picogl.backend.state

Render-state descriptors and command helpers for PicoGL backends.

The classes in this module are intentionally backend-neutral: they describe desired OpenGL state and delegate the actual gl calls to a backend object.

Classes

RasterState	Raster State
GLStateManager	Tracks capability state without querying OpenGL.
BlendState	Blend State
DepthState	Depth State
RenderState	Flat render-state descriptor with nested-state constructor support.
RenderStateApplier	Applies render-state deltas through a gl backend.
GLVertexBuffer
GLAttributeArray	gl Attribute Array
GLViewport
TestGLMesh	Test gl Mesh
DrawCommand	Draw Command
GLClipPlaneState	gl Clipping Plane State

Functions

gl_value(→ Any)

Return a raw OpenGL value for PicoGL enums or pass raw values through.

Module Contents

picogl.backend.state.gl_value(value: Any) → Any

Return a raw OpenGL value for PicoGL enums or pass raw values through.

class picogl.backend.state.RasterState

Raster State

polygon_mode: Any

line_width: float = 1.0

polygon_offset: tuple[float, float] = (0.0, 0.0)

point_size: float | None = None

apply(backend: Any) → None

class picogl.backend.state.GLStateManager(backend: CapabilityDriver)

Tracks capability state without querying OpenGL.

backend

_caps: dict[int, bool]

set_enabled(cap: int, enabled: bool) → None

is_enabled(cap: int) → bool

class picogl.backend.state.BlendState

Blend State

enabled: bool = False

src: Any

dst: Any

apply(state: GLStateManager)

class picogl.backend.state.DepthState(test: bool = True, write: bool = True, enabled: bool | None = None)

Depth State

test: bool = True

write: bool = True

property enabled: bool

apply(state: GLStateManager)

class picogl.backend.state.RenderState(*, raster: RasterState | None = None, depth: DepthState | None = None, blend: BlendState | bool | None = None, blend_src: Any = GLBlendFactor.SRC_ALPHA, blend_dst: Any = GLBlendFactor.ONE_MINUS_SRC_ALPHA, depth_test: bool | None = None, depth_write: bool | None = None, line_width: float | None = None, polygon_mode: Any | None = None, polygon_offset: tuple[float, float] | None = None, point_size: float | None = None, program_point_size: bool = False, cull_face: bool = False, lighting: bool = False)

Flat render-state descriptor with nested-state constructor support.

blend: bool = False

blend_src: Any

blend_dst: Any

depth_test: bool = True

depth_write: bool = True

line_width: float = 1.0

polygon_mode: Any

polygon_offset: tuple[float, float] = (0.0, 0.0)

point_size: float | None = None

program_point_size: bool = False

cull_face: bool = False

lighting: bool = False

property raster: RasterState

property depth: DepthState

property blend_state: BlendState

class picogl.backend.state.RenderStateApplier(backend: Any)

Applies render-state deltas through a gl backend.

backend

current: RenderState | None = None

apply(state: RenderState)

class picogl.backend.state.GLVertexBuffer(data: numpy.ndarray)

data

bind_legacy()

class picogl.backend.state.GLAttributeArray

gl Attribute Array

size: int

dtype: Any

stride: int

pointer: Any

enable_legacy(kind)

class picogl.backend.state.GLViewport

x: int

y: int

width: int

height: int

apply()

class picogl.backend.state.TestGLMesh(vertices, indices=None)

Test gl Mesh

vertices

indices = None

attributes: list[GLAttributeArray] = []

add_attribute(attr: GLAttributeArray)

draw()

class picogl.backend.state.DrawCommand

Draw Command

mesh: Any

mode: int | None = None

texture: picogl.texture.gltexture_driver.GLTextureDriver | int | None = None

state: RenderState | None = None

execute(backend: Any)

class picogl.backend.state.GLClipPlaneState

gl Clipping Plane State

enabled0: bool = False

enabled1: bool = False

apply(state: GLStateManager)