ImageCms 模块

这个 ImageCms 模块使用基于Kevin Cazabon的PycMS库的LittleCMS2颜色管理引擎提供颜色配置文件管理支持。

class PIL.ImageCms.ImageCmsTransform(input, output, input_mode, output_mode, intent=0, proof=None, proof_intent=3, flags=0)[源代码]

变换。这可以与过程API一起使用,也可以与标准image.point()方法一起使用。

将在output.info['icc_profile']中返回输出配置文件。

exception PIL.ImageCms.PyCMSError[源代码]

(Pycms)异常类。这用于PycMS API中的所有错误。

PIL.ImageCms.applyTransform(im, transform, inPlace=False)[源代码]

(Pycms)对给定图像应用转换。

如果IM.模式!=transform.inmode,引发PycmserRor。

如果inplace为true且transform.inmode!=transform.outmode,引发PycmserRor。

如果pyCMSdll或用于转换的配置文件不支持im.mode、transform.inMode或transform.outMode,则会引发PyCMSError。

如果在应用转换时发生错误,将引发PycmserRor。

此函数将预先计算的转换(从imagecms.buildTransform()或imagecms.buildTransformFromOpenProfiles())应用于图像。转换可用于多个图像,如果多次进行相同的转换,则可节省大量的计算时间。

如果要在适当的位置修改im而不是接收新图像作为返回值,请将in place设置为true。这只能在transform.in mode和transform.outmode相同的情况下完成,因为我们无法在适当的位置更改模式(某些模式的缓冲区大小不同)。默认行为是在模式transform.outmode中返回相同维度的新图像对象。

参数
  • im -- pil图像对象和im.mode必须与转换支持的inmode相同。

  • transform -- 有效的CmsTransform类对象

  • inPlace -- 胸部。如果为真,则就地修改im,不返回任何值;如果为假,则返回已应用转换的新图像对象(im未更改)。默认值为假。

返回

或者是无,或者是新的pil图像对象,这取决于inplace的值。配置文件将返回到图像的信息['icc_profile']。

引发

PyCMSError --

PIL.ImageCms.buildProofTransform(inputProfile, outputProfile, proofProfile, inMode, outMode, renderingIntent=0, proofRenderingIntent=3, flags=16384)[源代码]

(Pycms)构建从输入配置文件到输出配置文件的ICC转换映射,但尝试模拟将在Proofprofile设备上获得的结果。

如果指定的输入、输出或证明配置文件不是有效的文件名,则将引发Pycmserror。

如果在创建转换期间发生错误,将引发Pycmserror。

如果inmode或outmode不是outputprofile(或pycms)支持的模式,则将引发pycmserror。

此函数构建并返回从输入配置文件到输出配置文件的ICC转换,但尝试使用renderingintent和proofrenderingintent模拟Proofprofile设备上获得的结果,以确定如何处理超出范围的颜色。这就是所谓的“软打样”。它仅适用于将处于输入模式的图像转换为处于输出模式颜色格式的图像(PIL模式,即“RGB”、“RGBA”、“CMYK”等)。

结果转换对象的用法与imagecms.buildTransform()的用法完全相同。

当使用输出设备以更好地了解打印/显示的最终图像在Proofprofile设备上的外观时,通常使用校对配置文件,当使用输出设备判断颜色更快更容易时。一般来说,这意味着输出设备是显示器或染色子打印机(等),而模拟设备则更昂贵、更复杂或更耗时(这使得为了判断颜色而进行真正的打印变得困难)。

软打样的基本功能是通过调整输出设备上的颜色来匹配被模拟设备的颜色。但是,当模拟设备的范围比输出设备宽得多时,您可能会获得边际结果。

