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.

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

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ąć.
Nowy	Utwórz nowy parametr wtyczki. Zostanie wyświetlone okno dialogowe „Parametr”. 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”. Utwórz listę z opcjami wyboru. Każdą opcję umieść w osobnym wierszu. Aby edytować opcje wyboru, kliknij przycisk Dane.
Edytuj	Edytuj parametry wybranej wtyczki. Możliwa jest również edycja parametrów określonych wtyczek zewnętrznych i wbudowanych.
Usuń	Usuń wybraną wtyczkę.
Zakładka Teksty	Wprowadź ciągi znaków używanych przez wtyczkę.
Lista tekstów	Tu znajdują się teksty używane przez wtyczkę (np. wskazówka lub ostrzeżenie).
Dodaj	Dodaj tekst do definicji wtyczki. Zostanie wyświetlone okno dialogowe „Kategoria”. Zostanie automatycznie przypisany kolejny dostępny numer ID. Wprowadź nazwę kategorii.
Edytuj	Edytuj zaznaczony ciąg znaków. Zostanie otwarte okno dialogowe „Kategoria”. Zaznacz pojedynczy ciąg znaków i kliknij Edytuj, aby otworzyć okno dialogowe „Tekst”. Dostosuj tekst. Wartość zależna jest od kategorii. Więcej informacji (w języku angielskim) znajdziesz na stronie: developer.vectorworks.net.
Usuń	Usuń wybraną wtyczkę.
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 2017, 2018 i 2019 należy wprowadzić odpowiednio 22, 23 i 24.
Zmieniona w wersji	Wprowadź numer wersji Vectorworks, w której wtyczka została ostatnio zmieniona. Przykładowo dla wersji Vectorworks 2017, 2018 i 2019 należy wprowadzić odpowiednio 22, 23 i 24.
Nieobsługiwana od wersji	Wprowadź numer wersji Vectorworks, od której wtyczka nie jest już obsługiwana. Przykładowo dla wersji Vectorworks 2017, 2018 i 2019 należy wprowadzić odpowiednio 22, 23 i 24.
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 Edytuj 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 aktywowany Rzut 2D/Główny. 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 2017, 2018 i 2019 należy wprowadzić odpowiednio 22, 23 i 24.
Zmieniona w wersji	Wprowadź numer wersji Vectorworks, w której wtyczka została ostatnio zmieniona. Przykładowo dla wersji Vectorworks 2017, 2018 i 2019 należy wprowadzić odpowiednio 22, 23 i 24.
Nieobsługiwana od wersji	Wprowadź numer wersji Vectorworks, od której wtyczka nie jest już obsługiwana. Przykładowo dla wersji Vectorworks 2017, 2018 i 2019 należy wprowadzić odpowiednio 22, 23 i 24.
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 Edytuj 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 aktywowany Rzut 2D/Główny. 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ź oznaczenie wersji Vectorworks, w której utworzono wtyczkę. Przykładowo dla wersji Vectorworks 2017, 2018 i 2019 należy wprowadzić odpowiednio 22, 23 i 24.
Zmieniona w wersji	Wprowadź numer wersji Vectorworks, w której wtyczka została ostatnio zmieniona. Przykładowo dla wersji Vectorworks 2017, 2018 i 2019 należy wprowadzić odpowiednio 22, 23 i 24.
Nieobsługiwana od wersji	Wprowadź numer wersji Vectorworks, od której wtyczka nie jest już obsługiwana. Przykładowo dla wersji Vectorworks 2017, 2018 i 2019 należy wprowadzić odpowiednio 22, 23 i 24.
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).
Opcje (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 www.vectorworks.net.
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.

3. Po zdefiniowaniu parametrów wtyczki kliknij OK, aby powrócić do okna Zarządzaj wtyczkami.