Guía de filtrado de bitmaps y bake de texturas en V-Ray SDK

La documentación de V-Ray SDK de Chaos enumera, a fecha de 7 de octubre de 2026, los parámetros disponibles para filtrar bitmaps y hornear texturas con BakeView. Esta guía está dirigida a artistas técnicos y desarrolladores que usan funciones del SDK, más que menús de interfaz. La documentación no especifica a qué versión del software V-Ray se aplican estas funciones, por lo que no debe suponerse la compatibilidad con una versión concreta. El objetivo es distinguir qué hace cada parámetro y configurar los procesos de texturizado y bake con mayor criterio.

1. Elige el tipo de filtrado para el bitmap

BitmapBuffer se utiliza para proporcionar los datos de un bitmap de un archivo al complemento de textura TexBitmap. El parámetro filter_type permite elegir el método de filtrado. La documentación define las opciones mediante valores numéricos, por lo que es importante comprobar a qué método corresponde cada valor al integrar el SDK.

1. Primero, determina qué método de filtrado se ajusta al uso de la textura y comprueba que el valor de filter_type corresponda al método elegido. Por ejemplo, 1 es filtrado mip-map, mientras que 5 es filtrado mip-map nítido. No son el mismo ajuste.

2. Si no quieres aplicar filtrado, considera la opción 0; si necesitas el comportamiento de vecino más cercano, considera -1. La documentación define estas opciones, pero no recomienda un único valor ideal para todas las escenas o tipos de textura.

3. No uses el valor 4 en una nueva configuración. La documentación del SDK lo señala como una opción obsoleta.

4. filter_blur también figura como propiedad de BitmapBuffer, pero el texto de la documentación proporcionado no explica su comportamiento ni recomienda un valor. En lugar de asumir un valor de blur fijo, consulta también la documentación de la implementación utilizada.

El efecto del filtrado en la imagen no depende solo de esta elección numérica. La transferencia del color y la información del espacio de color también pueden influir en el tratamiento del bitmap. Por eso, no conviene considerar los parámetros de filtrado al margen de la gestión del color.

2. Configura conjuntamente transfer_function y el espacio de color

transfer_function de BitmapBuffer especifica el tipo de transferencia de la textura: 0 significa linear, 1 gamma corrected, 2 sRGB y 3 auto. La documentación también incluye una advertencia importante: si no se configura transfer_function, es posible que el filtrado de la textura no funcione correctamente. Por tanto, hay que tener en cuenta este campo al elegir el tipo de filtro.

1. Determina la función de transferencia adecuada para la textura de origen y asigna el valor correspondiente a transfer_function. La documentación enumera claramente los nombres y sus valores numéricos, pero no ofrece una regla general sobre qué valor usar con cada tipo de archivo.

2. Considera el campo rgb_color_space como el espacio de color RGB lineal de la textura. El valor predeterminado indicado es raw, que significa que no se realiza ninguna conversión.

3. Entre los nombres de espacios de color integrados están lin_srgb y acescg. La documentación describe lin_srgb como el espacio RGB lineal para sRGB. Si se ha definido la variable de entorno OCIO o se ha configurado el parámetro ocio_config_file en SettingsUnitsInfo, también se pueden usar otros nombres de espacios de color disponibles en la configuración OCIO correspondiente.

4. Ten en cuenta el orden de las conversiones: según la documentación, la conversión del espacio de color se realiza después de aplicar transfer function. Por ello, si los dos parámetros no son compatibles, el resultado esperado del procesamiento del color puede verse afectado.

Estos detalles son especialmente importantes en flujos de trabajo basados en el SDK donde se usan, dentro de una misma escena, texturas de distintos orígenes. Sin embargo, la documentación no recomienda un espacio de color ni un valor de transfer function para una escena concreta; la elección debe validarse según las características de la textura de origen y la configuración OCIO del proyecto.

3. Define el alcance del bake con BakeView

La documentación define BakeView como el complemento que sustituye a RenderView durante el bake de texturas. El destino del bake se especifica mediante bake_node, mientras que los objetos de destino para el bake por proyección se indican con target_nodes. La generación de UV puede vincularse mediante bake_uvwgen; los campos u_min, v_min, u_max y v_max definen los límites del rango UV que se horneará.

1. Determina qué objeto se horneará y cuáles serán los objetivos de proyección. Al activar el bake por proyección, projection_baking significa 0 para el bake normal y 1 para el bake por proyección.

2. Vincula el generador de UV a BakeView. Para colocar varios objetos en una sola imagen, se pueden usar mapped_bake_nodes y los generadores de UV correspondientes a cada objeto. Como alternativa, se puede asignar el mismo generador de UV a todos los nodos mediante bake_uvwgen.

3. Si vas a definir las regiones de bake individualmente, ten en cuenta que los campos mapped_x0, mapped_y0, mapped_x1 y mapped_y1 especifican la región de salida de cada objeto. La propiedad mapped_bake_nodes_auto permite colocar regiones automáticamente; la documentación indica que hornea los nodos en una sola imagen sin definir regiones.

4. Controla el comportamiento de los rayos. max_depth hace que se ignore la geometría que se encuentre más lejos que esta distancia a lo largo del rayo; si el valor es 0, no se excluye ninguna geometría por este motivo. ray_offset determina cuánto se desplaza el punto de origen del rayo a lo largo de la normal. La documentación no recomienda valores ideales generales para estos campos.

5. Elige el tipo de normal y la dirección del bake según tus necesidades. Si normal tiene el valor 0, se usa la normal smooth; si tiene el valor 1, se usa la normal geometry. Para from_camera, 0 significa reflexión y sombreado similar mediante rayos a lo largo de la normal de la superficie; 1 significa bake con rayos emitidos desde la cámara. Define el método de bake deseado antes de modificar estas opciones.

Errores frecuentes

El error más importante es elegir un filtro y olvidarse de configurar transfer_function: la documentación del SDK indica expresamente que, en ese caso, el filtrado podría no funcionar correctamente. Otro error es interpretar mal el valor numérico de filter_type o elegir la opción 4, que se señala como obsoleta.

En el bake, hay que recordar que asignar a max_depth un valor distinto de cero puede afectar a la geometría distante. Además, al usar mapped_bake_nodes, es necesario mantener una lógica coherente entre el generador de UV correspondiente a cada objeto y su región de salida. La documentación incluye parámetros del SDK, pero no proporciona rutas de menú, números de versión ni ajustes de calidad predefinidos para 3ds Max u otras aplicaciones.

Impacto en los flujos de trabajo de arquitectura y visualización

Estos parámetros son relevantes para los equipos que automatizan la carga de texturas y el bake mediante V-Ray SDK. Los artistas técnicos que desarrollan herramientas de visualización arquitectónica pueden definir explícitamente el espacio de color y la información de transferencia de los bitmaps, así como gestionar a nivel de código el alcance del bake y las regiones UV de los recursos de la escena. Para los equipos de arquitectura e interiorismo, el beneficio potencial no consiste tanto en una nueva función visual como en hacer más controlable la preparación de los recursos.

Estas fuentes no explican los requisitos de hardware, las condiciones de licencia ni las versiones concretas de V-Ray. Por tanto, antes de pasar a producción, hay que comprobar por separado la compatibilidad de la versión del SDK utilizada, el alcance de la licencia y la configuración de gestión del color del proyecto. Las funciones enumeradas en la documentación no deben interpretarse como una garantía de mejora automática de calidad o velocidad.