BaconVideoWidget

typedef struct _BaconVideoWidget BaconVideoWidget;

All the fields in the BaconVideoWidget structure are private and should never be accessed directly.

BaconVideoWidgetClass

typedef struct {
} BaconVideoWidgetClass;

All the fields in the BaconVideoWidgetClass structure are private and should never be accessed directly.

enum BvwAspectRatio

typedef enum {
	BVW_RATIO_AUTO = 0,
	BVW_RATIO_SQUARE = 1,
	BVW_RATIO_FOURBYTHREE = 2,
	BVW_RATIO_ANAMORPHIC = 3,
	BVW_RATIO_DVB = 4
} BvwAspectRatio;

The pixel aspect ratios available in which to display videos using @bacon_video_widget_set_aspect_ratio().

enum BvwAudioOutputType

typedef enum {
	BVW_AUDIO_SOUND_STEREO,
	BVW_AUDIO_SOUND_4CHANNEL,
	BVW_AUDIO_SOUND_41CHANNEL,
	BVW_AUDIO_SOUND_5CHANNEL,
	BVW_AUDIO_SOUND_51CHANNEL,
	BVW_AUDIO_SOUND_AC3PASSTHRU
} BvwAudioOutputType;

The audio output types available for use with bacon_video_widget_set_audio_output_type().

enum BvwConnectionSpeed

typedef enum {
	BVW_SPEED_14_4_MODEM = 0,
	BVW_SPEED_19_2_MODEM,
	BVW_SPEED_28_8_MODEM,
	BVW_SPEED_33_6_MODEM,
	BVW_SPEED_34_4_MODEM,
	BVW_SPEED_56_ISDN,
	BVW_SPEED_112_ISDN,
	BVW_SPEED_256_DSL,
	BVW_SPEED_384_DSL,
	BVW_SPEED_512_DSL,
	BVW_SPEED_1500_T1,
	BVW_SPEED_LAN
} BvwConnectionSpeed;

The different connection speeds understood by bacon_video_widget_set_connection_speed().

enum BvwDVDEvent

typedef enum {
	BVW_DVD_ROOT_MENU,
	BVW_DVD_TITLE_MENU,
	BVW_DVD_SUBPICTURE_MENU,
	BVW_DVD_AUDIO_MENU,
	BVW_DVD_ANGLE_MENU,
	BVW_DVD_CHAPTER_MENU,
	BVW_DVD_NEXT_CHAPTER,
	BVW_DVD_PREV_CHAPTER,
	BVW_DVD_NEXT_TITLE,
	BVW_DVD_PREV_TITLE,
	BVW_DVD_ROOT_MENU_UP,
	BVW_DVD_ROOT_MENU_DOWN,
	BVW_DVD_ROOT_MENU_LEFT,
	BVW_DVD_ROOT_MENU_RIGHT,
	BVW_DVD_ROOT_MENU_SELECT
} BvwDVDEvent;

The DVD navigation actions available to fire as DVD events to the BaconVideoWidget.

enum BvwMetadataType

typedef enum {
	BVW_INFO_TITLE,
	BVW_INFO_ARTIST,
	BVW_INFO_YEAR,
	BVW_INFO_COMMENT,
	BVW_INFO_ALBUM,
	BVW_INFO_DURATION,
	BVW_INFO_TRACK_NUMBER,
	BVW_INFO_COVER,
	BVW_INFO_CONTAINER,
	/* Video */
	BVW_INFO_HAS_VIDEO,
	BVW_INFO_DIMENSION_X,
	BVW_INFO_DIMENSION_Y,
	BVW_INFO_VIDEO_BITRATE,
	BVW_INFO_VIDEO_CODEC,
	BVW_INFO_FPS,
	/* Audio */
	BVW_INFO_HAS_AUDIO,
	BVW_INFO_AUDIO_BITRATE,
	BVW_INFO_AUDIO_CODEC,
	BVW_INFO_AUDIO_SAMPLE_RATE,
	BVW_INFO_AUDIO_CHANNELS
} BvwMetadataType;

The different metadata available for querying from a BaconVideoWidget stream with bacon_video_widget_get_metadata().

