Zum Hauptinhalt springen

PpcMakePreviewJpg

obj -> PpcMakePreviewJpg(alpha1, point2[, int3]) : int​

Ausführbar von Clients mit grafischer Oberfläche Ausführbar vom Server Ausführbar von der Web-Schnittstelle Ausführbar vom Druckprozessor Ausführbar von der ODBC-Schnittstelle

Preview-Dateien im JPEG-Format erstellen

Details

Der Befehl erzeugt einzelne Preview-Dateien ausgewählter Seiten der Originaldatei im JPEG-Format.

In (obj) wird der Deskriptor des PpcObject angeben. Der Deskriptor wird der Funktion des Druckprozessors übergeben.

Für jede Seite, die in das durch die Eigenschaft SelectPvw definierte Auswahlkriterium fällt, wird eine Preview-Datei erstellt. Damit möglichst einfach Dateinamen für die einzelnen Preview-Dateien generiert werden können, ist im Argument (alpha1) die Angabe des '%d' Format-Spezifizierers möglich.

Beispiel:

tPpcObject->ppSelectPvw # 'odd()';
tPpcObject->PpcMakePreviewJpg('preview_%d.jpg', PointMake(150, 75));

'%d' wird im Dateiname der Preview-Datei durch die entsprechende Seitennummer ersetzt. Das Beispiel erzeugt Previews aller ungeraden Seiten: preview_1.jpg, preview_3.jpg, preview_5.jpg, ...

Es können auch mehrere Format-Anweisungen im Dateinamen angegeben werden.

tPpcObject->ppSelectPvw # 'odd()';
tPpcObject->PpcMakePreviewJpg('pvw_%d_%d.jpg', PointMake(150, 75));

Es werden dann folgende Dateien erzeugt: pvw_1_1.jpg, pvw_3_3.jpg, pvw_5_5.jpg, ...

Soll das Prozentzeichen im Dateiname benutzt werden, wird dies durch Angabe eines doppelten Prozentzeichens ('%%') erreicht.

Weiterhin sind folgende Formatierungsangaben zulässig:

  • '%<n>d': '<n>' ist eine Ziffer (1 ... 9), die die Anzahl der Stellen festlegt. Nicht vorhandene Stellen werden durch Leerzeichen aufgefüllt.
  • '%0<n>d': wie '%<n>d' nur das nicht mit Leerzeichen, sondern mit Nullen aufgefüllt wird.

Die Angabe des Formatspezifizierers im Dateiname ist optional. Ist eine Datei mit demselben Namen bereits vorhanden, wird diese überschrieben.

info

Der Druckprozessor läuft als Dienst. D. h. das Programm läuft im Benutzerkontext "System". Dieser Benutzer hat in der Regel keinen Zugriff auf Netzwerkressourcen. In (alpha1) können also nur lokale Laufwerke angegeben werden.

In (point2) wird Breite und Höhe des zu erstellenden Images in Pixel angegeben. Ist eine der Ausdehnungen 0, wird das Bild unter Beibehaltung des Seitenverhältnisses skaliert. Sind beide Ausdehnungen auf 0 gesetzt, wird ein Vorschaubild in Originalgröße erzeugt. Beim Ausdruck über den PDF Druckertreiber ist die Auflösung auf 300 DPI begrenzt. (int3) bestimmt die Qualität des JPEGs. Zulässig sind die Werte 1 bis 100 (Prozent). Fehlt die Angabe ist die Qualität automatisch 100 Prozent.

Mögliche Rückgabewerte: