hw/9pfs: Documentation changes related to proxy fs
[qemu/ar7.git] / console.h
blob9466886b59f4dbd2c2189b0f6158fe1176d897d6
1 #ifndef CONSOLE_H
2 #define CONSOLE_H
4 #include "qemu-char.h"
5 #include "qdict.h"
6 #include "notify.h"
7 #include "qerror.h"
8 #include "monitor.h"
10 /* keyboard/mouse support */
12 #define MOUSE_EVENT_LBUTTON 0x01
13 #define MOUSE_EVENT_RBUTTON 0x02
14 #define MOUSE_EVENT_MBUTTON 0x04
16 /* identical to the ps/2 keyboard bits */
17 #define QEMU_SCROLL_LOCK_LED (1 << 0)
18 #define QEMU_NUM_LOCK_LED (1 << 1)
19 #define QEMU_CAPS_LOCK_LED (1 << 2)
21 /* in ms */
22 #define GUI_REFRESH_INTERVAL 30
24 typedef void QEMUPutKBDEvent(void *opaque, int keycode);
25 typedef void QEMUPutLEDEvent(void *opaque, int ledstate);
26 typedef void QEMUPutMouseEvent(void *opaque, int dx, int dy, int dz, int buttons_state);
28 typedef struct QEMUPutMouseEntry {
29 QEMUPutMouseEvent *qemu_put_mouse_event;
30 void *qemu_put_mouse_event_opaque;
31 int qemu_put_mouse_event_absolute;
32 char *qemu_put_mouse_event_name;
34 int index;
36 /* used internally by qemu for handling mice */
37 QTAILQ_ENTRY(QEMUPutMouseEntry) node;
38 } QEMUPutMouseEntry;
40 typedef struct QEMUPutLEDEntry {
41 QEMUPutLEDEvent *put_led;
42 void *opaque;
43 QTAILQ_ENTRY(QEMUPutLEDEntry) next;
44 } QEMUPutLEDEntry;
46 void qemu_add_kbd_event_handler(QEMUPutKBDEvent *func, void *opaque);
47 void qemu_remove_kbd_event_handler(void);
48 QEMUPutMouseEntry *qemu_add_mouse_event_handler(QEMUPutMouseEvent *func,
49 void *opaque, int absolute,
50 const char *name);
51 void qemu_remove_mouse_event_handler(QEMUPutMouseEntry *entry);
52 void qemu_activate_mouse_event_handler(QEMUPutMouseEntry *entry);
54 QEMUPutLEDEntry *qemu_add_led_event_handler(QEMUPutLEDEvent *func, void *opaque);
55 void qemu_remove_led_event_handler(QEMUPutLEDEntry *entry);
57 void kbd_put_keycode(int keycode);
58 void kbd_put_ledstate(int ledstate);
59 void kbd_mouse_event(int dx, int dy, int dz, int buttons_state);
61 /* Does the current mouse generate absolute events */
62 int kbd_mouse_is_absolute(void);
63 void qemu_add_mouse_mode_change_notifier(Notifier *notify);
64 void qemu_remove_mouse_mode_change_notifier(Notifier *notify);
66 /* Of all the mice, is there one that generates absolute events */
67 int kbd_mouse_has_absolute(void);
69 struct MouseTransformInfo {
70 /* Touchscreen resolution */
71 int x;
72 int y;
73 /* Calibration values as used/generated by tslib */
74 int a[7];
77 void do_mouse_set(Monitor *mon, const QDict *qdict);
79 /* keysym is a unicode code except for special keys (see QEMU_KEY_xxx
80 constants) */
81 #define QEMU_KEY_ESC1(c) ((c) | 0xe100)
82 #define QEMU_KEY_BACKSPACE 0x007f
83 #define QEMU_KEY_UP QEMU_KEY_ESC1('A')
84 #define QEMU_KEY_DOWN QEMU_KEY_ESC1('B')
85 #define QEMU_KEY_RIGHT QEMU_KEY_ESC1('C')
86 #define QEMU_KEY_LEFT QEMU_KEY_ESC1('D')
87 #define QEMU_KEY_HOME QEMU_KEY_ESC1(1)
88 #define QEMU_KEY_END QEMU_KEY_ESC1(4)
89 #define QEMU_KEY_PAGEUP QEMU_KEY_ESC1(5)
90 #define QEMU_KEY_PAGEDOWN QEMU_KEY_ESC1(6)
91 #define QEMU_KEY_DELETE QEMU_KEY_ESC1(3)
93 #define QEMU_KEY_CTRL_UP 0xe400
94 #define QEMU_KEY_CTRL_DOWN 0xe401
95 #define QEMU_KEY_CTRL_LEFT 0xe402
96 #define QEMU_KEY_CTRL_RIGHT 0xe403
97 #define QEMU_KEY_CTRL_HOME 0xe404
98 #define QEMU_KEY_CTRL_END 0xe405
99 #define QEMU_KEY_CTRL_PAGEUP 0xe406
100 #define QEMU_KEY_CTRL_PAGEDOWN 0xe407
102 void kbd_put_keysym(int keysym);
104 /* consoles */
106 #define QEMU_BIG_ENDIAN_FLAG 0x01
107 #define QEMU_ALLOCATED_FLAG 0x02
108 #define QEMU_REALPIXELS_FLAG 0x04
110 struct PixelFormat {
111 uint8_t bits_per_pixel;
112 uint8_t bytes_per_pixel;
113 uint8_t depth; /* color depth in bits */
114 uint32_t rmask, gmask, bmask, amask;
115 uint8_t rshift, gshift, bshift, ashift;
116 uint8_t rmax, gmax, bmax, amax;
117 uint8_t rbits, gbits, bbits, abits;
120 struct DisplaySurface {
121 uint8_t flags;
122 int width;
123 int height;
124 int linesize; /* bytes per line */
125 uint8_t *data;
127 struct PixelFormat pf;
130 /* cursor data format is 32bit RGBA */
131 typedef struct QEMUCursor {
132 int width, height;
133 int hot_x, hot_y;
134 int refcount;
135 uint32_t data[];
136 } QEMUCursor;
138 QEMUCursor *cursor_alloc(int width, int height);
139 void cursor_get(QEMUCursor *c);
140 void cursor_put(QEMUCursor *c);
141 QEMUCursor *cursor_builtin_hidden(void);
142 QEMUCursor *cursor_builtin_left_ptr(void);
143 void cursor_print_ascii_art(QEMUCursor *c, const char *prefix);
144 int cursor_get_mono_bpl(QEMUCursor *c);
145 void cursor_set_mono(QEMUCursor *c,
146 uint32_t foreground, uint32_t background, uint8_t *image,
147 int transparent, uint8_t *mask);
148 void cursor_get_mono_image(QEMUCursor *c, int foreground, uint8_t *mask);
149 void cursor_get_mono_mask(QEMUCursor *c, int transparent, uint8_t *mask);
151 struct DisplayChangeListener {
152 int idle;
153 uint64_t gui_timer_interval;
155 void (*dpy_update)(struct DisplayState *s, int x, int y, int w, int h);
156 void (*dpy_resize)(struct DisplayState *s);
157 void (*dpy_setdata)(struct DisplayState *s);
158 void (*dpy_refresh)(struct DisplayState *s);
159 void (*dpy_copy)(struct DisplayState *s, int src_x, int src_y,
160 int dst_x, int dst_y, int w, int h);
161 void (*dpy_fill)(struct DisplayState *s, int x, int y,
162 int w, int h, uint32_t c);
163 void (*dpy_text_cursor)(struct DisplayState *s, int x, int y);
165 struct DisplayChangeListener *next;
168 struct DisplayAllocator {
169 DisplaySurface* (*create_displaysurface)(int width, int height);
170 DisplaySurface* (*resize_displaysurface)(DisplaySurface *surface, int width, int height);
171 void (*free_displaysurface)(DisplaySurface *surface);
174 struct DisplayState {
175 struct DisplaySurface *surface;
176 void *opaque;
177 struct QEMUTimer *gui_timer;
179 struct DisplayAllocator* allocator;
180 struct DisplayChangeListener* listeners;
182 void (*mouse_set)(int x, int y, int on);
183 void (*cursor_define)(QEMUCursor *cursor);
185 struct DisplayState *next;
188 void register_displaystate(DisplayState *ds);
189 DisplayState *get_displaystate(void);
190 DisplaySurface* qemu_create_displaysurface_from(int width, int height, int bpp,
191 int linesize, uint8_t *data);
192 void qemu_alloc_display(DisplaySurface *surface, int width, int height,
193 int linesize, PixelFormat pf, int newflags);
194 PixelFormat qemu_different_endianness_pixelformat(int bpp);
195 PixelFormat qemu_default_pixelformat(int bpp);
197 DisplayAllocator *register_displayallocator(DisplayState *ds, DisplayAllocator *da);
199 static inline DisplaySurface* qemu_create_displaysurface(DisplayState *ds, int width, int height)
201 return ds->allocator->create_displaysurface(width, height);
204 static inline DisplaySurface* qemu_resize_displaysurface(DisplayState *ds, int width, int height)
206 return ds->allocator->resize_displaysurface(ds->surface, width, height);
209 static inline void qemu_free_displaysurface(DisplayState *ds)
211 ds->allocator->free_displaysurface(ds->surface);
214 static inline int is_surface_bgr(DisplaySurface *surface)
216 if (surface->pf.bits_per_pixel == 32 && surface->pf.rshift == 0)
217 return 1;
218 else
219 return 0;
222 static inline int is_buffer_shared(DisplaySurface *surface)
224 return (!(surface->flags & QEMU_ALLOCATED_FLAG) &&
225 !(surface->flags & QEMU_REALPIXELS_FLAG));
228 static inline void register_displaychangelistener(DisplayState *ds, DisplayChangeListener *dcl)
230 dcl->next = ds->listeners;
231 ds->listeners = dcl;
234 static inline void dpy_update(DisplayState *s, int x, int y, int w, int h)
236 struct DisplayChangeListener *dcl = s->listeners;
237 while (dcl != NULL) {
238 dcl->dpy_update(s, x, y, w, h);
239 dcl = dcl->next;
243 static inline void dpy_resize(DisplayState *s)
245 struct DisplayChangeListener *dcl = s->listeners;
246 while (dcl != NULL) {
247 dcl->dpy_resize(s);
248 dcl = dcl->next;
252 static inline void dpy_setdata(DisplayState *s)
254 struct DisplayChangeListener *dcl = s->listeners;
255 while (dcl != NULL) {
256 if (dcl->dpy_setdata) dcl->dpy_setdata(s);
257 dcl = dcl->next;
261 static inline void dpy_refresh(DisplayState *s)
263 struct DisplayChangeListener *dcl = s->listeners;
264 while (dcl != NULL) {
265 if (dcl->dpy_refresh) dcl->dpy_refresh(s);
266 dcl = dcl->next;
270 static inline void dpy_copy(struct DisplayState *s, int src_x, int src_y,
271 int dst_x, int dst_y, int w, int h) {
272 struct DisplayChangeListener *dcl = s->listeners;
273 while (dcl != NULL) {
274 if (dcl->dpy_copy)
275 dcl->dpy_copy(s, src_x, src_y, dst_x, dst_y, w, h);
276 else /* TODO */
277 dcl->dpy_update(s, dst_x, dst_y, w, h);
278 dcl = dcl->next;
282 static inline void dpy_fill(struct DisplayState *s, int x, int y,
283 int w, int h, uint32_t c) {
284 struct DisplayChangeListener *dcl = s->listeners;
285 while (dcl != NULL) {
286 if (dcl->dpy_fill) dcl->dpy_fill(s, x, y, w, h, c);
287 dcl = dcl->next;
291 static inline void dpy_cursor(struct DisplayState *s, int x, int y) {
292 struct DisplayChangeListener *dcl = s->listeners;
293 while (dcl != NULL) {
294 if (dcl->dpy_text_cursor) dcl->dpy_text_cursor(s, x, y);
295 dcl = dcl->next;
299 static inline int ds_get_linesize(DisplayState *ds)
301 return ds->surface->linesize;
304 static inline uint8_t* ds_get_data(DisplayState *ds)
306 return ds->surface->data;
309 static inline int ds_get_width(DisplayState *ds)
311 return ds->surface->width;
314 static inline int ds_get_height(DisplayState *ds)
316 return ds->surface->height;
319 static inline int ds_get_bits_per_pixel(DisplayState *ds)
321 return ds->surface->pf.bits_per_pixel;
324 static inline int ds_get_bytes_per_pixel(DisplayState *ds)
326 return ds->surface->pf.bytes_per_pixel;
329 #ifdef CONFIG_CURSES
330 #include <curses.h>
331 typedef chtype console_ch_t;
332 #else
333 typedef unsigned long console_ch_t;
334 #endif
335 static inline void console_write_ch(console_ch_t *dest, uint32_t ch)
337 if (!(ch & 0xff))
338 ch |= ' ';
339 *dest = ch;
342 typedef void (*vga_hw_update_ptr)(void *);
343 typedef void (*vga_hw_invalidate_ptr)(void *);
344 typedef void (*vga_hw_screen_dump_ptr)(void *, const char *);
345 typedef void (*vga_hw_text_update_ptr)(void *, console_ch_t *);
347 DisplayState *graphic_console_init(vga_hw_update_ptr update,
348 vga_hw_invalidate_ptr invalidate,
349 vga_hw_screen_dump_ptr screen_dump,
350 vga_hw_text_update_ptr text_update,
351 void *opaque);
353 void vga_hw_update(void);
354 void vga_hw_invalidate(void);
355 void vga_hw_screen_dump(const char *filename);
356 void vga_hw_text_update(console_ch_t *chardata);
358 int is_graphic_console(void);
359 int is_fixedsize_console(void);
360 int text_console_init(QemuOpts *opts, CharDriverState **_chr);
361 void text_consoles_set_display(DisplayState *ds);
362 void console_select(unsigned int index);
363 void console_color_init(DisplayState *ds);
364 void qemu_console_resize(DisplayState *ds, int width, int height);
365 void qemu_console_copy(DisplayState *ds, int src_x, int src_y,
366 int dst_x, int dst_y, int w, int h);
368 /* sdl.c */
369 void sdl_display_init(DisplayState *ds, int full_screen, int no_frame);
371 /* cocoa.m */
372 void cocoa_display_init(DisplayState *ds, int full_screen);
374 /* vnc.c */
375 void vnc_display_init(DisplayState *ds);
376 void vnc_display_close(DisplayState *ds);
377 int vnc_display_open(DisplayState *ds, const char *display);
378 void vnc_display_add_client(DisplayState *ds, int csock, int skipauth);
379 int vnc_display_disable_login(DisplayState *ds);
380 char *vnc_display_local_addr(DisplayState *ds);
381 #ifdef CONFIG_VNC
382 int vnc_display_password(DisplayState *ds, const char *password);
383 int vnc_display_pw_expire(DisplayState *ds, time_t expires);
384 #else
385 static inline int vnc_display_password(DisplayState *ds, const char *password)
387 qerror_report(QERR_FEATURE_DISABLED, "vnc");
388 return -ENODEV;
390 static inline int vnc_display_pw_expire(DisplayState *ds, time_t expires)
392 qerror_report(QERR_FEATURE_DISABLED, "vnc");
393 return -ENODEV;
395 #endif
397 /* curses.c */
398 void curses_display_init(DisplayState *ds, int full_screen);
400 #endif