PDFium Component Docs

CreatePath 메서드

이 API 항목은 식별자, 시그니처, 코드 블록, PDF 용어를 원래 형태로 유지합니다.
컴포넌트: TPdf  ·  유닛: PDFium
초기 위치에 새 path object를 만듭니다

구문

procedure CreatePath(X, Y: Single; FillMode: TPdfFillMode = fmNone; FillColor: TColor = clBlack; FillAlpha: Byte = $FF; Stroke: Boolean = True; StrokeColor: TColor = clBlack; StrokeAlpha: Byte = $FF; StrokeWidth: Single = 1.0; LineCap: TPdfLineCap = lcDefault; LineJoin: TPdfLineJoin = ljDefault; BlendMode: TPdfBlendMode = bmDefault);

FillModeTPdfFillMode. path 내부의 채움 규칙입니다: fmNone(채우지 않음), fmAlternate(even-odd rule), fmWinding(non-zero winding rule). 기본값은 fmNone입니다
FillColorTColor. FillModefmNone이 아닐 때 적용되는 채움 색상입니다. 기본값은 clBlack입니다
FillAlphaByte. 채움의 불투명도입니다. $00은 완전 투명, $FF는 완전 불투명입니다. 기본값은 $FF입니다
StrokeBoolean. True이면 StrokeColor, StrokeAlpha, StrokeWidth를 사용해 path 윤곽선을 그립니다. 기본값은 True입니다
StrokeColorTColor. path 윤곽선의 색상입니다. 기본값은 clBlack입니다
StrokeAlphaByte. stroke의 불투명도입니다. $00은 완전 투명, $FF는 완전 불투명입니다. 기본값은 $FF입니다
StrokeWidthSingle. PDF user unit(point) 기준의 stroke 선 너비입니다. 기본값은 1.0입니다
LineCapTPdfLineCap. 열린 path 끝점에 적용되는 스타일입니다: lcDefault, lcButt, lcRound, lcProjectingSquare. 기본값은 lcDefault입니다
LineJoinTPdfLineJoin. path segment 연결부에 적용되는 스타일입니다: ljDefault, ljMiter, ljRound, ljBevel. 기본값은 ljDefault입니다
BlendModeTPdfBlendMode. path object의 합성 blend mode입니다. 기본값은 bmDefault(normal)입니다

 

procedure CreatePath(X, Y, Width, Height: Single; FillMode: TPdfFillMode = fmNone; FillColor: TColor = clBlack; FillAlpha: Byte = $FF; Stroke: Boolean = True; StrokeColor: TColor = clBlack; StrokeAlpha: Byte = $FF; StrokeWidth: Single = 1.0; LineCap: TPdfLineCap = lcDefault; LineJoin: TPdfLineJoin = ljDefault; BlendMode: TPdfBlendMode = bmDefault);

FillModeTPdfFillMode. rectangle 내부의 채움 규칙입니다. 기본값은 fmNone입니다
FillColorTColor. rectangle의 채움 색상입니다. 기본값은 clBlack입니다
FillAlphaByte. 채움의 불투명도입니다($00–$FF). 기본값은 $FF입니다
StrokeBoolean. True이면 rectangle 윤곽선을 그립니다. 기본값은 True입니다
StrokeColorTColor. rectangle 윤곽선의 색상입니다. 기본값은 clBlack입니다
StrokeAlphaByte. stroke의 불투명도입니다($00–$FF). 기본값은 $FF입니다
StrokeWidthSingle. points 단위의 윤곽선 stroke 너비입니다. 기본값은 1.0입니다
LineCapTPdfLineCap. rectangle 모서리에 적용되는 line cap 스타일입니다. 기본값은 lcDefault입니다
LineJoinTPdfLineJoin. rectangle 모서리에 적용되는 line join 스타일입니다. 기본값은 ljDefault입니다
BlendModeTPdfBlendMode. 합성 blend mode입니다. 기본값은 bmDefault입니다

설명

CreatePath는 새 vector path object의 구성을 시작합니다. MoveTo, LineTo, BezierTo, ClosePath 같은 path 구성 메서드보다 먼저 호출해야 하며, AddPath를 호출해야 현재 page에 path를 커밋할 수 있습니다

두 가지 overload가 있습니다. 두 좌표 형식 CreatePath(X, Y, ...)은 현재 point가 (X, Y)인 빈 path를 초기화하며, 그 뒤에는 path segment 메서드로 자유롭게 모양을 만듭니다. 네 좌표 형식 CreatePath(X, Y, Width, Height, ...)은 닫힌 rectangle path를 직접 만들며, AddPath 전에 추가 segment 호출이 필요하지 않습니다

path의 모든 시각적 속성 - fill 색상과 규칙, stroke 색상, 너비, 불투명도, line cap, line join, blend mode - 는 optional parameter로 생성 시 설정합니다. 기본값은 채우지 않고 1-point black stroke 윤곽선을 만듭니다

한 번에 구성 중일 수 있는 path는 하나뿐입니다. AddPath 전에 CreatePath를 다시 호출하면 이전에 대기 중이던 path는 버려집니다

예제

// Draw a filled blue triangle with a 2-pt black outline
Pdf1.NewPage(595, 842);
Pdf1.CreatePath(100, 100, fmWinding, clBlue, $FF, True, clBlack, $FF, 2.0);
Pdf1.LineTo(200, 300);
Pdf1.LineTo(300, 100);
Pdf1.ClosePath;
Pdf1.AddPath;

// Draw a red filled rectangle using the 4-coordinate overload
Pdf1.CreatePath(50, 400, 200, 80, fmWinding, clRed);
Pdf1.AddPath;

참고 항목

MoveTo, LineTo, BezierTo, ClosePath, AddPath