blenderproc.python.modules.constructor.BasicEmptyInitializer module

class blenderproc.python.modules.constructor.BasicEmptyInitializer.BasicEmptyInitializer(config)

Bases: blenderproc.python.modules.main.Module.Module

Adds/initializes basic empty objects in the scene. Allows setting the basic attribute values. For more precise and powerful object manipulation use manipulators.EntityManipulator module.

These empty objects can be used to save locations or the be a focus point for the camera. They do not have any mesh data nor do the have any materials.

Example 1: Add a empty axis to the scene.

{
  "module": "constructor.BasicEmptyInitializer",
  "config": {
    "empties_to_add": [
    {
      "type": "plain_axes",
      "name": "Plain Axes"
    }
    ]
  }
}

Configuration:

Parameter	Description	Type
empties_to_add	List that contains entities configuration data in each cell. See table below for available parameters per cell.	list

empties_to_add cell configuration:

Parameter	Description	Type
type	Type of empty object to add. Default: “plain_axes”. Available types: [“plain_axes”, “arrows”, “single_arrow”, “circle”, “cube”, “sphere”, “cone”]	string
name	Name of the empty object.	string
location	Location of the empty object. Default: [0, 0, 0].	mathutils.Vector
rotation	Rotation (3 Euler angles) of the empty object. Default: [0, 0, 0].	mathutils.Vector
scale	Scale of the empty object. Default: [1, 1, 1].	mathutils.Vector

run()

Adds specified basic empty objects to the scene and sets at least their names to the user-defined ones. 1. Get configuration parameters’ values. 2. Add an object. 3. Set attribute values.