Foxit PDF SDK
foxit.common.ColorSpace类 参考
类 foxit.common.ColorSpace 继承关系图:
foxit.common.Base

Public 类型

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

Public 成员函数

 ColorSpace (ColorSpaceType type)
 带有指定颜色类型的构造函数。 更多...
 
 ColorSpace (ColorSpace other)
 使用另一个颜色空间对象的构造函数。 更多...
 
Color ConvertColor (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组件值转换为当前颜色空间中的颜色对象。 更多...
 
ColorSpaceType GetColorSpaceType ()
 获取颜色空间类型。 更多...
 
int GetComponentCount ()
 获取组件的数量。 更多...
 
StringArray GetComponentNames ()
 获取字符串数组,表示分离颜色空间的着色剂名称, 或为DeviceN颜色空间指定单个颜色组件的名称。 更多...
 
bool IsEmpty ()
 检查当前对象是否为空。 更多...
 
bool IsSpotColorSpace ()
 检查当前颜色空间对象是否为专色颜色空间。 更多...
 

详细描述

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

成员枚举类型说明

◆ 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 ( ColorSpaceType  type)
inline

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

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

◆ ColorSpace() [2/2]

foxit.common.ColorSpace.ColorSpace ( ColorSpace  other)
inline

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

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

成员函数说明

◆ ConvertColor() [1/3]

Color foxit.common.ColorSpace.ConvertColor ( Color  color)
inline

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

参数
[in]color输入颜色,将被转换为当前颜色空间。
返回
转换后的颜色。如果返回颜色的函数 Color.IsEmpty 的返回值为 true,则表示转换失败。

◆ ConvertColor() [2/3]

Color foxit.common.ColorSpace.ConvertColor ( int  r_value,
int  g_value,
int  b_value 
)
inline

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

参数
[in]r_valueR组件值。有效范围:从0到255。
[in]g_valueG组件值。有效范围:从0到255。
[in]b_valueB组件值。有效范围:从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 
)
inline

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

参数
[in]c_valueC组件值。有效范围:从0到255。
[in]m_valueM组件值。有效范围:从0到255。
[in]y_valueY组件值。有效范围:从0到255。
[in]k_valueK组件值。有效范围:从0到255。
返回
转换后的颜色。如果返回颜色的函数 Color.IsEmpty 的返回值为 true,则表示转换失败。

◆ GetColorSpaceType()

ColorSpaceType foxit.common.ColorSpace.GetColorSpaceType ( )
inline

获取颜色空间类型。

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

◆ GetComponentCount()

int foxit.common.ColorSpace.GetComponentCount ( )
inline

获取组件的数量。

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

返回
组件数量。

◆ GetComponentNames()

StringArray foxit.common.ColorSpace.GetComponentNames ( )
inline

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

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

返回
名称的字符串数组。
  • 对于分离颜色空间,返回数组的数量只有一个, 字符串指定着色剂的名称。

  • 对于DeviceN颜色空间,返回数组中可以有几个字符串, 它们指定各个颜色组件。

◆ IsEmpty()

bool foxit.common.ColorSpace.IsEmpty ( )
inline

检查当前对象是否为空。

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

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

◆ IsSpotColorSpace()

bool foxit.common.ColorSpace.IsSpotColorSpace ( )
inline

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

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