1267
|
1 /* magstep.h: declaration for magstep fixing. |
|
2 |
|
3 Copyright (C) 1994 Karl Berry. |
|
4 |
|
5 This program is free software; you can redistribute it and/or modify |
|
6 it under the terms of the GNU General Public License as published by |
|
7 the Free Software Foundation; either version 2, or (at your option) |
|
8 any later version. |
|
9 |
|
10 This program is distributed in the hope that it will be useful, |
|
11 but WITHOUT ANY WARRANTY; without even the implied warranty of |
|
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|
13 GNU General Public License for more details. |
|
14 |
|
15 You should have received a copy of the GNU General Public License |
|
16 along with this program; if not, write to the Free Software |
1315
|
17 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ |
1267
|
18 |
|
19 #ifndef KPATHSEA_MAGSTEP_H |
|
20 #define KPATHSEA_MAGSTEP_H |
|
21 |
|
22 #include <kpathsea/c-proto.h> |
|
23 #include <kpathsea/types.h> |
|
24 |
|
25 /* If DPI is close enough to some magstep of BDPI, return the true dpi |
|
26 value, and the magstep found (or zero) in M_RET (if |
|
27 non-null). ``Close enough'' means within one pixel. |
|
28 |
|
29 M_RET is slightly encoded: the least significant bit is on for a |
|
30 half-magstep, off otherwise. Thus, a returned M_RET of 1 means |
|
31 \magstephalf, i.e., sqrt(1.2), i.e., 1.09544. Put another way, |
|
32 return twice the number of magsteps. |
|
33 |
|
34 In practice, this matters for magstephalf. Floating-point computation |
|
35 with the fixed-point DVI representation leads to 328 (for BDPI == |
|
36 300); specifying `at 11pt' yields 330; the true \magstephalf is 329 |
|
37 (that's what you get if you run Metafont with mag:=magstep(.5)). |
|
38 |
|
39 The time to call this is after you read the font spec from the DVI |
|
40 file, but before you look up any files -- do the usual floating-point |
|
41 computations, and then fix up the result. */ |
|
42 |
|
43 extern unsigned kpse_magstep_fix P3H(unsigned dpi, unsigned bdpi, int *m_ret); |
|
44 |
|
45 #endif /* not KPATHSEA_MAGSTEP_H */ |