TAO Cheng
307 lines
8.5 KiB
C
307 lines
8.5 KiB
C
|
||
#ifndef __DATA_ACQ_2011__
|
||
#define __DATA_ACQ_2011__
|
||
|
||
#include <mmreg.h>
|
||
|
||
#include "DXMediaCap.h"
|
||
|
||
/*
|
||
描述：
|
||
获取指定区域的原始视频帧数据到缓冲区
|
||
参数：
|
||
device - [in] 设备句柄
|
||
buffer - [in] 指向缓冲区。NULL - 后续参数返回相应的数据，比如，所需缓冲区的大小、颜色空间、视频尺寸
|
||
bufferLen - [in] 指向的缓冲区的大小（单位：字节）
|
||
gotBufferLen - [out] 实际获取的数据的大小（单位：字节）
|
||
colorSpace - [out] 获取的原始数据的色彩空间类型
|
||
width - [out] 获取的原始数据的像素宽度
|
||
height - [out] 获取的原始数据的像素高度
|
||
bytesWidth - [out] 获取的原始数据的字节宽度
|
||
rect - [in] 指定获取数据的区域
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
unsigned __stdcall DXGetFrameBuffer(device_handle device, unsigned char* buffer, unsigned bufferLen, unsigned* gotBufferLen = NULL,
|
||
unsigned* colorSpace = NULL, unsigned* width = NULL, unsigned* height = NULL, unsigned* bytesWidth = NULL,
|
||
PRECT rect = NULL);
|
||
|
||
/*
|
||
描述：
|
||
保存原始视频帧数据到 BMP文件
|
||
参数：
|
||
szFileName - [in] BMP文件路径
|
||
buffer - [in] 指向缓冲区
|
||
bufferLen - [in] 指向的缓冲区的大小（单位：字节）
|
||
colorSpace - [in] 获取的原始数据的色彩空间类型
|
||
width - [in] 获取的原始数据的像素宽度
|
||
height - [in] 获取的原始数据的像素高度
|
||
bytesWidth - [in] 获取的原始数据的字节宽度
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
unsigned __stdcall DXSaveBMPFile(TCHAR* szFileName, unsigned char* buffer, unsigned bufferLen,
|
||
unsigned colorSpace, unsigned width, unsigned height, unsigned bytesWidth);
|
||
|
||
/*
|
||
描述：
|
||
保存原始视频帧数据到 JPG文件
|
||
参数：
|
||
szFileName - [in] JPG文件路径
|
||
buffer - [in] 指向缓冲区
|
||
bufferLen - [in] 指向的缓冲区的大小（单位：字节）
|
||
colorSpace - [in] 获取的原始数据的色彩空间类型
|
||
width - [in] 获取的原始数据的像素宽度
|
||
height - [in] 获取的原始数据的像素高度
|
||
bytesWidth - [in] 获取的原始数据的字节宽度
|
||
quality - [in] JPG文件的画面质量
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
unsigned __stdcall DXSaveJPGFile(TCHAR* szFileName, unsigned char* buffer, unsigned bufferLen,
|
||
unsigned colorSpace, unsigned width, unsigned height, unsigned bytesWidth, unsigned quality);
|
||
|
||
/*
|
||
描述：
|
||
直接抓取原始视频帧数据到 BMP文件
|
||
参数：
|
||
device - [in] 设备句柄
|
||
szFileName - [in] BMP文件路径
|
||
rect - [in] 指定获取数据的区域
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
unsigned __stdcall DXSnapToBMPFile(device_handle device, TCHAR* szFileName, PRECT rect = NULL);
|
||
|
||
/*
|
||
描述：
|
||
直接抓取原始视频帧数据到 BMP文件
|
||
参数：
|
||
device - [in] 设备句柄
|
||
szFileName - [in] BMP文件路径
|
||
buffer - [in] 指向缓冲区
|
||
bufferLen - [in] 指向的缓冲区的大小（单位：字节）
|
||
colorSpace - [in] 获取的原始数据的色彩空间类型
|
||
width - [in] 获取的原始数据的像素宽度
|
||
height - [in] 获取的原始数据的像素高度
|
||
bytesWidth - [in] 获取的原始数据的字节宽度
|
||
rect - [in] 指定获取数据的区域
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
unsigned __stdcall DXSnapToJPGFile(device_handle device, TCHAR* szFileName, unsigned quality, PRECT rect = NULL);
|
||
|
||
/*
|
||
描述：
|
||
原始视频数据回调的函数原型
|
||
参数：
|
||
buffer - [in] 缓冲区指针
|
||
colorSpace - [in] 获取的原始数据的色彩空间类型
|
||
width - [in] 获取的原始数据的像素宽度
|
||
height - [in] 获取的原始数据的像素高度
|
||
bytesWidth - [in] 获取的原始数据的字节宽度
|
||
context - [in] 回调函数的上下文
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
typedef unsigned (__stdcall *fnRawVideoCallback)(unsigned char* buffer, unsigned colorSpace,
|
||
unsigned width, unsigned height, unsigned bytesWidth, void* context);
|
||
|
||
/*
|
||
描述：
|
||
设置原始视频数据回调的函数
|
||
参数：
|
||
device - [in] 设备句柄
|
||
fn - [in] 回调函数指针，NULL - 停止回调
|
||
context - [in] 回调函数的上下文
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
unsigned __stdcall DXSetRawVideoCallback(device_handle device, fnRawVideoCallback fn, void* context);
|
||
|
||
/*
|
||
描述：
|
||
开始原始视频数据回调的函数
|
||
参数：
|
||
device - [in] 设备句柄
|
||
fn - [in] 回调函数指针，NULL - 停止回调
|
||
context - [in] 回调函数的上下文
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
unsigned __stdcall DXStartRawVideoCallback(device_handle device, fnRawVideoCallback fn, void* context);
|
||
|
||
/*
|
||
描述：
|
||
停止原始视频数据回调的函数
|
||
参数：
|
||
device - [in] 设备句柄
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
unsigned __stdcall DXStopRawVideoCallback(device_handle device);
|
||
|
||
/*
|
||
描述：
|
||
原始音频数据回调的函数原型
|
||
参数：
|
||
buffer - [in] 缓冲区指针
|
||
bufferLen - [in] 指向的缓冲区的大小（单位：字节）
|
||
wfx - [in] 音频数据格式
|
||
context - [in] 回调函数的上下文
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
typedef unsigned (__stdcall *fnRawAudioCallback)(unsigned char* buffer, unsigned bufferLen, WAVEFORMATEX* wfx, void* context);
|
||
|
||
/*
|
||
描述：
|
||
设置原始音频数据回调的函数
|
||
参数：
|
||
device - [in] 设备句柄
|
||
fn - [in] 回调函数指针，NULL - 停止回调
|
||
context - [in] 回调函数的上下文
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
unsigned __stdcall DXSetRawAudioCallback(device_handle device, fnRawAudioCallback fn, void* context);
|
||
|
||
|
||
/*
|
||
描述：
|
||
原始视频数据叠加回调的函数原型
|
||
参数：
|
||
hdc - [in] 视频叠加的HDC
|
||
width - [in] 能够叠加的宽度（单位：像素）
|
||
height - [in] 能够叠加的高度（单位：像素）
|
||
context - [in] 回调函数的上下文
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
typedef unsigned (__stdcall *fnOSDCallback)(HDC hdc, unsigned width, unsigned height, void* context);
|
||
|
||
/*
|
||
描述：
|
||
设置视频数据叠加回调的函数
|
||
参数：
|
||
device - [in] 设备句柄
|
||
fn - [in] 回调函数指针，NULL - 停止回调
|
||
context - [in] 回调函数的上下文
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
unsigned __stdcall DXSetOSDCallback(device_handle device, fnOSDCallback fn, void* context);
|
||
|
||
enum {osd_text, osd_time, osd_image};
|
||
#define MAX_OSD_TEXT_LEN 16
|
||
/*
|
||
描述：
|
||
设置原始视频帧数据的OSD
|
||
参数：
|
||
device - [in] 设备句柄
|
||
osdType - [in] OSD的类型
|
||
x - [in] 指定OSD的左上角横坐标
|
||
x - [in] 指定OSD的左上角竖坐标
|
||
osdData - [in] OSD的数据，NULL - 取消OSD
|
||
osdType = osd_text，最大MAX_OSD_TEXT_LEN个字符
|
||
osdType = osd_time，指定时间格式
|
||
osdType = osd_image，指定图片路径
|
||
pointSize - [in] 字体大小
|
||
faceName - [in] 字体名称
|
||
color - [in] 针对 osd_text, osd_time 两种类型的OSD的前景色，默认值：白色（RGB(255, 255, 255)）
|
||
bgcolor - [in] OSD的背景色，默认值：黑色（RGB(0, 0, 0)）
|
||
opaque - [in] OSD的背景色是否不透明，默认值：是。当选择透明时，则以 bgcolor 进行透明处理
|
||
alpha - [in] alpha运算值。取值[0 ~ 255]，0 - OSD透明，255 - OSD不透明，中间值 - OSD与视频数据进行alpha运算
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
unsigned __stdcall DXSetOSD(device_handle device, unsigned osdType, int x, int y, char* osdData, int pointSize = 120, LPCTSTR faceName = TEXT("Arial"),
|
||
COLORREF color = RGB(255, 255, 255), COLORREF bgcolor = RGB(0, 0, 0), BOOL opaque = TRUE,
|
||
unsigned char alpha = 255);
|
||
|
||
/*
|
||
描述：
|
||
启用/禁用原始视频帧数据的OSD
|
||
参数：
|
||
device - [in] 设备句柄
|
||
osdType - [in] OSD的类型
|
||
enable - [in] TRUE - 启用OSD，FALSE - 禁用OSD
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
unsigned __stdcall DXEnableOSD(device_handle device, unsigned osdType, BOOL enable);
|
||
|
||
/*
|
||
描述：
|
||
由图片缓冲创建预览对象
|
||
参数：
|
||
imgbuffer - [in] 图片缓冲区
|
||
buffersize - [in] 图片缓冲区的大小（单位：字节）
|
||
colorspace - [in] 图片缓冲的数据的色彩空间
|
||
width - [in] 图片的宽度（单位：像素）
|
||
height - [in] 图片的高度（单位：像素）
|
||
err - [out] 返回错误代码
|
||
返回值：
|
||
成功则返回图像句柄，否则返回 NULL。可通过 err 获得错误代码
|
||
// */
|
||
image_handle __stdcall DXCreateBufferImg(unsigned char* imgbuffer, unsigned buffersize,
|
||
unsigned colorspace, unsigned width, unsigned height,
|
||
unsigned* err);
|
||
|
||
/*
|
||
描述：
|
||
由图片文件创建预览对象
|
||
参数：
|
||
szImgFile - [in] 图片文件全路径
|
||
err - [out] 返回错误代码
|
||
返回值：
|
||
成功则返回图像句柄，否则返回 NULL。可通过 err 获得错误代码
|
||
// */
|
||
image_handle __stdcall DXCreateFileImg(TCHAR* szImgFile, unsigned* err);
|
||
|
||
/*
|
||
描述：
|
||
由更新预览对象到指定的窗体的相应区域
|
||
参数：
|
||
img - [in] 预览对象
|
||
hPrevWnd - [in] 预览的窗体
|
||
rect - [in] 预览的区域
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
unsigned __stdcall DXUpdateImg(image_handle img, HWND hPrevWnd, RECT* rect);
|
||
|
||
/*
|
||
描述：
|
||
删除预览对象
|
||
参数：
|
||
img - [in] 预览对象
|
||
返回值：
|
||
无
|
||
// */
|
||
void __stdcall DXDestroyImg(image_handle img);
|
||
|
||
/*
|
||
描述：
|
||
翻转视频
|
||
参数：
|
||
device - [in] 设备句柄
|
||
flip - [in] TRUE - 启用翻转，FALSE - 禁用翻转
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
unsigned __stdcall DXFlipVideo(device_handle device, BOOL flip);
|
||
|
||
/*
|
||
描述：
|
||
镜像视频
|
||
参数：
|
||
device - [in] 设备句柄
|
||
mirror - [in] TRUE - 启用镜像，FALSE - 禁用镜像
|
||
返回值：
|
||
0 - 成功；失败则返回错误代码
|
||
// */
|
||
unsigned __stdcall DXMirrorVideo(device_handle device, BOOL mirror);
|
||
|
||
|
||
#endif // __DATA_ACQ_2011__
|