Home | History | Annotate | Download | only in src
      1 #ifndef QCMS_H
      2 #define QCMS_H
      3 
      4 #ifdef  __cplusplus
      5 extern "C" {
      6 #endif
      7 
      8 /* if we've already got an ICC_H header we can ignore the following */
      9 #ifndef ICC_H
     10 /* icc34 defines */
     11 
     12 /*****************************************************************
     13  Copyright (c) 1994-1996 SunSoft, Inc.
     14 
     15                     Rights Reserved
     16 
     17 Permission is hereby granted, free of charge, to any person
     18 obtaining a copy of this software and associated documentation
     19 files (the "Software"), to deal in the Software without restrict-
     20 ion, including without limitation the rights to use, copy, modify,
     21 merge, publish distribute, sublicense, and/or sell copies of the
     22 Software, and to permit persons to whom the Software is furnished
     23 to do so, subject to the following conditions:
     24 
     25 The above copyright notice and this permission notice shall be
     26 included in all copies or substantial portions of the Software.
     27 
     28 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
     29 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
     30 OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-
     31 INFRINGEMENT.  IN NO EVENT SHALL SUNSOFT, INC. OR ITS PARENT
     32 COMPANY BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
     33 WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
     34 FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
     35 OTHER DEALINGS IN THE SOFTWARE.
     36 
     37 Except as contained in this notice, the name of SunSoft, Inc.
     38 shall not be used in advertising or otherwise to promote the
     39 sale, use or other dealings in this Software without written
     40 authorization from SunSoft Inc.
     41 ******************************************************************/
     42 
     43 /*
     44  * QCMS, in general, is not threadsafe. However, it should be safe to create
     45  * profile and transformation objects on different threads, so long as you
     46  * don't use the same objects on different threads at the same time.
     47  */
     48 
     49 /*
     50  * Color Space Signatures
     51  * Note that only icSigXYZData and icSigLabData are valid
     52  * Profile Connection Spaces (PCSs)
     53  */
     54 typedef enum {
     55     icSigXYZData                        = 0x58595A20L,  /* 'XYZ ' */
     56     icSigLabData                        = 0x4C616220L,  /* 'Lab ' */
     57     icSigLuvData                        = 0x4C757620L,  /* 'Luv ' */
     58     icSigYCbCrData                      = 0x59436272L,  /* 'YCbr' */
     59     icSigYxyData                        = 0x59787920L,  /* 'Yxy ' */
     60     icSigRgbData                        = 0x52474220L,  /* 'RGB ' */
     61     icSigGrayData                       = 0x47524159L,  /* 'GRAY' */
     62     icSigHsvData                        = 0x48535620L,  /* 'HSV ' */
     63     icSigHlsData                        = 0x484C5320L,  /* 'HLS ' */
     64     icSigCmykData                       = 0x434D594BL,  /* 'CMYK' */
     65     icSigCmyData                        = 0x434D5920L,  /* 'CMY ' */
     66     icSig2colorData                     = 0x32434C52L,  /* '2CLR' */
     67     icSig3colorData                     = 0x33434C52L,  /* '3CLR' */
     68     icSig4colorData                     = 0x34434C52L,  /* '4CLR' */
     69     icSig5colorData                     = 0x35434C52L,  /* '5CLR' */
     70     icSig6colorData                     = 0x36434C52L,  /* '6CLR' */
     71     icSig7colorData                     = 0x37434C52L,  /* '7CLR' */
     72     icSig8colorData                     = 0x38434C52L,  /* '8CLR' */
     73     icSig9colorData                     = 0x39434C52L,  /* '9CLR' */
     74     icSig10colorData                    = 0x41434C52L,  /* 'ACLR' */
     75     icSig11colorData                    = 0x42434C52L,  /* 'BCLR' */
     76     icSig12colorData                    = 0x43434C52L,  /* 'CCLR' */
     77     icSig13colorData                    = 0x44434C52L,  /* 'DCLR' */
     78     icSig14colorData                    = 0x45434C52L,  /* 'ECLR' */
     79     icSig15colorData                    = 0x46434C52L,  /* 'FCLR' */
     80     icMaxEnumData                       = 0xFFFFFFFFL
     81 } icColorSpaceSignature;
     82 #endif
     83 
     84 #include <stdio.h>
     85 
     86 typedef int qcms_bool;
     87 
     88 struct _qcms_transform;
     89 typedef struct _qcms_transform qcms_transform;
     90 
     91 struct _qcms_profile;
     92 typedef struct _qcms_profile qcms_profile;
     93 
     94 /* these values match the Rendering Intent values from the ICC spec */
     95 typedef enum {
     96 	QCMS_INTENT_DEFAULT = 0,
     97 	QCMS_INTENT_PERCEPTUAL = 0,
     98 	QCMS_INTENT_RELATIVE_COLORIMETRIC = 1,
     99 	QCMS_INTENT_SATURATION = 2,
    100 	QCMS_INTENT_ABSOLUTE_COLORIMETRIC = 3
    101 } qcms_intent;
    102 
    103 //XXX: I don't really like the _DATA_ prefix
    104 typedef enum {
    105 	QCMS_DATA_RGB_8,
    106 	QCMS_DATA_RGBA_8,
    107 	QCMS_DATA_GRAY_8,
    108 	QCMS_DATA_GRAYA_8
    109 } qcms_data_type;
    110 
    111 /* Format of the output data for qcms_transform_data_type() */
    112 typedef enum {
    113 	QCMS_OUTPUT_RGBX,
    114 	QCMS_OUTPUT_BGRX
    115 } qcms_output_type;
    116 
    117 /* the names for the following two types are sort of ugly */
    118 typedef struct
    119 {
    120 	double x;
    121 	double y;
    122 	double Y;
    123 } qcms_CIE_xyY;
    124 
    125 typedef struct
    126 {
    127 	qcms_CIE_xyY red;
    128 	qcms_CIE_xyY green;
    129 	qcms_CIE_xyY blue;
    130 } qcms_CIE_xyYTRIPLE;
    131 
    132 qcms_profile* qcms_profile_create_rgb_with_gamma(
    133 		qcms_CIE_xyY white_point,
    134 		qcms_CIE_xyYTRIPLE primaries,
    135 		float gamma);
    136 
    137 qcms_profile* qcms_profile_from_memory(const void *mem, size_t size);
    138 
    139 qcms_profile* qcms_profile_from_file(FILE *file);
    140 qcms_profile* qcms_profile_from_path(const char *path);
    141 #ifdef _WIN32
    142 qcms_profile* qcms_profile_from_unicode_path(const wchar_t *path);
    143 #endif
    144 qcms_profile* qcms_profile_sRGB(void);
    145 void qcms_profile_release(qcms_profile *profile);
    146 
    147 qcms_bool qcms_profile_is_bogus(qcms_profile *profile);
    148 qcms_intent qcms_profile_get_rendering_intent(qcms_profile *profile);
    149 icColorSpaceSignature qcms_profile_get_color_space(qcms_profile *profile);
    150 
    151 void qcms_profile_precache_output_transform(qcms_profile *profile);
    152 
    153 qcms_transform* qcms_transform_create(
    154 		qcms_profile *in, qcms_data_type in_type,
    155 		qcms_profile* out, qcms_data_type out_type,
    156 		qcms_intent intent);
    157 
    158 void qcms_transform_release(qcms_transform *);
    159 
    160 void qcms_transform_data(qcms_transform *transform, void *src, void *dest, size_t length);
    161 void qcms_transform_data_type(qcms_transform *transform, void *src, void *dest, size_t length, qcms_output_type type);
    162 
    163 void qcms_enable_iccv4();
    164 
    165 #ifdef  __cplusplus
    166 }
    167 #endif
    168 
    169 #endif
    170