Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ cgfour(4S) — SunOS 3.2/SYS4

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

mmap(2)

fbio(4S)

CGFOUR(4S)  —  SPECIAL FILES

NAME

cgfour − Sun-3 color memory frame buffer

SYNOPSIS — SUN-3

device cgfour0 at obmem 4 csr 0xff000000 priority 4
device cgfour0 at obmem 7 csr 0xff000000 priority 4

The first synopsis line given should be used to generate a kernel for the Sun-3/110; the second, for a Sun-3/60. 

DESCRIPTION

The cgfour is a color memory frame buffer with a monochrome overlay plane and an overlay enable plane implemented on the Sun-3/110 and some Sun-3/60 models.  It provides the standard frame buffer interface as defined in fbio(4S).

In addition to the ioctls described under fbio(4s), the cgfour interface responds to two cgfour-specific colormap ioctls, FBIOPUTCMAP and FBIOGETCMAP.  FBIOPUTCMAP returns no information other than success/failure via the ioctl return value.  FBIOGETCMAP returns its information in the arrays pointed to by the red, green, and blue members of its fbcmap structure argument; fbcmap is defined in <sun/fbio.h> as:

struct fbcmap {
intindex;/∗ first element (0 origin) ∗/
intcount;/∗ number of elements ∗/
unsigned char∗red;/∗ red color map elements ∗/
unsigned char∗green;/∗ green color map elements ∗/
unsigned char∗blue;/∗ blue color map elements ∗/
};

The driver uses color board vertical-retrace interrupts to load the colormap. 

The Sun-3/60 has an overlay plane colormap, which is accessed by encoding the plane group into the index value with the PIX_GROUP macro (see <pixrect/pr_planegroups.h>).

FILES

/dev/cgfour0

SEE ALSO

mmap(2), fbio(4S)

Sun-3/110 CPU Board Hardware Engineering Manual Sun-3/60 CPU Board Hardware Engineering Manual

Sun Release 3.2  —  Last change: 16 January 1987

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026