PDF: Render PDF page

In This Topic

PDF format is a vector format, so to get a PDF page as raster image it must be rendered. For rendering PDF pages is used PdfPage.Render method. PdfDocument.RenderingSettings property defines the default rendering settings for each page of PDF document.

PdfPage.Render method can return the entire image of page or just a part of it. The image of page can be obtained at any scale, a non-scaled image equals to the image with resolution 96x96 dpi.

Here is C#/VB.NET code that demonstrates how to render PDF page in resolution 300x300 dpi:

/// <summary>
/// Gets PDF page with 300x300 resolution.
/// </summary>
/// <param name="page">The page of PDF document.</param>
public static Vintasoft.Imaging.VintasoftImage GetImage300dpi(
    Vintasoft.Imaging.Pdf.Tree.PdfPage page)
{
    // get the rendering settings of PDF document
    Vintasoft.Imaging.Codecs.Decoders.PdfRenderingSettings renderingSettings = page.Document.RenderingSettings;
    // save previous resolution of rendering settings
    Vintasoft.Imaging.Resolution prevResolution = renderingSettings.Resolution;
    // set new resolution for image rendering
    renderingSettings.Resolution = new Vintasoft.Imaging.Resolution(300, 300);

    // render image of the page
    Vintasoft.Imaging.VintasoftImage image = page.Render();

    // restore resolution of rendering settings
    renderingSettings.Resolution = prevResolution;

    // return the image
    return image;
}

VB.NET

''' <summary>
''' Gets PDF page with 300x300 resolution.
''' </summary>
''' <param name="page">The page of PDF document.</param>
Public Shared Function GetImage300dpi(page As Vintasoft.Imaging.Pdf.Tree.PdfPage) As Vintasoft.Imaging.VintasoftImage
    ' get the rendering settings of PDF document
    Dim renderingSettings As Vintasoft.Imaging.Codecs.Decoders.PdfRenderingSettings = page.Document.RenderingSettings
    ' save previous resolution of rendering settings
    Dim prevResolution As Vintasoft.Imaging.Resolution = renderingSettings.Resolution
    ' set new resolution for image rendering
    renderingSettings.Resolution = New Vintasoft.Imaging.Resolution(300, 300)

    ' render image of the page
    Dim image As Vintasoft.Imaging.VintasoftImage = page.Render()

    ' restore resolution of rendering settings
    renderingSettings.Resolution = prevResolution

    ' return the image
    Return image
End Function

Here is C#/VB.NET code that demonstrates how to render PDF page region in resolution 600x600 dpi:

/// <summary>
/// Gets region of PDF page with 600x600 resolution.
/// </summary>
/// <param name="page">The page of PDF document.</param>
/// <param name="region">The region of page.</param>
public static Vintasoft.Imaging.VintasoftImage GetImage600dpiRegion(
    Vintasoft.Imaging.Pdf.Tree.PdfPage page, System.Drawing.RectangleF region)
{
    // get the rendering settings of PDF document
    Vintasoft.Imaging.Codecs.Decoders.PdfRenderingSettings renderingSettings = page.Document.RenderingSettings;
    // save previous resolution of rendering settings
    Vintasoft.Imaging.Resolution prevResolution = renderingSettings.Resolution;
    // set new resolution for image rendering
    renderingSettings.Resolution = new Vintasoft.Imaging.Resolution(600, 600);

    // render region of PDF page
    Vintasoft.Imaging.VintasoftImage image = page.Render(region, 1.0f);

    // restore resolution of rendering settings
    renderingSettings.Resolution = prevResolution;

    // return the image
    return image;
}

VB.NET

