tde api参考04发布日期

2014-2016。保留一切权利商标声、注2014-2016。保留一切权利商标声、注API前前言与与API前前言与与iAPI前言API前言API前言API前言API目目录前 1概API目目录前 1概 概 API参考 API参 API概 3数据类 映射 错误 实 45iAPI插图目图2-1位图与位图中的操作区域的关API插图目图2-1位图与位图中的操作区域的关 图2-2ROP运算的搬移操作示意图 API表格目表API表格目表1-1芯片规 表1-2API参考域说 表1-3数据类型参考域说 表3-1TDE数据结构映射 表4-1TDEAPI错误 API11概1.1API11概1.1alpha叠加、位图按位布尔运算、ColorKey操作。不同型号的芯片支持不同的规格，规格如1-11.2参数值，则系统默认将在无名的mmz上分配。HI_TDE2_BitmapMaskRop和HI_TDE2_BitmapMaskBlend运行的过程当中，需1API1API2API1API22API参2.1APIHI_TDE2_Open：打开TDE设备。HI_TDE2_Close：关闭TDE设备。2API参2.1APIHI_TDE2_Open：打开TDE设备。HI_TDE2_Close：关闭TDE设备。HI_TDE2_BeginJob：创建1个TDE任务。HI_TDE2_EndJob：提交添加操作完成的TDE任务。HI_TDE2_WaitAllDone：等待TDE的所有任务完成。HI_TDE2_Reset：复位TDE所有状态。HI_TDE2_GetAlphaThresholdValue：获取alpha判决阈值。HI_TDE2_SetAlphaThresholdValue：设置alpha判决阈值。HI_TDE2_GetAlphaThresholdState：获取alpha判决开关。HI_TDE2_SetAlphaThresholdState：设置alpha判决开关。HITDE2BitmapMaskRopMaskRop32.2HI_S322.2HI_S3240失败，其值为错误码HI_S32s32Ret=0;/*openTDEdevice*/s32Ret=HI_TDE2_Open();if(HI_SUCCESS!=s32Ret){return-}/*HI_S32s32Ret=0;/*openTDEdevice*/s32Ret=HI_TDE2_Open();if(HI_SUCCESS!=s32Ret){return-}/*closeTDEdevice*/HI_VOID5调用此接口1TDE任务（Job。TDE以任务的形式管理TDE命令调用此接口1TDE任务（Job。TDE以任务的形式管理TDE命令：1TDETDE1个正确的任务句柄。TDE能够缓存的任务数最多为200个。/*declaration6TDE设备未打开，API0失败，其值为错误码HI_S32s32Ret;/*createaTDEjob*/s32Handle=HI_TDE2_BeginJob();HI_S32s32Ret;/*createaTDEjob*/s32Handle=HI_TDE2_BeginJob();{return-}/*submitthejobs32Ret=HI_TDE2_EndJob(s32Handle,HI_FALSE,if(HI_SUCCESS!=s32Ret){return-}HI_TRUE,HI_BOOLbSync,HI_BOOLbBlock,−TDE−−等待被中断780失败，其值为80失败，其值为错误码HI_S32无TDEHI_S32无TDE9TDE设备未打开，API0失败，其值为错误码HI_S32TDE设备未打开，APIHI_S32TDE设备未打开，API0失败，其值为错误码【语TDE2_SURFACE_S*pstSrc,TDE2_SURFACE_S*pstDst,TDE2_RECT_S【描将基地址为pstSrc的位图的指定【语TDE2_SURFACE_S*pstSrc,TDE2_SURFACE_S*pstDst,TDE2_RECT_S【描将基地址为pstSrc的位图的指定区域pstSrcRect拷贝到以pstDst为目pstDstRect为输出区域的内存中位图、操作区域及两者的的关系描述如下位图及位图操作区域的关系如图2-1所示通过指定不同的操作区域，用户可指定位图的全部或部分参与操作若希望整个位图都参与操作，则指定操作区域起点为（00，宽高分别为位−若希望位图的部分区域参与操作，则指定适当的操作区域大小。如2-1中的情况（a），指定的操作区域即为有效的操作区域。注意：如果指定的操作区域与位图部分相交，如情况（b），则自动裁剪指定操作区域，故有效的操作区域−若指定的操作区域与位图不相交，如情况(c)，则认为配置错误，返回错误HIERRTDEINVALIDPARA有效操作区域：指调用者指定的操作区域与位图的相交部分图2-1位图与位图中的操作区域的关(b)操作区域与位图部分相(c)操作区域与位图不相(a)操作区域在位图内位TDE设备未打开，API0失败，其值为错误码TDE设备未打开，API0失败，其值为错误码ByteStride必须按照像素格式对ByteStride必须按照像素格式对HI_U32u32FillData);0失败，其值为错误码alpha位为。alpha位为。TDE2_SURFACE_S*pstSrc,TDE2_SURFACE_S*pstDst,TDE设备未打开，APIpstDst为目的地址、pstDstRectTDE设备未打开，API0失败，其值为错误码pstDst为目的地址、pstDstRectTDE设备未打开，API0失败，其值为错误码TDE2_SURFACE_S*pstSrc,TDE2_RECT_S*pstSrcRect,TDE2_SURFACE_S*pstDst,为目的地址、pstDstRect为输出区域的内存中。0TDE2_SURFACE_S*pstSrc,TDE2_RECT_S*pstSrcRect,TDE2_SURFACE_S*pstDst,为目的地址、pstDstRect为输出区域的内存中。0失败，其值为错误码HI_S32HI_TDE2_GetDeflickerLevel(TDE_DEFLICKER_LEVEL_ETDE设备未打开，APIHI_S32HI_TDE2_GetDeflickerLevel(TDE_DEFLICKER_LEVEL_ETDE设备未打开，APIHI_S32TDE设备未打开，API0失败，其值为错误码HI_S32TDE设备未打开，API0失败，其值为错误码HI_S32TDE设备未打开，API0失败，其值为错误码HI_S32TDE设备未打开，API0失败，其值为错误码景位图的alpha运算结果小于此阈值，结果alpha0；大于或等于此阈值alpha1景位图的alpha运算结果小于此阈值，结果alpha0；大于或等于此阈值alpha1TDE设备未打开，API0失败，其值为错误码为什么，硬件都会生成8888的中间位图格式，若目标图片象素格式为ARGB1555的情alphaalpha1为什么，硬件都会生成8888的中间位图格式，若目标图片象素格式为ARGB1555的情alphaalpha1TDE设备未打开，API0失败，其值为错误码*TDE设备未打开，API0*TDE设备未打开，API0失败，其值为错误码HI_TDE2_SetAlphaThresholdState(HI_BOOLTDE设备未打开，API0HI_TDE2_SetAlphaThresholdState(HI_BOOLTDE设备未打开，API0失败，其值为错误码HI_S32在不使能局部抗闪烁的情况下，HI_TDE2_QuickDeflicker或HI_TDE2_Bitblit在对指定TDE设备未打开，APIHI_S32在不使能局部抗闪烁的情况下，HI_TDE2_QuickDeflicker或HI_TDE2_Bitblit在对指定TDE设备未打开，APITRUE表明使能局部抗闪；FALSE【语TDE2_SURFACE_S*pstBackGround,TDE2_SURFACE_S*pstForeGround,TDE2_SURFACE_S*pstDst,TDE2_RECT_S*pstDstRect,TDE2_OPT_S【描将前景位图（pstForeGround【语TDE2_SURFACE_S*pstBackGround,TDE2_SURFACE_S*pstForeGround,TDE2_SURFACE_S*pstDst,TDE2_RECT_S*pstDstRect,TDE2_OPT_S【描将前景位图（pstForeGround）与背景位图（pstBackGround）的指定区（pstForeGroundRect、pstBackGroundRect）进行运算，将运算后的位图拷贝到（pstDst）的指定区域（pstDstRect）中。其中背景位图（pstBackGround）的指定区（pstBackGroundRect）和目标目标位图（pstDst）的指定区域（pstDstRect）必须一TDE2_OPT_S结构中存放有TDE运算功能的配置信息，如：是否进行ROP操作及作）及指clip区域；是否缩放、是否抗闪烁、是否镜像、是否进alpha混合等信TDE2_OPT_S结构中的配置项涉及到的概念解释如下按位布尔运算，即ROP操作是指在将前景位图RGB颜色分alpha分量值与背景位RGB，果输出，如图2-2所示。图2-2ROP运算的搬移操作示意图Alpha混合Alpha混合操作是指将前景位图和背景位图的像素值按照前景位图alpha值进行加权求和，得到1个alpha混和后的输出位图，达到两个位图按照一定透明度叠加的效果。输出位图alpha值取决于用户设置alpha混合命令，具体的计算方法参考TDE2_BLENDCMD_E里的介绍。这里有2种方式叠加方式：无论哪种模式，全局Alpha都要参−Alpha−Alpha叠加模ColorKey键色。Colorkey操作有2种模式：−colorkey，其设置的含义是前景位图中的关键色不参与运算，将背景位图保留，即背景位图相应区域直接拷贝至输出位图，如图2-3所示。−colorkey−Alpha−Alpha叠加模ColorKey键色。Colorkey操作有2种模式：−colorkey，其设置的含义是前景位图中的关键色不参与运算，将背景位图保留，即背景位图相应区域直接拷贝至输出位图，如图2-3所示。−colorkey，其设置的含义是背景位图中的关键色区域直接拷贝至输出位图，其他区域是运算结果，如图2-4所示。前景位背景位目标位＝＋＋：表示Alpha运算并且对前景位图进行Colorkey操＝：表示运算后结果输前景位背景位目标位＋＝＋：表示Alpha运算并且对背景位图进行Colorkey操＝：表示运算后结果输−TDE2_OPT_SbResizeTRUE，即将前景的操作区域缩放到目的位−TE2_PT_SbReieLE而是将前景、背景和目的位图的操作区域（pstForeroudct、pstBckrudRet、ptstRet）运算，可通过TDE2_OPT_S中bDeflicker指定。运算，可通过TDE2_OPT_S中bDeflicker指定。−−−水平垂直同时镜像，水平垂直同时对称拷贝。颜色扩展功能指将精度低的色彩格式通过调色板（称为CLUT表）扩展到真彩CLUT8256CLUT表，将检索CLUT表来实现CLUT8到真彩色ARGB的扩展。−YC−操作结构TDE2_OPT_SbClutReload项，表明是否需要硬件重新加载格式）时，需要打开ClutReload标记。clip支持两种裁剪模式：−clipTDE运算结果。如2-5所新为TDE运算结果，目标操作区域的其它地方保持不变。−TDEclip指定范围外的区域。如2-6所示，clip区域与目的位图的操作区域相交，区域外裁剪就导致仅将灰色区域更新为TDE运算结果，clip区域内部的地方保持不变。Clip剪切Clip剪切区−−−−对于alphaClip剪切Clip剪切区−−−−对于alphaNULL−−−−−−−ROP−alpha−ColorKey−前景位图指定区域缩放/alpha0−−−−−−−ROP−alpha−ColorKey−前景位图指定区域缩放/alpha0失败，其值为错误码GlobalAlphaAlplh0、Alpha1的设置值统一按照[0,255]的范围进行设置。GlobalAlphaAlplh0、Alpha1的设置值统一按照[0,255]的范围进行设置。clip−−clip，则裁减区域不可完全覆盖操作区域，否则会返回错误码。也要打开ClutReload标记。TDE设备未打开，APIROP操作时，通过操作结构体TDE2_OPT_S中的成员enRopCode_Color和类型中的S1指背景位图pstBackGround，S2指前景位图pstForeGround。ROP操作时，通过操作结构体TDE2_OPT_S中的成员enRopCode_Color和类型中的S1指背景位图pstBackGround，S2指前景位图pstForeGround。TDE2_SURFACE_S*pstBackGround,TDE2_RECT_S*pstBackGroundRect,TDE2_SURFACE_S*pstForeGround,TDE2_RECT_S*pstForeGroundRect,TDE2_SURFACE_S*pstDst,TDE2_RECT_S*pstDstRect,（pstBackGroundRect（pstDstRect−ROP−alpha−ColorKey当背景位图为NULL时，则：−TDE设备未打开，API当背景位图为NULL时，则：−TDE设备未打开，API−1NULL，前景位图无此要不能为clut格式。−1NULL，前景位图无此要不能为clut格式。NULL，则在将前景位图的指定区域往背景位图的在第一次作颜色扩展操作（Clut格式ARGB/AYCbCr格式），需要打开ClutReload标记。ROP操作时，通过操作结构体TDE2_OPT_S中的成员enRopCode_Color和类型中的S1指背景位图pstBackGround，S2指前景位图pstForeGround。光栅格式，可以伴随缩放、抗闪烁、Clip处理。TDE2_MB_S*pstMB,TDE2_RECT_S*pstMbRect,TDE2_SURFACE_S*pstDst,surface指定区域的亮度和色度数据合并成光栅格式输出到目标surface的指定区指定缩放，将直接将宏块数据合并的结果输出到目标surface上，超出的部分将剪切掉。当clip开关打开时，将做剪切拷贝；合并过程中也支持抗闪烁处理。TDE设备未打开，API0失败，其值为错误码TDE设备未打开，API0失败，其值为错误码TDE2_SURFACE_S*pstForeGround,TDE2_SURFACE_STDE2_SURFACE_S*pstForeGround,TDE2_SURFACE_S*pstDst,TDE2_RECT_S*pstDstRect,Clip充功能，即与HI_TDE2_QuickFill实现的功能一样。接口调用形式如下：NULL充功能，即与HI_TDE2_QuickFill实现的功能一样。接口调用形式如下：NULLTDE设备未打开，API0失败，其值为错误码pstOptalpha叠加或ROP、前景的colorkey、输出结果的镜像mirror和剪切clip。−ROP操作时，ROPS1指填充色，S2pstOptalpha叠加或ROP、前景的colorkey、输出结果的镜像mirror和剪切clip。−ROP操作时，ROPS1指填充色，S2−colorkeycolorkey成。例如：垂直直线就是绘制宽度为1像素的矩形。景位图ROP的效果。TDE2_SURFACE_S*pstBackGround,TDE2_RECT_S*pstBackGroundRect,TDE2_SURFACE_S*pstForeGround,TDE2_RECT_S*pstForeGroundRect,TDE2_SURFACE_S*pstMask,TDE2_RECT_S*pstMaskRect,TDE2_SURFACE_S*pstDst,TDE2_RECT_S*pstDstRect,出前景和背景的ROP运算结果值。普通ROP操作是两幅图像的操作区域中的每个像素点都参与ROP操作，无法实现部分区域做ROP操作，部分不做（保留背景。ROP结果，部分区域是背景图象，就像是对前背景ROP的结果做了一个clip剪切。通过构造Mask位图，还可实现随即形状的clip剪切。TDE设备未打开，API0失败，其值为错误码MaskTDE设备未打开，API0失败，其值为错误码Mask域，4个有效操作区域的大小必须一致。域，4个有效操作区域的大小必须一致。大小配置为前景位图大小，例如：对于前景格式为ARGB8888分辨率大小为720*576的图片则需要配置为：720*576*4=1658880。背景位图带Mask位图的叠加效果。TDE2_SURFACE_S*pstBackGround,TDE2_SURFACE_S*pstForeGround,TDE2_SURFACE_S*pstMask,TDE2_RECT_S*pstMaskRect,TDE2_SURFACE_S*pstDst,TDE2_RECT_S*pstDstRect,HI_U8和背景的blending叠加结果。MaskBlending与普通的blending法实现部分区域做Blending操作，部分不做（保留背景。MaksBlendingMask位图可实现：输出图像的部分区域是前clip剪切。通过构造Mask位图，还可实现随即形状的clip剪切。TDE设备未打开，API0失败，其值为错误码MaskMaksBlendingMask位图可实现：输出图像的部分区域是前clip剪切。通过构造Mask位图，还可实现随即形状的clip剪切。TDE设备未打开，API0失败，其值为错误码MaskHI_TDE2_BeginJob获得了有效的任务句柄。域，4个有效操作区域的大小必须一致。HI_TDE2_BeginJob获得了有效的任务句柄。域，4个有效操作区域的大小必须一致。大小配置为前景位图大小，例如：对于前景格式为ARGB8888分辨率大小为720*576的图片则需要配置为：720*576*4=1658880。0−ATDE−ATDE任务中添加其余命令，并提交该任务。若该任务成功执行，则说明所有成功添加的操作都完成了，A操作因未添加成功而没−A出错而取消整个任务，则说明该任务连同其下所有已成功添加的/*declaration*/HI_S32s32Ret;TDE_HANDLEs32Handle;TDE2_SURFACE_SstSrc;TDE2_SURFACE_SstDst;TDE2_OPT_SstOpt={0};/*createaTDEjobs32Handle=HI_API_TDE_BeginJob();if(HI_ERR_TDE_INVALID_HANDLE==s32Handle){return-}/*addserivalcommandstojobTDE设备未打开，API失败，其值为错误码/*prepareargumentsofbitblitcommand/*iffailtoaddonemorebitbltcommandtothejob,/*prepareargumentsofbitblitcommand/*iffailtoaddonemorebitbltcommandtothejob,cancelthejob*/s32Ret=HI_API_TDE_BitBlt(s32Handle,&stSrc,&stDst,&stOpt);if(HI_SUCCESS!=s32Ret){printf("addbitlitcommandfailed!\n");return-}TDE0失败，其值为错误码TDE设备未打开，APITDE设备未打开，APITDE设备未打开，API0失败，其值为错误码3数据类3.1TDE3数据类3.1TDEColorkey3.2typedef3.2typedeftypedefHI_VOID(*typedeftypedefHI_VOID(*typedefenum{TDE2_COLOR_FMT_RGB444=0,}RGB444RGB555}RGB444RGB555RGB565RGB888CLUT1CLUT4CLUT8ACLUT44ACLUT88CLUT1CLUT4CLUT8ACLUT44ACLUT88A1A8bytetypedefstruct{}有效范围：[0,位图宽度）。halfwordtypedefstruct{}有效范围：[0,位图宽度）。halfword操作区域与位图的关系如2-1typedefenum{TDE2_ALUCMD_NONE=0,}操作区域与位图的关系如2-1typedefenum{TDE2_ALUCMD_NONE=0,}Colorize有效范围：[0,位图高度）。有效范围：(0,0xFFF]。有效范围：(0,0xFFF]。操作，请选择TDE2_ALUCMD_COLORIZE。如选择TDE2_ALUCMD_ROP，指进行布尔逻辑运算类型。通过指定TDE2_OPT_S结构中的enRopCode_Color和enRopCode_Alpha成员，分别指定颜色和alpha分量的ROP运算类型。操作，请选择TDE2_ALUCMD_COLORIZE。如选择TDE2_ALUCMD_ROP，指进行布尔逻辑运算类型。通过指定TDE2_OPT_S结构中的enRopCode_Color和enRopCode_Alpha成员，分别指定颜色和alpha分量的ROP运算类型。typedefenum{TDE2_ROP_BLACK=0,~S1*/S2&S1*/S1*/S2*/S2+S1*/}注a：S11，S22不同操作时，S1、S2具体所指的位图不同，详见每个接口的说明部分。如果对两幅位图进行的操作类型选择为TDE2_ALUCMD_ROP，则可以分别对颜色空间和Alpha指pixelAlphaROPWhitenessROP注a：S11，S22不同操作时，S1、S2具体所指的位图不同，详见每个接口的说明部分。如果对两幅位图进行的操作类型选择为TDE2_ALUCMD_ROP，则可以分别对颜色空间和Alpha指pixelAlphaROPWhitenessROPBlackness，则经过运算之后的象素值pixel计算如下：pixel.alpha＝0xff；TDEcolorkeytypedefenum{TDE2_COLORKEY_MODE_NONE=0,}正，在CLUT后做colorkey。typedefenum{TDE2_COLORKEY_MODE_NONE=0,}正，在CLUT后做colorkey。typedefstruct{/*分量最小值/*分量最大值/*分量关键色在范围内或范围外/*分量是否忽略}−bCompIgnoreTRUE，表示关键色比较时，忽略该分量的比较，认为该分−bCompIgnoreFALSE，表示需要根据[最小关键色,最大关键色]范围以及属性bCompOut判断该分量的值是否符合关键色要求。结构u8CompMask控制−bCompIgnoreTRUE，表示关键色比较时，忽略该分量的比较，认为该分−bCompIgnoreFALSE，表示需要根据[最小关键色,最大关键色]范围以及属性bCompOut判断该分量的值是否符合关键色要求。结构u8CompMask控制分量中的bit位有效，即分量会和u8CompMask与运u8CompMask0则分量的值0，若u8CompMask0xFF则分量typedefunion{{}{{}}{{}}ARGB8888typedefenum{TDE2_CLIPMODE_NONE=0,}ARGB8888typedefenum{TDE2_CLIPMODE_NONE=0,}typedefenum{TDE2_OUTALPHA_FROM_NORM=0,}typedeftypedefenum{TDE2_OUTALPHA_FROM_NORM=0,}typedefenum{TDE2_DEFLICKER_MODE_NONE=0,输出图像的alpha来源于alphatypedefenum{TDE_DEFLICKER_AUTO=0,typedefenum{TDE_DEFLICKER_AUTO=0,typedefstruct{TDE2_RECT_SstInRect;TDE2_RECT_SstOutRect;TDE2_OPT_SstOpt;HI_S32s32HorizonOffset;}typedefstruct{TDE2_RECT_SstInRect;TDE2_RECT_SstOutRect;TDE2_OPT_SstOpt;HI_S32s32HorizonOffset;}typedefstruct{HI_U32u32SurfaceNum;typedefstruct{HI_U32u32SurfaceNum;typedefenum{TDE2_BLEND_ZERO=0x0,pixel(foregroundxfsbackgroundxfd)fs：foregroundblendcoefficient。fd：destinationblendcoefficient。sa：forgroundalpha。da：backgroundalphasc：forgroundpixel(foregroundxfsbackgroundxfd)fs：foregroundblendcoefficient。fd：destinationblendcoefficient。sa：forgroundalpha。da：backgroundalphasc：forground11TDE2_BLENDCMD_E01TDE2_BLEND1-TDE2_BLENDTDE2_BLENDTDE2_BLENDTDE2_BLENDTDE2_BLENDTDE2_BLENDTDE2_BLENDmin(1-da,typedefenumtypedefenum{TDE2_BLENDCMD_NONE=0x0，}TDE2BLENDCMDpixel(foregroundxfsbackgroundxfd)fs：foregroundblendcoefficient。fd：destinationblendcoefficient。sa：forgroundalpha。sa：sourcealphatypedefstruct{HI_BOOLfssa，fd1.0-fs0.0，sa：sourcealphatypedefstruct{HI_BOOLfssa，fd1.0-fs0.0，fdfs1.0，fdfs1.0，fd1.0-fs1.0-da，fdfsda，fdfs0.0，fdfs1.0-da，fdfs0.0，fd1.0-fsda，fd1.0-fs1.0-da，fdfs1.0，fdfs1.0-da，fd1.0-fs0.0，fdtypedefstruct{TDE2_ALUCMD_EenAluCmd;TDE2_ROP_CODE_EenRopCode_Color;TDE2_ROP_CODE_EenRopCode_Alpha;TDE2_COLORKEY_UunColorKeyValue;typedefstruct{TDE2_ALUCMD_EenAluCmd;TDE2_ROP_CODE_EenRopCode_Color;TDE2_ROP_CODE_EenRopCode_Alpha;TDE2_COLORKEY_UunColorKeyValue;TDE2_CLIPMODE_Erc1blend模式选择,在eBlendCmd=Src2blend模式选择,eBlendCmd=HI_BOOLbClutReload;HI_U8u8GlobalAlpha;HI_U32u32Colorize;TDE2_BLEND_OPT_SstBlendOpt;TDE2_CSC_OPT_SstCscOpt;alphaROPcolorkeyHI_BOOLbClutReload;HI_U8u8GlobalAlpha;HI_U32u32Colorize;TDE2_BLEND_OPT_SstBlendOpt;TDE2_CSC_OPT_SstCscOpt;alphaROPcolorkeycolorkeyclipclipColorizeCsctypedefenum{TDE2_FILTER_MODE_COLOR=0,}typedefstruct{TDE2_COLOR_FMT_E}typedefenum{TDE2_FILTER_MODE_COLOR=0,}typedefstruct{TDE2_COLOR_FMT_E}typedefenum{TDE2_MIRROR_NONE=0,}typedefenum{T