Platforms to show: All Mac Windows Linux Cross-Platform
Back to ImageCaptureEventsMBS class.
ImageCaptureEventsMBS.deviceDidBecomeReady(device as ICDeviceMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
A camera device is ready, when it is ready to receive requests. A scanner device is ready when its functional units are found and the default functional unit is selected for use and is ready to receive requests. The device will become ready to receive requests only after a session is opened.
Some examples using this event:
ImageCaptureEventsMBS.deviceDidChangeName(device as ICDeviceMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
This happens if the device module overrides the default name of the device reported by the device's transport layer, or if the name of the filesystem volume mounted by the device is changed by the user.
ImageCaptureEventsMBS.deviceDidChangeSharingState(device as ICDeviceMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
Any Image Capture client application can choose to share the device over the network using the sharing or webSharing facility in Image Capture.
ImageCaptureEventsMBS.deviceDidCloseSessionWithError(device as ICDeviceMBS, error as NSErrorMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
This event completes the process initiated by the message "requestCloseSession" sent to the device object. This event is also sent if the device module in control of the device ceases to control the device.
Some examples using this event:
ImageCaptureEventsMBS.deviceDidEncounterError(device as ICDeviceMBS, error as NSErrorMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
Some examples using this event:
ImageCaptureEventsMBS.deviceDidOpenSessionWithError(device as ICDeviceMBS, error as NSErrorMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
This event completes the process initiated by the requestOpenSession sent to the device object.
Some examples using this event:
ImageCaptureEventsMBS.deviceDidReceiveButtonPress(device as ICDeviceMBS, buttonType as String)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
This event is sent only if a session is open on the device. The value of 'buttonType' argument is one of the ICButtonType* values defined above.
Some examples using this event:
ImageCaptureEventsMBS.deviceDidReceiveCustomNotification(device as ICDeviceMBS, notification as Dictionary, data as Memoryblock)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
This event is sent only if a session is open on the device.
Some examples using this event:
ImageCaptureEventsMBS.deviceDidReceiveStatusInformation(device as ICDeviceMBS, status as Dictionary)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
In Mac OS X 10.6 this event is not called for camera devices. This may change in the future releases of Mac OS X.
The 'status' dictionary contains two keys, ICStatusNotificationKey and ICLocalizedStatusNotificationKey, which are defined above. If type of 'device' is ICDeviceTypeScanner, the value of ICStatusNotificationKey will be one of the values defined in ICScannerDevice.h (e.g., ICScannerStatusWarmingUp, ICScannerStatusWarmUpDone, or ICScannerStatusRequestsOverviewScan); the value of ICLocalizedStatusNotificationKey will be a localized status information string suitable for displaying to the user.
Some examples using this event:
ImageCaptureEventsMBS.deviceDidRemove(device as ICDeviceMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
Some examples using this event:
ImageCaptureEventsMBS.deviceDidSendMessage(messageCode as UInt32, data as Memoryblock, error as NSErrorMBS, device as ICDeviceMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
Some examples using this event:
ImageCaptureEventsMBS.scannerDeviceDidBecomeAvailable(scanner as ICScannerDeviceMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
Scanners require exclusive access, only one client can open a session on a scanner. The scanner is available if it does not have a session opened by another client. Attempting to open a session on a scanner that already has an open session for another client will result in an error. A client that wants to open a session on a scanner as soon as it is available should implement this method and send "requestOpenSession" message to scanner object from that method.
Some examples using this event:
ImageCaptureEventsMBS.scannerDeviceDidCompleteOverviewScanWithError(scanner as ICScannerDeviceMBS, error as NSErrorMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
Some examples using this event:
ImageCaptureEventsMBS.scannerDeviceDidCompleteScanWithError(scanner as ICScannerDeviceMBS, error as NSErrorMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
Some examples using this event:
ImageCaptureEventsMBS.scannerDeviceDidScanToBandData(scanner as ICScannerDeviceMBS, Data as ICScannerBandDataMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
In memory transfer mode, this will send a band of size that has been selected by the client via the maxMemoryBandSize property.
Some examples using this event:
ImageCaptureEventsMBS.scannerDeviceDidScanToURL(scanner as ICScannerDeviceMBS, URL as string, file as folderitem, data as MemoryBlock)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
If selectedFunctionalUnit is a document feeder, then this event will be sent once for each scanned page.
This event is sent when the scanner device receives the requested scan. If selectedFunctionalUnit is a document feeder, then this event will be sent once for each scanned page.
Some examples using this event:
ImageCaptureEventsMBS.scannerDeviceDidSelectFunctionalUnit(scanner as ICScannerDeviceMBS, functionalUnit as Variant, Error as NSErrorMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
A functional unit is selected immediately after the scanner device is instantiated and in response to requestSelectFunctionalUnit method.
Some examples using this event:
ImageCaptureEventsMBS.scannerDeviceViewDidEncounterError(scannerDeviceView as IKScannerDeviceViewMBS, error as NSErrorMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
ImageCaptureEventsMBS.scannerDeviceViewDidScanToBandData(scannerDeviceView as IKScannerDeviceViewMBS, data as ICScannerBandDataMBS, scanInfo as Dictionary, error as NSErrorMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
The 'data' parameter describes the scanned image data. Note that rotation/cropping/image adjustments are not applied yet. The 'scanInfo' parameter contains additional information (rotation angle, ...) that should be applied once the scan is completed.
Only called if transfermode is ICScannerTransferModeMemoryBased.
ImageCaptureEventsMBS.scannerDeviceViewDidScanToURL(scannerDeviceView as IKScannerDeviceViewMBS, url as String, file as FolderItem, fileData as MemoryBlock, error as NSErrorMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
event | Image Capture | MBS AVFoundation Plugin | 14.3 | ✅ Yes | ❌ No | ❌ No | ❌ No |
Based on the IKScannerDeviceViewTransferMode the downloaded file will be saved on disk using the 'url', or returned in memory as Memoryblock.
The items on this page are in the following plugins: MBS AVFoundation Plugin.