IPP MX library provides two methods of the description of a single matrix or a vector:
Standard description |
The method is used when the matrix (vector) is regular (Figure “Regular and Irregular Vectors” and Figure “Regular and Irregular Matrices”, cases A and B). |
Pointer description |
The method is used when the matrix (vector) is irregular (Figure “Regular and Irregular Vectors” and Figure “Regular and Irregular Matrices”, cases C and D). |
Note that objects describable using the Standard method can be also represented through the Pointer description but not vice versa.
IPP MX library provides three description methods for arrays of matrices, vectors and constants:
Standard description |
The method is used when all the matrices (vectors) have regular structure. Matrices (vectors, constants) must be regularly spaced in memory (Figure “Permissible Vector Arrays” and Figure “Permissible Matrix Arrays”, case A). |
Pointer description |
The method is used when all the matrices (vectors) have irregular structure. Matrices (vectors) must be regularly spaced in memory (Figure “Permissible Vector Arrays” and Figure “Permissible Matrix Arrays”, case B). |
Layout description |
The method is used when all the matrices (vectors) have regular structure, but are irregularly spaced in memory (Figure “Permissible Vector Arrays” and Figure “Permissible Matrix Arrays”, case C) or when the constants are irregularly spaced in memory. |
Note that arrays of objects describable using the Standard method can be also represented through the Pointer or Layout description but not vice versa.
Note
All elements in the array must have identical structure.
The following subsections describe the above methods in detail by means of IPP MX function parameters. There is no specification of object size, since although the size is an essential feature of an object, many IPP MX functions require only one size for several objects. The concept of size as a function and object attribute, as well as its specification is described in Object Size Puzzle.