CIB pdf toolbox technischer Leitfaden (DE)

17. Prüfschablonen verwenden

Mit Prüfschablonen ist es möglich zu prüfen, ob eine PDF Seite Inhalt enthält, an welcher Stelle und ob der Inhalt an dieser Stelle erlaubt bzw. zwingend erforderlich oder aber unerwünscht ist.

Die zu setzenden, speziellen Properties werden im Folgenden näher beschrieben.

Propertybezeichnung

Typ

Funktionalität

CheckMask

(ab CIB pdf toolbox

String

Beschreibt den Aufbau der konkreten Prüfschablonen. Die einzelnen Komponenten werden im Weiteren genauer beschrieben.

Aufbau:

<Checkmasklist> ::= <Checkmask> | <Checkmask> „;“ <Checkmasklist>

Es können mehrere Definitionen für Prüfschablonen aneinandergereiht werden. Sie werden durch Semikolon getrennt.

Beispiel:

CheckMask=“{{1,3-40}; {forbidden;2cm;2cm;5cm;4cm}}; {{2,5,6};{allowed;2cm;2cm;5cm;4cm};{mandatory;1cm;1cm;6cm;7cm}};“

<Checkmask>

 

String

Beschreibung einer Schablone.

Aufbau:
<Checkmask>::=“{„ <Pages>“;“<mask area> „}“

Für die Seiten, für die eine Prüfschablone angewendet werden soll, werden die Schablonen-Bereiche beschrieben.

Pro <Checkmask> können wahlweise „allowed“, „forbidden“ oder „mandatory“ Bereiche oder auch Kombinationen dieser Bereiche beschrieben werden.

<mask area>

 

Beschreibung des Prüfschablonen-Bereichs (Rechteck).

Aufbau:
<mask-area> = {forbidden | allowed | mandatory;left;top;right;bottom[;ID]}

Forbidden        In diesem Rechteck darf kein Text stehen

Allowed            In diesem Rechteck darf Text stehen

Mandatory       In diesem Rechteck muss Text stehen

 

left;top Koordinaten des linken, oberen Eckpunktes des Rechteckes (siehe in Grafik der Punkt A)

right;bottom    Koordinaten des rechten, unteren Eckpunktes des Rechteckes (siehe in Grafik der Punkt B)

ID        Angabe eines Bezeichners(ID) der in den CheckMaskViolations mit ausgegeben wird

Bezugspunkt für die Koordinaten ist die linke, obere Ecke der Seite.

Durch Eingabe von negativen Werten kann der Bezugspunkt auf die rechte untere Ecke der Seite geändert werden.

Unterstützt werden die Einheiten: mm, cm, in, ft;

Default: mm

<Pages>

 

Angabe der Seiten oder Seitenbereiche, auf denen die folgende Prüfschablone angebracht werden soll.
Die Seiten können bezogen auf das ganze Dokument oder auf eine Ausfertigung angegeben werden.
Wenn die Prüfschablone auf alle Seiten einer Ausfertigung aufgebracht werden soll, muss die Bezeichnung der Textmarke um „All“ ergänzt werden.

 

Aufbau:
<Pages>= {[any page number | from-to| All | Even | Odd | NoLast | NoFirst | First | Last]}  *

First (nur erste Seite),

NoFirst (nicht erste Seite),

Last (nur letzte Seite),

NoLast (nicht letzte Seite),

Even (gerade Seiten)

Odd (ungerade Seiten)

All (alle Seiten)

Wert (diese Seite)

Wert1-Wert2 (diesem Seitenbereich)

Wert1-Wert2[,]Wert3 (diesen Seiten/Seitenbereich)

 

CheckMaskViolations

String

Property liefert die Verletzungen der Prüfschablonen zurück.
(Get-Property).
Für jede Prüfschablone kann ein Bezeichner (ID) vergeben werden. Diese ID wird auch bei Ausgabe mitgegeben.

Es wird ausgegeben:
Position des Textes, der die Verletzung verursacht (content).

Position der Checkmask, die verletzt wird (masks).

 

Beispiel:

…{forbidden;50mm,50mm,150mm,100mm;myid1}.

Violations={{content;49.31;52.84;61.66;50.08;};{masks;{50;50;150;100;myid1}}}

Ausgabe im Trace:
Position der Checkmask, die verletzt wird
(masks).

Beispiel:

CheckMask: Content is placed on the forbidden area [forbidden;0mm;0mm;150cm;100mm;myid01].

CheckMaskThreshold

String

Ermöglicht das Einstellen einer Fehlertoleranz. Der Wert gibt an wieviele Pixel in einem „verbotenen“ Checkmaskbereich toleriert werden, ohne eine Verletzung auszulösen.

Angegeben werden können Ganzzahlen:

Default: 1

StopOnFirstCheckmaskViolation

String

Gibt an, ob bei der ersten auftretenden Verletzung abgebrochen werden soll.

Die Verletzung wird in der Property CheckmaskViolations gespeichert.

Mögliche Werte:

0: Es wird nicht abgebrochen (default)

1: Es wird abgebrochen

StopAfterCheckmaskViolation

String

Prüft das gesamte Dokument und speichert alle Verletzungen in der Property und gibt eine Fehlermeldung zurück.

Mögliche Werte:

0: Keine Fehlermeldung

1: Fehlermeldung und Speichern aller Verletzungen