Motor WebGPU desde cero Parte 6 Iluminación Difusa

Guía de iluminación difusa en WebGPU desde cero: aprende a empaquetar luces en buffers uniformes, calcular offsets y alineación, aplicar NormalMatrix y renderizar múltiples luces en WGSL con ejemplos prácticos y depuración.

26 ago 2025 • 5 min de lectura • Equipo Q2BSTUDIO

Inteligencia-Artificial-

WebGPU Engine from Scratch Part 6 Diffuse Lighting presenta cómo añadir iluminación difusa a una escena para mejorar el realismo y el contraste visual

Empezamos por definir una entidad Light que contiene los atributos esenciales tipo posición dirección y color Esta clase almacena los datos como vectores de punto flotante y enteros para facilitar su empaquetado hacia la GPU

La inicialización de luces usa una colección Map y un método initializeLights que crea una luz tipo point colocada mediante una conversión esférica a cartesiano sphericalToCartesian Este patrón permite gestionar múltiples luces de forma ordenada

El reto principal es calcular el tamaño del buffer y los offsets correctos para cada campo en memoria GPU Para ello se introduce una utilidad packStruct que toma un objeto y un esquema ordenado y genera un ArrayBuffer con los valores empacados respetando alineación y endianness La función cubre por ahora tipos u32 vec3f32 y vec4f32 escribiendo los elementos con DataView para garantizar la posición exacta

Sobre packLight se construye un esquema con las propiedades typeInt position direction y color y se solicita un tamaño mínimo de 64 bytes Esto permite preparar un bloque de memoria uniforme que represente una luz completa listo para ser enviado al dispositivo

Para pasar la luz al shader se crea un buffer GPU con usage UNIFORM COPY_DST STORAGE y se escribe su contenido con queue writeBuffer Además se crea un buffer adicional para el contador de luces LightCount que debe ser un struct con un campo count ya que WebGPU no permite enlazar escalares sueltos directamente

Se define un bind group de luces que incluye el buffer de datos y el buffer contador y se adjunta al passEncoder en el binding group 2 Así el pipeline tiene acceso tanto a la matriz de luces como al número de luces válidas

En WGSL se declaran las estructuras Uniforms Light y LightCount y se enlaza el arreglo de luces con var storage read lights array Light Este arreglo puede tener longitud controlada por la binding pero no expone su tamaño en el shader por eso se pasa adicionalmente light_count count

Como prueba inicial el fragment shader puede devolver directamente el color de la primera luz para verificar que el empaquetado y la transferencia de datos funcionan correctamente Esto ayuda a depurar offsets y problemas de alineación antes de implementar la iluminación real

La iluminación difusa se implementa pasando desde el vertex shader la posición en mundo y la normal Los pasos básicos en el fragment shader son muestrear el color de la textura calcular la dirección hacia la luz normalizar y calcular el producto punto entre la normal y la dirección a la luz para obtener la intensidad multiplicar por el color de la luz y acumular sobre todas las luces finalmente mezclar con el color superficial

Para soportar arreglos de luces se crea packArray que calcula el tamaño del struct empaquetado y reserva structSize multiplicado por la longitud del arreglo luego invoca packStruct para cada elemento desplazando el offset adecuadamente Esto asegura que cada elemento empieza en una frontera de alineación adecuada

Un error común detectado durante el desarrollo fue que las normales aparecían invertidas o giradas La causa fue no transformar correctamente las normales al hornearlas con las transformaciones del modelo Para convertir normales hay que tomar la submatriz 3x3 superior izquierda de la matriz de modelo calcular la inversa y luego la transpuesta NormalMatrix equals transpose inverse trim model matrix Al aplicar NormalMatrix a las normales y normalizarlas se corrige la iluminación

Otros puntos importantes a comprobar son que el packing de un mat3x3 requiere el mismo tipo de padding por columna que un mat4x4 con ceros al final de cada columna y que las matrices suelen ser column major lo que cambia el orden de indexado respecto a las convenciones utilizadas en JavaScript

Con todas esas correcciones en el empaquetado y la transformación de normales se consigue un resultado estable y escalable pudiendo representar varias luces que interactúan correctamente con la geometría

En Q2BSTUDIO somos una empresa de desarrollo de software que ofrece aplicaciones a medida y software a medida para clientes que necesitan soluciones gráficas avanzadas como motores WebGPU integración con servicios cloud aws y azure y despliegue seguro en entornos corporativos

