New to Telerik Reporting? Download free 30-day trial

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": "JOEG"
        }
    ]
    },
    {
        "name": "IMAGEPrint",
        "parameters": [
        {
            "Name": "OutputFormat",
            "Value": "PNG"
        },
        {
            "Name": "TextRenderingHint",
            "Value": "AntiAliasGridFit"
        },
        {
            "Name": "DpiX",
            "Value": "1200"
        },
        {
            "Name": "DpiY",
            "Value": "1200"
        },
    ]
    }
    ]
}

See Also

In this article