README
1AlembicArnoldProcedural usage:
2
3-filename /path/to/some/archive.abc
4
5This is the only required argument. It has no default value.
6
7-frame 42
8
9The frame number to load from within the archive. The default value is 0. This is combined with -fps to map to Alembic time units (double-precision seconds).
10
11-fps 24
12
13Combined with -frame above. The default value is 24
14
15-shutteropen 0.0
16-shutterclose 0.5
17
18These are frame-relative values which specify the shutter window. The procedural will include all samples present in the archive which are relevant to the shutter window. The default value of both is 0.0 (no motion blur).
19
20-objectpath /assetroot/characters
21
22If specified, only objects at or below the provided path (within the archive) will be emitted. When combined with -excludexform, this can also be used to load individual leaf locations within an externally defined hierarchy. Be aware that in that case, you'd need to set the "matrix" and "inherit_xform" parameters on the procedural node itself. If the path points to a single "faceset" object directly beneath a polymesh or subdivision mesh, it'll add a "face_visibility" user data array.
23
24
25-excludexform
26
27If specified, the "matrix" parameter will not be set on the resulting primitive nodes.
28
29-subditerations 2
30
31For AbcGeom::ISubD objects, this option specifies the "subdiv_iterations" value. It currently has no effect for other primitive types. The default value is 0.
32
33-nameprefix some_prefix__
34
35Because node names are unique scene-wide in arnold, this allows you control potential name clashes when loading or instancing an archive (or multiple equivalently named archives) multiple times. The default name of each node is its full path within the alembic archive.
36
37-makeinstance
38
39This behavior is disabled by default. If enabled, the procedural will attempt to identify identical primitives (using Alembic's per-array-property hash keys) and create corresponding "ginstance" nodes. Two primitives are considered equivalent if the keys of their relevant point position samples match along with any specified subdivision values. This works across multiple archives or invokations of the procedural. It currently does not write unique user data per instance but will likely do so automatically (when necessary) in a future release. The ray visibility of the source primitive will be set to AI_RAY_NONE and the "ginstance" node's will be set to that of the calling "procedural" node.
40
41STILL TO DO:
42-AbcGeom::IPoints
43-AbcGeom::ICurves
44-AbcGeom::INuPatch
45-AbcGeom::ICamera
46-automatic recognition of unique user data per-instance
47
48
49
50
51
52
53
54