![]() |
![]() |
![]() |
Gypsy Reference Manual | |
---|---|---|---|---|
GypsySatellite; #define GYPSY_SATELLITE_DBUS_INTERFACE #define GYPSY_SATELLITE_DBUS_SERVICE GypsySatelliteDetails; GypsySatellite* gypsy_satellite_new (const char *object_path); GPtrArray* gypsy_satellite_get_satellites (GypsySatellite *satellite, GError **error); void gypsy_satellite_free_satellite_array (GPtrArray *satellites);
GypsySatellite is used whenever the client program wishes to know about changes in the satellite details.
typedef struct _GypsySatellite GypsySatellite;
There are no public fields in GypsySatellite.
#define GYPSY_SATELLITE_DBUS_INTERFACE "org.freedesktop.Gypsy.Satellite"
A define containing the name of the Satellite interface
#define GYPSY_SATELLITE_DBUS_SERVICE "org.freedesktop.Gypsy"
A define containing the address of the Satellite service.
typedef struct { int satellite_id; gboolean in_use; guint elevation; guint azimuth; guint snr; } GypsySatelliteDetails;
A structure defining a satellite
int satellite_id ; |
The satellite PRN id |
gboolean in_use ; |
Whether this satellite was used in calculating the fix |
guint elevation ; |
The satellite elevation |
guint azimuth ; |
The satellite azimuth |
guint snr ; |
The signal to noise ratio |
GypsySatellite* gypsy_satellite_new (const char *object_path);
Creates a new GypsySatellite object that listens for satellite changes
from the GPS found at object_path
.
object_path : |
Object path to the GPS device |
Returns : | A GypsySatellite object |
GPtrArray* gypsy_satellite_get_satellites (GypsySatellite *satellite, GError **error);
Retrieves the GypsySatelliteDetails about the satellites that the GPS is able to see.
satellite : |
A GypsySatellite |
error : |
A GError for error return |
Returns : | A GPtrArray of GypsySatelliteDetails or NULL on error.
Should be freed using gypsy_satellite_free_satellite_array() .
|
void gypsy_satellite_free_satellite_array (GPtrArray *satellites);
Frees all resources used in the array.
satellites : |
GPtrArray containing GypsySatelliteDetails |
void user_function (GypsySatellite *satellites, gpointer arg1, gpointer user_data) : Run Last
The ::satellites-changed signal is emitted every time the GPS reports a change in the satellite data.
satellites : |
A GPtrArray containing GypsySatelliteDetails |
user_data : |
user data set when the signal handler was connected. |