{"id":11519,"date":"2025-11-05T16:28:15","date_gmt":"2025-11-05T16:28:15","guid":{"rendered":"https:\/\/test.sweethome3d.eu\/prirucka-pro-vyvojare-zasuvnych-modulu\/"},"modified":"2025-12-19T10:19:33","modified_gmt":"2025-12-19T10:19:33","slug":"prirucka-pro-vyvojare-zasuvnych-modulu","status":"publish","type":"page","link":"https:\/\/test.sweethome3d.eu\/cs\/prirucka-pro-vyvojare-zasuvnych-modulu\/","title":{"rendered":"P\u0159\u00edru\u010dka pro v\u00fdvoj\u00e1\u0159e z\u00e1suvn\u00fdch modul\u016f"},"content":{"rendered":"\n

\u00davod<\/h2>\n\n

Od verze 1.5 je mo\u017en\u00e9 p\u0159id\u00e1vat nov\u00e9 funkce do Sweet Home 3D<\/a> pomoc\u00ed soubor\u016f z\u00e1suvn\u00fdch modul\u016f um\u00edst\u011bn\u00fdch ve slo\u017ece z\u00e1suvn\u00fdch modul\u016f<\/a>. To umo\u017e\u0148uje program\u00e1tor\u016fm v Jav\u011b vyv\u00edjet a distribuovat nov\u00e9 funkce pro Sweet Home 3D bez \u00fapravy zdrojov\u00fdch soubor\u016f aktu\u00e1ln\u00ed verze (co\u017e je dobr\u00e9 pro zp\u011btnou kompatibilitu) a bez dod\u00e1v\u00e1n\u00ed pln\u00e9 verze programu (co\u017e je dobr\u00e9 pro velikost dod\u00e1vky).Tento dokument popisuje n\u00e1stroje<\/a> pot\u0159ebn\u00e9 k vytvo\u0159en\u00ed z\u00e1suvn\u00fdch modul\u016f, pot\u00e9 ukazuje, jak naprogramovat z\u00e1suvn\u00fd modul<\/a>, kter\u00fd vypo\u010d\u00edt\u00e1 maxim\u00e1ln\u00ed objem pohybliv\u00e9ho n\u00e1bytku p\u0159idan\u00e9ho do domu, a nakonec uv\u00e1d\u00ed n\u011bkter\u00e9 dal\u0161\u00ed informace<\/a>, kter\u00e9 v\u00e1m pomohou j\u00edt d\u00e1l. <\/p>\n\n

<\/div>\n\n

Instalace v\u00fdvojov\u00fdch n\u00e1stroj\u016f<\/h2>\n\n

Zat\u00edmco Sweet Home 3D je ur\u010den pro \u0161irokou ve\u0159ejnost, v\u00fdvoj z\u00e1suvn\u00fdch modul\u016f vy\u017eaduje speci\u00e1ln\u00ed dovednosti a m\u011bli byste v\u011bd\u011bt, jak programovat v Jav\u011b<\/a> s IDE<\/a>, ne\u017e budete pokra\u010dovat. Tato p\u0159\u00edru\u010dka ukazuje, jak vytvo\u0159it z\u00e1suvn\u00fd modul pomoc\u00ed Eclipse<\/a>, ale m\u016f\u017eete pou\u017e\u00edt IDE dle vlastn\u00edho v\u00fdb\u011bru, nebo \u017e\u00e1dn\u00e9 IDE. <\/p>\n\n

St\u00e1hn\u011bte a nainstalujte Eclipse<\/h3>\n\n

Nejprve si st\u00e1hn\u011bte Eclipse z https:\/\/www.eclipse.org\/<\/a>. Verze s n\u00e1zvem Eclipse IDE for Java Developers<\/em> sta\u010d\u00ed k v\u00fdvoji z\u00e1suvn\u00e9ho modulu, ale m\u016f\u017eete si st\u00e1hnout libovolnou verzi pro v\u00fdvoj v Jav\u011b. Po sta\u017een\u00ed je instalace Eclipse velmi jednoduch\u00e1: sta\u010d\u00ed rozbalit archiv, kter\u00fd z\u00edsk\u00e1te, otev\u0159\u00edt slo\u017eku eclipse a v z\u00e1vislosti na va\u0161em syst\u00e9mu spustit soubor s n\u00e1zvem eclipse.exe<\/code> (v syst\u00e9mu Windows), eclipse.app<\/code> (v syst\u00e9mu Mac OS X) nebo eclipse<\/code> (v syst\u00e9mu Linux).P\u0159i prvn\u00edm spu\u0161t\u011bn\u00ed bude Eclipse vy\u017eadovat, abyste si vybrali slo\u017eku pracovn\u00edho prostoru<\/em>, kde budou ulo\u017eeny projekty z\u00e1suvn\u00fdch modul\u016f.Jakmile to ud\u011bl\u00e1te, vyberte z nab\u00eddky Soubor > Nov\u00fd > Projekt<\/em> pro vytvo\u0159en\u00ed nov\u00e9ho projektu, vyberte Java > Java project<\/em> v pr\u016fvodci Nov\u00fd projekt<\/em>, kter\u00fd se zobraz\u00ed, zadejte VolumePlugin jako n\u00e1zev projektu a klikn\u011bte na tla\u010d\u00edtko Dokon\u010dit<\/em>. Nakonec zav\u0159ete kartu V\u00edtejte<\/em> a objevte sv\u016fj pracovn\u00ed prostor, jak je zn\u00e1zorn\u011bno na obr\u00e1zku 1. <\/p>\n\n

\n
\"\"
Obr\u00e1zek 1. Pracovn\u00ed prostor Eclipse <\/figcaption><\/figure>\n<\/div>\n\n

St\u00e1hn\u011bte a nainstalujte knihovnu Sweet Home 3D<\/h3>\n\n

V\u00fdvoj z\u00e1suvn\u00e9ho modulu je zalo\u017een na n\u011bkter\u00fdch t\u0159\u00edd\u00e1ch Sweet Home 3D, kter\u00e9 Eclipse mus\u00ed zn\u00e1t, aby mohl sestavit v\u00e1\u0161 projekt. Nejjednodu\u0161\u0161\u00ed zp\u016fsob, jak p\u0159idat t\u0159\u00eddy Sweet Home 3D do Eclipse, je st\u00e1hnout spustitelnou verzi JAR Sweet Home 3D, kter\u00e1 je k dispozici na https:\/\/sourceforge.net\/projects\/sweethome3d\/files\/SweetHome3D\/SweetHome3D-7.5\/SweetHome3D-7.5.jar\/download<\/a>. Po sta\u017een\u00ed p\u0159et\u00e1hn\u011bte soubor SweetHome3D-7.5.jar na ikonu projektu VolumePlugin<\/em> v zobrazen\u00ed Package Explorer<\/em> v Eclipse a vyberte polo\u017eku Build Path > Add to Build Path<\/em> v kontextov\u00e9 nab\u00eddce souboru SweetHome3D-7.5.jar, jak je zn\u00e1zorn\u011bno na obr\u00e1zku 2. <\/p>\n\n

\n
\"\"
Obr\u00e1zek 2. P\u0159id\u00e1n\u00ed SweetHome3D-7.5.jar do Build Path <\/figcaption><\/figure>\n<\/div>\n\n

Programov\u00e1n\u00ed z\u00e1suvn\u00e9ho modulu<\/h2>\n\n

Nyn\u00ed, kdy\u017e jste nainstalovali po\u017eadovan\u00e9 n\u00e1stroje, se pod\u00edvejme, jak m\u016f\u017eete naprogramovat sv\u016fj prvn\u00ed z\u00e1suvn\u00fd modul pro Sweet Home 3D.<\/p>\n\n

Vytvo\u0159en\u00ed t\u0159\u00eddy z\u00e1suvn\u00e9ho modulu<\/h3>\n\n

Nejprve vytvo\u0159te novou podt\u0159\u00eddu com.eteks.sweethome3d.plugin.Plugin v\u00fdb\u011brem polo\u017eky nab\u00eddky Soubor > Nov\u00fd > T\u0159\u00edda<\/em> v Eclipse.<\/p>\n\n

\n
\"\"
Obr\u00e1zek 3. Vytvo\u0159en\u00ed nov\u00e9 t\u0159\u00eddy <\/figcaption><\/figure>\n<\/div>\n\n

V dialogov\u00e9m okn\u011b Nov\u00e1 t\u0159\u00edda Java<\/em> zadejte VolumePlugin jako n\u00e1zev t\u0159\u00eddy, zadejte bal\u00ed\u010dek (zde byl zvolen bal\u00ed\u010dek com.eteks.test) a vyberte com.eteks.sweethome3d.plugin.Plugin jako nadt\u0159\u00eddu VolumePlugin. Jakmile to ud\u011bl\u00e1te, klikn\u011bte na Dokon\u010dit<\/em>. Eclipse vytvo\u0159\u00ed soubor nov\u00e9 t\u0159\u00eddy s n\u00e1sleduj\u00edc\u00edm obsahem: <\/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 Auto-generated method stub return null; }}<\/pre>\n\n
Jak m\u016f\u017eete odvodit z koment\u00e1\u0159e TODO, mus\u00edte nyn\u00ed zm\u011bnit implementaci metody getActions, aby vracela akci z\u00e1suvn\u00e9ho modulu, kter\u00e1 je schopna vypo\u010d\u00edtat objem pohybliv\u00e9ho n\u00e1bytku. Nahra\u010fte return null; n\u00e1sleduj\u00edc\u00edm p\u0159\u00edkazem: <\/p>\n\n
  return new PluginAction<\/strong> [] {new VolumeAction<\/strong>()};  <\/pre>\n\n
