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

gen_image_surface_first_ordergen_image_surface_first_ordergen_image_surface_first_orderGenImageSurfaceFirstOrderGenImageSurfaceFirstOrder (Operator)

Name

gen_image_surface_first_ordergen_image_surface_first_ordergen_image_surface_first_orderGenImageSurfaceFirstOrderGenImageSurfaceFirstOrder — Create a tilted gray surface with first order polynomial.

Signature

gen_image_surface_first_order( : ImageSurface : Type, Alpha, Beta, Gamma, Row, Col, Width, Height : )

Herror gen_image_surface_first_order(Hobject* ImageSurface, const char* Type, double Alpha, double Beta, double Gamma, double Row, double Col, const Hlong Width, const Hlong Height)

Herror T_gen_image_surface_first_order(Hobject* ImageSurface, const Htuple Type, const Htuple Alpha, const Htuple Beta, const Htuple Gamma, const Htuple Row, const Htuple Col, const Htuple Width, const Htuple Height)

Herror gen_image_surface_first_order(Hobject* ImageSurface, const HTuple& Type, const HTuple& Alpha, const HTuple& Beta, const HTuple& Gamma, const HTuple& Row, const HTuple& Col, const HTuple& Width, const HTuple& Height)

HImage HImage::GenImageSurfaceFirstOrder(const HTuple& Type, const HTuple& Alpha, const HTuple& Beta, const HTuple& Gamma, const HTuple& Row, const HTuple& Col, const HTuple& Width, const HTuple& Height)

void HOperatorSetX.GenImageSurfaceFirstOrder(
[out] IHUntypedObjectX** ImageSurface, [in] VARIANT Type, [in] VARIANT Alpha, [in] VARIANT Beta, [in] VARIANT Gamma, [in] VARIANT Row, [in] VARIANT Col, [in] VARIANT Width, [in] VARIANT Height)

void HImageX.GenImageSurfaceFirstOrder(
[in] BSTR Type, [in] double Alpha, [in] double Beta, [in] double Gamma, [in] double Row, [in] double Col, [in] Hlong Width, [in] Hlong Height)

static void HOperatorSet.GenImageSurfaceFirstOrder(out HObject imageSurface, HTuple type, HTuple alpha, HTuple beta, HTuple gamma, HTuple row, HTuple col, HTuple width, HTuple height)

void HImage.GenImageSurfaceFirstOrder(string type, double alpha, double beta, double gamma, double row, double col, int width, int height)

Description

The operator gen_image_surface_first_ordergen_image_surface_first_ordergen_image_surface_first_orderGenImageSurfaceFirstOrderGenImageSurfaceFirstOrder creates a tilted gray value surface according to the following equation: 

ImageSurfaceImageSurfaceImageSurfaceImageSurfaceimageSurface(r,c) = AlphaAlphaAlphaAlphaalpha(r- RowRowRowRowrow) +
                             BetaBetaBetaBetabeta(c- ColColColColcol) +
                             GammaGammaGammaGammagamma

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

Parallelization

Parameters

ImageSurfaceImageSurfaceImageSurfaceImageSurfaceimageSurface (output_object)  image → objectHImageHImageHImageXHobject * (byte / uint2 / real)

Created image with new image matrix.

TypeTypeTypeTypetype (input_control)  string → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Pixel type.

Default value: 'byte' "byte" "byte" "byte" "byte"

List of values: 'byte'"byte""byte""byte""byte", 'uint2'"uint2""uint2""uint2""uint2", 'real'"real""real""real""real"

AlphaAlphaAlphaAlphaalpha (input_control)  number → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

First order coefficient in vertical 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)  number → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

First order coefficient in horizontal 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

GammaGammaGammaGammagamma (input_control)  number → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Zero order coefficient

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

RowRowRowRowrow (input_control)  number → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

line coordinate of the apex of the surface

Default value: 256.0

Suggested values: 0.0, 128.0, 256.0, 512.0

Minimum increment: 0.000001

Recommended increment: -0.005

ColColColColcol (input_control)  number → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Column coordinate of the apex of the surface

Default value: 256.0

Suggested values: 0.0, 128.0, 256.0, 512.0

Minimum increment: 0.000001

Recommended increment: -0.005

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_surface_first_ordergen_image_surface_first_ordergen_image_surface_first_orderGenImageSurfaceFirstOrderGenImageSurfaceFirstOrder returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.

Possible Predecessors

fit_surface_first_orderfit_surface_first_orderfit_surface_first_orderFitSurfaceFirstOrderFitSurfaceFirstOrder

Possible Successors

sub_imagesub_imagesub_imageSubImageSubImage

See also

gen_image_gray_rampgen_image_gray_rampgen_image_gray_rampGenImageGrayRampGenImageGrayRamp, gen_image_surface_second_ordergen_image_surface_second_ordergen_image_surface_second_orderGenImageSurfaceSecondOrderGenImageSurfaceSecondOrder

Module

Foundation

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