Rodar DOOM em PDF

Evaluating the feasibility

I'm noting the request to embed DOOM in a PDF, evaluating if executing DOOM directly from a PDF is feasible, and examining potential methods like the "DOOM PDF" hack.

Verifying permissions

Checking if instruction on embedding a game in a PDF is permitted, as it doesn't involve hacking. Considering methods like JavaScript or an emulator for practical implementation.

Preparing a feasible method

I’m mapping out a way to reasonably demonstrate embedding DOOM in a PDF, likely using JavaScript, while noting it may need a specific environment and might not work on all readers.

Providing clear instructions

I'm preparing to give detailed, advanced instructions in Portuguese on embedding DOOM in a PDF, cautioning that it may involve security vulnerabilities and won't work across all readers.

Thought about rodar DOOM em um PDF por 9 segundos

A ideia de “rodar DOOM dentro de um PDF” tornou-se famosa na internet como uma demonstração de criatividade e de como alguns recursos internos do formato PDF podem ser explorados de maneiras não convencionais. Normalmente, o PDF é utilizado apenas para documentos de texto e imagens, mas há quem explore as funcionalidades de JavaScript ou de 3D embarcado (através de anotações 3D/embedded 3D annotations) para tentar fazer um jogo simples ser executado dentro do próprio arquivo.

No entanto, é importante frisar alguns pontos antes de prosseguir:

• Nem todo leitor de PDF suporta esse tipo de recurso. Geralmente, esse truque (quando funciona) ocorre no Adobe Acrobat/Reader, que possui uma implementação de JavaScript própria e algumas extensões de 3D em PDF. Em leitores mais simples (como visualizadores nativos do navegador, Okular, Foxit, etc.), muito provavelmente não funcionará.
• Pode exigir conhecimento avançado de programação em JavaScript e do próprio formato PDF.
• É um experimento/hack, não uma funcionalidade oficial e garantida. Em muitos casos, a execução pode ser lenta, com bugs ou simplesmente não acontecer.

A seguir, apresento um passo a passo em nível conceitual de como esse processo foi realizado em experimentos na internet. Cada etapa exigirá pesquisa aprofundada, pois não há uma “ferramenta oficial” que transforme DOOM em PDF com um clique.

1. Entendendo o que você vai precisar

1. O WAD do DOOM: São os arquivos originais do jogo (ou de uma versão livre, como o Freedoom).
2. Motor (engine) de DOOM em JavaScript: Existe, por exemplo, o “js-dos” (uma porta do DOSBox em JavaScript) e também versões experimentais do DOOM em WebAssembly/JavaScript. É esse motor que efetivamente “roda” o jogo dentro de um ambiente JavaScript.
3. Ferramentas de criação/edição de PDF avançadas: Você precisará de um editor ou gerador de PDF que permita inserir JavaScript e possivelmente recursos 3D ou multimídia. O Adobe Acrobat Pro é o mais comum, mas existem bibliotecas de geração de PDF em linguagens como Python, Node.js, C#, etc., que podem permitir a injeção de scripts.
4. Conhecimento de PDF JS API (a API de JavaScript do Acrobat): É uma API que permite criar botões, campos de formulário e outros elementos interativos dentro de um PDF, além de inserir scripts que serão executados no Acrobat Reader.

2. Converta ou incorpore o engine de DOOM em JavaScript

O cerne do truque está em ter uma versão de DOOM que rode em JavaScript. Há algumas opções:

1. Em-DOSBox: Uma emulação do DOSBox compilada em WebAssembly, que pode rodar DOOM (a versão do MS-DOS) diretamente no navegador.
2. Portes nativos de DOOM para JavaScript: Alguns desenvolvedores compilaram o código-fonte aberto do DOOM usando Emscripten, gerando um binário em WebAssembly + JavaScript.

O processo básico é:

• Obter o código-fonte que foi compilado para WebAssembly ou JavaScript (por exemplo, um projeto pronto do GitHub).
• Ajustar para que ele seja “embedding-friendly”, isto é, que possa ser chamado como uma função ou script dentro de outro sistema, em vez de ser executado somente em uma página HTML completa.

3. Preparando um protótipo em HTML/JavaScript

Antes de levar tudo para dentro do PDF, é altamente recomendável que você:

1. Faça um protótipo em HTML:

   • Crie uma página HTML local com o script do DOOM JavaScript ou Em-DOSBox.
   • Teste se o jogo inicia, se está pegando o arquivo WAD (ou Freedoom) corretamente, se o teclado/mouse funcionam.

2. Verifique o tamanho total dos arquivos:

   • O WAD do DOOM, por exemplo, pode ter vários MBs. Some a isso a engine (JavaScript + WebAssembly), que também tende a ter alguns MBs. Então, o PDF resultante pode ficar bem pesado.

3. Teste a integração:

   • Geralmente, você chama o script principal (por exemplo, doom.js ou dosbox.js) e insere o WAD ou o arquivo de disco no local correto.
   • Em projetos de demonstração, muitas vezes se usa um array binário em JavaScript (um Uint8Array) representando o conteúdo do WAD.

