Read colour image from file (in dipIO)
dip_Error dipio_ImageReadColour ( image, filename, photometric, format, addExtensions, recognised )
This function reads an image from a file and puts it in image. image must be allocated before calling this function. It works the same as ImageRead, except that, if the file contains a colour image, Colour2Gray is not called. The returned image has an extra dimension with colours (always the last dimension), and photometric is set to the colour space.
| Data type | Name | Description |
| dip_Image | image | Output image |
| dip_String | filename | File name |
| dipio_PhotometricInterpretation* | photometric | Photometric interpretation (==colour space) |
| dip_int | format | ID of file format |
| dip_Boolean | addExtensions | Add file format extensions to filename |
| dip_Boolean * | recognised | Pointer to boolean containing the file read status |
The enumerator dipio_PhotometricInterpretation contains the following constants:
| Name | Description |
| DIPIO_PHM_GREYVALUE | No colour information present; it's a grey-value image. |
| DIPIO_PHM_RGB | RGB image (the first three planes are red, green and blue) |
| DIPIO_PHM_RGB_NONLINEAR | Non-linear R'G'B' image (RGB channels to the power of 0.4) |
| DIPIO_PHM_CMY | CMY image (the first three planes are cyan, magenta and yellow) |
| DIPIO_PHM_CMYK | CMYK image (the first four planes are cyan, magenta, yellow and black) |
| DIPIO_PHM_CIELUV | CIE L*u'v' image (the first three planes are luminosity, u* and v*) |
| DIPIO_PHM_CIELAB | CIE L*a*b* image (the first three planes are luminosity, a* and b*) |
| DIPIO_PHM_CIEXYZ | CIE XYZ (the first three planes are X, Y and Z) |
| DIPIO_PHM_CIEYXY | CIE Yxy (the first three planes are Y, x and y) |
| DIPIO_PHM_HCV | HCV image (the first three planes are hue, chroma and value) |
| DIPIO_PHM_HSV | HSV image (the first three planes are hue, saturation and value) |
| DIPIO_PHM_DEFAULT | Same as DIPIO_PHM_GREYVALUE |
| DIPIO_PHM_GENERIC | Anything can be coded in the channels; the same as DIPIO_PHM_CMYK |
Most file formats support only some of these.
ImageRead, ImageReadROI, ImageFileGetInfo, ImageReadCSV, ImageReadGIF, ImageReadICS, ImageReadJPEG, ImageReadLSM, ImageReadPIC, ImageReadPNG, ImageReadTIFF, ImageWrite, Colour2Gray