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ę. |
|
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ę). |
|
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. |
|
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”.
