~ubuntu-branches/ubuntu/lucid/libgweather/lucid

« back to all changes in this revision

Viewing changes to doc/xml/weather.xml

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-01-07 14:05:06 UTC
  • mfrom: (1.1.20 upstream)
  • Revision ID: james.westby@ubuntu.com-20100107140506-mz4gowhy70do2k4z
Tags: 2.29.4-0ubuntu1
* New upstream version
* debian/patches/lp291853_obsolete_timezones.patch,
  debian/patches/lp404616_default_station_for_montreal.patch:
  - the changes are in the new version
* debian/patches/99_autoreconf.patch:
  - new version update

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<?xml version="1.0"?>
2
 
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3
 
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
4
 
<refentry id="libgweather-weather">
5
 
<refmeta>
6
 
<refentrytitle role="top_of_page" id="libgweather-weather.top_of_page">weather</refentrytitle>
7
 
<manvolnum>3</manvolnum>
8
 
<refmiscinfo>LIBGWEATHER Library</refmiscinfo>
9
 
</refmeta>
10
 
<refnamediv>
11
 
<refname>weather</refname>
12
 
<refpurpose></refpurpose>
13
 
</refnamediv>
14
 
 
15
 
<refsynopsisdiv id="libgweather-weather.synopsis" role="synopsis">
16
 
<title role="synopsis.title">Synopsis</title>
17
 
 
18
 
<synopsis>                    <link linkend="WeatherLocation">WeatherLocation</link>;
19
 
<link linkend="WeatherLocation">WeatherLocation</link> *   <link linkend="weather-location-new">weather_location_new</link>                (const <link linkend="gchar">gchar</link> *trans_name,
20
 
                                                         const <link linkend="gchar">gchar</link> *code,
21
 
                                                         const <link linkend="gchar">gchar</link> *zone,
22
 
                                                         const <link linkend="gchar">gchar</link> *radar,
23
 
                                                         const <link linkend="gchar">gchar</link> *coordinates,
24
 
                                                         const <link linkend="gchar">gchar</link> *country_code,
25
 
                                                         const <link linkend="gchar">gchar</link> *tz_hint);
26
 
<link linkend="WeatherLocation">WeatherLocation</link> *   <link linkend="weather-location-clone">weather_location_clone</link>              (const <link linkend="WeatherLocation">WeatherLocation</link> *location);
27
 
<link linkend="void">void</link>                <link linkend="weather-location-free">weather_location_free</link>               (<link linkend="WeatherLocation">WeatherLocation</link> *location);
28
 
<link linkend="gboolean">gboolean</link>            <link linkend="weather-location-equal">weather_location_equal</link>              (const <link linkend="WeatherLocation">WeatherLocation</link> *location1,
29
 
                                                         const <link linkend="WeatherLocation">WeatherLocation</link> *location2);
30
 
enum                <link linkend="WeatherForecastType">WeatherForecastType</link>;
31
 
enum                <link linkend="TempUnit">TempUnit</link>;
32
 
enum                <link linkend="SpeedUnit">SpeedUnit</link>;
33
 
enum                <link linkend="PressureUnit">PressureUnit</link>;
34
 
enum                <link linkend="DistanceUnit">DistanceUnit</link>;
35
 
                    <link linkend="WeatherPrefs">WeatherPrefs</link>;
36
 
                    <link linkend="WeatherInfo">WeatherInfo</link>;
37
 
<link linkend="void">void</link>                (<link linkend="WeatherInfoFunc">*WeatherInfoFunc</link>)                  (<link linkend="WeatherInfo">WeatherInfo</link> *info,
38
 
                                                         <link linkend="gpointer">gpointer</link> data);
39
 
#define             <link linkend="weather-info-new">weather_info_new</link>                    (location, prefs, cb, data)
40
 
#define             <link linkend="weather-info-update">weather_info_update</link>                 (info, prefs, cb, data)
41
 
<link linkend="void">void</link>                <link linkend="weather-info-abort">weather_info_abort</link>                  (<link linkend="WeatherInfo">WeatherInfo</link> *info);
42
 
<link linkend="WeatherInfo">WeatherInfo</link> *       <link linkend="weather-info-clone">weather_info_clone</link>                  (const <link linkend="WeatherInfo">WeatherInfo</link> *info);
43
 
<link linkend="void">void</link>                <link linkend="weather-info-free">weather_info_free</link>                   (<link linkend="WeatherInfo">WeatherInfo</link> *info);
44
 
<link linkend="gboolean">gboolean</link>            <link linkend="weather-info-is-valid">weather_info_is_valid</link>               (<link linkend="WeatherInfo">WeatherInfo</link> *info);
45
 
<link linkend="gboolean">gboolean</link>            <link linkend="weather-info-network-error">weather_info_network_error</link>          (<link linkend="WeatherInfo">WeatherInfo</link> *info);
46
 
<link linkend="void">void</link>                <link linkend="weather-info-to-metric">weather_info_to_metric</link>              (<link linkend="WeatherInfo">WeatherInfo</link> *info);
47
 
<link linkend="void">void</link>                <link linkend="weather-info-to-imperial">weather_info_to_imperial</link>            (<link linkend="WeatherInfo">WeatherInfo</link> *info);
48
 
const <link linkend="WeatherLocation">WeatherLocation</link> * <link linkend="weather-info-get-location">weather_info_get_location</link>       (<link linkend="WeatherInfo">WeatherInfo</link> *info);
49
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-location-name">weather_info_get_location_name</link>      (<link linkend="WeatherInfo">WeatherInfo</link> *info);
50
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-update">weather_info_get_update</link>             (<link linkend="WeatherInfo">WeatherInfo</link> *info);
51
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-sky">weather_info_get_sky</link>                (<link linkend="WeatherInfo">WeatherInfo</link> *info);
52
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-conditions">weather_info_get_conditions</link>         (<link linkend="WeatherInfo">WeatherInfo</link> *info);
53
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-temp">weather_info_get_temp</link>               (<link linkend="WeatherInfo">WeatherInfo</link> *info);
54
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-temp-min">weather_info_get_temp_min</link>           (<link linkend="WeatherInfo">WeatherInfo</link> *info);
55
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-temp-max">weather_info_get_temp_max</link>           (<link linkend="WeatherInfo">WeatherInfo</link> *info);
56
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-dew">weather_info_get_dew</link>                (<link linkend="WeatherInfo">WeatherInfo</link> *info);
57
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-humidity">weather_info_get_humidity</link>           (<link linkend="WeatherInfo">WeatherInfo</link> *info);
58
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-wind">weather_info_get_wind</link>               (<link linkend="WeatherInfo">WeatherInfo</link> *info);
59
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-pressure">weather_info_get_pressure</link>           (<link linkend="WeatherInfo">WeatherInfo</link> *info);
60
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-visibility">weather_info_get_visibility</link>         (<link linkend="WeatherInfo">WeatherInfo</link> *info);
61
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-apparent">weather_info_get_apparent</link>           (<link linkend="WeatherInfo">WeatherInfo</link> *info);
62
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-sunrise">weather_info_get_sunrise</link>            (<link linkend="WeatherInfo">WeatherInfo</link> *info);
63
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-sunset">weather_info_get_sunset</link>             (<link linkend="WeatherInfo">WeatherInfo</link> *info);
64
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-forecast">weather_info_get_forecast</link>           (<link linkend="WeatherInfo">WeatherInfo</link> *info);
65
 
<link linkend="GSList">GSList</link> *            <link linkend="weather-info-get-forecast-list">weather_info_get_forecast_list</link>      (<link linkend="WeatherInfo">WeatherInfo</link> *info);
66
 
<link linkend="GdkPixbufAnimation">GdkPixbufAnimation</link> * <link linkend="weather-info-get-radar">weather_info_get_radar</link>             (<link linkend="WeatherInfo">WeatherInfo</link> *info);
67
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-temp-summary">weather_info_get_temp_summary</link>       (<link linkend="WeatherInfo">WeatherInfo</link> *info);
68
 
<link linkend="gchar">gchar</link> *             <link linkend="weather-info-get-weather-summary">weather_info_get_weather_summary</link>    (<link linkend="WeatherInfo">WeatherInfo</link> *info);
69
 
const <link linkend="gchar">gchar</link> *       <link linkend="weather-info-get-icon-name">weather_info_get_icon_name</link>          (<link linkend="WeatherInfo">WeatherInfo</link> *info);
70
 
<link linkend="gint">gint</link>                <link linkend="weather-info-next-sun-event">weather_info_next_sun_event</link>         (<link linkend="WeatherInfo">WeatherInfo</link> *info);
71
 
enum                <link linkend="WeatherWindDirection">WeatherWindDirection</link>;
72
 
enum                <link linkend="WeatherSky">WeatherSky</link>;
73
 
enum                <link linkend="WeatherConditionPhenomenon">WeatherConditionPhenomenon</link>;
74
 
enum                <link linkend="WeatherConditionQualifier">WeatherConditionQualifier</link>;
75
 
<link linkend="gboolean">gboolean</link>            <link linkend="weather-info-get-value-update">weather_info_get_value_update</link>       (<link linkend="WeatherInfo">WeatherInfo</link> *info,
76
 
                                                         <link linkend="time-t">time_t</link> *value);
77
 
<link linkend="gboolean">gboolean</link>            <link linkend="weather-info-get-value-sky">weather_info_get_value_sky</link>          (<link linkend="WeatherInfo">WeatherInfo</link> *info,
78
 
                                                         <link linkend="WeatherSky">WeatherSky</link> *sky);
79
 
<link linkend="gboolean">gboolean</link>            <link linkend="weather-info-get-value-conditions">weather_info_get_value_conditions</link>   (<link linkend="WeatherInfo">WeatherInfo</link> *info,
80
 
                                                         <link linkend="WeatherConditionPhenomenon">WeatherConditionPhenomenon</link> *phenomenon,
81
 
                                                         <link linkend="WeatherConditionQualifier">WeatherConditionQualifier</link> *qualifier);
82
 
<link linkend="gboolean">gboolean</link>            <link linkend="weather-info-get-value-temp">weather_info_get_value_temp</link>         (<link linkend="WeatherInfo">WeatherInfo</link> *info,
83
 
                                                         <link linkend="TempUnit">TempUnit</link> unit,
84
 
                                                         <link linkend="gdouble">gdouble</link> *value);
85
 
<link linkend="gboolean">gboolean</link>            <link linkend="weather-info-get-value-temp-min">weather_info_get_value_temp_min</link>     (<link linkend="WeatherInfo">WeatherInfo</link> *info,
86
 
                                                         <link linkend="TempUnit">TempUnit</link> unit,
87
 
                                                         <link linkend="gdouble">gdouble</link> *value);
88
 
<link linkend="gboolean">gboolean</link>            <link linkend="weather-info-get-value-temp-max">weather_info_get_value_temp_max</link>     (<link linkend="WeatherInfo">WeatherInfo</link> *info,
89
 
                                                         <link linkend="TempUnit">TempUnit</link> unit,
90
 
                                                         <link linkend="gdouble">gdouble</link> *value);
91
 
<link linkend="gboolean">gboolean</link>            <link linkend="weather-info-get-value-dew">weather_info_get_value_dew</link>          (<link linkend="WeatherInfo">WeatherInfo</link> *info,
92
 
                                                         <link linkend="TempUnit">TempUnit</link> unit,
93
 
                                                         <link linkend="gdouble">gdouble</link> *value);
94
 
<link linkend="gboolean">gboolean</link>            <link linkend="weather-info-get-value-apparent">weather_info_get_value_apparent</link>     (<link linkend="WeatherInfo">WeatherInfo</link> *info,
95
 
                                                         <link linkend="TempUnit">TempUnit</link> unit,
96
 
                                                         <link linkend="gdouble">gdouble</link> *value);
97
 
<link linkend="gboolean">gboolean</link>            <link linkend="weather-info-get-value-wind">weather_info_get_value_wind</link>         (<link linkend="WeatherInfo">WeatherInfo</link> *info,
98
 
                                                         <link linkend="SpeedUnit">SpeedUnit</link> unit,
99
 
                                                         <link linkend="gdouble">gdouble</link> *speed,
100
 
                                                         <link linkend="WeatherWindDirection">WeatherWindDirection</link> *direction);
101
 
<link linkend="gboolean">gboolean</link>            <link linkend="weather-info-get-value-pressure">weather_info_get_value_pressure</link>     (<link linkend="WeatherInfo">WeatherInfo</link> *info,
102
 
                                                         <link linkend="PressureUnit">PressureUnit</link> unit,
103
 
                                                         <link linkend="gdouble">gdouble</link> *value);
104
 
<link linkend="gboolean">gboolean</link>            <link linkend="weather-info-get-value-visibility">weather_info_get_value_visibility</link>   (<link linkend="WeatherInfo">WeatherInfo</link> *info,
105
 
                                                         <link linkend="DistanceUnit">DistanceUnit</link> unit,
106
 
                                                         <link linkend="gdouble">gdouble</link> *value);
107
 
<link linkend="gboolean">gboolean</link>            <link linkend="weather-info-get-value-sunrise">weather_info_get_value_sunrise</link>      (<link linkend="WeatherInfo">WeatherInfo</link> *info,
108
 
                                                         <link linkend="time-t">time_t</link> *value);
109
 
<link linkend="gboolean">gboolean</link>            <link linkend="weather-info-get-value-sunset">weather_info_get_value_sunset</link>       (<link linkend="WeatherInfo">WeatherInfo</link> *info,
110
 
                                                         <link linkend="time-t">time_t</link> *value);
111
 
</synopsis>
112
 
</refsynopsisdiv>
113
 
 
114
 
<refsect1 id="libgweather-weather.description" role="desc">
115
 
<title role="desc.title">Description</title>
116
 
<para>
117
 
</para>
118
 
</refsect1>
119
 
<refsect1 id="libgweather-weather.details" role="details">
120
 
<title role="details.title">Details</title>
121
 
<refsect2 id="WeatherLocation" role="struct">
122
 
<title>WeatherLocation</title>
123
 
<indexterm zone="WeatherLocation"><primary>WeatherLocation</primary></indexterm>
124
 
<programlisting>typedef struct {
125
 
    gchar *name;
126
 
    gchar *code;
127
 
    gchar *zone;
128
 
    gchar *radar;
129
 
    gboolean zone_valid;
130
 
    gchar *coordinates;
131
 
    gdouble  latitude;
132
 
    gdouble  longitude;
133
 
    gboolean latlon_valid;
134
 
    gchar *country_code;
135
 
    gchar *tz_hint;
136
 
} WeatherLocation;
137
 
</programlisting>
138
 
<para>
139
 
</para></refsect2>
140
 
<refsect2 id="weather-location-new" role="function">
141
 
<title>weather_location_new ()</title>
142
 
<indexterm zone="weather-location-new"><primary>weather_location_new</primary></indexterm>
143
 
<programlisting><link linkend="WeatherLocation">WeatherLocation</link> *   weather_location_new                (const <link linkend="gchar">gchar</link> *trans_name,
144
 
                                                         const <link linkend="gchar">gchar</link> *code,
145
 
                                                         const <link linkend="gchar">gchar</link> *zone,
146
 
                                                         const <link linkend="gchar">gchar</link> *radar,
147
 
                                                         const <link linkend="gchar">gchar</link> *coordinates,
148
 
                                                         const <link linkend="gchar">gchar</link> *country_code,
149
 
                                                         const <link linkend="gchar">gchar</link> *tz_hint);</programlisting>
150
 
<para>
151
 
</para><variablelist role="params">
152
 
<varlistentry><term><parameter>trans_name</parameter>&#160;:</term>
153
 
