PrimoBurner(tm) for C++  4.6
CD, DVD and Blu-ray Software Development Kit
 All Classes Namespaces Files Functions Variables Enumerations Enumerator Pages
MetaAttribute Class Referenceabstract

MetaAttribute describes a textual meta information that is part of an audio or video file. More...

#include <PrimoAV.h>

Inherits Reference.

Public Member Functions

virtual MetaAttributeclone () const =0
 Creates a deep copy of this object. More...
 
virtual bool_t immutable () const =0
 Returns whether the object is immutable. More...
 
virtual const char * name () const =0
 Returns the name of the meta attribute. More...
 
virtual void setName (const char *name)=0
 Sets the name of a meta attribute. More...
 
virtual void setValue (const char_t *val)=0
 Sets the value a meta attribute. More...
 
virtual const char_t * value () const =0
 Returns the value of the meta attribute. More...
 
- Public Member Functions inherited from Reference
virtual int32_t release () const =0
 Releases the instance. More...
 
virtual int32_t retain () const =0
 Retains the instance. More...
 
virtual int32_t retainCount () const =0
 Returns the current reference count. More...
 

Protected Member Functions

virtual ~MetaAttribute ()
 This object can be destroyed only by the library that has created it. More...
 

Detailed Description

MetaAttribute describes a textual meta information that is part of an audio or video file.

See Also
Library::createMetaAttribute
Metadata

Constructor & Destructor Documentation

virtual ~MetaAttribute ( )
protectedvirtual

This object can be destroyed only by the library that has created it.

See Also
primo::Reference::release

Member Function Documentation

virtual MetaAttribute* clone ( ) const
pure virtual

Creates a deep copy of this object.

Returns
A new MetaAttribute object. The caller is responsible for releasing the new object when it's not needed anymore.
NULL if the object cannot be cloned because there is not enough memory.
See Also
Object Management
virtual bool_t immutable ( ) const
pure virtual

Returns whether the object is immutable.

An immmutable object cannot be modified and all modifying methods fail to produce a result.

Returns
TRUE if the object is immutable, FALSE otherwise.
Remarks
An immutable object can be modified by the AVBlocks library.
Object immutability spreads to all nested objects. Therefore it is not possible to add/set an immutable object to a mutable object.
When cloned an immutable object becomes mutable.
virtual const char* name ( ) const
pure virtual

Returns the name of the meta attribute.

Returns
A pointer to an ANSI string.

Common meta attribute names are defined in primo::codecs::Meta

See Also
primo::codecs::Meta
virtual void setName ( const char *  name)
pure virtual

Sets the name of a meta attribute.

Parameters
[in]nameA pointer to an ANSI string.

Common meta attribute names are defined in primo::codecs::Meta

See Also
primo::codecs::Meta
virtual void setValue ( const char_t *  val)
pure virtual

Sets the value a meta attribute.

Parameters
[in]valA pointer to a Unicode string.
virtual const char_t* value ( ) const
pure virtual

Returns the value of the meta attribute.

Returns
A pointer to a Unicode string.