---

xlv_mux.h

/*
 * xlv_mux.h
 *
 * Copyright (C) 2001 Guilhem Lavaux
 *
 * This file is part of XLV, a free middleware audio-video stream coder/decoder.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * XLV is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
#ifndef _XLV_MUX_H
#define _XLV_MUX_H

#include <glib.h>
#include "xlv_plugin_mgr.h"
#include "xlv_session.h"
#include "xlv_codec.h"
#include "xlv_audio.h"
#include "xlv_video.h"

#define XLV_MUXER_BASE_CMD 600

#define XLV_MUXER_NEW_STREAM  (XLV_MUXER_BASE_CMD+0)
#    define XLV_MUXER_AUDIO_STREAM 0
#    define XLV_MUXER_VIDEO_STREAM 1
#    define XLV_MUXER_EXT_STREAM   2
#    define XLV_MUXER_SPU_STREAM   3

typedef struct _XLV_MuxerStream {
    XLV_Stream *m_stream;
    guint8 m_stream_type;
    const gchar *m_encoding;
    guint32 m_codec_data_len;
    union {
        XLV_PCMData *m_audio_data;
        XLV_VideoData *m_video_data;
        gpointer m_generic_data;
    } m_codec_data;
} XLV_MuxerStream;

#define XLV_MUXER_SET_TIMESPEC (XLV_MUXER_BASE_CMD+1)
#define XLV_MUXER_SET_MODE     (XLV_MUXER_BASE_CMD+2)
#    define XLV_MUXER_SEEKING   0
#    define XLV_MUXER_STREAMING 1
#define XLV_MUXER_WRITE_HEADERS (XLV_MUXER_BASE_CMD+3)
#define XLV_MUXER_INTERLEAVE    (XLV_MUXER_BASE_CMD+4)
#define XLV_MUXER_NEED_FRAME    (XLV_MUXER_BASE_CMD+5)

typedef struct _XLV_MuxerInterleave {
    guint8 m_interleave_mode;
#    define XLV_MUXER_INTER_SEQUENTIAL 0

#    define XLV_MUXER_INTER_PARALLEL   1

#    define XLV_MUXER_INTER_ASAP       2

#    define XLV_MUXER_INTER_AUTO       3

    guint32 m_interleave_time;

    guint16 m_interleave_flags;
#     define XLV_MUXER_INTER_TIME_MASK     1
#       define XLV_MUXER_INTER_TIME_DELTA    0
#       define XLV_MUXER_INTER_TIME_ABSOLUTE 1
} XLV_MuxerInterleave;

/* For substreams */
#define XLV_MUXER_STREAM_BASE_CMD     (XLV_MUXER_BASE_CMD+50)
#define XLV_MUXER_STREAM_SET_TIMESPEC (XLV_MUXER_STREAM_BASE_CMD+2)
#define XLV_MUXER_STREAM_NEW_FRAME    (XLV_MUXER_STREAM_BASE_CMD+3)

typedef struct _XLV_MuxerTimeSpec {
    guint8 m_valid_entries;
#   define XLV_MUXER_TIME_FRAME_VALID 0x01
#   define XLV_MUXER_TIME_TIME_VALID 0x02
#   define XLV_MUXER_TIME_SIZE_VALID 0x04

    guint32 m_frames;
    guint32 m_time_length;
    guint32 m_size;
} XLV_MuxerTimeSpec;

typedef struct _XLV_Muxer {
    XLV_Session *m_session;
    XLV_Stream *m_output_stream;
    XLV_Stream *m_muxer;
    GSList *m_streams;
    XLV_MuxerInterleave m_interleave;
} XLV_Muxer;

typedef struct _XLV_Mux_Stream {
    XLV_Muxer *m_muxer;
    XLV_Stream *m_stream;
} XLV_Mux_Stream;

#ifdef __cplusplus
extern "C" {
#endif

    XLV_Muxer *xlv_muxer_new (XLV_Session * session, XLV_Stream * out_stream,
                              const gchar * idname);
    void xlv_muxer_release (XLV_Muxer * muxer);
    gboolean xlv_muxer_set_interleave (XLV_Muxer * muxer, guint8 mode,
                                       guint32 inter_time, guint16 flags);
    void xlv_muxer_set_time (XLV_Muxer * muxer, guint32 time);

    XLV_Mux_Stream *xlv_muxer_new_stream (XLV_Muxer * muxer,
                                          guint8 m_stream_type,
                                          XLV_ICodec * codec);
    gboolean xlv_muxer_new_frame (XLV_Mux_Stream * s, XLV_CodecFrame * frame);
    gboolean xlv_muxer_stream_set_time (XLV_Mux_Stream * s,
                                        XLV_MuxerTimeSpec * spec);
    /* When several streams are interleaved, this function tells the programmer
     * when he/she should add a new frame to the stream.
     */
    gboolean xlv_muxer_stream_need_frame (XLV_Mux_Stream * s);

#ifdef __cplusplus
}
#endif
#endif

---