''' <summary>
''' Gets region of PDF page with 600x600 resolution.
''' </summary>
''' <param name="page">The page of PDF document.</param>
''' <param name="region">The region of page.</param>
Public Shared Function GetImage600dpiRegion(page As Vintasoft.Imaging.Pdf.Tree.PdfPage, region As System.Drawing.RectangleF) As Vintasoft.Imaging.VintasoftImage
    ' get the rendering settings of PDF document
    Dim renderingSettings As Vintasoft.Imaging.Codecs.Decoders.PdfRenderingSettings = page.Document.RenderingSettings
    ' save previous resolution of rendering settings
    Dim prevResolution As Vintasoft.Imaging.Resolution = renderingSettings.Resolution
    ' set new resolution for image rendering
    renderingSettings.Resolution = New Vintasoft.Imaging.Resolution(600, 600)

    ' render region of PDF page
    Dim image As Vintasoft.Imaging.VintasoftImage = page.Render(region, 1F)

    ' restore resolution of rendering settings
    renderingSettings.Resolution = prevResolution

    ' return the image
    Return image
End Function

The rendering of PDF page can be performed with progress indication. The rendering of page can be cancelled.

Here is C#/VB.NET code that demonstrates how to render PDF page with progress indication and cancel the rendering process at 80% level:

/// <summary>
/// Cancels rendering of PDF page when progress of rendering is greater than 80%.
/// </summary>
/// <param name="page">The page of PDF document.</param>
public static void CancelRenderingExample(Vintasoft.Imaging.Pdf.Tree.PdfPage page)
{
    // render image of PDF page
    page.Render(new System.EventHandler<Vintasoft.Imaging.ProgressEventArgs>(RenderingProgress));
}

/// <summary>
/// Event handler of rendering progress.
/// </summary>
public static void RenderingProgress(object sender, Vintasoft.Imaging.ProgressEventArgs e)
{
    // if rendering canbe canceled and rendering progress is geater than 80%
    if (e.CanCancel && e.Progress >= 80)
        // cancel rendering
        e.Cancel = true;
}

VB.NET

''' <summary>
''' Cancels rendering of PDF page when progress of rendering is greater than 80%.
''' </summary>
''' <param name="page">The page of PDF document.</param>
Public Shared Sub CancelRenderingExample(page As Vintasoft.Imaging.Pdf.Tree.PdfPage)
    ' render image of PDF page
    page.Render(New System.EventHandler(Of Vintasoft.Imaging.ProgressEventArgs)(AddressOf RenderingProgress))
End Sub

''' <summary>
''' Event handler of rendering progress.
''' </summary>
Public Shared Sub RenderingProgress(sender As Object, e As Vintasoft.Imaging.ProgressEventArgs)
    ' if rendering canbe canceled and rendering progress is geater than 80%
    If e.CanCancel AndAlso e.Progress >= 80 Then
        ' cancel rendering
        e.Cancel = True
    End If
End Sub

Also PdfPage.Render method supports a progressive rendering of PDF page.

Here is C#/VB.NET code that demonstrates how to render PDF page progressively:

/// <summary>
/// The timer for getting intermediate images.
/// </summary>
public System.Diagnostics.Stopwatch _timer = new System.Diagnostics.Stopwatch();

/// <summary>
/// The index of intermediate image.
/// </summary>
public int _intermediateImageIndex = 0;

/// <summary>
/// Time interval, in milliseconds, for getting intermediate image during rendering.
/// </summary>
public int INTERMEDIATE_RENDER_IMAGE_INTERVAL = 300;



/// <summary>
/// Gets the image of PDF page.
/// </summary>
/// <param name="page">The page of PDF document.</param>
public Vintasoft.Imaging.VintasoftImage RenderPdfPageProgressively(
    Vintasoft.Imaging.Pdf.Tree.PdfPage page)
{
    _intermediateImageIndex = 0;
    // start timer
    _timer.Start();

    // render PDF page progressively
    Vintasoft.Imaging.VintasoftImage image = page.Render(page.CropBox, 1.0f, null,
        new System.EventHandler<Vintasoft.Imaging.ImageRendering.IntermediateImageRequestEventArgs>(IntermediateImageRequest));

    // stop timer
    _timer.Stop();

    // return the result image
    return image;
}

/// <summary>
/// Handler of event that occurs when intermediate image is ready and can be obtained.
/// </summary>
public void IntermediateImageRequest(object sender, Vintasoft.Imaging.ImageRendering.IntermediateImageRequestEventArgs e)
{
    // if intermediate image must be saved
    if (_timer.ElapsedMilliseconds >= INTERMEDIATE_RENDER_IMAGE_INTERVAL)
    {
        // reset timer
        _timer.Reset();
        // set the delegate which invoked for obtaining the intermediate image
        e.IntermediateImageCompleted =
            new Vintasoft.Imaging.ImageRendering.IntermediateImageCompletedDelegate(IntermediateImageReady);
        // start timer
        _timer.Start();
    }
}

/// <summary>
/// Delegate that allows to obtain intermediate image.
/// </summary>
public void IntermediateImageReady(Vintasoft.Imaging.ImageRendering.IntermediateImageReadyEventArgs e)
{
    // increment counter of intermediate images
    _intermediateImageIndex++;

    // clone the rendered image
    using (Vintasoft.Imaging.VintasoftImage image =
        (Vintasoft.Imaging.VintasoftImage)e.Image.Clone())
    {
        string filename = string.Format("IntermediateImage_{0}.bmp", _intermediateImageIndex.ToString("00"));
        // save the intermediate image to a file
        image.Save(filename);
    }
}

VB.NET

''' <summary>
''' The timer for getting intermediate images.
''' </summary>
Public _timer As New System.Diagnostics.Stopwatch()

''' <summary>
''' The index of intermediate image.
''' </summary>
Public _intermediateImageIndex As Integer = 0

''' <summary>
''' Time interval, in milliseconds, for getting intermediate image during rendering.
''' </summary>
Public INTERMEDIATE_RENDER_IMAGE_INTERVAL As Integer = 300



''' <summary>
''' Gets the image of PDF page.
''' </summary>
''' <param name="page">The page of PDF document.</param>
Public Function RenderPdfPageProgressively(page As Vintasoft.Imaging.Pdf.Tree.PdfPage) As Vintasoft.Imaging.VintasoftImage
    _intermediateImageIndex = 0
    ' start timer
    _timer.Start()

    ' render PDF page progressively
    Dim image As Vintasoft.Imaging.VintasoftImage = page.Render(page.CropBox, 1F, Nothing, New System.EventHandler(Of Vintasoft.Imaging.ImageRendering.IntermediateImageRequestEventArgs)(AddressOf IntermediateImageRequest))

    ' stop timer
    _timer.[Stop]()

    ' return the result image
    Return image
End Function

''' <summary>
''' Handler of event that occurs when intermediate image is ready and can be obtained.
''' </summary>
Public Sub IntermediateImageRequest(sender As Object, e As Vintasoft.Imaging.ImageRendering.IntermediateImageRequestEventArgs)
    ' if intermediate image must be saved
    If _timer.ElapsedMilliseconds >= INTERMEDIATE_RENDER_IMAGE_INTERVAL Then
        ' reset timer
        _timer.Reset()
        ' set the delegate which invoked for obtaining the intermediate image
        e.IntermediateImageCompleted = New Vintasoft.Imaging.ImageRendering.IntermediateImageCompletedDelegate(AddressOf IntermediateImageReady)
        ' start timer
        _timer.Start()
    End If
End Sub