enum BvwVisualizationQuality

typedef enum {
	BVW_VISUALIZATION_SMALL = 0,
	BVW_VISUALIZATION_NORMAL,
	BVW_VISUALIZATION_LARGE,
	BVW_VISUALIZATION_EXTRA_LARGE
} BvwVisualizationQuality;

The different visualisation sizes or qualities available for use with bacon_video_widget_set_visualization_quality().

enum BvwVideoProperty

typedef enum {
	BVW_VIDEO_BRIGHTNESS,
	BVW_VIDEO_CONTRAST,
	BVW_VIDEO_SATURATION,
	BVW_VIDEO_HUE
} BvwVideoProperty;

The video properties queryable with bacon_video_widget_get_video_property(), and settable with bacon_video_widget_set_video_property().

enum BvwError

typedef enum {
	/* Plugins */
	BVW_ERROR_AUDIO_PLUGIN,
	BVW_ERROR_NO_PLUGIN_FOR_FILE,
	BVW_ERROR_VIDEO_PLUGIN,
	BVW_ERROR_AUDIO_BUSY,
	/* File */
	BVW_ERROR_BROKEN_FILE,
	BVW_ERROR_FILE_GENERIC,
	BVW_ERROR_FILE_PERMISSION,
	BVW_ERROR_FILE_ENCRYPTED,
	BVW_ERROR_FILE_NOT_FOUND,
	/* Devices */
	BVW_ERROR_DVD_ENCRYPTED,
	BVW_ERROR_INVALID_DEVICE,
	BVW_ERROR_DEVICE_BUSY,
	/* Network */
	BVW_ERROR_UNKNOWN_HOST,
	BVW_ERROR_NETWORK_UNREACHABLE,
	BVW_ERROR_CONNECTION_REFUSED,
	/* Generic */
	BVW_ERROR_INVALID_LOCATION,
	BVW_ERROR_GENERIC,
	BVW_ERROR_CODEC_NOT_HANDLED,
	BVW_ERROR_AUDIO_ONLY,
	BVW_ERROR_CANNOT_CAPTURE,
	BVW_ERROR_READ_ERROR,
	BVW_ERROR_PLUGIN_LOAD,
	BVW_ERROR_EMPTY_FILE
} BvwError;

Error codes for BaconVideoWidget operations.

bacon_video_widget_new ()

GtkWidget *         bacon_video_widget_new              (GError **error);

Creates a new BaconVideoWidget.

width and height give the initial or expected video height. Set them to -1 if the video size is unknown. For small videos, BaconVideoWidget will be configured differently.

A BvwError will be returned on error.

bacon_video_widget_init_backend ()

void                bacon_video_widget_init_backend     (int *argc,
                                                         char ***argv);

bacon_video_widget_open ()

gboolean            bacon_video_widget_open             (BaconVideoWidget *bvw,
                                                         const char *mrl,
                                                         const char *subtitle_uri,
                                                         GError **error);

Opens the given mrl in bvw for playing. If subtitle_uri is not NULL, the given subtitle file is also loaded. Alternatively, the subtitle URI can be passed in mrl by adding it after subtitle:. For example: http://example.com/video.mpgsubtitle:/home/user/subtitle.ass.

If there was a filesystem error, a BVW_ERROR_GENERIC error will be returned. Otherwise, more specific BvwError errors will be returned.

On success, the MRL is loaded and waiting to be played with bacon_video_widget_play().

bacon_video_widget_play ()

gboolean            bacon_video_widget_play             (BaconVideoWidget *bvw,
                                                         GError **error);

Plays the currently-loaded video in bvw.

Errors from the GStreamer backend will be returned asynchronously via the "error" signal, even if this function returns TRUE.

bacon_video_widget_pause ()

void                bacon_video_widget_pause            (BaconVideoWidget *bvw);

Pauses the current stream in the video widget.

If a live stream is being played, playback is stopped entirely.

bacon_video_widget_seek ()

gboolean            bacon_video_widget_seek             (BaconVideoWidget *bvw,
                                                         double position,
                                                         GError **error);

