![]() |
![]() |
![]() |
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
);