修改yuv调整亮度和对比度-CSDN社区

TMPGEnc 是日本人堀浩行开发的一套老牌的高画质视频编码转换工具软件，在 Canopus ProCoder v2.0 Final 推出以前，一直是视频转换领域的画质冠军，支持 VCD、SVCD、DVD 以及所有主流媒体格式 (Windows Media、Real Video、Apple QuickTime、Microsoft DirectShow、Microsoft Video for Windows、Microsoft DV、Canopus DV、Canopus MPEG-1 和 MPEG-2 编码)，而且还提供对高清晰度视频格式的支持。 TMPGEnc Xpress 4.0 最新推出的版本，在保证原有的高质量视频转换品质的前提下，对新近推出的英特尔和 AMD 处理器进行了代码优化，支持最新的多媒体扩展指令，令其在提高视频转换质量的情况下大大加快了视频转换的速度。同时，软件在提供各类视频格式的标准编码设置外还提供了各种自定义设置，加强了编码的灵活性。程序安装时如出现提示错误则选择“忽略”，安装完成后点击绿化然后退出程序，再运行软件即可使用！小日本TMPGEnc为津波同享(TMPGEnc)的商业版。津波同享(TMPGEnc)应广大用户的期待，郑重推出商品版津波视像编码(TMPGEnc Plus )。即使非专业人员也能易如反掌地进行编码设定的“项目助手”功能装备面向更高画质的“新2次处理可变码率编码引擎” 制作原版DVD/VCD的“DVD，SVCD和VCD源码”生成之功能对AVI等类型的影片文件进行MPEG-1/2软编码编码时画面大小，宽高比调整视频与音频的码流合成/分解 TMPGEnc小日本参数设定详解本文并不介绍tmpgenc的菜单部分，因为影响mpeg编码效率/质量的主要是参数设置。TMPGEnc小日本菜单提供了一些很好的功能，比如压缩完成自动关机等，请大家自己摸索。 A. video（视频）部分：本部分设定输出的视频码流的类型和参数，大部分参数在模版中已经固定。 1）基本类型：有mpeg1/mpeg2，mpeg1用于vcd, mpeg2用于svcd/dvd. 2）大小：PAL vcd标准为352x288, pal svcd标准为480x576, pal dvd标准为720x576 3)画面宽高比：一般应该用4:3 625 line PAL, 这是电视机的屏幕比例 4）桢率：pal 的标准为25fps 5) 码率控制：码率控制算法是造成各种编码器编码效率和质量不同的关键因素。mpeg标准中并没有对次算法的具体实现做规定，这通常也是商业版本的知识产权内容。 CBR（固定码率）：保持码率基本维持在平均码率。实现简单，对复杂场景会因码率不足造成马赛克现象，对于简单场景则不能充分利用编码空间。(老枯这里讲的复杂场景是指细节/边缘丰富以及快速变化场景）。 VBR, (2-pass VBR), “二次处理VBR”。老枯认为其意思是通过对整个视频源进行2次处理使编码效率最高：第一遍判断何处为复杂场景和简单场景，第二遍根据码率的上下限，把码率重新分配更多给复杂场景。可以在实验中看出，tmpgenc在进行这种编码时进度指示在50%以前是没有预览图象的，而且桢进度指示为0。所以老枯建议威龙改译为“二次处理”。这种码流控制方式应该在给定码率下得到最好的质量，但是和具体2次分配算法关系很大。同时耗时最长。一些其他编码器甚至有3次处理的码率优化。 MVBR (手动可变码率），设定最大码率和对不同的帧类型设定不同的信息损失量，实现局部码率优化。可以通过手工指定复杂场景为I帧对之进行较精细的编码。参见对于GOP参数设定部分。 CQ-VBR (自动可变码率），设定主观质量值和码率上下限，以主观质量标准对编码器量化环节进行控制，在可选参数中设定主观质量值以后，编码器就在能达到此质量标准的前提下尽量节省码率。关键在于编码器对主观质量的评价方法。这是CQ和VBR的综合，也可以看作自动的MVBR. 威龙汉化5版在可选参数中有一行是“不破坏最小码率的状态而填充数据”，老枯的理解是，如果码率过低就填充无意义码（好浪费啊，不过可能是为了兼容性的原因），英文版这一句没有翻译，还是日文。 :-( CQ (固定品质），就是比MVBR多了一个主观质量值的设定。老枯不明白到底是怎么控制的。 RT-CBR (实时固定码率）：连GOP层次的码率优化也不做了的CBR,快一点，质量不高 RT-CQ (实时固定品质）：连GOP层次的码率优化也不做了的CQ,快一点，质量不高 6）码率：这个码率是指CBR方式下的平均码率 7）VBV缓冲区大小：缓冲区大的话，编码优化会好一些，但是解码的时候也要求大一些的缓冲区。因此，vcd/svcd标准中参数是固定的，否则可能机器无法播放。 8）Pofile & level(类别与级别）: 这个参数是mpeg1没有的。在svcd/dvd应用中应该是MP&ML,模版自动选定。 MP&HL是为HDTV定义的，分辨率可以高达 19??x11?? . 9)制式：好象这个也是mpeg2相关的参数。我们应该用PAL. 10) 隔行扫描：mpeg1只支持逐行扫描（25 frame/sec)，mpeg2可以选择隔行(50 field/sec)。如果成品在电视上播放，老枯建议选择隔行，使运动平滑。但是隔行的视频在pc上看会有毛刺现象，在水平运动景象中尤其明显。 11）播放时实现3:2下拉：这是在film/NTSC制式转换中需要的，即在编码时维持帧率不变，不做3:2下拉，而在播放中实现。参见 B.advanced部分。感谢威龙指正。 12）YUV格式：给亮度/红色差/蓝色差分配的码位。对于人眼来说，亮度信号是最敏感的，所以就分配比较多的编码空间以求精细，对于色差则粗糙些。一般就是4:2:0了。（其实4:2:0方案给蓝色差的码位不是0，老枯不知道为什么这样写） 13）DC分量精度：在mpeg编码中需要对8x8的图象块进行DCT(离散余弦变换），DC分量的意义基本是代表8x8块中的平均值，一般需要为之分配比较大的编码空间，否则马赛克的边缘效应就比较明显。（8bit就不小啦，图象压缩中是每个bit的油水都要榨干的） 14）运动检测精度：mpeg是对I帧进行帧内编码，对P帧进行预测误差编码。就是对于P帧的图块，在I帧中寻找对应的部分，然后对两个图块的差异部分进行编码，可以大大节省码率。运动检测精度越高，图块搜索匹配的范围越大，编码效率越高，同时编码速度越慢。这部分算法同样没有在mpeg标准中定义，各个厂商实现水平相差会很大。一般来说，在tmpgenc中设置为普通即可。 B. Advanced (影象源）部分：本部分设置视频源相关的参数，以及在编码之前对视频源进行的预处理。 1）视频源类型：隔行扫描/逐行扫描。这个参数在打开视频源文件的时候会对之自动判断设置。Tmpgenc12版不能自动识别type 1 DV，在12a版本中已经解决。参看老枯的编码测试页。 2）场顺序：这是整个tmpgenc甚至整个桌面视频领域中最混乱的一部分。tmpgenc12a好象也不能根据视频源自动设置这个参数。老枯在这个问题上搞了很久，才算明白了一点。这个参数是至关重要的，设置反了会造成生成图象的明显闪动，打个比方，一个物体的运动位置次序本来是1-2-3-4-5-6 -……，设置反了以后就成了2-1-4-3-6-5-8……对于模拟视频源，其场序是由捕捉卡类型决定的，对于dv,则定义为 field order A。讲到这里还没有什么麻烦，但麻烦的是虽然场序只有2种，对于他们的叫法却有3种: field order A/B (在ulead软件中的叫法）, even/odd line first （tmpgenc的叫法）, field top/bottom first（bitrate viewer叫法），这3种叫法之间的对应关系是最让人头疼的。在英文版的tmpgenc12a中，缺省的设置为“even line first (field A)”，，但在威龙汉化中缺省设置为“奇数场->偶数场”，老枯曾就此请教威龙，威龙讲这是日文版的原意，注意不要在字面上混淆了。总之，3种叫法的关系是这样的：field A = even line first(奇数场->偶数场) = field bottom first。最可*的方法，是用不同的设置对高速运动场景各生成一段隔行扫描的视频，并在电视上观察，应该能够看到差别。 3）视频源的宽高比：tmpgenc可以自动识别设置，一般应该为4:3 625line PAL. 4) 画面显示比例和位置：一般选用“全画面显示并宽高比不变”，所谓“全画面显示并宽高比不变2”选项可能是会造成部分画面不可见，老枯没有尝试过这一种。在 4:3视频源中可能没有差别，但对于16:9宽屏影象在4:3屏幕上输出而言，“全画面显示并宽高比不变”是在上下留出空白，“全画面显示并宽高比不变 2”会截掉左右两端画面。。。没有这样试过，仅为老枯猜测，不正确的地方请朋友们指正。 5）滤镜选项组：这一组设置可以对视频源进行预处理以提高影象质量。一般来说，老枯都是在非编软件中实现这些功能的。另外，对滤镜的使用要适度，因为客观上任何滤镜的使用都是引入了信息损失，这是对低品质视频源提高主观质量的代价。影象源范围：选取部分影象源进行压缩 24fps化：24fps是电影标准，一般不选消除鬼影：鬼影是影象的重影，视频源不好的时候会出现。老枯在dv中没有遇到过。消除噪点：在低光条件下的拍摄中影响中回出现明显的颗粒噪点，利用此滤镜可以消除。不过副作用是平滑了图象，比如人的面部会象橡皮娃娃一样，光滑但没有质感。锐化边缘：可以对横向/纵向边缘分别设置参数，做增强处理。简单色彩校正：调整亮度，对比度，gamma，色度等高级色彩校正：可以按照不同的色彩空间RGB/YUV等进行色彩校正。消除交错信号（de-interlace)：把隔行扫描的视频源转换成逐行扫描的视频，如果对输出的视频设置为隔行扫描（如在打算电视上播放的 svcd/dvd)，则不要选用。老枯认为在做vcd（逐行扫描mpeg1)时候也未必需要选用，要看视频源的大小决定。比如老枯用dv 576线，在做vcd时候只需要288线，简单舍弃一个场就可以，不需要deinterlace. 相反，如果视频源是352x288的隔行扫描视频，则需要做de-interlace. 裁剑画面：由于电视机播放视频的时候对边缘四周的部分做舍弃，所以可以利用这一点只对可见部分进行编码，这样可以加快编码速度，并且因为节省的码率可以利用在未裁剪区域从而提高画面质量。一般来说对上下左右各裁剪5%是安全的。 3:2下拉变换：因film 24fps和 NTSC 30fps帧率不同，在制式转换中所需要做的调整。一般不用。帧率不变：没什么好讲的声音处理：可以增大/减小音量，并做声音的淡入/淡出。 C. GOP结构 GOP = group of picture. 在mpeg中一个GOP就是一组时间上连续的画面。mp4视频中的画面分为3种：I,P,B. I是内部编码帧，编码方式基本上就是jpeg的格式。P是前向预测帧，编码方式是使用运动检测误差编码，参看A部分对运动检测的说明；B是双向内插帧，根据前后I/P帧进行插值运算，对插值误差进行编码。建议一般不要修改GOP结构，以取得压缩比例和图象质量之间的最好平衡。极端的例子是只用I帧，图象质量会有保证，但码流会很大。 1）输出编辑用的码流：这个选项会把GOP最后的B帧取消。因为B帧是双向内插的，其编码/解码不仅需要以前的I/P,也需要以后的I/P帧。取消最后的B帧，可以去除GOP之间的依赖性，从而便于编辑。 2）检测场景变化：对于快速变化的场景，强行设置为I帧，以保证画面质量 3）手工强制设定帧类型：手工设定需要精细编码的画面帧为I帧。结合MVBR码流控制可以全面控制码流分配。 D、量化矩阵 mpeg中的量化是对8x8 YUV 信号图块进行DCT变换之后的系数的量化。通过对高频分量使用比较大的量化阶从而达到减小高频分量的编码空间，达到压缩的目的。代价就是丧失图像细节，边缘模糊等。 1）帧内编码量化矩阵：这是指对I帧使用的帧内编码量化矩阵 2）帧间编码量化矩阵：是指对非I帧的帧间预测误差编码所用的量化矩阵。威龙汉化版中叫外部矩阵。 3）矩阵模版的选择：建议对一般的视频选用mpeg标准，可以看到，其帧间编码矩阵统一为16，这是因为帧间误差已经抵消了低频分量，高频分量丰富，所以和帧内编码矩阵有所不同。对于计算机动画尤其是2维线条为主的动画，建议选用CG模版，可以看到因为CG本身高频信号丰富，其帧内编码矩阵也统一为32。 4）YUV输出为YCrCb: YCrCb色彩空间分配给Y亮度信号的编码空间更大，如果视频源是YCrCb格式的话，这个选项可以增加画面质量。不过一般都是采用YUV(CCIR601),如dv,所以不要选择这个选项，否则白白浪费码率。 5）浮点离散余弦变换：整点运算的速度比浮点要快很多，但精度不如浮点。老枯猜测这里的浮点其实只是把DCT变换的系数从8bit增大为16bit的精度，并不需要浮点运算器单元参与变换，否则速度是不可忍耐的。 6）不对静止部分做半像素的运动检测：由于视频源是隔行的，对于精细的静止边缘线条（1个像素宽度）比如静止字幕会出现一个场中出现，另一个场中不出现的闪动。选中这个选项会消除闪动。。不过老枯觉得好像这个和量化矩阵无关。 F. 系统： mpeg的系统是指视频+音频。vcd/svcd/dvd模版中已经设定好。

using System; using System.Collections.Generic; using System.Text; using System.ComponentModel; using System.Data; using System.Drawing; using System.Windows.Forms; using System.Runtime.InteropServices; namespace DS40XXSDK { #region enum ///

/// 板卡类型 ///

public enum BOARD_TYPE_DS : uint { DS400XM = 0, //M卡 DS400XH = 1, //H卡 DS4004HC = 2, //4004HC DS4008HC = 3, //4008HC DS4016HC = 4, //4016HC DS4001HF = 5, //4001HF DS4004HF = 6, //4004HF DS4002MD = 7, //4002MD DS4004MD = 8, //4004MD DS4016HCS = 9, //4016HCS DS4002HT = 10, //4002HT DS4004HT = 11, //4004HT DS4008HT = 12, //4008HT DS4004HC_PLUS = 13, //4004HC+ DS4008HC_PLUS = 14, //4008HC+ DS4016HC_PLUS = 15, //4016HC+ DS4008HF = 16, //4008HF DS4008MD = 17, //4008MD DS4008HS = 18, //4008HS DS4016HS = 19, //4016HS INVALID_BOARD_TYPE = 0xffffffff, } ///

/// 视频预览格式 ///

public enum TypeVideoFormat { vdfRGB8A_233 = 0x00000001, vdfRGB8R_332 = 0x00000002, vdfRGB15Alpha = 0x00000004, ///

/// 16位RGB视频压缩格式 ///

vdfRGB16 = 0x00000008, ///

/// 24位RGB视频压缩格式 ///

vdfRGB24 = 0x00000010, vdfRGB24Alpha = 0x00000020, vdfYUV420Planar = 0x00000040, ///

/// YUV422视频压缩格式 ///

vdfYUV422Planar = 0x00000080, vdfYUV411Planar = 0x00000100, vdfYUV420Interspersed = 0x00000200, vdfYUV422Interspersed = 0x00000400, vdfYUV411Interspersed = 0x00000800, vdfYUV422Sequence = 0x00001000, /* U0, Y0, V0, Y1: For VO overlay */ vdfYUV422SequenceAlpha = 0x00002000, /* U0, Y0, V0, Y1: For VO overlay, with low bit for alpha blending */ vdfMono = 0x00004000, /* 8 bit monochrome */ vdfYUV444Planar = 0x00008000, }; ///

/// 视频制式 ///

public enum VideoStandard_t : uint { ///

/// 无视频信号 ///

StandardNone = 0x80000000, ///

/// NTSC制式 ///

StandardNTSC = 0x00000001, ///

/// PAL制式 ///

StandardPAL = 0x00000002, StandardSECAM = 0x00000004, } ; ///

/// 编码图像分辨率 ///

public enum PictureFormat_t { ENC_CIF_FORMAT = 0, ENC_QCIF_FORMAT = 1, ENC_2CIF_FORMAT = 2, ENC_4CIF_FORMAT = 3, ENC_QQCIF_FORMAT = 4, ENC_CIFQCIF_FORMAT = 5, ENC_CIFQQCIF_FORMAT = 6, ENC_DCIF_FORMAT = 7 }; ///

/// 码流控制方式 ///

public enum BitrateControlType_t { ///

/// 变码率 ///

brCBR = 0, ///

/// 恒定码率 ///

brVBR = 1, }; public enum FrameType_t { PktError = 0, PktIFrames = 0x0001, PktPFrames = 0x0002, PktBBPFrames = 0x0004, PktAudioFrames = 0x0008, PktMotionDetection = 0x00010, PktDspStatus = 0x00020, PktOrigImage = 0x00040, PktSysHeader = 0x00080, PktBPFrames = 0x00100, PktSFrames = 0x00200, PktSubIFrames = 0x00400, PktSubPFrames = 0x00800, PktSubBBPFrames = 0x01000, PktSubSysHeader = 0x02000 }; #endregion #region struct ///

/// 板卡信息结构体 ///

public struct DS_BOARD_DETAIL { ///

/// 板卡类型 ///

BOARD_TYPE_DS type; ///

/// 序列号 /// BYTE sn[16]; ///

[MarshalAs(UnmanagedType.ByValArray, SizeConst = 16)] byte[] sn; ///

/// 板卡包含的DSP个数 ///

uint dspCount; ///

/// 板卡上第一个DSP的索引 ///

uint firstDspIndex; ///

/// 板卡包含的编码通道个数 ///

uint encodeChannelCount; ///

/// 板卡上第一个编码通道的索引 ///

uint firstEncodeChannelIndex; ///

/// 板卡包含的解码通道个数 ///

uint decodeChannelCount; ///

/// 板卡上第一个解码通道的索引 ///

uint firstDecodeChannelIndex; ///

/// 板卡包含的视频输出通道个数 ///

uint displayChannelCount; ///

/// 板卡上第一个视频输出通道的索引 ///

uint firstDisplayChannelIndex; uint reserved1; uint reserved2; uint reserved3; ///

/// 硬件版本,format:major.minor.build,major:bit 16-19,minor: bit 8-15,build: bit 0-7 ///

uint version; } ///

/// DSP信息结构体 ///

public struct DSP_DETAIL { ///

/// 此DSP所包含的编码通道个数 ///

uint encodeChannelCount; ///

/// 此DSP上第一个编码通道在所有编码通道中的索引 ///

uint firstEncodeChannelIndex; ///

/// 此DSP所包含的解码通道个数 ///

uint decodeChannelCount; ///

/// 此DSP上第一个解码通道在所有解码通道中的索引 ///

uint firstDecodeChannelIndex; ///

/// 此DSP包含的显示通道个数 ///

uint displayChannelCount; ///

/// 此DSP上第一个显示通道在所有显示通道中的索引 ///

uint firstDisplayChannelIndex; uint reserved1; uint reserved2; uint reserved3; uint reserved4; } ///

/// 特殊功能结构体 ///

public struct CHANNEL_CAPABILITY { ///

/// 音频预览 ///

byte[] bAudioPreview; ///

/// 报警信号 ///

byte[] bAlarmIO; ///

/// 看家狗 ///

byte[] bWatchDog; } ///

/// 版本信息 ///

public struct PVERSION_INFO { ///

/// DSP版本号，DSP的BUILD号，用于软件升级时标明该版本的最后修改时间 ///

UInt64 DspVersion, DspBuildNum; ///

/// Driver版本号，Driver的BUILD号，用于软件升级时标明该版本的最后修改时间 ///

UInt64 DriverVersion, DriverBuildNum; ///

/// SDK版本号，SDK的BUILD号，用于软件升级时标明该版本的最后修改时间 ///

UInt64 SDKVersion, SDKBuildNum; } ///

/// 显示窗口内的矩形区域 ///

//[StructLayout(LayoutKind. //public struct RECT //{ // public Int32 left; // public Int32 top; // public Int32 right; // public Int32 bottom; //} ///

/// 帧统计信息结构体 ///

public struct PFRAMES_STATISTICS { ///

/// 视频帧 ///

UInt64 VideoFrames; ///

/// 音频帧 ///

UInt64 AudioFrames; ///

/// 丢失帧 ///

UInt64 FramesLost; ///

/// 丢失的码流（字节） ///

UInt64 QueueOverflow; ///

/// 当前的帧率（bps） ///

UInt64 CurBps; } ///

/// 版本信息结构体 ///

public struct PHW_VERSION { ///

/// DSP程序的版本号和Build号 ///

UInt64 DspVersion, DspBuildNum; ///

/// 驱动程序的版本号和Build号 ///

UInt64 DriverVersion, DriverBuildNum; ///

/// SDK 的版本号和Build号 ///

UInt64 SDKVersion, SDKBuildNum; } ///

/// 系统时间 ///

public struct SYSTEMTIME { ushort wYear; ushort wMonth; ushort wDayOfWeek; ushort wDay; ushort wHour; ushort wMinute; ushort wSecond; ushort wMilliseconds; } #endregion #region delegate ///

/// 原始图像流设置 /// /// typedef void (*IMAGE_STREAM_CALLBACK)(UINT channelNumber,void *context); ///

/// 通道号 /// 设备上下文 public delegate void IMAGE_STREAM_CALLBACK(uint channelNumber, IntPtr context); ///

/// 编码数据流直接读取回调函数 /// /// typedef int (*STREAM_DIRECT_READ_CALLBACK)(UInt64 channelNumber,void *DataBuf,DWORD Length,int FrameType,void *context); ///

/// 通道号 /// 缓冲区地址 /// 缓冲区长度 /// 缓冲区数据帧类型 /// 设备上下文 /// [UnmanagedFunctionPointer(CallingConvention.Cdecl)] //public delegate int STREAM_DIRECT_READ_CALLBACK(uint channelNumber, byte[] DataBuf, uint Length, FrameType_t FrameType, IntPtr context); public delegate int STREAM_DIRECT_READ_CALLBACK(int channelNumber, IntPtr DataBuf, int Length, FrameType_t FrameType, IntPtr context); //public unsafe delegate int STREAM_DIRECT_READ_CALLBACK(uint channelNumber, void * DataBuf, uint Length, int FrameType, IntPtr context); ///

/// 直接读取码流回调函数 /// /// typedef int (*STREAM_READ_CALLBACK)(UInt64 channelNumber, void *context) ///

/// 通道号 /// 设备上下文 /// public delegate int STREAM_READ_CALLBACK(UInt64 channelNumber, IntPtr context); ///

/// 移动侦测结果回调函数 /// /// typedef void (*MOTION_DETECTION_CALLBACK)(UInt64 channelNumber, BOOL bMotionDetected,void *context) ///

/// 通道号 /// /// 移动侦测发生标志，如果当前通道所设置的移动侦测 /// 区域内产生了移动侦测，则被置为True；如果当前通道所设置的移动侦测区域内自上 /// 一次产生移动侦测后delay秒内没有发生移动侦测，则被置为False。 /// /// 设备上下文 public delegate void MOTION_DETECTION_CALLBACK(UInt64 channelNumber, bool bMotionDetected, IntPtr context); ///

/// 画图回调函数 /// /// #define DRAWFUN(x) void (CALLBACK* x)(Int32 nPort,HDC hDc,Int32 nUser) ///

/// 通道号 /// offscreen表面设备上下文，相当于显示窗口中的DC /// 用户数据 public delegate void DrawFun(Int32 nPort, IntPtr HDC, Int32 nUser); ///

/// 解码回调函数 /// /// typedef void (*DECODER_VIDEO_CAPTURE_CALLBACK)(UINT nChannelNumber, void *DataBuf,UINT width,UINT height,UINT nFrameNum,UINT nFrameTime, SYSTEMTIME *pFrameAbsoluteTime,void *context) ///

/// 解码通道句柄 /// 缓冲区地址 /// 图像宽度 /// 图像高度 /// 捕获的当前帧的序号 /// 捕获的当前帧的相对时间，单位：毫秒 /// 捕获的当前帧的绝对时间 /// 设备上下文 public delegate void DECODER_VIDEO_CAPTURE_CALLBACK(uint nChannelNumber, IntPtr DataBuf, uint width, uint height, uint nFrameNum, uint nFrameTime, SYSTEMTIME pFrameAbsoluteTime, IntPtr context); ///

/// 创建索引完成回调函数 /// /// typedef void (*FILE_REF_DONE_CALLBACK)(UINT nChannel,UINT nSize) ///

/// 通道号 /// 索引大小（暂时无效，以后可以增加索引导出、导入功能） public delegate void FILE_REF_DONE_CALLBACK(uint nChannel, uint nSize); #endregion ///

/// DS40xxSDK.dll ///

public class HikVisionSDK { ///

/// 状态 ///

public static readonly List state = new List(new string[]{ "", "正在打开", "音频信号丢失", "视频信号丢失", "有物体移动", //0-4 "自动分割录像", "开始录像", "停止录像", "启动声音监听", "停止声音监听", //5-9 "启动视频预览", "停止视频预览", "启动录像", "停止录像", "启动视频报警", //10-14 "关闭视频报警", "启动音频报警", "停止音频报警", "启动移动侦测", "停止移动侦测", //15-19 "启动视频遮挡", "关闭视频遮挡", "开始屏幕输出", "停止屏幕输出", "启动视频LOGO", //20-24 "停止视频LOGO", "开始视频OSD", "停止视频OSD", "切换为黑白视频", "切换为彩色视频", //25-29 "切换为黑屏显示", "切换为白屏显示", "视频色彩复位", "启动全屏显示", "采集卡已经加载", //30-34 "采集卡已经卸截", "视频服务启动成功", "视频服务已停止", "静音", "音量恢复", //35-39 "云台控制命令发送", "系统出现未知错误", "录像文件大小", "配置端口号成功", "连接服务端成功", //40-44 "正在连接", "开始接收图象", "异常退出", "接收完毕，退出", "无法联系服务端", //45-49 "服务端拒绝访问", "无效", "停止客户端连接", "图像抓取成功", "初始化服务端网络连接成功", //50-54 "视频服务启动失败", "退出全屏预览", "", "", "" //55-59 }); //可以用新版函数替代功能或者无效的API //GetTotalChannels：可用GetEncodeChannelCount替代 //GetTotalDSPs：可用GetDspCount 替代 //SetupDateTime：4.0版本起无效 //HW_GetChannelNum：无效，请使用GetBoardDetail //HW_GetDeviceSerialNo：无效，请使用GetBoardDetail //HW_SetVideoOutStandard：无效，请使用SetDisplayStandard或SetDefaultVideoStandard //HW_SetDspDeadlockMsg：无效 //HW_ResetDsp：无效 //HW_SetDisplayPara：DISPLAY_PARA结构中bToVideoOut无效，MD卡模拟视频输出功能 //已经整合到视频矩阵之中。 #region 流类型宏定义 ///

/// 视频流 /// #define STREAM_TYPE_VIDEO ///

private const int STREAM_TYPE_VIDEO = 1; ///

/// 音频流 /// #define STREAM_TYPE_AUDIO ///

private const int STREAM_TYPE_AUDIO = 2; ///

/// 音视频复合流 /// #define STREAM_TYPE_AVSYNC ///

private const int STREAM_TYPE_AVSYNC = 3; #endregion #region 1.板卡初始化及卸载 ///

/// 1.1初始化DSP InitDSPs /// 说明：初始化系统中每一块板卡，应在应用软件程序启动时完成。如果返回值为0则表 /// 明初始化失败，可能没有找到相应的DSP软件模块。 /// /// int __stdcall InitDSPs() ///

/// 系统内可用的编码通道个数。 [DllImport("DS40xxSDK.dll")] public static extern int InitDSPs(); ///

/// 1.2卸载DSP DeInitDSPs /// 说明：关闭每一块板卡上的功能，应在应用软件程序退出时调用。 /// /// int __stdcall DeInitDSPs() ///

/// 0 [DllImport("DS40xxSDK.dll")] public static extern int DeInitDSPs(); #endregion #region 2.板卡信息获取 ///

/// 2.1获取系统中板卡的张数GetBoardCount /// 说明：获取系统中所有板卡的张数，包含编码卡和解码卡。 /// /// unsigned int __stdcall GetBoardCount() ///

/// 系统中板卡的总张数。 [DllImport("DS40xxSDK.dll")] public static extern uint GetBoardCount(); ///

/// 2.2获取系统中DSP的个数GetDspCount /// 说明：获取系统中所有板卡的DSP的个数。 /// /// unsigned int __stdcall GetDspCount() ///

/// 系统中DSP的总个数 [DllImport("DS40xxSDK.dll")] public static extern uint GetDspCount(); ///

/// GetTotalDSPs：可用GetDspCount 替代 /// 获得实际可用DSP ///

/// [DllImport("DS40xxSDK.dll")] public static extern int GetTotalDSPs(); ///

/// 2.3获取系统中编码通道的个数GetEncodeChannelCount /// 说明：获取系统中所有编码卡的编码通道总个数，包含H系列和HC系列编码卡。 /// /// unsigned int __stdcall GetEncodeChannelCount() ///

/// 系统中编码通道的个数 [DllImport("DS40xxSDK.dll")] public static extern uint GetEncodeChannelCount(); ///

/// 2.4获取系统中解码通道的个数GetDecodeChannelCount /// 说明：获取系统中MD卡的解码通道个数 /// /// unsigned int __stdcall GetDecodeChannelCount() ///

/// [DllImport("DS40xxSDK.dll")] public static extern uint GetDecodeChannelCount(); ///

/// 2.5获取系统中解码显示通道的个数GetDisplayChannelCount /// 说明：获取系统中MD卡显示通道的个数，即模拟视频输出通道的个数 /// /// unsigned int __stdcall GetDisplayChannelCount() ///

/// 系统中显示通道的个数 [DllImport("DS40xxSDK.dll")] public static extern uint GetDisplayChannelCount(); ///

/// 2.6获取板卡详细信息GetBoardDetail /// 说明：获取某张板卡的详细信息 /// /// int __stdcall GetBoardDetail(UINT boardNum,DS_BOARD_DETAIL *pBoardDetail) ///

/// 板卡索引 /// 板卡信息 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int GetBoardDetail(uint boardNum, ref DS_BOARD_DETAIL pBoardDetail); ///

/// 2.7获取DSP详细信息GetDspDetail /// 说明：获取某个DSP的详细信息 /// /// int __stdcall GetDspDetail(UINT dspNum,DSP_DETAIL *pDspDetail) ///

/// DSP索引 /// DSP信息 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int GetDspDetail(uint dspNum, ref DSP_DETAIL pDspDetail); ///

/// 2.8获取板卡型号及序列号信息GetBoardInfo /// 说明：获取板卡的型号及序列号信息 /// /// int __stdcall GetBoardInfo(HANDLE hChannelHandle, UInt64 *BoardType, UCHAR *SerialNo) ///

/// 通道句柄 /// 板卡型号 /// /// 板卡ID号, 内容为板卡序列号的ASCII的数值，次序为SerialNo[0] 对应最高位， /// SerialNo[11]对应最低位。比如卡号为“40000002345”的值对应为 4,0,0,0,0,1,0,0,2,3,4,5 的整形数组。 /// /// 成功为0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int GetBoardInfo(IntPtr hChannelHandle, UInt64 BoardType, byte[] SerialNo); ///

/// 2.9获取板卡特殊功能信息GetCapability /// 说明：获取板卡特殊功能信息 /// /// int __stdcall GetCapability(HANDLE hChannelHandle, CHANNEL_CAPABILITY *Capability) ///

/// 通道句柄 /// 特殊功能 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int GetCapability(IntPtr hChannelHandle, CHANNEL_CAPABILITY Capability); ///

/// 2.10获取板卡SDK信息GetSDKVersion /// 说明：获取当前所使用的DSP、Driver、SDK版本号 /// /// int __stdcall GetSDKVersion(PVERSION_INFO VersionInfo) ///

/// 版本信息 /// 成功返回0；失败返回错误号。 [DllImport("DS40xxSDK.dll")] public static extern int GetSDKVersion(ref PVERSION_INFO VersionInfo); ///

/// 2.11获取板卡SDK及DSP错误报告GetLastErrorNum*，此函数只对H卡有效 /// 说明：获取SDK及DSP错误报告。此函数只对H卡有效，用于HC卡上返回0且无效 /// /// int __stdcall GetLastErrorNum(HANDLE hChannelHandle, UInt64 *DspError, UInt64 *SdkError) ///

/// 通道句柄 /// DSP错误 /// SDK错误 /// DSP错误信息、SDK错误信息 [DllImport("DS40xxSDK.dll")] public static extern int GetLastErrorNum(IntPtr hChannelHandle, ref int DspError, ref int SdkError); #endregion #region 3.编码卡API #region 3.1通道打开及关闭 ///

/// 3.1.1打开通道ChannelOpen /// 说明：打开通道，获取编码通道的操作句柄，与通道相关的操作需使用相对应的句柄。 /// /// HANDLE __stdcall ChannelOpen(int ChannelNum) ///

/// 通道号（从0开始） /// 成功返回有效句柄（值可能为0）；失败返回0xFFFFFFFF。 [DllImport("DS40xxSDK.dll")] public static extern IntPtr ChannelOpen(int ChannelNum); ///

/// 3.1.2关闭通道ChannelClose /// 说明：关闭通道，释放相关资源 /// /// int __stdcall ChannelClose(HANDLE hChannelHandle) ///

/// 通道句柄 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int ChannelClose(IntPtr hChannelHandle); #endregion #region 3.2视频预览 #region 3.2.1 Overlay预览模式 // 释义： overlay预览模式 //Overlay通常被称为重叠页面或者是覆盖层，是一种需要特定的硬件支持的页面，通常 //被用于显示实时视频于主页面之上，而不需要Blit操作到主页面或用任何方法改变主页面的 //内容。使用该方式进行预览可以提高预览的画质和降低CPU利用率。 ///

/// 3.2.1.1设置视频预览模式SetPreviewOverlayMode /// 说明： SDK自3.2版本起在部分显卡中实现了HC卡以overlay方式预览的功能（此功 /// 能不支持与H卡混插的状态下），可以提高预览的画质和降低CPU利用率。当预览画面小 /// 于704*576时，需要调用该函数来启动overlay模式，如不设置则自动切换到offscreen模式 /// 进行预览显示，当预览画面大于704*576时，SDK自动切换到overlay模式 /// /// int __stdcall SetPreviewOverlayMode(BOOL bTrue) ///

/// 是否设置overlay预览方式，也适用于MD卡 /// 0表示显卡支持板卡的overlay预览方式；其他值表示显卡不支持 [DllImport("DS40xxSDK.dll")] public static extern int SetPreviewOverlayMode(bool bTrue); ///

/// 3.2.1.2设置overlay关键色SetOverlayColorKey /// 注意：需要在StartVideoPreview前调用该函数。 /// 说明：板卡在显示范围小于704*576时，调用SetPreviewOverlayMode可以开启overlay /// 预览模式，需调用SetOverlayColorKey设置overlay关键色；当显示范围大于704*576时， /// 板卡自动切换到overlay预览模式，关键色默认设置为RGB（10，10，10），也可调用 /// SetOverlayColorKey修改关键色。在这两种情况下，都需要将显示窗口的底色设置为和关键 /// 色相一致。否则图像将难以显示。 /// /// /// int __stdcall SetOverlayColorKey(COLORREF DestColorKey) ///

/// overlay关键色参数（RGB（*，*，*）） /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetOverlayColorKey(int DestColorKey); //public static extern int SetOverlayColorKey(Color DestColorKey); ///

/// 3.2.1.3恢复当前丢失的表面RestoreOverlay /// 说明：恢复当前丢失的表面，例如：当系统按下CTRL+ALT+DEL时系统的OVERLAY /// 表面会被强制关闭，调用该函数可以恢复OVERLAY表面 /// /// int __stdcall RestoreOverlay() ///

/// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int RestoreOverlay(); #endregion #region 3.2.2 开启及停止视频预览 ///

/// 3.2.2.1开启视频预览StartVideoPreview /// 说明：启动视频预览，调用SetPreviewOverlayMode后，可进行overlay模式预览，否则， /// 将默认采用offscreen模式预览。当画面大于704*576时，SDK自动切换到overlay预览模式。 /// /// int __stdcall StartVideoPreview(HANDLE hChannelHandle,HWND WndHandle, RECT *rect,BOOLEAN bOverlay, int VideoFormat, int FrameRate) ///

/// 通道句柄 /// 显示窗口句柄 /// /// 显示窗口内的矩形区域 /// Rect.right 必须为8的倍数 /// Rect.bottom必须为16的倍数 /// /// 是否启用Overlay预览模式 /// 视频预览格式（目前无效） /// 视频预览帧率（PAL：1-25，NTSC：1-30） /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int StartVideoPreview(IntPtr hChannelHandle, IntPtr WndHandle, ref Rectangle rect, bool bOverlay, int VideoFormat, int FrameRate); //public static extern int StartVideoPreview(IntPtr hChannelHandle, IntPtr WndHandle, ref RECT rect, bool bOverlay, int VideoFormat, int FrameRate); ///

/// 3.2.2.2停止视频预览StopVideoPreview /// 说明：停止视频预览 /// /// int __stdcall StopVideoPreview(HANDLE hChannelHandle) ///

/// 通道句柄 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int StopVideoPreview(IntPtr hChannelHandle); #endregion #region 3.2.3 视频参数的设置及获取 ///

/// 3.2.3.1设置视频参数SetVideoPara /// 说明：设置视频参数 /// /// int __stdcall SetVideoPara(HANDLE hChannelHandle, int Brightness, int Contrast, int Saturation, int Hue) ///

/// 通道句柄 /// 亮度值（0-255） /// 对比度（0-127） /// 饱和度（0-127） /// 色调（0-255） /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetVideoPara(IntPtr hChannelHandle, int Brightness, int Contrast, int Saturation, int Hue); ///

/// 3.2.3.2获取视频参数GetVideoPara /// 说明：获取视频参数 /// /// int __stdcall GetVideoPara(HANDLE hChannelHandle, VideoStandard_t *VideoStandard, int*Brightness, int *Contrast, int *Saturation, int *Hue) ///

/// 通道句柄 /// 视频制式 /// 亮度指针值（0-255） /// 对比度指针值（0-127） /// 饱和度指针值（0-127） /// 色调指针值（0-255） /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int GetVideoPara(IntPtr hChannelHandle, VideoStandard_t VideoStandard, out int Brightness, out int Contrast, out int Saturation, out int Hue); #endregion #endregion #region 3.3视频信号设置（制式、状况、输入位置等） ///

/// 3.3.1设置视频制式SetVideoStandard，此函数只对H卡有效 /// 说明：设置视频制式，在某一制式的摄像头已经接好的情况下启动系统时可不必调用该 /// 函数，如果没有接摄像头的情况下启动系统然后再接NTSC制式的摄像头则必须调用该函 /// 数，或者中途调换不同制式的摄像头也必须调用该函数。 /// /// int __stdcall SetVideoStandard(HANDLE hChannelHandle, VideoStandard_t VideoStandard) ///

/// 通道句柄 /// 视频制式 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetVideoStandard(IntPtr hChannelHandle, VideoStandard_t VideoStandard); ///

/// 3.3.2设置系统默认的视频制式SetDefaultVideoStandard /// 注意：该函数只能在系统初始化（InitDSPs）之前运行，否则无效 /// 说明：设置系统默认的视频制式，系统中所有的视频输入通道如果无视频输入或者在系 /// 统启动的时候，通道会按照所设置的系统默认视频制式进行处理。 /// /// int __stdcall SetDefaultVideoStandard(VideoStandard_t VideoStandard) ///

/// 视频制式，默认为PAL /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetDefaultVideoStandard(VideoStandard_t VideoStandard); ///

/// 3.3.3设置视频信号灵敏度SetVideoDetectPrecision /// 说明：设置视频信号检测的灵敏度。如果视频信号的强度比较弱，或者信号通断的切换 /// 比较频繁，会出现“无视频信号”的提示字样，为了避免提示字样影响图像，可以更改视频 /// 信号检测的灵敏度。灵敏度取值越大，检测精度越低，出现“无视频信号”提示字样的频率 /// 越低。当将value值设置为0xffffffff时，将不会再出现“无视频信号”的提示字样。 /// /// int __stdcall SetVideoDetectPrecision(HANDLE hChannel,unsigned int value) ///

/// 通道句柄 /// 灵敏度。取值范围：0-100，默认为20 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetVideoDetectPrecision(IntPtr hChannel, uint value); ///

/// 3.3.4获取视频信号输入情况GetVideoSignal /// 说明：获取视频信号的输入情况，用于视频丢失报警 /// /// int __stdcall GetVideoSignal(HANDLE hChannelHandle) ///

/// 通道句柄 /// 信号正常返回0；返回其他值说明信号异常或有错误 [DllImport("DS40xxSDK.dll")] public static extern int GetVideoSignal(IntPtr hChannelHandle); ///

/// 3.3.5调整视频信号输入位置SetInputVideoPosition /// 说明：设置视频信号的输入位置。（x，y）为系统处理图像的左上角在摄像机输入的原 /// 始图像中的坐标，某些摄像机输入的图像在预览时可能在左边会有黑边，可以通过此函数进 /// 行调节，x必须设置为2的整数倍。（x，y）的取值和摄像机的型号有关，如果指定的值和 /// 摄像机的输入参数不匹配，可能会导致图像静止、水平垂直方向滚动或者黑屏，请谨慎使用。 /// /// int __stdcall SetInputVideoPosition(HANDLE hChannel,UINT x,UINT y) ///

/// 通道句柄 /// X轴坐标，默认值为8 /// Y轴坐标，默认值为2 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetInputVideoPosition(IntPtr hChannel, uint x, uint y); ///

/// 3.3.6设置反隔行变换及强度SetDeInterlace /// 说明：设置是否采用反隔行算法，已经采用反隔行时的强度 /// /// 释义：反隔行变换 /// 如果该通道的图像需要进行4CIF的预览或编码，此时的图像中会同时包含奇、偶两 /// 场的数据，由于奇场图像和偶场图像不同步，导致图像中运动的部分发生错位、边缘模糊， /// 此时需要对图像进行反隔行变换来去掉这种现象。如果用户能够确定使用的是逐行扫描格式 /// 的摄像机，或者主要应用在静止场景，此时可以关掉反隔行变换功能，或者降低强度，这样 /// 可以提高系统运行效率，并降低反隔行变换对图像质量带来的损失。 /// /// int __stdcall SetDeInterlace(HANDLE hChannelHandle,UINT mode,UINT level) ///

/// 通道句柄 /// /// 0表示该通道不进行反隔行变换,此时level参数无效； /// 1表示使用旧的算法； /// 2表示使用默认算法（系统默认值）。 /// /// /// mode＝1时有效，其它时无效。 /// 0－10，反隔行变换的强度逐渐加强，0最弱，对图像的损失最小，10最强，对图像的损失最大。 /// /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetDeInterlace(IntPtr hChannelHandle, uint mode, uint level); #endregion #region 3.4视频编码参数设置 // 释义：双编码功能（主、子通道） // 对一路视频图像进行两路视频编码，两路视频可以有不同的码流类型、不同分辨率、不 //同码率等。3.0版本对双编码功能做了增强，子通道的所有参数都可以任意设置。 //双编码中主通道和子通道唯一的区别在于：子通道占用的系统资源比主通道少，优先级 //比主通道低。当系统忙时，会尽量保证主通道编码，并先从子通道开始丢帧。由于占用资源 //少，因此可以利用子通道来实现多路高分辨率的非实时编码。例如：可以把DS-4000HC中 //的每个子通道全部设置为4CIF分辨率（SetSubStreamType），而不使用主通道编码，这样就 //可以实现全部通道的4CIF编码。在一般场景下，每路图像都可以达到15帧以上。 ///

/// 3.4.1主、子通道切换SetupSubChannel /// 说明：配合双编码模式使用。当设置某个通道为双编码模式时，如主通道编码CIF，子 /// 通道编码QCIF，这时可对主/子通道分别设置某些参数。关键帧间隔、OSD、LOGO等参数 /// 对主/子通道是一样的；在设置帧率、量化系数、变码流/定码流模式、码流大小等参数时应 /// 调用此函数分别对主/子通道进行设置，缺省是对主通道进行设置 /// /// int __stdcall SetupSubChannel(HANDLE hChannelHandle, int iSubChannel) ///

/// 通道句柄 /// 子通道号（0表示主通道，1表示主通道） /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetupSubChannel(IntPtr hChannelHandle, int iSubChannel); ///

/// 3.4.2获取双编码时数据流类型GetSubChannelStreamType /// 说明：配合双编码模式使用，当设置双编码模式时，启动录像后，DSP会向上送两种 /// 数据流，调用此函数得到主通道和子通道的数据流类型，供应用程序使用。 /// /// int __stdcall GetSubChannelStreamType(void *DataBuf, int FrameType) ///

/// 数据缓存区 /// 帧类型 /// /// 0 其他数据 /// 1 主通道数据流的文件头 /// 2 子通道数据流的文件头 /// 3 主通道数据流的视频帧类型 /// 4 子通道数据流的视频帧类型 /// 5 数据流的音频帧 /// [DllImport("DS40xxSDK.dll")] public static extern int GetSubChannelStreamType(IntPtr DataBuf, int FrameType); #region 3.4.3编码流类型的设置及获取（不支持动态修改） ///

/// 3.4.3.1设置主通道编码流类型SetStreamType /// 说明：设置主通道编码流类型。此函数需在启动编码前进行设置 /// /// int __stdcall SetStreamType(HANDLE hChannelHandle, USHORT Type) ///

/// 通道句柄 /// 流类型 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetStreamType(IntPtr hChannelHandle, ushort Type); ///

/// 3.4.3.2获取主通道编码流类型GetStreamType /// 说明：获取主通道编码流类型 /// /// int __stdcall GetStreamType(HANDLE hChannelHandle, USHORT *StreamType) ///

/// 通道句柄 /// 流类型 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int GetStreamType(IntPtr hChannelHandle, ref ushort StreamType); ///

/// 3.4.3.3设置子通道编码流类型SetSubStreamType /// 说明：设置子通道编码流类型，此函数需在启动编码前进行设置 /// /// int __stdcall SetSubStreamType(HANDLE hChannelHandle, USHORT Type) ///

/// 通道句柄 /// 流类型 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetSubStreamType(IntPtr hChannelHandle, ref ushort Type); ///

/// 3.4.3.4获取子通道编码流类型GetSubStreamType /// 说明：获取子通道编码流类型 /// /// int __stdcall GetSubStreamType(HANDLE hChannelHandle, USHORT *StreamType) ///

/// 通道句柄 /// 流类型 /// [DllImport("DS40xxSDK.dll")] public static extern int GetSubStreamType(IntPtr hChannelHandle, ref ushort StreamType); #endregion #region 3.4.4（支持动态修改）的编码参数设置 ///

/// 3.4.4.1设置编码图像质量SetDefaultQuant /// 说明：设置图像量化系数，用于调整图像质量。量化系数越小图像质量越高。系统默认量化系数值为18，18，23。 /// 释义：量化系数 /// 量化系数是强烈影响MPEG标准中编码图像质量和码率的参数，当量化系数越低，图 /// 像质量就会越高，码率也就越高，反之，图形质量就会越低，码率也就越低 /// /// int __stdcall SetDefaultQuant(HANDLE hChannelHandle, int IQuantVal, int PQuantVal, int BQuantVal) ///

/// 通道句柄 /// I帧量化系数，取值范围：12-30 /// P帧量化系数。取值范围：12-30(目前无效) /// B帧量化系数。取值范围：12-30（目前无效） /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetDefaultQuant(IntPtr hChannelHandle, int IQuantVal, int PQuantVal, int BQuantVal); ///

/// 3.4.4.2设置编码帧结构、帧率SetIBPMode /// 说明：设置编码帧结构和帧率。支持动态修改 /// 释义：关键帧间隔 /// 关键帧为编码码流中采用帧内压缩的图像帧，其特点是图像清晰度好，但数据量大，通 /// 常作为帧间编码的原始参考帧。关键帧间隔是连续的帧间编码的帧个数，因H264(MPEG4) /// 编码是有损压缩，关键帧的个数会影响图像质量，因此关键帧的间隔需要合理设计。 /// /// int __stdcall SetIBPMode(HANDLE hChannelHandle, int KeyFrameIntervals, int BFrames, int PFrames, int FrameRate) ///

/// 通道句柄 /// 关键帧间隔。取值范围１-400，系统默认为100 /// B帧数量，取值为0或者2，系统默认为2 /// P帧数量。目前暂取值无效 /// 帧率，帧率范围1-25（PAL）、1-30（NTSC） /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetIBPMode(IntPtr hChannelHandle, int KeyFrameIntervals, int BFrames, int PFrames, int FrameRate); #region 3.4.4.3设置编码分辨率 ///

/// 3.4.4.3.1设置主通道分辨率SetEncoderPictureFormat /// 说明：设置主通道编码分辨率。支持动态修改。 /// /// int __stdcall SetEncoderPictureFormat(HANDLE hChannelHandle, PictureFormat_t PictureFormat) ///

/// 通道句柄 /// 编码图像分辨率（4CIF、DCIF、2CIF、CIF、QCIF） /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetEncoderPictureFormat(IntPtr hChannelHandle, PictureFormat_t PictureFormat); ///

/// 3.4.4.3.2设置子通道编码分辨率SetSubEncoderPictureFormat /// 说明：设置双编码模式时子通道的编码分辨率，支持动态修改。 /// /// int __stdcall SetSubEncoderPictureFormat(HANDLE hChannelHandle, PictureFormat_t PictureFormat) ///

/// 子通道句柄 /// 子通道编码图像分辨率（4CIF、DCIF、2CIF、CIF、 QCIF） /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetSubEncoderPictureFormat(IntPtr hChannelHandle, PictureFormat_t PictureFormat); #endregion #region 3.4.4.4设置码率及码流控制模式 ///

/// 3.4.4.4.1设置码流最大比特率SetupBitrateControl /// 说明：设置编码的最大比特率。设置为0时码流控制无效，设置为某一最大比特率时， /// 当编码码流超过该值时，DSP会自动调整编码参数来保证不超过最大比特率，当编码码流 /// 低于最大比特率时，DSP不进行干涉。调整误差<10% /// /// int __stdcall SetupBitrateControl(HANDLE hChannelHandle, UInt64 MaxBps) ///

/// 通道句柄 /// 最大比特率。取值：10000以上 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetupBitrateControl(IntPtr hChannelHandle, Int32 MaxBps); ///

/// 3.4.4.4.2设置码流控制方式SetBitrateControlMode /// 说明：设置编码码流控制方式。配合SetupBitrateControl使用。当设置为变码率（brVBR） /// 时，最大比特率将作为编码码流上限，由DSP在码流上限下自动控制码率，一般会自动回 /// 落到最低的状态（由设定的图像质量参数和关键帧间隔决定），能最大程度地降低带宽和存 /// 储空间，但存储容量一般难以估算；当设置为定码率（brCBR）时，以最大比特率作为编码 /// 码率参数恒定输出码流，不会自动回落到低码流状态，存储容量可根据设定码率的大小进行估算。 /// /// int __stdcall SetBitrateControlMode(HANDLE hChannelHandle, BitrateControlType_t brc) ///

/// 通道句柄 /// 码流控制方式，分为变码率（brVBR）和恒定码率（brCBR）两种方式 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetBitrateControlMode(IntPtr hChannelHandle, BitrateControlType_t brc); #endregion ///

/// 3.4.5强制设定I帧CaptureIFrame /// 说明：将当前编码帧强制设定为I帧模式，可从码流中提取该帧单独用于网络传送。 /// /// int __stdcall CaptureIFrame(HANDLE hChannelHandle) ///

/// 通道句柄 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int CaptureIFrame(IntPtr hChannelHandle); ///

/// 3.4.6获取帧统计信息GetFramesStatistics /// 说明：获取帧统计信息 /// /// int __stdcall GetFramesStatistics(HANDLE hChannelHandle,PFRAMES_STATISTICS framesStatistics) ///

/// 通道句柄 /// 帧统计信息 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int GetFramesStatistics(IntPtr hChannelHandle, PFRAMES_STATISTICS framesStatistics); #endregion #endregion #region 3.5数据捕获 #region 3.5.1抓图（获取单帧图像数据） #region 3.5.1.1抓取BMP格式图像 ///

/// 3.5.1.1.1获取原始yuv422格式数据GetOriginalImage /// 说明：获得原始yuv422格式图像，DS4000HC原始图像是4CIF图像格式(包括QCIF编码)， /// DS-4000HS原始图像为CIF图像格式，DS400xH卡的原始图象是CIF图象格式。 /// /// int __stdcall GetOriginalImage(HANDLE hChannelHandle, UCHAR *ImageBuf, UInt64 *Size) ///

/// 通道句柄 /// 原始yuv422格式图像指针 /// 原始yuv422格式图像尺寸，函数调用前是ImageBuf的大小，调用后是实际图像所占用的字节数 /// 成功返回0，失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int GetOriginalImage(IntPtr hChannelHandle, byte[] ImageBuf, out int Size); ///

/// 3.5.1.1.2图像格式转换YUVtoBMP SaveYUVToBmpFile /// 说明：用户程序可调用此函数来生成24位的bmp文件，如果是DS4000HC卡抓图则 /// Width 为704，Height 为576PAL/480NTSC，如果是DS400xH卡抓图则Width可能为352 /// 或176，Height为288、240、144或120，要根据缓冲区的大小来判断。 /// /// int __stdcall SaveYUVToBmpFile(char *FileName, unsigned char *yuv, int Width, int Height) ///

/// 文件名 /// yuv422格式图像指针 /// 图像宽度 /// 图像高度 /// [DllImport("DS40xxSDK.dll")] public static extern int SaveYUVToBmpFile(string FileName, byte[] yuv, int Width, int Height); ///

/// 3.5.1.2抓取JPEG格式图像GetJpegImage /// 说明：抓取JPEG格式图像 /// /// int __stdcall GetJpegImage(HANDLE hChannelHandle,UCHAR *ImageBuf, UInt64 *Size,UINT nQuality) ///

/// 通道句柄 /// JPEG图像指针 /// JPEG图像尺寸，函数调用前是ImageBuf的大小，调用后是实际图像所占用的字节数 /// JPEG图像质量，取值范围1-100，取值100时质量最好 /// [DllImport("DS40xxSDK.dll")] public static extern int GetJpegImage(IntPtr hChannelHandle, byte[] ImageBuf, out int Size, uint nQuality); #endregion #region 3.5.2原始图像数据流捕获（获取YUV420格式数据流） ///

/// 3.5.2.1注册原始图像数据流回调函数RegisterImageStreamCallback /// 说明：注册获取原始图像数据流函数，用户可以获取实时的YUV420格式的预览数据 /// /// int __stdcall RegisterImageStreamCallback (IMAGE_STREAM_CALLBACK ImageStreamCallback,void *context) ///

/// 原始图像数据流回调函数 /// 设备上下文 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int RegisterImageStreamCallback(IMAGE_STREAM_CALLBACK ImageStreamCallback, IntPtr context); ///

/// 3.5.2.2开启及停止原始数据流捕获SetImageStream /// 说明：开启或停止原始图像数据流捕获，此函数依赖主机的处理速度。DS-4000HS只能捕获不大于CIF格式的数据流 /// /// 函数： int __stdcall SetImageStream(HANDLE hChannel,BOOL bStart,UINT fps, UINT width,UINT height,unsigned char *imageBuffer) ///

/// 通道句柄 /// 是否启动捕获 /// 帧率 /// 图像宽度，必须是4CIF宽度的1/8，1/4，1/2或原始大小704 /// 图象高度，必须是4CIF高度的1/8，1/4，1/2或原始大小576PAL/480NTSC /// 数据存储缓存 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetImageStream(IntPtr hChannel, bool bStart, uint fps, uint width, uint height, char[] imageBuffer); #endregion #region 3.5.3编码数据流捕获（获取编码后H.264格式数据流）即录像 //注意：注册直接回调或者消息回调后，需要启动编码数据流捕获函数才能进行数据回调。三 //种数据回调方式，只需选取其中一种使用即可。对于HC系列板卡（包括HC、HC+、HCS、 //HS），推荐使用第一种读取方式。对于H系列板卡，只能使用后两种读取方式。 #region 3.5.3.1编码数据流捕获方式设置 ///

/// 3.5.3.1.1.1注册编码图像数据流直接读取回调函数 /// 说明： DS4000HC系列板卡新增的一种数据流读取方式，当启动数据捕获后， /// StreamDirectReadCallback会提供数据流的地址、长度、帧类型等，供用户程序直接处理。 /// /// 函数： int __stdcall RegisterStreamDirectReadCallback (STREAM_DIRECT_READ_CALLBACK StreamDirectReadCallback,void *Context) ///

/// 编码数据流直接读取回调函数 /// 设备上下文 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int RegisterStreamDirectReadCallback(STREAM_DIRECT_READ_CALLBACK StreamDirectReadCallback, IntPtr context); #endregion #region 3.5.3.1.2方式二、消息读取方式 ///

/// 3.5.3.1.2.1设置消息读取伐值，此函数只对H卡有效 /// 说明：设置消息读取的伐值，可以将缓冲区的数据在OnDataReady中一次性取走 /// /// int __stdcall SetupNotifyThreshold(HANDLE hChannelHandle, int iFramesThreshold) ///

/// 通道句柄 /// 读取消息伐值，范围1-10 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int SetupNotifyThreshold(IntPtr hChannelHandle, int iFramesThreshold); ///

/// 3.5.3.1.2.2注册消息读取码流函数 /// 说明：当数据准备好时，SDK会向hWnd窗口发送MessageId消息，目标窗口收到 /// Message后调用ReadStreamData读取一帧数据。如果HC卡与H卡混插，可以先调用 /// RegisterStreamDirectReadCallback函数来注册HC卡取码流回调函数，再调用 /// RegisterMessageNotifyHandle函数来注册H卡取码流消息函数。 /// HC系列板卡建议使用方式一进行数据捕获。 /// /// int __stdcall RegisterMessageNotifyHandle(HWND hWnd, UINT MessageId) ///

/// 通道句柄 /// 自定义消息 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int RegisterMessageNotifyHandle(IntPtr hWnd, uint MessageId); #endregion #region 3.5.3.1.3方式三、另一种直接读取方式 ///

/// 3.5.3.1.3.1注册直接读取码流回调函数 /// 说明：另一种数据流读取方式 /// /// int __stdcall RegisterStreamReadCallback (STREAM_READ_CALLBACK StreamReadCallback, void *Context) ///

/// 直接读取码流回调函数 /// 设备上下文 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int RegisterStreamReadCallback(STREAM_READ_CALLBACK StreamReadCallback, IntPtr Context); #endregion ///

/// 3.5.3.2读取码流函数 /// 说明：读指定长度的数据流，适用于方式二及方式三。当调用StartVideoCapture 或 /// StartMotionDetection后，SDK线程会向已注册的用户窗口消息处理函数发送指定的消息， /// 并提供消息来源的通道号。当用户程序收到该消息时，可调用本函数来读取数据，Length 在 /// 作为输入时必须提供缓冲的大小，ReadStreamData会判断缓冲是否足够，如果缓冲足够大 /// 则返回值为当前的读取的帧长度，否则返回错误。 /// 在HC卡中，如果已经先调用了RegisterStreamDirectReadCallback()函数，则不需调用 /// ReadStreamData来读取数据，因为音视频数据会在RegisterStreamDirectReadCallback所注册 /// 的回调函数中直接返回。 /// /// int __stdcall ReadStreamData(HANDLE hChannelHandle, void *DataBuf, DWORD *Length, int *FrameType) ///

/// 通道句柄 /// 自定义的数据缓存区 /// 输入：缓存区的大小；输出：一帧数据的大小 /// 帧类型 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int ReadStreamData(IntPtr hChannelHandle, byte[] DataBuf, out UInt64 Length, out int FrameType); #region 3.5.3.3开启及停止录像 ///

/// 3.5.3.3.1启动主通道编码数据流捕获 /// 说明：启动主通道编码数据流捕获。用户程序可以使用直接读取方式，使用 /// StreamDirectReadCallback回调函数直接对数据流进行处理；也可以与H卡一样，通过消息 /// 读取方式，等SDK向用户程序发送在RegisterMessageNotifyHandle中注册的消息，用户程 /// 序使用ReadStreamData来读取数据流。 /// /// int __stdcall StartVideoCapture(HANDLE hChannelHandle) ///

/// 通道句柄 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int StartVideoCapture(IntPtr hChannelHandle); ///

/// 3.5.3.3.2停止主通道编码数据流捕获 /// 说明：停止主通道编码数据流捕获 /// /// int __stdcall StopVideoCapture(HANDLE hChannelHandle) ///

/// 通道句柄 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int StopVideoCapture(IntPtr hChannelHandle); ///

/// 3.5.3.3.3启动子通道编码数据流捕获 /// 说明：启动子通道编码数据流捕获 /// /// int __stdcall StartSubVideoCapture(HANDLE hChannelHandle) ///

/// 通道句柄 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int StartSubVideoCapture(IntPtr hChannelHandle); ///

/// 3.5.3.3.4停止子通道编码数据流捕获 /// 说明：停止子通道编码数据流捕获 /// /// int __stdcall StopSubVideoCapture(HANDLE hChannelHandle) ///

/// 通道句柄 /// 成功返回0；失败返回错误号 [DllImport("DS40xxSDK.dll")] public static extern int StopSubVideoCapture(IntPtr hChannelHandle); #endregion #endregion #endregion #endregion #region 3.6移动侦测 // 释义：移动侦测 //DS4000HC提供运动强度信息来处理运动检测，设置移动侦测区域时以32*32像素块为 //单位，按4CIF（704*576）分辨率计算，每行有22个块（704/32），PAL时18行（576/32）， //NTSC时15行（480/32），与编码格式无关。经过测试，这种方法比H卡提高了灵敏度和可 //靠性，并简化了返回的数据，返回的值是18个DWORD，对应屏幕高度576/32=18行（PAL）, //每个DWORD的0-21位对应屏幕宽度704/32=22, 其中1为运动,0为静止，也可以调用原有 //MotionAnalyzer分析结果 //4.0版本的SDK新增了接口函数SetupMotionDetectionEx，

图像处理中，如果要调整图像的对比度、色度、饱和度，在RGB色彩空间处理实为不变，这需要转换到HSV色彩空间中去，不够快速。因此本文提出了直接基于YUV色彩空间处理的方法。

HRESULT CPlay_Image::YUV420ConvertImage(UCHAR *pYUV,LONG lYUVWidth,LONG lYUVHeight,LONG lBrightness,LONG lColorfulness,LONG lContrast){ UCHAR *pY = pYUV; UCHAR *pU = pYUV + lYUVWidth * lYUVHeigh

也就是像素值的大小的区别。那我乘以一个alpha系数，当alpha很大的时候就是放大了这种亮度值的差异,也就是提高了对比度，当alpha很小时，也就是缩小了亮度的差异，也就是缩小了对比度。线性变换有个问题,如上图,α=1.3 and β=40,提高原图亮度的同时,导致云几乎看不见了.如果要看见云的话,建筑的亮度又不够.如果查看不同变换下的灰度直方图的话可以看到.中间是原图的灰度直方图,可以看到低亮度值的像素点很多.与线性变换不同,对不同的原始亮度值,其改变强度是不同的,是非线性的．。最常用的是线性变换。