Skip to main content

Élément de visualisation : Path3D

Note

L'élément ne fonctionne pas avec le CODESYS HMI variante d'affichage.

Symbole:

visu_img_path3d.png

Catégorie: Contrôles spéciaux

Le Chemin3D Cet élément de visualisation affiche graphiquement les courbes de deux enregistrements indépendants sous forme de trajectoire 3D. Il est spécialement conçu pour une utilisation avec les commandes numériques (CNC) afin de visualiser la trajectoire d'une machine-outil ou d'un robot. La trajectoire programmée (trajectoire) et la trajectoire réellement parcourue (piste) sont affichées.

Bien que l'élément de visualisation soit conçu pour être utilisé avec CODESYS SoftMotion En CNC, il peut également être utilisé pour afficher tout autre enregistrement. Dans ce cas, l'application doit fournir les données de chemin.

Si l'élément est utilisé avec CODESYS SoftMotion CNC, puis blocs fonctionnels de la bibliothèque SM3_CNC_Visu Aide à générer les données du chemin et de la piste. Ces blocs fonctionnels sont utilisés par le projet d'exemple. CNC_File_3DPath, qui est stocké dans le répertoire d'installation de CODESYS.

  • SMC_PathCopier

  • SMC_PathCopierCompleteQueue

  • SMC_PathCopierFile

  • SMC_PositionTracker

Une description des blocs fonctionnels se trouve dans le gestionnaire de bibliothèque de la bibliothèque SM3_CNC_Visu.

Avis

0_Sample_ProjectExemple de projet : « Générateur de chemin 3D »

