fsdk::IDescriptorBatch Struct Reference

Descriptor batch interface. More...

#include <IDescriptor.h>

Inheritance diagram for fsdk::IDescriptorBatch:

List of all members.

Public Types
enum	Error {   Ok, InvalidInput, BatchFull, Incompatible,   Internal, IoError, OutOfRange }
	Descriptor batch error enumeration. More...
Public Member Functions
virtual Result< Error >	add (IDescriptor *descriptor) noexcept=0
	Add a descriptor to the batch.
virtual Result< Error >	add (IDescriptorBatch *batch, uint32_t offset=0) noexcept=0
	Add a given descriptor batch content to the current batch. Descriptors to copy from the source batch are selected based on offset parameter.
virtual Result< Error >	add (IDescriptorBatch *batch, uint32_t offset, uint32_t count) noexcept=0
	Add a descriptor batch content to the batch. Descriptors to copy from the source bath are selected based on count and offset parameters.
virtual Result< Error >	removeFast (uint32_t index) noexcept=0
	Remove a descriptor from batch.
virtual Result< Error >	removeSlow (uint32_t index) noexcept=0
	Remove a descriptor from batch.
virtual Result< MultiError < ISerializableObject::Error, Error > >	loadAndAdd (IArchive *archive)=0
	Load a descriptor/descriptors from archive and add it to the batch.
virtual uint32_t	getMaxCount () const noexcept=0
	Get maximum number of descriptors in this batch.
virtual uint32_t	getCount () const noexcept=0
	Get actual number of descriptors in this batch.
virtual uint32_t	getModelVersion () const noexcept=0
	Get algorithm model version the descriptors in this batch were created with.
virtual DescriptorType	getDescriptorType () const noexcept=0
	Get type of descriptor.
virtual uint32_t	getDescriptorLength () const noexcept=0
	Get length of one descriptor. Specified by version of descriptors in batch.
virtual ResultValue< FSDKError, IDescriptorPtr >	getDescriptorSlow (uint32_t index) const noexcept=0
	Get descriptor from batch by index with copying.
virtual ResultValue< FSDKError, IDescriptorPtr >	getDescriptorFast (uint32_t index) noexcept=0
	Get descriptor from batch by index without copying.

---

Detailed Description

Descriptor batch interface.

Used for matching large continous sets of descriptors.

A batch is created with a reserved memory for descriptors that can not be later extended. Thus descriptors can be add()'ed until the memory reservation is exceeded.

Memory reservation size can be obtained via getMaxCount() function. The batch me be reset via clear() function. It does not deallocate memory reservation. Instead, it resets internal counter allowing to re-populate the batch via add() again.

---

Member Enumeration Documentation

enum fsdk::IDescriptorBatch::Error

Descriptor batch error enumeration.

Used for descriptor batch related errors indication.

Enumerator:

Ok	No error.
InvalidInput	Invalid input (Ex: null pointer while a valid object is expected).
BatchFull	Batch is full.
Incompatible	Trying to add an incompatible descriptor.
Internal	An internal processing error (Ex: memopry allocation or misalignment).
IoError	Error while trying open/read/write file.
OutOfRange	Error while accessing descriptor out of range.

Reimplemented from fsdk::ISerializableObject.

---

Member Function Documentation

virtual Result<Error> fsdk::IDescriptorBatch::add

(

IDescriptor *

descriptor

)

[pure virtual]

Add a descriptor to the batch.

Parameters:

[in]

descriptor

descriptor to add. Descriptor data is copied and to internal reference is held, thus it is safe to release the source descriptor object later.

Returns:

Result with one of the error codes specified by DescriptorBatchError.

See also:

IDescriptor, Result and Error for details.

virtual Result<Error> fsdk::IDescriptorBatch::add	(	IDescriptorBatch *	batch,
		uint32_t	offset = 0
	)		[pure virtual]

Add a given descriptor batch content to the current batch. Descriptors to copy from the source batch are selected based on offset parameter.

Parameters:

[in]	batch	batch to take content from. All descriptors from the input batch are copied to the buffer of the current batch. So it is safe to release the source descriptor batch object later.
[in]	offset	offset of descriptors to copy.

Returns:

Result with one of the error codes specified by DescriptorBatchError.

See also:

IDescriptorBatch, Result and Error for details.

Note:

Current batch should have enough free space to place all descriptors from the input batch.

All selected descriptors from the source batch will be placed right after all descriptors in the current batch.

