PointCloud

class HPS.PointCloud : public IDisposable 

The PointCloud class contains objects and enumerations used for importing and exporting XYZ, PTX, and PTS files.

Public Functions

void Dispose ()

PointCloud (HPS.PointCloud in_that)

class File : public IDisposable 

The File class provides functions to import and export XYZ, PTX, and PTS files.

Public Functions

void Dispose ()

File (HPS.PointCloud.File in_that)

Public Static Functions

HPS.PointCloud.ImportNotifier Import (string in_file_name, HPS.PointCloud.ImportOptionsKit in_options)

Performs an asynchronous import of the specified XYZ, PTX, or PTS file with the provided options. May throw an IOException prior to starting the asynchronous import.

Param in_file_name: Name of XYZ, PTX, or PTS file to import.
Param in_options: Options controlling the import of the XYZ, PTX, or PTS file (e.g., segment to import into).
Return: An ImportNotfier object that can be used to query the import progress and status.

class ImportNotifier : public HPS.IONotifier 

The ImportNotifier class is a smart-pointer that is associated with an asynchronous file import. It is used to interact with an ongoing import or get the results from a completed import.

Public Functions

void Assign (HPS.PointCloud.ImportNotifier in_that)

Associate this ImportNotifier with the same file import as the source ImportNotifier.

Param in_that: The source ImportNotifier for the assignment.

override void Dispose ()

HPS.PointCloud.ImportResultsKit GetResults ()

Get the ImportResultsKit for the file import. Throws an IOException if the import is not complete or was not successful.

Return: The ImportResultsKit for a successful file import.

ImportNotifier (): The default constructor creates an ImportNotifier object which is not associated with any file import.

ImportNotifier (HPS.IONotifier in_that)

The conversion constructor creates a new derived ImportNotifier object from a base IONotifier object. The copy will only be successful if the source notifier is really an upcast of this notifier type. Otherwise the copy will fail and the resulting ImportNotifier will be invalid.

Param in_that: The source IONotifier to copy.

ImportNotifier (HPS.PointCloud.ImportNotifier in_that)

The copy constructor creates a new ImportNotifier object that is associated with the same file import as the source ImportNotifier.

Param in_that: The source ImportNotifier to copy.

override HPS.Type ObjectType ()

This function returns the type the object, as declared (if the object is derived, this does not give the true type of the derived object).

Return: The declared type of the object in question, which may differ from the true, underlying type.

class ImportOptionsKit : public HPS.Kit 

The ImportOptionsKit class contains any settings controlling the import of XYZ, PTX, and PTS files.

Public Functions

override void Dispose ()

override bool Empty ()

Indicates whether this ImportOptionsKit has any values set on it.

Return: true if no values are set on this ImportOptionsKit, false otherwise.

bool Equals (HPS.PointCloud.ImportOptionsKit in_kit)

Check if the source ImportOptionsKit is equivalent to this ImportOptionsKit.

Param in_kit: The source ImportOptionsKit to compare to this ImportOptionsKit.
Return: true if the objects are equivalent, false otherwise.

override bool Equals (Object obj)

override int GetHashCode ()

ImportOptionsKit (): The default constructor creates an empty ImportOptionsKit object.

ImportOptionsKit (HPS.PointCloud.ImportOptionsKit in_kit)

The copy constructor creates a new ImportOptionsKit object that contains the same settings as the source ImportOptionsKit.

Param in_kit: The source ImportOptionsKit to copy.

override HPS.Type ObjectType ()

This function returns the type the object, as declared (if the object is derived, this does not give the true type of the derived object).

Return: The declared type of the object in question, which may differ from the true, underlying type.

void Set (HPS.PointCloud.ImportOptionsKit in_kit)

Copies the source ImportOptionsKit into this ImportOptionsKit.

Param in_kit: The source ImportOptionsKit to copy.

HPS.PointCloud.ImportOptionsKit SetPointColor (HPS.RGBColor in_color)

Sets the point color for each point in the cloud. If the point cloud explicitly provides colors for points this option will be ignored unless in_override is specified. If the file only describes an intensity for each point the color provided will be multilplied by the intensity to resolve the final point coloration unless in_override is specified in which case the intensity will be ignored. If the file describes no intensity or color (or in_override is specified), this will set the vertex color at the containing segment.

Param in_color: The color to use.
Return: A reference to this ImportOptionsKit.

HPS.PointCloud.ImportOptionsKit SetPointColor (HPS.RGBColor in_color, bool in_override)

Sets the point color for each point in the cloud. If the point cloud explicitly provides colors for points this option will be ignored unless in_override is specified. If the file only describes an intensity for each point the color provided will be multilplied by the intensity to resolve the final point coloration unless in_override is specified in which case the intensity will be ignored. If the file describes no intensity or color (or in_override is specified), this will set the vertex color at the containing segment.

