AVBlocks for C++  2.1
Audio and Video Software Development Kit
primo::avblocks::Library Namespace Reference

Initializes AVBlocks and manages license information. More...

Functions

primo::avblocks::Configconfig ()
 Returns the library configuration object. More...
 
primo::codecs::AudioStreamInfocreateAudioStreamInfo ()
 Creates an empty audio stream info. More...
 
primo::codecs::StreamInfocreateDataStreamInfo ()
 Creates a stream info for generic data. More...
 
primo::error::ErrorInfocreateErrorInfo ()
 Creates a new ErrorInfo instance. More...
 
primo::avblocks::FloatParametercreateFloatParameter ()
 Creates a float parameter. More...
 
primo::codecs::HardwarecreateHardware ()
 Creates a Hardware enumeration object. More...
 
primo::avblocks::IntParametercreateIntParameter ()
 Creates an integer parameter. More...
 
primo::license::LicenseInfocreateLicenseInfo ()
 Creates a new LicenseInfo instance. More...
 
primo::codecs::MediaBuffercreateMediaBuffer (int32_t capacity=0)
 Creates a media buffer with the specified capacity. More...
 
primo::avblocks::MediaBufferParametercreateMediaBufferParameter ()
 Creates a parameter that holds a MediaBuffer object. More...
 
primo::avblocks::MediaInfocreateMediaInfo ()
 Creates a media information object. More...
 
primo::avblocks::MediaPincreateMediaPin ()
 Creates a media pin. More...
 
primo::codecs::MediaSamplecreateMediaSample ()
 Creates an empty media sample. More...
 
primo::avblocks::MediaSocketcreateMediaSocket ()
 Creates a media socket. More...
 
primo::avblocks::MediaSocketcreateMediaSocket (const char *preset)
 Creates a media socket from an AVBlocks Preset. More...
 
primo::avblocks::MediaSocketcreateMediaSocket (MediaInfo *mediaInfo)
 Creates a media socket from a MediaInfo object. More...
 
primo::codecs::MetaAttributecreateMetaAttribute ()
 Creates an empty MetaAttribute object. More...
 
primo::codecs::MetadatacreateMetadata ()
 Creates an empty Metadata object. More...
 
primo::codecs::MetaPicturecreateMetaPicture ()
 Creates an empty MetaPicture object. More...
 
primo::avblocks::ParameterListcreateParameterList ()
 Creates an empty collection of filter parameters. More...
 
primo::avblocks::StringParametercreateStringParameter ()
 Creates a parameter that holds a char_t* string. More...
 
TranscodercreateTranscoder ()
 Creates a Transcoder. More...
 
primo::codecs::VideoStreamInfocreateVideoStreamInfo ()
 Creates an empty video stream info. More...
 
primo::avblocks::VideoStreamInfoParametercreateVideoStreamInfoParameter ()
 Creates a parameter that holds a VideoStreamInfoParameter object. More...
 
const char * description ()
 Gets library build description. More...
 
bool_t initialize ()
 Initializes the AVBlocks library. More...
 
int32_t majorVersion ()
 Gets library major version. More...
 
int32_t minorVersion ()
 Gets library minor version. More...
 
int32_t patchVersion ()
 Gets library patch version. More...
 
int32_t setLicense (const char *license)
 Sets a license string. More...
 
void shutdown ()
 Closes the AVBlocks library and frees the resources that are used (if any). More...
 

Detailed Description

Initializes AVBlocks and manages license information.

This namespace contains global functions for the AVBlocks library. These are C++ wrappers of the functions in the pure "C" interface exported by the library.

Function Documentation

primo::avblocks::Config* primo::avblocks::Library::config ( )

Returns the library configuration object.

Returns
A pointer to configuration object. This is never NULL.
See Also
primo::avblocks::Config
primo::avblocks::HwConfig
primo::codecs::AudioStreamInfo* primo::avblocks::Library::createAudioStreamInfo ( )

