/// <summary>Generates a tree returns a <see cref="Chisel.Core.CSGTree"/> struct that contains a reference to it.</summary>
/// <param name="userID">A unique id to help identify this particular tree. For instance, this could be an InstanceID to a [UnityEngine.Object](https://docs.unity3d.com/ScriptReference/Object.html).</param>
/// <param name="children">The child nodes that are children of this tree. A tree may not have duplicate children, contain itself or contain a <see cref="Chisel.Core.CSGTree"/>.</param>
/// <returns>A new <see cref="Chisel.Core.CSGTree"/>. May be an invalid node if it failed to create it.</returns>
public static CSGTree Create(Int32 userID, params CSGTreeNode[] children)
{
int treeNodeID;
if (!GenerateTree(userID, out treeNodeID))
{
return new CSGTree()
{
treeNodeID = 0
}
}
;
if (children != null && children.Length > 0)
{
if (!CSGTreeNode.SetChildNodes(treeNodeID, children))
{
CSGTreeNode.DestroyNode(treeNodeID);
return(new CSGTree()
{
treeNodeID = 0
});
}
}
return(new CSGTree()
{
treeNodeID = treeNodeID
});
}
/// <summary>Generates a branch and returns a <see cref="Chisel.Core.CSGTreeBranch"/> struct that contains a reference to it.</summary>
/// <param name="userID">A unique id to help identify this particular branch. For instance, this could be an InstanceID to a [UnityEngine.Object](https://docs.unity3d.com/ScriptReference/Object.html)</param>
/// <param name="children">The child nodes that are children of this branch. A branch may not have duplicate children, contain itself or contain a <see cref="Chisel.Core.CSGTree"/>.</param>
/// <returns>A new <see cref="Chisel.Core.CSGTreeBranch"/>. May be an invalid node if it failed to create it.</returns>
public static CSGTreeBranch Create(Int32 userID, params CSGTreeNode[] children)
{
int branchNodeID;
if (!GenerateBranch(userID, out branchNodeID))
{
return new CSGTreeBranch()
{
branchNodeID = 0
}
}
;
if (children != null && children.Length > 0)
{
if (!CSGTreeNode.SetChildNodes(branchNodeID, children))
{
CSGTreeNode.DestroyNode(branchNodeID);
return(new CSGTreeBranch()
{
branchNodeID = 0
});
}
}
return(new CSGTreeBranch()
{
branchNodeID = branchNodeID
});
}
/// <summary>Generates a branch and returns a <see cref="Chisel.Core.CSGTreeBranch"/> struct that contains a reference to it.</summary>
/// <param name="userID">A unique id to help identify this particular branch. For instance, this could be an InstanceID to a [UnityEngine.Object](https://docs.unity3d.com/ScriptReference/Object.html)</param>
/// <param name="children">The child nodes that are children of this branch. A branch may not have duplicate children, contain itself or contain a <see cref="Chisel.Core.CSGTree"/>.</param>
/// <returns>A new <see cref="Chisel.Core.CSGTreeBranch"/>. May be an invalid node if it failed to create it.</returns>
public static CSGTreeBranch Create(Int32 userID = 0, CSGOperationType operation = CSGOperationType.Additive, params CSGTreeNode[] children)
{
int branchNodeID;
if (!GenerateBranch(userID, out branchNodeID))
{
return new CSGTreeBranch()
{
branchNodeID = 0
}
}
;
if (children != null && children.Length > 0)
{
if (operation != CSGOperationType.Additive)
{
CSGTreeNode.SetNodeOperationType(userID, operation);
}
if (!CSGTreeNode.SetChildNodes(branchNodeID, children))
{
CSGTreeNode.DestroyNode(branchNodeID);
return(new CSGTreeBranch()
{
branchNodeID = 0
});
}
}
return(new CSGTreeBranch()
{
branchNodeID = branchNodeID
});
}
/// <summary>Sets all the children of this <see cref="Chisel.Core.CSGTree"/> to the give array of <see cref="Chisel.Core.CSGTreeNode"/>s at the specified index.</summary>
/// <param name="array">The array whose <see cref="Chisel.Core.CSGTreeNode"/>s should be inserted into the <see cref="Chisel.Core.CSGTree"/>. The array itself cannot be null.</param>
/// <returns><b>true</b> on success, <b>false</b> on failure</returns>
public bool SetChildren(CSGTreeNode[] array)
{
if (array == null)
{
throw new ArgumentNullException("array");
}
return(CSGTreeNode.SetChildNodes(treeNodeID, array));
}