Skip to content

ludus::resources

Ludus Wiki · API overview · Browse API

Namespace

Declared in modules/graphics/renderer/include/ludus/graphics/renderer/static_lighting.hpp

Enumerations

Status

enum class Status : uint8
Explicit admission, observation and cleanup outcomes; no exceptions.

Related types: uint8

Ok

Ok
Operation completed or admission succeeded.

Pending

Pending
Owned work or a close blocker remains; service and poll again.

InvalidHandle

InvalidHandle
Wrong owner, slot, generation, type or consumed token.

InvalidState

InvalidState
Nonempty output, closed admission or invalid configuration.

QueueFull

QueueFull
A fixed table is full; failed admission owns nothing.

BudgetExceeded

BudgetExceeded
Declared peak reservation would exceed a domain limit.

OutOfMemory

OutOfMemory
Fixed control allocation failed.

NotFound

NotFound
Exact catalog identity is absent.

Unsupported

Unsupported
No adapter supports the declared content kind.

Cancelled

Cancelled
This caller cancelled; other callers are unaffected.

DeviceLost

DeviceLost
The adapter epoch changed; old ownership must still drain.

Failed

Failed
Adapter validation, acquisition or preparation failed.

DependencyFailed

DependencyFailed
A required child failed; FailureInfo retains the cause and chain.

Cycle

Cycle
Required resident edges contain a cycle.

LimitExceeded

LimitExceeded
Graph, closure or diagnostic storage exceeds a declared bound.

Conflict

Conflict
A desired revision superseded this transaction or identities differ.

Declared in modules/runtime/resources/include/ludus/runtime/resources/manager.h

HandleKind

enum class HandleKind : uint8
Compile-time identity categories; tokens of different categories cannot mix.

Related types: uint8

Asset

Asset
Immutable logical catalog entry.

Scope

Scope
Tracked group of requests and externally owned leases.

Request

Request
One caller's durable acquisition outcome.

Lease

Lease
One hold on an exact resident version.

Transaction

Transaction
One durable preparation/publication attempt.

Declared in modules/runtime/resources/include/ludus/runtime/resources/manager.h

TransactionState

enum class TransactionState : uint8
Durable transaction states; observing never publishes or consumes ownership.

Related types: uint8

Preparing

Preparing
Required roots are being prepared privately.

Ready

Ready
All roots are usable; an explicit boundary commit is still required.

Committed

Committed
The complete root binding set became current atomically.

Failed

Failed
Candidate failure/supersession retained the last good current set.

Cancelled

Cancelled
Explicit cancellation retained the last good current set.

Declared in modules/runtime/resources/include/ludus/runtime/resources/manager.h

RequestState

enum class RequestState : uint8
Request state; terminal outcomes survive repeated observation and service.

Related types: uint8

Queued

Queued
Accepted, awaiting adapter admission.

Working

Working
Shared operation owns candidate preparation.

Ready

Ready
Complete payload held until claimed or cancelled.

Failed

Failed
Terminal adapter failure; ownership cleanup may still be pending.

Cancelled

Cancelled
Caller demand dropped; shared cleanup is independent.

Declared in modules/runtime/resources/include/ludus/runtime/resources/manager.h

SceneLightKind

enum class SceneLightKind : uint8
Versioned authored analytic light kind, independent of renderer GPU types.

Related types: uint8

Directional

Directional = 0
IntensityRgb is illuminance in lux.

Point

Point = 1
IntensityRgb is luminous intensity in candela.

Spot

Spot = 2
Candela with cosine cone attenuation.

Declared in modules/runtime/resources/include/ludus/runtime/resources/scene.h

Aliases

AssetHandle

using ludus::resources::AssetHandle = Handle<HandleKind::Asset>
Identity without residency; Resolve never performs acquisition.

Related types: HandleKind::Asset · Handle

Declared in modules/runtime/resources/include/ludus/runtime/resources/manager.h

ScopeHandle

using ludus::resources::ScopeHandle = Handle<HandleKind::Scope>
Scope identity; closed scopes remain alive while external leases block close.

Related types: HandleKind::Scope · Handle

Declared in modules/runtime/resources/include/ludus/runtime/resources/manager.h

RequestHandle

using ludus::resources::RequestHandle = Handle<HandleKind::Request>
One caller's request, retained until TakeLease, EndRequest or CloseScope.

Related types: HandleKind::Request · Handle

Declared in modules/runtime/resources/include/ludus/runtime/resources/manager.h

LeaseToken

using ludus::resources::LeaseToken = Handle<HandleKind::Lease>
One exact-version ownership hold; duplicate release is rejected.

Related types: HandleKind::Lease · Handle

Declared in modules/runtime/resources/include/ludus/runtime/resources/manager.h

TransactionHandle

using ludus::resources::TransactionHandle = Handle<HandleKind::Transaction>
Durable replacement identity; copies do not own candidate storage.

Related types: HandleKind::Transaction · Handle

Declared in modules/runtime/resources/include/ludus/runtime/resources/manager.h

SceneMaterialName

using ludus::resources::SceneMaterialName = content::Text<content::scene_format::MAX_MATERIAL_NAME_BYTES>
Bounded counted UTF-8 source material name; inline materials may have an empty name.

Related types: content::scene_format::MAX_MATERIAL_NAME_BYTES · content::Text

Declared in modules/runtime/resources/include/ludus/runtime/resources/scene.h

Constants and variables

MAX_DEPENDENCIES

constexpr uint32 ludus::resources::MAX_DEPENDENCIES = 8
Maximum direct resident dependencies and admitted closure nodes in this profile.

Related types: uint32

Declared in modules/runtime/resources/include/ludus/runtime/resources/manager.h

MAX_FAILURE_CHAIN

constexpr uint32 ludus::resources::MAX_FAILURE_CHAIN = 8
Maximum copied resource IDs in a failure chain; longer cycles report truncation.

Related types: uint32

Declared in modules/runtime/resources/include/ludus/runtime/resources/manager.h