Convertir ASM a PDF

Una copia en PDF permite a los revisores imprimir o archivar el código fuente en lenguaje ensamblador sin necesitar un assembler, y permite a los destinatarios de CAD inspeccionar un ensamblaje cuando no disponen de la aplicación de autoría. El procedimiento correcto depende de si .asm contiene código fuente para un procesador o un ensamblaje de CAD.

Qué es el formato ASM

.asm es una extensión ambigua. En proyectos de software, normalmente identifica código fuente de lenguaje ensamblador en texto sin formato para procesadores como x86, ARM, MIPS, 8051 o 6502. MASM, NASM, GNU assembler, Keil, MPLAB y los IDE de sistemas embebidos pueden crear estos archivos. Pueden contener instrucciones, etiquetas, directivas, macros, comentarios y declaraciones include.

En CAD mecánico, .asm puede identificar un documento de ensamblaje, especialmente en Solid Edge. Un ensamblaje de CAD normalmente hace referencia a archivos independientes de piezas y subensamblajes; no es un documento de texto sin formato y no se puede convertir correctamente cambiando simplemente la extensión o enviándolo a un convertidor de texto a PDF.

Qué es el formato PDF

PDF almacena una representación visual paginada con fuentes, posicionamiento, gráficos y configuraciones de impresión. Es adecuado para listados de código, documentación técnica, copias para revisión e instantáneas de archivo, pero no compila el código fuente en lenguaje ensamblador ni conserva la editabilidad nativa, el historial paramétrico o la estructura completa de componentes de un ensamblaje de CAD.

Convertir código fuente en lenguaje ensamblador en Windows

1. Abra el archivo .asm en Notepad++, Visual Studio Code u otro editor de texto. No lo abra en un procesador de textos que pueda reemplazar tabulaciones o modificar caracteres.
2. Seleccione el lexer de lenguaje ensamblador más cercano si desea aplicar resaltado de sintaxis. En Notepad++, use Language → A → Assembly; el resaltado es visual y no comprueba la sintaxis ni identifica el dialecto del procesador.
3. Use una fuente monoespaciada como Consolas o DejaVu Sans Mono. Establezca el interlineado, los márgenes, la orientación y un tamaño de fuente que evite que las instrucciones importantes se ajusten a varias líneas.
4. Elija File → Print, seleccione Microsoft Print to PDF y establezca el tamaño del papel, la orientación, los márgenes, los números de línea y el resaltado de sintaxis en las opciones de impresión. Guarde el PDF resultante.

Para un PDF que contenga únicamente código, es preferible usar el comando de impresión del editor en lugar de copiar el código fuente en un procesador de textos, ya que conserva la sangría y la estructura de líneas de forma más fiable.

Generar PDF con resaltado reproducible en cualquier plataforma de escritorio

Pygments puede crear una representación HTML que un navegador imprime en PDF. Instálelo con:

python -m pip install Pygments

Para la sintaxis de NASM, ejecute:

pygmentize -l nasm -f html -O full,style=default -o program.html program.asm

Para la sintaxis de GNU assembler, use -l gas; seleccione otro lexer de Pygments cuando el dialecto lo requiera. Abra program.html en un navegador y elija Print → Save as PDF. Use una fuente monoespaciada, orientación horizontal, márgenes estrechos y una escala adecuada para líneas largas. Esto representa el código fuente; no lo ensambla ni lo valida.

Convertir un ensamblaje de Solid Edge u otro ensamblaje de CAD

1. Abra el ensamblaje en su aplicación de CAD nativa y resuelva las referencias faltantes a piezas, subensamblajes, materiales y texturas antes de exportarlo.
2. Use el comando Publish 3D PDF de Solid Edge, si está disponible en la versión y licencia instaladas; después, seleccione las vistas, propiedades del modelo, PMI y estructura del ensamblaje necesarios. Los nombres de los comandos y la disponibilidad de 3D-PDF varían según la versión.
3. Para crear en su lugar un documento técnico plano, cree o abra un dibujo y use File → Export o Print para crear un PDF 2D. Esto produce hojas de dibujo, no un modelo 3D interactivo.
4. Abra el resultado en un visor de PDF de escritorio compatible con contenido 3D incrustado. Muchos visores de PDF de navegadores y aplicaciones móviles solo muestran la página u omiten las funciones 3D interactivas.

Otros sistemas de CAD pueden publicar directamente en 3D PDF o requerir un exportador o traductor. Un convertidor genérico en línea no es un sustituto fiable porque puede ignorar las referencias del ensamblaje, suprimir componentes o admitir únicamente dibujos 2D.

Convertidores en línea

CloudConvert y Online-Convert pueden ser útiles para trabajos de conversión de texto sin formato a PDF cuando el servicio acepta explícitamente el archivo cargado o acepta una copia temporal .txt. Verifique el tipo de entrada, la codificación, el diseño de página y el texto generado antes de compartir el resultado. Por lo general, los servicios en línea no admiten ensamblajes de Solid Edge ni la exportación de PDF 3D interactivo.

No cargue firmware propietario, credenciales, investigaciones sobre exploits, código fuente no publicado ni datos confidenciales de CAD, a menos que las condiciones de retención y procesamiento del servicio sean aceptables. La exportación local desde un editor, navegador o CAD nativo evita esa exposición.

Limitaciones de calidad y compatibilidad

La conversión a PDF no resuelve archivos include, no expande macros, no detecta errores del assembler, no conserva las configuraciones de compilación ni reproduce el resultado ejecutable de un programa. Abra el código fuente usando su codificación real, normalmente UTF-8, antes de imprimirlo; una codificación incorrecta puede reemplazar los comentarios que no sean ASCII. Compruebe las líneas largas, las tabulaciones, los números de línea, los saltos de página, los símbolos y los colores de sintaxis en el PDF final.

Conserve el archivo original .asm y sus archivos relacionados del proyecto o de los componentes de CAD. La extracción de texto de un PDF puede modificar las tabulaciones, los espacios en blanco, los finales de línea y el orden de lectura, mientras que un PDF 3D puede omitir funciones de CAD no compatibles. Para las copias de archivo, registre el procesador, el assembler y su versión, la codificación del código fuente, la aplicación de CAD y su versión cuando corresponda, las configuraciones de exportación y la fecha de conversión.