参数
  • inputProfile -- 字符串,作为要用于此转换的ICC输入配置文件或配置文件对象的有效文件名路径

  • outputProfile -- 字符串,作为要用于此转换的ICC输出(通常是监视器)配置文件或配置文件对象的有效文件名路径

  • proofProfile -- 字符串,作为要用于此转换的ICC证明配置文件或配置文件对象的有效文件名路径

  • inMode -- 字符串,作为相应配置文件也支持的有效PIL模式(即“rgb”、“rgb a”、“cmyk”等)。

  • outMode -- 字符串,作为相应配置文件也支持的有效PIL模式(即“rgb”、“rgb a”、“cmyk”等)。

  • renderingIntent -- 整数(0-3),指定要用于输入的渲染意图->证明(模拟)转换图像cms.intent _perceptual=0(默认值)图像cms.intent _relative _coloromic=1图像cms.intent _saturation=2图像cms.intent _absolute _coloromic=3有关render的详细信息,请参阅pycms文档。戒指的用意和作用。

  • proofRenderingIntent -- 整数(0-3),指定要用于证明的渲染意图->输出转换图像cms.intent _perceptual=0(默认)图像cms.intent _relative _coloromic=1图像cms.intent _saturation=2图像cms.intent _absolute _coloromic=3有关渲染意图和他们做什么。

  • flags -- 整数(0-…)指定附加标志

返回

CMStransForm类对象。

引发

PyCMSError --

PIL.ImageCms.buildProofTransformFromOpenProfiles(inputProfile, outputProfile, proofProfile, inMode, outMode, renderingIntent=0, proofRenderingIntent=3, flags=16384)

(Pycms)构建从输入配置文件到输出配置文件的ICC转换映射,但尝试模拟将在Proofprofile设备上获得的结果。

如果指定的输入、输出或证明配置文件不是有效的文件名,则将引发Pycmserror。

如果在创建转换期间发生错误,将引发Pycmserror。

如果inmode或outmode不是outputprofile(或pycms)支持的模式,则将引发pycmserror。

此函数构建并返回从输入配置文件到输出配置文件的ICC转换,但尝试使用renderingintent和proofrenderingintent模拟Proofprofile设备上获得的结果,以确定如何处理超出范围的颜色。这就是所谓的“软打样”。它仅适用于将处于输入模式的图像转换为处于输出模式颜色格式的图像(PIL模式,即“RGB”、“RGBA”、“CMYK”等)。

结果转换对象的用法与imagecms.buildTransform()的用法完全相同。

当使用输出设备以更好地了解打印/显示的最终图像在Proofprofile设备上的外观时,通常使用校对配置文件,当使用输出设备判断颜色更快更容易时。一般来说,这意味着输出设备是显示器或染色子打印机(等),而模拟设备则更昂贵、更复杂或更耗时(这使得为了判断颜色而进行真正的打印变得困难)。

软打样的基本功能是通过调整输出设备上的颜色来匹配被模拟设备的颜色。但是,当模拟设备的范围比输出设备宽得多时,您可能会获得边际结果。

参数
  • inputProfile -- 字符串,作为要用于此转换的ICC输入配置文件或配置文件对象的有效文件名路径

  • outputProfile -- 字符串,作为要用于此转换的ICC输出(通常是监视器)配置文件或配置文件对象的有效文件名路径

  • proofProfile -- 字符串,作为要用于此转换的ICC证明配置文件或配置文件对象的有效文件名路径

  • inMode -- 字符串,作为相应配置文件也支持的有效PIL模式(即“rgb”、“rgb a”、“cmyk”等)。

  • outMode -- 字符串,作为相应配置文件也支持的有效PIL模式(即“rgb”、“rgb a”、“cmyk”等)。

  • renderingIntent -- 整数(0-3),指定要用于输入的渲染意图->证明(模拟)转换图像cms.intent _perceptual=0(默认值)图像cms.intent _relative _coloromic=1图像cms.intent _saturation=2图像cms.intent _absolute _coloromic=3有关render的详细信息,请参阅pycms文档。戒指的用意和作用。

  • proofRenderingIntent -- 整数(0-3),指定要用于证明的渲染意图->输出转换图像cms.intent _perceptual=0(默认)图像cms.intent _relative _coloromic=1图像cms.intent _saturation=2图像cms.intent _absolute _coloromic=3有关渲染意图和他们做什么。

  • flags -- 整数(0-…)指定附加标志

返回

CMStransForm类对象。

引发

