disp_polygon

Herror ::disp_polygon ( const HTuple &WindowHandle, const HTuple &Row, const HTuple &Column ) void HWindow::DispPolygon ( const HTuple &Row, const HTuple &Column ) const

Displays a polyline.

::disp_polygon displays a polyline with the row coordinates Row and the column coordinates Column in the output window. The parameters Row and Column 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 procedures used to control the display of regions (e.g. ::set_color, ::set_gray, ::set_draw, ::set_line_width) can also be used with polylines.

Attention

The given coordinates must lie within the window.

Parameters

`WindowHandle` (input_control)	window `->` HTuple.long
Window identifier.

`Row` (input_control)	polygon.y-array `->` HTuple.long / double
Row index
Default value: '[16,80,80]'
Suggested values: 0, 64, 128, 256, 511
Typical range of values: `0 <= Row <= 511` (lin)
Minimum increment: 1
Recommended increment: 10

`Column` (input_control)	polygon.x-array `->` HTuple.long / double
Column index
Default value: '[48,16,80]'
Suggested values: 0, 64, 128, 256, 511
Typical range of values: `0 <= Column <= 511` (lin)
Minimum increment: 1
Recommended increment: 10

Example

/* display a rectangle */ 

disp_rectangle1_margin1(long WindowHandle,
			  long Row1, long Column1,
			  long 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) ;

}

Result

::disp_polygon returns H_MSG_TRUE.

Possible Predecessors

::open_window, ::set_rgb, ::set_lut, ::set_hsi, ::set_draw, ::set_color, ::set_colored, ::set_line_width

Alternatives

::disp_line, ::gen_region_polygon, ::disp_region

Module

System