Instalacja narz\u0119dzi programistycznych<\/h2>\n\n
Chocia\u017c Sweet Home 3D jest przeznaczony dla og\u00f3lnego odbiorcy, tworzenie wtyczek wymaga specjalnych umiej\u0119tno\u015bci i powiniene\u015b wiedzie\u0107, jak programowa\u0107 w Java<\/a> u\u017cywaj\u0105c IDE<\/a>, zanim p\u00f3jdziesz dalej. Ten przewodnik pokazuje, jak zbudowa\u0107 wtyczk\u0119 w Eclipse<\/a>, ale mo\u017cesz u\u017cy\u0107 dowolnego IDE wed\u0142ug w\u0142asnego wyboru lub nie u\u017cywa\u0107 IDE wcale. <\/p>\n\n Najpierw pobierz Eclipse z https:\/\/www.eclipse.org\/<\/a>. Wersja nazwana Eclipse IDE for Java Developers<\/em> jest wystarczaj\u0105ca do tworzenia wtyczek, ale mo\u017cesz pobra\u0107 dowoln\u0105 wersj\u0119 do programowania w Java. Tworzenie wtyczki opiera si\u0119 na niekt\u00f3rych klasach Sweet Home 3D, kt\u00f3re Eclipse musi zna\u0107, aby m\u00f3c zbudowa\u0107 Tw\u00f3j projekt. Naj\u0142atwiejszym sposobem dodania klas Sweet Home 3D do Eclipse jest pobranie wersji JAR Sweet Home 3D dost\u0119pnej pod adresem Teraz, gdy zainstalowa\u0142e\u015b wymagane narz\u0119dzia, zobaczmy jak mo\u017cesz zaprogramowa\u0107 swoj\u0105 pierwsz\u0105 wtyczk\u0119 dla Sweet Home 3D.<\/p>\n\n Najpierw utw\u00f3rz now\u0105 podklas\u0119 com.eteks.sweethome3d.plugin.Plugin wybieraj\u0105c z menu Eclipse pozycj\u0119 File > New > Class<\/em>.<\/p>\n\n W oknie dialogowym New Java Class<\/em> wpisz VolumePlugin jako nazw\u0119 klasy, wprowad\u017a pakiet (tutaj wybrany pakiet to com.eteks.test) i wybierz com.eteks.sweethome3d.plugin.Plugin jako klas\u0119 nadrz\u0119dn\u0105 dla VolumePlugin. Po zako\u0144czeniu kliknij Finish<\/em>. Eclipse utworzy plik nowej klasy z nast\u0119puj\u0105c\u0105 zawarto\u015bci\u0105: <\/p>\n\n Jak mo\u017cesz si\u0119 domy\u015bli\u0107 z komentarza TODO, musisz teraz zmieni\u0107 implementacj\u0119 metody getActions, aby zwraca\u0142a akcj\u0119 wtyczki zdoln\u0105 do obliczenia obj\u0119to\u015bci ruchomych mebli. Zast\u0105p return null; nast\u0119puj\u0105c\u0105 instrukcj\u0105: <\/p>\n\n i wybierz Edition > Quick Fix<\/em> z menu Eclipse, aby utworzy\u0107 brakuj\u0105c\u0105 klas\u0119 VolumeAction, jak pokazano na rysunku 4.<\/p>\n\n W oknie dialogowym New Java Class<\/em>, kt\u00f3re si\u0119 pojawi, zaznacz pole wyboru Enclosing type<\/em>, aby utworzy\u0107 klas\u0119 wewn\u0119trzn\u0105 VolumePlugin i kliknij Finish<\/em>. Spowoduje to utworzenie klasy VolumeAction, kt\u00f3ra dziedziczy po klasie com.eteks.sweethome3d.plugin.PluginAction i zawiera pust\u0105 metod\u0119 execute: <\/p>\n\n Ta metoda zostanie wywo\u0142ana przez Sweet Home 3D, gdy u\u017cytkownik uruchomi akcj\u0119 wtyczki; to w\u0142a\u015bnie tutaj musisz zaimplementowa\u0107 spos\u00f3b obliczania obj\u0119to\u015bci mebli i wy\u015bwietlania jej:<\/p>\n\n Teraz, gdy okre\u015bli\u0142e\u015b, co ma robi\u0107 wtyczka, musisz opisa\u0107, jak u\u017cytkownik b\u0119dzie uruchamia\u0142 t\u0119 now\u0105 akcj\u0119. Masz do wyboru dodanie nowej pozycji menu<\/strong> do menu i\/lub nowego przycisku<\/strong> do paska narz\u0119dzi. Wyboru dokonuje si\u0119 ustawiaj\u0105c odpowiednie w\u0142a\u015bciwo\u015bci akcji wtyczki przy jej tworzeniu. Na przyk\u0142ad, je\u015bli chcesz, aby u\u017cytkownicy uruchamiali akcj\u0119 obliczania obj\u0119to\u015bci za pomoc\u0105 pozycji menu Oblicz obj\u0119to\u015b\u0107<\/em> znajduj\u0105cej si\u0119 w menu Narz\u0119dzia<\/em>, dodasz nast\u0119puj\u0105cy konstruktor do klasy VolumeAction: <\/p>\n\n Klasa wtyczki VolumePlugin<\/a> jest teraz zaprogramowana i prawie gotowa do dzia\u0142ania jako wtyczka w Sweet Home 3D. Pozosta\u0142y dwie ostatnie rzeczy do zrobienia: <\/p>\n\n Plik ApplicationPlugin.properties<\/tt>\n opisuje nazw\u0119 wtyczki, jej klas\u0119, minimalne wersje Sweet Home 3D i Java, pod kt\u00f3rymi jest obs\u0142ugiwana,\n oraz kwestie prawne. Wybierz File > New > File<\/i> z\n menu Eclipse, wprowad\u017a nazw\u0119 pliku ApplicationPlugin.properties<\/tt> i kliknij Finish<\/i>, jak pokazano\n na rysunku 5. <\/p>\n\n Nast\u0119pnie wprowad\u017a nast\u0119puj\u0105cy opis<\/a> w nowym pliku i zapisz go:<\/p>\n\n Plik JAR wtyczki zawiera pliki class<\/tt> utworzone z kompilacji pliku VolumePlugin.java<\/tt>,\n oraz plik ApplicationPlugin.properties<\/tt>. Poniewa\u017c Eclipse kompiluje plik Java zaraz po jego zapisaniu,\n wystarczy wybra\u0107 File > Export…<\/i> z menu i wybra\u0107 Java > JAR file<\/i> w oknie dialogowym Export<\/i>,\n kt\u00f3re zostanie wy\u015bwietlone. W kreatorze Jar Export<\/i>, kt\u00f3ry pojawi si\u0119 jak pokazano na rysunku 6, zaznacz pole wyboru projektu\n i wprowad\u017a \u015bcie\u017ck\u0119 do pliku JAR umieszczonego w folderze wtyczek Sweet Home 3D. Odpowiedni folder zale\u017cy\n od Twojego systemu w nast\u0119puj\u0105cy spos\u00f3b: <\/p>\n\n Wtyczka<\/a>, kt\u00f3r\u0105 stworzy\u0142e\u015b, b\u0119dzie dzia\u0142a\u0107 w Sweet Home 3D, zar\u00f3wno w wersji Java Web Start<\/a>, wersji instalacyjnej<\/a>, jak i w SweetHome3D-7.5.jar<\/a>, kt\u00f3ry pobra\u0142e\u015b wcze\u015bniej. Poniewa\u017c ten ostatni jest wykonywalnym plikiem JAR, mo\u017cesz go uruchomi\u0107 przez podw\u00f3jne klikni\u0119cie lub za pomoc\u0105 nast\u0119puj\u0105cego polecenia: <\/p>\n\n Wtyczka<\/a>, kt\u00f3r\u0105 stworzy\u0142e\u015b, b\u0119dzie dzia\u0142a\u0107 w Sweet Home 3D, zar\u00f3wno w wersji Java Web Start<\/a>, wersji instalacyjnej<\/a>, jak i w SweetHome3D-7.5.jar<\/a>, kt\u00f3ry pobra\u0142e\u015b wcze\u015bniej. Poniewa\u017c ten ostatni jest wykonywalnym plikiem JAR, mo\u017cesz go uruchomi\u0107 przez podw\u00f3jne klikni\u0119cie lub za pomoc\u0105 nast\u0119puj\u0105cego polecenia: <\/p>\n\n Dop\u00f3ki testujesz, prawdopodobnie b\u0119dziesz wola\u0142 uruchamia\u0107 Sweet Home 3D za pomoc\u0105 tego polecenia, aby m\u00f3c odczyta\u0107 w konsoli \u015blad stosu wyj\u0105tk\u00f3w rzucanych podczas wykonywania Twojej wtyczki.<\/p>\n\n Po uruchomieniu Sweet Home 3D zobaczysz nowe menu i jego pozycj\u0119, jak pokazano na rysunku 7:<\/p>\n\n Je\u015bli wybierzesz now\u0105 pozycj\u0119 menu dla przyk\u0142adowego domu<\/a> utworzonego w przewodniku u\u017cytkownika<\/a>, otrzymasz nast\u0119puj\u0105cy wynik:<\/p>\n\n Je\u015bli potrzebujesz debugowa\u0107 swoj\u0105 wtyczk\u0119 z Eclipse, utw\u00f3rz konfiguracj\u0119 debugowania wykonuj\u0105c nast\u0119puj\u0105ce kroki:<\/p>\n\n Za ka\u017cdym razem, gdy modyfikujesz kod \u017ar\u00f3d\u0142owy swojej wtyczki, nie zapomnij wygenerowa\u0107 pliku JAR wtyczki<\/a> przed uruchomieniem utworzonej konfiguracji debugowania. Aby przyspieszy\u0107 proces eksportu JAR w Eclipse, przejd\u017a do drugiego kroku kreatora eksportu JAR i wybierz opcj\u0119 Zapisz opis tego pliku JAR w przestrzeni roboczej<\/em>. Spowoduje to dodanie nowego elementu w projekcie z kontekstowym elementem menu Utw\u00f3rz JAR<\/em>. <\/p>\n<\/div>\n\n Po przygotowaniu, twoja wtyczka mo\u017ce by\u0107 wdro\u017cona na komputerach innych u\u017cytkownik\u00f3w Sweet Home 3D poprzez proste skopiowanie jej do ich folderu wtyczek<\/a>. Od wersji 1.6, plik wtyczki mo\u017ce by\u0107 r\u00f3wnie\u017c zainstalowany w folderze wtyczek Sweet Home 3D poprzez dwukrotne klikni\u0119cie na nim, je\u015bli jego rozszerzenie to SH3P (wystarczy zmieni\u0107 rozszerzenie pliku z .zip na .sh3p). Je\u015bli dwukrotne klikni\u0119cie na pliku .sh3p nie uruchamia Sweet Home 3D (co jest najbardziej prawdopodobne w systemie Linux), mo\u017cesz r\u00f3wnie\u017c zainstalowa\u0107 wtyczk\u0119 za pomoc\u0105 nast\u0119puj\u0105cego polecenia w oknie Terminala<\/em> (gdzie Aby przesta\u0107 u\u017cywa\u0107 wtyczki, usu\u0144 jej plik z folderu wtyczek i uruchom ponownie Sweet Home 3D.<\/p>\n\n Je\u015bli chcesz, aby twoja wtyczka mog\u0142a dzia\u0142a\u0107 ze wszystkimi instalatorami Sweet Home 3D<\/a> dost\u0119pnymi na tej stronie internetowej, zadbaj o to, aby by\u0142a zgodna z Java 5, wybieraj\u0105c Programowanie pierwszej wtyczki pokaza\u0142o ci og\u00f3lny obraz. Oto dodatkowe informacje, kt\u00f3re pomog\u0105 ci p\u00f3j\u015b\u0107 dalej. <\/p>\n\n Najbardziej przydatn\u0105 dokumentacj\u0105 do tworzenia nowej wtyczki jest API Sweet Home 3D<\/a> (Application Programming Interface), wygenerowane za pomoc\u0105 narz\u0119dzia javadoc. Sweet Home 3D opiera si\u0119 na architekturze MVC (Model-Widok-Kontroler), wi\u0119c zrozumienie, jak zorganizowana jest jej warstwa Modelu, jest kluczowe. Rysunek 13 (dost\u0119pny r\u00f3wnie\u017c w formacie PDF<\/a>) przedstawia prawie wszystkie klasy i interfejsy dost\u0119pne w wersji 1.5 pakietu com.eteks.sweethome3d.model<\/a>, kt\u00f3ry odpowiada tej warstwie Modelu. <\/p>\n\n [uml_diagram slug=”model-classes-diagram” map_name=”model-classes-diagram” caption=”Figure 13. UML diagram of com.eteks.sweethome3d.model package” caption_small=”(click on a class to view its javadoc)”]<\/p>\n\n Centraln\u0105 klas\u0105 w warstwie Modelu jest klasa HomeApplication<\/a> (10), abstrakcyjna nadklasa g\u0142\u00f3wnej klasy aplikacji SweetHome3D<\/a>. Instancja tej klasy daje dost\u0119p do aktualnie edytowanych instancji Home<\/a> (7) oraz do obiektu UserPreferences<\/a> (11), kt\u00f3ry przechowuje u\u017cywan\u0105 jednostk\u0119 d\u0142ugo\u015bci<\/a> (12), katalog mebli<\/a> (14) i katalog tekstur<\/a> (15), z kt\u00f3rych u\u017cytkownik wybiera meble<\/a> (17) i tekstury<\/a> (18). Te obiekty implementuj\u0105 interfejs Selectable<\/a> (1), podobnie jak obiekt ObserverCamera<\/a> (4), kt\u00f3ry przechowuje lokalizacj\u0119 kamery w trybie Wirtualnego zwiedzaj\u0105cego<\/em>. Wszystkie zewn\u0119trzne informacje zarz\u0105dzane przez obiekty Modelu, takie jak ikona i model 3D mebla<\/a> (16) lub obraz tekstury<\/a> (20), s\u0105 dost\u0119pne przez interfejs Content<\/a> (19), implementowany przez klas\u0119 URLContent<\/a> i inne klasy pakietu com.eteks.sweethome3d.tools<\/a>. <\/p>\n\n Ten diagram UML powinien pom\u00f3c ci zrozumie\u0107, jakie klasy s\u0105 dost\u0119pne w modelu Sweet Home 3D i jak mo\u017cesz uzyska\u0107 do nich dost\u0119p, ale prawdopodobnie zauwa\u017cysz, \u017ce nie s\u0105 w nim wymienione \u017cadne konstruktory ani mutatory (lub settery, je\u015bli wolisz). To tylko z braku miejsca, ale mo\u017cesz ich bez problemu u\u017cywa\u0107 w klasie wtyczki. Zauwa\u017c te\u017c, \u017ce ka\u017cda modyfikacja istniej\u0105cego obiektu modelu b\u0119dzie zg\u0142aszana do wy\u015bwietlanych komponent\u00f3w albo za pomoc\u0105 PropertyChangeEvent<\/a>\u00f3w, CollectionEvent<\/a>\u00f3w (8) lub SelectionEvent<\/a>\u00f3w (6), co pozwala na natychmiastowe odzwierciedlenie wszystkich zmian na ekranie. <\/p>\n\n Model Sweet Home 3D nie jest<\/strong> bezpieczny dla w\u0105tk\u00f3w ze wzgl\u0119d\u00f3w wydajno\u015bciowych. Wszystkie modyfikacje<\/strong> obiektu nale\u017c\u0105cego do modelu powinny by\u0107 wykonywane w w\u0105tku Event Dispatch Thread. <\/p>\n<\/div>\n\n Architektura klas wtyczek jest znacznie prostsza do zrozumienia ni\u017c architektura warstwy Modelu. Pakiet com.eteks.sweethome3d.plugin<\/a> zawiera tylko trzy klasy, z kt\u00f3rych powiniene\u015b u\u017cywa\u0107 tylko klas Plugin<\/a> i PluginAction<\/a>, jak pokazano na rysunku 14 (dost\u0119pnym r\u00f3wnie\u017c w formacie PDF<\/a>). <\/p>\n\n [uml_diagram slug=”plugin-classes-diagram” map_name=”plugin-classes-diagram” caption=”Figure 14. UML diagram of com.eteks.sweethome3d.plugin package” caption_small=”(click on a class to view its javadoc)”]<\/p>\n\n Instancja PluginManager<\/a> (1) jest tworzona przy uruchomieniu aplikacji i wyszukuje wtyczki zainstalowane w folderze wtyczek<\/a> u\u017cytkownika. Za ka\u017cdym razem, gdy edytowany jest nowy dom, ten mened\u017cer tworzy instancj\u0119 i konfiguruje obiekt Plugin<\/a> (3) dla ka\u017cdej wtyczki znalezionej w momencie uruchomienia. Nast\u0119pnie wywo\u0142uje metod\u0119 getActions<\/a>, aby pobra\u0107 wszystkie akcje<\/a> (4), kt\u00f3re zostan\u0105 dodane jako elementy menu i\/lub przyciski paska narz\u0119dzi w oknie domu. Ka\u017cda akcja jest instancj\u0105 PluginAction<\/a>, kt\u00f3ra przypomina klas\u0119 Action<\/a>, z jej metod\u0105 execute<\/a> i modyfikowalnymi w\u0142a\u015bciwo\u015bciami<\/a> (2). <\/p>\n\n Zauwa\u017c, \u017ce klasa Plugin<\/a> daje ci dost\u0119p do instancji UndoableEditSupport<\/a> poprzez jej metod\u0119 getUndoableEditSupport<\/a>. Gdy tylko zmodyfikujesz dom lub jego obiekty (meble, \u015bciany…) w metodzie execute instancji PluginAction<\/a>, powiniene\u015b r\u00f3wnie\u017c wys\u0142a\u0107 obiekt UndoableEdit<\/a> do obs\u0142ugi edycji cofania zwr\u00f3conej przez metod\u0119 getUndoableEditSupport, w przeciwnym razie u\u017cytkownicy nie b\u0119d\u0105 mogli prawid\u0142owo cofa\u0107\/ponawia\u0107 wprowadzonych przez ciebie zmian. <\/p>\n\n Je\u015bli planujesz opracowa\u0107 wtyczk\u0119 dla spo\u0142eczno\u015bci u\u017cytkownik\u00f3w Sweet Home 3D, postaraj si\u0119 zlokalizowa\u0107 wy\u015bwietlane przez ni\u0105 ci\u0105gi znak\u00f3w, zar\u00f3wno w nazwach akcji i menu, jak i w tworzonych dialogach (lub przynajmniej przygotuj jej lokalizacj\u0119). Dwa konstruktory klasy PluginAction<\/a> pomog\u0105 Ci zorganizowa\u0107 t\u0142umaczenie w\u0142a\u015bciwo\u015bci akcji za pomoc\u0105 plik\u00f3w .properties, a je\u015bli potrzebujesz przet\u0142umaczy\u0107 inne ci\u0105gi znak\u00f3w w swojej wtyczce (jak te w oknie dialogowym pokazanym przez testowan\u0105 wtyczk\u0119<\/a>), wykorzystaj ponownie te pliki .properties z klas\u0105 Java ResourceBundle<\/a>. Je\u015bli chcesz zobaczy\u0107 przyk\u0142ad wykorzystuj\u0105cy t\u0119 architektur\u0119, pobierz wtyczk\u0119 Pobierz i zainstaluj Eclipse<\/h3>\n\n
eclipse.exe<\/code> (w Windows), eclipse.app<\/code> (w Mac OS X) lub eclipse<\/code> (w Linux).![\"\"](\"https:\/\/test.sweethome3d.eu\/wp-content\/uploads\/2025\/12\/eclipse.png\")
Pobierz i zainstaluj bibliotek\u0119 Sweet Home 3D<\/h3>\n\n
![\"\"](\"https:\/\/test.sweethome3d.eu\/wp-content\/uploads\/2025\/12\/addToBuildPath.png\")
Programowanie wtyczki<\/h2>\n\n
Tworzenie klasy wtyczki<\/h3>\n\n
![\"\"](\"https:\/\/test.sweethome3d.eu\/wp-content\/uploads\/2025\/12\/newJavaClass.png\")
package com.eteks.test;
return new PluginAction<\/strong> [] {new VolumeAction<\/strong>()}; <\/pre>\n\n![\"\"](\"https:\/\/test.sweethome3d.eu\/wp-content\/uploads\/2025\/12\/quickFix.png\")
public class VolumeAction<\/strong> extends PluginAction<\/strong> { public class VolumeAction<\/strong> extends PluginAction<\/strong> { public VolumeAction<\/strong>() {\n
Tworzenie pliku opisu wtyczki<\/h3>\n\n
![\"\"](\"https:\/\/test.sweethome3d.eu\/wp-content\/uploads\/2025\/12\/newFile.png\")
name<\/strong>=Obj\u0119to\u015b\u0107 ruchomych mebli
Tworzenie pliku JAR wtyczki<\/h3>\n\n
\n
![\"\"](\"https:\/\/test.sweethome3d.eu\/wp-content\/uploads\/2025\/12\/jarExport.png\")
Testowanie wtyczki<\/h3>\n\n
java -jar \/\u015bcie\u017cka<\/em>\/do<\/em>\/SweetHome3D-7.5.jar<\/pre>\n\n
![\"\"](\"https:\/\/test.sweethome3d.eu\/wp-content\/uploads\/2025\/12\/pluginMenu.png\")
![\"\"](\"https:\/\/test.sweethome3d.eu\/wp-content\/uploads\/2025\/12\/pluginInAction.png\")
Debugowanie wtyczki<\/h3>\n\n
\n
![\"\"](\"https:\/\/test.sweethome3d.eu\/wp-content\/uploads\/2025\/12\/debugConfiguration.png\")
\n
![\"\"](\"https:\/\/test.sweethome3d.eu\/wp-content\/uploads\/2025\/12\/classpathConfiguration.png\")
\n
![\"\"](\"https:\/\/test.sweethome3d.eu\/wp-content\/uploads\/2025\/12\/sourcepathConfiguration.png\")
\n
![\"\"](\"https:\/\/test.sweethome3d.eu\/wp-content\/uploads\/2025\/12\/eclipseDebug.png\")
![\"\"](\"https:\/\/test.sweethome3d.eu\/wp-content\/uploads\/2025\/09\/warning-1.gif\")
<\/figure>\n\n\n\nWdra\u017canie wtyczki<\/h3>\n\n
SweetHome3D<\/code> to nazwa pliku wykonywalnego dostarczonego z instalatorami Sweet Home 3D):<\/p>\n\n\/\u015bcie\u017cka\/do\/<\/em>SweetHome3D \/\u015bcie\u017cka\/do\/<\/em>wtyczka.sh3p<\/pre>\n\n
<\/figure>\n\n\n\n1.5<\/code> w polu Poziom zgodno\u015bci kompilatora<\/em> dost\u0119pnym w sekcji Kompilator Java<\/em> okna dialogowego wy\u015bwietlanego po wybraniu opcji menu Projekt > W\u0142a\u015bciwo\u015bci<\/em> w Eclipse.javaMinimumVersion<\/code> w pliku ApplicationPlugin.properties<\/code> twojej wtyczki odpowiednio.<\/p>\n<\/div>\n\nId\u0105c dalej<\/h2>\n\n
API Sweet Home 3D – Javadoc<\/h3>\n\n
Architektura klas modelu<\/h3>\n\n
\n
![\"\"](\"https:\/\/test.sweethome3d.eu\/wp-content\/uploads\/2025\/11\/Frame-281.png\")
<\/figure>\n\n\n\nArchitektura klas wtyczek<\/h3>\n\n
Lokalizacja<\/h3>\n\n
![formacie PDF<\/a>) przedstawia prawie wszystkie klasy i interfejsy dost\u0119pne w wersji 1.5 pakietu](\"https:\/\/test.sweethome3d.eu\/wp-content\/uploads\/2025\/12\/modelClassesDiagram.png\"){kind=link}
![formacie PDF<\/a>). <\/p>\n\n[uml_diagram slug=”plugin-classes-diagram” map_name=”plugin-classes-diagram” caption=”Figure 14. UML diagram of com.eteks.sweethome3d.plugin package” caption_small=”(click on a class to view its javadoc)”]<\/p>\n\nInstancja PluginManager<\/a> (1) jest tworzona przy uruchomieniu aplikacji i wyszukuje wtyczki zainstalowane w folderze wtyczek<\/a> u\u017cytkownika. Za ka\u017cdym razem, gdy edytowany jest nowy dom, ten mened\u017cer tworzy instancj\u0119 i konfiguruje obiekt Plugin<\/a> (3) dla ka\u017cdej wtyczki znalezionej w momencie uruchomienia. Nast\u0119pnie wywo\u0142uje metod\u0119 getActions<\/a>, aby pobra\u0107 wszystkie akcje<\/a> (4), kt\u00f3re zostan\u0105 dodane jako elementy menu i\/lub przyciski paska narz\u0119dzi w oknie domu. Ka\u017cda akcja jest instancj\u0105 PluginAction<\/a>, kt\u00f3ra przypomina klas\u0119 Action<\/a>, z jej metod\u0105 execute<\/a> i modyfikowalnymi w\u0142a\u015bciwo\u015bciami<\/a> (2). <\/p>\n\nZauwa\u017c, \u017ce klasa Plugin<\/a> daje ci dost\u0119p do instancji UndoableEditSupport<\/a> poprzez jej metod\u0119 getUndoableEditSupport<\/a>. Gdy tylko zmodyfikujesz dom lub jego obiekty (meble, \u015bciany…) w metodzie execute instancji PluginAction<\/a>, powiniene\u015b r\u00f3wnie\u017c wys\u0142a\u0107 obiekt UndoableEdit<\/a> do obs\u0142ugi edycji cofania zwr\u00f3conej przez metod\u0119 getUndoableEditSupport, w przeciwnym razie u\u017cytkownicy nie b\u0119d\u0105 mogli prawid\u0142owo cofa\u0107\/ponawia\u0107 wprowadzonych przez ciebie zmian. <\/p>\n\nLokalizacja<\/h3>\n\nJe\u015bli planujesz opracowa\u0107 wtyczk\u0119 dla spo\u0142eczno\u015bci u\u017cytkownik\u00f3w Sweet Home 3D, postaraj si\u0119 zlokalizowa\u0107 wy\u015bwietlane przez ni\u0105 ci\u0105gi znak\u00f3w, zar\u00f3wno w nazwach akcji i menu, jak i w tworzonych dialogach (lub przynajmniej przygotuj jej lokalizacj\u0119). Dwa konstruktory klasy PluginAction<\/a> pomog\u0105 Ci zorganizowa\u0107 t\u0142umaczenie w\u0142a\u015bciwo\u015bci akcji za pomoc\u0105 plik\u00f3w .properties, a je\u015bli potrzebujesz przet\u0142umaczy\u0107 inne ci\u0105gi znak\u00f3w w swojej wtyczce (jak te w oknie dialogowym pokazanym przez testowan\u0105 wtyczk\u0119<\/a>), wykorzystaj ponownie te pliki .properties z klas\u0105 Java ResourceBundle<\/a>.Je\u015bli wolisz ograniczy\u0107 liczb\u0119 plik\u00f3w w\u0142a\u015bciwo\u015bci, mo\u017cesz nawet zapisa\u0107 warto\u015bci w\u0142a\u015bciwo\u015bci akcji i inne ci\u0105gi znak\u00f3w w pliku opisu<\/a> ApplicationPlugin.properties swojej wtyczki. <\/p>\n\nJe\u015bli chcesz zobaczy\u0107 przyk\u0142ad wykorzystuj\u0105cy t\u0119 architektur\u0119, pobierz wtyczk\u0119](\"https:\/\/test.sweethome3d.eu\/wp-content\/uploads\/2025\/12\/pluginClassesDiagram.png\"){kind=link}