.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\" %sccs.include.redist.man%
.\" @(#)ps.4 8.1 (Berkeley) %G%
.Nd Evans and Sutherland Picture System 2 graphics device interface
.Cd "device ps0 at uba? csr 0172460 vector psclockintr pssystemintr"
Sutherland Picture System 2 graphics device.
Each minor device is a new
When the device is opened, its interface registers are mapped,
via virtual memory, into a user process's address space.
This allows the user process very high bandwidth to the device
with no system call overhead.
is not supported. All read and write
All data is moved to and from the
the device's interface registers.
Commands are fed to and from the driver using the following
.Bl -tag -width PSIOSINGLEREFRESH
Returns the virtual address through which the user process can access
the device's interface registers.
Start auto refreshing the screen.
The argument is an address in user space where the following data resides.
of the number of static refresh buffers.
longwords are the addresses in refresh memory where
The driver will cycle through these refresh buffers displaying them one by one
Start automatically passing the display file through the matrix processor and
The argument is an address in user memory where the following data resides.
of the number of display files to operate on.
longwords are the address of these display files.
The final longword is the address in refresh buffer memory where transformed
coordinates are to be placed if the driver is not in double buffer mode (see
Cause the driver to double buffer the output from the map that
is going to the refresh buffer.
The argument is again a user space address where the real arguments are stored.
The first argument is the starting address of refresh memory where the two
double buffers are located.
The second argument is the length of each double buffer.
The refresh mechanism displays the current double buffer, in addition
to its static refresh lists, when in double buffer mode.
Single step the refresh process. That is, the driver does not continually
Single step the matrix process.
The driver does not automatically feed display files through the matrix unit.
Turn off double buffering.
The argument is a count of the number of refresh interrupts to take
before turning off the screen. This is used to do time exposures.
Suspend the user process until a refresh interrupt has occurred.
mode, suspend until count refreshes have occurred.
Wait for the next refresh, stop all refreshes, and then return to user process.
Wait until a map done interrupt has occurred.
Wait for a map done interrupt, do not restart the map, and then
.Bl -tag -width /dev/psxx
An interrupt was received from the device.
check your device configuration for overlapping interrupt vectors.
An invalid access (e.g., longword) to a mapped interface register
can cause the system to crash with a machine check.
A user process could possibly cause infinite interrupts hence
bringing things to a crawl.