<listitem><simpara>
154
 
</simpara></listitem></varlistentry>
155
 
<varlistentry><term><parameter>code</parameter>&#160;:</term>
156
 
<listitem><simpara>
157
 
</simpara></listitem></varlistentry>
158
 
<varlistentry><term><parameter>zone</parameter>&#160;:</term>
159
 
<listitem><simpara>
160
 
</simpara></listitem></varlistentry>
161
 
<varlistentry><term><parameter>radar</parameter>&#160;:</term>
162
 
<listitem><simpara>
163
 
</simpara></listitem></varlistentry>
164
 
<varlistentry><term><parameter>coordinates</parameter>&#160;:</term>
165
 
<listitem><simpara>
166
 
</simpara></listitem></varlistentry>
167
 
<varlistentry><term><parameter>country_code</parameter>&#160;:</term>
168
 
<listitem><simpara>
169
 
</simpara></listitem></varlistentry>
170
 
<varlistentry><term><parameter>tz_hint</parameter>&#160;:</term>
171
 
<listitem><simpara>
172
 
</simpara></listitem></varlistentry>
173
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
174
 
</simpara></listitem></varlistentry>
175
 
</variablelist></refsect2>
176
 
<refsect2 id="weather-location-clone" role="function">
177
 
<title>weather_location_clone ()</title>
178
 
<indexterm zone="weather-location-clone"><primary>weather_location_clone</primary></indexterm>
179
 
<programlisting><link linkend="WeatherLocation">WeatherLocation</link> *   weather_location_clone              (const <link linkend="WeatherLocation">WeatherLocation</link> *location);</programlisting>
180
 
<para>
181
 
</para><variablelist role="params">
182
 
<varlistentry><term><parameter>location</parameter>&#160;:</term>
183
 
<listitem><simpara>
184
 
</simpara></listitem></varlistentry>
185
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
186
 
</simpara></listitem></varlistentry>
187
 
</variablelist></refsect2>
188
 
<refsect2 id="weather-location-free" role="function">
189
 
<title>weather_location_free ()</title>
190
 
<indexterm zone="weather-location-free"><primary>weather_location_free</primary></indexterm>
191
 
<programlisting><link linkend="void">void</link>                weather_location_free               (<link linkend="WeatherLocation">WeatherLocation</link> *location);</programlisting>
192
 
<para>
193
 
</para><variablelist role="params">
194
 
<varlistentry><term><parameter>location</parameter>&#160;:</term>
195
 
<listitem><simpara>
196
 
</simpara></listitem></varlistentry>
197
 
</variablelist></refsect2>
198
 
<refsect2 id="weather-location-equal" role="function">
199
 
<title>weather_location_equal ()</title>
200
 
<indexterm zone="weather-location-equal"><primary>weather_location_equal</primary></indexterm>
201
 
<programlisting><link linkend="gboolean">gboolean</link>            weather_location_equal              (const <link linkend="WeatherLocation">WeatherLocation</link> *location1,
202
 
                                                         const <link linkend="WeatherLocation">WeatherLocation</link> *location2);</programlisting>
203
 
<para>
204
 
</para><variablelist role="params">
205
 
<varlistentry><term><parameter>location1</parameter>&#160;:</term>
206
 
<listitem><simpara>
207
 
</simpara></listitem></varlistentry>
208
 
<varlistentry><term><parameter>location2</parameter>&#160;:</term>
209
 
<listitem><simpara>
210
 
</simpara></listitem></varlistentry>
211
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
212
 
</simpara></listitem></varlistentry>
213
 
</variablelist></refsect2>
214
 
<refsect2 id="WeatherForecastType" role="enum">
215
 
<title>enum WeatherForecastType</title>
216
 
<indexterm zone="WeatherForecastType"><primary>WeatherForecastType</primary></indexterm>
217
 
<programlisting>typedef enum _WeatherForecastType {
218
 
    FORECAST_STATE,
219
 
    FORECAST_ZONE,
220
 
    FORECAST_LIST
221
 
} WeatherForecastType;
222
 
</programlisting>
223
 
<para>
224
 
</para></refsect2>
225
 
<refsect2 id="TempUnit" role="enum">
226
 
<title>enum TempUnit</title>
227
 
<indexterm zone="TempUnit"><primary>TempUnit</primary></indexterm>
228
 
<programlisting>typedef enum {
229
 
    TEMP_UNIT_INVALID = 0,
230
 
    TEMP_UNIT_DEFAULT,
231
 
    TEMP_UNIT_KELVIN,
232
 
    TEMP_UNIT_CENTIGRADE,
233
 
    TEMP_UNIT_FAHRENHEIT
234
 
} TempUnit;
235
 
</programlisting>
236
 
<para>
237
 
</para></refsect2>
238
 
<refsect2 id="SpeedUnit" role="enum">
239
 
<title>enum SpeedUnit</title>
240
 
<indexterm zone="SpeedUnit"><primary>SpeedUnit</primary></indexterm>
241
 
<programlisting>typedef enum {
242
 
    SPEED_UNIT_INVALID = 0,
243
 
    SPEED_UNIT_DEFAULT,
244
 
    SPEED_UNIT_MS,    /* metres per second */
245
 
    SPEED_UNIT_KPH,   /* kilometres per hour */
246
 
    SPEED_UNIT_MPH,   /* miles per hour */
247
 
    SPEED_UNIT_KNOTS, /* Knots */
248
 
    SPEED_UNIT_BFT    /* Beaufort scale */
249
 
} SpeedUnit;
250
 
</programlisting>
251
 
<para>
252
 
</para></refsect2>
253
 
<refsect2 id="PressureUnit" role="enum">
254
 
<title>enum PressureUnit</title>
255
 
<indexterm zone="PressureUnit"><primary>PressureUnit</primary></indexterm>
256
 
<programlisting>typedef enum {
257
 
    PRESSURE_UNIT_INVALID = 0,
258
 
    PRESSURE_UNIT_DEFAULT,
259
 
    PRESSURE_UNIT_KPA,    /* kiloPascal */
260
 
    PRESSURE_UNIT_HPA,    /* hectoPascal */
261
 
    PRESSURE_UNIT_MB,     /* 1 millibars = 1 hectoPascal */
262
 
    PRESSURE_UNIT_MM_HG,  /* millimeters of mecury */
263
 
    PRESSURE_UNIT_INCH_HG, /* inches of mercury */
264
 
    PRESSURE_UNIT_ATM     /* atmosphere */
265
 
} PressureUnit;
266
 
</programlisting>
267
 
<para>
268
 
</para></refsect2>
269
 
<refsect2 id="DistanceUnit" role="enum">
270
 
<title>enum DistanceUnit</title>
271
 
<indexterm zone="DistanceUnit"><primary>DistanceUnit</primary></indexterm>
272
 
<programlisting>typedef enum {
273
 
    DISTANCE_UNIT_INVALID = 0,
274
 
    DISTANCE_UNIT_DEFAULT,
275
 
    DISTANCE_UNIT_METERS,
276
 
    DISTANCE_UNIT_KM,
277
 
    DISTANCE_UNIT_MILES
278
 
} DistanceUnit;
279
 
</programlisting>
280
 
<para>
281
 
</para></refsect2>
282
 
<refsect2 id="WeatherPrefs" role="struct">
283
 
<title>WeatherPrefs</title>
284
 
<indexterm zone="WeatherPrefs"><primary>WeatherPrefs</primary></indexterm>
285
 
<programlisting>typedef struct {
286
 
    WeatherForecastType type;
287
 
 
288
 
    gboolean radar;
289
 
    const char *radar_custom_url;
290
 
 
291
 
    TempUnit temperature_unit;
292
 
    SpeedUnit speed_unit;
293
 
    PressureUnit pressure_unit;
294
 
    DistanceUnit distance_unit;
295
 
} WeatherPrefs;
296
 
</programlisting>
297
 
<para>
298
 
</para></refsect2>
299
 
