Definicja wtyczki

Parametry określające wygląd wtyczki dla danego narzędzia, polecenia lub obiektu zapisywane są w rekordzie z parametrami, skojarzonym ze wszystkimi obiektami wprowadzonymi wraz z wtyczką do pliku. W tych rekordach przechowywane są dane i domyślne parametry. Polecenie otwierające okno dialogowe zapisuje na przykład dane wprowadzone przez użytkownika w celu ich późniejszego użycia. Narzędzie powinno mieć kilka trybów. W przypadku gdy użytkownik zaznaczy inny tryb dla danego narzędzia, nowe ustawienia można zapisać i w późniejszym czasie zastosować je ponownie. Ustawienia te można zapisać jako profil polecenia lub narzędzia i wywołać, gdy będą ponownie potrzebne. W przypadku przełączania między plikami, w nowych plikach zostaną wyświetlone zapisane wartości lub - w przypadku braku rekordu z parametrami - zostaną wyświetlone wartości domyślne.

Parametry te można edytować w palecie Info obiektu. Rekord z parametrami tworzony jest każdorazowo przy pierwszym wstawieniu obiektu (lub narzędzia) do pliku. W rekordzie tym zapisywane są domyślne ustawienia obiektu w kombinacji z danym plikiem. Są one następnie stosowane do każdego kolejnego wstawianego obiektu.

Aby zdefiniować niestandardową wtyczkę:

W oknie dialogowym „Zarządzaj wtyczkami”, kliknij zakładkę Wtyczki niestandardowe. Zaznacz wtyczkę, którą chcesz zdefiniować lub edytować.

Kliknij przycisk Edytuj definicję.

Zostanie otwarte okno dialogowe „Edytuj definicję wtyczki”.

Kliknij, aby pokazać/ukryć parametry.Kliknij, aby pokazać/ukryć parametry.

Parametr

Opis

Zakładka Ogólne

 

Typ

Tu wyświetlony jest typ wtyczki (polecenie, narzędzie, obiekt lub procedura).

Język

Tu wyświetlany jest język skryptu wtyczki (zob. Pisanie skryptów do wtyczek).

Nazwa

Wprowadź nazwę nowej wtyczki. Plik wtyczki otrzyma tę samą nazwę co wtyczka, wraz z odpowiednim rozszerzeniem (.px.vsm, .vst lub .vso). W przypadku zmiany nazwy wtyczki należy następnie odpowiednio dostosować środowisko robocze.

Kategoria

Przypisz wtyczkę do kategorii, aby móc ją szybko odszukać podczas edycji środowiska roboczego.

Zakładka Parametry

Zdefiniuj domyślne parametry wtyczki. Domyślne parametry aktywowane są wraz z użyciem wtyczki. Parametry wyświetlane są w określonej kolejności. Możesz zmienić tę kolejność, przeciągając je w kolumnie #.

Lista parametrów

Tu znajdziesz listę domyślnych parametrów obiektu, ewentualnie alternatywną (zlokalizowaną) nazwę, typ parametru i wartość domyślną. Dla obiektów liniowych wyświetlany jest parametr LineLength, który opisuje długość osi obiektu liniowego. Dla obiektów prostokątnych wyświetlane są zarówno parametry LineLenght (początkowa długość obiektu), jak i BoxWidth (pierwotna szerokość obiektu). Możesz zmienić domyślne wartości tych parametrów, ale nie możesz ich całkowicie usunąć.

Utwórz

Kliknij, aby otworzyć okno dialogowe „Parametr” i utworzyć w nim nowy parametr dla danej wtyczki.

Wprowadź Nazwę parametru i w razie potrzeby jego Nazwę opcjonalną. Zdefiniuj Typ i wprowadź Wartość domyślną.

Aby utworzyć listę rozwijaną zawierająca predefiniowane opcje dla danego parametru, jako Typ wybierz opcję Lista rozwijana. Na ekranie wyświetlone zostanie okno dialogowe „Dane”. Sporządź listę opcji wyboru. Wprowadź każdą z możliwości w osobnym wierszu; nie pozostawiaj pustych wierszy. Aby zmodyfikować opcje wyboru na późniejszym etapie, kliknij przycisk Opcje wyboru.

Edytuj

