Blame gst-libs/gst/riff/riff-read.c

Packit 971217
/* GStreamer RIFF I/O
Packit 971217
 * Copyright (C) 2003 Ronald Bultje <rbultje@ronald.bitfreak.net>
Packit 971217
 *
Packit 971217
 * riff-read.c: RIFF input file parsing
Packit 971217
 *
Packit 971217
 * This library is free software; you can redistribute it and/or
Packit 971217
 * modify it under the terms of the GNU Library General Public
Packit 971217
 * License as published by the Free Software Foundation; either
Packit 971217
 * version 2 of the License, or (at your option) any later version.
Packit 971217
 *
Packit 971217
 * This library is distributed in the hope that it will be useful,
Packit 971217
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit 971217
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Packit 971217
 * Library General Public License for more details.
Packit 971217
 *
Packit 971217
 * You should have received a copy of the GNU Library General Public
Packit 971217
 * License along with this library; if not, write to the
Packit 971217
 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
Packit 971217
 * Boston, MA 02110-1301, USA.
Packit 971217
 */
Packit 971217
Packit 971217
#ifdef HAVE_CONFIG_H
Packit 971217
#include "config.h"
Packit 971217
#endif
Packit 971217
Packit 971217
#include <string.h>
Packit 971217
#include <gst/gstutils.h>
Packit 971217
#include <gst/tag/tag.h>
Packit 971217
Packit 971217
#include "riff-read.h"
Packit 971217
Packit 971217
GST_DEBUG_CATEGORY_EXTERN (riff_debug);
Packit 971217
#define GST_CAT_DEFAULT riff_debug
Packit 971217
Packit 971217
/**
Packit 971217
 * gst_riff_read_chunk:
Packit 971217
 * @element: caller element (used for debugging).
Packit 971217
 * @pad: pad to pull data from.
Packit 971217
 * @offset: offset to pull from, incremented by this function.
Packit 971217
 * @tag: fourcc of the chunk (returned by this function).
Packit 971217
 * @chunk_data: buffer (returned by this function).
Packit 971217
 *
Packit 971217
 * Reads a single chunk of data. 'JUNK' chunks are skipped
Packit 971217
 * automatically.
Packit 971217
 *
Packit 971217
 * Returns: flow status.
Packit 971217
 */
Packit 971217
Packit 971217
GstFlowReturn
Packit 971217
gst_riff_read_chunk (GstElement * element,
Packit 971217
    GstPad * pad, guint64 * _offset, guint32 * tag, GstBuffer ** _chunk_data)
