AddSeparationColorA
Vector graphics, Color
Description
The trailing A denotes the ANSI (char) DLL entry point; the ActiveX/COM surface exposes only the Unicode form. Behaviour is identical to AddSeparationColor and string arguments are interpreted using the current SetAnsiMode code page
Adds a separation color to the document.
A separation color has a name and an equivalent color in the CMYK color space. If the document is viewed the CMYK color will be used. If the document is printed to an image setter a separation with the specified name will be generated.
The values of the color parameters range from 0 to 1, with 0 indicating 0% and 1 indicating 100% of the color.
Syntax
Delphi
Function DLAddSeparationColorA(InstanceID: Integer; ColorName: PAnsiChar; C, M, Y, K: Double; Options: Integer): Integer;DLL
int DLAddSeparationColorA(int InstanceID, const char * ColorName, double C, double M, double Y, double K, int Options);Parameters
| ColorName | The name of the separation color, for example "PANTONE 403 EC". This can be any name you want, but is usually set to the name of a specific spot color that your printing press will know what to do with. The cyan component of the color equivalent to the spot color |
|---|---|
| C | |
| M | The magenta component of the color equivalent to the spot color |
| Y | The yellow component of the color equivalent to the spot color |
| K | The black component of the color equivalent to the spot color |
| Options | This parameter is ignored and should be set to 0 |
Return values
| 0 | The separation color could not be added. The color name may already have been used. |
|---|---|
| 1 | The separation color was added successfully |