pygfx.objects.Line

class pygfx.objects.Line(geometry: Geometry | None = None, material: Material | None = None, *, visible: bool = True, render_order: float = 0, render_mask: str | int = 'auto', name: str = '')

Bases: WorldObject

An object representing a line using a list of vertices (3D positions).

Some materials will render the line as a continuous line, while other materials will consider each pair of consecutive points a segment.

The picking info of a Line (the result of renderer.get_pick_info()) will for most materials include vertex_index (int) and segment_coord (float, sub-segment coordinate).

Parameters:

geometry (Geometry) – The data defining the shape of the object. Must contain at least a “positions” buffer. Depending on the usage of the material, can also include buffers “texcoords”, “colors”, and “sizes”.
material (Material) – The data defining the appearance of the object.
visible (bool) – Whether the object is visible.
render_order (int) – The render order (when applicable for the renderer’s blend mode).
render_mask (str) – Determines the render passes that the object is rendered in. It’s recommended to let the renderer decide, using “auto”.
position (Vector) – The position of the object in the world. Default (0, 0, 0).