From K-3D
Description
Renders a one-dimensional array of geometric object instances
|
Metadata
Properties
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
|
Notes
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.
Example
- 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