Package ke.ric.renderer.api

Class SceneContent

java.lang.Object
ke.ric.renderer.api.SceneContent
public final class SceneContent extends Object
Immutable selection of geometry retained in a derived scene. Content selection can only narrow available evidence; repeated entity selections intersect. Removed geometry is unavailable to camera, reflection and shadow rays. To hide geometry only from camera output while retaining its lighting and shadows, use RenderLayer.entities(EntitySelector) and RenderLayer.occlusion(Occlusion) instead.

World environment is separate from block geometry: entitiesOnly() removes block geometry while retaining captured time, weather, sampled light levels and other environment facts. Capture exclusions and viewer privacy remain authoritative in every derived scene. Use RenderEnvironment for supported environment overrides.

  • Method Details

    • all

      public static SceneContent all()
      Keeps all available block and entity geometry. It cannot restore evidence removed before capture or by earlier authoritative exclusions.
      Returns:
      an unrestricted content selection

    • blocksOnly

      public static SceneContent blocksOnly()
      Keeps captured block geometry and removes all entity geometry from the derived scene.
      Returns:
      block-only scene content

    • entitiesOnly

      public static SceneContent entitiesOnly()
      Removes block geometry from the derived scene while retaining captured entities, environment facts and sampled light levels. Removed blocks cannot occlude entities or cast geometric shadows.
      Returns:
      entity-only scene content

    • entities

      public SceneContent entities(EntitySelector selector)
      Intersects the current entity selection with another selector. Chaining selectors never restores entities excluded by the previous selection or capture.
      Parameters:
      selector - predicate over copied entity metadata
      Returns:
      a new narrowed content selection

    • includeBlocks

      public boolean includeBlocks()
      Reports whether captured block geometry is retained in the derived scene.
      Returns:
      true when block geometry is retained

    • entities

      public EntitySelector entities()
      Returns the entity selection evaluated against copied metadata, without live Bukkit reads.
      Returns:
      immutable entity selector