Namespace Apogee.Content.Assets¶
Classes¶
Which file an asset's UID names, and which UID a file has. The UID of an imported file is in its .import.xml, the UID of an authored one (a scene) is in its root element
(imported/assets.xml
(written by
Results are remembered until
One place in a document that names an asset: an attribute whose text is an
Finds the documents that refer to an asset and rewrites them when the asset is renamed or moved: what the editor's rename calls. A document is an authored file
(.xml file in one of the definition folders the caller names, in any root of the Model="res://models/car.glb|uid://4k2m9x7q1w3ze"); text inside elements is not looked at.
What counts as a reference to the asset: an attribute whose path is the asset's path (as the engine writes it: the two addresses of a package file, res://packages/id/x and
mod://id/x, are the same), or whose UID is the asset's UID and whose path does not lead to some other file. That last condition is the engine's own rule, the path wins
while its file exists (
Rewriting changes the characters of the path part of each reference and nothing else (
Assets that are written by people or tools as XML, rather than imported from another format: they carry their own UID, in the uid attribute of the document's root element
(<Scene version="1" uid="uid://…">, <Prefab …>), and have no .import.xml. Scenes and prefabs now; materials add their extension to
The UID in a <asset>.import.xml: the uid attribute of its <Import> root (<Import uid="uid://4k2m9x7q1w3ze" srgb="false"/>). Anything that rewrites a
sidecar (a settings panel) has to keep it: ImportSidecar.SetUid(newText, ImportSidecar.ReadUid(oldText)). The import settings and the import key ignore it
(
What
An attribute that is rewritten (or would be, in a preview): where it is and what it will say.
What
A file the search could not use, and why: the reason is written for a person (read-only, not valid UTF-8…).