NewGraphicsState

向量圖形、文字、頁面版面

描述

建立或重用一個 PDF ExtGState，可組合填色透明度、筆劃透明度、線寬、端點樣式、接合樣式與斜接限制設定，之後用 SetGraphicsState 套用

語法

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

參數

FillTransparency填色不透明度百分比，0 為不透明、100 為完全透明；-1 表示省略 /ca
StrokeTransparency筆劃不透明度百分比，0 為不透明、100 為完全透明；-1 表示省略 /CA
LineWidth線寬，以目前量測單位計；0 表示 PDF 髮絲線，-1 表示省略 /LW
LineCap線條端點樣式 0 = 平頭，1 = 圓頭，2 = 凸方頭；-1 表示省略 /LC
LineJoin線條接合樣式 0 = 尖角，1 = 圓角，2 = 斜切；-1 表示省略 /LJ
MiterLimit斜接限制比例，大於 0；-1 表示省略 /ML

傳回值

0未提供有效的圖形狀態屬性、某個參數超出範圍，或目前 PDF/A 模式不允許透明效果
>0所選文件可重複使用的圖形狀態 ID

備註

相同的設定重用同一個 ExtGState 物件，不寫出重複的資源字典

透明度項目會自動把文件有效版本提升到 PDF 1.4；僅線段狀態的項目提升到 PDF 1.3

傳回的 ID 屬於目前文件，繪製要使用這些設定的內容前應傳給 SetGraphicsState

另請參閱

NewSoftMaskGraphicsState, SetGraphicsState, FlattenTransparency

範例