|  |  |  | libgweather-3.0 Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
struct GWeatherInfo; void (*GWeatherInfoFunc) (GWeatherInfo *info,gpointer data); GWeatherInfo * gweather_info_new (GWeatherLocation *location,GWeatherForecastType forecast_type); void gweather_info_update (GWeatherInfo *info); void gweather_info_abort (GWeatherInfo *info); gboolean gweather_info_is_valid (GWeatherInfo *info); gboolean gweather_info_network_error (GWeatherInfo *info); const GWeatherLocation * gweather_info_get_location (GWeatherInfo *info); gchar * gweather_info_get_location_name (GWeatherInfo *info); gchar * gweather_info_get_update (GWeatherInfo *info); gchar * gweather_info_get_sky (GWeatherInfo *info); gchar * gweather_info_get_conditions (GWeatherInfo *info); gchar * gweather_info_get_temp (GWeatherInfo *info); gchar * gweather_info_get_temp_min (GWeatherInfo *info); gchar * gweather_info_get_temp_max (GWeatherInfo *info); gchar * gweather_info_get_dew (GWeatherInfo *info); gchar * gweather_info_get_humidity (GWeatherInfo *info); gchar * gweather_info_get_wind (GWeatherInfo *info); gchar * gweather_info_get_pressure (GWeatherInfo *info); gchar * gweather_info_get_visibility (GWeatherInfo *info); gchar * gweather_info_get_apparent (GWeatherInfo *info); gchar * gweather_info_get_sunrise (GWeatherInfo *info); gchar * gweather_info_get_sunset (GWeatherInfo *info); gchar * gweather_info_get_forecast (GWeatherInfo *info); GSList * gweather_info_get_forecast_list (GWeatherInfo *info); GdkPixbufAnimation * gweather_info_get_radar (GWeatherInfo *info); gchar * gweather_info_get_temp_summary (GWeatherInfo *info); gchar * gweather_info_get_weather_summary (GWeatherInfo *info); const gchar * gweather_info_get_icon_name (GWeatherInfo *info); gint gweather_info_next_sun_event (GWeatherInfo *info); gboolean gweather_info_get_value_update (GWeatherInfo *info,time_t *value); gboolean gweather_info_get_value_sky (GWeatherInfo *info,GWeatherSky *sky); gboolean gweather_info_get_value_conditions (GWeatherInfo *info,GWeatherConditionPhenomenon *phenomenon,GWeatherConditionQualifier *qualifier); gboolean gweather_info_get_value_temp (GWeatherInfo *info,GWeatherTemperatureUnit unit,gdouble *value); gboolean gweather_info_get_value_temp_min (GWeatherInfo *info,GWeatherTemperatureUnit unit,gdouble *value); gboolean gweather_info_get_value_temp_max (GWeatherInfo *info,GWeatherTemperatureUnit unit,gdouble *value); gboolean gweather_info_get_value_dew (GWeatherInfo *info,GWeatherTemperatureUnit unit,gdouble *value); gboolean gweather_info_get_value_apparent (GWeatherInfo *info,GWeatherTemperatureUnit unit,gdouble *value); gboolean gweather_info_get_value_wind (GWeatherInfo *info,GWeatherSpeedUnit unit,gdouble *speed,GWeatherWindDirection *direction); gboolean gweather_info_get_value_pressure (GWeatherInfo *info,GWeatherPressureUnit unit,gdouble *value); gboolean gweather_info_get_value_visibility (GWeatherInfo *info,GWeatherDistanceUnit unit,gdouble *value); gboolean gweather_info_get_value_sunrise (GWeatherInfo *info,time_t *value); gboolean gweather_info_get_value_sunset (GWeatherInfo *info,time_t *value); gboolean gweather_info_get_value_moonphase (GWeatherInfo *info,GWeatherMoonPhase *value,GWeatherMoonLatitude *lat); gboolean gweather_info_get_upcoming_moonphases (GWeatherInfo *info,time_t *phases);
GWeatherInfo * gweather_info_new (GWeatherLocation *location,GWeatherForecastType forecast_type);
Builds a new GWeatherInfo that will provide weather information about
location. The returned info will not be ready until the ::updated signal
is emitted.
| 
 | the desidered GWeatherLocation (NULL for default). [allow-none] | 
| 
 | the type of forecast requested | 
| Returns : | a new GWeatherInfo. [transfer full] | 
const GWeatherLocation * gweather_info_get_location     (GWeatherInfo *info);
GSList *            gweather_info_get_forecast_list     (GWeatherInfo *info);
| 
 | a GWeatherInfo | 
| Returns : | list of GWeatherInfo* objects for the forecast. The list is owned by the 'info' object thus is alive as long as the 'info'. This list is filled only when requested with type FORECAST_LIST and if available for given location. The 'update' property is the date/time when the forecast info is used for. [transfer none][element-type GWeather.Info] | 
GdkPixbufAnimation * gweather_info_get_radar            (GWeatherInfo *info);
| 
 | a GWeatherInfo | 
| Returns : | what?. [transfer none] | 
gchar *             gweather_info_get_weather_summary   (GWeatherInfo *info);
| 
 | a GWeatherInfo | 
