Model

Models have all the basic properties described in Object Instructions.

Child

Additionally, models have the child method for accessing children defined in the GLB or glTF file. Since the child method returns the model type again, all model properties and methods can be applied to children as well.

Please refer to Transformation Example or Robot Example for an example.

Material

The material properties of a model can be updated dynamically.

In order to access the material property, the unique_material argument must be set (True or False) when adding the model to the visualization.

If a material is not unique all material settings affect all models in the scene with the same material as the target model.

Warning

Some material properties might not be supported by the model’s original material. For example, a model with a png based texture might not support color changes.

Alternatively, a separately created material (e.g. via add_mesh_standard_material or add_mesh_basic_material) can be passed as the material argument when adding the model. It is then applied recursively to every mesh in the model, replacing whatever materials are baked into the model asset itself, regardless of what the asset’s own materials look like. The unique_material argument is ignored when material is set.

Depth Test

Setting the depth_test attribute updates the material’s rendering behavior:

• depthTest is set to the given value

• transparent is set to True

When the depth_test setting is applied to a parent object with multiple children, the property is set for all descending children recursively.

Example:

Python

    visu = Visu(voraus_3d_visu, clear_all=True)
    robot = visu.add_model(robot_glb, position=[0, 0, 0])
    box = visu.add_model(box_glb, position=[-0.5, -0.5, 0], unique_material=True)

    with visu.connection():
        visu.update(
            box.material.depth_test(False),
        )

Rust

let mut visu = Visu::new(url, false, false, true, None)?;
let robot = add_model(&visu, robot_glb, [0.0, 0.0, 0.0])?;
let box_model = add_model_unique(&visu, box_glb, [-0.5, -0.5, 0.0], true)?;

let mut connection = visu.connection()?;
connection.update(vec![box_model.material()?.depth_test(false)])?;

Fig. 3 Result of the depth_test instruction example

Transparency

Setting the transparency attribute updates the material’s rendering behavior:

• transparent is set to True

• opacity is set to the given value

When the transparency setting is applied to a parent object with multiple children, the property is set for all descending children recursively.

As the material of box 1 was not made unique, both boxes are transparent, even though the transparency was only set for box 1.

Example:

Python

    visu = Visu(voraus_3d_visu, clear_all=True)
    robot1 = visu.add_model(robot_glb, position=[0, 0, 0], unique_material=True)
    robot2 = visu.add_model(robot_glb, position=[0, 1, 0], unique_material=True)
    box1 = visu.add_model(box_glb, position=[1, 0, 0], unique_material=False)
    _ = visu.add_model(box_glb, position=[1, 1, 0])

    with visu.connection():
        visu.update(
            robot1.child("Base").material.transparency(0.1),
            robot1.child("Segment1").material.transparency(1.0),
            robot1.child("Segment2").material.transparency(0.1),
            robot1.child("Segment3").material.transparency(1.0),
            robot1.child("Segment4").material.transparency(0.1),
            robot1.child("Segment5").material.transparency(0.8),
            robot1.child("Segment6").material.transparency(0.1),
            robot2.material.transparency(0.4),
            box1.material.transparency(0.5),
        )

Rust

let mut visu = Visu::new(url, false, false, true, None)?;
let robot1 = add_model_unique(&visu, robot_glb, [0.0, 0.0, 0.0], true)?;
let robot2 = add_model_unique(&visu, robot_glb, [0.0, 1.0, 0.0], true)?;
let box1 = add_model_unique(&visu, box_glb, [1.0, 0.0, 0.0], false)?;
add_model(&visu, box_glb, [1.0, 1.0, 0.0])?;

let mut connection = visu.connection()?;
connection.update(vec![
    robot1.child("Base").material()?.transparency(0.1)?,
    robot1.child("Segment1").material()?.transparency(1.0)?,
    robot1.child("Segment2").material()?.transparency(0.1)?,
    robot1.child("Segment3").material()?.transparency(1.0)?,
    robot1.child("Segment4").material()?.transparency(0.1)?,
    robot1.child("Segment5").material()?.transparency(0.8)?,
    robot1.child("Segment6").material()?.transparency(0.1)?,
    robot2.material()?.transparency(0.4)?,
    box1.material()?.transparency(0.5)?,
])?;

Fig. 4 Result of the transparency instruction example

For a color example, see Geometric Primitives.