CIB pdf toolbox technischer Leitfaden (DE)
13. Allgemein gültige Properties
Die sogenannten „Properties“ oder Eigenschaften bilden ein wesentliches Kriterium vor dem Aufruf der eigentlich auszuführenden Methode. Alle unten im Klartext genannten Optionsnamen sind in den einzelnen Headerdateien der Komponenten auch als define deklariert und auch über diese defines in Ihrem Sourcecode ansprechbar. Die verschiedenen internen Module besitzen weitere spezielle Properties, die dort in den einzelnen Unterkapiteln beschrieben sind.
Zum Setzen der Optionen steht die Funktion CibPdfSetProperty und zum Abholen die Funktion CibPdfGetProperty zur Verfügung.
Propertybezeichnung |
Typ |
Funktionalität |
Art |
AnnotationsFilename (ab CIB pdf toolbox 1.4.105) |
String |
Eingabedatei bzw. Speicherbereich im XFDF-Format, die die Kommentare enthält, die ins PDF importiert werden sollen. Dies entspricht der Funktion „Kommentare importieren“ im Acrobat von Adobe. |
Set |
AnalysisFilename (ab CIB pdf toolbox 1.14.4) |
String |
Schreibt Informationen über die Eigenschaften einer PDF Seite in eine Logdatei. Syntax: Die Analysedatei enthält derzeit nur Informationen über die Seitengröße und Ausrichtung. Beispiel: Es liegen 2 Seiten vor, mit den angegebenen Abmessungen in mm und jeweils den Ausrichtungen Hochformat und Querformat. Diese Property kann mit der Property OutputFormat=FormatInfo kombiniert werden, so dass kein Ausgabedateiname angegeben werden muss. |
Set |
AntiAliasing |
String |
Einschalten der AntiAliasing-Funktionalität. 0 Kein AntiAliasing (default) 2 x2 AntiAliasing-Funktionalität für interne und Pango Rendering-Engine. 4 x4 AntiAliasing-Funktionalität für interne und Pango Rendering-Engine. (siehe auch RenderingEngine parameter) |
Set |
BookmarkAlignment (ab CIB pdf toolbox 1.4.84) |
String |
„0“ = Kein Einfügen von Leerseiten „1“ = Jede Ausfertigung wird durch Leerseiten auf eine gerade Seitenzahl erweitert. Nur sinnvoll bei PDF-Join ohne OutputFormat=FormatPrinter. |
Set |
CallbackPointer |
String |
Benutzerdaten des Callbacks für Rückmeldung nach jeder Seite |
Get/ |
ColorDithering (ab CIB pdf toolbox 1.4.86) |
String |
Ist diese Property gesetzt, werden bei der Ausgabe (als Bitmap oder beim Druck) alle Farbwerte in Schwarzweiß-Muster umgerechnet. Das Muster ergibt sich dann aus der Helligkeit des Farbwerts. Mögliche Werte:
|
Get/ |
Data |
String |
Angabe der Eingabedatenquelle. Syntax: Data=<Datentyp>:<Dateiname> <Datentyp>= leer (CSV wird angenommen) CSV TYP: weitere Datentypen (z.B. SQL), die über die DataAccess-Schnittstelle abgewickelt werden. <Dateiname>=datei.typ X:\datei.typ Datei.xml;//xpath Falls es sich bei der Datendatei (CSV, XML) um eine Multisteuerdatei handelt, muss MultiData=1 gesetzt werden. Beispiel: |
Get/ |
DataFileMemoryAddresses |
String |
Speicheradresse+Länge der Datendatei bei Speicherübergabe |
Get/ |
DataFileType |
String |
Datentyp für Datenquelle per Speicherübergabe |
Get/ |
DataXmlPath |
String |
Eingaberequest, z.B. „XML:data.xml;//root/...“ für Datenquelle per Speicherübergabe |
Get/ |
DataXslFilename |
String |
Name der Xsl-Transformationsdatei (für Transformation von Adobe-xfdf Formulardatenexport) |
Get/ |
DocumentUsedBookmarks (ab CIB pdf toolbox 1.4.105) |
String |
Ausgabe der in einem Dokument verwendeten Textmarken. Syntax: <Textmarke> ::= „{“ <Text> „;“ <Seitenliste> „}“ <Seitenliste> ::= <Seiten> | <Seiten> „,“ <Seitenliste> <Seiten> ::= <Zahl> | <Zahl> „-„ <Zahl> Beispiel: |
Get |
EmbeddedFileOutputFormat |
String |
„None“: Die Streams der eingebetteten Dateien werden nicht extrahiert (Default). „FormatEmbedded“: Die Streams der eingebetteten Dateien werden in das Metafile geschrieben. „FormatFile“: die eingebetteten Dateien werden in das aktuelle Arbeitsverzeichnis extrahiert. |
Set |
EmbeddedFilesExtract
|
String |
Ein JSON-Array von JSON-Objekten, die definieren, welche Dateien exportiert werden. Ein JSON-Objekt sieht wie folgt aus: - Datei: Dateiname wie im pdf angegeben - OutputFilename: Wo die Datei gespeichert werden soll. |
Set |
EnablePatternsShadings (ab CIB pdf toolbox 1.14.0) |
String |
Die Property steuert, ob PDF-Shadings und PDF-Patterns mit gerendert werden oder nicht. 1 PDF-Shadings und PDF-Patterns werden mit gerendert (Default) 0 PDF-Shadings und PDF-Patterns werden nicht mit gerendert. Erforderlich: CIB renderer |
Set |
ExtractEmbeddedFile (ab CIB pdf toolbox 1.8.0) |
String |
Über Belegung dieser Property kann gesteuert werden, dass die CIB pdf toolbox während eines Join-Laufs eine eingebettete Datei extrahiert. Mögliche Eingaben:
- „zugferd“: Die ZUGFeRD-XML-Datei wird extrahiert. Der Name, unter dem die eingebettete Datei herausgeschrieben wird, wird über die Property OutputFilename übergeben. |
Set |
ExtractEmbeddedFileInfo |
String |
„1“ = Die Informationen der eingebetteten Dateien werden in das Metafile geschrieben (Name, Dateigröße, Datum der Erstellung und letzten Änderung) (Default). „0“ = Es werden keine Informationen zu eingebetteten Dateien in das Metafile geschrieben. |
Set |
ExtractXmpMetadata |
String |
Ermöglicht das entpacken von XMP-Metadaten aus einer PDF-Datei. Die Property hat JSON Syntax. Beispiel: { „1“: „<filenameforfirstpage>“, // extrahiert xmp von Seite 1 } „<Zahl>“ Entpackt die XMP-Metadaten einer spezifischen Seite „Global“ entpackt die globalen XMP-Metadaten des PDF-Dokuments (aus dem Catalog Dictionary) „AllPages“ entpackt alle Seiten-XMP-Metadaten |
|
FieldCaptions. |
String |
dynamische Property, Beschriftung eines Formularfelds (z.B. FieldCaptions.Radio123) Der Wert der Property ist bei Pushbuttons: Eine durch „;“ getrennte Liste der Pushbuttonlabels. als Ansi-String oder als Utf8-String. (es kann mehrere Pushbuttons mit gleichem Namen geben, auch mit unterschiedlichen Labels) bei Radiobuttons und Checkboxen: Eine durch „;“ getrennte Liste, die den Stil für jeden Button der Gruppe angibt. Die Reihenfolge ist die gleiche wie bei FieldStates (außer „Off“). Mögliche Stile sind: „n“ = Quadrat (square) „u“ = Raute (diamond) „4“ = Haken (check) „8“ = Kreuz (cross) „H“ = Stern (star) „l“ = Kreis (bullet) |
Get |
FieldDimensions. |
String |
dynamische Property, Koordinaten eines Formularfelds (z.B. FieldDimensions.Feld123) |
Get |
FieldFlags. |
String |
Dynamische Property, Eigenschaften eines Formularfelds (z.B. FieldFlags.Feld123) Der Inhalt ist eine durch „;“ getrennte Liste der Eigenschaften, die für das Feld „Feld123“ gesetzt sind. Folgende Eigenschaften sind möglich: ReadOnly Schreibgeschützt Required Erforderlich NoExport Beim Exportieren des Formulars dieses Feld ignorieren Multiline mehrere Zeilen (nur bei Textfeldern) Password geschützte Eingabe (*****) (nur bei Textfeldern) NoToggleToOff Auswahl kann nicht auf leer gesetzt werden (Radiobutton) Radio redundant, siehe FieldType.<name> Pushbutton redundant, siehe FieldType.<name> Combo redundant, siehe FieldType.<name> Edit benutzerdefinierte Eingabe erlaubt (nur bei Comboboxen) Sort Auswahl sortieren (List- und Comboboxen) FileSelect Feld ist Auswahl für Dateiname MultiSelect Mehrfachselektion (nur bei Listbox) DoNotSpellCheck keine Rechtschreibprüfung DoNotScroll kein horizontales Scrolling (limitiert Textlänge) Comb Text in Kästchen RadiosInUnison Buttons mit demselben Exportwert synchron an- und abschalten CommitOnSelChange ausgewählten Wert sofort einsetzen (nicht erst beim Verlassen des Feldes) RichText Feld enthält „rich text“ (kein rtf, sondern Text mit ein paar html-tags wie <b>,<i>) |
Get |
FieldFont. |
String |
dynamische Property, Schriftart und -größe des Formularfeld-Textes |
Get |
FieldNames |
String |
Liste der Namen der Formularfelder im Dokument, durch „;“ getrennt |
Get |
FieldOptions. |
String |
dynamische Property, Optionen eines Formularfelds (z.B. FieldValue.Feld123) |
Get |
FieldOrder. |
String |
dynamische Property, Laufende Nummer des Formularfelds (unsortiert) |
Get |
FieldStates. |
String |
dynamische Property, Ausprägungen eines Formularfelds (z.B. FieldValue.Checkbox123) |
Get |
FieldType. |
String |
dynamische Property, Typ eines Formularfelds (z.B. FieldType.Textfeld123) |
Get |
FieldValue. |
String |
dynamische Property, zum Setzen oder Auslesen von Formularfeld-Inhalten (z.B. FieldValue.Textfeld123)
Durch Setzen dieser Property an den Modul PdfMerge können Inhalte von Formularfeldern übergeben und in das PDF eingemischt werden. (z.B. FieldValue.Textfeld123=Test)
|
Get/Set |
FillTextOutput (ab CIB pdf toolbox 1.27.0. ) |
String |
Diese Optionen wirken sich nur aus, wenn die Ausgabe Format-Option folgendermasen gesetzt ist: OutputFormat=FormatText (für die Ausgabe von reinem Text), oder OutputFormat=FormatHocr (für die Ausgabe von HOCR-Text). Wenn die Option FillTextOutput auf 0 gesetzt ist: Der extrahierte Text wird nur in die Ausgabedatei ausgegeben. Wenn der Ausgabedateiname nicht innerhalb der Option OutputFilename gesetzt ist, sollte ein Fehler erscheinen. Wenn die Option FillTextOutput auf 1 gesetzt ist: Der extrahierte Text wird in die Ausgabedatei ausgegeben und zusätzlich in die Ausgabeeigenschaft TextOutput in Utf8-Kodierung kopiert. Hinweis: Wenn FillTextOutput auf 1 gesetzt ist und OutputFilename nicht gesetzt ist, wird der extrahierte Text nur in der Property TextOutput gespeichert. |
Set |
FontsEmbedded (ab CIB pdf toolbox 1.10.0) |
String |
Wird dieser Wert gesetzt, so werden alle im PDF-Dokument verwendeten Fonts in das PDF Ausgabe-Dokument eingebettet. Mögliche Werte: „0“ kein Einbetten (default) „1“ Fonts werden einbettet. Hinweis: |
Set |
FontSubstitution (ab CIB pdf toolbox 1.10.0) |
String |
Die Property gilt wenn FontsEmbedded=1 oder PdfVersion=PDF/Axx. Alle im System nicht verfügbaren Fonts müssen ersetzt werden. Über diese Property kann gesteuert werden, welche Fonts für die Ersetzung verwendet werden. Syntax: Im Detail:
Beispiel: Hinweise:
|
Set |
FontWorkSpace |
String |
Pfad zum Verzeichnis, in dem die Fonts gespeichert sind, die beim Rendern des PDFs in Bildformat verwendet werden sollen. |
Set |
FormfieldNamePrefix |
String |
Präfix für alle Formularfelder eines Dokuments, bzw. eine durch „;“ getrennte Liste von Präfixen für die am Join beteiligten Dokumente. |
Set |
GeneratedDocumentCount (ab Version 1.4.83) |
String |
Liefert die Anzahl der erzeugten Ausgabedokumente. Im Normalfall wird „1“ zurückgeliefert, außer bei MultiOutput=1, wenn mehrere Ausgabe-PDFs erstellt werden. Im Fehlerfall, d.h. Abbruch und gar keine Ausgabe, wird „0“ zurückgegeben. |
Get |
GeneratedPageCount (ab Version 1.8.1) |
String |
Liefert die Anzahl der ausgegebenen Seiten. Beim Druck werden die erzeugten Kopien mitgezählt. Bei Ausgabe einer Datei ist die Anzahl identisch zu der aus PageCount. Im Fehlerfall, d.h. Abbruch und gar keine Ausgabe, wird „0“ zurückgegeben. |
Get |
GetFieldInfo |
String |
Über diese Property kann die Abfrage der Formularfelder ermöglicht werden. Mögliche Werte: „1“ Die Formularfelder können „0“ |
Get/ |
GetPageInfo |
String |
Über diese Property kann eine Versorgung der GET-Property „PageInfo.<seite>“ veranlasst werden. Mögliche Werte: „1“ Die Property „PageInfo.<seite>“ „0“ |
Get/ |
ImageInfo |
|
Abrufen einer Beschreibung über Bilder in einer PDF-Datei in JSON Format. |
Get |
ImagePdfCreation |
String |
Mögliche Werte: „0“ oder leer: Property hat keinen Effekt. „1“ CIB pdf toolbox verwendet CIB renderer um Inhalt von PDF Seiten als Grafik zu erzeugen. |
Set |
ImagePdfCreationPreserveText |
String |
Tritt der PdfAFallback Fall ein (siehe Kapitel 5.1.4.1.), können mit Setzen dieser Property Textinhalte aus der Eingabedatei über HOCR Export gesichert und in die Ausgabedatei übernommen werden. Mögliche Werte: „0“: Property hat keinen Effekt. „1“: Textinhalte der Eingabedatei werden in die Ausgabedatei übernommen |
Set |
IndDCAntiAliasing |
String |
Wird nicht mehr verwendet “2” – Einschalten x2 anti-aliasing Funktionalität für interne Rendering-Engine “4” – Einschalten x4 anti-aliasing Functionalität für interne Rendering-Engine (siehe Proprety RenderingEngine); Default: “0” oder leer (Es wird kein anti-aliasing durchgeführt) |
Set |
HiddenPages |
String |
CIB-interne Property, die derzeit nur vom CIB image unterstützt wird. Über diese Property gibt ein CIB-Viewer an, welche Seiten bei der Anzeige durch einen CIB viewer ausgeblendet werden sollen. Diese Information wird mit CIB-mitteln im PDF gespeichert. |
Set |
IgnoreTemporaryFontFailure (ab CIB pdf toolbox 1.8.0) |
String |
Über diese Property kann die Reaktion auf Fehler bei der temporären Installation von Schriften aus dem PDF gesteuert werden. Mögliche Werte: 1 Fehler werden ignoriert und die Verarbeitung fortgesetzt 0 Fehler werden mit einem Rückgabewert, z.B. 350, quittiert und die Verarbeitung beendet. (default) |
Set/ |
IncludeInvisibleText |
String |
Diese Property steuert, ob unsichtbarer PDF-Text (Rendering Mode = 3) von der CIB pdf toolbox ausgegeben wird oder nicht. Mögliche Werte: „1“ Unsichtbarer PDFdf-wird bei bestimmten Toolbox-Aufrufen genauso ausgegeben wie sichtbarer Pdf-Text. „0“ Unsichtbarer Pdf-Text wird bei diesen Toolbox-Aufrufen nicht ausgegeben. Diese Property ist nur bei folgenden Toolbox-Aufrufen wirksam: a) Bei der Toolbox-Textsuche mit PdfSearchText=“…“. b) Bei der Ausgabe des Pdf-Files in den OutputFormaten „FormatText“ oder „FormatCsv“. c) Bei der Ausgabe des Pdf-Files im OutputFormat „FormatXfdf“, wenn die Property „RegionTemplate“ nicht leer ist. d) Bei der Metafile-Ausgabe für CIB webview (OutputFormat ist „FormatWebview“). |
Set |
InputFilename |
String |
Eingabedatei bzw. eine durch „;“ getrennte Liste von Eingabedateien bzw. Paare {x};y von Seitenangabe(n)/Eingabedatei bzw. leere Seite(n) EMPTY[:Breite(mm), Höhe(mm)]. InputFilename= {Odd};Dokument1.pdf;EMPTY:210,297; {5,4,1-3};Dokument2.pdf;EMPTY heißt, dass alle ungeraden Seiten von Dokument1.pdf, eine leere Seite der Breite 210 mm und der Höhe 297mm, die Seiten 5, 4, 1, 2 und 3 von Dokument2.pdf und eine leere Seite mit der Breite und Höhe der aktuell letzten Seite (Seite 3 von Dokument2.pdf) in genau dieser Reihenfolge aneinandergefügt werden.
Syntax: InputFilename ::= <Eingabedatei> [“;“ <Eingabedatei>]... Eingabedatei ::= [<Seitenangaben> „;“] (<Filename> | <Speicherblöcke> | <Leerseite> | <Speicherblock-Delimiter>) Seitenangaben ::= „{“ <Seitenangabe> [“,“ <Seitenangabe>]... „}“ Seitenangabe ::= „All“ |“Even“ | „Odd“ | „First“ | „Last“ | <nummer> | (<startnummer> „-„ <endnummer>) Leerseite ::= „EMPTY“ [“:“ <Breite_in_mm> „,“ <Höhe_in_mm>] Speicherblöcke ::= <Speicherblock> [<Speicherblock-Delimiter> <Speicherblock>]... Speicherblock ::= <Adresse> <Speicherblock-Delimiter> <Länge>
Ein <Speicherblock-Delimiter> ist ein einzelnes Zeichen ungleich „;“, das möglichst nicht in einem Filenamen vorkommt, z.B. „#“, „?“. Adresse und Länge sind Dezimalzahlen |
Get/ |
InputMemoryAddress |
String |
Paare xxx?yyy von Speicheradresse/Länge Zu beachten: |
Get/ |
InsertEmptyPageInDuplex (ab CIB pdf toolbox 1.4.83) |
String |
„0“ = Keine DuplexLeerSeiten beim Druck einfügen(default) „1“ = Beim Duplexdruck von PDF-Dokumenten mit der CIB pdf toolbox werden bei ungerader Seitenanzahl zwischen den zusammengefügten PDF-Dokumenten automatisch Leerseiten eingesteuert. Die Identifizierung dieser Trennstellen erfolgt durch Auswertung der hinterlegten Markierungen. Diese Markierungen, werden über die Property JoinHistory gesetzt. (weitere Details, siehe Property JoinHistory) |
Get/ |
InsertEmptyPageBetweenRtfBookmarks (ab CIB pdf toolbox 1.4.83) |
String |
“0” = Keine DuplexLeerSeiten beim Druck einfügen(default) „1“ = Beim Duplexdruck von PDF-Dokumenten wird zwischen den Stellen, wo sich eine RtfBookmark ändert, bzw. wo ein Join gemacht wurde (siehe Property JoinHistory), eine Leerseite beim Druck eingefügt, wenn der darauffolgende Inhalt auf eine Rückseite gedruckt werden würde. |
Get/ |
JoinHistory (ab CIB pdf toolbox 1.4.83) |
String |
„0“ = Die CIB pdf toolbox setzt keine Markierung an den Seitenübergängen, an denen dieses aus mehreren Einzeldokumenten zusammengefügt wird. „1“ = Die Toolbox markiert diese Position(en).
Hinweis: Damit ist es möglich, einen späteren Ausdruck im Duplexmodus mit automatisch eingefügter Leerseite vorzunehmen. Siehe auch Property InsertEmptyPageInDuplex und InsertEmptyPageBetweenRtfBookmarks
Der Defaultwert ist 1 |
Get/ |
StartPage |
String |
In dieser Property kann die Seitennummer hinterlegt werden, bei der das PDF bei der Anzeige geöffnet wird. Die Nummer wird im PDF hinterlegt und bei der Anzeige durch den Adobe Reader, CIB jView oder CIB image ausgewertet. |
Set |
OpenSize (ab CIB pdf toolbox 1.13.5) |
String |
Gibt die Zoomstufe im Fenster des PDF-Anzeigeprogramms beim Öffnen der PDF-Datei vor. „Standard“ Standardeinstellung des PDF- „Fit“ An Fensterhöhe anpassen „FitH“ An Fensterbreite anpassen Kommt nur zur Anwendung, wenn auch StartPage gesetzt ist. |
Set |
PartialDocumentAlignment (ab CIB pdf toolbox 1.4.84) |
String |
„0“ = Kein Einfügen von Leerseiten „1“ = Jedes Teildokument wird durch Leerseiten auf eine gerade Seitenzahl erweitert. Nur sinnvoll bei PDF-Join ohne OutputFormat=Printer. |
Set |
PdfPrintFontCleanupInterval (ab CIB pdf toolbox 1.4.95) |
String |
Angabe eines Zeitintervalls, nach dem die CIB pdf toolbox Fonts aus der Fontliste entfernt. Damit kann verhindert werden, dass Fonts zu früh aus der Fontliste gelöscht werden. Einheit: Stunden
Bei jedem Aufruf prüft die CIB pdf toolbox die Fontliste. Diese enthält die noch nicht abgeräumten Fonts mit einem Zeitstempel. Alle Fonts älter als das FontCleanupInterval werden aus der Liste entfernt. Bei wiederholten Aufrufen von CibPdfMerge/ CibPdfJoin/CibPdfPrint im gleichen Prozeß wird die Fontliste nur geprüft, wenn seit dem letzten Aufruf mindestens 1 Stunde vergangen ist. |
Set |
LicenseKey |
String |
Lizenzschlüssel |
Set |
LicenseCompany |
String |
Lizenznehmer |
Set |
MaxResolution (ab CIB pdf toolbox 1.5.111) |
String |
Durch Angabe einer maximalen Auflösung (in dpi) kann die Größe von Grafiken im Metafile begrenzt werden. Das wirkt sich war auf die Qualität (etwa beim Zoomen) aus, die Metafiles werden jedoch kleiner. Default: Original-Auflösung wird beibehalten. Im Acrobat gibt es dieses Feature bei „Erweitert/Pdf-Optimierung“ und heißt „Bikubische Neuberechnung auf ... dpi für Bilder ab ... dpi“. Die CIB pdf toolbox führt die Neuberechnung (Resampling) nur beim Speichern als Metafile durch, nicht beim Speichern als PDF. Außerdem wird ein einfacherer (nicht bikubischer) Resampling-Algorithmus verwendet. |
Set |
ResolutionThreshold (ab CIB pdf toolbox 1.5.111) |
String |
Alle Bitmaps im Dokument, die eine höhere Auflösung haben als ResolutionThreshold (in dpi), werden auf MaxResolution herunterskaliert und dann ausgegeben. Das ist unabhängig von der Auflösung des Ausgabemediums (Bitmap, Drucker, Metafile). Setzt man nur MaxResolution, dann werden alle Bilder mit höherer Auflösung auf MaxResolution herunterskaliert. |
Set |
MemoryOutputCallback |
String |
Adresse der Callback-Funktion für Ausgabedokument per Speicherübergabe. |
Get/ |
MemoryOutputUserdata |
String |
Userdata der Callback-Funktion für Ausgabedokument per Speicherübergabe |
Get/ |
MetaFilename |
String |
Name des Metafiles, welches mit den CIB viewern angezeigt wird. |
Set |
MultiData |
String |
„1“ = Datendatei ist eine Multisteuerdatei |
Get/ |
MultiOutput |
String |
„1“ = Pro Datensatz eigene Ausgabedatei erzeugen |
Get/ |
NeedAppearances |
String |
„1“ = Acrobat baut die Formularfelder beim Öffnen neu auf. |
Get/ |
OutputFilename |
String |
Dateiname des Ausgabe-Dokuments |
Get/ |
OutputFormat |
String |
(keins): Dokument wird über OutputFilename gespeichert.
Auch für dieses Ausgabeformat wird ab CIB pdf toolbox 1.4.87 das Memory-Interface unterstützt. Wenn der Inhalt von Formularfeldern in den Textoutput übernommen werden soll, muss die Property FlattenFormfields=1 gesetzt werden.
(ab CIB pdf toolbox 1.4.90)
(ab CIB pdf toolbox 1.4.105) „FormatSearchablePdf“: In Grafiken enthaltener Text wird alsText extrahiert. (ab CIB pdf toolbox Version 1.6.116) „FormatBarcodeXml“: Die aus dem PDF über die Property „BarcodeInfo“ ausgelesenen Barcodeinformationen werden im XML-Format ausgegeben. (ab CIB pdf toolbox 1.8.0) „FormatBarcodeCsv“: Die aus dem PDF über die Property „BarcodeInfo“ ausgelesenen Barcodeinformationen werden im CSV-Format ausgegeben. (ab CIB pdf toolbox 1.8.0) „FormatInfo“: Es werden globale Dokumenten-Eigenschaften durch den PDF-Join aus dem PDF ausgelesen. (Ab CIB pdf toolbox 1.6.116f) “FormatPrinterCups”: Druckansteuerung über CUPS. Nur für Linux/Unix verfügbar. (siehe Kapitel 14.1.2 “Druck über CUPS” )
„FormatTiff“: Erzeugt Grafikdatei im Tiff-Format.
„FormatPng“: Erzeugt Grafikdatei im Png-Format.
„FormatWebview“: Ausgabeformat für die Anzeige in CIB doXiview.
“FormatWebP“: Erzeugt Grafikdatei im WebP-Format (verwendet verlustbehaftete und nicht verlustbehaftete Kompression). „FormatJpegXR“: Erzeugt Grafikdatei im JPEG extended range Format. „FormatBmp“: Erzeugt Grafikdatei im BMP-Format.
„FormatBmpLz4“: Erzeugt Grafikdatei im BMP-Format, wobei Daten nach lz4 Standard komprimiert sind. „FormatImage“: Bei einem Rendering-Vorgang werden mehrere Ausgabe-Grafikformate erzeugt. Dabei muss es sich um Raster-Grafikformate handeln. „FormatSvg“: Ausgabe einer Grafikdatei im SVG-Format (Scalable Vector Graphics=skalierbare Vektorgrafik).
”FormatAnalyse”: Der Prüf-Prozess zum Verifizieren der Signatur wird immer komplett durchgeführt und die SignedDocument.xxx-Properties für die Signatur gesetzt. Dadurch kann verfolgt werden, welche Verarbeitungsschritte erfolgreich
waren und welche nicht.
“FormatExtractImages”: Bei Angabe dieses Ausgabeformats werden alle Image-XObjects, die sich in den Eingabe-PDFs befinden, exportiert. Die Ausgabe erfolgt im TIFF-Format oder (bei bestimmten Pdf Bildobjekten) ins JPEG-Format unter
der bei OutputFilename angegebenen Dateibezeichnung.
„FormatCsv“: Aus dem PDF extrahierter Text wird als CSV-Datei ausgegeben. |
Get/ |
OutputRtfBookmarkNames |
|
Wenn die Option OutputRtfBookmarkNames=1 und PageSelection-Option unter Verwendung von CIB-Bookmark gesetzt ist, dann enthalten die Namen der Ausgabebilder Lesezeichennamen: Das Format ist OutputRtfBookmarkNames=0: <OutputFilename> - <Seitenzahl> Beispiel: out-000001.png Das Format ist OutputRtfBookmarkNames=1(erweiterte Ausgabe): <OutputFilename> - <RtfBookmarkName> - <CopyNumber> - <PageNumber> - <PageNumber>…. Beispiel: out-AUF1-0000-0000-00001.png |
|
PageCount |
String |
Anzahl Seiten im Dokument, Dezimalzahl als String. |
Get |
PageFieldNames.<seite> |
String |
Gibt die Formularfelder jeder Seite zurück. Z.B. PageFieldNames.0 enthält die Formularfelder der ersten Seite |
Get |
PageInfo.<seite> |
String |
Dynamische Property, in der Informationen zu einer Seite zurückgegeben werden (Breite, Höhe und Rotation). Z.B. PageInfo.1 enthält die Informationen zur zweiten Seite |
Get |
PdfDocPropertyEncoding |
String |
“” = kein Encoding(default) “Base64” = Base64 Encoding |
Get/ |
PdfDocProperties |
String |
Liefert die Namen, durch „;“ getrennt, aller benutzerdefinierten Dokumenteigenschaften. |
Get |
PdfDocProperties |
String |
Setzen neuer oder zu ändernder benutzerdefinierter Dokumenteigenschaften. |
Set |
PdfDocProperty.<name> (ab CIB pdf toolbox 1.4.78) |
String |
dynamische Property, Lesen oder Setzen des Wertes der benutzerdefinierten Dokumenteigenschaft, deren Namen über die Property PdfDocProperties geliefert werden. Das Encoding des Wertes erfolgt entsprechend der Property „PdfDocPropertyEncoding“. Achtung: neue Dokumenteigenschaften müssen über die Property „PdfDocProperties“ vorher bekannt gemacht werden. Bei Angabe von unbekannten Dokumenteigenschaften liefert die CIB pdf toolbox den Rückgabewert 99. |
Get/ |
PdfLinearized |
String |
Steuerung, ob das Ausgabe-PDF für die schnelle Anzeige im Web optimiert wird. Mögliche Werte:
|
Get/ |
PdfSearchIgnoreCase |
String |
Steuerung, ob bei der Suche im PDF die Groß-/Kleinschreibung berücksichtigt wird. Mögliche Werte:
|
Set |
PdfSearchFont |
String |
Setzen eines bestimmten Fonts. Bei einer nachfolgenden Textsuche werden als Ergebnis nur Texte geliefert, die mit diesem Font im Dokument vorkommen. Beispiel: PdfSearchFont=“CourierNewPS-ItalicMT“ bedeutet, dass im Dokument nur Textpassagen gesucht werden, die diesen Font verwenden.
Achtung: Die Fontbezeichnung muss mit der vom Acrobat-Reader aus den Dokument-Eigenschaften übereinstimmen. |
Set |
PdfSearchResult |
String |
Liefert die Fundstellen der Zeichenkette im Dokument. Jede Fundstelle wird durch eine Folge von Rechtecken beschrieben. Diese bezeichnen die genaue Position der gesuchten Zeichenkette im Seitentext. Eine Rechteck wird angegeben durch: <page>,<left>,<top>,<right>,<bottom>. Erstreckt sich eine Fundstelle über mehrere Zeilen, wird eine Folge von Rechtecken durch Semikolon voneinander getrennt zurückgeliefert.
„1,500,100,600,110;1,50,111,100,121“ heißt, dass sich der Suchtext auf Seite 1 über zwei Zeilen erstreckt. Einmal von (500,100) bis (600,110) und von (50,111) bis (100,121). „{1,500,100,600,110;1,50,111,100,121};{2,500,100,600,110;2,50,111,100,121}“ heißt dass der Suchtext auch noch auf Seite 2 von (500,100) bis (600,110) und von (50,111) bis (100,121) vorkommt. Eine Fundstelle kann sich auch über mehrere Seiten erstrecken. Ein Ergebnis wie „1,500,750,600,760;2,50,50,100,60“ bedeutet, dass die Fundstelle auf Seite 1 von (500,750) bis (600,760) geht und sich auf Seite 2 von (50,50) bis (100,60) fortsetzt. |
Get |
PdfSearchResultContext (ab CIB pdf toolbox 1.4.80)
|
String* |
Liefert die Fundstellen der Zeichenkette im Dokument mit ihrem Kontext.
={<Fundstelle1>};{<Fundstelle2>};... <Fundstelle> = {<Kontext>};<Rechteck1>;<Rechteck2>;... <Rechteck> = siehe PdfSearchResult <Kontext> = <Vor-Kontext> <Suchkette> <Nach-Kontext> Falls nicht genügend Zeichen im Dokument vorhanden sind um den definierten Vor- oder Nachkontext zu belegen (z.B. am Anfang oder Ende eines Dokuments), wird mit Leerzeichen aufgefüllt. Beispiel: Suchkette=Kinder, Vorkontext=3, Nachkontext=5 liefert das Ergebnis:
Die Property PdfSearchResult wird weiterhin zusätzlich belegt. |
Get |
PdfSearchText |
String |
Setzen der gesuchten Zeichenkette im Dokument. Hierbei kann es sich auch um eine längere Textpassage handeln. |
Set |
PdfSearchContext (ab CIB pdf toolbox 1.4.80) |
String |
Setzen eines Kontextes für die gesuchte Zeichenkette, der als Suchergebnis mitausgegeben wird. n= Anzahl Zeichen nach der gesuchten Zeichenkette Wird nur eine Zahl angegeben, so werden die Zeichen nach der gesuchten Zeichenkette verwendet. |
Set |
PdfVersionInfo (ab CIB pdf toolbox 1.18.0) |
String |
Diese Property liefert die PDF-Version und Spezial-Version des Dokuments zurück. Beispiel: {“Version“:“1.4“, „SpecialVersions“:[“PDF/A“, „PDF/X“]} Das PDF-Dokument hat die PDF-Version 1.4 und es erfüllt zusätzlich die Spezifikationen PDF/X und PDF/A. |
Get |
FirstPage LastPage |
String |
Einschränken der Textsuche (PdfSearchText) bzw. der Textausgabe (OutputFormat=FormatText) auf einen Seitenbereich. FirstPage=1 LastPage=3 Es wird nur Seite 1 bis 3 bearbeitet. Wenn die Angabe LastPage fehlt, geht der Bereich bis zum Ende des Dokuments. |
Set |
PdfSecurityMethod |
String |
Mögliche Werte sind: „“ = keine Methode „Standard“ = Methode ist „adobe standard security“ |
Get |
PngCompressLevel (ab CIB pdf toolbox 1.4.105) |
String |
Steuerung des Maßes der Kompression der Grafik beim Speichern. Mögliche Werte: 1 Standard-Wert für PNG Kompression 0 Keine Kompression 9 Maximale Kompression 2 Default |
Set |
PrefixDelimiter” (ab CIB pdf toolbox 1.3.62) |
String |
Der Parameter—prefix-delimiter definiert ein Trennzeichen zwischen Alias und Variablennamen und schaltet den Präfix-Mechanismus fest ein. Durch Setzen des Parameters—prefix-delimiter werden beim Einsatz von Multiknoten die Variablen eindeutig gehalten. Default=leer |
Set |
PrintCentered |
String |
Ist die Property auf „1“ gesetzt, wird die Seite(in x- und y-Richtung) bezüglich des bedruckbaren Bereichs(nicht des Papiers) zentriert. (default) Ist diese Property auf „0“ gesetzt, findet kein Zentrieren statt. |
Get/ |
PrintScaling |
String |
Skalieroptionen der Seiten auf den Druckbereich: PrintScaleNone – Die PDF-Seite wird nicht auf Druckerbegrenzungen skaliert. D.h. Texte und Grafiken werden abgeschnitten, wenn sie außerhalb der Druckseitengröße liegen. Die linke obere Ecke der PDF-Seite entspricht der linken oberen Ecke des bedruckbaren Bereichs - nicht des Papiers. Falls die PDF-Seite nicht im gleichen Seitenformat wie das Papier ist, bezieht sich die linke obere Ecke der PDF-Seite auf die gedrehte Druckseite.(default) PrintScaleDown – größeres Papier wird auf den bedruckbaren Bereich skaliert. PrintScaleFit – Das Papier wird passend auf den bedruckbaren Bereich skaliert, d.h. größere werden verkleinert und kleinere vergrößert |
Get/ |
Progress |
String |
Returning a JSON-description of current progress of the current running JOB. This property can be retrieved from a different thread as the thread in which the current execute is running. The JSON description consists of the Keys “AmountSteps” and “CurrentStep”. AmountSteps defines, how many internal bigger steps are done and the CurrentStep defines how many Steps were already done. |
Get |
RegenerateXMP (ab CIB pdf toolbox Version 1.6.116f) |
String |
„0“: Es wird nichts getan. (default) „1“: Aktualisiert XMP-Daten im PDF aus den DocInfo Werten. |
Set |
RenderingEngine (ab CIB pdf toolbox Version 1.7.0)
|
String |
“Internal” – Interne Rendering-Engine wird verwendet (Default für Unix-Systeme) “WinGDI” – Windows Rendering-Engine wird verwendet (Default für Windows-Systeme) “CIBRenderer” – Pango-Cairo Rendering-Engine wird verwendet; |
Set |
TraceFilename |
String |
Gibt an, wohin die Logmeldungen der Toolbox ausgegeben werden |
Get/ |
RegionTemplate |
String |
Über die Property wird der Name der XFDF-Datei übergeben, die die Bereiche (Rechtecke) enthält, aus denen Text extrahiert werden soll. Der extrahierte Text wird in eine XFDF- bzw. CSV-Datei geschrieben. Voraussetzung: RegionTemplate=<name>.xfdf |
Set |
RegionThreshold |
String |
Die Property gibt den prozentualen Anteil an, ab dem ein Zeichen zur Region gehört. Wenn also ein Zeichen zu einem geringeren Prozentsatz als hier angegeben in die Region hineinragt, zählt es nicht zur Region. RegionThreshold=<integer> Voraussetzung: |
Set |
SvgImageBounds (ab CIB pdf toolbox Version 1.20.0) |
String |
Über diese Property kann die maximale Auflösung (und damit die Größe der Ausgabe des Rendering-Prozesses) für SVG-Grafiken begrenzt werden. Möglicher Wert: Ein JSON-String mit folgenden Parametern/Werten: { „MinImageHeight“: 50, „MinImageWidth“: 50, „ResolutionThresholdJpeg“: 180, „ResolutionThresholdPng“: 180, „MaxResolutionJpeg“: 150, „MaxResolutionPng“: 150, } |
Set |
TempPath (ab CIB pdf toolbox Version 1.20.0) |
String |
Der in dieser Property angegebene Pfad wird verwendet für die Ablage von Andere Pfade wie z.B. zum Verzeichnis der Ausgabedatei, werden von dieser Property nicht beeinflusst. Der Pfad muss auf ein gültiges Verzeichnis verweisen. Es kann sich um einen relativen oder absoluten Pfad handeln. |
Set |
GraphicLayerInfo (ab CIB pdf toolbox Version 1.25.0) |
String |
In dieser Property wird zurückgemeldet, welche Grafiken beim Renderingvorgang im PDF gefunden werden. Erforderlich sind: OutputFormat=FormatText | FormatWebview | FormatJavaView RenderingEngine=CIBRenderer. Die Ausgabe hängt vom Inhalt der Property PageSelection ab: PageSelection leer: GraphicLayerInfo enthält die Information für das ganze PDF PageSelection gesetzt: GraphicLayerInfo enthält die Information für jede ausgewählte Seite Beispiele: PageSelection leer: {"stats": {"inlineImageCount":9,"externalImageCount":3,"externalImageIdents":[10,15,20]}} PageSelection gesetzt auf “1-2”: {"stats": [ {"inlineImageCount":0,"externalImageCount":1,"externalImageIdents":[10]}, {"inlineImageCount":3,"externalImageCount":2,"externalImageIdents":[15,20]}]} |
Get |
TextLayerInfo (ab CIB pdf toolbox Version 1.18.0) |
String |
In dieser Property wird zurückgemeldet, welche Textgruppen beim Renderingvorgang im PDF gefunden werden. Folgende Textgruppen sind möglich: any_visible – Jeder sichtbare Text simple_invisible – Unsichtbarer Text, nicht speziell gekennzeichnet cibocr_invisible – Unsichtbarer Text, von der CIB pdf toolbox als CIB_HOCR gekennzeichnet others_invisible – Unsichtbarer Text, von anderen PDF-Prozessoren gekennzeichnet Beispiel: {”groups”: [”any_visible”, “simple_invisible”, “cibocr_invisible”, “others_invisible”]}
Hinweise: OutputFormat muss auf Die PageSelection Property beeinflusst das Ausgabeformat der Property TextLayerInfo.
Beispiele: Keine PageSelection gesetzt: PageSelection ist gesetzt auf 1-3, |
Get |
TextMark (ab CIB pdf toolbox Version 1.37.0) |
String |
Die Eigenschaft funktioniert nur für das Ausgabeformat FormatText und arbeitet in Verbindung mit TextSelectionFilter. Wenn der Wert von TextSelectionFilter gesetzt ist als: TextSelectionFilter={"groups":["marked_invisible"]} Dann gibt die CIB pdf toolbox nur unsichtbaren Text aus, der mit einem speziellen Tag markiert ist, der durch die Eigenschaft TextMark angegeben wird. Für andere Gruppen im TextSelection-Filter wird die Eigenschaft TextMark ignoriert. Die CIB pdf toolbox extrahiert Text, der im pdf-Inhaltsstrom mit einem speziellen Tag markiert ist: CIB_HOCRerty. TextMark wird ignoriert. Beispiel: CibRsh.exe OutputFormat=FormatText TextSelectionFilter= {"Gruppen":["marked_invisible"]} TextMark=CIB_HOCR -fj Eingabe.pdf Ausgabe.txt |
Get |
TextOutput (ab CIB pdf toolbox Version 1.37.0) |
String |
Wenn wir FillTextOutput=1 setzen, dann wird die Ausgabeeigenschaft TextOutput mit Text in Utf8-Kodierung gefüllt. |
Get |
TextSelectionFilter (ab CIB pdf toolbox Version 1.18.0) |
String |
Über TextSelectionFilter kann die Property IncludeInvisibleText konfiguriert warden, d.h. sie steuert im Detail, welche Arten von sichtbaren und unsichtbaren Texten ausgegeben werden.
Als Auswahl können zusätzlich zu den einfachen Textgruppen any_visible, simple_invisible, cibocr_invisible, others_invisible (Details siehe Property TextLayerInfo) auch zusammengesetzte Textgruppen verwendet werden: any_invisible – jeder unsichtbare Text (simple_invisible + cibocr_invisible + others_invisible) any – jeder Text (any_visible + any_invisible) Hinweise: Die Property beeinflusst nur Ausgabe in Text- und Metafiles. Sie ist nur gültig für OutputFormat Beispiele: TextSelectionFilter={“groups“:[“cibocr_invisible“]}
TextSelectionFilter={”groups”:[”any_visible”, “any_invisible”]} |
Set |
UseColorProfileForCMYK (ab CIB pdf toolbox Version 1.4.98) |
String |
Mögliche Werte für Umwandlung in RGB: „1“ „US Web coated“ und „sRGB“ Profile werden benutzt (default) „0“ einfache Variante |
Set |
UseJbig2Compression (ab CIB pdf toolbox Version 1.10.0) |
String |
Achtung: Nur für Grafik-Overlay Über diese Property kann die für Overlay-Grafiken standardmäßig aktivierte Jbig2-Kompression deaktiviert werden. 0 Jbig2-Kompression wird deaktiviert, Der Standard ZLIB Kompression wird angewendet. 1 Jbig2-Kompression wird aktiviert (default) Hinweis: |
Set |
UseWinGDI |
String |
Wird nicht mehr verwendet, „1“ = Windows Rendering-Engine wird verwendet (Default für Windows-Systeme) „0“ = Interne Rendering-Engine wird verwendet (Default für Unix-Systeme) |
Set |
UseSvgExternalImages (ab CIB pdf toolbox Version 1.17.0) |
|
Ermöglicht es, alle internen Bilder, die zu SVG Grafiken zusammengefasst sind, separat vom SVG Inhalt als externe Resourcen zu speichern (JPEG oder PNG). Mögliche Werte: 0 deaktiviert 1 aktiviert |
|
ViewCallback |
String |
Adresse des Callbacks für Rückmeldung nach jeder Seite (interne Prop.) |
Get/ |
WorkSpace
(ab CIB pdf toolbox Version 1.4.81):
(ab CIB pdf toolbox Version 1.4.84): |
String |
Definitiert das Arbeitsverzeichnis für alle Dateinamensangaben, ausgenommen Ausgabedateien. Der Pfad wird als nullterminierte Zeichenkette angegeben. Der Pfad kann absolut angegeben werden oder relativ zum Arbeitsverzeichnis des aufrufenden Prozesses. Alle Dateiangaben (ohne absoluten Pfad) in Properties werden relativ zu diesem Workspace betrachtet. Es kann auch eine Liste von Arbeitsverzeichnissen angegeben werden. Die einzelnen Angaben werden durch Semikolon getrennt. Für jede verwendete Datei wird eine Suche gestartet und die erste Fundstelle genutzt. Ab dieser Version gilt die Property WorkSpace nicht mehr für Ausgabedateien. |
Get/ |
PageXmpMetadata (ab CIB pdf toolbox Version 1.14.0): |
String |
Diese Property dient dem Hinzufügen bzw. Überschreiben von Seiten-bezogenen Metadaten in einem PDF. Sie werden auf der jeweiligen Seite über “/Metadata“ referenziert. Syntax: Für jede Seite bzw. Seitenbereich des Ausgabe-PDFs können Metadaten (UTF-8 kodiert) spezifiziert werden. Die Metadaten können als XML-Datei oder Speicherblock übergeben werden. Wenn eine Seite bereits Metadaten enthält, so werden diese durch die neuen Daten ersetzt. Sind nur einige Seiten eines Dokuments angesprochen, bleiben Metadaten der restlichen Seiten unverändert erhalten. Beispiele: PageXmpMetadata= PageXmpMetadata= PageXmpMetadata= |
Set |
XMPMetadataExtension |
String |
Erlaubt die Angabe eines oder mehrerer XMP-Snippets vom Typ rdf:Description. Diese werden beim Konvertierungsvorgang (CibPdfSave()) der Metainfo des entstehenden PDFs hinzugefügt. Bitte beachten Sie dabei die offizielle XMP Spezifikation von Adobe. |
Set |
XfdfIgnorePageRotation (ab CIB pdf toolbox Version 1.17.0): |
String |
0 (default): Koordinaten werden im Seitenkoordinatensystem interpretiert und abhängig von Seitenausrichtung und cropping. (0,0) ist der Ursprung der MediaBox der Seite. 1: Koordinaten werden relativ zur sichtbaren Seite interpretiert. (0,0) ist die Koordinate Links Unten auf der sichtbaren seite (Nach zuschneiden und drehen) |
Set |
XfdfFlipPositionY ab CIB pdf toolbox Version 1.24.0): |
String |
Über diese Property wird der Ausgangspunkt / Anker der Koordinaten von links unten nach links oben geändert. 0 (default): Ausgangspunkt / Anker der Koordinaten links unten 1: Ausgangspunkt / Anker der Koordinaten links oben |
Set |