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.