a vyberte \u00dapravy > Rychl\u00e1 oprava<\/em> z nab\u00eddky Eclipse pro vytvo\u0159en\u00ed chyb\u011bj\u00edc\u00ed t\u0159\u00eddy VolumeAction, jak je zn\u00e1zorn\u011bno na obr\u00e1zku 4.<\/p>\n\n
\n
\"\"
Obr\u00e1zek 4. Pou\u017eit\u00ed rychl\u00e9 opravy ke generov\u00e1n\u00ed chyb\u011bj\u00edc\u00ed t\u0159\u00eddy <\/figcaption><\/figure>\n<\/div>\n\n
V dialogov\u00e9m okn\u011b Nov\u00e1 t\u0159\u00edda Java<\/em>, kter\u00e9 se zobraz\u00ed, za\u0161krtn\u011bte pol\u00ed\u010dko Uzav\u00edraj\u00edc\u00ed typ<\/em> pro vytvo\u0159en\u00ed vnit\u0159n\u00ed t\u0159\u00eddy VolumePlugin a klikn\u011bte na Dokon\u010dit<\/em>. T\u00edm se vytvo\u0159\u00ed t\u0159\u00edda VolumeAction, kter\u00e1 d\u011bd\u00ed z t\u0159\u00eddy com.eteks.sweethome3d.plugin.PluginAction a obsahuje pr\u00e1zdnou metodu execute: <\/p>\n\n
  public class VolumeAction<\/strong> extends PluginAction<\/strong> { @Override public void execute<\/strong>() { \/\/ TODO Auto-generated method stub } }<\/pre>\n\n