| Returns : | a summary for current weather conditions. [transfer full] | 
gboolean gweather_info_get_value_update (GWeatherInfo *info,time_t *value);
| 
 | a GWeatherInfo | 
| 
 | the time infowas last updated. [out][type glong] | 
| Returns : | TRUE is valueis valid, FALSE otherwise. | 
gboolean gweather_info_get_value_sky (GWeatherInfo *info,GWeatherSky *sky);
Fills out sky with current sky conditions.
| 
 | a GWeatherInfo | 
| 
 | a location for a GWeatherSky. [out] | 
| Returns : | TRUE is skyis valid, FALSE otherwise. | 
gboolean gweather_info_get_value_conditions (GWeatherInfo *info,GWeatherConditionPhenomenon *phenomenon,GWeatherConditionQualifier *qualifier);
Fills out phenomenon and qualifier with current weather conditions.
| 
 | a GWeatherInfo | 
| 
 | a location for a GWeatherConditionPhenomenon. [out] | 
| 
 | a location for a GWeatherConditionQualifier. [out] | 
| Returns : | TRUE is out arguments are valid, FALSE otherwise. | 
gboolean gweather_info_get_value_temp (GWeatherInfo *info,GWeatherTemperatureUnit unit,gdouble *value);
| 
 | a GWeatherInfo | 
| 
 | the desired unit, as a GWeatherTemperatureUnit | 
| 
 | the temperature value. [out] | 
| Returns : | TRUE is valueis valid, FALSE otherwise. | 
gboolean gweather_info_get_value_temp_min (GWeatherInfo *info,GWeatherTemperatureUnit unit,gdouble *value);
| 
 | a GWeatherInfo | 
| 
 | the desired unit, as a GWeatherTemperatureUnit | 
| 
 | the minimum temperature value. [out] | 
| Returns : | TRUE is valueis valid, FALSE otherwise. | 
gboolean gweather_info_get_value_temp_max (GWeatherInfo *info,GWeatherTemperatureUnit unit,gdouble *value);
| 
 | a GWeatherInfo | 
| 
 | the desired unit, as a GWeatherTemperatureUnit | 
| 
 | the maximum temperature value. [out] | 
| Returns : | TRUE is valueis valid, FALSE otherwise. | 
gboolean gweather_info_get_value_dew (GWeatherInfo *info,GWeatherTemperatureUnit unit,gdouble *value);
| 
 | a GWeatherInfo | 
| 
 | the desired unit, as a GWeatherTemperatureUnit | 
| 
 | the dew point. [out] | 
| Returns : | TRUE is valueis valid, FALSE otherwise. | 
gboolean gweather_info_get_value_apparent (GWeatherInfo *info,GWeatherTemperatureUnit unit,gdouble *value);
| 
 | a GWeatherInfo | 
| 
 | the desired unit, as a GWeatherTemperatureUnit | 
| 
 | the apparent temperature. [out] | 
| Returns : | TRUE is valueis valid, FALSE otherwise. | 
gboolean gweather_info_get_value_wind (GWeatherInfo *info,GWeatherSpeedUnit unit,gdouble *speed,GWeatherWindDirection *direction);
| 
 | a GWeatherInfo | 
| 
 | the desired unit, as a GWeatherSpeedUnit | 
| 
 | forecasted wind speed. [out] | 
| 
 | forecasted wind direction. [out] | 
| Returns : | TRUE if speedanddirectionare valid, FALSE otherwise. | 
gboolean gweather_info_get_value_pressure (GWeatherInfo *info,GWeatherPressureUnit unit,gdouble *value);
| 
 | a GWeatherInfo | 
| 
 | the desired unit, as a GWeatherPressureUnit | 
| 
 | forecasted pressure, expressed in unit. [out] | 
| Returns : | TRUE if valueis valid, FALSE otherwise. | 
gboolean gweather_info_get_value_visibility (GWeatherInfo *info,GWeatherDistanceUnit unit,gdouble *value);
| 
 | a GWeatherInfo | 
| 
 | the desired unit, as a GWeatherDistanceUnit | 
| 
 | forecasted visibility, expressed in unit. [out] | 
| Returns : | TRUE if valueis valid, FALSE otherwise. | 
gboolean gweather_info_get_value_sunrise (GWeatherInfo *info,time_t *value);
| 
 | a GWeatherInfo | 
| 
 | the time of sunrise. [out][type gulong] | 
| Returns : | TRUE is valueis valid, FALSE otherwise. | 
gboolean gweather_info_get_value_sunset (GWeatherInfo *info,time_t *value);
| 
 | a GWeatherInfo | 
| 
 | the time of sunset. [out][type gulong] | 
| Returns : | TRUE is valueis valid, FALSE otherwise. | 
gboolean gweather_info_get_value_moonphase (GWeatherInfo *info,GWeatherMoonPhase *value,GWeatherMoonLatitude *lat);
| 
 | a GWeatherInfo | 
| 
 | the current moon phase (represented as the visible percentage). [out] | 
| 
 | the latitude the moon is at (???). [out] | 
| Returns : | TRUE is valueis valid, FALSE otherwise. | 
gboolean gweather_info_get_upcoming_moonphases (GWeatherInfo *info,time_t *phases);