stbdsc.c File Reference

DVB subtitle control tasks. More...

#include <string.h>
#include <stdio.h>
#include <techtype.h>
#include <dbgfuncs.h>
#include "stbhwos.h"
#include "stbhwosd.h"
#include "stbhwdmx.h"
#include "stbheap.h"
#include "stbds.h"
#include "stbdsapi.h"
#include "stbdpc.h"
#include "stbpes.h"

Macros
#define	DVB_SUBT_TASK_STACK_SIZE   1024 * 5
#define	DVB_SUBT_TASK_PRIORITY   9
#define	STB_CONTROL_TASK_PRINT(x)
#define	PCS   0x10
#define	RCS   0x11
#define	CDS   0x12
#define	ODS   0x13
#define	DDS   0x14
#define	EDS   0x80
#define	END_OF_PES_DATA_FIELD_MARKER   0xff
#define	SYNC_BYTE   0x0f
#define	MATCH   0x00
#define	PES_HDR_DATA_LEN_BYTE   0x08
#define	MAX_PES_SIZE   (0xffff + 0x06)

Typedefs
typedef struct stream	S_STREAM

Functions
void	STB_SUBInitialise (void)
	Initialises subtitling control.
void	STB_SUBEnable (U8BIT path, BOOLEAN enable)
	Enables or disables subtitling display. More...
void	STB_SUBStart (U8BIT path, U16BIT pid, U16BIT composition_id, U16BIT ancillary_id)
	Starts subtitling display. More...
void	STB_SUBStop (U8BIT path)
	Stops subtitling display.
void	STB_SUBSetStream (U8BIT path, U16BIT pid, U16BIT composition_id, U16BIT ancillary_id)
	Sets the stream IDs to be decoded. More...
void	STB_SUBStatus (BOOLEAN *started, BOOLEAN *shown)
	returns the current status information More...
void	STB_SUBReadSettings (BOOLEAN *started, U16BIT *pid, U16BIT *comp_id, U16BIT *anc_id, BOOLEAN *enabled)
	returns the current status information More...
BOOLEAN	STB_DSGetNextPesPts (U8BIT *next_pts)
	Get the PTS of the next PES packet, does not process next PES, but places on the next PES pointer. More...

Detailed Description

DVB subtitle control tasks.

Date

12/09/2003

Function Documentation

BOOLEAN STB_DSGetNextPesPts

(

U8BIT *

next_pts

)

Get the PTS of the next PES packet, does not process next PES, but places on the next PES pointer.

Parameters

@return

TRUE or FALSE for success or failure.

void STB_SUBEnable	(	U8BIT	path,
		BOOLEAN	enable
	)

Enables or disables subtitling display.

Parameters

BOOLEAN

enable - TRUE to enable display

void STB_SUBReadSettings	(	BOOLEAN *	started,
		U16BIT *	pid,
		U16BIT *	comp_id,
		U16BIT *	anc_id,
		BOOLEAN *	enabled
	)

returns the current status information

Parameters

started	- returns TRUE if subtitles are decoding, FALSE otherwise
pid	- returns the pid in use. Not valid if running is FALSE
comp_id	- returns the comp page id. Not valid if running is FALSE
anc_id	- returns the ancillary page id. Not valid if running is FALSE
enabled	- returns TRUE if subtitle display is enabled, FALSE otherwise

void STB_SUBSetStream	(	U8BIT	path,
		U16BIT	pid,
		U16BIT	composition_id,
		U16BIT	ancillary_id
	)

Sets the stream IDs to be decoded.

EN 300 468 version 1.3.1 clause 6.2.30 Subtitling descriptor The values in the ancillary_page_id and the composition_page_id fields shall be the same if no ancillary page is provided.

Parameters

U16BIT	pid - The PID of the subtitle data
U16BIT	composition_id - The ID of the composition page
U16BIT	ancillary_id - The ID of the ancillary page

void STB_SUBStart	(	U8BIT	path,
		U16BIT	pid,
		U16BIT	composition_id,
		U16BIT	ancillary_id
	)

Starts subtitling display.

Parameters

U16BIT	pid - The PID of the subtitle data
U16BIT	composition_id - The ID of the composition page
U16BIT	ancillary_id - The ID of the ancillary page

void STB_SUBStatus	(	BOOLEAN *	started,
		BOOLEAN *	shown
	)

returns the current status information

Parameters