Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
VDRAW(nged)		     BRL-CAD MGED Commands		   VDRAW(nged)

NAME
       vdraw - Allows drawing of lines and polygons (optionally	with per
       vertex normals) in the MGED graphics display. It	is used	to build a
       named list of drawing commands for MGED,	send the list to the MGED
       display,	modify the list, or delete all or part of the list.

SYNOPSIS
       vdraw {command} [args]

DESCRIPTION
       Allows drawing of lines and polygons (optionally	with per vertex
       normals)	in the MGED graphics display. It is used to build a named list
       of drawing commands for MGED, send the list to the MGED display,	modify
       the list, or delete all or part of the list. All	vertices in the	vdraw
       command are in millimeters. The MGED drawing commands are represented
       by integers in the vdraw	command. The MGED drawing commands and the
       integers	that vdraw uses	for them are:

       Table 1.	Drawing	Commands
	   +-----------------------+---------------+---------------------+
	   |	 MGED Drawing	   | Vdraw integer |	 MGED Action	 |
	   |	 Command	   |		   |			 |
	   +-----------------------+---------------+---------------------+
	   |  RT_VLIST_LINE_MOVE   |	   0	   | Begin a new line at |
	   |			   |		   | this point		 |
	   +-----------------------+---------------+---------------------+
	   |  RT_VLIST_LINE_DRAW   |	   1	   |  Draw line	from	 |
	   |			   |		   |  previous point to	 |
	   |			   |		   |  this point	 |
	   +-----------------------+---------------+---------------------+
	   | RT_VLIST_POLY_START   |	   2	   |   Start polygon	 |
	   |			   |		   |   (argument is	 |
	   |			   |		   |   surface normal)	 |
	   +-----------------------+---------------+---------------------+
	   |  RT_VLIST_POLY_MOVE   |	   3	   |   move to first	 |
	   |			   |		   |   polygon vertex	 |
	   +-----------------------+---------------+---------------------+
	   |  RT_VLIST_POLY_DRAW   |	   4	   | Subsequent	polygon	 |
	   |			   |		   | vertices		 |
	   +-----------------------+---------------+---------------------+
	   |  RT_VLIST_POLY_END	   |	   5	   | Last polygon vertex |
	   |			   |		   | (should be	same as	 |
	   |			   |		   | first)		 |
	   +-----------------------+---------------+---------------------+
	   |RT_VLIST_POLY_VERTNORM |	   6	   | Vertex normal (for	 |
	   |			   |		   | shading		 |
	   |			   |		   | interpolation)	 |
	   +-----------------------+---------------+---------------------+
       The vdraw commands are as follows:

       o   open	-- with	no arguments, this returns A1A if there	is a open
	   list; A0A otherwise.	If an argument is supplied, a command list is
	   opened with the provided name.

       o   write-- with	arguments of
	    i c	x y z, the MGED	drawing	command	#c is placed in	the ith
	   position of the command list	with the vertex	as ( x y z).

	   -- with arguments of
	    next c x y z, the command is placed	at the end of the list.

       o   insert -- with arguments of i c x y z, the MGED drawing command #c
	   is inserted just before the ith position of the command list.

       o   delete -- with an integer argument of i, the	ith command is
	   deleted.

	   -- with an argument of "last," the last command on the list is
	   deleted.

	   -- with an argument of "all," all the commands on the list are
	   deleted.

       o   params -- with an argument of
	    color rrggbb, the color of all objects on this list	is set.	The
	   rrggbb is a hex number representing the color, "ffffff" is white,
	   "ff0000" is red, "00ff00" is	green, etc.

	   -- with a single string argument, the name of the current list is
	   changed.

       o   read	-- with	an integer argument of i, the ith command is returned.

	   -- with an argument of "color," the current color is	returned.

	   -- with an argument of "length," the	number of commands in the
	   current list	is returned.

	   -- with an argument of "name," the name of the current command list
	   is returned.

       o   send	-- send	the current command list to the	MGED display manager.

       o   vlist -- with an argument of	"list,"	return a list of the names of
	   all existing	command	lists.

	   -- with an argument of delete list_name, delete the specified
	   command list.

       All textual arguments may be abbreviated	by their first letter.

EXAMPLES
       The eight examples show the use of the vdraw command with four
       different commands and various arguments	to build a list	of commands to
       draw a square.

       Example 1. Open a specified list.

       mged>vdraw open square

       Opens a list named square.

       Example 2. Set the color.

       mged>vdraw params color ff00

       Sets the	color to green.

       Example 3. Start	a line at the origin.

       mged>vdraw write	next 0 0 0 0

       Starts a	line at	the origin.

       Example 4. Draw a line from the previous	point to a specified point.

       mged>vdraw write	next 1 100 0 0

       Draws a line from the origin to (100 0 0).

       Example 5. Draw a line from the previous	point to a specified point.

       mged>vdraw write	next 1 100 100 0

       Draws a line from the previous point to (100 100	0).

       Example 6. Draw a line from the previous	point to a specified point.

       mged>vdraw write	next 1 0 100 0

       Draws a line from the previous point to (0 100 0).

       Example 7. Draw a line from the previous	point to the origin.

       mged>vdraw write	next 1 0 0 0

       Draws a line from the previous point to the origin.

       Example 8. Send the command list	to the display manager.

       mged>vdraw send

       Draws the square	in the MGED display.

AUTHOR
       BRL-CAD Team

BUG REPORTS
       Reports of bugs or problems should be submitted via electronic mail to
       <devs@brlcad.org>, or via the "cadbug.sh" script.

BRL-CAD				  07/08/2017			   VDRAW(nged)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | AUTHOR | BUG REPORTS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=vdraw&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help