All selected descriptors from the input batch are copied to the buffer of the current batch. So it is safe to release the source descriptor batch object later.

virtual Result<Error> fsdk::IDescriptorBatch::add	(	IDescriptorBatch *	batch,
		uint32_t	offset,
		uint32_t	count
	)		[pure virtual]

Add a descriptor batch content to the batch. Descriptors to copy from the source bath are selected based on count and offset parameters.

Parameters:

[in]	batch	batch to take content from.
[in]	offset	offset of descriptors to copy.
[in]	count	count of descriptors to copy.

Returns:

Result with one of the error codes specified by DescriptorBatchError.

See also:

IDescriptorBatch, Result and Error for details.

Note:

Current batch should have enough free space to place all descriptors from the input batch.

All selected descriptors from the source batch will be placed right after all descriptors in the current batch.

All selected descriptors from the input batch are copied to the buffer of the current batch. So it is safe to release the source descriptor batch object later.

virtual uint32_t fsdk::IDescriptorBatch::getCount

(

)

const [pure virtual]

Get actual number of descriptors in this batch.

Returns:

actual number of descriptors in this batch.

virtual ResultValue<FSDKError, IDescriptorPtr> fsdk::IDescriptorBatch::getDescriptorFast

(

uint32_t

index

)

[pure virtual]

Get descriptor from batch by index without copying.

Parameters:

[in]

index

descriptor index in batch.

Returns:

ResultValue with error code and IDescriptorPtr instance.

See also:

IDescriptorPtr, ResultValue and FSDKError for details.

Note:

If you change achived descriptor - corresponded descriptor in batch will be changed.

virtual uint32_t fsdk::IDescriptorBatch::getDescriptorLength

(

)

const [pure virtual]

Get length of one descriptor. Specified by version of descriptors in batch.

Returns:

Length of one descriptor in batch.

virtual ResultValue<FSDKError, IDescriptorPtr> fsdk::IDescriptorBatch::getDescriptorSlow

(

uint32_t

index

)

const [pure virtual]

Get descriptor from batch by index with copying.

Parameters:

[in]

index

descriptor index in batch.

Returns:

ResultValue with error code and IDescriptorPtr instance.

See also:

IDescriptorPtr, ResultValue and FSDKError for details.

virtual DescriptorType fsdk::IDescriptorBatch::getDescriptorType

(

)

const [pure virtual]

Get type of descriptor.

Note:

This function only makes sense when there is at least one descriptor in the batch.

Returns:

type as enum.

See also:

DescriptorType for details.

virtual uint32_t fsdk::IDescriptorBatch::getMaxCount

(

)

const [pure virtual]

Get maximum number of descriptors in this batch.

Returns:

maximum number of descriptors in this batch.

virtual uint32_t fsdk::IDescriptorBatch::getModelVersion

(

)

const [pure virtual]

Get algorithm model version the descriptors in this batch were created with.

Note:

This function only makes sense when there is at least one descriptor in the batch. It will return 0 if the batch is empty.

Returns:

Version as integral number.

virtual Result<MultiError<ISerializableObject::Error, Error> > fsdk::IDescriptorBatch::loadAndAdd

(

IArchive *

archive

)

[pure virtual]

Load a descriptor/descriptors from archive and add it to the batch.

Note:

This method supports both serialized IDescriptorBatch and IDescriptor.

Parameters:

[in]

archive

archive to read from.

Returns:

MultiError result with codes specified by DescriptorBatchError and SerializationError.

Note:

This method pass exceptions from user defined IArchive, but doesnt throw its own

See also:

Result, IArchive, ISerializableObject::Error, Error and MultiError for details.

virtual Result<Error> fsdk::IDescriptorBatch::removeFast

(

uint32_t

index

)

[pure virtual]

Remove a descriptor from batch.

Remove descriptor by swapping it with the last descriptor in batch. This breaks descriptor order.

Parameters:

[in]

index

descriptor index.

Returns:

Result with one of the error codes specified by DescriptorBatchError.

See also:

Result and Error for details.

virtual Result<Error> fsdk::IDescriptorBatch::removeSlow

(

uint32_t

index

)

[pure virtual]

Remove a descriptor from batch.

Remove descriptor by shifting all the following descriptors back. This preserves descriptor order.

Parameters:

[in]

index

descriptor index.

Returns:

Result with one of the error codes specified by DescriptorBatchError.

See also:

Result and Error for details.

---

The documentation for this struct was generated from the following file:

• include/fsdk/IDescriptor.h