377e95304a
overloading functions. git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@32000 a95241bf-73f2-0310-859d-f6bbb57e9c96
283 lines
7.6 KiB
C++
283 lines
7.6 KiB
C++
/*
|
|
* Copyright 2009, Haiku, Inc. All rights reserved.
|
|
* Distributed under the terms of the MIT license.
|
|
*/
|
|
#ifndef _MEDIA_TYPES_H
|
|
#define _MEDIA_TYPES_H
|
|
|
|
|
|
#include <MediaDefs.h>
|
|
|
|
#include <Messenger.h>
|
|
#include <List.h>
|
|
#include <Locker.h>
|
|
|
|
|
|
struct media_codec_info {
|
|
char pretty_name[96]; /* eg: "SuperSqueeze Encoder by Foo Inc" */
|
|
char short_name[32]; /* eg: "SuperSqueeze" */
|
|
|
|
int32 id; /* opaque id passed to
|
|
BMediaFile::CreateTrack() */
|
|
int32 sub_id;
|
|
|
|
int32 pad[63];
|
|
};
|
|
|
|
/*! \brief Use this to iterate through the available encoders for a given file
|
|
format.
|
|
\param cookie A pointer to a preallocated cookie, which you need
|
|
to initialize to \c 0 before calling this function
|
|
the first time.
|
|
\param fileFormat A pointer to a valid media_file_format structure
|
|
as can be obtained through get_next_file_format().
|
|
\param inputFormat This is the type of data given to the encoder.
|
|
\param _outputFormat This is the type of data the encoder will output.
|
|
\param _codecInfo Pointer to a preallocated media_codec_info structure,
|
|
information about the encoder is placed there.
|
|
|
|
\return
|
|
- \c B_OK: Everything went fine.
|
|
- \c B_BAD_INDEX: There are no more encoders.
|
|
*/
|
|
status_t get_next_encoder(int32* cookie, const media_file_format* fileFormat,
|
|
const media_format* inputFormat, media_format* _outputFormat,
|
|
media_codec_info* _codecInfo);
|
|
|
|
/*! \brief Use this to iterate through the available encoders with
|
|
restrictions to the input and output media_format while the
|
|
encoders can specialize wildcards in the media_formats.
|
|
|
|
\param cookie A pointer to a preallocated cookie, which you need
|
|
to initialize to \c 0 before calling this function
|
|
the first time.
|
|
\param fileFormat A pointer to a valid media_file_format structure
|
|
as can be obtained through get_next_file_format().
|
|
You can pass \c NULL if you don't care.
|
|
\param inputFormat This is the type of data given to the encoder,
|
|
wildcards are accepted.
|
|
\param outputFormat This is the type of data you want the encoder to
|
|
output. Wildcards are accepted.
|
|
\param _codecInfo Pointer to a preallocated media_codec_info structure,
|
|
information about the encoder is placed there.
|
|
\param _acceptedInputFormat This is the type of data that the encoder will
|
|
accept as input. Wildcards in \a inFormat will be
|
|
specialized here.
|
|
\param _acceptedOutputFormat This is the type of data that the encoder will
|
|
output. Wildcards in \a _outFormat will be specialized
|
|
here.
|
|
|
|
\return
|
|
- \c B_OK: Everything went fine.
|
|
- \c B_BAD_INDEX: There are no more encoders.
|
|
*/
|
|
status_t get_next_encoder(int32* cookie, const media_file_format* fileFormat,
|
|
const media_format* inputFormat, const media_format* outputFormat,
|
|
media_codec_info* _codecInfo, media_format* _acceptedInputFormat,
|
|
media_format* _acceptedOutputFormat);
|
|
|
|
|
|
/*! \brief Iterate over the all the available encoders without media_format
|
|
restrictions.
|
|
|
|
\param cookie A pointer to a preallocated cookie, which you need
|
|
to initialize to \c 0 before calling this function
|
|
the first time.
|
|
\param _codecInfo Pointer to a preallocated media_codec_info structure,
|
|
information about the encoder is placed there.
|
|
|
|
\return
|
|
- \c B_OK: Everything went fine.
|
|
- \c B_BAD_INDEX: There are no more encoders.
|
|
*/
|
|
status_t get_next_encoder(int32* cookie, media_codec_info* _codecInfo);
|
|
|
|
|
|
enum media_file_accept_format_flags {
|
|
B_MEDIA_REJECT_WILDCARDS = 0x1
|
|
};
|
|
|
|
bool does_file_accept_format(const media_file_format* fileFormat,
|
|
media_format* format, uint32 flags = 0);
|
|
|
|
|
|
typedef struct {
|
|
uint8 data[16];
|
|
} GUID;
|
|
|
|
|
|
enum beos_format {
|
|
B_BEOS_FORMAT_RAW_AUDIO = 'rawa',
|
|
B_BEOS_FORMAT_RAW_VIDEO = 'rawv'
|
|
};
|
|
|
|
|
|
typedef struct {
|
|
int32 format;
|
|
} media_beos_description;
|
|
|
|
|
|
typedef struct {
|
|
uint32 codec;
|
|
uint32 vendor;
|
|
} media_quicktime_description;
|
|
|
|
|
|
typedef struct {
|
|
uint32 codec;
|
|
} media_avi_description;
|
|
|
|
|
|
typedef struct {
|
|
uint32 id;
|
|
} media_avr_description;
|
|
|
|
|
|
typedef struct {
|
|
GUID guid;
|
|
} media_asf_description;
|
|
|
|
|
|
enum mpeg_id {
|
|
B_MPEG_ANY = 0,
|
|
B_MPEG_1_AUDIO_LAYER_1 = 0x101,
|
|
B_MPEG_1_AUDIO_LAYER_2 = 0x102,
|
|
B_MPEG_1_AUDIO_LAYER_3 = 0x103, /* "MP3" */
|
|
B_MPEG_1_VIDEO = 0x111,
|
|
B_MPEG_2_AUDIO_LAYER_1 = 0x201,
|
|
B_MPEG_2_AUDIO_LAYER_2 = 0x202,
|
|
B_MPEG_2_AUDIO_LAYER_3 = 0x203,
|
|
B_MPEG_2_VIDEO = 0x211,
|
|
B_MPEG_2_5_AUDIO_LAYER_1 = 0x301,
|
|
B_MPEG_2_5_AUDIO_LAYER_2 = 0x302,
|
|
B_MPEG_2_5_AUDIO_LAYER_3 = 0x303,
|
|
};
|
|
|
|
|
|
typedef struct {
|
|
uint32 id;
|
|
} media_mpeg_description;
|
|
|
|
|
|
typedef struct {
|
|
uint32 codec;
|
|
} media_wav_description;
|
|
|
|
|
|
typedef struct {
|
|
uint32 codec;
|
|
} media_aiff_description;
|
|
|
|
|
|
typedef struct {
|
|
uint32 file_format;
|
|
uint32 codec;
|
|
} media_misc_description;
|
|
|
|
|
|
typedef struct _media_format_description {
|
|
_media_format_description();
|
|
~_media_format_description();
|
|
_media_format_description(
|
|
const _media_format_description& other);
|
|
_media_format_description& operator=(
|
|
const _media_format_description& other);
|
|
|
|
media_format_family family;
|
|
uint32 _reserved_[3];
|
|
union {
|
|
media_beos_description beos;
|
|
media_quicktime_description quicktime;
|
|
media_avi_description avi;
|
|
media_asf_description asf;
|
|
media_mpeg_description mpeg;
|
|
media_wav_description wav;
|
|
media_aiff_description aiff;
|
|
media_misc_description misc;
|
|
media_avr_description avr;
|
|
uint32 _reserved_[12];
|
|
} u;
|
|
} media_format_description;
|
|
|
|
|
|
class BMediaFormats {
|
|
public:
|
|
BMediaFormats();
|
|
virtual ~BMediaFormats();
|
|
|
|
status_t InitCheck();
|
|
|
|
// Make sure you memset() your descs to 0 before you start filling
|
|
// them in! Else you may register some bogus value.
|
|
enum make_format_flags {
|
|
B_EXCLUSIVE = 0x1, // Fail if this format has already been
|
|
// registered.
|
|
|
|
B_NO_MERGE = 0x2, // Don't re-number any formats if there are
|
|
// multiple clashing previous registrations,
|
|
// but fail instead.
|
|
|
|
B_SET_DEFAULT = 0x4 // Set the first format to be the default for
|
|
// the format family (when registering more
|
|
// than one in the same family). Only use in
|
|
// Encoder add-ons.
|
|
};
|
|
|
|
status_t MakeFormatFor(const media_format_description*
|
|
descriptions, int32 descriptionCount,
|
|
media_format* _inOutFormat,
|
|
uint32 flags = 0, void* _reserved = 0);
|
|
|
|
status_t GetFormatFor(const media_format_description&
|
|
description, media_format* _outFormat);
|
|
|
|
status_t GetCodeFor(const media_format& format,
|
|
media_format_family family,
|
|
media_format_description* _outDescription);
|
|
|
|
status_t RewindFormats();
|
|
status_t GetNextFormat(media_format* _outFormat,
|
|
media_format_description* _outDescription);
|
|
|
|
// You need to lock/unlock (only) when using
|
|
// RewindFormats()/GetNextFormat().
|
|
bool Lock();
|
|
void Unlock();
|
|
|
|
// convenience functions
|
|
static status_t GetBeOSFormatFor(uint32 fourcc,
|
|
media_format* _outFormat,
|
|
media_type type = B_MEDIA_UNKNOWN_TYPE);
|
|
static status_t GetAVIFormatFor(uint32 fourcc,
|
|
media_format* _outFormat,
|
|
media_type type = B_MEDIA_UNKNOWN_TYPE);
|
|
static status_t GetQuicktimeFormatFor(uint32 vendor,
|
|
uint32 fourcc, media_format* _outFormat,
|
|
media_type type = B_MEDIA_UNKNOWN_TYPE);
|
|
|
|
// Deprecated:
|
|
status_t MakeFormatFor(const media_format_description&
|
|
description, const media_format& inFormat,
|
|
media_format* _outFormat);
|
|
|
|
private:
|
|
int32 fIteratorIndex;
|
|
|
|
uint32 _reserved[30];
|
|
};
|
|
|
|
|
|
bool operator==(const media_format_description& a,
|
|
const media_format_description& b);
|
|
|
|
bool operator<(const media_format_description& a,
|
|
const media_format_description& b);
|
|
|
|
|
|
bool operator==(const GUID& a, const GUID& b);
|
|
|
|
bool operator<(const GUID& a, const GUID& b);
|
|
|
|
|
|
#endif // _MEDIA_TYPES_H
|