Creates an empty audio stream info.

The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new AudioStreamInfo object.
See Also
Object Management
AudioStreamInfo
primo::codecs::StreamInfo* primo::avblocks::Library::createDataStreamInfo ( )

Creates a stream info for generic data.

The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new StreamInfo object.
Remarks
The media type is always MediaType::Data and cannot be changed.
See Also
Object Management
primo::error::ErrorInfo* primo::avblocks::Library::createErrorInfo ( )

Creates a new ErrorInfo instance.

Returns
A pointer to ErrorInfo object.
See Also
primo::error::ErrorInfo
primo::avblocks::FloatParameter* primo::avblocks::Library::createFloatParameter ( )

Creates a float parameter.

The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new Parameter object.
See Also
Object Management
ParameterList
primo::codecs::Hardware* primo::avblocks::Library::createHardware ( )

Creates a Hardware enumeration object.

The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new Hardware object.
See Also
Object Management
primo::codecs::Hardware
primo::avblocks::IntParameter* primo::avblocks::Library::createIntParameter ( )

Creates an integer parameter.

The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new Parameter object.
See Also
Object Management
ParameterList
primo::license::LicenseInfo* primo::avblocks::Library::createLicenseInfo ( )

Creates a new LicenseInfo instance.

Returns
A pointer to LicenseInfo object.
See Also
primo::license::LicenseInfo
primo::codecs::MediaBuffer* primo::avblocks::Library::createMediaBuffer ( int32_t  capacity = 0)

Creates a media buffer with the specified capacity.

The caller is responsible for releasing the object when it is not needed anymore.

Parameters
capacityThe required capacity must be greater or equal to 0.
Returns
A pointer to the new MediaBuffer object if capacity >= 0, otherwise NULL.
Remarks
The returned object has a capacity that has been specified by the capacity parameter. It contains no data, i.e. dataSize() == 0.
See Also
Object Management
MediaBuffer
primo::avblocks::MediaBufferParameter* primo::avblocks::Library::createMediaBufferParameter ( )

Creates a parameter that holds a MediaBuffer object.

The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new Parameter object.
See Also
Object Management
ParameterList
primo::avblocks::MediaInfo* primo::avblocks::Library::createMediaInfo ( )

Creates a media information object.

The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new MediaInfo object.
See Also
Object Management
MediaInfo
primo::avblocks::MediaPin* primo::avblocks::Library::createMediaPin ( )

Creates a media pin.

It is used in input and output sockets of the transcoder. The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new MediaPin object.
See Also
Object Management
MediaPin
MediaSocket
Transcoder
primo::codecs::MediaSample* primo::avblocks::Library::createMediaSample ( )

Creates an empty media sample.

The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new MediaSample object.
See Also
Object Management
MediaSample
primo::avblocks::MediaSocket* primo::avblocks::Library::createMediaSocket ( )

Creates a media socket.

It is used as an input or output point of the transcoder. The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new MediaSocket object.
See Also
Object Management
MediaSocket
MediaPin
Transcoder
primo::avblocks::MediaSocket* primo::avblocks::Library::createMediaSocket ( const char *  preset)

Creates a media socket from an AVBlocks Preset.

Parameters
preset[in] A pointer to a preset string. The known presets are listed in the primo::avblocks::Preset namespace.
Returns
A pointer to the new MediaSocket object which is configured according to the specified preset.
primo::avblocks::MediaSocket* primo::avblocks::Library::createMediaSocket ( MediaInfo *  mediaInfo)

Creates a media socket from a MediaInfo object.

This method will call MediaInfo::load, if the MediaInfo has not been loaded.

Parameters
mediaInfo[in] A pointer to a MediaInfo object with audio/video information. This object is not needed after the method returns.
Returns
A pointer to a new MediaSocket object.
The pointer to a new MediaSocket object contains the information supplied by the mediaInfo parameter.
The caller is responsible for releasing the returned media socket when it is not needed anymore.
NULL if there was an error. In this case call MediaInfo::error() for detailed error information.

