File Rendering Configurations

File rendering configurations combine most settings and other data components required when rendering a 'final' image into a disk file. For example, image resolution and rendering quality settings are part of the configuration data. Often, in addition to selecting a suitable file rendering configuration, the user only has to make sure that a suitable camera object is included in the scene.

The 'Configuration' field contains a list of file rendering configurations. Selecting 'New' from the end of the list adds a new item to the list. It can be renamed and edited as appropriate, and saved to disk for later use.

The file rendering system supports simultaneous output to several files or other output targets (a preview window etc. may be also included). The following output controls are available:

File formats can be added also by drag and dropping them from the select window's 'Output Objects' tab into the active format list.

[Note] Note
You cannot add the same format twice to the active list, because the items on the active list are identified by the output object name. If you, for some unusual reason, truly want to output two identical files, create a duplicate of the format object at the select window and rename it.


Rendering quality settings and post processing settings can be select as follows:

  • Rendering Settings: The render settings object which defines ray tracing quality and other photorealistic rendering options.

  • Effect/Box: The post processing configuration (post image) which is executed for all rendered images and image sub regions.


These controls define the pixel resolution of the outputted images.

  • Width: Image accuracy in horizontal direction (pixels)

  • Height: Image accuracy in vertical direction

Box Rendering

The 'Render Box' controls limit the rendering to a sub area of the total image. For example, it may happen that after spending one whole day for high resolution rendering of a complex scene, the user notices that the color of a small object at the top left corner was wrong.

Instead of re-rendering the whole scene, the user can render one quarter of the total image width and one quarter of the total height around the object to a new file. The position of the new sub image is known accurately and therefore it can be pasted over the original image using a paint or image processing program.

The controls are:

Name Indexing

The 'Name Indexing' controls define how the file name is generated from the actual file name and the current frame number. Rendered images are named as follows:


For example:


The first portion is the file name defined by the user (such as d:\mypics\test). Index is the current frame plus the base index definedthrough the 'Base index' field. The number of digits in the index portion is automatically extracted from the number of frames in the animation. For example, if the length of the animation is 120 frames, the index portion contains three digits. The extension is determined by the selected file format.

The indexing controls are:

Frame Commands

The 'Frame Commands' area contains four command gadgets. The commands can be defined using any of the installed scripting languages. In addition to this, DOS (or shell) scripts can also be used.

The following commands can be defined:

The frame command can access the file name via the following predefined macros:

[image] - Full name of the rendered image, for example 'd:\images\test000.bmp'.[path] - Path portion of the file name without the last path separator, such as 'd:\images'.[base] - Base name (i.e. path and extension removed). For example 'test'.[ext] - Extension without the dot. For example 'bmp'.

For example, if the file name is d:\realsoft3d\images\test.bmp:

[path] - results in 'd:\realsoft3d\images' [path]\[base].[ext] is the same as [image] - 'd:\realsoft3d\images\test.bmp'. [path]\[base].tga results 'd:\realsoft3d\images\test.tga'