Struct ExtractContext 

pub struct ExtractContext<'w> {
    world: &'w mut World,
    entities: &'w mut HashMap<(FrameItemId, usize), OutputEntity>,
    seen: &'w mut HashSet<(FrameItemId, usize)>,
    source: FrameItemId,
    order: usize,
    next_part: &'w mut usize,
    transform: DAffine3,
}

World access, output identity, order, and inherited transform for extraction.

A context belongs to one ranim_core::frame::FrameItem. Recursive values share its output sequence; transform scopes compose without changing that sequence. Input data remains unchanged when a frame is rendered again.

Fields

world: &'w mut World

entities: &'w mut HashMap<(FrameItemId, usize), OutputEntity>

seen: &'w mut HashSet<(FrameItemId, usize)>

source: FrameItemId

order: usize

next_part: &'w mut usize

transform: DAffine3

Implementations

impl ExtractContext<'_>

pub fn world_mut(&mut self) -> &mut World

Access the render world to update resources or perform custom operations.

The current frame and this plugin’s identity state are temporarily scoped out of the world while extracting. The input value is available as self in Extract::extract. Directly spawned entities are not tracked by the context; manage their lifetimes in the implementation.

pub fn entity<B: Bundle>(&mut self) -> EntityWorldMut<'_>

Claim the source’s next persistent output entity.

B identifies the output bundle’s shape. The entity is reused while this shape stays the same; changing it replaces the entity so old components cannot remain. Values are inserted by the caller. Components managed outside B remain the implementation’s responsibility. An output not claimed on a later frame is despawned.

pub fn transform(&self) -> DAffine3

The accumulated local-to-world transform for the current value.

pub fn with_transform<R>( &mut self, transform: DAffine3, extract: impl FnOnce(&mut ExtractContext<'_>) -> R, ) -> R

Extract a subtree under current * transform, sharing output identities.

fn next_entity(&mut self, bundle_type: TypeId) -> EntityWorldMut<'_>