JarCastingicon-generator
A simple library for generating Java2D (Swing/AWT), JavaFX and SWT icons in Java.
icon-generator generates icons images automatically from text or icons with customisable shapes, colour and styles.
Configuring your project
The library is available in Maven Central, so configure your project according to the build system you use.
As from version 1.2, icon-generator requires Java 9 or higher (due to modularity requirements). If you want to use this library with Java 8 or earlier, then you will have to continue to use version 1.0.3. I may consider future 1.0.x releases if anyone needs them.
Choose the appropriate module for the toolkit you wish to use. You may include multiple toolkits if you wish :-
Swing
<dependency>
<groupId>com.sshtools</groupId>
<artifactId>icon-generator-swing</artifactId>
<version>1.3.0</version>
</dependency>
JavaFX
<dependency>
<groupId>com.sshtools</groupId>
<artifactId>icon-generator-javafx</artifactId>
<version>1.3.0</version>
</dependency>
SWT
<dependency>
<groupId>com.sshtools</groupId>
<artifactId>icon-generator-swt</artifactId>
<version>1.3.0</version>
</dependency>
Configuring the Icon
For this, you use IconBuilder.
Create The Builder
IconBuilder builder = new IconBuilder();
Sizes
builder.width(64);
builder.height(64);
Text Colours
builder.textColor(0xff0000); // red
// or
build.textColor(IconBuilder.AUTO_TEXT_COLOR);
// or
build.textColor(IconBuilder.RANDOM_TEXT_COLOR);
// or
build.textColor(IconBuilder.AUTO_TEXT_COLOR_WHITE);
// or
build.textColor(IconBuilder.AUTO_TEXT_COLOR_BLACK);
// and the background colour
builder.color(0x00ff00); // green
// or
builder.color(IconBuilder.AUTO_COLOR); // based on text / icon
// or
builder.color(IconBuilder.RANDOM_COLOR);
Shape
builder.autoShape();
// or
builder.rect(); // rectangle
// or
builder.round(); // round
// or
builder.rectRound(8); // rounded rectangle with 8px radius
Text And Fonts
builder.text("AB");
// or a full word and a processing option
builder.text("Actually Brilliant");
builder.textCase(TextCase.UPPER);
builder.textContext(TextContext.INITIALS);
// Font
builder.font("Monospaced");
builder.fontSize(12);
builder.bold(true);
Font Awesome Icon
builder.icon(AwesomeIcon.ADDRESS_BOOK);
// or
builder.awesomeIconMode(AwesomeIconMode.AUTO_TEXT);
// or
builder.awesomeIconMode(AwesomeIconMode.AUTO_MATCH);
Generate The Icon
Now you can use the IconBuilder.build() for the toolkit you are using. You must provide the class of the concrete icon to create, depending on the toolkit. The following are supported :-
| Class | Module | Description |
|---|---|---|
| java.awt.BufferedImage | icon-generator-swing | A Swing buffered image. |
| java.awt.Image | icon-generator-swing | A Swing buffered image. |
| javax.swing.Icon | icon-generator-swing | A Swing icon. |
| org.eclipse.swt.graphics.Image | icon-generator-swt | An SWT image. |
| javafx.scene.canvas.Canvas | icon-generator-javafx | A JavaFX canvas. |
Generate an ImageIcon for use in Swing
JLabel l = new JLabel("A label with an icon");
l.setIcon(builder.build(Icon.class));
Generate a Java2D BufferedImage for use in a servlet
Something like this :-
response.setContentType("image/jpeg");
try(OutputStream out = response.getOutputStream()) {
ImageIO.write(builder.build(BufferedImage.class), "jpg", out);
}
Extending
New generators may be added by implementing IconGenerator. You can then either add the generator to each IconBuilder you create :-
builder.generator(MyIcon.class, new IconGenerator<MyIcon>() {
@Override
public Class<MyIcon> getIconClass() {
return MyIcon.class;
}
@Override
public boolean isValid() {
/* This can be used to have the generator ignored if some pre-condition is not met,
such as a supporting library not being available */
return true;
}
@Override
public MyIcon generate(IconBuilder builder, Object... args) {
MyIcon myIcon = ..
/** Do stuff to generate a MyIcon given the configuration provided by IconBuilder */
return myIcon;
}
});
.. or create a concrete class and add it as a service. Create a classpath resource named META-INF/services/com.sshtools.icongenerator.IconGenerator (e.g. src/main/resources/META-INF/services/com.sshtools.icongenerator.IconGenerator) and place the full class name of your IconGenerator implementation inside it.
com.mystuff.icongen.MyIconGenerator
This will then be automatically loaded whenever you create a new IconBuilder instance, and you can use the build() method as normal :-
IconBuilder builder = new IconBuilder();
// do stuff to create builder ...
MyIcon myIcon = builder.build(MyIcon.class);
The build() method also can accept additional arguments which are passed on to the generator, if your generator needs additional configuration.
MyIcon myIcon = builder.build(MyIcon.class, flipX, flipY);
.. and then in the generator access the arguments :-
@Override
public MyIcon generate(IconBuilder builder, Object... args) {
boolean flipX = (Boolean)args[0];
boolean flipY = (Boolean)args[1];
MyIcon myIcon = ..
/** Do stuff to generate a MyIcon given the configuration provided by IconBuilder */
return myIcon;
}
