3.20. Trace

<trace> ‐ The control of tracing facilities and display appearance

3.20.1. Attributes

NameTypeDefaults
trace_input_fileBOOLEANfalse
trace_output_ frame_numberBOOLEANfalse
trace_timeBOOLEANfalse
first_frame_numberINTEGER0
last_frame_numberINTEGERINT_MAX

3.20.2. Description

This element defines the details about parsing and rendering outputs.

The boolean values of the trace_input_file, trace_output_frame_number, and trace_time attributes control the console output: the first one controls the output of the parsed scene description file, the second one controls the output of the current frame number, and the third one controls the output of the current scene time.

The integer value of the first_frame_number attribute defines the offset for frame numbering. Frame numbers are used by the POVray Rendering File, Renderman Rendering File, Tiff Rendering File, and Video Rendering File elements to control the frame intervals in which scene description files are produced. In addition, the integer value of the last_frame_number attribute defines the frame at which the VC application terminates.

3.20.3. Expected content

None.

3.20.4. Example

The example below enables the tracing of the parsed scene files and time output during scene browsing. Frames are numbered from number 0 and the application stops when it reaches the frame #1900.

<trace trace_input_file="true" trace_output_frame_number="false" 
  trace_time="true" first_frame_number="0" last_frame_number="1900"/>