Skip to main content
Version: 3.3

class XRScanningSubsystem

(Niantic.Lightship.AR.XRSubsystems.XRScanningSubsystem)

Overview​

Defines an interface for interacting with scanning functionality.

    class XRScanningSubsystem: SubsystemWithProvider< XRScanningSubsystem, XRScanningSubsystemDescriptor, XRScanningSubsystem.Provider > {
    public:
    
        class Provider;

        // properties
    
        XRScanningConfiguration CurrentConfiguration;

        // methods
    
        XRScanningSubsystem();
        XRScanningState GetState();
    
        bool TryGetRaycastBuffer(
            out XRTextureDescriptor colorBufferDescriptor,
            out XRTextureDescriptor normalBufferDescriptor,
            out XRTextureDescriptor positionTextureDescriptor
        );
    
        void ComputeVoxels();
        bool TryGetVoxelBuffer(out XRScanningVoxelData voxelData);
        void DisposeVoxelBuffer(XRScanningVoxelData voxelData);
        string GetScanId();
        void SaveCurrentScan();
        void DiscardCurrentScan();
    };

Detailed Documentation​

Defines an interface for interacting with scanning functionality.

This abstract class should be implemented by an XR provider and instantiated using the SubsystemManager to enumerate the available XRScanningSubsystemDescriptor s.

Properties​

CurrentConfiguration​

XRScanningConfiguration CurrentConfiguration

Get or set configuration with <name> XRScanningConfiguration </name>

Methods​

XRScanningSubsystem​

XRScanningSubsystem()

Constructor. Do not invoke directly; use the SubsystemManager to enumerate the available XRScanningSubsystemDescriptor s and call Create on the desired descriptor.

GetState​

XRScanningState GetState()

Get the current state of the scanning subsystem.

TryGetRaycastBuffer​

bool TryGetRaycastBuffer(
        out XRTextureDescriptor colorBufferDescriptor,
        out XRTextureDescriptor normalBufferDescriptor,
        out XRTextureDescriptor positionTextureDescriptor
    )

Get the latest raycast textures.

ComputeVoxels​

void ComputeVoxels()

Request a voxel buffer to be computed. This is an async operation that takes some time. Obtain the result with TryGetVoxels. "enableVoxels" must be set to true on the XRScanningConfiguration

TryGetVoxelBuffer​

bool TryGetVoxelBuffer(out XRScanningVoxelData voxelData)

Get latest computed voxel buffer. This then must be later disposed with DisposeVoxelBuffer

DisposeVoxelBuffer​

void DisposeVoxelBuffer(XRScanningVoxelData voxelData)

Dispose a voxel buffer previously obtained from TryGetVoxelBuffer

GetScanId​

string GetScanId()

Get the current scan's ID.

SaveCurrentScan​

void SaveCurrentScan()

Save the current scan. Recording will stop after save. ScanID will be reset.

DiscardCurrentScan​

void DiscardCurrentScan()

Discards the current scan. Anything previously saved will be deleted. Recording will stop after discard. ScanID will be reset.