How to utilise OpenGL ES 2.0 on Symbian^3 and Maemo - Revision history

Hamishwillee: Text replace - "Category:Symbian" to ""

2013-05-30T06:34:09Z

Vaishali Rawat: Vaishali Rawat - /* Introduction */

2012-12-12T10:03:40Z

Vaishali Rawat - - Introduction

Hamishwillee: Text replace - "`" to ""`


2012-10-11T01:17:36Z
Text replace - "<code cpp>" to "<code cpp-qt>"

			
			
			
			
		
		← Older revision
		Revision as of 01:17, 11 October 2012
		
Line 58:
Line 58:
  example_defines.h   example_defines.h
    
− <code cpp> + <code cpp-qt>
  #ifndef EXAMPLE_DEFINES_H   #ifndef EXAMPLE_DEFINES_H
  #define EXAMPLE_DEFINES_H   #define EXAMPLE_DEFINES_H
Line 70:
Line 70:
  example_defines.cpp   example_defines.cpp
    
− <code cpp> + <code cpp-qt>
  #include "example_defines.h"   #include "example_defines.h"
    
Line 121:
Line 121:
  * You need to override a few functions from QGLWidget, so add the following methods into the mainwindow as public members:   * You need to override a few functions from QGLWidget, so add the following methods into the mainwindow as public members:
    
− <code cpp> + <code cpp-qt>
  void resizeGL(int width, int height);   void resizeGL(int width, int height);
  void initializeGL();   void initializeGL();
Line 132:
Line 132:
  * Start the implementations by tweaking your constructor a little. The following will set a few attributes of the window in order to maximise the speed of OpenGL. It also creates and starts a timer (QTimer) object that will be responsible for requesting new frames from the application by calling updateGL(). The timer requires a new include <QTimer>; add it into the beginning of mainwindow.cpp.   * Start the implementations by tweaking your constructor a little. The following will set a few attributes of the window in order to maximise the speed of OpenGL. It also creates and starts a timer (QTimer) object that will be responsible for requesting new frames from the application by calling updateGL(). The timer requires a new include <QTimer>; add it into the beginning of mainwindow.cpp.
    
− <code cpp> + <code cpp-qt>
  MainWindow::MainWindow(QWidget *parent) {   MainWindow::MainWindow(QWidget *parent) {
       setAutoFillBackground( false );        setAutoFillBackground( false );
Line 150:
Line 150:
  * resizeGL is quite straightforward. When your window's size changes, reset the OpenGL viewport to match it. The mousePressEvent is overridden just to make sure you have a clean way to exit the application. Whenever you acquire any kind of mousePressEvent, shut down the application.   * resizeGL is quite straightforward. When your window's size changes, reset the OpenGL viewport to match it. The mousePressEvent is overridden just to make sure you have a clean way to exit the application. Whenever you acquire any kind of mousePressEvent, shut down the application.
    
− <code cpp> + <code cpp-qt>
  void MainWindow::resizeGL(int width, int height) {   void MainWindow::resizeGL(int width, int height) {
           // Reset the GL viewport for current resolution.            // Reset the GL viewport for current resolution.
Line 163:
Line 163:
  * The OpenGL initialisation. The Qt framework will call this when everything is ready for OpenGL setup. Before the first rendering call, compile your shaders and add them into m_sampleProgram. The source code for shaders is provided by example_defines, and changes to it should be implemented there. Also, some OpenGL flags are set that are going to remain the same through the entire execution.   * The OpenGL initialisation. The Qt framework will call this when everything is ready for OpenGL setup. Before the first rendering call, compile your shaders and add them into m_sampleProgram. The source code for shaders is provided by example_defines, and changes to it should be implemented there. Also, some OpenGL flags are set that are going to remain the same through the entire execution.
    
− <code cpp> + <code cpp-qt>
  void MainWindow::initializeGL() {   void MainWindow::initializeGL() {
       // Create and compile the vertex-shader        // Create and compile the vertex-shader
Line 186:
Line 186:
  * You are now ready for the actual painting -- the paintGL method, which refers to static data defined at example_defines for vertices and indices.   * You are now ready for the actual painting -- the paintGL method, which refers to static data defined at example_defines for vertices and indices.
    
− <code cpp> + <code cpp-qt>
  void MainWindow::paintGL() {   void MainWindow::paintGL() {
       // Clear the background and depth-buffer for this frame        // Clear the background and depth-buffer for this frame
Line 321:
Line 321:
  * Add members that you need into mygamewindow.h.   * Add members that you need into mygamewindow.h.
    
− <code cpp> + <code cpp-qt>
  GLuint vertexShader;   GLuint vertexShader;
  GLuint fragmentShader;   GLuint fragmentShader;
Line 330:
Line 330:
  Good programming practices force you to zero everything at the constructor. This is always a good idea. In MyGameWindow's constructor, add:   Good programming practices force you to zero everything at the constructor. This is always a good idea. In MyGameWindow's constructor, add:
    
− <code cpp> + <code cpp-qt>
  vertexShader = 0;   vertexShader = 0;
  fragmentShader = 0;   fragmentShader = 0;
Line 339:
Line 339:
  * Override methods for creating, destroying, and updating:   * Override methods for creating, destroying, and updating:
    
− <code cpp> + <code cpp-qt>
  void onCreate();   void onCreate();
  void onDestroy();   void onDestroy();
Line 347:
Line 347:
  * Create an implementation of MyGameWindow::onCreate() in mygamewindow.cpp to initialise your shader program and other things related to rendering.   * Create an implementation of MyGameWindow::onCreate() in mygamewindow.cpp to initialise your shader program and other things related to rendering.
    
− <code cpp> + <code cpp-qt>
  void MyGameWindow::onCreate() {   void MyGameWindow::onCreate() {
       fragmentShader = glCreateShader(GL_FRAGMENT_SHADER);        fragmentShader = glCreateShader(GL_FRAGMENT_SHADER);
Line 384:
Line 384:
  * Don't forget to add MyGameWindow::onDestroy() for releasing the program when the program is shutting down:   * Don't forget to add MyGameWindow::onDestroy() for releasing the program when the program is shutting down:
    
− <code cpp> + <code cpp-qt>
  void MyGameWindow::onDestroy() {   void MyGameWindow::onDestroy() {
       glDeleteShader( vertexShader );        glDeleteShader( vertexShader );
Line 394:
Line 394:
  * Now you can start implementing the actual logic. A frame in Qt GameEnabler is divided in two parts: update and render. Update is meant for changing values, running logic, and so on, and render is purely for rendering the application. You only have one attribute to update, an angle describing your cube's orientation: cubeAngle. You can update it in onUpdate().   * Now you can start implementing the actual logic. A frame in Qt GameEnabler is divided in two parts: update and render. Update is meant for changing values, running logic, and so on, and render is purely for rendering the application. You only have one attribute to update, an angle describing your cube's orientation: cubeAngle. You can update it in onUpdate().
    
− <code cpp> + <code cpp-qt>
  void MyGameWindow::onUpdate( const float frameDelta ) {   void MyGameWindow::onUpdate( const float frameDelta ) {
       cubeAngle += frameDelta*6.0f;        cubeAngle += frameDelta*6.0f;
Line 404:
Line 404:
  * Now everything is set up for rendering. Replace MyGameWindow's onRender() with the following:   * Now everything is set up for rendering. Replace MyGameWindow's onRender() with the following:
    
− <code cpp> + <code cpp-qt>
  void MyGameWindow::onRender()   void MyGameWindow::onRender()
  {   {
Line 527:
Line 527:
  * Replace the clear colour, add the culling states, and disable the depth buffering from AppInitL:   * Replace the clear colour, add the culling states, and disable the depth buffering from AppInitL:
    
− <code cpp> + <code cpp-qt>
  glFrontFace(GL_CCW);   glFrontFace(GL_CCW);
  glEnable(GL_CULL_FACE);   glEnable(GL_CULL_FACE);
Line 536:
Line 536:
  * Add a new function for multiplying matrices together. This is required for the multi-axis rotation of your cube. OpenGL does not have any kind of matrix operations, so you must implement them yourself. In a 'real' application, it is advisable to build a matrix class and do the operations inside: Transformations are widely needed in any 3D application. This is what was done with the Qt version of our example (Qt provided QMatrix4). For the Symbian example, it is done in the following way. In simpleshader.cpp, add a new global function (or define it as a member method; it doesn't matter):   * Add a new function for multiplying matrices together. This is required for the multi-axis rotation of your cube. OpenGL does not have any kind of matrix operations, so you must implement them yourself. In a 'real' application, it is advisable to build a matrix class and do the operations inside: Transformations are widely needed in any 3D application. This is what was done with the Qt version of our example (Qt provided QMatrix4). For the Symbian example, it is done in the following way. In simpleshader.cpp, add a new global function (or define it as a member method; it doesn't matter):
    
− <code cpp> + <code cpp-qt>
  void matrix3x3Multiply( float target[][4], float mul[][4] ) {   void matrix3x3Multiply( float target[][4], float mul[][4] ) {
       float temp[4][4];        float temp[4][4];
Line 553:
Line 553:
  * In this simple example you won't be implementing custom projection matrix generation, but the general shader you are using requires one. You can define a static projection matrix for the shader in the beginning of your simpleshader.cpp:   * In this simple example you won't be implementing custom projection matrix generation, but the general shader you are using requires one. You can define a static projection matrix for the shader in the beginning of your simpleshader.cpp:
    
− <code cpp> + <code cpp-qt>
  const float projectionMatrix[] = {   const float projectionMatrix[] = {
       1.43092f, 0, 0, 0,        1.43092f, 0, 0, 0,
Line 566:
Line 566:
  * Now you need to modify the AppCycle method. First, uncomment the aFrame attribute so you can use it as a main value for your angles. Then add the code for creating a rotation matrix as a two-dimensional table of floats. Finally, replace the old rendering call glDrawArrays to glDrawElements (which is the indexed version) with cube_indices as its attributes. The new AppCycle looks like this:   * Now you need to modify the AppCycle method. First, uncomment the aFrame attribute so you can use it as a main value for your angles. Then add the code for creating a rotation matrix as a two-dimensional table of floats. Finally, replace the old rendering call glDrawArrays to glDrawElements (which is the indexed version) with cube_indices as its attributes. The new AppCycle looks like this:
    
− <code cpp> + <code cpp-qt>
  void CSimpleShader::AppCycle( TInt aFrame,   void CSimpleShader::AppCycle( TInt aFrame,
                          TReal /*aTimeSecs*/,                           TReal /*aTimeSecs*/,
Line 659:
Line 659:
  With any OpenGL application using shaders, there is one thing you must remember to do before calling any compile functions: The locale must be set in a way that does not compromise the compilation. So, before compiling the shaders:   With any OpenGL application using shaders, there is one thing you must remember to do before calling any compile functions: The locale must be set in a way that does not compromise the compilation. So, before compiling the shaders:
    
− <code cpp> + <code cpp-qt>
  setLocale( LC_NUMERIC, "C"); // Reset locale for code compilation.   setLocale( LC_NUMERIC, "C"); // Reset locale for code compilation.
  </code>   </code>
Line 665:
Line 665:
  And after compiling the shaders, reset the locale:   And after compiling the shaders, reset the locale:
    
− <code cpp> + <code cpp-qt>
  setLocale( LC_ALL, "");     // Restore locale   setLocale( LC_ALL, "");     // Restore locale
  </code>   </code>



Hamishwillee: Hamishwillee - Bot update - Add ArticleMetaData
2012-07-25T00:56:00Z
Hamishwillee - Bot update - Add ArticleMetaData

			
			
			
			
		
		← Older revision
		Revision as of 00:56, 25 July 2012
		
Line 1:
Line 1:
  + {{ArticleMetaData <!-- v1.2 -->
  + |sourcecode= [[Media:qtopengl minimal example.zip]] [[Media:gameenabler minimal example.zip]] 
  + |installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
  + |devices= <!-- Devices tested against - e.g. ''devices=Nokia 6131 NFC, Nokia C7-00'') -->
  + |sdk= <!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Qt SDK 1.1.4]) -->
  + |platform= <!-- Compatible platforms - e.g. Symbian^1 and later, Qt 4.6 and later -->
  + |devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
  + |dependencies= <!-- Any other/external dependencies e.g.: Google Maps Api v1.0 -->
  + |signing= <!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
  + |capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
  + |keywords= <!-- APIs, classes and methods (e.g. QSystemScreenSaver, QList, CBase -->
  + |language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
  + |translated-by= <!-- [[User:XXXX]] -->
  + |translated-from-title= <!-- Title only -->
  + |translated-from-id= <!-- Id of translated revision -->
  + |review-by= <!-- After re-review: [[User:username]] -->
  + |review-timestamp= <!-- After re-review: YYYYMMDD -->
  + |update-by= <!-- After significant update: [[User:username]]-->
  + |update-timestamp= <!-- After significant update: YYYYMMDD -->
  + |creationdate= 20110406
  + |author= [[User:Tapla]]
  + }}
  [[Category:Graphics]][[Category:Maemo]][[Category:OpenGL ES 2.0]][[Category:Qt]][[Category:Symbian]][[Category:Symbian C++]]   [[Category:Graphics]][[Category:Maemo]][[Category:OpenGL ES 2.0]][[Category:Qt]][[Category:Symbian]][[Category:Symbian C++]]
  == Introduction ==   == Introduction ==
Line 95:
Line 117:
  * Create a new Qt Gui application. At the Qt Versions phase, select all of the targets except the Qt Simulator. At the details phase, unselect Generate form; you don't need one.   * Create a new Qt Gui application. At the Qt Versions phase, select all of the targets except the Qt Simulator. At the details phase, unselect Generate form; you don't need one.
  * Finish the wizard with your preferred choices. When the wizard has finished, your project should contain three files: main.cpp, mainwindow.h, and mainwindow.cpp.   * Finish the wizard with your preferred choices. When the wizard has finished, your project should contain three files: main.cpp, mainwindow.h, and mainwindow.cpp.
− * When working with QtOpenGL, you need to add an opengl flag into your .PRO file. Go to your .PRO file and add <tt>opengl</tt> to the end of the line with the Qt flags, so it looks like this: <tt>QT += core gui opengl</tt>. + * When working with QtOpenGL, you need to add an opengl flag into your .PRO file. Go to your .PRO file and add {{Icode|opengl}} to the end of the line with the Qt flags, so it looks like this: {{Icode|QT += core gui opengl}}.
− * The application's mainwindow object is derived from QMainWindow by default. You don't want that; instead, you want QGLWidget, so go to mainwindow.h and change <tt>#include <QMainWindow></tt> to <tt>#include <QGLWidget></tt>. Then change the class to be derived from QGLWidget: <tt>class MainWindow : public QGLWidget</tt>. Now your application has an OpenGL view as its mainview. + * The application's mainwindow object is derived from QMainWindow by default. You don't want that; instead, you want QGLWidget, so go to mainwindow.h and change {{Icode|#include <QMainWindow>}} to {{Icode|#include <QGLWidget>}}. Then change the class to be derived from QGLWidget: {{Icode|class MainWindow : public QGLWidget}}. Now your application has an OpenGL view as its mainview.
  * You need to override a few functions from QGLWidget, so add the following methods into the mainwindow as public members:   * You need to override a few functions from QGLWidget, so add the following methods into the mainwindow as public members:
    
Line 216:
Line 238:
  Build and launch. The results should look like this:   Build and launch. The results should look like this:
    
− [[Image:ogles_fig1.png]] + [[File:ogles fig1.png]]
    
  Figure 1: Example running in a desktop target   Figure 1: Example running in a desktop target
Line 274:
Line 296:
  * The application should build, deploy, and start running in your Symbian^3 device.   * The application should build, deploy, and start running in your Symbian^3 device.
    
− [[Image:ogles_fig2.png]] + [[File:ogles fig2.png]]
    
  Figure 2: Example program running on Nokia N8 device in landscape mode   Figure 2: Example program running on Nokia N8 device in landscape mode
Line 407:
Line 429:
  * Select your target (Symbian^3 or Maemo) and hit Run!   * Select your target (Symbian^3 or Maemo) and hit Run!
    
− [[Image:ogles_fig3.png]] + [[File:ogles fig3.png]]
    
  Figure 3: Example running on a Nokia N8 device with Qt GameEnabler   Figure 3: Example running on a Nokia N8 device with Qt GameEnabler
Line 457:
Line 479:
  :"Nokia"   :"Nokia"
    
− ;Supports Series 60 v 3.0 + ;Supports S60 v 3.0
  [0x20022e6d], 0, 0, 0, {"Series60ProductID"}   [0x20022e6d], 0, 0, 0, {"Series60ProductID"}
    
Line 484:
Line 506:
  </code>   </code>
    
− This will create <tt>WorldKey.key</tt> and <tt>WorldCert.cer</tt>, which can be used for self-signing. Obviously, the attributes of the key-generation can be changed as well. Now the actual signing can be applied: + This will create {{Icode|WorldKey.key}} and {{Icode|WorldCert.cer}}, which can be used for self-signing. Obviously, the attributes of the key-generation can be changed as well. Now the actual signing can be applied:
    
  <code>   <code>
Line 533:
Line 555:
  <code cpp>   <code cpp>
  const float projectionMatrix[] = {   const float projectionMatrix[] = {
−      1.43092f , 0 , 0 , 0, +      1.43092f, 0, 0, 0,
−      0 , 2.41421f , 0 , 0, +      0, 2.41421f, 0, 0,
−      0 , 0 , -1.01005f , -1.0f, +      0, 0 , -1.01005f , -1.0f,
−      0 , 0 , -0.201005f , 0 +      0, 0 , -0.201005f, 0
  };   };
  </code>   </code>
Line 621:
Line 643:
  * Now everything is in place. Compile the code with the instructions from the previous chapter; create the SIS package; and sign, install, and RUN!   * Now everything is in place. Compile the code with the instructions from the previous chapter; create the SIS package; and sign, install, and RUN!
    
− [[Image:ogles_fig4.png]] + [[File:ogles fig4.png]]
    
  Figure 4: Example running in Nokia N8 device   Figure 4: Example running in Nokia N8 device
Line 680:
Line 702:
  Follow these next steps:   Follow these next steps:
    
− * Make sure the installed binary (for example: <tt>/usr/local/bin/software_name</tt>) is executable. (Sometimes the binary installed by .DEB is not marked as executable.) If it is not executable, change its attributes accordingly: 'chmod +x binary_file_full_path'. + * Make sure the installed binary (for example: {{Icode|/usr/local/bin/software_name}}) is executable. (Sometimes the binary installed by .DEB is not marked as executable.) If it is not executable, change its attributes accordingly: 'chmod +x binary_file_full_path'.
− * Run the binary with a shell using standalone script (<tt>standalone.sh</tt>), or by clicking the application icon if your installer did one. A typical run with a standalone.sh looks like this: + * Run the binary with a shell using standalone script ({{Icode|standalone.sh}}), or by clicking the application icon if your installer did one. A typical run with a standalone.sh looks like this:
    
  <code>   <code>
Line 687:
Line 709:
  </code>   </code>
    
− [[Image:ogles_fig5.png]] + [[File:ogles fig5.png]]
    
  Figure 5: Example program running on Nokia N900 device   Figure 5: Example program running on Nokia N900 device
Line 709:
Line 731:
  == Supplementary material ==   == Supplementary material ==
    
− * Working code that can be used to test the functionality described in this article is available for download at [[Media:qtopengl_minimal_example.zip]]. + * Working code that can be used to test the functionality described in this article is available for download at [[Media:qtopengl minimal example.zip]].
− * A minimal example utilising [http://projects.developer.nokia.com/qtgameenabler Qt GameEnabler] is available for download at [[Media:gameenabler_minimal_example.zip]]. + * A minimal example utilising [http://projects.developer.nokia.com/qtgameenabler Qt GameEnabler] is available for download at [[Media:gameenabler minimal example.zip]].
  + [[Category:Code Examples]]



Mr Smiley: Mr Smiley -
2012-04-19T08:19:47Z
Mr Smiley -

			
			
			
			
		
		← Older revision
		Revision as of 08:19, 19 April 2012
		
Line 326:
Line 326:
    
  <code cpp>   <code cpp>
− int MyGameWindow::onCreate() { + void MyGameWindow::onCreate() {
       fragmentShader = glCreateShader(GL_FRAGMENT_SHADER);        fragmentShader = glCreateShader(GL_FRAGMENT_SHADER);
       glShaderSource(fragmentShader, 1, (const char**)&sample_fragment_shader_src, NULL);        glShaderSource(fragmentShader, 1, (const char**)&sample_fragment_shader_src, NULL);



Mr Smiley: Mr Smiley - Change update() to onUpdate() with QtGameEnabler example
2012-04-19T08:15:33Z
Mr Smiley - Change update() to onUpdate() with QtGameEnabler example

			
			
			
			
		
		← Older revision
		Revision as of 08:15, 19 April 2012
		
Line 320:
Line 320:
  void onCreate();   void onCreate();
  void onDestroy();   void onDestroy();
− void update( const float frameDelta ); + void onUpdate( const float frameDelta );
  </code>   </code>
    
Line 373:
Line 373:
    
  <code cpp>   <code cpp>
− void MyGameWindow::update( const float frameDelta ) { + void MyGameWindow::onUpdate( const float frameDelta ) {
       cubeAngle += frameDelta*6.0f;        cubeAngle += frameDelta*6.0f;
  };   };



Mr Smiley: Mr Smiley - Fix small bug in code
2012-04-19T03:19:32Z
Mr Smiley - Fix small bug in code

			
			
			
			
		
		← Older revision
		Revision as of 03:19, 19 April 2012
		
Line 165:
Line 165:
    
  <code cpp>   <code cpp>
− void GLWindow::PaintGL() { + void MainWindow::paintGL() {
       // Clear the background and depth-buffer for this frame        // Clear the background and depth-buffer for this frame
       glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);        glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);



Hamishwillee: Hamishwillee - Automated change of text from Forum Nokia to Nokia Developer. (Rebrand)
2011-06-22T11:50:22Z
Hamishwillee - Automated change of text from Forum Nokia to Nokia Developer. (Rebrand)

			
			
			
			
		
		← Older revision
		Revision as of 11:50, 22 June 2011
		
Line 262:
Line 262:
  ==== Prerequisites ====   ==== Prerequisites ====
    
− The Qt SDK has everything you need for compiling QtOpenGL to Symbian^3. You can find the SDK at Forum Nokia: http://www.developer.nokia.com/info/sw.nokia.com/id/da8df288-e615-443d-be5c-00c8a72435f8/Qt_SDK.html. It can be installed on top of previously installed Qt packages. + The Qt SDK has everything you need for compiling QtOpenGL to Symbian^3. You can find the SDK at Nokia Developer: http://www.developer.nokia.com/info/sw.nokia.com/id/da8df288-e615-443d-be5c-00c8a72435f8/Qt_SDK.html. It can be installed on top of previously installed Qt packages.
    
  ==== Step by step ====   ==== Step by step ====
Line 280:
Line 280:
  === Native OpenGL with Qt application framework using Qt GameEnabler ===   === Native OpenGL with Qt application framework using Qt GameEnabler ===
    
− Qt's framework can be mixed with an underlying native OpenGL ES 2.0 implementation as well. When this method is used, Qt provides the complete application framework, helper classes (such as vectors, matrices, etc.), control events, image loaders, and so on; OpenGL is used only for rendering. Qt's components cannot be rendered when native OpenGL is used. Forum Nokia's [http://projects.developer.nokia.com/qtgameenabler Qt GameEnabler] example project does this. It offers a QGLWidget kind-of class (derived from QWidget) that has native OpenGL ES 2.0 instead of QGLWidget's QtOpenGL. This is a very easy way to do game-kind-of (custom UI) applications for Symbian^3 devices. + Qt's framework can be mixed with an underlying native OpenGL ES 2.0 implementation as well. When this method is used, Qt provides the complete application framework, helper classes (such as vectors, matrices, etc.), control events, image loaders, and so on; OpenGL is used only for rendering. Qt's components cannot be rendered when native OpenGL is used. Nokia Developer's [http://projects.developer.nokia.com/qtgameenabler Qt GameEnabler] example project does this. It offers a QGLWidget kind-of class (derived from QWidget) that has native OpenGL ES 2.0 instead of QGLWidget's QtOpenGL. This is a very easy way to do game-kind-of (custom UI) applications for Symbian^3 devices.
    
  Native OpenGL ES 2.0 cannot be compiled directly to a desktop, since desktop OpenGL libraries do not normally support it directly. Some new OpenGL libraries have direct support for OpenGL ES 2.0. There are freely available debug OpenGL ES 2.0 emulation libraries that developers can use to compile their software into a desktop. The two most popular are:   Native OpenGL ES 2.0 cannot be compiled directly to a desktop, since desktop OpenGL libraries do not normally support it directly. Some new OpenGL libraries have direct support for OpenGL ES 2.0. There are freely available debug OpenGL ES 2.0 emulation libraries that developers can use to compile their software into a desktop. The two most popular are:
Line 293:
Line 293:
  The Qt GameEnabler program is just like any other Qt program, and therefore most easily developed with Qt Creator as well. You can build your simple test program with Qt GameEnabler's GameWindow.   The Qt GameEnabler program is just like any other Qt program, and therefore most easily developed with Qt Creator as well. You can build your simple test program with Qt GameEnabler's GameWindow.
    
− * Get the Qt GameEnabler from Forum Nokia Projects: https://projects.developer.nokia.com/qtgameenabler. + * Get the Qt GameEnabler from Nokia Developer Projects: https://projects.developer.nokia.com/qtgameenabler.
  * Open the QtGameEnablerTest.pro template project.   * Open the QtGameEnablerTest.pro template project.
  * Run it to make sure everything is working correctly. You should see a slowly flashing green screen.   * Run it to make sure everything is working correctly. You should see a slowly flashing green screen.
Line 415:
Line 415:
  ==== Prerequisites ====   ==== Prerequisites ====
    
− The Symbian^3 SDK contains everything needed. It can be downloaded from Forum Nokia: http://www.developer.nokia.com/info/sw.nokia.com/id/571baaf2-042a-4662-9d43-a5a68eb42d9d/Symbian_3_SDK_v1_0_en.zip.html. + The Symbian^3 SDK contains everything needed. It can be downloaded from Nokia Developer: http://www.developer.nokia.com/info/sw.nokia.com/id/571baaf2-042a-4662-9d43-a5a68eb42d9d/Symbian_3_SDK_v1_0_en.zip.html.
    
  ==== Testing an example ====   ==== Testing an example ====
Line 691:
Line 691:
  Figure 5: Example program running on Nokia N900 device   Figure 5: Example program running on Nokia N900 device
    
− There are several other examples deploying QtOpenGL on a Maemo device, such as the nice demo combining OpenGL ES 2.0 rendering with a third-party physics engine: OpenGL ES 2.0 Physics demo. It can be located at Forum Nokia: https://projects.developer.nokia.com/gles2phys. + There are several other examples deploying QtOpenGL on a Maemo device, such as the nice demo combining OpenGL ES 2.0 rendering with a third-party physics engine: OpenGL ES 2.0 Physics demo. It can be located at Nokia Developer: https://projects.developer.nokia.com/gles2phys.
    
  === Xlib + OpenGL ES 2 ===   === Xlib + OpenGL ES 2 ===



Hamishwillee: Hamishwillee - Bot fixing redirect link.(Moving links from forum.nokia.com TO developer.nokia.com)
2011-06-21T12:08:54Z
Hamishwillee - Bot fixing redirect link.(Moving links from forum.nokia.com TO developer.nokia.com)

			
			
			
			
		
		← Older revision
		Revision as of 12:08, 21 June 2011
		
Line 26:
Line 26:
  == The example program ==   == The example program ==
    
− You will now build a small example program for Symbian^3 and Maemo devices using a couple of different techniques: QtOpenGL and native OpenGL with a Qt framework (using [http://projects.forum.nokia.com/qtgameenabler Qt GameEnabler]). You will also build a native OpenGL application for Symbian^3 with the Symbian native SDK.   + You will now build a small example program for Symbian^3 and Maemo devices using a couple of different techniques: QtOpenGL and native OpenGL with a Qt framework (using [http://projects.developer.nokia.com/qtgameenabler Qt GameEnabler]). You will also build a native OpenGL application for Symbian^3 with the Symbian native SDK.  
    
  The example uses OpenGL ES 2.0. As a result, the program will output a rotating cube with depth-based gradient lighting implemented with GLSL (programmable pipeline).   The example uses OpenGL ES 2.0. As a result, the program will output a rotating cube with depth-based gradient lighting implemented with GLSL (programmable pipeline).
Line 87:
Line 87:
  ==== Prerequisites ====   ==== Prerequisites ====
    
− When an application needs to run with a desktop computer as well (as in this case), you will need the Qt SDK for Open Source C++ Development on Windows. The package can be found at forum.nokia.com: http://www.forum.nokia.com/info/sw.nokia.com/id/da8df288-e615-443d-be5c-00c8a72435f8/Qt_SDK.html. + When an application needs to run with a desktop computer as well (as in this case), you will need the Qt SDK for Open Source C++ Development on Windows. The package can be found at forum.nokia.com: http://www.developer.nokia.com/info/sw.nokia.com/id/da8df288-e615-443d-be5c-00c8a72435f8/Qt_SDK.html.
    
  ==== Step by step ====   ==== Step by step ====
Line 262:
Line 262:
  ==== Prerequisites ====   ==== Prerequisites ====
    
− The Qt SDK has everything you need for compiling QtOpenGL to Symbian^3. You can find the SDK at Forum Nokia: http://www.forum.nokia.com/info/sw.nokia.com/id/da8df288-e615-443d-be5c-00c8a72435f8/Qt_SDK.html. It can be installed on top of previously installed Qt packages. + The Qt SDK has everything you need for compiling QtOpenGL to Symbian^3. You can find the SDK at Forum Nokia: http://www.developer.nokia.com/info/sw.nokia.com/id/da8df288-e615-443d-be5c-00c8a72435f8/Qt_SDK.html. It can be installed on top of previously installed Qt packages.
    
  ==== Step by step ====   ==== Step by step ====
Line 280:
Line 280:
  === Native OpenGL with Qt application framework using Qt GameEnabler ===   === Native OpenGL with Qt application framework using Qt GameEnabler ===
    
− Qt's framework can be mixed with an underlying native OpenGL ES 2.0 implementation as well. When this method is used, Qt provides the complete application framework, helper classes (such as vectors, matrices, etc.), control events, image loaders, and so on; OpenGL is used only for rendering. Qt's components cannot be rendered when native OpenGL is used. Forum Nokia's [http://projects.forum.nokia.com/qtgameenabler Qt GameEnabler] example project does this. It offers a QGLWidget kind-of class (derived from QWidget) that has native OpenGL ES 2.0 instead of QGLWidget's QtOpenGL. This is a very easy way to do game-kind-of (custom UI) applications for Symbian^3 devices. + Qt's framework can be mixed with an underlying native OpenGL ES 2.0 implementation as well. When this method is used, Qt provides the complete application framework, helper classes (such as vectors, matrices, etc.), control events, image loaders, and so on; OpenGL is used only for rendering. Qt's components cannot be rendered when native OpenGL is used. Forum Nokia's [http://projects.developer.nokia.com/qtgameenabler Qt GameEnabler] example project does this. It offers a QGLWidget kind-of class (derived from QWidget) that has native OpenGL ES 2.0 instead of QGLWidget's QtOpenGL. This is a very easy way to do game-kind-of (custom UI) applications for Symbian^3 devices.
    
  Native OpenGL ES 2.0 cannot be compiled directly to a desktop, since desktop OpenGL libraries do not normally support it directly. Some new OpenGL libraries have direct support for OpenGL ES 2.0. There are freely available debug OpenGL ES 2.0 emulation libraries that developers can use to compile their software into a desktop. The two most popular are:   Native OpenGL ES 2.0 cannot be compiled directly to a desktop, since desktop OpenGL libraries do not normally support it directly. Some new OpenGL libraries have direct support for OpenGL ES 2.0. There are freely available debug OpenGL ES 2.0 emulation libraries that developers can use to compile their software into a desktop. The two most popular are:
Line 293:
Line 293:
  The Qt GameEnabler program is just like any other Qt program, and therefore most easily developed with Qt Creator as well. You can build your simple test program with Qt GameEnabler's GameWindow.   The Qt GameEnabler program is just like any other Qt program, and therefore most easily developed with Qt Creator as well. You can build your simple test program with Qt GameEnabler's GameWindow.
    
− * Get the Qt GameEnabler from Forum Nokia Projects: https://projects.forum.nokia.com/qtgameenabler. + * Get the Qt GameEnabler from Forum Nokia Projects: https://projects.developer.nokia.com/qtgameenabler.
  * Open the QtGameEnablerTest.pro template project.   * Open the QtGameEnablerTest.pro template project.
  * Run it to make sure everything is working correctly. You should see a slowly flashing green screen.   * Run it to make sure everything is working correctly. You should see a slowly flashing green screen.
Line 415:
Line 415:
  ==== Prerequisites ====   ==== Prerequisites ====
    
− The Symbian^3 SDK contains everything needed. It can be downloaded from Forum Nokia: http://www.forum.nokia.com/info/sw.nokia.com/id/571baaf2-042a-4662-9d43-a5a68eb42d9d/Symbian_3_SDK_v1_0_en.zip.html. + The Symbian^3 SDK contains everything needed. It can be downloaded from Forum Nokia: http://www.developer.nokia.com/info/sw.nokia.com/id/571baaf2-042a-4662-9d43-a5a68eb42d9d/Symbian_3_SDK_v1_0_en.zip.html.
    
  ==== Testing an example ====   ==== Testing an example ====
Line 653:
Line 653:
  ==== Prerequisites ====   ==== Prerequisites ====
    
− The Qt SDK has everything you need for compiling QtOpenGL to Maemo. You can find it at: http://www.forum.nokia.com/info/sw.nokia.com/id/da8df288-e615-443d-be5c-00c8a72435f8/Qt_SDK.html. The SDK can be installed on top of previously installed Qt packages. + The Qt SDK has everything you need for compiling QtOpenGL to Maemo. You can find it at: http://www.developer.nokia.com/info/sw.nokia.com/id/da8df288-e615-443d-be5c-00c8a72435f8/Qt_SDK.html. The SDK can be installed on top of previously installed Qt packages.
    
  ==== Step by step ====   ==== Step by step ====
Line 691:
Line 691:
  Figure 5: Example program running on Nokia N900 device   Figure 5: Example program running on Nokia N900 device
    
− There are several other examples deploying QtOpenGL on a Maemo device, such as the nice demo combining OpenGL ES 2.0 rendering with a third-party physics engine: OpenGL ES 2.0 Physics demo. It can be located at Forum Nokia: https://projects.forum.nokia.com/gles2phys. + There are several other examples deploying QtOpenGL on a Maemo device, such as the nice demo combining OpenGL ES 2.0 rendering with a third-party physics engine: OpenGL ES 2.0 Physics demo. It can be located at Forum Nokia: https://projects.developer.nokia.com/gles2phys.
    
  === Xlib + OpenGL ES 2 ===   === Xlib + OpenGL ES 2 ===
Line 710:
Line 710:
    
  * Working code that can be used to test the functionality described in this article is available for download at [[Media:qtopengl_minimal_example.zip]].   * Working code that can be used to test the functionality described in this article is available for download at [[Media:qtopengl_minimal_example.zip]].
− * A minimal example utilising [http://projects.forum.nokia.com/qtgameenabler Qt GameEnabler] is available for download at [[Media:gameenabler_minimal_example.zip]]. + * A minimal example utilising [http://projects.developer.nokia.com/qtgameenabler Qt GameEnabler] is available for download at [[Media:gameenabler_minimal_example.zip]].



Hamishwillee: Bot fixing redirect link
2011-05-27T13:06:53Z
Bot fixing redirect link

			
			
			
			
		
		← Older revision
		Revision as of 13:06, 27 May 2011
		
Line 415:
Line 415:
  ==== Prerequisites ====   ==== Prerequisites ====
    
− The Symbian^3 SDK contains everything needed. It can be downloaded from Forum Nokia: https://www.forum.nokia.com/info/sw.nokia.com/id/571baaf2-042a-4662-9d43-a5a68eb42d9d/Symbian_3_SDK_v1_0_en.zip.html. + The Symbian^3 SDK contains everything needed. It can be downloaded from Forum Nokia: http://www.forum.nokia.com/info/sw.nokia.com/id/571baaf2-042a-4662-9d43-a5a68eb42d9d/Symbian_3_SDK_v1_0_en.zip.html.
    
  ==== Testing an example ====   ==== Testing an example ====

@@ Line 24: / Line 24: @@
 == Introduction ==
-This article analyses and explains in detail a few of the most usable ways to deploy OpenGL ES 2.0 functionality with Nokia's Symbian^3 and Maemo&trade; devices.
+This article analyze and explains in detail a few of the most usable ways to deploy OpenGL ES 2.0 functionality with Nokia's Symbian^3 and Maemo&trade; devices.
 === OpenGL ES ===

How to utilise OpenGL ES 2.0 on Symbian^3 and Maemo - Revision history

Hamishwillee: Text replace - "Category:Symbian" to ""

Vaishali Rawat: Vaishali Rawat - /* Introduction */

Hamishwillee: Text replace - "" to ""

Hamishwillee: Hamishwillee - Bot update - Add ArticleMetaData

Mr Smiley: Mr Smiley -

Mr Smiley: Mr Smiley - Change update() to onUpdate() with QtGameEnabler example

Mr Smiley: Mr Smiley - Fix small bug in code

Hamishwillee: Hamishwillee - Automated change of text from Forum Nokia to Nokia Developer. (Rebrand)

Hamishwillee: Hamishwillee - Bot fixing redirect link.(Moving links from forum.nokia.com TO developer.nokia.com)

Hamishwillee: Bot fixing redirect link

Hamishwillee: Text replace - "`" to ""`