New to Telerik UI for WinForms? Download free 30-day trial

Customize PDF Rendering

RadPdfViewer provides some customization options for the way PDF documents are rendered.

Creating a Decoder

When rendering the text, RadPdfViewer uses different decoders. It finds the decoder that it needs to use by its name. These are the decoders that can be plugged:

  • ASCIIHexDecode

  • ASCII85Decode

  • LZWDecode

  • FlateDecode

  • RunLengthDecode

  • CCITTFaxDecode

  • JBIG2Decode

  • DCTDecode

  • JPXDecode

The following table indicates the status of the respective decoders in RadPdfViewer:

Fully supported Partially supported Not supported
ASCII85Decode CCITTFaxDecode JPXDecode (A sample implemnetation of the decoder is available here )
LZWDecode
FlateDecode
DCTDecode
ASCIIHexDecode
RunLengthDecode
JBIG2Decode

All decoders implement the IPdfFilter interface and if you decide, you can implement your own decoder and set the viewer to use it. RadPdfViewer uses the Name property in order to recognize the filter - it must return one of the values listed above.

For example, you can create a custom decoder for Tiff images by implementing the interface and setting the Name of the filter to CCITTFaxDecode. Then, just register the new class by calling FiltersManager.RegisterFilter() method and the viewer will use your implementation instead of the default one.

Inheriting from IPdfFilter will result in the following:

Creating Custom Filter


public class CustomFilter : Telerik.Windows.Documents.Fixed.FormatProviders.Pdf.Filters.IPdfFilter
{
    public byte[] Encode(PdfObject encodedObject, byte[] inputData)
    {
        throw new NotImplementedException();
    }

    public byte[] Decode(PdfObject decodedObject, byte[] inputData, DecodeParameters decodeParameters)
    {
        throw new NotImplementedException();
    }

    public string Name
    {
        get
        {
            throw new NotImplementedException();
        }
    }
}

Public Class CustomFilter
    Implements Telerik.Windows.Documents.Fixed.FormatProviders.Pdf.Filters.IPdfFilter
    Public Function Encode(encodedObject As PdfObject, inputData As Byte()) As Byte() Implements IPdfFilter.Encode
        ' TODO: Implement this method
        Throw New NotImplementedException()
    End Function
    Public Function Decode(decodedObject As PdfObject, inputData As Byte(), _
                           decodeParameters As DecodeParameters) As Byte() Implements IPdfFilter.Decode
        ' TODO: Implement this method
        Throw New NotImplementedException()
    End Function
    Public ReadOnly Property Name() As String Implements IPdfFilter.Name
        Get
            ' TODO: Implement this property getter
            Throw New NotImplementedException()
        End Get
    End Property
End Class

You should also register the filter as follows:

Registering Filters


private CustomFilter _filter;

public PdfDecoder()
{
    InitializeComponent();

    _filter = new CustomFilter();
    FiltersManager.RegisterFilter(_filter );
}

Private _filter As CustomFilter
Public Sub New()
    InitializeComponent()
    _filter = New CustomFilter()
    FiltersManager.RegisterFilter(_filter)
End Sub

The result that a custom filter should return depends on the type of the filter. For the binary filters it is enough to decode the byte array into decoded byte array using the respective algorithm. As for the filters listed below, additional transformation is required.

RadPdfViewer expects these filters to return data that depends on the decoded object's colors space and bits per component (there are such properties in the decodedObject). The resulting byte array should contain exactly BitsPerComponent bits for each color component in the color space. For example, if you have RGB color space and 8 bits per component, the resulting byte array should contains a single byte value for each Red, Green and Blue value (for each pixel) in the decoded image.

  • CCITTFaxDecode

  • JBIG2Decode

  • JPXDecode

  • DCTDecode

    You can override the DctDecode class and its Decode() method. This will enable you to call the DecodeWithJpegDecode() method in order to achieve backward compatibility by using Telerik's JpegDecoder. In some cases, this approach decodes faster than the BitmapImage class, which is currently used to decode the images.

    RadPdfViewer expects these filters to return data that depends on the decoded object's colors space and bits per component (there are such properties in the decodedObject). The resulting byte array should contain exactly BitsPerComponent bits for each color component in the color space. For example, if you have RGB color space and 8 bits per component, the resulting byte array should contains a single byte value for each Red, Green and Blue value (for each pixel) in the decoded image.

See Also

In this article