Renderers

Renderers allow defining default values or restrictions that apply to every incoming request. Every request is processed using the rules in a renderer. If no renderer name is given in the HTTP parameters, the default renderer will be used. A renderer defines how to render an image or a metadata response, which default values the image renderer will use and which file format is returned. The renderer name is given by the filename. Each renderer definition may include up to six sections: 

Image Renderer

Defines the renderer to use when an image request is directed at this profile and which default values and limits apply when rendering the image. The renderer to use is selected by specifying an "implementation" node which contains the class name of the renderer. If the "implementation" node is omitted then the default renderer will be used.

Depending on the chosen renderer implementation further nodes may define parameters for the renderer.

InfoRenderer

Currently only the default info renderer is delivered with FSI Server, therefore this node can be omitted.

List Renderer

Currently only the default list renderer is delivered with FSI Server, therefore this node can be omitted. 

OutputEffects

This optional section provides the ability to define output effects that will be applied to every image accessed via this profile. Effects are defined by a list of <effects> tags containing effect commands using the same syntax as in image URLs. See "Real-time Image Effects".

OutputCompression

Defines the output format and options for responses to image requests.

Compressor

Specifies the output file format, one of JPG, PNG, GIF and SWF.

Quality

Defines the default jpeg compression quality. Please note that requests containing the quality parameter can override this setting. The setting applies to JPG and SWF only.

Chroma Subsampling

Defines the chroma subsampling parameter used to encode JPG images. Possible values are: "4:4:4", "4:2:2" and "4:2:0". This setting applies to JPG and SWF only. 

Compression Level

Defines the compression level used when encoding an image as PNG. Possible values range from 0 to 9.

Compression Filter

Defines the pre-compression filtering method used when encoding an image as PNG. Possible values are "none" and "sub". This setting only applies to PNG output.

Colorspace

Defines the color space of a PNG output image. Values: "rgb" or "gray".

Embed ICC

Defines whether to embed the used ICC profile into the output image. This setting applies to PNG and JPG output only.

Encoding

Defines whether to send the output image to the client as base 64 encoded data or not. Possible values are "image" and "base64".