Convertir ASM en PDF

Une copie PDF permet aux réviseurs d’imprimer ou d’archiver le code source en langage assembly sans nécessiter d’assembleur, et elle permet aux destinataires CAD d’inspecter un assemblage lorsqu’ils ne disposent pas de l’application de création. La procédure correcte dépend du fait que .asm contienne du code source pour processeur ou un assemblage CAD.

Qu’est-ce que le format ASM ?

.asm est une extension ambiguë. Dans les projets logiciels, elle désigne généralement du code source en langage assembly au format texte brut pour des processeurs tels que x86, ARM, MIPS, 8051 ou 6502. MASM, NASM, GNU assembler, Keil, MPLAB et les IDE de systèmes embarqués peuvent créer ces fichiers. Ils peuvent contenir des instructions, des labels, des directives, des macros, des commentaires et des instructions include.

Dans la conception mécanique CAD, .asm peut désigner un document d’assemblage, notamment dans Solid Edge. Un assemblage CAD fait normalement référence à des fichiers de pièces et de sous-assemblages distincts ; il ne s’agit pas d’un document au format texte brut et il ne peut pas être converti correctement en renommant simplement l’extension ou en l’envoyant à un convertisseur texte-vers-PDF.

Qu’est-ce que le format PDF ?

PDF stocke une représentation visuelle paginée avec les polices, le positionnement, les graphiques et les paramètres d’impression. Il convient aux listings de code, à la documentation technique, aux copies de révision et aux instantanés d’archivage, mais il ne compile pas le code source assembly et ne préserve pas la possibilité de modifier nativement un assemblage CAD, son historique paramétrique ni sa structure complète de composants.

Convertir du code source assembly sous Windows

1. Ouvrez le fichier .asm dans Notepad++, Visual Studio Code ou un autre éditeur de texte. Ne l’ouvrez pas dans un traitement de texte susceptible de remplacer les tabulations ou de modifier les caractères.
2. Sélectionnez le lexer assembly le plus proche si vous souhaitez appliquer une coloration syntaxique. Dans Notepad++, utilisez Language → A → Assembly ; la coloration est visuelle et ne vérifie pas la syntaxe ni n’identifie le dialecte du processeur.
3. Utilisez une police à chasse fixe telle que Consolas ou DejaVu Sans Mono. Définissez l’interligne, les marges, l’orientation et une taille de police qui empêchent les instructions importantes de passer à la ligne.
4. Choisissez File → Print, sélectionnez Microsoft Print to PDF, puis définissez le format du papier, l’orientation, les marges, les numéros de ligne et la coloration syntaxique dans les options d’impression. Enregistrez le PDF obtenu.

Pour un PDF contenant uniquement du code, la commande d’impression d’un éditeur est préférable à la copie du code source dans un traitement de texte, car elle conserve plus fiablement l’indentation et la structure des lignes.

Générer des PDF avec coloration de manière reproductible sur toute plateforme de bureau

Pygments peut créer un rendu HTML qu’un navigateur imprime au format PDF. Installez-le avec :

python -m pip install Pygments

Pour la syntaxe NASM, exécutez :

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

Pour la syntaxe GNU assembler, utilisez -l gas ; sélectionnez un autre lexer Pygments lorsque le dialecte l’exige. Ouvrez program.html dans un navigateur et choisissez Print → Save as PDF. Utilisez une police à chasse fixe, l’orientation paysage, des marges étroites et une échelle adaptée aux lignes longues. Cette opération effectue le rendu du code source ; elle ne l’assemble pas et ne le valide pas.

Convertir un assemblage Solid Edge ou un autre assemblage CAD

1. Ouvrez l’assemblage dans son application CAD native et résolvez les références manquantes aux pièces, sous-assemblages, matériaux et textures avant l’exportation.
2. Utilisez la commande Publish 3D PDF de Solid Edge, si elle est disponible dans la version et la licence installées, puis sélectionnez les vues, propriétés du modèle, PMI et structure d’assemblage requis. Les noms des commandes et la disponibilité du 3D-PDF varient selon la version.
3. Pour obtenir plutôt un document technique statique, créez ou ouvrez un dessin et utilisez File → Export ou Print pour créer un PDF 2D. Cela produit des feuilles de dessin, et non un modèle 3D interactif.
4. Ouvrez le résultat dans une visionneuse PDF de bureau prenant en charge le contenu 3D intégré. De nombreuses visionneuses PDF de navigateur et applications mobiles n’affichent que la page ou omettent les fonctionnalités 3D interactives.

D’autres systèmes CAD peuvent publier directement un 3D PDF ou nécessiter un exportateur ou un traducteur. Un convertisseur en ligne générique ne constitue pas une solution de remplacement fiable, car il peut ignorer les références d’assemblage, supprimer des composants ou ne prendre en charge que les dessins 2D.

Convertisseurs en ligne

CloudConvert et Online-Convert peuvent être utiles pour les conversions de texte brut vers PDF lorsque le service accepte explicitement le fichier téléversé ou une copie temporaire .txt. Vérifiez le type d’entrée, l’encodage, la mise en page et le texte généré avant de partager le résultat. Les services en ligne ne prennent généralement pas en charge les assemblages Solid Edge ni l’exportation de PDF 3D interactifs.

Ne téléversez pas de firmware propriétaire, d’identifiants, de recherches sur les exploits, de code source non publié ou de données CAD confidentielles, sauf si les conditions de conservation et de traitement du service sont acceptables. L’exportation locale depuis un éditeur, un navigateur ou une application CAD native évite cette exposition.

Limites de qualité et de compatibilité

La conversion en PDF ne résout pas les fichiers include, ne développe pas les macros, ne détecte pas les erreurs de l’assembleur, ne préserve pas les paramètres de build et ne reproduit pas la sortie exécutable d’un programme. Ouvrez le code source avec son encodage réel, généralement UTF-8, avant l’impression ; un encodage incorrect peut remplacer les commentaires non ASCII. Vérifiez les lignes longues, les tabulations, les numéros de ligne, les sauts de page, les symboles et les couleurs de syntaxe dans le PDF final.

Conservez le fichier .asm d’origine ainsi que les fichiers de projet ou de composants CAD associés. L’extraction de texte d’un PDF peut modifier les tabulations, les espaces, les fins de ligne et l’ordre de lecture, tandis qu’un PDF 3D peut omettre les fonctionnalités CAD non prises en charge. Pour les copies d’archivage, notez le processeur, l’assembleur et sa version, l’encodage du code source, l’application CAD et sa version le cas échéant, les paramètres d’exportation et la date de conversion.