SSEETTMMOONN((11GG)) SSEETTMMOONN((11GG))
NNAAMMEE
setmon - set the current and default video output format
SSYYNNOOPPSSIISS
//uussrr//ggffxx//sseettmmoonn [ options ] format
DDEESSCCRRIIPPTTIIOONN
setmon changes the video output format to the one specified; it also
specifies the default video format to be used at system power-up or
graphics initialization. You must set the DISPLAY environment variable
to the local machine (e.g. :0.0) so that any GL calls that setmon makes
will occur on the local machine, and not over a network interface. If
none of (-n, -x, -w) options are specified on the command line, then
setmon will prompt for input to determine whether the format being loaded
should also be saved into the eeprom. If the format is to be loaded into
the eeprom, you must be root, or no operations will take place.
Command line options are:
--nn Specifies that format should not be saved and used as the default,
but should just be loaded temporarily. This is the opposite of the
--xx option.
--xx The specified video format will take effect when the X server
restarts (when one logs out from an X session) or during the next
boot cycle. You must be the root user to use the -x option. This
option is currently allowed on RReeaalliittyyEEnnggiinnee, IInnffiinniitteeRReeaalliittyy, VVPPrroo
((VV66,, VV88)), IIMMPPAACCTT, CCRRMM, XXLL, and GGRR22 ((EEllaann,, EExxttrreemmee,, XXSS oorr XXZZ))
graphics. (CRM graphics is found on O2 workstations).
On RReeaalliittyyEEnnggiinnee and IInnffiinniitteeRReeaalliittyy graphics, this saves the
specified format in the appropriate eeprom in the graphics
subsystem. On other graphics systems, the name of the format is
stored in /var/X11/Xvc/<gfxname><pipe>_TimingTable, where <gfxname>
is:
NNGG11 if the graphics type is XXLL,
GGRR22 if the graphics type is GGRR22,
CCrrmm if the graphics type is CCRRMM,
IImmppaacctt if the graphics type is IIMMPPAACCTT.
OOddyysssseeyy if the graphics type is VVPPrroo.
Except for CCRRMM, <pipe> can be 0 or 1. (A "pipe" is synonomous with
"graphics head" or graphics board".) On CCRRMM graphics, <pipe> is
always 0. Multipipe graphics is not supported on the O2
workstation.
For example, for the first graphics board on an IIMMPPAACCTT system, the
name of the format is stored in /var/X11/Xvc/Impact0_TimingTable.
PPaaggee 11
SSEETTMMOONN((11GG)) SSEETTMMOONN((11GG))
On graphics systems where the format name is not stored in eeprom,
the format specified by "setmon -x" will take effect whenever
graphics is initialized. To do so, use the following command
sequence:
su
(/usr/gfx/stopgfx; /usr/gfx/startgfx) &
--ww On systems which support --xx, specifies that format is to be loaded
now, and also that format will be used as the default when the X
server restarts. (--ww is like --xx, but in addition, the specified
video format is loaded into the hardware immediately.) You must be
root to use the -w option.
--aaacctype
Sets the type of accumulation support for the frame buffer. acctype
specifies either software only support at 16 bits per component
(--aa00) or hardware accelerated support at 24 bits per component
(--aa11).
This option requires the -x option and is only supported on VVPPrroo
graphics.
--ddfbdepthbytes
Specifies the depth of the framebuffer. fbdepthbytes can be either
8 bytes per pixel (--dd88) or 16 bytes per pixel (--dd1166).
This option requires the -x option and is only supported on VVPPrroo
graphics.
--DDDACgainlevel
Specifies the gain level for the DACs. DACgainlevel can be either
the nominal default setting - RS343 (--DDRRSS334433) or VESA level
(--DDVVEESSAA).
This option is only supported on OOCCTTAANNEE systems with IIMMPPAACCTT
graphics.
--gg Enables genlock (external video clock).
This option is not supported on CCRRMM graphics.
--tt Specifies that genlock input operates at TTL levels rather than
nominal video levels (only applicable when genlock is specified).
--TT Specifies that sync output should be at TTL levels rather than
nominal video levels. Currently only supported on RReeaalliittyyEEnnggiinnee;
other systems default to TTL levels.
--GG Specifies that genlock input is through the GREEN input rather than
the SYNC input (only applicable when genlock is specified).
PPaaggee 22
SSEETTMMOONN((11GG)) SSEETTMMOONN((11GG))
--sssyncselect
Specifies the source of the sync signal. syncselect is any
combination of rr, gg, bb, and aa to represent the sync signal on the
same combination of the red, green, blue, and alpha video cables.
If syncselect is nn, the sync signal will be generated on the sync
cable. If syncselect is not specified, the sync signal will default
to the green cable.
--jjgenlockdelay
Specifies the number of pixels to adjust the display, relative to
the genlock input signal. Currently, only supported on GGRR22 graphics
((EEllaann,, EExxttrreemmee,, XXSS oorr XXZZ)) for NTSC and PAL monitors. Positive
values move display to the left, and negative values move display to
the right. Must be used with the -g option.
--FFinput_signal
On systems with GGRR22 graphics ((EEllaann,, EExxttrreemmee,, XXSS oorr XXZZ)), input_signal
specifies whether the input signal used for framelocking is
interlaced (--FFii) or non-interlaced (--FFnn).
On IInnddyy XXLL graphics systems, it specifies whether the input signal
used for framelocking comes from Vino (--FFvv) or Galileo (--FFgg) video.
On IInnddiiggoo22 XXLL systems, it specifies whether the input signal used
for framelocking comes from the backplane (--FFvv) or Galileo (--FFgg)
video.
On IInnddiiggoo22 oorr OOCCTTAANNEE systems with IIMMPPAACCTT graphics, it specifies
whether the input signal used for framelocking is an internal (--FFii)
or external (--FFee) video signal.
--LLformat
On system with VVpprroo graphics, format specifies the name of the video
format used for external framelocking.
--mmwidthxheight
Specifies the area that the X server should manage; this may be
larger than the area displayed by format. If not specified, this
defaults to the area required by format. This is currently
supported only on RReeaalliittyyEEnnggiinnee.
--SS For use only on machines with multiple channel options
(RReeaalliittyyEEnnggiinnee,, IImmppaacctt aanndd OOccttaannee systems). This flag specifies
that the Channel Option should be enabled. You must specify a
format which is appropriate for the option; the available formats
are described in the documentation accompanying the hardware option.
Conventional names for appropriate formats are prefaced by the
number of outputs, ie 4@640x480_60 indicates that four channels,
each 640 wide by 480 tall and refreshed 60 times a second, should be
output. Please note that systems that can drive multiple channels
can also typically drive single channels, and that the -S option
indicates which category of timing formats the user is requesting.
PPaaggee 33
SSEETTMMOONN((11GG)) SSEETTMMOONN((11GG))
--vv Enable verbose mode. On systems supporting custom video output
formats, statistics related to downloaded file size and compression
are printed. For IImmppaacctt and OOccttaannee configurations, requesting a
format that cannot successfully be downloaded with the -v flag will
return formats that can be downloaded.
--pppipenumber
Specifies the pipe for which the format is to be changed on systems
with multiple graphics pipes. The pipenumber is a small integer,
typically 0, 1, or 2. If the pipenumber is not specified with this
command line option, the pipenumber is derived from the trailing
digit of the DISPLAY environment variable. For example, the DISPLAY
value :0.0 refers to pipe 0, :0.1 refers to pipe 1, and :0.2 refers
to pipe 2. On systems with IIMMPPAACCTT graphics, this option must be
used with the --xx option when invoking setmon without the X server
running.
--ccframelock master or slave
Implemented on IInnddiiggoo22 XXLL--XXLL dual-head, and VVPPRROO graphics. On VVpprroo
graphics, used to determine whether to send csync output through the
Genlock port. If --ccmm is used, csync will be output on the Genlock
connector for use in genlocking multiple systems. If --ccss is used,
the csync output will be shut off so that the GGeennlloocckk port can be
used as a genlock input. On IInnddiiggoo22 XXLL--XXLL dual-head use mm to set
the master and use ss to set the slave head if you want to change the
default settings for framelocking through the backplane. By
default, the bottom (pipe0) graphics board will be the master and
the top (pipe1) board will be the slave. The master sends out a
framelock sync signal to the backplane. The slave receives the
framelock sync signal from the backplane. Make sure the pipe number
refers to the appropriate board; set the pipe number as described in
the discussion of the --pp option above. Use --FFvv to framelock the
slave to the sync from the backplane. Use --FFgg to framelock the
master to the Galileo, assuming the video board will be attached to
the master. Refer to the galileo man page for more details on
framelocking to the video board.
format
specifies the desired video output format. format may be the name
of a "standard" format such as 6600 or nnttsscc. Note that case doesn't
matter when specifying a standard format. If not one of the
standard format names, format is interpreted as the filename (minus
the '.vfo' extension) of a valid video format file. Generally,
video format files reside in the directory
/usr/gfx/ucode/<boardname>/vof.
Here is a complete list of the "standard" format names, not all of
which are allowed on all graphics systems:
30hz
30 (alias for 30hz)
50hz
PPaaggee 44
SSEETTMMOONN((11GG)) SSEETTMMOONN((11GG))
50 (alias for 50hz)
60hz
60 (alias for 60hz)
ntsc
hdtv
vga
pr60
pal
343
str_rect
stereo (alias for str_rect)
st492 (alias for str_rect)
str_bot
str_top
sqr_rect
squareo (alias for sqr_rect)
sq492 (alias for sqr_rect)
sqr_bot
sqr_top
vof0
vof1
vof2
vof3
70hz
70 (alias for 70hz)
72hz
72 (alias for 72hz)
75hz
75 (alias for 75hz)
76hz
76 (alias for 76hz)
iris3k
presenter (alias for iris3k)
presenter1280 (alias for 60hz)
XXSS,, XXZZ,, EEllaann,, aanndd EExxttrreemmee GGrraapphhiiccss
support the standard names 30HZ, 50HZ, 60HZ, 72HZ, NTSC, PAL,
IRIS3K, STR_RECT, STR_BOT, STR_TOP and 343. Also, format may
be the name (minus the '.vfo' extension) of one of the video
format files which reside in /usr/gfx/ucode/GR2/vof.
EEnnttrryy//SSttaarrtteerr GGrraapphhiiccss
supports 60HZ.
XXLL GGrraapphhiiccss ((IInnddyy oorr IInnddiiggoo22))
supports supports the standard names 50HZ, 60HZ, 70HZ, 72HZ,
76HZ, NTSC, PAL, IRIS3K, STR_RECT, STR_BOT, and STR_TOP. Video
format files reside in /usr/gfx/ucode/NG1/vof.
PPaaggee 55
SSEETTMMOONN((11GG)) SSEETTMMOONN((11GG))
CCRRMM GGrraapphhiiccss
supports the standard names 50HZ, 60HZ, 72HZ, 70HZ, 75HZ,
STR_RECT, STR_BOT, and STR_TOP. Also allowed is the name
(minus the '.vfo' extension) of one of the video format files
which reside in /usr/gfx/ucode/CRM/vof.
The following letters at the end of a format name signify:
pp format is for a Flat-Panel Display.
ss format is for stereo.
IIMMPPAACCTT GGrraapphhiiccss
supports the standard names 50HZ, 60HZ, 72HZ, 76HZ, STR_RECT,
STR_BOT, and STR_TOP. Also, format may be the name of one of
the video format files (minus the '.vfo' extension). These
files reside in the directory /usr/gfx/ucode/MGRAS/vof for
IInnddiiggoo22 HHiigghh IImmppaacctt and SSoolliidd IImmppaacctt and OOCCTTAANNEE SSII and SSSSII
systems. (Systems with one RREE.) The directory is
/usr/gfx/ucode/MGRAS/vof/2RSS for IInnddiiggoo22 MMaaxxiimmuumm IImmppaacctt and
OOCCTTAANNEE MMXXII systems, which have two RREE's.
The following letters at the end of a format name signify:
pp format is for a Flat-Panel Display.
ss format is for stereo.
__3322ddbb allows deep (32-bit) double-buffered visuals, but with
no Z.
__ppbbuuff allows programs to allocate pbuffers in the Z
bitplanes of the framebuffer.
RReeaalliittyyEEnnggiinnee aanndd IInnffiinniitteeRReeaalliittyy GGrraapphhiiccss
support the standard names 60HZ 30HZ, NTSC, PAL, 343, HDTV,
VGA, 72HZ, STR_RECT, STR_BOT, and STR_TOP. In addition, format
may be the name of one of the video format files, which are
named according to the convention:
<width>x<height>_<framerate>
For example, 1280x1024_60 implies a video format that is 1280
pixels wide, 1024 pixels high and runs at 60 Hz. Letters added
at the end of a format name signify special options:
ii for interlaced,
ss for stereo,
qq for field sequential,
ff for framelocking, and
kk for special alternate formats respectively.
PPaaggee 66
SSEETTMMOONN((11GG)) SSEETTMMOONN((11GG))
For RReeaalliittyyEEnnggiinnee, the video format files reside in the
directory /usr/gfx/ucode/RE/dg2/vof. For IInnffiinniitteeRReeaalliittyy, the
video format files reside in /usr/gfx/ucode/KONA/dg4/vfo.
Those directories contain a README file which describes the
formats shipped with a release.
IInnffiinniittee RReeaalliittyy GGrraapphhiiccss
always operates as a multiple-channel device, and a simple
video format for a single channel is insufficient to describe
the operation of the entire video subsystem. Instead of simple
video formats, only video format combinations are supported.
On IInnffiinniittee RReeaalliittyy, setmon requires a combination file - a
file describing frame buffer layout and formats for all
channels - as the format parameter. These combination files
can be built with a program, ircombine(1g), that assembles an
ensemble of formats. The individual formats used by
ircombine(1g) reside in /usr/gfx/ucode/KONA/dg4/vfo, and are
described in /usr/gfx/ucode/KONA/dg4/vfo/README.
A number of pre-built combinations can be found in the
directory /usr/gfx/ucode/KONA/dg4/cmb. The names of these
files are sometimes precisely descriptive of their content, but
you can use ircombine(1G) to extract a full analysis of any
combination. Note that if you create new combinations of your
own, you must place them in /usr/gfx/ucode/KONA/dg4/cmb before
they can be loaded with setmon.
For backward compatibility, setmon supports a set of pre-built
combinations that contain only one format each. These
combinations are named similarly to the corresponding formats
on RReeaalliittyy EEnnggiinnee.
The NNTTSSCC and PPAALL video formats are actually the 525 and 625 line
component RGB formats, and are not the composite video formats that these
names imply.
To get composite video output from other systems, you may choose to
purchase an encoder option such as the CG3 or BVO (which encodes the 525
or 625 component RGB formats into true NTSC and PAL respectively), or a
video peripheral product which provides composite output from an external
frame buffer.
setmon does not control the composite outputs of RReeaalliittyyEEnnggiinnee or
IInnffiinniitteeRReeaalliittyy. For RReeaalliittyyEEnnggiinnee, the composite output is controlled
by the vout command. For IInnffiinniitteeRReeaalliittyy, it is controlled by the
ircombine(1g) command.
On systems that support custom video output formats, a user-defined
format may be selected by placing the file containing the VOF into the
appropriate /usr/gfx/ucode/vof subdirectory. A given user-defined format
may then be selected by specifying the file name as the format argument.
PPaaggee 77
SSEETTMMOONN((11GG)) SSEETTMMOONN((11GG))
EEXXAAMMPPLLEESS
/usr/gfx/setmon -s g 30HZ
sets the video output format to 30 Hz, sync-on-green.
/usr/gfx/setmon -x 1280x1024_60
sets a RReeaalliittyyEEnnggiinnee, IInnffiinniitteeRReeaalliittyy, IIMMPPAACCTT or CCRRMM to run 1280 x
1024 at 60Hz non-interlaced resolution the next time graphics is
initialized.
/usr/gfx/setmon -x -s b 640x480_180q
sets a RReeaalliittyyEEnnggiinnee or IInnffiinniitteeRReeaalliittyy to run 640 x 480 x 180 Hz
color field sequential output with sync on blue when graphics is
next initialized.
/usr/gfx/setmon -g -s rgb vof3
sets the video output format to the VOF contained in the file vof3.u
found in the appropriate /usr/gfx/ucode/vof subdirectory. The
format is genlocked and with sync-on-red/green/blue.
NNOOTTEESS
1. Above, IIMMPPAACCTT graphics also refers to:
IIMMPPAACCTTPPCC (Impact graphics on IP28)
and
IIMMPPAACCTTSSRR (Impact graphics on OCTANE).
2. Even if you use
/usr/gfx/setmon -n
to change the display resolution to something other than the
resolution that was active when the X server was started, X will
continue to manage a framebuffer area of the original size and
resolution. However, if the new size set by setmon is smaller than
the orignal size, then part of the framebuffer will be unviewable.
3. On IIMMPPAACCTT and CCRRMM, some formats may not be loadable using
/usr/gfx/setmon -n
because those formats require the X server to change its notion of
the screen resolution or the available visuals. To change to these
formats, it is necessary to use
/usr/gfx/setmon -x
and restart the X server.
PPaaggee 88
SSEETTMMOONN((11GG)) SSEETTMMOONN((11GG))
In addition, the pixel depth on RReeaalliittyyEEnnggiinnee and IInnffiinniitteeRReeaalliittyy is
not changed by
/usr/gfx/setmon -n.
To change pixel depth it is necessary to use
/usr/gfx/setmon -x
and restart the X server.
4. On GGRR22 graphics ((EEllaann,, EExxttrreemmee,, XXSS oorr XXZZ)), the X server must be
running before using setmon. On IIMMPPAACCTT graphics, setmon must be run
with the --xx and --pp options if the X server is not running.
5. On systems with GGRR22 graphics ((EEllaann,, EExxttrreemmee,, XXSS oorr XXZZ)), sync appears
on the red, green, and blue signals, by default. But you can use the
--ss <<rr,,gg,,bb,,nn>>
option to specify otherwise. Sync is always on the sync pin.
6. On systems with CCRRMM or IIMMPPAACCTT graphics, sync appears on the red,
green and blue signals. The -s option does not affect the sync
signals on these systems.
7. /usr/gfx/setmon -g -j 10 NTSC
sets the video output format to NTSC, and adjusts display by 10
pixels to the left, relative to the genlock input signal.
8. /usr/gfx/setmon -g -j -10 NTSC
sets the video output format to NTSC, and adjusts display by 10
pixels to the right, relative to the genlock input signal.
9. STR_BOT is used to turn on full-screen stereo, and signals the X
server that the bottom half of the screen is to be displayed as the
primary buffer. STR_TOP is used to turn on full-screen stereo, and
signals the X server that the top half of the screen is to be
displayed as the primary buffer. STR_RECT turns on full-screen
stereo, but does not inform the X server of the fact, which gives the
old full-screen stereo behavior.
10. /usr/gfx/setmon -cs -Fv 1280x1024_50
With the DISPLAY environment variable or the -p option set
appropriately, the "-cs" changes the IInnddiiggoo22 XXLL board to a slave and
the "-Fv" framelocks the slave to the sync signal coming from the
backplane of the IInnddiiggoo22. If the board is the slave by default, you
don't need the -c option. Type "/usr/gfx/gfxinfo" to see the default
settings.
PPaaggee 99
SSEETTMMOONN((11GG)) SSEETTMMOONN((11GG))
11. /usr/gfx/setmon -cm -Fg 1280x1024_50
The "-cm" sets the IInnddiiggoo22 XXLL board to a master which sends a
framelock sync signal to the backplane of the IInnddiiggoo22. The "-Fg"
framelocks the master to the video board which is assumed to be
attached to the master board. If the board is the master by default,
you don't need the -c option. Type "/usr/gfx/gfxinfo" to see the
default settings.
SSEEEE AALLSSOO
ircombine(1g), setmonitor(3g), vout(1V)
PPaaggee 1100
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=setmon&sektion=1&manpath=IRIX+6.5.30>