PVRVFrame User Manual - Imagination Technologies
Contents
1. ccccccceceeceeceeeeeeeeeeeaeaeeeeeeeeeseaaaeaeeeeeeesesnaaeaeeeeseesesennieaeeeeeess 4 Table 3 Package contents for LINUX ccceceeeeeeeeeeeceeeeeeeeeeeaeaeeeeeeeeesaaaaeaeeeseeesesaaeaeeeeeeeseeennaeeeeeeeess 5 Table 4 Package Contents for OS X cceccccccsesseceeseeeeeceeeaeeeseeeaeeeceseaeeececsaeesseesaeeesessaeeesseaeeseseseeeeseaaes 5 Table 5 Supported EGL extensions 0 cccccccccccessneceeecsneeeeecaeeeecceaeeessceaeeesecaeeesecaeeesscsaeeeessseeseeeaes 10 Table 6 Supported OpenGL ES extenSions cecccccssseceeecsneeeceseeeeeeesaeeeescaeeeseeqaeeessecaeeeeseneeseseaaes 10 Table 7 Current Imitat Ons sess saves cates c iii nesta EEEE EEA N EEEE AREA S 12 1 Introduction PVRVFrame is an emulation layer for desktop platforms that provides an OpenGL ES and EGL environment mimicking that available on PowerVR enabled devices It works by redirecting OpenGL ES API calls to the underlying OpenGL desktop implementation present on the development system PVRVFrame is aimed at developers writing OpenGL ES applications for PowerVR enabled embedded devices and is designed to mitigate the need to work directly with this hardware Figure 1 captures this understanding Revision PowerVR SDK REL_3 5 3523383a 2 User Manual og Imagination Public Imagination Technologies This utility is not pixel accurate nor a performance simulator The performance obtained when running OpenGL ES applications with PVRVFrame is not indic2. stencil wrap ES texture cube map ES texture env_crossbar ES texture float ES texture half float ES texture mirrored repeat K O O O O O O O O O O O O O O O O O O O O O O O O O O O O O O O O O ES vertex array object PVRVFrame 11 Revision PowerVR SDK REL_3 5 3523383a Imagination Technologies Public og imagination 5 Current Limitations Table 1 provides a list of the current limitations of PVRVFrame Table 7 Current limitations Aspect Limitation Precision qualifiers PVRVFrame does not support precision qualifiers in shaders Shaders using precision modifiers will still function but the precision qualifiers are ignored All precisions are assumed to be highp Orthogonal Tex Env Combine This is not supported PBuffer This is not supported on OS X It is supported on Windows and Linux Context The same context cannot be used to render to two different windows under Windows This functions correctly under Linux and OS X glRenderBufferStorage Calling gLRenderBufferStorage with GL STENCIL INDEX8 does not work DEPTH24 STENCIL8 which requires OES packed _depth_stencil should be used instead Revision PowerVR SDK REL_3 5 3523383a 12 User Manual og Imagination Public Imagination Technologies 6 Contact Details For further support visit our forum http forum imgtec
3. EXT shader texture lod ARB shader texture lod IMG multisampled_ render to texture EXT framebuffer multisample It should also be noted that in addition to these requirements at least an Intel HD3000 with proper drivers is also necessary 2 2 Package Contents 2 2 1 Windows Table 2 lists the package contents for Windows Table 2 Package contents for Windows Content Description 1libEGL d1 PVRVFrame driver file for EGL 1 4 1ibGLES CM dll PVRVFrame driver file for OpenGL ES 1 1 libGLESv2 d1 PVRVFrame driver file for OpenGL ES 2 0 and higher libEGL lib Import stub library for use when linking against libEGL dll libGLES_CM lib Import stub library for use when linking against libGLES CM dll 1LibGLESv2 lib Import stub library for use when linking against LibGLESv2 dll Revision PowerVR SDK REL_3 5 3523383a 4 User Manual og Imagination Public Imagination Technologies 2 2 2 Linux Table 3 lists the package contents for Linux Table 3 Package contents for Linux Content o Descriptio 1ibEGL so PVRVFrame driver file for EGL 1 4 1ibGLES cm so PVRVFrame driver file for OpenGL ES 1 1 libGLESv2 so PVRVFrame driver file for OpenGL ES 2 0 and higher 2 2 3 OS X Table 4 lists the package contents for OS X Table 4 Package contents for OS X libEGL dy
4. EXT texture filter anisotropic EXT texture format BGRA8888 not supported on OS X EXT texture rg EXT texture storage EXT texture type 2 10 10 10 REV IMG multisampled render to texture IMG program binary IMG read format IMG shader binary IMG texture compression pvrtc IMG texture compression pvrtc2 IMG texture env enhanced fixed function IMG texture format _BGRA8888 not supported on OS X IMG texture _npot IMG texture stream IMG texture stream2 Revision PowerVR SDK REL_3 5 3523383a 10 User Manual og Imagination Public Imagination Technologies IMG uniform buffer object IMG _ user clip plane IMG vertex array object HR debug ES blend equation separate ES blend func separate ES blend subtract ES byte coordinates ES compressed ETC RGB8 texture ES depth texture ES depth texture cube map ES draw texture ES egl sync ES element index uint ES extended matrix palette ES fixed point ES fragment precision high ES framebuffer object ES get program binary ES mapbuffer ES matrix get ES matrix palette ES packed depth stencil ES point size array ES point sprite ES query matrix ES read_format ES required internalformat ES single precision ES standard derivatives ES
5. INGOWS asenaan nannaa aaa a Aaaa eaaa aaa Aaa aaa a aE R aaa Aaaa 5 2 3 2 LED E E A E A E E E E 5 2 3 3 DED A E A E E E E A 6 3 PVRVFrame Graphical User Interface nsssnneunnsunneunreunnnunrnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn annn nnnn nnmnnn 7 3 1 Working with Profiles airesin A EE A 7 3 2 RUNNING an AppCIiOM sinin A R ent ei 9 4 Supported EXtenSionS sssssseunseunruunrennunnnnunnuunnnunnnunnnunnnnnnnunnnnnnnnnnnnnnn nnne nnnn nanenane nnen ennnen 10 5 G rrent LIMIBALIONS eera a aa arean paraaan aaar eara aeaa aapa aaa aaa aaa aa aaeoa aparecia 12 6 Contact Details srani e eaae aaa eaaa a a a ee eaa aeaa 13 List of Figures Figure 1 PVRVFrame layer OV rViQW ccccescccceceeeceeeeeeeceeeeneneeeeeneeceeeeseceeesaeeeeesneaeeesneneeeessenseeennnnees 3 Figure 2 PVRVE Kame orenera A A caseasyes A A 7 Figure 3 Viewing further information c ccccceceeeeeeeeeeece cece eeeeeaaaaeeeeeeeeesecaaaaeceeeeeeeeeeeeeaeeeeeeeeeeeeeanaeess 8 Figure 4 Preferences dialog DOX ccccccececescce cece eeeeeeeeaeee cece eeeeaaaaaeeeeeeeedceaaaeaeaeeeeeeeseesaeaeeeeeeeeseeenanaees 8 Figure 5 Running an application cccceceesecceceeeeeeeeeeeaeeeeeeeeeeeceaaaeeeeeeeeescaaaaeceeeeeeeseeceaaeeeeeeeeeeeenanaeees 9 List of Tables Table 1 Emulation requirements cccccecceceeeeeeeeeeeaeceeeeeeesecaaeaeceeeeeseseaaaeaeeeeeeesesenaaeaeeeeeeeseeennaneeeeeeess 4 Table 2 Package contents for WiNdOWS
6. ative of the performance obtained when running on real consumer hardware It only gives a qualitative preview of an OpenGL ES application PVRVFrame is available for OpenGL ES 1 1 Common profile OpenGL ES 2 0 and higher and must be used with the corresponding version of the Khronos OpenGL ES header files These header files should be downloaded from the Khronos website although some versions are also bundled with PVRVFrame for convenience Application OpenGL ES 1 1 OpenGL ES 2 0 PVRVFrame OpenGL 1 5 ES 1 1 OpenGL 2 0 ES 2 0 Desktop PC Figure 1 PVRVFrame layer overview PVRVFrame 3 Revision PowerVR SDK REL_3 5 3523383a Imagination Technologies Public og imagination 2 Getting Started 2 1 Hardware Requirements PVRVFrame requires hardware compatible with the underlying OpenGL implementation of the version of OpenGL ES being targeted Table 1 provides an indication of the requirements for emulation Table 1 Emulation requirements Target Requirements OpenGL ES 1 1 OpenGL 1 5 OpenGL ES 2 0 OpenGL 2 0 OpenGL ES 3 0 OpenGL 3 3 OpenGL ES 3 1 OpenGL 4 3 OES packed depth_stencil EXT packed depth_stencil OES framebuffer object EXT framebuffer object OES texture float ARB texture float OES texture half float ARB texture float OES vertex half float ARB half float pixel OES vertex array object ARB vertex array object
7. com Or file a ticket in our support system https ovrsupport imgtec com To learn more about our PowerVR Graphics SDK and Insider programme please visit http www powervrinsider com For general enquiries please visit our website http imgtec com corporate contactus asp PVRVFrame 13 Revision PowerVR SDK REL_3 5 3523383a Imagination Technologies Public og imagination Imagination Technologies the Imagination Technologies logo AMA Codescape Ensigma IMGworks I2P PowerVR PURE PURE Digital MeOS Meta MBX MTX PDP SGX UCC USSE VXD and VXE are trademarks or registered trademarks of Imagination Technologies Limited All other logos products trademarks and registered trademarks are the property of their respective owners Revision PowerVR SDK REL_3 5 3523383a 14 User Manual
8. lib PVRVFrame driver file for EGL 1 4 libGLES_CM dylib PVRVFrame driver file for OpenGL ES 1 1 libGLESv2 dylib PVRVFrame driver file for OpenGL ES 2 0 2 3 Installation 2 3 1 Windows The DLL files that match the version of OpenGL ES that is to be targeted must be in a folder in the PATH environment variable or in the directory the application is running from With the DLL files in place a Visual Studio project can be set up as follows 1 Create a new Visual C project adding source and include files as necessary 2 Add the following directory to the include paths of the project lt SDKPackage gt Builds Include 3 Link against the supplied libraries For OpenGL ES 1 1 projects it is only required to link against LibGLES CM 1lib For OpenGL ES 2 0 and higher it is required to link against both 1ibEGL 1ib and libGLESv2 1lib 2 3 2 Linux To set up a new project to run with PVRVFrame follow these steps 1 Create a new makefile adding source and include files as necessary 2 Add the following directory to the include paths of the project lt SDKPackage gt Builds Include 3 Link against the supplied libraries For OpenGL ES 1 1 projects it is only required to link against libGLES CM so For OpenGL ES 2 0 and higher it is required to link against both libEGL so and libGLESv2 so PVRVFrame 5 Revision PowerVR SDK REL_3 5 3523383a Imagination Technologies Public og imagina
9. lso be rendered in wireframe by using the Wireframe checkbox under Rendering Options Figure 5c File Edit Help Profile Host Console Font MS Shell Dig 2 v Auto dose tabs OGLES3Water exe Buld 3 5 3462881 PID 7272 EJ Rendering Options Wireframe c gt Console Error Lst _ _ Context info ox Hardware profie None E octes3waterexe Build 3563462881 PYRVFrame version 10 1 EEE b gt PowerVR by magnon Figure 5 Running an application Note Other actions can also be achieved in PVRVFrame GUI such as changing the font used to display text in the console PVRVFrame 9 Revision PowerVR SDK REL_3 5 3523383a Imagination Technologies Public og imagination 4 Supported Extensions Table 5 and Table 6 provide lists of supported EGL and OpenGL ES extensions respectively Documentation for these extensions can be found in the Khronos registry at http www khronos org registry Table 5 Supported EGL extensions EGL KHR fence sync EGL IMG context priority EGL KHR create context Table 6 Supported OpenGL ES extensions APPLE copy texture levels APPLE texture 2D limited npot EXT blend minmax EXT debug marker EXT discard framebuffer EXT draw_buffers EXT multi draw arrays EXT multisampled render to texture EXT occlusion query boolean EXT shader texture lod
10. of extensions and capabilities A selection of profiles is included with PVRVFrame To select a given profile for PVRVFrame perform the following steps 1 Open the PVRVFrame GUI Figure 2 E PVRVFrame GUI ranm File Edit Help a Profile Ainol Novo 9 Spark Console Font MS Shell Dig 2 _ Auto dose tabs Profile Information Vendor Imagination Technologies Renderer PowerVR SGX 544MP Device Ainol Novo 9 Spark b gt D More information Disconnected Rendering Options Figure 2 PVRVFrame GUI 2 From the Profile dropdown box select the profile name that matches the device or chipset Figure 2a 3 Expand the option called More Information Figure 2b in order to view the capabilities extensions and EGL configurations for the selected profile Figure 3 PVRVFrame 7 Revision PowerVR SDK REL_3 5 3523383a Imagination Technologies Public og imagination EB PVRVFrame GUI q i S File Edit Help Profile Ainol Novo 9 Spark x Console Font MS Shell Dig 2 hd Auto dose tabs Profile Information Vendor Imagination Technologies Renderer PowerVR SGX 544MP Device Ainol Novo 9 Spark w More information Capabilities Extensions 4 OpenGL ES1 a OpenGL ES 1 smooth_point_size_range OpenGL ES 2 smooth_line_width_range max_lights 8 max_clip_planes 6 max_modelview_stack_depth 16 z max_projection_stack_depth 2 max_texture_stack_depth 4 max_texture_units 4 EGL Configs 22 compressed_tex
11. og Imagination Public Imagination Technologies PowerVR by imagination PVRVFrame User Manual Copyright Imagination Technologies Limited All Rights Reserved This publication contains proprietary information which is subject to change without notice and is supplied as is without warranty of any kind Imagination Technologies and the Imagination Technologies logo are trademarks or registered trademarks of Imagination Technologies Limited All other logos products trademarks and registered trademarks are the property of their respective owners Filename PVRVFrame User Manual Version PowerVR SDK REL_3 5 3523383a External Issue Issue Date 17 Apr 2015 Author Imagination Technologies Limited PVRVFrame 1 Revision PowerVR SDK REL_3 5 3523383a Imagination Technologies Public og imagination Contents 1 Introduces cece seceded seat aces cote ccie che wee debe ceed chem en dotwc cd choca donee chee eve donee eeeeboeeesereneces s 2 2 Getting SUA i oo Fos wae cara ak ae ceases cae es sees wee eas cee cae gusts gee cece ad gage cat 4 2 1 Hardware REqQuiIreMeOntS ccsiee ssetcedssedebhs acceesvnsceedessncteeessneeeges A AARE EANNA AARS 4 2 2 Package Contents sessiun an aea eaa aa aa aaa aa aaa aa a aaia 4 2 2 1 WHNGOWS 5 seecdeccasciidvcsscetesanscancutnack a a a aeaa aa a A aaa E a aa aaa 4 2 2 2 TAL D E A A A E E E E E E S 5 2 2 3 OSX A E E E E E 5 2 3 installationerna nananana ka aaa ae Aaa E aa Ta eaaa AAE 5 2 3 1 W
12. tion 4 Run the following terminal command export LD LIBRARY PATH lt lib folder gt LD LIBRARY PATH Note It is possible to check that the correct versions of the libraries are being used and that the location of these libraries is set correctly To do this run the following command on an application built against the PVRVFrame libraries LAd lt path to application gt 2 3 3 OS X To set up a new project to run with PVRVFrame follow these steps if Create a new makefile adding source and include files as necessary 2 Add the following directory to the include paths of the project lt SDKPackage gt Builds Include 3 Link against the supplied libraries For OpenGL ES 1 1 projects it is only required to link against LibGLES CM dylib For OpenGL ES 2 0 and higher it is required to link against both 1libEGL dylib and libGLESv2 dylib 4 Run the following terminal command export DYLD LIBRARY PATH lt lib folder gt DYLD LIBRARY PATH Note It is possible to check that the correct versions of the libraries are being used and that the location of these libraries is set correctly To do this run the following commands on an application built against the PVRVFrame libraries otool L lt path to application gt Revision PowerVR SDK REL_3 5 3523383a 6 User Manual og Imagination Public Imagination Technologies 3 PVRVFrame Graphical User Interface 3 1 Working with Profiles Profiles are pre configured sets
13. ture_format PALETTE4_RGBS 1 A compressed_texture_format PALETTE4_RGBAS 2 compressed_texture_format PALETTE4_R5_G6_B5 3 compressed_texture_format PALETTE4_RGBA4 4 compressed_texture_format PALETTE4_RGBS_Al 5 compressed_texture_format PALETTES8_RGBS 6 compressed_texture_format PALETTE8_RGBAS 7 compressed_texture_format PALETTES_R5_G6_B5 B 8 d FETE EEE San nairrrro nenas Disconnected Rendering Options x Sex 4 Figure 3 Viewing further information Note If no profiles are displayed in the Profiles dropdown box clickEdit gt Preferences and ensure that the Directory field is set to the directory which contains the profile data files The default directory for Windows is displayed in Figure 4 E Preferences a General Context creation mode Strict Loose what s this Profiles Directory nagination PowerVR_Graphics PowerVR_Tools PVRVFrame Profiles Browse b Advanced aD Cena Figure 4 Preferences dialog box Revision PowerVR SDK REL_3 5 3523383a 8 User Manual en imagination Public Imagination Technologies 3 2 Running an Application When an OpenGL ES application is run Figure 5a it automatically connects to PVRVFrame and any GL errors or warnings that occur during the time that the application is run for will be displayed in the Console section of PVRVFrame Figure 5b By default a running application will be displayed rendered An application can a
Download Pdf Manuals
Related Search