/ **
播放应用程序的头文件。
此文件是头文件，用于定义Playback应用程序的API和数据类型。
@file PlaybackTsk.h
@ingroup mIAPPPlay
@note什么都没有。
版权所有Novatek Microelectronics Corp. .保留所有权利。
* /
#ifndef _PLAYBACKAPI_H
#define _PLAYBACKAPI_H
#include“SysKer.h”
#include“ExifDef.h”
#include“JpgHeader.h”
#include“GxImage.h”
/ **
@addtogroup mIAPPPlay
* /
// @ {
// ------------------------------------------------ ------------------------------
//定义
// ------------------------------------------------ ------------------------------
/ **
@name播放文件格式
文件的格式和属性。
@note对于_PLAY_OBJ :: uiPlayFileFmt。
* /
// @ {
#define PBFMT_UNKNOWN 0x00000000 /// <文件格式：未知
#define PBFMT_JPG 0x00000001 /// <文件格式：JPEG
#define PBFMT_WAV 0x00000002 /// <文件格式：WAV
#define PBFMT_AVI 0x00000004 /// <文件格式：AVI
#define PBFMT_ASF 0x00000008 /// <文件格式：ASF
#define PBFMT_RAW 0x00000010 /// <文件格式：RAW
#define PBFMT_JPGMEMO 0x00000010 /// <文件属性：带语音备忘录的JPEG
#define PBFMT_MP4 0x00000020 /// <文件格式：MP4
#define PBFMT_READONLY 0x00000040 /// <文件属性：只读
#define PBFMT_MPG 0x00000080 /// <文件格式：MPEG
#define PBFMT_MOVMJPG 0x00000100 /// <文件格式：带动态JPEG的MOV
#define PBFMT_MPO 0x00000200 /// <文件格式：MPO
#define PB_SUPPORT_FMT（PBFMT_JPG | PBFMT_WAV | PBFMT_AVI | PBFMT_MOVMJPG | PBFMT_ASF | PBFMT_MPG | PBFMT_MPO）/// <播放的默认文件格式
// @}
/ **
@name播放图像方向
#note为#PBPRMID_ROTATE_DIR。
* /
// @ {
#define PLAY_ROTATE_DIR_UNKNOWN 0xFF /// <旋转方向：初始化（未知）
#define PLAY_ROTATE_DIR_0 PLAY_ROTATE_DIR_UNKNOWN
#define PLAY_ROTATE_DIR_90 0x00 /// <旋转方向：90度
#define PLAY_ROTATE_DIR_180 0x01 /// <旋转方向：180度
#define PLAY_ROTATE_DIR_270 0x02 /// <旋转方向：270度
#define PLAY_ROTATE_DIR_HOR 0x03 /// <旋转方向：水平
#define PLAY_ROTATE_DIR_VER 0x04 /// <旋转方向：垂直
// @}
/ **
@name播放照片显示方向
#note为#PBPRMID_DISP_DIRECTION。
* /
// @ {
#define PB_DISPDIR_HORIZONTAL 0x01 /// <将显示方向设置为水平
#define PB_DISPDIR_VERTICAL 0x02 /// <将显示方向设置为垂直
// @}
/ **
@name播放功能启用标志
#note为#PBPRMID_EN_FLAGS。
* /
// @ {
#define PB_ENABLE_KEEP_ASPECT_RATIO 0x00000001 /// <保持宽高比（letterboxing或邮箱）
#define PB_ENABLE_SHOW_BACKGROUND_IN_THUMB 0x00000002 /// <以缩略图模式显示背景
#define PB_ENABLE_SEARCH_FILE_WITHOUT_DCF 0x00000004 /// <没有DCF的搜索文件
#define PB_ENABLE_SHOW_BG_IN_MOVIE 0x00000008 /// <在电影文件中显示背景
#define PB_ENABLE_SHOW_BG_IN_BADFILE 0x00000010 /// <在Bad文件中显示背景
#define PB_ENABLE_PLAY_FILE_BY_DATE 0x00000020 /// <按日期播放文件
#define PB_ENABLE_THUMB_WITH_DIFF_FOLDER 0x00000040 /// <带有diff文件夹的缩略图
#define PB_ENABLE_TV_PLUGIN 0x00000080 /// <代表电视插入
#define PB_ENABLE_SPEEDUP_SCREENNAIL 0x00000100 /// <在主图像后附加代表屏幕
// @}
/ **
@name播放缩略图模式显示方法
#note为#PBPRMID_THUMB_SHOW_METHOD。
* /
// @ {
#define PB_SHOW_THUMBNAIL_ONE_BY_ONE 0x00000001 /// <单一显示缩略图
#define PB_SHOW_THUMBNAIL_IN_THE_SAME_TIME 0x00000002 /// <同时显示缩略图
// @}
/ **
@name播放任务状态
#note为#PBPRMID_PLAYBACK_STATUS。
* /
// @ {
#define PB_STA_UNKNOWN 0x00000000 /// <未知
#define PB_STA_NOIMAGE 0x00000001 /// <无图像
#define PB_STA_ERR_FILE 0x00000002 /// <错误文件
#define PB_STA_ERR_DECODE 0x00000004 /// <解码错误
#define PB_STA_ERR_WRITE 0x00000008 /// <写入错误
#define PB_STA_DONE 0x00000010 /// <完成
#define PB_STA_BUSY 0x00000020 /// <忙碌
#define PB_STA_STANDBY 0x00000040 /// <待机
#define PB_STA_INITFAIL 0x00000080 /// <Init失败
#define PB_STA_ERR_TASK 0x00000100 /// <任务无法启动
// @}
/ **
@name播放单视图命令
@note对于_PLAY_SINGLE_OBJ :: PlayCommand。
* /
// @ {
#define PB_SINGLE_CURR 0x01 /// <播放当前图像
#define PB_SINGLE_NEXT 0x02 /// <播放下一张图像
#define PB_SINGLE_PREV 0x04 /// <播放上一张图像
#define PB_SINGLE_PRIMARY 0x08 /// <播放屏幕图像或主图像
#define PB_SINGLE_THUMB 0x40 /// <仅播放缩略图
#define PB_SINGLE_NO_HIDDEN 0x80 /// <仅播放主图像
// @}
/ **
@name Playback缩略图查看命令
@note对于_PLAY_BROWSER_OBJ :: BrowserCommand。
* /
// @ {
#define PB_BROWSER_CURR 0x01 /// <浏览当前缩略图页面
#define PB_BROWSER_NEXT 0x02 /// <浏览下一个缩略图页面
#define PB_BROWSER_PREV 0x04 /// <浏览上一个缩略图页面
#define PB_BROWSER_THUMB 0x40 /// <仅浏览缩略图
// @}
/ **
@name播放缩放命令
@note用于PB_PlayZoomMode（），PB_PlayZoomPanMode（）。
* /
// @ {
#define PLAYZOOM_IN 0x01 /// <放大
#define PLAYZOOM_OUT 0x02 /// <缩小
#define PLAYZOOM_UP 0x04 /// <缩放 - 向上滚动
#define PLAYZOOM_DOWN 0x08 /// <缩放 - 向下滚动
#define PLAYZOOM_LEFT 0x10 /// <缩放 - 向左滚动
#define PLAYZOOM_RIGHT 0x20 /// <缩放 - 向右滚动
#define PLAYZOOM_USER 0x40 /// <用户定义的缩放命令
// @}
/ **
@name播放模式
@note用于PBPRMID_PLAYBACK_MODE。
* /
// @ {
#define PLAYMODE_THUMB 9 /// <缩略图模式
#define PLAYMODE_PRIMARY 10 /// <单视图模式：JPEG
#define PLAYMODE_AVI 11 /// <单视图模式：AVI
#define PLAYMODE_ROTATE 12 /// <Rotae display
#define PLAYMODE_WAV 13 /// <单视图模式：WAV
#define PLAYMODE_ASF 14 /// <单一视图模式：ASF
#define PLAYMODE_MPG 16 /// <单一视图模式：MPEG
#define PLAYMODE_MOVMJPG 17 /// <单视图模式：Motion JPEG
#define PLAYMODE_ONLYTHUMB 33 /// <首先解码始终只解码缩略图
#define PLAYMODE_PICBRIDGE 55 /// <图片桥模式
#define PLAYMODE_USERJPGOUT 77 /// <用户JPEG模式
#define PLAYMODE_UNKNOWN 99 /// <开始播放时的初始模式
// @}
// ------------------------------------------------ ------------------------------
//枚举
// ------------------------------------------------ ------------------------------
/ **
播放显示video1 / video2中的特定文件
@note对于_PLAY_SPECFILE_OBJ :: PlayFileVideo。
* /
typedef enum
{
PLAY_SPEC_FILE_IN_VIDEO_1，/// <0，在video1中显示
PLAY_SPEC_FILE_IN_VIDEO_2 /// <1，在video2中显示
} PB_SPEC_VDO;
/ **
播放用/ wo清除缓冲区显示特定文件
@note对于_PLAY_SPECFILE_OBJ :: PlayFileClearBuf。
* /
typedef enum
{
PLAY_SPEC_FILE_WITH_CLEAR_BUF，/// <0，清除缓冲区
PLAY_SPEC_FILE_WITH_NOT_CLEAR_BUF /// <1，不清除缓冲区
} PB_SPEC_CLR;
/ **
播放参数枚举
@note对于PB_GetParam（），PB_SetParam（）。
* /
typedef enum _PB_PRMID
{
PBPRMID_FILE_ATTR_LOCK = 0x01，/// <文件属性：只读
PBPRMID_JPEG_WITH_VOICE = 0x02，/// <带语音备忘录的JPEG
PBPRMID_PLAYBACK_MODE = 0x10，/// <当前播放模式
PBPRMID_PLAYBACK_STATUS = 0x11，/// <播放任务的当前状态
PBPRMID_PLAYBACK_OBJ = 0x12，/// <指向回放对象设置结构的指针
PBPRMID_INFO_IMG = 0x13，/// <指向当前图像配置结构的指针
PBPRMID_INFO_VDO = 0x14，/// <指向当前视频配置结构的指针
PBPRMID_ROTATE_DIR = 0x15，/// <当前图像旋转方向
PBPRMID_MAX_PANELSZ = 0x16，/// <播放的最大面板大小
PBPRMID_EN_FLAGS = 0x17，/// <功能启用播放标志
PBPRMID_BG_COLOR = 0x18，/// <默认背景颜色
PBPRMID_THUMB_CURR_IDX = 0x20，/// <当前缩略图页面中当前浏览的文件索引
PBPRMID_THUMB_CURR_NUM = 0x21，/// <当前缩略图页面中当前解码的拇指文件编号
PBPRMID_THUMB_FMT_ARRAY = 0x22，/// <指向当前缩略图页面的文件格式数组的指针
PBPRMID_THUMB_DEC_ARRAY = 0x23，/// <指向当前缩略图页面的解码结果数组的指针
PBPRMID_THUMB_SEQ_ARRAY = 0x24，/// <指向当前缩略图页面的文件序列ID数组的指针
PBPRMID_THUMB_VDO_LTH_ARRAY = 0x25，/// <指向当前缩略图页面的视频时间数组的指针
PBPRMID_THUMB_SHOW_METHOD = 0x26，/// <缩略图模式显示方法（＃PB_SHOW_THUMBNAIL_ONE_BY_ONE /＃PB_SHOW_THUMBNAIL_IN_THE_SAME_TIME）
PBPRMID_THUMB_LAYOUT_ARRAY = 0x27，/// <指向播放缩略图模式外观的配置数组的指针
PBPRMID_THUMB_LAYOUT_ARRAY2 = 0x28，/// <指向一个配置数组的指针，用于双视图的回放缩略图模式外观
PBPRMID_ZOOM_INDEX = 0x30，/// <当前缩放表索引
PBPRMID_ZOOM_LVL_TBL = 0x31，/// <指向缩放级别表的指针
PBPRMID_PAN_CURX = 0x32，/// <当前X地址 - PBZoom子图像左上角相对于主图像左上角（（0,0）点）
PBPRMID_PAN_CURY = 0x33，/// <当前Y地址 - PBZoom子图像左上角相对于主图像左上角（（0,0）点）
PBPRMID_PAN_MAXX = 0x34，/// <MAX X addr - MAX PBZoom图像滚动范围
PBPRMID_PAN_MAXY = 0x35，/// <MAX Y addr - MAX PBZoom图像滚动范围
PBPRMID_NAMEID_FILE = 0x40，/// <当前DCF文件ID
PBPRMID_NAMEID_DIR = 0x41，/// <当前DCF目录ID
PBPRMID_DATABUF_ADDR = 0x42，/// <当前数据缓冲区地址
PBPRMID_DATABUF_SIZE = 0x43，/// <当前数据缓冲区大小
PBPRMID_CURR_FILEPATH = 0x44，/// <当前文件路径
PBPRMID_CURR_FILESEQ = 0x45，/// <当前文件序列
PBPRMID_CURR_FILESIZE = 0x46，/// <当前文件大小
PBPRMID_CURR_FILEFMT = 0x47，/// <当前文件格式
PBPRMID_TOTAL_FILE_COUNT = 0x48，/// <文件总数
PBPRMID_DISP_DIRECTION = 0x50，/// <显示方向（＃PB_DISPDIR_HORIZONTAL /＃PB_DISPDIR_VERTICAL）
PBPRMID_AUTO_ROTATE = 0x51，/// <根据EXIF方向自动旋转图像（TRUE / FALSE）
PBPRMID_SLIDE_SPEED_TBL = 0x60，/// <幻灯片速度表的指针用于幻灯片效果功能
PBPRMID_FILEDB_HANDLE = 0x90，/// <与文件DB通信的文件句柄
PBPRMID_FILELIST_OBJ = 0x91，/// <文件列表对象指针
PBPRMID_DEC_IMG_CALLBACK = 0x92，/// <用于解码图像文件的回调函数
PBPRMID_DEC_VIDEO_CALLBACK = 0x93，/// <用于解码视频文件的回调函数
PBPRMID_CFG4NEXT_CALLBACK = 0x94，/// <在下一次触发之前做某事的回调函数（DspSrv）
ENUM_DUMMY4WORD（PB_PRMID）
PB_PRMID;
/ **
播放错误代码。
* /
typedef enum _PB_ERR
{
PBERR_OK = 0x00，/// <操作成功
PBERR_NOT_SUPPORT = 0xF0，/// <不支持的功能
PBERR_PAR = 0xF1，/// <参数无效
PBERR_FAIL = 0xFF，/// <操作失败
ENUM_DUMMY4WORD（PB_ERR）
} PB_ERR;
/ **
播放等待模式。
@note用于PB_WaitCommandFinish（）。
* /
typedef enum _PB_WAIT_MODE
{
PB_WAIT_NOWAIT = 0x00，/// <不等待
PB_WAIT_INFINITE = 0xFF，/// <等待操作完成
ENUM_DUMMY4WORD（PB_WAIT_MODE）
} PB_WAIT_MODE;
/ **
播放编辑图像操作。
@note对于_PB_EDIT_CONFIG :: Operation。
* /
typedef enum _PB_EDIT_IMAGE
{
PBEDIT_RESIZE，/// <将图像大小调整为特定大小并保存文件
PBEDIT_REQTY，/// <当前图像和保存文件的重新质量
PBEDIT_ROTATE，/// <更新当前的JPEG EXIF-Orientation标签并保存文件
PBEDIT_ROTATE_DISP，/// <旋转图像仅供显示
PBEDIT_CROP，/// <裁剪打开的图像并保存为新文件
PBEDIT_NLIGHT_DISP，/// <设置Nova-Light仅供显示
PBEDIT_NLIGHT，/// <设置Nova-Light并保存文件
PBEDIT_CUSTOMIZE_DISP，/// <设置自定义效果仅供显示
PBEDIT_CUSTOMIZE，/// <设置自定义效果并保存文件
PBEDIT_CUSTOMIZE_PARA，/// <设置自定义参数（如有必要）
ENUM_DUMMY4WORD（PB_EDIT_IMAGE）
} PB_EDIT_IMAGE;
/ **
播放屏幕控制类型。
屏幕控制与OSD同步显示。
@note用于PB_ScreenControl（）。
* /
typedef enum {
PB_LOCK_SCREEN = ，/// <图像操作的结果不会显示在显示屏上
PB_FLUSH_SCREEN = 1，/// <在显示屏上显示图像操作的结果
ENUM_DUMMY4WORD（PB_SCREEN_CTRL_TYPE）
} PB_SCREEN_CTRL_TYPE;
/ **
要加载的文件的类型。
@note用于PB_QuasiLoadFile（）。
* /
typedef enum _PB_FILE_TYPE
{
PB_FILE_JPEG = ，/// <JPEG文件的主图像
PB_FILE_JPEG_THUMBNAIL，/// <JPEG文件的缩略图
PB_FILE_SCREENNAIL，/// <JPEG文件的屏幕图像
PB_FILE_AVI，/// <AVI文件的第1帧
PB_FILE_AVI_THUMBNAIL，/// <AVI文件的缩略图
ENUM_DUMMY4WORD（PB_FILE_TYPE）
} PB_FILE_TYPE;
/ **
显示索引
有两种显示引擎可供支持。
@note用于PB_ConfigVdoWIN（），PB_Set1stVideoFrame（）。
* /
typedef enum _PB_DISP_IDX
{
PBDISP_IDX_PRI = ，/// <主显示
PBDISP_IDX_SEC，/// <辅助显示
PBDISP_IDX_MAX，
ENUM_DUMMY4WORD（PB_DISP_IDX）
} PB_DISP_IDX;
/ **
播放解码图像类型。
此信息表示播放模块正在解码缩略图或主图像。
@note适用于PB_DECIMG_CB。
* /
typedef enum
{
PB_DECIMG_THUMBNAIL，/// <播放模块正在解码缩略图图像。
PB_DECIMG_PRIMARY，/// <播放模块正在解码主图像。
ENUM_DUMMY4WORD（PB_DECIMG_TYPE）
} PB_DECIMG_TYPE;
// ------------------------------------------------ ------------------------------
//函数原型
// ------------------------------------------------ ------------------------------
/ **
用于解码图像文件的回调函数原型。
每次重放图像文件时都会调用回调函数。
用户可以通过返回FLASE返回TRUE来决定图像文件的解码位置。
* /
typedef BOOL（* PB_DECIMG_CB）（PB_DECIMG_TYPE DecType）;
/ **
用于解码视频文件的回调函数原型。
每次播放视频文件时都会调用回调函数。
用户可以通过返回FLASE来返回TRUE，从而决定视频文件的解码位置。
* /
typedef BOOL（* PB_DECVIDEO_CB）（UINT32 uiUserDataAddr，UINT32 uiUserDataSize）;
/ **
回调函数原型，用于在DspSrv tirgger下一个图像之前做一些事情。
每次重放图像/视频时都会调用回调函数。
用户可以在DspSrv tirgger下一个图像之前旋转图像或执行其他操作。
* /
typedef void（* PB_CFG4NEXT_CB）（void）;
// ------------------------------------------------ ------------------------------
//结构
// ------------------------------------------------ ------------------------------
/ **
播放的配置对象（PB_Open）。
@note用于PB_Open（）。
* /
typedef struct _PLAY_OBJ
{
UINT32 uiMemoryAddr; /// <内存缓冲区起始地址
UINT32 uiMemorySize; /// <内存缓冲区大小
UINT32 uiPlayFileFmt; /// <播放静止图像和视频的文件格式
PLAY_OBJ，* PPLAY_OBJ;
/ **
播放编辑图像配置。
配置结构，包含操作的ID及其参数。
@注意
- ＃对于PB_EditImage（）。
- ＃除非另有说明，否则puiParam []的值应始终为零。
* /
typedef struct _PB_EDIT_CONFIG
{
PB_EDIT_IMAGE操作; /// <图像编辑操作ID
UINT32 puiParam [4]; /// <特定编辑操作的参数
} PB_EDIT_CONFIG，* PPB_EDIT_CONFIG;
/ **
单个视图的命令对象。
播放模式命令对象的结构。
@note用于PB_PlaySingleMode（）。
* /
typedef struct _PLAY_SINGLE_OBJ
{
UINT32 PlayCommand; /// <播放单个视图命令
UINT32 slideEffectFunc; /// <幻灯片效果函数，请参阅SlideEffect.h
UINT8 JumpOffset; /// <读取下一个/上一个文件的跳转偏移量
PLAY_SINGLE_OBJ，* PPLAY_SINGLE_OBJ;
/ **
缩略图视图的命令对象。
缩略图模式命令对象的结构。
@note用于PB_PlayBrowserMode（）。
* /
typedef struct _PLAY_BROWSER_OBJ
{
UINT8 BrowserCommand; /// <播放缩略图视图命令
UINT8 HorNums; /// <水平方向的图像数量，HorNums * VerNums必须<= 25
UINT8 VerNums; /// <垂直方向有多少个图像，HorNums * VerNums必须<= 25
UINT32 slideEffectFunc; /// <幻灯片效果函数，请参阅SlideEffect.h
UINT8 JumpOffset; /// <读取下一个/上一个文件的跳转偏移量
BOOL bReDecodeImages; /// <用于重新解码所有拇指图像
/// < - @b FALSE：这意味着#JumpOffset仍在同一页面中
/// < - @b TRUE：这意味着Playback必须解码另一个页面中的所有图像
} PLAY_BROWSER_OBJ，* PPLAY_BROWSER_OBJ;
/ **
显示特定文件的命令对象。
用于在特定视频层（#PB_SPEC_VDO）和特定大小中显示特定文件的结构。
@note用于PB_PlaySpecFile（）。
* /
typedef struct _PLAY_SPECFILE_OBJ
{
PB_SPEC_VDO PlayFileVideo; /// <播放在video1 / video2 #PB_SPEC_VDO中显示特定文件
PB_SPEC_CLR PlayFileClearBuf; /// <使用/ wo清除缓冲区#PB_SPEC_CLR播放显示特定文件
URECT PlayRect; /// <帧缓冲区布局的矩形数组的指针
BOOL bDisplayWoReDec; /// <用于加速第二个相同的特定文件
/// < - @b FALSE：强制当前图像重新解码以进行显示
/// < - @b TRUE：绘制图像，无需重新解码，以加速第二个相同的特定文件
PLAY_SPECFILE_OBJ，* PPLAY_SPECFILE_OBJ;
/ **
捕获屏幕的配置对象。
用于捕获屏幕到特定图像大小的结构。
@note用于PB_CaptureScreen（）。
* /
typedef struct _PB_LOGO_INFO
{
UINT32 uiDstWidth; /// <[in]捕获图像的宽度（'0'是特殊情况：使用面板宽度）
UINT32 uiDstHeight; /// <[in]捕获图像的高度（'0'是特殊情况：使用面板高度）
UINT32 uiFileSize; /// <[in] JPEG文件的上限大小（'0'是特殊情况：文件大小不受限制）
/// <[out]捕获的JPEG文件的大小
UINT32 uiFileAddr; /// <[out]捕获的JPEG文件的起始地址
} PB_LOGO_INFO，* PPB_LOGO_INFO;
// ------------------------------------------------ ------------------------------
//导出功能
// ------------------------------------------------ ------------------------------
/ **
安装播放任务，标志和信号量ID
@return无效
* /
extern void PB_InstallID（void）_SECTION（“。kercfg_text”）;
/ **
打开播放模式。
打开播放模式并开始播放任务。
@param [in] pPlayObj播放配置对象的指针：#_ PLAY_OBJ
@返回
- @b PBERR_OK：成功。
- @b PBERR_FAIL：失败。
例：
@码
{
PLAY_OBJ PlayObj;
PlayObj.uiMemoryAddr = 0x80000000;
PlayObj.uiMemorySize = 0x00200000;
PlayObj.uiPlayFileFmt =（PBFMT_JPG | PBFMT_AVI）;
PB_Open（＆PlayObj）;
}
@endcode
* /
extern PB_ERR PB_Open（PPLAY_OBJ pPlayObj）;
/ **
关闭播放模式。
关闭播放模式并终止播放任务。
@param [in] TimeOut播放等待模式
@返回
- @b PBERR_OK：成功。
- @b PBERR_FAIL：失败。
* /
extern PB_ERR PB_Close（PB_WAIT_MODE TimeOut）;
/ **
获取播放参数。
获取特定Playback参数的值。
@param [in] ParamID要设置的Playback参数的标识符。
@param [in，out] puiVal指针在哪里写入从Playback读取的特定参数值。
@返回
- @b PBERR_OK：成功。
- @b PBERR_PAR：参数无效。
* /
extern PB_ERR PB_GetParam（PB_PRMID ParamID，UINT32 * puiVal）;
/ **
设置播放参数。
为某些播放参数设置特定值。
@param [in] ParamID要设置的Playback参数的标识符。
@param [in] uiValue要设置为特定Playback参数的值。
@返回
- @b PBERR_OK：成功。
- @b PBERR_PAR：参数无效。
* /
extern PB_ERR PB_SetParam（PB_PRMID ParamID，UINT32 uiValue）;
/ **
等待播放命令完成。
等待播放的最后命令完成。
@param [in] TimeOut播放等待模式：#_PB_WAIT_MODE。
@返回
- @b任务状态：根据响应状态回放任务状态。
* /
extern INT32 PB_WaitCommandFinish（PB_WAIT_MODE TimeOut）;
// ------------------------- [Async Functions] ------------------- ---------
/ **
编辑图像。
该功能执行图像编辑操作。
@注意
- ＃仅在JPEG文件格式的播放模式下允许图像编辑
- 必须在#PBEDIT_NLIGHT命令之前调用## PBEDIT_NLIGHT_DISP才能配置相关的Nova-light参数。
- ＃这个API是一个异步函数（意思是：需要调用#PB_WaitCommandFinish（）来等待操作完成）。
@param [in] pConfig指向播放的指针编辑图像配置结构：#_PB_EDIT_CONFIG。
- @b Operation - 要执行的操作：
- @b #PBEDIT_RESIZE
- @b puiParam []输出图像大小的宽度。
- @b puiParam []输出图像大小的高度。
- @b puiParam []如果覆盖当前文件。
- @b #PBEDIT_ROTATE
- @b puiParam [] JPEG EXIF-Orientation。
- @b puiParam []如果在应用更改后显示已编辑的图像。
- @b puiParam []如果覆盖当前文件。
- @b #PBEDIT_ROTATE_DISP
- @b puiParam [] JPEG EXIF-Orientation。
- @b #PBEDIT_CROP
- @b puiParam []裁剪边界的水平开始。
- @b puiParam []裁剪边界的垂直开始。
- @b puiParam []裁剪边界的宽度。
- @b puiParam []裁剪边界的高度。
- @b #PBEDIT_NLIGHT_DISP
- @b puiParam [] Nova-light的等级。
- @b #PBEDIT_NLIGHT
- @b puiParam []如果覆盖当前文件。
- @b #PBEDIT_CUSTOMIZE_DISP
- @b puiParam []自定义编辑功能指针。
- @b puiParam []工作缓冲区所需的大小。
- @b #PBEDIT_CUSTOMIZE
- @b puiParam []自定义编辑功能指针。
- @b puiParam []工作缓冲区所需的大小。
- @b puiParam []如果覆盖当前文件。
@返回
- @b PBERR_OK：成功。
- @b PBERR_PAR：参数无效。
- @b PBERR_NOT_SUPPORT：不支持的操作。
例：
@码
{
PB_EDIT_CONFIG配置= {};
Config.Operation = PBEDIT_RESIZE;
Config.puiParam [] = ;
Config.puiParam [] = ;
Config.puiParam [] = FALSE;
PB_EditImage（配置）;
PB_WaitCommandFinish（PB_WAIT_INFINITE）;
}
@endcode
* /
extern PB_ERR PB_EditImage（PPB_EDIT_CONFIG pConfig）;
/ **
播放单张图片。
显示单个图像和第一帧视频剪辑。
@note这个API是一个异步函数（意思是：需要调用#PB_WaitCommandFinish（）来等待操作完成）。
@param [in] pPlaySingleObj单个视图的命令对象的指针：#_ PLAY_SINGLE_OBJ。
@return无效。
* /
extern void PB_PlaySingleMode（PPLAY_SINGLE_OBJ pPlaySingleObj）;
/ **
在缩略图视图中浏览图像。
显示缩略图页面，绘制缩略图图像和视频剪辑的第一帧。
@注意
- ＃水平图像编号*垂直图像编号不能超过25。
- ＃这个API是一个异步函数（意思是：需要调用#PB_WaitCommandFinish（）来等待操作完成）。
@param [in] pPlayBrowserObj缩略图视图的命令对象的指针：#_ PLAY_BROWSER_OBJ。
@返回
- @b PBERR_OK：作业被发送到回放任务，你必须等待结果。
- @b PBERR_PAR：参数无效。
- @b PB_STA_DONE：此命令已完成。
* /
extern INT32 PB_PlayBrowserMode（PPLAY_BROWSER_OBJ pPlayBrowserObj）;
/ **
播放图像缩放。
@note这个API是一个异步函数（意思是：需要调用#PB_WaitCommandFinish（）来等待操作完成）。
@param [in] PlayCommand播放缩放命令（#PLAYZOOM_IN / #PLAYZOOM_OUT ..）。
@return无效。
例：
@码
{
PB_PlayZoomMode（PLAYZOOM_IN）;
PB_WaitCommandFinish（PB_WAIT_INFINITE）;
}
@endcode
* /
extern void PB_PlayZoomMode（UINT32 PlayCommand）;
/ **
播放图像滚动。
@note这个API是一个异步函数（意思是：需要调用#PB_WaitCommandFinish（）来等待操作完成）。
@param [in] PlayCommand播放缩放命令（#PLAYZOOM_UP / #PLAYZOOM_DOWN / #PLAYZOOM_LEFT / #PLAYZOOM_RIGHT）。
@param [in] MoveOffsetX水平滚动偏移量。
@param [in] MoveOffsetY垂直滚动偏移。
@返回
- @b PBERR_OK：作业被发送到回放任务，你必须等待结果。
- @b PBERR_PAR：参数无效。
- @b PB_STA_DONE：此命令已完成，无法再滚动。
例：
@码
{
PB_PlayZoomPanMode（PLAYZOOM_UP，,）;
PB_WaitCommandFinish（PB_WAIT_INFINITE）;
}
@endcode
* /
extern INT32 PB_PlayZoomPanMode（UINT32 PlayCommand，UINT32 MoveOffsetX，UINT32 MoveOffsetY）;
/ **
通过用户设置进行数码变焦播放。
@note这个API是一个异步函数（意思是：需要调用#PB_WaitCommandFinish（）来等待操作完成）。
@param [in] LeftUp_X此图片的start-Left-Up-pixel-X
@param [in] LeftUp_Y此图片的开始 - 左上 - 像素-Y
@param [in] RightDown_X此图片的结束 - 右下 - 像素-X
@param [in] RightDown_Y此图片的结束 - 右下 - 像素-Y
@返回
- @b PBERR_OK：作业被发送到回放任务，你必须等待结果。
- @b PBERR_PAR：参数无效。
例：
@码
{
PB_PlayZoomUserSetting（,,,）;
PB_WaitCommandFinish（PB_WAIT_INFINITE）;
}
@endcode
* /
extern INT32 PB_PlayZoomUserSetting（UINT32 LeftUp_X，UINT32 LeftUp_Y，UINT32 RightDown_X，UINT32 RightDown_Y）;
/ **
在video1 / video2和规格尺寸中显示spec文件。
@note这个API是一个异步函数（意思是：需要调用#PB_WaitCommandFinish（）来等待操作完成）。
@param [in] pPlayFileObj显示特定文件的命令对象的指针：#_ PLAY_SPECFILE_OBJ。
@return无效。
* /
extern void PB_PlaySpecFile（PPLAY_SPECFILE_OBJ pPlayFileObj）;
/ **
将屏幕捕获到特定图像大小。
@note这个API是一个异步函数（意思是：需要调用#PB_WaitCommandFinish（）来等待操作完成）。
@param [in，out] pPBLogoInfo指向捕获屏幕的配置对象的指针：#_PB_LOGO_INFO。
@return无效。
例：
@码
{
PB_LOGO_INFO LogoInfo = {};
LogoInfo.uiDstWidth = ;
LogoInfo.uiDstHeight = ;
LogoInfo.uiFileSize = ;
PB_CaptureScreen（＆LogoInfo）;
PB_WaitCommandFinish（PB_WAIT_INFINITE）;
}
@endcode
* /
extern void PB_CaptureScreen（PPB_LOGO_INFO pPBLogoInfo）;
/ **
在显示坐标中获取面部编号和位置。
@note这个API是一个异步函数（意思是：需要调用#PB_WaitCommandFinish（）来等待操作完成）。
@param [out] ppRect指向面矩形的指针。
@param [out] pNum指向面数的指针。
@return无效。
例：
@码
{
URECT * pRcLocation;
UINT32 nFaces;
PB_FaceDetection（＆pRcLocation，＆nFaces）;
PB_WaitCommandFinish（PB_WAIT_INFINITE）;
}
@endcode
* /
extern void PB_FaceDetection（URECT ** ppRect，UINT32 * pNum）;
/ **
打开特定文件。
@note这个API是一个异步函数（意思是：需要调用#PB_WaitCommandFinish（）来等待操作完成）。
@param [in] PlayDirId DCF目录ID。
@param [in] PlayFileId DCF文件ID。
@return无效。
例：
@码
{
PB_OpenSpecFile（,）;
PB_WaitCommandFinish（PB_WAIT_INFINITE）;
}
@endcode
* /
extern void PB_OpenSpecFile（UINT32 PlayDirId，UINT32 PlayFileId）;
/ **
按序列ID打开特定文件。
@note这个API是一个异步函数（意思是：需要调用#PB_WaitCommandFinish（）来等待操作完成）。
@param [in] uiSeqID文件序列ID。
@param [in] bOnlyQuery Only查询文件但不读取所有文件数据。
@return无效。
例：
@码
{
PB_OpenSpecFileBySeq（，FALSE）;
PB_WaitCommandFinish（PB_WAIT_INFINITE）;
}
@endcode
* /
extern void PB_OpenSpecFileBySeq（UINT32 uiSeqID，BOOL bOnlyQuery）;
// - - - - - - - - - - - - - - -[ 获取信息 ] - - - - - - - - ----------------------
/ **
在解码之前获取当前图像的JPEG信息。
@param [in] bParseEXIF
- @b TRUE：解析EXIF和主要图像信息。
- @b FALSE：仅解析主图像信息。
@return pJPGInfo指向JPEG解码配置的指针（@b NULL表示解析NG）。
例：
@码
{
PJPGHEAD_DEC_CFG pJPGDecCfg;
pJPGDecCfg = PB_GetCurrImageInfoBeforeDec（FALSE）;
}
@endcode
* /
extern PJPGHEAD_DEC_CFG PB_GetCurrImageInfoBeforeDec（BOOL bParseEXIF）;
/ **
使用此API检查是否可以成功显示可绘制文件（JPEG，MJPEG等）而不实际显示它。
@param [in] FileType要加载的文件的类型：#_PB_FILE_TYPE。
@返回
- @b PBERR_OK：成功。
- @b PBERR_FAIL：失败。
例：
@码
{
PB_ERR LoadRslt;
PB_OpenSpecFileBySeq（，FALSE）;
PB_WaitCommandFinish（PB_WAIT_INFINITE）;
LoadRslt = PB_QuasiLoadFile（PB_FILE_JPEG）;
}
@endcode
* /
extern PB_ERR PB_QuasiLoadFile（PB_FILE_TYPE FileType）;
// - - - - - - - - - - - - - - -[ 设置 ] - - - - - - - - ---------------------
/ **
设置BRC（比特率控制）参数，以便在回放模式下重新编码PRIMARY图像。
@param [in] uiCompressRatio目标比特流压缩比。
@param [in] uiUpBoundRatio目标大小的上限比。
@param [in] uiLowBoundRatio目标大小的下限比率。
@param [in] uiLimitCnt重新编码的最大次数。
@return无效。
例：
@码
{
PB_SetExpectJPEGSize（,,,）;
PB_SetPerfectFix（PB_PERFECT_FIX_LIGHTING，FALSE，NULL）;
PB_WaitCommandFinish（PB_WAIT_INFINITE）;
}
@endcode
* /
extern void PB_SetExpectJPEGSize（UINT32 uiCompressRatio，UINT32 uiUpBoundRatio，UINT32 uiLowBoundRatio，UINT32 uiLimitCnt）;
/ **
设置视频输出窗口（在此特定区域中绘制图像）。
@param [in] DispIdx显示索引：#_PB_DISP_IDX。
@param [in] pRect指向视频窗口矩形的指针
@return无效
* /
extern void PB_ConfigVdoWIN（PB_DISP_IDX DispIdx，PURECT pRect）;
/ **
更新第一个视频帧对象。
@param [in] DispIdx显示索引：#_PB_DISP_IDX。
@param [in] pRect指向第一个视频剪辑帧的显示位置矩形的指针
@return无效。
* /
extern void PB_Set1stVideoFrame（PB_DISP_IDX DispIdx，PURECT pRect）;
// - - - - - - - - - - - - - - -[ 其他 ] - - - - - - - - ---------------------
/ **
控制操作结果立即显示在显示器上。
@note此API仅对一个PB操作有效。
@param [in] CtrlType播放屏幕控制类型：#PB_SCREEN_CTRL_TYPE。
@return无效。
例：
@码
{
PB_ScreenControl（PB_LOCK_SCREEN）;
PB_PlayZoomMode（PLAYZOOM_IN）;
PB_WaitCommandFinish（PB_WAIT_INFINITE）;
//在这里更新OSD
PB_ScreenControl（PB_FLUSH_SCREEN）;
}
@endcode
* /
extern void PB_ScreenControl（PB_SCREEN_CTRL_TYPE CtrlType）;
extern void PB_InSlideEffect4DetailMode（void）;
extern void PB_OutSlideEffect4DetailMode（void）;
// ----------------------------- [system] ---------------- ---------------------
/ **
进入睡眠模式
@return无效
* /
extern void PB_Sleep（void）;
/ **
离开睡眠模式
@return无效
* /
extern void PB_Wakeup（void）;
/ **
暂停DMA
@return无效
* /
extern void PB_PauseDMA（void）;
/ **
恢复DMA
@return无效
* /
extern void PB_ResumeDMA（void）;
/ **
暂停显示
@param [in] bWaitFinish如果等到操作完成。
@return无效
* /
extern void PB_PauseDisp（BOOL bWaitFinish）;
/ **
恢复显示
@param [in] bWaitFinish如果等到操作完成。
@return无效
* /
extern void PB_ResumeDisp（BOOL bWaitFinish）;
/ **
更改TV / LCD的显示尺寸。
@param [in] uiDisp_w显示目标的宽度。
@param [in] uiDisp_h显示目标的高度。
@return无效
* /
extern void PB_ChangeDisplaySize（UINT32 uiDisp_w，UINT32 uiDisp_h）;
// ***** [当FileList与FileDB合并时将删除以下代码] ******
//
// [按日期排序]
//
#define PLAY_FILE_ALL 0
#define PLAY_FILE_BY_DAY 1
#define PLAY_FILE_BY_MONTH 2
#define PLAY_FILE_BY_YEAR 3
#define PB_GET_DAY_FROM_DATE（x）（x＆0x1F）
#define PB_GET_MONTH_FROM_DATE（x）（（x >> 5）＆0x0F）
#define PB_GET_YEAR_FROM_DATE（x）（（（x >> 9）＆0x7F）+1980）
typedef enum {
PLAYDATE_INDEX_TO_1ST，
PLAYDATE_INDEX_TO_CURR，
PLAYDATE_INDEX_TO_LAST，
PLAYDATE_INDEX_MAX
} PLAYDATE_INDEX;
extern void PB_PlayDeletByDate（UINT32 Year，UINT32 Month，UINT32 Day）;
extern UINT32 PB_SetBuffForFileDB（UINT32 u32MemAddr，UINT32 u32MaxFileNum）;
extern INT32 PB_PlayByDateInit（void）;
extern void PB_PlayByDateUnInit（void）;
extern UINT16 PB_GetTotalPlayDay（void）;
extern UINT16 PB_GetFirstPlayDay（void）;
extern UINT16 PB_GetLastPlayDay（void）;
extern UINT16 PB_GetNextPlayDay（void）;
extern UINT16 PB_GetPrevPlayDay（void）;
extern UINT16 PB_GetCurrPlayDay（void）;
extern UINT16 PB_GetCurrPlayDaySeq（void）;
extern UINT16 PB_GetCurrPlayYearSeq（void）;
extern UINT16 PB_GetCurrPlayDaySeqInThisYear（void）;
extern UINT16 PB_GetPlayDaysNuminYear（UINT16 SpecYear）;
extern UINT16 PB_GetTotalPlayMonth（void）;
extern UINT16 PB_GetFirstPlayMonth（void）;
extern UINT16 PB_GetNextPlayMonth（void）;
extern UINT16 PB_GetPrevPlayMonth（void）;
extern UINT16 PB_GetTotalPlayYear（void）;
extern UINT16 PB_GetFirstPlayYear（void）;
extern UINT16 PB_GetNextPlayYear（void）;
extern UINT16 PB_GetPrevPlayYear（void）;
extern UINT16 PB_GetTotalFilesNumOfSpecDate（void）;
extern void PB_SetPlayDate（UINT32 DateType，UINT16 Date，PLAYDATE_INDEX CurrIdxTo）;
extern void PB_SetPlayDateToPrev（void）;
extern void PB_SetPlayDateToNext（void）;
// ********* [当FileList与FileDB合并时将删除上面的代码] **********
// @}
＃万一PlayBackTsk.h