Recent Updates

  • 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.

  • Updated on: May 07, 2021

    Place dynamic text

    pdfToolbox 8.0 supports a variety of information using static as well dynamic text in a PDF file. Different fonts, colors and placement options can be added.

    Using the Fixup "Place specified text at the center of each page" you can add text in a PDF file. In this tutorial we add the watermark "Draft".

  • In pdfToolbox 8.0 you have the opportunity to select individual color separations in the PDF file using the Visualize panel to view the values. In version 8.1 the tool is extended with ink coverage information for all separations.

  • Updated on: May 07, 2021

    Place dynamic page numbers

    pdfToolbox 8.0 supports a variety of information using static as well dynamic text in a PDF file. Different fonts, sizes, colors, placement options and other design specifications can be added.

    In this tutorial the dynamic text functionality is used. Page nummers are added in the PDF file.

  • Updated on: May 03, 2021

    Using QuickFix on the command line

  • Updated on: May 03, 2021

    Using QuickFix on the command line

  • Updated on: Apr 30, 2021

    Proximity: Objects close to each other

  • Updated on: Apr 29, 2021

    Migrate to another hardware

  • Updated on: Apr 29, 2021

    QuickFix features

  • Updated on: Apr 29, 2021

    QuickFix features