NAME

     cj_ds_pen,	pd, pd#, pdc, pdp, pdpp	- display drawing content
     by	pen number

FORMAT

     :cj_ds_pen;='color';=['yn'];:
     :cj_ds_pen;='pen number';=[0-15];=['yn'];:
     :cj_ds_pen;='range';=min;=max;=<CR>[;...];=['yn'];:

ALIASES

     :pd    is an alias	for  :cj_ds_pen
     :pdc   is an alias	for  :cj_ds_pen;='c'
     :pd#   is an alias	for  :cj_ds_pen;='p';=#	 [#=0-15]
     :pdp   is an alias	for  :cj_ds_pen;='r';=0;=8
     :pdpp  is an alias	for  :cj_ds_pen;='r';=0;=15

     (For aliases, remember that pd stands for "pen display".)

LEVEL

     1u

DESCRIPTION

     The :cj_ds_pen command partially automates	 the  display  of
     the  drawing  contents  by	pen number.  If	"color"	is speci-
     fied, all items drawn in pens 1 through 15	will be	displayed
     simultaneously,   using   colors  number  1  through  15  to
     represent the pens	respectively.

     If	"pen number" is	specified, then	the desired pen	number (0
     through  15)  is  entered	and all	items drawn with that pen
     will be displayed.

     If	"range"	is specified, prompts for the minimum and maximum
     pen  numbers are presented.  The screen will then be cleared
     and the items drawn in pens  "min"	 through  "max"	 will  be
     displayed	sequentially,  waiting	for  <CR>  to  be pressed
     between each pen.

     In	all cases, when	the pen	display	is completed, the user is
     given  the	 choice	 of  redisplaying  the original	screen or
     leaving the display in its	current	state.

PROMPTS

     Display pen by?   def: color  pen number  range  color  EXIT
	 Indicate the mode of operation	(as described  above)  by
	 selecting  the	desired	option,	entering the first letter
	 of the	option (either	'c',  'p'  or  'r')  or	 pressing
	 RETURN	to select the default option: "color".	Selecting
	 EXIT (or enter	an e)  causes  the  command  to	 be  ter-
	 minated.

     Enter pen number to display?   def: 0  1  2  3  4	5  6  7	 8

	 When  displaying  contents  by	pen, this prompt asks for
	 the desired pen number	to be displayed.  Once	selected,
	 the  screen  is  cleared and the entities drawn with the
	 specifiec pen are displayed.

     Minimum pen number	to display?   def: 0   OTHER
	 When displaying content by range, this	prompt	asks  for
	 the  minimum  pen  number  to display.	 Enter any number
	 between 0 and 15 inclusive or press RETURN to select the
	 default value of 0.

     Maximum pen number	to display?   def: 8   15   OTHER
	 When displaying content by range, this	prompt	asks  for
	 the  maximum  pen  number  to display.	 Enter any number
	 between 0 and 15 inclusive or press RETURN to select the
	 default value of 8.

     Select action?   def: display next	pen   EXIT
	 When displaying  content  by  pen  number,  this  prompt
	 allows	the user to control when the next display is per-
	 formed.  Selecting display next pen, entering a  'd'  or
	 pressing RETURN to select the default option, causes the
	 screen	to be cleared and the graphic content  associated
	 with  the  next pen to	be displayed.  Selecting EXIT (or
	 entering an e)	causes the sequential display to be  ter-
	 minated.

     Exiting:  Redraw display?	 def: yes   no	 yes
	 This prompt is	displayed just before  the  command  ter-
	 minates.   Selecting  yes,  entering  a  'y' or pressing
	 RETURN	causes the original screen  to	 be  redisplayed.
	 Selecting  no	(or  entering a	'n') leaves the	screen in
	 its current state.

ERROR MESSAGES

     Incorrect response: xxx
	 This message indicates	that the entry xxx was an invalid
	 response.   Check  the	 prompt	 and re-enter the correct
	 value.

     Must enter	a value	between	0 and 15.
	 This message indicates	that an	invalid	 pen  number  was
	 entered.  You must enter a value from 0 to 15 inclusive.

RELATED COMMANDS

     :mn_dpen

AUTHOR

     Jeffery Small

COPYRIGHT

     Copyright c 1995-2005 by CJSA LLC.