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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
|
/* libfo
* libfo-version.c: libfo version
*
* Copyright (C) 2008 Menteith Consulting Ltd
*
* Inspired by Pango and Cairo version APIs.
*
* See COPYING for the status of this software.
*/
#include <config.h>
#include <libfo/fo-utils.h>
#include "libfo/libfo-features.h"
#include "libfo/libfo-version.h"
#include "libfo/fo-libfo-module.h"
#if ENABLE_CAIRO
#include <libfo/fo-doc-cairo.h>
#endif
#if ENABLE_GP
#include <libfo/fo-doc-gp.h>
#endif
#include "libfo/fo-xsl-formatter.h"
#include "libfo/fo-xslt-transformer.h"
#include "libfo/fo-xml-doc.h"
/**
* libfo_version:
*
* This is similar to the macro %LIBFO_VERSION except that it returns
* the encoded version of libfo available at run-time, as opposed
* to the version available at compile-time.
*
* A version number can be encoded into an integer using
* LIBFO_VERSION_ENCODE().
*
* Returns value: The encoded version of libfo library
* available at run time.
**/
int
libfo_version (void)
{
return LIBFO_VERSION;
}
/**
* libfo_version_string:
*
* This is similar to the macro %LIBFO_VERSION_STRING except that it
* returns the version of libfo available at run-time, as opposed
* to the version available at compile-time.
*
* Returns value: A string containing the version of libfo library
* available at run time.
* The returned string is owned by libfo and should not be modified
* or freed.
**/
const char *
libfo_version_string (void)
{
return LIBFO_VERSION_STRING;
}
/**
* libfo_version_check:
* @required_major: the required major version.
* @required_minor: the required minor version.
* @required_micro: the required major version.
*
* Checks that the libfo library in use is compatible with the
* given version. Generally you would pass in the constants
* %LIBFO_VERSION_MAJOR, %LIBFO_VERSION_MINOR, %LIBFO_VERSION_MICRO as the
* three arguments to this function; that produces a check that the
* library in use at run-time is compatible with the version of
* libfo the application or module was compiled against.
*
* Compatibility is defined by two things: first the version
* of the running library is newer than the version
* @required_major.required_minor.@required_micro. Second
* the running library must be binary compatible with the
* version @required_major.required_minor.@required_micro
* (same major version.)
*
* For compile-time version checking use LIBFO_VERSION_CHECK().
*
* Return value: %NULL if the libfo library is compatible with the
* given version, or a string describing the version mismatch. The
* returned string is owned by libfo and should not be modified
* or freed.
**/
const char*
libfo_version_check (int required_major,
int required_minor,
int required_micro)
{
gint libfo_effective_micro = 100 * XMLROFF_VERSION_MINOR + XMLROFF_VERSION_MICRO;
gint required_effective_micro = 100 * required_minor + required_micro;
if (required_major < XMLROFF_VERSION_MAJOR)
return "libfo version too new (major mismatch)";
if (required_effective_micro < libfo_effective_micro - XMLROFF_BINARY_AGE)
return "libfo version too new (micro mismatch)";
if (required_effective_micro > libfo_effective_micro)
return "libfo version too old (micro mismatch)";
return NULL;
}
/**
* libfo_pixels_per_inch:
*
* This is similar to the macro %LIBFO_PIXELS_PER_INCH except that it
* returns the encoded pixels per inch of libfo available at run-time,
* as opposed to the pixels per inch available at compile-time.
*
* Returns value: The encoded pixels per inch of libfo library
* available at run time.
**/
int
libfo_pixels_per_inch (void)
{
return PIXELS_PER_INCH;
}
enum {
#if ENABLE_CAIRO
CAIRO_INFO,
#endif
#if ENABLE_GP
GP_INFO,
#endif
FORMATTER_INFO,
XSLT_INFO,
XML_DOC_INFO,
NULL_INFO,
INFO_LIMIT
};
/**
* libfo_version_get_info:
*
* Gets the #LibfoVersionInfo of libfo components.
*
* Returns: Array of pointers to #LibfoVersionInfo. The last item is %NULL.
**/
const LibfoVersionInfo **
libfo_version_get_info (void)
{
static const LibfoVersionInfo * backend_info[INFO_LIMIT];
if (backend_info[0] == NULL)
{
#if ENABLE_CAIRO
backend_info[CAIRO_INFO] =
fo_libfo_module_version_info_from_name (g_type_name (fo_doc_cairo_get_type ()));
#endif
#if ENABLE_GP
backend_info[GP_INFO] =
fo_libfo_module_version_info_from_name (g_type_name (fo_doc_gp_get_type ()));
#endif
backend_info[FORMATTER_INFO] =
fo_libfo_module_version_info_from_name (g_type_name (fo_xsl_formatter_get_type ()));
backend_info[XSLT_INFO] =
fo_xslt_transformer_version_info ();
backend_info[XML_DOC_INFO] =
fo_xml_doc_version_info ();
}
return &backend_info[0];
}
|
