pgxconfig(1M)						  System Administration Commands					     pgxconfig(1M)

NAME

       pgxconfig, GFXconfig, TSIgfxp_config - configure the PGX32 (Raptor GFX) Graphics Accelerator

SYNOPSIS

       /usr/sbin/pgxconfig  [-dev  device-filename]  [-res  video-mode	 [try  | noconfirm | nocheck] ] [-file	machine | system] [-depth  8 | 24]
       [-24only true | false] [-cachedpixmap true | false] [-defaults]

       /usr/sbin/pgxconfig [-propt] [-prconf]

       /usr/sbin/pgxconfig [-help] [-res  ?]

       /usr/sbin/pgxconfig [-i]

DESCRIPTION

       The pgxconfig utility configures the PGX32 (Raptor GFX) Graphics Accelerator and some of the X11 window system defaults for  PGX32  (Raptor
       GFX). A previous version of this utility was named GFXconfig.

       The  first  form of pgxconfig shown in the synopsis above stores the specified options in the OWconfig file. These options are used to ini-
       tialize the PGX32 (Raptor GFX) device the next time the window system is run on that device. Updating options in the OWconfig file provides
       persistence of these options across window system sessions and system reboots.

       The  second,  third,  and  fourth forms, which invoke only the -prconf, -propt, -help, and -res ? options, do not update the OWconfig file.
       For the third form all other options are ignored.

       The -i option starts pgxconfig in interactive mode.

       Options may be specified for only one PGX32 (Raptor GFX) device at a time.

       Only PGX32 (Raptor GFX)-specific options can be specified through pgxconfig. The normal window system options for specifying default depth,
       default	visual	class and so forth are still specified as device modifiers on the openwin command line. See the Xsun(1) manual page avail-
       able with the SUNWxwman package.

       The user can also specify the OWconfig file that is to be updated. By default, the machine-specific file in the /usr/openwin directory tree
       is  updated.  The  -file  option  can  be  used	to  specify  an alternate file to use. For example, the system-global OWconfig file in the
       /etc/openwin directory tree can be updated instead.

       Both of these standard OWconfig files can only be written by root.

