| 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 info was last updated. [out][type glong]
|
Returns : |
TRUE is value is 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 sky is 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 value is 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 value is 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 value is 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 value is 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 value is 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 speed and direction are 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 value is 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 value is 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 value is 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 value is 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 value is valid, FALSE otherwise. |
gboolean gweather_info_get_upcoming_moonphases (GWeatherInfo *info,time_t *phases);