* Rewrote Buffer.h, and BufferConsumer.h, that's enough for a day :-)

git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@32583 a95241bf-73f2-0310-859d-f6bbb57e9c96
This commit is contained in:
Axel Dörfler
2009-08-21 20:21:45 +00:00
parent 3580aefbfe
commit 7c26f9d16d
2 changed files with 200 additions and 268 deletions
+37 -49
View File
@@ -1,83 +1,74 @@
/******************************************************************************* /*
/ * Copyright 2009, Haiku Inc. All Rights Reserved.
/ File: Buffer.h * Distributed under the terms of the MIT License.
/ */
/ Description: A BBuffer is a container of media data in the Media Kit #ifndef _BUFFER_H
/
/ Copyright 1997-98, Be Incorporated, All Rights Reserved
/
*******************************************************************************/
#if !defined(_BUFFER_H)
#define _BUFFER_H #define _BUFFER_H
#include <MediaDefs.h> #include <MediaDefs.h>
/*** A BBuffer is not the same thing as the area segment that gets cloned ***/
/*** For each buffer that gets created, a BBuffer object is created to represent ***/
/*** it in each participant address space. ***/
struct _shared_buffer_list; struct _shared_buffer_list;
struct buffer_clone_info { struct buffer_clone_info {
buffer_clone_info(); buffer_clone_info();
~buffer_clone_info(); ~buffer_clone_info();
media_buffer_id buffer; media_buffer_id buffer;
area_id area; area_id area;
size_t offset; size_t offset;
size_t size; size_t size;
int32 flags; int32 flags;
private: private:
uint32 _reserved_[4]; uint32 _reserved_[4];
}; };
class BBuffer class BBuffer {
{
public: public:
// flags
void * Data(); /* returns NULL if buffer not correctly initialized */ enum {
size_t SizeAvailable(); // total size of buffer (how much data can it hold)
size_t SizeUsed(); // how much was written (how much data does it hold)
void SetSizeUsed(
size_t size_used);
uint32 Flags();
void Recycle();
buffer_clone_info CloneInfo() const;
media_buffer_id ID(); /* 0 if not registered */
media_type Type();
media_header * Header();
media_audio_header * AudioHeader();
media_video_header * VideoHeader();
enum { /* for flags */
B_F1_BUFFER = 0x1, B_F1_BUFFER = 0x1,
B_F2_BUFFER = 0x2, B_F2_BUFFER = 0x2,
B_SMALL_BUFFER = 0x80000000 B_SMALL_BUFFER = 0x80000000
}; };
size_t Size(); // deprecated; use SizeAvailable() void* Data();
size_t SizeAvailable();
size_t SizeUsed();
void SetSizeUsed(size_t used);
uint32 Flags();
void Recycle();
buffer_clone_info CloneInfo() const;
media_buffer_id ID();
media_type Type();
media_header* Header();
media_audio_header* AudioHeader();
media_video_header* VideoHeader();
size_t Size();
private: private:
friend struct _buffer_id_cache; friend struct _buffer_id_cache;
friend struct _shared_buffer_list; friend struct _shared_buffer_list;
friend class BMediaRoster; friend class BMediaRoster;
friend class BBufferProducer; friend class BBufferProducer;
friend class BBufferConsumer; /* for buffer receiving */ friend class BBufferConsumer;
friend class BBufferGroup; friend class BBufferGroup;
friend class BSmallBuffer; friend class BSmallBuffer;
explicit BBuffer(const buffer_clone_info& info); explicit BBuffer(const buffer_clone_info& info);
~BBuffer(); /* BBuffer is NOT a virtual class!!! */ ~BBuffer();
BBuffer(); /* not implemented */ BBuffer();
BBuffer(const BBuffer & clone); /* not implemented */ BBuffer(const BBuffer& other);
BBuffer & operator=(const BBuffer & clone); /* not implemented */ BBuffer& operator=(const BBuffer& other);
// not implemented
void SetHeader(const media_header* header); void SetHeader(const media_header* header);
@@ -90,19 +81,16 @@ private:
media_buffer_id fBufferID; media_buffer_id fBufferID;
int32 fFlags; int32 fFlags;
uint32 _reserved_buffer_[11]; uint32 _reserved[11];
}; };
class BSmallBuffer : public BBuffer class BSmallBuffer : public BBuffer {
{
public: public:
BSmallBuffer(); BSmallBuffer();
static size_t SmallBufferSizeLimit(); static size_t SmallBufferSizeLimit();
}; };
#endif /* _BUFFER_H */
#endif // _BUFFER_H
+86 -142
View File
@@ -1,184 +1,134 @@
/******************************************************************************* /*
/ * Copyright 2009, Haiku Inc. All Rights Reserved.
/ File: BufferConsumer.h * Distributed under the terms of the MIT License.
/ */
/ Description: A BBufferConsumer is anything that wants to receive buffers in the Media Kit #ifndef _BUFFER_CONSUMER_H
/
/ Copyright 1997-98, Be Incorporated, All Rights Reserved
/
*******************************************************************************/
#if !defined(_BUFFER_CONSUMER_H)
#define _BUFFER_CONSUMER_H #define _BUFFER_CONSUMER_H
#include <MediaDefs.h> #include <MediaDefs.h>
#include <MediaNode.h> #include <MediaNode.h>
class BBuffer; class BBuffer;
class BBufferGroup; class BBufferGroup;
class BRegion; class BRegion;
namespace BPrivate { namespace media {
class BMediaRosterEx;
}}
class _buffer_id_cache; class _buffer_id_cache;
class BBufferConsumer : namespace BPrivate {
public virtual BMediaNode namespace media {
{ class BMediaRosterEx;
}
}
class BBufferConsumer : public virtual BMediaNode {
protected: protected:
/* this has to be at the top to force a vtable */
virtual ~BBufferConsumer(); virtual ~BBufferConsumer();
public: public:
media_type ConsumerType(); media_type ConsumerType();
/* for encoding a region into the format needed for clipping requests */ static status_t RegionToClipData(const BRegion* region,
static status_t RegionToClipData( int32* format, int32* size, void* data);
const BRegion * region,
int32 * format,
int32 * ioSize,
void * data);
protected: protected:
explicit BBufferConsumer( explicit BBufferConsumer(media_type type);
media_type consumer_type /* = B_MEDIA_UNKNOWN_TYPE */);
static void NotifyLateProducer( static void NotifyLateProducer(
const media_source & what_source, const media_source& whatSource,
bigtime_t how_much, bigtime_t howMuch,
bigtime_t performance_time); bigtime_t performanceTime);
status_t SetVideoClippingFor( status_t SetVideoClippingFor(const media_source& output,
const media_source & output,
const media_destination& destination, const media_destination& destination,
const int16 * shorts, const int16* shorts, int32 shortCount,
int32 short_count,
const media_video_display_info& display, const media_video_display_info& display,
void * user_data, void* userData, int32* changeTag,
int32 * change_tag,
void * _reserved_ = 0); // change_tag value will be passed to RequestCompleted()
status_t SetOutputEnabled(
const media_source & source,
const media_destination & destination,
bool enabled,
void * user_data,
int32 * change_tag,
void * _reserved_ = 0); // change_tag value will be passed to RequestCompleted()
status_t RequestFormatChange(
const media_source & source,
const media_destination & destination,
const media_format & to_format,
void * user_data,
int32 * change_tag,
void * _reserved_ = 0); // change_tag value will be passed to RequestCompleted()
status_t RequestAdditionalBuffer( // new in 4.1
const media_source & source,
BBuffer * prev_buffer,
void* _reserved = NULL); void* _reserved = NULL);
status_t RequestAdditionalBuffer( // new in 4.1 status_t SetOutputEnabled(const media_source& source,
const media_source & source, const media_destination& destination,
bigtime_t start_time, bool enabled, void* userData,
int32* changeTag, void* _reserved = NULL);
status_t RequestFormatChange(const media_source& source,
const media_destination& destination,
const media_format& toFormat,
void* userData, int32* changeTag,
void* _reserved = NULL); void* _reserved = NULL);
status_t SetOutputBuffersFor( // new in 4.1 status_t RequestAdditionalBuffer(
const media_source& source, const media_source& source,
const media_destination & destination, BBuffer* previousBuffer,
BBufferGroup * group, void* _reserved = NULL);
void * user_data, status_t RequestAdditionalBuffer(
int32 * change_tag, // passed to RequestCompleted()
bool will_reclaim = false,
void * _reserved_ = 0);
status_t SendLatencyChange(
const media_source& source, const media_source& source,
bigtime_t startTime,
void* _reserved = NULL);
status_t SetOutputBuffersFor(const media_source& source,
const media_destination& destination, const media_destination& destination,
bigtime_t my_new_latency, BBufferGroup* group, void* userData,
uint32 flags = 0); int32* changeTag, bool willReclaim = false,
void* _reserved = NULL);
status_t SendLatencyChange(const media_source& source,
const media_destination& destination,
bigtime_t newLatency, uint32 flags = 0);
protected: protected:
virtual status_t HandleMessage(int32 message, const void* data,
virtual status_t HandleMessage(
int32 message,
const void * data,
size_t size); size_t size);
/* Someone, probably the producer, is asking you about this format. Give */
/* your honest opinion, possibly modifying *format. Do not ask upstream */
/* producer about the format, since he's synchronously waiting for your */
/* reply. */
virtual status_t AcceptFormat( virtual status_t AcceptFormat(
const media_destination & dest, const media_destination& destination,
media_format * ioFormat) = 0; media_format* format) = 0;
virtual status_t GetNextInput( virtual status_t GetNextInput(int32* cookie,
int32 * cookie, media_input* _input) = 0;
media_input * out_input) = 0; virtual void DisposeInputCookie(int32 cookie) = 0;
virtual void DisposeInputCookie( virtual void BufferReceived(BBuffer* buffer) = 0;
int32 cookie) = 0;
virtual void BufferReceived(
BBuffer * buffer) = 0;
virtual void ProducerDataStatus( virtual void ProducerDataStatus(
const media_destination & for_whom, const media_destination& forWhom,
int32 status, int32 status,
bigtime_t at_performance_time) = 0; bigtime_t atPerformanceTime) = 0;
virtual status_t GetLatencyFor( virtual status_t GetLatencyFor(const media_destination& forWhom,
const media_destination & for_whom, bigtime_t* _latency,
bigtime_t * out_latency, media_node_id* _timesource) = 0;
media_node_id * out_timesource) = 0; virtual status_t Connected(const media_source& producer,
virtual status_t Connected(
const media_source & producer, /* here's a good place to request buffer group usage */
const media_destination& where, const media_destination& where,
const media_format & with_format, const media_format& withFormat,
media_input * out_input) = 0; media_input* _input) = 0;
virtual void Disconnected( virtual void Disconnected(const media_source& producer,
const media_source & producer,
const media_destination& where) = 0; const media_destination& where) = 0;
/* The notification comes from the upstream producer, so he's already cool with */ virtual status_t FormatChanged(const media_source& producer,
/* the format; you should not ask him about it in here. */
virtual status_t FormatChanged(
const media_source & producer,
const media_destination& consumer, const media_destination& consumer,
int32 change_tag, int32 changeTag,
const media_format& format) = 0; const media_format& format) = 0;
/* Given a performance time of some previous buffer, retrieve the remembered tag */
/* of the closest (previous or exact) performance time. Set *out_flags to 0; the */
/* idea being that flags can be added later, and the understood flags returned in */
/* *out_flags. */
virtual status_t SeekTagRequested( virtual status_t SeekTagRequested(
const media_destination& destination, const media_destination& destination,
bigtime_t in_target_time, bigtime_t targetTime, uint32 flags,
uint32 in_flags, media_seek_tag* _seekTag,
media_seek_tag * out_seek_tag, bigtime_t* _taggedTime, uint32* _flags);
bigtime_t * out_tagged_time,
uint32 * out_flags);
private: private:
friend class BMediaNode;
friend class BBufferProducer;
friend class BMediaRoster;
friend class BPrivate::media::BMediaRosterEx;
BBufferConsumer(); /* private unimplemented */ BBufferConsumer();
BBufferConsumer( BBufferConsumer(const BBufferConsumer& other);
const BBufferConsumer & clone); BBufferConsumer& operator=(const BBufferConsumer& other);
BBufferConsumer & operator=(
const BBufferConsumer & clone);
// these functions are deprecated from the 4.0 API // deprecated methods following
static status_t SetVideoClippingFor( static status_t SetVideoClippingFor(const media_source& output,
const media_source & output, const int16* shorts, int32 shortCount,
const int16 * shorts,
int32 short_count,
const media_video_display_info& display, const media_video_display_info& display,
int32 * change_tag); // change_tag value will be passed to RequestCompleted() int32* changeTag);
static status_t RequestFormatChange( static status_t RequestFormatChange(const media_source& source,
const media_source & source,
const media_destination& destination, const media_destination& destination,
media_format * io_to_format, // the "o" part is unused from 4.1 media_format* toFormat, int32* changeTag);
int32 * change_tag); // change_tag value will be passed to RequestCompleted() static status_t SetOutputEnabled(const media_source& source,
static status_t SetOutputEnabled( bool enabled, int32* changeTag);
const media_source & source,
bool enabled,
int32 * change_tag); // change_tag value will be passed to RequestCompleted()
/* Mmmh, stuffing! */ status_t _Reserved_BufferConsumer_0(void*);
status_t _Reserved_BufferConsumer_0(void *); /* SeekTagRequested */ // used for SeekTagRequested()
virtual status_t _Reserved_BufferConsumer_1(void*); virtual status_t _Reserved_BufferConsumer_1(void*);
virtual status_t _Reserved_BufferConsumer_2(void*); virtual status_t _Reserved_BufferConsumer_2(void*);
virtual status_t _Reserved_BufferConsumer_3(void*); virtual status_t _Reserved_BufferConsumer_3(void*);
@@ -195,18 +145,12 @@ virtual status_t _Reserved_BufferConsumer_13(void *);
virtual status_t _Reserved_BufferConsumer_14(void*); virtual status_t _Reserved_BufferConsumer_14(void*);
virtual status_t _Reserved_BufferConsumer_15(void*); virtual status_t _Reserved_BufferConsumer_15(void*);
friend class BMediaNode; private:
friend class BBufferProducer;
friend class BMediaRoster;
friend class BPrivate::media::BMediaRosterEx;
media_type fConsumerType; media_type fConsumerType;
_buffer_id_cache* fBufferCache; _buffer_id_cache* fBufferCache;
BBufferGroup* fDeleteBufferGroup; BBufferGroup* fDeleteBufferGroup;
uint32 _reserved_buffer_consumer_[14]; uint32 _reserved[14];
}; };
#endif /* _BUFFER_CONSUMER_H */ #endif // _BUFFER_CONSUMER_H