THotPDF.RegisterLabColorSpace Method

 

THotPDF.RegisterLabColorSpace

THotPDF

 

Κορυφή

Καταχωρεί PDF 1.3 CIELab color space (ISO 32000-1 8.6.5.3) κάτω από auto-generated resource name (Lab1, Lab2, ...). Χρησιμοποιήστε το returned name με THPDFPage.SetFillColorSpace / SetStrokeColorSpace και έπειτα SetFillColor / SetStrokeColor περνώντας τα τρία L*a*b* components

 

Delphi syntax:

function RegisterLabColorSpace(WhitePointX, WhitePointY, WhitePointZ: Single; RangeAMin, RangeAMax, RangeBMin, RangeBMax: Single): AnsiString;

 

C++ syntax:

AnsiString RegisterLabColorSpace(float WhitePointX, float WhitePointY, float WhitePointZ, float RangeAMin, float RangeAMax, float RangeBMin, float RangeBMax);

 

Περιγραφή

Το CIELab color space περιγράφει χρώματα ανεξάρτητα από οποιαδήποτε display ή printing device: το L* εκφράζει lightness στο [0..100], το a* τον green/red axis και το b* τον blue/yellow axis (συνήθως [-128..127]). Οι conforming PDF viewers μετατρέπουν L*a*b* σε device color χρησιμοποιώντας το configured WhitePoint illuminant. Κοινά illuminants:

 

D50  - ICC print standard. WhitePoint = [0.9505, 1.0, 1.089].

D65  - sRGB / display standard. WhitePoint = [0.95047, 1.0, 1.08883].

 

WhitePoint Y must equal 1.0 per spec table 64; X and Z must be positive. Passing all four Range parameters as zero falls back to the spec's implicit default [-100 100 -100 100]; pass any non-zero combination to override.

 

Return value: auto-generated resource name (Lab1, Lab2, ...). Επιστρέφει κενό string όταν το StrictVersionLock είναι on και το active Version είναι κάτω από PDF 1.3 (διαφορετικά το version γίνεται auto-bump σε 1.3)

 

Code Example

// Register a D50 Lab space for print, paint a magenta swatch
var
  CSName: AnsiString;
begin
  HPDF.Version := pdf14;
  HPDF.BeginDoc;
  CSName := HPDF.RegisterLabColorSpace(
    0.9505, 1.0, 1.089,        // D50 WhitePoint
    -128, 127, -128, 127);     // standard a* and b* range
  HPDF.CurrentPage.SetFillColorSpace(CSName);
  HPDF.CurrentPage.SetFillColor([50.0, 60.0, -50.0]);  // L* a* b*
  HPDF.CurrentPage.Rectangle(60, 60, 200, 100);
  HPDF.CurrentPage.Fill;
  HPDF.EndDoc;
end;

 

See Also

Version, Compression, PDF Filter Support