Annotation of Amaya/amaya/amaya.h, revision 1.163

1.8       cvs         1: /*
                      2:  *
                      3:  *  (c) COPYRIGHT MIT and INRIA, 1996.
                      4:  *  Please first read the full copyright statement in file COPYRIGHT.
                      5:  *
                      6:  */
                      7: 
1.59      cvs         8: #ifndef AMAYA_H 
1.1       cvs         9: #define AMAYA_H
                     10: 
1.10      cvs        11: /* Thot interface */
                     12: #include "thot_gui.h"
                     13: #include "thot_sys.h"
1.79      cvs        14: #include "appstruct.h"
1.10      cvs        15: #include "application.h"
                     16: #include "attribute.h"
                     17: #include "browser.h"
                     18: #include "content.h"
                     19: #include "dialog.h"
1.103     cvs        20: #include "fileaccess.h"
1.10      cvs        21: #include "interface.h"
                     22: #include "libmsg.h"
                     23: #include "message.h"
                     24: #include "presentation.h"
                     25: #include "selection.h"
                     26: #include "reference.h"
                     27: #include "tree.h"
                     28: #include "view.h"
1.105     cvs        29: #include "uconvert.h"
1.82      cvs        30: #include "undo.h"
1.1       cvs        31: /* Included headerfiles */
1.10      cvs        32: #include "EDITOR.h"
1.1       cvs        33: #include "HTML.h"
1.84      cvs        34: #include "TextFile.h"
1.1       cvs        35: #include "amayamsg.h"
1.156     cvs        36: #include "parser.h"
1.1       cvs        37: 
1.25      cvs        38: #define NAME_LENGTH     32
                     39: 
1.137     cvs        40: #define HTAppName     TEXT("amaya")
1.163   ! cvs        41: #define HTAppVersion  TEXT("V3.9")
1.158     cvs        42: #define HTAppDate     TEXT ("")
1.130     cvs        43: 
                     44: #define URL_STR       "/"
                     45: #define URL_SEP       '/'
                     46: #define WC_URL_STR    TEXT ("/")
                     47: #define WC_URL_SEP    TEXT ('/')
1.105     cvs        48: 
1.36      cvs        49: 
1.94      cvs        50: /* Number of views used in Amaya */
                     51: #define AMAYA_MAX_VIEW_DOC  7
                     52: 
1.141     cvs        53: /* the type of character convertion we want to make on local URLs */
                     54: typedef enum _ConvertionType
                     55: {
                     56:   AM_CONV_NONE = 0,
                     57:   AM_CONV_URL_SEP = 0x1, /* converts URL_SEPs into DIR_SEPs */
                     58:   AM_CONV_PERCENT = 0x2, /* converts %xx into the equiv. char */
                     59:   AM_CONV_ALL = 0xFFFF   /* do everything */
                     60: }
                     61: ConvertionType;
                     62: 
1.139     cvs        63: /* the HTTP header name we want to make visible to the application */
                     64: typedef enum _AHTHeaderName
                     65:   {
                     66:     AM_HTTP_CONTENT_TYPE = 0,
                     67:     AM_HTTP_CHARSET = 1
                     68:   } 
                     69: AHTHeaderName;
                     70: 
                     71: /* the structure used for exchanging HTTP header info between the net library
                     72:    and amaya */
                     73: typedef struct _AHTHeaders
                     74:   {
                     75:     CHAR_T *content_type;
                     76:     CHAR_T *charset;
                     77:   }
                     78: AHTHeaders;
                     79: 
1.50      cvs        80: /* The structures used for request callbacks */
                     81: typedef void   TIcbf (Document doc, int status, char *urlName,
1.139     cvs        82:                      char *outputfile, const AHTHeaders *http_headers,
1.50      cvs        83:                      const char *data_block, int data_block_size,
                     84:                      void *context);
                     85: 
1.138     cvs        86: typedef void  TTcbf (Document doc, int status, CHAR_T* urlName,
1.139     cvs        87:                      CHAR_T* outputfile, const AHTHeaders *http_headers,
1.50      cvs        88:                      void *context);
                     89: 
1.25      cvs        90: /* How are Network accesses provided ? */
                     91: #include "libwww.h"
