Image Device Information Settings
The following table lists the device information settings for rendering in IMAGE, IMAGEPrintPreview and IMAGEPrint formats.
Image Device Information Settings
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"
},
]
}
]
}