Ir al contenido principal

Integración de Cámara

Rayforge soporta la integración de cámara USB para la alineación y posicionamiento preciso del material. La función de superposición de cámara te permite ver exactamente dónde tu láser va a cortar o grabar en el material, eliminando las conjeturas y reduciendo el desperdicio de material.

Ajustes de Cámara

Flujo de trabajo de configuración​

La configuración de una cámara se puede realizar mediante el Asistente de cámara guiado — un flujo único que cubre la configuración de imagen, la calibración de lente y la alineación — o configurando cada área manualmente desde el panel de propiedades de la cámara. En cualquier caso, la configuración cubre cuatro áreas:

  1. Añadir una cámara — Conecta tu cámara y agrégala a la configuración de la máquina
  2. Ajustar la configuración de imagen — Ajusta brillo, contraste, balance de blancos y reducción de ruido
  3. Calibrar la lente — Corrige la distorsión con la calibración automática del asistente de cámara o con coeficientes manuales
  4. Alinear la cámara — Mapa los píxeles de la cámara a las coordenadas de la máquina para un posicionamiento preciso

El panel de propiedades de la cámara muestra los íconos de estado de calibración y alineación de un vistazo:

  • ✓ Calibración de lente — La calibración se ha realizado
  • ⚠ Alineación de imagen — Advertencia cuando la alineación debe rehacerse (p. ej., después de la calibración de lente)
  • ✓ Alineación de imagen — La alineación está actualizada y es válida

Paso 1: Añadir una cámara​

Requisitos de Hardware​

Cámaras compatibles:

  • Cámaras web USB (más común)
  • Cámaras integradas de laptop (si ejecutas Rayforge en una laptop cerca de la máquina)
  • Cualquier cámara soportada por Video4Linux2 (V4L2) en Linux o DirectShow en Windows

Configuración recomendada:

  • Cámara montada sobre el área de trabajo con vista clara del material
  • Condiciones de iluminación consistentes
  • Cámara posicionada para capturar el área de trabajo del láser
  • Montaje seguro para prevenir el movimiento de la cámara

Añadir una Cámara​

  1. Conecta tu cámara a tu computadora vía USB

  2. Abre Ajustes de Cámara:

    • Navega a Configuración → Preferencias → Cámara
    • O usa el botón de la barra de herramientas de cámara

  3. Añade una nueva cámara:

    • Haz clic en el botón "+" para añadir una cámara
    • Ingresa un nombre descriptivo (ej., "Cámara Superior", "Cámara Área de Trabajo")
    • Selecciona el dispositivo del menú desplegable
      • En Linux: /dev/video0, /dev/video1, etc.
      • En Windows: Cámara 0, Cámara 1, etc.

  4. Habilita la cámara:

    • Activa el interruptor de habilitación de cámara
    • La transmisión en vivo debería aparecer en tu lienzo

Paso 2: Asistente de cámara​

El Asistente de cámara ejecuta la configuración completa de la cámara en un único flujo guiado, cubriendo las tres áreas en orden — configuración de imagen, calibración de lente y alineación de imagen. Se inicia desde:

  • La fila Asistente de cámara en el panel de propiedades de la cámara — haz clic en Start
  • Automáticamente desde el asistente de configuración cuando activas una cámara en su paso de cámara y continúas

Paso 2.1: Ajustar la configuración de imagen​

Diálogo de Configuración de Imagen

La configuración de imagen es la primera etapa del asistente de cámara — se abre ahí y te permite establecer la resolución, el balance de blancos, el brillo, el contraste y la reducción de ruido. Si no ejecutaste el asistente, o quieres ajustar los valores que estableció, haz clic en Configure junto a Image Settings en las propiedades de la cámara para abrir el diálogo de configuración de imagen. Ajusta estos parámetros para obtener una vista de cámara clara:

AjusteDescripción
BrilloBrillo general de la imagen (-100 a +100)
ContrasteDefinición de bordes y contraste (0 a 100)
Preferir YUYVUsar YUYV sin comprimir en lugar de MJPEG. Más lento pero puede solucionar algunos fallos
TransparenciaOpacidad de la superposición en el lienzo (0% opaco a 100% transparente)
Balance de BlancosCorrección de temperatura de color (Auto o 2500-10000K)
Reducción de RuidoReducción de ruido temporal (0.0 a 0.95)

La opción YUYV es útil si tu cámara produce imágenes con tono verdoso con el formato MJPEG predeterminado. Ten en cuenta que YUYV no está comprimido y puede reducir la resolución disponible o la tasa de fotogramas en conexiones USB 2.0.

Paso 2.2: Calibración de lente​

Si tu cámara tiene una lente gran angular o está montada en ángulo, la imagen puede mostrar curvatura visible — las líneas rectas aparecen dobladas, especialmente cerca de los bordes del encuadre. Esto se llama distorsión de lente, y puede afectar la alineación incluso si tus puntos de alineación están medidos con cuidado.

