Foxit PDF SDK
foxit::common::GraphState类 参考

继承自 Object .

Public 类型

enum  LineCapStyle { e_LineCapButt = 0, e_LineCapRound = 1, e_LineCapSquare = 2 }
 线条端盖样式枚举。 更多...
 
enum  LineJoinStyle { e_LineJoinMiter = 0, e_LineJoinRound = 1, e_LineJoinBevel = 2 }
 线条连接样式枚举。 更多...
 

Public 成员函数

 GraphState (float line_width, LineJoinStyle line_join, float miter_limit, LineCapStyle line_cap, float dash_phase, const FloatArray &dashes)
 带参数的构造函数。 更多...
 
 GraphState ()
 构造函数。
 
 GraphState (const GraphState &state)
 使用另一个图形状态对象的构造函数。 更多...
 
GraphStateoperator= (const GraphState &state)
 赋值操作符。 更多...
 
void Set (float line_width, LineJoinStyle line_join, float miter_limit, LineCapStyle line_cap, float dash_phase, const FloatArray &dashes)
 设置值。 更多...
 

Public 属性

float dash_phase
 虚线模式的虚线相位。
 
FloatArray dashes
 表示虚线模式的虚线数组。此数组中每个元素的值不应为负数。
 
LineCapStyle line_cap
 线端点样式。 更多...
 
LineJoinStyle line_join
 线连接样式 更多...
 
float line_width
 线宽。 更多...
 
float miter_limit
 线连接的斜角限制。 更多...
 

详细描述

此类表示PDF图形状态。

成员枚举类型说明

◆ LineCapStyle

线条端盖样式枚举。

此枚举的值应单独使用。线条端盖样式指定在描边时 开放子路径(以及虚线,如果有的话)末端使用的形状。

枚举值
e_LineCapButt 

平头端盖。描边在路径的端点处被切断。路径末端之外 没有投影。

e_LineCapRound 

圆头端盖。在端点周围绘制一个直径等于线宽的半圆弧 并填充。

e_LineCapSquare 

投影方形端盖。描边在路径端点之外继续延伸等于 线宽一半的距离,并被切断。

◆ LineJoinStyle

线条连接样式枚举。

此枚举的值应单独使用。 线条连接样式指定在描边路径的拐角处使用的形状。

枚举值
e_LineJoinMiter 

斜接线条连接类型。

两段描边的外边缘延伸直到它们以一定角度相交。

e_LineJoinRound 

圆角线条连接类型。

在两段相交的点周围绘制一个直径等于线宽的圆弧, 连接两段描边的外边缘。

e_LineJoinBevel 

斜角线条连接类型。

两段使用平头端盖完成,并且段末端之外的结果凹口 用三角形填充。

构造及析构函数说明

◆ GraphState() [1/2]

foxit::common::GraphState::GraphState ( float  line_width,
LineJoinStyle  line_join,
float  miter_limit,
LineCapStyle  line_cap,
float  dash_phase,
const FloatArray dashes 
)
inline

带参数的构造函数。

参数
[in]line_width线宽。如果设置为0,将默认视为1。
[in]line_join线连接样式。请参考从 GraphState::e_LineJoinMiter 开始的值, 应该是这些值中的一个。
[in]miter_limit线连接的斜角限制。
[in]line_cap线端点样式。请参考从 GraphState::e_LineCapButt 开始的值, 应该是这些值中的一个。
[in]dash_phase线虚线模式的虚线相位。
[in]dashes表示虚线模式的虚线数组。此数组中每个元素的值 不应为负数。

◆ GraphState() [2/2]

foxit::common::GraphState::GraphState ( const GraphState state)
inline

使用另一个图形状态对象的构造函数。

参数
[in]state另一个图形状态对象。

成员函数说明

◆ operator=()

GraphState& foxit::common::GraphState::operator= ( const GraphState state)
inline

赋值操作符。

参数
[in]state另一个图形状态对象,其值将被赋给当前对象。
返回
对当前对象本身的引用。

◆ Set()

void foxit::common::GraphState::Set ( float  line_width,
LineJoinStyle  line_join,
float  miter_limit,
LineCapStyle  line_cap,
float  dash_phase,
const FloatArray dashes 
)
inline

设置值。

参数
[in]line_width线宽。如果设置为0,将默认视为1。
[in]line_join线连接样式。请参考从 GraphState::e_LineJoinMiter 开始的值, 应该是这些值中的一个。
[in]miter_limit线连接的斜角限制。
[in]line_cap线端点样式。请参考从 GraphState::e_LineCapButt 开始的值, 应该是这些值中的一个。
[in]dash_phase线虚线模式的虚线相位。
[in]dashes表示虚线模式的虚线数组。此数组中每个元素的值 不应为负数。
返回
无。

类成员变量说明

◆ line_cap

LineCapStyle foxit::common::GraphState::line_cap

线端点样式。

线端点样式指定在描边开放子路径(和虚线,如果有的话)末端 使用的形状。请参考从 GraphState::e_LineCapButt 开始的值, 应该是这些值中的一个。

◆ line_join

LineJoinStyle foxit::common::GraphState::line_join

线连接样式

线连接样式指定在描边路径的拐角处使用的形状。 请参考从 GraphState::e_LineJoinMiter 开始的值, 应该是这些值中的一个。

◆ line_width

float foxit::common::GraphState::line_width

线宽。

它应该是PDF坐标系中的非负数。 如果设置为0,将默认视为1。

◆ miter_limit

float foxit::common::GraphState::miter_limit

线连接的斜角限制。

当两条线段以尖锐角度相交并指定了斜角连接 作为线连接样式时,斜角可能会延伸到远超过 描边路径的线宽。斜角限制对斜角长度与线宽的比率 设置了最大值。当超过限制时,连接从斜角转换为斜面。
有关更多详细信息,请参考<PDF参考1.7>第217页"Miter Limit"。