NewGraphicsState

Gráficos vetoriais, Texto, Layout da página

Descrição

Cria ou reutiliza um ExtGState do PDF que pode combinar transparência de preenchimento, transparência de traço, largura de linha, line cap, line join e miter limit, para aplicação posterior com SetGraphicsState

Sintaxe

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	Porcentagem de transparência de preenchimento, em que 0 é opaco e 100 é invisível, ou -1 para omitir `/ca`
StrokeTransparency	Porcentagem de transparência do traço, em que 0 é opaco e 100 é invisível, ou -1 para omitir `/CA`
LineWidth	Largura de linha nas unidades de medição atuais, 0 para um hairline do PDF, ou -1 para omitir `/LW`
LineCap	Estilo de ponta de linha 0 = butt, 1 = round, 2 = projecting square, ou -1 para omitir `/LC`
LineJoin	Estilo de junção de linha 0 = miter, 1 = round, 2 = bevel, ou -1 para omitir `/LJ`
MiterLimit	Razão de limite de miter maior que 0, ou -1 para omitir `/ML`

Valores retornados

0	Nenhuma propriedade válida de graphics state foi fornecida, um parâmetro estava fora do intervalo, ou transparência não é permitida no modo PDF/A atual
>0	Um ID de graphics state reutilizável para o documento selecionado

Observações

Configurações idênticas reutilizam o mesmo objeto ExtGState em vez de gravar dicionários de recursos duplicados

Entradas de transparência elevam automaticamente a versão efetiva do documento ao PDF 1.4; entradas apenas de estado de linha a elevam ao PDF 1.3

O ID retornado pertence ao documento atual e deve ser passado a SetGraphicsState antes de desenhar conteúdo que deva usar essas configurações

Veja também

NewSoftMaskGraphicsState, SetGraphicsState, FlattenTransparency