0_Sample_Project projet CNC_File_3DPath (inclus dans le CODESYSrépertoire d'installation)

Propriétés des éléments

Toutes les propriétés des éléments sont-elles disponibles ?

Toutes les propriétés ne sont disponibles qu'après avoir sélectionné le Avancé option ou la Toutes les catégories filtrer dans Propriétés.

Nom de l'élément

Exemple: GenElemInst_1

Astuce

Attribuez des noms individuels aux éléments afin qu'ils soient trouvés plus rapidement dans la liste des éléments.

Type d'élément

Path3D

Position

La position définit l'emplacement et la taille de l'élément dans la fenêtre de visualisation. Elle est basée sur le système de coordonnées cartésiennes. L'origine se situe dans le coin supérieur gauche de la fenêtre. L'axe horizontal positif des X est orienté vers la droite. L'axe vertical positif des Y est orienté vers le bas.

X

La coordonnée X (en pixels) du coin supérieur gauche de l'élément

Exemple: 10

Y

La coordonnée Y (en pixels) du coin supérieur gauche de l'élément

Exemple: 10

Largeur

Spécifié en pixels

Exemple: 150

Hauteur

Spécifié en pixels

Exemple: 30

Astuce

Vous pouvez modifier les valeurs en faisant glisser la module _visu_icon_position_element.png symboles vers d'autres positions dans l'éditeur.

Description du chemin

Données de chemin (VisuStruct3DTrack)

Variable de type VisuStruct3DTrack qui est déclaré dans le code CEI

Exemple: PLC_PRG.pc.vs3dt.

Une description de la structure peut être trouvée dans le gestionnaire de bibliothèque dans le VisuElem3DPath.library bibliothèque.

La structure de données décrit un chemin ou une piste par un nombre spécifique de points. Les points sont déterminés et tamponnés par l'application. La piste affiche généralement les n dernières positions de sorte que seule une partie spécifique d'entre elles soit affichée à la fois.

VisuStruct3DTrack.pProjection est une variable définie par l'élément de visualisation et contient des informations sur la projection du chemin/de la piste. Il peut (uniquement) être lu par l'application. De plus, le Projection.Apply ou .ApplyV peuvent être utilisées pour voir si la position transformée est à l'intérieur ou à l'extérieur de la zone d'affichage de la visualisation telle que définie par Projection.ElementRect.

Couleur du chemin

Couleur du chemin tracé

Largeur de ligne de chemin

Largeur de la ligne du chemin (en pixels)

Exemple: 2

Marquage du point de bordure

. Affichage des points entre deux objets consécutifs dans le chemin
  • Les extrémités ne sont pas marquées

  • Les extrémités sont marquées d'un cercle

  • Les extrémités sont marquées d'une croix

  • Les extrémités sont marquées d'un signe plus

Description de la piste

Les données de piste sont structurées de la même manière que les données de chemin : VisuStruct3DTrack

Suivre les données (VisuStruct3DTrack)

Variable de type VisuStruct3DTrack qui est déclaré dans le code CEI

Exemple: PLC_PRG.pc.vs3dt

Une description de la structure peut être trouvée dans le gestionnaire de bibliothèque dans le VisuElem3DPath.library bibliothèque.

Couleur de piste

Couleur de la piste tracée

Épaisseur de ligne de voie

Épaisseur de ligne de piste (en pixels)

Exemple : 2

Contrôle de la caméra

La position de la caméra pour le mode 3D est contrôlée avec une référence à une structure de données externe.

Cette structure permet les opérations suivantes :

  • Déplacer vers la gauche/droite/haut/bas

  • Rotation autour de l'axe X/Y/Z

  • Réinitialisez la vue sur le plan X/Y, Y/Z ou Z/X afin que la bande et le chemin soient entièrement visibles

Structure de données de contrôle (VisuStruct3DControl)

Variable de type VisuStruct3DControl qui est déclaré dans le code CEI

Exemple: PLC_PRG.pc.vs3dc

Les valeurs peuvent être définies via l'application elle-même ou via le Panneau de commande élément de visualisation. le VisuElem3DPath La bibliothèque contient des cadres de visualisation prêts à l'emploi qui fournissent une interface utilisateur possible pour ces données.

Une description de la structure peut être trouvée dans le gestionnaire de bibliothèque dans le VisuElem3DPath bibliothèque.

Configuration d'entrée

Les propriétés contiennent les configurations pour l'entrée de l'utilisateur lors de l'utilisation de la souris ou du clavier. Une entrée utilisateur définit un événement et une ou plusieurs actions qui sont exécutées lorsqu'un événement se produit.

Astuce

le Configurer bouton ouvre le Configuration des entrées dialogue. Vous pouvez y créer ou modifier des entrées utilisateur.

Les entrées utilisateur configurées sont répertoriées sous les événements. Ils incluent chacun l'action qui est déclenchée et le paramètre sous forme abrégée.

Exemple: Exécuter le code ST: _visu_icon_action.png PLC_PRG.i_x := 0;

OnDialogClosed

Evénement d'entrée : L'utilisateur ferme la boîte de dialogue.

OnMouseClick

Evénement d'entrée : L'utilisateur clique complètement sur le bouton de la souris dans la zone de l'élément. Le bouton de la souris est cliqué et relâché.

OnMouseDown

Événement d'entrée : l'utilisateur clique sur le bouton de la souris.

OnMouseEnter

Événement d'entrée : l'utilisateur fait glisser le pointeur de la souris sur l'élément.

OnMouseLeave

Evénement d'entrée : l'utilisateur éloigne le pointeur de la souris de l'élément.

OnMouseMove

Evénement d'entrée : L'utilisateur déplace le pointeur de la souris sur la zone de l'élément.

OnMouseUp

. Événements d'entrée :
  • L'utilisateur relâche le bouton de la souris dans la zone de l'élément. Peu importe que l'utilisateur ait auparavant appuyé sur le bouton de la souris à l'intérieur ou à l'extérieur de la zone de l'élément.

  • L'utilisateur appuie sur le bouton de la souris dans la zone de l'élément, quitte la zone de l'élément, puis relâche le bouton de la souris.

Note

Ce CODESYS-un comportement de déclenchement spécifique garantit que les actions pour les éléments clés sont terminées. Un élément clé déclenche une action pour OnMouseDown et met fin à l'action pour OnMouseUp.

Exemple : Un utilisateur de visualisation appuie sur le bouton de la souris dans la zone d'élément de l'élément clé, puis déplace la position du curseur de manière à ce qu'il se trouve en dehors de la zone d'élément. L'action est quand même terminée car OnMouseUp est déclenché.

OnValueChanged

Evénement qui déclenche des actions de suivi en raison d'un changement de valeur

Les actions de suivi déclenchées sont configurées dans le Configuration d'entrée dialogue.

Les actions de suivi définies et la configuration correspondante sont affichées sous la propriété de l'élément.

La OnValueChanged l'événement peut être désactivé par le VISU_NO_VALUECHANGED compilateur définir dans la boîte de dialogue des propriétés de l'application.

Robinet

Lorsqu'un événement de clic de souris se produit, la variable définie dans Variable est décrit dans la demande. Le codage dépend de la Appuyez sur FAUX et Appuyez sur entrer si capturé options.

Variable

Exigence : Le Appuyez sur FAUX l'option n'est pas activée.

variables (BOOL) pour l'événement de clic de souris

TRUE: Un événement de clic de souris existe. Elle dure tant que l'utilisateur appuie sur le bouton de la souris sur l'élément. Il se termine lorsque le bouton est relâché.

FALSE: Un événement de clic de souris n'existe pas.

Exemple: PLC_PRG.bIsTapped

Appuyez sur FAUX

standard icon: L'événement clic souris conduit à une valeur complémentaire dans Variable.

TRUE: Un événement de clic de souris n'existe pas.

FALSE: tant que l'événement de clic de souris existe.

Appuyez sur entrer si capturé

standard icon: Lors de la saisie de l'utilisateur, il est également pris en compte si le pointeur de la souris est déplacé ou non dans la zone de l'élément lorsque le bouton de la souris est enfoncé.

TRUE: tant que l'événement de clic de souris existe et que le pointeur de la souris est déplacé sur la zone de l'élément.

FALSE: Un événement de clic de souris n'existe pas. Soit l'utilisateur déplace le pointeur de la souris en dehors de la zone de l'élément pendant que le bouton de la souris est enfoncé.

La valeur est TRUE à nouveau dès que l'utilisateur ramène le pointeur sur la zone de l'élément. La souris est alors capturée.

Basculer

Au début d'un événement de clic de souris, la variable est définie ; lorsque l'événement de clic de souris est terminé, la variable est réinitialisée.

Variable

variables (BOOL) pour basculer à la fin de l'événement de clic de souris

C'est lorsque l'utilisateur relâche le bouton de la souris alors que le pointeur de la souris est sur la zone d'élément. basculé.

Astuce

L'utilisateur peut annuler une entrée de bascule commencée en faisant glisser le pointeur de la souris hors de la zone de l'élément.

Activer si capturé

standard icon: La valeur bascule indépendamment de l'endroit où se trouve le pointeur de la souris lorsque le bouton de la souris est relâché. La souris est alors capturée.

Raccourci

Raccourci sur l'élément pour déclencher des actions de saisie spécifiques

Lorsque l'événement de raccourci clavier se produit, les actions d'entrée dans le Événements propriété sont déclenchées. De cette manière, ce n'est pas l'action de saisie elle-même qui conduit à cette action de saisie, mais l'action de saisie de la souris.

Clé

Touche enfoncée pour l'action d'entrée.

Exemple: J

Les propriétés suivantes s'affichent lorsqu'une touche est sélectionnée.

Événements

  • Aucun

  • Souris vers le bas: L'appui sur la touche déclenche les actions d'entrée qui sont configurées dans le OnMouseDown biens.

  • Souris vers le haut: Le relâchement de la touche déclenche les actions de saisie qui sont configurées dans le OnMouseUp biens.

  • Souris bas/haut: L'appui et le relâchement de la touche déclenchent les actions d'entrée qui sont configurées dans le OnMouseDown la propriété et la OnMouseUp biens.

Basculer

standard icon: Combinaison avec la touche "Shift"

Exemple: Changement+J.

Contrôler

standard icon: Combinaison avec la touche "Ctrl"

Exemple: Ctrl+J.

Autre

standard icon: Combinaison avec la touche "Alt"

Exemple: Autre+J.

Astuce

Tous les raccourcis clavier et leurs actions qui sont configurés dans la visualisation sont répertoriés sur la Configuration du clavier languette.

Aspects supplémentaires

Système de coordonnées

standard icon: Le système de coordonnées s'affiche.

Grille

standard icon: Les lignes de la grille sont affichées

Couleur de la grille

Couleur des lignes de la grille

Surligner

Les différentes parties du chemin peuvent être mises en évidence visuellement. En règle générale, cela est utilisé pour marquer la partie déjà terminée d'une piste avec une couleur différente. Chaque point de la trajectoire reçoit un identifiant unique qui, dans le cas d'un éditeur CNC, est lié à l'identifiant de l'objet sur lequel se trouve le point. Cet ID ("highlight ID") peut être spécifié via l'application afin que des éléments/parties du chemin puissent être mis en évidence dynamiquement.

Type de surbrillance

. Sélectionnez l'un des types de surbrillance suivants :
  • Seul l'élément dont l'ID correspond à la valeur de la variable est mis en surbrillance.

  • Tous les éléments dont l'identifiant (dans le cas d'un éditeur CNC lié à l'identifiant de l'objet) est inférieur ou égal à la valeur dans Variable sont mis en évidence.

