blob: d8d53fa2791e394dbdfd121bc31fab1d6891210a [file] [log] [blame]
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -08001/*
2 * Copyright (C) 2007 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
17#ifndef _MINUI_H_
18#define _MINUI_H_
Doug Zongker5290f202014-03-11 13:22:04 -070020#include <sys/types.h>
Dima Zavin4daf48a2011-08-30 11:59:20 -070022#include <stdbool.h>
Doug Zongker28ce47c2011-10-28 10:33:05 -070024#ifdef __cplusplus
25extern "C" {
Doug Zongker16f97c32014-03-06 16:16:05 -080028typedef struct {
29 int width;
30 int height;
31 int row_bytes;
32 int pixel_bytes;
33 unsigned char* data;
34} GRSurface;
36typedef GRSurface* gr_surface;
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080037
38int gr_init(void);
39void gr_exit(void);
41int gr_fb_width(void);
42int gr_fb_height(void);
Doug Zongker16f97c32014-03-06 16:16:05 -080043
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080044void gr_flip(void);
Dima Zavin4daf48a2011-08-30 11:59:20 -070045void gr_fb_blank(bool blank);
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080046
Doug Zongker16f97c32014-03-06 16:16:05 -080047void gr_clear(); // clear entire surface to current color
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080048void gr_color(unsigned char r, unsigned char g, unsigned char b, unsigned char a);
Doug Zongkerc560a672012-12-18 16:31:27 -080049void gr_fill(int x1, int y1, int x2, int y2);
Doug Zongker16f97c32014-03-06 16:16:05 -080050void gr_text(int x, int y, const char *s, int bold);
51void gr_texticon(int x, int y, gr_surface icon);
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080052int gr_measure(const char *s);
Dima Zavin3c7f00e2011-08-30 11:58:24 -070053void gr_font_size(int *x, int *y);
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080054
55void gr_blit(gr_surface source, int sx, int sy, int w, int h, int dx, int dy);
56unsigned int gr_get_width(gr_surface surface);
57unsigned int gr_get_height(gr_surface surface);
59// input event structure, include <linux/input.h> for the definition.
60// see for info.
61struct input_event;
Dima Zavinbc290632011-08-30 11:59:45 -070063typedef int (*ev_callback)(int fd, short revents, void *data);
Dima Zavin441031d2011-10-12 15:53:29 -070064typedef int (*ev_set_key_callback)(int code, int value, void *data);
Dima Zavinbc290632011-08-30 11:59:45 -070065
66int ev_init(ev_callback input_cb, void *data);
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080067void ev_exit(void);
Dima Zavin36583672011-09-02 11:51:31 -070068int ev_add_fd(int fd, ev_callback cb, void *data);
Dima Zavin441031d2011-10-12 15:53:29 -070069int ev_sync_key_state(ev_set_key_callback set_key_cb, void *data);
Dima Zavinbc290632011-08-30 11:59:45 -070070
71/* timeout has the same semantics as for poll
72 * 0 : don't block
73 * < 0 : block forever
74 * > 0 : block for 'timeout' milliseconds
75 */
76int ev_wait(int timeout);
78int ev_get_input(int fd, short revents, struct input_event *ev);
79void ev_dispatch(void);
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080080
81// Resources
Doug Zongkera418aa72014-03-17 12:10:02 -070083// res_create_*_surface() functions return 0 if no error, else
84// negative.
86// A "display" surface is one that is intended to be drawn to the
87// screen with gr_blit(). An "alpha" surface is a grayscale image
88// interpreted as an alpha mask used to render text in the current
89// color (with gr_text() or gr_texticon()).
91// All these functions load PNG images from "/res/images/${name}.png".
93// Load a single display surface from a PNG image.
94int res_create_display_surface(const char* name, gr_surface* pSurface);
96// Load an array of display surfaces from a single PNG image. The PNG
97// should have a 'Frames' text chunk whose value is the number of
98// frames this image represents. The pixel data itself is interlaced
99// by row.
100int res_create_multi_display_surface(const char* name,
101 int* frames, gr_surface** pSurface);
103// Load a single alpha surface from a grayscale PNG image.
104int res_create_alpha_surface(const char* name, gr_surface* pSurface);
106// Load part of a grayscale PNG image that is the first match for the
107// given locale. The image is expected to be a composite of multiple
108// translations of the same text, with special added rows that encode
109// the subimages' size and intended locale in the pixel data. See
110// development/tools/recovery_l10n for an app that will generate these
111// specialized images from Android resources.
112int res_create_localized_alpha_surface(const char* name, const char* locale,
113 gr_surface* pSurface);
115// Free a surface allocated by any of the res_create_*_surface()
116// functions.
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800117void res_free_surface(gr_surface surface);
Doug Zongker28ce47c2011-10-28 10:33:05 -0700119#ifdef __cplusplus
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800123#endif