2013-09-30 19:37:13 -07:00
|
|
|
/******************************************************************************
|
2014-02-22 19:14:19 -08:00
|
|
|
Copyright (C) 2013-2014 by Hugh Bailey <obs.jim@gmail.com>
|
2013-09-30 19:37:13 -07:00
|
|
|
|
|
|
|
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
|
2013-12-02 21:24:38 -08:00
|
|
|
the Free Software Foundation, either version 2 of the License, or
|
2013-09-30 19:37:13 -07:00
|
|
|
(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/>.
|
|
|
|
******************************************************************************/
|
|
|
|
|
2014-02-14 14:56:01 -08:00
|
|
|
#include <inttypes.h>
|
|
|
|
|
2013-10-29 23:54:43 -07:00
|
|
|
#include "media-io/format-conversion.h"
|
2014-02-18 12:37:56 -08:00
|
|
|
#include "media-io/video-frame.h"
|
2014-05-20 07:26:18 -07:00
|
|
|
#include "media-io/audio-io.h"
|
2014-03-16 18:26:46 -07:00
|
|
|
#include "util/threading.h"
|
2013-10-24 00:57:55 -07:00
|
|
|
#include "util/platform.h"
|
2013-12-30 09:09:20 -08:00
|
|
|
#include "callback/calldata.h"
|
2013-11-26 21:26:14 -08:00
|
|
|
#include "graphics/matrix3.h"
|
|
|
|
#include "graphics/vec3.h"
|
2013-10-24 00:57:55 -07:00
|
|
|
|
2013-09-30 19:37:13 -07:00
|
|
|
#include "obs.h"
|
2014-01-26 17:48:14 -08:00
|
|
|
#include "obs-internal.h"
|
2013-09-30 19:37:13 -07:00
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
static inline bool source_valid(const struct obs_source *source)
|
2014-05-04 16:20:11 -07:00
|
|
|
{
|
|
|
|
return source && source->context.data;
|
|
|
|
}
|
|
|
|
|
2014-07-28 16:08:56 -07:00
|
|
|
const struct obs_source_info *find_source(struct darray *list, const char *id)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
|
|
|
size_t i;
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
struct obs_source_info *array = list->array;
|
2013-09-30 19:37:13 -07:00
|
|
|
|
|
|
|
for (i = 0; i < list->num; i++) {
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
struct obs_source_info *info = array+i;
|
2013-12-20 16:23:19 -08:00
|
|
|
if (strcmp(info->id, id) == 0)
|
2013-09-30 19:37:13 -07:00
|
|
|
return info;
|
|
|
|
}
|
|
|
|
|
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
static const struct obs_source_info *get_source_info(enum obs_source_type type,
|
2013-12-30 05:56:39 -08:00
|
|
|
const char *id)
|
|
|
|
{
|
|
|
|
struct darray *list = NULL;
|
|
|
|
|
|
|
|
switch (type) {
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
case OBS_SOURCE_TYPE_INPUT:
|
|
|
|
list = &obs->input_types.da;
|
|
|
|
break;
|
|
|
|
|
|
|
|
case OBS_SOURCE_TYPE_FILTER:
|
|
|
|
list = &obs->filter_types.da;
|
|
|
|
break;
|
|
|
|
|
|
|
|
case OBS_SOURCE_TYPE_TRANSITION:
|
|
|
|
list = &obs->transition_types.da;
|
|
|
|
break;
|
2013-12-30 05:56:39 -08:00
|
|
|
}
|
|
|
|
|
|
|
|
return find_source(list, id);
|
|
|
|
}
|
|
|
|
|
2014-03-01 04:54:55 -08:00
|
|
|
static const char *source_signals[] = {
|
|
|
|
"void destroy(ptr source)",
|
|
|
|
"void add(ptr source)",
|
|
|
|
"void remove(ptr source)",
|
|
|
|
"void activate(ptr source)",
|
|
|
|
"void deactivate(ptr source)",
|
|
|
|
"void show(ptr source)",
|
|
|
|
"void hide(ptr source)",
|
2014-06-30 00:05:35 -07:00
|
|
|
"void rename(ptr source, string new_name, string prev_name)",
|
2014-03-01 04:54:55 -08:00
|
|
|
"void volume(ptr source, in out float volume)",
|
2014-09-30 06:40:46 -07:00
|
|
|
"void update_properties(ptr source)",
|
2014-10-23 09:56:50 -07:00
|
|
|
"void update_flags(ptr source, int flags)",
|
2014-12-27 20:55:03 -08:00
|
|
|
"void audio_sync(ptr source, int out int offset)",
|
2014-12-13 05:10:45 -08:00
|
|
|
"void audio_data(ptr source, ptr data)",
|
(API Change) Add support for multiple audio mixers
API changed:
--------------------------
void obs_output_set_audio_encoder(
obs_output_t *output,
obs_encoder_t *encoder);
obs_encoder_t *obs_output_get_audio_encoder(
const obs_output_t *output);
obs_encoder_t *obs_audio_encoder_create(
const char *id,
const char *name,
obs_data_t *settings);
Changed to:
--------------------------
/* 'idx' specifies the track index of the output */
void obs_output_set_audio_encoder(
obs_output_t *output,
obs_encoder_t *encoder,
size_t idx);
/* 'idx' specifies the track index of the output */
obs_encoder_t *obs_output_get_audio_encoder(
const obs_output_t *output,
size_t idx);
/* 'mixer_idx' specifies the mixer index to capture audio from */
obs_encoder_t *obs_audio_encoder_create(
const char *id,
const char *name,
obs_data_t *settings,
size_t mixer_idx);
Overview
--------------------------
This feature allows multiple audio mixers to be used at a time. This
capability was able to be added with surprisingly very little extra
overhead. Audio will not be mixed unless it's assigned to a specific
mixer, and mixers will not mix unless they have an active mix
connection.
Mostly this will be useful for being able to separate out specific audio
for recording versus streaming, but will also be useful for certain
streaming services that support multiple audio streams via RTMP.
I didn't want to use a variable amount of mixers due to the desire to
reduce heap allocations, so currently I set the limit to 4 simultaneous
mixers; this number can be increased later if needed, but honestly I
feel like it's just the right number to use.
Sources:
Sources can now specify which audio mixers their audio is mixed to; this
can be a single mixer or multiple mixers at a time. The
obs_source_set_audio_mixers function sets the audio mixer which an audio
source applies to. For example, 0xF would mean that the source applies
to all four mixers.
Audio Encoders:
Audio encoders now must specify which specific audio mixer they use when
they encode audio data.
Outputs:
Outputs that use encoders can now support multiple audio tracks at once
if they have the OBS_OUTPUT_MULTI_TRACK capability flag set. This is
mostly only useful for certain types of RTMP transmissions, though may
be useful for file formats that support multiple audio tracks as well
later on.
2015-01-14 02:12:08 -08:00
|
|
|
"void audio_mixers(ptr source, in out int mixers)",
|
2014-03-01 04:54:55 -08:00
|
|
|
NULL
|
|
|
|
};
|
|
|
|
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
bool obs_source_init_context(struct obs_source *source,
|
2014-09-25 17:44:05 -07:00
|
|
|
obs_data_t *settings, const char *name)
|
2013-12-26 22:10:15 -08:00
|
|
|
{
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
if (!obs_context_data_init(&source->context, settings, name))
|
2014-03-01 04:54:55 -08:00
|
|
|
return false;
|
|
|
|
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
return signal_handler_add_array(source->context.signals,
|
|
|
|
source_signals);
|
2013-12-26 22:10:15 -08:00
|
|
|
}
|
|
|
|
|
2014-08-04 08:41:15 -07:00
|
|
|
const char *obs_source_get_display_name(enum obs_source_type type,
|
|
|
|
const char *id)
|
2013-12-30 05:56:39 -08:00
|
|
|
{
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
const struct obs_source_info *info = get_source_info(type, id);
|
2014-08-04 14:38:26 -07:00
|
|
|
return (info != NULL) ? info->get_name() : NULL;
|
2013-12-30 05:56:39 -08:00
|
|
|
}
|
|
|
|
|
2013-12-20 10:56:01 -08:00
|
|
|
/* internal initialization */
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
bool obs_source_init(struct obs_source *source,
|
|
|
|
const struct obs_source_info *info)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2013-11-20 14:00:16 -08:00
|
|
|
source->refs = 1;
|
2014-02-20 14:53:16 -08:00
|
|
|
source->user_volume = 1.0f;
|
libobs: Refactor source volume transition design
This changes the way source volume handles transitioning between being
active and inactive states.
The previous way that transitioning handled volume was that it set the
presentation volume of the source and all of its sub-sources to 0.0 if
the source was inactive, and 1.0 if active. Transition sources would
then also set the presentation volume for sub-sources to whatever their
transitioning volume was. However, the problem with this is that the
design didn't take in to account if the source or its sub-sources were
active anywhere else, so because of that it would break if that ever
happened, and I didn't realize that when I was designing it.
So instead, this completely overhauls the design of handling
transitioning volume. Each frame, it'll go through all sources and
check whether they're active or inactive and set the base volume
accordingly. If transitions are currently active, it will actually walk
the active source tree and check whether the source is in a
transitioning state somewhere.
- If the source is a sub-source of a transition, and it's not active
outside of the transition, then the transition will control the
volume of the source.
- If the source is a sub-source of a transition, but it's also active
outside of the transition, it'll defer to whichever is louder.
This also adds a new callback to the obs_source_info structure for
transition sources, get_transition_volume, which is called to get the
transitioning volume of a sub-source.
2014-12-27 22:16:10 -08:00
|
|
|
source->present_volume = 1.0f;
|
|
|
|
source->base_volume = 0.0f;
|
2014-02-20 15:16:25 -08:00
|
|
|
source->sync_offset = 0;
|
2013-10-24 00:57:55 -07:00
|
|
|
pthread_mutex_init_value(&source->filter_mutex);
|
2015-01-03 23:19:09 -08:00
|
|
|
pthread_mutex_init_value(&source->async_mutex);
|
2013-10-24 00:57:55 -07:00
|
|
|
pthread_mutex_init_value(&source->audio_mutex);
|
2014-01-28 14:45:30 -08:00
|
|
|
|
2013-10-24 00:57:55 -07:00
|
|
|
if (pthread_mutex_init(&source->filter_mutex, NULL) != 0)
|
|
|
|
return false;
|
|
|
|
if (pthread_mutex_init(&source->audio_mutex, NULL) != 0)
|
|
|
|
return false;
|
2015-01-03 23:19:09 -08:00
|
|
|
if (pthread_mutex_init(&source->async_mutex, NULL) != 0)
|
2013-10-24 00:57:55 -07:00
|
|
|
return false;
|
2013-09-30 19:37:13 -07:00
|
|
|
|
2014-07-29 09:38:55 -07:00
|
|
|
if (info && info->output_flags & OBS_SOURCE_AUDIO) {
|
2014-08-05 15:07:54 -07:00
|
|
|
source->audio_line = audio_output_create_line(obs->audio.audio,
|
(API Change) Add support for multiple audio mixers
API changed:
--------------------------
void obs_output_set_audio_encoder(
obs_output_t *output,
obs_encoder_t *encoder);
obs_encoder_t *obs_output_get_audio_encoder(
const obs_output_t *output);
obs_encoder_t *obs_audio_encoder_create(
const char *id,
const char *name,
obs_data_t *settings);
Changed to:
--------------------------
/* 'idx' specifies the track index of the output */
void obs_output_set_audio_encoder(
obs_output_t *output,
obs_encoder_t *encoder,
size_t idx);
/* 'idx' specifies the track index of the output */
obs_encoder_t *obs_output_get_audio_encoder(
const obs_output_t *output,
size_t idx);
/* 'mixer_idx' specifies the mixer index to capture audio from */
obs_encoder_t *obs_audio_encoder_create(
const char *id,
const char *name,
obs_data_t *settings,
size_t mixer_idx);
Overview
--------------------------
This feature allows multiple audio mixers to be used at a time. This
capability was able to be added with surprisingly very little extra
overhead. Audio will not be mixed unless it's assigned to a specific
mixer, and mixers will not mix unless they have an active mix
connection.
Mostly this will be useful for being able to separate out specific audio
for recording versus streaming, but will also be useful for certain
streaming services that support multiple audio streams via RTMP.
I didn't want to use a variable amount of mixers due to the desire to
reduce heap allocations, so currently I set the limit to 4 simultaneous
mixers; this number can be increased later if needed, but honestly I
feel like it's just the right number to use.
Sources:
Sources can now specify which audio mixers their audio is mixed to; this
can be a single mixer or multiple mixers at a time. The
obs_source_set_audio_mixers function sets the audio mixer which an audio
source applies to. For example, 0xF would mean that the source applies
to all four mixers.
Audio Encoders:
Audio encoders now must specify which specific audio mixer they use when
they encode audio data.
Outputs:
Outputs that use encoders can now support multiple audio tracks at once
if they have the OBS_OUTPUT_MULTI_TRACK capability flag set. This is
mostly only useful for certain types of RTMP transmissions, though may
be useful for file formats that support multiple audio tracks as well
later on.
2015-01-14 02:12:08 -08:00
|
|
|
source->context.name, 0xF);
|
2013-10-24 00:57:55 -07:00
|
|
|
if (!source->audio_line) {
|
|
|
|
blog(LOG_ERROR, "Failed to create audio line for "
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
"source '%s'", source->context.name);
|
2013-10-24 00:57:55 -07:00
|
|
|
return false;
|
|
|
|
}
|
|
|
|
}
|
2013-10-18 20:25:13 -07:00
|
|
|
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
obs_context_data_insert(&source->context,
|
|
|
|
&obs->data.sources_mutex,
|
|
|
|
&obs->data.first_source);
|
2013-10-24 00:57:55 -07:00
|
|
|
return true;
|
2013-09-30 19:37:13 -07:00
|
|
|
}
|
|
|
|
|
2013-12-27 04:08:58 -08:00
|
|
|
static inline void obs_source_dosignal(struct obs_source *source,
|
2014-02-23 16:46:00 -08:00
|
|
|
const char *signal_obs, const char *signal_source)
|
2013-12-27 04:08:58 -08:00
|
|
|
{
|
|
|
|
struct calldata data;
|
|
|
|
|
|
|
|
calldata_init(&data);
|
2014-08-05 17:49:28 -07:00
|
|
|
calldata_set_ptr(&data, "source", source);
|
2014-02-23 16:46:00 -08:00
|
|
|
if (signal_obs)
|
|
|
|
signal_handler_signal(obs->signals, signal_obs, &data);
|
|
|
|
if (signal_source)
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
signal_handler_signal(source->context.signals, signal_source,
|
|
|
|
&data);
|
2013-12-27 04:08:58 -08:00
|
|
|
calldata_free(&data);
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
obs_source_t *obs_source_create(enum obs_source_type type, const char *id,
|
|
|
|
const char *name, obs_data_t *settings)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2014-07-29 09:38:55 -07:00
|
|
|
struct obs_source *source = bzalloc(sizeof(struct obs_source));
|
2013-09-30 19:37:13 -07:00
|
|
|
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
const struct obs_source_info *info = get_source_info(type, id);
|
2013-09-30 19:37:13 -07:00
|
|
|
if (!info) {
|
2014-07-29 08:11:49 -07:00
|
|
|
blog(LOG_ERROR, "Source ID '%s' not found", id);
|
2013-09-30 19:37:13 -07:00
|
|
|
|
2014-07-29 09:38:55 -07:00
|
|
|
source->info.id = bstrdup(id);
|
|
|
|
source->info.type = type;
|
|
|
|
source->owns_info_id = true;
|
|
|
|
} else {
|
|
|
|
source->info = *info;
|
|
|
|
}
|
2013-10-24 00:57:55 -07:00
|
|
|
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
if (!obs_source_init_context(source, settings, name))
|
2013-12-26 22:10:15 -08:00
|
|
|
goto fail;
|
|
|
|
|
2014-08-04 21:27:52 -07:00
|
|
|
if (info && info->get_defaults)
|
|
|
|
info->get_defaults(source->context.settings);
|
2014-01-28 17:41:24 -08:00
|
|
|
|
2014-05-04 16:20:11 -07:00
|
|
|
/* allow the source to be created even if creation fails so that the
|
|
|
|
* user's data doesn't become lost */
|
2014-07-29 09:38:55 -07:00
|
|
|
if (info)
|
|
|
|
source->context.data = info->create(source->context.settings,
|
|
|
|
source);
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
if (!source->context.data)
|
2014-05-04 16:20:11 -07:00
|
|
|
blog(LOG_ERROR, "Failed to create source '%s'!", name);
|
2013-10-24 00:57:55 -07:00
|
|
|
|
2014-01-28 17:41:24 -08:00
|
|
|
if (!obs_source_init(source, info))
|
2013-10-24 00:57:55 -07:00
|
|
|
goto fail;
|
2013-09-30 19:37:13 -07:00
|
|
|
|
2014-07-13 05:01:02 -07:00
|
|
|
blog(LOG_INFO, "source '%s' (%s) created", name, id);
|
2014-03-01 04:54:55 -08:00
|
|
|
obs_source_dosignal(source, "source_create", NULL);
|
2014-12-27 21:42:03 -08:00
|
|
|
|
2014-12-31 21:58:45 -08:00
|
|
|
source->flags = source->default_flags;
|
|
|
|
|
2014-12-31 15:15:19 -08:00
|
|
|
if (info && info->type == OBS_SOURCE_TYPE_TRANSITION)
|
2014-12-27 21:42:03 -08:00
|
|
|
os_atomic_inc_long(&obs->data.active_transitions);
|
2013-09-30 19:37:13 -07:00
|
|
|
return source;
|
2013-10-24 00:57:55 -07:00
|
|
|
|
|
|
|
fail:
|
|
|
|
blog(LOG_ERROR, "obs_source_create failed");
|
|
|
|
obs_source_destroy(source);
|
|
|
|
return NULL;
|
2013-09-30 19:37:13 -07:00
|
|
|
}
|
|
|
|
|
2014-08-02 01:04:45 -07:00
|
|
|
void obs_source_frame_init(struct obs_source_frame *frame,
|
|
|
|
enum video_format format, uint32_t width, uint32_t height)
|
2014-02-07 02:03:54 -08:00
|
|
|
{
|
2014-02-18 12:37:56 -08:00
|
|
|
struct video_frame vid_frame;
|
2014-02-23 21:39:33 -08:00
|
|
|
|
|
|
|
if (!frame)
|
|
|
|
return;
|
|
|
|
|
2014-02-18 12:37:56 -08:00
|
|
|
video_frame_init(&vid_frame, format, width, height);
|
2014-02-09 04:51:06 -08:00
|
|
|
frame->format = format;
|
|
|
|
frame->width = width;
|
|
|
|
frame->height = height;
|
2014-02-07 02:03:54 -08:00
|
|
|
|
2014-02-18 12:37:56 -08:00
|
|
|
for (size_t i = 0; i < MAX_AV_PLANES; i++) {
|
|
|
|
frame->data[i] = vid_frame.data[i];
|
|
|
|
frame->linesize[i] = vid_frame.linesize[i];
|
2014-02-07 02:03:54 -08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
void obs_source_destroy(struct obs_source *source)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2013-11-20 14:00:16 -08:00
|
|
|
size_t i;
|
2013-10-24 00:57:55 -07:00
|
|
|
|
2014-02-23 21:39:33 -08:00
|
|
|
if (!source)
|
|
|
|
return;
|
|
|
|
|
2014-12-27 21:42:03 -08:00
|
|
|
if (source->info.type == OBS_SOURCE_TYPE_TRANSITION)
|
|
|
|
os_atomic_dec_long(&obs->data.active_transitions);
|
|
|
|
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
obs_context_data_remove(&source->context);
|
|
|
|
|
2014-07-13 05:01:02 -07:00
|
|
|
blog(LOG_INFO, "source '%s' destroyed", source->context.name);
|
|
|
|
|
2014-03-01 04:54:55 -08:00
|
|
|
obs_source_dosignal(source, "source_destroy", "destroy");
|
2013-12-27 04:08:58 -08:00
|
|
|
|
2014-05-04 16:20:11 -07:00
|
|
|
if (source->context.data) {
|
2014-05-04 12:01:46 -07:00
|
|
|
source->info.destroy(source->context.data);
|
2014-05-04 16:20:11 -07:00
|
|
|
source->context.data = NULL;
|
|
|
|
}
|
2014-05-04 12:01:46 -07:00
|
|
|
|
2013-11-20 14:00:16 -08:00
|
|
|
if (source->filter_parent)
|
|
|
|
obs_source_filter_remove(source->filter_parent, source);
|
2013-10-24 00:57:55 -07:00
|
|
|
|
2013-11-20 14:00:16 -08:00
|
|
|
for (i = 0; i < source->filters.num; i++)
|
|
|
|
obs_source_release(source->filters.array[i]);
|
2013-10-24 00:57:55 -07:00
|
|
|
|
2015-01-04 00:18:36 -08:00
|
|
|
for (i = 0; i < source->async_cache.num; i++)
|
|
|
|
obs_source_frame_destroy(source->async_cache.array[i].frame);
|
2013-10-24 00:57:55 -07:00
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_enter_context(obs->video.graphics);
|
|
|
|
gs_texrender_destroy(source->async_convert_texrender);
|
|
|
|
gs_texture_destroy(source->async_texture);
|
|
|
|
gs_leave_context();
|
2013-09-30 19:37:13 -07:00
|
|
|
|
2014-02-14 14:13:36 -08:00
|
|
|
for (i = 0; i < MAX_AV_PLANES; i++)
|
2014-02-07 02:03:54 -08:00
|
|
|
bfree(source->audio_data.data[i]);
|
|
|
|
|
2013-11-20 14:00:16 -08:00
|
|
|
audio_line_destroy(source->audio_line);
|
|
|
|
audio_resampler_destroy(source->resampler);
|
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_texrender_destroy(source->filter_texrender);
|
2015-01-04 00:18:36 -08:00
|
|
|
da_free(source->async_cache);
|
2015-01-03 23:19:09 -08:00
|
|
|
da_free(source->async_frames);
|
2013-11-20 14:00:16 -08:00
|
|
|
da_free(source->filters);
|
|
|
|
pthread_mutex_destroy(&source->filter_mutex);
|
|
|
|
pthread_mutex_destroy(&source->audio_mutex);
|
2015-01-03 23:19:09 -08:00
|
|
|
pthread_mutex_destroy(&source->async_mutex);
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
obs_context_data_free(&source->context);
|
2014-12-13 05:10:45 -08:00
|
|
|
|
2014-07-29 09:38:55 -07:00
|
|
|
if (source->owns_info_id)
|
|
|
|
bfree((void*)source->info.id);
|
|
|
|
|
2013-11-20 14:00:16 -08:00
|
|
|
bfree(source);
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_addref(obs_source_t *source)
|
2013-11-20 14:00:16 -08:00
|
|
|
{
|
2014-02-02 17:34:06 -08:00
|
|
|
if (source)
|
2014-03-16 18:26:46 -07:00
|
|
|
os_atomic_inc_long(&source->refs);
|
2013-11-20 14:00:16 -08:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_release(obs_source_t *source)
|
2013-11-20 14:00:16 -08:00
|
|
|
{
|
2014-02-02 17:34:06 -08:00
|
|
|
if (!source)
|
|
|
|
return;
|
2013-11-20 17:36:46 -08:00
|
|
|
|
2014-03-16 18:26:46 -07:00
|
|
|
if (os_atomic_dec_long(&source->refs) == 0)
|
2014-02-02 17:34:06 -08:00
|
|
|
obs_source_destroy(source);
|
2013-11-20 17:36:46 -08:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_remove(obs_source_t *source)
|
2013-11-20 17:36:46 -08:00
|
|
|
{
|
2014-02-05 20:03:06 -08:00
|
|
|
struct obs_core_data *data = &obs->data;
|
2013-11-20 17:36:46 -08:00
|
|
|
size_t id;
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
bool exists;
|
2013-11-20 17:36:46 -08:00
|
|
|
|
|
|
|
pthread_mutex_lock(&data->sources_mutex);
|
|
|
|
|
2014-02-23 21:39:33 -08:00
|
|
|
if (!source || source->removed) {
|
|
|
|
pthread_mutex_unlock(&data->sources_mutex);
|
2014-01-31 23:49:50 -08:00
|
|
|
return;
|
2014-02-23 21:39:33 -08:00
|
|
|
}
|
2014-01-31 23:49:50 -08:00
|
|
|
|
2014-02-02 13:26:23 -08:00
|
|
|
source->removed = true;
|
2014-01-31 23:49:50 -08:00
|
|
|
|
2014-02-02 13:26:23 -08:00
|
|
|
obs_source_addref(source);
|
|
|
|
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
id = da_find(data->user_sources, &source, 0);
|
|
|
|
exists = (id != DARRAY_INVALID);
|
|
|
|
if (exists) {
|
|
|
|
da_erase(data->user_sources, id);
|
2014-02-02 13:26:23 -08:00
|
|
|
obs_source_release(source);
|
2013-11-20 17:36:46 -08:00
|
|
|
}
|
|
|
|
|
|
|
|
pthread_mutex_unlock(&data->sources_mutex);
|
2014-02-02 13:26:23 -08:00
|
|
|
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
if (exists)
|
|
|
|
obs_source_dosignal(source, "source_remove", "remove");
|
|
|
|
|
2014-02-02 13:26:23 -08:00
|
|
|
obs_source_release(source);
|
2013-11-20 14:00:16 -08:00
|
|
|
}
|
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
bool obs_source_removed(const obs_source_t *source)
|
2013-11-20 14:00:16 -08:00
|
|
|
{
|
2014-02-23 21:39:33 -08:00
|
|
|
return source ? source->removed : true;
|
2013-09-30 19:37:13 -07:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static inline obs_data_t *get_defaults(const struct obs_source_info *info)
|
2014-04-04 00:30:37 -07:00
|
|
|
{
|
2014-09-25 17:44:05 -07:00
|
|
|
obs_data_t *settings = obs_data_create();
|
2014-08-04 21:27:52 -07:00
|
|
|
if (info->get_defaults)
|
|
|
|
info->get_defaults(settings);
|
2014-04-04 00:30:37 -07:00
|
|
|
return settings;
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
obs_data_t *obs_source_settings(enum obs_source_type type, const char *id)
|
2014-03-07 05:55:21 -08:00
|
|
|
{
|
|
|
|
const struct obs_source_info *info = get_source_info(type, id);
|
2014-04-04 00:30:37 -07:00
|
|
|
return (info) ? get_defaults(info) : NULL;
|
2014-03-07 05:55:21 -08:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
obs_properties_t *obs_get_source_properties(enum obs_source_type type,
|
2014-06-25 00:13:00 -07:00
|
|
|
const char *id)
|
2014-02-01 21:46:13 -08:00
|
|
|
{
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
const struct obs_source_info *info = get_source_info(type, id);
|
2014-08-04 21:27:52 -07:00
|
|
|
if (info && info->get_properties) {
|
2014-09-25 17:44:05 -07:00
|
|
|
obs_data_t *defaults = get_defaults(info);
|
|
|
|
obs_properties_t *properties;
|
2014-04-04 00:30:37 -07:00
|
|
|
|
2014-09-29 08:36:13 -07:00
|
|
|
properties = info->get_properties(NULL);
|
2014-04-04 00:30:37 -07:00
|
|
|
obs_properties_apply_settings(properties, defaults);
|
|
|
|
obs_data_release(defaults);
|
|
|
|
return properties;
|
|
|
|
}
|
2014-02-01 21:46:13 -08:00
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
obs_properties_t *obs_source_properties(const obs_source_t *source)
|
2014-03-23 01:07:54 -07:00
|
|
|
{
|
2014-08-04 21:27:52 -07:00
|
|
|
if (source_valid(source) && source->info.get_properties) {
|
2014-09-25 17:44:05 -07:00
|
|
|
obs_properties_t *props;
|
2014-09-29 08:36:13 -07:00
|
|
|
props = source->info.get_properties(source->context.data);
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
obs_properties_apply_settings(props, source->context.settings);
|
2014-04-04 00:30:37 -07:00
|
|
|
return props;
|
|
|
|
}
|
|
|
|
|
2014-03-23 01:07:54 -07:00
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
uint32_t obs_source_get_output_flags(const obs_source_t *source)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2014-02-23 21:39:33 -08:00
|
|
|
return source ? source->info.output_flags : 0;
|
2013-09-30 19:37:13 -07:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static void obs_source_deferred_update(obs_source_t *source)
|
Implement RTMP module (still needs drop code)
- Implement the RTMP output module. This time around, we just use a
simple FLV muxer, then just write to the stream with RTMP_Write.
Easy and effective.
- Fix the FLV muxer, the muxer now outputs proper FLV packets.
- Output API:
* When using encoders, automatically interleave encoded packets
before sending it to the output.
* Pair encoders and have them automatically wait for the other to
start to ensure sync.
* Change 'obs_output_signal_start_fail' to 'obs_output_signal_stop'
because it was a bit confusing, and doing this makes a lot more
sense for outputs that need to stop suddenly (disconnections/etc).
- Encoder API:
* Remove some unnecessary encoder functions from the actual API and
make them internal. Most of the encoder functions are handled
automatically by outputs anyway, so there's no real need to expose
them and end up inadvertently confusing plugin writers.
* Have audio encoders wait for the video encoder to get a frame, then
start at the exact data point that the first video frame starts to
ensure the most accrate sync of video/audio possible.
* Add a required 'frame_size' callback for audio encoders that
returns the expected number of frames desired to encode with. This
way, the libobs encoder API can handle the circular buffering
internally automatically for the encoder modules, so encoder
writers don't have to do it themselves.
- Fix a few bugs in the serializer interface. It was passing the wrong
variable for the data in a few cases.
- If a source has video, make obs_source_update defer the actual update
callback until the tick function is called to prevent threading
issues.
2014-04-07 22:00:10 -07:00
|
|
|
{
|
2014-05-04 16:20:11 -07:00
|
|
|
if (source->context.data && source->info.update)
|
|
|
|
source->info.update(source->context.data,
|
|
|
|
source->context.settings);
|
|
|
|
|
Implement RTMP module (still needs drop code)
- Implement the RTMP output module. This time around, we just use a
simple FLV muxer, then just write to the stream with RTMP_Write.
Easy and effective.
- Fix the FLV muxer, the muxer now outputs proper FLV packets.
- Output API:
* When using encoders, automatically interleave encoded packets
before sending it to the output.
* Pair encoders and have them automatically wait for the other to
start to ensure sync.
* Change 'obs_output_signal_start_fail' to 'obs_output_signal_stop'
because it was a bit confusing, and doing this makes a lot more
sense for outputs that need to stop suddenly (disconnections/etc).
- Encoder API:
* Remove some unnecessary encoder functions from the actual API and
make them internal. Most of the encoder functions are handled
automatically by outputs anyway, so there's no real need to expose
them and end up inadvertently confusing plugin writers.
* Have audio encoders wait for the video encoder to get a frame, then
start at the exact data point that the first video frame starts to
ensure the most accrate sync of video/audio possible.
* Add a required 'frame_size' callback for audio encoders that
returns the expected number of frames desired to encode with. This
way, the libobs encoder API can handle the circular buffering
internally automatically for the encoder modules, so encoder
writers don't have to do it themselves.
- Fix a few bugs in the serializer interface. It was passing the wrong
variable for the data in a few cases.
- If a source has video, make obs_source_update defer the actual update
callback until the tick function is called to prevent threading
issues.
2014-04-07 22:00:10 -07:00
|
|
|
source->defer_update = false;
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_update(obs_source_t *source, obs_data_t *settings)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2014-02-23 21:39:33 -08:00
|
|
|
if (!source) return;
|
|
|
|
|
2014-05-30 03:24:15 -07:00
|
|
|
if (settings)
|
|
|
|
obs_data_apply(source->context.settings, settings);
|
|
|
|
|
|
|
|
if (source->info.output_flags & OBS_SOURCE_VIDEO) {
|
|
|
|
source->defer_update = true;
|
|
|
|
} else if (source->context.data && source->info.update) {
|
|
|
|
source->info.update(source->context.data,
|
|
|
|
source->context.settings);
|
Implement RTMP module (still needs drop code)
- Implement the RTMP output module. This time around, we just use a
simple FLV muxer, then just write to the stream with RTMP_Write.
Easy and effective.
- Fix the FLV muxer, the muxer now outputs proper FLV packets.
- Output API:
* When using encoders, automatically interleave encoded packets
before sending it to the output.
* Pair encoders and have them automatically wait for the other to
start to ensure sync.
* Change 'obs_output_signal_start_fail' to 'obs_output_signal_stop'
because it was a bit confusing, and doing this makes a lot more
sense for outputs that need to stop suddenly (disconnections/etc).
- Encoder API:
* Remove some unnecessary encoder functions from the actual API and
make them internal. Most of the encoder functions are handled
automatically by outputs anyway, so there's no real need to expose
them and end up inadvertently confusing plugin writers.
* Have audio encoders wait for the video encoder to get a frame, then
start at the exact data point that the first video frame starts to
ensure the most accrate sync of video/audio possible.
* Add a required 'frame_size' callback for audio encoders that
returns the expected number of frames desired to encode with. This
way, the libobs encoder API can handle the circular buffering
internally automatically for the encoder modules, so encoder
writers don't have to do it themselves.
- Fix a few bugs in the serializer interface. It was passing the wrong
variable for the data in a few cases.
- If a source has video, make obs_source_update defer the actual update
callback until the tick function is called to prevent threading
issues.
2014-04-07 22:00:10 -07:00
|
|
|
}
|
2013-09-30 19:37:13 -07:00
|
|
|
}
|
|
|
|
|
2014-09-30 06:40:46 -07:00
|
|
|
void obs_source_update_properties(obs_source_t *source)
|
|
|
|
{
|
|
|
|
calldata_t calldata;
|
|
|
|
|
|
|
|
if (!source) return;
|
|
|
|
|
|
|
|
calldata_init(&calldata);
|
|
|
|
calldata_set_ptr(&calldata, "source", source);
|
|
|
|
|
|
|
|
signal_handler_signal(obs_source_get_signal_handler(source),
|
|
|
|
"update_properties", &calldata);
|
|
|
|
|
|
|
|
calldata_free(&calldata);
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_send_mouse_click(obs_source_t *source,
|
2014-09-14 13:31:57 -07:00
|
|
|
const struct obs_mouse_event *event,
|
|
|
|
int32_t type, bool mouse_up,
|
|
|
|
uint32_t click_count)
|
|
|
|
{
|
|
|
|
if (!source)
|
|
|
|
return;
|
|
|
|
|
|
|
|
if (source->info.output_flags & OBS_SOURCE_INTERACTION) {
|
|
|
|
if (source->info.mouse_click) {
|
|
|
|
source->info.mouse_click(source->context.data,
|
|
|
|
event, type, mouse_up, click_count);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_send_mouse_move(obs_source_t *source,
|
2014-09-14 13:31:57 -07:00
|
|
|
const struct obs_mouse_event *event, bool mouse_leave)
|
|
|
|
{
|
|
|
|
if (!source)
|
|
|
|
return;
|
|
|
|
|
|
|
|
if (source->info.output_flags & OBS_SOURCE_INTERACTION) {
|
|
|
|
if (source->info.mouse_move) {
|
|
|
|
source->info.mouse_move(source->context.data,
|
|
|
|
event, mouse_leave);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_send_mouse_wheel(obs_source_t *source,
|
2014-09-14 13:31:57 -07:00
|
|
|
const struct obs_mouse_event *event, int x_delta, int y_delta)
|
|
|
|
{
|
|
|
|
if (!source)
|
|
|
|
return;
|
|
|
|
|
|
|
|
if (source->info.output_flags & OBS_SOURCE_INTERACTION) {
|
|
|
|
if (source->info.mouse_wheel) {
|
|
|
|
source->info.mouse_wheel(source->context.data,
|
|
|
|
event, x_delta, y_delta);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_send_focus(obs_source_t *source, bool focus)
|
2014-09-14 13:31:57 -07:00
|
|
|
{
|
|
|
|
if (!source)
|
|
|
|
return;
|
|
|
|
|
|
|
|
if (source->info.output_flags & OBS_SOURCE_INTERACTION) {
|
|
|
|
if (source->info.focus) {
|
|
|
|
source->info.focus(source->context.data, focus);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_send_key_click(obs_source_t *source,
|
2014-09-14 13:31:57 -07:00
|
|
|
const struct obs_key_event *event, bool key_up)
|
|
|
|
{
|
|
|
|
if (!source)
|
|
|
|
return;
|
|
|
|
|
|
|
|
if (source->info.output_flags & OBS_SOURCE_INTERACTION) {
|
|
|
|
if (source->info.key_click) {
|
|
|
|
source->info.key_click(source->context.data, event,
|
|
|
|
key_up);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static void activate_source(obs_source_t *source)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2014-05-04 16:20:11 -07:00
|
|
|
if (source->context.data && source->info.activate)
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
source->info.activate(source->context.data);
|
2014-03-01 04:54:55 -08:00
|
|
|
obs_source_dosignal(source, "source_activate", "activate");
|
2013-09-30 19:37:13 -07:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static void deactivate_source(obs_source_t *source)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2014-05-04 16:20:11 -07:00
|
|
|
if (source->context.data && source->info.deactivate)
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
source->info.deactivate(source->context.data);
|
2014-03-01 04:54:55 -08:00
|
|
|
obs_source_dosignal(source, "source_deactivate", "deactivate");
|
2014-02-23 16:46:00 -08:00
|
|
|
}
|
2014-02-20 21:04:14 -08:00
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static void show_source(obs_source_t *source)
|
2014-02-23 16:46:00 -08:00
|
|
|
{
|
2014-05-04 16:20:11 -07:00
|
|
|
if (source->context.data && source->info.show)
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
source->info.show(source->context.data);
|
2014-03-01 04:54:55 -08:00
|
|
|
obs_source_dosignal(source, "source_show", "show");
|
2014-02-23 16:46:00 -08:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static void hide_source(obs_source_t *source)
|
2014-02-23 16:46:00 -08:00
|
|
|
{
|
2014-05-04 16:20:11 -07:00
|
|
|
if (source->context.data && source->info.hide)
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
source->info.hide(source->context.data);
|
2014-03-01 04:54:55 -08:00
|
|
|
obs_source_dosignal(source, "source_hide", "hide");
|
2014-02-20 21:04:14 -08:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static void activate_tree(obs_source_t *parent, obs_source_t *child,
|
|
|
|
void *param)
|
2014-02-20 21:04:14 -08:00
|
|
|
{
|
2014-03-16 18:26:46 -07:00
|
|
|
if (os_atomic_inc_long(&child->activate_refs) == 1)
|
2014-02-20 21:04:14 -08:00
|
|
|
activate_source(child);
|
Implement volume handling
- Remove obs_source::type because it became redundant now that the
type is always stored in the obs_source::info variable.
- Apply presentation volumes of 1.0 and 0.0 to sources when they
activate/deactivate, respectively. It also applies that presentation
volume to all sub-sources, with exception of transition sources.
Transition sources must apply presentation volume manually to their
sub-sources with the new transition functions below.
- Add a "transition_volume" variable to obs_source structure, and add
three functions for handling volume for transitions:
* obs_transition_begin_frame
* obs_source_set_transition_vol
* obs_transition_end_frame
Because the to/from targets of a transition source might both contain
some of the same sources, handling the transitioning of volumes for
that specific situation becomes an issue.
So for transitions, instead of modifying the presentation volumes
directly for both sets of sources, we do this:
- First, call obs_transition_begin_frame at the beginning of each
transition frame, which will reset transition volumes for all
sub-sources to 0. Presentation volumes remain unchanged.
- Call obs_source_set_transition_vol on each sub-source, which will
then add the volume to the transition volume for each source in
that source's tree. Presentation volumes still remain unchanged.
- Then you call obs_trandition_end_frame when complete, which will
then finally set the presentation volumes to the transition
volumes.
For example, let's say that there's one source that's within both the
"transitioning from" sources and "transition to" sources. It would
add both the fade in and fade out volumes to that source, and then
when the frame is complete, it would set the presentation volume to
the sum of those two values, rather than set the presentation volume
for that same source twice which would cause weird volume jittering
and also set the wrong values.
2014-02-21 18:41:38 -08:00
|
|
|
|
|
|
|
UNUSED_PARAMETER(parent);
|
|
|
|
UNUSED_PARAMETER(param);
|
2014-02-20 21:04:14 -08:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static void deactivate_tree(obs_source_t *parent, obs_source_t *child,
|
2014-02-20 21:04:14 -08:00
|
|
|
void *param)
|
|
|
|
{
|
2014-03-16 18:26:46 -07:00
|
|
|
if (os_atomic_dec_long(&child->activate_refs) == 0)
|
2014-02-20 21:04:14 -08:00
|
|
|
deactivate_source(child);
|
Implement volume handling
- Remove obs_source::type because it became redundant now that the
type is always stored in the obs_source::info variable.
- Apply presentation volumes of 1.0 and 0.0 to sources when they
activate/deactivate, respectively. It also applies that presentation
volume to all sub-sources, with exception of transition sources.
Transition sources must apply presentation volume manually to their
sub-sources with the new transition functions below.
- Add a "transition_volume" variable to obs_source structure, and add
three functions for handling volume for transitions:
* obs_transition_begin_frame
* obs_source_set_transition_vol
* obs_transition_end_frame
Because the to/from targets of a transition source might both contain
some of the same sources, handling the transitioning of volumes for
that specific situation becomes an issue.
So for transitions, instead of modifying the presentation volumes
directly for both sets of sources, we do this:
- First, call obs_transition_begin_frame at the beginning of each
transition frame, which will reset transition volumes for all
sub-sources to 0. Presentation volumes remain unchanged.
- Call obs_source_set_transition_vol on each sub-source, which will
then add the volume to the transition volume for each source in
that source's tree. Presentation volumes still remain unchanged.
- Then you call obs_trandition_end_frame when complete, which will
then finally set the presentation volumes to the transition
volumes.
For example, let's say that there's one source that's within both the
"transitioning from" sources and "transition to" sources. It would
add both the fade in and fade out volumes to that source, and then
when the frame is complete, it would set the presentation volume to
the sum of those two values, rather than set the presentation volume
for that same source twice which would cause weird volume jittering
and also set the wrong values.
2014-02-21 18:41:38 -08:00
|
|
|
|
|
|
|
UNUSED_PARAMETER(parent);
|
|
|
|
UNUSED_PARAMETER(param);
|
2014-02-20 21:04:14 -08:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static void show_tree(obs_source_t *parent, obs_source_t *child, void *param)
|
2014-02-23 16:46:00 -08:00
|
|
|
{
|
2014-03-16 18:26:46 -07:00
|
|
|
if (os_atomic_inc_long(&child->show_refs) == 1)
|
2014-02-23 16:46:00 -08:00
|
|
|
show_source(child);
|
|
|
|
|
|
|
|
UNUSED_PARAMETER(parent);
|
|
|
|
UNUSED_PARAMETER(param);
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static void hide_tree(obs_source_t *parent, obs_source_t *child, void *param)
|
2014-02-23 16:46:00 -08:00
|
|
|
{
|
2014-03-16 18:26:46 -07:00
|
|
|
if (os_atomic_dec_long(&child->show_refs) == 0)
|
2014-02-23 16:46:00 -08:00
|
|
|
hide_source(child);
|
|
|
|
|
|
|
|
UNUSED_PARAMETER(parent);
|
|
|
|
UNUSED_PARAMETER(param);
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_activate(obs_source_t *source, enum view_type type)
|
2014-02-20 21:04:14 -08:00
|
|
|
{
|
|
|
|
if (!source) return;
|
|
|
|
|
2014-03-16 18:26:46 -07:00
|
|
|
if (os_atomic_inc_long(&source->show_refs) == 1) {
|
2014-02-23 16:46:00 -08:00
|
|
|
show_source(source);
|
|
|
|
obs_source_enum_tree(source, show_tree, NULL);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (type == MAIN_VIEW) {
|
2014-03-16 18:26:46 -07:00
|
|
|
if (os_atomic_inc_long(&source->activate_refs) == 1) {
|
2014-02-23 16:46:00 -08:00
|
|
|
activate_source(source);
|
|
|
|
obs_source_enum_tree(source, activate_tree, NULL);
|
|
|
|
}
|
2014-02-20 21:04:14 -08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_deactivate(obs_source_t *source, enum view_type type)
|
2014-02-20 21:04:14 -08:00
|
|
|
{
|
|
|
|
if (!source) return;
|
|
|
|
|
2014-03-16 18:26:46 -07:00
|
|
|
if (os_atomic_dec_long(&source->show_refs) == 0) {
|
2014-02-23 16:46:00 -08:00
|
|
|
hide_source(source);
|
|
|
|
obs_source_enum_tree(source, hide_tree, NULL);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (type == MAIN_VIEW) {
|
2014-03-16 18:26:46 -07:00
|
|
|
if (os_atomic_dec_long(&source->activate_refs) == 0) {
|
2014-02-23 16:46:00 -08:00
|
|
|
deactivate_source(source);
|
|
|
|
obs_source_enum_tree(source, deactivate_tree, NULL);
|
|
|
|
}
|
2014-02-20 21:04:14 -08:00
|
|
|
}
|
2013-09-30 19:37:13 -07:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_video_tick(obs_source_t *source, float seconds)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2014-02-23 21:39:33 -08:00
|
|
|
if (!source) return;
|
|
|
|
|
Implement RTMP module (still needs drop code)
- Implement the RTMP output module. This time around, we just use a
simple FLV muxer, then just write to the stream with RTMP_Write.
Easy and effective.
- Fix the FLV muxer, the muxer now outputs proper FLV packets.
- Output API:
* When using encoders, automatically interleave encoded packets
before sending it to the output.
* Pair encoders and have them automatically wait for the other to
start to ensure sync.
* Change 'obs_output_signal_start_fail' to 'obs_output_signal_stop'
because it was a bit confusing, and doing this makes a lot more
sense for outputs that need to stop suddenly (disconnections/etc).
- Encoder API:
* Remove some unnecessary encoder functions from the actual API and
make them internal. Most of the encoder functions are handled
automatically by outputs anyway, so there's no real need to expose
them and end up inadvertently confusing plugin writers.
* Have audio encoders wait for the video encoder to get a frame, then
start at the exact data point that the first video frame starts to
ensure the most accrate sync of video/audio possible.
* Add a required 'frame_size' callback for audio encoders that
returns the expected number of frames desired to encode with. This
way, the libobs encoder API can handle the circular buffering
internally automatically for the encoder modules, so encoder
writers don't have to do it themselves.
- Fix a few bugs in the serializer interface. It was passing the wrong
variable for the data in a few cases.
- If a source has video, make obs_source_update defer the actual update
callback until the tick function is called to prevent threading
issues.
2014-04-07 22:00:10 -07:00
|
|
|
if (source->defer_update)
|
|
|
|
obs_source_deferred_update(source);
|
|
|
|
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
/* reset the filter render texture information once every frame */
|
|
|
|
if (source->filter_texrender)
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_texrender_reset(source->filter_texrender);
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
|
2014-05-04 16:20:11 -07:00
|
|
|
if (source->context.data && source->info.video_tick)
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
source->info.video_tick(source->context.data, seconds);
|
2014-09-12 00:35:21 -07:00
|
|
|
|
|
|
|
source->async_rendered = false;
|
2013-09-30 19:37:13 -07:00
|
|
|
}
|
|
|
|
|
2014-02-09 04:51:06 -08:00
|
|
|
/* unless the value is 3+ hours worth of frames, this won't overflow */
|
2014-02-14 14:13:36 -08:00
|
|
|
static inline uint64_t conv_frames_to_time(size_t frames)
|
2014-01-10 11:45:53 -08:00
|
|
|
{
|
Simplify media i/o interfaces
Completely revamped the entire media i/o data and handlers. The
original idea was to have a system that would have connecting media
inputs and outputs, but at a certain point I realized that this was an
unnecessary complexity for what we wanted to do. (Also, it reminded me
of directshow filters, and I HATE directshow with a passion, and
wouldn't wish it upon my greatest enemy)
Now, audio/video outputs are connected to directly, with better callback
handlers, and will eventually have the ability to automatically handle
conversions such as 4:4:4 to 4:2:0 when connecting to an input that uses
them. Doing this will allow the video/audio i/o handlers to also
prevent duplicate conversion, as well as make it easier/simple to use.
My true goal for this is to make output and encoder plugins as simple to
create as possible. I want to be able to be able to create an output
plugin with almost no real hassle of having to worry about image
conversions, media inputs/outputs, etc. A plugin developer shouldn't
have to handle that sort of stuff when he/she doesn't really need to.
Plugins will be able to simply create a callback via obs_video() and/or
obs_audio(), and they will automatically receive the audio/video data in
the formats requested via a simple callback, without needing to do
almost anything else at all.
2014-01-14 00:58:47 -08:00
|
|
|
const struct audio_output_info *info;
|
2014-08-05 15:07:54 -07:00
|
|
|
info = audio_output_get_info(obs->audio.audio);
|
2014-02-09 04:51:06 -08:00
|
|
|
|
|
|
|
return (uint64_t)frames * 1000000000ULL /
|
|
|
|
(uint64_t)info->samples_per_sec;
|
2014-01-10 11:45:53 -08:00
|
|
|
}
|
|
|
|
|
2014-10-19 09:17:53 -07:00
|
|
|
/* maximum timestamp variance in nanoseconds */
|
|
|
|
#define MAX_TS_VAR 2000000000ULL
|
2014-01-10 11:45:53 -08:00
|
|
|
|
2014-10-19 09:21:39 -07:00
|
|
|
static inline void reset_audio_timing(obs_source_t *source, uint64_t timestamp,
|
|
|
|
uint64_t os_time)
|
2014-01-10 11:45:53 -08:00
|
|
|
{
|
|
|
|
source->timing_set = true;
|
2014-10-19 09:21:39 -07:00
|
|
|
source->timing_adjust = os_time - timestamp;
|
2014-01-10 11:45:53 -08:00
|
|
|
}
|
2013-10-24 00:57:55 -07:00
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static inline void handle_ts_jump(obs_source_t *source, uint64_t expected,
|
2014-10-19 09:21:39 -07:00
|
|
|
uint64_t ts, uint64_t diff, uint64_t os_time)
|
2014-01-12 01:40:51 -08:00
|
|
|
{
|
2014-02-14 15:05:52 -08:00
|
|
|
blog(LOG_DEBUG, "Timestamp for source '%s' jumped by '%"PRIu64"', "
|
2014-02-18 13:38:51 -08:00
|
|
|
"expected value %"PRIu64", input value %"PRIu64,
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
source->context.name, diff, expected, ts);
|
2014-01-12 01:40:51 -08:00
|
|
|
|
|
|
|
/* if has video, ignore audio data until reset */
|
2014-09-03 21:44:54 -07:00
|
|
|
if (!(source->info.output_flags & OBS_SOURCE_ASYNC))
|
2014-10-19 09:21:39 -07:00
|
|
|
reset_audio_timing(source, ts, os_time);
|
2014-01-12 01:40:51 -08:00
|
|
|
}
|
|
|
|
|
2014-12-13 05:10:45 -08:00
|
|
|
static void source_signal_audio_data(obs_source_t *source,
|
2014-06-03 04:43:00 -07:00
|
|
|
struct audio_data *in)
|
|
|
|
{
|
2014-12-13 05:10:45 -08:00
|
|
|
struct calldata data;
|
2014-06-03 04:43:00 -07:00
|
|
|
|
2014-12-13 05:10:45 -08:00
|
|
|
calldata_init(&data);
|
2014-06-03 04:43:00 -07:00
|
|
|
|
2014-12-13 05:10:45 -08:00
|
|
|
calldata_set_ptr(&data, "source", source);
|
|
|
|
calldata_set_ptr(&data, "data", in);
|
2014-06-03 04:43:00 -07:00
|
|
|
|
2014-12-13 05:10:45 -08:00
|
|
|
signal_handler_signal(source->context.signals, "audio_data", &data);
|
2014-06-03 04:43:00 -07:00
|
|
|
|
2014-12-13 05:10:45 -08:00
|
|
|
calldata_free(&data);
|
2014-06-03 04:43:00 -07:00
|
|
|
}
|
|
|
|
|
2014-10-19 09:21:39 -07:00
|
|
|
static inline uint64_t uint64_diff(uint64_t ts1, uint64_t ts2)
|
|
|
|
{
|
|
|
|
return (ts1 < ts2) ? (ts2 - ts1) : (ts1 - ts2);
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static void source_output_audio_line(obs_source_t *source,
|
2013-10-24 00:57:55 -07:00
|
|
|
const struct audio_data *data)
|
|
|
|
{
|
|
|
|
struct audio_data in = *data;
|
2014-01-12 01:40:51 -08:00
|
|
|
uint64_t diff;
|
2014-10-19 09:21:39 -07:00
|
|
|
uint64_t os_time = os_gettime_ns();
|
2013-10-24 00:57:55 -07:00
|
|
|
|
2014-10-19 09:21:39 -07:00
|
|
|
/* detects 'directly' set timestamps as long as they're within
|
|
|
|
* a certain threshold */
|
|
|
|
if (uint64_diff(in.timestamp, os_time) < MAX_TS_VAR) {
|
|
|
|
source->timing_adjust = 0;
|
|
|
|
source->timing_set = true;
|
2013-10-24 00:57:55 -07:00
|
|
|
|
2014-10-19 09:21:39 -07:00
|
|
|
} else if (!source->timing_set) {
|
|
|
|
reset_audio_timing(source, in.timestamp, os_time);
|
2014-01-12 01:40:51 -08:00
|
|
|
|
2014-08-28 18:24:54 -07:00
|
|
|
} else if (source->next_audio_ts_min != 0) {
|
2014-10-19 09:21:39 -07:00
|
|
|
diff = uint64_diff(source->next_audio_ts_min, in.timestamp);
|
2014-02-18 13:38:51 -08:00
|
|
|
|
2014-10-09 12:14:51 -07:00
|
|
|
/* smooth audio if within threshold */
|
2014-10-19 09:17:53 -07:00
|
|
|
if (diff > MAX_TS_VAR)
|
2014-02-18 13:38:51 -08:00
|
|
|
handle_ts_jump(source, source->next_audio_ts_min,
|
2014-10-19 09:21:39 -07:00
|
|
|
in.timestamp, diff, os_time);
|
2014-10-09 12:14:51 -07:00
|
|
|
else if (diff < TS_SMOOTHING_THRESHOLD)
|
2014-02-18 13:38:51 -08:00
|
|
|
in.timestamp = source->next_audio_ts_min;
|
2013-10-24 00:57:55 -07:00
|
|
|
}
|
|
|
|
|
2014-01-12 01:40:51 -08:00
|
|
|
source->next_audio_ts_min = in.timestamp +
|
2014-02-14 14:13:36 -08:00
|
|
|
conv_frames_to_time(in.frames);
|
2014-01-10 11:45:53 -08:00
|
|
|
|
2014-02-20 15:16:25 -08:00
|
|
|
in.timestamp += source->timing_adjust + source->sync_offset;
|
libobs: Refactor source volume transition design
This changes the way source volume handles transitioning between being
active and inactive states.
The previous way that transitioning handled volume was that it set the
presentation volume of the source and all of its sub-sources to 0.0 if
the source was inactive, and 1.0 if active. Transition sources would
then also set the presentation volume for sub-sources to whatever their
transitioning volume was. However, the problem with this is that the
design didn't take in to account if the source or its sub-sources were
active anywhere else, so because of that it would break if that ever
happened, and I didn't realize that when I was designing it.
So instead, this completely overhauls the design of handling
transitioning volume. Each frame, it'll go through all sources and
check whether they're active or inactive and set the base volume
accordingly. If transitions are currently active, it will actually walk
the active source tree and check whether the source is in a
transitioning state somewhere.
- If the source is a sub-source of a transition, and it's not active
outside of the transition, then the transition will control the
volume of the source.
- If the source is a sub-source of a transition, but it's also active
outside of the transition, it'll defer to whichever is louder.
This also adds a new callback to the obs_source_info structure for
transition sources, get_transition_volume, which is called to get the
transitioning volume of a sub-source.
2014-12-27 22:16:10 -08:00
|
|
|
in.volume = source->base_volume * source->user_volume *
|
|
|
|
source->present_volume * obs->audio.user_volume *
|
|
|
|
obs->audio.present_volume;
|
2014-02-09 04:51:06 -08:00
|
|
|
|
2013-10-24 00:57:55 -07:00
|
|
|
audio_line_output(source->audio_line, &in);
|
2014-12-13 05:10:45 -08:00
|
|
|
source_signal_audio_data(source, &in);
|
2013-10-24 00:57:55 -07:00
|
|
|
}
|
|
|
|
|
2013-10-26 14:32:06 -07:00
|
|
|
enum convert_type {
|
|
|
|
CONVERT_NONE,
|
|
|
|
CONVERT_NV12,
|
|
|
|
CONVERT_420,
|
|
|
|
CONVERT_422_U,
|
|
|
|
CONVERT_422_Y,
|
|
|
|
};
|
|
|
|
|
2013-10-31 10:28:47 -07:00
|
|
|
static inline enum convert_type get_convert_type(enum video_format format)
|
2013-10-26 14:32:06 -07:00
|
|
|
{
|
2013-10-31 10:28:47 -07:00
|
|
|
switch (format) {
|
2013-10-26 14:32:06 -07:00
|
|
|
case VIDEO_FORMAT_I420:
|
|
|
|
return CONVERT_420;
|
|
|
|
case VIDEO_FORMAT_NV12:
|
|
|
|
return CONVERT_NV12;
|
|
|
|
|
|
|
|
case VIDEO_FORMAT_YVYU:
|
|
|
|
case VIDEO_FORMAT_YUY2:
|
|
|
|
return CONVERT_422_Y;
|
|
|
|
case VIDEO_FORMAT_UYVY:
|
|
|
|
return CONVERT_422_U;
|
|
|
|
|
2014-01-19 02:16:41 -08:00
|
|
|
case VIDEO_FORMAT_NONE:
|
2013-10-26 14:32:06 -07:00
|
|
|
case VIDEO_FORMAT_RGBA:
|
|
|
|
case VIDEO_FORMAT_BGRA:
|
|
|
|
case VIDEO_FORMAT_BGRX:
|
|
|
|
return CONVERT_NONE;
|
|
|
|
}
|
|
|
|
|
|
|
|
return CONVERT_NONE;
|
|
|
|
}
|
|
|
|
|
2014-04-23 20:57:56 -07:00
|
|
|
static inline bool set_packed422_sizes(struct obs_source *source,
|
2015-01-04 00:18:36 -08:00
|
|
|
const struct obs_source_frame *frame)
|
2014-04-23 20:57:56 -07:00
|
|
|
{
|
|
|
|
source->async_convert_height = frame->height;
|
2014-05-30 02:23:36 -07:00
|
|
|
source->async_convert_width = frame->width / 2;
|
|
|
|
source->async_texture_format = GS_BGRA;
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline bool set_planar420_sizes(struct obs_source *source,
|
2015-01-04 00:18:36 -08:00
|
|
|
const struct obs_source_frame *frame)
|
2014-05-30 02:23:36 -07:00
|
|
|
{
|
|
|
|
uint32_t size = frame->width * frame->height;
|
|
|
|
size += size/2;
|
|
|
|
|
|
|
|
source->async_convert_width = frame->width;
|
|
|
|
source->async_convert_height = (size / frame->width + 1) & 0xFFFFFFFE;
|
|
|
|
source->async_texture_format = GS_R8;
|
|
|
|
source->async_plane_offset[0] = frame->width * frame->height;
|
|
|
|
source->async_plane_offset[1] = source->async_plane_offset[0] +
|
|
|
|
frame->width * frame->height / 4;
|
2014-04-23 20:57:56 -07:00
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
2014-12-18 11:37:46 -08:00
|
|
|
static inline bool set_nv12_sizes(struct obs_source *source,
|
2015-01-04 00:18:36 -08:00
|
|
|
const struct obs_source_frame *frame)
|
2014-12-18 11:37:46 -08:00
|
|
|
{
|
|
|
|
uint32_t size = frame->width * frame->height;
|
|
|
|
size += size/2;
|
|
|
|
|
|
|
|
source->async_convert_width = frame->width;
|
|
|
|
source->async_convert_height = (size / frame->width + 1) & 0xFFFFFFFE;
|
|
|
|
source->async_texture_format = GS_R8;
|
|
|
|
source->async_plane_offset[0] = frame->width * frame->height;
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
2014-04-23 20:57:56 -07:00
|
|
|
static inline bool init_gpu_conversion(struct obs_source *source,
|
2015-01-04 00:18:36 -08:00
|
|
|
const struct obs_source_frame *frame)
|
2014-04-23 20:57:56 -07:00
|
|
|
{
|
|
|
|
switch (get_convert_type(frame->format)) {
|
|
|
|
case CONVERT_422_Y:
|
|
|
|
case CONVERT_422_U:
|
|
|
|
return set_packed422_sizes(source, frame);
|
|
|
|
|
|
|
|
case CONVERT_420:
|
2014-05-30 02:23:36 -07:00
|
|
|
return set_planar420_sizes(source, frame);
|
|
|
|
|
|
|
|
case CONVERT_NV12:
|
2014-12-18 11:37:46 -08:00
|
|
|
return set_nv12_sizes(source, frame);
|
2014-04-23 20:57:56 -07:00
|
|
|
break;
|
|
|
|
|
|
|
|
case CONVERT_NONE:
|
|
|
|
assert(false && "No conversion requested");
|
|
|
|
break;
|
|
|
|
|
|
|
|
}
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2014-05-30 02:23:36 -07:00
|
|
|
static inline enum gs_color_format convert_video_format(
|
|
|
|
enum video_format format)
|
|
|
|
{
|
|
|
|
if (format == VIDEO_FORMAT_RGBA)
|
|
|
|
return GS_RGBA;
|
|
|
|
else if (format == VIDEO_FORMAT_BGRA)
|
|
|
|
return GS_BGRA;
|
|
|
|
|
|
|
|
return GS_BGRX;
|
|
|
|
}
|
|
|
|
|
2014-04-23 20:57:56 -07:00
|
|
|
static inline bool set_async_texture_size(struct obs_source *source,
|
2015-01-04 00:18:36 -08:00
|
|
|
const struct obs_source_frame *frame)
|
2014-04-23 20:57:56 -07:00
|
|
|
{
|
2015-01-04 00:18:36 -08:00
|
|
|
enum convert_type cur = get_convert_type(frame->format);
|
|
|
|
|
|
|
|
if (!source->async_reset_texture)
|
|
|
|
return true;
|
|
|
|
|
|
|
|
source->async_reset_texture = false;
|
2014-04-23 20:57:56 -07:00
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_texture_destroy(source->async_texture);
|
|
|
|
gs_texrender_destroy(source->async_convert_texrender);
|
2014-04-23 20:57:56 -07:00
|
|
|
source->async_convert_texrender = NULL;
|
|
|
|
|
|
|
|
if (cur != CONVERT_NONE && init_gpu_conversion(source, frame)) {
|
|
|
|
source->async_gpu_conversion = true;
|
|
|
|
|
|
|
|
source->async_convert_texrender =
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_texrender_create(GS_BGRX, GS_ZS_NONE);
|
2014-04-23 20:57:56 -07:00
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
source->async_texture = gs_texture_create(
|
2014-04-23 20:57:56 -07:00
|
|
|
source->async_convert_width,
|
|
|
|
source->async_convert_height,
|
2014-05-30 02:23:36 -07:00
|
|
|
source->async_texture_format,
|
|
|
|
1, NULL, GS_DYNAMIC);
|
2014-04-23 20:57:56 -07:00
|
|
|
|
|
|
|
} else {
|
2014-05-30 02:23:36 -07:00
|
|
|
enum gs_color_format format = convert_video_format(
|
|
|
|
frame->format);
|
2014-04-23 20:57:56 -07:00
|
|
|
source->async_gpu_conversion = false;
|
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
source->async_texture = gs_texture_create(
|
2014-04-23 20:57:56 -07:00
|
|
|
frame->width, frame->height,
|
2014-05-30 02:23:36 -07:00
|
|
|
format, 1, NULL, GS_DYNAMIC);
|
2014-04-23 20:57:56 -07:00
|
|
|
}
|
|
|
|
|
2015-01-04 00:18:36 -08:00
|
|
|
return !!source->async_texture;
|
2014-04-23 20:57:56 -07:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static void upload_raw_frame(gs_texture_t *tex,
|
2014-08-02 01:04:45 -07:00
|
|
|
const struct obs_source_frame *frame)
|
2014-04-23 20:57:56 -07:00
|
|
|
{
|
|
|
|
switch (get_convert_type(frame->format)) {
|
|
|
|
case CONVERT_422_U:
|
|
|
|
case CONVERT_422_Y:
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_texture_set_image(tex, frame->data[0],
|
2014-04-23 20:57:56 -07:00
|
|
|
frame->linesize[0], false);
|
|
|
|
break;
|
|
|
|
|
|
|
|
case CONVERT_420:
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_texture_set_image(tex, frame->data[0],
|
2014-05-30 02:23:36 -07:00
|
|
|
frame->width, false);
|
|
|
|
break;
|
|
|
|
|
|
|
|
case CONVERT_NV12:
|
2014-12-18 11:37:46 -08:00
|
|
|
gs_texture_set_image(tex, frame->data[0],
|
|
|
|
frame->width, false);
|
2014-04-23 20:57:56 -07:00
|
|
|
break;
|
|
|
|
|
|
|
|
case CONVERT_NONE:
|
|
|
|
assert(false && "No conversion requested");
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
static const char *select_conversion_technique(enum video_format format)
|
|
|
|
{
|
|
|
|
switch (format) {
|
|
|
|
case VIDEO_FORMAT_UYVY:
|
2014-06-02 07:38:20 -07:00
|
|
|
return "UYVY_Reverse";
|
2014-04-23 20:57:56 -07:00
|
|
|
|
|
|
|
case VIDEO_FORMAT_YUY2:
|
|
|
|
return "YUY2_Reverse";
|
|
|
|
|
|
|
|
case VIDEO_FORMAT_YVYU:
|
|
|
|
return "YVYU_Reverse";
|
|
|
|
|
|
|
|
case VIDEO_FORMAT_I420:
|
2014-05-30 02:23:36 -07:00
|
|
|
return "I420_Reverse";
|
|
|
|
|
|
|
|
case VIDEO_FORMAT_NV12:
|
2014-12-18 11:37:46 -08:00
|
|
|
return "NV12_Reverse";
|
2014-04-23 20:57:56 -07:00
|
|
|
break;
|
|
|
|
|
|
|
|
case VIDEO_FORMAT_BGRA:
|
|
|
|
case VIDEO_FORMAT_BGRX:
|
|
|
|
case VIDEO_FORMAT_RGBA:
|
|
|
|
case VIDEO_FORMAT_NONE:
|
|
|
|
assert(false && "No conversion requested");
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static inline void set_eparam(gs_effect_t *effect, const char *name, float val)
|
2014-04-23 20:57:56 -07:00
|
|
|
{
|
2014-09-25 17:44:05 -07:00
|
|
|
gs_eparam_t *param = gs_effect_get_param_by_name(effect, name);
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_effect_set_float(param, val);
|
2014-04-23 20:57:56 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
static bool update_async_texrender(struct obs_source *source,
|
2014-08-02 01:04:45 -07:00
|
|
|
const struct obs_source_frame *frame)
|
2014-04-23 20:57:56 -07:00
|
|
|
{
|
2014-09-25 17:44:05 -07:00
|
|
|
gs_texture_t *tex = source->async_texture;
|
|
|
|
gs_texrender_t *texrender = source->async_convert_texrender;
|
2014-04-23 20:57:56 -07:00
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_texrender_reset(texrender);
|
2014-04-23 20:57:56 -07:00
|
|
|
|
|
|
|
upload_raw_frame(tex, frame);
|
|
|
|
|
|
|
|
uint32_t cx = source->async_width;
|
|
|
|
uint32_t cy = source->async_height;
|
|
|
|
|
2014-05-30 02:23:36 -07:00
|
|
|
float convert_width = (float)source->async_convert_width;
|
|
|
|
float convert_height = (float)source->async_convert_height;
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
gs_effect_t *conv = obs->video.conversion_effect;
|
|
|
|
gs_technique_t *tech = gs_effect_get_technique(conv,
|
2014-04-23 20:57:56 -07:00
|
|
|
select_conversion_technique(frame->format));
|
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
if (!gs_texrender_begin(texrender, cx, cy))
|
2014-04-23 20:57:56 -07:00
|
|
|
return false;
|
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_technique_begin(tech);
|
|
|
|
gs_technique_begin_pass(tech, 0);
|
2014-04-23 20:57:56 -07:00
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_effect_set_texture(gs_effect_get_param_by_name(conv, "image"), tex);
|
2014-04-23 20:57:56 -07:00
|
|
|
set_eparam(conv, "width", (float)cx);
|
|
|
|
set_eparam(conv, "height", (float)cy);
|
|
|
|
set_eparam(conv, "width_i", 1.0f / cx);
|
|
|
|
set_eparam(conv, "height_i", 1.0f / cy);
|
2014-05-30 02:23:36 -07:00
|
|
|
set_eparam(conv, "width_d2", cx * 0.5f);
|
2014-04-23 20:57:56 -07:00
|
|
|
set_eparam(conv, "height_d2", cy * 0.5f);
|
2014-05-30 02:23:36 -07:00
|
|
|
set_eparam(conv, "width_d2_i", 1.0f / (cx * 0.5f));
|
2014-04-23 20:57:56 -07:00
|
|
|
set_eparam(conv, "height_d2_i", 1.0f / (cy * 0.5f));
|
2014-05-30 02:23:36 -07:00
|
|
|
set_eparam(conv, "input_width", convert_width);
|
|
|
|
set_eparam(conv, "input_height", convert_height);
|
|
|
|
set_eparam(conv, "input_width_i", 1.0f / convert_width);
|
|
|
|
set_eparam(conv, "input_height_i", 1.0f / convert_height);
|
|
|
|
set_eparam(conv, "input_width_i_d2", (1.0f / convert_width) * 0.5f);
|
|
|
|
set_eparam(conv, "input_height_i_d2", (1.0f / convert_height) * 0.5f);
|
|
|
|
set_eparam(conv, "u_plane_offset",
|
|
|
|
(float)source->async_plane_offset[0]);
|
|
|
|
set_eparam(conv, "v_plane_offset",
|
|
|
|
(float)source->async_plane_offset[1]);
|
2014-04-23 20:57:56 -07:00
|
|
|
|
|
|
|
gs_ortho(0.f, (float)cx, 0.f, (float)cy, -100.f, 100.f);
|
|
|
|
|
|
|
|
gs_draw_sprite(tex, 0, cx, cy);
|
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_technique_end_pass(tech);
|
|
|
|
gs_technique_end(tech);
|
2014-04-23 20:57:56 -07:00
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_texrender_end(texrender);
|
2014-04-23 20:57:56 -07:00
|
|
|
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
2014-04-13 02:22:28 -07:00
|
|
|
static bool update_async_texture(struct obs_source *source,
|
2014-08-02 01:04:45 -07:00
|
|
|
const struct obs_source_frame *frame)
|
2013-10-26 14:32:06 -07:00
|
|
|
{
|
2014-09-25 17:44:05 -07:00
|
|
|
gs_texture_t *tex = source->async_texture;
|
|
|
|
gs_texrender_t *texrender = source->async_convert_texrender;
|
2014-04-23 20:57:56 -07:00
|
|
|
enum convert_type type = get_convert_type(frame->format);
|
2014-06-27 21:29:06 -07:00
|
|
|
uint8_t *ptr;
|
2014-04-13 02:22:28 -07:00
|
|
|
uint32_t linesize;
|
|
|
|
|
2014-04-23 15:24:51 -07:00
|
|
|
source->async_flip = frame->flip;
|
|
|
|
source->async_full_range = frame->full_range;
|
2014-04-13 02:22:28 -07:00
|
|
|
memcpy(source->async_color_matrix, frame->color_matrix,
|
|
|
|
sizeof(frame->color_matrix));
|
2014-04-23 15:24:51 -07:00
|
|
|
memcpy(source->async_color_range_min, frame->color_range_min,
|
|
|
|
sizeof frame->color_range_min);
|
|
|
|
memcpy(source->async_color_range_max, frame->color_range_max,
|
|
|
|
sizeof frame->color_range_max);
|
2013-10-26 14:32:06 -07:00
|
|
|
|
2014-04-23 20:57:56 -07:00
|
|
|
if (source->async_gpu_conversion && texrender)
|
|
|
|
return update_async_texrender(source, frame);
|
|
|
|
|
2013-10-26 14:32:06 -07:00
|
|
|
if (type == CONVERT_NONE) {
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_texture_set_image(tex, frame->data[0], frame->linesize[0],
|
2014-02-07 02:03:54 -08:00
|
|
|
false);
|
2013-10-26 14:32:06 -07:00
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
if (!gs_texture_map(tex, &ptr, &linesize))
|
2013-10-26 14:32:06 -07:00
|
|
|
return false;
|
|
|
|
|
|
|
|
if (type == CONVERT_420)
|
2014-02-14 14:13:36 -08:00
|
|
|
decompress_420((const uint8_t* const*)frame->data,
|
|
|
|
frame->linesize,
|
|
|
|
0, frame->height, ptr, linesize);
|
2013-10-26 14:32:06 -07:00
|
|
|
|
|
|
|
else if (type == CONVERT_NV12)
|
2014-02-14 14:13:36 -08:00
|
|
|
decompress_nv12((const uint8_t* const*)frame->data,
|
|
|
|
frame->linesize,
|
|
|
|
0, frame->height, ptr, linesize);
|
2013-10-26 14:32:06 -07:00
|
|
|
|
|
|
|
else if (type == CONVERT_422_Y)
|
2014-02-09 04:51:06 -08:00
|
|
|
decompress_422(frame->data[0], frame->linesize[0],
|
2014-02-14 14:13:36 -08:00
|
|
|
0, frame->height, ptr, linesize, true);
|
2013-10-26 14:32:06 -07:00
|
|
|
|
|
|
|
else if (type == CONVERT_422_U)
|
2014-02-09 04:51:06 -08:00
|
|
|
decompress_422(frame->data[0], frame->linesize[0],
|
2014-02-14 14:13:36 -08:00
|
|
|
0, frame->height, ptr, linesize, false);
|
2013-10-26 14:32:06 -07:00
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_texture_unmap(tex);
|
2013-10-26 14:32:06 -07:00
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
2014-04-13 02:22:28 -07:00
|
|
|
static inline void obs_source_draw_texture(struct obs_source *source,
|
2014-09-25 17:44:05 -07:00
|
|
|
gs_effect_t *effect, float *color_matrix,
|
2014-04-23 15:24:51 -07:00
|
|
|
float const *color_range_min, float const *color_range_max)
|
2013-10-25 10:25:28 -07:00
|
|
|
{
|
2014-09-25 17:44:05 -07:00
|
|
|
gs_texture_t *tex = source->async_texture;
|
|
|
|
gs_eparam_t *param;
|
2013-10-25 10:25:28 -07:00
|
|
|
|
2014-04-23 20:57:56 -07:00
|
|
|
if (source->async_convert_texrender)
|
2014-08-07 23:42:07 -07:00
|
|
|
tex = gs_texrender_get_texture(source->async_convert_texrender);
|
2014-04-23 20:57:56 -07:00
|
|
|
|
2014-04-24 13:33:02 -07:00
|
|
|
if (color_range_min) {
|
2014-04-23 15:24:51 -07:00
|
|
|
size_t const size = sizeof(float) * 3;
|
2014-08-07 23:42:07 -07:00
|
|
|
param = gs_effect_get_param_by_name(effect, "color_range_min");
|
|
|
|
gs_effect_set_val(param, color_range_min, size);
|
2014-04-24 13:33:02 -07:00
|
|
|
}
|
2014-06-03 04:43:00 -07:00
|
|
|
|
2014-04-24 13:33:02 -07:00
|
|
|
if (color_range_max) {
|
|
|
|
size_t const size = sizeof(float) * 3;
|
2014-08-07 23:42:07 -07:00
|
|
|
param = gs_effect_get_param_by_name(effect, "color_range_max");
|
|
|
|
gs_effect_set_val(param, color_range_max, size);
|
2014-04-24 13:33:02 -07:00
|
|
|
}
|
2014-06-03 04:43:00 -07:00
|
|
|
|
2014-04-24 13:33:02 -07:00
|
|
|
if (color_matrix) {
|
2014-08-07 23:42:07 -07:00
|
|
|
param = gs_effect_get_param_by_name(effect, "color_matrix");
|
|
|
|
gs_effect_set_val(param, color_matrix, sizeof(float) * 16);
|
2013-10-25 10:25:28 -07:00
|
|
|
}
|
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
param = gs_effect_get_param_by_name(effect, "image");
|
|
|
|
gs_effect_set_texture(param, tex);
|
2013-10-25 10:25:28 -07:00
|
|
|
|
2014-04-13 02:22:28 -07:00
|
|
|
gs_draw_sprite(tex, source->async_flip ? GS_FLIP_V : 0, 0, 0);
|
|
|
|
}
|
2013-10-25 10:25:28 -07:00
|
|
|
|
2014-04-13 02:22:28 -07:00
|
|
|
static void obs_source_draw_async_texture(struct obs_source *source)
|
|
|
|
{
|
2014-09-25 17:44:05 -07:00
|
|
|
gs_effect_t *effect = gs_get_effect();
|
2014-08-07 23:42:07 -07:00
|
|
|
bool yuv = format_is_yuv(source->async_format);
|
|
|
|
bool limited_range = yuv && !source->async_full_range;
|
|
|
|
const char *type = yuv ? "DrawMatrix" : "Draw";
|
|
|
|
bool def_draw = (!effect);
|
2014-09-25 17:44:05 -07:00
|
|
|
gs_technique_t *tech = NULL;
|
2014-04-13 02:22:28 -07:00
|
|
|
|
|
|
|
if (def_draw) {
|
|
|
|
effect = obs_get_default_effect();
|
2014-08-07 23:42:07 -07:00
|
|
|
tech = gs_effect_get_technique(effect, type);
|
|
|
|
gs_technique_begin(tech);
|
|
|
|
gs_technique_begin_pass(tech, 0);
|
2014-04-13 02:22:28 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
obs_source_draw_texture(source, effect,
|
2014-04-23 15:24:51 -07:00
|
|
|
yuv ? source->async_color_matrix : NULL,
|
|
|
|
limited_range ? source->async_color_range_min : NULL,
|
|
|
|
limited_range ? source->async_color_range_max : NULL);
|
2014-04-13 02:22:28 -07:00
|
|
|
|
|
|
|
if (def_draw) {
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_technique_end_pass(tech);
|
|
|
|
gs_technique_end(tech);
|
2014-04-13 02:22:28 -07:00
|
|
|
}
|
2013-10-25 10:25:28 -07:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static void obs_source_render_async_video(obs_source_t *source)
|
2013-10-24 00:57:55 -07:00
|
|
|
{
|
2014-09-12 00:35:21 -07:00
|
|
|
if (!source->async_rendered) {
|
|
|
|
struct obs_source_frame *frame = obs_source_get_frame(source);
|
|
|
|
|
|
|
|
source->async_rendered = true;
|
|
|
|
if (frame) {
|
|
|
|
if (!set_async_texture_size(source, frame))
|
|
|
|
return;
|
|
|
|
if (!update_async_texture(source, frame))
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
obs_source_release_frame(source, frame);
|
2014-04-13 02:22:28 -07:00
|
|
|
}
|
2013-10-24 00:57:55 -07:00
|
|
|
|
2015-01-03 20:47:29 -08:00
|
|
|
if (source->async_texture && source->async_active)
|
2014-04-13 02:22:28 -07:00
|
|
|
obs_source_draw_async_texture(source);
|
2013-10-24 00:57:55 -07:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static inline void obs_source_render_filters(obs_source_t *source)
|
2013-12-22 00:30:18 -08:00
|
|
|
{
|
|
|
|
source->rendering_filter = true;
|
|
|
|
obs_source_video_render(source->filters.array[0]);
|
|
|
|
source->rendering_filter = false;
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static inline void obs_source_default_render(obs_source_t *source,
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
bool color_matrix)
|
2013-12-22 00:30:18 -08:00
|
|
|
{
|
2014-09-25 17:44:05 -07:00
|
|
|
gs_effect_t *effect = obs->video.default_effect;
|
2014-08-07 23:42:07 -07:00
|
|
|
const char *tech_name = color_matrix ? "DrawMatrix" : "Draw";
|
2014-09-25 17:44:05 -07:00
|
|
|
gs_technique_t *tech = gs_effect_get_technique(effect, tech_name);
|
2014-08-07 23:42:07 -07:00
|
|
|
size_t passes, i;
|
2013-12-22 00:30:18 -08:00
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
passes = gs_technique_begin(tech);
|
2013-12-22 00:30:18 -08:00
|
|
|
for (i = 0; i < passes; i++) {
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_technique_begin_pass(tech, i);
|
2014-05-04 16:20:11 -07:00
|
|
|
if (source->context.data)
|
|
|
|
source->info.video_render(source->context.data, effect);
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_technique_end_pass(tech);
|
2013-12-22 00:30:18 -08:00
|
|
|
}
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_technique_end(tech);
|
2013-12-22 00:30:18 -08:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static inline void obs_source_main_render(obs_source_t *source)
|
2013-12-22 00:30:18 -08:00
|
|
|
{
|
2014-04-13 02:22:28 -07:00
|
|
|
uint32_t flags = source->info.output_flags;
|
|
|
|
bool color_matrix = (flags & OBS_SOURCE_COLOR_MATRIX) != 0;
|
|
|
|
bool custom_draw = (flags & OBS_SOURCE_CUSTOM_DRAW) != 0;
|
2013-12-22 00:30:18 -08:00
|
|
|
bool default_effect = !source->filter_parent &&
|
|
|
|
source->filters.num == 0 &&
|
2014-04-13 02:22:28 -07:00
|
|
|
!custom_draw;
|
2013-12-22 00:30:18 -08:00
|
|
|
|
|
|
|
if (default_effect)
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
obs_source_default_render(source, color_matrix);
|
2014-05-04 16:20:11 -07:00
|
|
|
else if (source->context.data)
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
source->info.video_render(source->context.data,
|
2014-08-07 23:42:07 -07:00
|
|
|
custom_draw ? NULL : gs_get_effect());
|
2013-12-22 00:30:18 -08:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_video_render(obs_source_t *source)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2014-05-04 16:20:11 -07:00
|
|
|
if (!source_valid(source)) return;
|
2014-02-23 21:39:33 -08:00
|
|
|
|
2014-04-13 02:22:28 -07:00
|
|
|
if (source->filters.num && !source->rendering_filter)
|
|
|
|
obs_source_render_filters(source);
|
2013-10-24 00:57:55 -07:00
|
|
|
|
2014-04-13 02:22:28 -07:00
|
|
|
else if (source->info.video_render)
|
|
|
|
obs_source_main_render(source);
|
|
|
|
|
|
|
|
else if (source->filter_target)
|
2013-10-24 00:57:55 -07:00
|
|
|
obs_source_video_render(source->filter_target);
|
|
|
|
|
2014-04-13 02:22:28 -07:00
|
|
|
else
|
2013-10-24 00:57:55 -07:00
|
|
|
obs_source_render_async_video(source);
|
2013-09-30 19:37:13 -07:00
|
|
|
}
|
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
uint32_t obs_source_get_width(const obs_source_t *source)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2014-05-04 16:20:11 -07:00
|
|
|
if (!source_valid(source)) return 0;
|
2014-04-13 02:22:28 -07:00
|
|
|
|
2014-08-04 14:38:26 -07:00
|
|
|
if (source->info.get_width)
|
|
|
|
return source->info.get_width(source->context.data);
|
2014-04-13 02:22:28 -07:00
|
|
|
return source->async_width;
|
2013-09-30 19:37:13 -07:00
|
|
|
}
|
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
uint32_t obs_source_get_height(const obs_source_t *source)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2014-05-04 16:20:11 -07:00
|
|
|
if (!source_valid(source)) return 0;
|
2014-04-13 02:22:28 -07:00
|
|
|
|
2014-08-04 14:38:26 -07:00
|
|
|
if (source->info.get_height)
|
|
|
|
return source->info.get_height(source->context.data);
|
2014-04-13 02:22:28 -07:00
|
|
|
return source->async_height;
|
2013-09-30 19:37:13 -07:00
|
|
|
}
|
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
obs_source_t *obs_filter_get_parent(const obs_source_t *filter)
|
2013-12-22 00:30:18 -08:00
|
|
|
{
|
2014-02-23 21:39:33 -08:00
|
|
|
return filter ? filter->filter_parent : NULL;
|
2013-12-22 00:30:18 -08:00
|
|
|
}
|
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
obs_source_t *obs_filter_get_target(const obs_source_t *filter)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2014-02-23 21:39:33 -08:00
|
|
|
return filter ? filter->filter_target : NULL;
|
2013-09-30 19:37:13 -07:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_filter_add(obs_source_t *source, obs_source_t *filter)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2014-02-23 21:39:33 -08:00
|
|
|
if (!source || !filter)
|
|
|
|
return;
|
|
|
|
|
2013-10-24 00:57:55 -07:00
|
|
|
pthread_mutex_lock(&source->filter_mutex);
|
|
|
|
|
2013-10-17 17:21:42 -07:00
|
|
|
if (da_find(source->filters, &filter, 0) != DARRAY_INVALID) {
|
2013-09-30 19:37:13 -07:00
|
|
|
blog(LOG_WARNING, "Tried to add a filter that was already "
|
|
|
|
"present on the source");
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (source->filters.num) {
|
2014-09-25 17:44:05 -07:00
|
|
|
obs_source_t **back = da_end(source->filters);
|
2013-09-30 19:37:13 -07:00
|
|
|
(*back)->filter_target = filter;
|
|
|
|
}
|
|
|
|
|
|
|
|
da_push_back(source->filters, &filter);
|
2013-10-24 00:57:55 -07:00
|
|
|
|
|
|
|
pthread_mutex_unlock(&source->filter_mutex);
|
|
|
|
|
|
|
|
filter->filter_parent = source;
|
2013-09-30 19:37:13 -07:00
|
|
|
filter->filter_target = source;
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_filter_remove(obs_source_t *source, obs_source_t *filter)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2013-10-24 00:57:55 -07:00
|
|
|
size_t idx;
|
|
|
|
|
2014-02-23 21:39:33 -08:00
|
|
|
if (!source || !filter)
|
|
|
|
return;
|
|
|
|
|
2013-10-24 00:57:55 -07:00
|
|
|
pthread_mutex_lock(&source->filter_mutex);
|
|
|
|
|
|
|
|
idx = da_find(source->filters, &filter, 0);
|
2013-10-17 17:21:42 -07:00
|
|
|
if (idx == DARRAY_INVALID)
|
2013-09-30 19:37:13 -07:00
|
|
|
return;
|
|
|
|
|
|
|
|
if (idx > 0) {
|
2014-09-25 17:44:05 -07:00
|
|
|
obs_source_t *prev = source->filters.array[idx-1];
|
2013-09-30 19:37:13 -07:00
|
|
|
prev->filter_target = filter->filter_target;
|
|
|
|
}
|
|
|
|
|
|
|
|
da_erase(source->filters, idx);
|
2013-10-24 00:57:55 -07:00
|
|
|
|
|
|
|
pthread_mutex_unlock(&source->filter_mutex);
|
|
|
|
|
|
|
|
filter->filter_parent = NULL;
|
2013-09-30 19:37:13 -07:00
|
|
|
filter->filter_target = NULL;
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_filter_set_order(obs_source_t *source, obs_source_t *filter,
|
2014-08-02 01:33:53 -07:00
|
|
|
enum obs_order_movement movement)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2014-02-23 21:39:33 -08:00
|
|
|
size_t idx, i;
|
|
|
|
|
|
|
|
if (!source || !filter)
|
|
|
|
return;
|
|
|
|
|
|
|
|
idx = da_find(source->filters, &filter, 0);
|
2013-10-17 17:21:42 -07:00
|
|
|
if (idx == DARRAY_INVALID)
|
2013-09-30 19:37:13 -07:00
|
|
|
return;
|
|
|
|
|
2014-08-02 01:33:53 -07:00
|
|
|
if (movement == OBS_ORDER_MOVE_UP) {
|
2013-09-30 19:37:13 -07:00
|
|
|
if (idx == source->filters.num-1)
|
|
|
|
return;
|
|
|
|
da_move_item(source->filters, idx, idx+1);
|
|
|
|
|
2014-08-02 01:33:53 -07:00
|
|
|
} else if (movement == OBS_ORDER_MOVE_DOWN) {
|
2013-09-30 19:37:13 -07:00
|
|
|
if (idx == 0)
|
|
|
|
return;
|
|
|
|
da_move_item(source->filters, idx, idx-1);
|
|
|
|
|
2014-08-02 01:33:53 -07:00
|
|
|
} else if (movement == OBS_ORDER_MOVE_TOP) {
|
2013-09-30 19:37:13 -07:00
|
|
|
if (idx == source->filters.num-1)
|
|
|
|
return;
|
|
|
|
da_move_item(source->filters, idx, source->filters.num-1);
|
|
|
|
|
2014-08-02 01:33:53 -07:00
|
|
|
} else if (movement == OBS_ORDER_MOVE_BOTTOM) {
|
2013-09-30 19:37:13 -07:00
|
|
|
if (idx == 0)
|
|
|
|
return;
|
|
|
|
da_move_item(source->filters, idx, 0);
|
|
|
|
}
|
|
|
|
|
2013-12-20 10:56:01 -08:00
|
|
|
/* reorder filter targets, not the nicest way of dealing with things */
|
2013-09-30 19:37:13 -07:00
|
|
|
for (i = 0; i < source->filters.num; i++) {
|
2014-09-25 17:44:05 -07:00
|
|
|
obs_source_t *next_filter = (i == source->filters.num-1) ?
|
2013-09-30 19:37:13 -07:00
|
|
|
source : source->filters.array[idx+1];
|
|
|
|
source->filters.array[i]->filter_target = next_filter;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
obs_data_t *obs_source_get_settings(const obs_source_t *source)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2014-02-23 21:39:33 -08:00
|
|
|
if (!source) return NULL;
|
|
|
|
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
obs_data_addref(source->context.settings);
|
|
|
|
return source->context.settings;
|
2013-09-30 19:37:13 -07:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static inline struct obs_source_frame *filter_async_video(obs_source_t *source,
|
2014-08-02 01:04:45 -07:00
|
|
|
struct obs_source_frame *in)
|
2013-10-24 00:57:55 -07:00
|
|
|
{
|
|
|
|
size_t i;
|
|
|
|
for (i = source->filters.num; i > 0; i--) {
|
|
|
|
struct obs_source *filter = source->filters.array[i-1];
|
2014-05-04 16:20:11 -07:00
|
|
|
|
|
|
|
if (filter->context.data && filter->info.filter_video) {
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
in = filter->info.filter_video(filter->context.data,
|
|
|
|
in);
|
2013-10-24 00:57:55 -07:00
|
|
|
if (!in)
|
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return in;
|
|
|
|
}
|
|
|
|
|
2014-08-02 01:04:45 -07:00
|
|
|
static inline void copy_frame_data_line(struct obs_source_frame *dst,
|
|
|
|
const struct obs_source_frame *src, uint32_t plane, uint32_t y)
|
2014-02-07 02:03:54 -08:00
|
|
|
{
|
2014-02-09 04:51:06 -08:00
|
|
|
uint32_t pos_src = y * src->linesize[plane];
|
|
|
|
uint32_t pos_dst = y * dst->linesize[plane];
|
|
|
|
uint32_t bytes = dst->linesize[plane] < src->linesize[plane] ?
|
|
|
|
dst->linesize[plane] : src->linesize[plane];
|
2014-02-07 02:03:54 -08:00
|
|
|
|
|
|
|
memcpy(dst->data[plane] + pos_dst, src->data[plane] + pos_src, bytes);
|
|
|
|
}
|
|
|
|
|
2014-08-02 01:04:45 -07:00
|
|
|
static inline void copy_frame_data_plane(struct obs_source_frame *dst,
|
|
|
|
const struct obs_source_frame *src,
|
|
|
|
uint32_t plane, uint32_t lines)
|
2014-02-07 02:03:54 -08:00
|
|
|
{
|
2014-02-09 04:51:06 -08:00
|
|
|
if (dst->linesize[plane] != src->linesize[plane])
|
2014-02-07 02:03:54 -08:00
|
|
|
for (uint32_t y = 0; y < lines; y++)
|
|
|
|
copy_frame_data_line(dst, src, plane, y);
|
|
|
|
else
|
|
|
|
memcpy(dst->data[plane], src->data[plane],
|
2014-02-09 04:51:06 -08:00
|
|
|
dst->linesize[plane] * lines);
|
2014-02-07 02:03:54 -08:00
|
|
|
}
|
|
|
|
|
2014-08-02 01:04:45 -07:00
|
|
|
static void copy_frame_data(struct obs_source_frame *dst,
|
|
|
|
const struct obs_source_frame *src)
|
2014-02-07 02:03:54 -08:00
|
|
|
{
|
|
|
|
dst->flip = src->flip;
|
2014-04-23 15:24:51 -07:00
|
|
|
dst->full_range = src->full_range;
|
2014-02-07 02:03:54 -08:00
|
|
|
dst->timestamp = src->timestamp;
|
|
|
|
memcpy(dst->color_matrix, src->color_matrix, sizeof(float) * 16);
|
2014-04-23 15:24:51 -07:00
|
|
|
if (!dst->full_range) {
|
|
|
|
size_t const size = sizeof(float) * 3;
|
|
|
|
memcpy(dst->color_range_min, src->color_range_min, size);
|
|
|
|
memcpy(dst->color_range_max, src->color_range_max, size);
|
|
|
|
}
|
2014-02-07 02:03:54 -08:00
|
|
|
|
|
|
|
switch (dst->format) {
|
|
|
|
case VIDEO_FORMAT_I420:
|
|
|
|
copy_frame_data_plane(dst, src, 0, dst->height);
|
|
|
|
copy_frame_data_plane(dst, src, 1, dst->height/2);
|
|
|
|
copy_frame_data_plane(dst, src, 2, dst->height/2);
|
|
|
|
break;
|
|
|
|
|
|
|
|
case VIDEO_FORMAT_NV12:
|
|
|
|
copy_frame_data_plane(dst, src, 0, dst->height);
|
|
|
|
copy_frame_data_plane(dst, src, 1, dst->height/2);
|
|
|
|
break;
|
|
|
|
|
|
|
|
case VIDEO_FORMAT_YVYU:
|
|
|
|
case VIDEO_FORMAT_YUY2:
|
|
|
|
case VIDEO_FORMAT_UYVY:
|
|
|
|
case VIDEO_FORMAT_NONE:
|
|
|
|
case VIDEO_FORMAT_RGBA:
|
|
|
|
case VIDEO_FORMAT_BGRA:
|
|
|
|
case VIDEO_FORMAT_BGRX:
|
|
|
|
copy_frame_data_plane(dst, src, 0, dst->height);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-01-04 00:18:36 -08:00
|
|
|
static inline bool async_texture_changed(struct obs_source *source,
|
|
|
|
const struct obs_source_frame *frame)
|
|
|
|
{
|
|
|
|
enum convert_type prev, cur;
|
|
|
|
prev = get_convert_type(source->async_format);
|
|
|
|
cur = get_convert_type(frame->format);
|
|
|
|
|
|
|
|
return source->async_width != frame->width ||
|
|
|
|
source->async_height != frame->height ||
|
|
|
|
prev != cur;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline void free_async_cache(struct obs_source *source)
|
|
|
|
{
|
|
|
|
for (size_t i = 0; i < source->async_cache.num; i++)
|
|
|
|
obs_source_frame_destroy(source->async_cache.array[i].frame);
|
|
|
|
|
|
|
|
da_resize(source->async_cache, 0);
|
|
|
|
da_resize(source->async_frames, 0);
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline struct obs_source_frame *cache_video(struct obs_source *source,
|
2014-08-02 01:04:45 -07:00
|
|
|
const struct obs_source_frame *frame)
|
2013-10-24 00:57:55 -07:00
|
|
|
{
|
2015-01-04 00:18:36 -08:00
|
|
|
struct obs_source_frame *new_frame = NULL;
|
|
|
|
|
|
|
|
pthread_mutex_lock(&source->async_mutex);
|
|
|
|
|
|
|
|
if (async_texture_changed(source, frame)) {
|
|
|
|
source->async_width = frame->width;
|
|
|
|
source->async_height = frame->height;
|
|
|
|
source->async_format = frame->format;
|
|
|
|
source->async_reset_texture = true;
|
|
|
|
free_async_cache(source);
|
|
|
|
}
|
|
|
|
|
|
|
|
for (size_t i = 0; i < source->async_cache.num; i++) {
|
|
|
|
struct async_frame *af = &source->async_cache.array[i];
|
|
|
|
if (!af->used) {
|
|
|
|
new_frame = af->frame;
|
|
|
|
af->used = true;
|
2015-01-06 14:29:40 -08:00
|
|
|
break;
|
2015-01-04 00:18:36 -08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (!new_frame) {
|
|
|
|
struct async_frame new_af;
|
|
|
|
|
|
|
|
new_frame = obs_source_frame_create(frame->format,
|
|
|
|
frame->width, frame->height);
|
|
|
|
new_af.frame = new_frame;
|
|
|
|
new_af.used = true;
|
|
|
|
|
|
|
|
da_push_back(source->async_cache, &new_af);
|
|
|
|
}
|
|
|
|
|
|
|
|
pthread_mutex_unlock(&source->async_mutex);
|
2013-10-26 14:32:06 -07:00
|
|
|
|
2014-02-07 02:03:54 -08:00
|
|
|
copy_frame_data(new_frame, frame);
|
2013-10-26 14:32:06 -07:00
|
|
|
return new_frame;
|
2013-10-24 00:57:55 -07:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static bool ready_async_frame(obs_source_t *source, uint64_t sys_time);
|
2014-04-28 20:38:15 -07:00
|
|
|
|
|
|
|
static inline void cycle_frames(struct obs_source *source)
|
|
|
|
{
|
2015-01-03 23:19:09 -08:00
|
|
|
if (source->async_frames.num && !source->activate_refs)
|
2014-05-04 16:20:11 -07:00
|
|
|
ready_async_frame(source, os_gettime_ns());
|
2014-04-28 20:38:15 -07:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_output_video(obs_source_t *source,
|
2014-08-02 01:04:45 -07:00
|
|
|
const struct obs_source_frame *frame)
|
2013-10-24 00:57:55 -07:00
|
|
|
{
|
2015-01-03 20:47:29 -08:00
|
|
|
if (!source)
|
2014-02-23 21:39:33 -08:00
|
|
|
return;
|
|
|
|
|
2015-01-04 00:18:36 -08:00
|
|
|
struct obs_source_frame *output = !!frame ?
|
|
|
|
cache_video(source, frame) : NULL;
|
2013-10-24 00:57:55 -07:00
|
|
|
|
|
|
|
pthread_mutex_lock(&source->filter_mutex);
|
|
|
|
output = filter_async_video(source, output);
|
|
|
|
pthread_mutex_unlock(&source->filter_mutex);
|
|
|
|
|
2013-10-26 14:32:06 -07:00
|
|
|
if (output) {
|
2015-01-03 23:19:09 -08:00
|
|
|
pthread_mutex_lock(&source->async_mutex);
|
2014-04-28 20:38:15 -07:00
|
|
|
cycle_frames(source);
|
2015-01-03 23:19:09 -08:00
|
|
|
da_push_back(source->async_frames, &output);
|
|
|
|
pthread_mutex_unlock(&source->async_mutex);
|
2015-01-03 20:47:29 -08:00
|
|
|
source->async_active = true;
|
|
|
|
} else {
|
|
|
|
source->async_active = false;
|
|
|
|
source->async_width = 0;
|
|
|
|
source->async_height = 0;
|
2013-10-26 14:32:06 -07:00
|
|
|
}
|
2013-10-24 00:57:55 -07:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static inline struct obs_audio_data *filter_async_audio(obs_source_t *source,
|
2014-08-02 08:32:53 -07:00
|
|
|
struct obs_audio_data *in)
|
2013-10-24 00:57:55 -07:00
|
|
|
{
|
|
|
|
size_t i;
|
|
|
|
for (i = source->filters.num; i > 0; i--) {
|
|
|
|
struct obs_source *filter = source->filters.array[i-1];
|
2014-05-04 16:20:11 -07:00
|
|
|
|
|
|
|
if (filter->context.data && filter->info.filter_audio) {
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
in = filter->info.filter_audio(filter->context.data,
|
|
|
|
in);
|
2013-10-24 00:57:55 -07:00
|
|
|
if (!in)
|
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return in;
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static inline void reset_resampler(obs_source_t *source,
|
2014-08-02 08:42:04 -07:00
|
|
|
const struct obs_source_audio *audio)
|
2013-10-24 00:57:55 -07:00
|
|
|
{
|
Simplify media i/o interfaces
Completely revamped the entire media i/o data and handlers. The
original idea was to have a system that would have connecting media
inputs and outputs, but at a certain point I realized that this was an
unnecessary complexity for what we wanted to do. (Also, it reminded me
of directshow filters, and I HATE directshow with a passion, and
wouldn't wish it upon my greatest enemy)
Now, audio/video outputs are connected to directly, with better callback
handlers, and will eventually have the ability to automatically handle
conversions such as 4:4:4 to 4:2:0 when connecting to an input that uses
them. Doing this will allow the video/audio i/o handlers to also
prevent duplicate conversion, as well as make it easier/simple to use.
My true goal for this is to make output and encoder plugins as simple to
create as possible. I want to be able to be able to create an output
plugin with almost no real hassle of having to worry about image
conversions, media inputs/outputs, etc. A plugin developer shouldn't
have to handle that sort of stuff when he/she doesn't really need to.
Plugins will be able to simply create a callback via obs_video() and/or
obs_audio(), and they will automatically receive the audio/video data in
the formats requested via a simple callback, without needing to do
almost anything else at all.
2014-01-14 00:58:47 -08:00
|
|
|
const struct audio_output_info *obs_info;
|
2013-10-31 10:28:47 -07:00
|
|
|
struct resample_info output_info;
|
|
|
|
|
2014-08-05 15:07:54 -07:00
|
|
|
obs_info = audio_output_get_info(obs->audio.audio);
|
2013-11-20 14:00:16 -08:00
|
|
|
|
2013-10-31 10:28:47 -07:00
|
|
|
output_info.format = obs_info->format;
|
|
|
|
output_info.samples_per_sec = obs_info->samples_per_sec;
|
|
|
|
output_info.speakers = obs_info->speakers;
|
|
|
|
|
|
|
|
source->sample_info.format = audio->format;
|
|
|
|
source->sample_info.samples_per_sec = audio->samples_per_sec;
|
|
|
|
source->sample_info.speakers = audio->speakers;
|
|
|
|
|
|
|
|
if (source->sample_info.samples_per_sec == obs_info->samples_per_sec &&
|
|
|
|
source->sample_info.format == obs_info->format &&
|
|
|
|
source->sample_info.speakers == obs_info->speakers) {
|
|
|
|
source->audio_failed = false;
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
audio_resampler_destroy(source->resampler);
|
|
|
|
source->resampler = audio_resampler_create(&output_info,
|
|
|
|
&source->sample_info);
|
|
|
|
|
|
|
|
source->audio_failed = source->resampler == NULL;
|
|
|
|
if (source->resampler == NULL)
|
|
|
|
blog(LOG_ERROR, "creation of resampler failed");
|
|
|
|
}
|
|
|
|
|
2014-12-28 01:20:53 -08:00
|
|
|
static void copy_audio_data(obs_source_t *source,
|
2014-02-14 14:13:36 -08:00
|
|
|
const uint8_t *const data[], uint32_t frames, uint64_t ts)
|
2013-10-31 10:28:47 -07:00
|
|
|
{
|
2014-08-05 15:07:54 -07:00
|
|
|
size_t planes = audio_output_get_planes(obs->audio.audio);
|
|
|
|
size_t blocksize = audio_output_get_block_size(obs->audio.audio);
|
2014-02-07 02:03:54 -08:00
|
|
|
size_t size = (size_t)frames * blocksize;
|
|
|
|
bool resize = source->audio_storage_size < size;
|
2013-10-31 10:28:47 -07:00
|
|
|
|
2014-02-14 14:13:36 -08:00
|
|
|
source->audio_data.frames = frames;
|
|
|
|
source->audio_data.timestamp = ts;
|
2014-02-07 02:03:54 -08:00
|
|
|
|
|
|
|
for (size_t i = 0; i < planes; i++) {
|
|
|
|
/* ensure audio storage capacity */
|
|
|
|
if (resize) {
|
|
|
|
bfree(source->audio_data.data[i]);
|
|
|
|
source->audio_data.data[i] = bmalloc(size);
|
|
|
|
}
|
|
|
|
|
|
|
|
memcpy(source->audio_data.data[i], data[i], size);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (resize)
|
|
|
|
source->audio_storage_size = size;
|
2013-10-31 10:28:47 -07:00
|
|
|
}
|
|
|
|
|
2014-12-28 00:34:35 -08:00
|
|
|
/* TODO: SSE optimization */
|
|
|
|
static void downmix_to_mono_planar(struct obs_source *source, uint32_t frames)
|
|
|
|
{
|
2014-12-28 03:51:06 -08:00
|
|
|
size_t channels = audio_output_get_channels(obs->audio.audio);
|
2014-12-28 00:34:35 -08:00
|
|
|
const float channels_i = 1.0f / (float)channels;
|
|
|
|
float **data = (float**)source->audio_data.data;
|
|
|
|
|
2014-12-28 03:51:06 -08:00
|
|
|
for (size_t channel = 1; channel < channels; channel++) {
|
2014-12-28 00:34:35 -08:00
|
|
|
for (uint32_t frame = 0; frame < frames; frame++)
|
|
|
|
data[0][frame] += data[channel][frame];
|
|
|
|
}
|
|
|
|
|
|
|
|
for (uint32_t frame = 0; frame < frames; frame++)
|
|
|
|
data[0][frame] *= channels_i;
|
|
|
|
|
2014-12-28 03:51:06 -08:00
|
|
|
for (size_t channel = 1; channel < channels; channel++) {
|
2014-12-28 00:34:35 -08:00
|
|
|
for (uint32_t frame = 0; frame < frames; frame++)
|
|
|
|
data[channel][frame] = data[0][frame];
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
static void downmix_to_mono_interleaved(struct obs_source *source,
|
|
|
|
uint32_t frames)
|
|
|
|
{
|
2014-12-28 03:51:06 -08:00
|
|
|
size_t channels = audio_output_get_channels(obs->audio.audio);
|
2014-12-28 00:34:35 -08:00
|
|
|
const float channels_i = 1.0f / (float)channels;
|
|
|
|
float *data = (float*)source->audio_data.data[0];
|
|
|
|
|
|
|
|
for (uint32_t frame = 0; frame < frames; frame++) {
|
2014-12-28 03:51:06 -08:00
|
|
|
size_t pos = frame * channels;
|
2014-12-28 00:34:35 -08:00
|
|
|
|
2014-12-28 03:51:06 -08:00
|
|
|
for (size_t channel = 1; channel < channels; channel++)
|
2014-12-28 00:34:35 -08:00
|
|
|
data[pos] += data[pos + channel];
|
|
|
|
}
|
|
|
|
|
|
|
|
for (uint32_t frame = 0; frame < frames; frame++)
|
|
|
|
data[frame * channels] *= channels_i;
|
|
|
|
|
|
|
|
for (uint32_t frame = 0; frame < frames; frame++) {
|
2014-12-28 03:51:06 -08:00
|
|
|
size_t pos = frame * channels;
|
2014-12-28 00:34:35 -08:00
|
|
|
|
2014-12-28 03:51:06 -08:00
|
|
|
for (size_t channel = 1; channel < channels; channel++)
|
2014-12-28 00:34:35 -08:00
|
|
|
data[pos + channel] = data[pos];
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2013-10-31 10:28:47 -07:00
|
|
|
/* resamples/remixes new audio to the designated main audio output format */
|
2014-09-25 17:44:05 -07:00
|
|
|
static void process_audio(obs_source_t *source,
|
2014-08-02 08:42:04 -07:00
|
|
|
const struct obs_source_audio *audio)
|
2013-10-31 10:28:47 -07:00
|
|
|
{
|
2014-12-28 00:34:35 -08:00
|
|
|
uint32_t frames = audio->frames;
|
|
|
|
|
2013-10-31 10:28:47 -07:00
|
|
|
if (source->sample_info.samples_per_sec != audio->samples_per_sec ||
|
|
|
|
source->sample_info.format != audio->format ||
|
|
|
|
source->sample_info.speakers != audio->speakers)
|
|
|
|
reset_resampler(source, audio);
|
|
|
|
|
|
|
|
if (source->audio_failed)
|
|
|
|
return;
|
|
|
|
|
|
|
|
if (source->resampler) {
|
2014-02-14 14:13:36 -08:00
|
|
|
uint8_t *output[MAX_AV_PLANES];
|
2013-10-31 10:28:47 -07:00
|
|
|
uint64_t offset;
|
|
|
|
|
2014-02-07 02:03:54 -08:00
|
|
|
memset(output, 0, sizeof(output));
|
|
|
|
|
|
|
|
audio_resampler_resample(source->resampler,
|
|
|
|
output, &frames, &offset,
|
|
|
|
audio->data, audio->frames);
|
2013-10-31 10:28:47 -07:00
|
|
|
|
2014-02-14 14:13:36 -08:00
|
|
|
copy_audio_data(source, (const uint8_t *const *)output, frames,
|
2013-10-31 10:28:47 -07:00
|
|
|
audio->timestamp - offset);
|
|
|
|
} else {
|
|
|
|
copy_audio_data(source, audio->data, audio->frames,
|
|
|
|
audio->timestamp);
|
|
|
|
}
|
2014-12-28 00:34:35 -08:00
|
|
|
|
|
|
|
if ((source->flags & OBS_SOURCE_FLAG_FORCE_MONO) != 0) {
|
|
|
|
if (is_audio_planar(source->sample_info.format))
|
|
|
|
downmix_to_mono_planar(source, frames);
|
|
|
|
else
|
|
|
|
downmix_to_mono_interleaved(source, frames);
|
|
|
|
}
|
2013-10-24 00:57:55 -07:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_output_audio(obs_source_t *source,
|
2014-08-02 08:42:04 -07:00
|
|
|
const struct obs_source_audio *audio)
|
2013-10-24 00:57:55 -07:00
|
|
|
{
|
2014-02-23 21:39:33 -08:00
|
|
|
uint32_t flags;
|
2014-08-02 08:32:53 -07:00
|
|
|
struct obs_audio_data *output;
|
2013-10-24 00:57:55 -07:00
|
|
|
|
2014-02-23 21:39:33 -08:00
|
|
|
if (!source || !audio)
|
|
|
|
return;
|
|
|
|
|
|
|
|
flags = source->info.output_flags;
|
2013-10-31 10:28:47 -07:00
|
|
|
process_audio(source, audio);
|
2013-10-24 00:57:55 -07:00
|
|
|
|
|
|
|
pthread_mutex_lock(&source->filter_mutex);
|
2013-10-31 10:28:47 -07:00
|
|
|
output = filter_async_audio(source, &source->audio_data);
|
2013-10-24 00:57:55 -07:00
|
|
|
|
|
|
|
if (output) {
|
2014-04-13 02:22:28 -07:00
|
|
|
bool async = (flags & OBS_SOURCE_ASYNC) != 0;
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
|
2013-10-24 00:57:55 -07:00
|
|
|
pthread_mutex_lock(&source->audio_mutex);
|
|
|
|
|
2013-12-20 10:56:01 -08:00
|
|
|
/* wait for video to start before outputting any audio so we
|
|
|
|
* have a base for sync */
|
2014-02-22 19:14:19 -08:00
|
|
|
if (source->timing_set || !async) {
|
2013-10-31 10:28:47 -07:00
|
|
|
struct audio_data data;
|
2014-02-07 02:03:54 -08:00
|
|
|
|
2014-02-14 14:13:36 -08:00
|
|
|
for (int i = 0; i < MAX_AV_PLANES; i++)
|
2014-02-07 02:03:54 -08:00
|
|
|
data.data[i] = output->data[i];
|
|
|
|
|
2013-10-31 10:28:47 -07:00
|
|
|
data.frames = output->frames;
|
|
|
|
data.timestamp = output->timestamp;
|
|
|
|
source_output_audio_line(source, &data);
|
2013-10-24 00:57:55 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
pthread_mutex_unlock(&source->audio_mutex);
|
|
|
|
}
|
|
|
|
|
|
|
|
pthread_mutex_unlock(&source->filter_mutex);
|
|
|
|
}
|
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
static inline bool frame_out_of_bounds(const obs_source_t *source, uint64_t ts)
|
2014-01-12 01:40:51 -08:00
|
|
|
{
|
2014-09-12 00:41:56 -07:00
|
|
|
if (ts < source->last_frame_ts)
|
2014-10-19 09:17:53 -07:00
|
|
|
return ((source->last_frame_ts - ts) > MAX_TS_VAR);
|
2014-09-12 00:41:56 -07:00
|
|
|
else
|
2014-10-19 09:17:53 -07:00
|
|
|
return ((ts - source->last_frame_ts) > MAX_TS_VAR);
|
2014-01-12 01:40:51 -08:00
|
|
|
}
|
|
|
|
|
2015-01-04 00:18:36 -08:00
|
|
|
static void remove_async_frame(obs_source_t *source,
|
|
|
|
struct obs_source_frame *frame)
|
|
|
|
{
|
|
|
|
for (size_t i = 0; i < source->async_cache.num; i++) {
|
|
|
|
struct async_frame *f = &source->async_cache.array[i];
|
|
|
|
|
|
|
|
if (f->frame == frame) {
|
|
|
|
f->used = false;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-09-12 00:41:56 -07:00
|
|
|
/* #define DEBUG_ASYNC_FRAMES 1 */
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static bool ready_async_frame(obs_source_t *source, uint64_t sys_time)
|
2014-01-12 01:40:51 -08:00
|
|
|
{
|
2015-01-03 23:19:09 -08:00
|
|
|
struct obs_source_frame *next_frame = source->async_frames.array[0];
|
2014-08-02 01:04:45 -07:00
|
|
|
struct obs_source_frame *frame = NULL;
|
2014-01-12 01:40:51 -08:00
|
|
|
uint64_t sys_offset = sys_time - source->last_sys_timestamp;
|
|
|
|
uint64_t frame_time = next_frame->timestamp;
|
|
|
|
uint64_t frame_offset = 0;
|
|
|
|
|
2014-12-27 21:29:48 -08:00
|
|
|
if ((source->flags & OBS_SOURCE_FLAG_UNBUFFERED) != 0) {
|
2015-01-03 23:19:09 -08:00
|
|
|
while (source->async_frames.num > 1) {
|
|
|
|
da_erase(source->async_frames, 0);
|
2015-01-04 00:18:36 -08:00
|
|
|
remove_async_frame(source, next_frame);
|
2015-01-03 23:19:09 -08:00
|
|
|
next_frame = source->async_frames.array[0];
|
2014-10-23 09:56:50 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
2014-09-12 00:41:56 -07:00
|
|
|
#if DEBUG_ASYNC_FRAMES
|
|
|
|
blog(LOG_DEBUG, "source->last_frame_ts: %llu, frame_time: %llu, "
|
|
|
|
"sys_offset: %llu, frame_offset: %llu, "
|
|
|
|
"number of frames: %lu",
|
|
|
|
source->last_frame_ts, frame_time, sys_offset,
|
|
|
|
frame_time - source->last_frame_ts,
|
2015-01-03 23:19:09 -08:00
|
|
|
(unsigned long)source->async_frames.num);
|
2014-09-12 00:41:56 -07:00
|
|
|
#endif
|
|
|
|
|
2014-01-12 01:40:51 -08:00
|
|
|
/* account for timestamp invalidation */
|
|
|
|
if (frame_out_of_bounds(source, frame_time)) {
|
2014-09-12 00:41:56 -07:00
|
|
|
#if DEBUG_ASYNC_FRAMES
|
|
|
|
blog(LOG_DEBUG, "timing jump");
|
|
|
|
#endif
|
2014-01-12 01:40:51 -08:00
|
|
|
source->last_frame_ts = next_frame->timestamp;
|
2014-09-12 00:41:56 -07:00
|
|
|
return true;
|
2014-01-12 01:40:51 -08:00
|
|
|
} else {
|
|
|
|
frame_offset = frame_time - source->last_frame_ts;
|
2014-09-12 00:41:56 -07:00
|
|
|
source->last_frame_ts += sys_offset;
|
2014-01-12 01:40:51 -08:00
|
|
|
}
|
|
|
|
|
2014-09-12 00:41:56 -07:00
|
|
|
while (source->last_frame_ts > next_frame->timestamp) {
|
|
|
|
|
|
|
|
/* this tries to reduce the needless frame duplication, also
|
|
|
|
* helps smooth out async rendering to frame boundaries. In
|
|
|
|
* other words, tries to keep the framerate as smooth as
|
|
|
|
* possible */
|
|
|
|
if ((source->last_frame_ts - next_frame->timestamp) < 1000000)
|
|
|
|
break;
|
|
|
|
|
|
|
|
if (frame)
|
2015-01-03 23:19:09 -08:00
|
|
|
da_erase(source->async_frames, 0);
|
2014-09-12 00:41:56 -07:00
|
|
|
|
|
|
|
#if DEBUG_ASYNC_FRAMES
|
|
|
|
blog(LOG_DEBUG, "new frame, "
|
|
|
|
"source->last_frame_ts: %llu, "
|
|
|
|
"next_frame->timestamp: %llu",
|
|
|
|
source->last_frame_ts,
|
|
|
|
next_frame->timestamp);
|
|
|
|
#endif
|
|
|
|
|
2015-01-04 00:18:36 -08:00
|
|
|
remove_async_frame(source, frame);
|
2014-01-12 01:40:51 -08:00
|
|
|
|
2015-01-03 23:19:09 -08:00
|
|
|
if (source->async_frames.num == 1)
|
2014-04-28 20:38:15 -07:00
|
|
|
return true;
|
|
|
|
|
2014-01-12 01:40:51 -08:00
|
|
|
frame = next_frame;
|
2015-01-03 23:19:09 -08:00
|
|
|
next_frame = source->async_frames.array[1];
|
2014-01-12 01:40:51 -08:00
|
|
|
|
|
|
|
/* more timestamp checking and compensating */
|
2014-10-19 09:17:53 -07:00
|
|
|
if ((next_frame->timestamp - frame_time) > MAX_TS_VAR) {
|
2014-09-12 00:41:56 -07:00
|
|
|
#if DEBUG_ASYNC_FRAMES
|
|
|
|
blog(LOG_DEBUG, "timing jump");
|
|
|
|
#endif
|
2014-01-12 01:40:51 -08:00
|
|
|
source->last_frame_ts =
|
|
|
|
next_frame->timestamp - frame_offset;
|
|
|
|
}
|
|
|
|
|
|
|
|
frame_time = next_frame->timestamp;
|
|
|
|
frame_offset = frame_time - source->last_frame_ts;
|
|
|
|
}
|
|
|
|
|
2014-09-12 00:41:56 -07:00
|
|
|
#if DEBUG_ASYNC_FRAMES
|
|
|
|
if (!frame)
|
|
|
|
blog(LOG_DEBUG, "no frame!");
|
|
|
|
#endif
|
2014-05-04 16:20:11 -07:00
|
|
|
|
2014-04-28 20:38:15 -07:00
|
|
|
return frame != NULL;
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static inline struct obs_source_frame *get_closest_frame(obs_source_t *source,
|
2014-04-28 20:38:15 -07:00
|
|
|
uint64_t sys_time)
|
|
|
|
{
|
2014-05-04 16:20:11 -07:00
|
|
|
if (ready_async_frame(source, sys_time)) {
|
2015-01-03 23:19:09 -08:00
|
|
|
struct obs_source_frame *frame = source->async_frames.array[0];
|
|
|
|
da_erase(source->async_frames, 0);
|
2014-04-28 20:38:15 -07:00
|
|
|
return frame;
|
|
|
|
}
|
|
|
|
|
|
|
|
return NULL;
|
2014-01-12 01:40:51 -08:00
|
|
|
}
|
|
|
|
|
2013-12-07 10:23:49 -08:00
|
|
|
/*
|
2013-10-26 14:32:06 -07:00
|
|
|
* Ensures that cached frames are displayed on time. If multiple frames
|
|
|
|
* were cached between renders, then releases the unnecessary frames and uses
|
2014-01-12 01:40:51 -08:00
|
|
|
* the frame with the closest timing to ensure sync. Also ensures that timing
|
|
|
|
* with audio is synchronized.
|
2013-10-26 14:32:06 -07:00
|
|
|
*/
|
2014-09-25 17:44:05 -07:00
|
|
|
struct obs_source_frame *obs_source_get_frame(obs_source_t *source)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2014-08-02 01:04:45 -07:00
|
|
|
struct obs_source_frame *frame = NULL;
|
2014-01-12 01:40:51 -08:00
|
|
|
uint64_t sys_time;
|
2013-10-26 14:32:06 -07:00
|
|
|
|
2014-02-23 21:39:33 -08:00
|
|
|
if (!source)
|
|
|
|
return NULL;
|
|
|
|
|
2015-01-03 23:19:09 -08:00
|
|
|
pthread_mutex_lock(&source->async_mutex);
|
2013-10-26 14:32:06 -07:00
|
|
|
|
2014-09-12 00:41:56 -07:00
|
|
|
sys_time = os_gettime_ns();
|
|
|
|
|
2015-01-03 23:19:09 -08:00
|
|
|
if (!source->async_frames.num)
|
2013-10-26 14:32:06 -07:00
|
|
|
goto unlock;
|
|
|
|
|
2014-01-12 01:40:51 -08:00
|
|
|
if (!source->last_frame_ts) {
|
2015-01-03 23:19:09 -08:00
|
|
|
frame = source->async_frames.array[0];
|
|
|
|
da_erase(source->async_frames, 0);
|
2013-10-26 14:32:06 -07:00
|
|
|
|
2014-01-12 01:40:51 -08:00
|
|
|
source->last_frame_ts = frame->timestamp;
|
2013-10-26 14:32:06 -07:00
|
|
|
} else {
|
2014-04-28 20:38:15 -07:00
|
|
|
frame = get_closest_frame(source, sys_time);
|
2014-01-12 02:24:01 -08:00
|
|
|
}
|
|
|
|
|
|
|
|
/* reset timing to current system time */
|
|
|
|
if (frame) {
|
|
|
|
source->timing_adjust = sys_time - frame->timestamp;
|
|
|
|
source->timing_set = true;
|
2013-10-26 14:32:06 -07:00
|
|
|
}
|
|
|
|
|
2014-09-12 00:41:56 -07:00
|
|
|
unlock:
|
2013-10-26 14:32:06 -07:00
|
|
|
source->last_sys_timestamp = sys_time;
|
|
|
|
|
2015-01-03 23:19:09 -08:00
|
|
|
pthread_mutex_unlock(&source->async_mutex);
|
2013-11-22 15:18:31 -08:00
|
|
|
|
2014-01-12 01:40:51 -08:00
|
|
|
if (frame)
|
2013-11-22 15:18:31 -08:00
|
|
|
obs_source_addref(source);
|
|
|
|
|
2013-10-26 14:32:06 -07:00
|
|
|
return frame;
|
2013-09-30 19:37:13 -07:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_release_frame(obs_source_t *source,
|
2014-08-02 01:04:45 -07:00
|
|
|
struct obs_source_frame *frame)
|
2013-09-30 19:37:13 -07:00
|
|
|
{
|
2014-02-23 21:39:33 -08:00
|
|
|
if (source && frame) {
|
2015-01-04 00:18:36 -08:00
|
|
|
remove_async_frame(source, frame);
|
2013-11-22 15:18:31 -08:00
|
|
|
obs_source_release(source);
|
|
|
|
}
|
2013-09-30 19:37:13 -07:00
|
|
|
}
|
2013-12-20 18:35:12 -08:00
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
const char *obs_source_get_name(const obs_source_t *source)
|
2013-12-20 18:35:12 -08:00
|
|
|
{
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
return source ? source->context.name : NULL;
|
2013-12-20 18:35:12 -08:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_set_name(obs_source_t *source, const char *name)
|
2013-12-20 18:35:12 -08:00
|
|
|
{
|
2014-02-23 21:39:33 -08:00
|
|
|
if (!source) return;
|
2014-06-30 00:05:35 -07:00
|
|
|
|
|
|
|
if (!name || !*name || strcmp(name, source->context.name) != 0) {
|
|
|
|
struct calldata data;
|
|
|
|
char *prev_name = bstrdup(source->context.name);
|
|
|
|
obs_context_data_setname(&source->context, name);
|
|
|
|
|
|
|
|
calldata_init(&data);
|
2014-08-05 17:49:28 -07:00
|
|
|
calldata_set_ptr(&data, "source", source);
|
|
|
|
calldata_set_string(&data, "new_name", source->context.name);
|
|
|
|
calldata_set_string(&data, "prev_name", prev_name);
|
2014-06-30 00:05:35 -07:00
|
|
|
signal_handler_signal(obs->signals, "source_rename", &data);
|
|
|
|
signal_handler_signal(source->context.signals, "rename", &data);
|
|
|
|
calldata_free(&data);
|
|
|
|
bfree(prev_name);
|
|
|
|
}
|
2013-12-20 18:35:12 -08:00
|
|
|
}
|
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
enum obs_source_type obs_source_get_type(const obs_source_t *source)
|
2013-12-20 18:35:12 -08:00
|
|
|
{
|
2014-08-02 12:42:47 -07:00
|
|
|
return source ? source->info.type : OBS_SOURCE_TYPE_INPUT;
|
|
|
|
}
|
2014-02-23 21:39:33 -08:00
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
const char *obs_source_get_id(const obs_source_t *source)
|
2014-08-02 12:42:47 -07:00
|
|
|
{
|
|
|
|
return source ? source->info.id : NULL;
|
2013-12-20 18:35:12 -08:00
|
|
|
}
|
2013-12-22 00:30:18 -08:00
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static inline void render_filter_bypass(obs_source_t *target,
|
|
|
|
gs_effect_t *effect, bool use_matrix)
|
2013-12-22 00:30:18 -08:00
|
|
|
{
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
const char *tech_name = use_matrix ? "DrawMatrix" : "Draw";
|
2014-09-25 17:44:05 -07:00
|
|
|
gs_technique_t *tech = gs_effect_get_technique(effect, tech_name);
|
2013-12-22 00:30:18 -08:00
|
|
|
size_t passes, i;
|
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
passes = gs_technique_begin(tech);
|
2013-12-22 00:30:18 -08:00
|
|
|
for (i = 0; i < passes; i++) {
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_technique_begin_pass(tech, i);
|
2013-12-22 00:30:18 -08:00
|
|
|
obs_source_video_render(target);
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_technique_end_pass(tech);
|
2013-12-22 00:30:18 -08:00
|
|
|
}
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_technique_end(tech);
|
2013-12-22 00:30:18 -08:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static inline void render_filter_tex(gs_texture_t *tex, gs_effect_t *effect,
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
uint32_t width, uint32_t height, bool use_matrix)
|
2013-12-22 00:30:18 -08:00
|
|
|
{
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
const char *tech_name = use_matrix ? "DrawMatrix" : "Draw";
|
2014-09-25 17:44:05 -07:00
|
|
|
gs_technique_t *tech = gs_effect_get_technique(effect, tech_name);
|
|
|
|
gs_eparam_t *image = gs_effect_get_param_by_name(effect, "image");
|
2013-12-22 00:30:18 -08:00
|
|
|
size_t passes, i;
|
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_effect_set_texture(image, tex);
|
2013-12-22 00:30:18 -08:00
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
passes = gs_technique_begin(tech);
|
2013-12-22 00:30:18 -08:00
|
|
|
for (i = 0; i < passes; i++) {
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_technique_begin_pass(tech, i);
|
2013-12-22 00:30:18 -08:00
|
|
|
gs_draw_sprite(tex, width, height, 0);
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_technique_end_pass(tech);
|
2013-12-22 00:30:18 -08:00
|
|
|
}
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_technique_end(tech);
|
2013-12-22 00:30:18 -08:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_process_filter(obs_source_t *filter, gs_effect_t *effect,
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
uint32_t width, uint32_t height, enum gs_color_format format,
|
2014-08-02 08:21:00 -07:00
|
|
|
enum obs_allow_direct_render allow_direct)
|
2013-12-22 00:30:18 -08:00
|
|
|
{
|
2014-09-25 17:44:05 -07:00
|
|
|
obs_source_t *target, *parent;
|
2014-02-23 21:39:33 -08:00
|
|
|
uint32_t target_flags, parent_flags;
|
|
|
|
int cx, cy;
|
|
|
|
bool use_matrix, expects_def, can_directly;
|
|
|
|
|
|
|
|
if (!filter) return;
|
|
|
|
|
2014-08-04 08:41:15 -07:00
|
|
|
target = obs_filter_get_target(filter);
|
|
|
|
parent = obs_filter_get_parent(filter);
|
2014-02-23 21:39:33 -08:00
|
|
|
target_flags = target->info.output_flags;
|
|
|
|
parent_flags = parent->info.output_flags;
|
2014-08-04 08:41:15 -07:00
|
|
|
cx = obs_source_get_width(target);
|
|
|
|
cy = obs_source_get_height(target);
|
2014-02-23 21:39:33 -08:00
|
|
|
use_matrix = !!(target_flags & OBS_SOURCE_COLOR_MATRIX);
|
|
|
|
expects_def = !(parent_flags & OBS_SOURCE_CUSTOM_DRAW);
|
2014-08-02 08:21:00 -07:00
|
|
|
can_directly = allow_direct == OBS_ALLOW_DIRECT_RENDERING;
|
2013-12-22 00:30:18 -08:00
|
|
|
|
|
|
|
/* if the parent does not use any custom effects, and this is the last
|
|
|
|
* filter in the chain for the parent, then render the parent directly
|
|
|
|
* using the filter effect instead of rendering to texture to reduce
|
|
|
|
* the total number of passes */
|
2013-12-22 01:03:40 -08:00
|
|
|
if (can_directly && expects_def && target == parent) {
|
2014-02-14 14:13:36 -08:00
|
|
|
render_filter_bypass(target, effect, use_matrix);
|
2013-12-22 00:30:18 -08:00
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
if (!filter->filter_texrender)
|
2014-08-07 23:42:07 -07:00
|
|
|
filter->filter_texrender = gs_texrender_create(format,
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
GS_ZS_NONE);
|
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
if (gs_texrender_begin(filter->filter_texrender, cx, cy)) {
|
2013-12-22 00:30:18 -08:00
|
|
|
gs_ortho(0.0f, (float)cx, 0.0f, (float)cy, -100.0f, 100.0f);
|
2013-12-22 01:03:40 -08:00
|
|
|
if (expects_def && parent == target)
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
obs_source_default_render(parent, use_matrix);
|
2013-12-22 01:03:40 -08:00
|
|
|
else
|
|
|
|
obs_source_video_render(target);
|
2014-08-07 23:42:07 -07:00
|
|
|
gs_texrender_end(filter->filter_texrender);
|
2013-12-22 00:30:18 -08:00
|
|
|
}
|
|
|
|
|
|
|
|
/* --------------------------- */
|
|
|
|
|
2014-08-07 23:42:07 -07:00
|
|
|
render_filter_tex(gs_texrender_get_texture(filter->filter_texrender),
|
Revamp API and start using doxygen
The API used to be designed in such a way to where it would expect
exports for each individual source/output/encoder/etc. You would export
functions for each and it would automatically load those functions based
on a specific naming scheme from the module.
The idea behind this was that I wanted to limit the usage of structures
in the API so only functions could be used. It was an interesting idea
in theory, but this idea turned out to be flawed in a number of ways:
1.) Requiring exports to create sources/outputs/encoders/etc meant that
you could not create them by any other means, which meant that
things like faruton's .net plugin would become difficult.
2.) Export function declarations could not be checked, therefore if you
created a function with the wrong parameters and parameter types,
the compiler wouldn't know how to check for that.
3.) Required overly complex load functions in libobs just to handle it.
It makes much more sense to just have a load function that you call
manually. Complexity is the bane of all good programs.
4.) It required that you have functions of specific names, which looked
and felt somewhat unsightly.
So, to fix these issues, I replaced it with a more commonly used API
scheme, seen commonly in places like kernels and typical C libraries
with abstraction. You simply create a structure that contains the
callback definitions, and you pass it to a function to register that
definition (such as obs_register_source), which you call in the
obs_module_load of the module.
It will also automatically check the structure size and ensure that it
only loads the required values if the structure happened to add new
values in an API change.
The "main" source file for each module must include obs-module.h, and
must use OBS_DECLARE_MODULE() within that source file.
Also, started writing some doxygen documentation in to the main library
headers. Will add more detailed documentation as I go.
2014-02-12 07:04:50 -08:00
|
|
|
effect, width, height, use_matrix);
|
2013-12-22 00:30:18 -08:00
|
|
|
}
|
2013-12-26 22:10:15 -08:00
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
signal_handler_t *obs_source_get_signal_handler(const obs_source_t *source)
|
2013-12-26 22:10:15 -08:00
|
|
|
{
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
return source ? source->context.signals : NULL;
|
2013-12-26 22:10:15 -08:00
|
|
|
}
|
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
proc_handler_t *obs_source_get_proc_handler(const obs_source_t *source)
|
2013-12-26 22:10:15 -08:00
|
|
|
{
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
return source ? source->context.procs : NULL;
|
2013-12-26 22:10:15 -08:00
|
|
|
}
|
2014-01-07 10:03:15 -08:00
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_set_volume(obs_source_t *source, float volume)
|
2014-01-07 10:03:15 -08:00
|
|
|
{
|
2014-02-21 16:51:16 -08:00
|
|
|
if (source) {
|
|
|
|
struct calldata data = {0};
|
2014-08-05 17:49:28 -07:00
|
|
|
calldata_set_ptr(&data, "source", source);
|
|
|
|
calldata_set_float(&data, "volume", volume);
|
2014-02-21 16:51:16 -08:00
|
|
|
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
signal_handler_signal(source->context.signals, "volume", &data);
|
2014-03-01 04:54:55 -08:00
|
|
|
signal_handler_signal(obs->signals, "source_volume", &data);
|
2014-02-21 16:51:16 -08:00
|
|
|
|
2014-03-01 04:54:55 -08:00
|
|
|
volume = (float)calldata_float(&data, "volume");
|
2014-02-21 16:51:16 -08:00
|
|
|
calldata_free(&data);
|
|
|
|
|
2014-02-20 15:16:25 -08:00
|
|
|
source->user_volume = volume;
|
2014-02-21 16:51:16 -08:00
|
|
|
}
|
2014-02-20 14:53:16 -08:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static void set_tree_preset_vol(obs_source_t *parent, obs_source_t *child,
|
Implement volume handling
- Remove obs_source::type because it became redundant now that the
type is always stored in the obs_source::info variable.
- Apply presentation volumes of 1.0 and 0.0 to sources when they
activate/deactivate, respectively. It also applies that presentation
volume to all sub-sources, with exception of transition sources.
Transition sources must apply presentation volume manually to their
sub-sources with the new transition functions below.
- Add a "transition_volume" variable to obs_source structure, and add
three functions for handling volume for transitions:
* obs_transition_begin_frame
* obs_source_set_transition_vol
* obs_transition_end_frame
Because the to/from targets of a transition source might both contain
some of the same sources, handling the transitioning of volumes for
that specific situation becomes an issue.
So for transitions, instead of modifying the presentation volumes
directly for both sets of sources, we do this:
- First, call obs_transition_begin_frame at the beginning of each
transition frame, which will reset transition volumes for all
sub-sources to 0. Presentation volumes remain unchanged.
- Call obs_source_set_transition_vol on each sub-source, which will
then add the volume to the transition volume for each source in
that source's tree. Presentation volumes still remain unchanged.
- Then you call obs_trandition_end_frame when complete, which will
then finally set the presentation volumes to the transition
volumes.
For example, let's say that there's one source that's within both the
"transitioning from" sources and "transition to" sources. It would
add both the fade in and fade out volumes to that source, and then
when the frame is complete, it would set the presentation volume to
the sum of those two values, rather than set the presentation volume
for that same source twice which would cause weird volume jittering
and also set the wrong values.
2014-02-21 18:41:38 -08:00
|
|
|
void *param)
|
|
|
|
{
|
|
|
|
float *vol = param;
|
|
|
|
child->present_volume = *vol;
|
|
|
|
|
|
|
|
UNUSED_PARAMETER(parent);
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_set_present_volume(obs_source_t *source, float volume)
|
2014-02-20 14:53:16 -08:00
|
|
|
{
|
2014-12-27 21:11:56 -08:00
|
|
|
if (source)
|
2014-02-20 15:16:25 -08:00
|
|
|
source->present_volume = volume;
|
2014-01-07 10:03:15 -08:00
|
|
|
}
|
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
float obs_source_get_volume(const obs_source_t *source)
|
2014-01-07 10:03:15 -08:00
|
|
|
{
|
2014-02-20 15:16:25 -08:00
|
|
|
return source ? source->user_volume : 0.0f;
|
2014-02-20 14:53:16 -08:00
|
|
|
}
|
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
float obs_source_get_present_volume(const obs_source_t *source)
|
2014-02-20 14:53:16 -08:00
|
|
|
{
|
2014-02-20 15:16:25 -08:00
|
|
|
return source ? source->present_volume : 0.0f;
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_set_sync_offset(obs_source_t *source, int64_t offset)
|
2014-02-20 15:16:25 -08:00
|
|
|
{
|
2014-12-27 20:55:03 -08:00
|
|
|
if (source) {
|
|
|
|
struct calldata data = {0};
|
|
|
|
|
|
|
|
calldata_set_ptr(&data, "source", source);
|
|
|
|
calldata_set_int(&data, "offset", offset);
|
|
|
|
|
|
|
|
signal_handler_signal(source->context.signals, "audio_sync",
|
|
|
|
&data);
|
|
|
|
|
|
|
|
source->sync_offset = calldata_int(&data, "offset");
|
|
|
|
calldata_free(&data);
|
|
|
|
}
|
2014-02-20 15:16:25 -08:00
|
|
|
}
|
|
|
|
|
2014-09-26 15:25:59 -07:00
|
|
|
int64_t obs_source_get_sync_offset(const obs_source_t *source)
|
2014-02-20 15:16:25 -08:00
|
|
|
{
|
|
|
|
return source ? source->sync_offset : 0;
|
2014-01-07 10:03:15 -08:00
|
|
|
}
|
2014-02-20 16:44:42 -08:00
|
|
|
|
|
|
|
struct source_enum_data {
|
|
|
|
obs_source_enum_proc_t enum_callback;
|
|
|
|
void *param;
|
|
|
|
};
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
static void enum_source_tree_callback(obs_source_t *parent, obs_source_t *child,
|
2014-02-20 16:44:42 -08:00
|
|
|
void *param)
|
|
|
|
{
|
|
|
|
struct source_enum_data *data = param;
|
|
|
|
|
2014-12-27 20:21:22 -08:00
|
|
|
if (child->info.enum_sources) {
|
|
|
|
if (child->context.data) {
|
2014-05-04 16:20:11 -07:00
|
|
|
child->info.enum_sources(child->context.data,
|
|
|
|
enum_source_tree_callback, data);
|
2014-12-27 20:21:22 -08:00
|
|
|
}
|
2014-02-20 16:44:42 -08:00
|
|
|
}
|
|
|
|
|
|
|
|
data->enum_callback(parent, child, data->param);
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_enum_sources(obs_source_t *source,
|
2014-02-20 16:44:42 -08:00
|
|
|
obs_source_enum_proc_t enum_callback,
|
|
|
|
void *param)
|
|
|
|
{
|
2014-12-27 20:21:22 -08:00
|
|
|
if (!source_valid(source) || !source->info.enum_sources)
|
2014-02-20 16:44:42 -08:00
|
|
|
return;
|
|
|
|
|
|
|
|
obs_source_addref(source);
|
|
|
|
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
source->info.enum_sources(source->context.data, enum_callback, param);
|
2014-02-20 16:44:42 -08:00
|
|
|
|
|
|
|
obs_source_release(source);
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_enum_tree(obs_source_t *source,
|
2014-02-20 16:44:42 -08:00
|
|
|
obs_source_enum_proc_t enum_callback,
|
|
|
|
void *param)
|
|
|
|
{
|
|
|
|
struct source_enum_data data = {enum_callback, param};
|
|
|
|
|
2014-12-27 20:21:22 -08:00
|
|
|
if (!source_valid(source) || !source->info.enum_sources)
|
2014-02-20 16:44:42 -08:00
|
|
|
return;
|
|
|
|
|
|
|
|
obs_source_addref(source);
|
|
|
|
|
libobs: Add services API, reduce repeated code
Add API for streaming services. The services API simplifies the
creation of custom service features and user interface.
Custom streaming services later on will be able to do things such as:
- Be able to use service-specific APIs via modules, allowing a more
direct means of communicating with the service and requesting or
setting service-specific information
- Get URL/stream key via other means of authentication such as OAuth,
or be able to build custom URLs for services that require that sort
of thing.
- Query information (such as viewer count, chat, follower
notifications, and other information)
- Set channel information (such as current game, current channel title,
activating commercials)
Also, I reduce some repeated code that was used for all libobs objects.
This includes the name of the object, the private data, settings, as
well as the signal and procedure handlers.
I also switched to using linked lists for the global object lists,
rather than using an array of pointers (you could say it was..
pointless.) ..Anyway, the linked list info is also stored in the shared
context data structure.
2014-04-19 20:38:53 -07:00
|
|
|
source->info.enum_sources(source->context.data,
|
|
|
|
enum_source_tree_callback,
|
2014-02-20 16:44:42 -08:00
|
|
|
&data);
|
|
|
|
|
|
|
|
obs_source_release(source);
|
|
|
|
}
|
2014-02-20 21:04:14 -08:00
|
|
|
|
2014-12-27 20:21:22 -08:00
|
|
|
struct descendant_info {
|
|
|
|
bool exists;
|
|
|
|
obs_source_t *target;
|
|
|
|
};
|
|
|
|
|
|
|
|
static void check_descendant(obs_source_t *parent, obs_source_t *child,
|
|
|
|
void *param)
|
2014-02-20 21:04:14 -08:00
|
|
|
{
|
2014-12-27 20:21:22 -08:00
|
|
|
struct descendant_info *info = param;
|
|
|
|
if (child == info->target || parent == info->target)
|
|
|
|
info->exists = true;
|
|
|
|
}
|
|
|
|
|
|
|
|
bool obs_source_add_child(obs_source_t *parent, obs_source_t *child)
|
|
|
|
{
|
|
|
|
struct descendant_info info = {false, child};
|
|
|
|
if (!parent || !child) return false;
|
|
|
|
|
|
|
|
obs_source_enum_tree(parent, check_descendant, &info);
|
|
|
|
if (info.exists)
|
|
|
|
return false;
|
2014-02-20 21:04:14 -08:00
|
|
|
|
2014-02-23 16:46:00 -08:00
|
|
|
for (int i = 0; i < parent->show_refs; i++) {
|
|
|
|
enum view_type type;
|
|
|
|
type = (i < parent->activate_refs) ? MAIN_VIEW : AUX_VIEW;
|
|
|
|
obs_source_activate(child, type);
|
|
|
|
}
|
2014-12-27 20:21:22 -08:00
|
|
|
|
|
|
|
return true;
|
2014-02-20 21:04:14 -08:00
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_remove_child(obs_source_t *parent, obs_source_t *child)
|
2014-02-20 21:04:14 -08:00
|
|
|
{
|
|
|
|
if (!parent || !child) return;
|
|
|
|
|
2014-02-23 16:46:00 -08:00
|
|
|
for (int i = 0; i < parent->show_refs; i++) {
|
|
|
|
enum view_type type;
|
|
|
|
type = (i < parent->activate_refs) ? MAIN_VIEW : AUX_VIEW;
|
|
|
|
obs_source_deactivate(child, type);
|
|
|
|
}
|
2014-02-20 21:04:14 -08:00
|
|
|
}
|
Implement volume handling
- Remove obs_source::type because it became redundant now that the
type is always stored in the obs_source::info variable.
- Apply presentation volumes of 1.0 and 0.0 to sources when they
activate/deactivate, respectively. It also applies that presentation
volume to all sub-sources, with exception of transition sources.
Transition sources must apply presentation volume manually to their
sub-sources with the new transition functions below.
- Add a "transition_volume" variable to obs_source structure, and add
three functions for handling volume for transitions:
* obs_transition_begin_frame
* obs_source_set_transition_vol
* obs_transition_end_frame
Because the to/from targets of a transition source might both contain
some of the same sources, handling the transitioning of volumes for
that specific situation becomes an issue.
So for transitions, instead of modifying the presentation volumes
directly for both sets of sources, we do this:
- First, call obs_transition_begin_frame at the beginning of each
transition frame, which will reset transition volumes for all
sub-sources to 0. Presentation volumes remain unchanged.
- Call obs_source_set_transition_vol on each sub-source, which will
then add the volume to the transition volume for each source in
that source's tree. Presentation volumes still remain unchanged.
- Then you call obs_trandition_end_frame when complete, which will
then finally set the presentation volumes to the transition
volumes.
For example, let's say that there's one source that's within both the
"transitioning from" sources and "transition to" sources. It would
add both the fade in and fade out volumes to that source, and then
when the frame is complete, it would set the presentation volume to
the sum of those two values, rather than set the presentation volume
for that same source twice which would cause weird volume jittering
and also set the wrong values.
2014-02-21 18:41:38 -08:00
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_save(obs_source_t *source)
|
2014-04-26 23:47:50 -07:00
|
|
|
{
|
2014-05-04 16:20:11 -07:00
|
|
|
if (!source_valid(source) || !source->info.save) return;
|
2014-04-26 23:47:50 -07:00
|
|
|
source->info.save(source->context.data, source->context.settings);
|
|
|
|
}
|
|
|
|
|
2014-09-25 17:44:05 -07:00
|
|
|
void obs_source_load(obs_source_t *source)
|
2014-04-26 23:47:50 -07:00
|
|
|
{
|
2014-05-04 16:20:11 -07:00
|
|
|
if (!source_valid(source) || !source->info.load) return;
|
2014-04-26 23:47:50 -07:00
|
|
|
source->info.load(source->context.data, source->context.settings);
|
|
|
|
}
|
2014-10-23 09:56:50 -07:00
|
|
|
|
2014-12-23 17:50:20 -08:00
|
|
|
bool obs_source_active(const obs_source_t *source)
|
|
|
|
{
|
2014-12-31 15:25:11 -08:00
|
|
|
return source ? source->activate_refs != 0 : false;
|
2014-12-23 17:50:20 -08:00
|
|
|
}
|
|
|
|
|
2014-12-31 15:26:02 -08:00
|
|
|
bool obs_source_showing(const obs_source_t *source)
|
|
|
|
{
|
|
|
|
return source ? source->show_refs != 0 : false;
|
|
|
|
}
|
|
|
|
|
2014-10-23 09:56:50 -07:00
|
|
|
static inline void signal_flags_updated(obs_source_t *source)
|
|
|
|
{
|
|
|
|
struct calldata data = {0};
|
|
|
|
|
|
|
|
calldata_set_ptr(&data, "source", source);
|
|
|
|
calldata_set_int(&data, "flags", source->flags);
|
|
|
|
|
|
|
|
signal_handler_signal(source->context.signals, "update_flags", &data);
|
|
|
|
|
|
|
|
calldata_free(&data);
|
|
|
|
}
|
|
|
|
|
|
|
|
void obs_source_set_flags(obs_source_t *source, uint32_t flags)
|
|
|
|
{
|
|
|
|
if (!source) return;
|
|
|
|
|
|
|
|
if (flags != source->flags) {
|
|
|
|
source->flags = flags;
|
|
|
|
signal_flags_updated(source);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-12-31 21:58:45 -08:00
|
|
|
void obs_source_set_default_flags(obs_source_t *source, uint32_t flags)
|
|
|
|
{
|
|
|
|
if (!source) return;
|
|
|
|
|
|
|
|
source->default_flags = flags;
|
|
|
|
}
|
|
|
|
|
2014-10-23 09:56:50 -07:00
|
|
|
uint32_t obs_source_get_flags(const obs_source_t *source)
|
|
|
|
{
|
|
|
|
return source ? source->flags : 0;
|
|
|
|
}
|
Add helper functions for drawing sources
If you look at the previous commits, you'll see I had added
obs_source_draw before. For custom drawn sources in particular, each
time obs_source_draw was called, it would restart the effect and its
passes for each draw call, which was not optimal. It should really use
the effect functions for that. I'll have to add a function to simplify
effect usage.
I also realized that including the color matrix parameters in
obs_source_draw made the function kind of messy to use; instead,
separating the color matrix stuff out to
obs_source_draw_set_color_matrix feels a lot more clean.
On top of that, having the ability to set the position would be nice to
have as well, rather than having to mess with the matrix stuff each
time, so I also added that for the sake of convenience.
obs_source_draw will draw a texture sprite, optionally of a specific
size and/or at a specific position, as well as optionally inverted. The
texture used will be set to the 'image' parameter of whatever effect is
currently active.
obs_source_draw_set_color_matrix will set the color matrix value if the
drawing requires color matrices. It will set the 'color_matrix',
'color_range_min', and 'color_range_max' parameters of whatever effect
is currently active.
Overall, these feel much more clean to use than the previous iteration.
2014-11-19 17:36:12 -08:00
|
|
|
|
(API Change) Add support for multiple audio mixers
API changed:
--------------------------
void obs_output_set_audio_encoder(
obs_output_t *output,
obs_encoder_t *encoder);
obs_encoder_t *obs_output_get_audio_encoder(
const obs_output_t *output);
obs_encoder_t *obs_audio_encoder_create(
const char *id,
const char *name,
obs_data_t *settings);
Changed to:
--------------------------
/* 'idx' specifies the track index of the output */
void obs_output_set_audio_encoder(
obs_output_t *output,
obs_encoder_t *encoder,
size_t idx);
/* 'idx' specifies the track index of the output */
obs_encoder_t *obs_output_get_audio_encoder(
const obs_output_t *output,
size_t idx);
/* 'mixer_idx' specifies the mixer index to capture audio from */
obs_encoder_t *obs_audio_encoder_create(
const char *id,
const char *name,
obs_data_t *settings,
size_t mixer_idx);
Overview
--------------------------
This feature allows multiple audio mixers to be used at a time. This
capability was able to be added with surprisingly very little extra
overhead. Audio will not be mixed unless it's assigned to a specific
mixer, and mixers will not mix unless they have an active mix
connection.
Mostly this will be useful for being able to separate out specific audio
for recording versus streaming, but will also be useful for certain
streaming services that support multiple audio streams via RTMP.
I didn't want to use a variable amount of mixers due to the desire to
reduce heap allocations, so currently I set the limit to 4 simultaneous
mixers; this number can be increased later if needed, but honestly I
feel like it's just the right number to use.
Sources:
Sources can now specify which audio mixers their audio is mixed to; this
can be a single mixer or multiple mixers at a time. The
obs_source_set_audio_mixers function sets the audio mixer which an audio
source applies to. For example, 0xF would mean that the source applies
to all four mixers.
Audio Encoders:
Audio encoders now must specify which specific audio mixer they use when
they encode audio data.
Outputs:
Outputs that use encoders can now support multiple audio tracks at once
if they have the OBS_OUTPUT_MULTI_TRACK capability flag set. This is
mostly only useful for certain types of RTMP transmissions, though may
be useful for file formats that support multiple audio tracks as well
later on.
2015-01-14 02:12:08 -08:00
|
|
|
void obs_source_set_audio_mixers(obs_source_t *source, uint32_t mixers)
|
|
|
|
{
|
|
|
|
struct calldata data = {0};
|
|
|
|
uint32_t cur_mixers;
|
|
|
|
|
|
|
|
if (!source) return;
|
|
|
|
if ((source->info.output_flags & OBS_SOURCE_AUDIO) == 0) return;
|
|
|
|
|
|
|
|
cur_mixers = audio_line_get_mixers(source->audio_line);
|
|
|
|
if (cur_mixers == mixers)
|
|
|
|
return;
|
|
|
|
|
|
|
|
calldata_set_ptr(&data, "source", source);
|
|
|
|
calldata_set_int(&data, "mixers", mixers);
|
|
|
|
|
|
|
|
signal_handler_signal(source->context.signals, "audio_mixers", &data);
|
|
|
|
|
|
|
|
mixers = (uint32_t)calldata_int(&data, "mixers");
|
|
|
|
calldata_free(&data);
|
|
|
|
|
|
|
|
audio_line_set_mixers(source->audio_line, mixers);
|
|
|
|
}
|
|
|
|
|
|
|
|
uint32_t obs_source_get_audio_mixers(const obs_source_t *source)
|
|
|
|
{
|
|
|
|
if (!source) return 0;
|
|
|
|
if ((source->info.output_flags & OBS_SOURCE_AUDIO) == 0) return 0;
|
|
|
|
|
|
|
|
return audio_line_get_mixers(source->audio_line);
|
|
|
|
}
|
|
|
|
|
Add helper functions for drawing sources
If you look at the previous commits, you'll see I had added
obs_source_draw before. For custom drawn sources in particular, each
time obs_source_draw was called, it would restart the effect and its
passes for each draw call, which was not optimal. It should really use
the effect functions for that. I'll have to add a function to simplify
effect usage.
I also realized that including the color matrix parameters in
obs_source_draw made the function kind of messy to use; instead,
separating the color matrix stuff out to
obs_source_draw_set_color_matrix feels a lot more clean.
On top of that, having the ability to set the position would be nice to
have as well, rather than having to mess with the matrix stuff each
time, so I also added that for the sake of convenience.
obs_source_draw will draw a texture sprite, optionally of a specific
size and/or at a specific position, as well as optionally inverted. The
texture used will be set to the 'image' parameter of whatever effect is
currently active.
obs_source_draw_set_color_matrix will set the color matrix value if the
drawing requires color matrices. It will set the 'color_matrix',
'color_range_min', and 'color_range_max' parameters of whatever effect
is currently active.
Overall, these feel much more clean to use than the previous iteration.
2014-11-19 17:36:12 -08:00
|
|
|
void obs_source_draw_set_color_matrix(const struct matrix4 *color_matrix,
|
|
|
|
const struct vec3 *color_range_min,
|
|
|
|
const struct vec3 *color_range_max)
|
|
|
|
{
|
2014-11-26 23:29:36 -08:00
|
|
|
struct vec3 color_range_min_def;
|
|
|
|
struct vec3 color_range_max_def;
|
|
|
|
|
|
|
|
vec3_set(&color_range_min_def, 0.0f, 0.0f, 0.0f);
|
|
|
|
vec3_set(&color_range_max_def, 1.0f, 1.0f, 1.0f);
|
|
|
|
|
Add helper functions for drawing sources
If you look at the previous commits, you'll see I had added
obs_source_draw before. For custom drawn sources in particular, each
time obs_source_draw was called, it would restart the effect and its
passes for each draw call, which was not optimal. It should really use
the effect functions for that. I'll have to add a function to simplify
effect usage.
I also realized that including the color matrix parameters in
obs_source_draw made the function kind of messy to use; instead,
separating the color matrix stuff out to
obs_source_draw_set_color_matrix feels a lot more clean.
On top of that, having the ability to set the position would be nice to
have as well, rather than having to mess with the matrix stuff each
time, so I also added that for the sake of convenience.
obs_source_draw will draw a texture sprite, optionally of a specific
size and/or at a specific position, as well as optionally inverted. The
texture used will be set to the 'image' parameter of whatever effect is
currently active.
obs_source_draw_set_color_matrix will set the color matrix value if the
drawing requires color matrices. It will set the 'color_matrix',
'color_range_min', and 'color_range_max' parameters of whatever effect
is currently active.
Overall, these feel much more clean to use than the previous iteration.
2014-11-19 17:36:12 -08:00
|
|
|
gs_effect_t *effect = gs_get_effect();
|
|
|
|
gs_eparam_t *matrix;
|
|
|
|
gs_eparam_t *range_min;
|
|
|
|
gs_eparam_t *range_max;
|
|
|
|
|
|
|
|
if (!effect) {
|
|
|
|
blog(LOG_WARNING, "obs_source_draw_set_color_matrix: NULL "
|
|
|
|
"effect");
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (!color_matrix) {
|
|
|
|
blog(LOG_WARNING, "obs_source_draw_set_color_matrix: NULL "
|
|
|
|
"color_matrix");
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (!color_range_min)
|
|
|
|
color_range_min = &color_range_min_def;
|
|
|
|
if (!color_range_max)
|
|
|
|
color_range_max = &color_range_max_def;
|
|
|
|
|
|
|
|
matrix = gs_effect_get_param_by_name(effect, "color_matrix");
|
|
|
|
range_min = gs_effect_get_param_by_name(effect, "color_range_min");
|
|
|
|
range_max = gs_effect_get_param_by_name(effect, "color_range_max");
|
|
|
|
|
|
|
|
gs_effect_set_matrix4(matrix, color_matrix);
|
|
|
|
gs_effect_set_val(range_min, color_range_min, sizeof(float)*3);
|
|
|
|
gs_effect_set_val(range_max, color_range_max, sizeof(float)*3);
|
|
|
|
}
|
|
|
|
|
|
|
|
void obs_source_draw(gs_texture_t *texture, int x, int y, uint32_t cx,
|
|
|
|
uint32_t cy, bool flip)
|
|
|
|
{
|
|
|
|
gs_effect_t *effect = gs_get_effect();
|
|
|
|
bool change_pos = (x != 0 || y != 0);
|
|
|
|
gs_eparam_t *image;
|
|
|
|
|
|
|
|
if (!effect) {
|
|
|
|
blog(LOG_WARNING, "obs_source_draw: NULL effect");
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (!texture) {
|
|
|
|
blog(LOG_WARNING, "obs_source_draw: NULL texture");
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
image = gs_effect_get_param_by_name(effect, "image");
|
|
|
|
gs_effect_set_texture(image, texture);
|
|
|
|
|
|
|
|
if (change_pos) {
|
|
|
|
gs_matrix_push();
|
|
|
|
gs_matrix_translate3f((float)x, (float)y, 0.0f);
|
|
|
|
}
|
|
|
|
|
|
|
|
gs_draw_sprite(texture, flip ? GS_FLIP_V : 0, cx, cy);
|
|
|
|
|
|
|
|
if (change_pos)
|
|
|
|
gs_matrix_pop();
|
|
|
|
}
|
libobs: Refactor source volume transition design
This changes the way source volume handles transitioning between being
active and inactive states.
The previous way that transitioning handled volume was that it set the
presentation volume of the source and all of its sub-sources to 0.0 if
the source was inactive, and 1.0 if active. Transition sources would
then also set the presentation volume for sub-sources to whatever their
transitioning volume was. However, the problem with this is that the
design didn't take in to account if the source or its sub-sources were
active anywhere else, so because of that it would break if that ever
happened, and I didn't realize that when I was designing it.
So instead, this completely overhauls the design of handling
transitioning volume. Each frame, it'll go through all sources and
check whether they're active or inactive and set the base volume
accordingly. If transitions are currently active, it will actually walk
the active source tree and check whether the source is in a
transitioning state somewhere.
- If the source is a sub-source of a transition, and it's not active
outside of the transition, then the transition will control the
volume of the source.
- If the source is a sub-source of a transition, but it's also active
outside of the transition, it'll defer to whichever is louder.
This also adds a new callback to the obs_source_info structure for
transition sources, get_transition_volume, which is called to get the
transitioning volume of a sub-source.
2014-12-27 22:16:10 -08:00
|
|
|
|
|
|
|
static inline float get_transition_volume(obs_source_t *source,
|
|
|
|
obs_source_t *child)
|
|
|
|
{
|
|
|
|
if (source && child && source->info.get_transition_volume)
|
|
|
|
return source->info.get_transition_volume(source->context.data,
|
|
|
|
child);
|
|
|
|
return 0.0f;
|
|
|
|
}
|
|
|
|
|
|
|
|
static float obs_source_get_target_volume_refs(obs_source_t *source,
|
|
|
|
obs_source_t *target, int refs);
|
|
|
|
|
|
|
|
struct base_vol_enum_info {
|
|
|
|
obs_source_t *target;
|
|
|
|
float vol;
|
|
|
|
};
|
|
|
|
|
|
|
|
static void get_transition_child_vol(obs_source_t *parent, obs_source_t *child,
|
|
|
|
void *param)
|
|
|
|
{
|
|
|
|
struct base_vol_enum_info *info = param;
|
|
|
|
float vol = obs_source_get_target_volume(child, info->target);
|
|
|
|
|
|
|
|
info->vol += vol * get_transition_volume(parent, child);
|
|
|
|
}
|
|
|
|
|
|
|
|
static void get_source_base_vol(obs_source_t *parent, obs_source_t *child,
|
|
|
|
void *param)
|
|
|
|
{
|
|
|
|
struct base_vol_enum_info *info = param;
|
|
|
|
float vol = obs_source_get_target_volume(child, info->target);
|
|
|
|
|
|
|
|
if (vol > info->vol)
|
|
|
|
info->vol = vol;
|
|
|
|
|
|
|
|
UNUSED_PARAMETER(parent);
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* This traverses a source tree for any references to a particular source.
|
|
|
|
* If the source is found, it'll just return 1.0. However, if the source
|
|
|
|
* exists within some transition somewhere, the transition source will be able
|
|
|
|
* to control what the volume of the source will be. If the source is also
|
|
|
|
* active outside the transition, then it'll just use 1.0.
|
|
|
|
*/
|
|
|
|
float obs_source_get_target_volume(obs_source_t *source, obs_source_t *target)
|
|
|
|
{
|
|
|
|
struct base_vol_enum_info info = {target, 0.0f};
|
|
|
|
bool transition = source->info.type == OBS_SOURCE_TYPE_TRANSITION;
|
|
|
|
|
|
|
|
if (source == target)
|
|
|
|
return 1.0f;
|
|
|
|
|
|
|
|
if (source->info.enum_sources) {
|
|
|
|
source->info.enum_sources(source->context.data,
|
|
|
|
transition ?
|
|
|
|
get_transition_child_vol :
|
|
|
|
get_source_base_vol,
|
|
|
|
&info);
|
|
|
|
}
|
|
|
|
|
|
|
|
return info.vol;
|
|
|
|
}
|