Converts the image from one color space to another.
Calling this method results in the pixels within the PixMap
image being mapped from the current color space to the new color
space. The new ColorSpace is then assigned to
the PixMap and (if it is not already there) added to the PixMap
Colors can only be sensibly mapped from one color space to
another if we know something about the characteristics of the color
space. If your color spaces do not contain this information (e.g.
if they are device color spaces) then ABCpdf will use a default
An exception will be thrown if the operation is not possible.
This may happen if the PixMap is not in an ObjectSoup or if the
ColorSpace object is in some way invalid.
If the ImageMask
property is true the image has no color space and is implicitly
black and white. Image masks cannot be anything other than black
and white so trying to convert an image mask to another color space
will result in an exception being raised.
The rendering intent determines how out of gamut colors are
handled. For full details see the
After the PixMap has been Recolored it is no longer compressed
and will have a BitsPerComponent of
eight or sixteen. You may wish to compress it using the StreamObject.Compress