set_line_approxT_set_line_approxSetLineApproxSetLineApproxset_line_approx (Operator)

Name

set_line_approxT_set_line_approxSetLineApproxSetLineApproxset_line_approx — Define the approximation error for contour display.

Warning

set_line_approxset_line_approxSetLineApproxSetLineApproxSetLineApproxset_line_approx is obsolete and is only provided for reasons of backward compatibility.

Signature

set_line_approx( : : WindowHandle, Approximation : )

Herror T_set_line_approx(const Htuple WindowHandle, const Htuple Approximation)

void SetLineApprox(const HTuple& WindowHandle, const HTuple& Approximation)

void HWindow::SetLineApprox(Hlong Approximation) const

static void HOperatorSet.SetLineApprox(HTuple windowHandle, HTuple approximation)

void HWindow.SetLineApprox(int approximation)

def set_line_approx(window_handle: HHandle, approximation: int) -> None

Description

set_line_approxset_line_approxSetLineApproxSetLineApproxSetLineApproxset_line_approx defines the approximation error for region and xld contour display in the window WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle. ApproximationApproximationApproximationApproximationapproximationapproximation values greater than zero cause an approximation of line strokes using less points. This may enable faster and in some cases smoother visualization. The parameter describes the maximal deviation in pixels of the approximated contour from the original contour (Ramer-Douglas-Peucker algorithm).

Execution Information

Parameters

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control)  window HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Window handle.

ApproximationApproximationApproximationApproximationapproximationapproximation (input_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Maximum deviation from the original contour.

Default value: 0

Typical range of values: 0 ≤ Approximation Approximation Approximation Approximation approximation approximation

Restriction: Approximation >= 0

Example (HDevelop)

* Calling...
set_line_approx(WindowHandle,Approximation)
set_draw(WindowHandle,'margin')
disp_region(Obj,WindowHandle)

* ...corresponds with
get_region_polygon(Obj,Approximation,Row,Col)
disp_polygon(WindowHandle,Row,Col)

Example (C)

/* Calling... */
T_set_line_approx(WindowHandle,Approximation);
create_tuple_s(mode,"margin");
T_set_draw(WindowHandle, mode);
destroy_tuple(mode);
T_disp_region(Obj,WindowHandle);

/* ...corresponds with */
create_tuple_i(&approximation,0);
create_tuple(&row,0);
create_tuple(&col,0);
T_get_region_polygon(Obj,approximation,&row,&col);
destroy_tuple(approximation);
T_disp_polygon(WindowHandle,row,col);
destroy_tuple(row); destroy_tuple(col);

Example (HDevelop)

* Calling...
set_line_approx(WindowHandle,Approximation)
set_draw(WindowHandle,'margin')
disp_region(Obj,WindowHandle)

* ...corresponds with
get_region_polygon(Obj,Approximation,Row,Col)
disp_polygon(WindowHandle,Row,Col)

Example (HDevelop)

* Calling...
set_line_approx(WindowHandle,Approximation)
set_draw(WindowHandle,'margin')
disp_region(Obj,WindowHandle)

* ...corresponds with
get_region_polygon(Obj,Approximation,Row,Col)
disp_polygon(WindowHandle,Row,Col)

Example (HDevelop)

* Calling...
set_line_approx(WindowHandle,Approximation)
set_draw(WindowHandle,'margin')
disp_region(Obj,WindowHandle)

* ...corresponds with
get_region_polygon(Obj,Approximation,Row,Col)
disp_polygon(WindowHandle,Row,Col)

Result

set_line_approxset_line_approxSetLineApproxSetLineApproxSetLineApproxset_line_approx returns TRUE if the parameter is correct and the window is valid. Otherwise an exception is raised.

Possible Predecessors

get_line_approxget_line_approxGetLineApproxGetLineApproxGetLineApproxget_line_approx

Possible Successors

disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region

Alternatives

get_region_polygonget_region_polygonGetRegionPolygonGetRegionPolygonGetRegionPolygonget_region_polygon, disp_polygondisp_polygonDispPolygonDispPolygonDispPolygondisp_polygon

See also

get_line_approxget_line_approxGetLineApproxGetLineApproxGetLineApproxget_line_approx, set_line_styleset_line_styleSetLineStyleSetLineStyleSetLineStyleset_line_style, set_drawset_drawSetDrawSetDrawSetDrawset_draw, disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region, disp_polygondisp_polygonDispPolygonDispPolygonDispPolygondisp_polygon

Module

Foundation