Adds a separation color space to the document returning the ID
of the newly added object.
Separation color spaces allow you to add spot colors or isolate
the use of individual colorants. A separation color space
represents a particular colorant and allows you to specify the
amount of that colorant that is applied.
For example you might define a separation color space called
Gold with a display representation of CMYK yellow. You might then
draw some text with different amounts of Gold. When viewing the
output on a standard monitor the display representation of the
color would be used. However when printed - using appropriate
software and an appropriate printer - the name of the color might
be used to select a gold colored ink.
The current color space is defined by the ColorSpace property. The
current color is defined by the Color property. Because separations
represent a single value property you should use single component -
grayscale - colors to specify the amount of spot colorant to
There are two special color spaces:
'All' refers collectively to all colorants on an output device.
It can be useful for printing registration marks.
'None' indicates no colorant and will never produce any visible