Software Porting Access Library V02 to V03

Transcription

1 Application Note Software Porting Access Library V02 to V03 Revision 1.1 Fujitsu Microelectronics Europe GmbH History Date Author Version Comment AvT 1.0 First version AvT 1.1 Revision with versioning, global differences, availability & added new input from Japan (GdcTextureImage) 1

2 Warranty and Disclaimer To the maximum extent permitted by applicable law, Fujitsu Microelectronics Europe GmbH restricts its warranties and its liability for all products delivered free of charge (eg. software include or header files, application examples, Application Notes, target boards, evaluation boards, engineering samples of IC s etc.), its performance and any consequential damages, on the use of the Product in accordance with (i) the terms of the License Agreement and the Sale and Purchase Agreement under which agreements the Product has been delivered, (ii) the technical descriptions and (iii) all accompanying written materials. In addition, to the maximum extent permitted by applicable law, Fujitsu Microelectronics Europe GmbH disclaims all warranties and liabilities for the performance of the Product and any consequential damages in cases of unauthorised decompiling and/or reverse engineering and/or disassembling. Note, all these products are intended and must only be used in an evaluation laboratory environment. 1. Fujitsu Microelectronics Europe GmbH warrants that the Product will perform substantially in accordance with the accompanying written materials for a period of 90 days form the date of receipt by the customer. Concerning the hardware components of the Product, Fujitsu Microelectronics Europe GmbH warrants that the Product will be free from defects in material and workmanship under use and service as specified in the accompanying written materials for a duration of 1 year from the date of receipt by the customer. 2. Should a Product turn out to be defect, Fujitsu Microelectronics Europe GmbH s entire liability and the customer s exclusive remedy shall be, at Fujitsu Microelectronics Europe GmbH s sole discretion, either return of the purchase price and the license fee, or replacement of the Product or parts thereof, if the Product is returned to Fujitsu Microelectronics Europe GmbH in original packing and without further defects resulting from the customer s use or the transport. However, this warranty is excluded if the defect has resulted from an accident not attributable to Fujitsu Microelectronics Europe GmbH, or abuse or misapplication attributable to the customer or any other third party not relating to Fujitsu Microelectronics Europe GmbH. 3. To the maximum extent permitted by applicable law Fujitsu Microelectronics Europe GmbH disclaims all other warranties, whether expressed or implied, in particular, but not limited to, warranties of merchantability and fitness for a particular purpose for which the Product is not designated. 4. To the maximum extent permitted by applicable law, Fujitsu Microelectronics Europe GmbH s and its suppliers liability is restricted to intention and gross negligence. NO LIABILITY FOR CONSEQUENTIAL DAMAGES To the maximum extent permitted by applicable law, in no event shall Fujitsu Microelectronics Europe GmbH and its suppliers be liable for any damages whatsoever (including but without limitation, consequential and/or indirect damages for personal injury, assets of substantial value, loss of profits, interruption of business operation, loss of information, or any other monetary or pecuniary loss) arising from the use of the Product. Should one of the above stipulations be or become invalid and/or unenforceable, the remaining stipulations shall stay in full effect. 2