Packit 971217
{
Packit 971217
  GstBuffer *buf;
Packit 971217
  GstFlowReturn res;
Packit 971217
  GstMapInfo info;
Packit 971217
  guint size;
Packit 971217
  guint64 offset = *_offset;
Packit 971217
Packit 971217
  g_return_val_if_fail (element != NULL, GST_FLOW_ERROR);
Packit 971217
  g_return_val_if_fail (pad != NULL, GST_FLOW_ERROR);
Packit 971217
  g_return_val_if_fail (_offset != NULL, GST_FLOW_ERROR);
Packit 971217
  g_return_val_if_fail (tag != NULL, GST_FLOW_ERROR);
Packit 971217
  g_return_val_if_fail (_chunk_data != NULL, GST_FLOW_ERROR);
Packit 971217
Packit 971217
skip_junk:
Packit 971217
  size = 8;
Packit 971217
  buf = NULL;
Packit 971217
  if ((res = gst_pad_pull_range (pad, offset, size, &buf)) != GST_FLOW_OK)
Packit 971217
    return res;
Packit 971217
  else if (gst_buffer_get_size (buf) < size)
Packit 971217
    goto too_small;
Packit 971217
Packit 971217
  gst_buffer_map (buf, &info, GST_MAP_READ);
Packit 971217
  *tag = GST_READ_UINT32_LE (info.data);
Packit 971217
  size = GST_READ_UINT32_LE (info.data + 4);
Packit 971217
  gst_buffer_unmap (buf, &info;;
Packit 971217
  gst_buffer_unref (buf);
Packit 971217
Packit 971217
  GST_DEBUG_OBJECT (element, "fourcc=%" GST_FOURCC_FORMAT ", size=%u",
Packit 971217
      GST_FOURCC_ARGS (*tag), size);
Packit 971217
Packit 971217
  /* skip 'JUNK' chunks */
Packit 971217
  if (*tag == GST_RIFF_TAG_JUNK || *tag == GST_RIFF_TAG_JUNQ) {
Packit 971217
    size = GST_ROUND_UP_2 (size);
Packit 971217
    *_offset += 8 + size;
Packit 971217
    offset += 8 + size;
Packit 971217
    GST_DEBUG_OBJECT (element, "skipping JUNK chunk");
Packit 971217
    goto skip_junk;
Packit 971217
  }
Packit 971217
Packit 971217
  buf = NULL;
Packit 971217
  if ((res = gst_pad_pull_range (pad, offset + 8, size, &buf)) != GST_FLOW_OK)
Packit 971217
    return res;
Packit 971217
  else if (gst_buffer_get_size (buf) < size)
Packit 971217
    goto too_small;
Packit 971217
Packit 971217
  *_chunk_data = buf;
Packit 971217
  *_offset += 8 + GST_ROUND_UP_2 (size);
Packit 971217
Packit 971217
  return GST_FLOW_OK;
Packit 971217
Packit 971217
  /* ERRORS */
Packit 971217
too_small:
Packit 971217
  {
Packit 971217
    /* short read, we return EOS to mark the EOS case */
Packit 971217
    GST_DEBUG_OBJECT (element, "not enough data (available=%" G_GSIZE_FORMAT
Packit 971217
        ", needed=%u)", gst_buffer_get_size (buf), size);
Packit 971217
    gst_buffer_unref (buf);
Packit 971217
    return GST_FLOW_EOS;
Packit 971217
  }
Packit 971217
}
Packit 971217
Packit 971217
/**
Packit 971217
 * gst_riff_parse_chunk:
Packit 971217
 * @element: caller element (used for debugging).
Packit 971217
 * @buf: input buffer.
Packit 971217
 * @offset: offset in the buffer in the caller. Is incremented
Packit 971217
 *          by the read size by this function.
Packit 971217
 * @fourcc: fourcc (returned by this function0 of the chunk.
Packit 971217
 * @chunk_data: buffer (returned by the function) containing the
Packit 971217
 *              chunk data, which may be NULL if chunksize == 0
Packit 971217
 *
Packit 971217
 * Reads a single chunk.
Packit 971217
 *
Packit 971217
 * Returns: FALSE on error, TRUE otherwise
Packit 971217
 */
Packit 971217
gboolean
Packit 971217
gst_riff_parse_chunk (GstElement * element, GstBuffer * buf,
Packit 971217
    guint * _offset, guint32 * _fourcc, GstBuffer ** chunk_data)
Packit 971217
{
Packit 971217
  guint size, bufsize;
Packit 971217
  guint32 fourcc;
Packit 971217
  guint8 *ptr;
Packit 971217
  GstMapInfo info;
Packit 971217
  guint offset = *_offset;
Packit 971217
Packit 971217
  g_return_val_if_fail (element != NULL, FALSE);
Packit 971217
  g_return_val_if_fail (buf != NULL, FALSE);
Packit 971217
  g_return_val_if_fail (_offset != NULL, FALSE);
Packit 971217
  g_return_val_if_fail (_fourcc != NULL, FALSE);
Packit 971217
  g_return_val_if_fail (chunk_data != NULL, FALSE);
Packit 971217
Packit 971217
  *chunk_data = NULL;
Packit 971217
  *_fourcc = 0;
Packit 971217
Packit 971217
  bufsize = gst_buffer_get_size (buf);
Packit 971217
Packit 971217
  if (bufsize == offset)
Packit 971217
    goto end_offset;
Packit 971217
Packit 971217
  if (bufsize < offset + 8)
Packit 971217
    goto too_small;
Packit 971217
Packit 971217
  /* read header */
Packit 971217
  gst_buffer_map (buf, &info, GST_MAP_READ);
Packit 971217
  ptr = info.data + offset;
Packit 971217
  fourcc = GST_READ_UINT32_LE (ptr);
Packit 971217
  size = GST_READ_UINT32_LE (ptr + 4);
Packit 971217
  gst_buffer_unmap (buf, &info;;
Packit 971217
Packit 971217
  GST_DEBUG_OBJECT (element, "fourcc=%" GST_FOURCC_FORMAT ", size=%u",
Packit 971217
      GST_FOURCC_ARGS (fourcc), size);
Packit 971217
Packit 971217
  /* be paranoid: size may be nonsensical value here, such as (guint) -1 */
Packit 971217
  if (G_UNLIKELY (size > G_MAXINT))
Packit 971217
    goto bogus_size;
Packit 971217
Packit 971217
  if (bufsize < size + 8 + offset) {
Packit 971217
    GST_DEBUG_OBJECT (element,
Packit 971217
        "Needed chunk data (%d) is more than available (%d), shortcutting",
Packit 971217
        size, bufsize - 8 - offset);
Packit 971217
    size = bufsize - 8 - offset;
Packit 971217
  }
Packit 971217
Packit 971217
  if (size)
Packit 971217
    *chunk_data =
Packit 971217
        gst_buffer_copy_region (buf, GST_BUFFER_COPY_ALL, offset + 8, size);
Packit 971217
  else
Packit 971217
    *chunk_data = NULL;
Packit 971217
Packit 971217
  *_fourcc = fourcc;
Packit 971217
  *_offset += 8 + GST_ROUND_UP_2 (size);
Packit 971217
Packit 971217
  return TRUE;
Packit 971217
Packit 971217
  /* ERRORS */
Packit 971217
end_offset:
Packit 971217
  {
Packit 971217
    GST_DEBUG_OBJECT (element, "End of chunk (offset %d)", offset);
Packit 971217
    return FALSE;
Packit 971217
  }
Packit 971217
too_small:
Packit 971217
  {
Packit 971217
    GST_DEBUG_OBJECT (element,
Packit 971217
        "Failed to parse chunk header (offset %d, %d available, %d needed)",
Packit 971217
        offset, bufsize, 8);
Packit 971217
    return FALSE;
Packit 971217
  }
Packit 971217
bogus_size:
Packit 971217
  {
Packit 971217
    GST_ERROR_OBJECT (element, "Broken file: bogus chunk size %u", size);
Packit 971217
    return FALSE;
Packit 971217
  }
Packit 971217
}
Packit 971217
Packit 971217
/**
Packit 971217
 * gst_riff_parse_file_header:
Packit 971217
 * @element: caller element (used for debugging/error).
Packit 971217
 * @buf: input buffer from which the file header will be parsed,
Packit 971217
 *       should be at least 12 bytes long.
Packit 971217
 * @doctype: a fourcc (returned by this function) to indicate the
Packit 971217
 *           type of document (according to the header).
Packit 971217
 *
Packit 971217
 * Reads the first few bytes from the provided buffer, checks
Packit 971217
 * if this stream is a RIFF stream, and determines document type.
Packit 971217
 * This function takes ownership of @buf so it should not be used anymore
Packit 971217
 * after calling this function.
Packit 971217
 *
Packit 971217
 * Returns: FALSE if this is not a RIFF stream (in which case the
Packit 971217
 * caller should error out; we already throw an error), or TRUE
Packit 971217
 * if it is.
Packit 971217
 */
Packit 971217
gboolean
Packit 971217
gst_riff_parse_file_header (GstElement * element,
Packit 971217
    GstBuffer * buf, guint32 * doctype)
Packit 971217
{
Packit 971217
  GstMapInfo info;
Packit 971217
  guint32 tag;
Packit 971217
Packit 971217
  g_return_val_if_fail (buf != NULL, FALSE);
Packit 971217
  g_return_val_if_fail (doctype != NULL, FALSE);
Packit 971217
Packit 971217
  gst_buffer_map (buf, &info, GST_MAP_READ);
Packit 971217
  if (info.size < 12)
Packit 971217
    goto too_small;
Packit 971217
Packit 971217
  tag = GST_READ_UINT32_LE (info.data);
Packit 971217
  if (tag != GST_RIFF_TAG_RIFF && tag != GST_RIFF_TAG_AVF0
Packit 971217
      && tag != GST_RIFF_TAG_RF64)
Packit 971217
    goto not_riff;
Packit 971217
Packit 971217
  *doctype = GST_READ_UINT32_LE (info.data + 8);
Packit 971217
  gst_buffer_unmap (buf, &info;;
Packit 971217
Packit 971217
  gst_buffer_unref (buf);
Packit 971217
Packit 971217
  return TRUE;
Packit 971217
Packit 971217
  /* ERRORS */
Packit 971217
too_small:
Packit 971217
  {
Packit 971217
    GST_ELEMENT_ERROR (element, STREAM, WRONG_TYPE, (NULL),
Packit 971217
        ("Not enough data to parse RIFF header (%" G_GSIZE_FORMAT " available,"
Packit 971217
            " %d needed)", info.size, 12));
Packit 971217
    gst_buffer_unmap (buf, &info;;
Packit 971217
    gst_buffer_unref (buf);
Packit 971217
    return FALSE;
Packit 971217
  }
Packit 971217
not_riff:
Packit 971217
  {
Packit 971217
    GST_ELEMENT_ERROR (element, STREAM, WRONG_TYPE, (NULL),
Packit 971217
        ("Stream is no RIFF stream: 0x%" G_GINT32_MODIFIER "x", tag));
Packit 971217
    gst_buffer_unmap (buf, &info;;
Packit 971217
    gst_buffer_unref (buf);
Packit 971217
    return FALSE;
Packit 971217
  }
Packit 971217
}
Packit 971217
Packit 971217
/**
Packit 971217
 * gst_riff_parse_strh:
Packit 971217
 * @element: caller element (used for debugging/error).
Packit 971217
 * @buf: input data to be used for parsing, stripped from header.
Packit 971217
 * @strh: a pointer (returned by this function) to a filled-in
Packit 971217
 *        strh structure. Caller should free it.
Packit 971217
 *
Packit 971217
 * Parses a strh structure from input data. Takes ownership of @buf.
Packit 971217
 *
Packit 971217
 * Returns: TRUE if parsing succeeded, otherwise FALSE. The stream
Packit 971217
 *          should be skipped on error, but it is not fatal.
Packit 971217
 */
Packit 971217
Packit 971217
gboolean
Packit 971217
gst_riff_parse_strh (GstElement * element,
Packit 971217
    GstBuffer * buf, gst_riff_strh ** _strh)
Packit 971217
{
Packit 971217
  gst_riff_strh *strh;
Packit 971217
  GstMapInfo info;
Packit 971217
Packit 971217
  g_return_val_if_fail (buf != NULL, FALSE);
Packit 971217
  g_return_val_if_fail (_strh != NULL, FALSE);
Packit 971217
Packit 971217
  gst_buffer_map (buf, &info, GST_MAP_READ);
Packit 971217
  if (info.size < sizeof (gst_riff_strh))
Packit 971217
    goto too_small;
Packit 971217
Packit 971217
  strh = g_memdup (info.data, info.size);
Packit 971217
  gst_buffer_unmap (buf, &info;;
Packit 971217
Packit 971217
  gst_buffer_unref (buf);
Packit 971217
Packit 971217
#if (G_BYTE_ORDER == G_BIG_ENDIAN)
Packit 971217
  strh->type = GUINT32_FROM_LE (strh->type);
Packit 971217
  strh->fcc_handler = GUINT32_FROM_LE (strh->fcc_handler);
Packit 971217
  strh->flags = GUINT32_FROM_LE (strh->flags);
Packit 971217
  strh->priority = GUINT32_FROM_LE (strh->priority);
Packit 971217
  strh->init_frames = GUINT32_FROM_LE (strh->init_frames);
Packit 971217
  strh->scale = GUINT32_FROM_LE (strh->scale);
Packit 971217
  strh->rate = GUINT32_FROM_LE (strh->rate);
Packit 971217
  strh->start = GUINT32_FROM_LE (strh->start);
Packit 971217
  strh->length = GUINT32_FROM_LE (strh->length);
Packit 971217
  strh->bufsize = GUINT32_FROM_LE (strh->bufsize);
Packit 971217
  strh->quality = GUINT32_FROM_LE (strh->quality);
Packit 971217
  strh->samplesize = GUINT32_FROM_LE (strh->samplesize);
Packit 971217
#endif
Packit 971217
Packit 971217
  /* avoid divisions by zero */
Packit 971217
  if (!strh->scale)
Packit 971217
    strh->scale = 1;
Packit 971217
  if (!strh->rate)
Packit 971217
    strh->rate = 1;
Packit 971217
Packit 971217
  /* debug */
Packit 971217
  GST_INFO_OBJECT (element, "strh tag found:");
Packit 971217
  GST_INFO_OBJECT (element, " type        %" GST_FOURCC_FORMAT,
Packit 971217
      GST_FOURCC_ARGS (strh->type));
Packit 971217
  GST_INFO_OBJECT (element, " fcc_handler %" GST_FOURCC_FORMAT,
Packit 971217
      GST_FOURCC_ARGS (strh->fcc_handler));
Packit 971217
  GST_INFO_OBJECT (element, " flags       0x%08x", strh->flags);
Packit 971217
  GST_INFO_OBJECT (element, " priority    %d", strh->priority);
Packit 971217
  GST_INFO_OBJECT (element, " init_frames %d", strh->init_frames);
Packit 971217
  GST_INFO_OBJECT (element, " scale       %d", strh->scale);
Packit 971217
  GST_INFO_OBJECT (element, " rate        %d", strh->rate);
Packit 971217
  GST_INFO_OBJECT (element, " start       %d", strh->start);
Packit 971217
  GST_INFO_OBJECT (element, " length      %d", strh->length);
Packit 971217
  GST_INFO_OBJECT (element, " bufsize     %d", strh->bufsize);
Packit 971217
  GST_INFO_OBJECT (element, " quality     %d", strh->quality);
Packit 971217
  GST_INFO_OBJECT (element, " samplesize  %d", strh->samplesize);
Packit 971217
Packit 971217
  *_strh = strh;
Packit 971217
Packit 971217
  return TRUE;
Packit 971217
Packit 971217
  /* ERRORS */
Packit 971217
too_small:
Packit 971217
  {
Packit 971217
    GST_ERROR_OBJECT (element,
Packit 971217
        "Too small strh (%" G_GSIZE_FORMAT " available, %d needed)",
Packit 971217
        info.size, (int) sizeof (gst_riff_strh));
Packit 971217
    gst_buffer_unmap (buf, &info;;
Packit 971217
    gst_buffer_unref (buf);
Packit 971217
    return FALSE;
Packit 971217
  }
Packit 971217
}
Packit 971217
Packit 971217
/**
Packit 971217
 * gst_riff_parse_strf_vids:
Packit 971217
 * @element: caller element (used for debugging/error).
Packit 971217
 * @buf: input data to be used for parsing, stripped from header.
Packit 971217
 * @strf: a pointer (returned by this function) to a filled-in
Packit 971217
 *        strf/vids structure. Caller should free it.
Packit 971217
 * @data: a pointer (returned by this function) to a buffer
Packit 971217
 *        containing extradata for this particular stream (e.g.
Packit 971217
 *        palette, codec initialization data).
Packit 971217
 *
Packit 971217
 * Parses a video stream's strf structure plus optionally some
Packit 971217
 * extradata from input data. This function takes ownership of @buf.
Packit 971217
 *
Packit 971217
 * Returns: TRUE if parsing succeeded, otherwise FALSE. The stream
Packit 971217
 *          should be skipped on error, but it is not fatal.
Packit 971217
 */
Packit 971217
Packit 971217
gboolean
Packit 971217
gst_riff_parse_strf_vids (GstElement * element,
Packit 971217
    GstBuffer * buf, gst_riff_strf_vids ** _strf, GstBuffer ** data)
Packit 971217
{
Packit 971217
  gst_riff_strf_vids *strf;
Packit 971217
  GstMapInfo info;
Packit 971217
Packit 971217
  g_return_val_if_fail (buf != NULL, FALSE);
Packit 971217
  g_return_val_if_fail (_strf != NULL, FALSE);
Packit 971217
  g_return_val_if_fail (data != NULL, FALSE);
Packit 971217
Packit 971217
  gst_buffer_map (buf, &info, GST_MAP_READ);
Packit 971217
  if (info.size < sizeof (gst_riff_strf_vids))
Packit 971217
    goto too_small;
Packit 971217
Packit 971217
  strf = g_memdup (info.data, info.size);
Packit 971217
  gst_buffer_unmap (buf, &info;;
Packit 971217
Packit 971217
#if (G_BYTE_ORDER == G_BIG_ENDIAN)
Packit 971217
  strf->size = GUINT32_FROM_LE (strf->size);
Packit 971217
  strf->width = GUINT32_FROM_LE (strf->width);
Packit 971217
  strf->height = GUINT32_FROM_LE (strf->height);
Packit 971217
  strf->planes = GUINT16_FROM_LE (strf->planes);
Packit 971217
  strf->bit_cnt = GUINT16_FROM_LE (strf->bit_cnt);
Packit 971217
  strf->compression = GUINT32_FROM_LE (strf->compression);
Packit 971217
  strf->image_size = GUINT32_FROM_LE (strf->image_size);
Packit 971217
  strf->xpels_meter = GUINT32_FROM_LE (strf->xpels_meter);
Packit 971217
  strf->ypels_meter = GUINT32_FROM_LE (strf->ypels_meter);
Packit 971217
  strf->num_colors = GUINT32_FROM_LE (strf->num_colors);
Packit 971217
  strf->imp_colors = GUINT32_FROM_LE (strf->imp_colors);
Packit 971217
#endif
Packit 971217
Packit 971217
  /* size checking */
Packit 971217
  *data = NULL;
Packit 971217
  if (strf->size > info.size) {
Packit 971217
    GST_WARNING_OBJECT (element,
Packit 971217
        "strf_vids header gave %d bytes data, only %" G_GSIZE_FORMAT
Packit 971217
        " available", strf->size, info.size);
Packit 971217
    strf->size = info.size;
Packit 971217
  }
Packit 971217
  if (sizeof (gst_riff_strf_vids) < info.size) {
Packit 971217
    *data =
Packit 971217
        gst_buffer_copy_region (buf, GST_BUFFER_COPY_ALL,
Packit 971217
        sizeof (gst_riff_strf_vids), info.size - sizeof (gst_riff_strf_vids));
Packit 971217
  }
Packit 971217
  gst_buffer_unref (buf);
Packit 971217
Packit 971217
  /* debug */
Packit 971217
  GST_INFO_OBJECT (element, "strf tag found in context vids:");
Packit 971217
  GST_INFO_OBJECT (element, " size        %d", strf->size);
Packit 971217
  GST_INFO_OBJECT (element, " width       %d", strf->width);
Packit 971217
  GST_INFO_OBJECT (element, " height      %d", strf->height);
Packit 971217
  GST_INFO_OBJECT (element, " planes      %d", strf->planes);
Packit 971217
  GST_INFO_OBJECT (element, " bit_cnt     %d", strf->bit_cnt);
Packit 971217
  GST_INFO_OBJECT (element, " compression %" GST_FOURCC_FORMAT,
Packit 971217
      GST_FOURCC_ARGS (strf->compression));
Packit 971217
  GST_INFO_OBJECT (element, " image_size  %d", strf->image_size);
Packit 971217
  GST_INFO_OBJECT (element, " xpels_meter %d", strf->xpels_meter);
Packit 971217
  GST_INFO_OBJECT (element, " ypels_meter %d", strf->ypels_meter);
Packit 971217
  GST_INFO_OBJECT (element, " num_colors  %d", strf->num_colors);
Packit 971217
  GST_INFO_OBJECT (element, " imp_colors  %d", strf->imp_colors);
Packit 971217
  if (*data)
Packit 971217
    GST_INFO_OBJECT (element, " %" G_GSIZE_FORMAT " bytes extradata",
Packit 971217
        gst_buffer_get_size (*data));
Packit 971217
Packit 971217
  *_strf = strf;
Packit 971217
Packit 971217
  return TRUE;
Packit 971217
Packit 971217
  /* ERRORS */
Packit 971217
too_small:
Packit 971217
  {
Packit 971217
    GST_ERROR_OBJECT (element,
Packit 971217
        "Too small strf_vids (%" G_GSIZE_FORMAT " available, %d needed)",
Packit 971217
        info.size, (int) sizeof (gst_riff_strf_vids));
Packit 971217
    gst_buffer_unmap (buf, &info;;
Packit 971217
    gst_buffer_unref (buf);
Packit 971217
    return FALSE;
Packit 971217
  }
Packit 971217
}
Packit 971217
Packit 971217
/**
Packit 971217
 * gst_riff_parse_strf_auds:
Packit 971217
 * @element: caller element (used for debugging/error).
Packit 971217
 * @buf: input data to be used for parsing, stripped from header.
Packit 971217
 * @strf: a pointer (returned by this function) to a filled-in
Packit 971217
 *        strf/auds structure. Caller should free it.
Packit 971217
 * @data: a pointer (returned by this function) to a buffer
Packit 971217
 *        containing extradata for this particular stream (e.g.
Packit 971217
 *        codec initialization data).
Packit 971217
 *
Packit 971217
 * Parses an audio stream's strf structure plus optionally some
Packit 971217
 * extradata from input data. This function takes ownership of @buf.
Packit 971217
 * use.
Packit 971217
 *
Packit 971217
 * Returns: TRUE if parsing succeeded, otherwise FALSE. The stream
Packit 971217
 *          should be skipped on error, but it is not fatal.
Packit 971217
 */
Packit 971217
gboolean
Packit 971217
gst_riff_parse_strf_auds (GstElement * element,
Packit 971217
    GstBuffer * buf, gst_riff_strf_auds ** _strf, GstBuffer ** data)
Packit 971217
{
Packit 971217
  gst_riff_strf_auds *strf;
Packit 971217
  GstMapInfo info;
Packit 971217
Packit 971217
  g_return_val_if_fail (buf != NULL, FALSE);
Packit 971217
  g_return_val_if_fail (_strf != NULL, FALSE);
Packit 971217
  g_return_val_if_fail (data != NULL, FALSE);
Packit 971217
Packit 971217
  gst_buffer_map (buf, &info, GST_MAP_READ);
Packit 971217
  if (info.size < sizeof (gst_riff_strf_auds))
Packit 971217
    goto too_small;
Packit 971217
Packit 971217
  strf = g_memdup (info.data, info.size);
Packit 971217
Packit 971217
#if (G_BYTE_ORDER == G_BIG_ENDIAN)
Packit 971217
  strf->format = GUINT16_FROM_LE (strf->format);
Packit 971217
  strf->channels = GUINT16_FROM_LE (strf->channels);
Packit 971217
  strf->rate = GUINT32_FROM_LE (strf->rate);
Packit 971217
  strf->av_bps = GUINT32_FROM_LE (strf->av_bps);
Packit 971217
  strf->blockalign = GUINT16_FROM_LE (strf->blockalign);
Packit 971217
  strf->bits_per_sample = GUINT16_FROM_LE (strf->bits_per_sample);
Packit 971217
#endif
Packit 971217
Packit 971217
  /* size checking */
Packit 971217
  *data = NULL;
Packit 971217
  if (info.size > sizeof (gst_riff_strf_auds) + 2) {
Packit 971217
    gint len;
Packit 971217
Packit 971217
    len = GST_READ_UINT16_LE (&info.data[16]);
Packit 971217
    if (len + 2 + sizeof (gst_riff_strf_auds) > info.size) {
Packit 971217
      GST_WARNING_OBJECT (element,
Packit 971217
          "Extradata indicated %d bytes, but only %" G_GSIZE_FORMAT
Packit 971217
          " available", len, info.size - 2 - sizeof (gst_riff_strf_auds));
Packit 971217
      len = info.size - 2 - sizeof (gst_riff_strf_auds);
Packit 971217
    }
Packit 971217
    if (len)
Packit 971217
      *data = gst_buffer_copy_region (buf, GST_BUFFER_COPY_ALL,
Packit 971217
          sizeof (gst_riff_strf_auds) + 2, len);
Packit 971217
  }
Packit 971217
Packit 971217
  /* debug */
Packit 971217
  GST_INFO_OBJECT (element, "strf tag found in context auds:");
Packit 971217
  GST_INFO_OBJECT (element, " format      %d", strf->format);
Packit 971217
  GST_INFO_OBJECT (element, " channels    %d", strf->channels);
Packit 971217
  GST_INFO_OBJECT (element, " rate        %d", strf->rate);
Packit 971217
  GST_INFO_OBJECT (element, " av_bps      %d", strf->av_bps);
Packit 971217
  GST_INFO_OBJECT (element, " blockalign  %d", strf->blockalign);
Packit 971217
  GST_INFO_OBJECT (element, " bits/sample %d", strf->bits_per_sample);
Packit 971217
  if (*data)
Packit 971217
    GST_INFO_OBJECT (element, " %" G_GSIZE_FORMAT " bytes extradata",
Packit 971217
        gst_buffer_get_size (*data));
Packit 971217
Packit 971217
  gst_buffer_unmap (buf, &info;;
Packit 971217
  gst_buffer_unref (buf);
Packit 971217
Packit 971217
  *_strf = strf;
Packit 971217
Packit 971217
  return TRUE;
Packit 971217
Packit 971217
  /* ERROR */
Packit 971217
too_small:
Packit 971217
  {
Packit 971217
    GST_ERROR_OBJECT (element,
Packit 971217
        "Too small strf_auds (%" G_GSIZE_FORMAT " available"
Packit 971217
        ", %" G_GSIZE_FORMAT " needed)", info.size,
Packit 971217
        sizeof (gst_riff_strf_auds));
Packit 971217
    gst_buffer_unmap (buf, &info;;
Packit 971217
    gst_buffer_unref (buf);
Packit 971217
    return FALSE;
Packit 971217
  }
Packit 971217
}
Packit 971217
Packit 971217
/**
Packit 971217
 * gst_riff_parse_strf_iavs:
Packit 971217
 * @element: caller element (used for debugging/error).
Packit 971217
 * @buf: input data to be used for parsing, stripped from header.
Packit 971217
 * @strf: a pointer (returned by this function) to a filled-in
Packit 971217
 *        strf/iavs structure. Caller should free it.
Packit 971217
 * @data: a pointer (returned by this function) to a buffer
Packit 971217
 *        containing extradata for this particular stream (e.g.
Packit 971217
 *        codec initialization data).
Packit 971217
 *
Packit 971217
 * Parses a interleaved (also known as "complex")  stream´s strf
Packit 971217
 * structure plus optionally some extradata from input data. This
Packit 971217
 * function takes ownership of @buf.
Packit 971217
 *
Packit 971217
 * Returns: TRUE if parsing succeeded, otherwise FALSE.
Packit 971217
 */
Packit 971217
Packit 971217
gboolean
Packit 971217
gst_riff_parse_strf_iavs (GstElement * element,
Packit 971217
    GstBuffer * buf, gst_riff_strf_iavs ** _strf, GstBuffer ** data)
Packit 971217
{
Packit 971217
  gst_riff_strf_iavs *strf;
Packit 971217
  GstMapInfo info;
Packit 971217
Packit 971217
  g_return_val_if_fail (buf != NULL, FALSE);
Packit 971217
  g_return_val_if_fail (_strf != NULL, FALSE);
Packit 971217
  g_return_val_if_fail (data != NULL, FALSE);
Packit 971217
Packit 971217
  gst_buffer_map (buf, &info, GST_MAP_READ);
Packit 971217
  if (info.size < sizeof (gst_riff_strf_iavs))
Packit 971217
    goto too_small;
Packit 971217
Packit 971217
  strf = g_memdup (info.data, info.size);
Packit 971217
  gst_buffer_unmap (buf, &info;;
Packit 971217
Packit 971217
  gst_buffer_unref (buf);
Packit 971217
Packit 971217
#if (G_BYTE_ORDER == G_BIG_ENDIAN)
Packit 971217
  strf->DVAAuxSrc = GUINT32_FROM_LE (strf->DVAAuxSrc);
Packit 971217
  strf->DVAAuxCtl = GUINT32_FROM_LE (strf->DVAAuxCtl);
Packit 971217
  strf->DVAAuxSrc1 = GUINT32_FROM_LE (strf->DVAAuxSrc1);
Packit 971217
  strf->DVAAuxCtl1 = GUINT32_FROM_LE (strf->DVAAuxCtl1);
Packit 971217
  strf->DVVAuxSrc = GUINT32_FROM_LE (strf->DVVAuxSrc);
Packit 971217
  strf->DVVAuxCtl = GUINT32_FROM_LE (strf->DVVAuxCtl);
Packit 971217
  strf->DVReserved1 = GUINT32_FROM_LE (strf->DVReserved1);
Packit 971217
  strf->DVReserved2 = GUINT32_FROM_LE (strf->DVReserved2);
Packit 971217
#endif
Packit 971217
Packit 971217
  /* debug */
Packit 971217
  GST_INFO_OBJECT (element, "strf tag found in context iavs:");
Packit 971217
  GST_INFO_OBJECT (element, " DVAAuxSrc   %08x", strf->DVAAuxSrc);
Packit 971217
  GST_INFO_OBJECT (element, " DVAAuxCtl   %08x", strf->DVAAuxCtl);
Packit 971217
  GST_INFO_OBJECT (element, " DVAAuxSrc1  %08x", strf->DVAAuxSrc1);
Packit 971217
  GST_INFO_OBJECT (element, " DVAAuxCtl1  %08x", strf->DVAAuxCtl1);
Packit 971217
  GST_INFO_OBJECT (element, " DVVAuxSrc   %08x", strf->DVVAuxSrc);
Packit 971217
  GST_INFO_OBJECT (element, " DVVAuxCtl   %08x", strf->DVVAuxCtl);
Packit 971217
  GST_INFO_OBJECT (element, " DVReserved1 %08x", strf->DVReserved1);
Packit 971217
  GST_INFO_OBJECT (element, " DVReserved2 %08x", strf->DVReserved2);
Packit 971217
Packit 971217
  *_strf = strf;
Packit 971217
  *data = NULL;
Packit 971217
Packit 971217
  return TRUE;
Packit 971217
Packit 971217
  /* ERRORS */
Packit 971217
too_small:
Packit 971217
  {
Packit 971217
    GST_ERROR_OBJECT (element,
Packit 971217
        "Too small strf_iavs (%" G_GSIZE_FORMAT "available"
Packit 971217
        ", %" G_GSIZE_FORMAT " needed)", info.size,
Packit 971217
        sizeof (gst_riff_strf_iavs));
Packit 971217
    gst_buffer_unmap (buf, &info;;
Packit 971217
    gst_buffer_unref (buf);
Packit 971217
    return FALSE;
Packit 971217
  }
Packit 971217
}
Packit 971217
Packit 971217
static void
Packit 971217
parse_tag_value (GstElement * element, GstTagList * taglist, const gchar * type,
Packit 971217
    guint8 * ptr, guint tsize)
Packit 971217
{
Packit 971217
  static const gchar *env_vars[] = { "GST_AVI_TAG_ENCODING",
Packit 971217
    "GST_RIFF_TAG_ENCODING", "GST_TAG_ENCODING", NULL
Packit 971217
  };
Packit 971217
  GType tag_type;
Packit 971217
  gchar *val;
Packit 971217
Packit 971217
  tag_type = gst_tag_get_type (type);
Packit 971217
  val = gst_tag_freeform_string_to_utf8 ((gchar *) ptr, tsize, env_vars);
Packit 971217
Packit 971217
  if (val != NULL) {
Packit 971217
    if (tag_type == G_TYPE_STRING) {
Packit 971217
      gst_tag_list_add (taglist, GST_TAG_MERGE_APPEND, type, val, NULL);
Packit 971217
    } else {
Packit 971217
      GValue tag_val = { 0, };
Packit 971217
Packit 971217
      g_value_init (&tag_val, tag_type);
Packit 971217
      if (gst_value_deserialize (&tag_val, val)) {
Packit 971217
        gst_tag_list_add_value (taglist, GST_TAG_MERGE_APPEND, type, &tag_val);
Packit 971217
      } else {
Packit 971217
        GST_WARNING_OBJECT (element, "could not deserialize '%s' into a "
Packit 971217
            "tag %s of type %s", val, type, g_type_name (tag_type));
Packit 971217
      }
Packit 971217
      g_value_unset (&tag_val);
Packit 971217
    }
Packit 971217
    g_free (val);
Packit 971217
  } else {
Packit 971217
    GST_WARNING_OBJECT (element, "could not extract %s tag", type);
Packit 971217
  }
Packit 971217
}
Packit 971217
Packit 971217
/**
Packit 971217
 * gst_riff_parse_info:
Packit 971217
 * @element: caller element (used for debugging/error).
Packit 971217
 * @buf: input data to be used for parsing, stripped from header.
Packit 971217
 * @taglist: a pointer to a taglist (returned by this function)
Packit 971217
 *           containing information about this stream. May be
Packit 971217
 *           NULL if no supported tags were found.
Packit 971217
 *
Packit 971217
 * Parses stream metadata from input data.
Packit 971217
 */
Packit 971217
void
Packit 971217
gst_riff_parse_info (GstElement * element,
Packit 971217
    GstBuffer * buf, GstTagList ** _taglist)
Packit 971217
{
Packit 971217
  GstMapInfo info;
Packit 971217
  guint8 *ptr;
Packit 971217
  gsize left;
Packit 971217
  guint tsize;
Packit 971217
  guint32 tag;
Packit 971217
  const gchar *type;
Packit 971217
  GstTagList *taglist;
Packit 971217
Packit 971217
  g_return_if_fail (_taglist != NULL);
Packit 971217
Packit 971217
  if (!buf) {
Packit 971217
    *_taglist = NULL;
Packit 971217
    return;
Packit 971217
  }
Packit 971217
  gst_buffer_map (buf, &info, GST_MAP_READ);
Packit 971217
Packit 971217
  taglist = gst_tag_list_new_empty ();
Packit 971217
Packit 971217
  ptr = info.data;
Packit 971217
  left = info.size;
Packit 971217
Packit 971217
  while (left > 8) {
Packit 971217
    tag = GST_READ_UINT32_LE (ptr);
Packit 971217
    tsize = GST_READ_UINT32_LE (ptr + 4);
Packit 971217
Packit 971217
    GST_MEMDUMP_OBJECT (element, "tag chunk", ptr, MIN (tsize + 8, left));
Packit 971217
Packit 971217
    left -= 8;
Packit 971217
    ptr += 8;
Packit 971217
Packit 971217
    GST_DEBUG ("tag %" GST_FOURCC_FORMAT ", size %u",
Packit 971217
        GST_FOURCC_ARGS (tag), tsize);
Packit 971217
Packit 971217
    if (tsize > left) {
Packit 971217
      GST_WARNING_OBJECT (element,
Packit 971217
          "Tagsize %d is larger than available data %" G_GSIZE_FORMAT,
Packit 971217
          tsize, left);
Packit 971217
      tsize = left;
Packit 971217
    }
Packit 971217
Packit 971217
    /* make uppercase */
Packit 971217
    tag = tag & 0xDFDFDFDF;
Packit 971217
Packit 971217
    /* find out the type of metadata */
Packit 971217
    switch (tag) {
Packit 971217
      case GST_RIFF_INFO_IARL:
Packit 971217
        type = GST_TAG_LOCATION;
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_IAAR:
Packit 971217
        type = GST_TAG_ALBUM_ARTIST;
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_IART:
Packit 971217
        type = GST_TAG_ARTIST;
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_ICMS:
Packit 971217
        type = NULL;            /*"Commissioner"; */
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_ICMT:
Packit 971217
        type = GST_TAG_COMMENT;
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_ICOP:
Packit 971217
        type = GST_TAG_COPYRIGHT;
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_ICRD:
Packit 971217
        type = GST_TAG_DATE_TIME;
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_ICRP:
Packit 971217
        type = NULL;            /*"Cropped"; */
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_IDIM:
Packit 971217
        type = NULL;            /*"Dimensions"; */
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_IDPI:
Packit 971217
        type = NULL;            /*"Dots per Inch"; */
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_IENG:
Packit 971217
        type = NULL;            /*"Engineer"; */
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_IGNR:
Packit 971217
        type = GST_TAG_GENRE;
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_IKEY:
Packit 971217
        type = GST_TAG_KEYWORDS;
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_ILGT:
Packit 971217
        type = NULL;            /*"Lightness"; */
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_IMED:
Packit 971217
        type = NULL;            /*"Medium"; */
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_INAM:
Packit 971217
        type = GST_TAG_TITLE;
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_IPLT:
Packit 971217
        type = NULL;            /*"Palette"; */
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_IPRD:
Packit 971217
        type = GST_TAG_ALBUM;
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_ISBJ:
Packit 971217
        type = GST_TAG_ALBUM_ARTIST;
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_ISFT:
Packit 971217
        type = GST_TAG_ENCODER;
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_ISHP:
Packit 971217
        type = NULL;            /*"Sharpness"; */
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_ISRC:
Packit 971217
        type = GST_TAG_ISRC;
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_ISRF:
Packit 971217
        type = NULL;            /*"Source Form"; */
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_ITCH:
Packit 971217
        type = NULL;            /*"Technician"; */
Packit 971217
        break;
Packit 971217
      case GST_RIFF_INFO_ITRK:
Packit 971217
        type = GST_TAG_TRACK_NUMBER;
Packit 971217
        break;
Packit 971217
      default:
Packit 971217
        type = NULL;
Packit 971217
        GST_WARNING_OBJECT (element,
Packit 971217
            "Unknown INFO (metadata) tag entry %" GST_FOURCC_FORMAT,
Packit 971217
            GST_FOURCC_ARGS (tag));
Packit 971217
        break;
Packit 971217
    }
Packit 971217
Packit 971217
    if (type != NULL && ptr[0] != '\0') {
Packit 971217
      GST_DEBUG_OBJECT (element, "mapped tag %" GST_FOURCC_FORMAT " to tag %s",
Packit 971217
          GST_FOURCC_ARGS (tag), type);
Packit 971217
Packit 971217
      parse_tag_value (element, taglist, type, ptr, tsize);
Packit 971217
    }
Packit 971217
Packit 971217
    if (tsize & 1) {
Packit 971217
      tsize++;
Packit 971217
      if (tsize > left)
Packit 971217
        tsize = left;
Packit 971217
    }
Packit 971217
Packit 971217
    ptr += tsize;
Packit 971217
    left -= tsize;
Packit 971217
  }
Packit 971217
Packit 971217
  if (!gst_tag_list_is_empty (taglist)) {
Packit 971217
    GST_INFO_OBJECT (element, "extracted tags: %" GST_PTR_FORMAT, taglist);
Packit 971217
    *_taglist = taglist;
Packit 971217
  } else {
Packit 971217
    *_taglist = NULL;
Packit 971217
    gst_tag_list_unref (taglist);
Packit 971217
  }
Packit 971217
  gst_buffer_unmap (buf, &info;;
Packit 971217
Packit 971217
  return;
Packit 971217
}