3.13. POVray Rendering File

<povray_rendering_file> ‐ The elements used to control the output of POVray scene descriptions

3.13.1. Attributes

NameTypeDefaults
idSTRINGEmpty string
headSTRINGEmpty string
tailSTRINGEmpty string
shotsSTRINGEmpty string
beginINTEGER0
endINTEGER10
stepINTEGER1

3.13.2. Description

This element defines the names of the files that are used for storing the POVray scene description files, and the period and the rate for POVray output with respect to the frame rate.

The string value of the id attribute defines the prefix of the POVray file names. The POVray output is active if and only if this string is not empty. This prefix is complemented with a frame number and a .pov extension to produce the final file name. It is prefixed with the string value of the shots attribute that is supposed to contain the name of the directory in which these files are stored.

The string values of the head and tail attributes define the names of the files that are concatenated before and after VC output in order to produce each POVray scene description file.

The integer values of the begin and end attributes define the frame numbers between which POVray output files are produced. The integer value step of the step attribute defines the output rate: a file is produced every step frames.

3.13.3. Expected content

None.

3.13.4. Example

The example below will produce POVray files named pov-files/p51XXXXX.pov in which XXXXX represents a frame number left padded with 0s. The header file is named bib/povray/comp-head.pov and the tail file bib/povray/comp-tail.pov. The POVray files are produced at each frame between frame number 4665 and frame number 5140.

<povray_rendering_file begin="4665" end="5140" step="1" 
  id="p51" head="bib/povray/comp-head.pov" 
  tail="bib/povray/comp-tail.pov" shots="pov-file/"/>