com.sta.mimages

Class ImageUtils

java.lang.Object

com.sta.mimages.ImageUtils

public class ImageUtils
extends Object

Name: ImageUtils

Description: Diese Klasse soll alle Methoden zur eigentlichen Behandlung von Bildern enthalten, u. a. laden/speichern, zoomen, kombinieren usw. In allen anderen Klassen sowie in abhängigen Projekten kann und soll dann ausschließlich diese Klasse bzw. eine Klasse, die wiederum diese Klasse verwendet, benutzt werden, um Bilder zu behandeln. Die Idee geht auf die Klasse ImageHelper im WAR-Modul vom Generator3 zurück, in der bereits einige Methoden gesammelt wurden. Statt die Quelltexte zu kopieren soll hier eine zentrale Stelle für alle Verwendungen erstellt werden.

Comment: Original-Kommentar: Hilfsklasse für Bildverarbeitung. Die umgesetzten Operationen entsprechen inhaltlich denen aus dem Image-Processor (MImgProc). Prinzipiell könnte man also auch in MImages eine solche Hilfsklasse erstellen und in MImgProc und an den Verwendungsstellen hier im Projekt benutzen. [ (c) 2020, 2021, 2023 ]

Copyright: Copyright (c) 2023

Company: >StA-Soft<

Version:

1.0

Author:

StA

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ImageUtils() Dummy-Constructor.

Method Summary

