Collaboration diagram for Audio output control:

Data Structures
struct	vlc_player_aout_cbs
	Player aout callbacks. More...

Typedefs
typedef struct vlc_player_aout_listener_id	vlc_player_aout_listener_id
	Player aout listener opaque structure. More...

Functions
audio_output_t *	vlc_player_aout_Hold (vlc_player_t *player)
	Get the audio output. More...

void	vlc_player_aout_Reset (vlc_player_t *player)
	Reset the main audio output. More...

vlc_player_aout_listener_id *	vlc_player_aout_AddListener (vlc_player_t player, const struct vlc_player_aout_cbs cbs, void *cbs_data)
	Add a listener callback for audio output events. More...

void	vlc_player_aout_RemoveListener (vlc_player_t player, vlc_player_aout_listener_id listener_id)
	Remove a aout listener callback. More...

float	vlc_player_aout_GetVolume (vlc_player_t *player)
	Get the audio volume. More...

int	vlc_player_aout_SetVolume (vlc_player_t *player, float volume)
	Set the audio volume. More...

int	vlc_player_aout_IncrementVolume (vlc_player_t player, int steps, float result)
	Increment the audio volume. More...

static int	vlc_player_aout_DecrementVolume (vlc_player_t player, int steps, float result)
	Helper to decrement the audio volume. More...

int	vlc_player_aout_IsMuted (vlc_player_t *player)
	Check if the audio output is muted. More...

int	vlc_player_aout_Mute (vlc_player_t *player, bool mute)
	Mute or unmute the audio output. More...

static int	vlc_player_aout_ToggleMute (vlc_player_t *player)
	Helper to toggle the mute state. More...

int	vlc_player_aout_EnableFilter (vlc_player_t player, const char name, bool add)
	Enable or disable an audio filter. More...

Detailed Description

Typedef Documentation

◆ vlc_player_aout_listener_id

typedef struct vlc_player_aout_listener_id vlc_player_aout_listener_id

Player aout listener opaque structure.

This opaque structure is returned by vlc_player_aout_AddListener() and can be used to remove the listener via vlc_player_aout_RemoveListener().

Function Documentation

◆ vlc_player_aout_AddListener()

vlc_player_aout_listener_id * vlc_player_aout_AddListener	(	vlc_player_t *	player,
		const struct vlc_player_aout_cbs *	cbs,
		void *	cbs_data
	)

Add a listener callback for audio output events.

Note: The player instance doesn't need to be locked for vlc_player_aout_*() functions.; Every registered callbacks need to be removed by the caller with vlc_player_aout_RemoveListener().

Parameters

player	player instance
cbs	pointer to a vlc_player_aout_cbs structure, the structure must be valid during the lifetime of the player
cbs_data	opaque pointer used by the callbacks

Returns: a valid listener id, or NULL in case of allocation error

References vlc_player_t::aout_listeners, vlc_player_t::aout_listeners_lock, vlc_player_aout_listener_id::cbs, vlc_player_aout_listener_id::cbs_data, vlc_player_aout_listener_id::node, vlc_list_append(), vlc_mutex_lock(), and vlc_mutex_unlock().

◆ vlc_player_aout_DecrementVolume()

static int vlc_player_aout_DecrementVolume	(	vlc_player_t *	player,
		int	steps,
		float *	result
	)

inlinestatic

Helper to decrement the audio volume.

References vlc_player_aout_IncrementVolume().

◆ vlc_player_aout_EnableFilter()

int vlc_player_aout_EnableFilter	(	vlc_player_t *	player,
		const char *	name,
		bool	add
	)

Enable or disable an audio filter.

See also: aout_EnableFilter()

Returns: VLC_SUCCESS or VLC_EGENERIC if there is no audio outputs

References aout_EnableFilter(), aout_Release(), name, and vlc_player_aout_Hold().

◆ vlc_player_aout_GetVolume()

float vlc_player_aout_GetVolume ( vlc_player_t * player )

Get the audio volume.

Note: The player instance doesn't need to be locked for vlc_player_aout_*() functions.

See also: vlc_player_aout_cbs.on_volume_changed

Parameters

player player instance

Returns: volume in the range [0;2.f] or -1.f if there is no audio outputs (independent of mute)

References aout_Release(), aout_VolumeGet(), and vlc_player_aout_Hold().

Referenced by vlc_player_osd_Volume().

◆ vlc_player_aout_Hold()

audio_output_t * vlc_player_aout_Hold ( vlc_player_t * player )

Get the audio output.

Warning: The returned pointer must be released with aout_Release().

Parameters

player player instance

Returns: a valid audio_output_t * or NULL (if there is no aouts)

References input_resource_HoldAout(), and vlc_player_t::resource.

