org.outernet.cesium-unity 1.15.3-linux.1

package/Runtime/CesiumFeature.cs

@@ -0,0 +1,279 @@
+using Reinterop;
+using UnityEngine;
+using System;
+
+namespace CesiumForUnity
+{
+    /// <summary>
+    /// Identifies the type of a property. 
+    /// </summary>
+    public enum MetadataType
+    {
+        None,
+        Int8,
+        UInt8,
+        Int16,
+        UInt16,
+        Int32,
+        UInt32,
+        Int64,
+        UInt64,
+        Float,
+        Double,
+        Boolean,
+        String,
+        Array
+    }
+
+    /// <summary>
+    /// Allows access to a particular feature of <see cref="CesiumMetadata"/>.
+    /// </summary>
+    [ReinteropNativeImplementation("CesiumForUnityNative::CesiumFeatureImpl", "CesiumFeatureImpl.h")]
+    [Obsolete("Retrieve feature IDs from the CesiumPrimitiveFeatures component attached to a mesh primitive instead. For metadata, use the CesiumModelMetadata component attached to its parent game object.")]
+    public partial class CesiumFeature
+    {
+        /// <summary>
+        /// The name of the class that this CesiumFeature conforms to.
+        /// </summary>
+        public string className { get; internal set; }
+
+        /// <summary>
+        /// The name of the feature table containing the values of this CesiumFeature's properties.
+        /// </summary>
+        public string featureTableName { get; internal set; }
+
+        /// <summary>
+        /// The names of the properties that exist in this CesiumFeature.
+        /// </summary>
+        public string[] properties { get; internal set; }
+
+        /// <summary>
+        /// Gets the value of the specified property as a signed byte. Returns the default 
+        /// value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial sbyte GetInt8(string property, sbyte defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property as a byte. Returns the default value
+        /// if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial byte GetUInt8(string property, byte defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property as a signed 16-bit integer. Returns
+        /// the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial Int16 GetInt16(string property, Int16 defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property as an unsigned 16-bit integer. Returns
+        /// the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial UInt16 GetUInt16(string property, UInt16 defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property as a signed 32-bit integer. Returns
+        /// the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial Int32 GetInt32(string property, Int32 defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property as an unsigned 32-bit integer.
+        /// Returns the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial UInt32 GetUInt32(string property, UInt32 defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property as a signed 64-bit integer. Returns
+        /// the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial Int64 GetInt64(string property, Int64 defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property as an unsigned 64-bit integer. Returns
+        /// the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial UInt64 GetUInt64(string property, UInt64 defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property as a 32-bit floating-point number.
+        /// Returns the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial float GetFloat32(string property, float defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property as a 64-bit floating-point number.
+        /// Returns the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial double GetFloat64(string property, double defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property as a boolean value. Returns the default
+        /// value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial Boolean GetBoolean(string property, Boolean defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property as a string. Returns the default value if
+        /// the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial String GetString(string property, String defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property from an array as a signed byte. 
+        /// Returns the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="index">The index of the component.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial sbyte GetComponentInt8(string property, int index, sbyte defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property from an array as a byte.
+        /// Returns the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="index">The index of the component.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial byte GetComponentUInt8(string property, int index, byte defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property from an array as a signed 16-bit integer.
+        /// Returns the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="index">The index of the component.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial Int16 GetComponentInt16(string property, int index, Int16 defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property from an array as an unsigned 16-bit integer.
+        /// Returns the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="index">The index of the component.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial UInt16 GetComponentUInt16(string property, int index, UInt16 defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property from an array as a signed 32-bit integer.
+        /// Returns the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="index">The index of the component.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial Int32 GetComponentInt32(string property, int index, Int32 defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property from an array as an unsigned 32-bit integer.
+        /// Returns the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="index">The index of the component.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial UInt32 GetComponentUInt32(string property, int index, UInt32 defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property from an array as a signed 64-bit integer.
+        /// Returns the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="index">The index of the component.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial Int64 GetComponentInt64(string property, int index, Int64 defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property from an array as an unsigned 64-bit integer.
+        /// Returns the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="index">The index of the component.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial UInt64 GetComponentUInt64(string property, int index, UInt64 defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property from an array as a 32-bit floating-point number.
+        /// Returns the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="index">The index of the component.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial float GetComponentFloat32(string property, int index, float defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property property from an array as a 64-bit 
+        /// floating-point number. Returns the default value if the property value cannot 
+        /// be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="index">The index of the component.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial double GetComponentFloat64(string property, int index, double defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property property from an array as a boolean value.
+        /// Returns the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="index">The index of the component.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial Boolean GetComponentBoolean(string property, int index, Boolean defaultValue);
+
+        /// <summary>
+        /// Gets the value of the specified property from an array as a string. Returns 
+        /// the default value if the property value cannot be converted to that type.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        /// <param name="index">The index of the component.</param>
+        /// <param name="defaultValue">The default value.</param>
+        public partial String GetComponentString(string property, int index, String defaultValue);
+
+        /// <summary>
+        /// Gets the number of components in the array.
+        /// <param name="property">The name of the property.</param>
+        /// </summary>
+        public partial int GetComponentCount(string property);
+
+        /// <summary>
+        /// Gets the type of component array.
+        /// <param name="property">The name of the property.</param>
+        /// </summary>
+        public partial MetadataType GetComponentType(string property);
+
+        /// <summary>
+        /// Gets the type of the specified property.
+        /// <param name="property">The name of the property.</param>
+        /// </summary>
+        public partial MetadataType GetMetadataType(string property);
+
+        /// <summary>
+        /// Determines if the specified property's value is normalized.
+        /// </summary>
+        /// <param name="property">The name of the property.</param>
+        public partial bool IsNormalized(string property);
+    }
+}

package/Runtime/CesiumFeature.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 7819f1c56f6c4284295780d3157719cb
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime/CesiumFeatureIdAttribute.cs

@@ -0,0 +1,61 @@
+using Reinterop;
+using System;
+using UnityEngine;
+
+namespace CesiumForUnity
+{
+    /// <summary>
+    /// Reports the status of a CesiumFeatureIdAttribute. If the feature ID
+    /// attribute cannot be accessed, this briefly indicates why.
+    /// </summary>
+    public enum CesiumFeatureIdAttributeStatus
+    {
+        /// <summary>
+        /// The feature ID attribute is valid.
+        /// </summary>
+        Valid,
+        /// <summary>
+        /// The feature ID attribute does not exist in the glTF primitive.
+        /// </summary>
+        ErrorInvalidAttribute,
+        /// <summary>
+        /// The feature ID attribute uses an invalid accessor in the glTF.
+        /// </summary>
+        ErrorInvalidAccessor
+    }
+
+    /// <summary>
+    /// Represents a feature ID attribute from a glTF primitive. Provides 
+    /// access to per-vertex feature IDs which can be used with the 
+    /// corresponding <see cref="CesiumPropertyTable"/> to access per-vertex
+    /// metadata.
+    /// </summary>
+    [ReinteropNativeImplementation("CesiumForUnityNative::CesiumFeatureIdAttributeImpl", "CesiumFeatureIdAttributeImpl.h")]
+    public partial class CesiumFeatureIdAttribute : CesiumFeatureIdSet
+    {
+        /// <summary>
+        /// The status of this feature ID attribute.
+        /// </summary>
+        public CesiumFeatureIdAttributeStatus status
+        {
+            get; internal set;
+        }
+
+        internal CesiumFeatureIdAttribute()
+        {
+            this.type = CesiumFeatureIdSetType.Attribute;
+            this.status = CesiumFeatureIdAttributeStatus.ErrorInvalidAttribute;
+            this.CreateImplementation();
+        }
+
+        /// <inheritdoc />
+        public override partial Int64 GetFeatureIdForVertex(Int64 vertexIndex);
+
+        /// <inheritdoc />
+        public override Int64 GetFeatureIdFromRaycastHit(RaycastHit hitInfo)
+        {
+            int vertex = CesiumPrimitiveFeatures.GetFirstVertexFromHitTriangle(hitInfo);
+            return this.GetFeatureIdForVertex(vertex);
+        }
+    }
+}

package/Runtime/CesiumFeatureIdAttribute.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 00523d00828a17948815bd0e493bca45
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime/CesiumFeatureIdSet.cs

@@ -0,0 +1,165 @@
+using System;
+using System.Collections.Generic;
+using UnityEngine;
+
+namespace CesiumForUnity
+{
+    /// <summary>
+    /// The type of a feature ID set.
+    /// </summary>
+    public enum CesiumFeatureIdSetType
+    {
+        None,
+        Attribute,
+        Texture,
+        Implicit
+    }
+
+    /// <summary>
+    /// Represents a feature ID set from a glTF primitive. A feature ID can be defined
+    /// as a per-vertex attribute, as a feature ID texture, or implicitly via vertex ID.
+    /// These can be used with the corresponding <see cref="CesiumPropertyTable"/> to 
+    /// access per-feature metadata.
+    /// </summary>
+    public class CesiumFeatureIdSet : IDisposable
+    {
+        #region Getters
+
+        /// <summary>
+        /// The type of this feature ID set.
+        /// </summary>
+        public CesiumFeatureIdSetType type
+        {
+            get; protected set;
+        }
+
+        /// <summary>
+        /// The label assigned to this feature ID set. If no label was present in
+        /// the glTF feature ID set, this returns an empty string.
+        /// </summary>
+        public String label
+        {
+            get; internal set;
+        }
+
+        /// <summary>
+        /// The number of features this primitive has.
+        /// </summary>
+        public Int64 featureCount
+        {
+            get; internal set;
+        }
+
+        /// <summary>
+        /// The null feature ID, i.e., the value that indicates no feature is
+        /// associated with the owner.In other words, if a vertex or texel returns
+        /// this value, then it is not associated with any feature.
+        /// </summary>
+        /// <remarks>
+        /// If this value was not defined in the glTF feature ID set, this returns -1.
+        /// </remarks>
+        public Int64 nullFeatureId
+        {
+            get; internal set;
+        }
+
+        /// <summary>
+        /// The index of the property table corresponding to this feature ID set.
+        /// The index can be used to fetch the appropriate <see cref="CesiumPropertyTable"/>
+        /// from the <see cref="CesiumModelMetadata"/>. 
+        /// <remarks>
+        /// If the feature ID set does not specify a property table, this returns -1.
+        /// </remarks>
+        /// </summary>
+        public Int64 propertyTableIndex
+        {
+            get; internal set;
+        }
+
+        #endregion
+
+        #region Constructors
+
+        internal CesiumFeatureIdSet() : this(0)
+        { }
+
+        internal CesiumFeatureIdSet(Int64 featureCount)
+        {
+            this.type = featureCount > 0 ? CesiumFeatureIdSetType.Implicit : CesiumFeatureIdSetType.None;
+            this.featureCount = featureCount;
+            this.label = "";
+            this.nullFeatureId = -1;
+            this.propertyTableIndex = -1;
+        }
+
+        #endregion
+
+        #region Public methods
+        /// <summary>
+        /// Gets the feature ID associated with a given vertex. The feature ID can be
+        /// used with a <see cref="CesiumPropertyTable"/> to retrieve the corresponding
+        /// metadata.
+        /// </summary>
+        /// <remarks>
+        /// This returns -1 if the given vertex is out-of-bounds, or if the feature ID
+        /// set is invalid.
+        /// </remarks>
+        /// <param name="vertexIndex">The index of the target vertex.</param>
+        /// <returns>The feature ID associated with the given vertex, or -1 for an
+        /// invalid feature ID set or invalid input.</returns>
+        public virtual Int64 GetFeatureIdForVertex(Int64 vertexIndex)
+        {
+            if (this.type != CesiumFeatureIdSetType.Implicit)
+            {
+                // Other methods should be handled by CesiumFeatureIdAttribute and
+                // CesiumFeatureIdTexture respectively.
+                return -1;
+            }
+
+            if (vertexIndex < 0 || vertexIndex >= this.featureCount)
+            {
+                return -1;
+            }
+
+            return vertexIndex;
+        }
+
+        /// <summary>
+        /// Gets the feature ID from the feature ID set using the given raycast hit.
+        /// This returns a more accurate value for feature ID textures, since they 
+        /// define feature IDs per-texel instead of per-vertex. The feature ID can
+        /// be used with a <see cref="CesiumPropertyTable"/> to retrieve the 
+        /// corresponding metadata.
+        /// </summary>
+        /// <remarks>
+        /// This can still retrieve the feature IDs for non-texture feature ID sets.
+        /// For attribute or implicit feature IDs, the first feature ID associated
+        /// with the first vertex of the intersected face is returned.<br/><br/>
+        /// 
+        /// This returns -1 if the feature ID set is invalid.
+        /// </remarks>
+        /// <param name="hitInfo">The raycast hit info.</param>
+        /// <returns>The feature ID associated with the given vertex, or -1 for an
+        /// invalid feature ID set.</returns>
+        public virtual Int64 GetFeatureIdFromRaycastHit(RaycastHit hitInfo)
+        {
+            if (this.type != CesiumFeatureIdSetType.Implicit)
+            {
+                // Other methods should be handled by CesiumFeatureIdAttribute and
+                // CesiumFeatureIdTexture respectively.
+                return -1;
+            }
+
+
+            return CesiumPrimitiveFeatures.GetFirstVertexFromHitTriangle(hitInfo);
+        }
+
+        #endregion
+
+        // Cache the list of indices to prevent the allocation of a new array every time
+        // GetFirstVertexFromHitTriangle is called.
+        List<int> _indices;
+
+        public virtual void Dispose() { }
+    }
+}

package/Runtime/CesiumFeatureIdSet.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 9831e7ff1f043494aa682f8d2f20be98
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime/CesiumFeatureIdTexture.cs

@@ -0,0 +1,68 @@
+using Reinterop;
+using System;
+using UnityEngine;
+
+namespace CesiumForUnity
+{
+    /// <summary>
+    /// Reports the status of a CesiumFeatureIdTexture. If the feature ID
+    /// texture cannot be accessed, this briefly indicates why.
+    /// </summary>
+    public enum CesiumFeatureIdTextureStatus
+    {
+        /// <summary>
+        /// The feature ID texture is valid.
+        /// </summary>
+        Valid,
+        /// <summary>
+        /// The feature ID texture cannot be found in the glTF, or the texture
+        /// itself has errors.
+        /// </summary>
+        ErrorInvalidTexture,
+        /// <summary>
+        /// The feature ID texture is being read in an invalid way -- for 
+        /// example, trying to read nonexistent image channels.
+        /// </summary>
+        ErrorInvalidTextureAccess
+    }
+
+    /// <summary>
+    /// Represents a feature ID texture from a glTF primitive. Provides 
+    /// access to per-texel feature IDs which can be used with the 
+    /// corresponding <see cref="CesiumPropertyTable"/> to access per-texel
+    /// metadata.
+    /// </summary>
+    [ReinteropNativeImplementation("CesiumForUnityNative::CesiumFeatureIdTextureImpl", "CesiumFeatureIdTextureImpl.h")]
+    public partial class CesiumFeatureIdTexture : CesiumFeatureIdSet
+    {
+        /// <summary>
+        /// The status of this feature ID texture.
+        /// </summary>
+        public CesiumFeatureIdTextureStatus status
+        {
+            get; internal set;
+        }
+
+        internal CesiumFeatureIdTexture()
+        {
+            this.type = CesiumFeatureIdSetType.Texture;
+            this.status = CesiumFeatureIdTextureStatus.ErrorInvalidTexture;
+            this.CreateImplementation();
+        }
+
+        /// <summary>
+        /// Gets the feature ID corresponding to the pixel specified by the UV texture
+        /// coordinates. The feature ID can be used with a <see cref="CesiumPropertyTable"/>
+        /// to retrieve the per-texel metadata.
+        /// </summary>
+        /// <param name="uv">The texture coordinates.</param>
+        /// <returns>The feature ID at the given texture coordinates, or -1 if the feature ID texture is invalid.</returns>
+        public partial Int64 GetFeatureIdForUV(Vector2 uv);
+
+        /// <inheritdoc />
+        public override partial Int64 GetFeatureIdForVertex(Int64 vertexIndex);
+
+        /// <inheritdoc />
+        public override partial Int64 GetFeatureIdFromRaycastHit(RaycastHit hitInfo);
+    }
+}

package/Runtime/CesiumFeatureIdTexture.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: b8d52d6db92283f45b49c6c030c8f31f
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: