PDFium Delphi Component Docs

CreatePath Método

Componente: TPdf  ·  Unidad: PDFium
Crea un nuevo objeto de ruta 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 ruta: fmNone (sin relleno), fmAlternate (regla par-impar) o fmWinding (regla de devanado no nulo). 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 ruta se dibuja usando StrokeColor, StrokeAlpha y StrokeWidth. El valor predeterminado es True
StrokeColorTColor. Color del contorno de la ruta. 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 PDF (puntos). El valor predeterminado es 1.0
LineCapTPdfLineCap. Estilo aplicado a los extremos abiertos de la ruta: lcDefault, lcButt, lcRound o lcProjectingSquare. El valor predeterminado es lcDefault
LineJoinTPdfLineJoin. Estilo aplicado en las uniones de segmentos de la ruta: ljDefault, ljMiter, ljRound o ljBevel. El valor predeterminado es ljDefault
BlendModeTPdfBlendMode. Modo de fusión de composición para el objeto de ruta. El valor predeterminado es bmDefault, que se 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 extremo 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 fusión de composición. El valor predeterminado es bmDefault

Description

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

Hay dos sobrecargas disponibles. La forma de dos coordenadas CreatePath(X, Y, ...) inicializa una ruta vacía con su punto actual en (X, Y); luego construye la forma libremente usando los métodos de segmento de ruta. La forma de cuatro coordenadas CreatePath(X, Y, Width, Height, ...) crea una ruta rectangular cerrada directamente, sin necesidad de llamadas de segmento adicionales antes de AddPath

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

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

Example

// Dibujar un triángulo azul relleno con un contorno negro de 2 pt
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;

// Dibujar un rectángulo rojo relleno usando la sobrecarga de 4 coordenadas
Pdf1.CreatePath(50, 400, 200, 80, fmWinding, clRed);
Pdf1.AddPath;

See Also

MoveTo, LineTo, BezierTo, ClosePath, AddPath