Synced
AssetLoader
Section titled “AssetLoader”
Coordinates importing, persistent cataloging, canonical loading, reloading and collection for one source and artifact root pair.
Resolves import settings and dependency invalidation for the asset loader.
Required contracts
Section titled “Required contracts”API: engine
Implements: System.IDisposable, Inno.Assets.IAssetReferenceResolver, Inno.Assets.IAssetArtifactLookup, Inno.Assets.IAssetPropertyStateResolver
Inherits: object
Project: Inno.Assets.Pipeline
Declaration
Section titled “Declaration”public sealed class Inno.Assets.Pipeline.AssetLoader : System.IDisposable, Inno.Assets.IAssetReferenceResolver, Inno.Assets.IAssetArtifactLookup, Inno.Assets.IAssetPropertyStateResolverMembers
Section titled “Members”| Kind | Element | Description |
|---|---|---|
| Constructors | AssetLoader.Constructor(Inno.Extensibility.Types.TypeCatalog,Inno.Core.Serialization.SerializationRegistry,Inno.Core.Identity.IdentityAllocator,Inno.Core.Diagnostics.DiagnosticHub,Inno.Core.Logging.LogRouter,System.Collections.Generic.IReadOnlyList{Inno.Assets.Pipeline.AssetSourceMount},System.String,Inno.Assets.Pipeline.AssetSourcePolicy,System.Boolean) | Creates an asset loader over one project source and zero or more isolated sources. |
| Constructors | AssetLoader.Constructor(Inno.Extensibility.Types.TypeCatalog,Inno.Core.Serialization.SerializationRegistry,Inno.Core.Identity.IdentityAllocator,Inno.Core.Diagnostics.DiagnosticHub,Inno.Core.Logging.LogRouter,System.String,System.String,Inno.Assets.Pipeline.AssetSourcePolicy) | Creates an asset loader for one source and Library root pair. |
| Events | AssetLoader.AssetReloaded | Occurs after a loaded canonical asset is updated in place. |
| Methods | AssetLoader.AcquireArtifact | Acquires an immutable output while excluding concurrent artifact collection. |
| Methods | AssetLoader.ApplySourceChanges | Applies normalized source file changes to the persistent catalog. |
| Methods | AssetLoader.BuildAsync | Builds and validates the requested artifact asynchronously before publishing it. |
| Methods | AssetLoader.CaptureWritableImportHealth | Captures the current failure identity of every writable source without exposing catalog internals. |
| Methods | AssetLoader.CollectArtifacts | Collects unreachable content-addressed artifacts. |
| Methods | AssetLoader.Dispose | Stops new loads and releases canonical assets before their registries and diagnostics. |
| Methods | AssetLoader.ExportRuntimeArtifacts(System.String) | Writes a source-free runtime catalog and its exact immutable artifact closure. |
| Methods | AssetLoader.ExportRuntimeArtifacts(System.String,System.Threading.CancellationToken) | Exports the validated runtime artifact closure while observing cooperative cancellation between files. |
| Methods | AssetLoader.FindIntroducedImportFailures | Finds writable-source failures that are new or changed relative to an earlier health snapshot. |
| Methods | AssetLoader.GetDependencies | Gets direct or transitive runtime dependencies of an asset. |
| Methods | AssetLoader.GetImportDependencies | Gets source import dependencies that invalidate an asset artifact. |
| Methods | AssetLoader.GetImportSettings | Reads a detached importer settings value without changing source metadata. |
| Methods | AssetLoader.GetLoadedPaths | Gets isolated source paths of all canonical loaded assets. |
| Methods | AssetLoader.GetReferenceInfo | Gets an engine-known reference diagnostic snapshot. |
| Methods | AssetLoader.Import | Imports one isolated source file into metadata and a runtime artifact. |
| Methods | AssetLoader.Load(Inno.Assets.AssetPath,System.Type) | Loads a canonical asset by isolated source path. |
| Methods | AssetLoader.Load(System.Guid,System.Type) | Loads a canonical asset by persistent identity. |
| Methods | AssetLoader.LoadAsync(Inno.Assets.AssetPath,System.Type,System.Threading.CancellationToken) | Asynchronously loads a canonical asset by isolated source path. |
| Methods | AssetLoader.LoadAsync(System.Guid,System.Type,System.Threading.CancellationToken) | Asynchronously loads a canonical asset by persistent identity. |
| Methods | AssetLoader.PrepareCatalogCandidate | Creates an isolated source-mount and catalog candidate without changing the active catalog. |
| Methods | AssetLoader.RefreshRegistries | Refreshes extension registries and reimports affected sources when their snapshot changed. |
| Methods | AssetLoader.Rescan | Reconciles source files, metadata, artifacts and the in-memory catalog. |
| Methods | AssetLoader.ResolveReference | Resolves a serialized reference or creates a persistent missing placeholder. |
| Methods | AssetLoader.RestoreProperties | Restores serialized properties to the existing asset object. |
| Methods | AssetLoader.Save(Inno.Assets.AssetObject) | Saves an asset back to its current source path. |
| Methods | AssetLoader.Save(Inno.Assets.AssetPath,Inno.Assets.AssetObject) | Saves an asset to its initial or existing isolated source path while preserving an existing destination identity. |
| Methods | AssetLoader.SaveImportSettings | Atomically saves importer settings and reimports the source. Failed imports retain both the saved settings and the previous successful artifact; callers must inspect the returned import status separately from saving. |
| Methods | AssetLoader.TryGetArtifact | Tries to resolve a named output from the current artifact bundle. |
| Methods | AssetLoader.TryGetAssetType | Tries to resolve the concrete asset type without loading it. |
| Methods | AssetLoader.TryGetInfo(Inno.Assets.AssetPath,Inno.Assets.AssetInfo@) | Tries to get a catalog snapshot by isolated source path. |
| Methods | AssetLoader.TryGetInfo(System.Guid,Inno.Assets.AssetInfo@) | Tries to get a catalog snapshot by persistent identity. |
| Methods | AssetLoader.TryGetPersistentId | Tries to resolve a persistent identity without loading the asset. |
| Methods | AssetLoader.TryLoad(Inno.Assets.AssetPath,System.Type,Inno.Assets.AssetObject@) | Tries to load a canonical asset by isolated source path. |
| Methods | AssetLoader.TryLoad(System.Guid,System.Type,Inno.Assets.AssetObject@) | Tries to load a canonical asset by persistent identity. |
| Methods | AssetLoader.UnloadUnusedAssets | Collects canonical assets that have no external managed references. |
| Methods | AssetLoader.WaitForIdle | Waits for pending import and build work. |
| Properties | AssetLoader.artifactRoot | Gets the derived content-addressed artifact root. |
| Properties | AssetLoader.assetRoot | Gets the absolute source root. |
| Properties | AssetLoader.libraryRoot | Gets the absolute rebuildable Library root. |