Description | API | Development Configuration | Deployment Configuration | FAQ
Custom graphics are used to visualize rasters, projections, and custom image globe overlays in a 3D display. Custom graphics can be defined by developers and users of STK via a plugin architecture in many software programming languages including Java.
The API to develop/run/deploy an STK Graphics Java Plugin based on the STK Java API includes the following lists of libraries/packages/javadocs:
JAR libraries:
JNI native libraries:
Packages:
Documentation
To use these samples:
Platform | Path |
---|---|
Windows 32bit | C:\Program Files\AGI\<STKVERSION>\CodeSamples\Extend\Graphics\Graphics.xml |
Windows 64bit | C:\Program Files\AGI\<STKVERSION>\CodeSamples\Extend\Graphics\Graphics.xml |
Windows 32bit on 64bit | C:\Program Files (x86)\AGI\<STKVERSION>\CodeSamples\Extend\Graphics\Graphics.xml |
Linux 32/64 | <STK_INSTALL_DIR>/CodeSamples/Extend/Graphics/Graphics.xml |
C:\Documents and
Settings\<user account name>\My
Documents\<STKVERSION>\Config\Plugins
on windows and
<STK_CONFIG_DIR>/<STKVERSION>/Config/Plugins
on LINUX.<JavaPlugin
ProgID="AgJNISTKPluginGraphicsDriver10.Driver" ...
Use the above listed JAR and JNI native libraries as input to the following development environment configurations:
Standalone environment - Instructions to configure a non-gui development environment for developing the Java plugin application.
Eclipse IDE - Instructions to configure an Eclipse Java plugin application development project.
Use the samples listed above as reference for implementing the IAgStkGraphicsPluginRasterStream, IAgStkGraphicsPluginProjectionStream, IAgStkGraphicsPluginCustomImageGlobeOverlay and IAgStkGraphicsPluginWithSite interfaces.
Deployment instructions for a STK Graphics Java Plugin application:
Note: Make sure the name of your Graphics XML file is unique as to not conflict with other plugin xml files.
Note: Do NOT include the AGI Plugin JARs, as these are automatically configured/loaded by STK at runtime.
Platform | Path |
Windows 32bit | C:\Program Files\AGI\<STKVERSION>\Plugins\<Name of plugin xml file>.xml |
Windows 64bit | C:\Program Files\AGI\<STKVERSION>\Plugins\<Name of plugin xml file>.xml |
Windows 32bit on 64bit | C:\Program Files (x86)\AGI\<STKVERSION>\Plugins\<Name of plugin xml file>.xml |
Linux 32/64 | <STK_INSTALL_DIR>/Plugins/<Name of plugin xml file>.xml |
If this is not a writable location, copy your Graphics Plugin
XML file to the STK Plugin configuration user directory, which
typically is C:\Documents and Settings\<user account
name>\My Documents\<STKVERSION>\Config\Plugins
on
windows and
<STK_CONFIG_DIR>/<STKVERSION>/Config/Plugins
on LINUX.
A set of frequently asked questions/issues and their answers/solutions.
STK is responsible for creating and initializing your plugin when necessary during 3D Graphics window redraw.
You do NOT need to declare a main method within your plugin. The latest installed JRE on the deployed machine fill be embedded/started within STK, your Java plugin class which you indicated in the ClassName attribute of your JavaPlugin entry within your plugin xml file.
STK Programming Interface 11.0.1