Adds an ICC based color space to the document.

[C#]
virtual int AddColorSpaceSpot(string name, string color)

[Visual Basic]
Function AddColorSpaceSpot(ByVal name As String, ByVal color As String) As Integer

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 use.

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 output.

In this example we define a colorant called Gold and add some text using varying amounts of our colorant.

[C#]
Doc theDoc = new Doc();
theDoc.Rect.Inset(20, 20);
theDoc.FontSize = 300;
theDoc.ColorSpace = theDoc.AddColorSpaceSpot("GOLD", "0 0 100 0");
for (int i = 1; i <= 10; i++) {
  theDoc.Color.Gray = 255 / i;
  theDoc.AddText(theDoc.Color.Gray.ToString());
  theDoc.Rect.Move(25, -50);
}
theDoc.Save(Server.MapPath("docaddcolorspacespot.pdf"));
theDoc.Clear();

[Visual Basic]
Dim theDoc As Doc = New Doc()
theDoc.Rect.Inset(20, 20)
theDoc.FontSize = 300
theDoc.ColorSpace = theDoc.AddColorSpaceSpot("GOLD", "0 0 100 0")
Dim i As Integer
For i = 1 To 10
  theDoc.Color.Gray = 255 / i
  theDoc.AddText(theDoc.Color.Gray.ToString())
  theDoc.Rect.Move(25, -50)
Next
theDoc.Save(Server.MapPath("docaddcolorspacespot.pdf"))
theDoc.Clear()


docaddcolorspacespot.pdf