Playing around with OpenGL / GLES
C C++
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
include
lib
test
.gitignore
Makefile
README
make_mingw.sh

README

OpenGL/GLES C Framework

Uses Kazmath for most of the math

SELF NOTE ->

CODING STYLE:
   When adding new object structures, functions related to those must have the structure name as prefix or as
   suffix depending which makes more sense.

   eg. typedef struct {} dlObject;
   dlRotateObject( dlObject*, params.. ); or dlObjectFreeTextures( dlObject*, params.. );

   Arguments should also make sense.
   If it's operation function for object, then the object should always be the first argument.

   If the object can be used outside of the library, then it _SHOULD_ have a reference counter
   and following operation functions :
   dlObjectNew()        - Allocation
   dlObjectCopy( src )  - Copy
   dlObjectRef( src )   - Reference
   dlObjectFree( obj )  - Free

   You are also encouraged to use the memory managment functions provided in dlAlloc.c/h
   dlMaloc()
   dlCalloc()
   dlRealloc()
   dlFree()

   Since they have some sanity checks and keep track of the memory.
   If it's internal object or variable then it's not needed to use these, and usually encouraged to not.

   Declariations and code should also not be mixed, put all declarariations at top of the function.

   Variable names should almost always be something you can easily understand.

   I usually use something_this_variable_does naming scheme, but in this project I thought of going with
   somethingThisVariableDoes scheme and it seems to work quite well so far.

   For iterators using variable like i or i2 and such is OK as long as you don't mix it up.

   Defines and enumerations should always be in uppercase and have a prefix eg. IMAGE_FORMAT_JPEG.

   There should never ever be extern variables, with expection of library core struct.

   Whenever I spot new styles that help me read the code a lot, I usually go and change my old stuff,
   sometimes I might forgot some places however.

   Might add more to remind myself, when something useful pops up into my mind :)

   Freeing objects :
   if the object has any reference counted objects, free them first!
   then free only the current object members which are not reference counted when
   object's reference hits 0.

   dlFreeObject( dlObject *obj )
   {
      /* free members which are ref counted,
       * and mark as NULL, when they are truly freed */
      if( dlFreeRefObject( obj ) == RETURN_OK ) obj = NULL;

      /* check if we still have reference on this object */
      if( --obj->refCounter != 0 )
         return( RETURN_NOTHING );

      /* free members which are not ref counted */
      free( obj->awesome_array );
      obj->awesome_array = NULL;

      /* free the object itself */
      free( obj ); obj = NULL;
   }

<- SELF NOTE

TO-DO ->
   """Adding stuff whenever I get old ones done"""
   /* Shaders and OpenGL 3.1+(GLES2.0) renderers are not high priority right now */

    +  =  DONE
   /+  =  PARTIALLY DONE
    -  =  TO-DO

SCENEOBJECTS:
   +Plane
   +Static Model
   /+ Animated Model

   -Cube
   -Sphere
   -Cone
   -Cylinder

IMAGE IMPORTERS:
   +SOIL

   NOTE: Dropped own importers, SOIL is much better :)

MESH IMPORTERS:
   /+OpenCTM
   /+Assimp wrapper
   /+PMD Importer (MikuMikuDance)

   -Framework friendly format

RENDERERS:
   +OGL 1.4+ (GLES 1.1)

   -OGL 3.1+ (GLES 2.0)

GENERAL:
   +OGL/GLES Context creation
   +Internal memory managment
   +Splitted index buffers
   +UVW && Textures
   +VBOs
   +IBOs
   /+Materials
   /+Shaders

   -RTTs

<- TO-DO