Extra tools/pt-br: Difference between revisions
Created page with "Essas e outras ferramentas extras (listadas abaixo) podem ser encontradas no [https://github.com/ddnet/ddnet código-fonte do DDNet] em [https://github.com/ddnet/ddnet/tree/master/src/ diretório de ferramentas src/tools]." |
Created page with "''Disponível desde: DDNet 10.6.1''" |
||
(52 intermediate revisions by the same user not shown) | |||
Line 9: | Line 9: | ||
Essas e outras ferramentas extras (listadas abaixo) podem ser encontradas no [https://github.com/ddnet/ddnet código-fonte do DDNet] em [https://github.com/ddnet/ddnet/tree/master/src/ diretório de ferramentas src/tools]. | Essas e outras ferramentas extras (listadas abaixo) podem ser encontradas no [https://github.com/ddnet/ddnet código-fonte do DDNet] em [https://github.com/ddnet/ddnet/tree/master/src/ diretório de ferramentas src/tools]. | ||
< | <span id="List_of_extra_tools"></span> | ||
== | == Lista de ferramentas extras == | ||
Veja abaixo a lista e descrição das ferramentas. | |||
=== config_retrieve === | === config_retrieve === | ||
config_retrieve ''arquivo_mapa'' | |||
config_retrieve '' | |||
Obtém a configuração incorporada em um arquivo de mapa ''arquivo_mapa'' do DDNet e a armazena em um arquivo de configuração de mapa do DDNet com o mesmo nome de arquivo (por exemplo, "Kobra 4.map" retorna "Kobra 4.cfg") | |||
''Disponível desde: DDNet 9.0'' | |||
'' | |||
=== config_store === | === config_store === | ||
config_store ''arquivo_mapa'' | |||
config_store '' | |||
Armazena a configuração de um arquivo de configuração de mapa em ''arquivo_mapa''. Os arquivos de configuração e de mapa devem ter o mesmo nome de arquivo no mesmo diretório, caso contrário a operação falhará. | |||
Se não houver diferença entre a configuração armazenada e a configuração incorporada no mapa, a operação será cancelada com a mensagem <code>configs coincide, not updating map</code>. | |||
''Disponível desde: DDNet 9.0'' | |||
'' | |||
=== crapnet === | === crapnet === | ||
crapnet | |||
crapnet | |||
Testa a conexão definindo uma conexão cliente-servidor localmente e executando ping entre eles. Relata pacotes descartados com a mensagem <code>dropped packet</code> (pacote descartado) e sucessos com <code>cfg = ''número''</code>, onde ''número'' varia de 0 a 2. | |||
=== dilate === | === dilate === | ||
dilate ''arquivo_imagem1'' [''arquivo_imagem2'' ... ] | |||
dilate '' | |||
É uma ferramenta gráfica, útil principalmente para mapeadores. Ele cuida das áreas transparentes para evitar contornos em preto e branco ao redor das imagens no jogo, evitando problemas de mesclagem e mipmap. Consulte [http://wiki.polycount.com/wiki/Edge_padding Edge padding] (Preenchimento de borda, em tradução livre) para obter mais informações. | |||
Observe que isso funciona apenas em arquivos de imagem RGBA (por exemplo, arquivos PNG). Então, ele irá falhar, p. ex., em arquivos JPEG. | |||
=== dummy_map === | === dummy_map === | ||
dummy_map | |||
dummy_map | |||
Cria um pequeno mapa vazio fictício para ser usado para iniciar um servidor. Consulte [https://github.com/ddnet/ddnet/blob/a66379918832e5ad93332bbe0475394b156b5c24/src/engine/shared/network_server.cpp#L371] para obter mais informações. | |||
=== fake_server === | === fake_server === | ||
fake_server | |||
fake_server | |||
Cria um servidor falso para testes. | |||
=== map_convert_07 === | === map_convert_07 === | ||
map_convert_07 ''arquivo_mapa_fonte'' ''arquivo_mapa_destino'' | |||
map_convert_07 '' | |||
Torna <code>''arquivo_mapa_destino''</code> compatível com Teeworlds versão 7.x que, do contrário, seria compatível '''apenas''' com Teeworlds versão 6.x. Se for bem-sucedido, ele cria um mapa de destino compatível com 07 válido; caso contrário, ele retornará um dos seguintes: | |||
* uma mensagem de uso se argumentos incorretos forem fornecidos | |||
* | * <code>failed to open source map</code> se ocorrer um erro ao abrir o mapa fonte | ||
* <code>failed to open source map</code> | * <code>failed to open destination map</code> se ocorrer um erro ao abrir o mapa de destino | ||
* <code>failed to open destination map</code> | * <code>erro ao carregar o armazenamento</code> se não for possível abrir o armazenamento por algum motivo | ||
* <code> | * <code>error loading storage</code> se ocorrer um erro ao abrir a imagem PNG | ||
* <code> | * <code>invalid image format</code> se for um PNG formatado incorretamente. | ||
* <code>invalid image format</code> | |||
''Disponível desde: DDNet 12.9'' | |||
'' | |||
=== map_diff === | === map_diff === | ||
map_diff ''arquivo_mapa1'' ''arquivo_mapa2'' | |||
map_diff '' | |||
Compara dois arquivos de mapa, relatando um dos seguintes: | |||
* sem saída diff, o que significa que os mapas são iguais | |||
* | * <code>different layer numbers</code>, se um mapa tiver mais camadas que outro | ||
* <code>different layer numbers</code>, | * <code>different tile layers</code>, se o número de camadas for o mesmo, mas pelo menos uma camada for diferente | ||
* <code>different tile layers</code>, | * por último, as posições do índice e dos sinalizadores que diferem. | ||
* | |||
Se não houver diferença entre os mapas, retorna 0; caso contrário, retornará 1. | |||
=== map_extract === | === map_extract === | ||
map_extract ''arquivo_mapa'' [''diretório''] | |||
map_extract '' | |||
Extrai o conteúdo de ''arquivo_mapa'' para o ''diretório''. Se o argumento opcional ''diretório'' não for fornecido, extrai para o diretório atual. | |||
=== map_optimize === | === map_optimize === | ||
map_optimize ''caminho_arquivo_mapa_fonte'' [''caminho_arquivo_mapa_destino''] | |||
map_optimize '' | |||
Otimiza o arquivo de mapa no <code>''caminho_arquivo_mapa_fonte''</code> fornecido (veja [https://github.com/ddnet/ddnet/pull/3201 como funciona]) e armazena a saída em < código>''caminho_arquivo_mapa_destino''</code>; se <code>''caminho_arquivo_mapa_destino''</code> não estiver definido, o caminho de saída será padronizado como <code>out/''caminho_arquivo_mapa_fonte''.map</code>, removendo o caminho e a extensão do arquivo de origem. | |||
Observe que o nome das imagens incorporadas otimizadas foi alterado de <code>''nomeoriginal''</code> para <code>''nomeoriginal''_cut_''newSHA256''</code> (onde <code>''newSHA256 ''</code> é o novo sha256 da imagem otimizada incorporada). É renomeada para deixar claro que foi otimizado porque esta ferramenta '''fará''' alterações nos mapres usados pelo arquivo de mapa. | |||
Se não for possível abrir o arquivo fonte ou de destino, retornará -1. | |||
''Disponível desde:'' DDNet 15.5.4 | |||
'' | |||
=== map_replace_image === | === map_replace_image === | ||
map_replace_image ''arquivo_mapa1'' ''arquivo_mapa2'' ''nomeimagem'' ''arquivo_imagem'' | |||
map_replace_image '' | |||
Substitui a imagem ''nomeimagem'' atualmente dentro do nome de arquivo do mapa ''arquivo_mapa1'' pelo caminho do arquivo de imagem ''arquivo_imagem'' e salva no nome de arquivo do mapa ''arquivo_mapa2.map''. | |||
Observe: | |||
* Ambos os nomes de arquivos de mapas devem ser relativos à pasta padrão de DDNet de usuário | |||
* | * O novo caminho do arquivo da imagem pode ser absoluto ou relativo ao diretório atual | ||
* | |||
=== map_resave === | === map_resave === | ||
map_resave ''arquivo_mapa'' ''arquivo_imagem'' | |||
map_resave '' | |||
Atualiza o arquivo de mapa ''arquivo_mapa.map'' com o arquivo fornecido ''arquivo_imagem''. | |||
O status de erro 255 é retornado se 1) um número de argumentos diferente de 2 for fornecido, 2) se ''arquivo_mapa.map'' não for válido ou 3) se ''arquivo_imagem'' não for um arquivo de imagem válido (por exemplo, é um arquivo de texto); caso contrário, retorne 0. | |||
=== packetgen === | === packetgen === | ||
packetgen | |||
packetgen | |||
Gera e envia pacotes de rede para 127.0.0.1:8303 (localhost, na porta padrão do servidor) para testar a comunicação com uma instância de servidor local. | |||
=== unicode_confusables === | === unicode_confusables === | ||
unicode_confusables ''string1'' ''string2'' | |||
unicode_confusables ''string1'' ''string2'' | |||
Compara ''string1'' com ''string2'' e informa se elas são "confundíveis", ou seja, se os caracteres são "iguais" e podem causar confusão. Para que isso funcione, os caracteres com acentos ou outras coisas ao seu redor são considerados "confundíveis" com o caractere base. Portanto, ''a'' e ''aá'' são confundíveis (''á'' foi considerado como ''a''), enquanto ''aa'' e ''ab'' não são. | |||
Se forem confundíveis, retorna <code>not_confusable=0</code>, caso contrário, retorna <code>not_confusable=1</code>. | |||
''Disponível desde: DDNet version 10.3.5'' | |||
'' | |||
''Novo no DDNet versão 12.9:'' Suporte a Unicode 12.0 e o nome da ferramenta foi renomeado de ''confusables'' para ''unicode_confusables''. | |||
'' | |||
=== uuid === | === uuid === | ||
uuid ''nome'' | |||
uuid '' | |||
Exibe o uuid para o ''nome'' fornecido. | |||
O sistema de uuid foi implementado para ser facilmente estendido por autores independentes sem colisões, algo que o sistema antigo – com números inteiros crescentes – não permitia. Isso funciona para mensagens da engine e do jogo, itens de instantâneo e eventos. | |||
Sai com status de erro 255 se ''nome'' não for fornecido. | |||
''Disponível desde: DDNet 10.6.1'' | |||
'' | |||
Latest revision as of 17:22, 9 February 2024
Ferramentas extras estão disponíveis para executar algumas tarefas não relacionadas a jogar, como otimização de mapas por mapeadores ou depuração e testes por desenvolvedores. Essas ferramentas devem ser executadas a partir da interface de linha de comando (por exemplo, Prompt de Comando no Windows ou Terminal no Linux), adicionando o diretório que as contém à variável PATH ou executando diretamente a partir do diretório que as contém.
Obtendo as ferramentas extras
Essas ferramentas não são fornecidas no jogo binário do DDNet na página de downloads. Dito isto, ferramentas extras relacionadas ao mapeamento podem ser baixadas para diferentes plataformas na página de Downloads, sob o nome "Ferramentas Gráficas".
Essas e outras ferramentas extras (listadas abaixo) podem ser encontradas no código-fonte do DDNet em diretório de ferramentas src/tools.
Lista de ferramentas extras
Veja abaixo a lista e descrição das ferramentas.
config_retrieve
config_retrieve arquivo_mapa
Obtém a configuração incorporada em um arquivo de mapa arquivo_mapa do DDNet e a armazena em um arquivo de configuração de mapa do DDNet com o mesmo nome de arquivo (por exemplo, "Kobra 4.map" retorna "Kobra 4.cfg")
Disponível desde: DDNet 9.0
config_store
config_store arquivo_mapa
Armazena a configuração de um arquivo de configuração de mapa em arquivo_mapa. Os arquivos de configuração e de mapa devem ter o mesmo nome de arquivo no mesmo diretório, caso contrário a operação falhará.
Se não houver diferença entre a configuração armazenada e a configuração incorporada no mapa, a operação será cancelada com a mensagem configs coincide, not updating map
.
Disponível desde: DDNet 9.0
crapnet
crapnet
Testa a conexão definindo uma conexão cliente-servidor localmente e executando ping entre eles. Relata pacotes descartados com a mensagem dropped packet
(pacote descartado) e sucessos com cfg = número
, onde número varia de 0 a 2.
dilate
dilate arquivo_imagem1 [arquivo_imagem2 ... ]
É uma ferramenta gráfica, útil principalmente para mapeadores. Ele cuida das áreas transparentes para evitar contornos em preto e branco ao redor das imagens no jogo, evitando problemas de mesclagem e mipmap. Consulte Edge padding (Preenchimento de borda, em tradução livre) para obter mais informações.
Observe que isso funciona apenas em arquivos de imagem RGBA (por exemplo, arquivos PNG). Então, ele irá falhar, p. ex., em arquivos JPEG.
dummy_map
dummy_map
Cria um pequeno mapa vazio fictício para ser usado para iniciar um servidor. Consulte [1] para obter mais informações.
fake_server
fake_server
Cria um servidor falso para testes.
map_convert_07
map_convert_07 arquivo_mapa_fonte arquivo_mapa_destino
Torna arquivo_mapa_destino
compatível com Teeworlds versão 7.x que, do contrário, seria compatível apenas com Teeworlds versão 6.x. Se for bem-sucedido, ele cria um mapa de destino compatível com 07 válido; caso contrário, ele retornará um dos seguintes:
- uma mensagem de uso se argumentos incorretos forem fornecidos
failed to open source map
se ocorrer um erro ao abrir o mapa fontefailed to open destination map
se ocorrer um erro ao abrir o mapa de destinoerro ao carregar o armazenamento
se não for possível abrir o armazenamento por algum motivoerror loading storage
se ocorrer um erro ao abrir a imagem PNGinvalid image format
se for um PNG formatado incorretamente.
Disponível desde: DDNet 12.9
map_diff
map_diff arquivo_mapa1 arquivo_mapa2
Compara dois arquivos de mapa, relatando um dos seguintes:
- sem saída diff, o que significa que os mapas são iguais
different layer numbers
, se um mapa tiver mais camadas que outrodifferent tile layers
, se o número de camadas for o mesmo, mas pelo menos uma camada for diferente- por último, as posições do índice e dos sinalizadores que diferem.
Se não houver diferença entre os mapas, retorna 0; caso contrário, retornará 1.
map_extract
map_extract arquivo_mapa [diretório]
Extrai o conteúdo de arquivo_mapa para o diretório. Se o argumento opcional diretório não for fornecido, extrai para o diretório atual.
map_optimize
map_optimize caminho_arquivo_mapa_fonte [caminho_arquivo_mapa_destino]
Otimiza o arquivo de mapa no caminho_arquivo_mapa_fonte
fornecido (veja como funciona) e armazena a saída em < código>caminho_arquivo_mapa_destino; se caminho_arquivo_mapa_destino
não estiver definido, o caminho de saída será padronizado como out/caminho_arquivo_mapa_fonte.map
, removendo o caminho e a extensão do arquivo de origem.
Observe que o nome das imagens incorporadas otimizadas foi alterado de nomeoriginal
para nomeoriginal_cut_newSHA256
(onde newSHA256
é o novo sha256 da imagem otimizada incorporada). É renomeada para deixar claro que foi otimizado porque esta ferramenta fará alterações nos mapres usados pelo arquivo de mapa.
Se não for possível abrir o arquivo fonte ou de destino, retornará -1.
Disponível desde: DDNet 15.5.4
map_replace_image
map_replace_image arquivo_mapa1 arquivo_mapa2 nomeimagem arquivo_imagem
Substitui a imagem nomeimagem atualmente dentro do nome de arquivo do mapa arquivo_mapa1 pelo caminho do arquivo de imagem arquivo_imagem e salva no nome de arquivo do mapa arquivo_mapa2.map.
Observe:
- Ambos os nomes de arquivos de mapas devem ser relativos à pasta padrão de DDNet de usuário
- O novo caminho do arquivo da imagem pode ser absoluto ou relativo ao diretório atual
map_resave
map_resave arquivo_mapa arquivo_imagem
Atualiza o arquivo de mapa arquivo_mapa.map com o arquivo fornecido arquivo_imagem.
O status de erro 255 é retornado se 1) um número de argumentos diferente de 2 for fornecido, 2) se arquivo_mapa.map não for válido ou 3) se arquivo_imagem não for um arquivo de imagem válido (por exemplo, é um arquivo de texto); caso contrário, retorne 0.
packetgen
packetgen
Gera e envia pacotes de rede para 127.0.0.1:8303 (localhost, na porta padrão do servidor) para testar a comunicação com uma instância de servidor local.
unicode_confusables
unicode_confusables string1 string2
Compara string1 com string2 e informa se elas são "confundíveis", ou seja, se os caracteres são "iguais" e podem causar confusão. Para que isso funcione, os caracteres com acentos ou outras coisas ao seu redor são considerados "confundíveis" com o caractere base. Portanto, a e aá são confundíveis (á foi considerado como a), enquanto aa e ab não são.
Se forem confundíveis, retorna not_confusable=0
, caso contrário, retorna not_confusable=1
.
Disponível desde: DDNet version 10.3.5
Novo no DDNet versão 12.9: Suporte a Unicode 12.0 e o nome da ferramenta foi renomeado de confusables para unicode_confusables.
uuid
uuid nome
Exibe o uuid para o nome fornecido.
O sistema de uuid foi implementado para ser facilmente estendido por autores independentes sem colisões, algo que o sistema antigo – com números inteiros crescentes – não permitia. Isso funciona para mensagens da engine e do jogo, itens de instantâneo e eventos.
Sai com status de erro 255 se nome não for fornecido.
Disponível desde: DDNet 10.6.1