RecolorDocument
Farge
Beskrivelse
Flytter hver side i dokumentet inn i ett fargerom
Syntaks
Delphi
Function TPDFlib.RecolorDocument(TargetSpace: Integer): Integer;Parametere
| TargetSpace | 1 grey, 2 RGB, 3 CMYK. |
|---|
Returverdier
| Count | Hvor mange farger som ble konvertert i hele dokumentet |
|---|---|
| 0 | Ingenting trengte konvertering, eller TargetSpace var utenfor 1 til 3. En side hvis farger allerede er i målrommet beholder sine opprinnelige bytes |
Merknader
Konverteringen er den vanlige enhetsaritmetikken i stedet for en fargeadministrert en: et dokument som bare sier DeviceRGB bærer ingen profil å konvertere gjennom. RGB blir grå etter luminansvektene i ITU-R BT.601, og CMYK konverteres som beskrevet i ISO 32000-1 §8.6.4.4, vilket er hva en fremviser allerede gjør når den viser et CMYK-dokument på en skjerm
Farger satt gjennom et ICCBased-, Separation-, Indexed- eller Pattern-rom får være som de er. Å lese komponentene deres uten profilen deres ville endre hvordan siden ser ut i stedet for å bevare den, så et slikt dokument konverteres bare i delene som navngir et enhetsrom direkte
Bildene en side tegner konverteres også, når bildet bærer åtte bit per komponent, et enhetsfargerom, og enten ingen kompresjon eller ren Flate. Et JPEG- eller faksbilde måtte vært rekodet, noe som er en annen operasjon enn å konvertere fargene, så det beholder sine egne bytes
Et indeksert bilde konverteres i stedet gjennom sin fargetabell, slik at prøvene beholder indeksene de allerede hadde. Den stien bryr seg ikke om hvordan prøvene er pakket eller komprimert, og det er hvordan et paletteskjermbilde eller diagram konverteres selv om prøvene ikke kunne omskrives
Gradienter konverteres med funksjonene bak dem, så rommet og stoppunktene samsvarer alltid. En gradient bygget fra en samplings- eller PostScript-funksjon beholder sine egne farger, likeså mesh-shading-typene, som bærer fargene sine i en strøm i stedet for i en funksjon
Bløte masker og stencilmasker får være i fred. Begge leses som dekning i stedet for som farge, og å konvertere én ville la siden vise masken som et bilde
Geometri, tekst, klipping og alle andre operatorer skrives tilbake uendret
Den valgte siden gjenopprettes når kallet returnerer
Eksempel
// Send a mixed-colour document to a press that expects CMYK
PDF.LoadFromFile('brochure.pdf', '');
Converted := PDF.RecolorDocument(3);
PDF.SaveToFile('brochure-cmyk.pdf');