2020.03.23

画像の新規作成

はじめに

フルカラー(24bit)画像を新しく作成するソースコードを解説します。

ここで作成できる画像は、横方向と縦方向のピクセル数を指定して作成される単色(黒)の画像PNG形式ファイルです。

新しく作成した画像は、グラフィックの描画や、画像処理の結果の保存や、画像処理の途中経過を保存する等に利用できます。

Javaソースコード

以下がそのソースコード例です。

CreateImage.java

001
002
003
004
005
006
007
008
009
010
011
012
013
014
015
016
017
018
019
020
021
022
023
024
025
026
027
028
029
030
031
032
033
034
035
036
037
038
039
040
041
042
043
044
045
046
047
048
049
050
051
052
053
054
055
056
057
058
059
060
061
062
063
064
065
066
067
068
import java.awt.image.BufferedImage;
import java.io.File;
import javax.imageio.ImageIO;
import java.io.IOException;

public class CreateImage {
	public static void main( String[] args ) {
		// 結果格納フラグ
		boolean result;
		// 画像サイズ
		int width, height;
		// ファイル名
		String outname;
		// 画像格納クラス
		BufferedImage img = null;

		// 入力した引数が3つ以上かを調べる
		if ( 3 > args.length ) {
			// 入力した引数が3つ未満の場合、使用方法を表示する
			System.out.println( "CreateImage [出力PNG名] [幅] [高さ]" );
			return;
		}

		// 出力PNG名をoutnameに代入(拡張子".png"省略なし)
		outname = args[ 0 ];

		try {
			// 幅ピクセルをwidthに代入
			width  = Integer.parseInt( args[ 1 ] );
			// 高さピクセルをheightに代入
			height = Integer.parseInt( args[ 2 ] );
		} catch ( NumberFormatException e ) {
			// 引数をwidth、heightの変換に失敗したときの処理
			e.printStackTrace();
			return;
		}

		// 画像サイズの検査
		if ( ( 1 > width ) || ( 1 > height ) ) {
			// 画像のサイズに1より小さい値が指定されたとき処理
			System.out.println( "画像サイズが範囲外です" );
			return;
		}

		// 24ビットカラーの画像を作成
		try {
			img = new BufferedImage( width, height,
						 BufferedImage.TYPE_INT_RGB );
		} catch ( Exception e ) {
			// 画像作成に失敗したときの処理
			e.printStackTrace();
			return;
		}
 
		// 24ビットカラーの画像を作成
		try {
			// imgをoutname(出力PNG)に保存
			result = ImageIO.write( img, "png", new File( outname ) );
		} catch ( Exception e ) {
			// outname(出力PNG)の保存に失敗したときの処理
			e.printStackTrace();
			return;
		}

		// 正常に終了
		System.out.println( "正常に終了しました" );
	}
}

コンパイル ソースコードが「ANSI」の場合

C:\talavax\javasample>javac -encoding sjis CreateImage.java

コンパイル ソースコードが「UTF-8」の場合

C:\talavax\javasample>javac CreateImage.java

実行

C:\talavax\javasample>java CreateImage createimage.png 256 128

1つ目の引数で渡したPNGファイルを新しく作成します。その画像のサイズは、2つ目の引数で指定した幅ピクセル、3つ目の引数で指定した高さピクセルで作成されます。

・作成した画像(createimage.png)

新規画像

新しく、黒色のPNG画像が作成されました。

Javaソースコードの解説

ここからは、このソースコードを上から順番に解説していきます。

001
002
003
004
import java.awt.image.BufferedImage;
import java.io.File;
import javax.imageio.ImageIO;
import java.io.IOException;

Javaクラスライブラリの中から「java.awt.image.BufferedImage」と「java.io.File」と「javax.imageio.ImageIO」と「java.io.IOException」というパッケージにあるクラスを、このプログラム内で使うために記述します。 この記述により、ImageIOクラスBufferedImageクラスが利用できるようになります。

