NAME

     va, vaa, va#, s#, v#, z#, vd#, vc,	vd, vl,	vr, vs,	vv, vz -
     screen view commands


FORMAT

     :va			toggle the current view	angle on/off
     :vaa;=<angle>		set the	view to	the specified angle
     :va[##]			Set the	view to	the indicated angle

     :s[0-9]			save screen as a numbered view
     :v[0-9]			restore	specified numbered view
     :z[0-9]			zoom window & save numbered view
     :vd[0-9]			delete specified numbered view
     :vv			toggle back to previous	view

     :vc;='{y|n}'		clear (delete) all numbered views

     :vd;='{<name>|ALL|MENU}'	delete specified named view
     :vl			list all saved views
     :vr;='<name>'		restore	specified named	view
     :vs;='<name>'		save screen as a named view
     :vz;=P1;=P2;='<name>'	zoom window & save named view


LEVEL

     3u


DESCRIPTION

     The following commands manage screen views	for the	currently
     loaded  database.	 A  view  is a combination of the current
     zoomed area on the	screen along with the angle  of	 rotation
     for  the three axes.  When	it is saved, the view is assigned
     a name which may be used later to restore	those  particular
     parameters.   As  a convenience aid, these	routines manage	a
     special series of ten numbered views with the names:

	     0,	1, 2, 3, 4, 5, 6, 7, 8 and 9

     which are easily manipulated using	 the  commands	described
     below.


COMMANDS

  :va	  [VIEW	ANGLE -	TOGGLE]
     This command immediately  toggles	the  current  view  angle
     on/off.   ARRIS zooms to the full extent of the drawing when
     displaying	the new	view.

  :vaa	   [VIEW ANGLE - SET ANGLE]
     This command prompts for an angle (in degrees) and	then sets
     the  view	to the indicated angle,	rotated	about the Z-axis.
     ARRIS zooms to the	full extent of the drawing when	 display-
     ing the new view.

  :va{15,30,45,60,75,90,135,180,225}  [VIEW ANGLE - SET	ANGLE]
     These commands are	simply convenience  routines  to  quickly
     set  the view angle the specified angle.  For example, :va60
     rotates the view 60 degrees around	the Z-axis.  ARRIS  zooms
     to	 the  full  extent of the drawing when displaying the new
     view.

  :s0  ...  :s9	    [NUMBERED VIEW - SAVE]
     These commands save the current screen view using the number
     indicated	by  the	 command name digit.  Note that	if a view
     has previously been saved to the same number, the older view
     will be silently overwritten.

  :v0  ...  :v9	    [NUMBERED VIEW - RESTORE]
     These commands redisplay the previously saved numbered  view
     indicated	by the command name digit.  If the specified view
     does not exist, then the error message:

	     ERR - View	# not set.  Set	with s#	or z#

     will be displayed.

  :z0  ...  :z9	    [NUMBERED VIEW - ZOOM & SAVE]
     These commands are	similar	to the s# commands but allow  you
     to	 specify  a  two-point	rectangular  area  which is first
     zoomed to and then	saved using the	number indicated  by  the
     command name digit.

     You will see the following	two prompts:

	     First zoom	point:
	     Second zoom point:

     which allow you to	specify	the rectangular	zoom area.   Note
     that  as with the s# commands, if a view has previously been
     saved to the same number, the older view  will  be	 silently
     overwritten.

  :vd0	...  :vd9     [NUMBERED	VIEW - DELETE]
     These commands silently delete the	numbered  view	indicated
     by	the command name digit.	 In other words, there will be no
     confirmation prompt before	deleting the view.  If the speci-
     fied  view	 does  not  exist  (i.e., has not been previously
     saved), then the message:

	     View # does not exist.

     will be displayed.

  :vv	  [TOGGLE PREVIOUS VIEW]
     This command immediately redisplays the previous view.  This
     is	 useful	 for  quickly  toggling	 between  two  views in	a
     drawing.  If a view has not first been  accessed  using  the
     :v#  or  :z#  commands,  then  the	following message will be
     displayed:

     Cannot toggle view.  No previous view has been visited.


  :vc	  [NUMBERED VIEWS - CLEAR ALL]
     This command deletes all of the existing numbered views from
     0 through 9.  The following prompt	is displayed:

	     Delete all	numbered views?	  def: NO   yes	  no

     If	yes is selected	(or if a 'y' is	entered	at the keyboard),
     then all of the numbered view files will be erased.

  :vd	  [NAMED VIEW -	DELETE]
     This command deletes views	by name, and may be used with any
     existing view file.  The following	prompt is displayed:

	     View to purge?   ALL   MENU

     You may enter a valid, existing view  filename  or	 use  the
     MENU  option to display a pop-up menu of existing view files
     in	 order	to  make  your	selection.   If	 an  non-existent
     filename	is   entered,  the  following  error  message  is
     displayed:

	     ERR: no such file

     The command repeats until	you  terminate	it  by	selecting
     STOP.

     If	you choose the ALL option, a pop-up list showing  all  of
     the  existing view	files for the database is displayed along
     with the following	prompt:

	     VERIFY: Purge ALL views?	def: YES   yes	 no

     Review the	list to	be sure	that you want to  delete  all  of
     these  view  files.  If yes is selected (or if a <CR> or 'y'
     is	entered	at the keyboard), then all  of	the  listed  view
     files  will  be  erased  and  the command automatically ter-
     minate.

  :vl	  [NAMED VIEW -	LIST]
     This command displays a pop-up menu which lists all  of  the
     existing view files for the current database.

  :vr	  [NAMED VIEW -	RESTORE]
     This command redisplays the view previously saved using  the
     specified name.  The following prompt is displayed:
	     Name of view to load?   MENU   OTHER

     Enter the name of the desired view	or use the MENU	option to
     display  a	 pop-up	 menu  of existing view	files in order to
     make your selection.  If a	non-existent filename is entered,
     the following error message is displayed:

	     ERR: no such file

     and the command repeats.

  :vs	  [NAMED VIEW -	SAVE]
     This command saves	the current screen view	using the  speci-
     fied name.	 The following prompt is displayed:

	     Name of view to save>

     Enter any desired name (up	to 11 characters).  If the speci-
     fied  name	 is  already  in  use,	the  following	prompt is
     displayed:

	     Overwrite existing	file?	def: NO	  yes	no

     If	yes is selected	(or if a 'y' is	entered	at the keyboard),
     then the current view will	replace	the existing one.

  :vz	  [NAMED VIEW -	ZOOM & SAVE]
     This command allows you to	save  a	 zoomed	 view  using  the
     specified name.  The following two	prompt are displayed:

	     First zoom	point:
	     Second zoom point:

     which  allow  you	to  enter  the	rectangular  zoom   area.
     Finally, you are prompted:

	     Name of view to save>

     Enter any desired name (up	to 11 characters).  If the speci-
     fied  name	 is  already  in  use,	the  following	prompt is
     displayed:

	     Overwrite existing	file?	def: NO	  yes	no

     If	yes is selected	(or if a y is entered at  the  keyboard),
     then the current view will	replace	the existing one.


FILES

     View files	are stored in the DB:views.dir directory  with	a
     .vw   suffix.    The   numbered   view   files   are   named
     [0-9]_<dwg>.vw where <dwg>	is up to the first  nine  charac-
     ters  of the basename of the current sheet	or drawing.  This
     naming convention allows numbered views to	be maintained for
     multiple sheets or	drawing	within the same	database.


FLAGS & PARAMETERS

     #dbnam


RELATED COMMANDS

     :mn_viewsv, :mn_zoom


SEE ALSO

     cj_views.ff: sigmac source	for screen view	support	routines.

     cj_vw_opt.ff: sigmac source for  the  optional  screen  view
     routines described	in this	document.


AUTHOR

     C.	Jeffery	Small <jeff@cjsa.com>


COPYRIGHT

     Copyright c 1993-2005 by CJSA LLC

































Man(1) output converted with man2html