Kliknij, aby otworzyć okno dialogowe „Parametr” i edytować w nim wybrany parametr wtyczki. Możliwa jest również edycja parametrów określonych wtyczek zewnętrznych i wbudowanych.

Usuń

Usuń wybraną wtyczkę.

Zakładka Teksty

Zdefiniuj ciągi tekstowe używane przez wtyczkę.

Lista kategorii tekstowych

Tutaj wyświetlane są kategorie ciągów znaków używanych przez wtyczkę (np. nazwy parametrów i przycisków w oknie dialogowym lub teksty pomocnicze). Wprowadź ciągi znaków dla każdej kategorii (np. wartości próbnika kolorów, definiujące kolor używany przez wtyczkę).

Dodaj

Kliknij, aby otworzyć okno dialogowe „Kategoria” i dodać w nim do definicji wtyczki kategorię ciągu tekstowego.

Zostanie automatycznie przypisany kolejny dostępny numer ID. Wprowadź nazwę kategorii. Po dodaniu kategorii, zaznacz ją i kliknij przycisk Edytuj, aby dodać do niej ciągi tekstowe.

Edytuj

Kliknij, aby otworzyć okno dialogowe „Kategoria” i edytować w nim aktualnie zaznaczoną kategorię tekstową. Kliknij Dodaj, aby dodać nowy ciąg znaków, lub zaznacz istniejący ciąg znaków i kliknij przycisk Edytuj albo Usuń.

Wartość ciągu tekstowego zależy od kategorii. Więcej informacji (w języku angielskim) znajdziesz na stronie: developer.vectorworks.net.

Usuń

Kliknij, aby usunąć aktualnie zaznaczoną kategorię wraz z zawartymi w niej ciągami znaków.

Zakładka Ustawienia

Ustawienia te umożliwiają takie dostosowanie wtyczki, aby funkcjonowała dokładnie tak jak standardowe polecenia, narzędzia i obiekty Vectorworks. Ustawienia te definiują zachowanie wtyczki w przypadku zmiany statusu pliku (zaznaczenie, widok), jak również tekst podpowiedzi.

Zestaw dostępnych ustawień zależny jest od typu wtyczki. Możliwe jest wyłącznie zdefiniowanie ustawień wtyczek niestandardowych.

Polecenie

 

Dostępność

Określ status dla każdej możliwej konfiguracji na rysunku: Wymagane (konfiguracja wymagana, aby wykonać polecenia), Niedozwolone (polecenie zostanie zdezaktywowane), Ignoruj (konfiguracja pozostanie bez wpływu na wykonanie polecenia).

Informacje w podpowiedzi

Wprowadź tekst podpowiedzi, który będzie wyświetlany po najechaniu kursorem na polecenie (funkcja chwilowo dostępna wyłącznie dla Mac).

Nadpisz pomoc kontekstową

Wprowadź adres URL (rozpoczynający się od http:), aby przekierować użytkownika na stronę internetową z pomocą. Aby zdefiniować ścieżkę względem programu Vectorworks, wprowadź ścieżkę rozpoczynającą się od . / (kropki i ukośnika).

Utworzona w wersji

Wprowadź numer wersji Vectorworks, w której utworzona została wtyczka. Przykładowo dla wersji Vectorworks 2021, 2022 i 2023 należy wprowadzić odpowiednio 26, 27 i 28.

Zmieniona w wersji

Wprowadź numer wersji Vectorworks, w której wtyczka została ostatnio zmieniona. Przykładowo dla wersji Vectorworks 2021, 2022 i 2023 należy wprowadzić odpowiednio 26, 27 i 28.

Nieobsługiwana od wersji

Wprowadź numer wersji Vectorworks, od której wtyczka nie jest już obsługiwana. Przykładowo dla wersji Vectorworks 2021, 2022 i 2023 należy wprowadzić odpowiednio 26, 27 i 28.

Narzędzie

 

Informacje na pasku

Wprowadź tekst informacyjny, który będzie wyświetlany na Pasku trybów. Najczęściej jest to nazwa obiektu i czynność, którą użytkownik musi wykonać.

Ikona

W razie potrzeby możesz zastąpić domyślną ikonę symbolem niestandardowym. Przy pomocy zewnętrznego edytora utwórz ikonę w dwóch wersjach: jedną do użytku w standardowej rozdzielczości, a drugą do użytku w wysokiej rozdzielczości.

Standardowa rozdzielczość: utwórz obraz wyśrodkowany w obszarze o szerokości 26 pikseli i wysokości 20 pikseli. Zapisz piktogram w formacie .png.

Wysoka rozdzielczość: utwórz obraz wyśrodkowany w obszarze o szerokości 52 pikseli i wysokości 40 pikseli. Zapisz piktogram w formacie .png. Nazwij go tak samo jak obraz w standardowej rozdzielczości, ale dodaj na końcu „@2x”. Jeśli na przykład ikona w standardowej rozdzielczości nosi nazwę „ZestawModelowanie3D.png”, ikonę w wysokiej rozdzielczości nazwij w następujący sposób: „ZestawModelowanie3D@2x.png”. W przeciwnym wypadku program nie będzie w stanie zlokalizować ikony.

Kliknij przycisk Importuj ikonę, aby zaimportować ikonę w standardowej rozdzielczości. Jeśli istnieje także ikona w wysokiej rozdzielczości (rozszerzona o „@2x”), program automatycznie zaimportuje obie wersje pliku. Vectorworks automatycznie wyświetli odpowiedni obraz, dostosowany do rozdzielczości Twojego urządzenia.

Rzut

Zdefiniuj widok, który ma być aktywowany w momencie włączenia narzędzia. Jeśli wymagany jest rzut 3D, widok zostanie odpowiednio dostosowany. Jeśli konieczny jest rzut 2D, dla tego narzędzia zostanie aktywowana płaszczyzna warstwy projektowej. Rzut hybrydowy (2D/3D) nie wpływa w żaden sposób na widok.

Wykonaj skrypt

Narzędzia ustawione są domyślnie w taki sposób, że wykonywane są natychmiast po ich kliknięciu. W niektórych przypadkach wykonanie skryptu powinno rozpocząć się po poruszeniu myszą (tak jak np. w przypadku narzędzi interaktywnych).

Nadpisz pomoc kontekstową

Wprowadź adres URL (rozpoczynający się od http:), aby przekierować użytkownika na stronę internetową z pomocą. Aby zdefiniować ścieżkę względem programu Vectorworks, wprowadź ścieżkę rozpoczynającą się od . / (kropki i ukośnika).

Utworzona w wersji

Wprowadź numer wersji Vectorworks, w której utworzona została wtyczka. Przykładowo dla wersji Vectorworks 2021, 2022 i 2023 należy wprowadzić odpowiednio 26, 27 i 28.

Zmieniona w wersji

Wprowadź numer wersji Vectorworks, w której wtyczka została ostatnio zmieniona. Przykładowo dla wersji Vectorworks 2021, 2022 i 2023 należy wprowadzić odpowiednio 26, 27 i 28.

Nieobsługiwana od wersji

Wprowadź numer wersji Vectorworks, od której wtyczka nie jest już obsługiwana. Przykładowo dla wersji Vectorworks 2021, 2022 i 2023 należy wprowadzić odpowiednio 26, 27 i 28.

Informacje w podpowiedzi

Wprowadź tekst podpowiedzi, który będzie wyświetlany po najechaniu kursorem na polecenie (funkcja chwilowo dostępna wyłącznie dla Mac).

Obiekt

 

Ikona

Możesz zastąpić domyślną ikonę symbolem niestandardowym. Utwórz obraz 8-bitowy, wyśrodkowany do szerokości 26 pikseli i wysokości 20 pikseli. Zapisz piktogram w formacie .png i kliknij przycisk Importuj ikonę, aby go zaimportować.

Rzut

Zdefiniuj widok, który ma być aktywowany w momencie włączenia narzędzia. Jeśli wymagany jest rzut 3D, widok zostanie odpowiednio dostosowany. Jeśli konieczny jest rzut 2D, dla tego narzędzia zostanie aktywowana płaszczyzna warstwy projektowej. Rzut hybrydowy (2D/3D) nie wpływa w żaden sposób na widok.

Wykonaj skrypt

Narzędzia ustawione są domyślnie w taki sposób, że wykonywane są natychmiast po ich kliknięciu. W niektórych przypadkach wykonanie skryptu powinno rozpocząć się po poruszeniu myszą (tak jak np. w przypadku narzędzi interaktywnych).

