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, ...)

Arguments

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.

Value

A length 1 character vector containing the Blender Python script with code for creating mesh primitives added.