Herror ::gen_image_gray_ramp (
    Hobject *ImageGrayRamp,
    const HTuple &Alpha,
    const HTuple &Beta,
    const HTuple &Mean,
    const HTuple &Row,
    const HTuple &Column,
    const HTuple &Width,
    const HTuple &Height
)
HImage HImage::GenImageGrayRamp (
    const HTuple &Alpha,
    const HTuple &Beta,
    const HTuple &Mean,
    const HTuple &Row,
    const HTuple &Column,
    const HTuple &Width,
    const HTuple &Height
)

Create a gray value ramp.

The operator ::gen_image_gray_ramp creates a gray value ramp according to the following equation: 

ImageGrayRamp(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

ImageGrayRamp (output_object)
 image -> Hobject * : HImage ( byte )
Created image with new image matrix.

Alpha (input_control)
 number -> HTuple.double
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 -> HTuple.double
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 -> HTuple.double
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 -> HTuple.long
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 -> HTuple.long
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 -> HTuple.long
Width of image.
Default value: 512
Suggested values: 128, 256, 512, 1024
Typical range of values: 1 <= Width <= 512 (lin)
Minimum increment: 1
Recommended increment: 10
Restriction: Width >= 1

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

Result

If the parameter values are correct ::gen_image_gray_ramp returns the value H_MSG_TRUE. Otherwise an exception handling is raised.

Possible Predecessors

::moments_gray_plane

Possible Successors

::paint_region, ::reduce_domain, ::get_image_pointer1, ::copy_obj

Alternatives

::gen_image1

See also

::reduce_domain, ::paint_gray

Module

Image / region / XLD management

Copyright © 1996-2002 MVTec Software GmbH