Zaawansowane skrypty Marionette

Jeśli jesteś zaawansowanym użytkownikiem narzędzia Marionette, możesz tworzyć własne węzły i używać ich w swoich projektach lub udostępniać innym użytkownikom. Aby uzyskać więcej informacji na temat tworzenia węzłów Marionette, zajrzyj na główną stronę Developer wiki: developer.vectorworks.net.

Bardziej zaawansowani programiści mogą korzystać z różnych bibliotek Pythona. Podczas programowania możesz testować różne pakiety bibliotek Pythona, aby wybrać najlepszy dla Twojego skryptu. Lista dostępnych pakietów znajduje się na stronie Developer wiki (aby uzyskać do niej szybki dostęp, kliknij łącze Repozytorium biblioteki Pythona w sekcji Zasoby pomocnicze w oknie dialogowym „Ustawienia Marionette”). Z tamtego miejsca możesz ponadto wnioskować o dodanie do repozytorium określonych pakietów.

W swoich węzłach Marionette możesz odwoływać się do pakietów biblioteki Pythona znajdujących się na stronie Vectorworks dla programistów. Odpowiedni pakiet dostosowany do podanej platformy i wersji jest pobierany automatycznie w momencie wykonywania Twojego skryptu przez jego użytkowników.

Tworzenie odwołania do biblioteki Pythona

Aby w Twoim niestandardowym węźle Marionette utworzyć odwołanie do pakietu biblioteki Pythona, użyj w kreatorze Marionette.Node następującej składni, która określi wersję i powiązania z pakietem dla danego węzła:

this.CustomNode("CustomNodeName", "OptionalLocalizedName", "OptionalNodeVersionNumber", [('Geopy', '2.2.0'), ('scipy', '1.7.3')])

Część przykładowej składni zapisana w nawiasach pokazuje, w jaki sposób zdefiniować dwa różne pakiety Pythona, na których opiera się działanie danego węzła, oraz opcjonalnie numer wersji dla każdego z pakietów.

Jeśli wymaganej biblioteki Pythona nie ma na serwerze Vectorworks, przejdź na stronę Developer wiki wymienioną powyżej, aby wysłać wiadomość e-mail do firmy Vectorworks z prośbą o dodanie potrzebnego pakietu. Zespół Vectorworks odpowiedzialny za narzędzie Marionette udostępni wymagany pakiet na serwerze. Ponieważ wszelkie odwołania do bibliotek Pythona występują i są instalowane na życzenie, możesz mieć pewność, że niestandardowy węzeł będzie działa prawidłowo w różnych wydaniach.

Instalacja biblioteki Pythona

Podczas wykonywania skryptu, jeśli pakiet referencyjny biblioteki Pythona został zainstalowany, dany skrypt zostanie wykonany.

Jeśli pakiet biblioteki Pythona nie został jeszcze zainstalowany, użytkownik skryptu będzie miał możliwość zainstalować pakiet automatycznie z serwera Vectorworks.

Aby zainstalować wymagane pliki biblioteki Pythona, wykonaj następujące kroki:

Jeśli narzędzie Marionette wykryje brakujący plik biblioteki dostępny do zainstalowania z serwerów Vectorworks, na ekranie wyświetli się okno dialogowe „Zainstaluj pakiety Pythona”.

Wymagane pakiety są wyszczególnione na liście, wraz z informacjami na ich temat. Kliknij Tak, aby zainstalować pakiety w osobnym folderze PythonExternals mieszczącym się w folderze użytkownika. Jeśli taki folder jeszcze nie istnieje, zostanie on automatycznie utworzony.

Gdy instalacja dobiegnie końca, na ekranie wyświetli się kolejne okno dialogowe – „Szczegóły instalacji”. Kliknij przycisk Szczegóły, aby wyświetlić plik tekstowy zawierający raport z instalacji, z którego dowiesz się: które pakiety zostały zainstalowane, w jakiej lokalizacji i czy ich instalacja powiodła się.

Gdy wymagane pakiety biblioteki Pythona zostaną pomyślnie zainstalowane, skrypt zostanie wykonany.

Ręczna instalacja biblioteki Pythona

Tryb	Narzędzie	Zestaw narzędzi
Ustawienia	Marionette	Narzędzia podstawowe

Podczas programowania możesz ręcznie zainstalować niektóre pakiety biblioteki Pythona, aby przetestować różne rozwiązania i wybrać najlepsze dla Twojego skryptu.

Aby zainstalować bibliotekę Pythona, wykonaj następujące kroki:

Włącz narzędzie i zaznacz właściwy tryb.

Na ekranie wyświetli się okno dialogowe „Ustawienia Marionette”.

Kliknij łącze Repozytorium biblioteki Pythona w sekcji Zasoby pomocnicze, aby sprawdzić, które biblioteki Pythona są dostępne na serwerze Vectorworks.

Kliknij przycisk Zainstaluj bibliotekę Pythona.

Na ekranie wyświetli się okno dialogowe „Lokalizacja biblioteki Pythona”.

Wpisz adres URL pliku biblioteki Pythona, aby zainstalować plik biblioteki znajdujący się we wskazanej lokalizacji.

Przetestuj skrypt. Jeśli stwierdzisz, że dany plik biblioteki jest przydatny i potrzebujesz go w swoim niestandardowym węźle Marionette, poproś o przesłanie go na serwer Vectorworks. W tym celu wejdź na stronę Developer wiki i wyślij do firmy Vectorworks e-mail z prośbą o dodanie pliku.

Listę zainstalowanych plików i pakietów biblioteki Pythona znajdziesz w pliku InstallOutput.txt, który mieści się w folderze PythonExternals w folderze użytkownika.

Debugowanie skryptu Marionette

Marionette