Initializes AVBlocks and manages license information. More...

Functions
primo::avblocks::Config *	config ()
	Returns the library configuration object. More...

primo::codecs::AudioStreamInfo *	createAudioStreamInfo ()
	Creates an empty audio stream info. More...

primo::codecs::StreamInfo *	createDataStreamInfo ()
	Creates a stream info for generic data. More...

primo::error::ErrorInfo *	createErrorInfo ()
	Creates a new ErrorInfo instance. More...

primo::avblocks::FloatParameter *	createFloatParameter ()
	Creates a float parameter. More...

primo::codecs::Hardware *	createHardware ()
	Creates a Hardware enumeration object. More...

primo::avblocks::IntParameter *	createIntParameter ()
	Creates an integer parameter. More...

primo::license::LicenseInfo *	createLicenseInfo ()
	Creates a new LicenseInfo instance. More...

primo::codecs::MediaBuffer *	createMediaBuffer (int32_t capacity=0)
	Creates a media buffer with the specified capacity. More...

primo::avblocks::MediaBufferParameter *	createMediaBufferParameter ()
	Creates a parameter that holds a MediaBuffer object. More...

primo::avblocks::MediaInfo *	createMediaInfo ()
	Creates a media information object. More...

primo::avblocks::MediaPin *	createMediaPin ()
	Creates a media pin. More...

primo::codecs::MediaSample *	createMediaSample ()
	Creates an empty media sample. More...

primo::avblocks::MediaSocket *	createMediaSocket ()
	Creates a media socket. More...

primo::avblocks::MediaSocket *	createMediaSocket (const char *preset)
	Creates a media socket from an AVBlocks Preset. More...

primo::avblocks::MediaSocket *	createMediaSocket (MediaInfo *mediaInfo)
	Creates a media socket from a MediaInfo object. More...

primo::codecs::MetaAttribute *	createMetaAttribute ()
	Creates an empty MetaAttribute object. More...

primo::codecs::Metadata *	createMetadata ()
	Creates an empty Metadata object. More...

primo::codecs::MetaPicture *	createMetaPicture ()
	Creates an empty MetaPicture object. More...

primo::avblocks::ParameterList *	createParameterList ()
	Creates an empty collection of filter parameters. More...

primo::avblocks::StringParameter *	createStringParameter ()
	Creates a parameter that holds a char_t* string. More...

Transcoder *	createTranscoder ()
	Creates a Transcoder. More...

primo::codecs::VideoStreamInfo *	createVideoStreamInfo ()
	Creates an empty video stream info. More...

primo::avblocks::VideoStreamInfoParameter *	createVideoStreamInfoParameter ()
	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

capacity The 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:

Use MediaInfo to load information for a file or user stream.
Create a media socket from the MediaInfo object (Library::createMediaSocket(MediaInfo*)).
Add the newly created socket to the inputs of the Transcoder (Transcoder::inputs(), MediaSocketList::add()).
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

license A 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.

Functions

Detailed Description

Function Documentation