add_primitive: Add code to add primitives to a Blender script

In mikemahoney218/mvdf: A Minimum Viable Data Format for 3D Rendering via Blender

Description

This function generates code that will, when run inside Blender, create mesh primitives within a scene.

Usage

add_mesh_primitive(
  script,
  object,
  primitive = "ico_sphere",
  location = NULL,
  ...
)

add_surface_primitive(
  script,
  object,
  primitive = "torus",
  location = NULL,
  ...
)

add_curve_primitive(
  script,
  object,
  primitive = "bezier_circle",
  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)'.
primitive	The primitive type to create. See the official Blender documentation at https://docs.blender.org/api/blender_python_api_current/bpy.ops.html for a full list of available primitives. Each category has a different set of primitives available.
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 primitive. If 'NULL', this vector will be automatically calculated using the 'x', 'y', and 'z' values in 'object'.
...	Additional arguments to pass to the primitive creation call. The available arguments are different for each primitive, and are documented in the official Blender documentation at https://docs.blender.org/api/blender_python_api_current/bpy.ops.mesh.html.

Value

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

mikemahoney218/mvdf documentation built on May 7, 2021, 11:46 a.m.