Name
polar_trans_region polar_trans_region PolarTransRegion polar_trans_region PolarTransRegion PolarTransRegion — Transform a region within an annular arc to polar coordinates.
Herror polar_trans_region (const Hobject Region , Hobject* PolarTransRegion , double Row , double Column , double AngleStart , double AngleEnd , double RadiusStart , double RadiusEnd , const Hlong Width , const Hlong Height , const char* Interpolation )
Herror T_polar_trans_region (const Hobject Region , Hobject* PolarTransRegion , const Htuple Row , const Htuple Column , const Htuple AngleStart , const Htuple AngleEnd , const Htuple RadiusStart , const Htuple RadiusEnd , const Htuple Width , const Htuple Height , const Htuple Interpolation )
Herror polar_trans_region (Hobject Region , Hobject* PolarTransRegion , const HTuple& Row , const HTuple& Column , const HTuple& AngleStart , const HTuple& AngleEnd , const HTuple& RadiusStart , const HTuple& RadiusEnd , const HTuple& Width , const HTuple& Height , const HTuple& Interpolation )
HRegion HRegion ::PolarTransRegion (const HTuple& Row , const HTuple& Column , const HTuple& AngleStart , const HTuple& AngleEnd , const HTuple& RadiusStart , const HTuple& RadiusEnd , const HTuple& Width , const HTuple& Height , const HTuple& Interpolation ) const
HRegionArray HRegionArray ::PolarTransRegion (const HTuple& Row , const HTuple& Column , const HTuple& AngleStart , const HTuple& AngleEnd , const HTuple& RadiusStart , const HTuple& RadiusEnd , const HTuple& Width , const HTuple& Height , const HTuple& Interpolation ) const
void PolarTransRegion (const HObject& Region , HObject* PolarTransRegion , const HTuple& Row , const HTuple& Column , const HTuple& AngleStart , const HTuple& AngleEnd , const HTuple& RadiusStart , const HTuple& RadiusEnd , const HTuple& Width , const HTuple& Height , const HTuple& Interpolation )
HRegion HRegion ::PolarTransRegion (const HTuple& Row , const HTuple& Column , double AngleStart , double AngleEnd , const HTuple& RadiusStart , const HTuple& RadiusEnd , Hlong Width , Hlong Height , const HString& Interpolation ) const
HRegion HRegion ::PolarTransRegion (double Row , double Column , double AngleStart , double AngleEnd , double RadiusStart , double RadiusEnd , Hlong Width , Hlong Height , const HString& Interpolation ) const
HRegion HRegion ::PolarTransRegion (double Row , double Column , double AngleStart , double AngleEnd , double RadiusStart , double RadiusEnd , Hlong Width , Hlong Height , const char* Interpolation ) const
void HOperatorSetX .PolarTransRegion ( [in] IHUntypedObjectX* Region , [out] IHUntypedObjectX* * PolarTransRegion , [in] VARIANT Row , [in] VARIANT Column , [in] VARIANT AngleStart , [in] VARIANT AngleEnd , [in] VARIANT RadiusStart , [in] VARIANT RadiusEnd , [in] VARIANT Width , [in] VARIANT Height , [in] VARIANT Interpolation )
IHRegionX* HRegionX .PolarTransRegion ( [in] VARIANT Row , [in] VARIANT Column , [in] double AngleStart , [in] double AngleEnd , [in] VARIANT RadiusStart , [in] VARIANT RadiusEnd , [in] Hlong Width , [in] Hlong Height , [in] BSTR Interpolation )
static void HOperatorSet .PolarTransRegion (HObject region , out HObject polarTransRegion , HTuple row , HTuple column , HTuple angleStart , HTuple angleEnd , HTuple radiusStart , HTuple radiusEnd , HTuple width , HTuple height , HTuple interpolation )
HRegion HRegion .PolarTransRegion (HTuple row , HTuple column , double angleStart , double angleEnd , HTuple radiusStart , HTuple radiusEnd , int width , int height , string interpolation )
HRegion HRegion .PolarTransRegion (double row , double column , double angleStart , double angleEnd , double radiusStart , double radiusEnd , int width , int height , string interpolation )
polar_trans_region polar_trans_region PolarTransRegion polar_trans_region PolarTransRegion PolarTransRegion transforms a Region Region Region Region Region region within the
annular arc specified by the center point (Row Row Row Row Row row ,
Column Column Column Column Column column ), the radii RadiusStart RadiusStart RadiusStart RadiusStart RadiusStart radiusStart and
RadiusEnd RadiusEnd RadiusEnd RadiusEnd RadiusEnd radiusEnd and the angles AngleStart AngleStart AngleStart AngleStart AngleStart angleStart and
AngleEnd AngleEnd AngleEnd AngleEnd AngleEnd angleEnd to its polar coordinate version in a virtual image
of the dimensions Width Width Width Width Width width x Height Height Height Height Height height .
The polar transformation is a change of the coordinate
system. Instead of a row and a column coordinate, each point's
position is expressed by its radius r (i.e. the distance to the
center point Row Row Row Row Row row , Column Column Column Column Column column ) and the angle phi
between the column axis (through the center point) and the line from
the center point towards the point. Note that this transformation is
not affine.
The coordinate (0,0) in the output region always corresponds to
the point in the input region that is specified by
RadiusStart RadiusStart RadiusStart RadiusStart RadiusStart radiusStart and AngleStart AngleStart AngleStart AngleStart AngleStart angleStart . Analogously, the
coordinate (Height Height Height Height Height height -1, Width Width Width Width Width width -1) corresponds to
the point in the input region that is specified by
RadiusEnd RadiusEnd RadiusEnd RadiusEnd RadiusEnd radiusEnd and AngleEnd AngleEnd AngleEnd AngleEnd AngleEnd angleEnd . In the usual mode
(AngleStart AngleStart AngleStart AngleStart AngleStart angleStart < AngleEnd AngleEnd AngleEnd AngleEnd AngleEnd angleEnd and RadiusStart RadiusStart RadiusStart RadiusStart RadiusStart radiusStart
< RadiusEnd RadiusEnd RadiusEnd RadiusEnd RadiusEnd radiusEnd ), the polar transformation is performed in
the mathematically positive orientation (counterclockwise).
Furthermore, points with smaller radii lie in the upper part of the
output region. By suitably exchanging the values of these
parameters (e.g., AngleStart AngleStart AngleStart AngleStart AngleStart angleStart > AngleEnd AngleEnd AngleEnd AngleEnd AngleEnd angleEnd or
RadiusStart RadiusStart RadiusStart RadiusStart RadiusStart radiusStart > RadiusEnd RadiusEnd RadiusEnd RadiusEnd RadiusEnd radiusEnd ), any desired
orientation of the output region can be achieved.
The angles can be chosen from all real numbers. Center point and
radii can be real as well. However, if they are both integers and
the difference of RadiusEnd RadiusEnd RadiusEnd RadiusEnd RadiusEnd radiusEnd and RadiusStart RadiusStart RadiusStart RadiusStart RadiusStart radiusStart equals
Height Height Height Height Height height -1, calculation will be sped up through an
optimized routine.
The radii and angles are inclusive, which means that the first row
of the virtual target image contains the circle with radius
RadiusStart RadiusStart RadiusStart RadiusStart RadiusStart radiusStart and the last row contains the circle with
radius RadiusEnd RadiusEnd RadiusEnd RadiusEnd RadiusEnd radiusEnd . For complete circles, where the
difference between AngleStart AngleStart AngleStart AngleStart AngleStart angleStart and AngleEnd AngleEnd AngleEnd AngleEnd AngleEnd angleEnd equals
(360 degrees), this also means that the first
column of the target image will be the same as the last.
To avoid this, do not make this difference
, but
degrees instead.
The parameter Interpolation Interpolation Interpolation Interpolation Interpolation interpolation is used to select the
interpolation method 'bilinear' "bilinear" "bilinear" "bilinear" "bilinear" "bilinear" or
'nearest_neighbor' "nearest_neighbor" "nearest_neighbor" "nearest_neighbor" "nearest_neighbor" "nearest_neighbor" . Setting Interpolation Interpolation Interpolation Interpolation Interpolation interpolation to
'bilinear' "bilinear" "bilinear" "bilinear" "bilinear" "bilinear" leads to smoother region boundaries, especially
if regions are enlarged. However, the runtime increases
significantly.
If more than one region is passed in Region Region Region Region Region region , their polar
transformations are computed individually and stored as a tuple in
PolarTransRegion PolarTransRegion PolarTransRegion PolarTransRegion PolarTransRegion polarTransRegion . Please note that the indices of an
input region and its transformation only correspond if the system
variable 'store_empty_regions' "store_empty_regions" "store_empty_regions" "store_empty_regions" "store_empty_regions" "store_empty_regions" is set to 'true' "true" "true" "true" "true" "true"
(see set_system set_system SetSystem set_system SetSystem SetSystem ). Otherwise empty output regions are
discarded and the length of the input tuple Region Region Region Region Region region is most
likely not equal to the length of the output tuple
PolarTransRegion PolarTransRegion PolarTransRegion PolarTransRegion PolarTransRegion polarTransRegion .
If Width Width Width Width Width width or Height Height Height Height Height height are chosen greater than the
dimensions of the current image, the system variable
'clip_region' "clip_region" "clip_region" "clip_region" "clip_region" "clip_region" should be set to 'false' "false" "false" "false" "false" "false" (see
set_system set_system SetSystem set_system SetSystem SetSystem ). Otherwise, an output region that does not lie
within the dimensions of the current image can produce an error
message.
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Automatically parallelized on tuple level.
Automatically parallelized on internal data level.
Row Row Row Row Row row (input_control) number → HTuple HTuple HTuple VARIANT Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)
Row coordinate of the center of the arc.
Default value: 256
Suggested values: 0, 16, 32, 64, 128, 240, 256, 480, 512
Typical range of values: 0
≤
Row
Row
Row
Row
Row
row
≤
32767
Restriction: Row >= -131068 && Row <= 131068
Column coordinate of the center of the arc.
Default value: 256
Suggested values: 0, 16, 32, 64, 128, 256, 320, 512, 640
Typical range of values: 0
≤
Column
Column
Column
Column
Column
column
≤
32767
Restriction: Column >= -131068 && Column <= 131068
Width of the virtual output image.
Default value: 512
Suggested values: 256, 320, 512, 640, 800, 1024
Typical range of values: 2
≤
Width
Width
Width
Width
Width
width
≤
32767
Height of the virtual output image.
Default value: 512
Suggested values: 240, 256, 480, 512, 600, 1024
Typical range of values: 2
≤
Height
Height
Height
Height
Height
height
≤
32767
Interpolation method for the transformation.
Default value:
'nearest_neighbor'
"nearest_neighbor"
"nearest_neighbor"
"nearest_neighbor"
"nearest_neighbor"
"nearest_neighbor"
List of values: 'bilinear' "bilinear" "bilinear" "bilinear" "bilinear" "bilinear" , 'nearest_neighbor' "nearest_neighbor" "nearest_neighbor" "nearest_neighbor" "nearest_neighbor" "nearest_neighbor"
polar_trans_image_ext polar_trans_image_ext PolarTransImageExt polar_trans_image_ext PolarTransImageExt PolarTransImageExt ,
polar_trans_image_inv polar_trans_image_inv PolarTransImageInv polar_trans_image_inv PolarTransImageInv PolarTransImageInv ,
polar_trans_region_inv polar_trans_region_inv PolarTransRegionInv polar_trans_region_inv PolarTransRegionInv PolarTransRegionInv ,
polar_trans_contour_xld polar_trans_contour_xld PolarTransContourXld polar_trans_contour_xld PolarTransContourXld PolarTransContourXld ,
polar_trans_contour_xld_inv polar_trans_contour_xld_inv PolarTransContourXldInv polar_trans_contour_xld_inv PolarTransContourXldInv PolarTransContourXldInv
Foundation