Artículo / CAD
Three.jsRobótica

Anotaciones 3D que siguen una junta del robot

Guardá el ancla de superficie en coordenadas de su nodo semántico y el desplazamiento de tarjeta por separado para que la articulación no desprenda la etiqueta.

Publicado: · ING-MC LAB
Marcador de superficie asociado a J5 y tarjeta Vacuum_OK independiente unidos por una línea guía.
Diagrama original de coordenadas, no un plano dimensional del robot. Marcador y tarjeta cumplen funciones de edición independientes.

La etiqueta parece unida al robot en Home, pero se separa al girar J5. Una causa habitual es guardar el ancla en coordenadas globales en vez del marco local del nodo móvil. Resolvé el contrato de coordenadas antes de mejorar la apariencia de la tarjeta.

Guardá tres cosas distintas

Industrial 3D Studio relaciona una anotación con un objeto de escena y un nodo semántico. El ancla guarda punto y normal locales; la tarjeta conserva otro desplazamiento, en pantalla. El estado mostrado proviene de un canal de datos separado, no de la geometría del ancla.

Una estructura ilustrativa es:

type SurfaceAnnotation = {
  objectId: string;
  node: string; // por ejemplo J5, ToolMount o TCP
  localPositionMm: [number, number, number];
  localNormal: [number, number, number];
  cardOffsetPx: [number, number];
};

El extracto explica responsabilidades; no representa todo el schema persistido de Studio. Los nombres admitidos dependen del contrato de asset/version. Dos instancias del mismo robot necesitan IDs de objeto distintos aunque ambas contengan un nodo J5.

Del arrastre al ancla local

Arrastrar una plantilla sobre una superficie crea un rayo de cámara que atraviesa la posición del puntero. El raycasting devuelve malla intersectada y punto global. Resolvé la instancia y el nodo semántico revisado que gobierna esa superficie; no asociés todos los hits a RobotRoot.

Después de actualizar matrices globales, convertí el punto con semanticNode.worldToLocal(hit.point.clone()). El renderer usa metros y Studio persiste posiciones en milímetros: convertí una sola vez en ese límite. Hacerlo dos veces multiplica el error por mil.

La documentación de Raycaster y Object3D describe las intersecciones y conversiones. Limitá la selección a superficies de assets; rejillas, contornos y etiquetas no deben convertirse accidentalmente en destinos de anclaje.

La normal requiere otra transformación

Una normal no es un punto. Convertí la normal local de la cara a global con la matriz normal de la malla. Para expresarla en el marco del nodo semántico, aplicá la transformación normal inversa: la transpuesta de la parte lineal de su matriz global, y luego normalizá. No usés worldToLocal() con una normal: la traslación no debe afectarla.

El adaptador actual de Studio sigue ese procedimiento, incluyendo escalado no uniforme de la fuente. Actualizá matrices antes de convertir y proyectar un ancla articulada; matrices atrasadas producen posiciones incorrectas aunque las fórmulas estén bien.

Dos arrastres, dos responsabilidades

Reubicar el marcador 3D cambia la sujeción de superficie y puede cambiar el nodo semántico. Arrastrar la tarjeta 2D cambia solo su offset en píxeles. No debe modificar el punto local. Recalculá la línea desde el ancla proyectada hasta el borde actual de la tarjeta.

Cuando cambie pose o cámara, transformá el punto local por la matriz global actual del nodo, proyectalo por cámara y llevá las coordenadas normalizadas al rectángulo del canvas. Considerá tamaño y desplazamiento del canvas en pantalla. Así el ancla sigue J5 incluso cuando también se mueve el robot completo dentro del área de trabajo.

Mostrá la pertenencia y comprobá movimientos

El Scene Tree agrupa las etiquetas bajo su objeto: RBT01 > Annotations > Vacuum_OK. La pertenencia no se deduce de dónde quedó dibujada la tarjeta.

Probá por separado mover objeto, girar junta, orbitar cámara, redimensionar, arrastrar tarjeta, reubicar marcador y guardar/reabrir escena. Comprobá que eliminar un objeto retire sus etiquetas y que un nodo/version ausente genere un aviso claro. El runtime proxy nativo de Ignition R01 no admite todas las anclas articuladas de Studio: su preflight debe señalar esa incompatibilidad, no aplanarla silenciosamente.

La composición referencia un catálogo de assets y archivos de geometría separados.
Artículo

Qué contiene una escena .ingmc3d

Qué guarda el archivo de escena, cómo referencia los modelos 3D y qué se necesita para compartirlo con otra persona que use Studio.

SoftwareDEVELOPMENT

ING-MC Industrial 3D Studio

Editor de escenas industriales en desarrollo para organizar activos 3D y exportar proyectos .ingmc3d.