3 1 Introduction This document describes how to port programs written for the 'MB86290 Series Graphics driver V02' (referred to simply as 'V02' in this document) to the 'GDC Access Library V03' (referred to simply as 'V03' in this document). Please refer to the Users Manual for the respective product for details of the functions in the respective library. 1.1 Access Library Naming Scheme The Access Libraries use a versioning scheme which is reflected in the name: Example: V03L01 V03 = Access Library Version (main) L01 = Subrelease 01 2 Major Differences Access Library V02 / V03 There are several differences between the two libraries, but this section roughly outlines the major points of interest: (please note that the true details of differences can be checked in a separate document, which will soon be made available on the GDC website) V02: No OS required V03: Supports multitasking Supports multiple display controllers Supports multiple capture units Requires OS support (for VRAM memory management, multitasking, semaphores, etc.) Supports OpenGL ES 1.1 (optional library) 3 Access Library Availability The availability of Access Libaries for different GDC devices can be checked on the GDC website. 4 Porting the Initialization The GdcInitialize function was made obsolete with the introduction of V03. In its place, the functions mb86290_initialize_gdc and GdcSysOpen were introduced. Table 1 below shows an example of a ported initialization routine, whereby the lefthand column shows the code for V02 and the righthand column for V03 and later versions. - - void *g_fd = 0; /* File descriptor */ void MainTask(VP_INT exinf){ void MainTask(VP_INT exinf){ GDC_INITPARAM initparam = {0, - - GdcInitialize(&initparam, GDC_INIT_START); mb86290_initialize_gdc(); - - GdcSysOpen(0, &g_fd ); } } Table 1 Ported Initialization Routine 3

4 5 Porting Display and Video Capture Processing In V03, the function for display control has an additional first argument compared with V02. An example of a ported display and video capture processing routine is shown in tables 2a and 2b. Changes in the code are indicated by the use of red italics. GdcDispDimension( GDC_DISP_LAYER_L0, GDC_ENABLE, GDC_16BPP_FORMAT, GDC_FLIPMODE_0, 0x0, 0x0, 640, 480); GdcDispOn(); GdcDispDimension(GDC_DISP_DISPLAY_0, GDC_DISP_LAYER_L0, GDC_ENABLE, GDC_ARGB_ORDER, GDC_16BPP_FORMAT, 640, 480); /* Buffer information on the display frame is registered. display: GDC_DISP_DISPLAY_0 layer : GDC_DISP_LAYER_L0 address: 0x0 draw_id: 0(Default) completion: GDC_RET_IMMEDIATELY */ GdcDispFrameBuffer(GDC_DISP_DISPLAY_0, GDC_DISP_LAYER_L0, 0x0, 0, GDC_RET_IMMEDIATELY); GdcDispOn(GDC_DISP_DISPLAY_0); Table 2a Example of a ported display processing routine 4

5 GdcDispDimension( GDC_DISP_LAYER_L1, GDC_ENABLE, GDC_16BPP_FORMAT, GDC_FLIPMODE_0, L1ADR, L1ADR, 320, 240); GdcCapSetWindowMode( GDC_CAP_YC_MODE, GDC_CAP_CAPTURE_MODE); GdcDispSetLayerWindow( GDC_DISP_LAYER_L1, 0, 0, 320, 240); GdcCapSetVideoCaptureBuffer(); GdcCapSetAttrVideo(); GdcCapSetAttrMisc(); GdcCapSetCaptureArea(); GdcCapStartVideoCapture(); GdcCapGetResource(GDC_CAP_CAPTURE_0, GDC_CAP_NO_OPTION ); GdcDispDimension(GDC_DISP_DISPLAY_0, GDC_DISP_LAYER_L1, GDC_ENABLE, GDC_ARGB_ORDER, GDC_YC_CAPTURE_FORMAT, 320, 240); GdcDispLayerPos(); GdcDispLayerSize(); GdcCapVideoCaptureBuffer(); GdcCapAttrVideo(); GdcCapAttrMisc(); GdcCapCaptureArea(); GdcCapStartVideoCapture(); Table 3b Example of a ported video capture routine (no details) 5

6 6 Porting drawing processing Graphic drawing functions have changed a lot in V03: The following functions are obsolete: XGdcPrimType, XGdcDrawVertex*, XGdcTexCoord* and XgdcPrimEnd An additional change was made to the GdcDrawPrimitive2D function so that it can draw efficiently by specifying the vertex data via an array. The following functions are obsolete: XGdcGeoPrimType, XGdcGeoDrawVertex*, XGdcGeoTexCoord* and XGdcGeoPrimEnd. An additional change was made to the GdcDrawPrimitive3D function so that it can draw efficiently by specifying the vertex data via an array. Examples of various ported drawing operations are shown in tables 3a, 3b and 3c. static void DrawFastTriangle(GDC_CTX *drvctx){ XGdcSetAttrSurf(drvctx, GDC_SHADE_MODE,GDC_SHADE_FLAT); XGdcPrimType(drvctx, GDC_TRIANGLES_FAST); XGdcColor(drvctx, GDC_GREEN); XGdcDrawVertex2D(drvctx, FLOAT_TO_FIXED(160.0f), FLOAT_TO_FIXED(240.0f)); XGdcDrawVertex2D(drvctx, FLOAT_TO_FIXED(20.0f), FLOAT_TO_FIXED(470.0f)); XGdcDrawVertex2D(drvctx, FLOAT_TO_FIXED(300.0f), FLOAT_TO_FIXED(470.0f)); XGdcPrimEnd(drvctx); static void DrawFastTriangle(GDC_CTX *drvctx){ GDC_VTX2X vertex_data_fixed[3]={ {160<<16,240<<16}, {20<<16,470<<16}, {300<<16,470<<16}, GdcAttrSurf(drvctx, GDC_SHADE_MODE, GDC_SHADE_ FLAT); /* Disable color array */ GdcAttrArray(drvctx, GDC_COLOR_ARRAY, GDC_ FALSE); /* Set vertex color */ GdcColori(drvctx, GDC_GREEN); /* Using vertex array */ GdcVertexArray(drvctx, GDC_TYPE_VTX2X, 0, vertex_data_fixed); /* Drawing 2D primitive */ GdcDrawPrimitive2D(drvctx, GDC_TRIANGLES, 0, 3); } } Table 3a Example of a ported flat triangle drawing operation 6

7 static void DrawTriangle(GDC_CTX *drvctx){ XGdcSetAttrSurf(drvctx, GDC_SHADE_MODE, GDC_SHADE_SMOOTH); XGdcGeoPrimType(drvctx, GDC_TRIANGLES); XGdcVertexColor32(drvctx, GDC_RED24); XGdcGeoDrawVertex3D(drvctx, FLOAT_TO_FIXED(480.0f), FLOAT_TO_FIXED(240.0f), FLOAT_TO_SHORT(1.0f)); XGdcVertexColor32(drvctx, GDC_GREEN24); XGdcGeoDrawVertex3D(drvctx, FLOAT_TO_FIXED(340.0f), FLOAT_TO_FIXED(470.0f), FLOAT_TO_SHORT(1.0f)); XGdcVertexColor32(drvctx, GDC_BLUE24); XGdcGeoDrawVertex3D(drvctx, FLOAT_TO_FIXED(620.0f), FLOAT_TO_FIXED(470.0f), FLOAT_TO_SHORT(1.0f)); XGdcGeoPrimEnd(drvctx); } } static void DrawTriangle(GDC_CTX *drvctx){ GDC_VTX3X vertex_data_fixed[3]={ {480<<16,240<<16,1<<16}, {340<<16,470<<16,1<<16}, {620<<16,470<<16,1<<16}, GDC_RGB3F color3f[3] ={ {1.0f,0.0f,0.0f}, {0.0f,1.0f,0.0f}, {0.0f,0.0f,1.0f}, GdcAttrSurf(drvctx, GDC_SHADE_MODE, GDC_SHADE_ SMOOTH); /* Enable color array */ GdcAttrArray(drvctx, GDC_COLOR_ARRAY, GDC_TRUE); /* Using color array */ GdcColorArray(drvctx, GDC_TYPE_RGB3F, GDC_COLOR_A_VTX, 0, color3f); /* Using vertex array */ GdcVertexArray(drvctx, GDC_TYPE_VTX3X, 0, vertex_data_fixed); /* Drawing 3D primitive */ GdcDrawPrimitive3D(drvctx, GDC_TRIANGLES, 0, 3); Table 3b Example of a ported Gouraud triangle drawing operation 7

8 static void DrawTriangleTexture( GDC_CTX *drvctx) typedef struct VertexRec { float x; /* X coordinates of vertex */ float y; /* Y coordinates of vertex */ float z; /* Z coordinates of vertex */ float rw; /* Reciprocal W coordinates of texture */ float s; /* S coordinates of vertex texture */ float t; /* T coordinates of vertex texture */ unsigned short col;/* Color of vertex */ } Vertex; static void DrawTriangleTexture( GDC_CTX *drvctx) GDC_VTX3F v[6] ={ /* Omission */ GDC_TEX2FN texcoord[6]={ {0.0f,0.0f}, {0.0f,1.0f}, {1.0f,0.0f}, {0.0f,1.0f}, {1.0f,1.0f}, {1.0f,0.0f}, Vertex v[8] = { /* Omission */ XGdcSetAttrSurf(drvctx, GDC_TEXTURE_SELECT, GDC_SELECT_TEXTURE); GDC_TEXTURE_DATA * tex_table; GdcAttrSurf(drvctx, GDC_TEXTURE_UNIT0, GDC_ENABLE); /* Get texture buffer area */ GdcSysMalloc( sizeof(gdc_texture_data)*1, (void*)&tex_table); XGdcTextureLoadExt16(drvctx, wall64, TEXADR); XGdcTextureDimension(drvctx, TEXADR, 0, 64, 64); /* Set specify texture table, member=1, initialize=gdc_true */ GdcSpecifyTextureTable(drvctx, 1, tex_table, GDC_TRUE); /* Load texture */ GdcLoadTexture(drvctx, wall64, /* texture data */ TEXADR, /* VRAM addr. */ GDC_16BPP_FORMAT, 64, /* width */ 64, /* height */ 128, /* sstride=(64)*sizeof(short)byte */ 64, /* frame */ 0, /* offsetx */ 0); /* offsety */ GdcTextureImage(drvctx, TEXADR, /* VRAM addr. */ 64, /* width */ 64, /* height */ GDC_TEXTURE_FORMAT_ARGB,/* data format */ GDC_DATA_TYPE_ARGB1555,/* data pixel format */ GDC_TEXTURE_COMP_PLAIN,/* non-compressed */ GDC_SELECT_TEXTURE,/* select texture data */ GDC_DISABLE); /* does not use bilinear fast mode */ XGdcGeoPrimType(drvctx, GDC_TRIANGLE_STRIP); XGdcGeoTexCoord2DNf(drvctx, 0.0f, 0.0f); XGdcGeoDrawVertex3Df(drvctx, v[0].x, v[0].y, v[0].z); XGdcGeoTexCoord2DNf(drvctx, 0.0f, 64); XGdcGeoDrawVertex3Df(drvctx, v[1].x, v[1].y, v[1].z); XGdcGeoTexCoord2DNf(drvctx, 64, 0.0f); XGdcGeoDrawVertex3Df(drvctx, v[4].x, v[4].y, v[4].z); /* Bind texture */ GdcBindTexture(drvctx, GDC_TEXTURE0, TEXADR); /* Enable texture array */ GdcAttrArray(drvctx, GDC_TEXTURE0_ARRAY, GDC_TRUE); /* Enable vertex array */ GdcVertexArray(drvctx, GDC_TYPE_VTX3F, 0, v); /* Enable texture coord array */ GdcTexCoordArray(drvctx, GDC_TEXTURE0, GDC_TYPE_TEX2FN, 2*sizeof(GDC_SFLOAT), texcoord); 8

9 XGdcGeoTexCoord2DNf(drvctx, 64, 64); XGdcGeoDrawVertex3Df(drvctx, v[5].x, v[5].y, v[5].z); XGdcGeoPrimEnd(drvctx); } } /* Drawing 3D primitive */ GdcDrawPrimitive3D(drvctx, GDC_TRIANGLES, 0, 6); Table 3c Example of a ported textured triangle drawing operation 9