THotPDF.RegisterCoonsPatchMesh 메서드

PDF 1.3+ Coons 패치 메시 셰이딩(ISO 32000-1 8.7.4.5.6, /ShadingType 6)을 선언하고, 페이지 Resources/Pattern 사전 안의 인라인 Pattern Type 2 항목으로 감쌉니다. 각 패치는 네 개의 3차 Bezier 곡선으로 둘러싸이며 모서리마다 색을 하나씩 가지고, 렌더러가 네 변 사이에 Coons 곡면을 맞춰 임의로 휘어진 색상 쿼드를 만들어 냅니다. 곡선 경계를 근사하는 데 직선 변 삼각형 메시(RegisterFreeFormGouraudShading, RegisterLatticeFormGouraudShading)로는 삼각형이 너무 많이 필요할 때 사용하세요. 휘어진 경로 위의 포일·메탈릭 그라디언트, SVG에서 파생된 그라디언트 메시, 변이 곡선인 모든 쿼드가 해당됩니다.

function RegisterCoonsPatchMesh(XMin, YMin, XMax, YMax: Single; NumComponents: Integer; const Patches: array of Extended): AnsiString;

AnsiString RegisterCoonsPatchMesh(float XMin, float YMin, float XMax, float YMax, int NumComponents, const Extended* Patches, int PatchesElementCount);

셰이딩은 /ShadingType 6, /BitsPerCoordinate 16, /BitsPerComponent 8, /BitsPerFlag 8을 갖는 indirect 스트림으로 출력됩니다. 각 패치는 플래그 1바이트(독립 패치는 항상 0), 제어점 12개(각 4바이트: big-endian X 2바이트 + big-endian Y 2바이트), 모서리 색 4개(각 NumComponents 바이트) 순으로 패킹되어 패치당 총 1 + 48 + 4 * NumComponents바이트가 됩니다. /Decode 배열은 16비트 좌표를 전달된 [XMin, XMax] x [YMin, YMax] user-space 사각형으로, 각 색 성분을 [0, 1]로 되돌려 매핑합니다.

제어점 12개는 모서리 1에서 시작해 패치 경계를 시계 방향으로 돌며 c1..c12로 번호가 매겨집니다. 네 모서리는 c1 / c4 / c7 / c10이고, 나머지 여덟 개(c1과 c4 사이의 c2, c3, c4와 c7 사이의 c5, c6, c7과 c10 사이의 c8, c9, c10과 c1 사이의 c11, c12)는 각 3차 곡선 변의 안쪽 Bezier 핸들입니다. 안쪽 핸들이 인접한 모서리 사이의 직선 위 1/3, 2/3 지점에 있으면 Coons 곡면은 쌍선형 보간으로 퇴화하며, 시각적으로 꼭짓점 4개짜리 Type 4 메시와 같습니다.

XMin, YMin, XMax, YMax - 인코딩되는 좌표의 경계가 되는 user-space 사각형입니다. 이 네 값이 /Decode의 처음 네 항목이 됩니다. 이 사각형 밖의 제어점은 인코딩할 때 잘려 나갑니다. 실제로 그릴 user-space 좌표와 같은 좌표계로 지정하세요. HotPDF의 화면 좌표 Rectangle (X, Y, W, H)에 대응하는 PDF user-space 사각형은 (X, PageHeight - Y - H)에서 (X + W, PageHeight - Y)까지입니다.

NumComponents - 모서리당 색 성분 수입니다. DeviceGray는 1, DeviceRGB는 3, DeviceCMYK는 4를 전달하세요. 다른 값은 예외를 발생시킵니다.

Patches - Extended 값의 평탄한 배열입니다. 패치 하나가 24 + 4 * NumComponents개의 값을 차지합니다. 제어점 12개용 float 24개(X, Y, X, Y, ...로 c1..c12 시계 방향 순서의 12쌍)에 이어 모서리 색용 float 4 * NumComponents개(모서리 1 / 2 / 3 / 4 = 순환 순서로 c1 / c4 / c7 / c10)가 옵니다. 배열 길이는 이 stride의 양의 배수여야 합니다. 출력되는 모든 패치의 플래그는 0(독립 패치)이며, 이전 패치와 변을 공유하는 연속 플래그 1 / 2 / 3은 이 편의 오버로드에서 지원하지 않습니다.

반환 값: 자동 생성된 패턴 이름(Sh1, Sh2, ...)이며, 현재 페이지의 Resources/Pattern 사전에 등록됩니다. StrictVersionLock이 켜져 있고 현재 Version이 PDF 1.3 미만이면 빈 문자열을 반환합니다(그렇지 않으면 문서 버전이 1.3으로 자동 상향됩니다).

Code Example

// Single straight-edge Coons patch covering a 200x200 quad. Inner
// control points placed at 1/3 / 2/3 along each edge => bilinear
// surface. Four corner colours = red / green / yellow / blue
var
  Doc: THotPDF;
  PatName: AnsiString;
  Patches: array[0..35] of Extended;   // 12 ctrl pts * 2 + 4 corners * 3 = 36
  H, XMin, YMin, XMax, YMax, W: Single;
begin
  Doc := THotPDF.Create(nil);
  try
    Doc.Version := pdf14;
    Doc.BeginDoc;
    H := Doc.CurrentPage.Height;
    XMin := 0; YMin := H - 200; XMax := 200; YMax := H;
    W := 200;
    // c1..c12 clockwise. Inner handles at 1/3 / 2/3 => straight edges
    Patches[ 0] := XMin;            Patches[ 1] := YMax;             // c1  TL
    Patches[ 2] := XMin + W / 3;    Patches[ 3] := YMax;             // c2
    Patches[ 4] := XMin + 2*W / 3;  Patches[ 5] := YMax;             // c3
    Patches[ 6] := XMax;            Patches[ 7] := YMax;             // c4  TR
    Patches[ 8] := XMax;            Patches[ 9] := YMax - W / 3;     // c5
    Patches[10] := XMax;            Patches[11] := YMax - 2*W / 3;   // c6
    Patches[12] := XMax;            Patches[13] := YMin;             // c7  BR
    Patches[14] := XMax - W / 3;    Patches[15] := YMin;             // c8
    Patches[16] := XMax - 2*W / 3;  Patches[17] := YMin;             // c9
    Patches[18] := XMin;            Patches[19] := YMin;             // c10 BL
    Patches[20] := XMin;            Patches[21] := YMin + W / 3;     // c11
    Patches[22] := XMin;            Patches[23] := YMin + 2*W / 3;   // c12
    // 4 corner colours (c1 / c4 / c7 / c10)
    Patches[24] := 1.0; Patches[25] := 0.0; Patches[26] := 0.0;  // red
    Patches[27] := 0.0; Patches[28] := 1.0; Patches[29] := 0.0;  // green
    Patches[30] := 1.0; Patches[31] := 1.0; Patches[32] := 0.0;  // yellow
    Patches[33] := 0.0; Patches[34] := 0.0; Patches[35] := 1.0;  // blue
    PatName := Doc.RegisterCoonsPatchMesh(XMin, YMin, XMax, YMax, 3, Patches);
    Doc.CurrentPage.SetFillPattern(PatName);
    Doc.CurrentPage.Rectangle(0, 0, 200, 200);
    Doc.CurrentPage.Fill;
    Doc.EndDoc;
  finally
    Doc.Free;
  end;
end;