disp_polygon

disp_polygon ( : : WindowHandle, Row, Column : )

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 `->` integer
Window identifier.

`Row` (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 <= 511` (lin)
Minimum increment: 1
Recommended increment: 10

`Column` (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 <= 511` (lin)
Minimum increment: 1
Recommended increment: 10

Example (Syntax: C)

/* 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 2 (H_MSG_TRUE).

Parallelization Information

disp_polygon is reentrant, local, and processed without parallelization.

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

Foundation