Adds a render command to the buffer.

raylib animated draw (GPU skinning path): emits one DrawSkinnedMesh per sub-mesh carrying the shared bone palette — no model mutation, so the same model can be drawn with several different poses in one frame. When pose is ValueNone, the pose is computed from the model's state. transform is the full world transform (the pipeline applies it directly, like every other mesh draw — model.Transform is not composed in).

raylib animated draw (legacy mutating path): applies the state's bone pose to its embedded model (raylib's UpdateModelAnimation path), then draws the model. The argument is ignored — the mutating path derives nothing from a palette; use the AnimatedModel overload for the GPU skinning path.

GPU skinning path, instanced: one DrawSkinnedMeshInstanced per sub-mesh carrying the shared flat per-instance palettes — N instances, each with its own pose, in one draw call per sub-mesh. poses carries one caller-evaluated BonePose per instance (share them with bone queries / attachment draws). The instance count is min(transforms.Length, poses.Length); 0 emits nothing. Each pose's Palette must contain at least boneCount matrices (one per bone): longer arrays are truncated to their first boneCount entries, shorter ones raise System.ArgumentException. A boneless model (boneCount = 0) emits nothing on this instanced path (matches the MonoGame backend). material overrides the authored materials (MaterialOverride.All / MaterialOverride.PerMesh). colors is MonoGame-only — ValueSome raises System.NotSupportedException. Both transforms and the palettes are copied into pooled arrays at record time, so the caller may freely reuse or refill its arrays once this call returns.

GPU skinning path with a whole-model material override — see the AnimatedModelAddAnimatedModel overload.

Legacy mutating path — is ignored; see the Animation3DState AddAnimatedModel overload.

GPU skinning path with a per-mesh material resolver — see the AnimatedModelAddAnimatedModel overload. The resolver receives the sub-mesh index.

Legacy mutating path — is ignored; see the Animation3DState AddAnimatedModel overload.

Draws a static mesh parented to bone of the animated model am. The attachment's world transform is localTransform * boneWorld * transform (applied left-to-right). All three matrices must be in raylib's native matrix layout — build them with Raymath.* ops (boneWorld already is, coming from BonePose.WorldPoses); never mix in System.Numerics.Matrix4x4.* results, which are the transpose of the native layout. An unknown bone is a no-op — no command is emitted. When pose is ValueNone, the pose is computed from the model's state; pass the same pose given to animatedModel to avoid a second evaluation this frame.

Draws a skinned mesh with an explicit bone palette. bones carries the palette in plain System.Numerics row-major layout (bones[i] = InverseBindPose[i] * pose[i]), NOT pre-transposed — the pipeline transposes at upload where the shader contract needs it.

Number of BeginCamera/BeginCameraConfig commands added since the last Clear. Lets a pipeline skip the per-camera-block plan (and its allocations) for single-camera frames.

The number of commands currently in the buffer.

Number of PostProcessWithDepth commands added since the last Clear. When > 0, the pipeline exposes the scene depth attachment to post-process actions via PostProcessContext3D.Depth. Zero on frames with only color-only PostProcess actions.

Gets the command at the specified index.

Number of PostProcess/PostProcessWithDepth commands added since the last Clear. Lets a pipeline skip the post-process drain (and its per-frame allocation) when the view emits none.

Tracks a rented matrix array (palette or transforms copy) so it can be returned to the ArrayPool after the pipeline consumes the commands. Called from the instanced draw witnesses (AddDrawInstanced/AddAnimatedModelInstanced, both inline extension members) — they cannot see primary-constructor let bindings, so they reach the field through this public method.

Number of light commands with CastsShadows = true added since the last Clear. A conservative gate for shadow-geometry collection: zero means no shadow-casting light exists in the buffer, so collection can be skipped outright. (Conservative because any casting directional counts, not just the first — only DirLights[0] can actually cast.)

Sorts commands using the provided comparer. Pipelines may call this internally to optimize draw order.