Adds an ICC based color space to the document.

[C#]
virtual int AddColorSpaceFile(string path)

[Visual Basic]
Overridable Function AddColorSpaceFile(path As String) As Integer

may throw Exception()

Adds an ICC based color space to the document returning the ID of the newly added object.

ICC Color Spaces allow the precise representation of colors in a device independent way. The ICC format is defined by the International Color Consortium (http://www.color.org/).

ABCpdf will allow you to add ICC profiles in the Gray, RGB, CMYK or Lab color spaces. This method will throw an error if the file is inaccessible or invalid.

The current color space is defined by the ColorSpace property. The current color is defined by the Color property. The ColorSpace is used when the Color is of a matching type. If the color type does not match then the default - device - color space is used.

For example you add a CMYK color space and assign it to the ColorSpace property. All CMYK Colors you use will be defined in terms of this color space. However RGB and Grayscale colors will continue to be defined in terms of the default - device - color spaces.

In this example we add some CMYK text defined in an ICC based color space.

[C#]
Doc theDoc = new Doc();
string theText = "Gallia est omnis divisa in partes tres, quarum unam incolunt Belgae, aliam Aquitani, tertiam qui ipsorum lingua Celtae, nostra Galli appellantur.";
theDoc.Rect.Inset(20, 40);
theDoc.FontSize = 96;
string thePath = Server.MapPath("../mypics/cmyk.icc");
theDoc.ColorSpace = theDoc.AddColorSpaceFile(thePath);
theDoc.Color.String = "200 20 20 20";
theDoc.AddText(theText);
theDoc.Save(Server.MapPath("docaddcolorspacefile.pdf"));
theDoc.Clear();

[Visual Basic]
Dim theDoc As Doc = New Doc()
Dim theText As String = "Gallia est omnis divisa in partes tres, quarum unam incolunt Belgae, aliam Aquitani, tertiam qui ipsorum lingua Celtae, nostra Galli appellantur."
theDoc.Rect.Inset(20, 40)
theDoc.FontSize = 96
Dim thePath As String = Server.MapPath("../mypics/cmyk.icc")
theDoc.ColorSpace = theDoc.AddColorSpaceFile(thePath)
theDoc.Color.String = "200 20 20 20"
theDoc.AddText(theText)
theDoc.Save(Server.MapPath("docaddcolorspacefile.pdf"))
theDoc.Clear()


docaddcolorspacefile.pdf