RecolorDocument
Farve
Beskrivelse
Flytter alle dokumentets sider til ét farverum.
Syntaks
Delphi
Function TPDFlib.RecolorDocument(TargetSpace: Integer): Integer;Parametre
| TargetSpace | 1 grå, 2 RGB, 3 CMYK. |
|---|
Returværdier
| Count | Hvor mange farver der blev konverteret i hele dokumentet. |
|---|---|
| 0 | Intet skulle konverteres, eller TargetSpace lå uden for 1 til 3. En side, hvis farver allerede ligger i målfarverummet, beholder sine oprindelige bytes |
Bemærkninger
Konverteringen er almindelig enhedsaritmetik og ikke farvestyret: Et dokument, der kun angiver DeviceRGB, har ingen profil at konvertere gennem. RGB bliver grå ved hjælp af luminansvægtene i ITU-R BT.601, og CMYK konverteres som beskrevet i ISO 32000-1 §8.6.4.4, hvilket er det, en fremviser allerede gør, når den viser et CMYK-dokument på en skærm
Farver, der er angivet gennem et ICCBased-, Separation-, Indexed- eller Pattern-rum, efterlades uændrede. Hvis deres komponenter blev læst uden deres profil, ville sidens udseende ændres i stedet for at blive bevaret, så et sådant dokument konverteres kun i de dele, der direkte navngiver et enhedsfarverum.
De billeder, som en side tegner, konverteres også, når billedet har otte bit pr. komponent, et enhedsfarverum og enten ingen komprimering eller almindelig Flate. Et JPEG- eller faxbillede skulle omkodes, hvilket er en anden handling end konvertering af dets farver, så det beholder sine egne bytes.
Et indekseret billede konverteres i stedet gennem sin farvetabel, så dets prøver beholder de indekser, de allerede havde. Denne sti er uafhængig af, hvordan prøverne er pakket eller komprimeret, og derfor kan et skærmbillede eller diagram med en palet konverteres, selv om dets prøver ikke kunne omskrives
Gradienter konverteres sammen med funktionerne bag dem, så rummet og stoppene altid stemmer overens. En gradient opbygget fra en sampled- eller PostScript-funktion bevarer sine egne farver, ligesom mesh-shadingtyperne, der indeholder deres farver i en stream i stedet for en funktion.
Soft masks og stencilmasker ændres ikke. Begge læses som dækning frem for farve, og konvertering ville få siden til at vise masken som et billede
Geometri, tekst, klipning og alle andre operatorer skrives uændret tilbage
Den valgte side gendannes, når kaldet 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');