Indexed Creation

 An indexed creation is a creation which references to a files set
Their are 3 indexes:
  • List: this index is an integer 1, 2, 3, etc.
  • Layer: this index is a layer name.
  • Size: this index is a size: 1920x1080, 960x540, etc.
The usual use cases are:
  • List index: render a frameset
  • Layer index: render a 3d scene with different layers "diffuse", "specular", "z-buffer", etc.
  • Size index: define a texture or execute a process rendering width different resolutions
The indexes can be combined. See Combined Indexes
Indexed creations are read and written by process. See details "Process Use"
 Definitions
indexed filename
 An indexed filename is the indexed creation filename. See filename definition
An indexed filename is build like: <path> / <shortname> _ <list-index-suffix> _ <layer-index-suffix> _ <size-index-suffix> . <extension>
Example: filename = render/picture.jpg, list-index = 20 indexed filename = render/picture_020.jpg

 List index

 this index is an integer index
To activate this index, index.list info must be true.
begin info and end info are the first and the last index values.
example
<Creation id="frameset1" filename="frame.jpg">
     <Info name="index.list">true</Info>
     <Info name="begin">1</Info>
     <Info name="end">250</Info>
</Creation>
 indexed filenames 
frame_0001.jpg
frame_0002.jpg
..
..
frame_0249.jpg
frame_0250.jpg

 Layer index

 this index is a string index
To activate this index, index.layer info must be true.
layer info is used to set the layer name list
example
<Creation id="render1" filename="render.jpg">
     <Info name="index.layer">true</Info>
     <Info name="layer">diffuse;specular;zbuffer</Info>
</Creation>
 indexed filenames 
render_diffuse.jpg
render_specular.jpg
render_zbuffer.jpg

 Size index

 this index is a size index
To activate this index, index.size info must be true.
width info and height info are used to set the size values.
example
<Creation id="texture" filename="map.jpg">
     <Info name="index.size">true</Info>
     <Info name="width">1920;960;480</Info>
     <Info name="height">1080;540;270</Info>
</Creation>
 indexed filenames 
map_1920x1080.jpg
map_960x540.jpg
map_480x270.jpg
Combined indexes
The 3 indexes can be combined.
example
<Creation id="render1" filename="render.jpg">
     <Info name="index.layer">true</Info>
     <Info name="layer">diffuse;specular;zbuffer</Info>
     <Info name="index.size">true</Info>
     <Info name="width">1920;960;480</Info>
     <Info name="height">1080;540;270</Info>
</Creation>
 indexed filenames 
map_diffuse_1920x1080.jpg
map_diffuse_960x540.jpg
map_diffuse_480x270.jpg
map_specular_1920x1080.jpg
map_specular_960x540.jpg
map_specular_480x270.jpg
map_zbuffer_1920x1080.jpg
map_zbuffer_960x540.jpg
map_zbuffer_480x270.jpg
@ assembler 2017