Foxit PDF SDK

Public 类型 | Public 成员函数 | Public 属性 | 所有成员列表
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 ()
| 构造函数。
| GraphState (const GraphState &state)
| 使用另一个图形状态对象的构造函数。 更多...
| GraphState (float line_width, LineJoinStyle line_join, float miter_limit, LineCapStyle line_cap, float dash_phase, const FloatArray &dashes)
| 带参数的构造函数。 更多...
GraphState & | operator= (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

enum foxit::common::GraphState::LineCapStyle

线条端盖样式枚举。

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

枚举值
e_LineCapButt | 平头端盖。描边在路径的端点处被切断。路径末端之外 没有投影。
e_LineCapRound | 圆头端盖。在端点周围绘制一个直径等于线宽的半圆弧 并填充。
e_LineCapSquare | 投影方形端盖。描边在路径端点之外继续延伸等于 线宽一半的距离，并被切断。

## ◆ LineJoinStyle

enum foxit::common::GraphState::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"。