Variable

Variable de projet qui spécifie l'ID d'un élément

Exemple: PLC_PRG.iVarElementID

Cet « identifiant de surbrillance » est pris en compte pour le réglage de la Type de surbrillance. Les variables peuvent être utilisées dans l'application.

Couleur de surbrillance

Exemple: rouge

Apparence

Largeur de la bordure

Epaisseur du cadre autour de l'élément (en pixels)

Exemple: 1

Style de bordure

. Sélectionnez l'un de ces types de style pour la ligne de cadre :
  • Solide

  • Tiret

  • Points

  • Tiret Point

  • Tiret Point Point

  • Invisible

Arrière-plan transparent

standard icon: Le fond de l'élément est affiché en transparence.

_cds_icon_option_deactivated.png: Le fond de l'élément est affiché dans la couleur de fond définie.

Couleur de l'arrière plan

Couleur de style ou couleur

Centre

Les propriétés contiennent des valeurs fixes pour les coordonnées du point de rotation. Le point de rotation est affiché dans l'éditeur sous la forme _visu_icon_center_point.png symbole et est utilisé comme centre de rotation et de mise à l'échelle.

Astuce

Vous pouvez également modifier les valeurs en faisant glisser le _visu_icon_center_point.png symbole vers une autre position dans l'éditeur.

