Esri · jfoster126 · Jul 3, 2019 · Jul 3, 2019
@@ -1,8 +1,8 @@
 # 3DNodeIndexDocument
 
-The 3dNodeIndexDocument JSON file describes a single index node within a store. It includes links to other nodes (e.g. children, sibling, and parent), links to feature data, geometry data, texture data resources, metadata (e.g. metrics used for LoD selection), and spatial extent. The node is the root object in the 3dNodeIndexDocument. There is always exactly one Node object in a 3dNodeIndexDocument. 
+The 3dNodeIndexDocument JSON file describes a single index node within a store. It includes links to other nodes (e.g. children, sibling, and parent), links to feature data, geometry data, texture data resources, metadata (e.g. metrics used for LoD selection), and spatial extent. The node is the root object in the 3dNodeIndexDocument. There is always exactly one node object in a 3dNodeIndexDocument. 
 
-Depending on the geometry and LoD Model, a node document can be tuned towards being light-weight or heavy-weight. Clients decide which data to retrieve. The bounding volume information for the node, its parent, neighbors, and children provide sufficient data for a simple visualization.  For example, the centroids could be rendered as point features. 
+Depending on the geometry and LoD model, a node document can be tuned towards being light-weight or heavy-weight. Clients decide which data to retrieve. The bounding volume information for the node, its parent, siblings, and children provide sufficient data for a simple visualization.  For example, the centroids could be rendered as point features. 
 
 ### Properties
 
@@ -11,7 +11,7 @@ Depending on the geometry and LoD Model, a node document can be tuned towards be
 | **id** | string | Tree Key ID, unique within the store. The root node is always 'root', all others follow the pattern '2-4-0-15-2'. At each level in a subtree, numbering starts at 0. |
 | level | integer | Explicit level of this node within the index tree. The lowest level is 1. |
 | version | string | The version (store update session ID) of this node. |
