Donate

Wprowadzenie

Konsola Python jest panelem, który jest częścią interfejs użytkownika FreeCAD. Może być używany do sterowania procesami FreeCAD oraz tworzenia i modyfikowania obiektów i ich właściwości.

Można go uwidocznić/ukryć poprzez menu Widok → Panele → Konsola Python.

Konsola Pythona w FreeCAD obsługuje podstawowe kolorowanie składni, potrafi rozróżnić różne style i kolory, komentarze, łańcuchy, wartości liczbowe, wbudowane funkcje, wydrukowany tekst wyjściowy i separatory, takie jak nawiasy i przecinki. Te właściwości konsoli można skonfigurować w Edytor preferencji.

Konsola Pythona pokazująca komunikaty, gdy FreeCAD właśnie się uruchamia.

Tworzenie skryptów

Dla absolutnie początkujących, zobacz: Wprowadzenie do Pythona, oraz Samouczek tworzenia skryptów Python.

Zobacz również: Podstawy tworzenia skryptów FreeCAD, oraz Obiekty skryptowe.

Konsola Pythona potrafi wykonać uzupełnienie podstawowego kodu. Gdy po obiekcie zostanie zapisana kropka, pokaże na przykład publiczne metody i atrybuty (zmienne) bieżącego obiektu (klasy), obj.

Konsola jest również w stanie wyświetlić łańcuch dokumentacji konkretnej funkcji, gdy zapisywany jest otwierający nawias, na przykład function(

Przykładowy kod Pythona, który generuje obiekty w oknie widoku 3D.

Skrypty inicjujące FreeCAD automatycznie ładują niektóre moduły i definiują niektóre aliasy. Dlatego też, są one dostępne w konsoli Pythona

App = FreeCAD
Gui = FreeCADGui

W związku z tym są one równe

App.newDocument()
FreeCAD.newDocument()

Note: Te wstępnie załadowane moduły i aliasy są dostępne tylko z konsoli Pythona wbudowanej w program FreeCAD. Jeśli używasz FreeCAD jako biblioteki w zewnętrznym programie, musisz pamiętać o załadowaniu modułów FreeCAD i FreeCADGui i zdefiniowaniu niezbędnych aliasów, jeżeli zachodzi taka potrzeba.

Menu kontekstowe

Kliknięcie prawym przyciskiem myszy w Konsoli Pythona otwiera menu kontekstowe z następującymi poleceniami:

• Kopiuj: zapisuje zaznaczony tekst w schowku do późniejszego wklejenia; jest wyłączone, jeśli nic nie zostało zaznaczone.
• Kopiuj polecenie: zapisuje zaznaczone polecenie w schowku do późniejszego wklejenia; jest wyłączone, jeśli nic nie zostało zaznaczone.
• Kopiuj historię: kopiuje całą historię poleceń Pythona wprowadzonych w tej sesji.
• Zapisz historię jako...: zapisuje całą historię poleceń Pythona wprowadzonych w tej sesji do pliku tekstowego.
• Zapisz historię: do ustalenia.
• Wklej: wkleja wcześniej skopiowany tekst ze schowka do Konsoli Pythona.
• Zaznacz wszystko: zaznacza cały tekst w Konsoli Pythona.
• Wyczyść konsolę: usuwa wszystkie polecenia wprowadzone do Konsoli Pythona. Przydatne, gdy konsola jest pełna komunikatów i wcześniej wpisanych poleceń, które mogą rozpraszać podczas testowania nowej funkcji. Ma to wyłącznie efekt estetyczny, ponieważ to polecenie nie usuwa istniejących zmiennych ani nie czyści zaimportowanych modułów w sesji.
• Wstaw nazwę pliku...: otwiera okno dialogowe umożliwiające wyszukanie pliku w systemie, a następnie wstawia pełną ścieżkę tego pliku. Jest to przydatne do testowania funkcji przetwarzających plik wejściowy, bez konieczności ręcznego wpisywania całej nazwy w konsoli, co sprzyja błędom. To polecenie nie uruchamia pliku ani nie importuje go jako modułu Pythona, zwraca jedynie pełną ścieżkę do tego pliku.
• Zawijanie linii: zawija bardzo długie linie, które przekraczają szerokość Konsoli Pythona.

Uwagi

• Istnieje możliwość przewijania API w konsoli Pythona. Przykład:
  1. W konsoli wpisz: FreeCAD.
  2. Pojawi się okno dialogowe z opcjonalnymi klasami / funkcjami do wyboru,
  3. Przewiń listę, aby przeczytać opis każdej klasy / funkcji
  4. Wybierając funkcję i podążając za nią z . można powtórzyć kroki 2 i 3, aby zagłębić się w API.
• Uzupełnianie tabulatorami / słowami jest obsługiwane za pomocą skrótu Ctrl + Spacja