Object2VR 4 Docs / Image Sequence Pattern

Image Sequence Pattern

The image sequence pattern is a way to describe your file naming convention to Object2VR in order for it to recognize your images as a sequence pattern.

This pattern 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 – number of columns
  • rows – number of rows
  • states – number of view states

You can also use the User Data fields as variables:

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

For example: title + (column) +'.tif'

There is a helper function: fill(<string>,<length>,<fill character>) This expands a string to a certain length. You can find a list of the other predefined objects in Qt’s ECMAScript Reference.


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 assuming 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' produces the file names “red_0.jpg”, “red_1.jpg”, …. “red_9.jpg”,”blue_0.jpg”,…. “pink_9.jpg”

See also…

Last modified: Aug 29, 2023