HALCON Reference Manual 10.0.2
Table of Contents / XLD / Transformations ClassesClassesClasses | | | Operators

shape_trans_xldshape_trans_xldshape_trans_xldShapeTransXldShapeTransXld (Operator)

Name

shape_trans_xldshape_trans_xldshape_trans_xldShapeTransXldShapeTransXld — Transform the shape of contours or polygons.

Signature

shape_trans_xld(XLD : XLDTrans : Type : )

Herror shape_trans_xld(const Hobject XLD, Hobject* XLDTrans, const char* Type)

Herror T_shape_trans_xld(const Hobject XLD, Hobject* XLDTrans, const Htuple Type)

Herror shape_trans_xld(Hobject XLD, Hobject* XLDTrans, const HTuple& Type)

HXLD HXLD::ShapeTransXld(const HTuple& Type) const

HXLDArray HXLDArray::ShapeTransXld(const HTuple& Type) const

void HOperatorSetX.ShapeTransXld(
[in] IHUntypedObjectX* XLD, [out] IHUntypedObjectX*XLDTrans, [in] VARIANT Type)

IHXLDX* HXLDX.ShapeTransXld([in] BSTR Type)

IHXLDX* HXLDContX.ShapeTransXld([in] BSTR Type)

IHXLDX* HXLDPolyX.ShapeTransXld([in] BSTR Type)

IHXLDX* HXLDParaX.ShapeTransXld([in] BSTR Type)

IHXLDX* HXLDModParaX.ShapeTransXld([in] BSTR Type)

IHXLDX* HXLDExtParaX.ShapeTransXld([in] BSTR Type)

static void HOperatorSet.ShapeTransXld(HObject XLD, out HObject XLDTrans, HTuple type)

HXLD HXLD.ShapeTransXld(string type)

Description

shape_transshape_transshape_transShapeTransShapeTrans transforms the input contours or polygons depending on the parameter TypeTypeTypeTypetype:

'convex'

Convex hull.

'ellipse'

Ellipse with the same moments and area as the input contour or polygon. The closed input contour or polygon must not intersect itself, otherwise the resulting ellipse is not meaningful(Whether the input contour or polygon intersects itself or not can be determined with test_self_intersection_xldtest_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXld).

'outer_circle'

Smallest enclosing circle.

'rectangle1'

Smallest enclosing rectangle parallel to the coordinate axes.

'rectangle2'

Smallest enclosing rectangle.

Parallelization

Parameters

XLDXLDXLDXLDXLD (input_object)  xld(-array) objectHXLDHXLDHXLDXHobject

Contours or polygons to be transformed.

XLDTransXLDTransXLDTransXLDTransXLDTrans (output_object)  xld(-array) objectHXLDHXLDHXLDXHobject *

Transformed contours respectively polygons.

TypeTypeTypeTypetype (input_control)  string HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Type of transformation.

Default value: 'convex' "convex" "convex" "convex" "convex"

List of values: 'convex'"convex""convex""convex""convex", 'ellipse'"ellipse""ellipse""ellipse""ellipse", 'outer_circle'"outer_circle""outer_circle""outer_circle""outer_circle", 'rectangle1'"rectangle1""rectangle1""rectangle1""rectangle1", 'rectangle2'"rectangle2""rectangle2""rectangle2""rectangle2"

Result

shape_trans_xldshape_trans_xldshape_trans_xldShapeTransXldShapeTransXld returns 2 (H_MSG_TRUE) if all parameters are correct. The behavior in case of empty input (no contours given) can be set via set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

gen_contours_skeleton_xldgen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXld, edges_sub_pixedges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPix, threshold_sub_pixthreshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPix, gen_contour_polygon_xldgen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXld, test_self_intersection_xldtest_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXld

Alternatives

smallest_circle_xldsmallest_circle_xldsmallest_circle_xldSmallestCircleXldSmallestCircleXld, smallest_rectangle1_xldsmallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld, smallest_rectangle2_xldsmallest_rectangle2_xldsmallest_rectangle2_xldSmallestRectangle2XldSmallestRectangle2Xld, elliptic_axis_xldelliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXld

See also

smallest_circle_xldsmallest_circle_xldsmallest_circle_xldSmallestCircleXldSmallestCircleXld, smallest_rectangle1_xldsmallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld, smallest_rectangle2_xldsmallest_rectangle2_xldsmallest_rectangle2_xldSmallestRectangle2XldSmallestRectangle2Xld, elliptic_axis_xldelliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXld

Module

Foundation


Table of Contents / XLD / Transformations ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH