In this tutorial we will cover how to create, and use module libraries (which are compiled libraries of groimp projects).

Let's create a very simple project from the newRGG template.

Let's include a custom shader from an image to the project (steps correspond to image bellow):

1. Open the image explorer
2. Import any image
3. Create a new shader in the shader explorer
4. In the attribute editor edit the shader to use the imported image

Now, let's use this shader on the module A in the project:

module A(float len) extends Sphere(0.1)
{
	{setShader(shader("testshader"));} // testshader is the name you gave to the shader created
}

We can now export the current project as a module library. Click on the menu File>Export as Module library.

You will need to provide a package name. The package name NEEDS to follow java specifications on package names (no weird characters). The package name will be used to identify the library with an unique name.

Let's use pkg.example.

You will need to provide a Plugin name. This name will be used when accessing the resources from this library.

The combination of package name + plugin name needs to be unique for GroIMP.

Let's use Test.

You decide where the project is exported to. The creation of a module lib create three or four files (depending on whether the project contains resources or not).

• A plugin.xml file - contains the information for GroIMP on how to load the library
• A plugin.property file - contains the additional properties for the library (its name).
• A .jar file - contains the compiled classes.
• A .grz file - contains the resources.

Now that the module library has been created, we can adds it to GroIMP as a plugin.

Create a directory with the name of your library (Test in this tutorial), and add the 4 files in it. Move the directory in the GroIMP plugin directory (~/.grogra.de-platform/plugins/ by default on debian).

Then, restart GroIMP to load the library.