com.docomostar.opt.ui.j3d
クラス Texture

Object
  com.docomostar.opt.ui.j3d.Texture

public class Texture

extends Object

テクスチャのデータを保持するクラスを定義します。
テクスチャはモデルマッピングならびに環境マッピングのために使用されます。 コンストラクタでどちら用のものかを指定します。
モデルマッピング用のテクスチャは、Figureオブジェクトにセットして使用します。 モデルマッピング用のテクスチャに対しては陰影設定を行うことができます。
環境マッピング用のテクスチャは、Graphics3Dオブジェクトにセットして使用します。 環境マッピング用のテクスチャに対しては陰影設定を行うことはできません。
元となるテクスチャデータはBMP形式の8bitで非圧縮のもののみ使用できます。 画像のサイズが規定のサイズよりも大きい場合は、 不正なデータとして読み込み時に例外が発生します。 画像のサイズが規定のサイズより小さい場合や、規定のサイズに満たない領域の色は機種依存です。

導入されたバージョン:

Star-1.0

コンストラクタの概要

Texture(byte[] data, boolean forEnv)
テクスチャデータからテクスチャオブジェクトを生成します。

Texture(java.io.InputStream is, boolean forEnv)
テクスチャデータからテクスチャオブジェクトを生成します。

メソッドの概要

void	setNormalShader() 推奨されていません。 このメソッドの振る舞いが有効となるのは、 非推奨であるGraphics3D.drawFigure(Figure) メソッドでモデルを描画した時のみです。 このため、Graphics3D オブジェクトに対して陰影設定を行い、 Graphics3D.renderFigure(Figure) メソッドを使ってモデルの描画を行うことを推奨します。
void	setToonShader(int threshold, int high, int low) 推奨されていません。 このメソッドの振る舞いが有効となるのは、 非推奨であるGraphics3D.drawFigure(Figure) メソッドでモデルを描画した時のみです。 このため、Graphics3D オブジェクトに対して陰影設定を行い、 Graphics3D.renderFigure(Figure) メソッドを使ってモデルの描画を行うことを推奨します。

クラス Object から継承したメソッド

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

コンストラクタの詳細

Texture

public Texture(byte[] data,
               boolean forEnv)

テクスチャデータからテクスチャオブジェクトを生成します。
モデルマッピング用のテクスチャの場合、陰影設定は通常のモードになります。

パラメータ:

data - データを表すバイト列を指定します。

forEnv - 環境マッピングのために使う場合にtrueを指定します。

例外:

NullPointerException -
引数 data に null が指定された場合に発生します。

com.docomostar.ui.UIException -
(UNSUPPORTED_FORMAT)
データが不正な場合に発生します。

Texture

public Texture(java.io.InputStream is,
               boolean forEnv)
        throws java.io.IOException

テクスチャデータからテクスチャオブジェクトを生成します。
モデルマッピング用のテクスチャの場合、陰影設定は通常のモードになります。

パラメータ:

is - データのソースの入力ストリームを指定します。

forEnv - 環境マッピングのために使う場合にtrueを指定します。

例外:

NullPointerException -
引数 is に null が指定された場合に発生します。

java.io.IOException -
データを読み出す際に I/O エラーが起こった場合に発生します。

com.docomostar.ui.UIException -
(UNSUPPORTED_FORMAT)
データが不正な場合に発生します。

メソッドの詳細

setNormalShader

public void setNormalShader()

推奨されていません。 このメソッドの振る舞いが有効となるのは、 非推奨であるGraphics3D.drawFigure(Figure) メソッドでモデルを描画した時のみです。 このため、Graphics3D オブジェクトに対して陰影設定を行い、 Graphics3D.renderFigure(Figure) メソッドを使ってモデルの描画を行うことを推奨します。

このテクスチャが貼り付けられた物体の陰影設定を通常のモードに戻します。 setToonShader(int, int, int) メソッドの呼び出しを取り消します。

関連項目:

Graphics3D.enableToonShader(boolean)

例外:

com.docomostar.ui.UIException -
(ILLEGAL_STATE)
環境マッピング用のテクスチャに対して呼び出した場合に発生します。

setToonShader

public void setToonShader(int threshold,
                          int high,
                          int low)

推奨されていません。 このメソッドの振る舞いが有効となるのは、 非推奨であるGraphics3D.drawFigure(Figure) メソッドでモデルを描画した時のみです。 このため、Graphics3D オブジェクトに対して陰影設定を行い、 Graphics3D.renderFigure(Figure) メソッドを使ってモデルの描画を行うことを推奨します。

このテクスチャが貼り付けられた物体の陰影をトゥーンシェーディング にて描画するための情報を設定します。 シェーディング対象となる任意の点に対して、 通常の(グロー)シェーディングの結果として、その点の明るさが 元のテクスチャの明るさのd %と計算されたとすると、 このメソッド呼び出しにより、実際に描画される明るさは、 以下のようになります。

• d > threshold の時、 high % の明るさ。
• d ≤ thresholdの時、 low % の明るさ。

パラメータ:

threshold - 上記thresholdの値を指定します。 区間[0, 255]の値を指定することができ、 255が100%を表します。

high - 上記highの値を指定します。 区間[0, 255]の値を指定することができ、 255が100%を表します。

low - 上記lowの値を指定します。 区間[0, 255]の値を指定することができ、 255が100%を表します。

関連項目:

setNormalShader(), Graphics3D.enableToonShader(boolean), Graphics3D.setToonParam(int,int,int)

例外:

com.docomostar.ui.UIException -
(ILLEGAL_STATE)
環境マッピング用のテクスチャに対して呼び出した場合に発生します。

IllegalArgumentException -
引数のいずれかが区間[0, 255]に収まっていない場合に発生します。