---
title: CMGetPS2ColorSpace
framework: Application Services
role: pseudoSymbol
platforms: []
path: applicationservices/colorsync_manager/1805191-cmgetps2colorspace
---

# CMGetPS2ColorSpace

Obtains color space element data in text format usable as the parameter to the PostScript `setColorSpace` operator, which characterizes the color space of subsequent graphics data. 

## Declaration

```occ
CMError CMGetPS2ColorSpace (
   CMProfileRef srcProf,
   UInt32 flags,
   CMFlattenUPP proc,
   void *refCon,
   Boolean *preferredCMMnotfound
);
```

## Parameters

- `srcProf`: A profile reference to the source profile that defines the data color space and identifies the preferred CMM.
- `flags`: If the value of `flags` is equal to `cmPS8bit`, the generated PostScript will utilize 8-bit encoding whenever possible to achieve higher data compaction. If the value of `flags` is not equal to `cmPS8bit`, the generated data will be 7-bit safe, in either ASCII or ASCII base-85 encoding.
- `proc`: A pointer to a callback flatten function to receive the PostScript data from the CMM. For information, see the function [doc://com.apple.documentation/documentation/applicationservices/cmflattenprocptr](applicationservices/cmflattenprocptr.md).
- `refCon`: An untyped pointer to arbitrary data supplied by your application. `CMGetPS2ColorSpace` passes this data in calls to your [doc://com.apple.documentation/documentation/applicationservices/cmflattenprocptr](applicationservices/cmflattenprocptr.md) function.
- `preferredCMMnotfound`: A pointer to a flag for whether the preferred CMM was found. On return, has the value `true` if the CMM corresponding to profile was not available or if it was unable to perform the function and the default CMM was used. Otherwise, has the value `false`.

## Return Value

A `CMError` value. See [Result Codes](../colorsync_manager.md).

## Overview

The `CMGetPS2ColorSpace` function obtains PostScript color space data from the source profile. The valid profile classes for the `CMGetPS2ColorSpace` function are display, input, and output profiles with at most four components.

To determine which profile elements to use to generate the PostScript color space data, the CMM:

- uses the PostScript `cmPS2CSATag`, if it exists
- otherwise, uses the multidimensional table tag (`cmAToB0`, `cmAToB1`, or `cmAToB2`), if it exists, for the rendering intent currently specified by the profile
- otherwise, uses the multidimensional table tag `cmAToB0`, if it exists
- otherwise, for display profiles only, uses the tristimulus tags (`cmRedColorantTag`, `cmGreenColorantTag`, `cmBlueColorantTag`) and the tonal curve tags (`cmRedTRCTag`, `cmGreenTRCTag`, and `cmBlueTRCTag`)

The CMM obtains the PostScript data from the profile and calls your low-level data transfer procedure passing the PostScript data to it. The CMM converts the data into a PostScript stream and calls your procedure as many times as necessary to transfer the data to it. 

Typically, the low-level data transfer function returns this data to the calling application or device driver to pass to a PostScript printer as an operand to the PostScript `setcolorspace` operator, which defines the color space of graphics data to follow. 

The `CMGetPS2ColorSpace` function is dispatched to the CMM component specified by the source profile. If the designated CMM is not available or the CMM does not implement this function, then the ColorSync Manager dispatches the function to the default CMM. 

## See Also

### Working With PostScript

- [CMGetPS2ColorRenderingIntent](1805196-cmgetps2colorrenderingintent.md)
- [CMGetPS2ColorRendering](1805202-cmgetps2colorrendering.md)
- [CMGetPS2ColorRenderingVMSize](1805206-cmgetps2colorrenderingvmsize.md)