1.1       cvs        92: 
1.66      cvs        93: /* The different events to open a new document */
1.41      cvs        94: typedef enum _ClickEvent {
1.73      cvs        95:   CE_ABSOLUTE, CE_RELATIVE, CE_FORM_POST, CE_FORM_GET,
1.153     cvs        96:   CE_HELP, CE_MAKEBOOK, CE_LOG , CE_TEMPLATE, CE_INIT,
                     97:   CE_ANNOT
1.41      cvs        98: } ClickEvent;
1.20      cvs        99: 
                    100: #define NO               0
                    101: #define YES              1
                    102: 
                    103: /* dialogue */
                    104: #define URLForm          1
1.29      cvs       105: #define OpenForm         2
                    106: #define URLName          3
                    107: #define LocalName        4
                    108: #define DirSelect        5
                    109: #define DocSelect        6
1.20      cvs       110: #define StopCommand      7
1.29      cvs       111: #define SaveForm         8
1.20      cvs       112: #define DirSave          9
                    113: #define DocSave         10
                    114: #define ToggleSave      11
1.29      cvs       115: #define NameSave        12
1.30      cvs       116: #define ImgDirSave      13
                    117: #define Label1          14
                    118: #define Label2          15
                    119: #define Label3          16
                    120: #define Label4          17
1.29      cvs       121: #define ConfirmForm     18
                    122: #define ConfirmText     19
1.20      cvs       123: #define AttrHREFForm    20
                    124: #define AttrHREFText    21
                    125: #define FormAnswer      22
1.120     cvs       126: #define RealmText       23
1.20      cvs       127: #define AnswerText      24
                    128: #define NameText        25
                    129: #define PasswordText    26
1.30      cvs       130: #define FilterText      27
                    131: #define ClassForm       28
1.20      cvs       132: #define ClassSelect     29
                    133: #define AClassForm      30
1.30      cvs       134: #define AClassSelect    31
                    135: #define ConfirmSave     32
                    136: #define ConfirmSaveList 33
                    137: #define OptionMenu     34
1.134     cvs       138: /* MAX_SUBMENUS references reserved for submenus of Option menu */
                    139: /* Do not insert new entries here */
1.91      cvs       140: #define MAX_SUBMENUS    400
                    141: #define About1         435
                    142: #define About2         436
                    143: #define About3         437
                    144: #define Version                438
                    145: #define AboutForm              439
1.92      cvs       146: #define TableForm       440
                    147: #define TableRows       441
                    148: #define TableCols       442
                    149: #define TableBorder     443
1.134     cvs       150: #define MathEntityForm  444
                    151: #define MathEntityText  445
1.142     cvs       152: #define TitleForm       446
                    153: #define TitleText       447
                    154: #define MAX_REF         448
1.20      cvs       155: 
1.150     cvs       156: #define FormPrint        1
                    157: #define PrintOptions     2
                    158: #define PaperFormat      3
                    159: #define PrintSupport     4
                    160: #define PPrinterName     5
                    161: #define PaperOrientation 6
                    162: #define PPagesPerSheet   7
                    163: #define PRINT_MAX_REF   8
1.147     cvs       164: 
                    165: #define ImageURL       1
                    166: #define ImageLabel     2
                    167: #define ImageLabel2    3
                    168: #define ImageLabel3    4
                    169: #define ImageLabel4    5
                    170: #define ImageDir       6
                    171: #define ImageSel       7
                    172: #define ImageFilter     8
                    173: #define FormImage      9
                    174: #define RepeatImage    10
                    175: #define FormBackground 11
                    176: #define ImageAlt       12
                    177: #define FormAlt        13
                    178: #define IMAGE_MAX_REF  14
                    179: 
                    180: #define CSSForm         0
                    181: #define CSSSelect       1
                    182: #define MAX_CSS_REF     2
                    183: 
                    184: #define FormMaths 0
                    185: #define MenuMaths 1
                    186: #define MAX_MATHS  2
                    187: 
1.11      cvs       188: /* The possible GET/POST/PUT request modes */
                    189: /*synchronous request*/
                    190: #define AMAYA_SYNC     1       /*0x000001 */  
                    191: /*synchronous request with incremental callbacks */
                    192: #define AMAYA_ISYNC    2       /*0x000010 */  
                    193: /*asynchronous request */
