IMVImageCapture2

The IMVImageCapture2 interface extends the IMVImageCapture interface.

Methods:

DontWriteFiles Capture image to memory only.
DrawColour Colour used for drawing region and time.
DrawRegion Draw the capture region into the video.
DrawTimeStamp Draw a time stamp on the captured image.
GetCaptureRegion Get the capture region.
GetCurrentBitmap Get current MV_BITMAP.
Interpolation Get the interpolation mode.
JpegQuality Get the JPEG compression ratio.
LineWidth Line width for drawing.
OutputHeight Get the height of the captured image.
OutputWidth Get the width of the captured image.
Overwrite Overwrite existing files.
PutCaptureRegion Put the capture region.
ShowCurrentBitmap Draw the capture region into the video.

Header file: IMVImageCapture.h
Interface definition language file: IMVImageCapture.idl
Interface ID: IID_IMVImageCapture2


Property IMVImageCapture2::DontWriteFiles

Declaration: Property Get/Put DontWriteFiles As Long

Capture image to memory only.

C Prototype:

HRESULT put_DontWriteFiles(LONG newVal);
HRESULT get_DontWriteFiles(LONG *pVal);


Property IMVImageCapture2::DrawColour

Declaration: Property Get/Put DrawColour As Long

Colour used for drawing region and time.

C Prototype:

HRESULT put_DrawColour(LONG newVal);
HRESULT get_DrawColour(LONG *pVal);


Property IMVImageCapture2::DrawRegion

Declaration: Property Get/Put DrawRegion As Long

Draw the capture region into the video.

C Prototype:

HRESULT put_DrawRegion(LONG newVal);
HRESULT get_DrawRegion(LONG *pVal);


Property IMVImageCapture2::DrawTimeStamp

Declaration: Property Get/Put DrawTimeStamp As Long

Draw a time stamp on the captured image.

C Prototype:

HRESULT put_DrawTimeStamp(LONG newVal);
HRESULT get_DrawTimeStamp(LONG *pVal);


Method IMVImageCapture2::GetCaptureRegion

Declaration: Sub GetCaptureRegion(piXOffset As Long, piYOffset As Long, piWidth As Long, piHeight As Long)

Get the capture region.

Parameter:

piXOffset X offset in pixel.
piYOffset Y offset in pixel.
piWidth Width in pixel.
piHeight Height in pixel.
C Prototype:

HRESULT GetCaptureRegion(LONG* piXOffset, LONG* piYOffset, LONG* piWidth, LONG* piHeight);


Method IMVImageCapture2::GetCurrentBitmap

Declaration: Sub GetCurrentBitmap(piWidth As Long, piHeight As Long, piBitCount As Long, piSize As Long, pbyData As Long)

Get current MV_BITMAP.

Parameter:

piWidth Bitmap width in pixel.
piHeight Bitmap height in pixel.
piBitCount Bitcount of the bitmap.
piSize Size of the bitmap data in bytes. Initialise piSize with the size of the pbyData buffer.
pbyData Pointer to buffer for the current bitmap data.
C Prototype:

HRESULT GetCurrentBitmap(LONG* piWidth, LONG* piHeight, LONG* piBitCount, LONG* piSize, LONG* pbyData);


Property IMVImageCapture2::Interpolation

Declaration: Property Get/Put Interpolation As Long

Get the interpolation mode.

C Prototype:

HRESULT put_Interpolation(LONG newVal);
HRESULT get_Interpolation(LONG *pVal);


Property IMVImageCapture2::JpegQuality

Declaration: Property Get/Put JpegQuality As Long

Get the JPEG compression ratio. Range from 0 to 100.

C Prototype:

HRESULT put_JpegQuality(LONG newVal);
HRESULT get_JpegQuality(LONG *pVal);


Property IMVImageCapture2::LineWidth

Declaration: Property Get/Put LineWidth As Long

Line width for drawing.

C Prototype:

HRESULT put_LineWidth(LONG newVal);
HRESULT get_LineWidth(LONG *pVal);


Property IMVImageCapture2::OutputHeight

Declaration: Property Get/Put OutputHeight As Long

The height of the captured image.

C Prototype:

HRESULT put_OutputHeight(LONG newVal);
HRESULT get_OutputHeight(LONG *pVal);


Property IMVImageCapture2::OutputWidth

Declaration: Property Get/Put OutputWidth As Long

The width of the captured image.

C Prototype:

HRESULT put_OutputWidth(LONG newVal);
HRESULT get_OutputWidth(LONG *pVal);


Property IMVImageCapture2::Overwrite

Declaration: Property Get/Put Overwrite As Long

Overwrite existing files.

C Prototype:

HRESULT put_Overwrite(LONG newVal);
HRESULT get_Overwrite(LONG *pVal);


Method IMVImageCapture2::PutCaptureRegion

Declaration: Sub PutCaptureRegion(iXOffset As Long, iYOffset As Long, iWidth As Long, iHeight As Long)

Put the capture region.

Parameter:

iXOffset X Ofsset in pixel.
iYOffset Y Ofsset in pixel.
iWidth Width in pixel.
iHeight Height in pixel.
C Prototype:

HRESULT PutCaptureRegion(LONG iXOffset, LONG iYOffset, LONG iWidth, LONG iHeight);


Method IMVImageCapture2::ShowCurrentBitmap

Declaration: Sub ShowCurrentBitmap(hWnd As Long)

Draw the capture region into the video.

Parameter:

hWnd Window handle.
C Prototype:

HRESULT ShowCurrentBitmap(LONG hWnd);