Referenced by vlc_player_AddMetadataLoudnessListener(), vlc_player_aout_AddCallbacks(), vlc_player_aout_DelCallbacks(), vlc_player_aout_EnableFilter(), vlc_player_aout_GetVolume(), vlc_player_aout_IncrementVolume(), vlc_player_aout_IsMuted(), vlc_player_aout_Mute(), vlc_player_aout_SetVolume(), vlc_player_RemoveMetadataLoudnessListener(), and vlc_strfplayer().

◆ vlc_player_aout_IncrementVolume()

int vlc_player_aout_IncrementVolume	(	vlc_player_t *	player,
		int	steps,
		float *	result
	)

Increment the audio volume.

See also: vlc_player_aout_SetVolume()

Parameters

player	player instance
steps	number of "volume-step"
result	pointer to store the resulting volume (can be NULL)

Returns: VLC_SUCCESS or VLC_EGENERIC if there is no audio outputs

References aout_Release(), aout_VolumeUpdate(), and vlc_player_aout_Hold().

Referenced by vlc_player_aout_DecrementVolume().

◆ vlc_player_aout_IsMuted()

int vlc_player_aout_IsMuted ( vlc_player_t * player )

Check if the audio output is muted.

Note: The player instance doesn't need to be locked for vlc_player_aout_*() functions.

See also: vlc_player_aout_cbs.on_mute_changed

Parameters

player player instance

Returns: 0 if not muted, 1 if muted, -1 if there is no audio outputs

References aout_MuteGet(), aout_Release(), and vlc_player_aout_Hold().

Referenced by vlc_player_aout_ToggleMute(), and vlc_player_osd_Volume().

◆ vlc_player_aout_Mute()

int vlc_player_aout_Mute	(	vlc_player_t *	player,
		bool	mute
	)

Mute or unmute the audio output.

Note: The player instance doesn't need to be locked for vlc_player_aout_*() functions.; A successful call will trigger the vlc_player_aout_cbs.on_mute_changed event.

Parameters

player	player instance
mute	true to mute

Returns: VLC_SUCCESS or VLC_EGENERIC if there is no audio outputs

References aout_MuteSet(), aout_Release(), and vlc_player_aout_Hold().

Referenced by vlc_player_aout_ToggleMute().

◆ vlc_player_aout_RemoveListener()

void vlc_player_aout_RemoveListener	(	vlc_player_t *	player,
		vlc_player_aout_listener_id *	listener_id
	)

Remove a aout listener callback.

Parameters

player	player instance
listener_id	listener id returned by vlc_player_aout_AddListener()

References vlc_player_t::aout_listeners_lock, vlc_player_aout_listener_id::node, vlc_list_remove(), vlc_mutex_lock(), and vlc_mutex_unlock().

◆ vlc_player_aout_Reset()

void vlc_player_aout_Reset ( vlc_player_t * player )

Reset the main audio output.

Warning: The main aout can only by reset if it is not currently used by any decoders (before any play).

Parameters

player player instance

References input_resource_ResetAout(), vlc_player_t::resource, vlc_player_aout_Deinit(), and vlc_player_aout_Init().

◆ vlc_player_aout_SetVolume()

int vlc_player_aout_SetVolume	(	vlc_player_t *	player,
		float	volume
	)

Set the audio volume.

Note: The player instance doesn't need to be locked for vlc_player_aout_*() functions.; A successful call will trigger the vlc_player_vout_cbs.on_volume_changed event.

Parameters

player	player instance
volume	volume in the range [0;2.f]

Returns: VLC_SUCCESS or VLC_EGENERIC if there is no audio outputs

References aout_Release(), aout_VolumeSet(), and vlc_player_aout_Hold().

◆ vlc_player_aout_ToggleMute()

static int vlc_player_aout_ToggleMute ( vlc_player_t * player )

inlinestatic

Helper to toggle the mute state.

References vlc_player_aout_IsMuted(), and vlc_player_aout_Mute().

Data Structures

Typedefs

Functions

Detailed Description

Typedef Documentation

◆ vlc_player_aout_listener_id

Function Documentation

◆ vlc_player_aout_AddListener()

◆ vlc_player_aout_DecrementVolume()

◆ vlc_player_aout_EnableFilter()

◆ vlc_player_aout_GetVolume()

◆ vlc_player_aout_Hold()

◆ vlc_player_aout_IncrementVolume()

◆ vlc_player_aout_IsMuted()

◆ vlc_player_aout_Mute()

◆ vlc_player_aout_RemoveListener()

◆ vlc_player_aout_Reset()

◆ vlc_player_aout_SetVolume()

◆ vlc_player_aout_ToggleMute()