aclfvCreateFeatureInfo

The Atlas 200/300/500 Inference Product does not support this API.

The Atlas Training Series Product does not support this API.

Description

Creates data of the aclfvFeatureInfo type for feature description.

To destroy data of the aclfvFeatureInfo type, call aclfvDestroyFeatureInfo.

Prototype

aclfvFeatureInfo *aclfvCreateFeatureInfo(uint32_t id0, uint32_t id1, uint32_t offset, uint32_t featureLen, uint32_t featureCount, uint8_t *featureData, uint32_t featureDataLen)

Parameters

Parameter

Input/Output

Description

id0

Input

Repository 0 ID. Must be within [0, 1023]. Defaults to 0 in N:M mode.

id0 and id1 together identify a repository.

id1

Input

Repository 1 ID. Must be within [0, 1023]. Defaults to 0 in N:M mode.

id0 and id1 together identify a repository.

offset

Input

Offset of the first feature in the library. The offset value must be consistent with the number of features that have been added to the library. In N:M mode, the default value is 0.

featureLen

Input

Feature length, fixed at 36 bytes. The system verifies the length internally.

featureCount

Input

Number of features, up to 1 million in 1:N mode or up to 10 million in N:M mode.

featureData

Input

Pointers to feature values, which are stored contiguously based on the feature length. The first 4 bytes of each feature are 0.

featureDataLen

Input

Length of the memory allocated for the featureData pointer, used for verification.

Returns

  • Success: a pointer to data of the aclfvFeatureInfo type
  • Failure: nullptr