Make imported asset fingerprints deterministic
This commit is contained in:
1 parent
a048233fce
commit
e1b2f86a49
27 files changed
+798
-135
No files matched your search
@@ -68,10 +68,11 @@ serialize into authored scenes.
|
||||
|
||||
`SkinnedMeshRenderer`, skeleton references, and clip references carry the model registry UUID. Generated
|
||||
artifacts are keyed by that UUID; source paths are cached resolution and repair hints. When one
|
||||
model is moved or renamed on disk, catalog refresh reconciles it by its animation-manifest content
|
||||
hash, preserves the UUID, and regenerates both manifests with the new source path. An identical copy
|
||||
is not treated as a move while the original still exists. Ambiguous content matches intentionally
|
||||
receive a new identity rather than silently binding the wrong asset.
|
||||
model is moved or renamed on disk, catalog refresh reconciles it by the registry's shared
|
||||
content-addressed source fingerprint, preserves the UUID, and regenerates both manifests with the
|
||||
new source path. The same registry policy covers textures and audio clips. An identical copy is not
|
||||
treated as a move while the original still exists. Ambiguous content matches intentionally receive
|
||||
a new identity rather than silently binding the wrong asset.
|
||||
|
||||
Scene schema v3 migrates legacy animated actors that paired `ModelRef` with
|
||||
`AnimationControllerDesc` to the dedicated skinned renderer. Generic `ImportedModel + ModelRef`
|
||||
@@ -83,6 +84,12 @@ used as identity. Animation-manifest schema v1 artifacts must be reimported to g
|
||||
signatures; schema v3 adds the explicit default-clip ID. Schema v2 deserializes as Imported rest
|
||||
pose and never receives an inferred default.
|
||||
|
||||
Source identity uses exact byte length plus BLAKE3 and never checkout mtime. Existing animation
|
||||
schema-v3 files may retain a legacy `modified_unix_secs` field in their exact bytes; the current
|
||||
reader ignores it, and an equivalent refresh preserves the whole file unchanged. Static-mesh schema
|
||||
v4 uses the same content fingerprint. See
|
||||
[ADR 0043](../adr/0043-content-addressed-import-fingerprints.md).
|
||||
|
||||
## Validation And Format Boundary
|
||||
|
||||
Interactive diagnostics and `cargo validate-levels` resolve registry UUIDs, generated manifests,
|
||||
|
||||
@@ -224,7 +224,11 @@ the Edit-to-Play boundary restore the complete runtime snapshot. See
|
||||
- **Processing:** the asset registry generates normalized model manifests under
|
||||
`assets/meshes/generated/`. The manifests store stable part IDs, glTF/FBX mesh/material subasset
|
||||
labels, whether each part is skin-bound, source metadata, dependencies, and import settings.
|
||||
These artifacts are hidden from the Asset Browser catalog.
|
||||
Model, texture, and audio registry records use byte length plus BLAKE3 source identity; model
|
||||
manifests use the same policy. Semantic RON comparison preserves exact existing bytes for an
|
||||
equivalent refresh, so checkout mtimes and formatting do not dirty project content. See
|
||||
[ADR 0043](../adr/0043-content-addressed-import-fingerprints.md). These artifacts are hidden from
|
||||
the Asset Browser catalog.
|
||||
- **Browser subassets:** model rows can expand into a content shelf backed by the generated
|
||||
manifest. Unrigged mesh subassets place as independent `StaticMeshRenderer` actors. A skinned
|
||||
subasset places its owning source through `SkinnedMeshRenderer`, retaining joints and inverse bind
|
||||
|
||||
@@ -2,7 +2,8 @@
|
||||
|
||||
## Shipped
|
||||
|
||||
- Stable asset registry (`assets/.index/registry.ron`) with import settings
|
||||
- Stable asset registry (`assets/.index/registry.ron`) with import settings and content-addressed
|
||||
model/texture/audio source fingerprints
|
||||
- Prefab instances (`PrefabInstance`) + save-as-prefab workflow
|
||||
- Unsaved-scene guards on New/Open/Recent
|
||||
- Hierarchy additive select, reparent/unparent undo, multi-entity gizmo delta
|
||||
|
||||
Reference in new issue
Block a user