Modifier and Type	Method and Description
static BufferedImage	addBorder(BufferedImage orgimg, int x1, int y1, int x2, int y2, Long cc) Rahmen hinzufügen.
static BufferedImage	combine(BufferedImage background, BufferedImage foreground, int x, int y) Bilder kombinieren.
static BufferedImage	loadImage(byte[] imagedata) Bild aus Byte-Array laden.
static BufferedImage	loadImage(File f) Bild aus Datei laden.
static BufferedImage	loadImage(InputStream is) Bild aus Stream laden.
static BufferedImage	loadImage(String fn) Bild aus Datei laden.
static BufferedImage	mboxImage(BufferedImage img, int x, int y, Long cc) Bild in eine Box einpassen und dabei ohne Verzerrung auf die maximale Größe zoomen.
static BufferedImage	newImage(int x, int y, Long cc) Neues Bild erzeugen (ARGB, also 32 Bit incl.
static byte[]	saveImage(BufferedImage img, String format) Bild in Byte-Array speichern.
static void	saveImage(File f, BufferedImage img) Bild in Datei speichern.
static void	saveImage(OutputStream os, BufferedImage img, String format) Bild in Stream speichern.
static void	saveImage(String fn, BufferedImage img) Bild in Datei speichern.
static void	scale(BufferedImage img, int ff) Farbwerte eines Bildes skalieren.
static BufferedImage	scale4(BufferedImage orgimg, int alpha, int red, int green, int blue) Farbwerte eines Bildes skalieren.
static BufferedImage	zoomImage(BufferedImage img, int x, int y) Bild auf die angegebene Breite und Höhe zoomen.
static BufferedImage	zoomImage(BufferedImage img, String sx, String sy) Bild auf die angegebene Breite und Höhe zoomen.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ImageUtils

protected ImageUtils()

Dummy-Constructor.

Method Detail

loadImage

public static BufferedImage loadImage(InputStream is)
                               throws IOException

Bild aus Stream laden.

Parameters:

is - Input-Stream

Returns:

Bild

Throws:

IOException - im Fehlerfall

loadImage

public static BufferedImage loadImage(byte[] imagedata)
                               throws IOException

Bild aus Byte-Array laden.

Parameters:

imagedata - Byte-Array

Returns:

Bild

Throws:

IOException - im Fehlerfall

loadImage

public static BufferedImage loadImage(File f)
                               throws IOException

Bild aus Datei laden.

Parameters:

f - Datei

Returns:

Bild

Throws:

IOException - im Fehlerfall

loadImage

public static BufferedImage loadImage(String fn)
                               throws IOException

Bild aus Datei laden.

Parameters:

fn - Dateiname

Returns:

Bild

Throws:

IOException - im Fehlerfall

saveImage

public static void saveImage(OutputStream os,
                             BufferedImage img,
                             String format)
                      throws IOException

Bild in Stream speichern.

Parameters:

os - Output-Stream

img - Bild

format - Format (png, jpg, gif, ...)

Throws:

IOException - im Fehlerfall

saveImage

public static byte[] saveImage(BufferedImage img,
                               String format)
                        throws IOException

Bild in Byte-Array speichern.

Parameters:

img - Bild

format - Format (png, jpg, gif, ...)

Returns:

Byte-Array

Throws:

IOException - im Fehlerfall

saveImage

public static void saveImage(File f,
                             BufferedImage img)
                      throws IOException

Bild in Datei speichern.

Parameters:

f - Datei

img - Bild

Throws:

IOException - im Fehlerfall

saveImage

public static void saveImage(String fn,
                             BufferedImage img)
                      throws IOException

Bild in Datei speichern.

Parameters:

fn - Dateiname

img - Bild

Throws:

IOException - im Fehlerfall

newImage

public static BufferedImage newImage(int x,
                                     int y,
                                     Long cc)

Neues Bild erzeugen (ARGB, also 32 Bit incl. Alpha-Channel).

Parameters:

x - Breite

y - Höhe

cc - (Hintergrund-) Farbe (optional, kann null sein)

Returns:

das erzeugte Bild

zoomImage

public static BufferedImage zoomImage(BufferedImage img,
                                      int x,
                                      int y)

Bild auf die angegebene Breite und Höhe zoomen.

Parameters:

img - Bild

x - neue Breite

y - neue Höhe

Returns:

Ergebnisbild

zoomImage

public static BufferedImage zoomImage(BufferedImage img,
                                      String sx,
                                      String sy)

Bild auf die angegebene Breite und Höhe zoomen. Entweder Breite oder Höhe können "*" sein, was bedeutet, dass das Bild ohne Verzerrung (ohne Veränderung des Seitenverhältnisses) gezoomt werden soll.

Parameters:

img - Bild

sx - neue Breite

sy - neue Höhe

Returns:

Ergebnisbild

combine

public static BufferedImage combine(BufferedImage background,
                                    BufferedImage foreground,
                                    int x,
                                    int y)

Bilder kombinieren. Es wird ein neues Bild in der Größe des Hintergrundbilds erstellt, das Hintergrundbild wird an Position (0, 0) und das Vordergrundbild an der angegebenen Position daraufkopiert.

Parameters:

background - Hintergrundbild

foreground - Vordergrundbild

x - Position-X

y - Position-Y

Returns:

Ergebnisbild

mboxImage

public static BufferedImage mboxImage(BufferedImage img,
                                      int x,
                                      int y,
                                      Long cc)

Bild in eine Box einpassen und dabei ohne Verzerrung auf die maximale Größe zoomen.

Parameters:

img - Bild

x - Breite der Box

y - Höhe der Box

cc - Farbe der ggf. verbleibenden Ränder

Returns:

neues Bild

addBorder

public static BufferedImage addBorder(BufferedImage orgimg,
                                      int x1,
                                      int y1,
                                      int x2,
                                      int y2,
                                      Long cc)

Rahmen hinzufügen.

Parameters:

orgimg - Originalbild

x1 - Rahmenbreite links

y1 - Rahmenhöhe oben

x2 - Rahmenbreite rechts

y2 - Rahmenhöhe unten

cc - Rahmenfarbe (kann null sein, Standard: schwarz)

Returns:

neues Bild mit Rahmen

scale

public static void scale(BufferedImage img,
                         int ff)

Farbwerte eines Bildes skalieren.

Parameters:

img - Bild

ff - Faktor als RGBA (8 Bit pro Komponente, 255 = keine Änderung, 128 = ca. halbieren)

scale4

public static BufferedImage scale4(BufferedImage orgimg,
                                   int alpha,
                                   int red,
                                   int green,
                                   int blue)

Farbwerte eines Bildes skalieren. Bedeutung der Werte: 255 = keine Änderung, 128 = ca. halbieren, 512 = ca. verdoppeln, Ergebnis wird bei 255 gedeckelt.

Parameters:

orgimg - Bild

alpha - A

red - R

green - G

blue - B

Returns:

Bild mit skalierten Farbwerten