2.6.4.12 m2img

1 Menu Information
2 Brief Information
3 Command Line Usage
4 X-Function Execution Options
5 Variables
6 Description
7 Examples
8 Algorithm
9 Related X-Functions

Menu Information

Image: Conversion: Convert to Image

Brief Information

Convert data matrix to grayscale image

Command Line Usage

1. m2img bits:=16;

2. m2img min:=0.5 max:=1;

X-Function Execution Options

Please refer to the page for additional option switches when accessing the x-function from script

Variables

Display Name	Variable Name	I/O and Type	Default Value	Description
Input Matrix	im	Input MatrixObject	<active>	Specifies the numeric matrix object to be converted. By default, it is the active matrix object.
Output Image	om	Output MatrixObject	<new>	Specifies the output image. By default, a new image will be created and used for output. See the syntax here.
Bits/Pixel	bits	Input int	8	Specifies the bits per pixel for the output image. The default value is 8.
Black Value	min	Input double	<auto>	Specifies the value to be mapped to the black color. The default input is <auto>, which corresponds to the minimum cell value of the input matrix object.
White Value	max	Input double	<auto>	Specifies the value to be mapped to the white color. The default input is <auto>, which corresponds to the maximum cell value of the input matrix object.

Description

This X-Function converts a numeric matrix object to a grayscale image with mapping. The values in the matrix are mapped to [0, ], where bpp is the specified bits per pixel. The matrix values that are not greater than the specified Black Value will be mapped to 0, which represent the black color; the matrix values that are not less than the specified White Value will be mapped to, which represent the white color; the other values are mapped to the output range linearly.

Note that the grayscale levels in the output image must be integers. Thus, rounding might be performed after mapping, causing some details to be dropped.

Examples

In this example, we create a numeric matrix and use the m2img function to convert it to an 8-bit image:

Create a new matrix with the New Matrix button on the Standard toolbar.
When this matrix is active, select Matrix: Set Values from the menu.
In the Set Values dialog, enter "sin(i)+sin(j)" in the textbox and click the OK button. This fills the matrix with some numeric values.
Keep this matrix active. Select Image: Conversion: Convert to Image from the menu to open the dialog of m2img. Change the settings as the screenshot below and click OK to close the dialog.

A new image like the one below is created.

Algorithm

Let x be a cell value of the input matrix and f(x) be the gray level of the image pixel that correspond to the cell. The linear mapping of x onto f(x) can be expressed as follows:

where bpp is the bits per pixel of the output image, BlackValue and WhiteValue are specified by the values of the variables, Black Value and Black Value, respectively.