View source for Es/VRAD

{{LanguageBar|title = VRAD}}
{{src topicon}}
{{map compile pipeline|source1}}

{{toc-right}}

'''VRAD''' es la herramienta de {{L|command-line|línea de comando}} que toma un mapa BSP compilado e incrusta datos de iluminación en él. La luz estática y precompilada de VRAD rebota alrededor del mundo con un algoritmo de [https://es.wikipedia.org/wiki/Radiosidad radiosidad].

VRAD:

* Genera {{L|lightmap|mapas de luz}}
* Genera {{L|Ambient light|luz ambiental}}
* Genera iluminación por objeto o por vértice para {{L|prop_static}} y {{L|detail prop}}

VRAD es generalmente el más lento de los tres compiladores debido a la gran cantidad de cálculos que debe realizar. La {{L|Lighting optimization|optimización de iluminación}} puede ayudar, al igual que asegurarse de que su mapa esté libre de las {{L|leak|fugas}}.

{{warning|VRAD no compila sombras basadas en el canal alfa de entidades sólidas. Si debe tener sombras creadas por una textura de valla de entidades sólidas, convierta la entidad sólida en un accesorio a través de {{L|SourceIO}}, {{L|crafty}} o {{L|propper}} y colóquelo en su lights.rad. Alternativamente, use un accesorio de cerca existente.}}

{{tip|Si está viendo el cuadro de diálogo de compilación y parece que se ha colgado en ''<code>9...</code>'', esto generalmente se debe a que VRAD tarda más con cada cálculo de rebote ligero. Puede usar <code>-bounce</code> para limitar la cantidad de rebotes para una compilación más rápida.}}

{{bug|En {{ep1}}{{l4d}}, los usuarios que ven fallas cuando VRAD compila la iluminación HDR deben leer {{L|VRAD HDR Crash Fix}}}}

{{bug|En los juegos antes de {{l4d}}, VRAD omitirá la iluminación de accesorios cuando su archivo de <code>.mdl</code> no tiene un archivo de <code>.dx80.vtx</code> con ellos. Copiando el archivo de <code>.dx90.vtx</code> y renombrandolo a <code>.dx80.vtx</code> solucionará el problema.
: {{Tip|Se ha creado un archivo batch de Windows para hacer esto automáticamente [https://drive.google.com/file/d/1OlQcFDlJPbK5vp6PTv7CZGXBjF9Z1UU0 aquí]. Colóquelo encima de la carpeta del modelo y ejecute el .bat}}
: {{Note|{{Dmmm}} está exento de este problema.}}}}

{{bug|Archivos de <code>.mdl</code> que tienen el encabezado <code>IDST1</code> no se cargará para {{L|VBSP}}, y dará un mensaje de error que indica que la propiedad no se pudo cargar; esto se puede solucionar cambiando el encabezado a <code>IDST0</code> en un editor hexadecimal, o volviendo a compilar el accesorio en una aplicación de rama que no sea L4D {{L|Studiomdl}} como Source 2013.}}

{{warning|VRAD usará el 100% de su CPU a menos que se especifique lo contrario con la opción de lanzamiento -threads #}}

{{bug|Desde hace aproximadamente 5 a 10 años hasta al menos octubre de 2017, todas las copias conocidas de VRAD tienen un error de uso compartido de hilos que hace que el rendimiento se escale mal a múltiples hilos, particularmente en escenas al aire libre con el conjunto <code>-final</code> (a pesar de mostrar 100% Uso de CPU). La corrección de este error para Source 2013 está disponible [https://github.com/ValveSoftware/source-sdk-2013/pull/436 aquí] y las DLL editadas están disponibles [http://www.content.tophattwaffle.com/Content/modded_vrad_dll.zip aquí]. Este problema está solucionada en {{csgo}} and {{tf2}}}}

{{bug|Causa aleatoriamente mapas de luz corruptos que parecen a «derrames de tinta». Estos pueden evitarse en su mayoría al no usar cepillos muy largos o diagonales, así como al no tener un nivel de luz demasiado bajo en sus áreas interiores.
: {{tip|[https://github.com/Enderlux/sourcelightmap El editor de mapas de luz BSP del motor Source] se puede usar para corregir manualmente los datos de un mapa de luz en el <code>.bsp</code>}}}}
== Sintaxis ==

 vrad.exe [opciones...] <archivo de BSP>

Por ejemplo:

 "Half-Life 2\bin\vrad.exe" -both -StaticPropLighting sdk_trainstation_01

Esto generará e incorporará datos de iluminación estándar y de {{L|HDR|Alto Rango Dinámico}}, con detalles por vértice para entidades prop_static.

==Opciones==

Úselos en combinación con el {{L|expert compile mode|modo de compilación experto}} o un archivo batch.

=== Efectos ===
{{ColumnBox|count=1|{{IO|-ldr}}
{{IO|-hdr}}
{{IO|-both|Si compilar o no iluminación de rango dinámico estándar, iluminación de {{L|HDR}}, o ambas, respectivamente.
: {{note|Desde {{l4d2}}, se eliminó la compatibilidad con SDR. Por lo tanto, <code>-ldr</code> y <code>-both</code> quedan obsoletos en las ramas del motor creadas en {{l4d2}} o después. En su lugar, se requiere <code>-hdr</code> para producir la iluminación adecuada para su mapa.}}
: {{note|{{bms}} por defecto compila HDR automáticamente.}}}}
{{IO|-fast|Compila iluminación rápida de baja calidad. Se utiliza para una vista previa rápida.
: {{Note|<code>-fast</code> hará que aparezcan manchas aleatorias y mal coloreadas en las áreas más oscuras. Así como bordes sombreados alrededor de Desplazamientos. Se recomienda no enviar su mapa usando <code>-fast</code>.}}}}
{{IO|-final|Aumenta la calidad de {{Ent|light_environment}} y la iluminación indirecta al pasar más tiempo disparando rayos.<br>{{csgo}} Establece <code>-StaticPropSampleScale</code> en 16.}}
{{IO|-extrasky|param=int|Trazar # veces más rayos para luz indirecta y ambiente de cielo. {{clr}}(<code>-final</code> equivale a <code>-extrasky 16</code>; normal equivale a <code>-extrasky 1</code>)}}
{{IO|-lights <filename>.rad|Cargue un [[#Archivos de luces|archivo de luces]] además de <code>lights.rad</code> y el archivo de luces específico del mapa. Incluya la extensión del archivo en el parámetro.}}
{{IO|-bounce|param=int|Establezca el número máximo de rebotes de rayos de luz. (predeterminado: 100).}}
{{IO|-smooth|param=int|Establezca el umbral para los {{L|smoothing group|grupos de suavizado}}, en grados sexagesimal (predeterminado: 45).}}
{{IO|-luxeldensity|param=normal|Reduzca todos los lujos. El valor predeterminado (y máximo) es 1.}}
{{IO|-reflectivityScale|param=float|Escale la {{L|$reflectivity}} de todas las texturas. Predeterminado 1.0}} (No funciona en {{css}})
{{IO|-softsun|param=float|Trate al sol como una fuente de luz de área de esta cantidad de grados. Produce sombras suaves. Los valores recomendados son 0-5, el valor predeterminado es 0. Idéntico al parámetro SunSpreadAngle para <code>light_environment</code>. Usa eso en su lugar.}}
{{IO|-StaticPropLighting|Genera iluminación por vértice en {{Ent|prop_static}}; siempre habilitado para las entidades {{Ent|light_spot}}. Deshabilita entidades de {{Ent|info_lighting}} en accesorios sin un {{L|bump maps|mapeado topológico}}. No funciona en accesorios con mapeado topológico, excepto en {{csgo}}. 
: {{Warning|Esto puede aumentar sustancialmente el tamaño del archivo de su mapa. Deshabilite la iluminación de vértice para accesorios que no la necesitan para mantener bajo el tamaño del archivo.}}
: {{note|En {{csgo}}, para obtener la iluminación adecuada en sus accesorios estáticos, deberá ejecutar VRAD con este comando.}}|since=EP2}}
{{IO|-StaticPropPolys|Usa las mallas reales de accesorios estáticos para generar sombras en lugar de usar sus {{L|collision mesh|mallas de colisión}}. Esto da como resultado un sombreado mucho más preciso.|since=EP2}}
{{IO|-TextureShadows|Genera sombras de mapas de luz a partir de {{Command|$translucent}} superficies de modelos (NO sólidos) que se especifican en un [[#Archivos de luz|archivo de luces]] y se utilizan con <code>prop_static</code>. Por lo general, requiere <code>-StaticPropPolys</code> para tener algún efecto.
: {{note|Una superficie necesitará una escala de {{L|lightmap|mapa de luz}} baja para que la mayoría de las sombras de textura sean reconocibles.}}
: {{note|Esto no funcionará si el parámetro $basetexture de una textura translúcida en el VMT contiene la extensión de archivo .vtf.}}|since=EP2}}
{{IO|-aoscale|param=float|Escala la intensidad de la oclusión ambiental simulada de VRAD. 1.0 es el predeterminado.
: {{Tip|Valve usa 1.5 para el nuevo Dust 2.}}|since=CSGO}}
{{IO|-aoradius|param=float|Establezca el radio de la oclusión ambiental simulada de VRAD. {{TODO|Descubre qué hace exactamente esto.}}|only={{Nwi_games}}}}
{{IO|-aosamples|param=int|Cuántas muestras usar para la oclusión ambiental simulada de VRAD.|only={{Nwi_games}}}}
{{IO|-StaticPropBounce|param=int|Número de rebotes de luz de accesorios estáticas para simular. El valor predeterminado es 0.
: {{Tip|Valve usa 3 rebotes de luz de accesorios estáticos para el nuevo Dust 2.}}
: {{Note|Cualquier accesorio estático en el que desee que rebote la luz también debe tener establecido su valor clave «Enable Bounced Lighting» (Habilitar iluminación rebotada).}}|only=CSGO}}
{{IO|-StaticPropLightingFinal|{{obs}} Reemplazado por <code>-final</code>.|only=CSGO}}
{{IO|-StaticPropLightingOld|Utilizará el antiguo algoritmo de iluminación en los accesorios. La luz les afecta mucho más.|only=CSGO}}
{{IO|-choptexlights|Permite dividir las luces de textura generadas a partir de un archivo de luces. Controle la calidad de la luz de la textura con la densidad del mapa de luz en Hammer. Aumenta drásticamente tanto la calidad de la luz de la textura como el tiempo de compilación.|only=BMS}}
{{IO|-extratransfers|Habilite la sobreescala de las transferencias de luz.|only=BMS}}
{{IO|-transferscale|param=float|Este es el factor de escala de las transferencias de luz. Los valores aumentados hacen que las superficies transfieran más luz (se sugiere una escala de 2 a 4). Predeterminado 1.0.|only=BMS}}
{{IO|-satthresh|param=float|Este es el umbral que comprueba qué tan saturado está el color de un material. Usado con <code>-satthreshscale</code>. Predeterminado 0.4.|only=BMS}}
{{IO|-satthreshscale|param=float|La cantidad a escala de transferencias de luz desde superficies que superan el umbral de saturación. Predeterminado 3.0.|only=BMS}}
{{IO|-ambientocclusion|Habilitar la oclusión ambiental con mapa de luz|only=BMS}}
{{IO|-experimentalambientocclusion|Utilice un algoritmo mejorado para la oclusión ambiental|only=BMS}}
{{IO|-cascadeshadows|Indica que los datos alfa del mapa de luz están intercalados en el bulto de iluminación. Requerido para CSM.|only=BMS}}
{{IO|-realskylight|Permite que VRAD calcule el color ambiental del tragaluz mediante el uso de sus valores reales.|only=BMS}}
{{IO|-realskylightscale|param=float|Factor de escala de la intensidad de -realskylight. Predeterminado: 1.0|only=BMS}}
{{IO|-directsunlightisforadditivemode|Alterna la luz solar directa para el modo aditivo.|only=BMS}}
{{IO|-ambient|param=vector|Establece el término ambiental. Se puede utilizar para modificar el color del mapa de luz. Parece que solo mezcla el color en todos los mapas de luz.|only=CSGO|also={{Dmmm}}}}
{{IO|-PortalTraversalLighting|Permite que las luces estáticas atraviesen portales mundiales estáticos.|only={{P2CE}}}}
{{IO|-PortalTraversalAO|Permite que la luz estática AO pase a través de portales mundiales estáticos.|only={{P2CE}}}}
}}

=== Rendimiento ===

{{ColumnBox|count=1|{{IO|-low|Ejecutar como un proceso de prioridad baja.}}
{{IO|-threads|param=int|Anule el número de subprocesos de CPU utilizados. El máximo es 16 subprocesos (32 en {{csgo}}, ilimitado en {{tf2}}). Con un {{L|Increased_Thread_Limit_for_Compile_Tools|vrad_dll parcheado}} puede usar 32 hilos.}}
{{IO|-mpi|Utilice {{L|Vmpi|VMPI}} para distribuir los cálculos.}}
{{IO|-mpi_pw|param=string|Utilice una contraseña para elegir un conjunto específico de trabajadores de VMPI.}}
{{IO|-noextra|Deshabilitar supermuestreo. Esto conducirá a una iluminación más bloqueada e imprecisa.}}
{{IO|-chop|param=int|El número más pequeño para el ancho de {{L|luxel}} para un parche de rebote, usado en los bordes. (Predeterminado: 4)}}
{{IO|-maxchop|param=int|Número más grueso permitido de anchos de luxel para un parche, utilizado en interiores de cara. (Predeterminado: 4)}}
{{IO|-dispchop|param=int|Ancho mínimo aceptable de {{L|luxel}} de la cara del parche de desplazamiento. (Predeterminado: 8)}}
{{IO|-LargeDispSampleRadius|Esto se puede usar si hay manchas de luz rebotada en el terreno. La compilación llevará más tiempo, pero reunirá luz en un área más amplia.}}
{{IO|-compressconstant|param=int|Comprime los {{L|lightmaps|mapas de luz}} cuya variación de color es menor que esta cantidad de unidades.}} {{todo|Averigua si esto es específico de la rama, ya que no funciona en TF2.}}
{{IO|-fastambient|Utiliza muestreo ambiental por hoja de baja calidad para ahorrar tiempo de cálculo.}}
{{IO|-LeafAmbientSampleReduction|param=float|Factor de reducción para muestras ambientales. El valor predeterminado es 1.0.|only=CSGO}}
{{IO|-noao|Deshabilita la compilación de oclusión ambiental simulada para mapas de luz.|only={{Nwi_games}}}}
{{IO|-StaticPropSampleScale|param=float|Regula la iluminación de vértice generada para prop_static.
: lento: 16 (alta calidad); predeterminado: 4 (normal); rápido: 0.25 (baja calidad)
: {{note|-final es el equivalente a tener -StaticPropSampleScale 16.}}|only=CSGO}}
{{IO|-disppatchradius|param=float|Establece el radio máximo permitido para parches de desplazamiento.}}
{{IO|-ambientfromleafcenters|Muestrea la iluminación ambiental desde el centro de la hoja.|only=CSGO}}
}}

=== Depuración ===

{{ColumnBox|count=1|{{IO|-rederrors|Emite luz roja cuando «a luxel has no samples» (un luxel no tiene muestras).}}
{{IO|-vproject <directory>}}
{{IO|-game <directory>|Anule la variable de entorno VPROJECT.}}
{{IO|-insert_search_path <directory>|Incluye un directorio base adicional para montar contenido adicional (como entradas {{L|Gameinfo.txt}}). Útil si desea separar algunos activos del mod por cualquier motivo.}}
{{IO|-v}}
{{IO|-verbose|Active la salida detallada.}}
{{IO|-novconfig|No muestre la interfaz de usuario gráfica en los errores de vproject.}}
{{IO|-dump|Volcar los parches a archivos de depuración.}}
{{IO|-dumpnormals|Escribe los normales a archivos .txt de depuración.}}
{{IO|-debugextra|Coloca los datos de depuración en mapas de luz para visualizar el supermuestreo.}}
{{IO|-dlightmap|Fuerza la iluminación directa en un mapa de luz diferente al de la radiosidad.}}
{{IO|-stoponexit|Espere una pulsación de tecla al salir.}}
{{IO|-nodetaillight|No encienda accesorios de detalle.}}
{{IO|-centersamples|Mueva los centros de muestra.}}
{{IO|-loghash|Registre la tabla hash de muestra en samplehash.txt.}}
{{IO|-onlydetail|Solo ilumine los accesorios de detalle y la iluminación por hoja.}}
{{IO|-maxdispsamplesize|param=int|Establezca el tamaño de muestra de desplazamiento máximo (predeterminado: 512).}}
{{IO|-FullMinidump|Escriba grandes minivolcados en caso de accidente.}}
{{IO|-OnlyStaticProps|Solo realice iluminación directa en accesorios estáticos.}}
{{IO|-StaticPropNormals|Cuando encienda accesorios estáticos, muestre su vector normal.}}
{{IO|-noskyboxrecurse|Desactive la recursividad en el cuadro del cielo tridimensional (sombras del cuadro del cielo en el mundo).}}
{{IO|-nossprops|Deshabilite globalmente el sombreado automático en accesorios estáticos.}}
{{IO|-dumppropmaps|Vuelca los mapas de luz de utilería calculados.|only=2013MP}}
{{IO|-unlitdetail|Desactiva la iluminación para accesorios de detalle.|only=CSGO}}
}}

==Archivos de luces==
{{moveto|Es/RAD file}}
Un archivo de luz es un archivo de texto que se puede usar para manipular la forma en que {{L|Vrad|VRAD}} maneja un {{L|material}} al compilar iluminación estática. Todos los archivos de luces deben tener la extensión de archivo .rad y deben estar en la misma carpeta que su {{L|gameinfo.txt}}.

Hay:

#'''<code>lights.rad</code>''', el archivo mundial.
#'''Un archivo de luz de mapa cargado automáticamente''', usando el formato <code><nombre del mapa>.rad</code>. El archivo debe colocarse en la misma carpeta que <code><nombre del mapa>.vmf</code>.
#'''Cualquier cantidad de archivos de luces adicionales''' que se pueden agregar con [[#Efectos|el parámetro de <code>-lights</code>]].

=== Reglas ===

Los archivos de luces realizan estas funciones. Una regla por línea:

;<code><material> <red> <green> <blue> <intensity> <hdr_red> <hdr_green> <hdr_blue> <hdr_intensity></code>
Hace que el material emita el valor de luz dado cuando se aplica a la cara de un {{L|brush|sólido}} (los valores <code>hdr_</code> son opcionales). La escala de textura tiene un efecto sobre la intensidad final.
:{{Note|El material realmente no emite luz, sino que se genera una entidad {{ent|light}} [https://developer.valvesoftware.com/w/images/8/8e/Lightsrad_light_generation.png en la superficie]. Más técnicamente, las luces se colocan en el centro de cada subdivisión de la superficie. El brillo de cada luz se distribuye uniformemente, tomando el área de cada subdivisión. Las escalas de mapa de luz más bajas aumentarán la subdivisión y, por lo tanto, se crearán más luces. Esto no ocurrirá en texturas que no estén iluminadas, ya que no se produce subdivisión en estas texturas. Sin embargo, las divisiones de hojas seguirán incurriendo en subdivisiones, lo que podría hacer que la creación de luz sea impredecible (el uso de {{L|func_detail}} evitará esto). Puede ser más inteligente y económico colocar manualmente entidades <code>light</code> cerca del material.}}
:{{note|Los materiales que no están en una carpeta deben tener una barra inclinada antes de su nombre.}}
{{warning|Un {{L|func_detail}} con un material emisivo aplicado en una cara puede causar que VRAD falle al calcular la iluminación de la cara.}}
;<code>noshadow <nombre del material></code>
:Evita que el material nombrado proyecte sombras.
;<code>forcetextureshadow <ruta del modelo>.mdl</code>
:Habilita la prueba de sombra de translucidez para un modelo cuando VRAD se ejecuta con <code>[[#Efectos|-TextureShadows]]</code>. La ruta es relativa a la carpeta de modelos.
;<code><nowiki>ldr:</nowiki></code>
;<code><nowiki>hdr:</nowiki></code>
:Prefijos para hacer que cualquier regla solo se aplique a la iluminación SDR o HDR.
;<code><nowiki>hdr:ldr:</nowiki></code>
:VRAD siempre ignorará las líneas que comiencen con ambas etiquetas (en ese orden). Se puede usar para agregar comentarios o deshabilitar rápidamente algunas entradas.

==Salida de consola ==
{{todo|Agregue una descripción sobre la salida de salidas faltantes (BuildVisLeafs, etcétera)}}

==Véase también ==

* {{L|QRAD}}: contraparte en {{gldsrc|4}}.
* {{L|VRAD_(Source 2)|VRAD2 y VRAD3}}: contraparte en {{source2|4}}.
* {{L|Map Compiling Theory|Teoría de compilación de mapa}}
* {{L|HDR Lighting Basics|Principios de iluminación HDR}}
* {{L|VRAD HDR Crash Fix|Correcciones de cuelgues por VRAD HDR}}
* {{L|Static Props show up black|Objetos del mapa negros}}
{{SDKTools}}

{{ACategory|Official Source Tools}}
{{ACategory|Source 1 BSP compilers}}