U
|
T ±dt ã @ sà d dl Z d dlmZ d dlmZ ddlmZ zd dlmZ W n6 ek
|
rr Z zddl
|
m Z e e ZW 5 dZ [ X Y nX dZ d Z eZG d
|
d d eZG d d d eZdd Zddddddddddddddd d d d d d!Zd Ze ¡ D ]ZeeerâeeB ZqâG d"d# d#ZG d$d% d%ejZdKd&d'ZG d(d) d)e Z ej dd*d fd+d,Z d-d. Z ej d fd/d0Z!ej ej"ed1 fd2d3Z#e!Z$e#Z%dLd4d5Z&dMd7d8Z'd9d: Z(d;d< Z)d=d> Z*d?d@ Z+dAdB Z,dCdD Z-dEdF Z.dGdH Z/dIdJ Z0dS )Né N)ÚIntEnum)ÚImageé )Ú deprecate)Ú _imagingcms)Ú DeferredErrora|
|
pyCMS
|
|
a Python / PIL interface to the littleCMS ICC Color Management System
|
Copyright (C) 2002-2003 Kevin Cazabon
|
kevin@cazabon.com
|
https://www.cazabon.com
|
|
pyCMS home page: https://www.cazabon.com/pyCMS
|
littleCMS home page: https://www.littlecms.com
|
(littleCMS is Copyright (C) 1998-2001 Marti Maria)
|
|
Originally released under LGPL. Graciously donated to PIL in
|
March 2009, for distribution under the standard PIL license
|
|
The pyCMS.py module provides a "clean" interface between Python/PIL and
|
pyCMSdll, taking care of some of the more complex handling of the direct
|
pyCMSdll functions, as well as error-checking and making sure that all
|
relevant data is kept together.
|
|
While it is possible to call pyCMSdll functions directly, it's not highly
|
recommended.
|
|
Version History:
|
|
1.0.0 pil Oct 2013 Port to LCMS 2.
|
|
0.1.0 pil mod March 10, 2009
|
|
Renamed display profile to proof profile. The proof
|
profile is the profile of the device that is being
|
simulated, not the profile of the device which is
|
actually used to display/print the final simulation
|
(that'd be the output profile) - also see LCMSAPI.txt
|
input colorspace -> using 'renderingIntent' -> proof
|
colorspace -> using 'proofRenderingIntent' -> output
|
colorspace
|
|
Added LCMS FLAGS support.
|
Added FLAGS["SOFTPROOFING"] as default flag for
|
buildProofTransform (otherwise the proof profile/intent
|
would be ignored).
|
|
0.1.0 pil March 2009 - added to PIL, as PIL.ImageCms
|
|
0.0.2 alpha Jan 6, 2002
|
|
Added try/except statements around type() checks of
|
potential CObjects... Python won't let you use type()
|
on them, and raises a TypeError (stupid, if you ask
|
me!)
|
|
Added buildProofTransformFromOpenProfiles() function.
|
Additional fixes in DLL, see DLL code for details.
|
|
0.0.1 alpha first public release, Dec. 26, 2002
|
|
Known to-do list with current version (of Python interface, not pyCMSdll):
|
|
none
|
|
z 1.0.0 pilc @ s e Zd ZdZdZdZdZdS )ÚIntentr r é é N)Ú__name__Ú
|
__module__Ú __qualname__Ú
|
PERCEPTUALZRELATIVE_COLORIMETRICZ
|
SATURATIONÚABSOLUTE_COLORIMETRIC© r r úCd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\PIL/ImageCms.pyr k s r c @ s e Zd ZdZdZdZdS )Ú Directionr r r N)r r r ZINPUTZOUTPUTZPROOFr r r r r r s r c C s t dtdi ¡ D ]X\}}| |¡r| t|d
} | |jkrt| | d|j d| || S qdt d| d}t|d S )NZINTENT_Z
|
DIRECTION_é
|
Ú.zmodule 'z' has no attribute 'ú') r r ÚitemsÚ
|
startswithÚlenÚ __members__r r ÚAttributeError)ÚnameÚenumÚprefixÚmsgr r r Ú __getattr__x s
|
|
r r r
|
é é é é@ é i i i i i i @ i i c C s | d@ d> S )Néÿ r! r )Únr r r Ú<lambda> ó r' )Z MATRIXINPUTZ MATRIXOUTPUTZ
|
MATRIXONLYZNOWHITEONWHITEFIXUPZNOPRELINEARIZATIONZGUESSDEVICECLASSZNOTCACHEZ
|
NOTPRECALCZ NULLTRANSFORMZHIGHRESPRECALCZ LOWRESPRECALCZWHITEBLACKCOMPENSATIONZBLACKPOINTCOMPENSATIONZ
|
GAMUTCHECKÚ SOFTPROOFINGZ PRESERVEBLACKZNODEFAULTRESOURCEDEFZ
|
GRIDPOINTSc @ s& e Zd Zdd ZdddZdd ZdS ) ÚImageCmsProfilec C sÈ t |trtjdkrl| ¡ }z| d¡ W n@ tk
|
rj t|d}| t
|
| ¡ ¡¡ W 5 Q R X Y dS X | t |¡|¡ nDt |dr | t
|
| ¡ ¡¡ n$t |tjr¸| |¡ n d}t|dS )z©
|
:param profile: Either a string representing a filename,
|
a file like object containing a profile or a
|
low-level profile object
|
|
Úwin32ÚasciiÚrbNÚreadzInvalid type for Profile)Ú
|
isinstanceÚstrÚsysÚplatformÚencodeÚdecodeÚUnicodeDecodeErrorÚopenÚ_setÚcoreZprofile_frombytesr. Z profile_openÚhasattrr Z
|
CmsProfileÚ TypeError)ÚselfÚprofileZprofile_bytes_pathÚfr r r r Ú__init__¬ s
|
|
|
zImageCmsProfile.__init__Nc C s. || _ || _|r d | _d | _n d | _d | _d S ©N)r< ÚfilenameZ product_nameZ product_info)r; r< r@ r r r r7 Æ s zImageCmsProfile._setc C s t | j¡S )z
|
Returns the profile in a format suitable for embedding in
|
saved images.
|
|
:returns: a bytes object containing the ICC profile.
|
)r8 Zprofile_tobytesr< )r; r r r ÚtobytesÐ s zImageCmsProfile.tobytes)N)r r r r> r7 rA r r r r r* « s
|
|
r* c @ s@ e Zd ZdZejdejdfddZdd Zd dd Z d
|
d Z
|
dS ) ÚImageCmsTransformzÍ
|
Transform. This can be used with the procedural API, or with the standard
|
:py:func:`~PIL.Image.Image.point` method.
|
|
Will return the output profile in the ``output.info['icc_profile']``.
|
Nr c
|
C sf |d kr$t |j|j||||¡| _n t |j|j|j|||||¡| _| | _| _| | _| _|| _ d S r? )
|
r8 ÚbuildTransformr< Ú transformÚbuildProofTransformÚ
|
input_modeZ inputModeÚ output_modeÚ
|
outputModeÚoutput_profile) r; ÚinputÚoutputrF rG ÚintentZproofZ proof_intentÚflagsr r r r> ä s, ÿø zImageCmsTransform.__init__c C s
|
| |¡S r? )Úapply)r; Úimr r r Úpoint s zImageCmsTransform.pointc C sL | ¡ |d kr"t | j|jd ¡}| j |jj|jj¡ | j
|
¡ |j d< |S )NÚ icc_profile) Úloadr ÚnewrG ÚsizerD rN rO ÚidrI rA Úinfo)r; rO ÚimOutr r r rN s zImageCmsTransform.applyc C sJ | ¡ |j| jkr d}t|| j |jj|jj¡ | j ¡ |j
|
d< |S )Nz mode mismatchrQ ) rR ÚmoderG Ú
|
ValueErrorrD rN rO rU rI rA rV )r; rO r r r r Úapply_in_place s z ImageCmsTransform.apply_in_place)N) r r r Ú__doc__r r r r> rP rN rZ r r r r rB Û s ÷
|
|
rB c C sV t jdkrdS ddlm} t| |jr4t | d¡}nt | p>d¡}|dkrNdS t|S )z
|
(experimental) Fetches the profile for the current display device.
|
|
:returns: ``None`` if the profile is not known.
|
r+ Nr )ÚImageWinr ) r1 r2 ÚPILr\ r/ ÚHDCr8 Zget_display_profile_win32r* )Úhandler\ r< r r r Úget_display_profile s
|
r` c @ s e Zd ZdZdS )Ú
|
PyCMSErrorzJ(pyCMS) Exception class.
|
This is used for all errors in the pyCMS API.N)r r r r[ r r r r ra 3 s ra Fc
|
C s |dkr| j }t|tr.d| kr,dks:n d}t|t|trZd| krXtksln dt }t|z\t|tst|}t|tst|}t||| j |||d}|r¼| | ¡ d} n
|
| | ¡} W n2 t t
|
t fk
|
rú }
|
zt|
|
|
|
W 5 d}
|
~
|
X Y nX | S )a
|
|
(pyCMS) Applies an ICC transformation to a given image, mapping from
|
``inputProfile`` to ``outputProfile``.
|
|
If the input or output profiles specified are not valid filenames, a
|
:exc:`PyCMSError` will be raised. If ``inPlace`` is ``True`` and
|
``outputMode != im.mode``, a :exc:`PyCMSError` will be raised.
|
If an error occurs during application of the profiles,
|
a :exc:`PyCMSError` will be raised.
|
If ``outputMode`` is not a mode supported by the ``outputProfile`` (or by pyCMS),
|
a :exc:`PyCMSError` will be raised.
|
|
This function applies an ICC transformation to im from ``inputProfile``'s
|
color space to ``outputProfile``'s color space using the specified rendering
|
intent to decide how to handle out-of-gamut colors.
|
|
``outputMode`` can be used to specify that a color mode conversion is to
|
be done using these profiles, but the specified profiles must be able
|
to handle that mode. I.e., if converting im from RGB to CMYK using
|
profiles, the input profile must handle RGB data, and the output
|
profile must handle CMYK data.
|
|
:param im: An open :py:class:`~PIL.Image.Image` object (i.e. Image.new(...)
|
or Image.open(...), etc.)
|
:param inputProfile: String, as a valid filename path to the ICC input
|
profile you wish to use for this image, or a profile object
|
:param outputProfile: String, as a valid filename path to the ICC output
|
profile you wish to use for this image, or a profile object
|
:param renderingIntent: Integer (0-3) specifying the rendering intent you
|
wish to use for the transform
|
|
ImageCms.Intent.PERCEPTUAL = 0 (DEFAULT)
|
ImageCms.Intent.RELATIVE_COLORIMETRIC = 1
|
ImageCms.Intent.SATURATION = 2
|
ImageCms.Intent.ABSOLUTE_COLORIMETRIC = 3
|
|
see the pyCMS documentation for details on rendering intents and what
|
they do.
|
:param outputMode: A valid PIL mode for the output image (i.e. "RGB",
|
"CMYK", etc.). Note: if rendering the image "inPlace", outputMode
|
MUST be the same mode as the input, or omitted completely. If
|
omitted, the outputMode will be the same as the mode of the input
|
image (im.mode)
|
:param inPlace: Boolean. If ``True``, the original image is modified in-place,
|
and ``None`` is returned. If ``False`` (default), a new
|
:py:class:`~PIL.Image.Image` object is returned with the transform applied.
|
:param flags: Integer (0-...) specifying additional flags
|
:returns: Either None or a new :py:class:`~PIL.Image.Image` object, depending on
|
the value of ``inPlace``
|
:exception PyCMSError:
|
Nr r
|
ú2renderingIntent must be an integer between 0 and 3z'flags must be an integer between 0 and ©rM ) rX r/ Úintra Ú _MAX_FLAGr* rB rZ rN ÚOSErrorr: rY ) rO Ú inputProfileÚ outputProfileÚrenderingIntentrH ÚinPlacerM r rD rW Úvr r r ÚprofileToProfile; s8 =
|
|
|
ú
|
rl c
|
C sB z
|
t | W S tttfk
|
r< } zt||W 5 d}~X Y nX dS )aü
|
(pyCMS) Opens an ICC profile file.
|
|
The PyCMSProfile object can be passed back into pyCMS for use in creating
|
transforms and such (as in ImageCms.buildTransformFromOpenProfiles()).
|
|
If ``profileFilename`` is not a valid filename for an ICC profile,
|
a :exc:`PyCMSError` will be raised.
|
|
:param profileFilename: String, as a valid filename path to the ICC profile
|
you wish to open, or a file-like object.
|
:returns: A CmsProfile class object.
|
:exception PyCMSError:
|
N)r* rf r: rY ra )ZprofileFilenamerk r r r ÚgetOpenProfile s
|
rm c
|
C sÎ t |tr d| kr dks,n d}t|t |trLd| krJtks\n dt }t|z:t | tspt| } t |tst|}t| |||||dW S tttfk
|
rÈ } zt||W 5 d}~X Y nX dS )a
|
(pyCMS) Builds an ICC transform mapping from the ``inputProfile`` to the
|
``outputProfile``. Use applyTransform to apply the transform to a given
|
image.
|
|
If the input or output profiles specified are not valid filenames, a
|
:exc:`PyCMSError` will be raised. If an error occurs during creation
|
of the transform, a :exc:`PyCMSError` will be raised.
|
|
If ``inMode`` or ``outMode`` are not a mode supported by the ``outputProfile``
|
(or by pyCMS), a :exc:`PyCMSError` will be raised.
|
|
This function builds and returns an ICC transform from the ``inputProfile``
|
to the ``outputProfile`` using the ``renderingIntent`` to determine what to do
|
with out-of-gamut colors. It will ONLY work for converting images that
|
are in ``inMode`` to images that are in ``outMode`` color format (PIL mode,
|
i.e. "RGB", "RGBA", "CMYK", etc.).
|
|
Building the transform is a fair part of the overhead in
|
ImageCms.profileToProfile(), so if you're planning on converting multiple
|
images using the same input/output settings, this can save you time.
|
Once you have a transform object, it can be used with
|
ImageCms.applyProfile() to convert images without the need to re-compute
|
the lookup table for the transform.
|
|
The reason pyCMS returns a class object rather than a handle directly
|
to the transform is that it needs to keep track of the PIL input/output
|
modes that the transform is meant for. These attributes are stored in
|
the ``inMode`` and ``outMode`` attributes of the object (which can be
|
manually overridden if you really want to, but I don't know of any
|
time that would be of use, or would even work).
|
|
:param inputProfile: String, as a valid filename path to the ICC input
|
profile you wish to use for this transform, or a profile object
|
:param outputProfile: String, as a valid filename path to the ICC output
|
profile you wish to use for this transform, or a profile object
|
:param inMode: String, as a valid PIL mode that the appropriate profile
|
also supports (i.e. "RGB", "RGBA", "CMYK", etc.)
|
:param outMode: String, as a valid PIL mode that the appropriate profile
|
also supports (i.e. "RGB", "RGBA", "CMYK", etc.)
|
:param renderingIntent: Integer (0-3) specifying the rendering intent you
|
wish to use for the transform
|
|
ImageCms.Intent.PERCEPTUAL = 0 (DEFAULT)
|
ImageCms.Intent.RELATIVE_COLORIMETRIC = 1
|
ImageCms.Intent.SATURATION = 2
|
ImageCms.Intent.ABSOLUTE_COLORIMETRIC = 3
|
|
see the pyCMS documentation for details on rendering intents and what
|
they do.
|
:param flags: Integer (0-...) specifying additional flags
|
:returns: A CmsTransform class object.
|
:exception PyCMSError:
|
r r
|
rb ú)flags must be an integer between 0 and %src N© r/ rd ra re r* rB rf r: rY )rg rh ÚinModeÚoutModeri rM r rk r r r rC ± s* ?
|
|
ÿrC r) c
|
|
C sâ t |tr d| kr dks,n d}t|t |trLd| krJtks\n dt }t|zNt | tspt| } t |tst|}t |tst|}t| |||||||W S tttfk
|
rÜ } zt| | W 5 d} ~ X Y nX dS )a
|
(pyCMS) Builds an ICC transform mapping from the ``inputProfile`` to the
|
``outputProfile``, but tries to simulate the result that would be
|
obtained on the ``proofProfile`` device.
|
|
If the input, output, or proof profiles specified are not valid
|
filenames, a :exc:`PyCMSError` will be raised.
|
|
If an error occurs during creation of the transform,
|
a :exc:`PyCMSError` will be raised.
|
|
If ``inMode`` or ``outMode`` are not a mode supported by the ``outputProfile``
|
(or by pyCMS), a :exc:`PyCMSError` will be raised.
|
|
This function builds and returns an ICC transform from the ``inputProfile``
|
to the ``outputProfile``, but tries to simulate the result that would be
|
obtained on the ``proofProfile`` device using ``renderingIntent`` and
|
``proofRenderingIntent`` to determine what to do with out-of-gamut
|
colors. This is known as "soft-proofing". It will ONLY work for
|
converting images that are in ``inMode`` to images that are in outMode
|
color format (PIL mode, i.e. "RGB", "RGBA", "CMYK", etc.).
|
|
Usage of the resulting transform object is exactly the same as with
|
ImageCms.buildTransform().
|
|
Proof profiling is generally used when using an output device to get a
|
good idea of what the final printed/displayed image would look like on
|
the ``proofProfile`` device when it's quicker and easier to use the
|
output device for judging color. Generally, this means that the
|
output device is a monitor, or a dye-sub printer (etc.), and the simulated
|
device is something more expensive, complicated, or time consuming
|
(making it difficult to make a real print for color judgement purposes).
|
|
Soft-proofing basically functions by adjusting the colors on the
|
output device to match the colors of the device being simulated. However,
|
when the simulated device has a much wider gamut than the output
|
device, you may obtain marginal results.
|
|
:param inputProfile: String, as a valid filename path to the ICC input
|
profile you wish to use for this transform, or a profile object
|
:param outputProfile: String, as a valid filename path to the ICC output
|
(monitor, usually) profile you wish to use for this transform, or a
|
profile object
|
:param proofProfile: String, as a valid filename path to the ICC proof
|
profile you wish to use for this transform, or a profile object
|
:param inMode: String, as a valid PIL mode that the appropriate profile
|
also supports (i.e. "RGB", "RGBA", "CMYK", etc.)
|
:param outMode: String, as a valid PIL mode that the appropriate profile
|
also supports (i.e. "RGB", "RGBA", "CMYK", etc.)
|
:param renderingIntent: Integer (0-3) specifying the rendering intent you
|
wish to use for the input->proof (simulated) transform
|
|
ImageCms.Intent.PERCEPTUAL = 0 (DEFAULT)
|
ImageCms.Intent.RELATIVE_COLORIMETRIC = 1
|
ImageCms.Intent.SATURATION = 2
|
ImageCms.Intent.ABSOLUTE_COLORIMETRIC = 3
|
|
see the pyCMS documentation for details on rendering intents and what
|
they do.
|
:param proofRenderingIntent: Integer (0-3) specifying the rendering intent
|
you wish to use for proof->output transform
|
|
ImageCms.Intent.PERCEPTUAL = 0 (DEFAULT)
|
ImageCms.Intent.RELATIVE_COLORIMETRIC = 1
|
ImageCms.Intent.SATURATION = 2
|
ImageCms.Intent.ABSOLUTE_COLORIMETRIC = 3
|
|
see the pyCMS documentation for details on rendering intents and what
|
they do.
|
:param flags: Integer (0-...) specifying additional flags
|
:returns: A CmsTransform class object.
|
:exception PyCMSError:
|
r r
|
rb rn Nro )
|
rg rh Z proofProfilerp rq ri ZproofRenderingIntentrM r rk r r r rE s2 T
|
|
|
ø
|
rE c
|
C sX z"|r| | ¡ d}n
|
| | ¡}W n0 ttfk
|
rR } zt||W 5 d}~X Y nX |S )a
|
(pyCMS) Applies a transform to a given image.
|
|
If ``im.mode != transform.inMode``, a :exc:`PyCMSError` is raised.
|
|
If ``inPlace`` is ``True`` and ``transform.inMode != transform.outMode``, a
|
:exc:`PyCMSError` is raised.
|
|
If ``im.mode``, ``transform.inMode`` or ``transform.outMode`` is not
|
supported by pyCMSdll or the profiles you used for the transform, a
|
:exc:`PyCMSError` is raised.
|
|
If an error occurs while the transform is being applied,
|
a :exc:`PyCMSError` is raised.
|
|
This function applies a pre-calculated transform (from
|
ImageCms.buildTransform() or ImageCms.buildTransformFromOpenProfiles())
|
to an image. The transform can be used for multiple images, saving
|
considerable calculation time if doing the same conversion multiple times.
|
|
If you want to modify im in-place instead of receiving a new image as
|
the return value, set ``inPlace`` to ``True``. This can only be done if
|
``transform.inMode`` and ``transform.outMode`` are the same, because we can't
|
change the mode in-place (the buffer sizes for some modes are
|
different). The default behavior is to return a new :py:class:`~PIL.Image.Image`
|
object of the same dimensions in mode ``transform.outMode``.
|
|
:param im: An :py:class:`~PIL.Image.Image` object, and im.mode must be the same
|
as the ``inMode`` supported by the transform.
|
:param transform: A valid CmsTransform class object
|
:param inPlace: Bool. If ``True``, ``im`` is modified in place and ``None`` is
|
returned, if ``False``, a new :py:class:`~PIL.Image.Image` object with the
|
transform applied is returned (and ``im`` is not changed). The default is
|
``False``.
|
:returns: Either ``None``, or a new :py:class:`~PIL.Image.Image` object,
|
depending on the value of ``inPlace``. The profile will be returned in
|
the image's ``info['icc_profile']``.
|
:exception PyCMSError:
|
N)rZ rN r: rY ra )rO rD rj rW rk r r r ÚapplyTransformy s )
|
rr éÿÿÿÿc
|
C s² | dkr d| d}t || dkrnz t|}W n< ttfk
|
rl } zd| d}t ||W 5 d}~X Y nX zt | |¡W S ttfk
|
r¬ } zt ||W 5 d}~X Y nX dS )aS
|
(pyCMS) Creates a profile.
|
|
If colorSpace not in ``["LAB", "XYZ", "sRGB"]``,
|
a :exc:`PyCMSError` is raised.
|
|
If using LAB and ``colorTemp`` is not a positive integer,
|
a :exc:`PyCMSError` is raised.
|
|
If an error occurs while creating the profile,
|
a :exc:`PyCMSError` is raised.
|
|
Use this function to create common profiles on-the-fly instead of
|
having to supply a profile on disk and knowing the path to it. It
|
returns a normal CmsProfile object that can be passed to
|
ImageCms.buildTransformFromOpenProfiles() to create a transform to apply
|
to images.
|
|
:param colorSpace: String, the color space of the profile you wish to
|
create.
|
Currently only "LAB", "XYZ", and "sRGB" are supported.
|
:param colorTemp: Positive integer for the white point for the profile, in
|
degrees Kelvin (i.e. 5000, 6500, 9600, etc.). The default is for D50
|
illuminant if omitted (5000k). colorTemp is ONLY applied to LAB
|
profiles, and is ignored for XYZ and sRGB.
|
:returns: A CmsProfile class object
|
:exception PyCMSError:
|
)ÚLABZXYZZsRGBz;Color space not supported for on-the-fly profile creation (ú)rt z$Color temperature must be numeric, "z " not validN)ra Úfloatr: rY r8 Ú createProfile)Z
|
colorSpaceZ colorTempr Úerk r r r rw ® s
|
ÿ rw c C s¢ zht | tst| } | jj}| jj}|s>|s>| jjp6dd W S |rNt|dkrX|d W S | d| dW S ttt t
|
fk
|
r } zt ||W 5 d}~X Y nX dS )a
|
|
(pyCMS) Gets the internal product name for the given profile.
|
|
If ``profile`` isn't a valid CmsProfile object or filename to a profile,
|
a :exc:`PyCMSError` is raised If an error occurs while trying
|
to obtain the name tag, a :exc:`PyCMSError` is raised.
|
|
Use this function to obtain the INTERNAL name of the profile (stored
|
in an ICC tag in the profile itself), usually the one used when the
|
profile was originally created. Sometimes this tag also contains
|
additional information supplied by the creator.
|
|
:param profile: EITHER a valid CmsProfile object, OR a string of the
|
filename of an ICC profile.
|
:returns: A string containing the internal name of the profile as stored
|
in an ICC tag.
|
:exception PyCMSError:
|
Ú Ú
|
é z - N) r/ r* r< ÚmodelÚ manufacturerÚprofile_descriptionr r rf r: rY ra )r< r| r} rk r r r ÚgetProfileNameß s
|
|
r c C s zRt | tst| } | jj}| jj}g }||fD ]}|r0| |¡ q0d |¡d W S ttt t
|
fk
|
r } zt ||W 5 d}~X Y nX dS )aÈ
|
(pyCMS) Gets the internal product information for the given profile.
|
|
If ``profile`` isn't a valid CmsProfile object or filename to a profile,
|
a :exc:`PyCMSError` is raised.
|
|
If an error occurs while trying to obtain the info tag,
|
a :exc:`PyCMSError` is raised.
|
|
Use this function to obtain the information stored in the profile's
|
info tag. This often contains details about the profile, and how it
|
was created, as supplied by the creator.
|
|
:param profile: EITHER a valid CmsProfile object, OR a string of the
|
filename of an ICC profile.
|
:returns: A string containing the internal profile information stored in
|
an ICC tag.
|
:exception PyCMSError:
|
z
|
|
N) r/ r* r< r~ Ú copyrightÚappendÚjoinr rf r: rY ra )r< Ú descriptionZcprightZarrÚeltrk r r r ÚgetProfileInfo s
|
r
c C s^ z$t | tst| } | jjp dd W S ttttfk
|
rX } zt||W 5 d}~X Y nX dS )aW
|
(pyCMS) Gets the copyright for the given profile.
|
|
If ``profile`` isn't a valid CmsProfile object or filename to a profile, a
|
:exc:`PyCMSError` is raised.
|
|
If an error occurs while trying to obtain the copyright tag,
|
a :exc:`PyCMSError` is raised.
|
|
Use this function to obtain the information stored in the profile's
|
copyright tag.
|
|
:param profile: EITHER a valid CmsProfile object, OR a string of the
|
filename of an ICC profile.
|
:returns: A string containing the internal profile information stored in
|
an ICC tag.
|
:exception PyCMSError:
|
ry rz N) r/ r* r< r r rf r: rY ra ©r< rk r r r ÚgetProfileCopyright1 s
|
r c C s^ z$t | tst| } | jjp dd W S ttttfk
|
rX } zt||W 5 d}~X Y nX dS )a`
|
(pyCMS) Gets the manufacturer for the given profile.
|
|
If ``profile`` isn't a valid CmsProfile object or filename to a profile, a
|
:exc:`PyCMSError` is raised.
|
|
If an error occurs while trying to obtain the manufacturer tag, a
|
:exc:`PyCMSError` is raised.
|
|
Use this function to obtain the information stored in the profile's
|
manufacturer tag.
|
|
:param profile: EITHER a valid CmsProfile object, OR a string of the
|
filename of an ICC profile.
|
:returns: A string containing the internal profile information stored in
|
an ICC tag.
|
:exception PyCMSError:
|
ry rz N) r/ r* r< r} r rf r: rY ra r r r r ÚgetProfileManufacturerM s
|
r c C s^ z$t | tst| } | jjp dd W S ttttfk
|
rX } zt||W 5 d}~X Y nX dS )aK
|
(pyCMS) Gets the model for the given profile.
|
|
If ``profile`` isn't a valid CmsProfile object or filename to a profile, a
|
:exc:`PyCMSError` is raised.
|
|
If an error occurs while trying to obtain the model tag,
|
a :exc:`PyCMSError` is raised.
|
|
Use this function to obtain the information stored in the profile's
|
model tag.
|
|
:param profile: EITHER a valid CmsProfile object, OR a string of the
|
filename of an ICC profile.
|
:returns: A string containing the internal profile information stored in
|
an ICC tag.
|
:exception PyCMSError:
|
ry rz N) r/ r* r< r| r rf r: rY ra r r r r ÚgetProfileModeli s
|
r c C s^ z$t | tst| } | jjp dd W S ttttfk
|
rX } zt||W 5 d}~X Y nX dS )a]
|
(pyCMS) Gets the description for the given profile.
|
|
If ``profile`` isn't a valid CmsProfile object or filename to a profile, a
|
:exc:`PyCMSError` is raised.
|
|
If an error occurs while trying to obtain the description tag,
|
a :exc:`PyCMSError` is raised.
|
|
Use this function to obtain the information stored in the profile's
|
description tag.
|
|
:param profile: EITHER a valid CmsProfile object, OR a string of the
|
filename of an ICC profile.
|
:returns: A string containing the internal profile information stored in an
|
ICC tag.
|
:exception PyCMSError:
|
ry rz N) r/ r* r< r~ r rf r: rY ra r r r r ÚgetProfileDescription s
|
r c C sV z t | tst| } | jjW S ttttfk
|
rP } zt||W 5 d}~X Y nX dS )a£
|
(pyCMS) Gets the default intent name for the given profile.
|
|
If ``profile`` isn't a valid CmsProfile object or filename to a profile, a
|
:exc:`PyCMSError` is raised.
|
|
If an error occurs while trying to obtain the default intent, a
|
:exc:`PyCMSError` is raised.
|
|
Use this function to determine the default (and usually best optimized)
|
rendering intent for this profile. Most profiles support multiple
|
rendering intents, but are intended mostly for one type of conversion.
|
If you wish to use a different intent than returned, use
|
ImageCms.isIntentSupported() to verify it will work first.
|
|
:param profile: EITHER a valid CmsProfile object, OR a string of the
|
filename of an ICC profile.
|
:returns: Integer 0-3 specifying the default rendering intent for this
|
profile.
|
|
ImageCms.Intent.PERCEPTUAL = 0 (DEFAULT)
|
ImageCms.Intent.RELATIVE_COLORIMETRIC = 1
|
ImageCms.Intent.SATURATION = 2
|
ImageCms.Intent.ABSOLUTE_COLORIMETRIC = 3
|
|
see the pyCMS documentation for details on rendering intents and what
|
they do.
|
:exception PyCMSError:
|
N) r/ r* r< Zrendering_intentr rf r: rY ra r r r r ÚgetDefaultIntent£ s
|
|
r c C sj z0t | tst| } | j ||¡r(W dS W dS W n4 ttttfk
|
rd } zt||W 5 d}~X Y nX dS )a
|
(pyCMS) Checks if a given intent is supported.
|
|
Use this function to verify that you can use your desired
|
``intent`` with ``profile``, and that ``profile`` can be used for the
|
input/output/proof profile as you desire.
|
|
Some profiles are created specifically for one "direction", can cannot
|
be used for others. Some profiles can only be used for certain
|
rendering intents, so it's best to either verify this before trying
|
to create a transform with them (using this function), or catch the
|
potential :exc:`PyCMSError` that will occur if they don't
|
support the modes you select.
|
|
:param profile: EITHER a valid CmsProfile object, OR a string of the
|
filename of an ICC profile.
|
:param intent: Integer (0-3) specifying the rendering intent you wish to
|
use with this profile
|
|
ImageCms.Intent.PERCEPTUAL = 0 (DEFAULT)
|
ImageCms.Intent.RELATIVE_COLORIMETRIC = 1
|
ImageCms.Intent.SATURATION = 2
|
ImageCms.Intent.ABSOLUTE_COLORIMETRIC = 3
|
|
see the pyCMS documentation for details on rendering intents and what
|
they do.
|
:param direction: Integer specifying if the profile is to be used for
|
input, output, or proof
|
|
INPUT = 0 (or use ImageCms.Direction.INPUT)
|
OUTPUT = 1 (or use ImageCms.Direction.OUTPUT)
|
PROOF = 2 (or use ImageCms.Direction.PROOF)
|
|
:returns: 1 if the intent/direction are supported, -1 if they are not.
|
:exception PyCMSError:
|
r rs N) r/ r* r< Zis_intent_supportedr rf r: rY ra )r< rL Ú directionrk r r r ÚisIntentSupportedÊ s &
|
|
r c C s t tjtj ¡ d tjfS )z#
|
(pyCMS) Fetches versions.
|
r )ÚVERSIONr8 Zlittlecms_versionr1 ÚversionÚsplitr Ú __version__r r r r Úversionsý s r )N)F)rs )1r1 r r r] r Z
|
_deprecater r Ú ImportErrorÚexZ_utilr Z DESCRIPTIONr r8 r r r ÚFLAGSre ÚvaluesÚflagr/ rd r* ZImagePointHandlerrB r` Ú Exceptionra r rl rm rC r rE Z buildTransformFromOpenProfilesZ#buildProofTransformFromOpenProfilesrr rw r r
r r r r r r r r r r r Ú<module> s ?ì
|
|
0>
|
ù
|
`ú
|
Yø
|
q
|
5
|
1*( '3
|
