Home / Community & Support / Knowledge Base / Telerik Reporting / Customization / Configuring the Image Rendering Extension to generate TIFF files

Configuring the Image Rendering Extension to generate TIFF files

Article Info

Rating: 5

Article information

Article relates to

Telerik Reporting Q2 2009 (v3.0)+

Created by

 Svetoslav, Telerik

Last modified

 06 August, 2009

Last modified by

 Steve, Telerik


HOW-TO
Configure the Image Rendering Extension to Generate TIFF Files

SOLUTION
By default the Image Rendering Extension generates TIFF files with LZW compression and resolution 96 x 96 dpi. In case you need bi-tonal (black and white) images, for example when you need to send the rendered report by fax, you may consider using any of the CCITT Group 3/Group 4 or RLE compressions which will produce files with smaller size.

In Telerik Reporting, device information settings are used to pass rendering parameters to a rendering extension.

You can specify device information settings in a variety of ways. You can use the <Telerik.Reporting> configuration section to specify rendering parameters globally. Programmatically, you can use the ReportProcessor.RenderReport() method. For more information about specifying rendering parameters globally, see Configuring Telerik Reporting.
The example below shows a sample application configuration file (App.config or Web.config depending on whether it is a Windows Forms or ASP.NET application) in which we modify the original Image rendering extension settings to generate high resolution (300 x 300 dpi) images and register four new formats that use the CCITT G3/G4, RLE and None compressions.

<?xml version="1.0"?> 
<configuration> 
  <!-- The configSectins element should be the first child element of configuration --> 
  <configSections> 
    <section 
      name="Telerik.Reporting" 
      type="Telerik.Reporting.Processing.Config.ReportingConfigurationSection, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be" 
      allowLocation="true" 
      allowDefinition="Everywhere"/> 
  </configSections> 
    <!-- Substitute Version=X.X.X.X with the assembly version you are using! --> 
  <Telerik.Reporting> 
    <Extensions> 
      <Render> 
        <!--This is the original Image rendering extension with modified settings to output high resolution TIFF – 300 x 300 dpi. Also we override the description attribute to hint on the changed resolution.--> 
        <Extension name="Image" description="TIFF file Hi res"> 
          <Parameters> 
            <Parameter name="DpiX" value="300" /> 
            <Parameter name="DpiY" value="300" /> 
          </Parameters> 
        </Extension> 
        <!--Each of the next Extension tags adds a new rendering extension with unique name. The value provided for the TiffCompression parameter defines the compression method to be used. The description attribute is the string to be displayed in the viewer controls, so that the end users can distinguish the export options.--> 
        <Extension name="TIFF_CCITT3" 
                   type="Telerik.Reporting.ImageRendering.ImageReport, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be" 
                   description="TIFF file (CCITT Group 3)"> 
          <Parameters> 
            <Parameter name="TiffCompression" value="ccitt3" /> 
          </Parameters> 
        </Extension> 
        <Extension name="TIFF_CCITT4" 
                   type="Telerik.Reporting.ImageRendering.ImageReport, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be" 
                   description="TIFF file (CCITT Group 4)"> 
          <Parameters> 
            <Parameter name="TiffCompression" value="ccitt4" /> 
          </Parameters> 
        </Extension> 
        <Extension name="TIFF_RLE" 
                   type="Telerik.Reporting.ImageRendering.ImageReport, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be" 
                   description="TIFF file (Rle)"> 
          <Parameters> 
            <Parameter name="TiffCompression" value="rle" /> 
          </Parameters> 
        </Extension> 
        <Extension name="TIFF_NONE" 
                   type="Telerik.Reporting.ImageRendering.ImageReport, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be" 
                   description="TIFF file (None)"> 
          <Parameters> 
            <Parameter name="TiffCompression" value="none" /> 
          </Parameters> 
        </Extension> 
      </Render> 
    </Extensions> 
  </Telerik.Reporting>   
</configuration> 
 

As a result, in the Report Viewer's drop-down with the available export formats, you will see all of the above registered TIFF extensions.


 
 
SEE ALSO

Comments

If you'd like to comment on this KB article, please, send us a Support Ticket.
Thank you!

Please Sign In to rate this article.