CS_get_signature

The CS_get_signature function is called to obtain the signature that characterizes an audio clip.

void CS_get_signature(
  CS_Sample_Processor sp,  /* pointer to an internal data structure */
  CS_Signature sig               /* signature array */
);

Parameters
sp
Identifies the internal data structure used for indexing this clip. This structure was created by a call of CS_create_sample_processor and a pointer to this structure was passed along with each sample value in successive calls of CS_process_sample.
sig
Identifies an array into which this function will place the signature.

Remarks

The sig parameter must identify an array that is large enough to receive the signature. The size of a signature is given by CS_SIGNATURE_SIZE (defined in CS.h) and is 16 bytes.

A signature may be produced for an audio clip of any duration; however, for best results, the clip should be at least 0.05 seconds in duration.

The contents of a signature must not be altered by the application. The meaning of the bytes in a signature is proprietary.

Signatures acquired using this function may be compared by calling CS_compare_signatures. A color may be derived from a signature by calling CS_get_color.

This function has no effect if either the sp parameter or the sig parameter is NULL.


 Home   Overview   Technologies   Applications   Sound Gallery   FindSounds.com   FindSounds Palette   About Us   Contact Us 

© 2008 Comparisonics Corporation