mirror of
https://github.com/juce-framework/JUCE.git
synced 2026-01-15 00:24:19 +00:00
122 lines
4.7 KiB
C++
122 lines
4.7 KiB
C++
/*
|
|
==============================================================================
|
|
|
|
This file is part of the JUCE library - "Jules' Utility Class Extensions"
|
|
Copyright 2004-11 by Raw Material Software Ltd.
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
JUCE can be redistributed and/or modified under the terms of the GNU General
|
|
Public License (Version 2), as published by the Free Software Foundation.
|
|
A copy of the license is included in the JUCE distribution, or can be found
|
|
online 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.rawmaterialsoftware.com/juce 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.
|
|
|
|
@see ScopedJuceInitialiser_NonGUI
|
|
*/
|
|
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(); }
|
|
|
|
#elif JUCE_WINDOWS && defined (WINAPI)
|
|
#define START_JUCE_APPLICATION(AppClass) \
|
|
static juce::JUCEApplicationBase* juce_CreateApplication() { return new AppClass(); } \
|
|
int WINAPI WinMain (HINSTANCE, HINSTANCE, LPSTR, int) \
|
|
{ \
|
|
juce::JUCEApplication::createInstance = &juce_CreateApplication; \
|
|
return juce::JUCEApplication::main(); \
|
|
}
|
|
|
|
#elif JUCE_WINDOWS
|
|
#define START_JUCE_APPLICATION(AppClass) \
|
|
static juce::JUCEApplicationBase* juce_CreateApplication() { return new AppClass(); } \
|
|
int __stdcall WinMain (void*, void*, const char*, int) \
|
|
{ \
|
|
juce::JUCEApplication::createInstance = &juce_CreateApplication; \
|
|
return juce::JUCEApplication::main(); \
|
|
}
|
|
|
|
#else
|
|
#define START_JUCE_APPLICATION(AppClass) \
|
|
static juce::JUCEApplicationBase* juce_CreateApplication() { return new AppClass(); } \
|
|
int main (int argc, char* argv[]) \
|
|
{ \
|
|
juce::JUCEApplication::createInstance = &juce_CreateApplication; \
|
|
return juce::JUCEApplication::main (argc, (const char**) argv); \
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
#endif // __JUCE_INITIALISATION_JUCEHEADER__
|