font: remove font.h
This header is unused so we can remove it. Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
This commit is contained in:
David Herrmann
parent
002e8fb65e
commit
f1f8fac0ec
166
src/font.h
166
src/font.h
@ -1,166 +0,0 @@
|
||||
/*
|
||||
* kmscon - Font Management
|
||||
*
|
||||
* Copyright (c) 2011-2012 David Herrmann <dh.herrmann@googlemail.com>
|
||||
* Copyright (c) 2011 University of Tuebingen
|
||||
*
|
||||
* 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.
|
||||
*/
|
||||
|
||||
/*
|
||||
* Font Management
|
||||
* The output of a console is a fixed-size table. That is, it consists of many
|
||||
* cells where each character is printed either into a single cell or spread
|
||||
* across multiple cells. However, there will never be multiple characters in a
|
||||
* single cell so cell indexes are the smallest position information.
|
||||
* The classic console uses one character per cell. Newer consoles may allow
|
||||
* widened characters, though. Common are characters that are double-width and
|
||||
* characters that are double-width+double-height.
|
||||
* If you mix many different widths/heights then this might get very
|
||||
* memory-consuming as we need to have one loaded font for each size to get
|
||||
* decent results. Therefore, avoid widths/heights other than the ones
|
||||
* mentioned.
|
||||
*
|
||||
* Therefore, this layer does not provide the classic font APIs, instead it
|
||||
* offers a font_screen object which represents the whole screen. You specify
|
||||
* the x/y coordinates of your framebuffer/target and the font plus point-size
|
||||
* that you want to use. This layer automatically computes the pixel size and
|
||||
* resulting row/column counts.
|
||||
* For reversed logic you can also specify row/column counts and the API
|
||||
* calculates the required font-point-size.
|
||||
* In both situations you never have to deal with font related details! The only
|
||||
* thing you need to know is the row/column count of the resulting table and
|
||||
* all the characters in the table.
|
||||
*
|
||||
* When drawing a screen you need to tell the font layer where to draw the
|
||||
* characters. For performance reasons this is split into several tasks:
|
||||
* 1: Start a drawing operation. This resets the screen and prepares the font
|
||||
* for drawing. It clears all previous entries.
|
||||
* 2: Add each character you want to draw to the font_screen object with its
|
||||
* cell position and cell width. The width is probably always 1/1 but for
|
||||
* multi-cell characters you can specify other widths/heights.
|
||||
* 3: Perform the drawing operation. This instructs the font-layer to actually
|
||||
* draw all the added characters to your surface.
|
||||
* You need to perform all 3 steps for every frame you render.
|
||||
*/
|
||||
|
||||
#ifndef FONT_FONT_H
|
||||
#define FONT_FONT_H
|
||||
|
||||
#include <stdlib.h>
|
||||
#include "gl.h"
|
||||
#include "unicode.h"
|
||||
#include "uterm.h"
|
||||
|
||||
struct kmscon_font_factory;
|
||||
struct kmscon_font;
|
||||
|
||||
int kmscon_font_factory_new(struct kmscon_font_factory **out);
|
||||
void kmscon_font_factory_ref(struct kmscon_font_factory *ff);
|
||||
void kmscon_font_factory_unref(struct kmscon_font_factory *ff);
|
||||
|
||||
int kmscon_font_factory_load(struct kmscon_font_factory *ff,
|
||||
struct kmscon_font **out, unsigned int width, unsigned int height);
|
||||
|
||||
void kmscon_font_ref(struct kmscon_font *font);
|
||||
void kmscon_font_unref(struct kmscon_font *font);
|
||||
|
||||
unsigned int kmscon_font_get_height(struct kmscon_font *font);
|
||||
unsigned int kmscon_font_get_width(struct kmscon_font *font);
|
||||
int kmscon_font_draw(struct kmscon_font *font, kmscon_symbol_t ch, float *m,
|
||||
struct gl_shader *shader);
|
||||
|
||||
/* font attributes */
|
||||
|
||||
enum font_style {
|
||||
FONT_NORMAL,
|
||||
FONT_ITALIC,
|
||||
};
|
||||
|
||||
struct font_attr {
|
||||
const char *name; /* use NULL for default */
|
||||
unsigned int points;
|
||||
unsigned int dpi; /* use 0 for default */
|
||||
bool bold;
|
||||
enum font_style style;
|
||||
};
|
||||
|
||||
#define FONT_ATTR(_name, _points, _dpi) &(const struct font_attr){ \
|
||||
.name = (_name), \
|
||||
.points = (_points), \
|
||||
.dpi = (_dpi), \
|
||||
.bold = false, \
|
||||
.style = FONT_NORMAL, \
|
||||
}
|
||||
|
||||
struct font_char_attr {
|
||||
uint8_t fr; /* foreground red */
|
||||
uint8_t fg; /* foreground green */
|
||||
uint8_t fb; /* foreground blue */
|
||||
uint8_t br; /* background red */
|
||||
uint8_t bg; /* background green */
|
||||
uint8_t bb; /* background blue */
|
||||
unsigned int bold : 1; /* bold character */
|
||||
unsigned int underline : 1; /* underlined character */
|
||||
unsigned int inverse : 1; /* inverse colors */
|
||||
unsigned int protect : 1; /* cannot be erased */
|
||||
};
|
||||
|
||||
/* font draw/assemble buffers */
|
||||
|
||||
struct font_buffer {
|
||||
unsigned int width;
|
||||
unsigned int stride;
|
||||
unsigned int height;
|
||||
char *data;
|
||||
};
|
||||
|
||||
int font_buffer_new(struct font_buffer **out, unsigned int width,
|
||||
unsigned int height);
|
||||
void font_buffer_free(struct font_buffer *buf);
|
||||
|
||||
/* font screens */
|
||||
|
||||
struct font_screen;
|
||||
|
||||
int font_screen_new(struct font_screen **out, struct font_buffer *buf,
|
||||
const struct font_attr *attr,
|
||||
struct uterm_screen *scr, struct gl_shader *shader);
|
||||
int font_screen_new_fixed(struct font_screen **out, struct font_buffer *buf,
|
||||
const struct font_attr *attr,
|
||||
unsigned int cols, unsigned int rows,
|
||||
struct uterm_screen *scr, struct gl_shader *shader);
|
||||
void font_screen_free(struct font_screen *screen);
|
||||
|
||||
unsigned int font_screen_columns(struct font_screen *screen);
|
||||
unsigned int font_screen_rows(struct font_screen *screen);
|
||||
unsigned int font_screen_points(struct font_screen *screen);
|
||||
unsigned int font_screen_width(struct font_screen *screen);
|
||||
unsigned int font_screen_height(struct font_screen *screen);
|
||||
|
||||
int font_screen_draw_start(struct font_screen *screen);
|
||||
int font_screen_draw_char(struct font_screen *screen, kmscon_symbol_t ch,
|
||||
const struct font_char_attr *attr,
|
||||
unsigned int cellx, unsigned int celly,
|
||||
unsigned int width, unsigned int height,
|
||||
bool draw_bg);
|
||||
int font_screen_draw_perform(struct font_screen *screen, float *m);
|
||||
|
||||
#endif /* FONT_FONT_H */
|
||||
Loading…
x
Reference in New Issue
Block a user