La calibración de lente es la segunda etapa del asistente de cámara. Te permite elegir cómo corregir la distorsión:

  • Automatic — captura fotogramas de una tarjeta de calibración impresa; el asistente calcula el modelo de distorsión por ti
  • Manual — ingresa los coeficientes radiales (k1–k3) y tangenciales (p1–p2) manualmente
  • Skip — deja la distorsión sin corregir; puedes calibrar más tarde

Calibración automática​

Para la calibración Automatic, el asistente te guía para capturar varias imágenes de una tarjeta de calibración impresa desde diferentes posiciones en la cama, y luego calcula un modelo de distorsión automáticamente.

Asistente — Configuración de Tarjeta

  1. Establece el Ancho y Alto de tu tarjeta impresa. La vista previa se actualiza en tiempo real — la tarjeta debe cubrir aproximadamente el 70% de la vista de la cámara.
  2. Haz clic en Save to PDF para exportar la tarjeta para imprimir, luego imprímela y colócala en la cama láser.

Asistente — Captura

  1. Mueve la tarjeta a diferentes posiciones y ángulos dentro de la vista de la cámara y haz clic en Capture Frame para cada posición. Apunta a al menos 8 capturas que cubran todo el encuadre, incluyendo esquinas y bordes. La barra de progreso y los indicadores de estado muestran la calidad de captura.
  2. Cuando se hayan capturado suficientes fotogramas, el asistente calcula el modelo de distorsión y lo aplica — la superposición de la cámara ahora muestra una imagen corregida y recta.

Calibración manual​

Diálogo de Calibración de Lente

Para coeficientes manuales o para ajustar finamente el resultado después de una calibración automática, abre el diálogo de calibración de lente haciendo clic en Configure junto a Lens Calibration en las propiedades de la cámara. Desde aquí puedes ajustar los coeficientes de distorsión manualmente — ajusta finamente los parámetros radiales (k1–k3) y tangenciales (p1–p2).

Paso 2.3: Alineación de imagen​

Diálogo de Alineación de Imagen

La alineación de imagen es la etapa final del asistente de cámara. La alineación de cámara calibra la relación entre los píxeles de la cámara y las coordenadas del mundo real, permitiendo el posicionamiento preciso. El asistente usa el mismo procedimiento descrito aquí, y aplicar la alineación finaliza el asistente.

Por Qué es Necesaria la Alineación​

La cámara ve el área de trabajo desde arriba, pero la imagen puede estar:

  • Rotada relativa a los ejes de la máquina
  • Escalada diferente en direcciones X e Y
  • Distorsionada por la perspectiva de la lente

La alineación crea una matriz de transformación que mapea los píxeles de la cámara a las coordenadas de la máquina.

Procedimiento de Alineación​

  1. Abre el Diálogo de Alineación:

    • Haz clic en el botón Configurar junto a Alineación de Imagen en las propiedades de la cámara
    • El diálogo muestra la transmisión de la cámara con la superposición de alineación actual

  2. Coloca marcadores de alineación:

    • Necesitas al menos 3 puntos de referencia (4 recomendados para mejor precisión)
    • Los puntos de alineación deben estar distribuidos por el área de trabajo
    • Usa posiciones conocidas como:
      • Posición de origen de la máquina
      • Marcas de regla
      • Agujeros de alineación pre-cortados
      • Cuadrícula de calibración

  3. Marca puntos de imagen:

    • Haz clic en la imagen de la cámara para colocar un punto en una ubicación conocida
    • El widget de burbuja aparece mostrando las coordenadas del punto
    • Repite para cada punto de referencia

  4. Ingresa coordenadas del mundo:

    • Para cada punto de imagen, ingresa las coordenadas X/Y del mundo real en mm
    • Estas son las coordenadas reales de la máquina donde está ubicado cada punto
    • Mide con precisión con una regla o usa posiciones conocidas de la máquina

  5. Aplica la alineación:

    • Haz clic en Aplicar para calcular la transformación
    • La superposición de la cámara ahora estará correctamente alineada

  6. Verifica la alineación:

    • Mueve la cabeza del láser a una posición conocida
    • Verifica que el punto del láser se alinee con la posición esperada en la vista de la cámara
    • Ajusta volviendo a alinear si es necesario

Estado de Alineación​

El panel de propiedades de la cámara muestra el estado de alineación con un ícono:

  • Marca de verificación — La alineación está actualizada y es válida
  • Advertencia — La alineación debe rehacerse. Esto ocurre cuando se actualiza la calibración de lente, porque la corrección de distorsión cambia la imagen de la cámara e invalida la alineación existente. Tus puntos de alineación se conservan — simplemente abre el diálogo y haz clic en Aplicar nuevamente.