PyCMSError --

PIL.ImageCms.buildTransform(inputProfile, outputProfile, inMode, outMode, renderingIntent=0, flags=0)[源代码]

(Pycms)构建从输入配置文件到输出配置文件的ICC转换映射。使用ApplyTransform将转换应用于给定图像。

如果指定的输入或输出配置文件不是有效的文件名,则将引发Pycmserror。如果在创建转换期间发生错误,将引发Pycmserror。

如果inmode或outmode不是outputprofile(或pycms)支持的模式,则将引发pycmserror。

此函数使用renderingintent构建并返回从inputprofile到outputprofile的ICC转换,以确定如何处理超出范围的颜色。它仅适用于将处于输入模式的图像转换为处于输出模式颜色格式的图像(PIL模式,即“RGB”、“RGBA”、“CMYK”等)。

在imagecms.profileToProfile()中构建转换是开销的一部分,因此如果您计划使用相同的输入/输出设置转换多个图像,这可以节省您的时间。一旦您有了转换对象,它就可以与imagecms.applyprofile()一起使用来转换图像,而无需重新计算转换的查找表。

pycms返回一个类对象而不是直接向转换返回一个句柄的原因是它需要跟踪转换的PIL输入/输出模式。这些属性存储在对象的“inmode”和“outmode”属性中(如果您真的想,可以手动覆盖这些属性,但我不知道任何时间会被使用,甚至可以工作)。

参数
  • inputProfile -- 字符串,作为要用于此转换的ICC输入配置文件或配置文件对象的有效文件名路径

  • outputProfile -- 字符串,作为要用于此转换的ICC输出配置文件或配置文件对象的有效文件名路径

  • inMode -- 字符串,作为相应配置文件也支持的有效PIL模式(即“rgb”、“rgb a”、“cmyk”等)。

  • outMode -- 字符串,作为相应配置文件也支持的有效PIL模式(即“rgb”、“rgb a”、“cmyk”等)。

  • renderingIntent -- 整数(0-3),指定要用于变换图像的渲染意图cms.intent_perceptual=0(默认值)imagecms.intent_relative_coloromic=1 imagecms.intent_saturation=2 imagecms.intent_absolute_coloromic=3请参见pycms文档,了解渲染意图的详细信息以及是的。

  • flags -- 整数(0-…)指定附加标志

返回

CMStransForm类对象。

引发

PyCMSError --

PIL.ImageCms.buildTransformFromOpenProfiles(inputProfile, outputProfile, inMode, outMode, renderingIntent=0, flags=0)

(Pycms)构建从输入配置文件到输出配置文件的ICC转换映射。使用ApplyTransform将转换应用于给定图像。

如果指定的输入或输出配置文件不是有效的文件名,则将引发Pycmserror。如果在创建转换期间发生错误,将引发Pycmserror。

如果inmode或outmode不是outputprofile(或pycms)支持的模式,则将引发pycmserror。

此函数使用renderingintent构建并返回从inputprofile到outputprofile的ICC转换,以确定如何处理超出范围的颜色。它仅适用于将处于输入模式的图像转换为处于输出模式颜色格式的图像(PIL模式,即“RGB”、“RGBA”、“CMYK”等)。

在imagecms.profileToProfile()中构建转换是开销的一部分,因此如果您计划使用相同的输入/输出设置转换多个图像,这可以节省您的时间。一旦您有了转换对象,它就可以与imagecms.applyprofile()一起使用来转换图像,而无需重新计算转换的查找表。

pycms返回一个类对象而不是直接向转换返回一个句柄的原因是它需要跟踪转换的PIL输入/输出模式。这些属性存储在对象的“inmode”和“outmode”属性中(如果您真的想,可以手动覆盖这些属性,但我不知道任何时间会被使用,甚至可以工作)。