X

Coordonnée X du point de rotation

Y

Coordonnée Y du point de rotation

Mouvement absolu

Les propriétés contiennent des variables CEI pour contrôler dynamiquement la position de l'élément. Le point de référence est le coin supérieur gauche de l'élément. Lors de l'exécution, l'élément entier est déplacé.

Mouvement

X

L'augmentation de cette valeur à l'exécution déplace l'élément vers la droite.

Y

L'augmentation de cette valeur à l'exécution déplace l'élément vers le bas.

Rotation

Variable (type de données numérique) pour l'angle de rotation (en degrés)

Exemple: PLC_PRG.iAngle1.

Le milieu de l'élément tourne à la Centre point. Ce point de rotation est représenté par le _visu_icon_center_point.png symbole.

Lors de l'exécution, l'alignement de l'élément reste le même par rapport au système de coordonnées de la visualisation. L'augmentation de la valeur fait pivoter l'élément vers la droite.

_visu_img_prp_rotation.png

Mise à l'échelle

Variable (type de données entier) pour déclencher un étirement centré

Exemple: PLC_PRG.iScaling

Le point de référence est le Centre propriété.

La valeur 1 rétrécit l'élément d'un facteur de 0.001. La valeur 1000 remet l'élément à sa taille d'origine.

Rotation intérieure

Variable (type de données numérique) pour l'angle de rotation (en degrés)

Exemple: PLC_PRG.iAngle2.

Lors de l'exécution, l'élément tourne autour du point de rotation spécifié dans Centre selon la valeur de la variable. De plus, l'alignement de l'élément pivote selon le système de coordonnées de la visualisation. L'augmentation de la valeur dans le code tourne dans le sens des aiguilles d'une montre.

Le point de rotation est représenté par le _visu_icon_center_point.png symbole.

Note

Si un angle de rotation statique est spécifié dans le Emplacement → Angle , l'angle de rotation statique est ajouté à l'angle de rotation variable (décalage) lors de l'exécution de la visualisation.

_visu_img_prp_inner_rotation.png

Astuce

Vous pouvez combiner les variables en un Conversion d'unités.

Astuce

le X, Oui, Rotation, et Rotation intérieure sont prises en charge par la fonctionnalité "Animation client".

Variables d'état

Les variables contrôlent le comportement des éléments de manière dynamique.

Invisible

Variable (BOOL ) pour basculer la visibilité de l'élément

TRUE: L'élément n'est pas visible lors de l'exécution.

Astuce

Le Invisible la propriété est prise en charge par la fonctionnalité « Animation client ».

Animation

Astuce

Ces propriétés ne sont disponibles que lorsque vous avez sélectionné l'option Prise en charge des animations client et de la superposition d'éléments natifs option dans le Gestionnaire de visualisation.

Durée de l'animation

Variable pour la durée (en millisecondes) pendant laquelle l'élément exécute une animation

  • Variable (valeur entière)

    Exemple: Menu.tContent avec VAR tContent : INT := 500; END_VAR

  • Littéral entier

    Exemple: 500

. Propriétés animables
  • Mouvement absolu, Mouvement, X, Oui

  • Mouvement absolu, Rotation

  • Mouvement absolu, Rotation intérieure

  • Mouvement absolu, Rotation extérieure

Le mouvement animé est exécuté lorsqu'au moins une valeur d'une propriété animable a changé. Le mouvement n'est alors pas saccadé, mais fluide pendant la durée d'animation spécifiée. L'élément de visualisation se déplace vers la position spécifiée tout en effectuant une rotation dynamique. Les transitions sont fluides.

Passer au premier plan

Variable (BOOL ) pour mettre l'élément au premier plan

TRUE: Au moment de l'exécution, l'élément de visualisation est affiché au premier plan.

FALSE: Au moment de l'exécution, l'élément de visualisation s'affiche dans la couche où il a été inséré dans l'éditeur de visualisation.

Exemple: bIsInForeground avec VAR bIsInForeground : BOOL := FALSE; END_VAR

Autorisations

Note

Disponible uniquement lorsqu'une gestion des utilisateurs est configurée pour la visualisation.

Droits d'accès bouton

Ouvre le Droits d'accès dialogue. Vous pouvez y modifier les droits d'accès de l'élément.

. Messages d'état :
  • Non défini. Tous droits réservés.: Droits d'accès pour tous les groupes d'utilisateurs : opérable

  • Les droits sont définis : Droits limités: L'accès est restreint pour au moins un groupe.