New to Telerik ReportingStart a 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.

NameTypeDescription
OutputFormatStringDefines 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. If you provide an invalid 'OutputFormat', for example, 'PDF', the extension will fall back to BMP.
StartPageIntegerThe first page of the report to render. A value of 0 indicates that all pages are rendered.
EndPageIntegerThe last page of the report to render.
DpiXIntegerThe resolution of the output image in the x-direction. The default value is 96.
DpiYIntegerThe resolution of the output image in the y-direction. The default value is 96.
TiffCompressionStringSpecifies 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.
TextRenderingHintstringSets 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
<configuration>
	<configSections>
		<section name="Telerik.Reporting" type="Telerik.Reporting.Configuration.ReportingConfigurationSection, Telerik.Reporting" allowLocation="true" allowDefinition="Everywhere" />
	</configSections>
	<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>

See Also