Skip to main content

Elemento de visualización: Path3D

Nota

El elemento no funciona con el CODESYS HMI variante de visualización.

Símbolo:

visu_img_path3d.png

Categoría: Controles especiales

El Path3D elemento de visualización muestra gráficamente las curvas de dos registros independientes como una trayectoria 3D. Está especialmente diseñado para su uso con CNC y permite visualizar la trayectoria de una máquina herramienta o un robot. Se muestran la trayectoria programada (trayectoria) y la trayectoria recorrida (trayectoria).

Aunque el elemento de visualización está diseñado para usarse con CODESYS SoftMotion en CNC, también se puede usar para mostrar cualquier otro registro. En este caso, la aplicación debe proporcionar los datos de la ruta.

Si el elemento se utiliza junto con CODESYS SoftMotion CNC, luego bloques de funciones de la biblioteca SM3_CNC_Visu Ayudan a generar los datos de la ruta y el recorrido. Estos bloques de función se utilizan en el proyecto de ejemplo. CNC_File_3DPath, que se almacena en el directorio de instalación de CODESYS.

  • SMC_PathCopier

  • SMC_PathCopierCompleteQueue

  • SMC_PathCopierFile

  • SMC_PositionTracker

Una descripción de los bloques de funciones se puede encontrar en el Administrador de bibliotecas en la biblioteca SM3_CNC_Visu.

Aviso

0_Sample_ProjectProyecto de ejemplo: "Generador de rutas 3D"

0_Sample_Project proyecto CNC_File_3DPath (incluido en el CODESYSdirectorio de instalación)

Propiedades del elemento

¿Están disponibles todas las propiedades de los elementos?

Todas las propiedades están disponibles solo después de seleccionar la Avanzado opción o la Todas las categorías filtrar en Propiedades.

Nombre del elemento

Ejemplo: GenElemInst_1

Sugerencia

Asigne nombres individuales a los elementos para que se encuentren más rápido en la lista de elementos.

Tipo de elemento

Camino3D

Posición

La posición define la ubicación y el tamaño del elemento en la ventana de visualización. Se basa en el sistema de coordenadas cartesianas. El origen se encuentra en la esquina superior izquierda de la ventana. El eje X horizontal positivo se extiende hacia la derecha. El eje Y vertical positivo se extiende hacia abajo.

X

La coordenada X (en píxeles) de la esquina superior izquierda del elemento

Ejemplo: 10

Y

La coordenada Y (en píxeles) de la esquina superior izquierda del elemento

Ejemplo: 10

Ancho

Especificado en píxeles

Ejemplo: 150

Altura

Especificado en píxeles

Ejemplo: 30

Sugerencia

Puede cambiar los valores arrastrando el módulo _visu_icon_position_element.png símbolos a otras posiciones en el editor.

Descripción de la ruta

Datos de ruta (VisuStruct3DTrack)

variable de tipo VisuStruct3DTrack que se declara en el código IEC

Ejemplo: PLC_PRG.pc.vs3dt.

Puede encontrar una descripción de la estructura en el Administrador de bibliotecas en el VisuElem3DPath.library Biblioteca.

La estructura de datos describe un camino o pista por un número específico de puntos. La aplicación determina y amortigua los puntos. La pista normalmente muestra las últimas n posiciones para que solo se muestre una parte específica de ellas a la vez.

VisuStruct3DTrack.pProjection es una variable establecida por el elemento de visualización y contiene información sobre la proyección de ruta/pista. Puede (solo) ser leído por la aplicación. Además, el Projection.Apply o .ApplyV Se pueden usar métodos para ver si la posición transformada está dentro o fuera del área de visualización definida por Projection.ElementRect.

color de ruta

Color del camino dibujado

Ancho de línea de ruta

Ancho de línea de ruta (en píxeles)

Ejemplo: 2

Marcado de puntos de borde

. Visualización de los puntos entre dos objetos consecutivos en la ruta

  • Los puntos finales no están marcados

  • Los puntos finales están marcados con un círculo.

  • Los puntos finales están marcados con una cruz.

  • Los puntos finales están marcados con un signo más

Descripción de la pista

Los datos de la pista están estructurados de la misma manera que los datos de la ruta: VisuStruct3DTrack

Seguimiento de datos (VisuStruct3DTrack)

variable de tipo VisuStruct3DTrack que se declara en el código IEC

Ejemplo: PLC_PRG.pc.vs3dt

Puede encontrar una descripción de la estructura en el Administrador de bibliotecas en el VisuElem3DPath.library Biblioteca.

Color de la pista

Color de la pista dibujada

