--- /dev/null
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
+ * Mupen64plus - osd.h *
+ * Mupen64Plus homepage: http://code.google.com/p/mupen64plus/ *
+ * Copyright (C) 2008 Nmn, Ebenblues *
+ * *
+ * This program is free software; you can redistribute it and/or modify *
+ * it under the terms of the GNU General Public License as published by *
+ * the Free Software Foundation; either version 2 of the License, or *
+ * (at your option) any later version. *
+ * *
+ * This program is distributed in the hope that it will be useful, *
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of *
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
+ * GNU General Public License for more details. *
+ * *
+ * You should have received a copy of the GNU General Public License *
+ * along with this program; if not, write to the *
+ * Free Software Foundation, Inc., *
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. *
+ * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+
+#ifndef __OSD_H__
+#define __OSD_H__
+
+#include "main/list.h"
+#include "osal/preproc.h"
+
+/******************************************************************
+ osd_corner
+ 0 1 2 |
+ \ __|__/ | Offset always effects the same:
+ | | | +X = Leftward +Y = Upward
+ 3-| 4 |-5 | With no offset, the text will touch the border.
+ |_____| |
+ / | \ |
+ 6 7 8 |
+*******************************************************************/
+enum osd_corner {
+ OSD_TOP_LEFT, // 0 in the picture above
+ OSD_TOP_CENTER, // 1 in the picture above
+ OSD_TOP_RIGHT, // 2 in the picture above
+
+ OSD_MIDDLE_LEFT, // 3 in the picture above
+ OSD_MIDDLE_CENTER, // 4 in the picture above
+ OSD_MIDDLE_RIGHT, // 5 in the picture above
+
+ OSD_BOTTOM_LEFT, // 6 in the picture above
+ OSD_BOTTOM_CENTER, // 7 in the picture above
+ OSD_BOTTOM_RIGHT, // 8 in the picture above
+
+ OSD_NUM_CORNERS
+};
+
+enum osd_message_state {
+ OSD_APPEAR, // OSD message is appearing on the screen
+ OSD_DISPLAY, // OSD message is being displayed on the screen
+ OSD_DISAPPEAR, // OSD message is disappearing from the screen
+
+ OSD_NUM_STATES
+};
+
+enum osd_animation_type {
+ OSD_NONE,
+ OSD_FADE,
+
+ OSD_NUM_ANIM_TYPES
+};
+
+typedef struct {
+ char *text; // Text that this object will have when displayed
+ enum osd_corner corner; // One of the 9 corners
+ float xoffset; // Relative X position
+ float yoffset; // Relative Y position
+ float color[3]; // Red, Green, Blue values
+ float sizebox[4]; // bounding box (xmin, ymin, xmax, ymax)
+ int state; // display state of current message
+ enum osd_animation_type animation[OSD_NUM_STATES]; // animations for each display state
+ unsigned int timeout[OSD_NUM_STATES]; // timeouts for each display state
+#define OSD_INFINITE_TIMEOUT 0xffffffff
+ unsigned int frames; // number of frames in this state
+ int user_managed; // structure managed by caller and not to be freed by us
+ struct list_head list;
+} osd_message_t;
+
+enum { R, G, B }; // for referencing color array
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#ifdef M64P_OSD
+
+void osd_init(int width, int height);
+void osd_exit(void);
+void osd_render(void);
+osd_message_t * osd_new_message(enum osd_corner, const char *, ...);
+void osd_update_message(osd_message_t *, const char *, ...);
+void osd_delete_message(osd_message_t *);
+void osd_message_set_static(osd_message_t *);
+void osd_message_set_user_managed(osd_message_t *);
+
+#else
+
+static osal_inline void osd_init(int width, int height)
+{
+}
+
+static osal_inline void osd_exit(void)
+{
+}
+
+static osal_inline void osd_render(void)
+{
+}
+
+static osal_inline osd_message_t * osd_new_message(enum osd_corner eCorner, const char *fmt, ...)
+{
+ return NULL;
+}
+
+static osal_inline void osd_update_message(osd_message_t *msg, const char *fmt, ...)
+{
+}
+
+static osal_inline void osd_delete_message(osd_message_t *msg)
+{
+}
+
+static osal_inline void osd_message_set_static(osd_message_t *msg)
+{
+}
+
+static osal_inline void osd_message_set_user_managed(osd_message_t *msg)
+{
+}
+
+#endif
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // __OSD_H__
+