<refsect2 id="WeatherInfo" role="struct">
300
 
<title>WeatherInfo</title>
301
 
<indexterm zone="WeatherInfo"><primary>WeatherInfo</primary></indexterm>
302
 
<programlisting>typedef struct _WeatherInfo WeatherInfo;</programlisting>
303
 
<para>
304
 
</para></refsect2>
305
 
<refsect2 id="WeatherInfoFunc" role="function">
306
 
<title>WeatherInfoFunc ()</title>
307
 
<indexterm zone="WeatherInfoFunc"><primary>WeatherInfoFunc</primary></indexterm>
308
 
<programlisting><link linkend="void">void</link>                (*WeatherInfoFunc)                  (<link linkend="WeatherInfo">WeatherInfo</link> *info,
309
 
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
310
 
<para>
311
 
</para><variablelist role="params">
312
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
313
 
<listitem><simpara>
314
 
</simpara></listitem></varlistentry>
315
 
<varlistentry><term><parameter>data</parameter>&#160;:</term>
316
 
<listitem><simpara>
317
 
</simpara></listitem></varlistentry>
318
 
</variablelist></refsect2>
319
 
<refsect2 id="weather-info-new" role="macro">
320
 
<title>weather_info_new()</title>
321
 
<indexterm zone="weather-info-new"><primary>weather_info_new</primary></indexterm>
322
 
<programlisting>#define&#160;weather_info_new(location, prefs, cb, data) _weather_info_fill (NULL, (location), (prefs), (cb), (data))
323
 
</programlisting>
324
 
<para>
325
 
</para><variablelist role="params">
326
 
<varlistentry><term><parameter>location</parameter>&#160;:</term>
327
 
<listitem><simpara>
328
 
</simpara></listitem></varlistentry>
329
 
<varlistentry><term><parameter>prefs</parameter>&#160;:</term>
330
 
<listitem><simpara>
331
 
</simpara></listitem></varlistentry>
332
 
<varlistentry><term><parameter>cb</parameter>&#160;:</term>
333
 
<listitem><simpara>
334
 
</simpara></listitem></varlistentry>
335
 
<varlistentry><term><parameter>data</parameter>&#160;:</term>
336
 
<listitem><simpara>
337
 
</simpara></listitem></varlistentry>
338
 
</variablelist></refsect2>
339
 
<refsect2 id="weather-info-update" role="macro">
340
 
<title>weather_info_update()</title>
341
 
<indexterm zone="weather-info-update"><primary>weather_info_update</primary></indexterm>
342
 
<programlisting>#define&#160;weather_info_update(info, prefs, cb, data) _weather_info_fill ((info), NULL, (prefs), (cb), (data))
343
 
</programlisting>
344
 
<para>
345
 
</para><variablelist role="params">
346
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
347
 
<listitem><simpara>
348
 
</simpara></listitem></varlistentry>
349
 
<varlistentry><term><parameter>prefs</parameter>&#160;:</term>
350
 
<listitem><simpara>
351
 
</simpara></listitem></varlistentry>
352
 
<varlistentry><term><parameter>cb</parameter>&#160;:</term>
353
 
<listitem><simpara>
354
 
</simpara></listitem></varlistentry>
355
 
<varlistentry><term><parameter>data</parameter>&#160;:</term>
356
 
<listitem><simpara>
357
 
</simpara></listitem></varlistentry>
358
 
</variablelist></refsect2>
359
 
<refsect2 id="weather-info-abort" role="function">
360
 
<title>weather_info_abort ()</title>
361
 
<indexterm zone="weather-info-abort"><primary>weather_info_abort</primary></indexterm>
362
 
<programlisting><link linkend="void">void</link>                weather_info_abort                  (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
363
 
<para>
364
 
</para><variablelist role="params">
365
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
366
 
<listitem><simpara>
367
 
</simpara></listitem></varlistentry>
368
 
</variablelist></refsect2>
369
 
<refsect2 id="weather-info-clone" role="function">
370
 
<title>weather_info_clone ()</title>
371
 
<indexterm zone="weather-info-clone"><primary>weather_info_clone</primary></indexterm>
372
 
<programlisting><link linkend="WeatherInfo">WeatherInfo</link> *       weather_info_clone                  (const <link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
373
 
<para>
374
 
</para><variablelist role="params">
375
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
376
 
<listitem><simpara>
377
 
</simpara></listitem></varlistentry>
378
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
379
 
</simpara></listitem></varlistentry>
380
 
</variablelist></refsect2>
381
 
<refsect2 id="weather-info-free" role="function">
382
 
<title>weather_info_free ()</title>
383
 
<indexterm zone="weather-info-free"><primary>weather_info_free</primary></indexterm>
384
 
<programlisting><link linkend="void">void</link>                weather_info_free                   (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
385
 
<para>
386
 
</para><variablelist role="params">
387
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
388
 
<listitem><simpara>
389
 
</simpara></listitem></varlistentry>
390
 
</variablelist></refsect2>
391
 
<refsect2 id="weather-info-is-valid" role="function">
392
 
<title>weather_info_is_valid ()</title>
393
 
<indexterm zone="weather-info-is-valid"><primary>weather_info_is_valid</primary></indexterm>
394
 
<programlisting><link linkend="gboolean">gboolean</link>            weather_info_is_valid               (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
395
 
<para>
396
 
</para><variablelist role="params">
397
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
398
 
<listitem><simpara>
399
 
</simpara></listitem></varlistentry>
400
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
401
 
</simpara></listitem></varlistentry>
402
 
</variablelist></refsect2>
403
 
<refsect2 id="weather-info-network-error" role="function">
404
 
<title>weather_info_network_error ()</title>
405
 
<indexterm zone="weather-info-network-error"><primary>weather_info_network_error</primary></indexterm>
406
 
<programlisting><link linkend="gboolean">gboolean</link>            weather_info_network_error          (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
407
 
<para>
408
 
</para><variablelist role="params">
409
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
410
 
<listitem><simpara>
411
 
</simpara></listitem></varlistentry>
412
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
413
 
</simpara></listitem></varlistentry>
414
 
</variablelist></refsect2>
415
 
<refsect2 id="weather-info-to-metric" role="function">
416
 
<title>weather_info_to_metric ()</title>
417
 
<indexterm zone="weather-info-to-metric"><primary>weather_info_to_metric</primary></indexterm>
418
 
<programlisting><link linkend="void">void</link>                weather_info_to_metric              (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
419
 
<para>
420
 
</para><variablelist role="params">
421
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
422
 
<listitem><simpara>
423
 
</simpara></listitem></varlistentry>
424
 
</variablelist></refsect2>
425
 
<refsect2 id="weather-info-to-imperial" role="function">
426
 
<title>weather_info_to_imperial ()</title>
427
 
<indexterm zone="weather-info-to-imperial"><primary>weather_info_to_imperial</primary></indexterm>
428
 
<programlisting><link linkend="void">void</link>                weather_info_to_imperial            (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
429
 
<para>
430
 
</para><variablelist role="params">
431
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
432
 
<listitem><simpara>
433
 
</simpara></listitem></varlistentry>
434
 
</variablelist></refsect2>
435
 
<refsect2 id="weather-info-get-location" role="function">
436
 
<title>weather_info_get_location ()</title>
437
 
<indexterm zone="weather-info-get-location"><primary>weather_info_get_location</primary></indexterm>
438
 
<programlisting>const <link linkend="WeatherLocation">WeatherLocation</link> * weather_info_get_location       (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
439
 
<para>
440
 
</para><variablelist role="params">
441
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
442
 
<listitem><simpara>
443
 
</simpara></listitem></varlistentry>
444
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
445
 
</simpara></listitem></varlistentry>
446
 
</variablelist></refsect2>
447
 
<refsect2 id="weather-info-get-location-name" role="function">
448
 
<title>weather_info_get_location_name ()</title>
449
 
<indexterm zone="weather-info-get-location-name"><primary>weather_info_get_location_name</primary></indexterm>
450
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_location_name      (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
451
 
<para>
452
 
</para><variablelist role="params">
453
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
454
 
<listitem><simpara>
455
 
</simpara></listitem></varlistentry>
456
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
457
 
</simpara></listitem></varlistentry>
458
 
</variablelist></refsect2>
459
 
<refsect2 id="weather-info-get-update" role="function">
460
 
<title>weather_info_get_update ()</title>
461
 
<indexterm zone="weather-info-get-update"><primary>weather_info_get_update</primary></indexterm>
462
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_update             (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
463
 
<para>
464
 
</para><variablelist role="params">
465
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
466
 
<listitem><simpara>
467
 
</simpara></listitem></varlistentry>
468
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
469
 
</simpara></listitem></varlistentry>
470
 
</variablelist></refsect2>
471
 
<refsect2 id="weather-info-get-sky" role="function">
472
 
<title>weather_info_get_sky ()</title>
473
 
<indexterm zone="weather-info-get-sky"><primary>weather_info_get_sky</primary></indexterm>
474
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_sky                (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
475
 
<para>
476
 
</para><variablelist role="params">
477
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
478
 
<listitem><simpara>
479
 
</simpara></listitem></varlistentry>
480
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
481
 
</simpara></listitem></varlistentry>
482
 
</variablelist></refsect2>
483
 
<refsect2 id="weather-info-get-conditions" role="function">
484
 
<title>weather_info_get_conditions ()</title>
485
 
<indexterm zone="weather-info-get-conditions"><primary>weather_info_get_conditions</primary></indexterm>
486
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_conditions         (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
487
 
<para>
488
 
</para><variablelist role="params">
489
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
490
 
<listitem><simpara>
491
 
</simpara></listitem></varlistentry>
492
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
493
 
</simpara></listitem></varlistentry>
494
 
</variablelist></refsect2>
495
 
<refsect2 id="weather-info-get-temp" role="function">
496
 
<title>weather_info_get_temp ()</title>
497
 
<indexterm zone="weather-info-get-temp"><primary>weather_info_get_temp</primary></indexterm>
498
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_temp               (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
499
 
<para>
500
 
</para><variablelist role="params">
501
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
502
 
<listitem><simpara>
503
 
</simpara></listitem></varlistentry>
504
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
505
 
</simpara></listitem></varlistentry>
506
 
</variablelist></refsect2>
507
 
<refsect2 id="weather-info-get-temp-min" role="function">
508
 
<title>weather_info_get_temp_min ()</title>
509
 
<indexterm zone="weather-info-get-temp-min"><primary>weather_info_get_temp_min</primary></indexterm>
510
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_temp_min           (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
511
 
<para>
512
 
</para><variablelist role="params">
513
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
514
 
<listitem><simpara>
515
 
</simpara></listitem></varlistentry>
516
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
517
 
</simpara></listitem></varlistentry>
518
 
</variablelist></refsect2>
519
 
<refsect2 id="weather-info-get-temp-max" role="function">
520
 
<title>weather_info_get_temp_max ()</title>
521
 
<indexterm zone="weather-info-get-temp-max"><primary>weather_info_get_temp_max</primary></indexterm>
522
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_temp_max           (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
523
 
<para>
524
 
</para><variablelist role="params">
525
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
526
 
<listitem><simpara>
527
 
</simpara></listitem></varlistentry>
528
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
529
 
</simpara></listitem></varlistentry>
530
 
</variablelist></refsect2>
531
 
<refsect2 id="weather-info-get-dew" role="function">
532
 
<title>weather_info_get_dew ()</title>
533
 
<indexterm zone="weather-info-get-dew"><primary>weather_info_get_dew</primary></indexterm>
534
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_dew                (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
535
 
<para>
536
 
</para><variablelist role="params">
537
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
538
 
<listitem><simpara>
539
 
</simpara></listitem></varlistentry>
540
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
541
 
</simpara></listitem></varlistentry>
542
 
</variablelist></refsect2>
543
 
<refsect2 id="weather-info-get-humidity" role="function">
544
 
<title>weather_info_get_humidity ()</title>
545
 
<indexterm zone="weather-info-get-humidity"><primary>weather_info_get_humidity</primary></indexterm>
546
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_humidity           (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
547
 
<para>
548
 
</para><variablelist role="params">
549
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
550
 
<listitem><simpara>
551
 
</simpara></listitem></varlistentry>
552
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
553
 
</simpara></listitem></varlistentry>
554
 
</variablelist></refsect2>
555
 
<refsect2 id="weather-info-get-wind" role="function">
556
 
<title>weather_info_get_wind ()</title>
557
 
<indexterm zone="weather-info-get-wind"><primary>weather_info_get_wind</primary></indexterm>
558
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_wind               (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
559
 
<para>
560
 
</para><variablelist role="params">
561
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
562
 
<listitem><simpara>
563
 
</simpara></listitem></varlistentry>
564
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
565
 
</simpara></listitem></varlistentry>
566
 
</variablelist></refsect2>
567
 
<refsect2 id="weather-info-get-pressure" role="function">
568
 
<title>weather_info_get_pressure ()</title>
569
 
<indexterm zone="weather-info-get-pressure"><primary>weather_info_get_pressure</primary></indexterm>
570
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_pressure           (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
571
 
<para>
572
 
</para><variablelist role="params">
573
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
574
 
<listitem><simpara>
575
 
</simpara></listitem></varlistentry>
576
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
577
 
</simpara></listitem></varlistentry>
578
 
</variablelist></refsect2>
579
 
<refsect2 id="weather-info-get-visibility" role="function">
580
 
<title>weather_info_get_visibility ()</title>
581
 
<indexterm zone="weather-info-get-visibility"><primary>weather_info_get_visibility</primary></indexterm>
582
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_visibility         (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
583
 
<para>
584
 
</para><variablelist role="params">
585
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
586
 
<listitem><simpara>
587
 
</simpara></listitem></varlistentry>
588
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
589
 
</simpara></listitem></varlistentry>
590
 
</variablelist></refsect2>
591
 
<refsect2 id="weather-info-get-apparent" role="function">
592
 
<title>weather_info_get_apparent ()</title>
593
 
<indexterm zone="weather-info-get-apparent"><primary>weather_info_get_apparent</primary></indexterm>
594
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_apparent           (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
595
 
<para>
596
 
</para><variablelist role="params">
597
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
598
 
<listitem><simpara>
599
 
</simpara></listitem></varlistentry>
600
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
601
 
</simpara></listitem></varlistentry>
602
 
</variablelist></refsect2>
603
 
<refsect2 id="weather-info-get-sunrise" role="function">
604
 
<title>weather_info_get_sunrise ()</title>
605
 
<indexterm zone="weather-info-get-sunrise"><primary>weather_info_get_sunrise</primary></indexterm>
606
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_sunrise            (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
607
 
<para>
608
 
</para><variablelist role="params">
609
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
610
 
<listitem><simpara>
611
 
</simpara></listitem></varlistentry>
612
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
613
 
</simpara></listitem></varlistentry>
614
 
</variablelist></refsect2>
615
 
<refsect2 id="weather-info-get-sunset" role="function">
616
 
<title>weather_info_get_sunset ()</title>
617
 
<indexterm zone="weather-info-get-sunset"><primary>weather_info_get_sunset</primary></indexterm>
618
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_sunset             (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
619
 
<para>
620
 
</para><variablelist role="params">
621
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
622
 
<listitem><simpara>
623
 
</simpara></listitem></varlistentry>
624
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
625
 
</simpara></listitem></varlistentry>
626
 
</variablelist></refsect2>
627
 
<refsect2 id="weather-info-get-forecast" role="function">
628
 
<title>weather_info_get_forecast ()</title>
629
 
<indexterm zone="weather-info-get-forecast"><primary>weather_info_get_forecast</primary></indexterm>
630
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_forecast           (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
631
 
<para>
632
 
</para><variablelist role="params">
633
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
634
 
<listitem><simpara>
635
 
</simpara></listitem></varlistentry>
636
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
637
 
</simpara></listitem></varlistentry>
638
 
</variablelist></refsect2>
639
 
<refsect2 id="weather-info-get-forecast-list" role="function">
640
 
<title>weather_info_get_forecast_list ()</title>
641
 
<indexterm zone="weather-info-get-forecast-list"><primary>weather_info_get_forecast_list</primary></indexterm>
642
 
<programlisting><link linkend="GSList">GSList</link> *            weather_info_get_forecast_list      (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
643
 
<para>
644
 
</para><variablelist role="params">
645
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
646
 
<listitem><simpara>
647
 
</simpara></listitem></varlistentry>
648
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
649
 
</simpara></listitem></varlistentry>
650
 
</variablelist></refsect2>
651
 
<refsect2 id="weather-info-get-radar" role="function">
652
 
<title>weather_info_get_radar ()</title>
653
 
<indexterm zone="weather-info-get-radar"><primary>weather_info_get_radar</primary></indexterm>
654
 
<programlisting><link linkend="GdkPixbufAnimation">GdkPixbufAnimation</link> * weather_info_get_radar             (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
655
 
<para>
656
 
</para><variablelist role="params">
657
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
658
 
<listitem><simpara>
659
 
</simpara></listitem></varlistentry>
660
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
661
 
</simpara></listitem></varlistentry>
662
 
</variablelist></refsect2>
663
 
<refsect2 id="weather-info-get-temp-summary" role="function">
664
 
<title>weather_info_get_temp_summary ()</title>
665
 
<indexterm zone="weather-info-get-temp-summary"><primary>weather_info_get_temp_summary</primary></indexterm>
666
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_temp_summary       (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
667
 
<para>
668
 
</para><variablelist role="params">
669
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
670
 
<listitem><simpara>
671
 
</simpara></listitem></varlistentry>
672
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
673
 
</simpara></listitem></varlistentry>
674
 
</variablelist></refsect2>
675
 
<refsect2 id="weather-info-get-weather-summary" role="function">
676
 
<title>weather_info_get_weather_summary ()</title>
677
 
<indexterm zone="weather-info-get-weather-summary"><primary>weather_info_get_weather_summary</primary></indexterm>
678
 
<programlisting><link linkend="gchar">gchar</link> *             weather_info_get_weather_summary    (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
679
 
<para>
680
 
</para><variablelist role="params">
681
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
682
 
<listitem><simpara>
683
 
</simpara></listitem></varlistentry>
684
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
685
 
</simpara></listitem></varlistentry>
686
 
</variablelist></refsect2>
687
 
<refsect2 id="weather-info-get-icon-name" role="function">
688
 
<title>weather_info_get_icon_name ()</title>
689
 
<indexterm zone="weather-info-get-icon-name"><primary>weather_info_get_icon_name</primary></indexterm>
690
 
<programlisting>const <link linkend="gchar">gchar</link> *       weather_info_get_icon_name          (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
691
 
<para>
692
 
</para><variablelist role="params">
693
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
694
 
<listitem><simpara>
695
 
</simpara></listitem></varlistentry>
696
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
697
 
</simpara></listitem></varlistentry>
698
 
</variablelist></refsect2>
699
 
<refsect2 id="weather-info-next-sun-event" role="function">
700
 
<title>weather_info_next_sun_event ()</title>
701
 
<indexterm zone="weather-info-next-sun-event"><primary>weather_info_next_sun_event</primary></indexterm>
702
 
<programlisting><link linkend="gint">gint</link>                weather_info_next_sun_event         (<link linkend="WeatherInfo">WeatherInfo</link> *info);</programlisting>
703
 
<para>
704
 
</para><variablelist role="params">
705
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
706
 
<listitem><simpara>
707
 
</simpara></listitem></varlistentry>
708
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
709
 
</simpara></listitem></varlistentry>
710
 
</variablelist></refsect2>
711
 
<refsect2 id="WeatherWindDirection" role="enum">
712
 
<title>enum WeatherWindDirection</title>
713
 
<indexterm zone="WeatherWindDirection"><primary>WeatherWindDirection</primary></indexterm>
714
 
<programlisting>enum WeatherWindDirection {
715
 
    WIND_INVALID = -1,
716
 
    WIND_VARIABLE,
717
 
    WIND_N, WIND_NNE, WIND_NE, WIND_ENE,
718
 
    WIND_E, WIND_ESE, WIND_SE, WIND_SSE,
719
 
    WIND_S, WIND_SSW, WIND_SW, WIND_WSW,
720
 
    WIND_W, WIND_WNW, WIND_NW, WIND_NNW,
721
 
    WIND_LAST
722
 
};
723
 
</programlisting>
724
 
<para>
725
 
</para></refsect2>
726
 
<refsect2 id="WeatherSky" role="enum">
727
 
<title>enum WeatherSky</title>
728
 
<indexterm zone="WeatherSky"><primary>WeatherSky</primary></indexterm>
729
 
<programlisting>enum WeatherSky {
730
 
    SKY_INVALID = -1,
731
 
    SKY_CLEAR,
732
 
    SKY_BROKEN,
733
 
    SKY_SCATTERED,
734
 
    SKY_FEW,
735
 
    SKY_OVERCAST,
736
 
    SKY_LAST
737
 
};
738
 
</programlisting>
739
 
<para>
740
 
</para></refsect2>
741
 
<refsect2 id="WeatherConditionPhenomenon" role="enum">
742
 
<title>enum WeatherConditionPhenomenon</title>
743
 
<indexterm zone="WeatherConditionPhenomenon"><primary>WeatherConditionPhenomenon</primary></indexterm>
744
 
<programlisting>enum WeatherConditionPhenomenon {
745
 
    PHENOMENON_INVALID = -1,
746
 
 
747
 
    PHENOMENON_NONE,
748
 
 
749
 
    PHENOMENON_DRIZZLE,
750
 
    PHENOMENON_RAIN,
751
 
    PHENOMENON_SNOW,
752
 
    PHENOMENON_SNOW_GRAINS,
753
 
    PHENOMENON_ICE_CRYSTALS,
754
 
    PHENOMENON_ICE_PELLETS,
755
 
    PHENOMENON_HAIL,
756
 
    PHENOMENON_SMALL_HAIL,
757
 
    PHENOMENON_UNKNOWN_PRECIPITATION,
758
 
 
759
 
    PHENOMENON_MIST,
760
 
    PHENOMENON_FOG,
761
 
    PHENOMENON_SMOKE,
762
 
    PHENOMENON_VOLCANIC_ASH,
763
 
    PHENOMENON_SAND,
764
 
    PHENOMENON_HAZE,
765
 
    PHENOMENON_SPRAY,
766
 
    PHENOMENON_DUST,
767
 
 
768
 
    PHENOMENON_SQUALL,
769
 
    PHENOMENON_SANDSTORM,
770
 
    PHENOMENON_DUSTSTORM,
771
 
    PHENOMENON_FUNNEL_CLOUD,
772
 
    PHENOMENON_TORNADO,
773
 
    PHENOMENON_DUST_WHIRLS,
774
 
 
775
 
    PHENOMENON_LAST
776
 
};
777
 
</programlisting>
778
 
<para>
779
 
</para></refsect2>
780
 
<refsect2 id="WeatherConditionQualifier" role="enum">
781
 
<title>enum WeatherConditionQualifier</title>
782
 
<indexterm zone="WeatherConditionQualifier"><primary>WeatherConditionQualifier</primary></indexterm>
783
 
<programlisting>enum WeatherConditionQualifier {
784
 
    QUALIFIER_INVALID = -1,
785
 
 
786
 
    QUALIFIER_NONE,
787
 
 
788
 
    QUALIFIER_VICINITY,
789
 
 
790
 
    QUALIFIER_LIGHT,
791
 
    QUALIFIER_MODERATE,
792
 
    QUALIFIER_HEAVY,
793
 
    QUALIFIER_SHALLOW,
794
 
    QUALIFIER_PATCHES,
795
 
    QUALIFIER_PARTIAL,
796
 
    QUALIFIER_THUNDERSTORM,
797
 
    QUALIFIER_BLOWING,
798
 
    QUALIFIER_SHOWERS,
799
 
    QUALIFIER_DRIFTING,
800
 
    QUALIFIER_FREEZING,
801
 
 
802
 
    QUALIFIER_LAST
803
 
};
804
 
</programlisting>
805
 
<para>
806
 
</para></refsect2>
807
 
<refsect2 id="weather-info-get-value-update" role="function">
808
 
<title>weather_info_get_value_update ()</title>
809
 
<indexterm zone="weather-info-get-value-update"><primary>weather_info_get_value_update</primary></indexterm>
810
 
<programlisting><link linkend="gboolean">gboolean</link>            weather_info_get_value_update       (<link linkend="WeatherInfo">WeatherInfo</link> *info,
811
 
                                                         <link linkend="time-t">time_t</link> *value);</programlisting>
812
 
<para>
813
 
</para><variablelist role="params">
814
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
815
 
<listitem><simpara>
816
 
</simpara></listitem></varlistentry>
817
 
<varlistentry><term><parameter>value</parameter>&#160;:</term>
818
 
<listitem><simpara>
819
 
</simpara></listitem></varlistentry>
820
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
821
 
</simpara></listitem></varlistentry>
822
 
</variablelist></refsect2>
823
 
<refsect2 id="weather-info-get-value-sky" role="function">
824
 
<title>weather_info_get_value_sky ()</title>
825
 
<indexterm zone="weather-info-get-value-sky"><primary>weather_info_get_value_sky</primary></indexterm>
826
 
<programlisting><link linkend="gboolean">gboolean</link>            weather_info_get_value_sky          (<link linkend="WeatherInfo">WeatherInfo</link> *info,
827
 
                                                         <link linkend="WeatherSky">WeatherSky</link> *sky);</programlisting>
828
 
<para>
829
 
</para><variablelist role="params">
830
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
831
 
<listitem><simpara>
832
 
</simpara></listitem></varlistentry>
833
 
<varlistentry><term><parameter>sky</parameter>&#160;:</term>
834
 
<listitem><simpara>
835
 
</simpara></listitem></varlistentry>
836
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
837
 
</simpara></listitem></varlistentry>
838
 
</variablelist></refsect2>
839
 
<refsect2 id="weather-info-get-value-conditions" role="function">
840
 
<title>weather_info_get_value_conditions ()</title>
841
 
<indexterm zone="weather-info-get-value-conditions"><primary>weather_info_get_value_conditions</primary></indexterm>
842
 
<programlisting><link linkend="gboolean">gboolean</link>            weather_info_get_value_conditions   (<link linkend="WeatherInfo">WeatherInfo</link> *info,
843
 
                                                         <link linkend="WeatherConditionPhenomenon">WeatherConditionPhenomenon</link> *phenomenon,
844
 
                                                         <link linkend="WeatherConditionQualifier">WeatherConditionQualifier</link> *qualifier);</programlisting>
845
 
<para>
846
 
</para><variablelist role="params">
847
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
848
 
<listitem><simpara>
849
 
</simpara></listitem></varlistentry>
850
 
<varlistentry><term><parameter>phenomenon</parameter>&#160;:</term>
851
 
<listitem><simpara>
852
 
</simpara></listitem></varlistentry>
853
 
<varlistentry><term><parameter>qualifier</parameter>&#160;:</term>
854
 
<listitem><simpara>
855
 
</simpara></listitem></varlistentry>
856
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
857
 
</simpara></listitem></varlistentry>
858
 
</variablelist></refsect2>
859
 
<refsect2 id="weather-info-get-value-temp" role="function">
860
 
<title>weather_info_get_value_temp ()</title>
861
 
<indexterm zone="weather-info-get-value-temp"><primary>weather_info_get_value_temp</primary></indexterm>
862
 
<programlisting><link linkend="gboolean">gboolean</link>            weather_info_get_value_temp         (<link linkend="WeatherInfo">WeatherInfo</link> *info,
863
 
                                                         <link linkend="TempUnit">TempUnit</link> unit,
864
 
                                                         <link linkend="gdouble">gdouble</link> *value);</programlisting>
865
 
<para>
866
 
</para><variablelist role="params">
867
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
868
 
<listitem><simpara>
869
 
</simpara></listitem></varlistentry>
870
 
<varlistentry><term><parameter>unit</parameter>&#160;:</term>
871
 
<listitem><simpara>
872
 
</simpara></listitem></varlistentry>
873
 
<varlistentry><term><parameter>value</parameter>&#160;:</term>
874
 
<listitem><simpara>
875
 
</simpara></listitem></varlistentry>
876
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
877
 
</simpara></listitem></varlistentry>
878
 
</variablelist></refsect2>
879
 
<refsect2 id="weather-info-get-value-temp-min" role="function">
880
 
<title>weather_info_get_value_temp_min ()</title>
881
 
<indexterm zone="weather-info-get-value-temp-min"><primary>weather_info_get_value_temp_min</primary></indexterm>
882
 
<programlisting><link linkend="gboolean">gboolean</link>            weather_info_get_value_temp_min     (<link linkend="WeatherInfo">WeatherInfo</link> *info,
883
 
                                                         <link linkend="TempUnit">TempUnit</link> unit,
884
 
                                                         <link linkend="gdouble">gdouble</link> *value);</programlisting>
885
 
<para>
886
 
</para><variablelist role="params">
887
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
888
 
<listitem><simpara>
889
 
</simpara></listitem></varlistentry>
890
 
<varlistentry><term><parameter>unit</parameter>&#160;:</term>
891
 
<listitem><simpara>
892
 
</simpara></listitem></varlistentry>
893
 
<varlistentry><term><parameter>value</parameter>&#160;:</term>
894
 
<listitem><simpara>
895
 
</simpara></listitem></varlistentry>
896
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
897
 
</simpara></listitem></varlistentry>
898
 
</variablelist></refsect2>
899
 
<refsect2 id="weather-info-get-value-temp-max" role="function">
900
 
<title>weather_info_get_value_temp_max ()</title>
901
 
<indexterm zone="weather-info-get-value-temp-max"><primary>weather_info_get_value_temp_max</primary></indexterm>
902
 
<programlisting><link linkend="gboolean">gboolean</link>            weather_info_get_value_temp_max     (<link linkend="WeatherInfo">WeatherInfo</link> *info,
903
 
                                                         <link linkend="TempUnit">TempUnit</link> unit,
904
 
                                                         <link linkend="gdouble">gdouble</link> *value);</programlisting>
905
 
<para>
906
 
</para><variablelist role="params">
907
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
908
 
<listitem><simpara>
909
 
</simpara></listitem></varlistentry>
910
 
<varlistentry><term><parameter>unit</parameter>&#160;:</term>
911
 
<listitem><simpara>
912
 
</simpara></listitem></varlistentry>
913
 
<varlistentry><term><parameter>value</parameter>&#160;:</term>
914
 
<listitem><simpara>
915
 
</simpara></listitem></varlistentry>
916
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
917
 
</simpara></listitem></varlistentry>
918
 
</variablelist></refsect2>
919
 
<refsect2 id="weather-info-get-value-dew" role="function">
920
 
<title>weather_info_get_value_dew ()</title>
921
 
<indexterm zone="weather-info-get-value-dew"><primary>weather_info_get_value_dew</primary></indexterm>
922
 
<programlisting><link linkend="gboolean">gboolean</link>            weather_info_get_value_dew          (<link linkend="WeatherInfo">WeatherInfo</link> *info,
923
 
                                                         <link linkend="TempUnit">TempUnit</link> unit,
924
 
                                                         <link linkend="gdouble">gdouble</link> *value);</programlisting>
925
 
<para>
926
 
</para><variablelist role="params">
927
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
928
 
<listitem><simpara>
929
 
</simpara></listitem></varlistentry>
930
 
<varlistentry><term><parameter>unit</parameter>&#160;:</term>
931
 
<listitem><simpara>
932
 
</simpara></listitem></varlistentry>
933
 
<varlistentry><term><parameter>value</parameter>&#160;:</term>
934
 
<listitem><simpara>
935
 
</simpara></listitem></varlistentry>
936
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
937
 
</simpara></listitem></varlistentry>
938
 
</variablelist></refsect2>
939
 
<refsect2 id="weather-info-get-value-apparent" role="function">
940
 
<title>weather_info_get_value_apparent ()</title>
941
 
<indexterm zone="weather-info-get-value-apparent"><primary>weather_info_get_value_apparent</primary></indexterm>
942
 
<programlisting><link linkend="gboolean">gboolean</link>            weather_info_get_value_apparent     (<link linkend="WeatherInfo">WeatherInfo</link> *info,
943
 
                                                         <link linkend="TempUnit">TempUnit</link> unit,
944
 
                                                         <link linkend="gdouble">gdouble</link> *value);</programlisting>
945
 
<para>
946
 
</para><variablelist role="params">
947
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
948
 
<listitem><simpara>
949
 
</simpara></listitem></varlistentry>
950
 
<varlistentry><term><parameter>unit</parameter>&#160;:</term>
951
 
<listitem><simpara>
952
 
</simpara></listitem></varlistentry>
953
 
<varlistentry><term><parameter>value</parameter>&#160;:</term>
954
 
<listitem><simpara>
955
 
</simpara></listitem></varlistentry>
956
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
957
 
</simpara></listitem></varlistentry>
958
 
</variablelist></refsect2>
959
 
<refsect2 id="weather-info-get-value-wind" role="function">
960
 
<title>weather_info_get_value_wind ()</title>
961
 
<indexterm zone="weather-info-get-value-wind"><primary>weather_info_get_value_wind</primary></indexterm>
962
 
<programlisting><link linkend="gboolean">gboolean</link>            weather_info_get_value_wind         (<link linkend="WeatherInfo">WeatherInfo</link> *info,
963
 
                                                         <link linkend="SpeedUnit">SpeedUnit</link> unit,
964
 
                                                         <link linkend="gdouble">gdouble</link> *speed,
965
 
                                                         <link linkend="WeatherWindDirection">WeatherWindDirection</link> *direction);</programlisting>
966
 
<para>
967
 
</para><variablelist role="params">
968
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
969
 
<listitem><simpara>
970
 
</simpara></listitem></varlistentry>
971
 
<varlistentry><term><parameter>unit</parameter>&#160;:</term>
972
 
<listitem><simpara>
973
 
</simpara></listitem></varlistentry>
974
 
<varlistentry><term><parameter>speed</parameter>&#160;:</term>
975
 
<listitem><simpara>
976
 
</simpara></listitem></varlistentry>
977
 
<varlistentry><term><parameter>direction</parameter>&#160;:</term>
978
 
<listitem><simpara>
979
 
</simpara></listitem></varlistentry>
980
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
981
 
</simpara></listitem></varlistentry>
982
 
</variablelist></refsect2>
983
 
<refsect2 id="weather-info-get-value-pressure" role="function">
984
 
<title>weather_info_get_value_pressure ()</title>
985
 
<indexterm zone="weather-info-get-value-pressure"><primary>weather_info_get_value_pressure</primary></indexterm>
986
 
<programlisting><link linkend="gboolean">gboolean</link>            weather_info_get_value_pressure     (<link linkend="WeatherInfo">WeatherInfo</link> *info,
987
 
                                                         <link linkend="PressureUnit">PressureUnit</link> unit,
988
 
                                                         <link linkend="gdouble">gdouble</link> *value);</programlisting>
989
 
<para>
990
 
</para><variablelist role="params">
991
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
992
 
<listitem><simpara>
993
 
</simpara></listitem></varlistentry>
994
 
<varlistentry><term><parameter>unit</parameter>&#160;:</term>
995
 
<listitem><simpara>
996
 
</simpara></listitem></varlistentry>
997
 
<varlistentry><term><parameter>value</parameter>&#160;:</term>
998
 
<listitem><simpara>
999
 
</simpara></listitem></varlistentry>
1000
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
1001
 
</simpara></listitem></varlistentry>
1002
 
</variablelist></refsect2>
1003
 
<refsect2 id="weather-info-get-value-visibility" role="function">
1004
 
<title>weather_info_get_value_visibility ()</title>
1005
 
<indexterm zone="weather-info-get-value-visibility"><primary>weather_info_get_value_visibility</primary></indexterm>
1006
 
<programlisting><link linkend="gboolean">gboolean</link>            weather_info_get_value_visibility   (<link linkend="WeatherInfo">WeatherInfo</link> *info,
1007
 
                                                         <link linkend="DistanceUnit">DistanceUnit</link> unit,
1008
 
                                                         <link linkend="gdouble">gdouble</link> *value);</programlisting>
1009
 
<para>
1010
 
</para><variablelist role="params">
1011
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
1012
 
<listitem><simpara>
1013
 
</simpara></listitem></varlistentry>
1014
 
<varlistentry><term><parameter>unit</parameter>&#160;:</term>
1015
 
<listitem><simpara>
1016
 
</simpara></listitem></varlistentry>
1017
 
<varlistentry><term><parameter>value</parameter>&#160;:</term>
1018
 
<listitem><simpara>
1019
 
</simpara></listitem></varlistentry>
1020
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
1021
 
</simpara></listitem></varlistentry>
1022
 
</variablelist></refsect2>
1023
 
<refsect2 id="weather-info-get-value-sunrise" role="function">
1024
 
<title>weather_info_get_value_sunrise ()</title>
1025
 
<indexterm zone="weather-info-get-value-sunrise"><primary>weather_info_get_value_sunrise</primary></indexterm>
1026
 
<programlisting><link linkend="gboolean">gboolean</link>            weather_info_get_value_sunrise      (<link linkend="WeatherInfo">WeatherInfo</link> *info,
1027
 
                                                         <link linkend="time-t">time_t</link> *value);</programlisting>
1028
 
<para>
1029
 
</para><variablelist role="params">
1030
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
1031
 
<listitem><simpara>
1032
 
</simpara></listitem></varlistentry>
1033
 
<varlistentry><term><parameter>value</parameter>&#160;:</term>
1034
 
<listitem><simpara>
1035
 
</simpara></listitem></varlistentry>
1036
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
1037
 
</simpara></listitem></varlistentry>
1038
 
</variablelist></refsect2>
1039
 
<refsect2 id="weather-info-get-value-sunset" role="function">
1040
 
<title>weather_info_get_value_sunset ()</title>
1041
 
<indexterm zone="weather-info-get-value-sunset"><primary>weather_info_get_value_sunset</primary></indexterm>
1042
 
<programlisting><link linkend="gboolean">gboolean</link>            weather_info_get_value_sunset       (<link linkend="WeatherInfo">WeatherInfo</link> *info,
1043
 
                                                         <link linkend="time-t">time_t</link> *value);</programlisting>
1044
 
<para>
1045
 
</para><variablelist role="params">
1046
 
<varlistentry><term><parameter>info</parameter>&#160;:</term>
1047
 
<listitem><simpara>
1048
 
</simpara></listitem></varlistentry>
1049
 
<varlistentry><term><parameter>value</parameter>&#160;:</term>
1050
 
<listitem><simpara>
1051
 
</simpara></listitem></varlistentry>
1052
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
1053
 
</simpara></listitem></varlistentry>
1054
 
</variablelist></refsect2>
1055
 
 
1056
 
</refsect1>
1057
 
 
1058
 
</refentry>