icon-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;
	}

sshtools / icon-generator