Python (Windows Platform)

Download Camport Multi_language SDK

Choose any of the following methods to download Camport Multi_language SDK:

  • Access: https://github.com/percipioxyz/camport_multi_language.git using a browser and download the Camport Multi_language SDK.

  • Use the git command to obtain a local copy: Open the terminal, switch to the working directory where the SDK should be stored, and enter the git clone command to clone the remote repository.

    git clone https://github.com/percipioxyz/camport_multi_language.git
    

Sample Program Descriptions

The sample programs are stored in the python folder in the root directory of the SDK. For detailed descriptions of the sample programs, refer to Sample Program Descriptions: Python.

Install Dependencies

Before compiling, please:

  • Install Python.

  • Install NumPy and OpenCV.

    pip install numpy
    pip install opencv-python -i https://pypi.tuna.tsinghua.edu.cn/simple
    
  • Install SWIG (version 4.0.2 or above).

    Download link: https://www.swig.org/download.html

  • Install CMake (version 3.15.0 or above).

    Download link: https://cmake.org/download/

  • Install Visual Studio.

Compile Sample Programs

To compile the sample programs, do the following:

  1. Configure environment variables: Right-click on This PC, select Properties > Advanced system settings > Environment Variables, in the Edit environment variables page, add the executable file path of the local SWIG to the system variable Path.

    ../_images/setpathforswig-en.gif
  2. Open the CMakeLists.txt in the camport_multi_language directory, set the target language to PYTHON, set the Python version to match the local Python version, and set the SWIG’s local path.

    ../_images/editcmakelistpython.png

    Tip

    If the compilation is interrupted due to SWIG path or version issues, you can manually select the correct SWIG path or version. Once configured, you can proceed with the compilation without needing to exit.

    ../_images/Selectionpath.png
  3. Create a new folder in the camport_multi_language directory and name it python_build_x64.

  4. Start cmake-gui, specify the source code directory as camport_multi_language, and specify the build output directory as camport_multi_language/python_build_x64.

    ../_images/specifydirectorypython.png
  5. Click on Configure, select the Visual Studio version and X86/X64 version settings.

    ../_images/clickcongifure_CP.png
  6. Click on Generate.

  7. Click on Open Project to open the project, then select Release in the Visual Studio menu bar and click on Build > Build Solution in order.

    ../_images/pythonmake-en.png

After compilation, copy the generated dynamic libraries pcammls.py and _pcammls.pyd, as well as the tycam.dll, to the camport_multi_language/python directory. Open Windows PowerShell and run the generated python file.

  • pcammls.py: python_build_x64/swig/swig/_output

  • _pcammls.pyd: python_build_x64/swig/Release

  • tycam.dll: camport3/lib/win/hostapp/x64

../_images/pythonrun.png