Flujo de trabajo de ejemplo​

  1. Mueve el láser a la posición de origen (0, 0) y marca en la cámara
  2. Mueve el láser a (100, 0) y marca en la cámara
  3. Mueve el láser a (100, 100) y marca en la cámara
  4. Mueve el láser a (0, 100) y marca en la cámara
  5. Ingresa las coordenadas exactas para cada punto
  6. Haz clic en Aplicar y verifica
Mejores Prácticas
  • Usa puntos en las esquinas de tu área de trabajo para máxima cobertura
  • Evita agrupar puntos en una área
  • Mide las coordenadas del mundo cuidadosamente - la precisión aquí determina la calidad general de la alineación
  • Vuelve a alinear si mueves la cámara o cambias la distancia de enfoque
  • Vuelve a alinear después de actualizar la calibración de lente
  • Guarda tu alineación - persiste entre sesiones

Usando la Superposición de Cámara​

Una vez alineada, la superposición de cámara ayuda a posicionar trabajos con precisión. Actívala haciendo clic en el icono de cámara en la barra de herramientas de la ventana principal.

Múltiples Cámaras​

Rayforge soporta múltiples cámaras para diferentes vistas o máquinas:

  • Añade múltiples cámaras en preferencias
  • Cada cámara puede tener alineación independiente
  • Cambia entre cámaras usando el selector de cámara
  • Casos de uso:
    • Vista superior + vista lateral para objetos 3D
    • Diferentes cámaras para diferentes máquinas
    • Cámara gran angular + cámara de detalle

Solución de Problemas​

Cámara No Detectada​

Problema: La cámara no aparece en la lista de dispositivos.

Soluciones:

Linux: Verifica si la cámara es reconocida por el sistema:

# Listar dispositivos de video
ls -l /dev/video*

# Verificar cámara con v4l2
v4l2-ctl --list-devices

# Probar con otra aplicación
cheese  # o VLC, etc.

Para usuarios de Snap:

# Conceder acceso a la cámara
sudo snap connect rayforge:camera

Windows:

  • Revisa el Administrador de Dispositivos para la cámara en "Cámaras" o "Dispositivos de imagen"
  • Asegúrate de que ninguna otra aplicación esté usando la cámara (cierra Zoom, Skype, etc.)
  • Prueba un puerto USB diferente
  • Actualiza los controladores de la cámara

La Cámara Muestra Pantalla Negra​

Problema: La cámara es detectada pero no muestra imagen.

Posibles causas:

  1. Cámara en uso por otra aplicación - Cierra otras aplicaciones de video
  2. Dispositivo incorrecto seleccionado - Prueba diferentes IDs de dispositivo
  3. Permisos de cámara - En Linux Snap, asegúrate de que la interfaz de cámara esté conectada
  4. Problema de hardware - Prueba la cámara con otra aplicación

Soluciones:

# Linux: Liberar dispositivo de cámara
sudo killall cheese  # u otras aplicaciones de cámara

# Verificar qué proceso está usando la cámara
sudo lsof /dev/video0

Alineación No Precisa​

Problema: La superposición de cámara no coincide con la posición real del láser.

Diagnóstico:

  1. Puntos de alineación insuficientes - Usa al menos 4 puntos
  2. Errores de medición - Verifica doblemente las coordenadas del mundo
  3. Cámara movida - Vuelve a alinear si la posición de la cámara cambió
  4. Distorsión no lineal - Puede necesitar calibración de lente

Mejora la precisión:

  • Usa más puntos de alineación (6-8 para áreas muy grandes)
  • Distribuye los puntos por toda el área de trabajo
  • Mide las coordenadas del mundo muy cuidadosamente
  • Usa comandos de movimiento de la máquina para posicionar precisamente el láser en coordenadas conocidas
  • Vuelve a alinear después de cualquier ajuste de la cámara

Calidad de Imagen Pobre​

Problema: La imagen de la cámara está borrosa, oscura o deslavada.

Soluciones:

  1. Ajusta brillo/contraste en ajustes de cámara
  2. Mejora la iluminación - Añade iluminación consistente del área de trabajo
  3. Limpia la lente de la cámara - El polvo y escombros reducen la claridad
  4. Revisa el enfoque - El autoenfoque puede no funcionar bien; usa manual si es posible
  5. Reduce la transparencia temporalmente para ver la imagen de la cámara más claramente
  6. Prueba diferentes ajustes de balance de blancos
  7. Ajusta la reducción de ruido si la imagen aparece granulada

Retraso o Tartamudeo de la Cámara​

Problema: La transmisión de cámara en vivo es entrecortada o retrasada.

Soluciones:

  • Reduce la resolución de la cámara en ajustes del dispositivo (si es accesible)
  • Cierra otras aplicaciones que usen CPU/GPU
  • Actualiza los controladores de gráficos

Páginas Relacionadas​