@ -41,44 +41,62 @@ information.
*/ */
class Context : public Magnum : : Context { class Context : public Magnum : : Context {
public : public :
/**
* @ brief Try to create the context
*
* Unline @ ref Context ( ) , this function returns ` nullptr ` on error
* instead of application exit and thus is usable for context creation
* fallbacks .
*/
static std : : unique_ptr < Context > tryCreate ( ) {
std : : unique_ptr < Context > c { new Context { NoCreate } } ;
return c - > create ( ) ? std : : move ( c ) : nullptr ;
}
/**
/**
* @ brief Constructor * @ brief Constructor
* *
* Does initial setup , loads OpenGL function pointers using * Parses command - line arguments , loads OpenGL function pointers using
* platform - specific API , detects available features and enables them * platform - specific API , does initial setup , detects available
* throughout the engine . If detected version is unsupported or any * features and enables them throughout the engine . If detected version
* other error occurs , a message is printed to output and the * is unsupported or any other error occurs , a message is printed to
* application exits . See @ ref tryCreate ( ) for an alternative . * output and the application exits . See @ ref Context ( NoCreateT , Int , char * * )
* and @ ref tryCreate ( ) for an alternative .
* @ see @ fn_gl { Get } with @ def_gl { MAJOR_VERSION } , @ def_gl { MINOR_VERSION } , * @ see @ fn_gl { Get } with @ def_gl { MAJOR_VERSION } , @ def_gl { MINOR_VERSION } ,
* @ def_gl { CONTEXT_FLAGS } , @ def_gl { NUM_EXTENSIONS } , * @ def_gl { CONTEXT_FLAGS } , @ def_gl { NUM_EXTENSIONS } ,
* @ fn_gl { GetString } with @ def_gl { EXTENSIONS } * @ fn_gl { GetString } with @ def_gl { EXTENSIONS }
*/ */
explicit Context ( ) : explicit Context ( Int argc , char * * argv ) : Context { NoCreate , argc , argv } { create ( ) ; }
# if !defined(CORRADE_TARGET_EMSCRIPTEN) && !defined(CORRADE_TARGET_NACL)
Magnum : : Context { flextGLInit } { } # ifdef MAGNUM_BUILD_DEPRECATED
# else /** @copybrief Context(Int, char**)
Magnum : : Context { nullptr } { } * @ deprecated Use @ ref Context ( Int , char * * ) instead .
# endif */
CORRADE_DEPRECATED ( " use Context(Int, char**) instead " ) explicit Context ( ) : Context ( 0 , nullptr ) { }
# endif
private : /**
explicit Context ( NoCreateT ) : * @ brief Construct the class without doing complete setup
*
* Unlike @ ref Context ( Int , char * * ) just parses command - line arguments
* and sets @ ref version ( ) to @ ref Version : : None , everything else is
* left in empty state . Use @ ref create ( ) or @ ref tryCreate ( ) to
* complete the setup .
*/
explicit Context ( NoCreateT , Int argc , char * * argv ) :
# if !defined(CORRADE_TARGET_EMSCRIPTEN) && !defined(CORRADE_TARGET_NACL) # if !defined(CORRADE_TARGET_EMSCRIPTEN) && !defined(CORRADE_TARGET_NACL)
Magnum : : Context { NoCreate , flextGLInit } { } Magnum : : Context { NoCreate , argc , argv , flextGLInit } { }
# else # else
Magnum : : Context { NoCreate , nullptr } { } Magnum : : Context { NoCreate , argc , argv , nullptr } { }
# endif # endif
/**
* @ brief Complete the context setup and exit on failure
*
* Finalizes the setup after the class was created using
* @ ref Context ( NoCreateT , Int , char * * ) . If detected version is
* unsupported or any other error occurs , a message is printed to error
* output and the application exits . See @ ref Context ( Int , char * * ) for
* more information and @ ref tryCreate ( ) for an alternative .
*/
void create ( ) { return Magnum : : Context : : create ( ) ; }
/**
* @ brief Complete the context setup
*
* Unlike @ ref create ( ) just prints a message to error output and
* returns ` false ` on error .
*/
bool tryCreate ( ) { return Magnum : : Context : : tryCreate ( ) ; }
} ; } ;
} } } }
Vladimír Vondruš
11 years ago