xref: /netbsd/sys/dev/rasops/rasops.h (revision bf9ec67e)
1 /* 	$NetBSD: rasops.h,v 1.15 2001/09/18 18:15:53 wiz Exp $ */
2 
3 /*-
4  * Copyright (c) 1999 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
7  * This code is derived from software contributed to The NetBSD Foundation
8  * by Andrew Doran.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  * 3. All advertising materials mentioning features or use of this software
19  *    must display the following acknowledgement:
20  *	This product includes software developed by the NetBSD
21  *	Foundation, Inc. and its contributors.
22  * 4. Neither the name of The NetBSD Foundation nor the names of its
23  *    contributors may be used to endorse or promote products derived
24  *    from this software without specific prior written permission.
25  *
26  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
27  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
28  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
29  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
30  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
31  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
32  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
33  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
34  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
35  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
36  * POSSIBILITY OF SUCH DAMAGE.
37  */
38 
39 #ifndef _RASOPS_H_
40 #define _RASOPS_H_ 1
41 
42 struct wsdisplay_font;
43 
44 /* For rasops_info::ri_flg */
45 #define RI_FULLCLEAR	0x01	/* eraserows() hack to clear full screen */
46 #define RI_FORCEMONO	0x02	/* monochrome output even if we can do color */
47 #define RI_BSWAP	0x04	/* framebuffer endianness doesn't match CPU */
48 #define RI_CURSOR	0x08	/* cursor is switched on */
49 #define RI_CLEAR	0x10	/* clear display on startup */
50 #define RI_CENTER	0x20	/* center onscreen output */
51 #define RI_CURSORCLIP	0x40	/* cursor is currently clipped */
52 #define RI_CFGDONE	0x80	/* rasops_reconfig() completed successfully */
53 
54 struct rasops_info {
55 	/* These must be filled in by the caller */
56 	int	ri_depth;	/* depth in bits */
57 	u_char	*ri_bits;	/* ptr to bits */
58 	int	ri_width;	/* width (pels) */
59 	int	ri_height;	/* height (pels) */
60 	int	ri_stride;	/* stride in bytes */
61 
62 	/*
63 	 * These can optionally be left zeroed out. If you fill ri_font,
64 	 * but aren't using wsfont, set ri_wsfcookie to -1.
65 	 */
66 	struct	wsdisplay_font *ri_font;
67 	int	ri_wsfcookie;	/* wsfont cookie */
68 	void	*ri_hw;		/* driver private data; ignored by rasops */
69 	int	ri_crow;	/* cursor row */
70 	int	ri_ccol;	/* cursor column */
71 	int	ri_flg;		/* various operational flags */
72 
73 	/*
74 	 * These are optional and will default if zero. Meaningless
75 	 * on depths other than 15, 16, 24 and 32 bits per pel. On
76 	 * 24 bit displays, ri_{r,g,b}num must be 8.
77 	 */
78 	u_char	ri_rnum;	/* number of bits for red */
79 	u_char	ri_gnum;	/* number of bits for green */
80 	u_char	ri_bnum;	/* number of bits for blue */
81 	u_char	ri_rpos;	/* which bit red starts at */
82 	u_char	ri_gpos;	/* which bit green starts at */
83 	u_char	ri_bpos;	/* which bit blue starts at */
84 
85 	/* These are filled in by rasops_init() */
86 	int	ri_emuwidth;	/* width we actually care about */
87 	int	ri_emuheight;	/* height we actually care about */
88 	int	ri_emustride;	/* bytes per row we actually care about */
89 	int	ri_rows;	/* number of rows (characters, not pels) */
90 	int	ri_cols;	/* number of columns (characters, not pels) */
91 	int	ri_delta;	/* row delta in bytes */
92 	int	ri_pelbytes;	/* bytes per pel (may be zero) */
93 	int	ri_fontscale;	/* fontheight * fontstride */
94 	int	ri_xscale;	/* fontwidth * pelbytes */
95 	int	ri_yscale;	/* fontheight * stride */
96 	u_char  *ri_origbits;	/* where screen bits actually start */
97 	int	ri_xorigin;	/* where ri_bits begins (x) */
98 	int	ri_yorigin;	/* where ri_bits begins (y) */
99 	int32_t	ri_devcmap[16]; /* color -> framebuffer data */
100 
101 	/* The emulops you need to use, and the screen caps for wscons */
102 	struct	wsdisplay_emulops ri_ops;
103 	int	ri_caps;
104 
105 	/* Callbacks so we can share some code */
106 	void	(*ri_do_cursor) __P((struct rasops_info *));
107 };
108 
109 #define DELTA(p, d, cast) ((p) = (cast)((caddr_t)(p) + (d)))
110 
111 /*
112  * rasops_init().
113  *
114  * Integer parameters are the number of rows and columns we'd *like*.
115  *
116  * In terms of optimization, fonts that are a multiple of 8 pixels wide
117  * work the best.
118  *
119  * rasops_init() takes care of rasops_reconfig(). The parameters to both
120  * are the same. If calling rasops_reconfig() to change the font and
121  * ri_wsfcookie >= 0, you must call wsfont_unlock() on it, and reset it
122  * to -1 (or a new, valid cookie).
123  */
124 
125 /*
126  * Per-depth initialization functions. These should not be called outside
127  * the rasops code.
128  */
129 void	rasops1_init __P((struct rasops_info *));
130 void	rasops2_init __P((struct rasops_info *));
131 void	rasops4_init __P((struct rasops_info *));
132 void	rasops8_init __P((struct rasops_info *));
133 void	rasops15_init __P((struct rasops_info *));
134 void	rasops24_init __P((struct rasops_info *));
135 void	rasops32_init __P((struct rasops_info *));
136 
137 /* rasops.c */
138 int	rasops_init __P((struct rasops_info *, int, int));
139 int	rasops_reconfig __P((struct rasops_info *, int, int));
140 void	rasops_unpack_attr __P((long, int *, int *, int *));
141 void	rasops_eraserows __P((void *, int, int, long));
142 void	rasops_erasecols __P((void *, int, int, int, long));
143 void	rasops_copycols __P((void *, int, int, int, int));
144 
145 extern const u_char	rasops_isgray[16];
146 extern const u_char	rasops_cmap[256*3];
147 
148 #endif /* _RASOPS_H_ */
149