Igneus

XML Reference

Tag name:

Renderer

Base class:

None

Type:

Static object

Description:

The viewport renderer is responsible for projecting primary rays to compose the final rendered image.

Syntax:

The hemisphere attribute determines the resolution of the spread of samples taken to calculate the irradiance at each point on the surface.

minsamples		Sets the initial number of samples cast per pixel
maxsamples		Sets the maximum number of samples that may be cast per pixel
tolerance		Sets the standard deviation threshold which determines whether more samples will be taken

The illumination attribute allows certain components of incoming illumination to be selectively enabled and disabled

type		Select between a pinhole and thin lens camera model. The pinhole camera assumes an infinitely small aperture and no lens. As such, no focussing is required since there is infinite depth of field. The thin lens camera model has a focal length and an f-stop. This allows for depth of field bur, Bokeh and other focussing effects.
fstop		The f-stop (also called the f-number) represents the diameter of the aperture as a function of the focal length of the lens. Setting the focal length is done in the 3D package by specifying a targeted camera. The f-stop can be calculated as being N = f/D where N is the f-stop, f is the focal length of the lens in millimeters and D is the diameter of the aperture. Therefore, a small value of N will reduce the depth of field and generate more depth of field blur. A large value of N will have the opposite effect.
apertureblades		When the thin lens camera model is selected, primary rays are constrained to an aperture map in the same shape as a camera shutter. Shutters are typically comprised of a number of blades which control the amount of light allowed to expose the film. In images with small, bright highlights, out of focus regions generate bright "circles of confusion" which assume the shape of the aperture. This effect is known as Bokeh and is considered by some to be aesthetically pleasing.
bladeangle		Rotates the aperture blade map. Angles in degrees.

This tag exposes the same parameters as the post processing tab in the status window.

exposure		The exposure value specifies a linear mapping whereby each pixel is multiplied by the exposure coefficient.
gamma		Specifies the gamma exponent for each pixel. Adjusting the gamma has a more pronounced effect on on the darker values in the image.
offset		The offset value is added to each pixel in each channel. Adjusting this value is effective at deepening shadows with mininmal effect on highlights.

Igneus uses the tone mapping algorithm suggested by Reinhard et al.

enabled		Enables/disables tonemapping
burnout		The burnout coefficient specifies the smallest luminance that will be mapped to the maximum allowed brightness of the low dynamic range image. A value of 1 for this parameter will make the brightest pixel in the image map to 255 in the display range. A value greater than 1 will cause certain areas in the image to appear over-exposed.
keyvalue		The key value controls the scaling of the HDR to the LDR image. A higher value will result in a brighter image, although too large a value will result in the image appearing washed out.

The colour temperature filter applies a normalised black body radiance to each pixel in the image. This allows the image to be "warmed" or "cooled". For example, an image rendered with the physical sky at sunset might seem too warm. Applying this filter with a high temperature cancels out the warmer colours making the image feel cooler.

enabled		Enables/disables colour temperature mapping
value		Specifies the temperature of the black body in Kelvins

</postprocessing>

</renderer>