Accusoft ImagXpress 13
Matrix Method

The address to the filter matrix values, specified as a simple array of shorts with 9 elements.

Valid matrix values are -32767 to 32767.

The nIPMatrixV is mapped to a 3x3 array used for filtering the image.

An integer expression that evaluates to the divisor of the matrix filter values.

Valid range is -999 to 999.

Note: An error is set if 0 is used as it is not divisible by 0.

An integer expression that evaluates to the intensity of the matrix filter.

Valid range is 0 to 10.

Description

This method has been deprecated and will be removed from ImagXpress in a future release. Please use MatrixV instead.

Modifies the image using a 3x3 correlation matrix filter.

Syntax
Visual Basic
Public Sub Matrix( _
   ByRef IPMatrixV As Integer, _
   ByVal IPMatrixD As Integer, _
   ByVal IPMatrixI As Integer _
) 
Parameters
IPMatrixV

The address to the filter matrix values, specified as a simple array of shorts with 9 elements.

Valid matrix values are -32767 to 32767.

The nIPMatrixV is mapped to a 3x3 array used for filtering the image.

IPMatrixD

An integer expression that evaluates to the divisor of the matrix filter values.

Valid range is -999 to 999.

Note: An error is set if 0 is used as it is not divisible by 0.

IPMatrixI

An integer expression that evaluates to the intensity of the matrix filter.

Valid range is 0 to 10.

Remarks

The convolution matrix filter alters each pixel's color based on its current color and the colors of any neighboring pixels. The array of IPMatrixV matrix values are coefficients. When a pixel is processed, its color value is multiplied by the coefficient in the array's center and any pixels within the 3x3 grid are multiplied by the corresponding coefficients in the array. The sum of the products becomes the target pixel's new value.

Example
The following Visual Basic source code demonstrates how to use the Matrix method to sharpen an image:
Dim matrixValues(9) As Integer
matrixValues(0) = -1
matrixValues(1) = -1
matrixValues(2) = -1
matrixValues(3) = -1
matrixValues(4) = 9
matrixValues(5) = -1
matrixValues(6) = -1
matrixValues(7) = -1
matrixValues(8) = -1
ImagXpress1.Matrix matrixValues(0), 1, 2
See Also

ImagXpress Object  | ImagXpress Members  | Color Image Processing  | Image Processing

 

 


©2015. Accusoft Corporation. All Rights Reserved.

Send Feedback