BSGETV, BSGETOCTV – Binary Structure - Get matrix (all values of same given type)

Block SymbolsLicensing group: ADVANCED

Function Description
This group of blocks is used for obtaining values from a binary structure (byte array). The BSSETV and BSSETOCTV blocks can be used to write to the binary structure.
The meaning of most of the parameters is the same as the BSGET block, but these blocks retrieve several values of the same type and store them in an array (matrix). A matrix always has m rows and n columns. For the BSGETV block, all elements are of the same type (determined by the type parameter) and the data is filled into the matrix fed to the uMat input. The BSGETOCTV block loads up to 8 vectors. Each row of the matrix can be of a different type. The block allocates the matrix itself. The matrix is available at the yMat output.

This block does not propagate the signal quality. More information can be found in the 1.4 section.

Input

uVec	Input reference to a binary structure	Reference
uOffset	Offset to start in the input Binary Structure (in bytes)	Long (I32)
n	Number of matrix columns	Long (I32)

Parameter

BE	Big-Endian byte order (default is Little-Endian, e.g. Intel)	Bool
m	Number of active items $↓$ 1 $↑$ 8 $⊙$ 8	Long (I32)
nmax	Allocated size of output matrix (total number of items) $↓$ 1 $⊙$ 32	Long (I32)
type	Data type of item $↓$ 2 $↑$ 10 $⊙$ 2	Long (I32)
type1..type8	Data type of item $↓$ 2 $↑$ 10 $⊙$ 2	Long (I32)

Output

yVec	Output reference to a binary structure	Reference
yMat	Matrix value output	Reference
yOffset	Offset after the last processed byte of the input Binary Structure (in bytes), for easy chaining	Long (I32)

[Previous] [Back to top] [Up] [Next]