Konwertuj ASM na PDF

Kopia PDF pozwala recenzentom drukować lub archiwizować kod źródłowy w języku asemblera bez konieczności posiadania asemblera, a odbiorcom CAD umożliwia przeglądanie złożenia, gdy nie mają aplikacji użytej do jego utworzenia. Właściwa procedura zależy od tego, czy plik .asm zawiera kod źródłowy procesora, czy złożenie CAD.

Czym jest format ASM

.asm jest niejednoznacznym rozszerzeniem. W projektach programistycznych zwykle oznacza tekstowy kod źródłowy w języku asemblera dla procesorów takich jak x86, ARM, MIPS, 8051 lub 6502. MASM, NASM, GNU assembler, Keil, MPLAB oraz środowiska IDE systemów wbudowanych mogą tworzyć takie pliki. Mogą one zawierać instrukcje, etykiety, dyrektywy, makra, komentarze i instrukcje include.

W mechanicznym CAD plik .asm może oznaczać dokument złożenia, zwłaszcza w Solid Edge. Złożenie CAD zwykle odwołuje się do osobnych plików części i podzłożeń; nie jest dokumentem tekstowym i nie można go poprawnie przekonwertować przez samo przemianowanie rozszerzenia lub przesłanie go do konwertera tekstu na PDF.

Czym jest format PDF

PDF przechowuje stronicowaną wizualną reprezentację z czcionkami, pozycjonowaniem, grafiką i ustawieniami drukowania. Nadaje się do wykazów kodu, dokumentacji technicznej, kopii do recenzji i migawek archiwalnych, ale nie kompiluje kodu źródłowego asemblera ani nie zachowuje natywnej możliwości edycji złożenia CAD, jego historii parametrycznej ani pełnej struktury komponentów.

Konwertowanie kodu źródłowego asemblera w systemie Windows

1. Otwórz plik .asm w Notepad++, Visual Studio Code lub innym edytorze tekstu. Nie otwieraj go w edytorze tekstu sformatowanego, który może zastąpić tabulatory lub zmienić znaki.
2. Wybierz odpowiedni lexer języka asemblera, jeśli potrzebne jest kolorowanie składni. W Notepad++ użyj Language → A → Assembly; kolorowanie ma charakter wizualny i nie sprawdza składni ani nie identyfikuje dialektu procesora.
3. Użyj czcionki o stałej szerokości, takiej jak Consolas lub DejaVu Sans Mono. Ustaw odstępy między wierszami, marginesy, orientację i rozmiar czcionki tak, aby ważne instrukcje nie były zawijane.
4. Wybierz File → Print, zaznacz Microsoft Print to PDF i ustaw rozmiar papieru, orientację, marginesy, numery wierszy oraz wyróżnianie składni w opcjach drukowania. Zapisz wynikowy plik PDF.

W przypadku pliku PDF zawierającego wyłącznie kod lepiej użyć polecenia drukowania w edytorze niż kopiować kod źródłowy do edytora tekstu sformatowanego, ponieważ rozwiązanie to bardziej niezawodnie zachowuje wcięcia i strukturę wierszy.

Tworzenie powtarzalnych plików PDF z wyróżnioną składnią na dowolnej platformie desktopowej

Pygments może utworzyć renderowanie HTML, które przeglądarka wydrukuje do PDF. Zainstaluj go za pomocą:

python -m pip install Pygments

W przypadku składni NASM uruchom:

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

W przypadku składni GNU assembler użyj -l gas; gdy dialekt tego wymaga, wybierz inny lexer Pygments. Otwórz plik program.html w przeglądarce i wybierz Print → Save as PDF. Użyj czcionki o stałej szerokości, orientacji poziomej, wąskich marginesów i odpowiedniego skalowania dla długich wierszy. Ta metoda renderuje kod źródłowy; nie składa go ani nie sprawdza poprawności.

Konwertowanie złożenia Solid Edge lub innego złożenia CAD

1. Otwórz złożenie w natywnej aplikacji CAD i przed eksportem rozwiąż problemy z brakującymi odwołaniami do części, podzłożeń, materiałów i tekstur.
2. Użyj polecenia Publish 3D PDF w Solid Edge, jeśli jest dostępne w zainstalowanej wersji i licencji, a następnie wybierz wymagane widoki, właściwości modelu, PMI i strukturę złożenia. Nazwy poleceń oraz dostępność funkcji 3D PDF różnią się w zależności od wersji.
3. Jeśli zamiast tego potrzebujesz płaskiego dokumentu technicznego, utwórz lub otwórz rysunek i użyj polecenia File → Export lub Print, aby utworzyć 2D PDF. Powstaną arkusze rysunkowe, a nie interaktywny model 3D.
4. Otwórz wynik w desktopowej przeglądarce PDF obsługującej osadzoną zawartość 3D. Wiele przeglądarek PDF działających w przeglądarce internetowej i aplikacji mobilnych wyświetla tylko stronę albo pomija interaktywne funkcje 3D.

Inne systemy CAD mogą publikować 3D PDF bezpośrednio albo wymagać eksportera lub translatora. Ogólny konwerter online nie jest niezawodnym zamiennikiem, ponieważ może ignorować odwołania złożenia, ukrywać komponenty lub obsługiwać wyłącznie rysunki 2D.

Konwertery online

CloudConvert i Online-Convert mogą być przydatne przy konwertowaniu zwykłego tekstu do PDF, gdy usługa wyraźnie akceptuje przesłany plik lub tymczasową kopię .txt. Przed udostępnieniem wyniku sprawdź typ danych wejściowych, kodowanie, układ strony i wygenerowany tekst. Usługi online zazwyczaj nie obsługują złożeń Solid Edge ani interaktywnego eksportu 3D PDF.

Nie przesyłaj zastrzeżonego oprogramowania sprzętowego, danych uwierzytelniających, badań nad exploitami, nieopublikowanego kodu źródłowego ani poufnych danych CAD, chyba że warunki przechowywania i przetwarzania danych przez usługę są akceptowalne. Lokalny eksport z edytora, przeglądarki lub natywnej aplikacji CAD pozwala uniknąć takiego ujawnienia.

Ograniczenia jakości i zgodności

Konwersja do PDF nie rozwiązuje plików include, nie rozwija makr, nie wykrywa błędów asemblera, nie zachowuje ustawień kompilacji ani nie odtwarza wynikowego pliku wykonywalnego programu. Przed drukowaniem otwórz kod źródłowy przy użyciu jego rzeczywistego kodowania, zazwyczaj UTF-8; nieprawidłowe kodowanie może zastąpić komentarze zawierające znaki spoza ASCII. Sprawdź długie wiersze, tabulatory, numery wierszy, podziały stron, symbole i kolory składni w końcowym pliku PDF.

Zachowaj oryginalny plik .asm oraz powiązane z nim pliki projektu lub komponentów CAD. Wyodrębnianie tekstu z PDF może zmienić tabulatory, białe znaki, zakończenia wierszy i kolejność odczytu, a 3D PDF może pomijać nieobsługiwane funkcje CAD. W przypadku kopii archiwalnych zapisz informacje o procesorze, asemblerze i jego wersji, kodowaniu źródła, aplikacji CAD i jej wersji, jeśli ma to zastosowanie, ustawieniach eksportu oraz dacie konwersji.