Grosor de la línea de seguimiento

Grosor de la línea de seguimiento (en píxeles)

Ejemplo: 2

Mando de cámara

La posición de la cámara para el modo 3D se controla con una referencia a una estructura de datos externa.

Esta estructura permite las siguientes operaciones:

  • Mover a la izquierda/derecha/arriba/abajo

  • Rotar alrededor del eje X/Y/Z

  • Restablezca la vista al plano X/Y, Y/Z o Z/X para que la web y la ruta sean completamente visibles

Estructura de datos de control (VisuStruct3DControl)

variable de tipo VisuStruct3DControl que se declara en el código IEC

Ejemplo: PLC_PRG.pc.vs3dc

Los valores se pueden configurar a través de la propia aplicación o a través del Panel de control elemento de visualización. El VisuElem3DPath La biblioteca contiene marcos de visualización listos para usar que proporcionan una posible interfaz de usuario para estos datos.

Puede encontrar una descripción de la estructura en el Administrador de bibliotecas en el VisuElem3DPath Biblioteca.

Configuración de entrada

Las propiedades contienen las configuraciones para la entrada del usuario al usar el mouse o el teclado. Una entrada de usuario define un evento y una o más acciones que se ejecutan cuando ocurre un evento.

Sugerencia

El Configurar botón abre el Configuración de entrada diálogo. Allí puede crear o editar entradas de usuario.

Las entradas de usuario configuradas se enumeran debajo de los eventos. Cada uno de ellos incluye la acción que se desencadena y el escenario en forma abreviada.

Ejemplo: Ejecutar código ST: _visu_icon_action.png PLC_PRG.i_x := 0;

OnDialogCerrado

Evento de entrada: el usuario cierra el cuadro de diálogo.

Al hacer clic en el mouse

Evento de entrada: el usuario hace clic completamente con el botón del mouse en el área del elemento. Se hace clic en el botón del ratón y se suelta.

AlMouseAbajo

Evento de entrada: el usuario hace clic con el botón del mouse.

AlMouseEntrar

Evento de entrada: el usuario arrastra el puntero del mouse al elemento.

OnMouseLeave

Evento de entrada: el usuario arrastra el puntero del mouse fuera del elemento.

EnMouseMove

Evento de entrada: el usuario mueve el puntero del mouse sobre el área del elemento.

EnMouseUp

. Eventos de entrada:

  • El usuario suelta el botón del mouse dentro del área del elemento. Es irrelevante si el usuario ha pulsado previamente el botón del ratón dentro o fuera del área del elemento.

  • El usuario presiona el botón del mouse dentro del área del elemento, abandona el área del elemento y luego suelta el botón del mouse.

Nota

Esta CODESYS-El comportamiento de activación específico garantiza que se completen las acciones para los elementos clave. Un elemento clave inicia una acción para AlMouseAbajo y finaliza la acción para EnMouseUp.

Ejemplo: un usuario de visualización presiona el botón del mouse dentro del área del elemento del elemento clave y luego mueve la posición del cursor para que quede fuera del área del elemento. La acción termina de todos modos porque EnMouseUp se desencadena.

OnValueChanged

Evento que desencadena acciones de seguimiento debido a un cambio en el valor

Las acciones de seguimiento que se activan se configuran en el Configuración de entrada diálogo.

Las acciones de seguimiento definidas y la configuración correspondiente se muestran debajo de la propiedad del elemento.

los OnValueChanged El evento puede ser deshabilitado por el VISU_NO_VALUECHANGED definido por el compilador en el cuadro de diálogo de propiedades de la aplicación.

Grifo

Cuando ocurre un evento de clic del mouse, la variable definida en Variable se describe en la solicitud. La codificación depende de la Toca FALSO y Toque entrar si es capturado opciones

Variable

Requisito: El Toca FALSO la opción no está activada.

Variable (BOOL) para el evento de clic del mouse

TRUE: existe un evento de clic del mouse. Dura mientras el usuario presiona el botón del mouse sobre el elemento. Termina cuando se suelta el botón.

FALSE: No existe un evento de clic del mouse.

Ejemplo: PLC_PRG.bIsTapped

Toca FALSO

standard icon: El evento de clic del mouse conduce a un valor complementario en Variable.

TRUE: No existe un evento de clic del mouse.

FALSE: mientras exista el evento de clic del mouse.

Toque entrar si es capturado

standard icon: Durante la entrada del usuario, también se tiene en cuenta si el puntero del mouse se arrastra dentro del área del elemento o no mientras se presiona el botón del mouse.

