4. Python¶
This section will show you how to run a Python sample in Windows.
4.1. Sample List¶
Samples are divided into five categories, Basic, Advanced, Util, Laser and UHP.
Basic: camera connection and basic capturing functions.
Advanced: advanced capturing functions.
Util: obtain information from a camera and set camera parameters.
Laser: for Laser/LSR series cameras only.
UHP: for UHP series cameras only.
Basic
ConnectToCamera: Connect to a Mech-Eye Industrial 3D Camera.
ConnectAndCaptureImage: Connect to a camera and obtain 2D image, depth map and 3D image.
CaptureColorMap: Obtain 2D image in OpenCV format from a camera.
CaptureDepthMap: Obtain depth map in OpenCV format from a camera.
CapturePointCloud: Obtain untextured and textured point clouds (PCL format) generated from images captured with a single exposure time.
CaptureHDRPointCloud: Obtain untextured and textured point clouds (PCL format) generated from images captured with multiple exposure times.
CapturePointCloudROI: Obtain untextured and textured point clouds (PCL format) of the objects in the ROI from a camera.
Advanced
CaptureCloudFromDepth: Construct point clouds from depth map and 2D image captured from a camera.
CaptureTimedAndPeriodically: Obtain 2D image, depth map and 3D images sequentially from multiple cameras.
CaptureSimultaneouslyMultiCamera: Obtain 2D image, depth map and 3D images simultaneously from multiple cameras.
CaptureSequentiallyMultiCamera: Obtain 2D image, depth map and 3D images periodically for the specified duration from a camera.
Util
GetCameraIntri: Get and print a camera’s intrinsic parameters.
PrintDeviceInfo: Get and print a camera’s information such as model, serial number and firmware version.
SetDepthRange: Set the range of depth values to be retained by a camera.
SetParameters: Set specified parameters to a camera.
SetUserSets: provide functions related to parameter groups, such as switching to a different parameter group, adding and deleting parameter groups, etc.
Laser
SetLaserFramePartitionCount: Divide the projector FOV into partitions and project structured light in one partition at a time. The output of the entire FOV is composed from images of all partitions.
SetLaserFrameRange: Set the projection range of the structured light. The entire projector FOV is from 0 to 100.
SetLaserFringeCodingMode: Set the coding mode of the structured light pattern.
SetLaserPowerLevel: Set the output power of the laser projector in percentage of max power. This affects the intensity of the laser light.
UHP
SetUHPCaptureMode: Set the capture mode (capture images with camera 1, with camera 2, or with both 2D cameras and compose the outputs).
SetUHPFringeCodingMode: Set the coding mode of the structured light pattern.
4.2. Requirements¶
Make sure that the Python you installed is version 3.6.8 or above
4.3. Instructions¶
4.3.1. Setting up Python¶
Press Win + R on the keyboard to open Run box. Type “PowerShell” and then press Ctrl+Shift+Enter to run PowerShell as Administrator.
Compulsory: MechEyeAPI 。
pip install MechEyeAPI
If an error occurs, please enter the command as below:
pip install MechEyeAPI -i http://pypi.douban.com/simple/ --trusted-host pypi.douban.com
Optional: open3d, opencv-python, opencv-contrib-python 。
Samples |
open3d |
opencv-python |
opencv-contrib-python |
CaptureColorMap |
√ |
√ |
|
CaptureDepthMap |
√ |
√ |
|
CapturePointCloud |
√ |
||
CaptureHDRPointCloud |
√ |
||
CapturePointCloudROI |
√ |
||
CaptureCloudFromDepth |
√ |
pip install opencv-python pip install opencv-contrib-python
Attention
The version of opencv-python should be the same as that of opencv-contrib-python.
4.3.2. Run Sample Program¶
The example below shows how to run CaptureColorMap.py.
Navigate to the directory where CaptureColorMap.py is located.
cd XXX\mecheye_python_samples/source/Basic
Run the sample.
python.exe CaptureColorMap.py
After running the program, you will get colorMap in samples directory.
