3.2 Laden von Seiten als Vektorpinsel

Mit dem Plugin lassen sich PDF-Seiten bequem als Vektorpinsel laden. Übergeben Sie einfach die Seite, die geladen werden soll, an das Benutzer-Tag namens Page, und das Plugin lädt die angegebene Seite. Dieser Code lädt beispielsweise Seite 10 als Vektorpinsel 1:

 
LoadBrush(1, "test.pdf", {UserTags = {Page = 10}})

Wenn das Benutzer-Tag Page nicht angegeben wird, wird standardmäßig der Wert 1 verwendet, was bedeutet, dass die erste Seite geladen wird. Standardmäßig werden die Seitenhintergründe mit einem statischen weißen Hintergrund ausgefüllt. Wenn Sie stattdessen einen transparenten Hintergrund wünschen, setzen Sie das Benutzer-Tag Transparent auf True, z.B. wie folgt:

 
LoadBrush(1, "test.pdf", {UserTags = {Page = 10, Transparent = True}})

In diesem Fall wird der Hintergrund der Seite transparent gemacht. Schließlich können Sie auch ein Benutzer-Tag namens Password angeben, um ein Passwort festzulegen, falls die PDF-Datei passwortgeschützt ist.

Beachten Sie, dass es speichersparender ist, wenn Sie mehrere Seiten gleichzeitig als Vektorpinsel laden müssen: Öffnen Sie die PDF-Datei zunächst mit pdf.OpenDocument() und rufen Sie dann die Vektorpinsel der einzelnen Seiten mit pdf.GetBrush() ab. Wenn Sie LoadBrush() oder @BRUSH verwenden, wird für jede Seite, die Sie in einen Vektorpinsel konvertieren, das gesamte PDF in den Arbeitsspeicher geladen, was sehr viel Speicherplatz beanspruchen kann. Wenn Sie pdf.OpenDocument() und anschließend pdf.GetBrush() verwenden, um Vektorpinsel der einzelnen Seiten abzurufen, wird die PDF-Datei nur einmal im Speicher geladen.

Hier ist ein Beispiel dafür, wie man PDF-Seiten mithilfe der Funktion pdf.OpenDocument() und des Befehls pdf.GetBrush() in Vektorpinsel umwandelt:

 
pdf.OpenDocument(1, "test.pdf")
pdf.GetBrush(1, 1, 1)
DisplayBrush(1, #CENTER, #CENTER)
FreeBrush(1)
pdf.CloseDocument(1)

Der obige Code öffnet das PDF-Dokument mit dem Namen test.pdf und konvertiert seine erste Seite in einen Vektorpinsel. Es zeigt dann diesen Vektorpinsel in der Mitte des Displays. Beachten Sie, dass der Vektorpinsel immer noch vom PDF-Dokument abhängig ist. Daher ist es nicht erlaubt, den Befehl pdf.CloseDocument() im Dokument aufzurufen, solange Sie den Pinsel noch benötigen. Deshalb müssen wir zuerst den Pinsel aus dem Speicher löschen und schließen anschließend das Dokument. Andernfalls wird ein Fehler angezeigt.

Sie können die Anzahl der Seiten im PDF-Dokument ermitteln, indem Sie zuerst den Objekttyp für PDF-Dokumente ermitteln und dann den Befehl GetAttribute() von Hollywood verwenden:

 
PDF_DOCUMENT = pdf.GetObjectType()
numpages = GetAttribute(PDF_DOCUMENT, 1, #PDFATTRPAGES)

Der obige Code ermittelt die Anzahl der Seiten aus dem PDF-Dokument mit dem Identifikator 1 und speichert sie in der Variable numpages.


Navigation zeigen