diff options
author | Karl Berry <karl@freefriends.org> | 2021-02-25 19:22:25 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2021-02-25 19:22:25 +0000 |
commit | ad547a6b5986815fda458221149728d9d9ab1d87 (patch) | |
tree | 16296910eb3eca724371474ea9aea3994dc69614 /Build/source/texk/kpathsea/magstep.h | |
parent | 947b43de3dd21d58ccc2ffadefc4441ea1c2a813 (diff) |
restore Build,TODO from r57911
git-svn-id: svn://tug.org/texlive/trunk@57915 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/kpathsea/magstep.h')
-rw-r--r-- | Build/source/texk/kpathsea/magstep.h | 59 |
1 files changed, 59 insertions, 0 deletions
diff --git a/Build/source/texk/kpathsea/magstep.h b/Build/source/texk/kpathsea/magstep.h new file mode 100644 index 00000000000..eae08f6a35d --- /dev/null +++ b/Build/source/texk/kpathsea/magstep.h @@ -0,0 +1,59 @@ +/* magstep.h: declaration for magstep fixing. + + Copyright 1994, 2008, 2009 Karl Berry. + Copyright 1999, 2005 Olaf Weber. + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + This library 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 + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public License + along with this library; if not, see <http://www.gnu.org/licenses/>. */ + +#ifndef KPATHSEA_MAGSTEP_H +#define KPATHSEA_MAGSTEP_H + +#include <kpathsea/c-proto.h> +#include <kpathsea/types.h> + +#ifdef __cplusplus +extern "C" { +#endif + +/* If DPI is close enough to some magstep of BDPI, return the true dpi + value, and the magstep found (or zero) in M_RET (if + non-null). ``Close enough'' means within one pixel. + + M_RET is slightly encoded: the least significant bit is on for a + half-magstep, off otherwise. Thus, a returned M_RET of 1 means + \magstephalf, i.e., sqrt(1.2), i.e., 1.09544. Put another way, + return twice the number of magsteps. + + In practice, this matters for magstephalf. Floating-point computation + with the fixed-point DVI representation leads to 328 (for BDPI == + 300); specifying `at 11pt' yields 330; the true \magstephalf is 329 + (that's what you get if you run Metafont with mag:=magstep(.5)). + + The time to call this is after you read the font spec from the DVI + file, but before you look up any files -- do the usual floating-point + computations, and then fix up the result. */ + +extern KPSEDLL unsigned kpathsea_magstep_fix (kpathsea kpse, unsigned dpi, + unsigned bdpi, int *m_ret); + +#if defined (KPSE_COMPAT_API) +extern KPSEDLL unsigned kpse_magstep_fix (unsigned dpi, unsigned bdpi, + int *m_ret); +#endif + +#ifdef __cplusplus +} +#endif + +#endif /* not KPATHSEA_MAGSTEP_H */ |