PDFium Delphi Component Docs

CreatePath método

Componente: TPdf  ·  Unidad: PDFium
Crea un nuevo objeto de trayectoria en una posición inicial

Syntax

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. Regla de relleno para el interior de la trayectoria: fmNone (sin relleno), fmAlternate (regla par-impar) o fmWinding (regla de devanado distinto de cero). El valor predeterminado es fmNone
FillColorTColor. Color de relleno aplicado cuando FillMode no es fmNone. El valor predeterminado es clBlack
FillAlphaByte. Opacidad del relleno, donde $00 es totalmente transparente y $FF es totalmente opaco. El valor predeterminado es $FF
StrokeBoolean. Cuando es True, el contorno de la trayectoria se dibuja usando StrokeColor, StrokeAlpha y StrokeWidth. El valor predeterminado es True
StrokeColorTColor. Color del contorno de la trayectoria. El valor predeterminado es clBlack
StrokeAlphaByte. Opacidad del trazo, donde $00 es totalmente transparente y $FF es totalmente opaco. El valor predeterminado es $FF
StrokeWidthSingle. Ancho de la línea de trazo en unidades de usuario de PDF (puntos). El valor predeterminado es 1.0
LineCapTPdfLineCap. Estilo aplicado a los extremos abiertos de la trayectoria: lcDefault, lcButt, lcRound o lcProjectingSquare. El valor predeterminado es lcDefault
LineJoinTPdfLineJoin. Estilo aplicado en las uniones de segmentos de la trayectoria: ljDefault, ljMiter, ljRound o ljBevel. El valor predeterminado es ljDefault
BlendModeTPdfBlendMode. Modo de mezcla de composición para el objeto de trayectoria. El valor predeterminado es bmDefault, que compone como bmNormal

 

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. Regla de relleno para el interior del rectángulo. El valor predeterminado es fmNone
FillColorTColor. Color de relleno del rectángulo. El valor predeterminado es clBlack
FillAlphaByte. Opacidad del relleno ($00–$FF). El valor predeterminado es $FF
StrokeBoolean. Cuando es True, se dibuja el contorno del rectángulo. El valor predeterminado es True
StrokeColorTColor. Color del contorno del rectángulo. El valor predeterminado es clBlack
StrokeAlphaByte. Opacidad del trazo ($00–$FF). El valor predeterminado es $FF
StrokeWidthSingle. Ancho del trazo del contorno en puntos. El valor predeterminado es 1.0
LineCapTPdfLineCap. Estilo de remate de línea para las esquinas del rectángulo. El valor predeterminado es lcDefault
LineJoinTPdfLineJoin. Estilo de unión de línea para las esquinas del rectángulo. El valor predeterminado es ljDefault
BlendModeTPdfBlendMode. Modo de mezcla de composición. El valor predeterminado es bmDefault

Description

CreatePath inicia la construcción de un nuevo objeto de trayectoria vectorial. Debe llamarse antes de cualquiera de los métodos de construcción de trayectorias (MoveTo, LineTo, BezierTo, ClosePath), y la secuencia debe completarse con una llamada a AddPath para confirmar la trayectoria en la página actual

Hay dos sobrecargas disponibles. La forma de dos coordenadas CreatePath(X, Y, ...) inicializa una trayectoria vacía con su punto actual en (X, Y); después se construye la forma libremente con los métodos de segmentos de trayectoria. La forma de cuatro coordenadas CreatePath(X, Y, Width, Height, ...) crea directamente una trayectoria rectangular cerrada — no se necesitan llamadas de segmentos adicionales antes de AddPath

Todas las propiedades visuales de la trayectoria — color y regla de relleno, color de trazo, ancho, opacidad, remate de línea, unión de línea y modo de mezcla — se establecen en el momento de la creación mediante los parámetros opcionales. Los valores predeterminados producen un contorno con trazo negro de 1 punto y sin relleno

Solo puede haber una trayectoria en construcción a la vez. Llamar a CreatePath de nuevo antes de AddPath descarta la trayectoria pendiente anterior

Example

// 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;

See Also

MoveTo, LineTo, BezierTo, ClosePath, AddPath