summaryrefslogtreecommitdiff
path: root/xc/lib/font/include/fontenc.h
blob: 984caf45b36280c6f5a45681e203c5ba4c7ed262 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
/*
Copyright (c) 1998-2000 by Juliusz Chroboczek

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.
*/

/* $XFree86: xc/lib/font/include/fontenc.h,v 1.7 2000/11/14 16:54:45 dawes Exp $ */

/* Header for backend-independent encoding code */

/* An encoding is identified with a name.  An encoding contains some
 * global encoding data, such as its size, and a set of mappings.
 * Mappings are identified with their type and two integers, known as
 * pid and eid, the interpretation of which is type dependent. */

#ifndef _FONTENC_H
#define _FONTENC_H

/* Encoding types.  For future extensions, backends should be prepared
 * to ignore unknown encoding types. */
/* None of those should be 0 (used internally) */

#define FONT_ENCODING_UNICODE 1
#define FONT_ENCODING_TRUETYPE 2
#define FONT_ENCODING_POSTSCRIPT 3

/* This structure represents a mapping, either from numeric codes from
 * numeric codes, or from numeric codes to strings. */

/* It is expected that only one of `recode' and `name' will actually
 * be present.  However, having both fields simplifies the interface
 * somewhat. */

struct font_encoding_mapping {
  int type;                     /* the type of the mapping */
  int pid, eid;                 /* the identification of the mapping */
  unsigned (*recode)(unsigned, void*); /* mapping function */
  char *(*name)(unsigned, void*); /* function returning glyph names */
  void *client_data;            /* second parameter of the two above */
  struct font_encoding_mapping *next; /* link to next element in list */
};

/* This is the structure that holds all the info for one encoding.  It
 * consists of a charset name, its size, and a linked list of mappings
 * like above. */

struct font_encoding {
  char *name;                   /* the name of the encoding */
  char **aliases;               /* its aliases, null terminated */
  int size;                     /* its size, either in bytes or rows */
  int row_size;                 /* the size of a row, or 0 if bytes */
  struct font_encoding_mapping *mappings; /* linked list of mappings */
  struct font_encoding *next;   /* link to next element */
  /* the following two were added in version 0.2 of the font interface */
  /* they should be kept at the end to preserve binary compatibility */
  int first;                    /* first byte or row */
  int first_col;                /* first column in each row */
};


/* Function prototypes */

/* extract an encoding name from an XLFD name.  Returns a pointer to a
 * *static* buffer, or NULL */
char *font_encoding_from_xlfd(const char*, int);

/* find the encoding data for a given encoding name; second parameter
 * is the filename of the font for which the encoding is needed.
 * Returns NULL on failure. */
struct font_encoding *font_encoding_find(const char*, const char*);

/* Recode a code.  Always succeeds. */
unsigned font_encoding_recode(unsigned,
                              struct font_encoding*,
                              struct font_encoding_mapping*);

/* Return a name for a code.  Returns a string or NULL. */
char *font_encoding_name(unsigned,
                         struct font_encoding*,
                         struct font_encoding_mapping*);

/* Identify an encoding file.  If fileName doesn't exist, or is not an
   encoding file, return NULL, otherwise returns a NULL-terminated
   array of strings. */
char **identifyEncodingFile(const char *fileName);
#endif