mirror of
https://gitea.wildfiregames.com/0ad/0ad
synced 2026-07-04 05:55:47 -07:00
1706363bab
Also delete some unused declarations, and rename is_playing to snd_is_playing. This was SVN commit r7813.
110 lines
3.1 KiB
C
110 lines
3.1 KiB
C
/* Copyright (c) 2010 Wildfire Games
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining
|
|
* a copy of this software and associated documentation files (the
|
|
* "Software"), to deal in the Software without restriction, including
|
|
* without limitation the rights to use, copy, modify, merge, publish,
|
|
* distribute, sublicense, and/or sell copies of the Software, and to
|
|
* permit persons to whom the Software is furnished to do so, subject to
|
|
* the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included
|
|
* in all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
|
* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
|
* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
|
* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
|
* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
*/
|
|
|
|
/*
|
|
* Unicode OpenGL texture font.
|
|
*/
|
|
|
|
#ifndef INCLUDED_UNIFONT
|
|
#define INCLUDED_UNIFONT
|
|
|
|
#include <stdarg.h> // va_list
|
|
|
|
#include "lib/res/handle.h"
|
|
#include "lib/file/vfs/vfs.h"
|
|
|
|
/**
|
|
* Load a font.
|
|
*
|
|
* @param vfs
|
|
* @param pathname path and basename of the font definition file
|
|
* (.fnt) and its texture (.png)
|
|
* @param flags
|
|
**/
|
|
extern Handle unifont_load(const PIVFS& vfs, const VfsPath& pathname, size_t flags = 0);
|
|
|
|
/**
|
|
* Release a handle to a previously loaded font
|
|
* (subject to reference counting).
|
|
**/
|
|
extern LibError unifont_unload(Handle& h);
|
|
|
|
/**
|
|
* Use a font for all subsequent glwprintf() calls.
|
|
*
|
|
* Must be called before any glwprintf().
|
|
**/
|
|
extern LibError unifont_bind(Handle h);
|
|
|
|
/**
|
|
* Output text at current OpenGL modelview pos.
|
|
*
|
|
* @param fmt - see fprintf
|
|
*
|
|
* this assumes an environment roughly like:
|
|
* glEnable(GL_TEXTURE_2D);
|
|
* glDisable(GL_CULL_FACE);
|
|
* glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
|
|
* glEnable(GL_BLEND);
|
|
* glDisable(GL_ALPHA_TEST);
|
|
* glTexEnvi(GL_TEXTURE_ENV, GL_TEXTURE_ENV_MODE, GL_MODULATE);
|
|
**/
|
|
extern void glwprintf(const wchar_t* fmt, ...) WPRINTF_ARGS(1);
|
|
|
|
/**
|
|
* Varargs version of glwprintf.
|
|
*
|
|
* @param fmt
|
|
* @param args
|
|
* @see vfprintf
|
|
**/
|
|
extern void glvwprintf(const wchar_t* fmt, va_list args) VWPRINTF_ARGS(1);
|
|
|
|
/**
|
|
* Determine pixel extents of a string.
|
|
*
|
|
* @param h
|
|
* @param text string in question.
|
|
* @param width
|
|
* @param height is roughly the pixel height of a capital letter, for use
|
|
* when aligning text in an aesthetically pleasing way.
|
|
*
|
|
* note: This is intended for the GUI (hence Unicode).
|
|
**/
|
|
LibError unifont_stringsize(const Handle h, const wchar_t* text, int& width, int& height);
|
|
|
|
/**
|
|
* @return height [pixels] of the font.
|
|
**/
|
|
int unifont_height(const Handle h);
|
|
|
|
/**
|
|
* @return width [pixels] of a certain character.
|
|
**/
|
|
int unifont_character_width(const Handle h, wchar_t c);
|
|
|
|
/**
|
|
* @return spacing in pixels from one line of text to the next.
|
|
**/
|
|
int unifont_linespacing(const Handle h);
|
|
|
|
#endif // INCLUDED_UNIFONT
|