Understanding MapGuide Resources
================================

.. todo::
    Currently copy/paste of existing wiki content

Before you can start using MapGuide Maestro, you must understand how MapGuide divides the different parts that make up a map. To understand the MapGuide Maestro interface, you must also have a knowledgde of the names used in MapGuide. 

.. todo::
    Detail the features offered with each schema revision. Most of this already is covered in resource-readme.txt in the Maestro source code.

There are many types of resources that can be stored in a MapGuide Server

Feature Sources
^^^^^^^^^^^^^^^

Introduced: MapGuide Open Source 1.0 / MapGuide Enterprise 2007

Version(s): 

 * 1.0.0 - MapGuide Open Source 1.0 / MapGuide Enterprise 2007

Feature Sources describe a FDO connection to a particular data store, which could be inside the MapGuide Server or stored externally. (see below: Spatial Data and Regular Data)

Drawing Sources
^^^^^^^^^^^^^^^

Introduced: MapGuide Open Source 1.0 / MapGuide Enterprise 2007

Version(s): 

 * 1.0.0 - MapGuide Open Source 1.0 / MapGuide Enterprise 2007

Drawing Sources are DWF data sources which provide drawing data with full visual fidelity. 

Layer Definitions
^^^^^^^^^^^^^^^^^

Introduced: MapGuide Open Source 1.0 / MapGuide Enterprise 2007

Version(s): 

 * 1.0.0 - MapGuide Open Source 1.0 / MapGuide Enterprise 2007
 * 1.1.0 - MapGuide Open Source 1.2 / MapGuide Enterprise 2008
 * 1.2.0 - MapGuide Open Source 2.0 / MapGuide Enterprise 2009
 * 1.3.0 - MapGuide Open Source 2.1 / MapGuide Enterprise 2010

Layer Definitions describe how data from a Feature Source is to be styled. (see below: Displaying Data)

Layer Definitions are can be shared among different maps.

Map Definitions
^^^^^^^^^^^^^^^

Introduced: MapGuide Open Source 1.0 / MapGuide Enterprise 2007

Version(s): 

 * 1.0.0 - MapGuide Open Source 1.0 / MapGuide Enterprise 2007
 * 2.3.0 - MapGuide Open Source 2.3 / MapGuide Enterprise 2012

Map Definitions contains one or more Layer Definitions grouped together and sorted by drawing order.

Web Layouts
^^^^^^^^^^^

Introduced: MapGuide Open Source 1.0 / MapGuide Enterprise 2007

Version(s): 

 * 1.0.0 - MapGuide Open Source 1.0 / MapGuide Enterprise 2007
 * 1.1.0 - MapGuide Open Source 2.2 / MapGuide Enterprise 2011

Describes the user interface for the AJAX viewer (see: Understanding MapGuide Applications - Web Layouts)

Application Definitions
^^^^^^^^^^^^^^^^^^^^^^^

Introduced: MapGuide Open Source 2.0 / MapGuide Enterprise 2009

Version(s): 

 * 1.0.0 - MapGuide Open Source 2.0 / MapGuide Enterprise 2009

Describes the user interface for the Fusion viewer (see: Understanding MapGuide Applications - Application Definitions)

Load Procedures
^^^^^^^^^^^^^^^

Introduced: MapGuide Open Source 1.0 / MapGuide Enterprise 2007

Version(s): 
 
 * 1.0.0 - MapGuide Open Source 1.0 / MapGuide Enterprise 2007
 * 1.1.0 - MapGuide Open Source 2.0 / MapGuide Enterprise 2009
 * 2.2.0 - MapGuide Open Source 2.2 / MapGuide Enterprise 2011

Describes to a client application like MapGuide Studio, how to load a set of data files into the MapGuide Server

Print Layouts
^^^^^^^^^^^^^

Introduced: MapGuide Open Source 1.0 / MapGuide Enterprise 2007

Version(s): 

 * 1.0.0 - MapGuide Open Source 1.0 / MapGuide Enterprise 2007

Describes the printing layout for a DWF plot operation

Symbol Libraries
^^^^^^^^^^^^^^^^

Introduced: MapGuide Open Source 1.0 / MapGuide Enterprise 2007

Version(s): 

 * 1.0.0 - MapGuide Open Source 1.0 / MapGuide Enterprise 2007

Describes a collection of DWF-based symbols that can be used for point styles in a Layer Definitions

There is no specialized editor support for Symbol Libraries. Opening Symbol Libraries will default to the generic XML editor.

Symbol Definitions
^^^^^^^^^^^^^^^^^^

Introduced: MapGuide Open Source 1.2 / MapGuide Enterprise 2008

Version(s): 

 * 1.0.0 - MapGuide Open Source 1.2 / MapGuide Enterprise 2008
 * 1.1.0 - MapGuide Open Source 2.0 / MapGuide Enterprise 2009

Describes a cartographic symbol, which has lots of display and customisation parameters. Used by Layer Definitions.

There is no specialized editor support for Symbol Definitions. Opening Symbol Definitions will default to the generic XML editor.

Watermark Definitions
^^^^^^^^^^^^^^^^^^^^^

Introduced: MapGuide Open Source 2.3 / MapGuide Enterprise 2012

Version(s): 

 * 2.3.0 - MapGuide Open Source 2.3 / MapGuide Enterprise 2012

Describes a watermark that is rendered as part of the map when viewing it. Used by Map Definitions.

There is no specialized editor support for Watermark Definitions. Opening Watermark Definitions will default to the generic XML editor.