|Geocvpf Reference Manual|
Vector Product Format (VPF) is a geo-relational format developed by the National Geospatial Intelligence Agency. It is specified by MIL-STD-600006. VPF is the format used in Digital Nautical Charts. Geocvpf provides a set of GObjects that facilitate drawing information from a VPF database onto the GeocCanvas widget.
The only GObject that is strictly required for rendering VPF isGeocvpfCanvasTheme. This object handles the querying, drawing, and management of a single library, coverage, feature class, and expression combination.
This example creates a simple theme.
/* The GeocvpfCanvasTheme is used to display all feature types - edge, face, * entity_node, connected_node, and text. * * library_path: location of the library. Use of directory path can be avoided * by using the GeocvpfDatabaseLookup object. * * coverage: a set of topologically related feature classes. Earth coverage in * in this case. * * feature_class: features that share a homogenous set of attributes. Earth * coverage areas in this case. * * expression: thematic information (a limited database query). * This example queries for land and island coverage. */ geoc_item_new(group, GEOCVPF_TYPE_THEME, "library-path", "/home/username/dnc/dnc17/a1707420", "coverage", "ecr", "feature-class", "ecrarea", "expression", "F_CODE=BA030 or F_CODE=DA010", "fill-color-rgba", 0xBDAF1Bff, NULL);
The VPF database structure looks something like this:
Database (e.g. DNC17) - Library (e.g. a1707420 approach chart) - coverage (e.g. ecr) - feature class (e.g. ecrarea) -expression (e.g. F_CODE, etc.)
To discover how to properly set up the coverage, feature class, and expression
properties of the theme, there is a program included in the geocvpf directory of
this package called
geocvpfprint. Use the -h option to see
the usage. This program can provide a detailed list of what is available in the
for the VPF databases being used.
The use of a directory path in the "library_path" property is not required if
the GeocvpfDatabasLookup is used. A
VPF database can consist of 100 or more libraries. In some cases it might be
necessary to browse through multiple databases. The
GeocvpfDatabaseLookup object simplifies finding the
a library by building a hash table at construction time. It builds the has
table based on a pre-defined colon delimited directory search path. When the
GeocvpfDatabaseLookup object has been initialized, it is
necessary only to specify the library_name to the theme.
Here is the example again using the
/* The database lookup is a singleton object. The directory search path is * is colon delimited. */ g_object_new(GEOCVPF_TYPE_DATABASE_LOOKUP, "search_path", "/home/username/dnc:/media/DNC17", NULL); geoc_item_new(group, GEOCVPF_TYPE_THEME, "library-path", "a1707420", "coverage", "ecr", "feature-class", "ecrarea", "expression", "F_CODE=BA030 or F_CODE=DA010", "fill-color-rgba", 0xBDAF1Bff, NULL);
To simplify things even further, it is possible to not use the "library_path"
property at all. The GeocvpfLibrarySelector and
GeocvpfCanvasView objects can be used to partially
automate the selection of the appropriate library. The
GeocvpfLibrarySelector can be used to determine the list
of libraries from the database search path that fit the current
GeocCanvas viewport. It connects to the
GeocCanvas viewport-changed signal. Whenever the
viewport changes, it searches the list of available libraries from the
GeocvpfDatabaseLookup object and reports the subset that
is equal or larger in size and location to current viewport.
Each time the viewport changes,
emits three signals. The first signal, the select-event,
indicates that a library is available for selection. This event is emitted once
for each of the available libraries until a listener returns a TRUE value. If a
TRUE value is returned, that library is marked to be selected, otherwise the
library at the head of the list is marked. The second signal is a notify on the
available_libraries property. The available _libraries is a linked list of all
libraries that fit the current viewport. Finally, a notify is issued on the
selected_library property if it is different than the proeviously selected
The GeocvpfCanvasView object is a
simple canvas group that connects to the
GeocvpfCanvasSelector. It has special logic to select an
appropriate library based on its library_pattern property and pass the
library_name into is child
GeocvpfCanvasTheme objects. A
GeocvpfCanvasView can be thought of as a set of themes
that should be applied to specific type of library.
Here is an example of how to use the
/* The library selector needs to be told which canvas to connect to. * After that, all views will look for a singleton instance unless the * view "library-selector" property is set explicitly. */ selector = g_object_new(GEOCVPF_TYPE_LIBRARY_SELECTOR, "geocanvas", canvas, NULL); /* This view will activate select any library that begins with "g". * DNC, this is a "general" library. */ general = geoc_item_new(group, GEOCVPF_TYPE_VIEW, "library_pattern", "g*", NULL); /* This item will draw water */ geoc_item_new(general, GEOCVPF_TYPE_THEME, "coverage", "ecr", "feature_class", "ecrarea", "expression", "F_CODE=BA040", "fill_color_rgba", 0xD1F4FFFF, NULL); /* This item will draw mainland and islands */ geoc_item_new(general, GEOCVPF_TYPE_THEME, "coverage", "ecr", "feature_class", "ecrarea", "expression", "F_CODE=BA030 or F_CODE=DA010", "fill_color_rgba", 0xBDAF1Bff, NULL); /* This item will draw text features. */ geoc_item_new(general, GEOCVPF_TYPE_THEME, "coverage", "ecr", "feature_class", "ecrtext", "fill_color_rgba", 0x000000FF, NULL);