-| mbs | number[4] | An array of four doubles, corresponding to x, y, z and radius of the minimum bounding sphere of a node. |
+| mbs | number[4] | An array of four doubles, corresponding to x, y, z and radius of the [minimum bounding sphere](docs/1.6/mbs.cmn.md) of a node. |
 | obb | [obb](obb.cmn.md) | Describes oriented bounding box. |
 | created | string | Creation date of this node in UTC, presented as a string in the format YYYY-MM-DDThh:mm:ss.sTZD, with a fixed 'Z' time zone (see http://www.w3.org/TR/NOTE-datetime). |
 | expires | string | Expiration date of this node in UTC, presented as a string in the format YYYY-MM-DDThh:mm:ss.sTZD, with a fixed 'Z' time zone (see http://www.w3.org/TR/NOTE-datetime). |
@@ -23,9 +23,9 @@ Depending on the geometry and LoD Model, a node document can be tuned towards be
 | featureData | [resource](resource.cmn.md)[] | Resource reference describing a FeatureData document. |
 | geometryData | [resource](resource.cmn.md)[] | Resource reference describing a geometry resource. |
 | textureData | [resource](resource.cmn.md)[] | Resource reference describing a texture resource. |
-| attributeData | [resource](resource.cmn.md)[] | Resource reference describing a FeatureData document. |
-| lodSelection | [lodSelection](lodSelection.cmn.md)[] | Metrics for LoD Selection, to be evaluated by the client. |
-| features | [lodSelection](lodSelection.cmn.md)[] | A list of summary information on the features present in this node, used for pre-visualisation and LoD switching in featureTree LoD stores. |
+| attributeData | [resource](resource.cmn.md)[] | Resource reference describing a featureData document. |
+| lodSelection | [lodSelection](lodSelection.cmn.md)[] | Metrics for LoD selection, to be evaluated by the client. |
+| features | [features](features.cmn.md)[] | **Deprecated.** A list of summary information on the features present in this node, used for pre-visualisation and LoD switching in featureTree LoD stores. |
 
 *Note: properties in **bold** are required*
 

@@ -2,6 +2,8 @@
 
 The object 3DSceneLayerInfo describes the properties of a layer in a store. Every scene layer contains 3DSceneLayerInfo. For features based scene layers, such as 3D objects or point scene layers, may include the default symbology, as specified in the drawingInfo, which contains stylization information for a feature layer.
 
+When generating scene layers with the meshpyramid cooker, the root node never has any geometry. Any node's children represent a higher LOD quality than an ancestor node.  Nodes without geometry at the top of the tree are allowable since the lowest LOD of a feature/geometry is not to shown.
+
 ### Properties
 
 | Property | Type | Description |
@@ -10,10 +12,10 @@ The object 3DSceneLayerInfo describes the properties of a layer in a store. Ever
 | href | string | The relative URL to the 3DSceneLayerResource. Only present as part of the SceneServiceInfo resource. |
 | **layerType** | string | The user-visible layer type<div>Possible values are:<ul><li>`Line`</li><li>`Polygon`</li><li>`3DObject`</li><li>`IntegratedMesh`</li></ul></div> |
 | spatialReference | [spatialReference](spatialReference.cmn.md) | The spatialReference of the layer including the vertical coordinate system. WKT is included to support custom spatial references. |
-| heightModelInfo | [heightModelInfo](heightModelInfo.cmn.md) | Enables consuming clients to quickly determine whether this layer is compatible (with respect to its horizontal and vertical CRS) with existing content. |
+| heightModelInfo | [heightModelInfo](heightModelInfo.cmn.md) | Enables consuming clients to quickly determine whether this layer is compatible (with respect to its horizontal and vertical coordinate system) with existing content. |
 | **version** | string | The ID of the last update session in which any resource belonging to this layer has been updated. |
 | name | string | The name of this layer. |
-| serviceUpdateTimeStamp | [serviceUpdateTimeStamp](serviceUpdateTimeStamp.cmn.md) | The time of the last update |
+| serviceUpdateTimeStamp | [serviceUpdateTimeStamp](serviceUpdateTimeStamp.cmn.md) | The time of the last update. |
 | alias | string | The display alias to be used for this layer. |
 | description | string | Description string for this layer. |
 | copyrightText | string | Copyright and usage information for the data in this layer. |
@@ -23,9 +25,9 @@ The object 3DSceneLayerInfo describes the properties of a layer in a store. Ever
 | drawingInfo | [drawingInfo](drawingInfo.cmn.md) | An object containing drawing information. |
 | elevationInfo | [elevationInfo](elevationInfo.cmn.md) | An object containing elevation drawing information. If absent, any content of the scene layer is drawn at its z coordinate. |
 | popupInfo | [popupInfo](popupInfo.cmn.md) | PopupInfo of the scene layer. |
-| disablePopup | boolean | Indicates if client application will show the popup information. |
+| disablePopup | boolean | Indicates if client application will show the popup information. Default is FALSE. |
 | **store** | [store](store.cmn.md) | The store object describes the exact physical storage of a layer and enables the client to detect when multiple layers are served from the same store. |
-| fields | [field](field.cmn.md)[] | A collection of objects that describe each attribute field regarding its field name, datatype, and a user friendly name {name,type,alias}. It includes all fields that are included as part of the I3S layer as derived from a source input feature layer. |
+| fields | [field](field.cmn.md)[] | A collection of objects that describe each attribute field regarding its field name, datatype, and a user friendly name {name,type,alias}. It includes all fields that are included as part of the scene layer as derived from a source input feature layer. |
 | attributeStorageInfo | [attributeStorageInfo](attributeStorageInfo.cmn.md)[] | Provides the schema and layout used for storing attribute content in binary format in I3S. |
 | statisticsInfo | [statisticsInfo](statisticsInfo.cmn.md)[] | Contains the statistical information for a layer. |
 

@@ -10,10 +10,10 @@ The object 3DSceneLayerInfo describes the properties of a layer in a store. Ever
 | href | string | The relative URL to the 3DSceneLayerResource. Only present as part of the SceneServiceInfo resource. |
 | **layerType** | string | The user-visible layer type.<div>Must be:<ul><li>`Point`</li></ul></div> |
 | spatialReference | [spatialReference](spatialReference.cmn.md) | The spatialReference of the layer including the vertical coordinate system. WKT is included to support custom spatial references. |
-| heightModelInfo | [heightModelInfo](heightModelInfo.cmn.md) | Enables consuming clients to quickly determine whether this layer is compatible (with respect to its horizontal and vertical CRS) with existing content. |
+| heightModelInfo | [heightModelInfo](heightModelInfo.cmn.md) | Enables consuming clients to quickly determine whether this layer is compatible (with respect to its horizontal and vertical coordinate system) with existing content. |
 | **version** | string | The ID of the last update session in which any resource belonging to this layer has been updated. |
 | name | string | The name of this layer. |
-| serviceUpdateTimeStamp | [serviceUpdateTimeStamp](serviceUpdateTimeStamp.cmn.md) | The time of the last update |
+| serviceUpdateTimeStamp | [serviceUpdateTimeStamp](serviceUpdateTimeStamp.cmn.md) | The time of the last update. |
 | alias | string | The display alias to be used for this layer. |
 | description | string | Description string for this layer. |
 | copyrightText | string | Copyright and usage information for the data in this layer. |
@@ -23,9 +23,9 @@ The object 3DSceneLayerInfo describes the properties of a layer in a store. Ever
 | drawingInfo | [drawingInfo](drawingInfo.cmn.md) | An object containing drawing information. |
 | elevationInfo | [elevationInfo](elevationInfo.cmn.md) | An object containing elevation drawing information. If absent, any content of the scene layer is drawn at its z coordinate. |
 | popupInfo | [popupInfo](popupInfo.cmn.md) | PopupInfo of the scene layer. |
-| disablePopup | boolean | Indicates if client application will show the popup information. |
+| disablePopup | boolean | Indicates if client application will show the popup information. Default is FALSE. |
 | **store** | [store](store.psl.md) | The store object describes the exact physical storage of a layer and enables the client to detect when multiple layers are served from the same store. |
-| fields | [field](field.cmn.md)[] | A collection of objects that describe each attribute field regarding its field name, datatype, and a user friendly name {name,type,alias}. It includes all fields that are included as part of the I3S layer as derived from a source input feature layer. |
+| fields | [field](field.cmn.md)[] | A collection of objects that describe each attribute field regarding its field name, datatype, and a user friendly name {name,type,alias}. It includes all fields that are included as part of the scene layer as derived from a source input feature layer. |
 | attributeStorageInfo | [attributeStorageInfo](attributeStorageInfo.cmn.md)[] | Provides the schema and layout used for storing attribute content in binary format in I3S. |
 | statisticsInfo | [statisticsInfo](statisticsInfo.cmn.md)[] | Contains the statistical information for a layer. |
 

@@ -1,56 +1,128 @@
-# 3D Object Scene Layer
+# 3D Object Scene Layer (1.6)
 
 A 3D object scene layer is used to visualize 3D objects.  3D object scene layers are often created from GIS data with attributes and explicitly modeled in 3D.  These attributes allow definition queries to specify symbology and other properties in lieu of setting properties for each object individually.  A 3D object scene layer can efficiently create and share just a few buildings or an entire city.
 
 *Realistic 3D Object Scene Layer with textures*
 
-![Realistic 3D Object Scene Layer with textures](img/LyonTextured.png)
+![Realistic 3D Object Scene Layer with textures](../img/LyonTextured.png)
 
 *Thematic 3D Object Scene Layer without textures*
 
-![Thematic 3D Object Scene Layer without textures](img/LyonThematic.png)
+![Thematic 3D Object Scene Layer without textures](../img/LyonThematic.png)
 
 ## 3D Object Scene Layer Structure
-The 3D object scene layer is structured into a tree of multiple JSON files. Besides storing information in the JSON format, some are also provided as binary buffer. A 3D object scene layer can be used to create a scene layer package (*.slpk) or a I3S service. A 3D object scene layer contains the following:
+The 3D object scene layer is structured into a tree of multiple JSON files.  A 3D object scene layer can be used to create a scene layer package (*.slpk) or a I3S service. A 3D object scene layer contains the following:
 
 - [Layer description](3DSceneLayer.cmn.md)
-- Nodes containing [Geometry](geometry.cmn.md) and [Attributes](attributeStorageInfo.cmn.md)
+- Nodes containing [Geometry](defaultGeometrySchema.cmn.md) and [Attributes](attributeStorageInfo.cmn.md)
 - [Node Index Document](3DNodeIndexDocument.cmn.md)
 - [Statistics](statsInfo.cmn.md)
+- [Shared Resources](sharedResource.cmn.md)
 
 *Example of 3DObject layer structure*
 
 ```
 .<host>/SceneServer/layers
-	+--0 // layer description (named 3dSceneLayer.json in SLPK)
+	+--0 // scene layer document
 	+-- nodes
 	|  +--0
 	|  |  +-- attributes
-	|  |  |  +--2
-	|  |  |  +--4
-	|  |  |  +--8
+	|  |  |  +--f_2
+	|  |  |  +--f_4
 	|  |  |  +--(...)
 	|  |  +-- geometries
 	|  |  |  +-- 0
-	|  +--1
-	|  |  (...) //same structure for all nodes
-	|  +--...
-	|  +-- 259
-	|  |  (...) //same structure for all nodes
+	|  |  +-- textures
+	|  |  |  +-- 0
+	|  |  |  +-- 0_0_1
+	|  |  |  +--(...)
+	|  |  +-- shared 
+	|  |  (...) 
 	+--statistics
-	|  +-- 2
-	|  +-- 4
-	|  +-- 8
+	|  +-- f_2
+	|  |  | +--0
+	|  +-- f_4
+	|  |  | +--0
 	|  +-- (...)
 ```
-# HTTP API Overview
+# HTTP API Overview 1.6
+
+The following API methods are available for 3D Object scene layer:
+
+| Resource             | Type   | Description                                                  | URL Template                         |
+| -------------------- | ------ | ------------------------------------------------------------ | ------------------------------------ |
+| Scene Layer Document | `JSON` | This is the root document for the service that will contain properties common to the entire layer. | `http://serviceURL/layers/{layerID}` |
+
+- `layerID`: Integer. ID of the associated layer. Esri products expect this to be `0`.
+
+Example: http://my.server.com/3DObjectSceneLayer/SceneServer/layers/0
+
+
+
+| Resource      | Type   | Description              | URL Template                                            |
+| ------------- | ------ | ------------------------ | ------------------------------------------------------- |
+| Node Document | `JSON` | Description of the node. | `http://serviceURL/layers/{layerID}/nodes/{resourceID}` |
+
+- `layerID`: Integer. ID of the associated layer. Esri products expect this to be `0`.
+- `resourceID`: String. ID of the associated resource. 
+
+Example: http://my.server.com/3DObjectSceneLayer/SceneServer/layers/0/nodes/98
+
+
+
+| Resource | Type                       | Description                   | URL Template                                                 |
+| -------- | -------------------------- | ----------------------------- | ------------------------------------------------------------ |
+| Textures | `JPG`, `PNG`, `DDS`, `KTX` | The texture resource  (image) | `http://serviceURL/layers/{layerID}/nodes/{resourceID}/textures/{texture ID}` |
+
+- `layerID`: Integer. ID of the associated layer. Esri products expect this to be `0`.
+- `resourceID`: String. ID of the associated node.
+- `textureID`: String. This ID returns one of the textures available for this node. The same texture may be available in different formats. 
+
+Example: http://my.server.com/3DObjectSceneLayer/SceneServer/layers/0/nodes/98/textures/1
+
+
+
+
+| Resource   | Type  | Description            | URL Template                                                 |
+| ---------- | ----- | ---------------------- | ------------------------------------------------------------ |
+| Geometries | `bin` | The geometry resource. | `http://serviceURL/layers/{layerID}/nodes/{resourceID}/geometries/0` |
+
+- `layerID`: Integer. ID of the associated layer. Esri products expect this to be `0`.
+- `resourceID`: String. ID of the associated node.
+
+Example: http://my.server.com/3DObjectSceneLayer/SceneServer/layers/0/nodes/98/geometries/1 
+
+
+
+| Resource   | Type   | Description                                                  | URL Template                                                 |
+| ---------- | ------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
+| Statistics | `JSON` | The statistics for the entire layer for a specific attribute. | `http://serviceURL/layers/{layerID}/statistics/f_{attributeID}/0` |
+
+- `layerID`: Integer. ID of the associated layer. Esri clients expect this to be `0`.
+- `attributeID`: Integer.  ID of the specific attribute for the layer.
+
+Example: http://my.server.com/3DObjectSceneLayer/SceneServer/layers/0/statistics/f_48/0 
+
+
+
+| Resource   | Type   | Description                                                  | URL Template                                                 |
+| ---------- | ------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
+| Attributes | `JSON` | The attributes for the entire layer for a specific attribute. | `http://serviceURL/layers/{layerID}/attributes/f_{attributeID}/0` |
+
+- `layerID`: Integer. ID of the associated layer. Esri products expect this to be `0`.
+- `attributeID`: Integer.  ID of the specific attribute for the layer.
+
+Example: http://my.server.com/3DObjectSceneLayer/SceneServer/layers/0/attributes/f_48/0 
+
+
+
+| Resource         | Type   | Description                        | URL Template                                                 |
+| ---------------- | ------ | ---------------------------------- | ------------------------------------------------------------ |
+| Shared Resources | `JSON` | Texture and material descriptions. | `http://serviceURL/layers/{layerID}/nodes/{resourceID}/shared` |
+
+- `layerID`: Integer. ID of the associated layer. Esri products expect this to be `0`.
+- `resourceID`: String. ID of the associated node. 
+
+Example: http://my.server.com/3DObjectSceneLayer/SceneServer/layers/0/nodes/98/shared
 
-The following API methods are available for point cloud scene layer:
 
-|Method|Example|
-|------|-------|
-|To query SceneLayer document|http://my.server.com/layers/{layerId}|
-|To query attribute, statistics, documents|http://my.server.com/layers/{layerId}/statistics/{AttribKey}|
-|To query  NodePage  document|http://my.server.com/layers/{layerId}/nodepages/{firstNodeIdInPage} |
-|To query  Geometry  Buffer|http://my.server.com/layers/{layerId}/nodes/{resourceID}/geometries/0 |
-|To query  Attribute  Buffer|http://my.server.com/layers/{layerId}/nodes/{resourceID}/attributes/{AttribKey}  Node:  {AttribKey}  is listed at  scenelayer.attributeStorageInfo[].key |