OPTIONS

       The following options are supported:

       -cachedpixmap true | false

	   When set to false, it forces the PGX32 (Raptor GFX) device to use 24-bit only when running OpenWindows. The default value is true.

	   Certain applications make use of a cached pixmap when writing to the display device. Such a technique can cause garbled output and  can
	   cause the X server to crash. If you experience such behavior, try setting the -cachedpixmap option to false.

       -defaults

	   Reset all option values to their default values.

       -depth 8 | 24

	   Sets the screen depth to 8 or 24 bits per pixel. 24 bits per pixel enables TrueColor graphics in the window system.

       -dev device-filename

	   Specify the PGX32 (Raptor GFX) special file. The default is /dev/fbs/gfxp0, or /dev/fbs/raptor0 if applicable.

       -file machine|system

	   Specifies which OWconfig file to update. If machine is specified, the machine-specific OWconfig file in the /etc/openwin directory tree
	   is updated. If system is specified, the global OWconfig file in the /usr/openwin directory tree is updated. If the specified file  does
	   not exist, it is created. This option has no effect unless other options are specified. The default is machine.

       -help

	   Print a list of the pgxconfig command line options, along with a brief explanation of each.

       -i

	   Start pgxconfig in interactive mode.

       -prconf

	   Print the PGX32 (Raptor GFX) hardware configuration. Thie following is a typical display:

	   --- Hardware Configuration for /dev/fbs/gfxp0 ---
	   DAC: version 0x0
	   Type:
	   Board:
	   PROM: version 0x0
	   PROM Information:
	   RAM:
	   EDID Data:
	   Monitor Sense ID:
	   Card possible resolutions:  640x480x60, 800x600x75, 1024x768x60
			  1024x768x70, 1024x768x75, 1280x1024x75, 1280x1024x76
			  1280x1024x60, 1152x900x66, 1152x900x76, 1280x1024x67
			  960x680x112S, 960x680x108S, 640x480x60i, 768x575x50i,
			  1280x800x76, 1440x900x76, 1600x1000x66, 1600x1000x76,
			  vga, svga, 1152, 1280, stereo, ntsc, pal
	   Monitor possible resolutions:  720x400x70, 720x400x88, 640x480x60
			  640x480x67, 640x480x72, 640x480x75, 800x600x56,
			  800x600x60, 800x600x72, 800x600x75, 832x624x75,
			  1024x768x87, 1024x768x60, 1024x768x70, 1024x768x75,
			  1280x1024x75, 1280x1024x76, 1152x900x66, 1152x900x76,
			  1280x1024x67, 960x680x112S, vga, svga, 1152, 1280
			  stereo
	   Current resolution setting: 1280x1024x76
	   Possible depths: 8, 24, 8+24
	   Current depth: 8

       -propt

	   Print  the current values of all PGX32 (Raptor GFX) options in the OWconfig file specified by the -file option for the device specified
	   by the -dev option. Print the values of options as they would be in the OWconfig file after the call to pgxconfig would have completed.
	   The following is a typical display:

	   --- OpenWindows Configuration for /dev/fbs/gfxp0 ---
	   OWconfig: machine
	   Video Mode: not set
	   Depth: 8+24

       -res video-mode [try | noconfirm | nocheck ]

	   Specify the built-in video mode used to drive the monitor connected to the specified PGX32 (Raptor GFX) device.

	   The format for video-mode can be one of the following:

	   widthxheightxrate	   The	width  is the screen width in pixels, height is the screen height in pixels, and rate is the vertical fre-
				   quency of the screen refresh. As a convenience, -res also accepts formats with @ prepended to the refresh  rate
				   rather  than x. For example: 1280x1024@76. The list can be obtained by running pgxconfig with the -res ? option
				   (the third form shown in the command synopsis above). Note that not all resolutions are supported by  both  the
				   video  board and by the monitor. The pgxconfig utility will not permit you to set a resolution not supported by
				   the board unless the noconfirm or nocheck option is specified. It will also request confirmation before setting
				   a resolution not supported by the monitor if the nocheck option is not specified.

	   Symbolic names	   For	convenience,  the  video  modes  listed  below	have  symbolic names defined. Rather than the form widthx-
				   heightxrate, the symbolic name may be supplied as the argument to -res. If  the  symbolic  name  is	none,  the
				   screen  resolution  will be the video mode that is currently programmed in the device when the window system is
				   run.

				   svga     1024x768x60

				   1152     1152x900x76

				   1280     1280x1024x76

				   vga	    640x480x60

				   none     default console resolution

	   The -res option also accepts additional, optional arguments immediately following the video mode specification. Any or all of these may
	   be present.

	   noconfirm

	       Using  the -res option, the user could put the system into an unusable state, a state where there is no video output. This can hap-
	       pen if there is ambiguity in the monitor sense codes for the particular code read. To reduce the  chance  of  this  occurring,  the
	       default behavior of pgxconfig is to print a warning message to this effect and to prompt the user to find out if it is okay to con-
	       tinue. The noconfirm option instructs pgxconfig to bypass this confirmation and to program the requested video  mode  anyway.  This
	       option is useful when pgxconfig is being run from a shell script.

	   nocheck

	       If  present,  normal  error  checking  based  on  the monitor sense code is suspended. The video mode specified by the user will be
	       accepted regardless of whether it is appropriate for the currently attached monitor. (This option is useful if a different  monitor
	       is to be connected to the PGX32 (Raptor GFX) device). Use of this option implies noconfirm as well.

	   try

	       This  option  allows  the  user to test the specified resolution before committing it. It displays a pattern on the screen with the
	       specified resolution. If the test pattern appears correctly, the user may answer "y" to the query. The other permissable answer	is
	       "n".

	       This  sub-option should not be used with pgxconfig while the configured device is being used (for example, while running the window
	       system) as unpredictable results may occur. To run pgxconfig with the try sub-option, the window  system  should  be  brought  down
	       first.

       -res ?

	   Print the list of possible resolutions supported by the PGX32 and the monitor.

       -24only

	   Force the PGX32 (Raptor GFX) device to use 24 bit only when running Openwindows.

DEFAULTS

       For a given invocation of pgxconfig, if an option does not appear on the command line, the corresponding OWconfig option is not updated; it
       retains its previous value, except for -depth and -24only.

       A default value is used if a PGX32 (Raptor GFX) option has not been specified with pgxconfig when the window system  is	run.   The  option
       defaults are as follows:

       -dev	       /dev/fbs/gfxp0

       -file	       system

       -res	       none

       The  default of none for the -res option indicates that when the window system is run, the screen resolution will be the video mode that is
       currently programmed in the device.

EXAMPLES

       Example 1: Switching the Resolution on the Monitor Type

       The following example switches the monitor type to the resolution of 1280 x 1024 at 76 Hz:

       example# /usr/sbin/pgxconfig -res 1280x1024x76

FILES

       /dev/fbs/gfxp0

	   device special file

       /usr/openwin/server/etc/OWconfig

	   system configuration file

       /etc/openwin/server/etc/OWconfig

	   machine configuration file

SEE ALSO

       PGX32 Installation Manual

SunOS 5.10							    8 Apr 2004							     pgxconfig(1M)