/* ** (c) COPYRIGHT CERN 1994. ** Please first read the full copyright statement in the file COPYRIGH. */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.
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.
If 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.
This module is implemented by HTStyle.c, and it is a part of the Library of Common Code.
#ifndef HTStyle_H
#define HTStyle_H
#include "HTFormat.h"
#include "HTAnchor.h"
#include "HTML.h"
typedef long int HTFont; /* Dummy definition instead */
#ifdef SHORT_NAMES
#define HTStyleNew HTStNew
#define HTStyleFree HTStFree
#define HTStyleRead HTStRead
#define HTStyleWrite HTStWrite
#define HTStyleSheetNew HTStShNe
#define HTStyleSheetFree HTStShFr
#define HTStyleNamed HTStName
#define HTStyleForParagraph HTStFoPa
#define HTStyleMatching HTStMatc
#define HTStyleForRun HTStFoRu
#define HTStyleSheetAddStyle HTStShAd
#define HTStyleSheetRemoveStyle HTStShRm
#define HTStyleSheetRead HTStShRe
#define HTStyleSheetWrite HTStShWr
#endif
#ifdef DEFINE_STRUCT_HTSTYLE
#ifdef NeXT_suppressed
#include <appkit/appkit.h>
typedef NXCoord HTCoord;
#define HTParagraphStyle NXTextStyle
#define HTCoord NXCoord
typedef struct _color {
double grey;
int RGBColor;
} HTColor;
#else
typedef double HTCoord;
typedef struct _HTParagraphStyle {
HTCoord left_indent; /* @@@@ junk! etc etc*/
} HTParagraphStyle;
typedef int HTColor; /* Sorry about the US spelling! */
#endif
typedef struct {
short kind; /* only NX_LEFTTAB implemented*/
HTCoord position; /* x coordinate for stop */
} HTTabStop;
#else
typedef struct _HTParagraphStyle HTParagraphStyle;
#endif
#define STYLE_NAME_LENGTH 80 /* @@@@@@@@@@@ */
/* The Style Structure
** -------------------
*/
typedef struct _HTStyle
#ifdef DEFINE_STRUCT_HTSTYLE /* Don't */
{
/* Style management information
*/
struct _HTStyle *next; /* Link for putting into stylesheet */
char * name; /* Style name */
char * 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 Attribtes (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 */
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
}
#endif
HTStyle;
extern HTStyle * HTStyleModify PARAMS((
HTStyle * style,
HTNesting* nesting,
int element_number));
/* Style functions:
*/
extern HTStyle * HTStyleNew NOPARAMS;
extern HTStyle* HTStyleNewNamed PARAMS ((CONST char * name));
extern HTStyle * HTStyleFree PARAMS((HTStyle * self));
#ifdef SUPRESS
extern HTStyle * HTStyleRead PARAMS((HTStyle * self, HTStream * stream));
extern HTStyle * HTStyleWrite PARAMS((HTStyle * self, HTStream * stream));
#endif
/* Style Sheet
** -----------
*/
typedef struct _HTStyleSheet {
char * name;
HTStyle * styles;
} HTStyleSheet;
/* Stylesheet functions:
*/
extern HTStyleSheet * HTStyleSheetNew NOPARAMS;
extern HTStyleSheet * HTStyleSheetFree PARAMS((HTStyleSheet * self));
extern HTStyle * HTStyleNamed PARAMS((HTStyleSheet * self, CONST char * name));
extern HTStyle * HTStyleMatching PARAMS((HTStyleSheet *self, HTStyle * style));
/* extern HTStyle * HTStyleForRun PARAMS((HTStyleSheet *self, NXRun * run)); */
extern HTStyleSheet * HTStyleSheetAddStyle PARAMS((HTStyleSheet * self,
HTStyle * style));
extern HTStyleSheet * HTStyleSheetRemoveStyle PARAMS((HTStyleSheet * self,
HTStyle * style));
#ifdef SUPPRESS
extern HTStyleSheet * HTStyleSheetRead PARAMS((HTStyleSheet * self,
HTStream * stream));
extern HTStyleSheet * HTStyleSheetWrite PARAMS((HTStyleSheet * self,
HTStream * stream));
#endif
#define CLEAR_POINTER ((void *)-1) /* Pointer value means "clear me" */
#endif /* HTStyle_H */