NetBSD/usr.sbin/iteconfig/iteconfig_atari.8

.\"	$NetBSD: iteconfig_atari.8,v 1.1 1995/05/12 21:04:31 leo Exp $
.\"
.\" Copyright (c) 1994 Christian E. Hopps
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"      This product includes software developed by Christian E. Hopps.
.\" 3. The name of the author may not be used to endorse or promote products
.\"    derived from this software without specific prior written permission
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\"
.Dd April 15, 1995
.Dt ITECONFIG 8 atari
.Os 
.Sh NAME
.Nm iteconfig 
.Nd modify console attributes at run time
.Sh SYNOPSIS
.Nm iteconfig
.Op Fl i
.Op Fl f Ar file
.Op Fl v Ar volume
.Op Fl p Ar pitch
.Op Fl t Ar msec
.Op Fl w Ar width
.Op Fl h Ar height
.Op Fl d Ar depth
.Op Fl x Ar offset
.Op Fl y Ar offset
.Op Ar color ...
.Sh DESCRIPTION
.Nm Iteconfig
is used to modify or examine the attributes of the
.Tn Atari's
console bell and bitmapped console display.
The console bell's volume, pitch, and count may be
specified, as well as
the bitmapped display's width, height, horizontal and
vertical offset, pixel depth, and color map.
.Pp
The following flags are interpreted by
.Nm iteconfig :
.Bl -tag -width indent
.It Fl i
After processing all other arguments,
print information about the console's state.
.It Fl f
Open and use the terminal named by
.Ar file
rather than the default console
.Nm "/dev/ttye0".
.It Fl v
Set the volume of the console bell to
.Ar volume ,
which must be between 0 and 63, inclusive.
.It Fl p
Set the pitch of the console bell to
.Ar pitch ,
which must be between 10 and 1399.
.It Fl t
Set the duration of the beep to
.Ar msec 
milliseconds which must be between 1 and 5000 (5 seconds).
.It Fl w
Set the width of the console display to
.Ar width
pixel columns.
.Ar Width
must be a positive integer.
.It Fl h
Set the height of the console display to
.Ar height
pixel rows.
.Ar Height 
must be a positive integer.
.It Fl d
Set the number of bitplanes the console view should use to
.Ar depth .
For example, if
.Ar depth
is 3 then 8 colors will be used.
.It Fl x
Set the horizontal offset of the console view on the monitor to
.Ar offset
pixel columns.  The horizontal offset may be a positive or a
negative integer, positive being an offset to the right, negative
to the left.
.It Fl y
Set the vertical offset of the console view on the monitor to
.Ar offset
pixel rows.  The vertical offset may be a positive or a negative
integer, positive being an offset down, negative up.
.El
.Pp
Any additional arguments will be interpreted as colors and will
be used to supply the color values for the console view's
color map, starting with the first entry in the map.  (See the
.Sx COLOR SPECIFICATION
section of this manual page for information on how to specify
colors.)
If more colors are supplied than are usable by the console
view, a warning is printed and the extra colors are ignored.
.Sh COLOR SPECIFICATION
Colors are hexidecimal numbers which have one of the following
formats:
.Bl -tag -width "0xRRGGBB"
.It Ar 0xRRGGBB
.Ar RR ,
.Ar GG ,
and
.Ar BB
are taken to be eight-bit values specifying the
intensities of the red, green and blue components, respectively,
of the color to be used.  For example, 
.Li 0xff0000
is bright red,
.Li 0xffffff
is white, and
.Li 0x008080
is dark cyan.
.It Ar 0xGG
.Ar GG
is taken to be an eight-bit value specifying the intensity
of grey to be used.  A value of
.Li 0x00
is black, a value of
.Li 0xff
is white, and a value of
.Li 0x80
is a grey
approximately half way in between.
.It Ar 0xM
.Ar M
is taken to be the one-bit monochrome value to be used.
A value of
.Li 0x1
is black, and a value of
.Li 0x0
is white.
.El