trimesh.rendering module

rendering.py

Functions to convert trimesh objects to pyglet/opengl objects.

Functions

colors_to_gl(colors, count)

Given a list of colors (or None) return a GL-acceptable list of colors

convert_to_vertexlist(geometry, **kwargs)

Try to convert various geometry objects to the constructor args for a pyglet indexed vertex list.

light_to_gl(light, transform, lightN)

Convert trimesh.scene.lighting.Light objects into

material_to_texture(material[, upsize])

Convert a trimesh.visual.texture.Material object into a pyglet-compatible texture object.

matrix_to_gl(matrix)

Convert a numpy row-major homogeneous transformation matrix to a flat column-major GLfloat transformation.

mesh_to_vertexlist(mesh[, group, smooth, …])

Convert a Trimesh object to arguments for an indexed vertex list constructor.

path_to_vertexlist(path[, group, colors])

Convert a Path3D object to arguments for a pyglet indexed vertex list constructor.

points_to_vertexlist(points[, colors, group])

Convert a numpy array of 3D points to args for a vertex list constructor.

vector_to_gl(array, *args)

Convert an array and an optional set of args into a

trimesh.rendering.colors_to_gl(colors, count)

Given a list of colors (or None) return a GL-acceptable list of colors

Parameters

colors ((count, (3 or 4)) float) – Input colors as an array

Returns

  • colors_type (str) – Color type

  • colors_gl ((count,) list) – Colors to pass to pyglet

trimesh.rendering.convert_to_vertexlist(geometry, **kwargs)

Try to convert various geometry objects to the constructor args for a pyglet indexed vertex list.

Parameters

obj (Trimesh, Path2D, Path3D, (n,2) float, (n,3) float) – Object to render

Returns

args – Args to be passed to pyglet indexed vertex list constructor.

Return type

tuple

trimesh.rendering.light_to_gl(light, transform, lightN)

Convert trimesh.scene.lighting.Light objects into args for gl.glLightFv calls

Parameters
  • light (trimesh.scene.lighting.Light) – Light object to be converted to GL

  • transform ((4, 4) float) – Transformation matrix of light

  • lightN (int) – Result of gl.GL_LIGHT0, gl.GL_LIGHT1, etc

Returns

multiarg – List of args to pass to gl.glLightFv eg: [gl.glLightfb(*a) for a in multiarg]

Return type

[tuple]

trimesh.rendering.material_to_texture(material, upsize=True)

Convert a trimesh.visual.texture.Material object into a pyglet-compatible texture object.

Parameters
  • material (trimesh.visual.texture.Material) – Material to be converted

  • upsize (bool) – If True, will upscale textures to their nearest power of two resolution to avoid weirdness

Returns

texture – Texture loaded into pyglet form

Return type

pyglet.image.Texture

trimesh.rendering.matrix_to_gl(matrix)

Convert a numpy row-major homogeneous transformation matrix to a flat column-major GLfloat transformation.

Parameters

matrix ((4,4) float) – Row-major homogeneous transform

Returns

glmatrix – Transform in pyglet format

Return type

(16,) gl.GLfloat

trimesh.rendering.mesh_to_vertexlist(mesh, group=None, smooth=True, smooth_threshold=60000)

Convert a Trimesh object to arguments for an indexed vertex list constructor.

Parameters
  • mesh (trimesh.Trimesh) – Mesh to be rendered

  • group (str) – Rendering group for the vertex list

  • smooth (bool) – Should we try to smooth shade the mesh

  • smooth_threshold (int) – Maximum number of faces to smooth shade

Returns

args – Args for vertex list constructor

Return type

(7,) tuple

trimesh.rendering.path_to_vertexlist(path, group=None, colors=None, **kwargs)

Convert a Path3D object to arguments for a pyglet indexed vertex list constructor.

Parameters
  • path (trimesh.path.Path3D object) – Mesh to be rendered

  • group (str) – Rendering group for the vertex list

Returns

args – Args for vertex list constructor

Return type

(7,) tuple

trimesh.rendering.points_to_vertexlist(points, colors=None, group=None, **kwargs)

Convert a numpy array of 3D points to args for a vertex list constructor.

Parameters
  • points ((n, 3) float) – Points to be rendered

  • colors ((n, 3) or (n, 4) float) – Colors for each point

  • group (str) – Rendering group for the vertex list

Returns

args – Args for vertex list constructor

Return type

(7,) tuple

trimesh.rendering.vector_to_gl(array, *args)

Convert an array and an optional set of args into a flat vector of gl.GLfloat