Foxit PDF SDK

Public 类型 | Public 成员函数 | 所有成员列表
foxit::common::ColorSpace类 参考
类 foxit::common::ColorSpace 继承关系图:

## Public 类型
enum | RenderingIntent { e_RenderIntentPerceptual = 0, e_RenderIntentRelColorimetric = 1, e_RenderIntentSaturation = 2, e_RenderIntentAbsColorimetric = 3 }
| 渲染意图枚举。 更多...

## Public 成员函数
| ColorSpace (const ColorSpace &other)
| 使用另一个颜色空间对象的构造函数。 更多...
| ColorSpace (foxit::common::ColorSpaceType type)
| 带有指定颜色类型的构造函数。 更多...
| ~ColorSpace ()
| 析构函数。
Color | ConvertColor (const Color &color)
| 将输入颜色转换为当前颜色空间中的颜色。 更多...
Color | ConvertColor (int c_value, int m_value, int y_value, int k_value)
| 将输入的C/M/Y/K组件值转换为当前颜色空间中的颜色对象。 更多...
Color | ConvertColor (int r_value, int g_value, int b_value)
| 将输入的R/G/B组件值转换为当前颜色空间中的颜色。 更多...
foxit::common::ColorSpaceType | GetColorSpaceType () const
| 获取颜色空间类型。 更多...
int | GetComponentCount () const
| 获取组件的数量。 更多...
StringArray | GetComponentNames () const
| 获取字符串数组，表示分离颜色空间的着色剂名称， 或为DeviceN颜色空间指定单个颜色组件的名称。 更多...
bool | IsEmpty () const
| 检查当前对象是否为空。 更多...
bool | IsSpotColorSpace () const
| 检查当前颜色空间对象是否为专色颜色空间。 更多...
bool | operator!= (const ColorSpace &other) const
| 不相等操作符。 更多...
ColorSpace & | operator= (const ColorSpace &other)
| 赋值操作符。 更多...
bool | operator== (const ColorSpace &other) const
| 相等操作符。 更多...
Public 成员函数 继承自 foxit::Base
FS_HANDLE | Handle () const
| 获取当前对象的句柄。 更多...

## 详细描述

此类表示颜色空间。用户可以使用此类来转换颜色。

## 成员枚举类型说明

## ◆ RenderingIntent

enum foxit::common::ColorSpace::RenderingIntent

渲染意图枚举。

此枚举的值应单独使用。
渲染意图可用于颜色转换。有关更多详细信息，请参考 PDF 2.0参考文档中的第8.6.5.8节"Rendering intents"。

枚举值
e_RenderIntentPerceptual | 渲染意图：感知的。
e_RenderIntentRelColorimetric | 渲染意图：相对色度的。
e_RenderIntentSaturation | 渲染意图：饱和度。
e_RenderIntentAbsColorimetric | 渲染意图：绝对色度的。

## 构造及析构函数说明

## ◆ ColorSpace() [1/2]

foxit::common::ColorSpace::ColorSpace | ( | foxit::common::ColorSpaceType | type | ) |

带有指定颜色类型的构造函数。

参数

  [in] | type | 颜色空间类型。目前，此值只能是以下值之一： common::e_ColorSpaceDeviceGray，common::e_ColorSpaceDeviceRGB， common::e_ColorSpaceDeviceCMYK。 对于其他不支持的颜色空间类型，将抛出异常 foxit::e_ErrUnsupported。

## ◆ ColorSpace() [2/2]

foxit::common::ColorSpace::ColorSpace | ( | const ColorSpace & | other | ) |

使用另一个颜色空间对象的构造函数。

参数

  [in] | other | 另一个颜色空间对象。

## 成员函数说明

## ◆ ConvertColor() [1/3]

Color foxit::common::ColorSpace::ConvertColor | ( | const Color & | color | ) |

将输入颜色转换为当前颜色空间中的颜色。

参数

  [in] | color | 输入颜色，将被转换为当前颜色空间。

返回
  转换后的颜色。如果返回颜色的函数 Color::IsEmpty 的返回值为 true，则表示转换失败。

## ◆ ConvertColor() [2/3]

Color foxit::common::ColorSpace::ConvertColor | ( | int | c_value,
|  | int | m_value,
|  | int | y_value,
|  | int | k_value
| ) |  |

将输入的C/M/Y/K组件值转换为当前颜色空间中的颜色对象。

参数

  [in] | c_value | C组件值。有效范围：从0到255。
  [in] | m_value | M组件值。有效范围：从0到255。
  [in] | y_value | Y组件值。有效范围：从0到255。
  [in] | k_value | K组件值。有效范围：从0到255。

返回
  转换后的颜色。如果返回颜色的函数 Color::IsEmpty 的返回值为 true，则表示转换失败。

## ◆ ConvertColor() [3/3]

Color foxit::common::ColorSpace::ConvertColor | ( | int | r_value,
|  | int | g_value,
|  | int | b_value
| ) |  |

将输入的R/G/B组件值转换为当前颜色空间中的颜色。

参数

  [in] | r_value | R组件值。有效范围：从0到255。
  [in] | g_value | G组件值。有效范围：从0到255。
  [in] | b_value | B组件值。有效范围：从0到255。

返回
  转换后的颜色。如果返回颜色的函数 Color::IsEmpty 的返回值为 true，则表示转换失败。

## ◆ GetColorSpaceType()

foxit::common::ColorSpaceType foxit::common::ColorSpace::GetColorSpaceType | ( |  | ) | const

获取颜色空间类型。

返回
  颜色空间类型。请参考从 common::e_ColorSpaceInvalid 开始的值， 这将是这些值中的一个。

## ◆ GetComponentCount()

int foxit::common::ColorSpace::GetComponentCount | ( |  | ) | const

获取组件的数量。

对于不同的颜色空间类型，组件的数量不相同。

返回
  组件数量。

## ◆ GetComponentNames()

StringArray foxit::common::ColorSpace::GetComponentNames | ( |  | ) | const

获取字符串数组，表示分离颜色空间的着色剂名称， 或为DeviceN颜色空间指定单个颜色组件的名称。

此函数仅在当前颜色空间类型为 common::e_ColorSpaceSeparation 或 common::e_ColorSpaceDeviceN 时可用。 对于其他颜色空间类型，此函数将返回空字符串数组。

返回
  名称的字符串数组。
  - 对于分离颜色空间，返回数组的数量只有一个， 字符串指定着色剂的名称。
  - 对于DeviceN颜色空间，返回数组中可以有几个字符串， 它们指定各个颜色组件。

## ◆ IsEmpty()

bool foxit::common::ColorSpace::IsEmpty | ( |  | ) | const

检查当前对象是否为空。

当当前对象为空时，意味着当前对象无用。

返回
  true 表示当前对象为空，false 表示不为空。

## ◆ IsSpotColorSpace()

bool foxit::common::ColorSpace::IsSpotColorSpace | ( |  | ) | const

检查当前颜色空间对象是否为专色颜色空间。

返回
  true 表示当前对象是专色颜色空间，false 表示不是。

## ◆ operator!=()

bool foxit::common::ColorSpace::operator!= | ( | const ColorSpace & | other | ) | const

不相等操作符。

参数

  [in] | other | 另一个颜色空间对象。此函数将检查当前对象是否不 等于此对象。

返回
  true 表示不相等，false 表示相等。

## ◆ operator=()

ColorSpace& foxit::common::ColorSpace::operator= | ( | const ColorSpace & | other | ) |

赋值操作符。

参数

  [in] | other | 另一个颜色空间对象，其值将被赋给当前对象。

返回
  对当前对象本身的引用。

## ◆ operator==()

bool foxit::common::ColorSpace::operator== | ( | const ColorSpace & | other | ) | const

相等操作符。

参数

  [in] | other | 另一个颜色空间对象。此函数将检查当前对象是否 等于此对象。

返回
  true 表示相等，false 表示不相等。