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
|
#ifndef MUPDF_FITZ_OUTPUT_H
#define MUPDF_FITZ_OUTPUT_H
#include "mupdf/fitz/system.h"
#include "mupdf/fitz/context.h"
#include "mupdf/fitz/buffer.h"
#include "mupdf/fitz/string.h"
/*
Generic output streams - generalise between outputting to a file,
a buffer, etc.
*/
typedef struct fz_output_s fz_output;
/*
fz_new_output_with_file: Open an output stream that writes to a FILE *.
fz_new_output_with_path: Open an output stream that writes to a file.
fz_new_output_with_buffer: Open an output stream that writes into a buffer.
*/
fz_output *fz_new_output_with_file_ptr(fz_context *, FILE *, int close);
fz_output *fz_new_output_with_path(fz_context *, const char *filename, int append);
fz_output *fz_new_output_with_buffer(fz_context *, fz_buffer *);
/*
fz_write: fwrite equivalent for output streams.
fz_printf: fprintf equivalent for output streams. See fz_snprintf.
fz_vprintf: vfprintf equivalent for output streams. See fz_vsnprintf.
fz_puts: fputs equivalent for output streams.
fz_putc: fputc equivalent for output streams.
fz_putrune: fputrune equivalent for output streams.
*/
void fz_printf(fz_context *ctx, fz_output *out, const char *fmt, ...);
void fz_vprintf(fz_context *ctx, fz_output *out, const char *fmt, va_list ap);
int fz_write(fz_context *, fz_output *out, const void *data, int len);
#define fz_puts(C,O,S) fz_write(C, O, (S), strlen(S))
#define fz_putc(C,O,B) fz_write_byte(C, O, B)
#define fz_putrune(C,O,R) fz_write_rune(C, O, R)
/*
fz_seek_output: Seek to the specified file position. Throw an error on unseekable outputs.
fz_tell_output: Return the current file position. Throw an error on unseekable outputs.
*/
void fz_seek_output(fz_context *ctx, fz_output *out, fz_off_t off, int whence);
fz_off_t fz_tell_output(fz_context *ctx, fz_output *out);
/*
fz_drop_output: Close and free an output stream.
*/
void fz_drop_output(fz_context *, fz_output *);
/*
fz_write_int32be: Write a big-endian 32-bit binary integer.
fz_write_int32le: Write a little-endian 32-bit binary integer.
fz_write_byte: Write a single byte.
fz_write_rune: Write a UTF-8 encoded unicode character.
*/
static inline int fz_write_int32be(fz_context *ctx, fz_output *out, int x)
{
char data[4];
data[0] = x>>24;
data[1] = x>>16;
data[2] = x>>8;
data[3] = x;
return fz_write(ctx, out, data, 4);
}
static inline int fz_write_int32le(fz_context *ctx, fz_output *out, int x)
{
char data[4];
data[0] = x;
data[1] = x>>8;
data[2] = x>>16;
data[3] = x>>24;
return fz_write(ctx, out, data, 4);
}
static inline void fz_write_byte(fz_context *ctx, fz_output *out, int x)
{
char data = x;
fz_write(ctx, out, &data, 1);
}
static inline void fz_write_rune(fz_context *ctx, fz_output *out, int rune)
{
char data[10];
fz_write(ctx, out, data, fz_runetochar(data, rune));
}
/*
fz_vsnprintf: Our customised vsnprintf routine. Takes %c, %d, %o, %s, %u, %x, as usual.
Modifiers are not supported except for zero-padding ints (e.g. %02d, %03o, %04x, etc).
%f and %g both output in "as short as possible hopefully lossless non-exponent" form,
see fz_ftoa for specifics.
%C outputs a utf8 encoded int.
%M outputs a fz_matrix*. %R outputs a fz_rect*. %P outputs a fz_point*.
%q and %( output escaped strings in C/PDF syntax.
%ll{d,u,x} indicates that the values are 64bit.
%z{d,u,x} indicates that the value is a size_t.
%Z{d,u,x} indicates that the value is a fz_off_t.
*/
int fz_vsnprintf(char *buffer, int space, const char *fmt, va_list args);
int fz_snprintf(char *buffer, int space, const char *fmt, ...);
/*
fz_tempfilename: Get a temporary filename based upon 'base'.
'hint' is the path of a file (normally the existing document file)
supplied to give the function an idea of what directory to use. This
may or may not be used depending on the implementations whim.
The returned path must be freed.
*/
char *fz_tempfilename(fz_context *ctx, const char *base, const char *hint);
#endif
|
