# Image File Name Convention

Scene files which have version data ``1 1'' (i.e. the top line of the scene file is `RenderWorld_data_file scene 1 1` ) provide automatic naming of the output image files in a rigid format. The image files generated by RenderWorld are given names generated from (1) the root name specified at the top of the scene file; (2) the camera number; (3) the name of the camera; (4) the frame number; and (5) the image format. The form of the filename is

<root name>c<camera #><camera name><frame #>.<type>

When image striping is performed, the names of the strips is

<root name>c<camera #><camera name>_s<strip #><frame #>.<type>.

Begining with scene files having version numbers ``2 2'' (i.e. the scene file top line is `RenderWorld_data_file scene 2 2` ) the user is given options for customizing the format of the file names. The scene file begins with

  `RenderWorld_data_file scene 2 2`
  ``
  `output_file` `basename`
  `output_format -``b-.-f-.-t-`
  ``
  `number_of_bands 3`
  `band_id wavelength width`
  `1 0.701 0.158`
  `2 0.535 0.085`
  `3 0.473 0.037`
  ``

The `output_file` line defines a base name for the files generated. The `output_format` string defines the list and positioning of elements in the filenames. In general, it has the form

`-X-X-X-X-X-`

X is "b","c","C","f","t",".","-",or "_". These symbols stand for:

b - insert "output_file" (or base name)

c - insert camera_name

C - insert camera_number (such as "c1" for the first camera in the scene)

f - insert a four digit frame number

t - insert file extension

. - insert a "."

- - insert a "-"

_ - insert a "_"

The number of Xs is arbitrary and you should be careful to include an "f" if you are running more than 1 frame. The string must start and end with a "-".

For example:

with output_file = "atest"

camera_name = "video"

camera_number = "0"

frame number = "78"

and file extension = "img" (no ".")

`-b-.-f-.-t-` produces a file: "atest.0078.img"

`-b-C-c-f-.-t-` produces a file: "atestc1video0078.img"

`-b-_-c-.-f-.-t-` produces a file: "atest_video.0078.img"

`-b-f-` produces a file: "atest0078"

The RenderWorld Engine does check to make sure you put in "-f-" somewhere, but it only prints out a WARNING message and continues. (It stops if the string is actually invalid).

As long as "-b" is the first part of your file format, directory path names can be included in the base name.

When compositing fields are being generated, the filenames of the composite fields are created from this format, with the name of the composite field inserted in the filename just before the frame number. When no frame number is used, the compositing field name is attached to the end of the filename.

When image stripping is being used, the strip label, ``_sn'', where n is the strip number, is attached to the filename just to the left of the frame number, but after other format information and the composite field name.

Contents