wolfhece.opengl.cloud_points_shader2d

Shared-resource shader for cloud point rendering.

Draws cloud vertices as GL_POINTS with configurable shape in fragment shader (point, circle, cross, quad), color and fill mode.

Module Contents

wolfhece.opengl.cloud_points_shader2d.SHADER_DIR

wolfhece.opengl.cloud_points_shader2d.SYMBOLS_DIR

class wolfhece.opengl.cloud_points_shader2d.CloudPointsShader2D

Singleton shader for point-cloud rendering.

_instance: CloudPointsShader2D | None = None

_program: int | None = None

_locs: dict | None = None

_vao: int | None = None

_vao_pt: int | None = None

_vbo: int | None = None

_texture_cache: dict[tuple[str, float], int]

classmethod get_instance() → CloudPointsShader2D

_init_program()

static _compile(shader_type: int, path: pathlib.Path) → int

_ensure_vao_vbo()

_upload(pts_xy: numpy.ndarray)

_get_symbol_texture_id(symbol_path: str | None, symbol_raster_size: int = 128) → int | None

draw_points(pts_xy: numpy.ndarray, mvp: numpy.ndarray, point_size_px: float, color: tuple[float, float, float, float], style: int, filled: bool, symbol_path: str | None = None, symbol_raster_size: int = 128, symbol_rotation: float = 0.0, symbol_scale: float = 1.0, pts_transform: numpy.ndarray | None = None)

Draw cloud points with the shader pipeline.

Parameters:

• symbol_rotation – Per-cloud rotation in radians (CCW, Option A). Ignored when pts_transform is provided.

• symbol_scale – Per-cloud scale factor (Option A). Ignored when pts_transform is provided.

• pts_transform – Optional (N, 2) float32 array with per-point [rotation_rad, scale] columns (Option B). When provided, overrides symbol_rotation and symbol_scale on a per-point basis and uses the dedicated 4-float VAO layout.

destroy()