3.3.2.41 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.

-d i; Delete object images in sheet

Syntax: matrix -d i

Delete all cached matrix object images in the sheet

-d1 i; Delete object image from active sheet

Syntax: matrix -d1 i

Delete cached matrix object image from the active sheet

-d2 i; Delete object images except in active sheet

Syntax: matrix -d2 i

Delete all cached matrix object images except in the active sheet

-d m; Delete colormap for objects in sheet

Syntax: matrix -d m

Delete colormap for all matrix objects in the sheet

-d1 m; Delete colormap for active object

Syntax: matrix -d1 m

Delete colormap for the active matrix object only

-d2 m; Delete colormap for all objects except the active object

Syntax: matrix -d2 m

Delete colormap for all matrix objects in the active sheet except the active object

-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.

-g; Convert both matrix data and image to gray scale

Syntax: matrix -g

-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 [option]

matrix -ii -- change to image view mode, active matrix object only

matrix -ii 0 -- change to data mode, active matrix object only

matrix -ii 1 0 -- all objects change to image view

matrix -ii 0 0 -- all objects change to data view

-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 matrixbook, and value = 0, hide image thumbnails for the active matrixbook.

-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).

-vu; Fill the matrix with values, allow undo

Syntax: matrix -vu expression

Same as -v but supports Undo.

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);