Tato metoda je ta, kterou Sweet Home 3D zavol\u00e1, kdy\u017e u\u017eivatel spust\u00ed akci z\u00e1suvn\u00e9ho modulu; proto je to m\u00edsto, kde mus\u00edte implementovat, jak vypo\u010d\u00edtat objem n\u00e1bytku a zobrazit jej:<\/p>\n\n
  public class VolumeAction<\/strong> extends PluginAction<\/strong> {    @Override  public void execute<\/strong>() {   float volumeInCm3 = 0; \/\/ Compute the sum of the volume of the bounding box of  \/\/ each movable piece of furniture in home for (PieceOfFurniture piece : getHome<\/strong>(). getFurniture<\/g>()) { if (piece. isMovable<\/g>()) { volumeInCm3 += piece. getWidth<\/strong>()  * piece. getDepth<\/strong>()  * piece. getHeight<\/strong>();  } }             \/\/ Display the result in a message box (\u00b3 is for 3 in supercript) String message = String. format<\/strong>( \"The maximum volume of the movable furniture in home is %.2f m\u00b3.\",  volumeInCm3 \/ 1000000); JOptionPane. showMessageDialog<\/strong>(null, message);  }  }<\/pre>\n\n
Nyn\u00ed, kdy\u017e jste ur\u010dili, co m\u00e1 z\u00e1suvn\u00fd modul d\u011blat, mus\u00edte popsat, jak u\u017eivatel spust\u00ed tuto novou akci. M\u00e1te na v\u00fdb\u011br mezi p\u0159id\u00e1n\u00edm nov\u00e9 polo\u017eky nab\u00eddky<\/strong> do nab\u00eddky a\/nebo nov\u00e9ho tla\u010d\u00edtka<\/strong> na panel n\u00e1stroj\u016f. Tato volba se prov\u00e1d\u00ed nastaven\u00edm p\u0159\u00edslu\u0161n\u00fdch vlastnost\u00ed akce z\u00e1suvn\u00e9ho modulu p\u0159i jeho vytvo\u0159en\u00ed. Nap\u0159\u00edklad, pokud chcete, aby u\u017eivatel\u00e9 spou\u0161t\u011bli akci objemu pomoc\u00ed polo\u017eky nab\u00eddky Vypo\u010d\u00edtat objem<\/em>, kter\u00e1 se nach\u00e1z\u00ed v nab\u00eddce N\u00e1stroje<\/em>, p\u0159id\u00e1te n\u00e1sleduj\u00edc\u00ed konstruktor do t\u0159\u00eddy VolumnAction:   <\/p>\n\n
  public VolumeAction<\/strong>() {           putPropertyValue<\/strong>(Property.NAME, \"Compute volume\");           putPropertyValue<\/strong>(Property.MENU, \"Tools\"); \/\/ Enables the action by default           setEnabled<\/strong>(true); }<\/pre>\n\n
T\u0159\u00edda z\u00e1suvn\u00e9ho modulu VolumePlugin<\/a> je nyn\u00ed naprogramov\u00e1na a t\u00e9m\u011b\u0159 p\u0159ipravena k pr\u00e1ci jako z\u00e1suvn\u00fd modul v Sweet Home 3D. Posledn\u00ed dv\u011b v\u011bci, kter\u00e9 je t\u0159eba ud\u011blat, jsou: <\/p>\n\n