This method is meant to help in setting correctly the inputs of the Transcoder. The intended usage is as follows:

  1. Use MediaInfo to load information for a file or user stream.
  2. Create a media socket from the MediaInfo object (Library::createMediaSocket(MediaInfo*)).
  3. Add the newly created socket to the inputs of the Transcoder (Transcoder::inputs(), MediaSocketList::add()).
  4. Release the media socket if it will not be used outside of the Transcoder.
See Also
MediaInfo
Object Management
primo::codecs::MetaAttribute* primo::avblocks::Library::createMetaAttribute ( )

Creates an empty MetaAttribute object.

The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new MetaAttribute object.
See Also
Object Management
Metadata
Metadata::attributes
primo::codecs::Metadata* primo::avblocks::Library::createMetadata ( )

Creates an empty Metadata object.

The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new Metadata object.
See Also
Object Management
Metadata
MediaSocket::setMetadata
MediaSocket::metadata
primo::codecs::MetaPicture* primo::avblocks::Library::createMetaPicture ( )

Creates an empty MetaPicture object.

The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new MetaPicture object.
See Also
Object Management
Metadata
Metadata::pictures
primo::avblocks::ParameterList* primo::avblocks::Library::createParameterList ( )

Creates an empty collection of filter parameters.

The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new ParameterList object.
See Also
Object Management
ParameterList
primo::avblocks::StringParameter* primo::avblocks::Library::createStringParameter ( )

Creates a parameter that holds a char_t* string.

The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new Parameter object.
See Also
Object Management
ParameterList
Transcoder* primo::avblocks::Library::createTranscoder ( )

Creates a Transcoder.

The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new Transcoder object.
See Also
Object Management
Transcoder
primo::codecs::VideoStreamInfo* primo::avblocks::Library::createVideoStreamInfo ( )

Creates an empty video stream info.

The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new VideoStreamInfo object.
See Also
Object Management
VideoStreamInfo
primo::avblocks::VideoStreamInfoParameter* primo::avblocks::Library::createVideoStreamInfoParameter ( )

Creates a parameter that holds a VideoStreamInfoParameter object.

The caller is responsible for releasing the object when it is not needed anymore.

Returns
A pointer to the new Parameter object.
See Also
Object Management
ParameterList
const char* primo::avblocks::Library::description ( )

Gets library build description.

Returns
ANSI string.
Remarks
Contains details about the build including full version, architecture (x86/x64), configuration (Release/Debug), license (OEM/Demo) and platform (OS).
bool_t primo::avblocks::Library::initialize ( )

Initializes the AVBlocks library.

Must be called once before the library is used, usually when the application starts.

Returns
TRUE if the library is successfully initialized, otherwise FALSE.
int32_t primo::avblocks::Library::majorVersion ( )

Gets library major version.

Returns
major version
int32_t primo::avblocks::Library::minorVersion ( )

Gets library minor version.

Returns
minor version
int32_t primo::avblocks::Library::patchVersion ( )

Gets library patch version.

Returns
patch version
Remarks
The patch version is used for bug fixes and small improvements that do not involve API changes
int32_t primo::avblocks::Library::setLicense ( const char *  license)

Sets a license string.

The supplied license is appended to the library license state.

Parameters
licenseA string with license information. If the license string is NULL the library license state is cleared.
Returns
The status after the license is set. The returned value is a combination of flags from the LicenseStatusFlags enum.
Remarks
A Demo build of the library cannot be licensed and always returns LicenseStatusFlags::DemoBuild.
See Also
primo::license::LicenseStatusFlags::Enum
void primo::avblocks::Library::shutdown ( )

Closes the AVBlocks library and frees the resources that are used (if any).

Should be called when the library will not be used anymore, e.g. when the application ends.