Image Sequence Pattern (Object2VR)

Object2VR – Help

The image sequence pattern is simply a way for you to describe your file naming convention to Object2VR in order for it to recognize your images as a sequence pattern. This description is written in one line of JavaScript which uses predefined variables based on column and row numbers:

  • column – current column
  • row – current row
  • state – current view state
  • columns – selected number of columns
  • rows – selected number of rows
  • states – number of view states

Studio V3.0 You can also use the User Data fields:

  • title
  • description
  • author
  • datetime
  • copyright
  • source
  • information
  • comment

There is also a helper function:

fill(<string>,<length>,<fill character>) – expands a string to a certain length

You can find a list of the other predefined objects in Qt’s ECMAScript Reference.

Examples

Some useful examples of image name patterns. The round brackets around the variables are used to force a mathematical evaluation.

Single Row

The following examples are explained assuming 10 columns.

'image' + (column) + '.tif'

produces “image0.tif” to “image9.tif”

'image' + (column+1) + '.tif'

produces “image1.tif” to “image10.tif”

'image' + fill(column+1,4,'0') + '.tif'

produces “image0001.tif” to “image0010.tif”

Multi Row

The following example are explained asuming 10 columns and 5 rows.

'out_'+ (row) + '_' + (column) + '.tif'

produces “out_0_0.tif”,”out_0_1.tif”,.. to “out_4_9.tif”

'out_'+ ((rows-1)-row) + '_' + (column) + '.tif'

produces “out_4_0.tif”,”out_4_1.tif”,.. to “out_0_9.tif”

'DSC_' + fill(column+row*columns+234,4,'0') + '.JPG'

produces “DSC_0234.JPG”, “DSC_0235.JPG”,… to “DSC_0283.JPG”. This is useful if you shot a multi row object movie in one go with your digital camera and the first image is “DSC_0234.JPG”.

Advanced Examples

You can also define functions or arrays within the pattern line. Only the evaluation of the last statement defines the result. If you have, for example, several rows with different names you could use something like this:

rowname=Array('red','blue','green','yellow','pink'); rowname[row] + '_' + column + '.jpg'

This produces the file names “red_0.jpg”, “red_1.jpg”, …. “red_9.jpg”,”blue_0.jpg”,…. “pink_9.jpg”

See also

Importing with Select Input (Object2VR)
Input (Object2VR)
Image Capture (Object2VR)
User Data (Object2VR)