{"id":11726,"date":"2025-11-05T16:28:15","date_gmt":"2025-11-05T16:28:15","guid":{"rendered":"https:\/\/www.sweethome3d.com\/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:\/\/www.sweethome3d.com\/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<\/a>, 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