参数
  • inputProfile -- 字符串,作为要用于此转换的ICC输入配置文件或配置文件对象的有效文件名路径

  • outputProfile -- 字符串,作为要用于此转换的ICC输出配置文件或配置文件对象的有效文件名路径

  • inMode -- 字符串,作为相应配置文件也支持的有效PIL模式(即“rgb”、“rgb a”、“cmyk”等)。

  • outMode -- 字符串,作为相应配置文件也支持的有效PIL模式(即“rgb”、“rgb a”、“cmyk”等)。

  • renderingIntent -- 整数(0-3),指定要用于变换图像的渲染意图cms.intent_perceptual=0(默认值)imagecms.intent_relative_coloromic=1 imagecms.intent_saturation=2 imagecms.intent_absolute_coloromic=3请参见pycms文档,了解渲染意图的详细信息以及是的。

  • flags -- 整数(0-…)指定附加标志

返回

CMStransForm类对象。

引发

PyCMSError --

PIL.ImageCms.createProfile(colorSpace, colorTemp=-1)[源代码]

(Pycms)创建配置文件。

如果colorspace不在[“lab”、“xyz”、“srgb”]中,则会引发pycmserror

如果使用lab和colortemp!=正整数,引发PycmsError。

如果在创建配置文件时发生错误,将引发Pycmserror。

使用此函数可以动态创建通用配置文件,而不必在磁盘上提供配置文件并知道其路径。它返回一个普通的cmsprofile对象,可以将该对象传递给imagecms.buildTransformFromOpenProfiles(),以创建一个应用于图像的转换。

参数
  • colorSpace -- 字符串,要创建的配置文件的颜色空间。目前只支持“lab”、“xyz”和“srgb”。

  • colorTemp -- 轮廓白点的正整数,以开氏度为单位(即5000、6500、9600等)。如果省略,则默认为d50光源(5000k)。colortemp仅应用于实验室配置文件,XYZ和SRGB将忽略它。

返回

cmsprofile类对象

引发

PyCMSError --

PIL.ImageCms.getDefaultIntent(profile)[源代码]

(pycms)获取给定配置文件的默认意图名称。

如果配置文件不是配置文件的有效cmsprofile对象或文件名,则会引发pycmserror。

如果在尝试获取默认意图时发生错误,将引发Pycmserror。

使用此函数可以确定此配置文件的默认(通常是最佳优化的)渲染意图。大多数配置文件支持多种渲染意图,但主要用于一种类型的转换。如果希望使用与返回的不同的意图,请使用ImageCMS.IsIntentsupported()验证它是否首先工作。

参数

profile -- 有效的cmsprofile对象或ICC配置文件的文件名字符串。

返回

整数0-3,指定此配置文件的默认呈现意图。imagecms.intent_perceptual=0(默认值)imagecms.intent_relative_coloromic=1 imagecms.intent_saturation=2 imagecms.intent_absolute_coloromic=3请参阅pycms文档,了解渲染意图及其操作的详细信息。

引发

PyCMSError --

PIL.ImageCms.getOpenProfile(profileFilename)[源代码]

(Pycms)打开ICC配置文件。

pycmsprofile对象可以传递回pycms以用于创建转换,例如在imagecms.buildTransformFromOpenProfiles()中。

如果profileFileName不是ICC配置文件的有效文件名,则将引发pycmserror。

参数

profileFilename -- 字符串,作为要打开的ICC配置文件或类似文件的对象的有效文件名路径。

返回

CMSProfile类对象。

引发

PyCMSError --

PIL.ImageCms.getProfileCopyright(profile)[源代码]

(pycms)获取给定配置文件的版权。

如果配置文件不是配置文件的有效cmsprofile对象或文件名,则会引发pycmserror。

如果在尝试获取版权标记时发生错误,将引发Pycmserror

使用此函数可以获取存储在配置文件的版权标记中的信息。

参数

profile -- 有效的cmsprofile对象或ICC配置文件的文件名字符串。

返回

包含存储在ICC标记中的内部配置文件信息的字符串。

引发

PyCMSError --

PIL.ImageCms.getProfileDescription(profile)[源代码]

(pycms)获取给定配置文件的描述。

如果配置文件不是配置文件的有效cmsprofile对象或文件名,则会引发pycmserror。

如果在尝试获取描述标记时发生错误,将引发PycmserRor

