|
1
|
1 #pragma once
|
|
|
2
|
|
|
3 namespace core_api {
|
|
|
4
|
|
|
5 #ifdef _WIN32
|
|
|
6 //! Retrieves HINSTANCE of calling DLL.
|
|
|
7 HINSTANCE get_my_instance();
|
|
|
8 #endif
|
|
|
9 //! Retrieves filename of calling dll, excluding extension, e.g. "foo_asdf"
|
|
|
10 const char * get_my_file_name();
|
|
|
11 //! Retrieves full path of calling dll, e.g. c:\blah\foobar2000\foo_asdf.dll . No file:// prefix, this path can interop with win32 API calls.
|
|
|
12 const char * get_my_full_path();
|
|
|
13 //! Retrieves main app window. WARNING: this is provided for parent of dialog windows and such only; using it for anything else (such as hooking windowproc to alter app behaviors) is absolutely illegal. \n
|
|
|
14 //! Becomes valid when main window has been fully initialized. Returns NULL during creation of main window's embedded elements.
|
|
|
15 fb2k::hwnd_t get_main_window();
|
|
|
16 //! Tests whether services are available at this time. They are not available only during DLL startup or shutdown (e.g. inside static object constructors or destructors).
|
|
|
17 bool are_services_available();
|
|
|
18 //! Tests whether calling thread is main app thread, and shows diagnostic message in debugger output if it's not.
|
|
|
19 bool assert_main_thread();
|
|
|
20 //! Triggers a bug check if the calling thread is not the main app thread.
|
|
|
21 void ensure_main_thread();
|
|
|
22 //! Returns true if calling thread is main app thread, false otherwise.
|
|
|
23 bool is_main_thread();
|
|
|
24 //! Returns whether the app is currently shutting down.
|
|
|
25 bool is_shutting_down();
|
|
|
26 //! Returns whether the app is currently initializing.
|
|
|
27 bool is_initializing();
|
|
|
28 //! Returns filesystem path to directory with user settings, e.g. file://c:\documents_and_settings\username\blah\foobar2000
|
|
|
29 const char * get_profile_path();
|
|
|
30
|
|
|
31 //! Returns a path to <file name> in fb2k profile folder.
|
|
|
32 inline pfc::string8 pathInProfile(const char * fileName) { pfc::string8 p( core_api::get_profile_path() ); p.add_filename( fileName ); return p; }
|
|
|
33
|
|
|
34 //! Returns whether foobar2000 has been installed in "portable" mode.
|
|
|
35 bool is_portable_mode_enabled();
|
|
|
36
|
|
|
37 //! Returns whether foobar2000 is currently running in quiet mode. \n
|
|
|
38 //! Quiet mode bypasses all GUI features, disables Media Library and does not save any changes to app configuration. \n
|
|
|
39 //! Your component should not display any forms of user interface when running in quiet mode, as well as avoid saving configuration on its own (no need to worry if you only rely on cfg_vars or config_io_callback, they will simply be ignored on shutdown).
|
|
|
40 bool is_quiet_mode_enabled();
|
|
|
41 };
|
|
|
42
|
|
|
43 #define FB2K_SUPPORT_LOW_MEM_MODE (SIZE_MAX <= UINT32_MAX)
|
|
|
44
|
|
|
45 namespace fb2k {
|
|
|
46 bool isDebugModeActive();
|
|
|
47 #if FB2K_SUPPORT_LOW_MEM_MODE
|
|
|
48 bool isLowMemModeActive();
|
|
|
49 #else
|
|
|
50 inline constexpr bool isLowMemModeActive() { return false; }
|
|
|
51 #endif
|
|
|
52 }
|
