{"id":11521,"date":"2025-11-05T16:28:15","date_gmt":"2025-11-05T16:28:15","guid":{"rendered":"https:\/\/www.sweethome3d.com\/handleiding-voor-plug-in-ontwikkelaars\/"},"modified":"2025-12-19T10:19:34","modified_gmt":"2025-12-19T10:19:34","slug":"handleiding-voor-plug-in-ontwikkelaars","status":"publish","type":"page","link":"https:\/\/www.sweethome3d.com\/nl\/handleiding-voor-plug-in-ontwikkelaars\/","title":{"rendered":"Handleiding voor plug-in ontwikkelaars"},"content":{"rendered":"\n

Inleiding<\/h2>\n\n

Vanaf versie 1.5 is het mogelijk om nieuwe functies aan Sweet Home 3D<\/a> toe te voegen met plug-in bestanden die in je plug-ins map<\/a> worden geplaatst. Dit stelt Java-programmeurs in staat om nieuwe functies voor Sweet Home 3D<\/a> te ontwikkelen en te distribueren zonder de bronbestanden van de huidige versie te wijzigen (wat goed is voor opwaartse compatibiliteit), en zonder een volledige versie van het programma te leveren (wat goed is voor de omvang van de levering).Dit document beschrijft de tools<\/a> die nodig zijn om plug-ins te maken, laat vervolgens zien hoe je een plug-in kunt programmeren<\/a> die het maximale volume van het verplaatsbare meubilair berekent dat aan een huis is toegevoegd, en geeft ten slotte wat aanvullende informatie<\/a> die je helpt om verder te gaan. <\/p>\n\n

<\/div>\n\n

Ontwikkeltools installeren<\/h2>\n\n

Hoewel Sweet Home 3D zich richt op een algemeen publiek, vereist het ontwikkelen van plug-ins speciale vaardigheden, en je moet weten hoe je in Java<\/a> moet programmeren met een IDE<\/a>, voordat je verder gaat. Deze handleiding laat zien hoe je een plug-in kunt bouwen met Eclipse<\/a>, maar je kunt de IDE van je keuze gebruiken, of helemaal geen IDE. <\/p>\n\n

Download en installeer Eclipse<\/h3>\n\n

Download<\/a> eerst Eclipse van https:\/\/www.eclipse.org\/<\/a>. De versie genaamd Eclipse IDE for Java Developers<\/em> is voldoende om een plug-in te ontwikkelen, maar je kunt elke versie voor Java-ontwikkeling downloaden. Eenmaal gedownload, is het installeren van Eclipse zeer eenvoudig: pak gewoon het archief dat je krijgt uit, open de eclipse map en voer, afhankelijk van je systeem, het bestand uit met de naam eclipse.exe<\/code> (onder Windows), eclipse.app<\/code> (onder Mac OS X) of eclipse<\/code> (onder Linux).Bij de eerste keer opstarten zal Eclipse je vragen om een workspace<\/em> map te kiezen, waar plug-in projecten zullen worden opgeslagen.Kies vervolgens File > New > Project<\/em> uit het menu om een nieuw project te maken, selecteer Java > Java project<\/em> in de New project<\/em> wizard die wordt weergegeven, voer VolumePlugin in als projectnaam en klik op de knop Finish<\/em>. Sluit ten slotte het tabblad Welcome<\/em> om je workspace te ontdekken zoals weergegeven in figuur 1. <\/p>\n\n

\n
\"\"
Figuur 1. Eclipse workspace <\/figcaption><\/figure>\n<\/div>\n\n

Download en installeer Sweet Home 3D bibliotheek<\/h3>\n\n

De ontwikkeling van een plug-in is gebaseerd op enkele klassen van Sweet Home 3D die Eclipse moet kennen om je project te kunnen bouwen. De eenvoudigste manier om Sweet Home 3D klassen aan Eclipse toe te voegen is door de JAR uitvoerbare versie van Sweet Home 3D te downloaden die beschikbaar is op https:\/\/sourceforge.net\/projects\/sweethome3d\/files\/SweetHome3D\/SweetHome3D-7.5\/SweetHome3D-7.5.jar\/download<\/a>. Eenmaal gedownload, sleep en zet het bestand SweetHome3D-7.5.jar neer op het pictogram van het VolumePlugin<\/em> project in de Package Explorer<\/em> weergave van Eclipse, en kies het item Build Path > Add to Build Path<\/em> in het contextmenu van het SweetHome3D-7.5.jar bestand, zoals weergegeven in figuur 2. <\/p>\n\n

\n
\"\"
Figuur 2. SweetHome3D-7.5.jar toevoegen aan Build Path <\/figcaption><\/figure>\n<\/div>\n\n

Een plug-in programmeren<\/h2>\n\n

Nu je de vereiste tools hebt ge\u00efnstalleerd, laten we eens kijken hoe je je eerste plug-in voor Sweet Home 3D kunt programmeren.<\/p>\n\n

De plug-in klasse maken<\/h3>\n\n

Maak eerst een nieuwe subklasse van com.eteks.sweethome3d.plugin.Plugin door File > New > Class<\/em> menu-item te kiezen in Eclipse.<\/p>\n\n

\n
\"\"
Figuur 3. Een nieuwe klasse maken <\/figcaption><\/figure>\n<\/div>\n\n

Voer in het dialoogvenster New Java Class<\/em> VolumePlugin in als de klassenaam, voer een pakket in (hier is het gekozen pakket com.eteks.test), en kies com.eteks.sweethome3d.plugin.Plugin als de superklasse van VolumePlugin. Klik vervolgens op Finish<\/em>. Eclipse zal het bestand van de nieuwe klasse maken met de volgende inhoud: <\/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
Zoals je kunt raden uit de TODO-opmerking, moet je nu de implementatie van de getActions methode wijzigen om een plug-in actie te retourneren die het volume van het verplaatsbare meubilair kan berekenen. Vervang return null; door de volgende verklaring: <\/p>\n\n
  return new PluginAction<\/strong> [] {new VolumeAction<\/strong>()};  <\/pre>\n\n
en kies Edition > Quick Fix<\/em> uit het Eclipse-menu om de ontbrekende klasse VolumeAction te maken, zoals weergegeven in figuur 4.<\/p>\n\n
\n
\"\"
Figuur 4. Quick fix gebruiken om een ontbrekende klasse te genereren <\/figcaption><\/figure>\n<\/div>\n\n
Selecteer in het dialoogvenster New Java Class<\/em> dat verschijnt het selectievakje Enclosing type<\/em> om een inner class van VolumePlugin te maken en klik op Finish<\/em>. Dit zal de klasse VolumeAction maken die overerft van de klasse com.eteks.sweethome3d.plugin.PluginAction en een lege execute methode bevat: <\/p>\n\n
  public class VolumeAction<\/strong> extends PluginAction<\/strong> { @Override public void execute<\/strong>() { \/\/ TODO Auto-generated method stub } }<\/pre>\n\n
Dit is de methode die Sweet Home 3D zal aanroepen wanneer de gebruiker de plug-in actie start; dit is dus de plek waar je moet implementeren hoe het volume van het meubilair moet worden berekend en weergegeven:<\/p>\n\n
  public class VolumeAction<\/strong> extends PluginAction<\/strong> {    @Override  public void execute<\/strong>() {   float volumeInCm3 = 0; \/\/ Bereken de som van het volume van de bounding box van  \/\/ elk verplaatsbaar meubelstuk in het huis for (PieceOfFurniture piece : getHome<\/strong>(). getFurniture<\/strong>()) { if (piece. isMovable<\/strong>()) { volumeInCm3 += piece. getWidth<\/strong>()  * piece. getDepth<\/strong>()  * piece. getHeight<\/strong>();  } }             \/\/ Toon het resultaat in een berichtvenster (\u00b3 is voor 3 in superscript) String message = String. format<\/strong>( \"Het maximale volume van het verplaatsbare meubilair in het huis is %.2f m\u00b3.\",  volumeInCm3 \/ 1000000); JOptionPane. showMessageDialog<\/strong>(null, message);  }  }<\/pre>\n\n
Nu je hebt gespecificeerd wat je wilt dat de plug-in doet, moet je beschrijven hoe de gebruiker deze nieuwe actie zal starten. Je hebt de keuze tussen het toevoegen van een nieuw menu-item<\/strong> aan een menu, en\/of een nieuwe knop<\/strong> aan de werkbalk. Deze keuze wordt gemaakt door de juiste eigenschappen van de plug-in actie in te stellen bij de creatie ervan. Als je bijvoorbeeld wilt dat gebruikers de volume-actie starten met het menu-item Volume berekenen<\/em> in het menu Tools<\/em>, voeg je de volgende constructor toe aan de VolumnAction klasse:   <\/p>\n\n
  public VolumeAction<\/strong>() {           putPropertyValue<\/strong>(Property.NAME, \"Volume berekenen\");           putPropertyValue<\/strong>(Property.MENU, \"Tools\"); \/\/ Schakelt de actie standaard in           setEnabled<\/strong>(true); }<\/pre>\n\n
De VolumePlugin<\/a> plug-in klasse is nu geprogrammeerd en bijna klaar om als plug-in in Sweet Home 3D te werken. De twee laatste dingen die je moet doen zijn: <\/p>\n\n