# Working With VisionPro Images in Cognex ViDi Suite

The VisionPro API deals with images that implement ICogImage, such as CogImage24PlanarColor and CogImage8Grey. The ViDi API deals with images that implement IImage, such as WpfImage and FormsImage.

Note:

- The ImageExtensions class contains the method ToCogImage which can convert a ViDi image into an ICogImage.

  Note that the resulting ICogImage will have a default CoordinateSpaceTree. If converting back and forth, you may want to preserve this information when going from ICogImage → IImage, so that you can restore this information when going from IImage → ICogImage.

- The wrapper also provides an Image class, which is constructed with an ICogImage and converts the image under the hood into an image that implements IImage.

The following table details which ICogImage types are currently accepted by the Image class, as well as how the Image's channels vary depending on the type of ICogImage converted:

ICogImage Type | Channel Depth of Converted Image | Channels in Converted Image
--- | --- | ---
CogImage8Grey | ImageChannelDepth.Depth8 | 1
CogImage24PlanarColor | ImageChannelDepth.Depth8 | 3
CogImage16Grey | ImageChannelDepth.Depth16 | 1
CogImage16Root | ImageChannelDepth.Depth16 | 1

The following table details which IImage types can currently be converted using the ToCogImage extension method:

IImage Type | Supports ToCogImage?*
--- | ---
Local.LibraryImage | Yes
WpfImage | Yes
FormsImage | Yes
Image | No

Note:

- The type of ICogImage returned will depend on the channels and channel depth, as described in the first table above.
- Currently, 1 channel/Depth16 images are always converted to CogImage16Grey.