使用此函数可获取存储在配置文件描述标记中的信息。

参数

profile -- 有效的cmsprofile对象或ICC配置文件的文件名字符串。

返回

包含存储在ICC标记中的内部配置文件信息的字符串。

引发

PyCMSError --

PIL.ImageCms.getProfileInfo(profile)[源代码]

(Pycms)获取给定配置文件的内部产品信息。

如果配置文件不是配置文件的有效cmsprofile对象或文件名,则会引发pycmserror。

如果在尝试获取INFO标记时发生错误,将引发Pycmserror

使用此函数可获取存储在配置文件信息标记中的信息。这通常包含有关概要文件以及如何创建概要文件的详细信息,如创建者提供的那样。

参数

profile -- 有效的cmsprofile对象或ICC配置文件的文件名字符串。

返回

包含存储在ICC标记中的内部配置文件信息的字符串。

引发

PyCMSError --

PIL.ImageCms.getProfileManufacturer(profile)[源代码]

(Pycms)获取给定配置文件的制造商。

如果配置文件不是配置文件的有效cmsprofile对象或文件名,则会引发pycmserror。

如果在尝试获取manufacturer标记时发生错误,将引发Pycmserror

使用此功能可获取存储在配置文件的制造商标签中的信息。

参数

profile -- 有效的cmsprofile对象或ICC配置文件的文件名字符串。

返回

包含存储在ICC标记中的内部配置文件信息的字符串。

引发

PyCMSError --

PIL.ImageCms.getProfileModel(profile)[源代码]

(pycms)获取给定配置文件的模型。

如果配置文件不是配置文件的有效cmsprofile对象或文件名,则会引发pycmserror。

如果在尝试获取模型标记时发生错误,将引发Pycmserror

使用此函数可以获取存储在配置文件的模型标记中的信息。

参数

profile -- 有效的cmsprofile对象或ICC配置文件的文件名字符串。

返回

包含存储在ICC标记中的内部配置文件信息的字符串。

引发

PyCMSError --

PIL.ImageCms.getProfileName(profile)[源代码]

(pycms)获取给定配置文件的内部产品名称。

如果配置文件不是配置文件的有效cmsprofile对象或文件名,则如果在尝试获取名称标记时发生错误,则会引发pycmserror。

使用此函数获取配置文件的内部名称(存储在配置文件本身的ICC标记中),通常是最初创建配置文件时使用的名称。有时此标记还包含创建者提供的其他信息。

参数

profile -- 有效的cmsprofile对象或ICC配置文件的文件名字符串。

返回

包含存储在ICC标记中的配置文件内部名称的字符串。

引发

PyCMSError --

PIL.ImageCms.get_display_profile(handle=None)[源代码]

(实验)获取当前显示设备的配置文件。:如果配置文件未知,则返回:无。

PIL.ImageCms.isIntentSupported(profile, intent, direction)[源代码]

(Pycms)检查是否支持给定的意图。

使用此功能验证您是否可以将所需的渲染意图与配置文件一起使用,以及该配置文件是否可以根据需要用于输入/输出/证明配置文件。

有些配置文件是专门为一个“方向”创建的,不能用于其他方向。某些配置文件只能用于某些渲染意图…因此,最好在尝试使用它们(使用此函数)创建转换之前验证这一点,或者捕获如果它们不支持您选择的模式将发生的潜在pycmserror。

参数
  • profile -- 有效的cmsprofile对象或ICC配置文件的文件名字符串。

  • intent -- 整数(0-3),指定要与此配置文件一起使用的渲染意图imagecms.intent_perceptual=0(默认值)imagecms.intent_relative_coloromic=1 imagecms.intent_saturation=2 imagecms.intent_absolute_coloromic=3有关渲染意图和内容的详细信息,请参阅pycms文档。是的。

  • direction -- 整数,指定配置文件是否用于输入、输出或证明输入=0(或使用imagecms.direction_input)输出=1(或使用imagecms.direction_output)证明=2(或使用imagecms.direction_proof)

返回

如果支持意向/方向,则为1;如果不支持,则为-1。

引发

PyCMSError --

