`simvx.core.render_view`¶

RenderView: render the MAIN scene from a second camera into a texture.

Where :class:~simvx.core.SubViewport renders its own subtree with its own camera, a :class:RenderView renders the main scene tree through any

class:: ~simvx.core.Camera3D placed in it (design D6, render_modernization.md). The rendered colour buffer is published as a bindless texture index via
attr:: RenderView.texture, sampled exactly like a SubViewport feed: pass the node as Material(albedo_map=render_view) for a security-monitor slab, or read render_view.texture directly.

The render-to-texture integration is driven from the graphics backend (simvx.graphics.renderer.render_view.RenderViewManager); core stays rendering-agnostic. RenderViews are scheduled with the SubViewports by the

class:: ~simvx.core.scene_target_graph.SceneTargetGraph, so a RenderView that samples another offscreen target (or feeds one) renders in producer-first order within the same frame; genuine cycles degrade to a one-frame lag on the broken edge, never an error.

Pipelined render mode (render_mode="pipelined") defers RenderView capture exactly like reflection-probe capture: the texture slot stays valid but never updates, and the backend logs a one-time warning.

Module Contents¶

Classes¶

RenderView

Renders the main scene from camera into an offscreen texture.

Data¶

`log`
`__all__`

API¶

simvx.core.render_view.log¶: ‘getLogger(…)’

simvx.core.render_view.__all__¶: [‘RenderView’]

class simvx.core.render_view.RenderView(name='RenderView', **kwargs)[source]¶

Bases: simvx.core.nodes_3d.node3d.Node3D

Renders the main scene from camera into an offscreen texture.

Unlike SubViewport this node has no offscreen subtree: its children (if any) are ordinary main-scene content, and the view it captures is the main world itself, seen from the Camera3D that camera points at. The referenced camera does not need to be (and normally is not) the scene’s active camera.

Properties: camera: Node path to the Camera3D to render from, resolved relative to this node (e.g. "../SecurityCam"). Empty or unresolvable paths skip rendering with a one-time warning. size: Offscreen target dimensions in pixels. render_target_update_mode: "always" (default, render every frame), "when_visible" (render only while this node is visible in the hierarchy), "once" (render a single frame then freeze), or "disabled" (never render; the slot stays valid but stale). Same name as SubViewport’s property for the same dial (the plain update_mode of design D6 is taken: every Node carries the pause-processing update_mode). use_occlusion: Run the two-phase Hi-Z occlusion cull for this view’s own camera (desktop renderer; the web Hi-Z is single-phase and has no per-view hook yet). Off by default: an offscreen view is usually small enough that the occlusion pass costs more than it saves. In the pipelined render mode RenderView capture (and with it this cull) is deferred entirely, like probe capture.

Note: Avoid pointing camera at a surface that displays this RenderView’s own texture: sampling an image while rendering into it is a feedback loop the GPU does not order (the same caveat applies to a SubViewport showing its own feed).

Initialization