{"id":11726,"date":"2025-11-05T16:28:15","date_gmt":"2025-11-05T16:28:15","guid":{"rendered":"https:\/\/test.sweethome3d.eu\/vodnik-za-razvijalce-vticnikov\/"},"modified":"2025-12-19T10:19:44","modified_gmt":"2025-12-19T10:19:44","slug":"vodnik-za-razvijalce-vticnikov","status":"publish","type":"page","link":"https:\/\/test.sweethome3d.eu\/sl\/vodnik-za-razvijalce-vticnikov\/","title":{"rendered":"Vodnik za razvijalce vti\u010dnikov"},"content":{"rendered":"\n

Uvod<\/h2>\n\n

Od razli\u010dice 1.5 naprej je mogo\u010de dodati nove funkcije v Sweet Home 3D<\/a> z datotekami vti\u010dnikov, ki so shranjene v tvoji mapi z vti\u010dniki<\/a>. To omogo\u010da programerjem Jave, da razvijajo in distribuirajo nove funkcije za Sweet Home 3D, ne da bi spreminjali izvorne datoteke trenutne razli\u010dice (kar je dobro za zdru\u017eljivost navzgor) in ne da bi dostavili celotno razli\u010dico programa (kar je dobro za velikost dostave).Ta dokument opisuje orodja<\/a>, potrebna za ustvarjanje vti\u010dnikov, nato poka\u017ee, kako programirati vti\u010dnik<\/a>, ki izra\u010duna najve\u010djo prostornino premi\u010dnega pohi\u0161tva, dodanega v dom, in kon\u010dno ponuja nekaj dodatnih informacij<\/a>, ki ti bodo pomagale pri nadaljnjem delu. <\/p>\n\n

<\/div>\n\n

Namestitev razvojnih orodij<\/h2>\n\n

\u010ce je Sweet Home 3D namenjen splo\u0161ni javnosti, razvoj vti\u010dnikov zahteva posebne ve\u0161\u010dine in mora\u0161 znati programirati v Javi<\/a> z IDE<\/a>, preden nadaljuje\u0161. Ta vodnik prikazuje, kako zgraditi vti\u010dnik z Eclipse<\/a>, lahko pa uporabi\u0161 IDE po svoji izbiri ali pa sploh nobenega IDE-ja. <\/p>\n\n

Prenesi in namesti Eclipse<\/h3>\n\n

Najprej prenesi Eclipse z https:\/\/www.eclipse.org\/<\/a>. Razli\u010dica z imenom Eclipse IDE for Java Developers<\/em> je dovolj za razvoj vti\u010dnika, lahko pa prenese\u0161 katero koli razli\u010dico za razvoj v Javi. Ko je prenesen, je namestitev Eclipse zelo preprosta: samo razpakiraj arhiv, ki ga bo\u0161 dobil, odpri mapo eclipse in odvisno od tvojega sistema, za\u017eeni datoteko z imenom eclipse.exe<\/code> (v sistemu Windows), eclipse.app<\/code> (v sistemu Mac OS X) ali eclipse<\/code> (v sistemu Linux).Ob prvem zagonu bo Eclipse zahteval, da izbere\u0161 mapo delovnega prostora<\/em>, kjer bodo shranjeni projekti vti\u010dnikov.Ko je to storjeno, izberi Datoteka > Novo > Projekt<\/em> iz menija, da ustvari\u0161 nov projekt, izberi Java > Java projekt<\/em> v \u010darovniku Nov projekt<\/em>, ki se bo prikazal, vnesi VolumePlugin kot ime projekta in klikni na gumb Dokon\u010daj<\/em>. Na koncu zapri zavihek Dobrodo\u0161li<\/em>, da odkrije\u0161 svoj delovni prostor, kot je prikazano na sliki 1. <\/p>\n\n

\n
\"\"
Slika 1. Delovni prostor Eclipse <\/figcaption><\/figure>\n<\/div>\n\n

Prenesi in namesti knji\u017enico Sweet Home 3D<\/h3>\n\n

Razvoj vti\u010dnika temelji na nekaterih razredih Sweet Home 3D, ki jih mora Eclipse poznati, da lahko zgradi tvoj projekt. Najla\u017eji na\u010din za dodajanje razredov Sweet Home 3D v Eclipse je, da prenese\u0161 izvedljivo razli\u010dico JAR Sweet Home 3D, ki je na voljo na https:\/\/sourceforge.net\/projects\/sweethome3d\/files\/SweetHome3D\/SweetHome3D-7.5\/SweetHome3D-7.5.jar\/download<\/a>. Ko je prenesen, povleci in spusti datoteko SweetHome3D-7.5.jar na ikono projekta VolumePlugin<\/em> v pogledu Package Explorer<\/em> v Eclipse in izberi element Build Path > Add to Build Path<\/em> v kontekstnem meniju datoteke SweetHome3D-7.5.jar, kot je prikazano na sliki 2. <\/p>\n\n

\n
\"\"
Slika 2. Dodajanje SweetHome3D-7.5.jar v Build Path <\/figcaption><\/figure>\n<\/div>\n\n

Programiranje vti\u010dnika<\/h2>\n\n

Zdaj, ko si namestil potrebna orodja, poglejmo, kako lahko programira\u0161 svoj prvi vti\u010dnik za Sweet Home 3D.<\/p>\n\n

Ustvarjanje razreda vti\u010dnika<\/h3>\n\n

Najprej ustvari nov podrazred com.eteks.sweethome3d.plugin.Plugin tako, da izbere\u0161 element menija Datoteka > Novo > Razred<\/em> v Eclipse.<\/p>\n\n

\n
\"\"
Slika 3. Ustvarjanje novega razreda <\/figcaption><\/figure>\n<\/div>\n\n

V pogovornem oknu Nov razred Java<\/em> vnesi VolumePlugin kot ime razreda, vnesi paket (tukaj je bil izbran paket com.eteks.test) in izberi com.eteks.sweethome3d.plugin.Plugin kot nadrazred VolumePlugin. Ko je to storjeno, klikni na Dokon\u010daj<\/em>. Eclipse bo ustvaril datoteko novega razreda z naslednjo vsebino: <\/p>\n\n

package com.eteks.test;import com.eteks.sweethome3d.plugin.Plugin;import com.eteks.sweethome3d.plugin.PluginAction;public class VolumePlugin<\/strong> extends Plugin<\/strong> { @Override public PluginAction[] getActions<\/strong>() { \/\/ TODO Samodejno generirana metoda return null; }}<\/pre>\n\n
Kot lahko ugane\u0161 iz komentarja TODO, mora\u0161 zdaj spremeniti implementacijo metode getActions, da vrne dejanje vti\u010dnika, ki lahko izra\u010duna prostornino premi\u010dnega pohi\u0161tva. Zamenjaj return null; z naslednjo izjavo: <\/p>\n\n
  return new PluginAction<\/strong> [] {new VolumeAction<\/strong>()};  <\/pre>\n\n
in izberi Urejanje > Hitri popravek<\/em> iz menija Eclipse, da ustvari\u0161 manjkajo\u010di razred VolumeAction, kot je prikazano na sliki 4.<\/p>\n\n
\n
\"\"
Slika 4. Uporaba hitrega popravka za generiranje manjkajo\u010dega razreda <\/figcaption><\/figure>\n<\/div>\n\n
V pogovornem oknu Nov razred Java<\/em>, ki se prika\u017ee, izberi potrditveno polje Vklju\u010dujo\u010di tip<\/em>, da ustvari\u0161 notranji razred VolumePlugin, in klikni na Dokon\u010daj<\/em>. To bo ustvarilo razred VolumeAction, ki podeduje od razreda com.eteks.sweethome3d.plugin.PluginAction in vsebuje prazno metodo execute: <\/p>\n\n
  public class VolumeAction<\/strong> extends PluginAction<\/strong> { @Override public void execute<\/strong>() { \/\/ TODO Samodejno generirana metoda } }<\/pre>\n\n
To metodo bo Sweet Home 3D poklical, ko bo uporabnik zagnal dejanje vti\u010dnika; zato je to mesto, kjer mora\u0161 implementirati, kako izra\u010dunati prostornino pohi\u0161tva in jo prikazati:<\/p>\n\n
  public class VolumeAction<\/strong> extends PluginAction<\/strong> {    @Override  public void execute<\/strong>() {   float volumeInCm3 = 0; \/\/ Izra\u010dunaj vsoto prostornine omejevalnega polja  \/\/ vsakega premi\u010dnega kosa pohi\u0161tva v domu for (PieceOfFurniture piece : getHome<\/strong>(). getFurniture<\/strong>()) { if (piece. isMovable<\/strong>()) { volumeInCm3 += piece. getWidth<\/strong>()  * piece. getDepth<\/strong>()  * piece. getHeight<\/strong>();  } }             \/\/ Prika\u017ei rezultat v sporo\u010dilnem oknu (\u00b3 je za 3 v nadpisu) String message = String. format<\/strong>( \u201eNajve\u010dja prostornina premi\u010dnega pohi\u0161tva v domu je %.2f m\u00b3.\u201c,  volumeInCm3 \/ 1000000); JOptionPane. showMessageDialog<\/strong>(null, message);  }  }<\/pre>\n\n
Zdaj, ko si dolo\u010dil, kaj \u017eeli\u0161, da vti\u010dnik naredi, mora\u0161 opisati, kako bo uporabnik zagnal to novo dejanje. Izbira\u0161 lahko med dodajanjem novega elementa menija<\/strong> v meni in\/ali novega gumba<\/strong> v orodno vrstico. Ta izbira se izvede z nastavitvijo ustreznih lastnosti dejanja vti\u010dnika ob njegovi ustvaritvi. Na primer, \u010de \u017eeli\u0161, da uporabniki za\u017eenejo dejanje prostornine z elementom menija Izra\u010dunaj prostornino<\/em>, ki se nahaja v meniju Orodja<\/em>, bo\u0161 dodal naslednji konstruktor razredu VolumnAction:   <\/p>\n\n
  public VolumeAction<\/strong>() {           putPropertyValue<\/strong>(Property.NAME, \u201eIzra\u010dunaj prostornino\u201c);           putPropertyValue<\/strong>(Property.MENU, \u201eOrodja\u201c); \/\/ Privzeto omogo\u010di dejanje           setEnabled<\/strong>(true); }<\/pre>\n\n
Razred vti\u010dnika VolumePlugin<\/a> je zdaj programiran in skoraj pripravljen za delovanje kot vti\u010dnik v Sweet Home 3D. Zadnji dve stvari, ki ju je treba narediti, sta: <\/p>\n\n