mirror of
https://github.com/juce-framework/JUCE.git
synced 2026-01-13 00:04:19 +00:00
113 lines
4.3 KiB
C++
113 lines
4.3 KiB
C++
/*
|
|
==============================================================================
|
|
|
|
This file is part of the JUCE library.
|
|
Copyright (c) 2013 - Raw Material Software Ltd.
|
|
|
|
Permission is granted to use this software under the terms of either:
|
|
a) the GPL v2 (or any later version)
|
|
b) the Affero GPL v3
|
|
|
|
Details of these licenses can be found at: www.gnu.org/licenses
|
|
|
|
JUCE is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
|
|
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
To release a closed-source product which uses JUCE, commercial licenses are
|
|
available: visit www.juce.com for more information.
|
|
|
|
==============================================================================
|
|
*/
|
|
|
|
#ifndef __JUCE_INITIALISATION_JUCEHEADER__
|
|
#define __JUCE_INITIALISATION_JUCEHEADER__
|
|
|
|
|
|
//==============================================================================
|
|
/** Initialises Juce's GUI classes.
|
|
|
|
If you're embedding Juce into an application that uses its own event-loop rather
|
|
than using the START_JUCE_APPLICATION macro, call this function before making any
|
|
Juce calls, to make sure things are initialised correctly.
|
|
|
|
Note that if you're creating a Juce DLL for Windows, you may also need to call the
|
|
Process::setCurrentModuleInstanceHandle() method.
|
|
|
|
@see shutdownJuce_GUI()
|
|
*/
|
|
JUCE_API void JUCE_CALLTYPE initialiseJuce_GUI();
|
|
|
|
/** Clears up any static data being used by Juce's GUI classes.
|
|
|
|
If you're embedding Juce into an application that uses its own event-loop rather
|
|
than using the START_JUCE_APPLICATION macro, call this function in your shutdown
|
|
code to clean up any juce objects that might be lying around.
|
|
|
|
@see initialiseJuce_GUI()
|
|
*/
|
|
JUCE_API void JUCE_CALLTYPE shutdownJuce_GUI();
|
|
|
|
|
|
//==============================================================================
|
|
/** A utility object that helps you initialise and shutdown Juce correctly
|
|
using an RAII pattern.
|
|
|
|
When an instance of this class is created, it calls initialiseJuce_GUI(),
|
|
and when it's deleted, it calls shutdownJuce_GUI(), which lets you easily
|
|
make sure that these functions are matched correctly.
|
|
|
|
This class is particularly handy to use at the beginning of a console app's
|
|
main() function, because it'll take care of shutting down whenever you return
|
|
from the main() call.
|
|
*/
|
|
class ScopedJuceInitialiser_GUI
|
|
{
|
|
public:
|
|
/** The constructor simply calls initialiseJuce_GUI(). */
|
|
ScopedJuceInitialiser_GUI() { initialiseJuce_GUI(); }
|
|
|
|
/** The destructor simply calls shutdownJuce_GUI(). */
|
|
~ScopedJuceInitialiser_GUI() { shutdownJuce_GUI(); }
|
|
};
|
|
|
|
|
|
//==============================================================================
|
|
/*
|
|
To start a JUCE app, use this macro: START_JUCE_APPLICATION (AppSubClass) where
|
|
AppSubClass is the name of a class derived from JUCEApplication.
|
|
|
|
See the JUCEApplication class documentation (juce_Application.h) for more details.
|
|
|
|
*/
|
|
#if JUCE_ANDROID
|
|
#define START_JUCE_APPLICATION(AppClass) \
|
|
juce::JUCEApplication* juce_CreateApplication() { return new AppClass(); }
|
|
|
|
#else
|
|
#if JUCE_WINDOWS
|
|
#if defined (WINAPI) || defined (_WINDOWS_)
|
|
#define JUCE_MAIN_FUNCTION int __stdcall WinMain (HINSTANCE, HINSTANCE, const LPSTR, int)
|
|
#elif defined (_UNICODE)
|
|
#define JUCE_MAIN_FUNCTION int __stdcall WinMain (void*, void*, const wchar_t*, int)
|
|
#else
|
|
#define JUCE_MAIN_FUNCTION int __stdcall WinMain (void*, void*, const char*, int)
|
|
#endif
|
|
#define JUCE_MAIN_FUNCTION_ARGS
|
|
#else
|
|
#define JUCE_MAIN_FUNCTION int main (int argc, char* argv[])
|
|
#define JUCE_MAIN_FUNCTION_ARGS argc, (const char**) argv
|
|
#endif
|
|
|
|
#define START_JUCE_APPLICATION(AppClass) \
|
|
static juce::JUCEApplicationBase* juce_CreateApplication() { return new AppClass(); } \
|
|
extern "C" JUCE_MAIN_FUNCTION \
|
|
{ \
|
|
juce::JUCEApplication::createInstance = &juce_CreateApplication; \
|
|
return juce::JUCEApplication::main (JUCE_MAIN_FUNCTION_ARGS); \
|
|
}
|
|
#endif
|
|
|
|
#endif // __JUCE_INITIALISATION_JUCEHEADER__
|