jDip

Creating Variant Maps

Maps

jDip uses maps in SVG format. SVG is a structured ("vector") graphics format, in some ways similar to Flash, and different from a bitmap format like Paint or Photoshop. However, bitmapped maps can be created and used in an SVG file; for an example, see the Detailed Standard Variant map.

While the creation of SVG is beyond the scope of this document, the goal is to discuss the structure of the SVG (including jDip-specific XML tags) maps so that they can be properly used within jDip. jDip requires a certain structure to the SVG, because all graphical operations occur by manipulating the SVG document.

Learning by example is perhaps the best method (and the only method, until this document is complete!). To help, any of the variant packages may be uncompressed (they are in .zip format). The SVG files can be opened with a text editor.

Tools Needed

TODO: discuss needed tools. Editor, SVG display program, etc.

Basic SVG Structure

TODO: discuss basic tags and structure needed so that jDip can read and properly display the SVG.

jDip-Specific Namespace Additions

TODO: discuss the jdipNS: tags and how they are used.

A Simple Map

TODO: a very very simple map with two or three spaces that can be loaded and works.