RecolorPage
Kleur
Beschrijving
Zet de geselecteerde pagina om naar één kleurruimte
Syntaxis
Delphi
Function TPDFlib.RecolorPage(TargetSpace: Integer): Integer;Parameters
| TargetSpace | 1 grey, 2 RGB, 3 CMYK. |
|---|
Retourwaarden
| Count | Hoeveel kleuren op deze pagina zijn geconverteerd |
|---|---|
| 0 | Er hoefde niets te worden geconverteerd, of TargetSpace lag buiten 1 tot 3. De pagina houdt dan zijn originele bytes |
Opmerkingen
De conversie is de gewone device-rekunde, geen kleurbeheerde: een document dat alleen DeviceRGB noemt draagt geen profiel om doorheen te converteren. RGB wordt grijs via de luminantiegewichten van ITU-R BT.601, en CMYK converteert zoals beschreven in ISO 32000-1 §8.6.4.4 — precies wat een viewer al doet wanneer hij een CMYK-document op een scherm toont
Kleuren die via een ICCBased-, Separation-, Indexed- of Pattern-ruimte zijn gezet blijven onaangetast. Hun componenten lezen zonder hun profiel zou veranderen hoe de pagina eruitziet in plaats van behouden, dus zo'n document wordt alleen geconverteerd in de delen die rechtstreeks een device space noemen
Afbeeldingen worden door deze aanroep niet geconverteerd: een afbeelding kan op meer dan één pagina worden getekend, dus hier converteren zou pagina's veranderen waar de aanroeper niet om vroeg. Gebruik RecolorDocument om de afbeeldingen mee te converteren
Geometrie, tekst, clipping en alle andere operatoren worden ongewijzigd teruggeschreven
De lagen van de pagina worden vóór de pas samengevoegd, omdat een kleur die op één laag is gezet op de volgende doorwerkt en ze apart lezen dat kwijtraakt
Voorbeeld
PDF.SelectPage(1);
PDF.RecolorPage(1); // this page in grey