GstConfig

GstConfig — Configuration options

Synopsis


#include <gst/gst.h>


#define     GST_DISABLE_LOADSAVE_REGISTRY
#define     GST_DISABLE_GST_DEBUG
#define     GST_DISABLE_LOADSAVE
#define     GST_DISABLE_PARSE
#define     GST_DISABLE_TRACE
#define     GST_DISABLE_ALLOC_TRACE
#define     GST_DISABLE_REGISTRY
#define     GST_DISABLE_ENUMTYPES
#define     GST_DISABLE_INDEX
#define     GST_DISABLE_PLUGIN
#define     GST_DISABLE_URI
#define     GST_PTR_FORMAT
#define     GST_EXPORT
#define     GST_PLUGIN_EXPORT

Description

This describes the configuration options for GStreamer. When building GStreamer there are a lot of parts (known internally as "subsystems" ) that can be disabled for various reasons. The most common reasons are speed and size, which is important because GStreamer is designed to run on embedded systems.

If a subsystem is disabled, most of this changes are done in an API compatible way, so you don't need to adapt your code in most cases. It is never done in an ABI compatible way though. So if you want to disable a suybsystem, you have to rebuild all programs depending on GStreamer, too.

If a subsystem is disabled in GStreamer, a value is defined in <gst/gst.h>. You can check this if you do subsystem-specific stuff.

Example 4. Doing subsystem specific things

#ifndef GST_DISABLE_GST_DEBUG
/* do stuff specific to the debugging subsystem */
#endif /* GST_DISABLE_GST_DEBUG */

Details

GST_DISABLE_LOADSAVE_REGISTRY

#define     GST_DISABLE_LOADSAVE_REGISTRY

GST_DISABLE_GST_DEBUG

#define GST_DISABLE_GST_DEBUG 1

If this is defined, the debugging subsystem is disabled and debugging messages are not output.

GST_DISABLE_LOADSAVE

#define GST_DISABLE_LOADSAVE 1

GST_DISABLE_PARSE

#define GST_DISABLE_PARSE 1

GST_DISABLE_TRACE

#define GST_DISABLE_TRACE 1

GST_DISABLE_ALLOC_TRACE

#define GST_DISABLE_ALLOC_TRACE 1

GST_DISABLE_REGISTRY

#define GST_DISABLE_REGISTRY 1

GST_DISABLE_ENUMTYPES

#define GST_DISABLE_ENUMTYPES 1

GST_DISABLE_INDEX

#define GST_DISABLE_INDEX 1

GST_DISABLE_PLUGIN

#define GST_DISABLE_PLUGIN 1

GST_DISABLE_URI

#define GST_DISABLE_URI 1

GST_PTR_FORMAT

#define GST_PTR_FORMAT "P"

GST_EXPORT

#define     GST_EXPORT

Under Windows it permits to export variables from a DLL, otherwise it just means extern.

GST_PLUGIN_EXPORT

#define     GST_PLUGIN_EXPORT

Under Windows it permits to automatically export the plugin definition, otherwise it just defines as nothing.