gen_image_surface_second_order gen_image_surface_second_order GenImageSurfaceSecondOrder GenImageSurfaceSecondOrder gen_image_surface_second_order (Operator)
Name
gen_image_surface_second_order gen_image_surface_second_order GenImageSurfaceSecondOrder GenImageSurfaceSecondOrder gen_image_surface_second_order
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 Type Alpha Beta Gamma Delta Epsilon Zeta Row Column Width Height
Herror T_gen_image_surface_second_order (Hobject* ImageSurface Type Alpha Beta Gamma Delta Epsilon Zeta Row Column Width Height
void GenImageSurfaceSecondOrder (HObject* ImageSurface Type Alpha Beta Gamma Delta Epsilon Zeta Row Column Width Height
void HImage ::GenImageSurfaceSecondOrder (const HString& Type Alpha Beta Gamma Delta Epsilon Zeta Row Column Width Height
void HImage ::GenImageSurfaceSecondOrder (const char* Type Alpha Beta Gamma Delta Epsilon Zeta Row Column Width Height
void HImage ::GenImageSurfaceSecondOrder (const wchar_t* Type Alpha Beta Gamma Delta Epsilon Zeta Row Column Width Height
(
Windows only)
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 alpha beta gamma delta epsilon zeta row column width height
def gen_image_surface_second_order (type alpha beta gamma delta epsilon zeta row column width height
Description The operator
gen_image_surface_second_order gen_image_surface_second_order GenImageSurfaceSecondOrder GenImageSurfaceSecondOrder gen_image_surface_second_order creates a curved
gray value surface according to the following equation:
The size of the image is determined by
Width Width Width width width and
Height Height Height height height .
The parameters
Row Row Row row row and
Column Column Column column column define the reference point
of the created gray surface. If
fit_surface_second_order fit_surface_second_order FitSurfaceSecondOrder FitSurfaceSecondOrder fit_surface_second_order was used to
determine the parameters of the gray surface, this reference point should
correspond to the center of gravity that is used in the surface equation
(see
fit_surface_second_order fit_surface_second_order FitSurfaceSecondOrder FitSurfaceSecondOrder fit_surface_second_order ). Its coordinates can be computed as
follows:
intersection(ROI, Image, RegionIntersection) intersection(ROI, Image, RegionIntersection) Intersection(ROI, Image, RegionIntersection) Intersection(ROI, Image, RegionIntersection) intersection(ROI, Image, RegionIntersection)
fit_surface_second_order(RegionIntersection, Image, Algorithm, Iterations, ClippingFactor, Alpha, Beta, Gamma, Delta, Epsilon, Zeta)
area_center(RegionIntersection, Area, Row, Column) area_center(RegionIntersection, Area, Row, Column) AreaCenter(RegionIntersection, Area, Row, Column) AreaCenter(RegionIntersection, Area, Row, Column) area_center(RegionIntersection, Area, Row, Column)
gen_image_surface_second_order(ImageSurface, Type, Alpha, Beta, Gamma, Delta, Epsilon, Zeta, Row, Column, Width, Height) gen_image_surface_second_order(ImageSurface, Type, Alpha, Beta, Gamma, Delta, Epsilon, Zeta, Row, Column, Width, Height) GenImageSurfaceSecondOrder(ImageSurface, Type, Alpha, Beta, Gamma, Delta, Epsilon, Zeta, Row, Column, Width, Height) GenImageSurfaceSecondOrder(ImageSurface, Type, Alpha, Beta, Gamma, Delta, Epsilon, Zeta, Row, Column, Width, Height) gen_image_surface_second_order(ImageSurface, Type, Alpha, Beta, Gamma, Delta, Epsilon, Zeta, Row, Column, Width, Height)
The gray values are of the type Type Type Type type type gen_image_const gen_image_const GenImageConst GenImageConst gen_image_const
Execution Information
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.
Parameters
ImageSurface ImageSurface ImageSurface imageSurface image_surface image → object HImage HObject HObject Hobject * (byte / uint2 / real)
Created image with new image matrix.
Type Type Type type type string → HTuple str HTuple Htuple (string) (string ) (HString ) (char* )
Pixel type.
Default:
'byte'
"byte"
"byte"
"byte"
"byte"
List of values:
'byte' "byte" "byte" "byte" "byte" , 'real' "real" "real" "real" "real" , 'uint2' "uint2" "uint2" "uint2" "uint2"
Alpha Alpha Alpha alpha alpha number → HTuple float HTuple Htuple (real) (double ) (double ) (double )
Second order coefficient in vertical direction.
Default:
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 Beta Beta beta beta number → HTuple float HTuple Htuple (real) (double ) (double ) (double )
Second order coefficient in horizontal direction.
Default:
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
Gamma Gamma Gamma gamma gamma number → HTuple float HTuple Htuple (real) (double ) (double ) (double )
Mixed second order coefficient.
Default:
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
Delta Delta Delta delta delta number → HTuple float HTuple Htuple (real) (double ) (double ) (double )
First order coefficient in vertical direction.
Default:
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
Epsilon Epsilon Epsilon epsilon epsilon number → HTuple float HTuple Htuple (real) (double ) (double ) (double )
First order coefficient in horizontal direction.
Default:
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
Zeta Zeta Zeta zeta zeta number → HTuple float HTuple Htuple (real) (double ) (double ) (double )
Zero order coefficient.
Default:
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
Row Row Row row row number → HTuple float HTuple Htuple (real) (double ) (double ) (double )
Row coordinate of the reference point of the surface.
Default:
256.0
Suggested values:
0.0, 128.0, 256.0, 512.0
Minimum increment:
0.000001
Recommended increment:
-0.005
Column Column Column column column number → HTuple float HTuple Htuple (real) (double ) (double ) (double )
Column coordinate of the reference point of the surface.
Default:
256.0
Suggested values:
0.0, 128.0, 256.0, 512.0
Minimum increment:
0.000001
Recommended increment:
-0.005
Width Width Width width width extent.x → HTuple int HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Width of image.
Default:
512
Suggested values:
128, 256, 512, 1024
Value range:
1
≤
Width
Width
Width
width
width
(lin)
Minimum increment:
1
Recommended increment:
10
Height Height Height height height extent.y → HTuple int HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Height of image.
Default:
512
Suggested values:
128, 256, 512, 1024
Value range:
1
≤
Height
Height
Height
height
height
(lin)
Minimum increment:
1
Recommended increment:
10
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_order gen_image_surface_second_order GenImageSurfaceSecondOrder GenImageSurfaceSecondOrder gen_image_surface_second_order 2 (
H_MSG_TRUE )
. Otherwise an exception is raised.
Possible Predecessors
fit_surface_second_order fit_surface_second_order FitSurfaceSecondOrder FitSurfaceSecondOrder fit_surface_second_order
Possible Successors
sub_image sub_image SubImage SubImage sub_image
See also
gen_image_gray_ramp gen_image_gray_ramp GenImageGrayRamp GenImageGrayRamp gen_image_gray_ramp gen_image_surface_first_order gen_image_surface_first_order GenImageSurfaceFirstOrder GenImageSurfaceFirstOrder gen_image_surface_first_order gen_image_const gen_image_const GenImageConst GenImageConst gen_image_const
Module
Foundation