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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
|
/*
* $LynxId: HTStyle.h,v 1.20 2023/10/24 08:14:54 tom Exp $
HTStyle: Style management for libwww
STYLE DEFINITION FOR HYPERTEXT
Styles allow the translation between a logical property of a piece of text
and its physical representation.
A StyleSheet is a collection of styles, defining the translation necessary
to represent a document. It is a linked list of styles.
Overriding this module
Why is the style structure declared in the HTStyle.h module, instead of
having the user browser define the structure, and the HTStyle routines just
use sizeof() for copying?
It's not obvious whether HTStyle.c should be common code. It's useful to
have common code for loading style sheets, especially if the movement toward
standard style sheets gets going.
If it IS common code, then both the hypertext object and HTStyle.c must know
the structure of a style, so HTStyle.h is a suitable place to put that.
HTStyle.c has to be compiled with a knowledge of the
It we take it out of the library, then of course HTStyle could be declared
as an undefined structure. The only references to it are in the
structure-flattening code HTML.c and HTPlain.c, which only use
HTStypeNamed().
You can in any case override this function in your own code, which will
prevent the HTStyle from being loaded. You will be able to redefine your
style structure in this case without problems, as no other moule needs to
know it.
*/
#ifndef HTStyle_H
#define HTStyle_H
#include <HTAnchor.h>
typedef long int HTFont; /* Dummy definition instead */
#ifdef NeXT_suppressed
#include <appkit/appkit.h>
typedef NXCoord HTCoord;
#define HTParagraphStyle NXTextStyle
#define HTCoord NXCoord
typedef struct _color {
float grey;
int RGBColor;
} HTColor;
#else
typedef int HTCoord; /* changed from float to int - kw */
typedef struct _HTParagraphStyle {
HTCoord left_indent; /* @@@@ junk! etc etc */
} HTParagraphStyle;
typedef int HTColor; /* Sorry about the US spelling! */
#endif
#ifdef __cplusplus
extern "C" {
#endif
#define STYLE_NAME_LENGTH 80 /* @@@@@@@@@@@ */
typedef struct {
short kind; /* only NX_LEFTTAB implemented */
HTCoord position; /* x coordinate for stop */
} HTTabStop;
/* The Style Structure
* -------------------
*/
typedef struct _HTStyle {
/* Style management information
*/
struct _HTStyle *next; /* Link for putting into stylesheet */
char *w_name; /* Style name */
const char *c_name; /* Style name */
int id; /* equivalent of name, for speed */
char *w_SGMLTag; /* Tag name to start */
const char *c_SGMLTag; /* Tag name to start */
/* Character attributes (a la NXRun)
*/
HTFont font; /* Font id */
HTCoord fontSize; /* The size of font, not independent */
HTColor color; /* text gray of current run */
int superscript; /* superscript (-sub) in points */
HTAnchor *anchor; /* Anchor id if any, else zero */
/* Paragraph Attributes (a la NXTextStyle)
*/
HTCoord indent1st; /* how far first line in paragraph is
* indented */
HTCoord leftIndent; /* how far second line is indented */
HTCoord rightIndent; /* (Missing from NeXT version */
short alignment; /* quad justification */
HTCoord lineHt; /* line height */
HTCoord descentLine; /* descender bottom from baseline */
const HTTabStop *tabs; /* array of tab stops, 0 terminated */
BOOL wordWrap; /* Yes means wrap at space not char */
BOOL freeFormat; /* Yes means \n is just white space */
HTCoord spaceBefore; /* Omissions from NXTextStyle */
HTCoord spaceAfter;
int paraFlags; /* Paragraph flags, bits as follows: */
#define PARA_KEEP 1 /* Do not break page within this paragraph */
#define PARA_WITH_NEXT 2 /* Do not break page after this paragraph */
#define HT_JUSTIFY 0 /* For alignment */
#define HT_LEFT 1
#define HT_RIGHT 2
#define HT_CENTER 3
} HTStyle;
#define GetHTStyleName(p) ((p)->w_name ? (p)->w_name : (p)->c_name)
#define GetHTStyleSGML(p) ((p)->w_SGMLTag ? (p)->w_SGMLTag : (p)->c_SGMLTag)
#define HTStyleInit( \
next, name, SGML_tag, \
font, fontsize, color, superscript, \
anchor, indent1st, leftIndent, rightIndent, \
alignment, lineHt, descentLine, \
tabs, wordWrap, freeFormat, spaceBefore, spaceAfter, paraFlags) \
{ \
next, NULL, #name, ST_##name, NULL, SGML_tag, \
font, fontsize, color, superscript, \
anchor, indent1st, leftIndent, rightIndent, \
alignment, lineHt, descentLine, \
tabs, wordWrap, freeFormat, spaceBefore, spaceAfter, paraFlags }
#define HT_ALIGN_NONE (-1)
/* Style functions:
*/
extern HTStyle *HTStyleNew(void);
extern HTStyle *HTStyleNewNamed(const char *name);
extern HTStyle *HTStyleFree(HTStyle *self);
/* Style Sheet
* -----------
*/
typedef struct _HTStyleSheet {
const char *name;
HTStyle *styles;
} HTStyleSheet;
/* Stylesheet functions:
*/
extern HTStyleSheet *HTStyleSheetNew(void);
extern HTStyleSheet *HTStyleSheetFree(HTStyleSheet *self);
extern HTStyle *HTStyleNamed(HTStyleSheet *self, const char *name);
extern HTStyle *HTStyleForParagraph(HTStyleSheet *self, HTParagraphStyle * paraStyle);
extern HTStyle *HTStyleMatching(HTStyleSheet *self, HTStyle *style);
/* extern HTStyle * HTStyleForRun (HTStyleSheet *self, NXRun * run); */
extern HTStyleSheet *HTStyleSheetAddStyle(HTStyleSheet *self, HTStyle *style);
extern HTStyleSheet *HTStyleSheetRemoveStyle(HTStyleSheet *self, HTStyle *style);
#define CLEAR_POINTER ((void *)-1) /* Pointer value means "clear me" */
/* DefaultStyle.c */
extern HTStyleSheet *DefaultStyle(HTStyle ***result_array);
/* enum, use this instead of HTStyle name comparisons */
enum HTStyle_Enum {
ST_Normal = 0,
ST_DivCenter,
ST_DivLeft,
ST_DivRight,
ST_Banner,
ST_Blockquote,
ST_Bq,
ST_Footnote,
ST_List,
ST_List1,
ST_List2,
ST_List3,
ST_List4,
ST_List5,
ST_List6,
ST_Menu,
ST_Menu1,
ST_Menu2,
ST_Menu3,
ST_Menu4,
ST_Menu5,
ST_Menu6,
ST_Glossary,
ST_Glossary1,
ST_Glossary2,
ST_Glossary3,
ST_Glossary4,
ST_Glossary5,
ST_Glossary6,
ST_GlossaryCompact,
ST_GlossaryCompact1,
ST_GlossaryCompact2,
ST_GlossaryCompact3,
ST_GlossaryCompact4,
ST_GlossaryCompact5,
ST_GlossaryCompact6,
ST_Example,
ST_Preformatted,
ST_Listing,
ST_Address,
ST_Note,
ST_Heading1,
ST_Heading2,
ST_Heading3,
ST_Heading4,
ST_Heading5,
ST_Heading6,
ST_HeadingCenter,
ST_HeadingLeft,
ST_HeadingRight
};
#ifdef __cplusplus
}
#endif
#endif /* HTStyle_H */
|
