Home | History | Annotate | Line # | Download | only in iteconfig
iteconfig.8 revision 1.1 

 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.

 $Id: iteconfig.8,v 1.1 1994/04/05 01:56:45 chopps Exp $

.Dd February 3, 1994
.Dt ITECONFIG 8 amiga
.Os 
.Sh NAME
.Nm iteconfig 
.Nd modify bitmaped console attributes at run time.
.Sh SYNOPSIS
.Nm iteconfig
.Op Fl i
.Op Fl v Ar volume
.Op Fl t Ar count
.Op Fl p Ar period
.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 color0 ...
.Sh DESCRIPTION
.Nm iteconfig
is used to modify or examine the amiga's bitmaped console. There are
two areas in the console, the speaker and the display.

p
With the display flags and values, you can set the
.Ar width
,
.Ar height
and
.Ar depth
of the console display. You can also move the display around on the
monitor with a horizontal and vertical
.Ar offset .
Finally the remaining arguments to
.Nm iteconfig
are used as color values for the view, beginning with color 0.

p
The speaker options allow you to set the
.Ar volume
,
.Ar period
and 
.Ar count
of a console beep.

p
The following flags are interpreted by
.Nm iteconfig
l -tag -width indent t Fl i Print information about the console's current state after
.Nm iteconfig
finishes processing all other arguments.
t Fl v Set the volume of the console beep to
.Ar volume
(0 to 63).
t Fl p Set the period of the console beep to
.Ar period
t Fl t Set the number of repititions of the console beep sample to
.Ar count
t Fl w Set the width of the console display to
.Ar width
pixel columns. (positive integer)
t Fl h Set the height of the console display to
.Ar height
pixels rows (
.Ar height
should be an even positive integer).
t Fl d Set the number of bitplanes the console should use to
.Ar depth .
Therefore if
.Ar depth
is 3 then the number of color will be 8.
t Fl x Set the horizontal offset of the console view on the monitor in
.Ar offset
pixel columns. (positive or negative integer)
t Fl y Set the vertical offset of the console view on the monitor in
.Ar offset
pixel rows. (positive or negative integer)
.Sh BUGS
.Ar period
and
.Ar cound
are something users should never deal with. These should be changed
to 
.Ar pitch
and
.Ar time
where time is 100's of a second.