PIL.ImageCms.profileToProfile(im, inputProfile, outputProfile, renderingIntent=0, outputMode=None, inPlace=False, flags=0)[源代码]

(Pycms)将ICC转换应用于给定图像,从输入配置文件映射到输出配置文件。

如果指定的输入或输出配置文件不是有效的文件名,则将引发Pycmserror。如果inplace为true,则输出模式为!=im.mode,将引发Pycmserror。如果在应用配置文件期间发生错误,将引发Pycmserror。如果outputmode不是outputprofile(或pycms)支持的模式,则将引发pycmserror。

此函数使用指定的渲染意图将ICC转换为IM,从输入配置文件的颜色空间转换为输出配置文件的颜色空间,以决定如何处理超出范围的颜色。

OutputMode可用于指定使用这些配置文件进行颜色模式转换,但指定的配置文件必须能够处理该模式。例如,如果使用配置文件将im从rgb转换为cmyk,则输入配置文件必须处理rgb数据,而输出配置文件必须处理cmyk数据。

参数
  • im -- 打开的pil图像对象(即image.new(…)或image.open(…)等)

  • inputProfile -- 字符串,作为要用于此图像或配置文件对象的ICC输入配置文件的有效文件名路径

  • outputProfile -- 字符串,作为要用于此图像或配置文件对象的ICC输出配置文件的有效文件名路径

  • renderingIntent -- 整数(0-3),指定要用于变换图像的渲染意图cms.intent_perceptual=0(默认值)imagecms.intent_relative_coloromic=1 imagecms.intent_saturation=2 imagecms.intent_absolute_coloromic=3请参见pycms文档,了解渲染意图的详细信息以及是的。

  • outputMode -- 输出图像的有效PIL模式(即“RGB”、“CMYK”等)。注:如果渲染图像“inplace”,则输出模式必须与输入模式相同,或完全忽略。如果省略,输出模式将与输入图像的模式相同(im.模式)

  • inPlace -- 布尔值。如果为真,则原始图像将在适当位置进行修改,并且不会返回任何图像。如果为false(默认值),则返回应用转换的新图像对象。

  • flags -- 整数(0-…)指定附加标志

返回

无PIL图像对象或新PIL图像对象,取决于就地的值

引发

PyCMSError --

PIL.ImageCms.versions()[源代码]

(Pycms)获取版本。

CmsProfile

ICC颜色配置文件包装在类的实例中 CmsProfile . 规范ICC.1:2010包含有关ICC配置文件中值含义的更多信息。

为了方便起见,所有XYZ值也都作为XYY值给出(例如,它们可以很容易地显示在色度图中)。

class PIL.ImageCms.CmsProfile
creation_date

首次创建此配置文件的日期和时间(参见ICC.1:2010的7.2.1)。

类型

datetime.datetime or None

version

