diff options
Diffstat (limited to 'usr.sbin/grfconfig/grfconfig.8')
| -rw-r--r-- | usr.sbin/grfconfig/grfconfig.8 | 142 |
1 files changed, 106 insertions, 36 deletions
diff --git a/usr.sbin/grfconfig/grfconfig.8 b/usr.sbin/grfconfig/grfconfig.8 index 36f2cf12b34..08f2cfea7f9 100644 --- a/usr.sbin/grfconfig/grfconfig.8 +++ b/usr.sbin/grfconfig/grfconfig.8 @@ -1,8 +1,12 @@ -.\" $NetBSD: grfconfig.8,v 1.3 1995/12/27 07:59:00 chopps Exp $ +.\" $OpenBSD: grfconfig.8,v 1.3 1997/09/18 22:03:45 niklas Exp $ +.\" $NetBSD: grfconfig.8,v 1.4 1997/07/29 17:40:47 veego Exp $ .\" -.\" Copyright (c) 1994 Ezra Story +.\" Copyright (c) 1997 The NetBSD Foundation, Inc. .\" All rights reserved. .\" +.\" This code is derived from software contributed to The NetBSD Foundation +.\" by Ezra Story and Bernd Ernesti. +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -13,37 +17,39 @@ .\" 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 Ezra Story. -.\" 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. +.\" This product includes software developed by the NetBSD +.\" Foundation, Inc. and its contributors. +.\" 4. Neither the name of The NetBSD Foundation nor the names of its +.\" contributors may be used to endorse or promote products derived +.\" from this software without specific prior written permission. .\" +.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS +.\" ``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 REGENTS OR CONTRIBUTORS 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 October 7, 1994 .Dt GRFCONFIG 8 amiga -.Os +.Os OpenBSD .Sh NAME .Nm grfconfig .Nd alter grf device screen mode definitions at run time .Sh SYNOPSIS -.Nm grfconfig +.Nm .Op Fl r .Ar device .Op Ar file .Sh DESCRIPTION -.Nm Grfconfig +.Nm is used to change or view the screen mode definition list contained -in a grf device. You may also alter the console screen definition as well +in a grf device. You may alter the console screen definition as well as the definitions for the graphic screen. The console will automatically reinitialize itself to the new screen mode. .Pp @@ -58,18 +64,18 @@ The grf device to manipulate. This argument is required. .It Ar file The file which contains the mode definitions. If this argument is not specified, -.Nm grfconfig +.Nm will print out of a list of the modes currently loaded into the grf device. .Pp .Sh MODE DEFINITION FILE The mode definitions are taken from a file which has lines of the format: .Pp -num clk wid hi dep hbs hss hse hbe ht vbs vss vse vbe vt +num clk wid hi dep hbs hss hse ht vbs vss vse vt flags .Pp .Bl -tag -width indent .It Ar num -The mode number for 'c' for the console mode. +The mode number or 'c' for the console mode. .It Ar clk The pixel clock in Hz. .It Ar wid @@ -78,17 +84,38 @@ The screen mode's width. The screen mode's height. .It Ar dep The bitdepth of the mode. -.It Ar hbs hss hse hbe ht -The horizonatal timing parameters for the mode in pixel values. All the +.It Ar hbs hss hse ht +The horizontal timing parameters for the mode in pixel values. All the values are relative to the end of the horizontal blank (beginning of the displayed area). -.It Ar vbs vss vse vbe vt +.It Ar vbs vss vse vt The vertical timing paramters for the mode in line values. All the values are relative to the end of vertical blank (beginning of the displayed -area). If vbs is half the width, the grf device will interlace the -display. -If the vbs is twice the width, the grf device will scan double the display. -This is provided the grf device supports those two modes of operation. +area). +.It Ar flags +By default every mode uses negative horizontal and vertical sync pulses, +it is non-interlaced and does not use scandoubling. +.Pp +.Bl -tag -width sync-on-green -offset indent +.It default +Use the default flags: -hsync -vsync +.It doublescan +Doublescan mode +.It interlace +Interlace mode +.It +hsync +Positive horizontal sync pulses +.It -hsync +Negative horizontal sync pulses +.It +vsync +Positive vertical sync pulses +.It -vsync +Negative vertical sync pulses +.It sync-on-green +Composite sync on green +.Pp +.El +.Pp .El .Pp .nf @@ -126,10 +153,53 @@ This is provided the grf device supports those two modes of operation. vbe - +.Sh HISTORY +The +.Nm +command first appeared in +.Nx 1.0 +.Pp +The mode definition file changed two times. +.Pp +In +.Nx 1.0 +all horizontal values were videoclock cycle values instead of pixel values: +.Pp + num clk wid hi dep hbs hss hse hbe ht vbs vss vse vbe vt +.br + 1 31000000 640 480 8 80 86 96 102 104 480 489 492 517 520 + 2 31000000 640 480 8 80 86 96 102 104 240 244 246 258 260 + 3 31000000 640 480 8 80 86 96 102 104 960 978 984 1034 1040 +.Pp +In +.Nx 1.1 +and +.Nx 1.2 : +.Pp + num clk wid hi dep hbs hss hse hbe ht vbs vss vse vbe vt +.br + 1 31000000 640 480 8 640 688 768 816 832 480 489 492 517 520 + 2 31000000 640 480 8 640 688 768 816 832 240 244 246 258 260 + 3 31000000 640 480 8 640 688 768 816 832 960 978 984 1034 1040 +.Pp +the vertical values were used to select the interlace or doublescan mode. +All vertical values were half the width for the interlace mode and twice +the width for the doublescan mode. +.Pp +Beginning with +.Nx 1.3 : +.Pp + num clk wid hi dep hbs hss hse ht vbs vss vse vt flags +.br + 1 31000000 640 480 8 640 688 768 832 480 489 492 520 default + 2 31000000 640 480 8 640 688 768 832 480 489 492 520 interlace + 3 31000000 640 480 8 640 688 768 832 480 489 492 520 doublescan + 4 31000000 640 480 8 640 688 768 832 480 489 492 520 +hsync +vsync +.Pp +hbe and vbe are computed in the grf drivers. +.Pp .Sh BUGS -Some grf devices only understand horizontal cycle values instead of -horizontal pixel values. Add -the option -.Nm -o -to make grfconfig interpret values from the grf device as cycle values. +.Nm +can not set the modes for /dev/grf1, /dev/grf2 and /dev/grf4 +and it will not work for /dev/grf0. + |