source/asn/src/asn1_createAction.c File Reference

Functions to create a MHEG5Action from a MHEG5 script (in the form of a list of fpa1_syntaxList structures). MHEG5Action consists itself of a list of elementary actions (stored as a list of MHEG5GList structures. More...

#include <stdio.h>
#include "vpa1_sys.h"
#include "vpa1_tgs.h"
#include "fpa1_syn.h"
#include "fpa1_rdf.h"
#include "asn1_sys.h"
#include "mh5action.h"
#include "mh5profile.h"
#include "mh5support.h"
#include "asn1_createAction.h"
#include "asn1_createExtras.h"
#include "asn1_createGroup.h"

Defines
#define	AssignNextParam(gl)
Functions
MHEG5EventType	asn1_decodeEventType (MHEG5Int evt_val)
MHEG5GList *	asn1_addNewGList (MHEG5GList *gList)
	Creates a new MHEG5GList element and adds it to the end of the supplied list.
asnErr	asn1_decodeObjectReference (fpa1_syntaxList *listPtr, MHEG5GList *gList)
	Decodes a MHEG object reference to a MHEG5GList. This function can cope with listPtr being NULL. Will return an error code in that eventuality. Will clean up properly if a asn1_NewGList call fails. Note: This function expects a valid MHEG5GList item to be passed in but will create any others necessary.
asnErr	asn1_decodeGenericObjectReference (fpa1_syntaxList *listPtr, MHEG5GList *gList)
asnErr	asn1_decodeGenericInteger (fpa1_syntaxList *listPtr, MHEG5GList *gList)
asnErr	asn1_decodeGenericBoolean (fpa1_syntaxList *listPtr, MHEG5GList *gList)
asnErr	asn1_decodeGenericOctetString (fpa1_syntaxList *listPtr, MHEG5GList *gList)
asnErr	asn1_decodeGenericContentReference (fpa1_syntaxList *listPtr, MHEG5GList *gList)
void	asn1_decodeActions (fpa1_syntaxList *listPtr, MHEG5ActionList *p_actions)
	Decodes action class Refer to MHEG5 Specification (ISO/IEC 13522-2:1996), Appendix A, section [A.42] for details of ASN.1 representation. This function ignores any elementary actions in cannot decode (Including if a malloc fails during decoding. NULL is returned if no actions could be decoded.
void	asn1_decodeNextScenes (fpa1_syntaxList *listPtr, ParamList *p_scenes)
	Refer to MHEG5 Specification (ISO/IEC 13522-2:1996), Appendix A, section[A.3] for details of ASN.1 representation. NextScenes is a GList containg references to the following scenes. Each reference are of the form: OpenBracket, OctetString, Integer, CloseBracket. Safe if asn1_addGList() fails to allocate memory, returns NULL after deleting any allocated GList items.
Variables
MHEG5Action *	asn1_GroupActionPtr = NULL
MHEG5GList *	asn1_GroupParamPtr = NULL
int	asn1_GroupActionCount = 0
int	asn1_GroupParamCount = 0

---

Detailed Description

Functions to create a MHEG5Action from a MHEG5 script (in the form of a list of fpa1_syntaxList structures). MHEG5Action consists itself of a list of elementary actions (stored as a list of MHEG5GList structures.

Date:

16/07/2002

Author:

S.Charman

---

Define Documentation

#define AssignNextParam

(

gl

)

Value:

if (asn1_GroupParamCount < fpa1_GroupParamCount) { \
      gl = asn1_GroupParamPtr++; asn1_GroupParamCount++; } else { \
      gl = NULL; }

---

Function Documentation

MHEG5GList* asn1_addNewGList

(

MHEG5GList *

gList

)

Creates a new MHEG5GList element and adds it to the end of the supplied list.

Parameters:

gList

MHEG5GList to be extended.

Returns:

MHEG5GList The GList item created. Null if failed to create GList.

void asn1_decodeActions	(	fpa1_syntaxList *	listPtr,
		MHEG5ActionList *	p_actions
	)

Decodes action class Refer to MHEG5 Specification (ISO/IEC 13522-2:1996), Appendix A, section [A.42] for details of ASN.1 representation. This function ignores any elementary actions in cannot decode (Including if a malloc fails during decoding. NULL is returned if no actions could be decoded.

Parameters:

listPtr

pointer to current fpa1_syntaxList item

Returns:

MHEG5Action. NULL if fails.

asnErr asn1_decodeGenericBoolean	(	fpa1_syntaxList *	listPtr,
		MHEG5GList *	gList
	)

This function can cope with listPtr being NULL. Will return an error code in that eventuality.

Parameters:

listPtr	pointer to current fpa1_syntaxList item
lineart	Pointer to GenericBoolean class being decoded. (in the form of a MHEG5GList).

Returns:

asnErr

asnErr asn1_decodeGenericContentReference	(	fpa1_syntaxList *	listPtr,
		MHEG5GList *	gList
	)

This function can cope with listPtr being NULL. Will return an error code in that eventuality.

Parameters:

listPtr	pointer to current fpa1_syntaxList item
lineart	Pointer to GenericContentReference class being decoded. (in the form of a MHEG5GList).

Returns:

asnErr

asnErr asn1_decodeGenericInteger	(	fpa1_syntaxList *	listPtr,
		MHEG5GList *	gList
	)

This function can cope with listPtr being NULL. Will return an error code in that eventuality.

Parameters:

listPtr	pointer to current fpa1_syntaxList item
lineart	Pointer to GenericObjectInteger class being decoded. (in the form of a MHEG5GList).

Returns:

asnErr

asnErr asn1_decodeGenericObjectReference	(	fpa1_syntaxList *	listPtr,
		MHEG5GList *	gList
	)

Parameters:

listPtr	pointer to current fpa1_syntaxList item
lineart	Pointer to GenericObjectReference class being decoded. (in the form of a MHEG5GList).

Returns:

asnErr

asnErr asn1_decodeGenericOctetString	(	fpa1_syntaxList *	listPtr,
		MHEG5GList *	gList
	)

This function can cope with listPtr being NULL. Will return an error code in that eventuality.

Parameters:

listPtr	pointer to current fpa1_syntaxList item
lineart	Pointer to GenericOctetString class being decoded. (in the form of a MHEG5GList).

Returns:

asnErr

void asn1_decodeNextScenes	(	fpa1_syntaxList *	listPtr,
		ParamList *	p_scenes
	)

Refer to MHEG5 Specification (ISO/IEC 13522-2:1996), Appendix A, section[A.3] for details of ASN.1 representation. NextScenes is a GList containg references to the following scenes. Each reference are of the form: OpenBracket, OctetString, Integer, CloseBracket. Safe if asn1_addGList() fails to allocate memory, returns NULL after deleting any allocated GList items.

Parameters:

listPtr	pointer to current fpa1_syntaxList item
p_scenes	Pointer to next scenes list being decoded.

Returns:

void

asnErr asn1_decodeObjectReference	(	fpa1_syntaxList *	listPtr,
		MHEG5GList *	gList
	)

Decodes a MHEG object reference to a MHEG5GList. This function can cope with listPtr being NULL. Will return an error code in that eventuality. Will clean up properly if a asn1_NewGList call fails. Note: This function expects a valid MHEG5GList item to be passed in but will create any others necessary.

Parameters:

listPtr	pointer to current fpa1_syntaxList item
lineart	Pointer to objectReference class being decoded (in the form of a MHEG5GList).

Returns:

asnErr