Param in_color: The color to use.
Param in_override: Specifies whether to override the point colors specified in the file (if any) with the color provided
Return: A reference to this ImportOptionsKit.

HPS.PointCloud.ImportOptionsKit SetSegment (HPS.SegmentKey in_segment)

Sets the root segment where the point cloud data will be imported into. If no segment is specified, a root segment will be created for this purpose during import.

Param in_segment: Segment the point cloud data will be imported into.
Return: A reference to this ImportOptionsKit.

void Show (out HPS.PointCloud.ImportOptionsKit out_kit)

Copies this ImportOptionsKit into the given ImportOptionsKit.

Param out_kit: The ImportOptionsKit to populate with the contents of this ImportOptionsKit.

bool ShowPointColor (out HPS.RGBColor out_color, out bool out_override)

Shows the point color to use during import.

Param out_color: The color being used.
Param out_override: Specifies whether the point colors specified in the file (if any) will be override with the color provided
Return: true if a root segment was specified, false otherwise.

bool ShowSegment (out HPS.SegmentKey out_segment)

Shows the root segment where the HSF data will be imported into.

Param out_segment: Segment the HSF data will be imported into.
Return: true if a root segment was specified, false otherwise.

HPS.PointCloud.ImportOptionsKit UnsetEverything ()

Removes all settings from this ImportOptionsKit.

Return: A reference to this ImportOptionsKit.

HPS.PointCloud.ImportOptionsKit UnsetPointColor ()

Remove the point color to use during import.

Return: A reference to this ImportOptionsKit.

HPS.PointCloud.ImportOptionsKit UnsetSegment ()

Removes the root segment speciyfing where the point cloud data will be imported into.

Return: A reference to this ImportOptionsKit.

Public Static Functions

bool operator!= (HPS.PointCloud.ImportOptionsKit a, HPS.PointCloud.ImportOptionsKit b)

bool operator== (HPS.PointCloud.ImportOptionsKit a, HPS.PointCloud.ImportOptionsKit b)

class ImportResultsKit : public HPS.Kit 

The ImportResultsKit class contains the results of a successful point cloud import.

Public Functions

override void Dispose ()

override bool Empty ()

Indicates whether this ImportResultsKit has any values set on it.

Return: true if no values are set on this ImportResultsKit, false otherwise.

bool Equals (HPS.PointCloud.ImportResultsKit in_kit)

Check if the source ImportResultsKit is equivalent to this ImportResultsKit.

Param in_kit: The source ImportResultsKit to compare to this ImportResultsKit.
Return: true if the objects are equivalent, false otherwise.

override bool Equals (Object obj)

override int GetHashCode ()

ImportResultsKit (): The default constructor creates an empty ImportResultsKit object.

ImportResultsKit (HPS.PointCloud.ImportResultsKit in_kit)

The copy constructor creates a new ImportResultsKit object that contains the same settings as the source ImportResultsKit.

Param in_kit: The source ImportResultsKit to copy.

override HPS.Type ObjectType ()

This function returns the type the object, as declared (if the object is derived, this does not give the true type of the derived object).

Return: The declared type of the object in question, which may differ from the true, underlying type.

void Set (HPS.PointCloud.ImportResultsKit in_kit)

Copies the source ImportResultsKit into this ImportResultsKit.

Param in_kit: The source ImportResultsKit to copy.

HPS.PointCloud.ImportResultsKit SetSegment (HPS.SegmentKey in_segment)

Sets the root segment which the point cloud data was imported into. This is really only used when generating an ImportResultsKit which is being returned to a user following an point cloud import.

Param in_segment: Segment the point cloud data was imported into.
Return: A reference to this ImportResultsKit.

void Show (out HPS.PointCloud.ImportResultsKit out_kit)

Copies this ImportResultsKit into the given ImportResultsKit.

Param out_kit: The ImportResultsKit to populate with the contents of this ImportResultsKit.

bool ShowSegment (out HPS.SegmentKey out_segment)

Shows the root segment which the point cloud data was imported into. This was either the root segment specified by the user in the ImportOptionsKit passed to OBJ.File.Import, or the root segment that was created for this purpose during import.

Param out_segment: Segment the point cloud data was imported into.
Return: true if a root segment was specified, false otherwise.

HPS.PointCloud.ImportResultsKit UnsetEverything ()

Removes all settings from this ImportResultsKit.

Return: A reference to this ImportResultsKit.

HPS.PointCloud.ImportResultsKit UnsetSegment ()

Removes the root segment which the point cloud data was imported into. This is really only used when generating an ImportResultsKit which is being returned to a user following an point cloud import.

Return: A reference to this ImportResultsKit.

Public Static Functions

bool operator!= (HPS.PointCloud.ImportResultsKit a, HPS.PointCloud.ImportResultsKit b)

bool operator== (HPS.PointCloud.ImportResultsKit a, HPS.PointCloud.ImportResultsKit b)