เมธอด THotPDF.RegisterNChannelColorSpace
ลงทะเบียน NChannel colour space แบบ process เท่านั้นหรือแบบผสม process กับ spot โดยใช้รูปแบบ attribute DeviceN ของ PDF 1.6
การประกาศ
function RegisterNChannelColorSpace(
const ColorantNames: array of AnsiString;
const AlternateCS: AnsiString;
const TintC1Matrix: array of Extended): AnsiString; overload;
function RegisterNChannelColorSpace(
const ColorantNames, ProcessColorantNames: array of AnsiString;
const AlternateCS: AnsiString; TintTransform: THPDFObject;
const SpotColorants: array of THPDFNChannelSpotColorant;
const PrintingOrder: array of AnsiString): AnsiString; overload;
ยูนิต
HPDFDoc
พารามิเตอร์
| ชื่อ | หน้าที่ |
|---|---|
ColorantNames | ชื่อที่แมปส่วนประกอบ process ของ NChannel เข้าสู่ process colour space |
AlternateCS | process colour space และ alternate colour space แบบ DeviceGray, DeviceRGB หรือ DeviceCMYK |
TintC1Matrix | matrix ของ tint transform ที่แมปค่า colorant เข้าสู่ alternate colour space |
ProcessColorantNames | ส่วนประกอบ process ที่เรียงลำดับแล้วซึ่งปรากฏใน master colorant array |
TintTransform | ฟังก์ชันแบบ indirect ที่แมป master colorant เข้าสู่ alternate colour space |
SpotColorants | ชื่อ spot, ฟังก์ชัน tint แบบ Separation, solidity ที่เลือกได้ และฟังก์ชัน dot-gain ที่เลือกได้ |
PrintingOrder | การเรียงสลับ (permutation) ของ colorant ทั้งหมด ทั้ง process และ spot แบบเลือกได้ |
ค่าที่ส่งกลับ
ชื่อ colour space resource สำหรับใช้กับ API ของ fill และ stroke colour space ในหน้า
หมายเหตุการใช้งาน
- สร้าง array
DeviceNห้าส่วนประกอบ โดย attributes dictionary มี/Subtype /NChannelและ dictionary/Processที่สอดคล้องกัน - ต้องการ PDF 1.6 ขึ้นไป และปฏิเสธชื่อส่วนประกอบที่ว่าง ซ้ำ เป็น
Allหรือเป็นNone DeviceGrayต้องการหนึ่งส่วนประกอบ,DeviceRGBต้องการสามส่วนประกอบที่เรียงลำดับแล้ว และชุดDeviceCMYKแบบบางส่วนใช้ชื่อสงวนCyan,Magenta,YellowและBlack- overload แบบขั้นสูงสร้างนิยาม Separation รายตัวใน
/Colorants, ส่วนประกอบ/Processแบบตรงตัว และ/MixingHintsที่เลือกได้ซึ่งมี/Solidities,/PrintingOrderและ/DotGain - array master, process และ spot ต้องครอบคลุมทุก colorant ครบพอดีหนึ่งครั้ง, ฟังก์ชัน tint กับ dot-gain ต้องเป็นแบบ indirect ที่มีรูปร่างถูกต้อง และ solidity ต้องอยู่ในช่วง 0 ถึง 1
- การลงทะเบียนชื่อ spot เดิมกับ alternate colour space หรือ tint function ต่างกันภายในเอกสารเดียวจะล้มเหลวก่อนส่งออก