Klasa domyślna

Zdefiniuj klasę, w której ma zostać utworzony obiekt. Jeśli klasa nie istnieje jeszcze w chwili wstawiania obiektu, zostanie ona utworzona automatycznie.

Nadpisz pomoc kontekstową

Wprowadź adres URL (rozpoczynający się od http:), aby przekierować użytkownika na stronę internetową z pomocą. Aby zdefiniować ścieżkę względem programu Vectorworks, wprowadź ścieżkę rozpoczynającą się od . / (kropki i ukośnika).

Utworzona w wersji

Wprowadź numer wersji Vectorworks, w której utworzona została wtyczka. Przykładowo dla wersji Vectorworks 2021, 2022 i 2023 należy wprowadzić odpowiednio 26, 27 i 28.

Zmieniona w wersji

Wprowadź numer wersji Vectorworks, w której wtyczka została ostatnio zmieniona. Przykładowo dla wersji Vectorworks 2021, 2022 i 2023 należy wprowadzić odpowiednio 26, 27 i 28.

Nieobsługiwana od wersji

Wprowadź numer wersji Vectorworks, od której wtyczka nie jest już obsługiwana. Przykładowo dla wersji Vectorworks 2021, 2022 i 2023 należy wprowadzić odpowiednio 26, 27 i 28.

Informacje w podpowiedzi

Wprowadź tekst podpowiedzi, który będzie wyświetlany po najechaniu kursorem na polecenie (funkcja chwilowo dostępna wyłącznie dla Mac).

Subelementy

Zdefiniuj subelementy używane przez wtyczkę.

Lista subelementów

Tutaj wyświetlany jest każdy subelement wraz z alternatywną (lokalną) nazwą, jeśli taka ma zastosowanie.

Utwórz

Kliknij, aby dodać do wtyczki nazwę nowego subelementu. Na ekranie wyświetli się okno dialogowe „Dodaj nazwę subelementu”.

Określ w nim nazwę parametru i alternatywną (lokalną) nazwę, jeśli taka ma zastosowanie.

Edytuj

Kliknij, aby edytować nazwę zaznaczonego subelementu.

Usuń

Kliknij, aby usunąć nazwę zaznaczonego subelementu.

Ustawienia

(dot. tylko niestandardowych obiektów parametrycznych)

 

Opcje wykonywania

Obiekty, takie jak symbole, możesz przypisać do wstępnie zdefiniowanych opcji w celu umieszczenia ich w dokumencie. Za pomocą tych opcji możesz skutecznie zintegrować obiekty ze ścianami lub innymi zaawansowanymi typami obiektów. Wtyczki polecenia i narzędzia nie posiadają opcji wstawienia.

Domyślnie geometria obiektu będzie obliczana ponownie po zmianie parametrów obiektu lub punktów kontrolnych. Przy obliczaniu geometrii obiektu domyślne ustawienia pliku, takie jak czcionka, rozmiar tekstu i kolor linii, zostaną ponownie zastosowane do obiektu. W przypadku zmiany jednego z ustawień po wstawieniu lub ostatniej edycji obiektu, mogą nastąpić zmiany w wyglądzie obiektu.

Przy zmianie parametrów obiektu wywoływany jest skrypt. Również w przypadkach gdy ponowne obliczenia obiektu są konieczne (np. w przypadku wstawienia okien do ściany), skrypt może wywołać ponowne obliczenia po obrocie (Resetuj po obrocie) lub przesunięciu (Resetuj po przesunięciu).

Skrypt wtyczki może posłużyć również jako obsługa zdarzeń (Obsługa zdarzeń). Skrypty będą wtedy reagować na drobne zdarzenia w aplikacji. Przykłady i dokumentację (w języku angielskim) znajdziesz na stronie vectorworks.net, w zakładce Support.

Wstaw w ścianę

Zaznacz żądane opcje dla obiektu. Zob. Tworzenie definicji symbolu.

W przypadku obiektów niewymagających opcji wstawienia, opcje domyślne należy pozostawić bez zmian.

Po zdefiniowaniu wtyczki kliknij OK, aby powrócić do okna „Zarządzaj wtyczkami”.

Pisanie skryptów do wtyczek

Definiowanie wtyczek

Zagadnienie: Wtyczki skryptowe