/[public]/psiconv/trunk/lib/psiconv/data.h
ViewVC logotype

Contents of /psiconv/trunk/lib/psiconv/data.h

Parent Directory Parent Directory | Revision Log Revision Log


Revision 94 - (show annotations)
Wed Jan 17 00:05:08 2001 UTC (23 years, 2 months ago) by frodo
File MIME type: text/plain
File size: 17809 byte(s)
(Frodo) Start of Sheet support: base types defined, page and status section
        parsed, supporting definitions in data.c

1 /*
2 data.h - Part of psiconv, a PSION 5 file formats converter
3 Copyright (c) 1999, 2000 Frodo Looijaard <frodol@dds.nl>
4
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 2 of the License, or
8 (at your option) any later version.
9
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
14
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
18 */
19
20 /* This file contains the declarations of all types that are used to
21 represent the Word file. Variables of these types are written by the
22 parse routines, and read by the generation routines. */
23
24 #ifndef PSICONV_DATA_H
25 #define PSICONV_DATA_H
26
27 #include <psiconv/general.h>
28 #include <psiconv/list.h>
29
30 /* All types which end on _t are plain types; all other types are pointers
31 to structs */
32
33 #ifdef __cplusplus
34 extern "C" {
35 #endif /* __cplusplus */
36
37
38 typedef enum psiconv_file_type {
39 psiconv_unknown_file,
40 psiconv_word_file,
41 psiconv_texted_file,
42 psiconv_mbm_file,
43 psiconv_sketch_file,
44 psiconv_clipart_file,
45 psiconv_sheet_file
46 } psiconv_file_type_t;
47
48 /* Length indicators */
49 typedef psiconv_u32 psiconv_S_t;
50 typedef psiconv_u32 psiconv_X_t;
51
52 /* A string */
53 typedef char *psiconv_string_t;
54
55 /* In the Psion file, these are identical; but we translate them to more
56 human-readable quantities */
57 typedef float psiconv_length_t; /* For offsets in centimeters */
58 typedef float psiconv_size_t; /* For sizes in points */
59
60 /* Some enums */
61 typedef enum psiconv_bool
62 {
63 psiconv_bool_false,
64 psiconv_bool_true
65 } psiconv_bool_t;
66
67 typedef enum psiconv_triple
68 {
69 psiconv_triple_on,
70 psiconv_triple_off,
71 psiconv_triple_auto
72 } psiconv_triple_t;
73
74 typedef enum psiconv_super_sub
75 { psiconv_normalscript,
76 psiconv_superscript,
77 psiconv_subscript
78 } psiconv_super_sub_t;
79
80 typedef enum psiconv_justify_hor
81 { psiconv_justify_left,
82 psiconv_justify_centre,
83 psiconv_justify_right,
84 psiconv_justify_full
85 } psiconv_justify_hor_t;
86
87 typedef enum psiconv_justify_ver
88 { psiconv_justify_top,
89 psiconv_justify_middle,
90 psiconv_justify_bottom
91 } psiconv_justify_ver_t;
92
93 typedef enum psiconv_border_kind
94 { psiconv_border_none,
95 psiconv_border_solid,
96 psiconv_border_double,
97 psiconv_border_dotted,
98 psiconv_border_dashed,
99 psiconv_border_dotdashed,
100 psiconv_border_dotdotdashed
101 } psiconv_border_kind_t;
102
103 typedef enum psiconv_screenfont
104 {
105 psiconv_font_misc,
106 psiconv_font_sansserif,
107 psiconv_font_nonprop,
108 psiconv_font_serif
109 } psiconv_screenfont_t;
110
111 /* Colors.
112 black: 0x00 0x00 0x00
113 white: 0xff 0xff 0xff */
114 typedef struct psiconv_color_s
115 {
116 psiconv_u8 red;
117 psiconv_u8 green;
118 psiconv_u8 blue;
119 } * psiconv_color;
120
121 typedef struct psiconv_font_s
122 {
123 char *name;
124 psiconv_screenfont_t screenfont;
125 } *psiconv_font;
126
127 typedef struct psiconv_border_s
128 {
129 psiconv_border_kind_t kind;
130 psiconv_size_t thickness; /* Set to 1/20 for non-solid lines */
131 psiconv_color color;
132 } *psiconv_border;
133
134 typedef struct psiconv_bullet_s
135 {
136 psiconv_bool_t on;
137 psiconv_size_t font_size;
138 psiconv_u8 character;
139 psiconv_bool_t indent;
140 psiconv_color color;
141 psiconv_font font;
142 } *psiconv_bullet;
143
144 typedef enum psiconv_tab_kind
145 {
146 psiconv_tab_left,
147 psiconv_tab_centre,
148 psiconv_tab_right
149 } psiconv_tab_kind_t;
150
151 typedef struct psiconv_tab_s
152 {
153 psiconv_length_t location;
154 psiconv_tab_kind_t kind;
155 } *psiconv_tab;
156
157
158 typedef psiconv_list psiconv_tab_list; /* of struct psiconv_tab */
159
160 typedef struct psiconv_all_tabs_s
161 {
162 psiconv_length_t normal;
163 psiconv_tab_list extras;
164 } *psiconv_all_tabs;
165
166 typedef struct psiconv_character_layout_s
167 {
168 psiconv_color color;
169 psiconv_color back_color;
170 psiconv_size_t font_size;
171 psiconv_bool_t italic;
172 psiconv_bool_t bold;
173 psiconv_super_sub_t super_sub;
174 psiconv_bool_t underline;
175 psiconv_bool_t strikethrough;
176 psiconv_font font;
177 } *psiconv_character_layout;
178
179 typedef struct psiconv_paragraph_layout_s
180 {
181 psiconv_color back_color;
182 psiconv_length_t indent_left;
183 psiconv_length_t indent_right;
184 psiconv_length_t indent_first;
185 psiconv_justify_hor_t justify_hor;
186 psiconv_justify_ver_t justify_ver;
187 psiconv_size_t linespacing;
188 psiconv_bool_t linespacing_exact;
189 psiconv_size_t space_above;
190 psiconv_size_t space_below;
191 psiconv_bool_t keep_together;
192 psiconv_bool_t keep_with_next;
193 psiconv_bool_t on_next_page;
194 psiconv_bool_t no_widow_protection;
195 psiconv_length_t border_distance;
196 psiconv_bullet bullet;
197 psiconv_border left_border;
198 psiconv_border right_border;
199 psiconv_border top_border;
200 psiconv_border bottom_border;
201 psiconv_all_tabs tabs;
202 } *psiconv_paragraph_layout;
203
204 typedef struct psiconv_header_section_s
205 {
206 psiconv_u32 uid1;
207 psiconv_u32 uid2;
208 psiconv_u32 uid3;
209 psiconv_u32 checksum;
210 psiconv_file_type_t file;
211 } *psiconv_header_section;
212
213 typedef struct psiconv_section_table_entry_s
214 {
215 psiconv_u32 id;
216 psiconv_u32 offset;
217 } *psiconv_section_table_entry;
218
219 typedef psiconv_list psiconv_section_table_section;
220 /* Of struct sectiontable_entry */
221
222 typedef struct psiconv_application_id_section_s
223 {
224 psiconv_u32 id;
225 psiconv_string_t name;
226 } *psiconv_application_id_section;
227
228 typedef struct psiconv_in_line_layout_s
229 {
230 psiconv_character_layout layout;
231 int length;
232 } *psiconv_in_line_layout;
233
234 typedef psiconv_list psiconv_in_line_layouts; /* of struct in_line_layout */
235
236 typedef enum psiconv_replacement_type
237 {
238 psiconv_replace_time,
239 psiconv_replace_date,
240 psiconv_replace_pagenr,
241 psiconv_replace_nr_of_pages,
242 psiconv_replace_filename
243 } psiconv_replacement_type_t;
244
245 typedef struct psiconv_replacement_s
246 {
247 int offset;
248 int cur_len;
249 psiconv_replacement_type_t type;
250 } *psiconv_replacement;
251
252 typedef psiconv_list psiconv_replacements; /* of struct replacement */
253
254 typedef struct psiconv_paragraph_s
255 {
256 char *text;
257 psiconv_character_layout base_character;
258 psiconv_paragraph_layout base_paragraph;
259 psiconv_s16 base_style;
260 psiconv_in_line_layouts in_lines;
261 psiconv_replacements replacements;
262 } *psiconv_paragraph;
263
264 typedef psiconv_list psiconv_text_and_layout; /* Of struct paragraphs */
265
266 typedef struct psiconv_texted_section_s
267 {
268 psiconv_text_and_layout paragraphs;
269 } *psiconv_texted_section;
270
271 typedef struct psiconv_page_header_s
272 {
273 psiconv_bool_t on_first_page;
274 psiconv_paragraph_layout base_paragraph_layout;
275 psiconv_character_layout base_character_layout;
276 psiconv_texted_section text;
277 } *psiconv_page_header;
278
279 typedef struct psiconv_page_layout_section_s
280 {
281 psiconv_u32 first_page_nr;
282 psiconv_length_t header_dist;
283 psiconv_length_t footer_dist;
284 psiconv_length_t left_margin;
285 psiconv_length_t right_margin;
286 psiconv_length_t top_margin;
287 psiconv_length_t bottom_margin;
288 psiconv_length_t page_width;
289 psiconv_length_t page_height;
290 psiconv_page_header header;
291 psiconv_page_header footer;
292 psiconv_bool_t landscape;
293 } * psiconv_page_layout_section;
294
295 typedef struct psiconv_word_status_section_s
296 {
297 psiconv_bool_t show_tabs;
298 psiconv_bool_t show_spaces;
299 psiconv_bool_t show_paragraph_ends;
300 psiconv_bool_t show_line_breaks;
301 psiconv_bool_t show_hard_minus;
302 psiconv_bool_t show_hard_space;
303 psiconv_bool_t show_full_pictures;
304 psiconv_bool_t show_full_graphs;
305 psiconv_bool_t show_top_toolbar;
306 psiconv_bool_t show_side_toolbar;
307 psiconv_bool_t fit_lines_to_screen;
308 psiconv_u32 cursor_position;
309 psiconv_u32 display_size;
310 } *psiconv_word_status_section;
311
312 typedef struct psiconv_word_style_s
313 {
314 psiconv_character_layout character;
315 psiconv_paragraph_layout paragraph;
316 psiconv_u8 hotkey;
317 psiconv_string_t name;
318 psiconv_bool_t built_in;
319 psiconv_u32 outline_level;
320 } *psiconv_word_style;
321
322 typedef psiconv_list psiconv_word_style_list; /* Of style */
323
324 typedef struct psiconv_word_styles_section_s
325 {
326 psiconv_word_style normal;
327 psiconv_word_style_list styles;
328 } *psiconv_word_styles_section;
329
330 typedef struct psiconv_word_f_s
331 {
332 psiconv_page_layout_section page_sec;
333 psiconv_text_and_layout paragraphs;
334 psiconv_word_status_section status_sec;
335 psiconv_word_styles_section styles_sec;
336 } *psiconv_word_f;
337
338 typedef struct psiconv_texted_f_s
339 {
340 psiconv_page_layout_section page_sec;
341 psiconv_texted_section texted_sec;
342 } *psiconv_texted_f;
343
344 typedef psiconv_list psiconv_jumptable_section; /* of psiconv_u32 */
345
346 /* Normalized values [0..1] for each component
347 Origin is (x,y)=(0,0), to get pixel at (X,Y) use index [Y*xsize+X] */
348 typedef struct psiconv_paint_data_section_s
349 {
350 psiconv_u32 xsize;
351 psiconv_u32 ysize;
352 psiconv_length_t pic_xsize; /* 0 if not specified */
353 psiconv_length_t pic_ysize; /* 0 if not specified */
354 float *red;
355 float *green;
356 float *blue;
357 } *psiconv_paint_data_section;
358
359 typedef psiconv_list psiconv_pictures;
360 /* of struct psiconv_paint_data_section */
361
362 typedef struct psiconv_mbm_f_s
363 {
364 psiconv_pictures sections;
365 } *psiconv_mbm_f;
366
367 /* This is a little intricated. A picture may be embedded in a larger form.
368 A form is empty, except for the picture. The form has size form_{x,y}size,
369 and the picture is at offset picture_{x,y}_offset within the form. The
370 picture itself has size picture_{x,y}size.
371 Cuts are always <= 1.0; a cut of 0.0 cuts nothing away, a cut of 1.0
372 cuts everything away. */
373 typedef struct psiconv_sketch_section_s
374 {
375 psiconv_u16 form_xsize;
376 psiconv_u16 form_ysize;
377 psiconv_u16 picture_x_offset;
378 psiconv_u16 picture_y_offset;
379 psiconv_u16 picture_xsize;
380 psiconv_u16 picture_ysize;
381 float magnification_x; /* computed relative to first six values */
382 float magnification_y; /* computed relative to first six values */
383 float cut_left; /* computed relative to first six values */
384 float cut_right; /* computed relative to first six values */
385 float cut_top; /* computed relative to first six values */
386 float cut_bottom; /* computed relative to first six values */
387 psiconv_paint_data_section picture;
388 } *psiconv_sketch_section;
389
390 typedef struct psiconv_sketch_f_s
391 {
392 psiconv_sketch_section sketch_sec;
393 } *psiconv_sketch_f;
394
395 typedef struct psiconv_clipart_section_s
396 {
397 /* Perhaps later on some currently unknown stuff. */
398 psiconv_paint_data_section picture;
399 } * psiconv_clipart_section;
400
401 typedef psiconv_list psiconv_cliparts; /* of struct psiconv_clipart_section */
402
403 typedef struct psiconv_clipart_f_s
404 {
405 psiconv_cliparts sections;
406 } *psiconv_clipart_f;
407
408 typedef struct psiconv_sheet_status_section_s
409 {
410 psiconv_bool_t show_graph;
411 psiconv_u32 cursor_row;
412 psiconv_u32 cursor_column;
413 psiconv_bool_t show_top_sheet_toolbar;
414 psiconv_bool_t show_side_sheet_toolbar;
415 psiconv_bool_t show_top_graph_toolbar;
416 psiconv_bool_t show_side_graph_toolbar;
417 psiconv_u32 sheet_display_size;
418 psiconv_u32 graph_display_size;
419 psiconv_triple_t show_horizontal_scrollbar;
420 psiconv_triple_t show_vertical_scrollbar;
421 } *psiconv_sheet_status_section;
422
423 typedef struct psiconv_sheet_f_s
424 {
425 psiconv_page_layout_section page_sec;
426 psiconv_sheet_status_section status_sec;
427 } *psiconv_sheet_f;
428
429 typedef struct psiconv_file_s
430 {
431 psiconv_file_type_t type;
432 void *file;
433 } *psiconv_file;
434
435
436 /* UID1 */
437 #define PSICONV_ID_PSION5 0x10000037
438 #define PSICONV_ID_CLIPART 0x10000041
439 /* UID2 */
440 #define PSICONV_ID_DATA_FILE 0x1000006D
441 #define PSICONV_ID_MBM_FILE 0x10000042
442 /* UID3 */
443 #define PSICONV_ID_WORD 0x1000007F
444 #define PSICONV_ID_TEXTED 0x10000085
445 #define PSICONV_ID_SKETCH 0x1000007D
446 #define PSICONV_ID_SHEET 0x10000088
447
448 /* Section table ids */
449 #define PSICONV_ID_WORD_STATUS_SECTION 0x10000243
450 #define PSICONV_ID_APPL_ID_SECTION 0x10000089
451 #define PSICONV_ID_TEXT_SECTION 0x10000106
452 #define PSICONV_ID_LAYOUT_SECTION 0x10000143
453 #define PSICONV_ID_WORD_STYLES_SECTION 0x10000104
454 #define PSICONV_ID_PAGE_LAYOUT_SECTION 0x10000105
455 #define PSICONV_ID_PASSWORD_SECTION 0x100000CD
456 #define PSICONV_ID_SKETCH_SECTION 0x1000007D
457 #define PSICONV_ID_SHEET_STATUS_SECTION 0x1000011F
458
459 /* Other ids */
460 #define PSICONV_ID_PAGE_DIMENSIONS1 0x100000fd
461 #define PSICONV_ID_PAGE_DIMENSIONS2 0x1000010e
462 #define PSICONV_ID_TEXTED_BODY 0x1000005c
463 #define PSICONV_ID_TEXTED_REPLACEMENT 0x10000063
464 #define PSICONV_ID_TEXTED_UNKNOWN 0x10000065
465 #define PSICONV_ID_TEXTED_LAYOUT 0x10000066
466 #define PSICONV_ID_TEXTED_TEXT 0x10000064
467 #define PSICONV_ID_STYLE_REMOVABLE 0x1000004F
468 #define PSICONV_ID_STYLE_BUILT_IN 0x1000004C
469 #define PSICONV_ID_CLIPART_ITEM 0x10000040
470
471
472 /* Return a clean layout_status. You can modify it at will. Returns NULL
473 if there is not enough memory. */
474 extern psiconv_character_layout psiconv_basic_character_layout(void);
475
476 /* Return a clean layout_status. You can modify it at will. Returns NULL
477 if there is not enough memory. */
478 extern psiconv_paragraph_layout psiconv_basic_paragraph_layout(void);
479
480 /* Clone a layout_status: the new copy is completely independent of the
481 original one. Returns NULL if there is not enough memory. */
482 extern psiconv_paragraph_layout psiconv_clone_paragraph_layout
483 (psiconv_paragraph_layout ls);
484
485 extern psiconv_character_layout psiconv_clone_character_layout
486 (psiconv_character_layout ls);
487
488 /* Get a numbered style. Returns NULL if the style is unknown. */
489 extern psiconv_word_style psiconv_get_style (psiconv_word_styles_section ss, int nr);
490
491 extern void psiconv_free_color(psiconv_color color);
492 extern void psiconv_free_border(psiconv_border border);
493 extern void psiconv_free_bullet(psiconv_bullet bullet);
494 extern void psiconv_free_font(psiconv_font font);
495 extern void psiconv_free_tab(psiconv_tab tab);
496 extern void psiconv_free_tabs(psiconv_all_tabs tabs);
497 extern void psiconv_free_paragraph_layout(psiconv_paragraph_layout layout);
498 extern void psiconv_free_character_layout(psiconv_character_layout layout);
499 extern void psiconv_free_word_style(psiconv_word_style style);
500 extern void psiconv_free_word_styles_section
501 (psiconv_word_styles_section styles);
502 extern void psiconv_free_sheet_status_section
503 (psiconv_sheet_status_section section);
504 extern void psiconv_free_sheet_f(psiconv_sheet_f file);
505 extern void psiconv_free_header_section(psiconv_header_section header);
506 extern void psiconv_free_section_table_entry(psiconv_section_table_entry entry);
507 extern void psiconv_free_section_table_section
508 (psiconv_section_table_section section);
509 extern void psiconv_free_application_id_section
510 (psiconv_application_id_section section);
511 extern void psiconv_free_in_line_layout(psiconv_in_line_layout layout);
512 extern void psiconv_free_in_line_layouts(psiconv_in_line_layouts layouts);
513 extern void psiconv_free_replacement(psiconv_replacement replacement);
514 extern void psiconv_free_replacements(psiconv_replacements replacements);
515 extern void psiconv_free_paragraph(psiconv_paragraph paragraph);
516 extern void psiconv_free_text_and_layout(psiconv_text_and_layout text);
517 extern void psiconv_free_texted_section(psiconv_texted_section section);
518 extern void psiconv_free_page_header(psiconv_page_header header);
519 extern void psiconv_free_page_layout_section
520 (psiconv_page_layout_section section);
521 extern void psiconv_free_word_status_section
522 (psiconv_word_status_section section);
523 extern void psiconv_free_word_f(psiconv_word_f file);
524 extern void psiconv_free_texted_f(psiconv_texted_f file);
525 extern void psiconv_free_paint_data_section(psiconv_paint_data_section section);
526 extern void psiconv_free_pictures(psiconv_pictures section);
527 extern void psiconv_free_jumptable_section
528 (psiconv_jumptable_section section);
529 extern void psiconv_free_mbm_f(psiconv_mbm_f file);
530 extern void psiconv_free_sketch_section(psiconv_sketch_section sec);
531 extern void psiconv_free_sketch_f(psiconv_sketch_f file);
532 extern void psiconv_free_clipart_section(psiconv_clipart_section section);
533 extern void psiconv_free_cliparts(psiconv_cliparts section);
534 extern void psiconv_free_clipart_f(psiconv_clipart_f file);
535
536 extern void psiconv_free_file(psiconv_file file);
537
538 extern int psiconv_compare_color(const psiconv_color value1,
539 const psiconv_color value2);
540 extern int psiconv_compare_font(const psiconv_font value1,
541 const psiconv_font value2);
542 extern int psiconv_compare_border(const psiconv_border value1,
543 const psiconv_border value2);
544 extern int psiconv_compare_bullet(const psiconv_bullet value1,
545 const psiconv_bullet value2);
546 extern int psiconv_compare_tab(const psiconv_tab value1,
547 const psiconv_tab value2);
548 extern int psiconv_compare_all_tabs(const psiconv_all_tabs value1,
549 const psiconv_all_tabs value2);
550 extern int psiconv_compare_paragraph_layout
551 (const psiconv_paragraph_layout value1,
552 const psiconv_paragraph_layout value2);
553
554 extern int psiconv_compare_character_layout
555 (const psiconv_character_layout value1,
556 const psiconv_character_layout value2);
557
558 /* Get a newly allocated file with sensible defaults, ready to generate. */
559 extern psiconv_file psiconv_empty_file(psiconv_file_type_t type);
560
561
562 #ifdef __cplusplus
563 }
564 #endif /* __cplusplus */
565
566 #endif /* def PSICONV_DATA_H */

frodo@frodo.looijaard.name
ViewVC Help
Powered by ViewVC 1.1.26