From 5e21c1dc35540c8cbe0f17f5b7767f91343415c5 Mon Sep 17 00:00:00 2001 From: David Rhodes Date: Tue, 18 Apr 2017 15:58:52 -0600 Subject: [PATCH 1/9] Updating readme with links to documentation site. This removes redundancy of information. Updated contact information to help support. --- documentation/docs/00-getting-started.md | 2 +- sdkproject/Assets/Mapbox/README.txt | 115 ++--------------------- 2 files changed, 9 insertions(+), 108 deletions(-) diff --git a/documentation/docs/00-getting-started.md b/documentation/docs/00-getting-started.md index 0435df2a2..b3637c429 100644 --- a/documentation/docs/00-getting-started.md +++ b/documentation/docs/00-getting-started.md @@ -20,4 +20,4 @@ ## Issues -If you run into any issues or have any feedback, please reach out to us at unity-beta@mapbox.com or check for issues in our repo: https://github.com/mapbox/mapbox-unity-sdk/issues. \ No newline at end of file +If you run into issues or have feedback, please contact us at https://www.mapbox.com/contact/ or check for issues in our repo: https://github.com/mapbox/mapbox-unity-sdk/issues. \ No newline at end of file diff --git a/sdkproject/Assets/Mapbox/README.txt b/sdkproject/Assets/Mapbox/README.txt index 3c5611ed4..8cff6c994 100644 --- a/sdkproject/Assets/Mapbox/README.txt +++ b/sdkproject/Assets/Mapbox/README.txt @@ -1,109 +1,10 @@ -Thanks again for signing up for the Mapbox Unity SDK! +Thank you for downloading the Mapbox Unity SDK (for Unity 5.4 and above)! -Please note: we currently only support Unity 5.4 and above. +Getting started: https://www.mapbox.com/mapbox-unity-sdk/docs/00-getting-started.html +Configuring your API token: https://www.mapbox.com/mapbox-unity-sdk/docs/01-mapbox-api-token.html +Known Issues: https://www.mapbox.com/mapbox-unity-sdk/docs/02-known-issues.html +Built-in Examples: https://www.mapbox.com/mapbox-unity-sdk/docs/03-examples.html +Attribution: https://www.mapbox.com/mapbox-unity-sdk/docs/04-attribution.html +Changelog: https://www.mapbox.com/mapbox-unity-sdk/docs/05-changelog.html -If you run into any issues or have any feedback, please reach out to us at unity-beta@mapbox.com. - -API documentation is available here: https://mapbox.github.io/mapbox-sdk-unity/api/index.html - -All uses of Mapbox’s custom maps and data must attribute both Mapbox and the appropriate data providers. Mapbox’s -custom design is copyrighted and our data sources require attribution. This requirement extends to all plan levels. - -For your convenience, we have included a prefab called “Attribution.” You must include the the Mapbox wordmark and -attribution notice on any map that uses the Mapbox Unity SDK. We provide with the SDK an Attribution prefab that includes -all required information. This prefab utilizes UGUI for integration and customization. You may adjust the position of the -Mapbox wordmark and attribution notice (pivots and anchors of the rect transform), but they must remain visible on the map. -You may also change the background color (transparent by default) of the rect transform and the text color of the text -attribution notice to best match your design aesthetics, but all information must be clearly legible. You may not otherwise -alter the Mapbox wordmark or text attribution notice. If you wish to otherwise relocate or to remove the Mapbox wordmark, -please contact our sales team to discuss options available under our Enterprise plans. Read more on our website: -https://www.mapbox.com/help/attribution/. - -Before testing the included examples, paste your api token in: Assets/Mapbox/Prefabs/MapboxConvenience.prefab Token field. -This will ensure that all the demos work properly. - - -Demos: - - -* MeshGenerationBasics - This demo shows the most basic elements of the Mesh Generation system. Contains three factories; Terrain, Imagery and Mesh with - two layer visualizers for buildings and roads. - -* MeshGenerationPois - This demo focuses on Poi Visualizer class and adds PoiVisualizer on the Basic demo setup, which uses the Maki icons to - represent points of interest on 2D UI space. - -* MeshGenerationStyles - This demo shows the filtering and styling capabilities of the system and has two alternative styles for different types of - buildings and one alternative style for roads (footway). Building visualizer also has uses a filter module and filters out the school - from the process. - -* Drive - Drive demo integrates Mapbox Directions api and traffic data into the mesh generation and shows traffic congestion by different - road colors. It also contains start/target points to test Directions api. - -* Playground - - Playground demos consist of the following examples: - - ForwardGeocoder: - A forward geocoding request will fetch GeoJSON from a place name query. - See: https://www.mapbox.com/api-documentation/#geocoding for more information. - - ReverseGeocoder: - A reverse geocoding request will fetch GeoJSON from a latitude, longitude query. - See: https://www.mapbox.com/api-documentation/#geocoding for more information. - - VectorTile: - Uses a forward geocoder request to fetch GeoJSON from a Map object. - In this example, the result is GeoJSON with a feature collection. - See: https://www.mapbox.com/api-documentation/#retrieve-features-from-vector-tiles - - RasterTile: - Uses a forward geocoder request to fetch a style's raster tile from a Map object. - "Request image tiles from a style that can be arranged and displayed with the help of a mapping library." - See: https://www.mapbox.com/help/define-style/ - See: https://www.mapbox.com/api-documentation/#retrieve-raster-tiles-from-styles - - Directions: - Enter a start location query (eg. "San Francisco, CA"), this is a forward geocode request. - Enter a destination query (eg. "Los Angeles, CA"), this is also a forward geocode request. - When the requests have been completed, a directions request is executed. - Direction results will be logged to the UI when they are available (in the form of JSON). - -* SlippyVectorTerrain - The purpose of this example is to demonstrate a slippy map built with the sdk. Use W, A, S, and D keyboard keys to - pan the map. [Add information] - -* Voxels - VoxelWorld uses a Mapbox Studio style (as a raster tile) to map specific prefabs to the colors of each pixel in the texture. - These prefabs are vertically offset using Mapbox global terrain data (elevation). Note that this example only uses maps out - a single tile. Read more here: https://www.mapbox.com/blog/how-to-minecraft-unity/. - - -CHANGELOG - -v0.4.0 - - Updates mapbox-sdk-unity-core to v1.0.0-alpha13; features vector tile overzooming - - Updates to attribution guidelines in README.MD - - Added Conversions.cs and VectorExtensions.cs to enable simple conversions from geocoordinate to unity coordinate space - -v0.3.0 - - Added new infrastructure for mesh generation - - Added new demos for basic, styled, point of interest vector mesh generation - - Added new demo for vector tiles + terrain with a slippy implementation (dynamic tile loading) - - Added a new demo for Mapbox Directions & Traffic - - Deprecated old slippy demo - - Deprecated old directions component demo - -v0.2.0 - - Added core sdk support for mapbox styles - - vector tile decoding optimizations for speed and lazy decoding - - Added attribution prefab - - new Directions example - - All examples scripts updated streamlined to use MapboxConvenience object - -v0.1.1 - - removed orphaned references from link.xml, this was causing build errors - - moved JSON utility to Mapbox namespace to avoid conflicts with pre-exisiting frameworks +If you have issues or feedback, please contact us at https://www.mapbox.com/contact/ or check our public repository: https://github.com/mapbox/mapbox-unity-sdk/issues. \ No newline at end of file From 61bc819eb108b342b41b3c5f05c56964510c8c50 Mon Sep 17 00:00:00 2001 From: David Rhodes Date: Tue, 18 Apr 2017 15:59:08 -0600 Subject: [PATCH 2/9] Added API link. --- sdkproject/Assets/Mapbox/README.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/sdkproject/Assets/Mapbox/README.txt b/sdkproject/Assets/Mapbox/README.txt index 8cff6c994..b42bc9f84 100644 --- a/sdkproject/Assets/Mapbox/README.txt +++ b/sdkproject/Assets/Mapbox/README.txt @@ -6,5 +6,6 @@ Known Issues: https://www.mapbox.com/mapbox-unity-sdk/docs/02-known-issues.html Built-in Examples: https://www.mapbox.com/mapbox-unity-sdk/docs/03-examples.html Attribution: https://www.mapbox.com/mapbox-unity-sdk/docs/04-attribution.html Changelog: https://www.mapbox.com/mapbox-unity-sdk/docs/05-changelog.html +API: https://www.mapbox.com/mapbox-unity-sdk/api/ If you have issues or feedback, please contact us at https://www.mapbox.com/contact/ or check our public repository: https://github.com/mapbox/mapbox-unity-sdk/issues. \ No newline at end of file From d4c2ad8661f36fddddc5b826250c0e4c1e8850a7 Mon Sep 17 00:00:00 2001 From: David Rhodes Date: Tue, 18 Apr 2017 16:30:25 -0600 Subject: [PATCH 3/9] Added another known issue (regarding building roofs and terrain) --- documentation/docs/02-known-issues.md | 1 + 1 file changed, 1 insertion(+) diff --git a/documentation/docs/02-known-issues.md b/documentation/docs/02-known-issues.md index 1de223fc2..73643e985 100644 --- a/documentation/docs/02-known-issues.md +++ b/documentation/docs/02-known-issues.md @@ -11,6 +11,7 @@ - Buildings are split along tile borders (features duplicated across boundaries) - Building parts are not associated with specific buildings (other than spatially) - Some complex building data is not rendered correctly (cut out holes, floating pieces, etc.) +- Building rooftops are not flat when placed on non-flat terrain ### Global Elevation Data From c675af3fedcb9433bc0ca91184178ea25e599a1b Mon Sep 17 00:00:00 2001 From: Siyu Song Date: Tue, 18 Apr 2017 15:34:05 -0700 Subject: [PATCH 4/9] include version in README --- sdkproject/Assets/Mapbox/README.txt | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/sdkproject/Assets/Mapbox/README.txt b/sdkproject/Assets/Mapbox/README.txt index b42bc9f84..43dbc0556 100644 --- a/sdkproject/Assets/Mapbox/README.txt +++ b/sdkproject/Assets/Mapbox/README.txt @@ -5,7 +5,9 @@ Configuring your API token: https://www.mapbox.com/mapbox-unity-sdk/docs/01-mapb Known Issues: https://www.mapbox.com/mapbox-unity-sdk/docs/02-known-issues.html Built-in Examples: https://www.mapbox.com/mapbox-unity-sdk/docs/03-examples.html Attribution: https://www.mapbox.com/mapbox-unity-sdk/docs/04-attribution.html -Changelog: https://www.mapbox.com/mapbox-unity-sdk/docs/05-changelog.html API: https://www.mapbox.com/mapbox-unity-sdk/api/ +Current version: 0.4.0 +Changelog: https://www.mapbox.com/mapbox-unity-sdk/docs/05-changelog.html + If you have issues or feedback, please contact us at https://www.mapbox.com/contact/ or check our public repository: https://github.com/mapbox/mapbox-unity-sdk/issues. \ No newline at end of file From c128d2a7608387ead4bffdb9f8db912d5ed4453e Mon Sep 17 00:00:00 2001 From: David Rhodes Date: Tue, 18 Apr 2017 16:38:36 -0600 Subject: [PATCH 5/9] Updating with notes for v0.5 --- documentation/docs/05-changelog.md | 25 ++++++++++++++++++++----- 1 file changed, 20 insertions(+), 5 deletions(-) diff --git a/documentation/docs/05-changelog.md b/documentation/docs/05-changelog.md index 3ee0b3c95..4d562009b 100644 --- a/documentation/docs/05-changelog.md +++ b/documentation/docs/05-changelog.md @@ -1,12 +1,27 @@ -CHANGELOG +## CHANGELOG + +#### v0.5.0 + +- Fixed precision issue with tile conversions + - Replaced `Geocoordinate` with `Vector2d` +- Mapbox API Token is now stored in MapboxAccess.txt + - `MapboxConvenience` has been removed +- Added `LocationProviders` and example scene to build maps or place objects based on a latitude/longitude +- Mesh Generation: + - General performance improvements (local tile geometry) + - Custom editors for tile factories + - Added new `MergedModifierStack` which will reduce the number of transforms and draw calls in dense maps + - Continuous UVs for building facades + - `DirectionsFactory` now draws full geometry, not just waypoints + - Fixed occasional vertex mismatch in `PolygonMeshModifier.cs` (which caused an index out of range exception) #### v0.4.0 - - Updates mapbox-sdk-unity-core to v1.0.0-alpha13; features vector tile overzooming +- Updates mapbox-sdk-unity-core to v1.0.0-alpha13; features vector tile overzooming - Updates to attribution guidelines in README.MD - Added Conversions.cs and VectorExtensions.cs to enable simple conversions from geocoordinate to unity coordinate space #### v0.3.0 - - Added new infrastructure for mesh generation +- Added new infrastructure for mesh generation - Added new demos for basic, styled, point of interest vector mesh generation - Added new demo for vector tiles + terrain with a slippy implementation (dynamic tile loading) - Added a new demo for Mapbox Directions & Traffic @@ -14,12 +29,12 @@ CHANGELOG - Deprecated old directions component demo #### v0.2.0 - - Added core sdk support for mapbox styles +- Added core sdk support for mapbox styles - vector tile decoding optimizations for speed and lazy decoding - Added attribution prefab - new Directions example - All examples scripts updated streamlined to use MapboxConvenience object #### v0.1.1 - - removed orphaned references from link.xml, this was causing build errors +- removed orphaned references from link.xml, this was causing build errors - moved JSON utility to Mapbox namespace to avoid conflicts with pre-exisiting frameworks \ No newline at end of file From aa1c4ed36ce97cfb027ff5a0f894abe043ad5820 Mon Sep 17 00:00:00 2001 From: David Rhodes Date: Tue, 18 Apr 2017 16:43:10 -0600 Subject: [PATCH 6/9] UWP support? --- documentation/docs/05-changelog.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/documentation/docs/05-changelog.md b/documentation/docs/05-changelog.md index 4d562009b..af2f25e47 100644 --- a/documentation/docs/05-changelog.md +++ b/documentation/docs/05-changelog.md @@ -2,6 +2,8 @@ #### v0.5.0 +- Added support for UWP + - Share your Hololens creations with us! - Fixed precision issue with tile conversions - Replaced `Geocoordinate` with `Vector2d` - Mapbox API Token is now stored in MapboxAccess.txt From f7e4292c0c2a091f502f255f605e6fe545fb0ce8 Mon Sep 17 00:00:00 2001 From: David Rhodes Date: Wed, 19 Apr 2017 16:15:38 -0600 Subject: [PATCH 7/9] =?UTF-8?q?Removed=20=E2=80=9CUWP=20not=20supported?= =?UTF-8?q?=E2=80=9D=20from=20Known=20issues.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- documentation/docs/02-known-issues.md | 3 +-- documentation/docs/05-changelog.md | 2 +- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/documentation/docs/02-known-issues.md b/documentation/docs/02-known-issues.md index 1de223fc2..e8388c685 100644 --- a/documentation/docs/02-known-issues.md +++ b/documentation/docs/02-known-issues.md @@ -2,8 +2,7 @@ ### Platform Support -- UWP builds not currently working -- WebGL builds not showing maps (build successful) +- WebGL builds not showing maps (even though builds are successful) ### Vector Tile diff --git a/documentation/docs/05-changelog.md b/documentation/docs/05-changelog.md index af2f25e47..097bb49ce 100644 --- a/documentation/docs/05-changelog.md +++ b/documentation/docs/05-changelog.md @@ -11,7 +11,7 @@ - Added `LocationProviders` and example scene to build maps or place objects based on a latitude/longitude - Mesh Generation: - General performance improvements (local tile geometry) - - Custom editors for tile factories + - Custom editors for map factories - Added new `MergedModifierStack` which will reduce the number of transforms and draw calls in dense maps - Continuous UVs for building facades - `DirectionsFactory` now draws full geometry, not just waypoints From e8d245a00577c26d3da580617e95d40e9bdbbdea Mon Sep 17 00:00:00 2001 From: David Rhodes Date: Mon, 24 Apr 2017 15:53:47 -0600 Subject: [PATCH 8/9] Update 05-changelog.md Updating with expected release date. --- documentation/docs/05-changelog.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/docs/05-changelog.md b/documentation/docs/05-changelog.md index 097bb49ce..081354c01 100644 --- a/documentation/docs/05-changelog.md +++ b/documentation/docs/05-changelog.md @@ -1,6 +1,6 @@ ## CHANGELOG -#### v0.5.0 +#### v0.5.0 - 04/26/2017 - Added support for UWP - Share your Hololens creations with us! @@ -39,4 +39,4 @@ #### v0.1.1 - removed orphaned references from link.xml, this was causing build errors - - moved JSON utility to Mapbox namespace to avoid conflicts with pre-exisiting frameworks \ No newline at end of file + - moved JSON utility to Mapbox namespace to avoid conflicts with pre-exisiting frameworks From 844b667c7d4496d1f182381856739ce366173c38 Mon Sep 17 00:00:00 2001 From: David Rhodes Date: Tue, 25 Apr 2017 11:59:02 -0600 Subject: [PATCH 9/9] Updating mapbox unity sdk name and fixing a few formatting issues. --- dependencies/mapbox-sdk-cs | 2 +- documentation/docs/05-changelog.md | 4 +++- documentation/docs/index.md | 6 +++--- 3 files changed, 7 insertions(+), 5 deletions(-) diff --git a/dependencies/mapbox-sdk-cs b/dependencies/mapbox-sdk-cs index 558cb770a..d4850704d 160000 --- a/dependencies/mapbox-sdk-cs +++ b/dependencies/mapbox-sdk-cs @@ -1 +1 @@ -Subproject commit 558cb770ade50ff737bf4d6001b88af6e68578ba +Subproject commit d4850704db12269df261ff61aea999fef542e3f6 diff --git a/documentation/docs/05-changelog.md b/documentation/docs/05-changelog.md index 081354c01..531dbc429 100644 --- a/documentation/docs/05-changelog.md +++ b/documentation/docs/05-changelog.md @@ -1,6 +1,8 @@ ## CHANGELOG -#### v0.5.0 - 04/26/2017 +#### v0.5.0 + +*04/26/20178* - Added support for UWP - Share your Hololens creations with us! diff --git a/documentation/docs/index.md b/documentation/docs/index.md index 3658f34df..d17cfae1f 100644 --- a/documentation/docs/index.md +++ b/documentation/docs/index.md @@ -1,6 +1,6 @@ -# Mapbox SDK for Unity +# Mapbox Unity SDK -Welcome to the `Mapbox SDK for Unity`! +Welcome to the `Mapbox Unity SDK`! Check out these links to get started: @@ -9,7 +9,7 @@ Check out these links to get started: * [Known issues](02-known-issues.md) * [Examples](03-examples.md) -This SDK uses +This SDK uses: * `mapbox-sdk-cs` for interacting with the Mapbox API * documentation: https://mapbox.github.io/mapbox-sdk-cs/