006
public class CreateImage {

クラス名を、CreateImageとしています。

007
	public static void main( String[] args ) {

このmainメソッドからプログラムを実行します。

008
009
010
011
012
013
014
015
		// 結果格納フラグ
		boolean result;
		// 画像サイズ
		int width, height;
		// ファイル名
		String outname;
		// 画像格納クラス
		BufferedImage img = null;

このプログラムで使う変数を宣言しています。どのように使われているかは、後ろのソースコードで。

017
018
019
020
021
022
		// 入力した引数が3つ以上かを調べる
		if ( 3 > args.length ) {
			// 入力した引数が3つ未満の場合、使用方法を表示する
			System.out.println( "CreateImage [出力PNG名] [幅] [高さ]" );
			return;
		}

1つ以上の引数が与えられたかをチェックし、1つ未満の場合に、使い方のメッセージを表示し、returnによってmainメソッドを抜けています。

024
025
		// 出力PNG名をoutnameに代入(拡張子".png"省略なし)
		outname = args[ 0 ];

与えられた1つ目の引数を、出力PNG名の変数(outname)代入しています。

027
028
029
030
031
032
033
034
035
036
		try {
			// 幅ピクセルをwidthに代入
			width  = Integer.parseInt( args[ 1 ] );
			// 高さピクセルをheightに代入
			height = Integer.parseInt( args[ 2 ] );
		} catch ( NumberFormatException e ) {
			// 引数をwidth、heightの変換に失敗したときの処理
			e.printStackTrace();
			return;
		}

与えられた2つ目と3つ目の引数を、それぞれ、幅ピクセルwidth、高さピクセルheightに代入しています。

038
039
040
041
042
043
		// 画像サイズの検査
		if ( ( 1 > width ) || ( 1 > height ) ) {
			// 画像のサイズに1より小さい値が指定されたとき処理
			System.out.println( "画像サイズが範囲外です" );
			return;
		}

ピクセルwidth、高さピクセルheightが1以上はどうかをチェックして、1未満であればエラーを表示して終了しています。

045
046
047
048
049
050
051
052
053
		// 24ビットカラーの画像を作成
		try {
			img = new BufferedImage( width, height,
						 BufferedImage.TYPE_INT_RGB );
		} catch ( Exception e ) {
			// 画像作成に失敗したときの処理
			e.printStackTrace();
			return;
		}

BufferedImageクラスコンストラクタで、新しいBufferedImageを構築しています。

BufferedImageコンストラクタ

BufferedImage( int width, int height, int imageType )
・新しい BufferedImage を構築します。
  パラメータ width     : 構築する画像の横ピクセル
        height    : 構築する画像の縦ピクセル
        imageType : 構築する画像のイメージ形式

imgTypeで指定しているTYPE_INT_RGBは、整数ピクセルにパックされた 8 ビット RGB 色成分によるイメージを表します。これを指定することで24ビット画像を作成できます。

try { ~ } catchは、失敗する可能性がある処理を波括弧で囲み、その処理に失敗したときにcatch { ~ }の波括弧で囲まれた処理を実行するということです。この場合は、PNGファイル名が不正であったり、存在していなかったり、フォーマットが違っているなどが原因で処理が失敗する可能性があります。処理が失敗するとreturnによってmainメソッドを抜けるようにしています。

055
056
057
058
059
060
061
062
063
		// 24ビットカラーの画像を作成
		try {
			// imgをoutname(出力PNG)に保存
			result = ImageIO.write( img, "png", new File( outname ) );
		} catch ( Exception e ) {
			// outname(出力PNG)の保存に失敗したときの処理
			e.printStackTrace();
			return;
		}

BufferedImageクラスのimgのメモリ内のデータを、出力PNG名の変数(outname)に格納されているファイル名で保存します。この場合は、PNGファイル名が不正であったり、保存先のHDDなどが存在していなかったり、空き容量が少ないなどが原因で処理が失敗する可能性があります。

ImageIO.wrireメソッド

public static boolean write( RenderedImage im, String formatName, File output ) throws IOException
・BufferedImageを画像ファイルに保存します。

  パラメータ RenderedImage : 保存するRenderedImage
                  formatName     : 画像ファイルのフォーマット(png/jpeg/bmp/gifなど)
                  output             : Fileオブジェクト

  戻り値     保存に成功するとtrue、失敗するとfalseを返します。
065
066
		// 正常に終了
		System.out.println( "正常に終了しました" );

全ての処理が正常終了すると、ここまで処理が実行されます。

以上です。

関連コンテンツ

画像フォーマット形式・色・大きさ・傾きなどの変更、特定の図形(文字・記号など)を見つけたり、取り出したりする画像処理について詳しく解説。

2015.11.29

一般に使われている画像の色の種類ってどんなものがありますか?。色の種類ごとの用途も説明しています。

2015.12.22

一般に使われている画像フォーマットには、いろいろな種類があります。画像フォーマットBMP、JPEG、PNG、GIF、TIFFの特徴を知ってますか?

2015.11.29

デジタル画像データを構成している要素について解説しています。

2015.12.22

PCやスマートフォンのディスプレイに表示されている色、プリンターで印刷される色の仕組みについて解説しています。

2020.03.23

Javaを使った簡単な応用プログラム(生年月日から年齢を計算プログラムなど)を紹介しています。

2022.07.07

Javaの学習に役立つソースコードを多数紹介しています。是非、ご覧ください。

2022.09.10

プログラミング、ITに関する用語をまとめています。

2022.10.17

条件式を判断して処理を分岐する方法を詳しく説明しています。

2023.03.20

Javaのmainメソッドで受け取るパラメータについて解説しています。

2017.09.26

mainメソッドで受け取るパラメータの数の取得の仕方について解説しています。

2019.05.14

変数やクラスに格納されている値をコンソール出力する方法は?

2020.03.23

メソッドを抜けるときに使用するreturn文について説明しています。

2020.03.20

プログラムの最初に実行されるメソッドは?

2022.12.13

プログラミングで使う変数って何?

2020.03.23

Javaのプログラムを書いてみませんか?プログラムの書き方をくわしく説明しています。

2020.03.23

「Javaソースコード」から実行可能な「オブジェクトコード」に変換する方法をくわしく説明しています。

2020.03.23

Javaのプログラムを作ってみませんか?プログラミングに必要なものの用意から実行までを説明しています。

2020.03.23

Swingパッケージを使ってグラフィック表示を行う方法を解説しています。

2020.03.23

繰り返し処理を使ったJavaのソースコードサンプルを紹介しています。

2020.03.23

配列を使うJavaソースコードを多数紹介しています。

2021.05.18

数学に関係するJavaのメソッドやソースコードなどを紹介しています。

2022.10.25

三角形、台形、円などいろいろな図形の面積を計算するプログラムを紹介しています。詳しくは、記事をご覧ください。

2021.05.18

StringクラスとStringBuilderクラスを利用したプログラミングの仕方を紹介しています。

2016.12.16

日本で使われてきた伝統文様「和柄」について解説しています。

2022.07.27

画像って何?

2022.07.25

ファイルは、データを取り扱うとき管理単位の一つで、ハードディスク、SSD,USBメモリ、CD/DVD/ブルーレイなどの記憶媒体に保存するときに使われます。詳しくは、記事をご覧ください。

2022.08.12

メソッドの定義方法を詳しく解説しています。Javaのサンプルソースコードを使った説明もあります。

2020.03.23

プログラミング言語とは?種類や特徴について説明しています。

2022.08.03

Javaプログラムの構成について解説しています。詳しくは、こちらをご覧ください。

2020.03.23

数値を2進数で表したときの各桁の「0」と「1」に対して演算を行えます。4種類の演算、AND(論理積)、OR(論理和)、XOR(排他的論理和)、NOT(否定)を詳しく説明しています。

2016.03.26

自然数と整数って何が違う?

2020.03.23

コンピュータに保存されたファイルを特定するための名前がファイル名です。その付け方は?

2016.11.23

コンピュータは、いくつかの装置から構成されています。その主な5つの装置(機能)って何?

2022.07.10

データを記憶する部品のことで、ハードディスク、ハードディスクドライブと呼ばれます。電源の供給がなくてもデータが消えない記憶装置です。

2022.07.14

「ゆるゆるプログラム」のコンテンツを紹介しています。興味のある方はこの記事をご覧ください。

2020.03.23

広告