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 = butt, 1 = round, 2 = projecting square, или -1, чтобы опустить /LC |
| LineJoin | Стиль соединения линий 0 = miter, 1 = round, 2 = bevel, или -1, чтобы опустить /LJ |
| MiterLimit | Отношение предела miter больше 0, или -1, чтобы опустить /ML |
Возвращаемые значения
| 0 | Не передано допустимого свойства графического состояния, параметр вне диапазона либо прозрачность запрещена в текущем режиме PDF/A |
|---|---|
| >0 | Многоразовый ID графического состояния для выбранного документа |
Примечания
Одинаковые настройки переиспользуют один объект ExtGState вместо записи дублирующихся словарей ресурсов
Записи прозрачности автоматически поднимают эффективную версию документа до PDF 1.4; записи только состояния линий поднимают ее до PDF 1.3
Transparency entries automatically raise the effective document version to PDF 1.4; line-state-only entries raise it to PDF 1.3
The returned ID belongs to the current document and should be passed to SetGraphicsState before drawing content that should use those settings
См. также
NewSoftMaskGraphicsState, SetGraphicsState, FlattenTransparency