mirror of
https://github.com/elliotnunn/sys7.1-doc-wip.git
synced 2024-06-06 06:29:27 +00:00
192 lines
7.2 KiB
C
192 lines
7.2 KiB
C
/*
|
|
File: sc.h
|
|
|
|
Contains: xxx put contents here (or delete the whole line) xxx
|
|
|
|
Written by: xxx put name of writer here (or delete the whole line) xxx
|
|
|
|
Copyright: © 1987-1990 by Apple Computer, Inc., all rights reserved.
|
|
|
|
Change History (most recent first):
|
|
|
|
<4> 2/11/91 RB MR, CL,CC,#81198: Add initials to previous fix.
|
|
<3> 1/24/91 RB (CEL) #81198, #81199 Increase MAXVECTORS by 6 so that SCANERR is
|
|
not returned by drawparab in big glyphs.
|
|
<2> 12/10/90 RB Change findextrema to return error code.[cel]
|
|
<7> 7/18/90 MR ScanChar returns error code as int
|
|
<6> 7/13/90 MR Minor cleanup on some comments
|
|
<5> 6/21/90 RB add NODOCONTROL define
|
|
<4> 6/3/90 RB add def of STUBCONTROL
|
|
<3> 5/3/90 RB Almost completely new scanconverter. Winding number fill,
|
|
dropout control.
|
|
|
|
<2> 2/27/90 CL Dropoutcontrol scanconverter and SCANCTRL[] instruction
|
|
<3.0> 8/28/89 sjk Cleanup and one transformation bugfix
|
|
<2.2> 8/14/89 sjk 1 point contours now OK
|
|
<2.1> 8/8/89 sjk Improved encryption handling
|
|
<2.0> 8/2/89 sjk Just fixed EASE comment
|
|
<1.7> 8/1/89 sjk Added composites and encryption. Plus some enhancements…
|
|
<1.6> 6/13/89 SJK Comment
|
|
<1.5> 6/2/89 CEL 16.16 scaling of metrics, minimum recommended ppem, point size 0
|
|
bug, correct transformed integralized ppem behavior, pretty much
|
|
so
|
|
<1.4> 5/26/89 CEL EASE messed up on “c” comments
|
|
<•1.3> 5/26/89 CEL Integrated the new Font Scaler 1.0 into Spline Fonts
|
|
|
|
To Do:
|
|
*/
|
|
/* rwb - 4/19/90 Almost completely new scanconverter - winding number fill, dropout control
|
|
** 3.2 CKL 02/20/1990 Added another public prototype sc_MovePoints()
|
|
** 3.1 CKL 02/08/1990 Added ANSI-C prototypes.
|
|
*/
|
|
|
|
/*EASE$$$ READ ONLY COPY of file “sc.h”
|
|
** 3.0 sjk 08/28/1989 Cleanup and one transformation bugfix
|
|
** 2.2 sjk 08/14/1989 1 point contours now OK
|
|
** 2.1 sjk 08/08/1989 Improved encryption handling
|
|
** 2.0 sjk 08/02/1989 Just fixed EASE comment
|
|
** 1.7 sjk 08/01/1989 Added composites and encryption. Plus some enhancements…
|
|
** 1.6 SJK 06/13/1989 Comment
|
|
** 1.5 CEL 06/02/1989 16.16 scaling of metrics, minimum recommended ppem,
|
|
** point size 0 bug, correct transformed integralized ppem behavior,
|
|
** pretty much so
|
|
** 1.4 CEL 05/26/1989 EASE messed up on “c” comments
|
|
**•1.3 CEL 05/26/1989 Integrated the new Font Scaler 1.0 into Spline Fonts
|
|
** END EASE MODIFICATION HISTORY */
|
|
/*
|
|
* This module scanconverts a shape defined by quadratic bezier splines
|
|
*
|
|
* © Apple Computer Inc. 1987, 1988, 1989.
|
|
*
|
|
*
|
|
* Released for alpha on January 31, 1989.
|
|
*
|
|
* History:
|
|
* Work on this module began in the fall of 1987.
|
|
* Written June 14, 1988 by Sampo Kaasila.
|
|
*
|
|
*/
|
|
|
|
/* DO NOT change these constants without understanding implications:
|
|
overflow, out of range, out of memory, quality considerations, etc... */
|
|
|
|
#define PIXELSIZE 64 /* number of units per pixel. It has to be a power of two */
|
|
#define PIXSHIFT 6 /* should be 2log of PIXELSIZE */
|
|
#define ERRDIV 16 /* maximum error is (pixel/ERRDIV) */
|
|
#define ERRSHIFT 4 /* = 2log(ERRDIV), define only if ERRDIV is a power of 2 */
|
|
#define ONE 0x40 /* constants for 26.6 arithmetic */
|
|
#define HALF 0x20
|
|
#define HALFM 0x1F /* one-half - one-sixtyfourth */
|
|
#define FRACPART 0x3F
|
|
#define INTPART 0xFFFFFFC0
|
|
#define STUBCONTROL 0x10000
|
|
#define NODOCONTROL 0x20000
|
|
|
|
/* The maximum number of vectors a spline segment is broken down into
|
|
* is 2 ^ MAXGY
|
|
* MAXGY can at most be:
|
|
* (31 - (input range to sc_DrawParabola 15 + PIXSHIFT = 21)) / 2
|
|
*/
|
|
#define MAXGY 5
|
|
#define MAXMAXGY 8 /* related to MAXVECTORS */
|
|
|
|
/* RULE OF THUMB: xPoint and yPoints will run out of space when
|
|
* MAXVECTORS = 176 + ppem/4 ( ppem = pixels per EM ) */
|
|
#define MAXVECTORS 262 /* must be at least 257 = (2 ^ MAXMAXGY) + 1 <3> added 5 because vecount
|
|
is now initialized to 5 rather than 1 plus 1 for slop*/
|
|
|
|
#define sc_outOfMemory 0x01 /* For the error field */
|
|
#define sc_freeBitMap 0x01 /* For the info field */
|
|
|
|
typedef struct {
|
|
uint32 *bitMap;
|
|
int16 *xLines, *yLines, **xBase, **yBase;
|
|
int16 xMin, yMin, xMax, yMax;
|
|
uint16 nXchanges, nYchanges;
|
|
uint16 high, wide;
|
|
} sc_BitMapData;
|
|
/* rwb 4/2/90 New definition of sc_BitMapData.
|
|
|
|
bitMap is high bits tall, and wide bits wide, but wide is rounded up to
|
|
a long. The actual bitmap width is xMax - xMin. xMin and yMin represent the
|
|
rounded integer value of the minimum 26.6 coordinate, but j.5 is rounded down
|
|
to j rather than up to j+1. xMax and yMax represent the rounded up integer
|
|
value of the maximum 26.6 coordinat, and j.5 does round up to j+1. The actual
|
|
pixel center scan lines that are represented in the bitmap are xMin ... xMax-1
|
|
and yMin...to ...yMax-1.
|
|
|
|
nYchanges is the total number of times that all of the contours in a glyph changed
|
|
y direction. It is always an even number, and represents the maximum number
|
|
of times that a row scan line can intersect the glyph. Similarly, nXchanges
|
|
is the total number of x direction changes.
|
|
|
|
yLines is an array of arrays. Each array corresoponds to one row scan line. Each
|
|
array is nYchanges+2 entries long. The 0th entry contains the number of times that row
|
|
intersects the glyph contours in an On Transition and then the pixel columns where
|
|
the intersections occur. These intersections are sorted from left to right. The last
|
|
entry contains the number of OFF transition intersections, and the immediately
|
|
preceding entries contain the pixel column numbers where the intersections occur.
|
|
These are also sorted from left to right. yBase is an array of
|
|
pointers; each pointer pointing to one of the arrays in yLines.
|
|
|
|
Similarly, xLines and xBase describe the intersection of column scan lines with
|
|
the glyph conotours. These arrays are only used to fix dropouts.
|
|
*/
|
|
|
|
typedef struct {
|
|
int32 xPoints[ MAXVECTORS ]; /* vectors */
|
|
int32 yPoints[ MAXVECTORS ];
|
|
} sc_GlobalData;
|
|
|
|
typedef struct {
|
|
int32 *x, *y;
|
|
int16 ctrs;
|
|
int16 padWord; /* <4> */
|
|
int16 *sp, *ep;
|
|
int8 *onC;
|
|
} sc_CharDataType;
|
|
|
|
|
|
/* Internal flags for the onCurve array */
|
|
#define OVERLAP 0x02 /* can not be the same as ONCURVE in sfnt.h */
|
|
#define DROPOUTCONTROL 0x04 /* can not be the same as ONCURVE in sfnt.h */
|
|
|
|
#ifndef ONCURVE
|
|
#include "sfnt.h"
|
|
#endif
|
|
|
|
|
|
/* PUBLIC PROTOTYPES */
|
|
|
|
/*
|
|
* Returns the bitmap
|
|
* This is the top level call to the scan converter.
|
|
*
|
|
* Assumes that (*handle)->bbox.xmin,...xmax,...ymin,...ymax
|
|
* are already set by sc_FindExtrema()
|
|
*
|
|
* PARAMETERS:
|
|
*
|
|
* lowBand is lowest scan line to be included in the band.
|
|
* highBand is the highest scan line to be included in the band.
|
|
* if highBand < lowBand then no banding will be done.
|
|
* Always keep lowBand and highband within range: [ymin, (ymin+1) ....... ymax];
|
|
* scPtr->bitMap always points at the actual memory.
|
|
* the first row of pixels above the baseLine is numbered 0, and the next one up is 1.
|
|
* => the y-axis definition is the normal one with the y-axis pointing straight up.
|
|
*
|
|
*/
|
|
extern int sc_ScanChar(sc_CharDataType *glyphPtr, sc_GlobalData *scPtr,
|
|
sc_BitMapData *bbox, int16 lowBand, int16 highBand, int32 scanControl);
|
|
|
|
/*
|
|
* Finds the extrema of a character.
|
|
*
|
|
* PARAMETERS:
|
|
*
|
|
* bbox is the output of this function and it contains the bounding box.
|
|
*/
|
|
extern int sc_FindExtrema(sc_CharDataType *glyphPtr, sc_BitMapData *bbox);
|
|
|
|
|