A MediaKit producer node which mixes sound from the GameKit and sends them to the audio mixer. More...

Inherits BBufferProducer, and BMediaEventLooper.

Public Member Functions
	GameProducer (GameSoundBuffer object, const gs_audio_format format)
	Initializes the GameProducer with the passed in GameSoundBuffer and gs_audio_format.

	~GameProducer ()
	Destroys the GameProducer object and stops the BMediaEventLooper thread.

void	AdditionalBufferRequested (const media_source &source, media_buffer_id prev_buffer, bigtime_t prev_time, const media_seek_tag *prev_tag)
	Offline modes are not supported for now, does nothing.

BMediaAddOn *	AddOn (int32 *internal_id) const
	Unimplemented.

void	Connect (status_t error, const media_source &source, const media_destination &destination, const media_format &format, char *ioName)
	Connects to the output device.

void	Disconnect (const media_source &what, const media_destination &where)
	Disconnects from the output device.

status_t	DisposeOutputCookie (int32 cookie)
	Does nothing because the cookie has no use as of yet.

void	EnableOutput (const media_source &what, bool enabled, int32 *_deprecated_)
	Enable or disable an output.

status_t	FormatChangeRequested (const media_source &source, const media_destination &destination, media_format io_format, int32 _deprecated_)
	We don't support any other formats, so we just reject any format changes.

status_t	FormatProposal (const media_source &output, media_format *format)
	Attempts to change the media format.

status_t	FormatSuggestionRequested (media_type type, int32 quality, media_format *format)
	Checks if a certain media format works with the GameProducer.

status_t	GetLatency (bigtime_t *_latency)
	Gets the total latency, including internal downstream plus scheduling.

status_t	GetNextOutput (int32 cookie, media_output _output)
	Gets the next output cookie.

void	HandleEvent (const media_timed_event *event, bigtime_t lateness, bool realTimeEvent=false)
	Handles when an event is triggered.

status_t	HandleMessage (int32 message, const void *data, size_t size)
	Private messages are not supported, returns `B_ERROR`.

void	LatencyChanged (const media_source &source, const media_destination &destination, bigtime_t new_latency, uint32 flags)
	Sets the event latency in the case that the latency changed.

void	LateNoticeReceived (const media_source &what, bigtime_t howMuch, bigtime_t performanceDuration)
	Attempts to catch up to the buffer.

void	NodeRegistered ()
	Handles when an output source node is registered.

status_t	PrepareToConnect (const media_source &what, const media_destination &where, media_format format, media_source _source, char *out_name)
	Confirms that the media format and wild cards are valid.

status_t	SetBufferGroup (const media_source &forSource, BBufferGroup *group)
	Changes the buffer group from the current one, to the specified one.

status_t	SetPlayRate (int32 numerator, int32 denominator)
	Play rates are not supported, returns `B_ERROR`.

void	SetRunMode (run_mode mode)
	Offline mode is not supported.

Detailed Description

A MediaKit producer node which mixes sound from the GameKit and sends them to the audio mixer.

Since: Haiku R1

Constructor & Destructor Documentation

◆ GameProducer()

GameProducer::GameProducer	(	GameSoundBuffer *	object,
		const gs_audio_format *	format
	)

Initializes the GameProducer with the passed in GameSoundBuffer and gs_audio_format.

Parameters

object	The GameSoundBuffer to 'sync' the GameProducer with.
format	The gs_audio_format to set the GameProducer's format.

Since: Haiku R1

◆ ~GameProducer()

GameProducer::~GameProducer ( )

Destroys the GameProducer object and stops the BMediaEventLooper thread.

Since: Haiku R1

Member Function Documentation

◆ AdditionalBufferRequested()

void GameProducer::AdditionalBufferRequested	(	const media_source &	source,
		media_buffer_id	prev_buffer,
		bigtime_t	prev_time,
		const media_seek_tag *	prev_tag
	)

Offline modes are not supported for now, does nothing.

Parameters

source	The media output source.
prev_buffer	The previous buffer.
prev_time	The previous buffer time.
prev_tag	The previous buffer delimiter.

Since: Haiku R1

◆ AddOn()

BMediaAddOn * GameProducer::AddOn ( int32 * internal_id ) const

virtual

Unimplemented.

Since: Haiku R1

Implements BMediaNode.

◆ Connect()

void GameProducer::Connect	(	status_t	error,
		const media_source &	source,
		const media_destination &	destination,
		const media_format &	format,
		char *	ioName
	)

Connects to the output device.

Parameters

error	The variable that holds an error, should one arise.
source	The output source to connect to.
destination	The media destination, that is connected to.
format	The variable that holds the format type.
ioName	The variable that holds the output name.

◆ Disconnect()

void GameProducer::Disconnect	(	const media_source &	what,
		const media_destination &	where
	)

Disconnects from the output device.

Parameters

what	The media destination.
where	The media's output source.

Since: Haiku R1

◆ DisposeOutputCookie()

status_t GameProducer::DisposeOutputCookie ( int32 cookie )

Does nothing because the cookie has no use as of yet.

Parameters

cookie The cookie index.

Returns: Always returns B_OK.

Since: Haiku R1

◆ EnableOutput()

void GameProducer::EnableOutput	(	const media_source &	what,
		bool	enabled,
		int32 *	_deprecated_
	)

Enable or disable an output.

Attention: This method is deprecated.

Parameters

what	The media output source.
enabled	Sets the output to enabled or disabled.
_deprecated_	This method is deprecated.

Since: Haiku R1

◆ FormatChangeRequested()

status_t GameProducer::FormatChangeRequested	(	const media_source &	source,
		const media_destination &	destination,
		media_format *	io_format,
		int32 *	_deprecated_
	)

We don't support any other formats, so we just reject any format changes.

Attention: This method is deprecated.

Parameters

source	The output source.
destination	The media's destination.
io_format	The format of the media
_deprecated_	This method is deprecated.

Returns: B_ERROR as this function is deprecated, it has been removed, and now only returns B_ERROR.

Since: Haiku R1

◆ FormatProposal()

status_t GameProducer::FormatProposal	(	const media_source &	output,
		media_format *	format
	)

Attempts to change the media format.

Warning: Only supports raw audio and wildcard audio types.

Parameters

output	The source that the media outputs to.
format	The type of media being proposed.

Returns: A status code.

Return values

B_OK	The format is supported.
B_MEDIA_BAD_SOURCE	The output doesn't match the current output source.
B_MEDIA_BAD_FORMAT	The format is not supported.

Since: Haiku R1

◆ FormatSuggestionRequested()

status_t GameProducer::FormatSuggestionRequested	(	media_type	type,
		int32	quality,
		media_format *	format
	)

Checks if a certain media format works with the GameProducer.

Warning: Only supports raw audio at this point.

Parameters

type	The media format being tested.
quality	The quality of the media – Not used in the method.
format	The media format to send through.

Returns: A status code.

Return values

B_OK	type is supported.
B_BAD_VALUE	No format was received.
B_MEDIA_BAD_FORMAT	The format is not supported.

Since: Haiku R1

◆ GetLatency()

status_t GameProducer::GetLatency ( bigtime_t * _latency )

Gets the total latency, including internal downstream plus scheduling.

Parameters

_latency Gets set to the current latency.

Returns: B_OK.

Since: Haiku R1

◆ GetNextOutput()

status_t GameProducer::GetNextOutput	(	int32 *	cookie,
		media_output *	_output
	)

Gets the next output cookie.

Cookie can only be zero, as GameProducer supports one output.

Parameters

cookie	The output cookie value.
_output	The output that the cookie represents.

Returns: A status code.

Return values

B_OK	The cookie was successfully incremented.
B_BAD_INDEX	The cookie is not equal to zero.

Since: Haiku R1

◆ HandleEvent()

void GameProducer::HandleEvent	(	const media_timed_event *	event,
		bigtime_t	lateness,
		bool	realTimeEvent = `false`
	)

virtual

Handles when an event is triggered.

Parameters

