Share via

RECO_LATTICE Structure

  • Article

RECO_LATTICE Structure

Serves as the entry point into a lattice.

Declaration

[C++]

typedef struct tagRECO_LATTICE
    {
    ULONG ulColumnCount;
    RECO_LATTICE_COLUMN *pLatticeColumns;
    ULONG ulPropertyCount;
    GUID *pGuidProperties;
    ULONG ulBestResultColumnCount;
    ULONG *pulBestResultColumns;
    ULONG *pulBestResultIndexes;
    }     RECO_LATTICE;

Members

Name Description
ulColumnCount The number of columns in the lattice.
pLatticeColumns An array of RECO_LATTICE_COLUMN structures contained by the lattice.
ulPropertyCount The number of properties assigned to the lattice.

For details about properties, see the RECO_LATTICE_PROPERTIES structure.
pGuidProperties An array of property GUIDs. The GUIDS for these properties can either be the properties defined in the Msinkaut.h header file (for example, line metrics) or custom properties defined by your recognizer.
ulBestResultColumnCount The number of columns that the best result consists of.
pulBestResultColumns An array containing the indexes of the columns in the pLatticeColumns array that make up the best result.
pulBestResultIndexes An array of indexes of the elements in the pLatticeElements array of the corresponding column designated by pulBestResultColumn.

Remarks

The ulBestResultColumnCount, pulBestResultColumns, andpulBestResultIndexes members are used together to hold information about the top alternates among all columns. These values should be filled in by the recognizer, even in the simplest case where there is no segmentation and there is only one column. Using the "together" example, if the recognizer determines that the best result is "to gather", ulBestResultColumnCount would be 3, the pulBestResultColumns array would contain [0, 1, 2] and the pulBestResultIndexes array would contain [1, 0, 2].