Seeks the currently-playing stream to position as a percentage of the total stream length.

bacon_video_widget_seek_time ()

gboolean            bacon_video_widget_seek_time        (BaconVideoWidget *bvw,
                                                         gint64 _time,
                                                         gboolean accurate,
                                                         GError **error);

Seeks the currently-playing stream to the absolute position time, in milliseconds.

bacon_video_widget_stop ()

void                bacon_video_widget_stop             (BaconVideoWidget *bvw);

Stops playing the current stream and resets to the first position in the stream.

bacon_video_widget_close ()

void                bacon_video_widget_close            (BaconVideoWidget *bvw);

Closes the current stream and frees the resources associated with it.

bacon_video_widget_can_direct_seek ()

gboolean            bacon_video_widget_can_direct_seek  (BaconVideoWidget *bvw);

Determines whether direct seeking is possible for the current stream.

bacon_video_widget_can_get_frames ()

gboolean            bacon_video_widget_can_get_frames   (BaconVideoWidget *bvw,
                                                         GError **error);

Determines whether individual frames from the current stream can be returned using bacon_video_widget_get_current_frame().

Frames cannot be returned for audio-only streams, unless visualisations are enabled.

bacon_video_widget_can_set_volume ()

gboolean            bacon_video_widget_can_set_volume   (BaconVideoWidget *bvw);

Returns whether the volume level can be set, given the current settings.

The volume cannot be set if the audio output type is set to BVW_AUDIO_SOUND_AC3PASSTHRU.

bacon_video_widget_dvd_event ()

void                bacon_video_widget_dvd_event        (BaconVideoWidget *bvw,
                                                         BvwDVDEvent type);

Issues a DVD navigation event to the video widget, such as one to skip to the next chapter, or navigate to the DVD title menu.

This is a no-op if the current stream is not navigable.

bacon_video_widget_has_menus ()

gboolean            bacon_video_widget_has_menus        (BaconVideoWidget *bvw);

Returns whether the widget is currently displaying a menu, such as a DVD menu.

bacon_video_widget_get_aspect_ratio ()

BvwAspectRatio      bacon_video_widget_get_aspect_ratio (BaconVideoWidget *bvw);

Returns the current aspect ratio used by the widget, from BaconVideoWidgetAspectRatio.

bacon_video_widget_set_aspect_ratio ()

void                bacon_video_widget_set_aspect_ratio (BaconVideoWidget *bvw,
                                                         BvwAspectRatio ratio);

Sets the aspect ratio used by the widget, from BaconVideoWidgetAspectRatio.

Changes to this take effect immediately.

bacon_video_widget_get_audio_output_type ()

BvwAudioOutputType  bacon_video_widget_get_audio_output_type
                                                        (BaconVideoWidget *bvw);

Returns the current audio output type (e.g. how many speaker channels) from BaconVideoWidgetAudioOutputType.

bacon_video_widget_set_audio_output_type ()

void                bacon_video_widget_set_audio_output_type
                                                        (BaconVideoWidget *bvw,
                                                         BvwAudioOutputType type);

Sets the audio output type (number of speaker channels) in the video widget.

bacon_video_widget_get_auto_resize ()

gboolean            bacon_video_widget_get_auto_resize  (BaconVideoWidget *bvw);

Returns whether the widget will automatically resize to fit videos.

bacon_video_widget_set_auto_resize ()

void                bacon_video_widget_set_auto_resize  (BaconVideoWidget *bvw,
                                                         gboolean auto_resize);

Sets whether the widget should automatically resize to fit to new videos when they are loaded. Changes to this will take effect when the next media file is loaded.

bacon_video_widget_get_backend_name ()

char *              bacon_video_widget_get_backend_name (BaconVideoWidget *bvw);

Returns the name string for bvw. For the GStreamer backend, it is the output of gst_version_string(). *

bacon_video_widget_get_connection_speed ()

int                 bacon_video_widget_get_connection_speed
                                                        (BaconVideoWidget *bvw);

Returns the current connection speed, where 0 is the lowest speed and 11 is the highest.

bacon_video_widget_set_connection_speed ()

