Neue Versionen
-
Letzte Änderung: Feb 16, 2023
Beliebige Inhalte platzieren: Informationen über das PDF-Dokument verwenden
Um beim Platzieren von Inhalten auf Informationen aus dem PDF-Dokument oder auf die verwendeten Variablen und ihre Werte zurückgreifen zu können, wird zur Aufrufzeit im Unterordner "callas_tmp" eine Datei "calsDocInfo.js" bereitgestellt bzw. vor jeder Ausführung einer "Inhalt platzieren"-Korrektur aktualisiert, die einige nützliche Informationen enthält:
- Dateiname
- Dateipfad
- Variablen, die für die Ausführung der "Inhalt platzieren"-Korrektur (bzw. des Profils, in dem diese Korrektur enthalten ist) verwendet wurden, einschließlich der übergebenen Werte für diese Variablen
- Dokumentinformations-Metadatenfelder: Titel, Autor, Thema, Sticchwörter
- für jede Seite die Seitengeometrierahmen (MediaBox, CropBox, BleedBox, TrimBox, ArtBox) sowie das "Page label"
Diese Informationen sind als Wert der Variablen "cals_doc_info" repräsentiert und können per JavaScript ausgelesen werden.
Beispiel für die Informationen in einer "calsDocInfo.js"-Datei:
var cals_doc_info = { 'document':{ 'name':'Example.pdf', 'path':'\/Users\/odruemmer\/Desktop', 'info':{ 'author':'Max Meyer' 'title':'Von cals_doc_info und anderen nützlichen Dingen', 'subject':null, 'keywords':'pdfChip; nützlich; Dokumentinformationen; Variablen; Sonderfarben; Flächendeckung; Trefferpositionen' }, 'numberofpages':2, 'completeinkinformation':false, 'variables':[ { 'name':'minimum', 'value':'0' }, { 'name':'maximum', 'value':'100' } ] }, 'pages':[ { 'mediabox':[ 0, 0, 4251.97, 2834.65 ], 'trimbox':[ 0, 0, 4251.97, 2834.65 ], 'bleedbox':[ 0, 0, 4251.97, 2834.65 ], 'cropbox':[ 0, 0, 4251.97, 2834.65 ], 'artbox':[ 0, 0, 4251.97, 2834.65 ], 'pagenumber':0, 'pagelabel':'front side' }, { 'mediabox':[ 0, 0, 4251.97, 2834.65 ], 'trimbox':[ 0, 0, 4251.97, 2834.65 ], 'bleedbox':[ 0, 0, 4251.97, 2834.65 ], 'cropbox':[ 0, 0, 4251.97, 2834.65 ], 'artbox':[ 0, 0, 4251.97, 2834.65 ], 'pagenumber':1, 'pagelabel': 'back side' } ] };
Weitergehende Informationen anfordern
Weitergehende Informationen über das PDF-Dokument können zusätzlich angefordert werden - mit Hilfe einer sog. Manifest-Datei ("manifest.xml"). In dieser Manifest -Datei kann man folgende Arten von Informationen zusätzlich anfordern:
- Name und Ersatzdarstellung der im PDF enthaltenen Sonderfarben: <x:inkinfo/>
- Flächendeckung pro Farbkanal pro Seite: <x:inkcov aperture="1mm" bbox="trimbox"/>; Achtung: diese Informationen erfordern es, dass jede Seite mit einer einstellbaren Auflösung (über den Blendenwert - aperture - anzugeben) gerendert wird, was die Ausführung etwas verlangsamen kann
- die bounding box (umschließendes Rechteck) pro "Treffer" für eine "Anwenden auf"-Prüfung, die in der "Inhalt platzieren"-Korrektur eingestellt ist: <x:hitinfo/>
Diese Angaben zur Informationsanforderung müssen in einem <x:resources>-Knoten innerhalb des <manifest>-Wurzelknotens enthalten sein:
<?xml version="1.0" encoding="UTF-8" ?> <manifest xmlns:x="http://www.callassoftware.com/cchip/template/manifest/"> <x:resources> < ... eine oder mehrere Einträge mit Informationsanforderungen ... /> </x:resources> </manifest>
Fordert man alle verfügbaren Informationen an, sieht die Manifest-Datei wie folgt aus:
<?xml version="1.0" encoding="UTF-8" ?> <manifest xmlns:x="http://www.callassoftware.com/cchip/template/manifest/"> <x:resources> <!--- include ink info (ink names and alternate appearance only): --> <x:inkinfo/> <!--- include ink coverage info: ink names, usagecm, usage percent Ink coverage is determined by rendering the bbox of each page with the specified aperture; units for aperture can be pt or mm bbox can be mediabox, cropbox, bleedbox, trimbox (Default: bbox: trimbox, aperture: 15mm) --> <x:inkcov aperture="1mm" bbox="trimbox"/> <!--- include bbox info for items found by "Apply to" check --> <x:hitinfo/> </x:resources> </manifest>
Nachstehend ein Beispiel einer "calsDocInfo.js"-Datei mit maximaler Bereitstellung von Informationen. Von besonderem Interesse sind hier:
- "completeinkinformation" steht auf true; dies heisst, dass sowohl die vorhandenen Sonderfarben aufgelistet sind (samt ihrer Ersatzdarstellung in CMYK-Werten), wie auch alle Farbkanäle aufgelistet mit Angabe ihrer jeweiligen Flächendeckung (anteilig in Prozent bezogen auf die angegebene Seitenfläche (z.B. trimbox) und absolut als Fläche in Quadratzentimetern)
- für jede Dokument-Seite ist ein Eintrag "inks" vorhanden, der die vorgenannten Information zu Sonderfarben und zur Flächendeckung aller Farbkanäle enthält
- für die beiden Sonderfarben "Himmelblau" und "Tomatenrot" sind die Tonwerte für die Ersatzdarstellung in CMYK angegeben.
- unter "hits" finden sich die bounding boxes ("bbox", umschließenden Rechtecke) für jeden Treffer der in der "Inhalt platzieren"-Korrektur eingestellten "Anwenden auf"-Prüfung – in diesem Beispiel ist dies eine Prüfung auf Sonderfarbobjekte.
var cals_doc_info = { 'document':{ 'name':'zwei Sonderfarben.pdf', 'path':'\/Users\/odruemmer\/Desktop', 'info':{ 'author':'OD', 'title':'zwei Sonderfarben', 'subject':'Testdatei für Sonderfarben', 'keywords':null }, 'numberofpages':1, 'completeinkinformation':true, 'variables':[ ] }, 'pages':[ { 'mediabox':[ 0, 0, 792, 612 ], 'trimbox':[ 0, 0, 792, 612 ], 'bleedbox':[ 0, 0, 792, 612 ], 'cropbox':[ 0, 0, 792, 612 ], 'artbox':[ 0, 0, 792, 612 ], 'pagenumber':0, 'pagelabel':null, 'inks':[ { 'name':"Cyan", 'usagecm':0, 'usagepercent':0 }, { 'name':"Magenta", 'usagecm':0, 'usagepercent':0 }, { 'name':"Yellow", 'usagecm':0, 'usagepercent':0 }, { 'name':"Black", 'usagecm':1.09066, 'usagepercent':0.180804 }, { 'name':"Himmelblau", 'alternatename':'cmyk', 'alternatecomps':[ 1, 0, 0, 0 ], 'alternateicc':null, 'usagecm':37.6872, 'usagepercent':6.24762 }, { 'name':"Tomatenrot", 'alternatename':'cmyk', 'alternatecomps':[ 0.15, 1, 1, 0 ], 'alternateicc':null, 'usagecm':37.6685, 'usagepercent':6.24453 } ], 'hits':[ { 'bbox':[ 82.2098, 129.289, 253.823, 229.147 ] }, { 'bbox':[ 473.391, 209.367, 253.823, 229.147 ] } ] } ] };
Wichtig für die erfolgreiche Verarbeitung ist, dass die Datei manifest.xml heissen muss und im zu verarbeitenden Ordner (neben der index.html-Datei) liegt.
Manual callas pdfToolbox -
Letzte Änderung: Feb 13, 2023
Using Variables for resources
Manual callas pdfToolbox -
Letzte Änderung: Jan 27, 2023
Migrate to a different location
Manual callas License Server -
Letzte Änderung: Jan 26, 2023
VDP Dateien aus PDF Vorlagen erzeugen
Manual callas pdfToolbox -
Letzte Änderung: Jan 16, 2023
Extended list of parameters for the barcode object
Manual callas pdfChip -
Letzte Änderung: Jan 16, 2023
List of supported barcodes and matrix codes
Manual callas pdfChip -
Letzte Änderung: Jan 16, 2023
How to create ITF-14 barcode with bearer bars
Manual callas pdfChip -
Letzte Änderung: Jan 16, 2023
How to create rectangular 16x48 DataMatrix Industry code
Manual callas pdfChip -
Letzte Änderung: Jan 16, 2023
Using gradient or image as "color" for QR code
Manual callas pdfChip -
Letzte Änderung: Jan 12, 2023
In Acrobat Pro parallel mit pdfaPilot und Preflight arbeiten
Viele Anwender möchten die Acrobat-eigene Preflight-Funktionalität nutzen und parallel die vielfältigen zusätzlichen Werkzeuge der pdfToolbox verwenden.
In diesem Tutorial wird erklärt, wie diese parallele Nutzung von Acrobat Preflight (eine Entwicklung von callas software, die Adobe seit 2003 als Bestandteil von Adobe Acrobat Pro ausliefert) und der callas pdfToolbox funktioniert.Manual callas pdfaPilot