C#

Vous consultez actuellement la documentation pour la dernière version (2.5.4). Pour accéder à une autre version, cliquez sur le bouton "Changer de version" situé dans le coin supérieur droit de la page.

■ Si vous n’êtes pas sûr de la version du produit que vous utilisez, veuillez contacter le support technique Mech-Mind pour obtenir de l’aide.

Ce sujet explique comment compiler les exemples C# de Mech-Eye API avec Visual Studio sous Windows.

Liste des exemples

Les exemples sont répartis dans les catégories suivantes : Basique, Avancé, Utilitaire et Étalonnage.

  • Basic exemples: Se connecter et acquérir des données.

  • Advanced exemples: Acquérir des données de manière plus complexe et définir des paramètres spécifiques au modèle.

  • Util exemples: Obtenir les informations de la caméra et définir des paramètres communs.

  • Calibration exemples: Effectuer l’étalonnage main-œil avec Mech-Eye API.

The samples in each category and their descriptions are provided below.

Basic

  • ConnectToCamera: Se connecter à une caméra.

  • ConnectAndCaptureImages: Se connecter à une caméra et obtenir l’image 2D, la carte de profondeur et les données de nuage de points.

  • Capture2DImage: Obtenir et enregistrer l’image 2D.

  • CaptureDepthMap: Obtenir et enregistrer la carte de profondeur.

  • CapturePointCloud: Obtenir et enregistrer les nuages de points non texturés et texturés.

  • CapturePointCloudHDR: Définir plusieurs temps d’exposition, puis obtenir et enregistrer le nuage de points.

  • CapturePointCloudWithNormals: Calculer les normales et enregistrer le nuage de points avec des normales.

  • SaveVirtualDevice: Enregistrer les données acquises par la caméra en tant que fichier de périphérique virtuel.

Advanced

  • ConvertDepthMapToPointCloud: Générer un nuage de points à partir de la carte de profondeur et enregistrer le nuage de points.

  • MultipleCamerasCaptureSequentially: Obtenir et enregistrer des images 2D, des cartes de profondeur et des nuages de points de manière séquentielle depuis plusieurs caméras.

  • MultipleCamerasCaptureSimultaneously: Obtenir et enregistrer simultanément des images 2D, des cartes de profondeur et des nuages de points depuis plusieurs caméras.

  • CapturePeriodically: Obtenir et enregistrer périodiquement, pendant la durée spécifiée, des images 2D, des cartes de profondeur et des nuages de points depuis une caméra.

  • Mapping2DImageToDepthMap: Générer des nuages de points non texturés et texturés à partir d’une image 2D masquée et d’une carte de profondeur.

  • RenderDepthMap: Obtenir et enregistrer la carte de profondeur rendue avec la palette de couleurs jet.

  • TransformPointCloud: Obtenir et enregistrer les nuages de points dans le repère personnalisé.

  • SetParametersOfLaserCameras: Définir les paramètres spécifiques aux caméras laser (les séries DEEP et LSR).

  • SetParametersOfUHPCameras: Définir les paramètres spécifiques à la série UHP.

  • RegisterCameraEvent: Définir et enregistrer la fonction de rappel pour surveiller les événements de la caméra.

  • WarmUp: Préchauffer l’appareil.

  • CaptureStereo2DImages: Obtenir les images 2D des deux caméras 2D de Laser L Enhanced, LSR L-GL, LSR S-GL, NANO ULTRA-GL, et DEEP-GL.

Util

  • GetCameraIntrinsics: Obtenir et afficher les paramètres intrinsèques de la caméra.

  • PrintCameraInfo: Obtenir et afficher les informations de la caméra, telles que le modèle, le numéro de série, la version du firmware et les températures.

  • SetScanningParameters: Définir les paramètres dans les catégories Paramètres 3D, Paramètres 2D et ROI.

  • SetDepthRange: Définir le paramètre Plage de profondeur.

  • SetPointCloudProcessingParameters: Définir les paramètres de Traitement du nuage de points.

  • ManageUserSets: Gérer des groupes de paramètres, par exemple obtenir les noms de tous les groupes de paramètres, ajouter un groupe de paramètres, changer de groupe de paramètres et enregistrer des réglages de paramètres dans le groupe de paramètres.

  • SaveAndLoadUserSet: Importer et remplacer tous les groupes de paramètres depuis un fichier JSON, et enregistrer tous les groupes de paramètres dans un fichier JSON.

Calibration

  • HandEyeCalibration: Effectuer l’étalonnage main-œil.

Prérequis

Pour utiliser les exemples C# de Mech-Eye API, les prérequis suivants doivent être satisfaits :

