foxit::common::ColorSpace类 参考

类 foxit::common::ColorSpace 继承关系图:

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

Public 成员函数
	ColorSpace (foxit::common::ColorSpaceType type)
	带有指定颜色类型的构造函数。 更多...
	ColorSpace (const ColorSpace &other)
	使用另一个颜色空间对象的构造函数。 更多...
	~ColorSpace ()
	析构函数。
Color	ConvertColor (const Color &color)
	将输入颜色转换为当前颜色空间中的颜色。 更多...
Color	ConvertColor (int r_value, int g_value, int b_value)
	将输入的R/G/B组件值转换为当前颜色空间中的颜色。 更多...
Color	ConvertColor (int c_value, int m_value, int y_value, int k_value)
	将输入的C/M/Y/K组件值转换为当前颜色空间中的颜色对象。 更多...
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	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，则表示转换失败。

ConvertColor() [3/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，则表示转换失败。

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 表示不相等。