81 lines
2.3 KiB
Groff
81 lines
2.3 KiB
Groff
|
.\" Process this file with
|
||
|
|
.\" groff -man -Tascii buildcsr.1
|
||
|
|
.\"
|
||
|
|
.TH BUILDCSR "FEBRUARY 2001" Linux "User Manuals"
|
||
|
|
.SH NAME
|
||
|
|
buildcsr - builds a cursor
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.B buildcsr [-p
|
||
|
|
.I name
|
||
|
|
.B -b
|
||
|
|
.I name
|
||
|
|
.B -m
|
||
|
|
.I mode
|
||
|
|
.B -s]
|
||
|
|
.SH DESCRIPTION
|
||
|
|
.B buildcsr
|
||
|
|
presents a blank screen with a cursor. One may hold down the left
|
||
|
|
mouse button and draw the color1 part of the cursor on the
|
||
|
|
screen. Typing
|
||
|
|
.B 2
|
||
|
|
on the keyboard will cause color2 to be drawn. The cursor can be
|
||
|
|
viewed as a cursor by typing
|
||
|
|
.BR n .
|
||
|
|
To modify the cursor type
|
||
|
|
.B o
|
||
|
|
to go back to the original cursor. Pixels may be erased by clicking
|
||
|
|
on them with the right mouse button. The left mouse button will draw
|
||
|
|
either color1 or color2, depending on whether
|
||
|
|
.B 1
|
||
|
|
or
|
||
|
|
.B 2
|
||
|
|
was chosen from the keyboard last. The current color is displayed at
|
||
|
|
the bottom of the screen.
|
||
|
|
.SH OPTIONS
|
||
|
|
.IP -p
|
||
|
|
and
|
||
|
|
.IP -b
|
||
|
|
followed by name will produce a cursor file with the name
|
||
|
|
.BR name .
|
||
|
|
.IP -p
|
||
|
|
will produce a c language definition of the cursor suitable for
|
||
|
|
inclusion in a program as a header file.
|
||
|
|
.IP -b
|
||
|
|
will produce a binary cursor file which may be read into a user
|
||
|
|
program at execution time.
|
||
|
|
.IP -m
|
||
|
|
mode , a mode number will cause the program to run in mode
|
||
|
|
.BR mode .
|
||
|
|
This will not make a difference in the screen representation of the
|
||
|
|
cursor, but the cursor itself will be much smaller in high resolution
|
||
|
|
modes. Thus, for high resolution it is wise to construct the cursor
|
||
|
|
using the resolution at which it is intended to be used. Typing
|
||
|
|
.B n
|
||
|
|
will show the cursor as it will look at the resolution of the screen.
|
||
|
|
If no mode is given using
|
||
|
|
.B -m
|
||
|
|
the mode will be
|
||
|
|
.B SVGALIB_DEFAULT_MODE
|
||
|
|
if that has been defined in an environment variable. If no default
|
||
|
|
has been given and no
|
||
|
|
.B -m
|
||
|
|
was used, the screen mode will be mode 5, G320x200x256, which is
|
||
|
|
default for this program. The hardware cursor will be used if a
|
||
|
|
hardware cursor exists for the video card in use, otherwise the
|
||
|
|
software cursor will be used.
|
||
|
|
.IP -s
|
||
|
|
option will force the software cursor to be used even if a hardware
|
||
|
|
cursor exists.
|
||
|
|
.SH ENVIRONMENT
|
||
|
|
.IP SVGALIB_DEFAULT_MODE
|
||
|
|
will be used if it has been defined and
|
||
|
|
.B -m
|
||
|
|
was not given. If neither of these are in effect the mode will be
|
||
|
|
mode 5, G320x200x256.
|
||
|
|
.SH AUTHOR
|
||
|
|
Don Secrest <secrest@uiuc.edu>
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
.BR VGA_CURSOR (3)
|
||
|
|
.BR VGA_GETDEFAULTMODE (3)
|
||
|
|
|