Obtenir les exemples

Les exemples C# sont inclus dans le chemin d’installation de Mech-Eye SDK ou peuvent être obtenus en clonant depuis GitHub. Les exemples dans le chemin d’installation correspondent à la version au moment de la sortie de Mech-Eye SDK. La version sur GitHub peut contenir les dernières modifications.

  • Les exemples dans le chemin d’installation se trouvent dans xxx/Mech-Eye SDK-2.5.4/API/samples/csharp/area_scan_3d_camera.

  • Les exemples clonés depuis GitHub se trouvent dans xxx/mecheye_csharp_samples/area_scan_3d_camera.

Installer les logiciels requis

Afin d’utiliser les exemples C++ de Mech-Eye API, Mech-Eye SDK, Visual Studio et Emgu CV doivent être installés.

Installer la dernière version de Mech-Eye SDK

Veuillez installer ou mettre à niveau Mech-Eye SDK conformément à Guide d’installation de Mech-Eye SDK.

Installer Visual Studio (version 2019 ou supérieure)

  1. Téléchargez le Programme d’installation de Visual Studio.

  2. Lors de l’installation, sélectionnez les charges de travail et le composant individuel suivants, puis cliquez sur Installer.

    • Charges de travail dans la catégorie Bureau et mobile:

      • Développement .NET pour le bureau

      • Développement de bureau avec C++

      • Développement pour la plateforme Windows universelle

    • Composant individuel : .Kit de ciblage .NET Framework 4.8

L’API Mech-Eye API pour C# est développée sur la base de .NET Framework 4.8. Si .NET Framework 4.8 n’est pas installé, les exemples ne peuvent pas être compilés.

Installer Emgu CV

Les exemples CaptureDepthMap et RenderDepthMap contiennent des fonctions qui dépendent de la bibliothèque logicielle OpenCV. Par conséquent, Emgu CV (le wrapper .NET pour OpenCV) doit être installé via le NuGet Package Manager dans Visual Studio.

Pour des instructions détaillées, consultez le guide fourni par Microsoft.

Compiler et exécuter les exemples

Après avoir compilé les exemples dans Visual Studio, choisissez la méthode appropriée pour exécuter les exemples.

Compiler les exemples dans Visual Studio

  1. Double-cliquez sur MechEyeCSharpSamples.sln dans le dossier area_scan_3d_camera.

  2. Dans la barre d’outils de Visual Studio, changez la configuration de la solution de Debug à Release.

  3. Dans la barre de menus, sélectionnez Générer  Générer la solution. Un fichier exécutable (.exe) est généré pour chaque exemple. Les fichiers exécutables sont enregistrés dans le dossier Build, situé dans le dossier area_scan_3d_camera.

Exécuter les exemples

Vous pouvez exécuter les exemples dans Visual Studio après les avoir compilés, ou exécuter les exemples en double-cliquant sur les fichiers exécutables.

Exécuter un exemple dans Visual Studio

  1. Dans le panneau Explorateur de solutions, cliquez avec le bouton droit sur un exemple et sélectionnez Définir comme projet de démarrage.

  2. Cliquez sur Débogueur Windows local dans la barre d’outils pour exécuter l’exemple.

    Pendant l’exécution de l’exemple, saisissez l’indice du Caméra auquel vous souhaitez vous connecter selon les instructions, puis appuyez sur Entrée pour vous connecter au Caméra.

  3. Si des fichiers d’image et/ou de nuage de points sont enregistrés par l’exemple, vous pouvez les trouver dans le dossier Build.

Exécuter le fichier exécutable d’un exemple

  1. Accédez au dossier Build dans le dossier area_scan_3d_camera.

  2. Exécutez le fichier exécutable portant le même nom que l’exemple.

    Pendant l’exécution de l’exemple, saisissez l’indice du Caméra auquel vous souhaitez vous connecter selon les instructions, puis appuyez sur Entrée pour vous connecter au Caméra.

  3. Si des fichiers d’image et/ou de nuage de points sont enregistrés par l’exemple, vous pouvez les trouver dans le dossier Build.

Cette page est-elle utile ?

Veuillez nous indiquer comment améliorer :

Nous accordons de l’importance à votre vie privée

Nous utilisons des cookies pour vous offrir la meilleure expérience possible sur notre site web. En continuant à utiliser le site, vous reconnaissez accepter l’utilisation des cookies. Si vous refusez, un cookie unique sera utilisé pour garantir que vous ne soyez pas suivi ou reconnu lors de votre visite sur ce site.

  • Préférence
  • J’accepte
  • Je n’accepte pas