gen_image_gray_rampgen_image_gray_rampGenImageGrayRampGenImageGrayRamp (Operator)
Name
gen_image_gray_rampgen_image_gray_rampGenImageGrayRampGenImageGrayRamp — Create a gray value ramp.
Signature
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)
void GenImageGrayRamp(HObject* ImageGrayRamp, const HTuple& Alpha, const HTuple& Beta, const HTuple& Mean, const HTuple& Row, const HTuple& Column, const HTuple& Width, const HTuple& Height)
void HImage::GenImageGrayRamp(double Alpha, double Beta, double Mean, Hlong Row, Hlong Column, Hlong Width, 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_rampGenImageGrayRampGenImageGrayRampGenImageGrayRamp 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.
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
ImageGrayRampImageGrayRampImageGrayRampImageGrayRampimageGrayRamp (output_object) image → objectHImageHImageHobject * (byte)
Created image with new image matrix.
AlphaAlphaAlphaAlphaalpha (input_control) real → HTupleHTupleHtuple (real) (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 → HTupleHTupleHtuple (real) (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 → HTupleHTupleHtuple (real) (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 → HTupleHTupleHtuple (integer) (int / long) (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 → HTupleHTupleHtuple (integer) (int / long) (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 → HTupleHTupleHtuple (integer) (int / long) (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 → HTupleHTupleHtuple (integer) (int / long) (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_rampGenImageGrayRampGenImageGrayRampGenImageGrayRamp
returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.
Possible Predecessors
moments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlaneMomentsGrayPlane
Possible Successors
paint_regionpaint_regionPaintRegionPaintRegionPaintRegion,
reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain,
get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1GetImagePointer1,
copy_objcopy_objCopyObjCopyObjCopyObj
Alternatives
gen_image1gen_image1GenImage1GenImage1GenImage1
See also
reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain,
paint_graypaint_grayPaintGrayPaintGrayPaintGray,
gen_image_constgen_image_constGenImageConstGenImageConstGenImageConst
Module
Foundation