View source for Pt-br/Cubemaps

{{wip}}{{translate}}
{{LanguageBar}}
{{Todo|Precisa de informações sobre os cube maps da Source 2. Veja [[Draft:Cubemaps (Source 2)]].}}

[[File:Env_cubemap.png|left]]
[[File:Specular.jpg|thumb|right|300px|Um exemplo de reflexos especulares em alguns modelos (exagerados por causa do {{cmd|r_showenvcubemap}}).]]
Um '''cubemap''' é uma textura que representa uma representação tridimensional de uma área. {{source|4.1}} usa entidades {{ent|env_cubemap}} como pontos de amostragem para gerar estas texturas, que são depois integradas no arquivo do [[BSP|mapa]]. Os cubemaps, quando [[#Building cubemaps|construídos]], são refletidos em materiais que usam o parâmetro [[$envmap]] (superfícies como vidro refletor, azulejos, água, etc.) Um mapa sem entidades '''env_cubemap''' construídas ou existentes usará outros tipos de “reflexões” que não o retratam corretamente.


==Construindo Cubemaps==
BConstruir cubemaps é o processo de gerar texturas para usar como reflexões. Por razões técnicas, este processo não é automatizado {{mapbase|in|addtext-front='' Exceto''{{nbsp}}}} e cabe ao usuário fazê-lo; até lá, as entidades '''env_cubemap''' existentes permanecerão sem uso e o mapa, dependendo do jogo, mostrará uma textura genérica, preta ou [[Missing content|texturas “ em falta”]] como reflexos devido a cubemaps inexistentes.
{{warning|{{clr}}
* '''PARA PESSOAS COM EPILEPSIA''': A criação de cubemaps em jogos executados em Vulkan, como {{l4d2|4.1}}, faz com que a tela pisque violentamente em preto e branco. Também em sistemas com CPU/GPU mais rápida <!-- confirmada com i5-12400F e RTX 3060 -->, a criação de cubemaps HDR em jogos do ramo pré-L4D, como {{css|4.1}}, mesmo com Direct3D 9/DX9, também fará a tela piscar em preto e branco repetidamente.
* Se o comando {{Command|nav_show_ladder_bounds}} tiver sido usado antes da criação de cubemaps, as caixas verdes também serão incorporadas ao cubemap.
* Se estiver criando cubemaps para o {{Hl2|4.1}} (exceto os episódios) após a '''Atualização do Aniversário de 20 anos''', você deverá iniciar o jogo com {{code|-game hl2}} [[command line argument|argumento da linha de comando]]. Caso contrário, o jogo tentará acessar o {{code|episodic/maps}} ({{hl2ep1}}) em vez do diretório de mapas {{hl2|1}}, fazendo com que o jogo não salve os cubemaps criados no mapa. Da mesma forma, se estiver criando cubemaps para mapas localizados no diretório Episode One ou Episode Two, inicie o jogo com {{code|-game episodic}} (para EP1) ou {{code|-game ep2}} (para o EP2), respectivamente (ou inicie o Episódio Um/Episódio Dois em Steam > Ferramentas).
}}

===Antes de construir===
{{Cleanup|Os jogos Source modernos, nomeadamente {{portal2|1}} e {{p2ce|1|nt=1}}, não precisam de todos estes parâmetros e passos complicados, pelo menos na minha experiência -[[User:Equalizer5118|Equalizer]] ([[User talk:Equalizer5118|talk]]) 10:56, 22 março 2024 (PDT)
Também alguns jogos Source (como o CS:S), não parecem necessitar que os cheats estejam activados para construir cubemaps. -[[User:Kr0tchet|leonidakarlach]] ([[User talk:Kr0tchet|talk]]) 02:50, 25 agosto 2024 (PDT)
}}
{{Important|Mapas para jogos {{src13|4.1}} e outros, como {{css|4.1}}, são conhecidos por incluírem cubemaps pré-construídos e em branco depois de serem compilados (mesmo que não existam entidades '''env_cubemap'''' neles); estes devem ser apagados antes de construir novos, como detalhado [[#Deleting cubemaps|aqui]]. Tal foi corrigido no {{mapbase|4.1}}}}
{{tip|{{clr}}
* As entidades {{ent|env_cubemap}} [[Env cubemap#Keyvalues|permitem]] gerar reflexos de alta ou baixa qualidade, embora a qualidade da textura do jogo também entre em jogo; considere maximizar as configurações visuais do jogo antes de criar cubemaps.
*  Para criar cubemaps, a resolução da tela do seu jogo precisa ser pelo menos 4 vezes maior do que o maior [[Env cubemap#Keyvalues|tamanho]] de um '''env_cubemap''' existente, caso contrário, a tentativa de criá-los falhará ou até mesmo causará o travamento do jogo.<br>Por exemplo, se o maior '''env_cubemap''' tiver o tamanho 128x128, será necessária uma resolução não inferior a 512x512. (''128 &times; 4 &#61; '''512''' -&gt; 720x576'' (como uma resolução válida) ou superior){{note|O jogo pode parecer congelar ou deixar de responder durante o processo, e o tempo depende de vários fatores. Para obter resultados bem-sucedidos, não se afaste do jogo até que ele seja concluído.}}
* Se estiver usando o {{mapbase|4.1}}, adicione {{code|-autocubemap}} à sua linha de comando em {{hammer|1}}. O jogo criará automaticamente cubemaps
* O {{slamminsrc|4.1|nt=1}} apresenta o comando {{code|-nodefaultcubemap}}, que ignora a geração automática de cubemaps skybox na compilação do mapa}}.

===LDR===
{{note|Esta etapa não se aplica a {{l4d|4.1}} nem a {{csgo|4.1}}, pois seus mapas são compilados somente no modo [[#HDR|HDR]]. Embora o {{p2|4.1}} seja compatível com LDR, o jogo usa HDR por padrão, portanto, recomendamos a criação de cubemaps somente em HDR.}}
A criação de cubemaps em um mapa compilado no modo '''LDR''' (''Low Dynamic Range'') gerará texturas somente para esse modo, independentemente da configuração de vídeo ''High Dynamic Range'' do jogo. Para criar os cubemaps, envie os seguintes comandos para o console do jogo:
{| class="wikitable"
|-
! Comando !! Descrição
|-
| {{Command|mat_specular|0}} || Desativa os reflexos, o que é necessário se estiver usando apenas uma iteração de buildcubemaps. Isso também significa que a desativação dos reflexos evitaria alguns casos em que as texturas ausentes ou a textura padrão do cubemap ({{code|materials/engine/defaultcubemap.vtf}}, também conhecida como um deserto com céu laranja ao pôr do sol), poderiam acabar refletidas no próprio cubemap.
|-
| {{Command|map}} ''map_name''</code> || Carrega o mapa; substitua "''map_name''" pelo nome real do mapa
|-
| {{Command|sv_cheats|1}} || Habilita o uso de comandos de trapaça; necessário para criar cubemaps<br>{{Confirm|{{hl2|1}} não parece exigir trapaças para criar cubemaps, portanto esta etapa pode ser ignorada. Confirme se outros jogos também exigem trapaças para criar cubemaps.}}
|-
| {{Command|buildcubemaps}} || Inicia a criação de cubemaps. Opcionalmente, especifique o número de iterações (e.g.: <code>buildcubemaps 2</code> (default is 1))
|-
| {{Command|disconnect}} || Descarrega o mapa e retorna ao menu principal
|-
| {{Command|mat_specular|1}} || Ativa os reflexos.
|-
| {{Command|quit}} || (opcional) Sai do jogo. Em alguns jogos, é necessário reiniciar o jogo para exibir os cubemaps recém-construídos
|}

===LDR + HDR===
A construção de cubemaps no jogo {{src06|3.1}} - {{src13|3.1}}, com um mapa compilado com suporte a [[HDR]], precisa ser executada duas vezes - uma para cada modo ('''HDR''' e '''LDR'''). Ao contrário do caso de um mapa '''LDR''', a configuração de vídeo ''High Dynamic Range'' do seu jogo deve ser definida como “Full” para criar cubemaps '''HDR''' e como “None” para criar cubemaps '''LDR''' (ou usando o comando {{code|mat_hdr_level}}. Para criar os cubemaps para LDR + HDR, envie os seguintes comandos para o console do jogo:
{{Note|Os mapas criados em {{l4d|1}} ou posteriores (e alguns jogos Source de terceiros) não exigem a criação de cubemaps em LDR. Veja [[#HDR]]}}
{| class="wikitable"
|-
! Comando !! Descrição
|-
| {{Command|mat_specular|0}} || Desativa os reflexos, o que é necessário se estiver usando apenas uma iteração de buildcubemaps. Isso também significa que a desativação dos reflexos evitaria alguns casos em que as texturas ausentes ou a textura padrão do cubemap ({{code|materials/engine/defaultcubemap.vtf}}, também conhecida como um deserto com céu laranja ao pôr do sol), poderiam acabar refletidas no próprio cubemap.
|-
| {{Command|map}} ''map_name'' || Carrega o mapa; substitua "''map_name''" pelo nome real do mapa
|-
| {{Command|sv_cheats|1}} || Habilita o uso de comandos de trapaça; necessário para criar cubemaps<br>{{Confirm|{{hl2|1}} não parece exigir trapaças para criar cubemaps, portanto, esta etapa pode ser ignorada. Confirme se outros jogos também exigem trapaças para criar cubemaps}}.
|-
| {{Command|building_cubemaps|1}} || Define a exposição HDR em um valor consistente. Isso será redefinido automaticamente para 0 depois que os cubemaps forem criados.
|-
| {{Command|buildcubemaps}} || Começa a criar cubemaps. Opcionalmente, especifique o número de iterações  (e.g.: <code>buildcubemaps 2</code> (o padrão é 1))
|-
| {{Command|disconnect}} || Descarrega o mapa e retorna ao menu principal
|-
| {{Command|sv_cheats|0}} || Desativa os comandos de trapaça; evita que o comando <code>''mat_reloadallmaterials''</code> se autoexecute desnecessariamente (o que congela o jogo por um breve período)
|-
| {{Command|mat_hdr_level|0}} || Muda para o modo '''LDR''' (de '''HDR'''); em vez disso, envie <code>''mat_hdr_level 2''</code> se os cubemaps '''LDR''' tiverem sido criados primeiro
|-
| {{Command|map}} ''map_name'' || Carrega o mapa novamente para criar cubemaps para o novo modo
|-
| {{Command|sv_cheats|1}} || 
|-
| {{Command|buildcubemaps}} || Begins building cubemaps for the new mode
|-
| {{Command|disconnect}} ||
|-
| {{Command|mat_specular|1}} || Ativa os reflexos.
|-
| {{Command|mat_hdr_level|0/1/2}} || Se necessário, retorna ao modo em que estava antes de ter enviado <code>''mat_hdr_level 0/2''</code>
|-
| {{Command|quit}} || (opcional) Sai do jogo. Em alguns jogos, é necessário reiniciar o jogo para exibir os cubemaps recém-construídos
|}

===HDR===
Esta seção destina-se a jogos que executam {{l4dbranch|4}} e ramificações de mecanismo posteriores ou ramificações de mecanismo que suportam apenas HDR ({{xengine|1}}). Para criar cubemaps apenas em HDR, envie os seguintes comandos para o console do jogo:

{| class="wikitable"
|-
! Comando !! Descrição
|-
| {{Command|mat_specular|0}} || Desativa os reflexos, o que é necessário se estiver usando apenas uma iteração de buildcubemaps. Isso também significa que a desativação dos reflexos evitaria alguns casos em que as texturas ausentes ou a textura padrão do cubemap ({{code|materials/engine/defaultcubemap.vtf}}, também conhecida como um deserto com céu laranja ao pôr do sol), poderiam acabar refletidas no próprio cubemap.
|-
| {{Command|map}} ''map_name'' || Carrega o mapa; substitua "''map_name''" pelo nome real do mapa
|-
| {{Command|sv_cheats|1}} || Permite o uso de comandos de trapaça; necessário para criar cubemaps
|-
| {{Command|building_cubemaps|1}} || Define a exposição HDR em um valor consistente. Isso será redefinido automaticamente para 0 depois que os cubemaps forem criados.
|-
| {{Command|buildcubemaps}} || Inicia a criação de cubemaps. Opcionalmente, especifique o número de iterações
|-
| {{Command|disconnect}} || Descarrega o mapa e retorna ao menu principal
|-
| {{Command|mat_specular|1}} || Ativa os reflexos.
|-
| {{Command|quit}} || (opcional) Sai do jogo. Em alguns jogos, é necessário reiniciar o jogo para exibir os cubemaps recém-construídos
|}

==Building cubemaps in specific games==
===Black Mesa: Source===
To build cubemaps in {{bms|4.1}} maps, the game has to be launched with these parameters: <code>-oldgameui -dev -console +r_4way_use_fast_normals 0 +mat_specular 0</code><br>Then, load the map and submit the <code>buildcubemaps</code> command into the console.

===Half-Life: Source===
{{bug|Building cubemaps in {{hls|4.1}} is currently not possible as their textures, despite being generated, aren't embedded into the map file afterward.
{{workaround|Move the map file into the {{path|maps}} folder of a game in the same engine branch (such as {{hl2|4.1}}), build its cubemaps in that game, then move the file back into '''Half-Life: Source'''<nowiki>'</nowiki>s folder.}}{{Confirm|Fixed in {{hldms}}?}}}}

===Half-Life 2 (20th Anniversary Update) ===
{{bug|hidetested=1|Building cubemaps in {{hl2|4.1}}, {{hl2ep1|4.1}} and {{hl2ep2|4.1}}, after 20th anniversary update, might fail. In Half-Life 2 case, the game may access the wrong directory (example: {{code|episodic/maps}}), instead of {{code|hl2/maps}}, preventing the cubemaps from embedded into the map file.

You may also see this error message generated on the console:
{{code|vtex failed to compile cubemap! Unable to remove \steamapps\common\half-life 2\episodic\materials\maps\<map name>\<cubemap location>.vtf}}
}}
{{Workaround|Launch Half-Life 2 with {{code|-game hl2}} [[command line argument]]. For Episodes, launch the game through Steam > Tools (or using {{code|-game episodic}} or {{code|-game ep2}}).}}

===Portal 2===
{{bug|Building cubemaps in {{portal2|4.1}} will fail if the map file is not in the highest-numbered DLC folder ({{path|dlc2}} by default).

{{workaround|Move the map to that folder before building cubemaps and, if necessary, edit the "'''Place compiled maps in this directory before running the game'''" path in [[Hammer Build Programs|Hammer's Build Programs]] options so that the map is automatically generated there.}}}}

===Portal 2: Community Edition===
{{bug|Amount of iterations (e.g.: {{command|buildcubemaps|2}}) doesn't currently work in {{p2ce|4.1}}.
{{workaround|Run the {{command|buildcubemaps}} command, reload the map, then run the command again. Successively repeat these steps if necessary.}}}}


===Source Filmmaker===
[[File:Cubemap_bug_sfm.jpg|thumb|right|300px|Improper rendering of an HDR cubemap's face in Source Filmmaker.]]
{{bug|'''HDR''' cubemaps sizing lower than 64x64 built-in {{tf2|4.1}} and some other games usually display graphical artifacts on reflections due to the last face of each cubemap not rendering properly in {{sfm|4.1}}. While rebuilding cubemaps in it would normally fix the issue, it is currently not possible to do so as {{sfm|4.1}} generates blank textures.
{{workaround|If recompiling a special version of an affected map with {{ent|env_cubemap}}'s now sizing 64x64 (or higher) is not an option, move the map file into {{as|4.1}}<nowiki>'</nowiki>s {{path|maps}} folder, build its cubemaps in that game, then move the file back into {{sfm|4.1}}<nowiki>'</nowiki>s folder.}}}}

:{{note|'''Alien Swarm'''<nowiki>'</nowiki>s "gameinfo.txt" file needs to be modified for this procedure so that the game can have access to assets used by other games' maps not to build cubemaps with missing textures or models. The file's "SearchPaths" section should look like this:}}
 "SearchPaths"
 {
 	"Game"	"|gameinfo_path|."
 	"Game"	"swarm_base"
 	"Game"	"platform"
 	'''"Game" "..\SourceFilmmaker\game\usermod"'''
 	'''"Game" "..\SourceFilmmaker\game\tf_movies"'''
 	'''"Game" "..\SourceFilmmaker\game\tf"'''
 	'''"Game" "..\SourceFilmmaker\game\hl2"'''
 }
{{note|{{tf2|4.1}} configurations were used for the example; consider replacing game subfolders (only those within {{sfm|4.1}} paths) with the ones needed.
:{{workaround|Another option is to manually remove the [[$envmapsphere|sphere map]] (face #7) from the existing HDR cubemap textures. See [[$envmap#Creating a custom static cubemap texture|Creating a custom static cubemap texture]] for more info.<br>Alternatively, deleting the affected HDR cubemap texture files will cause the LDR versions to be used, which do not suffer from this bug.}}}}

==Deleting cubemaps==
Several tools make it possible to delete unnecessary or outdated cubemaps; [[BSPZIP]] is one official, command-line tool which is usually the preferred option for this procedure, allowing for an usage unlikely of corrupting the map file due to misuse. To delete cubemaps, execute the following command within the {{path|maps}} folder:
 ..\..\bin\bspzip -deletecubemaps map_name.bsp
{{note|Replace "''map_name''" with the map's actual name.}}
{{warning|Deleting cubemaps actually deletes all the texture ("[[Valve Texture Format|.vtf]]") files currently embedded into the map, so it's recommended not to embed custom textures before deleting cubemaps.}}

==Extracting cubemaps==
In cases where a map has to be recompiled with minor changes (and its built cubemaps vanish as a result), extracting them beforehand will make it not necessary to go through the whole cubemap-building process again. To extract cubemaps with '''BSPZIP''', create a folder that will contain the extracted cubemaps inside the {{path|maps}} one, then execute the following command:
 ..\..\bin\bspzip -extractcubemaps map_name.bsp "foldername"
{{note|Replace "''map_name''" with the map's actual name, and "''foldername''" with the actual name of the folder to extract cubemaps into.}}


===Embedding cubemaps===
For '''BSPZIP''' to make a map use extracted cubemaps, create a text file inside the {{path|maps}} folder. The file's content should look like this:
 materials/maps/map_name/c-128_384_64.hdr.vtf
 '''foldername\materials\maps\map_name\c-128_384_64.hdr.vtf'''
 materials/maps/map_name/c-128_384_64.vtf
 '''foldername\materials\maps\map_name\c-128_384_64.vtf'''
 materials/maps/map_name/c448_-256_64.hdr.vtf
 '''foldername\materials\maps\map_name\c448_-256_64.hdr.vtf'''
 materials/maps/map_name/c448_-256_64.vtf
 '''foldername\materials\maps\map_name\c448_-256_64.vtf'''
 materials/maps/map_name/cubemapdefault.vtf
 '''foldername\materials\maps\map_name\cubemapdefault.vtf'''
{{note|Replace "''map_name''" with the map's actual name, the cubemaps' filenames with correct ones, and "''foldername''" with the actual name of the folder that contains the extracted cubemaps.}}
A file requires two dedicated lines (paths): the first line represents the path it will use within the map file, whereas the second one is the actual location of the file to embed into the map file. Relative location paths were used for the example, but they can also be Absolute. Once the text file is ready, execute the following command:
 ..\..\bin\bspzip -addlist map_name.bsp textfile.txt newmap_name.bsp
{{note|Replace "''map_name''" with the map's actual name, "''textfile''" with the text file's actual name, and "''newmap_name''" with either the map's actual name, or a new name not to overwrite the original file (and instead create a separate one).}}

==Renaming a map==
For built cubemaps to work, they must be located in a folder that is named after the map; this folder is automatically created within the map file during the building process. Renaming the map file will not also rename said folder, and therefore cubemaps will not be accessed. Some third-party apps allow renaming the folder, though it is not advisable to do so as it may corrupt the file. Instead, either delete and then rebuild the cubemaps, or revert the map to its original name.

==See also==
* [[env_cubemap]]
* [[$envmap]]
* [[parallax_obb]] - For Parallax Corrected Cubemaps.

[[Category:Level Design]]