THotPDF.RegisterLabColorSpace Method

רושם color space מסוג CIELab עבור PDF 1.3 ‏(ISO 32000-1 8.6.5.3) תחת resource name שנוצר אוטומטית, כגון Lab1, Lab2 וכן הלאה. השתמש בשם המוחזר עם THPDFPage.SetFillColorSpace / SetStrokeColorSpace ולאחר מכן SetFillColor / SetStrokeColor, תוך העברת שלושת רכיבי L*a*b*

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

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

CIELab color space מתאר צבעים ללא תלות בהתקן תצוגה או הדפסה: L* מבטא בהירות ב-[0..100], ‏a* את ציר green/red, ו-b* את ציר blue/yellow, בדרך כלל [-128..127]. PDF viewers תואמים ממירים L*a*b* לצבע התקן באמצעות illuminant ‏WhitePoint שהוגדר. illuminants נפוצים:

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.

הערך המוחזר: resource name שנוצר אוטומטית, כגון Lab1, Lab2 וכן הלאה. מוחזרת מחרוזת ריקה כאשר StrictVersionLock מופעל וה-Version הפעילה נמוכה מ-PDF 1.3; אחרת הגרסה עולה אוטומטית ל-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;