Device Information Settings for the Image Rendering Formats

The following table lists the device information settings for rendering in IMAGE, IMAGEPrintPreview and IMAGEPrint formats.

Available Image Device Information settings

The names of the properties in Device Information Settings are Case-Sensitive.

Name	Type	Description
OutputFormat	String	Defines the output format of the produced image. Supported formats are: BMP, EMF, EMFPLUS, GIF, JPEG, PNG, or TIFF. The default value for IMAGE rendering extension is TIFF. The default value for IMAGEPrint and IMAGEPrintPreview rendering extensions is EMF.
StartPage	Integer	The first page of the report to render. A value of 0 indicates that all pages are rendered.
EndPage	Integer	The last page of the report to render.
DpiX	Integer	The resolution of the output image in x-direction. The default value is 96.
DpiY	Integer	The resolution of the output image in y-direction. The default value is 96.
TiffCompression	String	Specifies the compression scheme of the output TIFF file. Respected only when OutputFormat is set to TIFF. Supported compression kinds are: LZW, CCITT3, CCITT4, RLE, or NONE. The default value is LZW.
TextRenderingHint	string	Sets the rendering mode for text using a TextRenderingHint enumeration member. The default value depends on the machine settings - if it has ClearType enabled, then ClearTypeGridFit will be used. Otherwise the rendering algorithm will use AntiAliasGridFit hinting. If text rendering hinting is not supported, the SystemDefault value will be used.

For a detailed example of how to set up the settings for a rendering extension, see extensions Element.

Example

The following example demonstrates how to configure the settings for IMAGE, IMAGEPrintPreview and IMAGEPrint formats.

XML-based configuration file:

<configuration>
…
    <Telerik.Reporting>
        <extensions>
            <render>
                <extension name="IMAGE">
                    <parameters>
                        <parameter name="OutputFormat" value="TIFF"/>
                        <parameter name="TiffCompression" value="RLE"/>
                    </parameters>
                </extension>
                <extension name="IMAGEPrintPreview">
                    <parameters>
                        <parameter name="OutputFormat" value="JPEG"/>
                    </parameters>
                </extension>
                <extension name="IMAGEPrint">
                    <parameters>
                        <parameter name="OutputFormat" value="PNG"/>
                        <parameter name="TextRenderingHint" value="AntiAliasGridFit"/>
                        <parameter name="DpiX" value="1200"/>
                        <parameter name="DpiY" value="1200"/>
                    </parameters>
                </extension>
            </render>
        </extensions>
    </Telerik.Reporting>
…
</configuration>

JSON-based configuration file:

"telerikReporting": {
    "extensions": [
    {
        "name": "IMAGE",
        "parameters": [
        {
            "Name": "OutputFormat",
            "Value": "TIFF"
        },
        {
            "Name": "TiffCompression",
            "Value": "RLE"
        }
    ]
    },
    {
        "name": "IMAGEPrintPreview",
        "parameters": [
        {
            "Name": "OutputFormat",
            "Value": "JPEG"
        }
    ]
    },
    {
        "name": "IMAGEPrint",
        "parameters": [
        {
            "Name": "OutputFormat",
            "Value": "PNG"
        },
        {
            "Name": "TextRenderingHint",
            "Value": "AntiAliasGridFit"
        },
        {
            "Name": "DpiX",
            "Value": "1200"
        },
        {
            "Name": "DpiY",
            "Value": "1200"
        },
    ]
    }
    ]
}

See Also

• Device Information Settings
• Export Formats