pyvale.render.riley module

Riley renderer adapter using Riley’s native public mesh and shader API.

class Riley(config, output_dir=None)

Bases: IRenderer3D

Render native Riley meshes through pyvale’s common scene container.

Riley owns its complete mesh and shader representation. Construct meshes with riley.Mesh, including its texture, nodal field, or analytic function shader settings, then place them in Scene3D.

Parameters:

• config (riley.RasterConfig) – Actual Riley raster configuration passed directly to riley.raster().

• output_dir (pathlib.Path or None, optional) – Directory to which Riley writes requested output. None preserves Riley’s default output behaviour.

capabilities = RenderCapabilities(element_types=frozenset({<EElemType.QUAD9: 'quad9'>, <EElemType.TRI7: 'tri7'>, <EElemType.TRI6: 'tri6'>, <EElemType.TET4: 'tet4'>, <EElemType.QUAD8: 'quad8'>, <EElemType.QUAD4: 'quad4'>, <EElemType.HEX20: 'hex20'>, <EElemType.TRI3: 'tri3'>, <EElemType.HEX8: 'hex8'>, <EElemType.TET10: 'tet10'>, <EElemType.HEX27: 'hex27'>}), supports_lights=False, supports_camera_distortion=True, supports_psf=True)

__init__(config, output_dir=None)

Create a renderer around a concrete Riley raster configuration.

verify_input(scene)

Verify native Riley meshes and common cameras before rasterisation.

Parameters:

scene (Scene3D) – Scene containing native Riley meshes and no explicit lights.

Raises:

RenderInputError – If configuration, mesh, camera, or lighting input is unsupported.

to_riley_camera(camera)

Convert one common perspective camera to a Riley camera.

Native riley.Camera instances are returned unchanged so scenes may mix cameras built through the render API with cameras loaded directly from Riley. SciPy reports Euler angles in X, Y, Z order, whereas Riley stores its camera angles in Z, Y, X order, so this adapter reverses their storage order at the API boundary.

Parameters:

camera (Camera or riley.Camera) – Input camera to convert.

Returns:

riley.Camera – Native Riley camera instance.

to_riley_mesh(mesh)

Convert one common mesh to a native Riley mesh.

Native riley.Mesh instances are returned unchanged so scenes may mix meshes built through the render API with meshes built directly through Riley.

Parameters:

mesh (Mesh3D or riley.Mesh) – Input mesh to convert.

Returns:

riley.Mesh – Native Riley mesh instance.

Raises:

TypeError – If mesh shader is unsupported.