3.3.2.40 Matrix

Get values from, or set values for, a matrix window.

Please see the msetvalue X-Function.

Syntax:

matrix  [option] argument

Options:

-c r; Rotate the matrix 90 degrees

Syntax: matrix -c r

Rotate the matrix 90 degrees.Imported Images must be converted to gray-scale. See the Convert matrix image to data without prompting option

-c h; Flip the matrix horizontally

Syntax: matrix -c h

Flip the matrix horizontally.Imported images must be converted to gray-scale. See the Convert matrix image to data without prompting option.

-c v; Flip the matrix vertically

Syntax: matrix -c v

Flip the matrix vertically.Imported images must be converted to gray-scale. See the Convert matrix image to data without prompting option.

-e; Open the Set Matrix Values dialog box

Syntax: matrix -e

Open the Set Matrix Values dialog box.

-e d; Open the Matrix Properties dialog box

Syntax: matrix -e d

Open the Matrix Properties dialog box.

-e m; Open the Matrix Dimensions dialog box

Syntax: matrix -e m

Open the Matrix Dimensions dialog box.

-id; Convert matrix image to data with conformation prompt

Syntax: matrix -id

-ig; Convert matrix image to gray scale with conformation prompt

Syntax: matrix -ig

Convert matrix image to gray scale with conformation prompt.

-ii; Check and convert view to Image Mode

Syntax: matrix -ii

Check and convert view to Image Mode.

-in; Convert matrix image to data without prompting

Syntax: matrix -in

Convert matrix image to data without prompting.

-it; Show/Hide matrix image thumbnails

Syntax: matrix -it value

value = 1, show image thumbnails for the active matrix book, and value = 0, hide image thumbnails for the active matrix book.

-pg; Get the specified parameter

Syntax: matrix -pg parameter varName1 varName2

Get the specified parameter, as described with the Set parameter to specified range of values option.

-ps; Set parameter to the specified range of values

Syntax: matrix -ps parameter value1 value2

Set parameter to the specified range of values.Possible values for parameter, value1, and value2 are shown below. Only the first parameter letter is required.

DIM nCol nRow -- Sets the matrix column by row size.

X xMin xMax -- Sets the matrix X mapping range.

Y yMin yMax -- Sets the matrix Y mapping range.

-t; Transpose the active matrix

Syntax: matrix -t

Transpose the active matrix.

-v; Fill the matrix with values from the expression

Syntax: matrix -v expression

Fill the matrix with values from the expression.The current XY mapping relation is used. You can use X and Y in the expression, as well as i and j (the row and column number value for any particular cell).

Examples:

The following script puts the X minimum and X maximum values into xmin and xmax.

matrix -pg X xmin xmax;

The next script fills the matrix with the given expression.

matrix -v sin(x)+cos(y);