1.5       cvs       194: #define AMAYA_ASYNC    4       /*0x000100 */
1.11      cvs       195: /*asynchronous request with incremental callbacks */
1.5       cvs       196: #define AMAYA_IASYNC   8       /*0x001000 */
1.11      cvs       197: /* send the form using the POST HTTP method */
1.5       cvs       198: #define AMAYA_FORM_POST 16     /*0x010000 */
1.11      cvs       199: /* send the form using the GET HTTP method */
1.5       cvs       200: #define AMAYA_FORM_GET  32     /*0x100000 */
1.23      cvs       201: /* bypass caching */
                    202: #define AMAYA_NOCACHE  64
                    203: /* don't follow redirections */
                    204: #define AMAYA_NOREDIR  128
1.129     cvs       205: /* post an annonation */
1.136     cvs       206: #define AMAYA_FILE_POST 256
1.48      cvs       207: /* Prevents a stop race condition in ASYNC transfers */
                    208: #define AMAYA_ASYNC_SAFE_STOP  256
1.60      cvs       209: #define AMAYA_LOAD_CSS   512
1.67      cvs       210: #define AMAYA_FLUSH_REQUEST 1024
1.80      cvs       211: #define AMAYA_USE_PRECONDITIONS 2048
1.123     cvs       212: #define AMAYA_LOAD_IMAGE 4096
1.87      cvs       213: 
                    214: /*
                    215:  * Flags to indicate the action to take when the network options
                    216:  * are modified
                    217:  */
                    218: #define AMAYA_CACHE_RESTART 1
                    219: #define AMAYA_PROXY_RESTART 2
1.114     cvs       220: #define AMAYA_LANNEG_RESTART 4
                    221: #define AMAYA_SAFEPUT_RESTART 8
1.87      cvs       222: 
1.26      cvs       223: /*
                    224:  * Flags to indicate the status of the network requests associated
                    225:  * to a document.
                    226:  */
                    227: 
                    228: #define AMAYA_NET_INACTIVE 1
                    229: #define AMAYA_NET_ERROR    2
                    230: #define AMAYA_NET_ACTIVE   4
                    231: 
1.25      cvs       232: /*
                    233:  * Flags for HTParse, specifying which parts of the URL are needed
                    234:  */
                    235: #define AMAYA_PARSE_ACCESS      16  /* Access scheme, e.g. "HTTP" */
                    236: #define AMAYA_PARSE_HOST        8   /* Host name, e.g. "www.w3.org" */
                    237: #define AMAYA_PARSE_PATH        4   /* URL Path, e.g. "pub/WWW/TheProject.html" */
                    238: #define AMAYA_PARSE_ANCHOR      2   /* Fragment identifier, e.g. "news" */
                    239: #define AMAYA_PARSE_PUNCTUATION 1   /* Include delimiters, e.g, "/" and ":" */
                    240: #define AMAYA_PARSE_ALL         31  /* All the parts */
1.1       cvs       241: 
1.149     cvs       242: THOT_EXPORT int          AMAYA;     /* Index of amaya message table */
1.14      cvs       243: THOT_EXPORT int          appArgc;
1.137     cvs       244: THOT_EXPORT CHAR_T**     appArgv;
                    245: THOT_EXPORT CHAR_T       TempFileDirectory[MAX_LENGTH];
1.105     cvs       246: THOT_EXPORT CHAR_T       Answer_text[MAX_LENGTH];
                    247: THOT_EXPORT CHAR_T       Answer_name[NAME_LENGTH];
                    248: THOT_EXPORT CHAR_T       Answer_password[NAME_LENGTH];
                    249: THOT_EXPORT CHAR_T       Display_password[NAME_LENGTH];
                    250: THOT_EXPORT CHAR_T       ScanFilter[NAME_LENGTH]; /* to scan directories    */
