RecolorPage
Farbe
Beschreibung
Verschiebt die ausgewählte Seite in einen Farbraum
Syntax
Delphi
Function TPDFlib.RecolorPage(TargetSpace: Integer): Integer;Parameter
| TargetSpace | 1 Grau, 2 RGB, 3 CMYK |
|---|
Rückgabewerte
| Count | Anzahl der auf dieser Seite konvertierten Farben |
|---|---|
| 0 | Es musste nichts konvertiert werden oder TargetSpace lag außerhalb des Bereichs von 1 bis 3. Die Seite behält dann ihre ursprünglichen Bytes |
Anmerkungen
Die Konvertierung verwendet normale Gerätearithmetik und kein Farbmanagement: Ein Dokument, das nur DeviceRGB angibt, enthält kein Profil, über das konvertiert werden könnte. RGB wird anhand der Luminanzgewichte von ITU-R BT.601 in Grau umgewandelt, CMYK entsprechend ISO 32000-1 §8.6.4.4; genauso verfährt bereits ein Viewer bei der Anzeige eines CMYK-Dokuments auf einem Bildschirm.
Farben, die über einen ICCBased-, Separation-, Indexed- oder Pattern-Farbraum festgelegt wurden, bleiben unverändert. Das Lesen ihrer Komponenten ohne ihr Profil würde das Erscheinungsbild der Seite ändern, statt es zu erhalten; ein solches Dokument wird daher nur in den Teilen konvertiert, die direkt einen geräteabhängigen Farbraum benennen
Bilder werden durch diesen Aufruf nicht konvertiert: Ein Bild kann auf mehreren Seiten gezeichnet sein, sodass seine Konvertierung hier auch nicht angeforderte Seiten verändern würde. Verwenden Sie RecolorDocument, um auch die Bilder zu konvertieren
Geometrie, Text, Clipping und jeder andere Operator werden unverändert zurückgeschrieben.
Die als page's layers bezeichneten Ebenen werden vor dem Durchlauf zusammengeführt, da eine auf einer Ebene festgelegte Farbe auf der nächsten wirksam bleibt und beim getrennten Lesen verloren ginge
Beispiel
PDF.SelectPage(1);
PDF.RecolorPage(1); // this page in grey