Untitled

SUBMITTED BY: Guest

DATE: Nov. 25, 2014, 7:18 a.m.

FORMAT: Text only

SIZE: 11.6 kB

Raw Download

HITS: 48365

Report
  1. /* CoreGraphics - CGColorSpace.h
  2. Copyright (c) 1999-2013 Apple Inc.
  3. All rights reserved. */
  5. #ifndef CGCOLORSPACE_H_
  6. #define CGCOLORSPACE_H_
  8. typedef struct CGColorSpace *CGColorSpaceRef;
  10. #include <CoreGraphics/CGBase.h>
  11. #include <CoreGraphics/CGDataProvider.h>
  13. CF_IMPLICIT_BRIDGING_ENABLED
  15. /* Color rendering intents. */
  17. enum CGColorRenderingIntent {
  18. kCGRenderingIntentDefault,
  19. kCGRenderingIntentAbsoluteColorimetric,
  20. kCGRenderingIntentRelativeColorimetric,
  21. kCGRenderingIntentPerceptual,
  22. kCGRenderingIntentSaturation
  23. };
  24. typedef enum CGColorRenderingIntent CGColorRenderingIntent;
  26. /* The model of a color space. */
  28. enum CGColorSpaceModel {
  29. kCGColorSpaceModelUnknown = -1,
  30. kCGColorSpaceModelMonochrome,
  31. kCGColorSpaceModelRGB,
  32. kCGColorSpaceModelCMYK,
  33. kCGColorSpaceModelLab,
  34. kCGColorSpaceModelDeviceN,
  35. kCGColorSpaceModelIndexed,
  36. kCGColorSpaceModelPattern
  37. };
  38. typedef enum CGColorSpaceModel CGColorSpaceModel;
  40. /* The name of the "Generic" gray color space. */
  42. CG_EXTERN const CFStringRef kCGColorSpaceGenericGray
  43. CG_AVAILABLE_STARTING(__MAC_10_4, __IPHONE_NA);
  45. /* The name of the "Generic" RGB color space. */
  47. CG_EXTERN const CFStringRef kCGColorSpaceGenericRGB
  48. CG_AVAILABLE_STARTING(__MAC_10_4, __IPHONE_NA);
  50. /* The name of the "Generic" CMYK color space. */
  52. CG_EXTERN const CFStringRef kCGColorSpaceGenericCMYK
  53. CG_AVAILABLE_STARTING(__MAC_10_4, __IPHONE_NA);
  55. /* The name of the "Generic" linear RGB color space. This is the same as
  56. `kCGColorSpaceGenericRGB' but with a 1.0 gamma. */
  58. CG_EXTERN const CFStringRef kCGColorSpaceGenericRGBLinear
  59. CG_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_NA);
  61. /* The name of the Adobe RGB (1998) color space. For more information, see
  62. "Adobe RGB (1998) Color Image Encoding", Version 2005-05, Adobe Systems
  63. Inc. (http://www.adobe.com). */
  65. CG_EXTERN const CFStringRef kCGColorSpaceAdobeRGB1998
  66. CG_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_NA);
  68. /* The name of the sRGB color space. The capitalization in the name, while
  69. strictly inaccurate, avoids interpretational ambiguity. For more
  70. information, see IEC 61966-2-1 (1999-10): "Multimedia systems and
  71. equipment - Colour measurement and management - Part 2-1: Colour
  72. management - Default RGB colour space - sRGB". */
  74. CG_EXTERN const CFStringRef kCGColorSpaceSRGB
  75. CG_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_NA);
  77. /* The "Generic" gray color space with γ = 2.2. */
  79. CG_EXTERN const CFStringRef kCGColorSpaceGenericGrayGamma2_2
  80. CG_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_NA);
  82. /* Create a DeviceGray color space. */
  84. CG_EXTERN CGColorSpaceRef CGColorSpaceCreateDeviceGray(void)
  85. CG_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_2_0);
  87. /* Create a DeviceRGB color space. */
  89. CG_EXTERN CGColorSpaceRef CGColorSpaceCreateDeviceRGB(void)
  90. CG_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_2_0);
  92. /* Create a DeviceCMYK color space. */
  94. CG_EXTERN CGColorSpaceRef CGColorSpaceCreateDeviceCMYK(void)
  95. CG_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_2_0);
  97. /* Create a calibrated gray color space. `whitePoint' is an array of 3
  98. numbers specifying the tristimulus value, in the CIE 1931 XYZ-space, of
  99. the diffuse white point. `blackPoint' is an array of 3 numbers specifying
  100. the tristimulus value, in CIE 1931 XYZ-space, of the diffuse black point.
  101. `gamma' defines the gamma for the gray component. */
  103. CG_EXTERN CGColorSpaceRef CGColorSpaceCreateCalibratedGray(const CGFloat
  104. whitePoint[3], const CGFloat blackPoint[3], CGFloat gamma)
  105. CG_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_2_0);
  107. /* Create a calibrated RGB color space. `whitePoint' is an array of 3
  108. numbers specifying the tristimulus value, in the CIE 1931 XYZ-space, of
  109. the diffuse white point. `blackPoint' is an array of 3 numbers specifying
  110. the tristimulus value, in CIE 1931 XYZ-space, of the diffuse black point.
  111. `gamma' is an array of 3 numbers specifying the gamma for the red, green,
  112. and blue components of the color space. `matrix' is an array of 9 numbers
  113. specifying the linear interpretation of the gamma-modified RGB values of
  114. the color space with respect to the final XYZ representation. */
  116. CG_EXTERN CGColorSpaceRef CGColorSpaceCreateCalibratedRGB(const CGFloat
  117. whitePoint[3], const CGFloat blackPoint[3], const CGFloat gamma[3],
  118. const CGFloat matrix[9]) CG_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_2_0);
  120. /* Create an L*a*b* color space. `whitePoint' is an array of 3 numbers
  121. specifying the tristimulus value, in the CIE 1931 XYZ-space, of the
  122. diffuse white point. `blackPoint' is an array of 3 numbers specifying the
  123. tristimulus value, in CIE 1931 XYZ-space, of the diffuse black point.
  124. `range' is an array of four numbers specifying the range of valid values
  125. for the a* and b* components of the color space. */
  127. CG_EXTERN CGColorSpaceRef CGColorSpaceCreateLab(const CGFloat whitePoint[3],
  128. const CGFloat blackPoint[3], const CGFloat range[4])
  129. CG_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_2_0);
  131. /* Create an ICC-based color space using the ICC profile specified by
  132. `data'. */
  134. CG_EXTERN CGColorSpaceRef CGColorSpaceCreateWithICCProfile(CFDataRef data)
  135. CG_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
  137. /* Create an ICC-based color space. `nComponents' specifies the number of
  138. color components in the color space defined by the ICC profile data. This
  139. must match the number of components actually in the ICC profile, and must
  140. be 1, 3, or 4. `range' is an array of 2*nComponents numbers specifying
  141. the minimum and maximum valid values of the corresponding color
  142. components, so that for color component k, range[2*k] <= c[k] <=
  143. range[2*k+1], where c[k] is the k'th color component. `profile' is a data
  144. provider specifying the ICC profile. `alternate' specifies an alternate
  145. color space to be used in case the ICC profile is not supported. It must
  146. have `nComponents' color components. If `alternate' is NULL, then the
  147. color space used will be DeviceGray, DeviceRGB, or DeviceCMYK, depending
  148. on whether `nComponents' is 1, 3, or 4, respectively. */
  150. CG_EXTERN CGColorSpaceRef CGColorSpaceCreateICCBased(size_t nComponents,
  151. const CGFloat *range, CGDataProviderRef profile, CGColorSpaceRef alternate)
  152. CG_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_2_0);
  154. /* Create an indexed color space. A sample value in an indexed color space
  155. is treated as an index into the color table of the color space. `base'
  156. specifies the base color space in which the values in the color table are
  157. to be interpreted. `lastIndex' is an integer which specifies the maximum
  158. valid index value; it must be less than or equal to 255. `colorTable' is
  159. an array of m * (lastIndex + 1) bytes, where m is the number of color
  160. components in the base color space. Each byte is an unsigned integer in
  161. the range 0 to 255 that is scaled to the range of the corresponding color
  162. component in the base color space. */
  164. CG_EXTERN CGColorSpaceRef CGColorSpaceCreateIndexed(CGColorSpaceRef baseSpace,
  165. size_t lastIndex, const unsigned char *colorTable)
  166. CG_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_2_0);
  168. /* Create a pattern color space. `baseSpace' is the underlying color space
  169. of the pattern color space. For colored patterns, `baseSpace' should be
  170. NULL; for uncolored patterns, `baseSpace' specifies the color space of
  171. colors which will be painted through the pattern. */
  173. CG_EXTERN CGColorSpaceRef CGColorSpaceCreatePattern(CGColorSpaceRef baseSpace)
  174. CG_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_2_0);
  176. /* Create a color space using `ref', a platform-specific color space
  177. reference. For MacOS X, `ref' should be a CMProfileRef. */
  179. CG_EXTERN CGColorSpaceRef
  180. CGColorSpaceCreateWithPlatformColorSpace(const void *ref)
  181. CG_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA);
  183. /* Create a color space using `name' as the identifier for the color
  184. space. */
  186. CG_EXTERN CGColorSpaceRef CGColorSpaceCreateWithName(CFStringRef name)
  187. CG_AVAILABLE_STARTING(__MAC_10_2, __IPHONE_2_0);
  189. /* Equivalent to `CFRetain(space)', except it doesn't crash (as CFRetain
  190. does) if `space' is NULL. */
  192. CG_EXTERN CGColorSpaceRef CGColorSpaceRetain(CGColorSpaceRef space)
  193. CG_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_2_0);
  195. /* Equivalent to `CFRelease(space)', except it doesn't crash (as CFRelease
  196. does) if `space' is NULL. */
  198. CG_EXTERN void CGColorSpaceRelease(CGColorSpaceRef space)
  199. CG_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_2_0);
  201. /* Return the name used to create the color space `space', or NULL if the
  202. color space was not created using `CGColorSpaceCreateWithName'. */
  204. CG_EXTERN CFStringRef CGColorSpaceCopyName(CGColorSpaceRef space)
  205. CG_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_NA);
  207. /* Return the CFTypeID for CGColorSpaces. */
  209. CG_EXTERN CFTypeID CGColorSpaceGetTypeID(void)
  210. CG_AVAILABLE_STARTING(__MAC_10_2, __IPHONE_2_0);
  212. /* Return the number of color components in the color space `space'. */
  214. CG_EXTERN size_t CGColorSpaceGetNumberOfComponents(CGColorSpaceRef space)
  215. CG_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_2_0);
  217. /* Return the color space model of `space'. */
  219. CG_EXTERN CGColorSpaceModel CGColorSpaceGetModel(CGColorSpaceRef space)
  220. CG_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
  222. /* Return the base color space of `space' if `space' is a pattern or indexed
  223. color space; otherwise, return NULL. To determine whether a color space
  224. is an indexed or pattern color space, use `CGColorSpaceGetModel'. */
  226. CG_EXTERN CGColorSpaceRef CGColorSpaceGetBaseColorSpace(CGColorSpaceRef space)
  227. CG_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
  229. /* Return the number of entries in the color table of `space' if `space' is
  230. an indexed color space; otherwise, return 0. To determine whether a color
  231. space is an indexed color space, use `CGColorSpaceGetModel'. */
  233. CG_EXTERN size_t CGColorSpaceGetColorTableCount(CGColorSpaceRef space)
  234. CG_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
  236. /* Copy the entries in the color table of `space' to `table' if `space' is
  237. an indexed color space; otherwise, do nothing. The array pointed to by
  238. `table' should be at least as large as the number of entries in the color
  239. table; the returned data is in the same format as that passed to
  240. `CGColorSpaceCreateIndexed'. To determine whether a color space is an
  241. indexed color space, use `CGColorSpaceGetModel'. */
  243. CG_EXTERN void CGColorSpaceGetColorTable(CGColorSpaceRef space, uint8_t *table)
  244. CG_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
  246. /* Return a copy of the ICC profile of `space', or NULL if the color space
  247. doesn't have an ICC profile. */
  249. CG_EXTERN CFDataRef CGColorSpaceCopyICCProfile(CGColorSpaceRef space)
  250. CG_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_6_0);
  252. CF_IMPLICIT_BRIDGING_DISABLED
  254. #endif /* CGCOLORSPACE_H_ */
comments powered by Disqus