1.134     cvs       251: THOT_EXPORT CHAR_T       MathMLEntityName[MAX_LENGTH]; /* entity name typed by the user for a MathML expression */
1.147     cvs       252: THOT_EXPORT CHAR_T       ImgFilter[NAME_LENGTH];
1.137     cvs       253: THOT_EXPORT CHAR_T*      LastURLName;  /* last URL requested               */
                    254: THOT_EXPORT CHAR_T*      DirectoryName;        /* local path of the document       */
                    255: THOT_EXPORT CHAR_T*      DocumentName; /* document name                    */
                    256: THOT_EXPORT CHAR_T*      SavePath;     /* saving path                      */
                    257: THOT_EXPORT CHAR_T*      SaveName;     /* saving name of the document      */
1.105     cvs       258: THOT_EXPORT STRING       ObjectName;   /* document name                    */
                    259: THOT_EXPORT STRING       SaveImgsURL;  /* where to save remote Images      */
                    260: THOT_EXPORT STRING       TargetName;
                    261: THOT_EXPORT STRING       SavingFile;   /* complete path or URL of the document */
1.45      cvs       262: THOT_EXPORT int          Lg_password;
                    263: THOT_EXPORT int          BaseDialog;
1.147     cvs       264: THOT_EXPORT int          BasePrint;
                    265: THOT_EXPORT int          BaseImage;
                    266: THOT_EXPORT int                 MathsDialogue;
                    267: THOT_EXPORT int                 BaseCSS;
1.14      cvs       268: THOT_EXPORT int          ReturnOption;
1.70      cvs       269: THOT_EXPORT int          NumberRows;
                    270: THOT_EXPORT int          NumberCols;
                    271: THOT_EXPORT int          TBorder;
1.69      cvs       272: THOT_EXPORT int          ReturnOptionMenu;
1.14      cvs       273: THOT_EXPORT Document     CurrentDocument;
                    274: THOT_EXPORT Document     SavingDocument;
                    275: THOT_EXPORT Document     SavingObject;
                    276: THOT_EXPORT Document     AttrHREFdocument;
1.45      cvs       277: THOT_EXPORT Document     DocBook;
                    278: THOT_EXPORT Document     IncludedDocument;
1.14      cvs       279: THOT_EXPORT Element      AttrHREFelement;
1.95      cvs       280: THOT_EXPORT STRING       AttrHREFvalue;
1.14      cvs       281: THOT_EXPORT Document     SelectionDoc;
1.113     cvs       282: THOT_EXPORT ThotBool    IsNewAnchor;
1.115     cvs       283: THOT_EXPORT ThotBool    UseLastTarget;
1.116     cvs       284: THOT_EXPORT ThotBool    LinkAsCSS;
1.98      cvs       285: THOT_EXPORT ThotBool    SaveAsHTML;
                    286: THOT_EXPORT ThotBool    SaveAsXHTML;
                    287: THOT_EXPORT ThotBool    SaveAsText;
                    288: THOT_EXPORT ThotBool     CopyImages;   /* should we copy images in Save As */
                    289: THOT_EXPORT ThotBool     UpdateURLs;   /* should we update URLs in Save As */
                    290: THOT_EXPORT ThotBool     UserAnswer;
                    291: THOT_EXPORT ThotBool     InNewWindow;
                    292: THOT_EXPORT ThotBool     SelectionInPRE;
                    293: THOT_EXPORT ThotBool     SelectionInComment;
                    294: THOT_EXPORT ThotBool     SelectionInEM;
                    295: THOT_EXPORT ThotBool     SelectionInSTRONG;
                    296: THOT_EXPORT ThotBool     SelectionInCITE;
                    297: THOT_EXPORT ThotBool     SelectionInABBR;
                    298: THOT_EXPORT ThotBool     SelectionInACRONYM;
                    299: THOT_EXPORT ThotBool     SelectionInINS;
                    300: THOT_EXPORT ThotBool     SelectionInDEL;
                    301: THOT_EXPORT ThotBool     SelectionInDFN;
                    302: THOT_EXPORT ThotBool     SelectionInCODE;
                    303: THOT_EXPORT ThotBool     SelectionInVAR;
                    304: THOT_EXPORT ThotBool     SelectionInSAMP;
                    305: THOT_EXPORT ThotBool     SelectionInKBD;
                    306: THOT_EXPORT ThotBool     SelectionInI;
                    307: THOT_EXPORT ThotBool     SelectionInB;
                    308: THOT_EXPORT ThotBool     SelectionInTT;
                    309: THOT_EXPORT ThotBool     SelectionInBIG;
                    310: THOT_EXPORT ThotBool     SelectionInSMALL;
