Creates a new point cloud type for a given point cloud engine.

Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 22.0.0.0 (22.1.1.0)
Since: 2012

Syntax

C#
public static PointCloudType Create( Document document, string engineIdentifier, string typeIdentifier )

Visual Basic
Public Shared Function Create ( _ document As Document, _ engineIdentifier As String, _ typeIdentifier As String _ ) As PointCloudType

Visual C++
public: static PointCloudType^ Create( Document^ document, String^ engineIdentifier, String^ typeIdentifier )

Parameters

document: Type: Autodesk.Revit.DB..::..Document
The document in which to create the point cloud.

engineIdentifier: Type: System..::..String
The string identifying the engine to be invoked. It should be the file extension or engine identifier registered by the third party.

typeIdentifier: Type: System..::..String
The file name or the identification string for a non-file based engine.

Return Value

The newly created PointCloudType object to be used to create instances of this point cloud.

Remarks

A list of supported engine identifiers and whether they are file-based or not can be obtained from PointCloudEngineRegistry. The method GetSupportedEngines() returns a list of the identifiers registered for engines.

Examples

CopyC#

private PointCloudInstance CreatePointCloud(Document doc)
{
    PointCloudType type = PointCloudType.Create(doc, "rcs", "c:\\32_cafeteria.rcs");
    return (PointCloudInstance.Create(doc, type.Id, Transform.Identity));
}

CopyVB.NET

Private Function CreatePointCloud(doc As Document) As PointCloudInstance
    Dim type As PointCloudType = PointCloudType.Create(doc, "rcs", "c:\32_cafeteria.rcs")
    Return (PointCloudInstance.Create(doc, type.Id, Transform.Identity))
End Function

Exceptions

Exception	Condition
Autodesk.Revit.Exceptions..::..ArgumentException	The engine identifier was not found in the Revit session. -or- document is not a project document.
Autodesk.Revit.Exceptions..::..ArgumentNullException	A non-optional argument was null
Autodesk.Revit.Exceptions..::..FileNotFoundException	The external file could not be found or loaded.
Autodesk.Revit.Exceptions..::..InvalidOperationException	Unable to create a point cloud from the third party engine.
Autodesk.Revit.Exceptions..::..ModificationForbiddenException	The document is in failure mode: an operation has failed, and Revit requires the user to either cancel the operation or fix the problem (usually by deleting certain elements). -or- The document is being loaded, or is in the midst of another sensitive process.
Autodesk.Revit.Exceptions..::..ModificationOutsideTransactionException	The document has no open transaction.