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"
},
]
}
]
}