1.100     cvs       311: THOT_EXPORT ThotBool     SelectionInSub;
                    312: THOT_EXPORT ThotBool     SelectionInSup;
                    313: THOT_EXPORT ThotBool     SelectionInQuote;
                    314: THOT_EXPORT ThotBool     SelectionInBDO;
1.108     cvs       315: THOT_EXPORT ThotBool     HTMLErrorsFound;
1.157     cvs       316: THOT_EXPORT ThotBool     XMLabort;
1.160     cvs       317: THOT_EXPORT FILE*        ErrFile;
                    318: THOT_EXPORT CHAR_T       ErrFileName [80];
1.53      cvs       319: typedef enum
                    320: {
                    321:   docHTML,
1.110     cvs       322:   docHTMLRO,
1.74      cvs       323:   docText,
1.84      cvs       324:   docTextRO,
1.75      cvs       325:   docImage,
1.85      cvs       326:   docImageRO,
                    327:   docCSS,
1.110     cvs       328:   docCSSRO,
                    329:   docSource,
1.127     cvs       330:   docSourceRO,
                    331:   docAnnot,
1.153     cvs       332:   docAnnotRO,
                    333:   docLog
1.53      cvs       334: } DocumentType;
1.64      cvs       335: 
                    336: 
                    337: /* a record for data associated with a request */
                    338: typedef struct _DocumentMetaDataElement
                    339: {
1.162     kahan     340:   CHAR_T*    initial_url;      /* if the server returns a different URL name
1.161     kahan     341:                                  after a redirection, we store here the one
                    342:                                  that the browser first asked */
1.137     cvs       343:   CHAR_T*    form_data;        /* form data associated with a URL               */
1.135     cvs       344:   ClickEvent method;           /* method used to send this data                 */
                    345:   ThotBool   put_default_name; /* URL name was concatenated with DEFAULT_NAME   */
                    346:   ThotBool   xmlformat;        /* the document should be exported in xml format */
1.144     kahan     347: #ifdef ANNOTATIONS
                    348:   Document   source_doc;       /* if the document is an annotation,
                    349:                                  this variable giveso the annoted document
                    350:                                  docid */
                    351: #endif /* ANNOTATIONS */
1.64      cvs       352: } DocumentMetaDataElement;
                    353: 
1.1       cvs       354: #define DocumentTableLength 10
1.110     cvs       355: /* URL of each loaded document */
1.137     cvs       356: THOT_EXPORT CHAR_T* DocumentURLs[DocumentTableLength];
1.64      cvs       357: /* Any formdata associated with a URL */
                    358: THOT_EXPORT DocumentMetaDataElement *DocumentMeta[DocumentTableLength];
1.110     cvs       359: /* Type of document */
1.53      cvs       360: THOT_EXPORT DocumentType DocumentTypes[DocumentTableLength];
1.110     cvs       361: /* identifier of the document displaying the source code */
                    362: THOT_EXPORT Document DocumentSource[DocumentTableLength];
                    363: /* The whole document is loaded when the corresponding entry in FilesLoading is 0 */
1.14      cvs       364: THOT_EXPORT int          FilesLoading[DocumentTableLength];
1.110     cvs       365: /* Status (error, success) of the download of the objects of a document */
                    366: THOT_EXPORT int          DocNetworkStatus[DocumentTableLength];
1.156     cvs       367: /* Status of the XHTML document (basic, strict, transitional) */
                    368: THOT_EXPORT int          ParsingLevel[DocumentTableLength];
