Type Default Value Read Only Description

[Visual Basic]
 XRendering ColorSpaceType.Rgb No The name of the output color space.




The name of the output color space.

The XRendering.ColorSpaceType enumeration may take the following values:

  • Rgb - red, green and blue
  • Gray - grayscale
  • Cmyk - cyan, magenta, yellow and black
  • Lab - a device independent color space
  • Indexed - indexed RGB; see the Palette property

The following table shows the supported color spaces and valid BitsPerChannel for each output format:

Output format RGB Gray CMYK Lab Indexed
TIFF 8, 16 1, 8, 16 8, 16 8, 16  
PSD (Photoshop) 8, 16 8, 16 8, 16 8, 16  
JP2 (JPEG 2000) 8, 16 8, 16 8, 16    
JPG 8 8 8    
BMP 8 8     8
PNG 8 8, 16     8
GIF 8 (8 bit indexed) 8     8


Why is my ColorSpace a string?

In older versions of ABCpdf the ColorSpace property was a string. So you might find code of this form.


theDoc.Rendering.ColorSpace = "CMYK";

In Version 8 the ColorSpace property was changed to a true enumeration. This is a safer way of coding as it allows the compiler to ensure that the values you are using are valid. Your new code should look like this.


theDoc.Rendering.ColorSpace = XRendering.ColorSpaceType.Cmyk;

The names of the items in the XRendering.ColorSpaceType enumeration are the same as the values of the strings used in previous versions. So changing your code should be a simple search and replace operation.

Note that the enumeration is the XRendering.ColorSpace indicating the output color space for rendering. There is a different ColorSpace enumeration used for the content of objects inside a PDF document. The two are not the same.

Alternatively if you need to convert between enumerations and strings automatically you can do so. To convert from a string to an enumeration use the following code.


XRendering.ColorSpaceType csType = (XRendering.ColorSpaceType)Enum.Parse(typeof(XRendering.ColorSpaceType), csString, true);

To convert from an enumeration to a string use the following code.


string csString = csType.ToString("G");




The following example shows the effect that this parameter has on PDF rendering.


using (Doc doc = new Doc()) {   doc.AddImage(Server.MapPath("../mypics/Shuttle.jpg"));   doc.Rect.String = doc.MediaBox.String;   // Render document in Gray colorspace   doc.Rendering.ColorSpace = XRendering.ColorSpaceType.Gray;   doc.Rendering.DotsPerInch = 36;   doc.Rendering.Save(Server.MapPath("RenderingColorSpace.png")); }