TRUE: mientras existe el evento de clic del mouse y el puntero del mouse se mueve sobre el área del elemento.

FALSE: No existe un evento de clic del mouse. O el usuario mueve el puntero del mouse fuera del área del elemento mientras se presiona el botón del mouse.

el valor es TRUE de nuevo tan pronto como el usuario mueva el puntero de vuelta al área del elemento. Luego se captura el ratón.

Pasar a otra cosa

Con el inicio de un evento de clic del mouse, la variable se establece; cuando se completa el evento de clic del mouse, la variable se restablece.

Variable

Variable (BOOL) para alternar al final del evento de clic del mouse

Esto es cuando el usuario suelta el botón del mouse mientras el puntero del mouse está sobre el área del elemento. Si el usuario suelta el botón del mouse mientras el puntero del mouse está fuera del área del elemento, el evento de clic del mouse no finaliza y el valor no cambia.

Sugerencia

El usuario puede cancelar una entrada de alternancia iniciada arrastrando el puntero del mouse fuera del área del elemento.

Activar hacia arriba si es capturado

standard icon: el valor cambia independientemente de dónde esté el puntero del mouse cuando se suelta el botón del mouse. Luego se captura el ratón.

tecla de acceso rápido

Acceso directo en el elemento para activar acciones de entrada específicas

Cuando ocurre el evento de tecla de acceso rápido, las acciones de entrada en el Eventos se activan las propiedades. De esta forma, no es la acción de entrada en sí misma la que conduce a esta acción de entrada, sino la acción de entrada del ratón.

Llave

Tecla presionada para acción de entrada.

Ejemplo: T

Las siguientes propiedades aparecen cuando se selecciona una tecla.

Eventos

  • Ninguna

  • Ratón hacia abajo: Al pulsar la tecla se activan las acciones de entrada que están configuradas en el AlMouseAbajo propiedad.

  • Ratón arriba: Al soltar la tecla se activan las acciones de entrada que están configuradas en el EnMouseUp propiedad.

  • Ratón abajo/arriba: Al presionar y soltar la tecla se activan las acciones de entrada que están configuradas en el AlMouseAbajo propiedad y la EnMouseUp propiedad.

Pasar a otra cosa

standard icon: Combinación con la tecla "Shift"

Ejemplo: Cambio+T.

Control

standard icon: Combinación con la tecla "Ctrl"

Ejemplo: control+T.

alternativa

standard icon: Combinación con la tecla "Alt"

Ejemplo: alternativa+T.

Sugerencia

Todos los métodos abreviados de teclado y sus acciones que están configurados en la visualización se enumeran en la Configuración del teclado pestaña.

Aspectos adicionales

Sistema coordinado

standard icon: Se muestra el sistema de coordenadas.

Red

standard icon: Se muestran las líneas de cuadrícula

color de la cuadrícula

Color de las líneas de cuadrícula

Destacar

Las partes individuales de la ruta se pueden resaltar visualmente. Por lo general, esto se usa para marcar la parte ya terminada de una pista con un color diferente. A cada punto de la ruta se le asigna una ID única, que en el caso de un editor CNC está vinculada a la ID del objeto en el que se encuentra el punto. Este ID ("ID de resaltado") se puede especificar a través de la aplicación para que los elementos/partes de la ruta se puedan resaltar dinámicamente.

Tipo de resaltado

. Seleccione uno de los siguientes tipos de resaltado:

  • Solo se resalta el elemento con el ID que coincide con el valor de la variable.

  • Todos los elementos cuyo ID (en el caso de un editor CNC vinculado al ID del objeto) sea menor o igual que el valor en Variable están resaltados.

Variable

Variable de proyecto que especifica el ID de un elemento

Ejemplo: PLC_PRG.iVarElementID

Este "ID de resaltado" se tiene en cuenta para la configuración de la Tipo de resaltado. Las variables se pueden utilizar en la aplicación.

Resaltar color

Ejemplo: rojo

Apariencia

Ancho de línea de borde

Grosor del marco alrededor del elemento (en píxeles)

Ejemplo: 1

Estilo de línea de borde

. Seleccione uno de estos tipos de estilo para la línea del marco:

  • Sólido

  • Pizca

  • Puntos

  • Guion punto

  • Guión Punto Punto

  • Invisible

fondo transparente

standard icon: El fondo del elemento se muestra transparente.

_cds_icon_option_deactivated.png: El fondo del elemento se muestra en el color de fondo definido.

Color de fondo

estilo color o color

Centro

Las propiedades contienen valores fijos para las coordenadas del punto de rotación. El punto de rotación se muestra en el editor como _visu_icon_center_point.png símbolo y se utiliza como centro para la rotación y la escala.

