Update API docs

[grits] / src / gis-tile.h

diff --git a/src/gis-tile.h b/src/gis-tile.h
index cda4442be6de3450be53b4da2ec638f41e4c6650..b7e912336aee50663daad59a8e91acbff7b2bc2b 100644 (file)
--- a/src/gis-tile.h
+++ b/src/gis-tile.h
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2009 Andy Spencer <spenceal@rose-hulman.edu>
+ * Copyright (C) 2009-2010 Andy Spencer <andy753421@gmail.com>
  *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -18,24 +18,19 @@
 #ifndef __GIS_TILE_H__
 #define __GIS_TILE_H__
 
-#include <config.h>
 #include <glib.h>
+#include "gis-object.h"
 
-typedef struct _GisTile        GisTile;
+#define GIS_TYPE_TILE (gis_tile_get_type())
 
-#define gis_tile_foreach(tile, child) \
-       for (int _x = 0; _x < G_N_ELEMENTS(tile->children); _x++) \
-       for (int _y = 0; child = tile->children[_x][_y], \
-               _y < G_N_ELEMENTS(tile->children[_x]); _y++) \
-
-#define gis_tile_foreach_index(tile, x, y) \
-       for (x = 0; x < G_N_ELEMENTS(tile->children); x++) \
-       for (y = 0; y < G_N_ELEMENTS(tile->children[x]); y++)
-
-typedef void (*GisTileLoadFunc)(GisTile *tile, gpointer user_data);
-typedef void (*GisTileFreeFunc)(GisTile *tile, gpointer user_data);
+GOBJECT_HEAD(
+       GIS, TILE,
+       Gis, Tile,
+       gis, tile);
 
 struct _GisTile {
+       GisObject  parent_instance;
+
        /* Pointer to the tile data */
        gpointer data;
 
@@ -52,7 +47,24 @@ struct _GisTile {
        time_t atime;
 };
 
-/* Path to string table, keep in sync with tile->children */ 
+struct _GisTileClass {
+       GisObjectClass parent_class;
+};
+
+typedef void (*GisTileLoadFunc)(GisTile *tile, gpointer user_data);
+typedef void (*GisTileFreeFunc)(GisTile *tile, gpointer user_data);
+
+/* Forech functions */
+#define gis_tile_foreach(tile, child) \
+       for (int _x = 0; _x < G_N_ELEMENTS(tile->children); _x++) \
+       for (int _y = 0; child = tile->children[_x][_y], \
+               _y < G_N_ELEMENTS(tile->children[_x]); _y++) \
+
+#define gis_tile_foreach_index(tile, x, y) \
+       for (x = 0; x < G_N_ELEMENTS(tile->children); x++) \
+       for (y = 0; y < G_N_ELEMENTS(tile->children[x]); y++)
+
+/* Path to string table, keep in sync with tile->children */
 extern gchar *gis_tile_path_table[2][2];
 
 /* Allocate a new Tile */
@@ -69,6 +81,9 @@ void gis_tile_update(GisTile *root,
                gdouble lat, gdouble lon, gdouble elev,
                GisTileLoadFunc load_func, gpointer user_data);
 
+/* Find the leaf tile containing lat-lon */
+GisTile *gis_tile_find(GisTile *root, gdouble lat, gdouble lon);
+
 /* Delete nodes that haven't been accessed since atime */
 GisTile *gis_tile_gc(GisTile *root, time_t atime,
                GisTileFreeFunc free_func, gpointer user_data);