xref: /netbsd-src/share/man/man4/man4.amiga/amidisplaycc.4 (revision 82d56013d7b633d116a93943de88e08335357a7c)
1.\"
2.\" Copyright (c) 2000 Jukka Andberg
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\"    notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\"    notice, this list of conditions and the following disclaimer in the
12.\"    documentation and/or other materials provided with the distribution.
13.\"
14.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
15.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
16.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
17.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
18.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
19.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
20.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
21.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
23.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24.\"
25.\" $NetBSD: amidisplaycc.4,v 1.13 2016/02/07 14:06:04 wiz Exp $
26.Dd November 12, 2003
27.Dt AMIDISPLAYCC 4 amiga
28.Os
29.Sh NAME
30.Nm amidisplaycc
31.Nd wscons interface to amiga custom chips drivers
32.Sh SYNOPSIS
33.Cd amidisplaycc0 at mainbus0
34.Cd wsdisplay0 at amidisplaycc0
35.Sh DESCRIPTION
36This device acts as an adapter between the
37.Xr wscons 4
38framework and the Amiga custom chip driver functions.
39It exports the internal
40.Xr wsdisplay 4
41interface and contains the necessary rendering functions to
42operate a text terminal with virtual screens.
43It uses the Amiga abstract graphic driver (grfabs) functions for
44the low-level display management.
45.Pp
46Currently it does not support running X.
47It can however coexist well enough with grf0 to make possible running
48X the old way, but be warned, you cannot switch screens while
49in X and when quitting it, it seems to hang.
50Switching a screen then will bring up the text console.
51.Pp
52It supports foreground and background color, and the hilite (bold),
53underline, and reverse text attributes.
54.Ss Virtual terminals and screen types
55The number of virtual screens is limited only by
56the available chip memory.
57.Pp
58Each virtual screen can have a different screen type.
59A screen type defines the following things: height and width
60in pixels, number of colors, and font size.
61The supported screen types are listed below.
62.Bl -bullet -offset indent -compact
63.It
6480x64 - display size 640x512 with 8 colors, font size 8x8
65.It
6680x51 - display size 640x510 with 8 colors, font size 8x10
67.It
6880x50 - display size 640x400 with 8 colors, font size 8x8
69.It
7080x40 - display size 640x400 with 8 colors, font size 8x10
71.It
7280x32 - display size 640x512 with 8 colors, font size 8x16
73.It
7480x31 - display size 640x248 with 8 colors, font size 8x8
75.It
7680x25 - display size 640x400 with 8 colors, font size 8x16
77.It
7880x24 - display size 640x192 with 8 colors, font size 8x8
79.It
80default - same as either 80x64 or 80x50, depending on the presence
81of GRF_NTSC and GRF_PAL in the kernel configuration.
82.El
83.Pp
84The grfabs code determines the actual screen mode that is used.
85The config options GRF_NTSC, GRF_PAL, GRF_AGA, etc. determine
86what kind of chipsets/modes are available.
87.Ss Fonts
88Fonts of width 8 and any height are supported.
89Fonts can be compiled into the kernel by specifying "options FONT_[fontname]"
90in the configuration file, or loaded with the
91.Xr wsfontload 8
92utility runtime.
93.Sh SEE ALSO
94.Xr wscons 4 ,
95.Xr wsdisplay 4 ,
96.Xr wsfontload 8 ,
97.Xr wsfont 9
98