stream.point_cloud

blickfeld_scanner.stream.point_cloud.signal_handler(sig, frame)
class blickfeld_scanner.stream.point_cloud.point_cloud(connection=None, from_file=None, filter=None, reference_frame=None)

Class to request a point cloud stream

Parameters

connection (blickfeld_scanner.scanner.connection) – connection to the device

REF_FRAME_XYZ = <Blickfeld Frame 0: 0 returns, 0.0x0.0 FoV, 1 scanlines>

Reference frame: XYZ coordinates, intensity

REF_FRAME_XYZ_I = <Blickfeld Frame 0: 0 returns, 0.0x0.0 FoV, 1 scanlines>

Reference frame: XYZ coordinates, intensity, frame id, scanline id, point id, return id

REF_FRAME_XYZ_I_ID = <Blickfeld Frame 0: 0 returns, 0.0x0.0 FoV, 1 scanlines>

Reference frame: XYZ coordinates, intensity, frame id, scanline id, point id, return id, timestamps

REF_FRAME_XYZ_I_ID_TS = <Blickfeld Frame 0: 0 returns, 0.0x0.0 FoV, 1 scanlines>

Reference frame: ambient_light_level, intensity, range, frame id, scanline id, point id

REF_FRAME_DEPTH_MAP = <Blickfeld Frame 0: 0 returns, 0.0x0.0 FoV, 1 scanlines>
close()

Close point cloud stream and connection. Always call this function before deleting a point_cloud_stream object.

get_metadata()

Get metadata of point cloud stream

Returns

Point cloud metadata, see: Protobuf definitions PointCloud.Metadata

recv_frame(fail_on_lost_frames=False)

Receive point cloud frame

Parameters

fail_on_lost_frames – An exception will be raised when a frame is lost. Please check performance of client or network. If file recording is enabled the compressions level of gzip can be reduced and therefore less CPU power is needed. See record_to_file()

Returns

point cloud frame with all the data in it, see: Protobuf definitions Frame

end_of_stream()

Check whether stream has ended. This function is required for point cloud streams of files

Returns

Bool if end of stream is reached

record_to_file(file_name, compresslevel=1)

Record point cloud stream to file

Parameters
  • file_name – Path to the file where it should be dumped

  • compresslevel – The compresslevel argument is an integer from 0 to 9 controlling the level of compression; 1 is fastest and produces the least compression, and 9 is slowest and produces the most compression. 0 is no compression. The default is 1. If frames are lost during the recording decrease the compression level.

stop_recording()

Stop recording. Always call this function or the blickfeld_scanner.stream.point_cloud.point_cloud.close() function before deleting a point_cloud object.