Allows you to get or set the current color space for the
Grayscale, RGB and CMYK colors are defined purely in terms of
the values of the XColor object. However more complex colors need
to be defined in the context of a separate color space.
The ColorOperatorType enumeration may take the following
- DeviceGray (i.e. grayscale)
- DeviceRGB (i.e. RGB)
- DeviceCMYK (i.e. CMYK)
- ColorSpace (i.e. a generic set of color components)
The actual color is defined in terms of the Components of the color. For grayscale, RGB
and CMYK there are one, three and four of these respectively. These
components are most commonly accessed using properties such as
Gray, Red, Green or Blue which express
the values in terms of integers (typically 0 to 255). However it is
ultimately the Components ranging from
0.0 to 1.0 which are provided as parameters to the PDF color
If you change the value of this property between DeviceGray,
DeviceRGB and DeviceCMYK, the current color will automatically be
converted to the indicated color space. However different color
spaces have fundamentally different properties and color
conversions can only ever be approximate. Changing to None or
ColorSpace will not change the number or values of the Components.
The integer values for the enumeration values DeviceGray,
DeviceRGB and DeviceCMYK are one, three and four respectively, so
that they match up with the number of color components in each of
these color spaces.
The ColorSpace enumeration value indicates a generic color with
a generic set of components. This type of color only makes sense
within the context of a specified color space such as a spot color
space. In this situation the parameters that are provided to the
PDF color operator are accessed directly using the Components of the color. In addition, for
pattern color spaces, there may also be a Name associated with the color.
Why is my ColorSpace an integer?
In older versions of ABCpdf the ColorSpace property was an
integer. So you might find code of this form.
theColor.ColorSpace = 3;
theColor.ColorSpace = 3
In Version 10 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.
theColor.ColorSpace = ColorOperatorType.DeviceRGB;
theColor.ColorSpace = ColorOperatorType.DeviceRGB
The old values of the integers match up with the new enumeration
values. So if you find code of this form:
theColor.ColorSpace = anInteger;
theColor.ColorSpace = anInteger
You can just cast it to the correct type.
theColor.ColorSpace = (ColorOperatorType)anInteger;
theColor.ColorSpace = CType(anInteger, ColorOperatorType)
int n = theColor.ColorSpace;
Dim n As Integer = theColor.ColorSpace
You can again cast it to the correct type.
int n = (int)theColor.ColorSpace;
Dim n As Integer = CInt(theColor.ColorSpace)