gen_image_surface_first_order gen_image_surface_first_order GenImageSurfaceFirstOrder GenImageSurfaceFirstOrder gen_image_surface_first_order (Operator)
gen_image_surface_first_order gen_image_surface_first_order GenImageSurfaceFirstOrder GenImageSurfaceFirstOrder gen_image_surface_first_order
— Create a tilted gray surface with first order polynomial.
Signature
Herror gen_image_surface_first_order (Hobject* ImageSurface , const char* Type , double Alpha , double Beta , double Gamma , double Row , double Column , 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 Column , const Htuple Width , const Htuple Height )
void GenImageSurfaceFirstOrder (HObject* ImageSurface , const HTuple& Type , const HTuple& Alpha , const HTuple& Beta , const HTuple& Gamma , const HTuple& Row , const HTuple& Column , const HTuple& Width , const HTuple& Height )
void HImage ::GenImageSurfaceFirstOrder (const HString& Type , double Alpha , double Beta , double Gamma , double Row , double Column , Hlong Width , Hlong Height )
void HImage ::GenImageSurfaceFirstOrder (const char* Type , double Alpha , double Beta , double Gamma , double Row , double Column , Hlong Width , Hlong Height )
void HImage ::GenImageSurfaceFirstOrder (const wchar_t* Type , double Alpha , double Beta , double Gamma , double Row , double Column , Hlong Width , Hlong Height )
(
Windows only)
static void HOperatorSet .GenImageSurfaceFirstOrder (out HObject imageSurface , HTuple type , HTuple alpha , HTuple beta , HTuple gamma , HTuple row , HTuple column , HTuple width , HTuple height )
void HImage .GenImageSurfaceFirstOrder (string type , double alpha , double beta , double gamma , double row , double column , int width , int height )
Description The operator
gen_image_surface_first_order gen_image_surface_first_order GenImageSurfaceFirstOrder GenImageSurfaceFirstOrder gen_image_surface_first_order
creates a tilted
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_first_order fit_surface_first_order FitSurfaceFirstOrder FitSurfaceFirstOrder fit_surface_first_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_first_order fit_surface_first_order FitSurfaceFirstOrder FitSurfaceFirstOrder fit_surface_first_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_first_order(RegionIntersection, Image, Algorithm, Iterations, ClippingFactor, Alpha, Beta, Gamma) fit_surface_first_order(RegionIntersection, Image, Algorithm, Iterations, ClippingFactor, Alpha, Beta, Gamma) FitSurfaceFirstOrder(RegionIntersection, Image, Algorithm, Iterations, ClippingFactor, Alpha, Beta, Gamma) FitSurfaceFirstOrder(RegionIntersection, Image, Algorithm, Iterations, ClippingFactor, Alpha, Beta, Gamma) fit_surface_first_order(RegionIntersection, Image, Algorithm, Iterations, ClippingFactor, Alpha, Beta, Gamma)
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_first_order(ImageSurface, Type, Alpha, Beta, Gamma, Row, Column, Width, Height) gen_image_surface_first_order(ImageSurface, Type, Alpha, Beta, Gamma, Row, Column, Width, Height) GenImageSurfaceFirstOrder(ImageSurface, Type, Alpha, Beta, Gamma, Row, Column, Width, Height) GenImageSurfaceFirstOrder(ImageSurface, Type, Alpha, Beta, Gamma, Row, Column, Width, Height) gen_image_surface_first_order(ImageSurface, Type, Alpha, Beta, Gamma, Row, Column, Width, Height)
The gray values are of the type Type Type Type type type
(see gen_image_const gen_image_const GenImageConst GenImageConst gen_image_const
for a detailed description of the pixel types).
Gray values outside the valid area are clipped.
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
(output_object) image →
object HImage HObject HObject Hobject * (byte / uint2 / real)
Created image with new image matrix.
Type Type Type type type
(input_control) 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
(input_control) 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
Beta Beta Beta beta beta
(input_control) 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
Gamma Gamma Gamma gamma gamma
(input_control) 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
(input_control) 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
(input_control) 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
(input_control) 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
(input_control) 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
Result
If the parameter values are correct gen_image_surface_first_order gen_image_surface_first_order GenImageSurfaceFirstOrder GenImageSurfaceFirstOrder gen_image_surface_first_order
returns the value 2 (
H_MSG_TRUE )
. Otherwise an exception is raised.
Possible Predecessors
fit_surface_first_order fit_surface_first_order FitSurfaceFirstOrder FitSurfaceFirstOrder fit_surface_first_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_second_order gen_image_surface_second_order GenImageSurfaceSecondOrder GenImageSurfaceSecondOrder gen_image_surface_second_order
,
gen_image_const gen_image_const GenImageConst GenImageConst gen_image_const
Module
Foundation