此配置文件遵循的ICC标准的版本号(例如 2.0

类型

float

icc_version

等同于 version ,但采用编码格式(见ICC.1:2010第7.2.4节)。

device_class

4个字符的字符串,用于标识配置文件类。什么之中的一个 scnrmntrprtrlinkspacabstnmcl (详见ICC.1:2010第7.2.5条)。

类型

string

xcolor_space

4个字符的字符串(用空格填充),用于标识颜色空间,例如 XYZ␣RGB␣CMYK (详见ICC.1:2010第7.2.6条)。

请注意,弃用的属性 color_space 包含此的解释(非填充)变量(但在未知输入时可以为空)。

类型

string

connection_space

4个字符的字符串(用空格填充),用于标识转换B端的颜色空间(有关详细信息,请参见ICC.1:2010的7.2.7)。

请注意,弃用的属性 pcs 包含此的解释(非填充)变量(但在未知输入时可以为空)。

类型

string

header_flags

配置文件的编码头标志(有关详细信息,请参阅ICC.1:2010的7.2.11)。

类型

int

header_manufacturer

4个字符的字符串(用空格填充),用于标识设备制造商,该字符串应与www.color.org(见ICC.1:2010第7.2.12条)上的ICC签名注册表的相应部分中包含的签名相匹配。

类型

string

header_model

4个字符的字符串(用空格填充),用于标识设备型号,该字符串应与www.color.org(见ICC.1:2010第7.2.13条)上的ICC签名注册表的相应部分中包含的签名相匹配。

类型

string

attributes

用于标识配置文件适用的特定设备设置的唯一属性的标志(有关详细信息,请参阅ICC.1:2010的7.2.14)。

类型

int

rendering_intent

将此配置文件与另一个配置文件组合时使用的呈现意图(通常在运行时被覆盖,但此处提供了deviceLink和嵌入源配置文件,请参见ICC.1:2010的7.2.15)。

什么之中的一个 ImageCms.INTENT_ABSOLUTE_COLORIMETRICImageCms.INTENT_PERCEPTUALImageCms.INTENT_RELATIVE_COLORIMETRICImageCms.INTENT_SATURATION .

类型

int

profile_id

识别配置文件的16个字节序列(通过特殊构造的MD5和),或者如果未计算配置文件ID,则为16个二进制零(见ICC.1:2010的7.2.18)。

类型

bytes

copyright

配置文件的文本版权信息(见ICC.1:2010的9.2.21)。

类型

unicode or None

manufacturer

设备制造商的(英文)显示字符串(见ICC.1:2010的9.2.22)。

类型

unicode or None

model

创建此配置文件的设备型号的(英文)显示字符串(参见ICC.1:2010的9.2.23)。

类型

unicode or None

profile_description

配置文件描述的(英文)显示字符串(见ICC.1:2010的9.2.41)。

类型

unicode or None

target

已注册的特征数据集的名称,或特征目标的测量数据(见ICC.1:2010的9.2.14)。

类型

unicode or None

red_colorant

矩阵/TRC转换中使用的矩阵的第一列(见ICC.1:2010的9.2.44)。

类型

((X, Y, Z), (x, y, Y)) or None

green_colorant

矩阵/TRC转换中使用的矩阵的第二列(见ICC.1:2010的9.2.30)。

类型

((X, Y, Z), (x, y, Y)) or None

blue_colorant

矩阵/TRC转换中使用的矩阵的第三列(见ICC.1:2010的9.2.4)。

类型

((X, Y, Z), (x, y, Y)) or None

luminance

Y通道所述发射装置的绝对亮度(单位:坎德拉/平方米)(见ICC.1:2010第9.2.32条)。

类型

((X, Y, Z), (x, y, Y)) or None

chromaticity

使用的荧光粉/着色剂色度设置的数据(红色、绿色和蓝色通道,见ICC.1:2010的9.2.16)。

类型

((x, y, Y), (x, y, Y), (x, y, Y)) or None

chromatic_adaption

色度自适应矩阵将使用实际照明条件和相对于实际采用的白色测量的颜色转换为相对于采用白色的PC的颜色,完全适应实际采用的白色色度与采用白色色度的PC(见ICC.1:2010的9.2.15)。

返回两个矩阵,一个在(x,y,z)空间中,一个在(x,y,y)空间中。

类型

3元组的2元组,第一个具有(x,y,z)值,第二个具有(x,y,y)值

colorant_table

此标记通过一个唯一的名称和一组PCSXYZ或PCSLAB值(参见ICC.1:2010的9.2.19)来标识轮廓中使用的着色剂。

类型

字符串表

colorant_table_out

此标记通过一个唯一的名称和一组pcslab值来标识配置文件中使用的着色剂(仅适用于deviceLink配置文件,请参见ICC.1:2010的9.2.19)。

类型

字符串表

colorimetric_intent

4个字符的字符串(用空格填充),用于识别使用比色意向转换生成的pcs比色法的图像状态(详情请参见ICC.1:2010的9.2.20)。

类型

string or None

perceptual_rendering_intent_gamut

4个字符的字符串(用空格填充),用于标识(一个)标准参考中色域(详见ICC.1:2010的9.2.37)。

类型

string or None

saturation_rendering_intent_gamut

4个字符的字符串(用空格填充),用于标识(一个)标准参考中色域(详见ICC.1:2010的9.2.37)。

类型

string or None

technology

4个字符的字符串(用空格填充),用于标识设备技术(有关详细信息,请参阅ICC.1:2010的9.2.47)。

类型

string or None

media_black_point

此标签指定介质黑点,用于生成绝对比色法。

此标记在ICC 3.2中可用,但已从版本4中删除。

类型

((X, Y, Z), (x, y, Y)) or None

media_white_point_temperature

计算白点温度(有关详细信息,请参阅LCMS文档)。

类型

float or None

viewing_condition

查看条件的(英文)显示字符串(见ICC.1:2010的9.2.48)。

类型

unicode or None

screening_description

(英文)显示筛选条件的字符串。

此标记在ICC 3.2中可用,但已从版本4中删除。

类型

unicode or None

red_primary

RGB原色红色(1,0,0)的XYZ变换。

类型

((X, Y, Z), (x, y, Y)) or None

green_primary

RGB原色绿色(0,1,0)的XYZ变换。

类型

((X, Y, Z), (x, y, Y)) or None

blue_primary

RGB原色蓝色(0,0,1)的XYZ变换。

类型

((X, Y, Z), (x, y, Y)) or None

is_matrix_shaper

如果此配置文件作为矩阵整形器实现,则为true(请参见有关LCMS的文档)。

类型

bool

clut

返回CLUT模型所有支持的意图和方向的字典。

词典是按意图编索引的。( ImageCms.INTENT_ABSOLUTE_COLORIMETRICImageCms.INTENT_PERCEPTUALImageCms.INTENT_RELATIVE_COLORIMETRICImageCms.INTENT_SATURATION

这些值是按方向索引的三元组( ImageCms.DIRECTION_INPUTImageCms.DIRECTION_OUTPUTImageCms.DIRECTION_PROOF

元组的元素是布尔值。如果值是 True ,这一意图得到了该方向的支持。

类型

dict 布尔3-元组的

intent_supported

返回所有支持的意图和方向的字典。

词典是按意图编索引的。( ImageCms.INTENT_ABSOLUTE_COLORIMETRICImageCms.INTENT_PERCEPTUALImageCms.INTENT_RELATIVE_COLORIMETRICImageCms.INTENT_SATURATION

这些值是按方向索引的三元组( ImageCms.DIRECTION_INPUTImageCms.DIRECTION_OUTPUTImageCms.DIRECTION_PROOF

元组的元素是布尔值。如果值是 True ,这一意图得到了该方向的支持。

类型

dict 布尔3-元组的

color_space

已弃用,但为了向后兼容而保留。解释值 xcolor_space . 如果无法解码值,则可能是空字符串。

类型

string

pcs

已弃用,但为了向后兼容而保留。解释值 connection_space . 如果无法解码值,则可能是空字符串。

类型

string

product_model

已弃用,但为了向后兼容而保留。的ASCII编码值 model .

类型

string

product_manufacturer

已弃用,但为了向后兼容而保留。的ASCII编码值 manufacturer .

类型

string

已弃用,但为了向后兼容而保留。的ASCII编码值 copyright .

类型

string

product_description

已弃用,但为了向后兼容而保留。的ASCII编码值 profile_description .

类型

string

product_desc

已弃用,但为了向后兼容而保留。的ASCII编码值 profile_description .

这个别名 product_description 用于包含有关配置文件的派生信息字符串,具体取决于描述、版权、制造商和模型字段的值)。

类型

string

类上定义了一个函数:

is_intent_supported(intent, direction)

返回给定方向是否支持意向。

请注意,您还可以通过 intent_supported .

参数
  • intent -- 什么之中的一个 ImageCms.INTENT_ABSOLUTE_COLORIMETRICImageCms.INTENT_PERCEPTUALImageCms.INTENT_RELATIVE_COLORIMETRICImageCms.INTENT_SATURATION .

  • direction -- 什么之中的一个 ImageCms.DIRECTION_INPUTImageCms.DIRECTION_OUTPUTImageCms.DIRECTION_PROOF

返回

如果支持意图和方向,则为布尔值。