blob: 75965631a84cfd5fb1c5c243d1a44389f2d2e59f [file] [log] [blame]
/* dvb-sub.c - DVB subtitle decoding
* Copyright (C) Mart Raudsepp 2009 <mart.raudsepp@artecdesign.ee>
* Copyright (C) 2010 ONELAN Ltd.
*
* Heavily uses code algorithms ported from ffmpeg's libavcodec/dvbsubdec.c,
* especially the segment parsers. The original license applies to this
* ported code and the whole code in this file as well.
*
* Original copyright information follows:
*/
/*
* DVB subtitle decoding for ffmpeg
* Copyright (c) 2005 Ian Caulfield
*
* This file is part of FFmpeg.
*
* FFmpeg is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* FFmpeg 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with FFmpeg; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
#include <string.h> /* memset */
#include <gst/gstutils.h> /* GST_READ_UINT16_BE */
#include <gst/base/gstbitreader.h> /* GstBitReader */
#include "dvb-sub.h"
GST_DEBUG_CATEGORY_STATIC (dvbsub_debug);
#define GST_CAT_DEFAULT dvbsub_debug
static void dvb_sub_init (void);
/* FIXME: Are we waiting for an acquisition point before trying to do things? */
/* FIXME: In the end convert some of the guint8/16 (especially stack variables) back to gint for access efficiency */
/**
* SECTION:dvb-sub
* @short_description: a DVB subtitle parsing class
* @stability: Unstable
*
* The #DvbSub represents an object used for parsing a DVB subpicture,
* and signalling the API user for new bitmaps to show on screen.
*/
#define AYUV(y,u,v,a) (((a) << 24) | ((y) << 16) | ((u) << 8) | (v))
#define RGBA_TO_AYUV(r,g,b,a) (((a) << 24) | ((rgb_to_y(r,g,b)) << 16) | ((rgb_to_u(r,g,b)) << 8) | (rgb_to_v(r,g,b)))
typedef struct DVBSubCLUT
{
int id; /* default_clut uses -1 for this, so guint8 isn't fine without adaptations first */
guint32 clut4[4];
guint32 clut16[16];
guint32 clut256[256];
struct DVBSubCLUT *next;
} DVBSubCLUT;
static DVBSubCLUT default_clut;
typedef struct DVBSubObjectDisplay
{
/* FIXME: Use more correct sizes */
int object_id;
int region_id;
int x_pos;
int y_pos;
int fgcolor;
int bgcolor;
/* FIXME: Should we use GSList? The relating interaction and pointer assigment is quite complex and perhaps unsuited for a plain GSList anyway */
struct DVBSubObjectDisplay *region_list_next;
struct DVBSubObjectDisplay *object_list_next;
} DVBSubObjectDisplay;
typedef struct DVBSubObject
{
/* FIXME: Use more correct sizes */
int id; /* FIXME: Use guint8 after checking it's fine in all code using it */
int type;
/* FIXME: Should we use GSList? */
DVBSubObjectDisplay *display_list;
struct DVBSubObject *next;
} DVBSubObject;
typedef struct DVBSubRegionDisplay
{ /* FIXME: Figure out if this structure is only used temporarily in page_segment parser, or also more */
int region_id;
int x_pos;
int y_pos;
struct DVBSubRegionDisplay *next;
} DVBSubRegionDisplay;
typedef struct DVBSubRegion
{
guint8 id;
guint16 width;
guint16 height;
guint8 depth; /* If we want to make this a guint8, then need to ensure it isn't wrap around with reserved values in region handling code */
guint8 clut;
guint8 bgcolor;
/* FIXME: Validate these fields existence and exact types */
guint8 *pbuf;
int buf_size;
DVBSubObjectDisplay *display_list;
struct DVBSubRegion *next;
} DVBSubRegion;
struct _DvbSub
{
DvbSubCallbacks callbacks;
gpointer user_data;
guint8 page_time_out;
DVBSubRegion *region_list;
DVBSubCLUT *clut_list;
DVBSubObject *object_list;
/* FIXME... */
int display_list_size;
DVBSubRegionDisplay *display_list;
GString *pes_buffer;
DVBSubtitleWindow display_def;
};
typedef enum
{
TOP_FIELD = 0,
BOTTOM_FIELD = 1
} DvbSubPixelDataSubBlockFieldType;
static inline gint
rgb_to_y (gint r, gint g, gint b)
{
gint ret;
ret = (gint) (((19595 * r) >> 16) + ((38470 * g) >> 16) + ((7471 * b) >> 16));
ret = CLAMP (ret, 0, 255);
return ret;
}
static inline gint
rgb_to_u (gint r, gint g, gint b)
{
gint ret;
ret =
(gint) (-((11059 * r) >> 16) - ((21709 * g) >> 16) + ((32768 * b) >> 16) +
128);
ret = CLAMP (ret, 0, 255);
return ret;
}
static inline gint
rgb_to_v (gint r, gint g, gint b)
{
gint ret;
ret =
(gint) (((32768 * r) >> 16) - ((27439 * g) >> 16) - ((5329 * b) >> 16) +
128);
ret = CLAMP (ret, 0, 255);
return ret;
}
static DVBSubObject *
get_object (DvbSub * dvb_sub, guint16 object_id)
{
DVBSubObject *ptr = dvb_sub->object_list;
while (ptr && ptr->id != object_id) {
ptr = ptr->next;
}
return ptr;
}
static DVBSubCLUT *
get_clut (DvbSub * dvb_sub, gint clut_id)
{
DVBSubCLUT *ptr = dvb_sub->clut_list;
while (ptr && ptr->id != clut_id) {
ptr = ptr->next;
}
return ptr;
}
static DVBSubRegion *
get_region (DvbSub * dvb_sub, guint8 region_id)
{
DVBSubRegion *ptr = dvb_sub->region_list;
while (ptr && ptr->id != region_id) {
ptr = ptr->next;
}
return ptr;
}
static void
delete_region_display_list (DvbSub * dvb_sub, DVBSubRegion * region)
{
DVBSubObject *object, *obj2;
DVBSubObject **obj2_ptr;
DVBSubObjectDisplay *display, *obj_disp, **obj_disp_ptr;
while (region->display_list) {
display = region->display_list;
object = get_object (dvb_sub, display->object_id);
if (object) {
obj_disp_ptr = &object->display_list;
obj_disp = *obj_disp_ptr;
while (obj_disp && obj_disp != display) {
obj_disp_ptr = &obj_disp->object_list_next;
obj_disp = *obj_disp_ptr;
}
if (obj_disp) {
*obj_disp_ptr = obj_disp->object_list_next;
if (!object->display_list) {
obj2_ptr = (DVBSubObject **) & dvb_sub->object_list; /* FIXME: Evil casting */
obj2 = *obj2_ptr;
while (obj2 != object) {
g_assert (obj2);
obj2_ptr = &obj2->next;
obj2 = *obj2_ptr;
}
*obj2_ptr = obj2->next;
g_slice_free (DVBSubObject, obj2);
}
}
}
region->display_list = display->region_list_next;
g_slice_free (DVBSubObjectDisplay, display);
}
}
static void
delete_state (DvbSub * dvb_sub)
{
DVBSubRegion *region;
while (dvb_sub->region_list) {
region = dvb_sub->region_list;
dvb_sub->region_list = region->next;
delete_region_display_list (dvb_sub, region);
g_free (region->pbuf);
g_slice_free (DVBSubRegion, region);
}
g_slice_free_chain (DVBSubCLUT, dvb_sub->clut_list, next);
dvb_sub->clut_list = NULL;
/* Should already be NULL */
g_warn_if_fail (dvb_sub->object_list == NULL);
}
static void
dvb_sub_init (void)
{
int i, r, g, b, a = 0;
GST_DEBUG_CATEGORY_INIT (dvbsub_debug, "dvbsub", 0, "dvbsuboverlay parser");
/* Initialize the static default_clut structure, from which other clut
* structures are initialized from (to start off with default CLUTs
* as defined in the specification). */
default_clut.id = -1;
default_clut.clut4[0] = RGBA_TO_AYUV (0, 0, 0, 0);
default_clut.clut4[1] = RGBA_TO_AYUV (255, 255, 255, 255);
default_clut.clut4[2] = RGBA_TO_AYUV (0, 0, 0, 255);
default_clut.clut4[3] = RGBA_TO_AYUV (127, 127, 127, 255);
default_clut.clut16[0] = RGBA_TO_AYUV (0, 0, 0, 0);
for (i = 1; i < 16; i++) {
if (i < 8) {
r = (i & 1) ? 255 : 0;
g = (i & 2) ? 255 : 0;
b = (i & 4) ? 255 : 0;
} else {
r = (i & 1) ? 127 : 0;
g = (i & 2) ? 127 : 0;
b = (i & 4) ? 127 : 0;
}
default_clut.clut16[i] = RGBA_TO_AYUV (r, g, b, 255);
}
default_clut.clut256[0] = RGBA_TO_AYUV (0, 0, 0, 0);
for (i = 1; i < 256; i++) {
if (i < 8) {
r = (i & 1) ? 255 : 0;
g = (i & 2) ? 255 : 0;
b = (i & 4) ? 255 : 0;
a = 63;
} else {
switch (i & 0x88) {
case 0x00:
r = ((i & 1) ? 85 : 0) + ((i & 0x10) ? 170 : 0);
g = ((i & 2) ? 85 : 0) + ((i & 0x20) ? 170 : 0);
b = ((i & 4) ? 85 : 0) + ((i & 0x40) ? 170 : 0);
a = 255;
break;
case 0x08:
r = ((i & 1) ? 85 : 0) + ((i & 0x10) ? 170 : 0);
g = ((i & 2) ? 85 : 0) + ((i & 0x20) ? 170 : 0);
b = ((i & 4) ? 85 : 0) + ((i & 0x40) ? 170 : 0);
a = 127;
break;
case 0x80:
r = 127 + ((i & 1) ? 43 : 0) + ((i & 0x10) ? 85 : 0);
g = 127 + ((i & 2) ? 43 : 0) + ((i & 0x20) ? 85 : 0);
b = 127 + ((i & 4) ? 43 : 0) + ((i & 0x40) ? 85 : 0);
a = 255;
break;
case 0x88:
r = ((i & 1) ? 43 : 0) + ((i & 0x10) ? 85 : 0);
g = ((i & 2) ? 43 : 0) + ((i & 0x20) ? 85 : 0);
b = ((i & 4) ? 43 : 0) + ((i & 0x40) ? 85 : 0);
a = 255;
break;
}
}
default_clut.clut256[i] = RGBA_TO_AYUV (r, g, b, a);
}
}
static void
_dvb_sub_parse_page_segment (DvbSub * dvb_sub, guint16 page_id, guint8 * buf,
gint buf_size)
{ /* FIXME: Use guint for buf_size here and in many other places? */
DVBSubRegionDisplay *display;
DVBSubRegionDisplay *tmp_display_list, **tmp_ptr;
const guint8 *buf_end = buf + buf_size;
guint8 region_id;
guint8 page_state;
if (buf_size < 1)
return;
dvb_sub->page_time_out = *buf++;
page_state = ((*buf++) >> 2) & 3;
#ifndef GST_DISABLE_GST_DEBUG
{
static const gchar *page_state_str[4] = {
"Normal case", "ACQUISITION POINT", "Mode Change", "RESERVED"
};
GST_DEBUG ("PAGE: page_id = %u, length = %d, page_time_out = %u secs, "
"page_state = %s", page_id, buf_size, dvb_sub->page_time_out,
page_state_str[page_state]);
}
#endif
if (page_state == 2) { /* Mode change */
delete_state (dvb_sub);
}
tmp_display_list = dvb_sub->display_list;
dvb_sub->display_list = NULL;
dvb_sub->display_list_size = 0;
while (buf + 5 < buf_end) {
region_id = *buf++;
buf += 1;
display = tmp_display_list;
tmp_ptr = &tmp_display_list;
while (display && display->region_id != region_id) {
tmp_ptr = &display->next;
display = display->next;
}
if (!display)
display = g_slice_new0 (DVBSubRegionDisplay);
display->region_id = region_id;
display->x_pos = GST_READ_UINT16_BE (buf);
buf += 2;
display->y_pos = GST_READ_UINT16_BE (buf);
buf += 2;
*tmp_ptr = display->next;
display->next = dvb_sub->display_list;
dvb_sub->display_list = display;
dvb_sub->display_list_size++;
GST_LOG ("PAGE: REGION information: ID = %u, address = %ux%u", region_id,
display->x_pos, display->y_pos);
}
while (tmp_display_list) {
display = tmp_display_list;
tmp_display_list = display->next;
g_slice_free (DVBSubRegionDisplay, display);
}
}
static void
_dvb_sub_parse_region_segment (DvbSub * dvb_sub, guint16 page_id, guint8 * buf,
gint buf_size)
{
const guint8 *buf_end = buf + buf_size;
guint8 region_id;
guint16 object_id;
DVBSubRegion *region;
DVBSubObject *object;
DVBSubObjectDisplay *object_display;
gboolean fill;
if (buf_size < 10)
return;
region_id = *buf++;
region = get_region (dvb_sub, region_id);
if (!region) { /* Create a new region */
region = g_slice_new0 (DVBSubRegion);
region->id = region_id;
region->next = dvb_sub->region_list;
dvb_sub->region_list = region;
}
fill = ((*buf++) >> 3) & 1;
region->width = GST_READ_UINT16_BE (buf);
buf += 2;
region->height = GST_READ_UINT16_BE (buf);
buf += 2;
if (region->width * region->height != region->buf_size) { /* FIXME: Read closer from spec what happens when dimensions change */
g_free (region->pbuf);
region->buf_size = region->width * region->height;
region->pbuf = g_malloc (region->buf_size); /* TODO: We can probably use GSlice here if careful about freeing while buf_size still records the correct size */
fill = 1; /* FIXME: Validate from spec that fill is forced on (in the following codes context) when dimensions change */
}
region->depth = 1 << (((*buf++) >> 2) & 7);
if (region->depth < 2 || region->depth > 8) {
GST_WARNING ("region depth %d is invalid", region->depth);
region->depth = 4; /* FIXME: Check from spec this is the default? */
}
region->clut = *buf++;
if (region->depth == 8) {
region->bgcolor = *buf++;
buf += 1; /* Skip undefined 4-bit and 2-bit field */
} else {
buf += 1;
if (region->depth == 4)
region->bgcolor = (((*buf++) >> 4) & 15);
else
region->bgcolor = (((*buf++) >> 2) & 3);
}
GST_DEBUG ("REGION: id = %u, (%ux%u)@%u-bit", region_id, region->width,
region->height, region->depth);
if (fill) {
memset (region->pbuf, region->bgcolor, region->buf_size);
GST_DEBUG ("REGION: filling region (%u) with bgcolor = %u", region->id,
region->bgcolor);
}
delete_region_display_list (dvb_sub, region); /* Delete the region display list for current region - FIXME: why? */
while (buf + 6 <= buf_end) {
object_id = GST_READ_UINT16_BE (buf);
buf += 2;
object = get_object (dvb_sub, object_id);
if (!object) {
object = g_slice_new0 (DVBSubObject);
object->id = object_id;
object->next = dvb_sub->object_list;
dvb_sub->object_list = object;
}
object->type = (*buf) >> 6;
object_display = g_slice_new0 (DVBSubObjectDisplay);
object_display->object_id = object_id;
object_display->region_id = region_id;
object_display->x_pos = GST_READ_UINT16_BE (buf) & 0xfff;
buf += 2;
object_display->y_pos = GST_READ_UINT16_BE (buf) & 0xfff;
buf += 2;
if ((object->type == 1 || object->type == 2) && buf + 2 <= buf_end) {
object_display->fgcolor = *buf++;
object_display->bgcolor = *buf++;
}
object_display->region_list_next = region->display_list;
region->display_list = object_display;
object_display->object_list_next = object->display_list;
object->display_list = object_display;
GST_DEBUG ("REGION DATA: object_id = %u, region_id = %u, pos = %ux%u, "
"obj_type = %u", object->id, region->id, object_display->x_pos,
object_display->y_pos, object->type);
if (object->type == 1 || object->type == 2) {
GST_DEBUG ("REGION DATA: fgcolor = %u, bgcolor = %u",
object_display->fgcolor, object_display->bgcolor);
}
}
}
static void
_dvb_sub_parse_clut_segment (DvbSub * dvb_sub, guint16 page_id, guint8 * buf,
gint buf_size)
{
const guint8 *buf_end = buf + buf_size;
guint8 clut_id;
DVBSubCLUT *clut;
int entry_id, depth, full_range;
int y, cr, cb, alpha;
GST_MEMDUMP ("DVB clut packet", buf, buf_size);
clut_id = *buf++;
buf += 1;
clut = get_clut (dvb_sub, clut_id);
if (!clut) {
clut = g_slice_new (DVBSubCLUT);
memcpy (clut, &default_clut, sizeof (DVBSubCLUT));
clut->id = clut_id;
clut->next = dvb_sub->clut_list;
dvb_sub->clut_list = clut;
}
while (buf + 4 < buf_end) {
entry_id = *buf++;
depth = (*buf) & 0xe0;
if (depth == 0) {
GST_WARNING ("Invalid clut depth 0x%x!", *buf);
return;
}
full_range = (*buf++) & 1;
if (full_range) {
y = *buf++;
cr = *buf++;
cb = *buf++;
alpha = *buf++;
} else {
y = buf[0] & 0xfc;
cr = (((buf[0] & 3) << 2) | ((buf[1] >> 6) & 3)) << 4;
cb = (buf[1] << 2) & 0xf0;
alpha = (buf[1] << 6) & 0xc0;
buf += 2;
}
if (y == 0)
alpha = 0xff;
GST_DEBUG ("CLUT DEFINITION: clut %d := (%d,%d,%d,%d)", entry_id, y, cb, cr,
alpha);
if (depth & 0x80)
clut->clut4[entry_id] = AYUV (y, cb, cr, 255 - alpha);
if (depth & 0x40)
clut->clut16[entry_id] = AYUV (y, cb, cr, 255 - alpha);
if (depth & 0x20)
clut->clut256[entry_id] = AYUV (y, cb, cr, 255 - alpha);
}
}
// FFMPEG-FIXME: The same code in ffmpeg is much more complex, it could use the same
// FFMPEG-FIXME: refactoring as done here
static int
_dvb_sub_read_2bit_string (guint8 * destbuf, gint dbuf_len,
const guint8 ** srcbuf, gint buf_size, guint8 non_mod, guint8 * map_table)
{
GstBitReader gb = GST_BIT_READER_INIT (*srcbuf, buf_size);
/* FIXME: Handle FALSE returns from gst_bit_reader_get_* calls? */
gboolean stop_parsing = FALSE;
guint32 bits = 0;
guint32 pixels_read = 0;
GST_TRACE ("dbuf_len = %d", dbuf_len);
/* Need at least 2 bits remaining */
while (!stop_parsing && (gst_bit_reader_get_remaining (&gb) > 1)) {
guint run_length = 0, clut_index = 0;
bits = gst_bit_reader_get_bits_uint32_unchecked (&gb, 2);
if (bits) { /* 2-bit_pixel-code */
run_length = 1;
clut_index = bits;
} else { /* 2-bit_zero */
bits = gst_bit_reader_get_bits_uint32_unchecked (&gb, 1);
if (bits == 1) { /* switch_1 == '1' */
run_length = gst_bit_reader_get_bits_uint32_unchecked (&gb, 3);
run_length += 3;
clut_index = gst_bit_reader_get_bits_uint32_unchecked (&gb, 2);
} else { /* switch_1 == '0' */
bits = gst_bit_reader_get_bits_uint32_unchecked (&gb, 1);
if (bits == 1) { /* switch_2 == '1' */
run_length = 1; /* 1x pseudo-colour '00' */
} else { /* switch_2 == '0' */
bits = gst_bit_reader_get_bits_uint32_unchecked (&gb, 2);
switch (bits) { /* switch_3 */
case 0x0: /* end of 2-bit/pixel_code_string */
stop_parsing = TRUE;
break;
case 0x1: /* two pixels shall be set to pseudo colour (entry) '00' */
run_length = 2;
break;
case 0x2: /* the following 6 bits contain run length coded pixel data */
run_length = gst_bit_reader_get_bits_uint32_unchecked (&gb, 4);
run_length += 12;
clut_index = gst_bit_reader_get_bits_uint32_unchecked (&gb, 2);
break;
case 0x3: /* the following 10 bits contain run length coded pixel data */
run_length = gst_bit_reader_get_bits_uint32_unchecked (&gb, 8);
run_length += 29;
clut_index = gst_bit_reader_get_bits_uint32_unchecked (&gb, 2);
break;
}
}
}
}
/* If run_length is zero, continue. Only case happening is when
* stop_parsing is TRUE too, so next cycle shouldn't run */
if (run_length == 0)
continue;
/* Trim the run_length to not go beyond the line end and consume
* it from remaining length of dest line */
run_length = MIN (run_length, dbuf_len);
dbuf_len -= run_length;
/* Make clut_index refer to the index into the desired bit depths
* CLUT definition table */
if (map_table)
clut_index = map_table[clut_index]; /* now clut_index signifies the index into map_table dest */
/* Now we can simply memset run_length count of destination bytes
* to clut_index, but only if not non_modifying */
GST_TRACE ("RUNLEN: setting %u pixels to color 0x%x in destination buffer, "
"dbuf_len left is %d pixels", run_length, clut_index, dbuf_len);
if (!(non_mod == 1 && clut_index == 1))
memset (destbuf, clut_index, run_length);
destbuf += run_length;
pixels_read += run_length;
}
// FIXME: Test skip_to_byte instead of adding 7 bits, once everything else is working good
//gst_bit_reader_skip_to_byte (&gb);
*srcbuf += (gst_bit_reader_get_pos (&gb) + 7) >> 3;
GST_TRACE ("PIXEL: returning, read %u pixels", pixels_read);
// FIXME: Shouldn't need this variable if tracking things in the loop better
return pixels_read;
}
// FFMPEG-FIXME: The same code in ffmpeg is much more complex, it could use the same
// FFMPEG-FIXME: refactoring as done here, explained in commit 895296c3
static int
_dvb_sub_read_4bit_string (guint8 * destbuf, gint dbuf_len,
const guint8 ** srcbuf, gint buf_size, guint8 non_mod, guint8 * map_table)
{
GstBitReader gb = GST_BIT_READER_INIT (*srcbuf, buf_size);
/* FIXME: Handle FALSE returns from gst_bit_reader_get_* calls? */
gboolean stop_parsing = FALSE;
guint32 bits = 0;
guint32 pixels_read = 0;
GST_TRACE ("RUNLEN: srcbuf position %p, buf_size = %d; destination buffer "
"size is %d @ %p", *srcbuf, buf_size, dbuf_len, destbuf);
/* Need at least 4 bits */
while (!stop_parsing && (gst_bit_reader_get_remaining (&gb) > 3)) {
guint run_length = 0, clut_index = 0;
bits = gst_bit_reader_get_bits_uint32_unchecked (&gb, 4);
if (bits) {
run_length = 1;
clut_index = bits;
} else {
bits = gst_bit_reader_get_bits_uint32_unchecked (&gb, 1);
if (bits == 0) { /* switch_1 == '0' */
run_length = gst_bit_reader_get_bits_uint32_unchecked (&gb, 3);
if (!run_length) {
stop_parsing = TRUE;
} else {
run_length += 2;
}
} else { /* switch_1 == '1' */
bits = gst_bit_reader_get_bits_uint32_unchecked (&gb, 1);
if (bits == 0) { /* switch_2 == '0' */
run_length = gst_bit_reader_get_bits_uint32_unchecked (&gb, 2);
run_length += 4;
clut_index = gst_bit_reader_get_bits_uint32_unchecked (&gb, 4);
} else { /* switch_2 == '1' */
bits = gst_bit_reader_get_bits_uint32_unchecked (&gb, 2);
switch (bits) {
case 0x0: /* switch_3 == '00' */
run_length = 1; /* 1 pixel of pseudo-color 0 */
break;
case 0x1: /* switch_3 == '01' */
run_length = 2; /* 2 pixels of pseudo-color 0 */
break;
case 0x2: /* switch_3 == '10' */
run_length = gst_bit_reader_get_bits_uint32_unchecked (&gb, 4);
run_length += 9;
clut_index = gst_bit_reader_get_bits_uint32_unchecked (&gb, 4);
break;
case 0x3: /* switch_3 == '11' */
run_length = gst_bit_reader_get_bits_uint32_unchecked (&gb, 8);
run_length += 25;
clut_index = gst_bit_reader_get_bits_uint32_unchecked (&gb, 4);
break;
}
}
}
}
/* If run_length is zero, continue. Only case happening is when
* stop_parsing is TRUE too, so next cycle shouldn't run */
if (run_length == 0)
continue;
/* Trim the run_length to not go beyond the line end and consume
* it from remaining length of dest line */
run_length = MIN (run_length, dbuf_len);
dbuf_len -= run_length;
/* Make clut_index refer to the index into the desired bit depths
* CLUT definition table */
if (map_table)
clut_index = map_table[clut_index]; /* now clut_index signifies the index into map_table dest */
/* Now we can simply memset run_length count of destination bytes
* to clut_index, but only if not non_modifying */
GST_TRACE ("RUNLEN: setting %u pixels to color 0x%x in destination buffer; "
"dbuf_len left is %d pixels", run_length, clut_index, dbuf_len);
if (!(non_mod == 1 && clut_index == 1))
memset (destbuf, clut_index, run_length);
destbuf += run_length;
pixels_read += run_length;
}
// FIXME: Test skip_to_byte instead of adding 7 bits, once everything else is working good
//gst_bit_reader_skip_to_byte (&gb);
*srcbuf += (gst_bit_reader_get_pos (&gb) + 7) >> 3;
GST_LOG ("Returning with %u pixels read", pixels_read);
// FIXME: Shouldn't need this variable if tracking things in the loop better
return pixels_read;
}
static int
_dvb_sub_read_8bit_string (guint8 * destbuf, gint dbuf_len,
const guint8 ** srcbuf, gint buf_size, guint8 non_mod, guint8 * map_table)
{
GstBitReader gb = GST_BIT_READER_INIT (*srcbuf, buf_size);
/* FIXME: Handle FALSE returns from gst_bit_reader_get_* calls? */
gboolean stop_parsing = FALSE;
guint32 bits = 0;
guint32 pixels_read = 0;
GST_LOG ("dbuf_len = %d", dbuf_len);
/* FFMPEG-FIXME: ffmpeg uses a manual byte walking algorithm, which might be more performant,
* FFMPEG-FIXME: but it does almost absolutely no buffer length checking, so could walk over
* FFMPEG-FIXME: memory boundaries. While we don't check gst_bit_reader_get_bits_uint32
* FFMPEG-FIXME: return values either and therefore might get some pixels corrupted, we at
* FFMPEG-FIXME: lest have no chance of reading memory we don't own and visual corruption
* FFMPEG-FIXME: is guaranteed anyway when not all bytes are present */
/* Rephrased - it's better to work with bytes with default value '0' instead of reading from memory we don't own. */
while (!stop_parsing && (gst_bit_reader_get_remaining (&gb) > 7)) {
guint run_length = 0, clut_index = 0;
bits = gst_bit_reader_get_bits_uint32_unchecked (&gb, 8);
if (bits) { /* 8-bit_pixel-code */
run_length = 1;
clut_index = bits;
} else { /* 8-bit_zero */
bits = gst_bit_reader_get_bits_uint32_unchecked (&gb, 1);
if (bits == 0) { /* switch_1 == '0' */
/* run_length_1-127 for pseudo-colour _entry) '0x00' */
run_length = gst_bit_reader_get_bits_uint32_unchecked (&gb, 7);
if (run_length == 0) { /* end_of_string_signal */
stop_parsing = TRUE;
}
} else { /* switch_1 == '1' */
/* run_length_3-127 */
run_length = gst_bit_reader_get_bits_uint32_unchecked (&gb, 7);
clut_index = gst_bit_reader_get_bits_uint32_unchecked (&gb, 8);
if (run_length < 3) {
GST_WARNING ("runlength value was %u, but the spec requires it "
"must be >=3", run_length);
}
}
}
/* If run_length is zero, continue. Only case happening is when
* stop_parsing is TRUE too, so next cycle shouldn't run */
if (run_length == 0)
continue;
/* Trim the run_length to not go beyond the line end and consume
* it from remaining length of dest line */
run_length = MIN (run_length, dbuf_len);
dbuf_len -= run_length;
/* Make clut_index refer to the index into the desired bit depths
* CLUT definition table */
if (map_table)
clut_index = map_table[clut_index]; /* now clut_index signifies the index into map_table dest */
/* Now we can simply memset run_length count of destination bytes
* to clut_index, but only if not non_modifying */
GST_TRACE ("RUNLEN: setting %u pixels to color 0x%x in destination buffer; "
"dbuf_len left is %d pixels", run_length, clut_index, dbuf_len);
if (!(non_mod == 1 && clut_index == 1))
memset (destbuf, clut_index, run_length);
destbuf += run_length;
pixels_read += run_length;
}
GST_LOG ("Returning with %u pixels read", pixels_read);
*srcbuf += (gst_bit_reader_get_pos (&gb) + 7) >> 3;
// FIXME: Shouldn't need this variable if tracking things in the loop better
return pixels_read;
}
static void
_dvb_sub_parse_pixel_data_block (DvbSub * dvb_sub,
DVBSubObjectDisplay * display, const guint8 * buf, gint buf_size,
DvbSubPixelDataSubBlockFieldType top_bottom, guint8 non_mod)
{
DVBSubRegion *region = get_region (dvb_sub, display->region_id);
const guint8 *buf_end = buf + buf_size;
guint8 *pbuf;
int x_pos, y_pos;
int i;
gboolean dest_buf_filled = FALSE;
guint8 map2to4[] = { 0x0, 0x7, 0x8, 0xf };
guint8 map2to8[] = { 0x00, 0x77, 0x88, 0xff };
guint8 map4to8[] = { 0x00, 0x11, 0x22, 0x33, 0x44, 0x55, 0x66, 0x77,
0x88, 0x99, 0xaa, 0xbb, 0xcc, 0xdd, 0xee, 0xff
};
guint8 *map_table;
GST_LOG ("DVB pixel block size %d, %s field:", buf_size,
top_bottom ? "bottom" : "top");
GST_MEMDUMP ("packet", buf, buf_size);
if (region == NULL) {
GST_LOG ("Region is NULL, returning");
return;
}
pbuf = region->pbuf;
x_pos = display->x_pos;
y_pos = display->y_pos;
if ((y_pos & 1) != top_bottom)
y_pos++;
while (buf < buf_end) {
GST_LOG ("Iteration start, %u bytes remaining; buf = %p, "
"buf_end = %p; Region is number %u, with a dimension of %dx%d; "
"We are at position %dx%d", (guint) (buf_end - buf), buf, buf_end,
region->id, region->width, region->height, x_pos, y_pos);
// FFMPEG-FIXME: ffmpeg doesn't check for equality and so can overflow destination buffer later on with bad input data
// FFMPEG-FIXME: However that makes it warn on end_of_object_line and map tables as well, so we add the dest_buf_filled tracking
// FIXME: Removed x_pos checking here, because we don't want to turn dest_buf_filled to TRUE permanently in that case
// FIXME: We assume that region->width - x_pos as dbuf_len to read_nbit_string will take care of that case nicely;
// FIXME: That is, that read_nbit_string never scribbles anything if dbuf_len passed to it is zero due to this.
if (y_pos >= region->height) {
dest_buf_filled = TRUE;
}
switch (*buf++) {
case 0x10:
if (dest_buf_filled) {
/* FIXME: Be more verbose */
GST_WARNING ("Invalid object location for data_type 0x%x!",
*(buf - 1));
GST_MEMDUMP ("Remaining data after invalid object location:", buf,
(guint) (buf_end - buf));
return;
}
if (region->depth == 8)
map_table = map2to8;
else if (region->depth == 4)
map_table = map2to4;
else
map_table = NULL;
// FFMPEG-FIXME: ffmpeg code passes buf_size instead of buf_end - buf, and could
// FFMPEG-FIXME: therefore potentially walk over the memory area we own
x_pos +=
_dvb_sub_read_2bit_string (pbuf + (y_pos * region->width) + x_pos,
region->width - x_pos, &buf, buf_end - buf, non_mod, map_table);
break;
case 0x11:
if (dest_buf_filled) {
/* FIXME: Be more verbose */
GST_WARNING ("Invalid object location for data_type 0x%x!",
*(buf - 1));
GST_MEMDUMP ("Remaining data after invalid object location:", buf,
buf_end - buf);
return; // FIXME: Perhaps tell read_nbit_string that dbuf_len is zero and let it walk the bytes regardless? (Same FIXME for 2bit and 8bit)
}
if (region->depth < 4) {
GST_WARNING ("4-bit pixel string in %d-bit region!", region->depth);
return;
}
if (region->depth == 8)
map_table = map4to8;
else
map_table = NULL;
GST_LOG ("READ_4BIT_STRING: String data into position %dx%d; "
"buf before is %p", x_pos, y_pos, buf);
// FFMPEG-FIXME: ffmpeg code passes buf_size instead of buf_end - buf, and could
// FFMPEG-FIXME: therefore potentially walk over the memory area we own
x_pos +=
_dvb_sub_read_4bit_string (pbuf + (y_pos * region->width) + x_pos,
region->width - x_pos, &buf, buf_end - buf, non_mod, map_table);
GST_DEBUG ("READ_4BIT_STRING finished: buf pointer now %p", buf);
break;
case 0x12:
if (dest_buf_filled) {
/* FIXME: Be more verbose */
GST_WARNING ("Invalid object location for data_type 0x%x!",
*(buf - 1));
GST_MEMDUMP ("Remaining data after invalid object location:",
buf, (guint) (buf_end - buf));
return;
}
if (region->depth < 8) {
GST_WARNING ("8-bit pixel string in %d-bit region!", region->depth);
return;
}
// FFMPEG-FIXME: ffmpeg code passes buf_size instead of buf_end - buf, and could
// FFMPEG-FIXME: therefore potentially walk over the memory area we own
x_pos +=
_dvb_sub_read_8bit_string (pbuf + (y_pos * region->width) + x_pos,
region->width - x_pos, &buf, buf_end - buf, non_mod, NULL);
break;
case 0x20:
GST_DEBUG ("handling map2to4 table data");
/* FIXME: I don't see any guards about buffer size here - buf++ happens with the switch, but
* FIXME: buffer is walked without length checks? Same deal in other map table cases */
map2to4[0] = (*buf) >> 4;
map2to4[1] = (*buf++) & 0xf;
map2to4[2] = (*buf) >> 4;
map2to4[3] = (*buf++) & 0xf;
break;
case 0x21:
GST_DEBUG ("handling map2to8 table data");
for (i = 0; i < 4; i++)
map2to8[i] = *buf++;
break;
case 0x22:
GST_DEBUG ("handling map4to8 table data");
for (i = 0; i < 16; i++)
map4to8[i] = *buf++;
break;
case 0xf0:
GST_DEBUG ("end of object line code encountered");
x_pos = display->x_pos;
y_pos += 2;
break;
default:
/* FIXME: Do we consume word align stuffing byte that could follow top/bottom data? */
GST_WARNING ("Unknown/unsupported pixel block 0x%x", *(buf - 1));
}
}
}
static void
_dvb_sub_parse_object_segment (DvbSub * dvb_sub, guint16 page_id, guint8 * buf,
gint buf_size)
{
const guint8 *buf_end = buf + buf_size;
guint object_id;
DVBSubObject *object;
guint8 coding_method, non_modifying_color;
object_id = GST_READ_UINT16_BE (buf);
buf += 2;
object = get_object (dvb_sub, object_id);
GST_DEBUG ("OBJECT: a new object segment has occurred for object_id = %u",
object_id);
if (!object) {
GST_WARNING ("Nothing known about object with ID %u yet, bailing out",
object_id);
return;
}
coding_method = ((*buf) >> 2) & 3;
non_modifying_color = ((*buf++) >> 1) & 1;
if (coding_method == 0) {
const guint8 *block;
DVBSubObjectDisplay *display;
guint16 top_field_len, bottom_field_len;
top_field_len = GST_READ_UINT16_BE (buf);
buf += 2;
bottom_field_len = GST_READ_UINT16_BE (buf);
buf += 2;
if (buf + top_field_len + bottom_field_len > buf_end) {
GST_WARNING ("Field data size too large");
return;
}
/* FIXME: Potential optimization opportunity here - parse the object pixmap only once, and copy it to all the
* FIXME: regions that need it. One object being in multiple regions is a rare occurrence in real life, however */
for (display = object->display_list; display;
display = display->object_list_next) {
block = buf;
GST_DEBUG ("OBJECT: parsing top and bottom part of object id %d; "
"top_field_len = %u, bottom_field_len = %u",
display->object_id, top_field_len, bottom_field_len);
_dvb_sub_parse_pixel_data_block (dvb_sub, display, block, top_field_len,
TOP_FIELD, non_modifying_color);
if (bottom_field_len > 0)
block = buf + top_field_len;
else
bottom_field_len = top_field_len;
_dvb_sub_parse_pixel_data_block (dvb_sub, display, block,
bottom_field_len, BOTTOM_FIELD, non_modifying_color);
}
} else if (coding_method == 1) {
GST_FIXME ("'a string of characters' coding method not supported yet!");
} else {
GST_WARNING ("Unknown object coding 0x%x", coding_method);
}
}
static gint
_dvb_sub_parse_display_definition_segment (DvbSub * dvb_sub, guint8 * buf,
gint buf_size)
{
int dds_version, info_byte;
if (buf_size < 5)
return -1;
info_byte = *buf++;
dds_version = info_byte >> 4;
if (dvb_sub->display_def.version == dds_version)
return 0; /* already have this display definition version */
dvb_sub->display_def.version = dds_version;
dvb_sub->display_def.display_width = GST_READ_UINT16_BE (buf) + 1;
buf += 2;
dvb_sub->display_def.display_height = GST_READ_UINT16_BE (buf) + 1;
buf += 2;
dvb_sub->display_def.window_flag = info_byte & 1 << 3;
if (buf_size >= 13 && dvb_sub->display_def.window_flag) {
dvb_sub->display_def.window_x = GST_READ_UINT16_BE (buf);
buf += 2;
dvb_sub->display_def.window_width =
GST_READ_UINT16_BE (buf) - dvb_sub->display_def.window_x + 1;
buf += 2;
dvb_sub->display_def.window_y = GST_READ_UINT16_BE (buf);
buf += 2;
dvb_sub->display_def.window_height =
GST_READ_UINT16_BE (buf) - dvb_sub->display_def.window_y + 1;
}
return 0;
}
static gint
_dvb_sub_parse_end_of_display_set (DvbSub * dvb_sub, guint16 page_id,
guint64 pts)
{
DVBSubRegionDisplay *display;
DVBSubtitles *sub;
DVBSubCLUT *clut;
guint32 *clut_table;
int i;
GST_DEBUG ("DISPLAY SET END: page_id = %u", page_id);
sub = g_slice_new0 (DVBSubtitles);
#if 0 /* FIXME: PTS stuff not figured out yet */
sub->start_display_time = 0;
sub->end_display_time = priv->page_time_out * 1000;
sub->format = 0; /* 0 = graphics */
#endif
/* N.B. g_new0() will return NULL if num_rects is 0 */
sub->num_rects = dvb_sub->display_list_size;
sub->rects = g_new0 (DVBSubtitleRect, sub->num_rects);
i = 0;
/* copy subtitle display and window information */
sub->display_def = dvb_sub->display_def;
for (display = dvb_sub->display_list; display; display = display->next) {
DVBSubtitleRect *rect;
DVBSubRegion *region;
region = get_region (dvb_sub, display->region_id);
if (!region)
continue;
rect = &sub->rects[i];
rect->x = display->x_pos;
rect->y = display->y_pos;
rect->w = region->width;
rect->h = region->height;
#if 0 /* FIXME: Don't think we need to save the number of colors in the palette when we are saving as RGBA? */
rect->nb_colors = 16;
#endif
#if 0 /* FIXME: Needed to be specified once we support strings of characters based subtitles */
rect->type = SUBTITLE_BITMAP;
#endif
rect->pict.rowstride = region->width;
rect->pict.palette_bits_count = region->depth;
clut = get_clut (dvb_sub, region->clut);
if (!clut)
clut = &default_clut;
switch (region->depth) {
case 2:
clut_table = clut->clut4;
break;
case 8:
clut_table = clut->clut256;
break;
case 4:
default:
clut_table = clut->clut16;
break;
}
/* FIXME: Tweak this to be saved in a format most suitable for Qt and GStreamer instead.
* Currently kept in AVPicture for quick save_display_set testing */
rect->pict.palette = g_malloc ((1 << region->depth) * sizeof (guint32)); /* FIXME: Can we use GSlice here? */
memcpy (rect->pict.palette, clut_table,
(1 << region->depth) * sizeof (guint32));
GST_MEMDUMP ("rect->pict.data.palette content",
(guint8 *) rect->pict.palette, (1 << region->depth) * sizeof (guint32));
rect->pict.data = g_malloc (region->buf_size); /* FIXME: Can we use GSlice here? */
memcpy (rect->pict.data, region->pbuf, region->buf_size);
GST_DEBUG ("DISPLAY: an object rect created: iteration %u, "
"pos: %d:%d, size: %dx%d", i, rect->x, rect->y, rect->w, rect->h);
GST_MEMDUMP ("rect->pict.data content", rect->pict.data, region->buf_size);
++i;
}
sub->pts = pts;
sub->page_time_out = dvb_sub->page_time_out;
sub->num_rects = i;
if (dvb_sub->callbacks.new_data) {
dvb_sub->callbacks.new_data (dvb_sub, sub, dvb_sub->user_data);
} else {
/* No-one responsible to clean up memory, so do it ourselves */
/* FIXME: Just don't bother with all this palette image creation in the first place then... */
dvb_subtitles_free (sub);
}
return 1; /* FIXME: The caller of this function is probably supposed to do something with the return value */
}
void
dvb_subtitles_free (DVBSubtitles * sub)
{
int i;
if (sub == NULL)
return;
/* Now free up all the temporary memory we allocated */
for (i = 0; i < sub->num_rects; ++i) {
g_free (sub->rects[i].pict.palette);
g_free (sub->rects[i].pict.data);
}
g_free (sub->rects);
g_slice_free (DVBSubtitles, sub);
}
DvbSub *
dvb_sub_new (void)
{
static gsize inited = 0;
DvbSub *sub;
if (g_once_init_enter (&inited)) {
dvb_sub_init ();
g_once_init_leave (&inited, TRUE);
}
sub = g_slice_new0 (DvbSub);
/* TODO: Add initialization code here */
/* FIXME: Do we have a reason to initiate the members to zero, or are we guaranteed that anyway? */
sub->region_list = NULL;
sub->object_list = NULL;
sub->page_time_out = 0; /* FIXME: Maybe 255 instead? */
sub->pes_buffer = g_string_new (NULL);
/* display/window information */
sub->display_def.version = -1;
sub->display_def.window_flag = 0;
sub->display_def.display_width = 720;
sub->display_def.display_height = 576;
return sub;
}
void
dvb_sub_free (DvbSub * sub)
{
/* TODO: Add deinitalization code here */
/* FIXME: Clear up region_list contents */
delete_state (sub);
while (sub->display_list) {
DVBSubRegionDisplay *tmp = sub->display_list->next;
g_slice_free (DVBSubRegionDisplay, sub->display_list);
sub->display_list = tmp;
}
g_string_free (sub->pes_buffer, TRUE);
g_slice_free (DvbSub, sub);
}
#define DVB_SUB_SEGMENT_PAGE_COMPOSITION 0x10
#define DVB_SUB_SEGMENT_REGION_COMPOSITION 0x11
#define DVB_SUB_SEGMENT_CLUT_DEFINITION 0x12
#define DVB_SUB_SEGMENT_OBJECT_DATA 0x13
#define DVB_SUB_SEGMENT_DISPLAY_DEFINITION 0x14
#define DVB_SUB_SEGMENT_END_OF_DISPLAY_SET 0x80
#define DVB_SUB_SEGMENT_STUFFING 0xFF
#define DVB_SUB_SYNC_BYTE 0x0f
/**
* dvb_sub_feed_with_pts:
* @dvb_sub: a #DvbSub
* @pts: The PTS of the data
* @data: The data to feed to the parser
* @len: Length of the data
*
* Feeds the DvbSub parser with new binary data to parse,
* with an associated PTS value. E.g, data left after PES
* packet header has been already parsed, which contains
* the PTS information).
*
* Return value: -1 if data was unhandled (e.g, not a subtitle packet),
* -2 if data parsing was unsuccesful (e.g, length was invalid),
* 0 or positive if data was handled. If positive, then amount of data consumed on success. FIXME: List the positive return values.
*/
gint
dvb_sub_feed_with_pts (DvbSub * dvb_sub, guint64 pts, guint8 * data, gint len)
{
unsigned int pos = 0;
guint8 segment_type;
guint16 segment_len;
guint16 page_id;
GST_DEBUG ("pts=%" G_GUINT64_FORMAT " and length %d", pts, len);
g_return_val_if_fail (data != NULL || len == 0, -1);
if (G_UNLIKELY (data == NULL)) {
GST_DEBUG ("no data; forcing end-of-display-set");
_dvb_sub_parse_end_of_display_set (dvb_sub, 0, pts);
return 0;
}
if (len <= 3) { /* len(0x20 0x00 end_of_PES_data_field_marker) */
GST_WARNING ("Data length too short");
return -1;
}
if (data[pos++] != 0x20) {
GST_WARNING ("Tried to handle a PES packet private data that isn't a "
"subtitle packet (does not start with 0x20)");
return -1;
}
if (data[pos++] != 0x00) {
GST_WARNING ("'Subtitle stream in this PES packet' was not 0x00, so this "
"is in theory not a DVB subtitle stream (but some other subtitle "
"standard?); bailing out");
return -1;
}
while (data[pos++] == DVB_SUB_SYNC_BYTE) {
if ((len - pos) < (2 * 2 + 1)) {
GST_WARNING ("Data after SYNC BYTE too short, less than needed to "
"even get to segment_length");
return -2;
}
segment_type = data[pos++];
GST_DEBUG ("=== Segment type is 0x%x", segment_type);
page_id = (data[pos] << 8) | data[pos + 1];
GST_DEBUG ("page_id is 0x%x", page_id);
pos += 2;
segment_len = (data[pos] << 8) | data[pos + 1];
GST_DEBUG ("segment_length is %d (0x%x 0x%x)", segment_len, data[pos],
data[pos + 1]);
pos += 2;
if ((len - pos) < segment_len) {
GST_WARNING ("segment_length was told to be %u, but we only have "
"%d bytes left", segment_len, len - pos);
return -2;
}
// TODO: Parse the segment per type (this is probably a leftover TODO that is now done?)
/* FIXME: Handle differing PTS values - all segments of a given display set must be with the same PTS,
* FIXME: but we let it slip and just take it for granted in end_of_display_set */
switch (segment_type) {
case DVB_SUB_SEGMENT_PAGE_COMPOSITION:
GST_DEBUG ("Page composition segment at buffer pos %u", pos);
_dvb_sub_parse_page_segment (dvb_sub, page_id, data + pos, segment_len); /* FIXME: Not sure about args */
break;
case DVB_SUB_SEGMENT_REGION_COMPOSITION:
GST_DEBUG ("Region composition segment at buffer pos %u", pos);
_dvb_sub_parse_region_segment (dvb_sub, page_id, data + pos, segment_len); /* FIXME: Not sure about args */
break;
case DVB_SUB_SEGMENT_CLUT_DEFINITION:
GST_DEBUG ("CLUT definition segment at buffer pos %u", pos);
_dvb_sub_parse_clut_segment (dvb_sub, page_id, data + pos, segment_len); /* FIXME: Not sure about args */
break;
case DVB_SUB_SEGMENT_OBJECT_DATA:
GST_DEBUG ("Object data segment at buffer pos %u", pos);
_dvb_sub_parse_object_segment (dvb_sub, page_id, data + pos, segment_len); /* FIXME: Not sure about args */
break;
case DVB_SUB_SEGMENT_DISPLAY_DEFINITION:
GST_DEBUG ("display definition segment at buffer pos %u", pos);
_dvb_sub_parse_display_definition_segment (dvb_sub, data + pos,
segment_len);
break;
case DVB_SUB_SEGMENT_END_OF_DISPLAY_SET:
GST_DEBUG ("End of display set at buffer pos %u", pos);
_dvb_sub_parse_end_of_display_set (dvb_sub, page_id, pts); /* FIXME: Not sure about args */
break;
default:
GST_FIXME ("Unhandled segment type 0x%x", segment_type);
break;
}
pos += segment_len;
if (pos == len) {
GST_WARNING ("Data ended without a PES data end marker");
return 1;
}
}
GST_LOG ("Processed %d bytes out of %d", pos, len);
return pos;
}
/**
* dvb_sub_set_callbacks:
* @dvb_sub: a #DvbSub
* @callbacks: the callbacks to install
* @user_data: a user_data argument for the callback
*
* Set callback which will be executed when new subpictures are available.
*/
void
dvb_sub_set_callbacks (DvbSub * dvb_sub, DvbSubCallbacks * callbacks,
gpointer user_data)
{
g_return_if_fail (dvb_sub != NULL);
g_return_if_fail (callbacks != NULL);
dvb_sub->callbacks = *callbacks;
dvb_sub->user_data = user_data;
}