NewGraphicsState

Gráficos vectoriales, texto, diseño de página

Descripción

Crea o reutiliza un ExtGState PDF que puede combinar opciones de transparencia de relleno, transparencia de trazo, anchura de línea, terminación de línea, unión de líneas y límite de inglete para aplicarlas posteriormente con SetGraphicsState

Sintaxis

Delphi

Function TPDFlib.NewGraphicsState(FillTransparency, StrokeTransparency: Integer; LineWidth: Double; LineCap, LineJoin: Integer; MiterLimit: Double): Integer;

ActiveX

Function PDFlib::NewGraphicsState(FillTransparency As Long, StrokeTransparency As Long, LineWidth As Double, LineCap As Long, LineJoin As Long, MiterLimit As Double) As Long

DLL

int DLNewGraphicsState(int InstanceID, int FillTransparency, int StrokeTransparency, double LineWidth, int LineCap, int LineJoin, double MiterLimit);

Parámetros

FillTransparency	Porcentaje de transparencia de relleno, donde 0 es opaco y 100 invisible, o -1 para omitir `/ca`
StrokeTransparency	Porcentaje de transparencia del trazo, donde 0 es opaco y 100 invisible, o -1 para omitir `/CA`
LineWidth	Anchura de línea en las unidades de medida actuales, 0 para una línea ultrafina de PDF o -1 para omitir `/LW`
LineCap	Estilo de extremo de línea: 0 = plano, 1 = redondo, 2 = cuadrado saliente, o -1 para omitir `/LC`
LineJoin	Estilo de unión de líneas: 0 = inglete, 1 = redonda, 2 = bisel, o -1 para omitir `/LJ`
MiterLimit	Relación del límite de inglete mayor que 0, o -1 para omitir `/ML`

Valores devueltos

0	No se facilitó ninguna propiedad válida de estado gráfico, un parámetro estaba fuera del intervalo o no se permite la transparencia en el modo PDF/A actual
>0	Un identificador de estado gráfico reutilizable para el documento seleccionado

Observaciones

Los ajustes idénticos reutilizan el mismo objeto ExtGState en lugar de escribir diccionarios de recursos duplicados

Las entradas de transparencia elevan automáticamente la versión efectiva del documento a PDF 1.4; las entradas que solo contienen estado de línea la elevan a PDF 1.3

El ID devuelto pertenece al documento actual y debe pasarse a SetGraphicsState antes de dibujar contenido que deba utilizar esa configuración

Véase también

NewSoftMaskGraphicsState, SetGraphicsState, FlattenTransparency