Python console/pl: Difference between revisions
(Created page with "Skrypty inicjujące FreeCAD automatycznie ładują niektóre moduły i definiują niektóre aliasy. Dlatego też, są one dostępne w konsoli Pythona") |
No edit summary |
||
(18 intermediate revisions by 2 users not shown) | |||
Line 4: | Line 4: | ||
==Wprowadzenie== |
==Wprowadzenie== |
||
{{TOCright}} |
|||
⚫ | |||
⚫ | |||
Można go uwidocznić/ukryć poprzez menu {{MenuCommand|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 [[Preferences_Editor|Edytor preferencji]]. |
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 [[Preferences_Editor|Edytor preferencji]]. |
||
Line 20: | Line 24: | ||
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)'', {{incode|obj.}} |
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)'', {{incode|obj.}} |
||
Konsola jest również w stanie wyświetlić łańcuch dokumentacji konkretnej funkcji, gdy zapisywany jest otwierający nawias, na przykład {{ |
Konsola jest również w stanie wyświetlić łańcuch dokumentacji konkretnej funkcji, gdy zapisywany jest otwierający nawias, na przykład {{incode|function(}} |
||
[[File:FreeCAD_Python_console_example.png|800px]] |
[[File:FreeCAD_Python_console_example.png|800px]] |
||
Line 32: | Line 36: | ||
}} |
}} |
||
W związku z tym są one równe |
|||
Therefore these are equal |
|||
{{Code|code= |
{{Code|code= |
||
Line 39: | Line 43: | ||
}} |
}} |
||
{{Emphasis|Note:}} |
{{Emphasis|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 {{incode|FreeCAD}} i {{incode|FreeCADGui}} i zdefiniowaniu niezbędnych aliasów, jeżeli zachodzi taka potrzeba. |
||
==Działania== |
|||
Kliknij prawym przyciskiem myszy na konsoli Pythona, aby wyświetlić kilka poleceń: |
|||
*{{MenuCommand|Copy}}: Przechowuje zaznaczony tekst w schowku do późniejszego wklejenia. Funkcja jest wyłączona, jeśli nic nie jest zaznaczone. |
|||
*{{MenuCommand|Copy command}}: Przechowuje wybrane polecenie w schowku do późniejszego wklejenia. Funkcja jest wyłączona, jeśli nic nie jest zaznaczone. |
|||
*{{MenuCommand|Historia kopiowania}}: Skopiuj całą historię poleceń Pythona wprowadzonych w tej sesji. |
|||
*{{MenuCommand|Zapisz historię jako}}: Zapisuje całą historię poleceń Pythona wprowadzonych w tej sesji do pliku tekstowego. |
|||
*{{MenuCommand|Wklej}}: Wklej uprzednio skopiowany tekst ze schowka do konsoli Pythona. |
|||
* {{MenuCommand|Zaznacz wszystko}}: Zaznacza cały tekst w konsoli Pythona. |
|||
* {{MenuCommand|Wyczyść konsolę}}: Usuwa wszystkie polecenia wprowadzone do konsoli Pythona. Jest to przydatne, gdy konsola Pythona jest pełna komunikatów i wcześniej wprowadzonych poleceń, które mogą rozpraszać podczas testowania nowej funkcji. Jest to tylko estetyczne, ponieważ polecenie to nie usuwa istniejących zmiennych ani nie usuwa zaimportowanych modułów w sesji. |
|||
*{{MenuCommand|Wstaw nazwę pliku}}: Otwiera okno dialogowe do wyszukiwania pliku w systemie, a następnie wstawia pełną ścieżkę do pliku. Jest to przydatne do testowania funkcji, które przetwarzają plik wejściowy, bez konieczności zapisywania całej nazwy w konsoli, co jest podatne na błędy. To polecenie nie uruchamia pliku i nie importuje go jako modułu Pythona, tylko zwraca pełną ścieżkę do tego pliku. |
|||
* {{MenuCommand|Zawijanie linii}}: zawijaj bardzo długie linie, które przekraczają poziomy wymiar konsoli Pythona. |
|||
==Uwagi== |
|||
* Istnieje możliwość przewijania API w konsoli Pythona. Przykład: |
|||
== Actions == |
|||
*# W konsoli wpisz: {{incode|FreeCAD.}} |
|||
*# Pojawi się okno dialogowe z opcjonalnymi klasami / funkcjami do wyboru, |
|||
*# Przewiń listę, aby przeczytać opis każdej klasy / funkcji |
|||
*# Wybierając funkcję i podążając za nią z {{incode|.}} 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 {{KEY|Ctrl}} + {{KEY|Spacja}} |
|||
Right click on the Python console shows some commands: |
|||
* {{MenuCommand|Copy}}: stores the selected text in the clipboard for later pasting; it is disabled if nothing is selected. |
|||
* {{MenuCommand|Copy command}}: stores the selected command in the clipboard for later pasting; it is disabled if nothing is selected. |
|||
* {{MenuCommand|Copy history}}: copy the entire history of Python commands entered in this session. |
|||
* {{MenuCommand|Save history as}}: save the entire history of Python commands entered in this session to a text file. |
|||
* {{MenuCommand|Paste}}: paste previously copied text in the clipboard to the Python console. |
|||
* {{MenuCommand|Select all}}: selects all text in the Python console. |
|||
* {{MenuCommand|Clear console}}: erases all commands entered into the Python console. This is useful if the Python console is full of messages and previously entered commands that may be distracting when testing a new function. This is merely aesthetic, as this command doesn't delete existing variables nor clears the imported modules in the session. |
|||
* {{MenuCommand|Insert file name}}: opens a dialog to search for a file in the system, then it inserts the full path of the file. This is useful to test functions that process an input file, without having to write the entire name in the console, which is error prone. This command does not run the file, and does not import it as a Python module, it just returns the full path of that file. |
|||
* {{MenuCommand|Word wrap}}: wrap very long lines that exceed the horizontal dimension of the Python console. |
|||
{{Interface}} |
{{Interface navi{{#translation:}}}} |
||
{{Std Base navi{{#translation:}}}} |
|||
{{Userdocnavi}} |
{{Userdocnavi{{#translation:}}}} |
Latest revision as of 17:24, 17 February 2022
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.
Działania
Kliknij prawym przyciskiem myszy na konsoli Pythona, aby wyświetlić kilka poleceń:
- Copy: Przechowuje zaznaczony tekst w schowku do późniejszego wklejenia. Funkcja jest wyłączona, jeśli nic nie jest zaznaczone.
- Copy command: Przechowuje wybrane polecenie w schowku do późniejszego wklejenia. Funkcja jest wyłączona, jeśli nic nie jest zaznaczone.
- Historia kopiowania: Skopiuj całą historię poleceń Pythona wprowadzonych w tej sesji.
- Zapisz historię jako: Zapisuje całą historię poleceń Pythona wprowadzonych w tej sesji do pliku tekstowego.
- Wklej: Wklej uprzednio 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. Jest to przydatne, gdy konsola Pythona jest pełna komunikatów i wcześniej wprowadzonych poleceń, które mogą rozpraszać podczas testowania nowej funkcji. Jest to tylko estetyczne, ponieważ polecenie to nie usuwa istniejących zmiennych ani nie usuwa zaimportowanych modułów w sesji.
- Wstaw nazwę pliku: Otwiera okno dialogowe do wyszukiwania pliku w systemie, a następnie wstawia pełną ścieżkę do pliku. Jest to przydatne do testowania funkcji, które przetwarzają plik wejściowy, bez konieczności zapisywania całej nazwy w konsoli, co jest podatne na błędy. To polecenie nie uruchamia pliku i nie importuje go jako modułu Pythona, tylko zwraca pełną ścieżkę do tego pliku.
- Zawijanie linii: zawijaj bardzo długie linie, które przekraczają poziomy wymiar konsoli Pythona.
Uwagi
- Istnieje możliwość przewijania API w konsoli Pythona. Przykład:
- W konsoli wpisz:
FreeCAD.
- Pojawi się okno dialogowe z opcjonalnymi klasami / funkcjami do wyboru,
- Przewiń listę, aby przeczytać opis każdej klasy / funkcji
- Wybierając funkcję i podążając za nią z
.
można powtórzyć kroki 2 i 3, aby zagłębić się w API.
- W konsoli wpisz:
- Uzupełnianie tabulatorami / słowami jest obsługiwane za pomocą skrótu Ctrl + Spacja
- Edytor ustawień, Dostosowywanie interfejsu użytkownika do własnych potrzeb
- Okno główne: Menu główne, widok 3D, Widok połączony (Widok drzewa, Panel zadań, Edytor właściwości), Widok zaznaczenia, Widok raportu, Konsola Phyton, Pasek statusu, Widok DAG
- Okna pomocnicze: Inspektor sceny, Graf zależności
- Plik: Nowy, Otwórz, Zamknij, Zamknij wszystkie, Zapisz, Zapisz jako, Zapisz jako kopię, Zapisz wszystkie, Przywróć, Importuj, Eksportuj, Scal projekt, Informacje o projekcie, Drukuj, Podgląd wydruku, Eksportuj do PDF, Oststnio otwierane pliki, Zakończ
- Edycja: Cofnij, Ponów, Wytnij, Kopiuj, Wklej, Powiel zaznaczenie, Odświerz, Zaznacz obszar, Wybór elementów ramką zaznaczenia, Zaznacz wszystko, Usuń, Wyślij do konsoli Python, Umiejscowienie, Przemieszczenie, Wyrównanie, Przełącz tryb edycji, Preferencje
- Widok:
- Różności: Utwórz widok, Widok ortogonalny, Widok perspektywy, Pełny ekran, Ramka otaczająca, Symbol osi, Płaszczyzna tnąca, Mapowanie tekstury, Przełącz tryb nawigacji, Wygląd zewnętrzny, Kolor losowy, Środowisko pracy, Pasek stanu
- Widok standardowy: Dopasuj wszystko, Widok dopasowany do wyboru, Izometryczny, Dimetryczny, Trimetryczny, Domyślny, Widok od przodu, Widok od góry, Widok z prawej, Widok od tyłu, Widok od góry, Widok z lewej, Odwróć widok w lewo, Odwróć widok w prawo
- Zamroź obraz: Zapisz widok, Wczytaj widok, Zamroź widok, Wyczyść widoki, Odtwórz widok
- Styl kreślenia: Jak jest, Wierzchołki, Szkielet, Ukryte linie, Bez cieniowania, Cieniowany, Płaska linia
- Stereo: Widok stereo czerwony / cyjan, Widok poczwórny bufor stereo, Widok stereo z przeplotem wierszy, Widok stereo z przeplotem kolumn, Wyłącz widok trójwymiarowy, Ustaw ujęcie widoku
- Przybliżenie: Przybliż widok, Oddal widok, Dostosuj widok do ramki otaczjącej
- Okno dokumentu: Zablokuj widok, Odblokuj widok, Wyświetl na pełnym ekranie
- Widoczność: Przełącz widoczność, Pokaż zaznaczenie, Ukryj zaznaczone, Zaznacz widoczne obiekty, Przełącz widoczność, Wyświetl wszystkie obiekty, Ukryj obiekty, Przełącz wybór, Przełącz widoczność wymiarów, Usuń widoczne wymiary
- Paski narzędzi: Plik, Środowisko pracy, Makrodefinicje, Widok, Struktura
- Panele: Widok raportu, Widok drzewa, Edytor właściwości, Widok zaznaczenia, Widok połączony, Konsola Python, Widok DAG
- Akcje widoku drzewa: Wybór w widoku drzewa, Synchronizuj wybór w widoku drzewa, Synchronizuj umiejscowienie w widoku drzewa, Wybór wstępny w widoku drzewa, Zapisz wybór z widoku drzewa, Jeden dokument w widoku drzewa, Wiele dokumentów w widoku drzewa, Zwiń dokument w widoku drzewa, Przeciąganie w widoku drzewa, Wybór w widoku drzewa
- Przybory: Edytor parametrów, Zrzut ekranu, Wczytaj grafikę, Inspektor sceny, Graf zależności, Narzędzia projektu, Wymiarowanie odległości, Dokument tekstowy, Widok demonstracyjny, Kalkulator jednostek, Dostosuj, Menadżer dodatków
- Makrodefinicje: Rejestruj makropolecenie, Zakończ nagrywania makrodefinicji, Wykonaj makrodefinicję, Ostatnio używane makrodefinicje, Wykonaj makrodefinicję w trakcie edycji, Przełącz na debuger zewnętrzny, Uruchom debugowanie, Zatrzymaj debugowanie, Krok dalej, Wejdź do, Przełącz punkt przerwania
- Pomoc: Pomoc online, Witryna FreeCAD, Dokumentacja użytkowników, Dokumentacja skryptów środowiska Python, Pomoc dla środowiska Python, Forum FreeCAD, Często zadawane pytania, Informacje o FreeCAD, Co to jest
- Struktura i odnośniki: Std: Część, Std: Grupa, Std: Utwórz łącze, Utwórz odnośnik względny, Zastąp odnośnikiem, Odłącz odnośnik, Importuj odnośnik, Importuj wszystkie odnośniki, Wybierz połączone odnośnikami, Przejdź do najgłębiej połączonego obiektu, Wybierz wszystkie łącza
- Jak zacząć
- Instalacja: Pobieranie programu, Windows, Linux, Mac, Dodatkowych komponentów, Docker, AppImage, Ubuntu Snap
- Podstawy: Informacje na temat FreeCAD, Interfejs użytkownika, Profil nawigacji myszką, Metody wyboru, Nazwa obiektu, Edytor ustawień, Środowiska pracy, Struktura dokumentu, Właściwości, Pomóż w rozwoju FreeCAD, Dotacje
- Pomoc: Poradniki, Wideo poradniki
- Środowiska pracy: Strona Startowa, Złożenie, BIM, CAM, Rysunek Roboczy, MES, Inspekcja, Siatka, OpenSCAD, Część, Projekt Części, Punkty, Inżynieria Wsteczna, Robot, Szkicownik, Arkusz Kalkulacyjny, Powierzchnia 3D, Rysunek Techniczny, Test Framework