Renderer

Render protein and annotation objects with a reusable GPU renderer.

from proteinmotion.renderer import Renderer

Constructor

Renderer(width=1920, height=1080, *, msaa=4, require_metal=None, readback_format='rgba')

Parameters

Parameter	Default	Description
`width`	`1920`	Image width in pixels.
`height`	`1080`	Image height in pixels.
`msaa`keyword only	`4`	Multisample count: 1 or 4.
`require_metal`keyword only	`None`	Require the Metal backend. None requires Metal on macOS and requests a high-performance adapter elsewhere.
`readback_format`keyword only	`'rgba'`	"rgba" for image arrays or "nv12" for video encoding.

Notes

Use a with block to release resources. draw() submits GPU work without readback. render() returns one completed frame. enqueue() and drain() overlap GPU rendering and CPU encoding.

Attributes

Name	Description
`adapter_info`	GPU adapter and backend information.

Methods and properties

Name	Description
draw()method	Draw a GPU frame without copying pixels to the CPU.
enqueue()method	Submit a frame and retrieve the oldest completed readback when the pipeline is full.
drain()method	Yield all remaining queued frame arrays in submission order.
render()method	Draw one frame and wait for its pixel readback.
close()method	Release GPU buffers and renderer resources.
__enter__()method	Enter a with Renderer(...) context.
__exit__()method	Close renderer resources on context exit.

draw()

View source

Renderer.draw(proteins, camera, background)

Draw a GPU frame without copying pixels to the CPU.

Parameter	Default	Description
`proteins`	Required	Protein or annotation objects to add or render.
`camera`	Required	Camera used to project or frame objects.
`background`	Required	Three RGB floats in [0, 1], such as scene.background.

Returns: None

enqueue()

View source

Renderer.enqueue(proteins, camera, background)

Submit a frame and retrieve the oldest completed readback when the pipeline is full.

Parameter	Default	Description
`proteins`	Required	Protein or annotation objects to add or render.
`camera`	Required	Camera used to project or frame objects.
`background`	Required	Three RGB floats in [0, 1], such as scene.background.

Returns: Frame array, or None while the readback pipeline fills.

drain()

View source

Renderer.drain()

Yield all remaining queued frame arrays in submission order.

Returns: Iterator of frame arrays.

render()

View source

Renderer.render(proteins, camera, background)

Draw one frame and wait for its pixel readback.

Parameter	Default	Description
`proteins`	Required	Protein or annotation objects to add or render.
`camera`	Required	Camera used to project or frame objects.
`background`	Required	Three RGB floats in [0, 1], such as scene.background.