summaryrefslogtreecommitdiff
path: root/include/mupdf/fitz/output.h
blob: e7179a3b8808736a8c76573e2786011a631e51b7 (plain)
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
#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;

struct fz_output_s
{
	void *opaque;
	void (*write)(fz_context *, void *opaque, const void *, int n);
	void (*seek)(fz_context *, void *opaque, fz_off_t off, int whence);
	fz_off_t (*tell)(fz_context *, void *opaque);
	void (*close)(fz_context *, void *opaque);
};

/*
	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);
#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: Write data to output.
*/

static inline void fz_write(fz_context *ctx, fz_output *out, const void *data, int size)
{
	out->write(ctx, out->opaque, data, size);
}

/*
	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 void 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;

	fz_write(ctx, out, data, 4);
}

static inline void 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;

	fz_write(ctx, out, data, 4);
}

static inline void fz_write_byte(fz_context *ctx, fz_output *out, unsigned char x)
{
	fz_write(ctx, out, &x, 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