4. Inserindo no PDF via JavaScript Embutido

Depois que o protótipo estiver funcionando em HTML, o próximo passo é tentar aproveitar esse mesmo código dentro do PDF. Para isso:

1. Abra o Adobe Acrobat Pro (ou outro editor capaz) e crie um PDF em branco ou com alguma página inicial.

2. Acesse as ferramentas de Formulário:

   • Crie um campo de botão (por exemplo, um botão de formulário). É nesse botão que normalmente se consegue anexar scripts que rodam no JavaScript interno do Acrobat.
   • Há a possibilidade de usar scripts em “Document-level scripts” (Scripts de nível de documento), que executam assim que o PDF é aberto.

3. Cole o código JavaScript do DOOM:

   • O Acrobat possui limites de tamanho e de API, por isso você pode precisar fracionar o código ou tentar incorporar por meio de anexos.
   • Algumas demonstrações usam o Anexo (Attachment) dentro do PDF para armazenar o arquivo WAD e o JS/wasm. Então, no script principal, você “extrai” esses anexos e roda em memória.

4. Ajuste o script para que ele use os recursos de multimídia ou 3D do Acrobat:

   • Algumas versões desse experimento fizeram uso de “anotações 3D” para renderizar gráficos dentro de um quadro 3D do Acrobat.
   • Outras tentaram simplesmente usar as APIs de canvas 2D do Acrobat, mas elas são muito mais limitadas.

5. Teste no próprio Adobe Reader:

   • Salve o PDF, abra no Adobe Reader e veja se algo acontece. Na maioria das vezes, o Reader vai travar, ou não vai conseguir rodar o script, ou vai exibir avisos de segurança que bloqueiam o JavaScript.
   • Ajuste as configurações de segurança do Acrobat para permitir scripts mais avançados.

5. Verificando limitações e compatibilidades

Mesmo seguindo todos os passos, há grandes chances de o experimento falhar ou funcionar parcialmente. Eis alguns dos problemas comuns:

1. Limitação de API de JavaScript no Acrobat Reader: O Acrobat não implementa todos os recursos do JavaScript de um navegador. Então, chamadas como document.createElement("canvas"), WebGL, AudioContext, etc., podem não existir.
2. Velocidade de execução: O motor JavaScript do Acrobat não foi feito para rodar jogos pesados; pode ficar extremamente lento ou travar.
3. Recursos de desenho: Para exibir o jogo, seria necessário um “canvas” ou algo equivalente. Em alguns experimentos, recorre-se a anotações 3D que podem atualizar a imagem em tempo real, mas não é simples nem garantido.
4. Tamanho do PDF: Se você embutir o WAD e toda a engine em um único PDF, o arquivo pode chegar a dezenas de MB ou mais.

6. Possível alternativa: PDF com link incorporado

Diante dessas dificuldades, algumas pessoas simulam “rodar DOOM no PDF” assim:

1. Crie um PDF com um iframe ou um objeto multimídia que aponte para uma página HTML (hosteada na internet ou offline).
2. Ao abrir o PDF, dependendo do leitor, esse objeto pode carregar a página HTML em um webview interno (principalmente no Acrobat) e exibir o DOOM rodando no “site” incorporado.
3. Esse método, porém, depende de conexão com a internet ou de configurações permissivas do Adobe Reader para carregar conteúdo externo.

Na prática, acaba sendo um truque de “abrir DOOM através de um embed no PDF”, mas não exatamente dentro do PDF, pois você continua dependendo de um navegador embutido.

Conclusão

“Fazer DOOM rodar em um .pdf” é mais um experimento técnico e curioso do que um procedimento simples para todo mundo repetir. Não existe uma ferramenta oficial ou documentação detalhada da Adobe descrevendo “como embutir um jogo inteiro em PDF”. A maioria dos exemplos se baseia em:

1. Encontrar (ou compilar) uma versão WebAssembly/JS de DOOM.
2. Usar recursos não convencionais do Acrobat (JavaScript + anotações 3D/objetos multimídia).
3. Fazer inúmeras adaptações para que o código rode no ambiente limitado do Acrobat Reader.

Se você quiser se aprofundar:

• Procure por repositórios no GitHub que demonstram “DOOM em PDF” ou “Adobe DOOM”.
• Estude a parte de JavaScript for Acrobat API Reference, que descreve o que é ou não permitido no JavaScript do Acrobat.
• Fique atento à segurança do PDF: muitos recursos JavaScript são bloqueados por padrão, justamente para evitar exploits e malwares.

Portanto, se a sua intenção for simplesmente se divertir ou demonstrar que é possível, siga os passos conceituais acima e estude as demos existentes na internet. Mas esteja preparado: trata-se de um “hack” bastante avançado, não garantido, e que depende profundamente de funcionalidades específicas e restritas do Adobe Reader.