Nuestro equipo de especialistas en inteligencia artificial trabaja en proyectos de inteligencia artificial e ia para empresas diseñando agentes IA análisis de datos y soluciones de servicios inteligencia de negocio además ofrecemos integración con herramientas como power bi para visualización y reporting

También proporcionamos servicios de ciberseguridad auditorías y hardening de infraestructuras y consultoría para asegurar sus aplicaciones y datos Nuestra oferta incluye despliegue en servicios cloud aws y azure para garantizar escalabilidad disponibilidad y cumplimiento

Si desea una solución personalizada para visualización 3D en WebGPU o integrar capacidades de inteligencia artificial y agentes IA en su aplicación contacte con Q2BSTUDIO desarrollamos aplicaciones a medida software a medida e implementamos soluciones completas que combinan AI ciberseguridad y cloud

El repositorio de referencia y las muestras del proyecto contienen el código final y ejemplos prácticos para empacar estructuras gestionar bind groups y calcular matrices normales que pueden servir como base para su propio motor gráfico o proyecto de visualización

Para más información sobre servicios soluciones y consultoría en proyectos de gráficos en tiempo real inteligencia artificial y seguridad empresarial visite Q2BSTUDIO y descubra cómo podemos ayudar a transformar su idea en una aplicación de alto valor

¿UNA PAUSA?

Juega un momento antes de irte

NUESTROS SERVICIOS

Cómo podemos ayudarte

Inteligencia artificial

Agentes de IA, chatbots y asistentes inteligentes que automatizan tareas y atienden a tus clientes 24/7 para mejorar la eficiencia de tu negocio.

Más info

Desarrollo de software

Aplicaciones web, móviles y de escritorio, intranets, e-commerce, SaaS y plataformas de gestión diseñadas para las necesidades concretas de tu empresa.

Más info

Servicios cloud

Migración, infraestructura, hosting gestionado, alta disponibilidad y seguridad en Microsoft Azure y Amazon Web Services para que tu negocio escale sin límites.

Más info

Ciberseguridad y pentesting

Auditorías de seguridad, test de intrusión (pentesting) y protección de aplicaciones, datos e infraestructura on-premise y cloud, con hacking ético y cumplimiento normativo.

Más info

Business Intelligence

Cuadros de mando y análisis de datos con Power BI: integramos tus fuentes, diseñamos dashboards y KPIs y convertimos tus datos en decisiones.

Más info

Automatización de procesos

Automatizamos tareas repetitivas y conectamos tus aplicaciones con n8n, Power Automate, Make y RPA, eliminando trabajo manual y aumentando la productividad.

Más info

Formación para empresas

Formamos a tus equipos en tecnología con criterio: desarrollo web, bases de datos, Git, buenas prácticas y seguridad, automatización con n8n, inteligencia artificial para empresas y creación de soluciones de IA con Azure AI Foundry.

Más info

Auditoría de código

Auditamos el código que creas tú, tu equipo o una IA: te decimos qué está bien y qué mejorar, lo securizamos y lo dejamos listo para producción, web o app.

Más info

Generación de imágenes con IA

Creamos por ti las imágenes que necesita tu negocio con inteligencia artificial: producto, redes, publicidad, ilustración y avatares. Tú nos dices qué quieres y te lo entregamos listo para usar.

Más info

Generación de vídeos con IA

Creamos por ti vídeos con inteligencia artificial: promocionales, para redes, presentadores virtuales, doblaje y animaciones. Nos cuentas la idea y te lo entregamos montado y listo para publicar.

Más info

Avatares conversacionales con IA

Creamos avatares conversacionales con IA —humanos digitales con cara y voz— que atienden a tus clientes y equipos con el conocimiento de tu empresa, en tu web, monitores interactivos, WhatsApp o Teams.

Más info

Marketing Online e IA

Google Ads, Meta Ads, LinkedIn Ads y posicionamiento en motores de IA (GEO/AEO): captamos clientes y hacemos que tu marca aparezca donde te buscan, también en ChatGPT, Gemini y Perplexity.

Más info

¿Tienes un proyecto en mente?

Cuéntanos tu visión y la convertimos en una solución de software. Sea cual sea el alcance, hacemos realidad tu idea.

Live Chat