NewGraphicsState

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

Descrição

Cria ou reutiliza um ExtGState de PDF que pode combinar definições de transparência de preenchimento, transparência de traço, largura da linha, extremidade da linha, união de linhas e limite de esquadria para posterior aplicação 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	Percentagem de transparência do preenchimento, em que 0 é opaco e 100 é invisível, ou -1 para omitir `/ca`
StrokeTransparency	Percentagem de transparência do traço, em que 0 é opaco e 100 é invisível, ou -1 para omitir `/CA`
LineWidth	Largura da linha nas unidades de medição atuais, 0 para uma linha fina PDF ou -1 para omitir `/LW`
LineCap	Estilo de extremidade de linha 0 = reta, 1 = redonda, 2 = quadrada saliente, ou -1 para omitir `/LC`
LineJoin	Estilo de união de linhas 0 = meia-esquadria, 1 = redonda, 2 = bisel, ou -1 para omitir `/LJ`
MiterLimit	Relação do limite de junção superior a 0, ou -1 para omitir `/ML`

Valores devolvidos

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

Observações

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

As entradas de transparência elevam automaticamente a versão efetiva do documento para PDF 1.4; as entradas apenas de estado da linha elevam-na para PDF 1.3

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

Consulte também

NewSoftMaskGraphicsState, SetGraphicsState, FlattenTransparency