template<class Class>
OcaLibrary class
Template parameters | |
---|---|
Class | - Class to wrap. |
Contents
This class template detects the methods and events defined for the class OcaLibrary in the AES70 specification and exposes them through AES70. Note that all AES70 methods and event handlers need to be public in order to be detected.
Detects the following symbols with the corresponding detector classes:
AddVolume : aes70::
device:: Method Arguments:
- Volume : OcaLibVol
Return values:
- ID : OcaUint32
ReplaceVolume : aes70::
device:: Method Arguments:
- ID : OcaUint32
- Volume : OcaLibVol
DeleteVolume : aes70::
device:: Method Arguments:
- ID : OcaUint32
GetVolume : aes70::
device:: Method Return values:
- Volume : OcaLibVol
GetVolumeCount : aes70::
device:: Method Return values:
- Count : OcaUint16
GetVolumes : aes70::
device:: Getter Return values:
- Volumes : OcaMap<OcaUint32, OcaLibVol>
GetAccess : aes70::
device:: Getter Return values:
- Access : OcaLibAccess
SetAccess : aes70::
device:: Setter Arguments:
- Access : OcaLibAccess
Detects the following event handlers:
- OnOcaLibVolChanged with arguments:
- OcaLibVolID : OCP1::
OcaUint32 - OcaPropertyChangeType : OCP1::
OcaUint8
- OcaLibVolID : OCP1::
Detects the following event handlers for property changes (of type aes70::
- OnVolumeTypeChanged with property encoder OCP1::
Struct<OCP1::OcaBlobFixedLen<3>, OCP1:: OcaUint32> - OnAccessChanged with property encoder OCP1::
OcaUint8 - OnVolumesChanged with property encoder OCP1::
OcaMap<OCP1:: OcaUint32, OCP1:: Struct<OCP1:: Struct<OCP1:: OcaString, OCP1:: Struct<OCP1::OcaBlobFixedLen<3>, OCP1:: OcaUint32>, OCP1:: OcaUint8, OCP1:: OcaUint32, OCP1:: OcaString, OCP1::Struct<OCP1::OcaBoolean, OCP1::OcaUint64, OCP1::OcaUint32>>, OCP1:: OcaBlob>>
From the AES70 standard:
A library is an agent that holds a collection of datasets. We refer to each dataset as a Volume. There are two kinds of volumes: ParamSet (parameter set). A ParamSet is a collection of operating parameter settings that can be applied to a block. Each ParamSet is associated with a specific block type, but not with a specific instance of that type. A ParamSet may be applied to any block instance of the associated type. A block's type is the object number of its factory or, for factory-defined blocks, a unique identifier set at time of manufacture. Patch. A Patch is a collection of ParamSet assignments. A ParamSet assigment is the description of a binding of a ParamSet to a block instance. To "apply" a Patch is to apply all of its assignments. To apply an assignment is to set all of its ParamSet's parameter values into its block. A given library instance can only hold one class of volume. A device that supports libraries can have any number of Patch and ParamSet libraries. If a device implements a Patch library, it must also implement at least one ParamSet library. However, the reverse is not true: a device may implement one or more ParamSet libraries without a Patch library.
Base classes
-
template<class Class>class OcaAgent
Public static variables
- static const OcaClassVersionNumber ClassVersion
-
static const classid_
tpl<3> ClassId - static const size_t count_events
Public static functions
- static auto get_event_index(OcaEventID id, size_t index) -> AES70_ALWAYS_INLINE ptrdiff_t
Constructors, destructors, conversion operators
-
template<typename ... TN>OcaLibrary(TN && ... args)
Public functions
- auto get_class_version() const -> uint16_t virtual
- auto get_classid() const -> const classid& virtual
-
void init(aes70::
device:: device* d, uint32_t n) virtual -
auto call(const OcaMethodID id,
const uint8_t* src,
const uint8_t* src_end,
uint8_t parameterCount,
const aes70::
response_generator& response) -> bool virtual - auto get_event_index(const OcaEventID OcaEventID) const -> ptrdiff_t virtual
Function documentation
template<classClass>
static AES70_ALWAYS_INLINE ptrdiff_t aes70:: device:: OcaLibrary<Class>:: get_event_index(OcaEventID id,
size_t index)
Internal class for finding the event index of a given EventID. Returns -1 if the given event is not defined.
template<classClass>
template<typename ... TN>
aes70:: device:: OcaLibrary<Class>:: OcaLibrary(TN && ... args)
Constructor which calls the constructor of Class with args forwarded.
template<classClass>
uint16_t aes70:: device:: OcaLibrary<Class>:: get_class_version() const virtual
Returns the AES70 class version of this object.
template<classClass>
const classid& aes70:: device:: OcaLibrary<Class>:: get_classid() const virtual
Returns the AES70 class id of this object.
template<classClass>
void aes70:: device:: OcaLibrary<Class>:: init(aes70:: device:: device* d,
uint32_t n) virtual
Called when this object is added to a device.
template<classClass>
bool aes70:: device:: OcaLibrary<Class>:: call(const OcaMethodID id,
const uint8_t* src,
const uint8_t* src_end,
uint8_t parameterCount,
const aes70:: response_generator& response) virtual
Internal method used to call AES70 methods in this object.
template<classClass>
ptrdiff_t aes70:: device:: OcaLibrary<Class>:: get_event_index(const OcaEventID OcaEventID) const virtual
Returns the index of a given event. The idea is that all events defined on a aes70 class can be enumerated. For events which this object does not implement, the value -1 is returned.
Variable documentation
template<classClass>
static const OcaClassVersionNumber aes70:: device:: OcaLibrary<Class>:: ClassVersion
The ClassVersion of this class according to the AES70 standard.
template<classClass>
static const classid_ tpl<3> aes70:: device:: OcaLibrary<Class>:: ClassId
The ClassID of this class according to the AES70 standard.
template<classClass>
static const size_t aes70:: device:: OcaLibrary<Class>:: count_events
Number of events defined in this class. This depends on which events are implemented by Class.