event	The type of event.
lateness	Unused.
realTimeEvent	Unused.

Since: Haiku R1

Implements BMediaEventLooper.

◆ HandleMessage()

status_t GameProducer::HandleMessage	(	int32	message,
		const void *	data,
		size_t	size
	)

virtual

Private messages are not supported, returns B_ERROR.

Parameters

message	The message to be sent.
data	The data to be sent.
size	The size of the message.

Returns: Always returns B_ERROR since private messages aren't supported.

Since: Haiku R1

Reimplemented from BMediaNode.

◆ LatencyChanged()

void GameProducer::LatencyChanged	(	const media_source &	source,
		const media_destination &	destination,
		bigtime_t	new_latency,
		uint32	flags
	)

Sets the event latency in the case that the latency changed.

Parameters

source	The media output source.
destination	The connected output destination.
new_latency	The new amount of latency.
flags	Unused.

Since: Haiku R1

◆ LateNoticeReceived()

void GameProducer::LateNoticeReceived	(	const media_source &	what,
		bigtime_t	howMuch,
		bigtime_t	performanceDuration
	)

Attempts to catch up to the buffer.

Parameters

what	The media output source.
howMuch	The amount of 'lateness'.
performanceDuration	Unused.

Since: Haiku R1

◆ NodeRegistered()

void GameProducer::NodeRegistered ( )

virtual

Handles when an output source node is registered.

Since: Haiku R1

Reimplemented from BMediaEventLooper.

◆ PrepareToConnect()

status_t GameProducer::PrepareToConnect	(	const media_source &	what,
		const media_destination &	where,
		media_format *	format,
		media_source *	_source,
		char *	out_name
	)

Confirms that the media format and wild cards are valid.

Parameters

what	The media source to output to.
where	The destination for the connection.
format	The format to finish specializing.
_source	The output source that the method retrieves.
out_name	The variable that holds the output name.

Returns: A status code.

Return values

B_OK	The connection preparations have finished.
B_MEDIA_BAD_SOURCE	The output doesn't match the current output source.
B_MEDIA_ALREADY_CONNECTED	The GameProducer is already connected.
B_MEDIA_BAD_FORMAT	The format is not supported.

Since: Haiku R1

◆ SetBufferGroup()

status_t GameProducer::SetBufferGroup	(	const media_source &	forSource,
		BBufferGroup *	newGroup
	)

Changes the buffer group from the current one, to the specified one.

Parameters

forSource	The output source. Can't be equivalent to the current output source.
newGroup	The new BBufferGroup to assign the buffer group to.

Returns: A status code.

Return values

B_OK	The change has succeeded.
B_MEDIA_BAD_SOURCE	forSource is equal to the current output source.
B_BAD_VALUE	The new BBufferGroup's buffer list returns an error.

Since: Haiku R1

◆ SetPlayRate()

status_t GameProducer::SetPlayRate	(	int32	numerator,
		int32	denominator
	)

Play rates are not supported, returns B_ERROR.

Parameters

numerator	The top part of the fraction.
denominator	The bottom part of the fraction.

Returns: Always returns B_ERROR since play rates aren't supported.

Since: Haiku R1

◆ SetRunMode()

void GameProducer::SetRunMode ( run_mode mode )

virtual

Offline mode is not supported.

Parameters

mode	The mode of running.

Since: Haiku R1

Reimplemented from BMediaEventLooper.

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ GameProducer()

◆ ~GameProducer()

Member Function Documentation

◆ AdditionalBufferRequested()

◆ AddOn()

◆ Connect()

◆ Disconnect()

◆ DisposeOutputCookie()

◆ EnableOutput()

◆ FormatChangeRequested()

◆ FormatProposal()

◆ FormatSuggestionRequested()

◆ GetLatency()

◆ GetNextOutput()

◆ HandleEvent()

◆ HandleMessage()

◆ LatencyChanged()

◆ LateNoticeReceived()

◆ NodeRegistered()

◆ PrepareToConnect()

◆ SetBufferGroup()

◆ SetPlayRate()

◆ SetRunMode()