1.42      cvs       369: 
1.14      cvs       370: THOT_EXPORT Document     W3Loading;    /* the document being loaded */
1.65      cvs       371: THOT_EXPORT Document     BackupDocument;       /* the current backup */
1.104     cvs       372: 
                    373: /* button indexes */
                    374: THOT_EXPORT int iStop;
                    375: THOT_EXPORT int iBack;
                    376: THOT_EXPORT int iForward;
                    377: THOT_EXPORT int iReload;
                    378: THOT_EXPORT int iHome;
                    379: THOT_EXPORT int iEditor;
                    380: THOT_EXPORT int iSave;
                    381: THOT_EXPORT int iPrint;
                    382: THOT_EXPORT int iFind;
                    383: THOT_EXPORT int iI;
                    384: THOT_EXPORT int iB;
                    385: THOT_EXPORT int iT;
                    386: THOT_EXPORT int iImage;
                    387: THOT_EXPORT int iH1;
                    388: THOT_EXPORT int iH2;
                    389: THOT_EXPORT int iH3;
                    390: THOT_EXPORT int iBullet;
                    391: THOT_EXPORT int iNum;
                    392: THOT_EXPORT int iDL;
                    393: THOT_EXPORT int iLink;
                    394: THOT_EXPORT int iTable;
1.5       cvs       395: 
1.64      cvs       396: #define IMAGE_NOT_LOADED        0
1.1       cvs       397: #define IMAGE_LOCAL            1
                    398: #define IMAGE_LOADED           2
                    399: #define IMAGE_MODIFIED         3
                    400: 
1.109     cvs       401: 
1.27      cvs       402: #ifdef __STDC__
1.137     cvs       403: typedef void (*LoadedImageCallback)(Document doc, Element el, CHAR_T* file, void *extra);
1.27      cvs       404: #else
                    405: typedef void (*LoadedImageCallback)();
                    406: #endif
1.109     cvs       407: 
1.5       cvs       408: typedef struct _ElemImage
                    409:   {
1.27      cvs       410:      Element             currentElement;/* first element using this image */
1.5       cvs       411:      struct _ElemImage  *nextElement;
1.27      cvs       412:      LoadedImageCallback callback;     /* Callback for non-standard handling */
                    413:      void              *extra;         /* any extra info for the CallBack */
1.5       cvs       414:   }
                    415: ElemImage;
                    416: 
                    417: typedef struct _LoadedImageDesc
                    418:   {
1.105     cvs       419:      STRING          originalName;     /* complete URL of the image                */
                    420:      STRING          localName;        /* local name (without path) of the image   */
1.58      cvs       421:      struct _LoadedImageDesc *prevImage;/* double linked list                       */
                    422:      struct _LoadedImageDesc *nextImage;/* easier to unchain                        */
                    423:      Document            document;     /* document concerned                       */
                    424:      struct _ElemImage  *elImage;      /* first element using this image           */
                    425:      int                 imageType;     /* the type of the image                    */
                    426:      int                 status;       /* the status of the image loading          */
1.5       cvs       427:   }
                    428: LoadedImageDesc;
1.109     cvs       429: 
                    430: /* the structure used for storing the context of the 
                    431:    FetchAndDisplayImages_callback function */
                    432: typedef struct _FetchImage_context {
                    433:   STRING base_url;
                    434:   LoadedImageDesc    *desc;
                    435: } FetchImage_context;
                    436: 
1.5       cvs       437: 
1.14      cvs       438: THOT_EXPORT LoadedImageDesc *ImageURLs;
1.31      cvs       439: THOT_EXPORT LoadedImageDesc *ImageLocal;
1.1       cvs       440: 
1.88      cvs       441: /* The default Amaya HOME pages (page shown at boot time */
                    442: 
1.137     cvs       443: #ifdef _WINDOWS
                    444: #      define AMAYA_PAGE  TEXT("\\amaya\\AmayaPage.html")
                    445: #else  /* !_WINDOWS */
                    446: #      define AMAYA_PAGE  TEXT("/amaya/AmayaPage.html")
                    447: #endif /* !_WINDOWS */
                    448: 
                    449: #define   AMAYA_PAGE_DOC  TEXT("http://www.w3.org/Amaya/User/")
                    450: 
                    451: #ifndef MAX_TXT_LEN
                    452: #define MAX_TXT_LEN 1024       /* Max. length of strings */
                    453: #endif  /* MAX_TXT_LEN */
1.88      cvs       454: 
1.25      cvs       455: #endif /* AMAYA_H */

Webmaster