mirror of
https://github.com/obsproject/obs-studio.git
synced 2024-07-04 10:33:30 +00:00
d45017370b
Useful for sharing translated text from modules with the frontend. This is technically already done via properties, but it would be nice to just be able to explicitly look up locale text directly rather than have to go through properties.
176 lines
6.9 KiB
C
176 lines
6.9 KiB
C
/******************************************************************************
|
|
Copyright (C) 2014 by Hugh Bailey <obs.jim@gmail.com>
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 2 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program 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.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
******************************************************************************/
|
|
|
|
#pragma once
|
|
|
|
#include "obs.h"
|
|
|
|
#ifdef __cplusplus
|
|
#define MODULE_EXPORT extern "C" EXPORT
|
|
#define MODULE_EXTERN extern "C"
|
|
#else
|
|
#define MODULE_EXPORT EXPORT
|
|
#define MODULE_EXTERN extern
|
|
#endif
|
|
|
|
/**
|
|
* @file
|
|
* @brief This file is used by modules for module declaration and module
|
|
* exports.
|
|
*
|
|
* @page modules_page Modules
|
|
* @brief Modules or plugins are libraries that can be loaded by libobs and
|
|
* subsequently interact with it.
|
|
*
|
|
* @section modules_overview_sec Overview
|
|
*
|
|
* Modules can provide a wide range of functionality to libobs, they for example
|
|
* can feed captured audio or video to libobs, or interface with an encoder to
|
|
* provide some codec to libobs.
|
|
*
|
|
* @section modules_basic_sec Creating a basic module
|
|
*
|
|
* In order to create a module for libobs you will need to build a shared
|
|
* library that implements a basic interface for libobs to interact with.
|
|
* The following code would create a simple source plugin without localization:
|
|
*
|
|
@code
|
|
#include <obs-module.h>
|
|
|
|
OBS_DECLARE_MODULE()
|
|
|
|
extern struct obs_source_info my_source;
|
|
|
|
bool obs_module_load(void)
|
|
{
|
|
obs_register_source(&my_source);
|
|
return true;
|
|
}
|
|
@endcode
|
|
*
|
|
* If you want to enable localization, you will need to also use the
|
|
* @ref OBS_MODULE_USE_DEFAULT_LOCALE() macro.
|
|
*
|
|
* Other module types:
|
|
* - @ref obs_register_encoder()
|
|
* - @ref obs_register_service()
|
|
* - @ref obs_register_output()
|
|
*
|
|
*/
|
|
|
|
/** Required: Declares a libobs module. */
|
|
#define OBS_DECLARE_MODULE() \
|
|
static obs_module_t *obs_module_pointer; \
|
|
MODULE_EXPORT void obs_module_set_pointer(obs_module_t *module); \
|
|
void obs_module_set_pointer(obs_module_t *module) \
|
|
{ \
|
|
obs_module_pointer = module; \
|
|
} \
|
|
obs_module_t *obs_current_module(void) { return obs_module_pointer; } \
|
|
MODULE_EXPORT uint32_t obs_module_ver(void); \
|
|
uint32_t obs_module_ver(void) { return LIBOBS_API_VER; }
|
|
|
|
/**
|
|
* Required: Called when the module is loaded. Use this function to load all
|
|
* the sources/encoders/outputs/services for your module, or anything else that
|
|
* may need loading.
|
|
*
|
|
* @return Return true to continue loading the module, otherwise
|
|
* false to indicate failure and unload the module
|
|
*/
|
|
MODULE_EXPORT bool obs_module_load(void);
|
|
|
|
/** Optional: Called when the module is unloaded. */
|
|
MODULE_EXPORT void obs_module_unload(void);
|
|
|
|
/** Optional: Called when all modules have finished loading */
|
|
MODULE_EXPORT void obs_module_post_load(void);
|
|
|
|
/** Called to set the current locale data for the module. */
|
|
MODULE_EXPORT void obs_module_set_locale(const char *locale);
|
|
|
|
/** Called to free the current locale data for the module. */
|
|
MODULE_EXPORT void obs_module_free_locale(void);
|
|
|
|
/** Optional: Use this macro in a module to use default locale handling. */
|
|
#define OBS_MODULE_USE_DEFAULT_LOCALE(module_name, default_locale) \
|
|
lookup_t *obs_module_lookup = NULL; \
|
|
const char *obs_module_text(const char *val) \
|
|
{ \
|
|
const char *out = val; \
|
|
text_lookup_getstr(obs_module_lookup, val, &out); \
|
|
return out; \
|
|
} \
|
|
bool obs_module_get_string(const char *val, const char **out) \
|
|
{ \
|
|
return text_lookup_getstr(obs_module_lookup, val, out); \
|
|
} \
|
|
void obs_module_set_locale(const char *locale) \
|
|
{ \
|
|
if (obs_module_lookup) \
|
|
text_lookup_destroy(obs_module_lookup); \
|
|
obs_module_lookup = obs_module_load_locale( \
|
|
obs_current_module(), default_locale, locale); \
|
|
} \
|
|
void obs_module_free_locale(void) \
|
|
{ \
|
|
text_lookup_destroy(obs_module_lookup); \
|
|
obs_module_lookup = NULL; \
|
|
}
|
|
|
|
/** Helper function for looking up locale if default locale handler was used */
|
|
MODULE_EXTERN const char *obs_module_text(const char *lookup_string);
|
|
|
|
/** Helper function for looking up locale if default locale handler was used,
|
|
* returns true if text found, otherwise false */
|
|
MODULE_EXPORT bool obs_module_get_string(const char *lookup_string,
|
|
const char **translated_string);
|
|
|
|
/** Helper function that returns the current module */
|
|
MODULE_EXTERN obs_module_t *obs_current_module(void);
|
|
|
|
/**
|
|
* Returns the location to a module data file associated with the current
|
|
* module. Free with bfree when complete. Equivalent to:
|
|
* obs_find_module_file(obs_current_module(), file);
|
|
*/
|
|
#define obs_module_file(file) obs_find_module_file(obs_current_module(), file)
|
|
|
|
/**
|
|
* Returns the location to a module config file associated with the current
|
|
* module. Free with bfree when complete. Will return NULL if configuration
|
|
* directory is not set. Equivalent to:
|
|
* obs_module_get_config_path(obs_current_module(), file);
|
|
*/
|
|
#define obs_module_config_path(file) \
|
|
obs_module_get_config_path(obs_current_module(), file)
|
|
|
|
/**
|
|
* Optional: Declares the author(s) of the module
|
|
*
|
|
* @param name Author name(s)
|
|
*/
|
|
#define OBS_MODULE_AUTHOR(name) \
|
|
MODULE_EXPORT const char *obs_module_author(void); \
|
|
const char *obs_module_author(void) { return name; }
|
|
|
|
/** Optional: Returns the full name of the module */
|
|
MODULE_EXPORT const char *obs_module_name(void);
|
|
|
|
/** Optional: Returns a description of the module */
|
|
MODULE_EXPORT const char *obs_module_description(void);
|