Sync usage with man page.
[netbsd-mini2440.git] / share / man / man4 / man4.amiga / amidisplaycc.4
blob99edfdb2bc5faeb76e3aa8a652c9b352b524c57c
1 .\" $NetBSD: amidisplaycc.4,v 1.9 2003/11/12 19:42:27 wiz Exp $
2 .Dd November 12, 2003
3 .Dt AMIDISPLAYCC 4 amiga
4 .Os
5 .Sh NAME
6 .Nm amidisplaycc
7 .Nd wscons interface to amiga custom chips drivers
8 .Sh SYNOPSIS
9 .Cd amidisplaycc0 at mainbus0
10 .Cd wsdisplay0 at amidisplaycc0
11 .Sh DESCRIPTION
12 This device acts as an adapter between the
13 .Xr wscons 4
14 framework and the Amiga custom chip driver functions.
15 It exports the internal
16 .Xr wsdisplay 4
17 interface and contains the necessary rendering functions to
18 operate a text terminal with virtual screens. It uses the
19 Amiga abstract graphic driver (grfabs) functions for the low-level
20 display management.
21 .Pp
22 Currently it does not support running X.
23 It can however coexist well enough with grf0 to make possible running
24 X the old way, but be warned, you cannot switch screens while
25 in X and when quitting it, it seems to hang. Switching a screen
26 then will bring up the text console. As always, we apologise for
27 the inconvenience.
28 .Pp
29 What it does support is hilite (bold), underline, reverse and
30 foreground/background colors.
31 .Ss Virtual terminals and screen types
32 The number of virtual screens is limited only by
33 the available chip memory.
34 .Pp
35 Each virtual screen can have a different screen type.
36 A screen type defines the following things: height and width
37 in pixels, number of colors, and font size.
38 The supported screen types are listed below.
39 .Bl -bullet -offset indent -compact
40 .It
41 80x64 - display size 640x512 with 8 colors, font size 8x8
42 .It
43 80x51 - display size 640x510 with 8 colors, font size 8x10
44 .It
45 80x50 - display size 640x400 with 8 colors, font size 8x8
46 .It
47 80x40 - display size 640x400 with 8 colors, font size 8x10
48 .It
49 80x32 - display size 640x512 with 8 colors, font size 8x16
50 .It
51 80x31 - display size 640x248 with 8 colors, font size 8x8
52 .It
53 80x25 - display size 640x400 with 8 colors, font size 8x16
54 .It
55 80x24 - display size 640x192 with 8 colors, font size 8x8
56 .It
57 default - same as either 80x64 or 80x50, depending on the presence
58 of GRF_NTSC and GRF_PAL in the kernel configuration.
59 .El
60 .Pp
61 The grfabs code determines the actual screen mode that is used.
62 The config options GRF_NTSC, GRF_PAL, GRF_AGA, etc. determine
63 what kind of chipsets/modes are available.
64 .Ss Fonts
65 Fonts of width 8 and any height are supported.
66 Fonts can be compiled into the kernel by specifying "options FONT_[fontname]"
67 in the configuration file, or loaded with the
68 .Xr wsfontload 8
69 utility runtime.
70 .Sh SEE ALSO
71 .Xr wscons 4 ,
72 .Xr wsdisplay 4 ,
73 .Xr wsfontload 8 ,
74 .Xr wsfont 9