disp_polygonT_disp_polygonDispPolygonDispPolygon (Operator)

Name

disp_polygonT_disp_polygonDispPolygonDispPolygon — Displays a polyline.

Signature

disp_polygon( : : WindowHandle, Row, Column : )

disp_polygondisp_polygonDispPolygonDispPolygonDispPolygon displays a polyline with the row coordinates RowRowRowRowrow and the column coordinates ColumnColumnColumnColumncolumn in the output window. The parameters RowRowRowRowrow and ColumnColumnColumnColumncolumn have to be provided as tuples. Straight lines are drawn between the given points. The start and the end of the polyline are not connected.

The operators used to control the display of regions (e.g. set_colorset_colorSetColorSetColorSetColor, set_grayset_graySetGraySetGraySetGray, set_drawset_drawSetDrawSetDrawSetDraw, set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidth) can also be used with polylines.

Attention

The given coordinates must lie within the window.

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

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control) window → (handle)

Window handle.

RowRowRowRowrow (input_control) polygon.y-array → (integer / real)

Row index

Default value: [16,80,80]

Suggested values: 0, 64, 128, 256, 511

Typical range of values: 0 ≤ Row Row Row Row row ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 10

ColumnColumnColumnColumncolumn (input_control) polygon.x-array → (integer / real)

Column index

Default value: [48,16,80]

Suggested values: 0, 64, 128, 256, 511

Typical range of values: 0 ≤ Column Column Column Column column ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 10

Example (C)

/* display a rectangle */

disp_rectangle1_margin1(Hlong WindowHandle,
                        Hlong Row1, long Column1,
                        Hlong Row2, long Column2)
{
  Htuple Row, Col;
  create_tuple(&Row,4) ;
  create_tuple(&Col,4) ;

  set_i(Row,Row1,0) ;
  set_i(Col,Column1,0) ;

  set_i(Row,Row1,1) ;
  set_i(Col,Column2,1) ;

  set_i(Row,Row2,2) ;
  set_i(Col,Column2,2) ;

  set_i(Row,Row2,3) ;
  set_i(Col,Column1,3) ;

  set_i(Row,Row1,4) ;
  set_i(Col,Column1,4) ;

  T_disp_polygon(WindowHandle,Row,Col) ;

}