''' <summary>
''' Delegate that allows to obtain intermediate image.
''' </summary>
Public Sub IntermediateImageReady(e As Vintasoft.Imaging.ImageRendering.IntermediateImageReadyEventArgs)
    ' increment counter of intermediate images
    _intermediateImageIndex += 1

    ' clone the rendered image
    Using image As Vintasoft.Imaging.VintasoftImage = DirectCast(e.Image.Clone(), Vintasoft.Imaging.VintasoftImage)
        Dim filename As String = String.Format("IntermediateImage_{0}.bmp", _intermediateImageIndex.ToString("00"))
        ' save the intermediate image to a file
        image.Save(filename)
    End Using
End Sub

Render PDF pages with annotations

A PDF page may be rendered with or without annotations.

Here is C#/VB.NET code that demonstrates how to render PDF page with annotations:

/// <summary>
/// Renders PDF page with the PDF annotations.
/// </summary>
/// <param name="page">The page of PDF document.</param>
public static Vintasoft.Imaging.VintasoftImage RenderPdfPageWithPdfAnnotations(
    Vintasoft.Imaging.Pdf.Tree.PdfPage page)
{
    // get rendering settings of PDF page
    Vintasoft.Imaging.Codecs.Decoders.PdfRenderingSettings renderingSettings = page.Document.RenderingSettings;
    // save previous value of PdfRenderingSettings.DrawPdfAnnotations property
    bool prevDrawPdfAnnotations = renderingSettings.DrawPdfAnnotations;
    // enable rendering of PDF annotations on PDF page
    renderingSettings.DrawPdfAnnotations = true;

    // render PDF page
    Vintasoft.Imaging.VintasoftImage image = page.Render();

    // restore value of PdfRenderingSettings.DrawPdfAnnotations property
    renderingSettings.DrawPdfAnnotations = prevDrawPdfAnnotations;

    // return the image of PDF page
    return image;
}

VB.NET

''' <summary>
''' Renders PDF page with the PDF annotations.
''' </summary>
''' <param name="page">The page of PDF document.</param>
Public Shared Function RenderPdfPageWithPdfAnnotations(page As Vintasoft.Imaging.Pdf.Tree.PdfPage) As Vintasoft.Imaging.VintasoftImage
    ' get rendering settings of PDF page
    Dim renderingSettings As Vintasoft.Imaging.Codecs.Decoders.PdfRenderingSettings = page.Document.RenderingSettings
    ' save previous value of PdfRenderingSettings.DrawPdfAnnotations property
    Dim prevDrawPdfAnnotations As Boolean = renderingSettings.DrawPdfAnnotations
    ' enable rendering of PDF annotations on PDF page
    renderingSettings.DrawPdfAnnotations = True

    ' render PDF page
    Dim image As Vintasoft.Imaging.VintasoftImage = page.Render()

    ' restore value of PdfRenderingSettings.DrawPdfAnnotations property
    renderingSettings.DrawPdfAnnotations = prevDrawPdfAnnotations

    ' return the image of PDF page
    Return image
End Function

Render PDF pages with the use of optional content groups (OCG)

A PDF page can be rendered with the use of optional content groups (OCG), which are sometimes named - layers. The SDK allows to obtain a list of layers and show/hide the specified layers while rendering PDF page.

Here is C#/VB.NET code that demonstrates how to render PDF pages with the use of optional content groups:

/// <summary>
/// Renders PDF page with the optional content group.
/// </summary>
/// <param name="page">The page of PDF document.</param>
public static Vintasoft.Imaging.VintasoftImage RenderPdfPageWithOptionalContentGroup(
    Vintasoft.Imaging.Pdf.Tree.PdfPage page)
{
    // get PDF document of page
    Vintasoft.Imaging.Pdf.PdfDocument document = page.Document;

    // if document has optional content groups then
    if (document.OptionalContentProperties != null &&
        document.OptionalContentProperties.OptionalContentGroups != null)
    {
        // get a list of optional content groups of PDF document
        System.Collections.Generic.IList<Vintasoft.Imaging.Pdf.Tree.OptionalContent.PdfOptionalContentGroup> allGroups =
            document.OptionalContentProperties.OptionalContentGroups;

        // for each optional content group
        foreach (Vintasoft.Imaging.Pdf.Tree.OptionalContent.PdfOptionalContentGroup group in allGroups)
            // set the optional content group as invisible
            document.OptionalContentConfiguration.SetGroupVisibility(group, false);
    }

    // render PDF page
    Vintasoft.Imaging.VintasoftImage image = page.Render();

    // return the image of PDF page
    return image;
}

VB.NET

''' <summary>
''' Renders PDF page with the optional content group.
''' </summary>
''' <param name="page">The page of PDF document.</param>
Public Shared Function RenderPdfPageWithOptionalContentGroup(page As Vintasoft.Imaging.Pdf.Tree.PdfPage) As Vintasoft.Imaging.VintasoftImage
    ' get PDF document of page
    Dim document As Vintasoft.Imaging.Pdf.PdfDocument = page.Document

    ' if document has optional content groups then
    If document.OptionalContentProperties IsNot Nothing AndAlso document.OptionalContentProperties.OptionalContentGroups IsNot Nothing Then
        ' get a list of optional content groups of PDF document
        Dim allGroups As System.Collections.Generic.IList(Of Vintasoft.Imaging.Pdf.Tree.OptionalContent.PdfOptionalContentGroup) = document.OptionalContentProperties.OptionalContentGroups

        ' for each optional content group
        For Each group As Vintasoft.Imaging.Pdf.Tree.OptionalContent.PdfOptionalContentGroup In allGroups
            ' set the optional content group as invisible
            document.OptionalContentConfiguration.SetGroupVisibility(group, False)
        Next
    End If

    ' render PDF page
    Dim image As Vintasoft.Imaging.VintasoftImage = page.Render()

    ' return the image of PDF page
    Return image
End Function

Color management while rendering page

PDF page can be rendered with enabled color management. The PdfDocument.DecodingSettings property defines the default color management settings that should be used when PDF page is rendered.

Here is C#/VB.NET code that demonstrates how to render PDF page with enabled color management:

/// <summary>
/// Renders PDF page with enabled color management.
/// </summary>
/// <param name="page">The PDF page.</param>
/// <param name="iccProfile">The ICC profile that should be applied to PDF page.</param>
public static Vintasoft.Imaging.VintasoftImage RenderPdfPageWithEnabledColorManagement(
    Vintasoft.Imaging.Pdf.Tree.PdfPage page,
    Vintasoft.Imaging.ColorManagement.Icc.IccProfile iccProfile)
{
    // if decoding settings are NOT specified
    if (page.Document.DecodingSettings == null)
        // create the default decoding settings
        page.Document.DecodingSettings = new Vintasoft.Imaging.Codecs.Decoders.DecodingSettings();

    // get the decoding setting of PDF document
    Vintasoft.Imaging.Codecs.Decoders.DecodingSettings decodingSettings = page.Document.DecodingSettings;
    // if color management decoding settings is NOT enabled
    if (decodingSettings.ColorManagement == null)
        // create the default color management decoding settings
        decodingSettings.ColorManagement = new Vintasoft.Imaging.ColorManagement.ColorManagementDecodeSettings();

    // set the ICC profile that should be applied to PDF page
    decodingSettings.ColorManagement.InputCmykProfile = iccProfile;

    // render PDF page
    Vintasoft.Imaging.VintasoftImage image = page.Render();

    // return the image of PDF page
    return image;
}

VB.NET

''' <summary>
''' Renders PDF page with enabled color management.
''' </summary>
''' <param name="page">The PDF page.</param>
''' <param name="iccProfile">The ICC profile that should be applied to PDF page.</param>
Public Shared Function RenderPdfPageWithEnabledColorManagement(page As Vintasoft.Imaging.Pdf.Tree.PdfPage, iccProfile As Vintasoft.Imaging.ColorManagement.Icc.IccProfile) As Vintasoft.Imaging.VintasoftImage
    ' if decoding settings are NOT specified
    If page.Document.DecodingSettings Is Nothing Then
        ' create the default decoding settings
        page.Document.DecodingSettings = New Vintasoft.Imaging.Codecs.Decoders.DecodingSettings()
    End If

    ' get the decoding setting of PDF document
    Dim decodingSettings As Vintasoft.Imaging.Codecs.Decoders.DecodingSettings = page.Document.DecodingSettings
    ' if color management decoding settings is NOT enabled
    If decodingSettings.ColorManagement Is Nothing Then
        ' create the default color management decoding settings
        decodingSettings.ColorManagement = New Vintasoft.Imaging.ColorManagement.ColorManagementDecodeSettings()
    End If

    ' set the ICC profile that should be applied to PDF page
    decodingSettings.ColorManagement.InputCmykProfile = iccProfile

    ' render PDF page
    Dim image As Vintasoft.Imaging.VintasoftImage = page.Render()

    ' return the image of PDF page
    Return image
End Function

Send Feedback