Converter PMX para PDF

As pessoas convertem código-fonte PMX para PDF quando precisam de partituras imprimíveis, uma partitura com layout fixo para compartilhar ou uma cópia que possa ser visualizada sem a cadeia de ferramentas PMX e MusiXTeX. O PDF também fornece uma versão estável para arquivamento, enquanto o código-fonte original permanece editável.

O que é o formato PMX

No contexto de Documentos, PMX é um formato de código-fonte baseado em texto para o pré-processador PMX, usado com o sistema de editoração musical MusiXTeX. Ele descreve notas, ritmos, vozes, letras, instrumentos e layout de página; não é uma imagem de página finalizada nem uma partitura renderizada.

Compositores, arranjadores e profissionais de editoração musical criam ou editam arquivos PMX com ferramentas PMX e editores de texto. Um projeto também pode conter arquivos .tex gerados, macros MusiXTeX, fontes musicais, arquivos de letras e outros recursos referenciados. Renomear .pmx para outra extensão não converte o código-fonte.

O que é o formato PDF

O PDF armazena as páginas compostas em um layout fixo, incluindo texto, notação, espaçamento e, normalmente, fontes incorporadas ou referenciadas. Ele é adequado para imprimir, distribuir partituras, enviar uma partitura e arquivar uma versão que não exija PMX ou MusiXTeX.

O PDF não é um substituto conveniente para o código-fonte: alterar a estrutura musical, as letras ou o layout é consideravelmente mais fácil no .pmx original e nos arquivos relacionados. Mantenha o projeto completo do código-fonte junto com o PDF exportado.

Como converter PMX para PDF

O método mais confiável é a editoração local com uma distribuição TeX, MusiXTeX e a distribuição PMX. O TeX Live oferece suporte a Linux, macOS e Windows; o MiKTeX pode ser usado no Windows quando os pacotes MusiXTeX necessários estiverem disponíveis. O próprio PMX pode precisar ser instalado separadamente a partir de sua distribuição ou do código-fonte CTAN.

1. Instale TeX Live ou MiKTeX, MusiXTeX e PMX. Confirme que pmxab e o comando wrapper do MusiXTeX estão disponíveis no PATH do sistema.
2. Coloque o arquivo de código-fonte e todos os arquivos referenciados em um único diretório de trabalho. Verifique os nomes de arquivo, os caminhos relativos, as macros personalizadas, as fontes e os gráficos incluídos.
3. Abra um terminal nesse diretório e execute pmxab score.pmx. Normalmente, isso gera um arquivo compatível com MusiXTeX, como score.tex.
4. Execute o wrapper de compilação do MusiXTeX, geralmente musixtex score ou musixtex score.tex, de acordo com a distribuição instalada. O wrapper executa as etapas do TeX e dos arquivos auxiliares necessárias para o espaçamento musical e normalmente produz score.pdf.
5. Abra o PDF e inspecione todas as páginas, incluindo o espaçamento dos sistemas, as letras, as quiálteras, os acidentes, as viradas de página, as quebras de linha e as barras finais.

Os nomes dos comandos e o comportamento do wrapper variam entre as versões do PMX e do MusiXTeX. Se o wrapper não estiver disponível, use o procedimento de compilação fornecido com essa versão, em vez de presumir que uma única execução de pdflatex seja suficiente. Um arquivo PMX gerado pode exigir as passagens tradicionais do TeX, de musixflx e do TeX repetido, seguidas pela geração do PDF.

No Windows, execute os comandos no Prompt de Comando ou no PowerShell depois de adicionar os diretórios do TeX, MusiXTeX e PMX ao PATH. Uma distribuição PMX também pode fornecer um arquivo em lote ou um comando gráfico Build ou Typeset.

Opções de conversão online

Sites gerais de conversão de arquivos e conversores de documentos de escritório normalmente não analisam a notação PMX, portanto não são opções confiáveis de upload direto. O Overleaf pode compilar um projeto MusiXTeX .tex gerado quando os pacotes necessários e os arquivos de suporte são enviados, mas não é um conversor direto de PMX, pois a etapa de pré-processamento do PMX geralmente precisa ser executada localmente primeiro. A compilação local é preferível para partituras não publicadas ou projetos que contenham material proprietário.

Qualidade e compatibilidade

A saída depende de versões compatíveis do PMX, MusiXTeX, TeX, macros e fontes musicais. Pacotes ou arquivos referenciados ausentes podem interromper a compilação ou produzir uma notação incompleta; mantenha o log do compilador ao diagnosticar erros.

O PMX usa código-fonte estruturado e sensível à sintaxe, em vez de texto comum de processamento de texto. Se as quebras de página ou o espaçamento estiverem incorretos, altere as configurações de layout relevantes do PMX e gere o PDF novamente. Editar a notação diretamente em um PDF pode alterar o posicionamento sem corrigir a música subjacente. Mantenha o código-fonte original e registre as versões das ferramentas usadas para criar o PDF final.