Sugerencia

También puedes cambiar los valores arrastrando el _visu_icon_center_point.png símbolo a otra posición en el editor.

X

Coordenada X del punto de rotación

Y

Coordenada Y del punto de rotación

Movimiento absoluto

Las propiedades contienen variables IEC para controlar dinámicamente la posición del elemento. El punto de referencia es la esquina superior izquierda del elemento. En tiempo de ejecución, se mueve todo el elemento.

Movimiento

X

Aumentar este valor en tiempo de ejecución mueve el elemento a la derecha.

Y

Aumentar este valor en tiempo de ejecución mueve el elemento hacia abajo.

Rotación

Variable (tipo de dato numérico) para el ángulo de rotación (en grados)

Ejemplo: PLC_PRG.iAngle1.

El punto medio del elemento gira en el Centrar punto. Este punto de rotación se muestra como el _visu_icon_center_point.png símbolo.

En tiempo de ejecución, la alineación del elemento permanece igual con respecto al sistema de coordenadas de la visualización. Al aumentar el valor, el elemento gira hacia la derecha.

_visu_img_prp_rotation.png

Escalada

Variable (tipo de dato entero) para desencadenar un estiramiento céntrico

Ejemplo: PLC_PRG.iScaling

El punto de referencia es el Centrar propiedad.

El valor 1 reduce el elemento por un factor de 0.001. El valor 1000 devuelve el elemento a su tamaño original.

Rotación interior

Variable (tipo de dato numérico) para el ángulo de rotación (en grados)

Ejemplo: PLC_PRG.iAngle2.

En tiempo de ejecución, el elemento gira sobre el punto de rotación especificado en Centrar según el valor de la variable. Además, la alineación del elemento gira según el sistema de coordenadas de la visualización. Aumentar el valor en el código gira en el sentido de las agujas del reloj.

El punto de rotación se muestra como el _visu_icon_center_point.png símbolo.

Nota

Si se especifica un ángulo estático de rotación en el Posición → Ángulo propiedad, el ángulo de rotación estático se agrega al ángulo de rotación variable (desplazamiento) cuando se ejecuta la visualización.

_visu_img_prp_inner_rotation.png

Sugerencia

Puedes combinar las variables para formar una Conversión de unidades.

Sugerencia

El X, Y, Rotación, y Rotación interior Las propiedades son compatibles con la funcionalidad "Animación del cliente".

Variables de estado

Las variables controlan el comportamiento del elemento dinámicamente.

Invisible

Variable (BOOL ) para alternar la visibilidad del elemento

TRUE: El elemento no es visible en tiempo de ejecución.

Sugerencia

El Invisible La propiedad está respaldada por la funcionalidad "Animación del cliente".

Animación

Sugerencia

Estas propiedades están disponibles solo cuando usted ha seleccionado la Admite animaciones de clientes y superposición de elementos nativos opción en el Administrador de visualización.

Duración de la animación

Variable para la duración (en milisegundos) en la que el elemento ejecuta una animación

  • Variable (valor entero)

    Ejemplo: Menu.tContent con VAR tContent : INT := 500; END_VAR

  • literal entero

    Ejemplo: 500

. Propiedades animables

  • Movimiento absoluto, Movimiento, incógnita, Y

  • Movimiento absoluto, Rotación

  • Movimiento absoluto, Rotación interior

  • Movimiento absoluto, Rotación exterior

El movimiento animado se ejecuta cuando cambia al menos un valor de una propiedad animable. El movimiento no es brusco, sino suave dentro de la duración de la animación especificada. El elemento de visualización se desplaza a la posición especificada mientras gira dinámicamente. Las transiciones son suaves.

Mover al primer plano

Variable (BOOL ) para colocar el elemento en primer plano

TRUE: Durante la ejecución, el elemento de visualización se muestra en primer plano.

FALSE: En tiempo de ejecución, el elemento de visualización se muestra en la capa donde se insertó en el editor de visualización.

Ejemplo: bIsInForeground con VAR bIsInForeground : BOOL := FALSE; END_VAR

Permisos

Nota

Disponible solo cuando se configura una gestión de usuarios para la visualización.

Derechos de acceso botón

Abre el Derechos de acceso Diálogo. Allí puede editar los privilegios de acceso para el elemento.

. Mensajes de estado:

  • No establecido. Plenos derechos.: Derechos de acceso para todos los grupos de usuarios: operable

  • Se establecen derechos: derechos limitados: El acceso está restringido para al menos un grupo.

En esta sección: