/*
File: CGColorSpace.h
Contains: CoreGraphics color space
Version: QuickTime 7.3
Copyright: (c) 2007 (c) 2000-2001 by Apple Computer, Inc., all rights reserved.
Bugs?: For bug reports, consult the following page on
the World Wide Web:
http://developer.apple.com/bugreporter/
*/
#ifndef CGCOLORSPACE_H_
#define CGCOLORSPACE_H_
#ifndef __CGBASE__
#include <CGBase.h>
#endif
#ifndef __CGDATAPROVIDER__
#include <CGDataProvider.h>
#endif
#if PRAGMA_ONCE
#pragma once
#endif
#ifdef __cplusplus
extern "C" {
#endif
#if PRAGMA_IMPORT
#pragma import on
#endif
#if PRAGMA_ENUM_ALWAYSINT
#if defined(__fourbyteints__) && !__fourbyteints__
#define __CGCOLORSPACE__RESTORE_TWOBYTEINTS
#pragma fourbyteints on
#endif
#pragma enumsalwaysint on
#elif PRAGMA_ENUM_OPTIONS
#pragma option enum=int
#elif PRAGMA_ENUM_PACK
#if __option(pack_enums)
#define __CGCOLORSPACE__RESTORE_PACKED_ENUMS
#pragma options(!pack_enums)
#endif
#endif
typedef struct CGColorSpace* CGColorSpaceRef;
enum CGColorRenderingIntent {
kCGRenderingIntentDefault = 0,
kCGRenderingIntentAbsoluteColorimetric = 1,
kCGRenderingIntentRelativeColorimetric = 2,
kCGRenderingIntentPerceptual = 3,
kCGRenderingIntentSaturation = 4
};
typedef enum CGColorRenderingIntent CGColorRenderingIntent;
/** Device-dependent color spaces. **/
/* Create a DeviceGray colorspace. */
/*
* CGColorSpaceCreateDeviceGray()
*
* Availability:
* Non-Carbon CFM: not available
* CarbonLib: not available
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( CGColorSpaceRef )
CGColorSpaceCreateDeviceGray(void);
/* Create a DeviceRGB colorspace. */
/*
* CGColorSpaceCreateDeviceRGB()
*
* Availability:
* Non-Carbon CFM: not available
* CarbonLib: not available
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( CGColorSpaceRef )
CGColorSpaceCreateDeviceRGB(void);
/* Create a DeviceCMYK colorspace. */
/*
* CGColorSpaceCreateDeviceCMYK()
*
* Availability:
* Non-Carbon CFM: not available
* CarbonLib: not available
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( CGColorSpaceRef )
CGColorSpaceCreateDeviceCMYK(void);
/** Device-independent color spaces. **/
/* Create a calibrated gray colorspace. `whitePoint' is an array of 3
* numbers specifying the tristimulus value, in the CIE 1931 XYZ-space, of
* the diffuse white point. `blackPoint' is an array of 3 numbers
* specifying the tristimulus value, in CIE 1931 XYZ-space, of the diffuse
* black point. `gamma' defines the gamma for the gray component. */
/*
* CGColorSpaceCreateCalibratedGray()
*
* Availability:
* Non-Carbon CFM: not available
* CarbonLib: not available
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( CGColorSpaceRef )
CGColorSpaceCreateCalibratedGray(
const float whitePoint[3],
const float blackPoint[3],
float gamma);
/* Create a calibrated RGB colorspace. `whitePoint' is an array of 3
* numbers specifying the tristimulus value, in the CIE 1931 XYZ-space, of
* the diffuse white point. `blackPoint' is an array of 3 numbers
* specifying the tristimulus value, in CIE 1931 XYZ-space, of the diffuse
* black point. `gamma' is an array of 3 numbers specifying the gamma for
* the red, green, and blue components of the color space. `matrix' is an
* array of 9 numbers specifying the linear interpretation of the
* gamma-modified RGB values of the colorspace with respect to the final
* XYZ representation. */
/*
* CGColorSpaceCreateCalibratedRGB()
*
* Availability:
* Non-Carbon CFM: not available
* CarbonLib: not available
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( CGColorSpaceRef )
CGColorSpaceCreateCalibratedRGB(
const float whitePoint[3],
const float blackPoint[3],
const float gamma[3],
const float matrix[9]);
/* Create an L*a*b* colorspace. `whitePoint' is an array of 3 numbers
* specifying the tristimulus value, in the CIE 1931 XYZ-space, of the
* diffuse white point. `blackPoint' is an array of 3 numbers specifying
* the tristimulus value, in CIE 1931 XYZ-space, of the diffuse black
* point. `range' is an array of four numbers specifying the range of valid
* values for the a* and b* components of the color space. */
/*
* CGColorSpaceCreateLab()
*
* Availability:
* Non-Carbon CFM: not available
* CarbonLib: not available
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( CGColorSpaceRef )
CGColorSpaceCreateLab(
const float whitePoint[3],
const float blackPoint[3],
const float range[4]);
/* Create an ICC-based colorspace. `nComponents' specifies the number of
* color components in the color space defined by the ICC profile data.
* This must match the number of components actually in the ICC profile,
* and must be 1, 3, or 4. `range' is an array of 2*nComponents numbers
* specifying the minimum and maximum valid values of the corresponding
* color components, so that for color component k, range[2*k] <= c[k] <=
* range[2*k+1], where c[k] is the k'th color component. `profile' is a
* data provider specifying the ICC profile. `alternate' specifies an
* alternate colorspace to be used in case the ICC profile is not
* supported. It must have `nComponents' color components. If `alternate'
* is NULL, then the color space used will be DeviceGray, DeviceRGB, or
* DeviceCMYK, depending on whether `nComponents' is 1, 3, or 4,
* respectively. */
/*
* CGColorSpaceCreateICCBased()
*
* Availability:
* Non-Carbon CFM: not available
* CarbonLib: not available
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( CGColorSpaceRef )
CGColorSpaceCreateICCBased(
size_t nComponents,
const float * range,
CGDataProviderRef profile,
CGColorSpaceRef alternateSpace);
/** Special colorspaces. **/
/* Create an indexed colorspace. A sample value in an indexed color space
* is treated as an index into the color table of the color space. `base'
* specifies the base color space in which the values in the color table
* are to be interpreted. `lastIndex' is an integer which specifies the
* maximum valid index value; it must be less than or equal to 255.
* `colorTable' is an array of m * (lastIndex + 1) bytes, where m is
* the number of color components in the base color space. Each byte
* is an unsigned integer in the range 0 to 255 that is scaled to the
* range of the corresponding color component in the base color space. */
/*
* CGColorSpaceCreateIndexed()
*
* Availability:
* Non-Carbon CFM: not available
* CarbonLib: not available
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( CGColorSpaceRef )
CGColorSpaceCreateIndexed(
CGColorSpaceRef baseSpace,
size_t lastIndex,
const unsigned char * colorTable);
/* Create a pattern colorspace. `baseSpace' is the underlying colorspace of
* the pattern colorspace. For colored patterns, `baseSpace' should be
* NULL; for uncolored patterns, `baseSpace' specifies the colorspace of
* colors which will be painted through the pattern. */
/*
* CGColorSpaceCreatePattern()
*
* Availability:
* Non-Carbon CFM: not available
* CarbonLib: not available
* Mac OS X: in version 10.1 and later
*/
EXTERN_API_C( CGColorSpaceRef )
CGColorSpaceCreatePattern(CGColorSpaceRef baseSpace);
/* Create a CGColorSpace using `platformColorSpaceReference', a pointer to
* a platform-specific color space reference. For MacOS X,
* `platformColorSpaceReference' should be a pointer to a CMProfileRef. */
/*
* CGColorSpaceCreateWithPlatformColorSpace()
*
* Availability:
* Non-Carbon CFM: not available
* CarbonLib: not available
* Mac OS X: in version 10.1 and later
*/
EXTERN_API_C( CGColorSpaceRef )
CGColorSpaceCreateWithPlatformColorSpace(void * platformColorSpaceReference);
/** Colorspace information. **/
/* Return the number of color components supported by the colorspace `cs'. */
/*
* CGColorSpaceGetNumberOfComponents()
*
* Availability:
* Non-Carbon CFM: not available
* CarbonLib: not available
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( size_t )
CGColorSpaceGetNumberOfComponents(CGColorSpaceRef cs);
/** Retaining & releasing colorspaces. **/
/* Increment the retain count of `cs' and return it. All colorspaces are
* created with an initial retain count of 1. */
/*
* CGColorSpaceRetain()
*
* Availability:
* Non-Carbon CFM: not available
* CarbonLib: not available
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( CGColorSpaceRef )
CGColorSpaceRetain(CGColorSpaceRef cs);
/* Decrement the retain count of `cs'. If the retain count reaches 0, then
* release it and any associated resources. */
/*
* CGColorSpaceRelease()
*
* Availability:
* Non-Carbon CFM: not available
* CarbonLib: not available
* Mac OS X: in version 10.0 and later
*/
EXTERN_API_C( void )
CGColorSpaceRelease(CGColorSpaceRef cs);
#if PRAGMA_ENUM_ALWAYSINT
#pragma enumsalwaysint reset
#ifdef __CGCOLORSPACE__RESTORE_TWOBYTEINTS
#pragma fourbyteints off
#endif
#elif PRAGMA_ENUM_OPTIONS
#pragma option enum=reset
#elif defined(__CGCOLORSPACE__RESTORE_PACKED_ENUMS)
#pragma options(pack_enums)
#endif
#ifdef PRAGMA_IMPORT_OFF
#pragma import off
#elif PRAGMA_IMPORT
#pragma import reset
#endif
#ifdef __cplusplus
}
#endif
#endif /* CGCOLORSPACE_H_ */