Skip to content

Canvas::BlankPage method

Create a blank page on the canvas with the specified properties.

Prototype

void BlankPage(int width, int height, string options)

void BlankPage(int width, int height, string options) throws IGRException;

def BlankPage(self, width: int, height: int, options: string) -> void

void BlankPage(int width, int height, const std::wstring& options)

void BlankPage(int width, int height, std::wstring options)

HRESULT BlankPage([in] int width, [in] int height, [in] BSTR options)

Parameters

width: int : The width of the new page, in pixels.

height: int : The height of the new page, in pixels.

options: string : Canvas processing options to use when creating the new page.

Sample Code

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
using Hyland.DocumentFilters;

var api = new Hyland.DocumentFilters.Api();
api.Initialize("License Code", ".");

using var canvas = api.MakeOutputCanvas("barcode.png", CanvasType.PNG);
canvas.BlankPage(400, 400);
canvas.Annotate(new Hyland.DocumentFilters.Annotations.QrCode {
    Caption = "Hello World",
    Text = "http://www.hyland.com",
    Rect = System.Drawing.Rectangle.FromLTRB(20, 20, 380, 380)
});

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
import com.perceptive.documentfilters.*;

public class GenerateQRCode {
    public static void main(String[] args) {
        try {
            // Initialize the API
            Api api = new Api();
            api.Initialize("License Code", ".");

            // Create an output canvas
            try (Canvas canvas = api.MakeOutputCanvas("barcode.png", CanvasType.PNG.swigValue())) {
                // Create a blank page
                canvas.BlankPage(400, 400);

                // Create and configure the QR code annotation
                AnnotationQrCode qrCode = new AnnotationQrCode();
                qrCode.setCaption("Hello World");
                qrCode.setContent("http://www.hyland.com");
                qrCode.setRect(new AnnotationRect(20, 20, 380, 380));

                // Annotate the canvas
                canvas.Annotate(qrCode);
            }
        } catch (IGRException e) {
            System.err.println("Error: " + e.getMessage());
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
from DocumentFilters import *

api = DocumentFilters()
api.Initialize("License Code", ".")

with api.MakeOutputCanvas("barcode.png", IGR_DEVICE_IMAGE_PNG) as canvas:
    canvas.BlankPage(400, 400)

    anno = AnnotationQrCode()
    anno.Caption = "Hello World"
    anno.Content = "http://www.hyland.com"
    anno.Margin = 8
    anno.ErrorCorrectionLevel = 3
    anno.Rect = AnnotationRect.FromLTRB(20, 20, 380, 380)
    canvas.Annotate(anno)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
#include "DocumentFiltersObjects.h"

int main() {
    try {
        // Create and initialize the API object
        Hyland::DocFilters::Api api;
        api.Initialize("License Code", ".");

        // Create the output canvas 
        Hyland::DocFilters::Canvas canvas = api.MakeOutputCanvas("barcode.png", Hyland::DocFilters::CanvasType::PNG);

        // Set up a blank page
        canvas.BlankPage(400, 400);

        // Create and configure the QR code annotation
        Hyland::DocFilters::AnnotationQrCode qrCode;
        qrCode.setCaption(L"Hello World");
        qrCode.setText(L"http://www.hyland.com");
        qrCode.setRect(Hyland::DocFilters::RectI32::ltrb(20, 20, 380, 380));

        // Add the QR code to the canvas
        canvas.Annotate(qrCode);

        // Close the canvas (ensures the image is saved)
        canvas.Close(); 

    } catch (const std::exception& e) {
        std::cerr << "Error: " << e.what() << std::endl;
        return 1; // Indicate an error
    }

    return 0; // Successful execution
}