HALCON Reference Manual 10.0.2
Table of Contents / Image / Creation ClassesClassesClasses | | | Operators

gen_image_gray_rampgen_image_gray_rampgen_image_gray_rampGenImageGrayRampGenImageGrayRamp (Operator)

Name

gen_image_gray_rampgen_image_gray_rampgen_image_gray_rampGenImageGrayRampGenImageGrayRamp — Create a gray value ramp.

Signature

gen_image_gray_ramp( : ImageGrayRamp : Alpha, Beta, Mean, Row, Column, Width, Height : )

Herror gen_image_gray_ramp(Hobject* ImageGrayRamp, double Alpha, double Beta, double Mean, const Hlong Row, const Hlong Column, const Hlong Width, const Hlong Height)

Herror T_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)

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)

void HOperatorSetX.GenImageGrayRamp(
[out] IHUntypedObjectX** ImageGrayRamp, [in] VARIANT Alpha, [in] VARIANT Beta, [in] VARIANT Mean, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Width, [in] VARIANT Height)

void HImageX.GenImageGrayRamp(
[in] double Alpha, [in] double Beta, [in] double Mean, [in] Hlong Row, [in] Hlong Column, [in] Hlong Width, [in] Hlong Height)

static void HOperatorSet.GenImageGrayRamp(out HObject imageGrayRamp, HTuple alpha, HTuple beta, HTuple mean, HTuple row, HTuple column, HTuple width, HTuple height)

void HImage.GenImageGrayRamp(double alpha, double beta, double mean, int row, int column, int width, int height)

Description

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

ImageGrayRampImageGrayRampImageGrayRampImageGrayRampimageGrayRamp(r,c) = AlphaAlphaAlphaAlphaalpha(r-RowRowRowRowrow) +
                        BetaBetaBetaBetabeta(c-ColumnColumnColumnColumncolumn) +
MeanMeanMeanMeanmean

The size of the image is determined by WidthWidthWidthWidthwidth and HeightHeightHeightHeightheight The gray values are of the type 'byte'"byte""byte""byte""byte". Gray values outside the valid area are clipped.

Parallelization

Parameters

ImageGrayRampImageGrayRampImageGrayRampImageGrayRampimageGrayRamp (output_object)  image → objectHImageHImageHImageXHobject * (byte)

Created image with new image matrix.

AlphaAlphaAlphaAlphaalpha (input_control)  real → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (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

BetaBetaBetaBetabeta (input_control)  real → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (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

MeanMeanMeanMeanmean (input_control)  real → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Mean gray value.

Default value: 128

Suggested values: 0.0, 20.0, 40.0, 60.0, 80.0, 100.0, 120.0, 140.0, 160.0, 180.0, 200.0, 220.0, 255.0

Minimum increment: 1

Recommended increment: 10

RowRowRowRowrow (input_control)  point.y → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Line index of reference point.

Default value: 256

Suggested values: 128, 256, 512, 1024

Minimum increment: 1

Recommended increment: 10

ColumnColumnColumnColumncolumn (input_control)  point.x → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Column index of reference point.

Default value: 256

Suggested values: 128, 256, 512, 1024

Minimum increment: 1

Recommended increment: 10

WidthWidthWidthWidthwidth (input_control)  extent.x → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Width of image.

Default value: 512

Suggested values: 128, 256, 512, 1024

Typical range of values: 1 ≤ Width Width Width Width width ≤ 512 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Width >= 1

HeightHeightHeightHeightheight (input_control)  extent.y → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Height of image.

Default value: 512

Suggested values: 128, 256, 512, 1024

Typical range of values: 1 ≤ Height Height Height Height height ≤ 512 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Height >= 1

Result

If the parameter values are correct gen_image_gray_rampgen_image_gray_rampgen_image_gray_rampGenImageGrayRampGenImageGrayRamp returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.

Possible Predecessors

moments_gray_planemoments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlane

Possible Successors

paint_regionpaint_regionpaint_regionPaintRegionPaintRegion, reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain, get_image_pointer1get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1, copy_objcopy_objcopy_objCopyObjCopyObj

Alternatives

gen_image1gen_image1gen_image1GenImage1GenImage1

See also

reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain, paint_graypaint_graypaint_grayPaintGrayPaintGray

Module

Foundation

Table of Contents / Image / Creation ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH