Class ModelNodeCollection

StereoKit/Assets/Model.cs:810–857

An enumerable for Model's ModelNodes

	/// <summary>An enumerable for Model's ModelNodes</summary>
	public class ModelNodeCollection : IEnumerable<ModelNode>
	{
		Model _model;
		/// <summary>This is the total number of nodes in the Model.</summary>
		public int Count => NativeAPI.model_node_count(_model._inst);
		/// <summary>Allows you to retrieve a node from this collection via its
		/// index.</summary>
		/// <param name="index">This should be in the range of [0, Count).</param>
		/// <returns>A ModelNode for the given index.</returns>
		public ModelNode this[int index] => new ModelNode(_model, NativeAPI.model_node_index(_model._inst, index));

		internal ModelNodeCollection(Model model) { _model = model; }

		/// <summary>Gets an enumerator for the collection.</summary>
		/// <returns>An enumerator.</returns>
		public IEnumerator<ModelNode> GetEnumerator()
		{
			int count = Count;
			for (int i = 0; i < count; i++)
				yield return new ModelNode(_model, NativeAPI.model_node_index(_model._inst, i));
		}
		IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();

		/// <summary>This adds a root node to the `Model`'s node hierarchy! If
		/// There is already an initial root node, this node will still be a
		/// root node, but will be a `Sibling` of the `Model`'s `RootNode`. If
		/// this is the first root node added, you'll be able to access it via
		/// `RootNode`.</summary>
		/// <param name="name">A text name to identify the node. If null is
		/// provided, it will be auto named to "node"+index.</param>
		/// <param name="modelTransform">A Matrix describing this node's
		/// transform in Model space.</param>
		/// <param name="mesh">The Mesh to attach to this Node's visual, if
		/// this is null, then material must also be null.</param>
		/// <param name="material">The Material to attach to this Node's
		/// visual, if this is null, then mesh must also be null.</param>
		/// <param name="solid">A flag that indicates the Mesh for this node
		/// will be used in ray intersection tests. This flag is ignored if no
		/// Mesh is attached.</param>
		/// <returns>This returns the newly added ModelNode, or if there's an
		/// issue with mesh and material being inconsistently null, then this
		/// result will also be null.</returns>
		public ModelNode Add(string name, Matrix modelTransform, Mesh mesh = null, Material material = null, bool solid = true)
		{
			return new ModelNode(_model,
				NativeAPI.model_node_add(_model._inst, name, modelTransform, mesh != null ? mesh._inst : IntPtr.Zero, material != null ? material._inst : IntPtr.Zero, solid ? 1 : 0));
		}
	}

	/// <summary>An enumerable for Model's visual ModelNodes</summary>
	public class ModelVisualCollection : IEnumerable<ModelNode>