QMatroskaAPI - QTheora - Theora Decoder Library Wiki - QTheora - Theora Decoder Library

QMatroska Core API 仕様

QMatroska は、Matroska コンテナのリーダーライブラリである。

リーダー

 struct QM_TrackVideo {
 
         INT32  PixelWidth;
         INT32  PixelHeight;
         DOUBLE FrameRate;
 
 }; /* QM_TrackVideo */
 
 typedef struct QM_TrackVideo QM_TrackVideo_t;
 
 struct QM_TrackAudio {
 
         DOUBLE SamplingFrequency;
         INT32  Channels;
         INT32  BitDepth;
 
 }; /* QM_TrackAudio */
 
 typedef struct QM_TrackAudio QM_TrackAudio_t;
 
 struct QM_Track {
 
         INT32 TrackNo;
         INT32 TrackType;
         INT32 TrackLacing;
 
         const char* CodecId;
 
         INT64 TrackDuration;
 
         const QM_TrackVideo_t* Video;
         const QM_TrackAudio_t* Audio;
 
         const VOID* CodecPrivate;
         INT32       CodecPrivateSize;
 
 }; /* QM_Track */
 
 typedef struct QM_Track QM_Track_t;
 
 /* */
 
 struct QM_QuePoint {
 
         INT64 CueTime;
 
         INT32 TrackNo;
         INT64 ClusterPos;
 
 }; /* QM_QuePoint */
 
 typedef struct QM_QuePoint QM_QuePoint_t;
 
 /* */
 
 #define QM_FLAGS_KEYFRAME 0x80
 
 struct QM_Block {
 
         INT64 ClusterTime;
 
         INT32 Duration;
         INT32 Reference;
 
         INT32 TrackNo;
         INT32 TimeDelta;
 
         INT32 Flags;
 
         const VOID* Payload;
         INT32       Size;
 
 }; /* QM_Block */
 
 typedef struct QM_Block QM_Block_t;
 
 /* */
 
 struct QM_Frame {
 
         const VOID* Payload;
         INT32       Size;
 
 }; /* QM_Frame */
 
 typedef struct QM_Frame QM_Frame_t;
 
 /* */
 
 struct QM_Reader;
 
 typedef struct QM_Reader QM_Reader_t;
 
 QM_Reader_t* QM_CreateReader(void);
 
 void QM_ReleaseReader(QM_Reader_t* t);
 
 BOOL QM_OpenReader(
         QM_Reader_t* t,
         const WCHAR* path);
 
 BOOL QM_OpenReader_IStream(
         QM_Reader_t* t,
         IStream*     p);
 
 INT64 QM_GetTimeCodeScale(
         QM_Reader_t* t);
 
 DOUBLE QM_GetDuraion(
         QM_Reader_t* t);
 
 INT32 QM_GetTrackCount(
         QM_Reader_t* t);
 
 const QM_Track_t* QM_GetTracks(
         QM_Reader_t* t);
 
 INT32 QM_ReadBlock(
         QM_Reader_t* t,
         QM_Block_t*  block);
 
 BOOL QM_SeekCluster(
         QM_Reader_t* t,
         INT64        pos);

QM_CreateReader()

リーダーオブジェクトを作成する。

QM_ReleaseReader()

リーダーオブジェクトを解放する。

QM_OpenReader()

Matroska ファイルを開く。 ファイルが正しくない場合は、エラーとして FALSE を返す。

QM_OpenReader_IStream()

Windows IStream COM インターフェイスを用いて、Matroska ファイルを開く。 ファイルが正しくない場合は、エラーとして FALSE を返す。

QM_GetTimeCodeScale()

Matroska ファイルのタイムコードスケールを返す。

通常 ms 単位を表す値 1,000,000 (ns) が返る。

QM_GetDuraion()

Matroska ファイルの再生時間を返す。(タイムコードスケール・通常 ms 単位)

QM_GetTrackCount()

Matroska ファイル内のトラック数を返す。

QM_GetTracks()

Matroska ファイルのトラック情報を返す。

QM_ReadBlock()

Matroska ファイルの Block を読みだす。 全ての Block を読み終わったら、0 を返す。 エラーの場合は、負の値を返す。

QM_SeekCluster()

Cluster 単位でシーク動作を行う。シーク先 (pos タイムコードスケール) タイムスタンプを 超えないもっとも直前の Cluster へ移動する。

QM_Track_t

TrackLacing トラックのデータが Lacing されているかを表す。

QM_Block_t

ClusterTime 上位 Cluster のタイムスタンプ。

TimeDelta Block のタイムスタンプ。(ClusterTime からの相対値)

フレームエキストラクター

Lacing された Block から、Frame データを抽出する。

 struct QM_FrameExtractor;
 
 typedef struct QM_FrameExtractor QM_FrameExtractor_t;
 
 QM_FrameExtractor_t* QM_CreateFrameExtractor(void);
 
 void QM_ReleaseFrameExtractor(QM_FrameExtractor_t* t);
 
 BOOL QM_DecodeLacingBlock(
         QM_FrameExtractor_t* t,
         const QM_Block_t*    block);
 
 INT32 QM_ReadFrame(
         QM_FrameExtractor_t* t,
         QM_Frame_t*          frame);

QM_CreateFrameExtractor()

フレームエキストラクターオブジェクトを作成する。

QM_ReleaseFrameExtractor()

フレームエキストラクターオブジェクトを解放する。

QM_DecodeLacingBlock()

Block をデコードする。

QM_ReadFrame()

Block から、デコードされた Frame を抽出する。 全ての Frame を読み終わったら、0 を返す。 エラーの場合は、負の値を返す。