pygfx.objects.Line

class pygfx.objects.Line(geometry=None, material=None, *, visible=True, render_order=0, render_mask='auto', name='')

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.

  • 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).

Examples

Boundary Boxes

Boundary Boxes

Lights

Lights

Orbit Camera

Orbit Camera

Line Drawing Performance

Line Drawing Performance

Line Segments

Line Segments

Gizmo to transform world objects

Gizmo to transform world objects

Thick Lines

Thick Lines

Use a Skybox

Use a Skybox

Panzoom Camera

Panzoom Camera

Directional Shadow 1

Directional Shadow 1

Displaying an image in a scene

Displaying an image in a scene

Scene Overlay

Scene Overlay

Subplots 1

Subplots 1

Mesh and Volume Slicing 2

Mesh and Volume Slicing 2

Volume and Mesh Slicing 1

Volume and Mesh Slicing 1

Directional Shadow 2

Directional Shadow 2

Line plot

Line plot

Line Drawing

Line Drawing

Skinned Mesh

Skinned Mesh

Skinning Animation

Skinning Animation

Multi-Object Selection

Multi-Object Selection

Detached Bind Mode

Detached Bind Mode

Spotlights

Spotlights

Spotlight Shadow

Spotlight Shadow

Axes Helper 1

Axes Helper 1

Axis Helper 2

Axis Helper 2

Lines with different thicknesses

Lines with different thicknesses

Depth Overlay 1

Depth Overlay 1

Text anchor

Text anchor

Dashing

Dashing

Validate ruler

Validate ruler

Text size

Text size

Lines in 2D

Lines in 2D

Lines drawn with different thickness_space

Lines drawn with different thickness_space

Integrate Pygfx in Qt

Integrate Pygfx in Qt

Two Canvases

Two Canvases

Performance of drawing many Lines

Performance of drawing many Lines