image_plane ( : ImagePlane : Alpha, Beta, Mean, Row, Column, Width, Height : )

Create a gray value plane.

The operator image_plane creates an image plane according to the following equation:

ImagePlane(r,c) = Alpha(r-Row) +
                        Beta(c-Column) +
Mean
The size of the image is determined by Width and Height The gray values are of the type byte. Gray values outside the valid area are clipped.


Parameters

ImagePlane (output_object)
image -> object : byte
Created image with new image matrix.

Alpha (input_control)
number -> real
Gradient in line direction
Default value: 1.0
Suggested values: -2.0, -1.0, -0.5, -0.0, 0.5, 1.0, 2.0
Minimum increment: 0.000001
Recommended increment: -0.005

Beta (input_control)
number -> real
Gradient in column direction
Default value: 1.0
Suggested values: -2.0, -1.0, -0.5, -0.0, 0.5, 1.0, 2.0
Minimum increment: 0.000001
Recommended increment: -0.005

Mean (input_control)
number -> real
Mean gray value
Default value: 128
Suggested values: 0, 20, 40, 60, 80, 100, 120, 140, 160, 180, 200, 220, 255
Minimum increment: 1
Recommended increment: 10

Row (input_control)
point.y -> integer
Line index of reference point
Default value: 256
Suggested values: 128, 256, 512, 1024
Minimum increment: 1
Recommended increment: 10

Column (input_control)
point.x -> integer
Column index of reference point
Default value: 256
Suggested values: 128, 256, 512, 1024
Minimum increment: 1
Recommended increment: 10

Width (input_control)
extent.x -> integer
Width of image
Default value: 512
Suggested values: 128, 256, 512, 1024
Range of values: 1 <= Width <= 512 (lin)
Minimum increment: 1
Recommended increment: 10
Restriction: Width >= 1

Height (input_control)
extent.y -> integer
Height of image
Default value: 512
Suggested values: 128, 256, 512, 1024
Range of values: 1 <= Height <= 512 (lin)
Minimum increment: 1
Recommended increment: 10
Restriction: Height >= 1


Result

If the parameter values are correct image_plane returns the value TRUE. Otherwise an exception is raised.


Possible Predecessors

grey_moments


Possible Successors

paint_region__, reduce_domain, get_image_pointer__, copy_obj


Alternatives

create_image


See also

reduce_domain, paint_grey__



Copyright © 1996-1997 MVTec Software GmbH