From K-3D

Jump to: navigation, search


Renders a one-dimensional array of geometric object instances
Plugin Status:Stable
Categories:All Plugins, Stable Plugins, RenderMan Plugins, Array Plugins


Name Value


Label Description Type Script Name
Input Matrix Input matrix k3d::matrix4 input_matrix
Output Matrix Output Matrix k3d::matrix4 output_matrix
Render Controls whether this node will be visible in the final rendered image. k3d::bool_t render_final
Render Shadows Controls whether this node will be visible during shadow-map render passes. k3d::bool_t render_shadows
Motion Blur If enabled, this node will be rendered with motion-blur. k3d::bool_t motion_blur
Viewport Visible Controls whether this node will be visibile in the viewport. k3d::bool_t viewport_visible
Surface Material Surface material k3d::inode* material
Source Source k3d::inode* source
Layout Layout k3d::inode* layout
count Count k3d::int32_t count


RenderManArray1D renders multiple copies of a source object that have been transformed along a single dimension. It can be more efficient than rendering using multiple MeshInstance nodes because it only stores one copy of the source object in the output RIB file. Multiple instances of the source object are then rendered using lightweight RiObject/RiInstance directives. The layout of the transformed instances is controlled with separate Layout nodes for flexibility.


Using RenderManArray1D with TranslateArray1D and RotateArray1D
  • Start K-3D.
  • Use Create > Quadrics > Cone to create a Cone that will be rendered multiple times.
  • Choose Create > Array > RenderManArray1D to create the array node that will control the number and layout of cones to be rendered.
  • The new RenderManArray1D properties will appear in the Node Properties Panel.
  • For the Source property, choose the cone.
  • For the Layout property, choose "-- New TranslateArray1D".
  • The new TranslateArray1D properties will appear in the Node Properties Panel.
  • You will see a collection of overlapping cyan bounding-boxes in the viewport. Each bounding-box is the same size as the source cone, and the boxes show where the cones will be rendered. The boxes overlap because the default offset for each copy is less than the size of the source cone.
  • Set the Offset property X value to "15.0". You will see that the bounding-boxes no longer overlap.
  • Zoom out and recenter the display so you can see all of the bounding boxes.
  • Continue adjusting the Offset property and note the cumulative effect as the offset is applied to each copy of the original cone.
  • Note that the TranslateArray1D node also has a Layout property - you can use this to "chain together" different layout algorithms.
  • For the Layout property, choose "-- New RotateArray1D".
  • The new RotateArray1D properties will appear in the Node Properties Panel.
  • Note that the cyan bounding boxes are rotated as well as translated.
  • Set the Angle property Z value to "10".
  • Select the RenderManArray1D node in the Node List Panel so its properties are visible in the Node Properties Panel.
  • Change the Count property and see that the number of cone instances changes.

See Also

RenderManArray2D, RenderManArray3D, TranslateArray1D, RotateArray1D, AlternateArray1D