[mapguide-commits] r10062 - in branches/4.0/MgDev/Doc: . dotnet_api dotnet_api/docs java_api landing
svn_mapguide at osgeo.org
svn_mapguide at osgeo.org
Fri Nov 10 10:20:56 PST 2023
Author: jng
Date: 2023-11-10 10:20:55 -0800 (Fri, 10 Nov 2023)
New Revision: 10062
Added:
branches/4.0/MgDev/Doc/build.bat
branches/4.0/MgDev/Doc/java_api/
branches/4.0/MgDev/Doc/java_api/overview.html
branches/4.0/MgDev/Doc/landing/
branches/4.0/MgDev/Doc/landing/TODO.md
branches/4.0/MgDev/Doc/landing/bib-dana99.md
branches/4.0/MgDev/Doc/landing/bib-egenhofer91.md
branches/4.0/MgDev/Doc/landing/bib-jts14.md
branches/4.0/MgDev/Doc/landing/bib-ogc96-015r1.md
branches/4.0/MgDev/Doc/landing/bib-ogc99-049.md
branches/4.0/MgDev/Doc/landing/bib-osugr.md
branches/4.0/MgDev/Doc/landing/bib-peat.md
branches/4.0/MgDev/Doc/landing/collections.md
branches/4.0/MgDev/Doc/landing/cs-testvalues.md
branches/4.0/MgDev/Doc/landing/cs-wkttosrs.md
branches/4.0/MgDev/Doc/landing/docfx.json
branches/4.0/MgDev/Doc/landing/feature-properties.md
branches/4.0/MgDev/Doc/landing/geom-collections.md
branches/4.0/MgDev/Doc/landing/index.md
branches/4.0/MgDev/Doc/landing/toc.yml
Removed:
branches/4.0/MgDev/Doc/dotnet_api/docs/introduction.md
Modified:
branches/4.0/MgDev/Doc/dotnet_api/docfx.json
branches/4.0/MgDev/Doc/dotnet_api/docs/getting-started.md
branches/4.0/MgDev/Doc/dotnet_api/docs/toc.yml
branches/4.0/MgDev/Doc/dotnet_api/index.md
Log:
#2877:
- Add landing site (also docfx based)
- Start migrating some conceptual topics from doxygen to markdown
- Link these migrated topics
- Add overview page for javadoc
- Add end-to-end build.bat
Added: branches/4.0/MgDev/Doc/build.bat
===================================================================
--- branches/4.0/MgDev/Doc/build.bat (rev 0)
+++ branches/4.0/MgDev/Doc/build.bat 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,17 @@
+ at echo off
+REM TODO: Move to setenviroment64.bat once this is fully fleshed out
+SET LABEL=4.0 RC1
+pushd dotnet_api
+docfx build --metadata _appTitle="MapGuide .net API reference (%LABEL%)"
+popd
+pushd ..\Bindings\src\Managed\Java
+REM NOTE: javadoc may report errors, but that is okay as they are not "derail this build script"-tier errors and the docs
+REM for the affected classes will still be generated, these errors are mostly about malformed tags that are a by-product
+REM of being transferred from the C++ doxygen fragments
+REM TODO: These errors will go away by fixing the comments in question at the C++ source
+javadoc -d ..\..\..\..\Doc\landing\_site\java_api org.osgeo.mapguide -overview ..\..\..\..\Doc\java_api\overview.html -windowtitle "MapGuide Java API reference (%LABEL%)"
+popd
+pushd landing
+docfx build
+popd
+REM todo doctum once we've got IMake to generate doc'd proxy stub classes
\ No newline at end of file
Modified: branches/4.0/MgDev/Doc/dotnet_api/docfx.json
===================================================================
--- branches/4.0/MgDev/Doc/dotnet_api/docfx.json 2023-11-10 16:16:27 UTC (rev 10061)
+++ branches/4.0/MgDev/Doc/dotnet_api/docfx.json 2023-11-10 18:20:55 UTC (rev 10062)
@@ -30,7 +30,7 @@
]
}
],
- "output": "_site",
+ "output": "../landing/_site/dotnet_api",
"template": [
"default",
"modern"
Modified: branches/4.0/MgDev/Doc/dotnet_api/docs/getting-started.md
===================================================================
--- branches/4.0/MgDev/Doc/dotnet_api/docs/getting-started.md 2023-11-10 16:16:27 UTC (rev 10061)
+++ branches/4.0/MgDev/Doc/dotnet_api/docs/getting-started.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -1 +1,19 @@
-# Getting Started
\ No newline at end of file
+# Getting Started
+
+To get started, your application needs to reference the MapGuide API for .net assemblies. You can do this in one of 2 ways below.
+
+## NuGet Packages (recommended)
+
+The MapGuide API for .net is available as packages from nuget.org. New versions of these packages are published with each release of MapGuide.
+
+Simply install the following packges:
+
+ * `OSGeo.MapGuide.Foundation`
+ * `OSGeo.MapGuide.Geometry`
+ * `OSGeo.MapGuide.PlatformBase`
+ * `OSGeo.MapGuide.MapGuideCommon`
+ * `OSGeo.MapGuide.Web`
+
+## Local Packages
+
+Local copies of these nuget packages are also included with a normal MapGuide web tier installation, to use these local nuget packages, either copy/upload these `.nupkg` files to your local nuget registry or set up a package source in your `nuget.config` that points to the directory containing these files
\ No newline at end of file
Deleted: branches/4.0/MgDev/Doc/dotnet_api/docs/introduction.md
===================================================================
--- branches/4.0/MgDev/Doc/dotnet_api/docs/introduction.md 2023-11-10 16:16:27 UTC (rev 10061)
+++ branches/4.0/MgDev/Doc/dotnet_api/docs/introduction.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -1 +0,0 @@
-# Introduction
\ No newline at end of file
Modified: branches/4.0/MgDev/Doc/dotnet_api/docs/toc.yml
===================================================================
--- branches/4.0/MgDev/Doc/dotnet_api/docs/toc.yml 2023-11-10 16:16:27 UTC (rev 10061)
+++ branches/4.0/MgDev/Doc/dotnet_api/docs/toc.yml 2023-11-10 18:20:55 UTC (rev 10062)
@@ -1,4 +1,2 @@
-- name: Introduction
- href: introduction.md
- name: Getting Started
href: getting-started.md
\ No newline at end of file
Modified: branches/4.0/MgDev/Doc/dotnet_api/index.md
===================================================================
--- branches/4.0/MgDev/Doc/dotnet_api/index.md 2023-11-10 16:16:27 UTC (rev 10061)
+++ branches/4.0/MgDev/Doc/dotnet_api/index.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -2,10 +2,6 @@
_layout: landing
---
-# This is the **HOMEPAGE**.
+# Introduction
-Refer to [Markdown](http://daringfireball.net/projects/markdown/) for how to write markdown files.
-
-## Quick Start Notes:
-
-1. Add images to the *images* folder if the file is referencing an image.
\ No newline at end of file
+This is the home of the reference document for the MapGuide API for .net
\ No newline at end of file
Added: branches/4.0/MgDev/Doc/java_api/overview.html
===================================================================
--- branches/4.0/MgDev/Doc/java_api/overview.html (rev 0)
+++ branches/4.0/MgDev/Doc/java_api/overview.html 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,7 @@
+<html>
+ <body>
+ <p>This is the Java reference for the MapGuide API</p>
+ <h2>Using this API</h2>
+ <p>To use the Java bindings for the MapGuide API, the <strong>MapGuideApi.jar</strong> must be in your application's classpath</p>
+ </body>
+</html>
\ No newline at end of file
Index: branches/4.0/MgDev/Doc/landing
===================================================================
--- branches/4.0/MgDev/Doc/landing 2023-11-10 16:16:27 UTC (rev 10061)
+++ branches/4.0/MgDev/Doc/landing 2023-11-10 18:20:55 UTC (rev 10062)
Property changes on: branches/4.0/MgDev/Doc/landing
___________________________________________________________________
Added: svn:ignore
## -0,0 +1 ##
+_site
Added: branches/4.0/MgDev/Doc/landing/TODO.md
===================================================================
--- branches/4.0/MgDev/Doc/landing/TODO.md (rev 0)
+++ branches/4.0/MgDev/Doc/landing/TODO.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,3 @@
+# TODO
+
+Oops! If you got here it means we haven't updated the original link
\ No newline at end of file
Added: branches/4.0/MgDev/Doc/landing/bib-dana99.md
===================================================================
--- branches/4.0/MgDev/Doc/landing/bib-dana99.md (rev 0)
+++ branches/4.0/MgDev/Doc/landing/bib-dana99.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,5 @@
+# Dana99
+
+Dana, P. H., <i>The Geographer's Craft Project</i>, Department of
+Geography, The University of Colorado at Boulder, c1999,
+http://www.colorado.edu/geography/gcraft/notes/datum/datum_f.html
\ No newline at end of file
Added: branches/4.0/MgDev/Doc/landing/bib-egenhofer91.md
===================================================================
--- branches/4.0/MgDev/Doc/landing/bib-egenhofer91.md (rev 0)
+++ branches/4.0/MgDev/Doc/landing/bib-egenhofer91.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,5 @@
+# Egenhofer91
+
+Egenhofer, M.F. and Franzosa, R.D., Point Set Topological
+Spatial Relations, <i>International Journal of Geographical
+Information Systems</i>, vol 5, no 2, 161-174, 1991.
\ No newline at end of file
Added: branches/4.0/MgDev/Doc/landing/bib-jts14.md
===================================================================
--- branches/4.0/MgDev/Doc/landing/bib-jts14.md (rev 0)
+++ branches/4.0/MgDev/Doc/landing/bib-jts14.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,9 @@
+# JTS14
+
+Vivid Solutions, "JTS Topology Suite Technical Specifications", Version 1.4, 2003. Version 1.4 of this specification at
+
+http://www.geotools.org/Working+with+JTS+Geometries+from+DataStores
+
+The latest version of this specification is at
+
+http://www.vividsolutions.com/JTS/JTSHome.htm
\ No newline at end of file
Added: branches/4.0/MgDev/Doc/landing/bib-ogc96-015r1.md
===================================================================
--- branches/4.0/MgDev/Doc/landing/bib-ogc96-015r1.md (rev 0)
+++ branches/4.0/MgDev/Doc/landing/bib-ogc96-015r1.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,44 @@
+# OGC96015R1
+
+<p>
+OpenGIS Consortium Inc., "The OpenGIS Abstract
+Specification: An Object Model For Interoperable
+Geoprocessing," Revision 1, OpenGIS Project Document Number
+96-015R1, 1966.
+</p>
+
+### Document Notice
+<p>Public documents on the OGC site are provided by the copyright holders under the following license.
+The software or Document Type Definitions (DTDs) associated with OGC specifications are governed
+by the Software Notice. By using and/or copying this document, or the OGC
+document from which this statement is linked, you (the licensee) agree that you have read, understood,
+and will comply with the following terms and conditions:</p>
+
+<p>Permission to use, copy, and distribute the contents of this document, or the OGC document from which
+this statement is linked, in any medium for any purpose and without fee or royalty is hereby granted,
+provided that you include the following on <i>ALL</i> copies of the document, or portions thereof, that you use:</p>
+<ol>
+<li>Include a link or URL to the original OGC document.</li>
+<li>The pre-existing copyright notice of the original author, or if it doesn't exist, a notice
+of the form: "Copyright � <date-of-document> Open Geospatial Consortium, Inc. All Rights Reserved.
+http://www.opengeospatial.org/ogc/document (Hypertext is preferred, but a textual representation is permitted.)</li>
+<li><em>If it exists</em>, the STATUS of the OGC document.</li>
+
+</ol>
+<p>When space permits, inclusion of the full text of this <b>NOTICE</b>should be provided. We request
+that authorship attribution be provided in any software, documents, or other items or products that you
+create pursuant to the implementation of the contents of this document, or any portion thereof.</p>
+<p>No right to create modifications or derivatives of OGC documents is granted pursuant to this license.
+However, if additional requirements (documented in the Copyright FAQ) are
+satisfied, the right to create modifications or derivatives is sometimes granted by the OGC to individuals
+complying with those requirements.</p>
+<p>THIS DOCUMENT IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES,
+EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+PURPOSE, NON-INFRINGEMENT, OR TITLE; THAT THE CONTENTS OF THE DOCUMENT ARE SUITABLE FOR ANY PURPOSE; NOR
+THAT THE IMPLEMENTATION OF SUCH CONTENTS WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS</p>
+<p>COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF ANY USE OF THE DOCUMENT OR THE PERFORMANCE OR IMPLEMENTATION OF THE CONTENTS THEREOF.</p>
+<p>The name and trademarks of copyright holders may NOT be used in advertising or publicity pertaining to
+this document or its contents without specific, written prior permission. Title to copyright in this document
+will at all times remain with copyright holders.
+</p>
Added: branches/4.0/MgDev/Doc/landing/bib-ogc99-049.md
===================================================================
--- branches/4.0/MgDev/Doc/landing/bib-ogc99-049.md (rev 0)
+++ branches/4.0/MgDev/Doc/landing/bib-ogc99-049.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,45 @@
+# OGC99049
+
+<p>
+Open GIS Consortium Inc., "OpenGIS Simple
+Features Specification for SQL", Revision 1.1, OpenGIs
+Project Document 99-049, May 5, 1999. To obtain this
+document, go to http://www.opengeospatial.org/specs/. Click
+on "OpenGIS Specifications," and then click on "Simple
+Features - SQL."
+</p>
+<h3>Document Notice</h3>
+<p>Public documents on the OGC site are provided by the copyright holders under the following license.
+The software or Document Type Definitions (DTDs) associated with OGC specifications are governed
+by the Software Notice. By using and/or copying this document, or the OGC
+document from which this statement is linked, you (the licensee) agree that you have read, understood,
+and will comply with the following terms and conditions:</p>
+
+<p>Permission to use, copy, and distribute the contents of this document, or the OGC document from which
+this statement is linked, in any medium for any purpose and without fee or royalty is hereby granted,
+provided that you include the following on <i>ALL</i> copies of the document, or portions thereof, that you use:</p>
+<ol>
+<li>Include a link or URL to the original OGC document.</li>
+<li>The pre-existing copyright notice of the original author, or if it doesn't exist, a notice
+of the form: "Copyright � <date-of-document> Open Geospatial Consortium, Inc. All Rights Reserved.
+http://www.opengeospatial.org/ogc/document (Hypertext is preferred, but a textual representation is permitted.)</li>
+<li><em>If it exists</em>, the STATUS of the OGC document.</li>
+
+</ol>
+<p>When space permits, inclusion of the full text of this <b>NOTICE</b>should be provided. We request
+that authorship attribution be provided in any software, documents, or other items or products that you
+create pursuant to the implementation of the contents of this document, or any portion thereof.</p>
+<p>No right to create modifications or derivatives of OGC documents is granted pursuant to this license.
+However, if additional requirements (documented in the Copyright FAQ) are
+satisfied, the right to create modifications or derivatives is sometimes granted by the OGC to individuals
+complying with those requirements.</p>
+<p>THIS DOCUMENT IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES,
+EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+PURPOSE, NON-INFRINGEMENT, OR TITLE; THAT THE CONTENTS OF THE DOCUMENT ARE SUITABLE FOR ANY PURPOSE; NOR
+THAT THE IMPLEMENTATION OF SUCH CONTENTS WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS</p>
+<p>COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF ANY USE OF THE DOCUMENT OR THE PERFORMANCE OR IMPLEMENTATION OF THE CONTENTS THEREOF.</p>
+<p>The name and trademarks of copyright holders may NOT be used in advertising or publicity pertaining to
+this document or its contents without specific, written prior permission. Title to copyright in this document
+will at all times remain with copyright holders.
+</p>
Added: branches/4.0/MgDev/Doc/landing/bib-osugr.md
===================================================================
--- branches/4.0/MgDev/Doc/landing/bib-osugr.md (rev 0)
+++ branches/4.0/MgDev/Doc/landing/bib-osugr.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,6 @@
+# OSUGR
+
+<p>
+"Oracle Spatial User Guide and Reference", 10g -
+Release 1 (10.1), Part No. B10826-01, Dec 2003.
+</p>
Added: branches/4.0/MgDev/Doc/landing/bib-peat.md
===================================================================
--- branches/4.0/MgDev/Doc/landing/bib-peat.md (rev 0)
+++ branches/4.0/MgDev/Doc/landing/bib-peat.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,6 @@
+# Peat
+
+<p>
+Peat, Chris, Heavens Above website,
+http://www.heavens-above.com/gloss.asp?term=azimuth.
+</p>
\ No newline at end of file
Added: branches/4.0/MgDev/Doc/landing/collections.md
===================================================================
--- branches/4.0/MgDev/Doc/landing/collections.md (rev 0)
+++ branches/4.0/MgDev/Doc/landing/collections.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,18 @@
+# Collections
+
+<p>
+ One of the functions of collections is to serve as a repository for
+ intermediate results. In this role, a collection is a helper class. An
+ example is the construction of an MgLineString geometry. From the
+ perspective of construction, this geometry is a set of coordinates. The
+ sequence of construction is:
+</p>
+<ol>
+ <li>create a coordinate</li>
+ <li>add coordinate to coordinate collection</li>
+ <li>do 1 and 2 until all coordinates created</li>
+ <li>create the line string using coordinate collection</li>
+</ol>
+<p>
+ See [Geometry Collections](geom-collections.md) for the list of collections used in the construction of geometries.
+</p>
\ No newline at end of file
Added: branches/4.0/MgDev/Doc/landing/cs-testvalues.md
===================================================================
--- branches/4.0/MgDev/Doc/landing/cs-testvalues.md (rev 0)
+++ branches/4.0/MgDev/Doc/landing/cs-testvalues.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,263 @@
+# CSTestValues
+<p>
+ These values are used for testing the coordinate system API.
+</p>
+<h2>Geodetic Coordinate System </h2>
+<h3>Used in the PHP Sample Code</h3>
+<p>
+ The following well-known text represents a coordinate system
+ based on longitude and latitude whose name is "Longitude /
+ Latitude (NAD 83)". The horizontal datum used to measure
+ positions on the surface of the earth is named "NAD 83". The
+ earth's surface is modeled as a squashed sphere. The name of
+ the model is "GRS 80". The "GRS 80" model has a semi-major
+ axis value of 6378137 and an inverse flattening value of
+ 298.257222101. The longitudinal measurement is taken from the
+ Greenwich prime meridian. The Greenwich prime meridian is at
+ an angle of 0.000000 degrees relative to the reference
+ (Greenwich) prime meridian. The unit of measurement is an
+ angular type whose name is "Decimal Degree", which can be
+ converted to radians by applying the scalar factor of
+ 0.01745329251994330.
+</p>
+
+```
+SQL\> select cs_name,srid, wktext from mdsys.cs_srs where srid = 8265;
+cs_name = Longitude / Latitude (NAD 83)
+ srid=8265
+wktext=
+GEOGCS [
+ "Longitude / Latitude (NAD 83)",
+ DATUM
+ "NAD 83",
+ SPHEROID [
+ "GRS 80",
+ 6378137,
+ 298.257222101
+ ]
+ ],
+ PRIMEM [
+ "Greenwich",
+ 0.000000
+ ],
+ UNIT [
+ "Decimal Degree",
+ 0.01745329251994330
+ ]
+]
+```
+<h3>Used in the C# Sample Code</h3>
+<p>
+ The following well-known text represents a coordinate system
+ based on longitude and latitude whose name is "LL83".
+ The horizontal datum used to measure
+ positions on the surface of the earth is named "NAD83". The
+ earth's surface is modeled as a squashed sphere. The name of
+ the model is "GRS 80". The "GRS 80" model has a semi-major
+ axis value of 6378137 and an inverse flattening value of
+ 298.257222101. The longitudinal measurement is taken from the
+ Greenwich prime meridian. The Greenwich prime meridian is at
+ an angle of 0.000000 degrees relative to the reference
+ (Greenwich) prime meridian. The unit of measurement is an
+ angular type whose name is "Decimal Degree", which can be
+ converted to radians by applying the scalar factor of
+ 0.01745329251994330.
+
+</p>
+```
+GEOGCS [
+ "LL83",
+ DATUM [
+ "NAD83",
+ SPHEROID [
+ "GRS1980",
+ 6378137.000,
+ 298.25722210
+ ]
+ ],
+ PRIMEM [
+ "Greenwich",
+ 0
+ ],
+ UNIT [
+ "Degree",
+ 0.01745329251994
+ ]
+]
+```
+<h2>Projected Coordinate System </h2>
+<h3>Used in the PHP Sample Code</h3>
+<p>
+ The following well-known text represents a projected
+ coordinate system whose name is "UTM Zone 18 (NAD 83)". It
+ uses a parameterized transform called "Transverse Mercator"
+ to transform geographic coordinates into the projected
+ coordinates. The source coordinates are expressed in terms of
+ a geographic coordinate system whose name is "NAD 83
+ (Continental US)." based on longitude and latitude whose name
+ is "Longitude / Latitude (NAD 83)". The "Transverse Mercator"
+ transform takes three parameters. The name of the first
+ parameter is "Scale_Factor", and its value is 0.999600. The
+ name of the second parameter is "Central_Meridian", and its
+ value is -117.000000. The name of the third parameter is
+ "False_Easting", and its value is 500000.000000. The unit of
+ measurement is a linear type whose name is "Meter", which can
+ be converted to meters by applying the scalar factor of
+ 1.000000000000.
+</p>
+```
+SQL\> select cs_name,srid, wktext from mdsys.cs_srs where srid = 82217;
+cs_name=UTM Zone 11 (NAD 83)
+srid=82254
+wktext=
+PROJCS[
+ "UTM Zone 18 (NAD 83)",
+ GEOGCS [
+ "NAD 83 (Continental US)",
+ DATUM [
+ "NAD 83 (Continental US)",
+ SPHEROID [
+ "GRS 80",
+ 6378137,
+ 298.257222101
+ ]
+ ],
+ PRIMEM [
+ "Greenwich", 0.000000
+ ],
+ UNIT [
+ "Decimal Degree",
+ 0.01745329251994330
+ ]
+ ],
+ PROJECTION [
+ "Transverse Mercator"
+ ],
+ PARAMETER [
+ "Scale_Factor",
+ 0.999600
+ ],
+ PARAMETER [
+ "Central_Meridian",
+ \-75.000000
+ ],
+ PARAMETER [
+ "False_Easting",
+ 500000.000000
+ ],
+ UNIT [
+ "Meter",
+ 1.000000000000
+ ]
+]
+```
+<h3>Used in the C# Sample Code</h3>
+<p>
+ The following well-known text represents a projected
+ coordinate system whose name is "UTM83-4". It
+ uses a parameterized transform called "Transverse Mercator"
+ to transform geographic coordinates into the projected
+ coordinates. The source coordinates are expressed in terms of
+ a geographic coordinate system whose name is "LL83".
+ The "Transverse Mercator" transform takes five parameters.
+ The name of the first parameter is "false_easting", and its value is 500000.000.
+ The name of the second parameter is "false_northing", and its value is 0.000.
+ The name of the third parameter is "central_meridian", and its value is -159.00000000000000.
+ The name of the fourth parameter is "scale_factor", and its value is 0.9996.
+ The name of the fifth parameter is "latitude_of_origin", and its value is 0.000.
+ The unit of measurement is a linear type whose name is "Meter", which can
+ be converted to meters by applying the scalar factor of 1.000000000000.
+</p>
+```
+PROJCS[
+ "UTM83-4",
+ GEOGCS[
+ "LL83",
+ DATUM[
+ "NAD83",
+ SPHEROID[
+ "GRS1980",
+ 6378137.000,
+ 298.25722210
+ ]
+ ],
+ PRIMEM[
+ "Greenwich",
+ 0
+ ],
+ UNIT[
+ "Degree",
+ 0.017453292519943295
+ ]
+ ],
+ PROJECTION[
+ "Transverse_Mercator"
+ ],
+ PARAMETER[
+ "false_easting",
+ 500000.000
+ ],
+ PARAMETER[
+ "false_northing",
+ 0.000
+ ],
+ PARAMETER[
+ "central_meridian",
+ -159.00000000000000
+ ],
+ PARAMETER[
+ "scale_factor",
+ 0.9996
+ ],
+ PARAMETER[
+ "latitude_of_origin",
+ 0.000
+ ],
+ UNIT[
+ "Meter",
+ 1.00000000000000
+ ]
+]
+```
+<h2> Arbitrary Coordinate System </h2>
+<p>
+ The following well-known text represents a local,
+ ungeoreferenced coordinate system whose name is "Non-Earth
+ (Mile)." The horizontal datum used to measure positions in
+ the coordinate system is named "Local Datum". The type of the
+ horizontal datum is 0. The unit of measurement is a linear
+ type whose name is "Mile", which can be converted to meters
+ by applying the scalar factor of 1.609344e+03. The system has
+ two AXIS values indicating that it is two-dimensional. The
+ directional value associated with the "X" AXIS signifies that
+ "X" increases positively in value moving east from the
+ origin. The directional value associated with the "Y" AXIS
+ signifies that "Y" increases positively in value moving north
+ from the origin.
+</p>
+
+```
+select cs_name, srid, wktext from mdsys.cs_srs where wktext like '%LOCAL_CS%';
+cs_name=Non-Earth (Mile)
+srid=262156
+wktext=
+LOCAL_CS [
+ "Non-Earth (Mile)",
+ LOCAL_DATUM [
+ "Local Datum",
+ 0
+ ]
+ UNIT [
+ "Mile",
+ 1.609344e+03
+ ],
+ AXIS [
+ "X",
+ EAST
+ ],
+ AXIS[
+ "Y",
+ NORTH
+ ]
+]
+```
Added: branches/4.0/MgDev/Doc/landing/cs-wkttosrs.md
===================================================================
--- branches/4.0/MgDev/Doc/landing/cs-wkttosrs.md (rev 0)
+++ branches/4.0/MgDev/Doc/landing/cs-wkttosrs.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,56 @@
+# WKT of SRS
+
+This extended BNF grammar represents the syntax of a
+Well-Known Text (WKT) specification of a Spatial Reference
+System (SRS), also known as a coordinate system. The grammar
+is taken verbatim from OGC01009 and is
+reproduced here for convenience.
+
+```
+<math transform> = <param mt> | <concat mt> | <inv mt> | <passthrough mt>
+<param mt> = PARAM_MT["<classification name>" {,<parameter>}* ]
+<parameter> = PARAMETER["<name>", <value>]
+<value> = <number>
+<concat mt> = CONCAT_MT[<math transform> {,<math transform>}* ]
+<inv mt> = INVERSE_MT[<math transform>]
+<passthrough mt> = PASSTHROUGH_MT[<integer>, <math transform>]
+<coordinate system> = <horz cs> | <geocentric cs> | <vert cs> | <compd cs> | <fitted cs> | <local cs>
+<horz cs> = <geographic cs> | <projected cs>
+<projected cs> = PROJCS["<name>", <geographic cs>, <projection>, {<parameter>,}* <linear unit> {,<twin axes>}{,<authority>}]
+<projection> = PROJECTION["<name>" {,<authority>}]
+<geographic cs> = GEOGCS["<name>", <datum>, <prime meridian>, <angular unit> {,<twin axes>} {,<authority>}]
+<datum> = DATUM["<name>", <spheroid> {,<to wgs84>} {,<authority>}]
+<spheroid> = SPHEROID["<name>", <semi-major axis>, <inverse flattening> {,<authority>}]
+<semi-major axis> = <number>
+<inverse flattening> = <number>
+<prime meridian> = PRIMEM["<name>", <longitude> {,<authority>}]
+<longitude> = <number>
+<angular unit> = <unit>
+<linear unit> = <unit>
+<unit> = UNIT["<name>", <conversion factor> {,<authority>}]
+<conversion factor> = <number>
+<geocentric cs> = GEOCCS["<name>", <datum>, <prime meridian>, <linear unit> {,<axis>, <axis>, <axis>} {,<authority>}]
+<authority> = AUTHORITY["<name>", "<code>"]
+<vert cs> = VERT_CS["<name>", <vert datum>, <linear unit>, {<axis>,} {,<authority>}]
+<vert datum> = VERT_DATUM["<name>", <datum type> {,<authority>}]
+<datum type> = <number>
+<compd cs> = COMPD_CS["<name>", <head cs>, <tail cs> {,<authority>}]
+<head cs> = <coordinate system>
+<tail cs> = <coordinate system>
+<twin axes> = <axis>, <axis>
+<axis> = AXIS["<name>", NORTH | SOUTH | EAST | WEST | UP | DOWN | OTHER]
+<to wgs84s> = TOWGS84[<seven param>]
+<seven param> = <dx>, <dy>, <dz>, <ex>, <ey>, <ez>, <ppm>
+<dx> = <number>
+<dy> = <number>
+<dz> = <number>
+<ex> = <number>
+<ey> = <number>
+<ez> = <number>
+<ppm> = <number>
+<fitted cs> = FITTED_CS["<name>", <to base>, <base cs>]
+<to base> = <math transform>
+<base cs> = <coordinate system>
+<local cs> = LOCAL_CS["<name>", <local datum>, <unit>, <axis>, {,<axis>}* {,<authority>}]
+<local datum> = LOCAL_DATUM["<name>", <datum type> {,<authority>}]
+```
\ No newline at end of file
Added: branches/4.0/MgDev/Doc/landing/docfx.json
===================================================================
--- branches/4.0/MgDev/Doc/landing/docfx.json (rev 0)
+++ branches/4.0/MgDev/Doc/landing/docfx.json 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,32 @@
+{
+ "build": {
+ "content": [
+ {
+ "files": [
+ "**/*.{md,yml}"
+ ],
+ "exclude": [
+ "_site/**"
+ ]
+ }
+ ],
+ "resources": [
+ {
+ "files": [
+ "images/**"
+ ]
+ }
+ ],
+ "output": "_site",
+ "template": [
+ "default",
+ "modern"
+ ],
+ "globalMetadata": {
+ "_appName": "MapGuide API Reference",
+ "_appTitle": "MapGuide API Reference",
+ "_enableSearch": true,
+ "pdf": false
+ }
+ }
+}
\ No newline at end of file
Added: branches/4.0/MgDev/Doc/landing/feature-properties.md
===================================================================
--- branches/4.0/MgDev/Doc/landing/feature-properties.md (rev 0)
+++ branches/4.0/MgDev/Doc/landing/feature-properties.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,26 @@
+# Feature Properties
+
+A feature property is a key-value pair where the key is a
+property name as defined in a feature class definition, and
+the value is the property's value. The property's type is one
+of the classes derived from the base class `MgProperty` ([.net](dotnet_api/api/OSGeo.MapGuide.MgProperty.html) [Java](java_api/org/osgeo/mapguide/MgProperty.html) [PHP](TODO.md)). The
+following list shows the names of the classes derived from
+`MgProperty` and, for each class, the type returned by the
+`GetValue()` method:
+
+| Class | Returns |
+|-------|---------|
+| `MgBlobProperty` | `MgByteReader` [.net](dotnet_api/api/OSGeo.MapGuide.MgByteReader.html) [Java](java_api/org/osgeo/mapguide/MgByteReader.html) [PHP](TODO.md) |
+| `MgBooleanProperty` | `bool` |
+| `MgByteProperty` | `byte` |
+| `MgClobProperty` | `MgByteReader` [.net](dotnet_api/api/OSGeo.MapGuide.MgByteReader.html) [Java](java_api/org/osgeo/mapguide/MgByteReader.html) [PHP](TODO.md) |
+| `MgDateTimeProperty` | `MgDateTime` [.net](dotnet_api/api/OSGeo.MapGuide.MgDateTime.html) [Java](java_api/org/osgeo/mapguide/MgDateTime.html) [PHP](TODO.md) |
+| `MgDoubleProperty` | `double` |
+| `MgFeatureProperty` | `MgFeatureReader` [.net](dotnet_api/api/OSGeo.MapGuide.MgFeatureReader.html) [Java](java_api/org/osgeo/mapguide/MgFeatureReader.html) [PHP](TODO.md) |
+| `MgGeometryProperty` | `MgByteReader` [.net](dotnet_api/api/OSGeo.MapGuide.MgByteReader.html) [Java](java_api/org/osgeo/mapguide/MgByteReader.html) [PHP](TODO.md) |
+| `MgInt16Property` | `int16` |
+| `MgInt32Property` | `int32` |
+| `MgInt64Property` | `int64` |
+| `MgRasterProperty` | `MgRaster` [.net](dotnet_api/api/OSGeo.MapGuide.MgRaster.html) [Java](java_api/org/osgeo/mapguide/MgRaster.html) [PHP](TODO.md) |
+| `MgSingleProperty` | `float` |
+| `MgStringProperty` | `string` |
\ No newline at end of file
Added: branches/4.0/MgDev/Doc/landing/geom-collections.md
===================================================================
--- branches/4.0/MgDev/Doc/landing/geom-collections.md (rev 0)
+++ branches/4.0/MgDev/Doc/landing/geom-collections.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,23 @@
+# Geometry Collections
+
+<p>The following collection classes are used by
+ MgGeometryFactory methods in the construction of geometries
+ and geometry components. See the MgGeometryFactory description for discussion and illustration of this use.</p>
+
+ * [MgGeometryFactory (.net)](dotnet_api/api/OSGeo.MapGuide.MgGeometryFactory.html)
+ * [MgGeometryFactory (java)](java_api/org/osgeo/mapguide/MgGeometryFactory.html)
+ * [MgGeometryFactory (PHP)](TODO.md)
+
+| Class | | | |
+|-----------------------------|--------|--------|----------------|
+|MgCoordinateCollection |[.net](dotnet_api/api/OSGeo.MapGuide.MgCoordinateCollection.html)|[Java](java_api/org/osgeo/mapguide/MgCoordinateCollection.html)|[PHP](TODO.md)|
+|MgCurvePolygonCollection |[.net](dotnet_api/api/OSGeo.MapGuide.MgCurvePolygonCollection.html)|[Java](java_api/org/osgeo/mapguide/MgCurvePolygonCollection.html)|[PHP](TODO.md)|
+|MgCurveRingCollection |[.net](dotnet_api/api/OSGeo.MapGuide.MgCurveRingCollection.html)|[Java](java_api/org/osgeo/mapguide/MgCurveRingCollection.html)|[PHP](TODO.md)|
+|MgCurveSegmentCollection |[.net](dotnet_api/api/OSGeo.MapGuide.MgCurveSegmentCollection.html)|[Java](java_api/org/osgeo/mapguide/MgCurveSegmentCollection.html)|[PHP](TODO.md)|
+|MgCurveStringCollection |[.net](dotnet_api/api/OSGeo.MapGuide.MgCurveStringCollection.html)|[Java](java_api/org/osgeo/mapguide/MgCurveStringCollection.html)|[PHP](TODO.md)|
+|MgGeometryCollection |[.net](dotnet_api/api/OSGeo.MapGuide.MgGeometryCollection.html)|[Java](java_api/org/osgeo/mapguide/MgGeometryCollection.html)|[PHP](TODO.md)|
+|MgGeometryComponentCollection|[.net](dotnet_api/api/OSGeo.MapGuide.MgGeometryComponentCollection.html)|[Java](java_api/org/osgeo/mapguide/MgGeometryComponentCollection.html)|[PHP](TODO.md)|
+|MgLinearRingCollection |[.net](dotnet_api/api/OSGeo.MapGuide.MgLinearRingCollection.html)|[Java](java_api/org/osgeo/mapguide/MgLinearRingCollection.html)|[PHP](TODO.md)|
+|MgLineStringCollection |[.net](dotnet_api/api/OSGeo.MapGuide.MgLineStringCollection.html)|[Java](java_api/org/osgeo/mapguide/MgLineStringCollection.html)|[PHP](TODO.md)|
+|MgPointCollection |[.net](dotnet_api/api/OSGeo.MapGuide.MgPointCollection.html)|[Java](java_api/org/osgeo/mapguide/MgPointCollection.html)|[PHP](TODO.md)|
+|MgPolygonCollection |[.net](dotnet_api/api/OSGeo.MapGuide.MgPolygonCollection.html)|[Java](java_api/org/osgeo/mapguide/MgPolygonCollection.html)|[PHP](TODO.md)|
\ No newline at end of file
Added: branches/4.0/MgDev/Doc/landing/index.md
===================================================================
--- branches/4.0/MgDev/Doc/landing/index.md (rev 0)
+++ branches/4.0/MgDev/Doc/landing/index.md 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,13 @@
+---
+_layout: landing
+---
+
+# Welcome to the MapGuide API Reference
+
+The MapGuide API is available for the following languages/platforms below
+
+## Choose your language/platform
+
+ * [.net API reference](dotnet_api/index.html)
+ * [PHP API reference](php_api/index.html)
+ * [Java API reference](java_api/index.html)
\ No newline at end of file
Added: branches/4.0/MgDev/Doc/landing/toc.yml
===================================================================
--- branches/4.0/MgDev/Doc/landing/toc.yml (rev 0)
+++ branches/4.0/MgDev/Doc/landing/toc.yml 2023-11-10 18:20:55 UTC (rev 10062)
@@ -0,0 +1,35 @@
+# TODO: Link to conceptual topics once they've all been migrated to markdown and copied into this dir
+#- name: Introduction
+# href: introduction.md
+#- name: Getting Started
+# href: getting-started.md
+- name: Collections
+ href: collections.md
+- name: Feature Service
+ items:
+ - name: Feature Properties
+ href: feature-properties.md
+- name: Geometry
+ items:
+ - name: Collections
+ href: geom-collections.md
+- name: Coordinate System
+ items:
+ - name: Test values
+ href: cs-testvalues.md
+ - name: WKT to SRS
+ href: cs-wkttosrs.md
+- name: Bibliography
+ items:
+ - name: Dana99
+ href: bib-dana99.md
+ - name: Egenhofer91
+ href: bib-egenhofer91.md
+ - name: OGC96015R1
+ href: bib-ogc96-015r1.md
+ - name: OGC99049
+ href: bib-ogc99-049.md
+ - name: OSUGR
+ href: bib-osugr.md
+ - name: Peat
+ href: bib-peat.md
More information about the mapguide-commits
mailing list