README for X3D-Edit 4.0 Development

Got X3D-Edit?

• X3D-Edit home page documents this authoring tool for X3D Graphics models.

• Apache NetBeans X3D-Edit Plugin is our primary distribution.

• SourceForge X3D-Edit Distribution offers executable installers.

This file is the developers' documentation page for creation of X3D-Edit 4.0 suite.

---

Developer Work in Progress

X3D-Edit is now stable and successfully transitioned as part of the NetBeans plugin architecture.

The coming year will see most work focused on implementing addition nodes for X3D version 4.

We are now tracking work items at GitHub Issues for X3D-Edit.

---

Resources

• Tutorial Contribution Guidelines

• AsciiDoc is a plain text markup language for writing technical content

• Online Javadoc for Netbeans IDE: Apache NetBeans Development Version Documentation | APIs Overview

• TODO attaching Javadoc for Netbeans IDE

• Apache NetBeans API Development

• Apache NetBeans DevFaq wiki index

• List of NetBeans-based software outdated?

• StackOverflow: How to debug multiple threads/runnables at the same time in netbeans

---

NetBeans Resources

NetBeans Platform Learning Trail

"Comprehensive tutorials that highlight a wide range of Apache NetBeans APIs for a variety of application types."

• NetBeans Issues

• Netbeans API References

• Top 10 NetBeans APIs dated but some nuggets found

XML Editor Extension Module Tutorial

Tutorial section Specifying the Module’s Dependencies

• Issue 4492 XML Editor Extension Module Tutorial erratum I/O APIs not found, (I/O APIs - Swing) worked, other is (I/O API and SPI)

• Note that multiple XML-related module dependencies are provided by NetBeans

Don used this to create initial code block for X3D-Edit Module Suite.

NetBeans Code Snippet Module Tutorial

Has better excerpt of layer.xml file.

• Inspect build/classes/META-INF/generated-layer.xml to see what is actually generated using layer.xml and annotations

Creating layer.xml file is optional if using annotations instead:

• StackOverflow Learning NetBeans platform: annotations vs layer.xml file

• StackOverflow Where to find the main layer.xml file in Netbeans RCP maven project?

NetBeans Editor Component Palette Module Tutorial

"This tutorial demonstrates how to create a component palette that provides drag-and-drop code snippets for a new file type."

• Issue 4519 NetBeans Editor Component Palette Module Tutorial missing source code

• Issue 4520 NetBeans Editor Component Palette Module Tutorial, garbled source

• Issue 4521 org.openide.util.Exceptions not found by import in tutorial fixed, closed.

Implemented module as X3dSourceFilePalette. Not all names aligned, not all source applied, work ongoing.

Netbeans Splash Screen

• How to make Splash Screen in Java using Netbeans with Source Code

Note problem failing when turned on by Project setting for X3D-Edit module suite. <- FIXED (TDN)

NetBeans Ant-Based Project Type Module Tutorial

TODO. Consider if this will help create projects of interest - might be superfluous.

Using the NetBeans IDE created installer for Windows

Desktop shortcut for Windows. Assumes JAVA_HOME areadly defined in Environment Variables Right click on shortcut properties and set:

• Target: x3deditmodulesuite64 --jdkhome "%JAVA_HOME%" --console new
• Start in: "C:\Program Files\x3deditmodulesuite\bin"

Creating standalone installers

Once the X3D-Edit 4.0 module suite is working as a Netbeans plugin, this tutorial shows how to create installer executables.

Tutorial Native Packaging in NetBeans IDE

• WiX Toolset to create Windows installation packages

• Inno Setup free installer for Windows programs