This function generates code that will, when run inside Blender, create empties within a scene. See the official Blender documentation at https://docs.blender.org/api/blender_python_api_current/bpy.ops.object.html for a full list of available options.
add_empty(script, object, type = "PLAIN_AXES", location = NULL, ...) add_empty_method(object, script, type = "PLAIN_AXES", location = NULL, ...) # S4 method for mvdf_obj add_empty_method(object, script, type = "PLAIN_AXES", location = NULL, ...)
script | The Python script to append the generated code onto. |
---|---|
object | An object inheriting from [mvdf_obj] which will be used to calculate the x, y, and z positions for each primitive. One primitive will be created for each row of `mvdf(object)`. |
type | The empty type to create. Options include 'PLAIN_AXES', 'ARROWS', 'SINGLE_ARROW', 'CIRCLE', 'CUBE', 'SPHERE', 'CONE', and 'IMAGE'. |
location | Either `NULL` (the default) or a vector of strings (in the format `location=(x, y, z)`) specifying the location for the origin of each empty. If `NULL`, this vector will be automatically calculated using the `x`, `y`, and `z` values in `object`. |
... | Additional arguments to pass to the empty creation call. |
A length 1 character vector containing the Blender Python script with code for creating mesh primitives added.