setmon - set the current and default video output format
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
////uuuussssrrrr////ggggffffxxxx////sssseeeettttmmmmoooonnnn [ options ] format
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
_s_e_t_m_o_n 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 _s_e_t_m_o_n 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:
----nnnn Specifies that _f_o_r_m_a_t should not be saved and used as the default,
but should just be loaded temporarily. This is the opposite of the
----xxxx option.
----xxxx 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 RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy, VVVVPPPPrrrroooo
Specifies the source of the sync signal. _s_y_n_c_s_e_l_e_c_t is any
combination of rrrr, gggg, bbbb, and aaaa to represent the sync signal on the
same combination of the red, green, blue, and alpha video cables.
If _s_y_n_c_s_e_l_e_c_t is nnnn, the sync signal will be generated on the sync
cable. If _s_y_n_c_s_e_l_e_c_t is not specified, the sync signal will default
to the green cable.
----jjjj_g_e_n_l_o_c_k_d_e_l_a_y
Specifies the number of pixels to adjust the display, relative to
the genlock input signal. Currently, only supported on GGGGRRRR2222 graphics
((((EEEEllllaaaannnn,,,, EEEExxxxttttrrrreeeemmmmeeee,,,, XXXXSSSS oooorrrr XXXXZZZZ)))) 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.
----FFFF_i_n_p_u_t__s_i_g_n_a_l
On systems with GGGGRRRR2222 graphics ((((EEEEllllaaaannnn,,,, EEEExxxxttttrrrreeeemmmmeeee,,,, XXXXSSSS oooorrrr XXXXZZZZ)))), _i_n_p_u_t__s_i_g_n_a_l
specifies whether the input signal used for framelocking is
interlaced (----FFFFiiii) or non-interlaced (----FFFFnnnn).
On IIIInnnnddddyyyy XXXXLLLL graphics systems, it specifies whether the input signal
used for framelocking comes from Vino (----FFFFvvvv) or Galileo (----FFFFgggg) video.
On IIIInnnnddddiiiiggggoooo2222 XXXXLLLL systems, it specifies whether the input signal used
for framelocking comes from the backplane (----FFFFvvvv) or Galileo (----FFFFgggg)
video.
On IIIInnnnddddiiiiggggoooo2222 oooorrrr OOOOCCCCTTTTAAAANNNNEEEE systems with IIIIMMMMPPPPAAAACCCCTTTT graphics, it specifies
whether the input signal used for framelocking is an internal (----FFFFiiii)
or external (----FFFFeeee) video signal.
----LLLL_f_o_r_m_a_t
On system with VVVVpppprrrroooo graphics, _f_o_r_m_a_t specifies the name of the video
format used for external framelocking.
----mmmm_w_i_d_t_h_x_h_e_i_g_h_t
Specifies the area that the X server should manage; this may be
larger than the area displayed by _f_o_r_m_a_t. If not specified, this
defaults to the area required by _f_o_r_m_a_t. This is currently
supported only on RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee.
----SSSS For use only on machines with multiple channel options
(RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee,,,, IIIImmmmppppaaaacccctttt aaaannnndddd OOOOccccttttaaaannnneeee 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.
supports the standard names 50HZ, 60HZ, 72HZ, 76HZ, STR_RECT,
STR_BOT, and STR_TOP. Also, _f_o_r_m_a_t 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
IIIInnnnddddiiiiggggoooo2222 HHHHiiiigggghhhh IIIImmmmppppaaaacccctttt and SSSSoooolllliiiidddd IIIImmmmppppaaaacccctttt and OOOOCCCCTTTTAAAANNNNEEEE SSSSIIII and SSSSSSSSIIII
systems. (Systems with one RRRREEEE.) The directory is
/usr/gfx/ucode/MGRAS/vof/2RSS for IIIInnnnddddiiiiggggoooo2222 MMMMaaaaxxxxiiiimmmmuuuummmm IIIImmmmppppaaaacccctttt and
OOOOCCCCTTTTAAAANNNNEEEE MMMMXXXXIIII systems, which have two RRRREEEE's.
The following letters at the end of a format name signify:
pppp format is for a Flat-Panel Display.
ssss format is for stereo.
____33332222ddddbbbb allows deep (32-bit) double-buffered visuals, but with
no Z.
____ppppbbbbuuuuffff allows programs to allocate pbuffers in the Z
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 _c_o_m_b_i_n_a_t_i_o_n_s are supported.
On IIIInnnnffffiiiinnnniiiitttteeee RRRReeeeaaaalllliiiittttyyyy, _s_e_t_m_o_n requires a combination file - a
file describing frame buffer layout and formats for all
channels - as the _f_o_r_m_a_t 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 _s_e_t_m_o_n.
For backward compatibility, _s_e_t_m_o_n supports a set of pre-built
combinations that contain only one format each. These
combinations are named similarly to the corresponding formats
on RRRReeeeaaaalllliiiittttyyyy EEEEnnnnggggiiiinnnneeee.
The NNNNTTTTSSSSCCCC and PPPPAAAALLLL 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.
_s_e_t_m_o_n does not control the composite outputs of RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee or
IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy. For RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, the composite output is controlled
by the _v_o_u_t command. For IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy, it is controlled by the
_i_r_c_o_m_b_i_n_e(_1_g) 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 /_u_s_r/_g_f_x/_u_c_o_d_e/_v_o_f subdirectory. A given user-defined format
may then be selected by specifying the file name as the _f_o_r_m_a_t argument.
sets the video output format to 30 Hz, sync-on-green.
/usr/gfx/setmon -x 1280x1024_60
sets a RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy, IIIIMMMMPPPPAAAACCCCTTTT or CCCCRRRRMMMM 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 RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee or IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy 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 /_u_s_r/_g_f_x/_u_c_o_d_e/_v_o_f subdirectory. The
format is genlocked and with sync-on-red/green/blue.
NNNNOOOOTTTTEEEESSSS
1. Above, IIIIMMMMPPPPAAAACCCCTTTT graphics also refers to:
IIIIMMMMPPPPAAAACCCCTTTTPPPPCCCC (Impact graphics on IP28)
and
IIIIMMMMPPPPAAAACCCCTTTTSSSSRRRR (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 IIIIMMMMPPPPAAAACCCCTTTT and CCCCRRRRMMMM, 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
In addition, the pixel depth on RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee and IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy 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 GGGGRRRR2222 graphics ((((EEEEllllaaaannnn,,,, EEEExxxxttttrrrreeeemmmmeeee,,,, XXXXSSSS oooorrrr XXXXZZZZ)))), the X server must be
running before using _s_e_t_m_o_n. On IIIIMMMMPPPPAAAACCCCTTTT graphics, _s_e_t_m_o_n must be run
with the ----xxxx and ----pppp options if the X server is not running.
5. On systems with GGGGRRRR2222 graphics ((((EEEEllllaaaannnn,,,, EEEExxxxttttrrrreeeemmmmeeee,,,, XXXXSSSS oooorrrr XXXXZZZZ)))), sync appears
on the red, green, and blue signals, by default. But you can use the
----ssss <<<<rrrr,,,,gggg,,,,bbbb,,,,nnnn>>>>
option to specify otherwise. Sync is always on the sync pin.
6. On systems with CCCCRRRRMMMM or IIIIMMMMPPPPAAAACCCCTTTT 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. _S_T_R__B_O_T 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. _S_T_R__T_O_P 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. _S_T_R__R_E_C_T 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 IIIInnnnddddiiiiggggoooo2222 XXXXLLLL board to a slave and
the "-Fv" framelocks the slave to the sync signal coming from the
backplane of the IIIInnnnddddiiiiggggoooo2222. If the board is the slave by default, you
don't need the -c option. Type "/usr/gfx/gfxinfo" to see the default
