stillleben.Mesh class

Typical usage

import stillleben as sl

sl.init()

# Load a mesh
mesh = sl.Mesh('my_meshfile.gltf')

# Add an object referencing the mesh to the scene
obj = sl.Object(mesh)
scene = sl.Scene((1920, 1080))
scene.add_object(obj)

Accessing and manipulating vertex data

You can use points, faces, colors, normals to access common vertex attributes. update_positions() and friends can be used to write vertex attributes.

Sub-Meshes

Some mesh file formats (such as .obj) may contain multiple sub-meshes with different properties and textures. Stillleben fully supports loading and working with such files. If you work with the mesh data itself (see points, faces), it will feel like working with a big concatenated mesh. This is more convenient in most situations and removes a level of indirection when performing vertex updates. All meshes live in the same coordinate system.

Enums

class Flag: NONE = 0 PHYSICS_FORCE_CONVEX_HULL = 1

Mesh flags

Static methods

def load_threaded(filenames: typing.List[object], visual: bool = True, physics: bool = True, flags: typing.List[Flag] = []) -> typing.List[Mesh]

Load multiple meshes using a thread pool.

Methods

def center_bbox(self, /) -> None

Center mesh.

def dump_physics_meshes(self, arg0: str, /) -> None

Write physics meshes in PLY format into the given directory.

def scale_to_bbox_diagonal(self, target_diagonal: float, mode: str = 'exact') -> None

Rescale mesh.

def set_new_colors(self, new_colors: at::Tensor) -> None

Set new vertex colors.

def set_new_positions(self, new_positions: at::Tensor) -> None

Set new vertex positions.

def update_colors(self, vertex_indices: at::Tensor, color_update: at::Tensor) -> None

Updates the mesh vertex colors.

def update_positions(self, vertex_indices: at::Tensor, position_update: at::Tensor) -> None

Updates the mesh vertex positions.

def update_positions_and_colors(self, vertex_indices: at::Tensor, position_update: at::Tensor, color_update: at::Tensor) -> None

Updates the mesh verticex positions and vertex colors.

Special methods

def __init__(self, filename: object, visual: bool = True, physics: bool = True, flags: Flag = stillleben.Mesh.) -> None

Constructor

Properties

bbox: Range3D get

Mesh bounding box.

class_index: int get set

Class index for training semantic segmentation.

colors: at::Tensor get

The mesh colors as (Nx4) float tensor.

faces: at::Tensor get

The mesh faces as (N*3) int32 tensor.

filename: str get

The mesh filename

normals: at::Tensor get

The mesh normals as (Nx3) float tensor.

physics_mesh_data: list get

The convex decomposition used for physics simulation. This is a list of dicts, with the keys positions and indices.

points: at::Tensor get

The mesh vertices as (Nx3) float tensor.

pretransform: at::Tensor get set

The current pretransform matrix.

Method documentation

Property documentation