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.