set_line_approxset_line_approxSetLineApproxset_line_approxSetLineApproxSetLineApprox (Operator)

Name

set_line_approxset_line_approxSetLineApproxset_line_approxSetLineApproxSetLineApprox — Define the approximation error for contour display.

Warning

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

Signature

set_line_approx( : : WindowHandle, Approximation : )

set_line_approxset_line_approxSetLineApproxset_line_approxSetLineApproxSetLineApprox defines the approximation error for region and xld contour display in the window WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle. 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).

Parallelization

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control) window → (integer)

Window handle.

ApproximationApproximationApproximationApproximationApproximationapproximation (input_control) integer → (integer)

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... */
set_line_approx(WindowHandle,Approximation) ;
set_draw(WindowHandle,"margin") ;
disp_region(Obj,WindowHandle) ;

/* ...corresponds with */
Htuple Approximation,Row,Col, WindowHandleTuple ;
create_tuple(&Approximation,1) ;
set_i(Approximation,0,0) ;
create_tuple(&WindowHandleTuple,1) ;
set_i(WindowHandleTuple,WindowHandle, 0) ;
T_get_region_polygon(Obj,Approximation,&Row,&Col) ;
T_disp_polygon(WindowHandleTuple,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)

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_approxSetLineApproxset_line_approxSetLineApproxSetLineApprox returns 2 (H_MSG_TRUE) if the parameter is correct and the window is valid. Otherwise an exception is raised.