HALCON Website / HALCON Operator Reference / Image / Creation
ClassesClassesClassesClasses | | | | Operators

gen_image_surface_second_ordergen_image_surface_second_orderGenImageSurfaceSecondOrdergen_image_surface_second_orderGenImageSurfaceSecondOrderGenImageSurfaceSecondOrder (Operator)

Name

gen_image_surface_second_ordergen_image_surface_second_orderGenImageSurfaceSecondOrdergen_image_surface_second_orderGenImageSurfaceSecondOrderGenImageSurfaceSecondOrder — Create a curved gray surface with second order polynomial.

Signature

gen_image_surface_second_order( : ImageSurface : Type, Alpha, Beta, Gamma, Delta, Epsilon, Zeta, Row, Column, Width, Height : )

Herror gen_image_surface_second_order(Hobject* ImageSurface, const char* Type, double Alpha, double Beta, double Gamma, double Delta, double Epsilon, double Zeta, double Row, double Column, const Hlong Width, const Hlong Height)

Herror T_gen_image_surface_second_order(Hobject* ImageSurface, const Htuple Type, const Htuple Alpha, const Htuple Beta, const Htuple Gamma, const Htuple Delta, const Htuple Epsilon, const Htuple Zeta, const Htuple Row, const Htuple Column, const Htuple Width, const Htuple Height)

Herror gen_image_surface_second_order(Hobject* ImageSurface, const HTuple& Type, const HTuple& Alpha, const HTuple& Beta, const HTuple& Gamma, const HTuple& Delta, const HTuple& Epsilon, const HTuple& Zeta, const HTuple& Row, const HTuple& Column, const HTuple& Width, const HTuple& Height)

HImage HImage::GenImageSurfaceSecondOrder(const HTuple& Type, const HTuple& Alpha, const HTuple& Beta, const HTuple& Gamma, const HTuple& Delta, const HTuple& Epsilon, const HTuple& Zeta, const HTuple& Row, const HTuple& Column, const HTuple& Width, const HTuple& Height)

void GenImageSurfaceSecondOrder(HObject* ImageSurface, const HTuple& Type, const HTuple& Alpha, const HTuple& Beta, const HTuple& Gamma, const HTuple& Delta, const HTuple& Epsilon, const HTuple& Zeta, const HTuple& Row, const HTuple& Column, const HTuple& Width, const HTuple& Height)

void HImage::GenImageSurfaceSecondOrder(const HString& Type, double Alpha, double Beta, double Gamma, double Delta, double Epsilon, double Zeta, double Row, double Column, Hlong Width, Hlong Height)

void HImage::GenImageSurfaceSecondOrder(const char* Type, double Alpha, double Beta, double Gamma, double Delta, double Epsilon, double Zeta, double Row, double Column, Hlong Width, Hlong Height)

void HOperatorSetX.GenImageSurfaceSecondOrder(
[out] IHUntypedObjectX** ImageSurface, [in] VARIANT Type, [in] VARIANT Alpha, [in] VARIANT Beta, [in] VARIANT Gamma, [in] VARIANT Delta, [in] VARIANT Epsilon, [in] VARIANT Zeta, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Width, [in] VARIANT Height)

void HImageX.GenImageSurfaceSecondOrder(
[in] BSTR Type, [in] double Alpha, [in] double Beta, [in] double Gamma, [in] double Delta, [in] double Epsilon, [in] double Zeta, [in] double Row, [in] double Column, [in] Hlong Width, [in] Hlong Height)

static void HOperatorSet.GenImageSurfaceSecondOrder(out HObject imageSurface, HTuple type, HTuple alpha, HTuple beta, HTuple gamma, HTuple delta, HTuple epsilon, HTuple zeta, HTuple row, HTuple column, HTuple width, HTuple height)

void HImage.GenImageSurfaceSecondOrder(string type, double alpha, double beta, double gamma, double delta, double epsilon, double zeta, double row, double column, int width, int height)

Description

The operator gen_image_surface_second_ordergen_image_surface_second_orderGenImageSurfaceSecondOrdergen_image_surface_second_orderGenImageSurfaceSecondOrderGenImageSurfaceSecondOrder creates a curved gray value surface according to the following equation:

The size of the image is determined by WidthWidthWidthWidthWidthwidth and HeightHeightHeightHeightHeightheight. The parameters RowRowRowRowRowrow and ColumnColumnColumnColumnColumncolumn define the reference point of the created gray surface. The gray values are of the type TypeTypeTypeTypeTypetype (see gen_image_constgen_image_constGenImageConstgen_image_constGenImageConstGenImageConst for a detailed description of the pixel types). Gray values outside the valid area are clipped.

Parallelization

Parameters

ImageSurfaceImageSurfaceImageSurfaceImageSurfaceImageSurfaceimageSurface (output_object)  image → objectHImageHImageHImageHImageXHobject * (byte / uint2 / real)

Created image with new image matrix.

TypeTypeTypeTypeTypetype (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Pixel type.

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

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

AlphaAlphaAlphaAlphaAlphaalpha (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Second 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

BetaBetaBetaBetaBetabeta (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Second 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

GammaGammaGammaGammaGammagamma (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Mixed second 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

DeltaDeltaDeltaDeltaDeltadelta (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (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

EpsilonEpsilonEpsilonEpsilonEpsilonepsilon (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (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

ZetaZetaZetaZetaZetazeta (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (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

RowRowRowRowRowrow (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Row coordinate of the reference point 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

ColumnColumnColumnColumnColumncolumn (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Column coordinate of the reference point 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

WidthWidthWidthWidthWidthwidth (input_control)  extent.x → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (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 width ≤ 512 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Width >= 1

HeightHeightHeightHeightHeightheight (input_control)  extent.y → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (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 height ≤ 512 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Height >= 1

Example (HDevelop)

* Adjust an inhomogeneous illumination
* using gen_image_surface_second_order
read_image (Image, 'cap_illumination/cap_illumination_01')
get_image_size (Image, Width, Height)
gen_circle (Circle, 495, 630, 350.5)
difference (Image, Circle, RegionDifference)
fit_surface_second_order (RegionDifference, Image, 'regression', 5, 2, \
                          Alpha, Beta, Gamma, Delta, Epsilon, Zeta)
area_center (RegionDifference, Area, Row, Column)
gen_image_surface_second_order (ImageSurface, 'byte', Alpha, Beta, \
                                Gamma, Delta, Epsilon, Zeta, Row, Column, \
                                Width, Height)
sub_image (Image, ImageSurface, ImageSub, 1, 128)

Result

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

Possible Predecessors

fit_surface_second_orderfit_surface_second_orderFitSurfaceSecondOrderfit_surface_second_orderFitSurfaceSecondOrderFitSurfaceSecondOrder

Possible Successors

sub_imagesub_imageSubImagesub_imageSubImageSubImage

See also

gen_image_gray_rampgen_image_gray_rampGenImageGrayRampgen_image_gray_rampGenImageGrayRampGenImageGrayRamp, gen_image_surface_first_ordergen_image_surface_first_orderGenImageSurfaceFirstOrdergen_image_surface_first_orderGenImageSurfaceFirstOrderGenImageSurfaceFirstOrder, gen_image_constgen_image_constGenImageConstgen_image_constGenImageConstGenImageConst

Module

Foundation

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 13.0.4 Copyright © 1996-2019 MVTec Software GmbH