void                bacon_video_widget_set_connection_speed
                                                        (BaconVideoWidget *bvw,
                                                         int speed);

Sets the connection speed from the given speed index, where 0 is the lowest speed and 11 is the highest.

bacon_video_widget_get_current_frame ()

GdkPixbuf *         bacon_video_widget_get_current_frame
                                                        (BaconVideoWidget *bvw);

Returns a GdkPixbuf containing the current frame from the playing stream. This will wait for any pending seeks to complete before capturing the frame.

bacon_video_widget_get_current_time ()

gint64              bacon_video_widget_get_current_time (BaconVideoWidget *bvw);

Returns the current position in the stream, as the time (in milliseconds) since the beginning of the stream.

bacon_video_widget_get_deinterlacing ()

gboolean            bacon_video_widget_get_deinterlacing
                                                        (BaconVideoWidget *bvw);

Returns whether deinterlacing of videos is enabled for this widget.

bacon_video_widget_set_deinterlacing ()

void                bacon_video_widget_set_deinterlacing
                                                        (BaconVideoWidget *bvw,
                                                         gboolean deinterlace);

Sets whether the widget should deinterlace videos.

bacon_video_widget_set_fullscreen ()

void                bacon_video_widget_set_fullscreen   (BaconVideoWidget *bvw,
                                                         gboolean fullscreen);

Sets whether the widget renders the stream in fullscreen mode.

bacon_video_widget_get_languages ()

GList *             bacon_video_widget_get_languages    (BaconVideoWidget *bvw);

Returns a list of audio language tags, each in the form AUDIO x, where x is the language index.

bacon_video_widget_get_language ()

int                 bacon_video_widget_get_language     (BaconVideoWidget *bvw);

Returns the index of the current audio language.

If the widget is not playing, or the default language is in use, -1 will be returned.

bacon_video_widget_set_language ()

void                bacon_video_widget_set_language     (BaconVideoWidget *bvw,
                                                         int language);

Sets the audio language index for bvw. If language is -1, the default language will be used.

bacon_video_widget_set_logo ()

void                bacon_video_widget_set_logo         (BaconVideoWidget *bvw,
                                                         const char *name);

Sets the logo displayed on the video widget when no stream is loaded.

bacon_video_widget_get_logo_mode ()

gboolean            bacon_video_widget_get_logo_mode    (BaconVideoWidget *bvw);

Gets whether the logo is displayed when no stream is loaded.

bacon_video_widget_set_logo_mode ()

void                bacon_video_widget_set_logo_mode    (BaconVideoWidget *bvw,
                                                         gboolean logo_mode);

Sets whether to display a logo set with bacon_video_widget_set_logo when no stream is loaded. If logo_mode is FALSE, nothing will be displayed and the video widget will take up no space. Otherwise, the logo will be displayed and will requisition a corresponding amount of space.

bacon_video_widget_get_metadata ()

void                bacon_video_widget_get_metadata     (BaconVideoWidget *bvw,
                                                         BvwMetadataType type,
                                                         GValue *value);

Provides metadata of the given type about the current stream in value.

Free the GValue with g_value_unset().

bacon_video_widget_get_mrls ()

gchar **            bacon_video_widget_get_mrls         (BaconVideoWidget *bvw,
                                                         TotemDiscMediaType type,
                                                         const char *device,
                                                         GError **error);

Returns an array of MRLs available for the given device and media type.

device should typically be the number of the device (e.g. 0 for the first DVD drive.

type can be any value from TotemDiscMediaType, but a BVW_ERROR_INVALID_LOCATION error will be returned if type is MEDIA_TYPE_CDDA, as CDDA support has been removed from Totem (and hence BaconVideoWidget).

A BVW_ERROR_NO_PLUGIN_FOR_FILE error will be returned if the required GStreamer elements do not exist for the given type (for the GStreamer backend). * If device does not exist, a BVW_ERROR_INVALID_DEVICE error will be returned.

bacon_video_widget_get_option_group ()

GOptionGroup *      bacon_video_widget_get_option_group (void);

Returns the GOptionGroup containing command-line options for BaconVideoWidget.

Applications must call either this or bacon_video_widget_init_backend() exactly once; but not both.

bacon_video_widget_get_position ()

double              bacon_video_widget_get_position     (BaconVideoWidget *bvw);

Returns the current position in the stream, as a value between 0 and 1.

bacon_video_widget_set_referrer ()

void                bacon_video_widget_set_referrer     (BaconVideoWidget *bvw,
                                                         const char *referrer);

Sets the HTTP referrer URI to use when fetching HTTP ressources.

bacon_video_widget_set_scale_ratio ()

void                bacon_video_widget_set_scale_ratio  (BaconVideoWidget *bvw,
                                                         float ratio);

Sets the ratio by which the widget will scale videos when they are displayed. If ratio is set to 0, the highest ratio possible will be chosen.

bacon_video_widget_get_show_cursor ()

gboolean            bacon_video_widget_get_show_cursor  (BaconVideoWidget *bvw);

Returns whether the cursor is shown when it is over the video widget.

bacon_video_widget_set_show_cursor ()

void                bacon_video_widget_set_show_cursor  (BaconVideoWidget *bvw,
                                                         gboolean show_cursor);

Sets whether the cursor should be shown when it is over the video widget. If show_cursor is FALSE, the cursor will be invisible when it is moved over the video widget.

bacon_video_widget_set_show_visualizations ()

void                bacon_video_widget_set_show_visualizations
                                                        (BaconVideoWidget *bvw,
                                                         gboolean show_visualizations);

Sets whether to show visualisations when playing audio-only streams.

bacon_video_widget_get_stream_length ()

gint64              bacon_video_widget_get_stream_length
                                                        (BaconVideoWidget *bvw);

Returns the total length of the stream, in milliseconds.

bacon_video_widget_get_subtitles ()

GList *             bacon_video_widget_get_subtitles    (BaconVideoWidget *bvw);

Returns a list of subtitle tags, each in the form TEXT x, where x is the subtitle index.

bacon_video_widget_get_subtitle ()

int                 bacon_video_widget_get_subtitle     (BaconVideoWidget *bvw);

Returns the index of the current subtitles.

If the widget is not playing, -2 will be returned. If no subtitles are being used, -1 is returned.

bacon_video_widget_set_subtitle ()

void                bacon_video_widget_set_subtitle     (BaconVideoWidget *bvw,
                                                         int subtitle);

Sets the subtitle index for bvw. If subtitle is -1, no subtitles will be used.

bacon_video_widget_set_subtitle_encoding ()

void                bacon_video_widget_set_subtitle_encoding
                                                        (BaconVideoWidget *bvw,
                                                         const char *encoding);

Sets the encoding system for the subtitles, so that they can be decoded properly.

bacon_video_widget_set_subtitle_font ()

void                bacon_video_widget_set_subtitle_font
                                                        (BaconVideoWidget *bvw,
                                                         const char *font);

Sets the font size and style in which to display subtitles.

font is a Pango font description string, as understood by pango_font_description_from_string().

bacon_video_widget_set_user_agent ()

void                bacon_video_widget_set_user_agent   (BaconVideoWidget *bvw,
                                                         const char *user_agent);

Sets the HTTP user agent string to use when fetching HTTP ressources.

bacon_video_widget_get_video_property ()

int                 bacon_video_widget_get_video_property
                                                        (BaconVideoWidget *bvw,
                                                         BvwVideoProperty type);

Returns the given property of the video display, such as its brightness or saturation.

It is returned as a percentage in the full range of integer values; from 0 to 65535 (inclusive), where 32768 is the default.

bacon_video_widget_set_video_property ()

void                bacon_video_widget_set_video_property
                                                        (BaconVideoWidget *bvw,
                                                         BvwVideoProperty type,
                                                         int value);

Sets the given property of the video display, such as its brightness or saturation.

It should be given as a percentage in the full range of integer values; from 0 to 65535 (inclusive), where 32768 is the default.

bacon_video_widget_get_visualization_list ()

GList *             bacon_video_widget_get_visualization_list
                                                        (BaconVideoWidget *bvw);

Returns a list of the visualisations available when playing audio-only streams.

bacon_video_widget_set_visualization ()

void                bacon_video_widget_set_visualization
                                                        (BaconVideoWidget *bvw,
                                                         const char *name);

Sets the visualisation to display when playing audio-only streams.

If name is NULL, visualisations will be disabled. Otherwise, name should be from the list returned by bacon_video_widget_get_visualization_list().

bacon_video_widget_set_visualization_quality ()

void                bacon_video_widget_set_visualization_quality
                                                        (BaconVideoWidget *bvw,
                                                         BvwVisualizationQuality quality);

Sets the quality/size of displayed visualisations.

bacon_video_widget_get_volume ()

double              bacon_video_widget_get_volume       (BaconVideoWidget *bvw);

Returns the current volume level, as a percentage between 0 and 1.

bacon_video_widget_set_volume ()

void                bacon_video_widget_set_volume       (BaconVideoWidget *bvw,
                                                         double volume);

Sets the volume level of the stream as a percentage between 0 and 1.

If bacon_video_widget_can_set_volume() returns FALSE, this is a no-op.

bacon_video_widget_get_zoom ()

BvwZoomMode         bacon_video_widget_get_zoom         (BaconVideoWidget *bvw);

Returns the zoom mode applied to videos displayed by the widget.

bacon_video_widget_set_zoom ()

void                bacon_video_widget_set_zoom         (BaconVideoWidget *bvw,
                                                         BvwZoomMode mode);

Sets the zoom type applied to the video when it is displayed.

bacon_video_widget_has_next_track ()

gboolean            bacon_video_widget_has_next_track   (BaconVideoWidget *bvw);

Determines whether there is another track after the current one, typically as a chapter on a DVD.

bacon_video_widget_has_previous_track ()

gboolean            bacon_video_widget_has_previous_track
                                                        (BaconVideoWidget *bvw);

Determines whether there is another track before the current one, typically as a chapter on a DVD.

bacon_video_widget_is_playing ()

gboolean            bacon_video_widget_is_playing       (BaconVideoWidget *bvw);

Returns whether the widget is currently playing a stream.

bacon_video_widget_is_seekable ()

gboolean            bacon_video_widget_is_seekable      (BaconVideoWidget *bvw);

Returns whether seeking is possible in the current stream.

If no stream is loaded, FALSE is returned.

bacon_video_widget_step ()

gboolean            bacon_video_widget_step             (BaconVideoWidget *bvw,
                                                         gboolean forward,
                                                         GError **error);

Step one frame forward, if forward is TRUE, or backwards, if forward is FALSE

The "audio-output-type" property

  "audio-output-type"        BvwAudioOutputType    : Read / Write

The type of audio output to use (e.g. the number of channels).

Default value: BVW_AUDIO_SOUND_STEREO

The "auto-resize" property

  "auto-resize"              gboolean              : Read / Write

Whether to automatically resize the video widget to the video size when loading a new video.

Default value: FALSE

The "brightness" property

  "brightness"               gint                  : Read / Write

The brightness of the video display.

Allowed values: [0,65535]

Default value: 32768

The "connection-speed" property

  "connection-speed"         BvwConnectionSpeed    : Read / Write

The connection speed to use when calculating how much of a network stream to buffer.

Default value: BVW_SPEED_LAN

The "contrast" property

  "contrast"                 gint                  : Read / Write

The contrast of the video display.

Allowed values: [0,65535]

Default value: 32768

The "deinterlacing" property

  "deinterlacing"            gboolean              : Read / Write

Whether to automatically deinterlace videos.

Default value: FALSE

The "download-filename" property

  "download-filename"        gchar*                : Read / Write

The filename of the fully downloaded stream when using download buffering.

Default value: NULL

The "hue" property

  "hue"                      gint                  : Read / Write

The hue of the video display.

Allowed values: [0,65535]

Default value: 32768

The "logo-mode" property

  "logo-mode"                gboolean              : Read / Write

Whether the logo should be displayed when no stream is loaded, or the widget should take up no space.

Default value: FALSE

The "playing" property

  "playing"                  gboolean              : Read

Whether a stream is currently playing.

Default value: FALSE

The "position" property

  "position"                 gdouble               : Read

The current position in the stream, as a percentage between 0 and 1.

Allowed values: [0,1]

Default value: 0

The "referrer" property

  "referrer"                 gchar*                : Read / Write

The HTTP referrer URI.

Default value: NULL

The "saturation" property

  "saturation"               gint                  : Read / Write

The saturation of the video display.

Allowed values: [0,65535]

Default value: 32768

The "seekable" property

  "seekable"                 gboolean              : Read

Whether the current stream can be seeked.

Default value: FALSE

The "show-cursor" property

  "show-cursor"              gboolean              : Read / Write

Whether the cursor should be shown, or should be invisible, when it is over the video widget.

Default value: FALSE

The "show-visualizations" property

  "show-visualizations"      gboolean              : Write

Whether visualisations should be shown for audio-only streams.

Default value: FALSE

The "stream-length" property

  "stream-length"            gint64                : Read

The length of the current stream, in milliseconds.

Allowed values: >= 0

Default value: 0

The "user-agent" property

  "user-agent"               gchar*                : Read / Write

The HTTP user agent string to use.

Default value: NULL

The "visualization-quality" property

  "visualization-quality"    BvwVisualizationQuality  : Read / Write

The size of the visualizations to display when playing audio.

Default value: BVW_VISUALIZATION_SMALL

The "volume" property

  "volume"                   gdouble               : Read / Write

The current volume level, as a percentage between 0 and 1.

Allowed values: [0,1]

Default value: 0

The "buffering" signal

void                user_function                      (BaconVideoWidget *percentage,
                                                        gint              arg1,
                                                        gpointer          user_data)       : Run Last

Emitted regularly when a network stream is being buffered, to provide status updates on the buffering progress.

The "channels-change" signal

void                user_function                      (BaconVideoWidget *arg0,
                                                        gpointer          user_data)      : Run Last

Emitted when the number of audio languages available changes, or when the selected audio language is changed.

Query the new list of audio languages with bacon_video_widget_get_languages().

The "download-buffering" signal

void                user_function                      (BaconVideoWidget *percentage,
                                                        gdouble           arg1,
                                                        gpointer          user_data)       : Run Last

Emitted regularly when a network stream is being cached on disk, to provide status updates on the buffering level of the stream.

The "eos" signal

void                user_function                      (BaconVideoWidget *arg0,
                                                        gpointer          user_data)      : Run Last

Emitted when the end of the current stream is reached.

The "error" signal

void                user_function                      (BaconVideoWidget *message,
                                                        gchar            *playback_stopped,
                                                        gboolean          fatal,
                                                        gboolean          arg3,
                                                        gpointer          user_data)             : Run Last

Emitted when the backend wishes to asynchronously report an error. If fatal is TRUE, playback of this stream cannot be restarted.

The "got-metadata" signal

void                user_function                      (BaconVideoWidget *arg0,
                                                        gpointer          user_data)      : Run Last

Emitted when the widget has updated the metadata of the current stream. This will typically happen just after opening a stream.

Call bacon_video_widget_get_metadata() to query the updated metadata.

The "got-redirect" signal

void                user_function                      (BaconVideoWidget *new_mrl,
                                                        gchar            *arg1,
                                                        gpointer          user_data)      : Run Last

Emitted when a redirect response is received from a stream's server.

The "missing-plugins" signal

gboolean            user_function                      (BaconVideoWidget *details,
                                                        GStrv             descriptions,
                                                        GStrv             playing,
                                                        gboolean          Returns,
                                                        gpointer          user_data)         : Run Last

Emitted when plugins required to play the current stream are not found. This allows the application to request the user install them before proceeding to try and play the stream again.

Note that this signal is only available for the GStreamer backend.

The "tick" signal

void                user_function                      (BaconVideoWidget *current_time,
                                                        gint64            stream_length,
                                                        gint64            current_position,
                                                        gdouble           seekable,
                                                        gboolean          arg4,
                                                        gpointer          user_data)             : Run Last

Emitted every time an important time event happens, or at regular intervals when playing a stream.