Platforms to show: All Mac Windows Linux Cross-Platform

Back to EdsImageMBS class.

EdsImageMBS.CacheImage(UseCache as boolean)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Canon EOS Digital MBS Cameras Plugin 12.1 ✅ Yes ✅ Yes ✅ Yes ❌ No Desktop only
Switches a setting on and off for creation of an image cache in the SDK for a designated image object during extraction (processing) of the image data.

Creating the cache increases the processing speed, starting from the second time.
UseCache: Image Cache on/off.
Lasterror is set.

EdsImageMBS.Constructor(stream as EdsImageMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Canon EOS Digital MBS Cameras Plugin 12.1 ✅ Yes ✅ Yes ✅ Yes ❌ No Desktop only
Creates an image object from an image file.

Without modification, stream objects cannot be worked with as images. Thus, when extracting images from image files, you must use this API to create image objects.
The image object created this way can be used to get image information (such as the height and width, number of color components, and resolution), thumbnail image data, and the image data itself.
Lasterror is set.

EdsImageMBS.DateTime as EdsTimeMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Canon EOS Digital MBS Cameras Plugin 12.1 ✅ Yes ✅ Yes ✅ Yes ❌ No Desktop only
Convenience function to query date and time values.

Calls GetPropertyData for you with kEdsPropID_DateTime.
Lasterror is set.

EdsImageMBS.FocusInfo as EdsFocusInfoMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Canon EOS Digital MBS Cameras Plugin 12.1 ✅ Yes ✅ Yes ✅ Yes ❌ No Desktop only
Convenience function to query focus information.

Lasterror is set.
This queries kEdsPropID_FocusInfo with GetPropertyData for you and returns an EdsFocusInfoMBS object.

EdsImageMBS.Image(ImageSource as Integer, TargetImageType as Integer, Source as EdsRectMBS, Dest as EdsSizeMBS, DestStream as EdsStreamMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Canon EOS Digital MBS Cameras Plugin 12.1 ✅ Yes ✅ Yes ✅ Yes ❌ No Desktop only
Gets designated image data from an image file, in the form of a designated rectangle.

Returns uncompressed results for JPEG compressed images and processed results in the designated pixel order (RGB, Top-down BGR, and so on) for RAW images. Additionally, by designating the input/output rectangle, it is possible to get reduced, enlarged, or partial images. However, because images corresponding to the designated output rectangle are always returned by the SDK, the SDK does not take the aspect ratio into account. To maintain the aspect ratio, you must keep the aspect ratio in mind when designating the rectangle.
Lasterror is set.

ImageSource: Designate the type of image data to get from the image file (thumbnail, preview, and so on). Designate values as defined in kEdsImageSrc* constants.
TargetImageType: Designate the output image type. Because the output format of EdsGetImage may only be RGB, only kEdsTargetImageType_RGB or kEdsTargetImageType_RGB16 can be designated.

However, image types exceeding the resolution of ImageSource cannot be designated.
Example: Suppose the source image resolution (componentDepth) retrieved by means of ImageInfo() is 8 bits
-> The resolution that can be retrieved by means of Image () is also 8 bits
-> Thus, only kEdsTargetImageType_RGB is available.
Source: Designate the coordinates and size of the rectangle to be retrieved (processed) from the source image.
Dest: Designate the rectangle size for output.
DestStream: Designate the memory or file stream for output of the image.

Lasterror is set.

  • To maintain the aspect ratio, you must keep the aspect ratio in mind when designating a rectangle.
  • In calculating the data size of the output file, the original image data resolution is not used.

Instead, the resolution of the image type designated by inImageType is used. For example, the calculation for kEdsTargetImageType_RGB is 3 (R, G, and B) x 8 (resolution) x width x height ÷ 8 (bytes). Similarly, kEdsTargetImageType_RGB16 is calculated by 3 x 16 x width x height ÷ 8 (bytes).

EdsImageMBS.ImageInfo(ImageSource as Integer) as EdsImageInfoMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Canon EOS Digital MBS Cameras Plugin 12.1 ✅ Yes ✅ Yes ✅ Yes ❌ No Desktop only
Gets image information from a designated image object.

Here, image information means the image width and height, number of color components, resolution, and effective image area.
Lasterror is set.

EdsImageMBS.PictureStyleDesc as EdsPictureStyleDescMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Canon EOS Digital MBS Cameras Plugin 12.1 ✅ Yes ✅ Yes ✅ Yes ❌ No Desktop only
Convenience function to query Picture Style Description information.

Calls GetPropertyData for you with kEdsPropID_PictureStyleDesc and returns object with values.
Lasterror is set.

EdsImageMBS.ReflectImageProperty

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Canon EOS Digital MBS Cameras Plugin 12.1 ✅ Yes ✅ Yes ✅ Yes ❌ No Desktop only
Incorporates image object property changes (effected by means of EdsSetPropertyData) in the stream.

Lasterror is set.

EdsImageMBS.SaveImage(TargetImageType as Integer, DestStream as EdsStreamMBS, JPEGQuality as Integer = 0, iccProfileStream as EdsStreamMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Canon EOS Digital MBS Cameras Plugin 12.1 ✅ Yes ✅ Yes ✅ Yes ❌ No Desktop only
Saves as a designated image type after RAW processing.

TargetImageType: Designate the image type to produce. Designate the following image types. See kEdsTargetImageType* constants.
JPEGQuality: Image quality for JPEG compression
iccProfileStream: ICC profile stream.

Lasterror is set.

The items on this page are in the following plugins: MBS Cameras Plugin.


The biggest plugin in space...