Acquisition events



qpx_AcqDeviceConnected 0x1001 A device has been connected
qpx_AcqDeviceDisconnected 0x1002 A device has been disconnected
qpx_AcqImageSaved 0x1003

An image was saved on disk.

Parameter eventInfoParam points to a text variable that contains the full pathname to the saved image file.

Supported by all acquisition protocols.

qpx_AcqImageDeleted 0x1004

An image was deleted on the device (typically a digital camera).

Parameter eventInfoParam points to a text variable that contains the name of the image.

Supported by the PTP acquisition protocol.

qpx_AcqSetupWindowBounds 0x2001

The device dialog is about to be displayed and QPix asks the application for the dialog's bounds.

Parameter eventInfoParam points to a longint array with 4 elements. The event handler method can set the array elements to the left, top, right, and bottom coordinates of the desired window bounds.

Supported by the PTP (Mac OS) and Video acquisition protocols.

qpx_AcqSetupWindowTitle 0x2002

The device dialog is about to be displayed and QPix asks the application for the dialog's title.

Parameter eventInfoParam points to a string. The event handler method can set the string to the desired window title.

Supported by the PTP (Mac OS) and Video acquisition protocols.

qpx_AcqSetupResolution 0x3001

The acquisition session is about to begin and QPix asks the application for the image resolution.

Parameter eventInfoParam points to a longint array with 2 elements that contains the current horizontal and vertical resolution of the device. The event handler method can change the contents of the array to the desired horizontal and vertical resolution.

Supported by the TWAIN (GUI-less) and Video acquisition protocols.

qpx_AcqSetupPixelFormat 0x3002

The acquisition session is about to begin and QPix asks the application for the pixel format.

Parameter eventInfoParam points to a longint that contains the current pixel format of the device. The event handler method can change the longint to the desired pixel format. Acceptable pixel formats are 1 for black and white, 40 for gray scale, 8 for palette color, and 24 for true color. Not all pixel formats are supported by all devices. QPix will adjust the requested pixel format to match the closest pixel format that the device can handle.

Supported by the TWAIN (GUI-less) acquisition protocol.

qpx_AcqRestoreDeviceSettings 0x4001

QPix asks the application for saved device settings.

Parameter eventInfoParam points to a BLOB that contains the settings for the device. The event handler method can assign to the BLOB the device settings that were previously stored during a qpx_AcqStoreDeviceSettings acquisition event. Note that QuickTime and/or the video digitizer component (VDIG) may reject or adjust some of all of the device settings.

Supported by the Video acquisition protocol on Mac OS.

qpx_AcqStoreDeviceSettings 0x4002

QPix passes to the application the device settings.

Parameter eventInfoParam points to a BLOB that contains the settings for the device. The event handler method can store the BLOB to be later passed to the device during a qpx_AcqRestoreDeviceSettings acquisition event.

Supported by the Video acquisition protocol on Mac OS.


QPix © Escape
Generated by QDoc 2.8 on Wed, Feb 17, 2010 18:03:28