com.docomostar.opt.ui.eruption
クラス Appearance

Object
  com.docomostar.opt.ui.eruption.Object3D
      com.docomostar.opt.ui.eruption.Animatable
          com.docomostar.opt.ui.eruption.Appearance

public final class Appearance
extends Animatable

IndexBuffer が表すサブメッシュに対するレンダリング属性を扱うクラスです。

レンダリング属性には主にテクスチャに関係するもの、色に関係するもの、ブレンド等のモードに関係するものがあります。 MascotCapsule eruption では 2 枚(インデックス 0 〜 1)のテクスチャを用いたマルチテクスチャが可能であるが、実際の使用可能枚数は実行環境に依存します。 なお、ポイントスプライトにおいては 0 枚目のテクスチャのみが使われるため、それ以降の設定は無視されます。

描画処理に当たってライティングまでの処理で使用する色情報を以下に示します。

ここで、環境光色は MCE_MATERIAL_TYPE_AMBIENT の Light からのみ使用されます。その他の色は MCE_MATERIAL_TYPE_AMBIENT 以外の Light から使用されます。 なお、ライティングを行う場合には各ライトの色の影響も受けることに注意してください。
さらに、テクスチャマッピングはこの後で行われるため、最終的な描画色はその影響も受けます。

端末によって、本クラスはサポートされていない場合があります。未サポートの場合、メソッドが呼び出された時点で UnsupportedOperationException が発生します。

グローバルIDについて

モデルデータに含まれる Animatable と Action、 Appearance と Texture の組ではグローバルID と呼ばれる番号を用いて関連付けます。両者間のグローバル ID が一致するもの同士でのみ関連付けられます。
ただし Action と Appearance に関してはグローバル ID の変更が可能です。
アクションデータの場合は以下のAPIにて関連付けが行われます。
Figure.bindAction(ActionTable)
Figure や EffectSource は以下の API を通じて関連付けます。
Figure.bindTexture(TextureTable)
EffectSource.bindTexture(TextureTable)

また、-1 のグローバルID は、上記 API による関連付けの対象外であることを示します。

フィールドの概要

static int	MCE_ALPHA_WRITE カラーバッファへのアルファ要素の書き込みを表します(=0x00000002)。
static int	MCE_BLEND_MODE_ALPHA ポリゴンに対するアルファブレンドを表します(=0)。
static int	MCE_BLEND_MODE_ALPHA_ADD ポリゴンに対する加算ブレンドを表します(=1)。
static int	MCE_BLEND_MODE_DST_DST_ALPHA OpenGL® ES のデスティネーション係数である GL_DST_ALPHA に相当します(=6)。
static int	MCE_BLEND_MODE_DST_ONE OpenGL® ES のデスティネーション係数である GL_ONE に相当します(=1)。
static int	MCE_BLEND_MODE_DST_ONE_MINUS_DST_ALPHA OpenGL® ES のデスティネーション係数である GL_ONE_MINUS_DST_ALPHA に相当します(=7)。
static int	MCE_BLEND_MODE_DST_ONE_MINUS_SRC_ALPHA OpenGL® ES のデスティネーション係数である GL_ONE_MINUS_SRC_ALPHA に相当します(=5)。
static int	MCE_BLEND_MODE_DST_ONE_MINUS_SRC_COLOR OpenGL® ES のデスティネーション係数である GL_ONE_MINUS_SRC_COLOR に相当します(=3)。
static int	MCE_BLEND_MODE_DST_SRC_ALPHA OpenGL® ES のデスティネーション係数である GL_SRC_ALPHA に相当します(=4)。
static int	MCE_BLEND_MODE_DST_SRC_COLOR OpenGL® ES のデスティネーション係数である GL_SRC_COLOR に相当します(=2)。
static int	MCE_BLEND_MODE_DST_ZERO OpenGL® ES のデスティネーション係数である GL_ZERO に相当します(=0)。
static int	MCE_BLEND_MODE_MODULATE ポリゴンに対する基本変調ブレンドを表します(=2)。
static int	MCE_BLEND_MODE_MODULATE_X2 ポリゴンに対する高輝度変調ブレンドを表します(=3)。
static int	MCE_BLEND_MODE_REPLACE ポリゴンに対する置換モードを表します(=4)。
static int	MCE_BLEND_MODE_SRC_DST_ALPHA OpenGL® ES のソース係数である GL_DST_ALPHA に相当します(=6)。
static int	MCE_BLEND_MODE_SRC_DST_COLOR OpenGL® ES のソース係数である GL_DST_COLOR に相当します(=2)。
static int	MCE_BLEND_MODE_SRC_ONE OpenGL® ES のソース係数である GL_ONE に相当します(=1)。
static int	MCE_BLEND_MODE_SRC_ONE_MINUS_DST_ALPHA OpenGL® ES のソース係数である GL_ONE_MINUS_DST_ALPHA に相当します(=7)。
static int	MCE_BLEND_MODE_SRC_ONE_MINUS_DST_COLOR OpenGL® ES のソース係数である GL_ONE_MINUS_DST_COLOR に相当します(=3)。
static int	MCE_BLEND_MODE_SRC_ONE_MINUS_SRC_ALPHA OpenGL® ES のソース係数である GL_ONE_MINUS_SRC_ALPHA に相当します(=5)。
static int	MCE_BLEND_MODE_SRC_SRC_ALPHA OpenGL® ES のソース係数である GL_SRC_ALPHA に相当します(=4)。
static int	MCE_BLEND_MODE_SRC_SRC_ALPHA_SATURATE OpenGL® ES のソース係数である GL_SRC_ALPHA_SATURATE に相当します(=8)。
static int	MCE_BLEND_MODE_SRC_ZERO OpenGL® ES のソース係数である GL_ZERO に相当します(=0)。
static int	MCE_COLOR_WRITE カラーバッファへの色要素の書き込みを表します(=0x00000004)。
static int	MCE_CULLING_MODE_CULL_BACK 背面カリングを表します(=0)。
static int	MCE_CULLING_MODE_CULL_FRONT 前面カリングを表します(=1)。
static int	MCE_CULLING_MODE_CULL_NONE カリングなしを表します(=2)。
static int	MCE_DEPTH_OFFSET デプスオフセットを表します(=0x00000080)。
static int	MCE_DEPTH_TEST デプステストを表します(=0x00000008)。
static int	MCE_DEPTH_WRITE デプスバッファへの書き込みを表します(=0x00000010)。
static int	MCE_DRAW_SILHOUETTE 輪郭線の描画を表します(=0x00000200)。
static int	MCE_LIGHT_TWO_SIDE 両面ライティングを表します(=0x00000100)。
static int	MCE_LIGHTING ライティング有効を表します(=0x00000001)。
static int	MCE_MATERIAL_TYPE_AMBIENT マテリアルに対する環境光色を表します(=0)。
static int	MCE_MATERIAL_TYPE_DIFFUSE マテリアルに対する拡散色を表します(=1)。
static int	MCE_MATERIAL_TYPE_EMISSIVE マテリアルに対する発光色を表します(=2)。
static int	MCE_MATERIAL_TYPE_SPECULAR マテリアルに対する鏡面反射色を表します(=3)。
static int	MCE_MAX_TEXTURE_NUM 使用可能テクスチャ数を表します(=2)。
static int	MCE_PERSPECTIVE_CORRECT パースペクティブコレクションを表します(=0x00000020)。
static int	MCE_SHADING_MODE_FLAT フラットシェーディングを表します(=0)。
static int	MCE_SHADING_MODE_GOURAUD グーローシェーディングを表します(=1)。
static int	MCE_TEXTURE_FILTER_LINEAR 4 近傍の加重平均を表します(=1)。
static int	MCE_TEXTURE_FILTER_LINEAR_MIPMAP_LINEAR 最適な 2 つのミップマップのそれぞれに対し 4 近傍の加重平均を取得しそれらの加重平均を表します(=5)。
static int	MCE_TEXTURE_FILTER_LINEAR_MIPMAP_NEAREST 最適なミップマップレベルにおける 4 近傍の加重平均を表します(=3)。
static int	MCE_TEXTURE_FILTER_NEAREST 最近傍を表します(=0)。
static int	MCE_TEXTURE_FILTER_NEAREST_MIPMAP_LINEAR 最適な 2 つのミップマップのそれぞれに対し最近傍を取得しそれらの加重平均を表します(=4)。
static int	MCE_TEXTURE_FILTER_NEAREST_MIPMAP_NEAREST 最適なミップマップレベルにおける最近傍を表します(=2)。
static int	MCE_TEXTURE_FILTER_TYPE_MAG テクスチャ拡大時のフィルタタイプを表します(=1)。
static int	MCE_TEXTURE_FILTER_TYPE_MIN テクスチャ縮小時のフィルタタイプを表します(=0)。
static int	MCE_TEXTURE_FUNC_ADD テクスチャに対する加算モードを表します(=1)。
static int	MCE_TEXTURE_FUNC_BLEND テクスチャに対するブレンドモードを表します(=2)。
static int	MCE_TEXTURE_FUNC_DECAL テクスチャに対する混合モードを表します(=3)。
static int	MCE_TEXTURE_FUNC_MODULATE テクスチャに対する乗算モードを表します(=4)。
static int	MCE_TEXTURE_FUNC_REPLACE テクスチャに対する置き換えモードを表します(=0)。
static int	MCE_TEXTURE_TYPE_COLORMAP 通常のテクスチャを表します(=0)。
static int	MCE_TEXTURE_TYPE_LIGHTMAP ライトマップテクスチャを表します(=2)。
static int	MCE_TEXTURE_TYPE_NORMALMAP 法線マップテクスチャを表します(=3)。
static int	MCE_TEXTURE_TYPE_PROJECTIVE 投影テクスチャを表します(=4)。
static int	MCE_TEXTURE_TYPE_REFLECTMAP 環境マップテクスチャを表します(=1)。
static int	MCE_TEXTURE_WRAP_CLAMP テクスチャのラッピングモード：クランプを表します(=1)。
static int	MCE_TEXTURE_WRAP_REPEAT テクスチャのラッピングモード：リピートを表します(=0)。
static int	MCE_USE_FIGURE_APPEARANCE Figure の Appearance を使用します(=0x00000800)。
static int	MCE_VERTEX_COLOR 頂点カラーを表します(=0x00000040)。
static int	MCE_VISIBLE 描画有効を表します(=0x00000400)。

クラス com.docomostar.opt.ui.eruption.Animatable から継承されたフィールド

MCE_MAX_ACTION_NUM

クラス com.docomostar.opt.ui.eruption.Object3D から継承されたフィールド

MCE_CLASS_TYPE_ACTION, MCE_CLASS_TYPE_ACTIONCONTROLLER, MCE_CLASS_TYPE_ACTIONTABLE, MCE_CLASS_TYPE_APPEARANCE, MCE_CLASS_TYPE_BONE, MCE_CLASS_TYPE_BONEDEFORMER, MCE_CLASS_TYPE_CAMERA, MCE_CLASS_TYPE_EFFECTSOURCE, MCE_CLASS_TYPE_FIGURE, MCE_CLASS_TYPE_GEOMETRICSHAPE, MCE_CLASS_TYPE_GRAPHICS3D, MCE_CLASS_TYPE_INDEXBUFFER, MCE_CLASS_TYPE_INTERSECTIONATTRIBUTES, MCE_CLASS_TYPE_LIGHT, MCE_CLASS_TYPE_MORPHDEFORMER, MCE_CLASS_TYPE_NODEDEFORMER, MCE_CLASS_TYPE_OBJECT3D, MCE_CLASS_TYPE_PARTICLE, MCE_CLASS_TYPE_TEXTURE, MCE_CLASS_TYPE_TEXTURETABLE, MCE_CLASS_TYPE_TRACKBALL, MCE_CLASS_TYPE_TRANSFORMTREE, MCE_CLASS_TYPE_VERTEXBUFFER

コンストラクタの概要

Appearance()
Appearance を生成します。

メソッドの概要

int	getAlphaThreshold() アルファテストの閾値を取得します。
int	getBlendModeDst() destination blending factor を取得します。
int	getBlendModeSrc() source blending factor を取得します。
int	getColor(int colorType) Appearance の色を取得します。
int	getCullingMode() カリングモードを取得します。
int	getDrawOrder() 描画順位を取得します。
float	getPolygonOffsetFactor() デプスオフセットの factor を取得します。
float	getPolygonOffsetUnits() デプスオフセットの unit を取得します。
Camera	getProjector(int ix) 投影テクスチャでプロジェクタとして使用するカメラを取得します。
int	getProperties() Appearance のプロパティを取得します。
int	getShadingMode() シェーディングモードを取得します。
int	getShininess() Appearance の輝度を取得します。
int	getSilhouetteColor() 輪郭線描画時の色を取得します。
float	getSilhouetteWidth() 輪郭線描画時の太さを取得します。
Light	getSoftwareLight(int ix) 設定されているライトマップ、法線マップで使用するライトを取得します。
Texture	getTexture(int ix) テクスチャを取得します。
int	getTextureBlendColor(int ix) テクスチャブレンドカラーを取得します。
int	getTextureBlendMode(int ix) テクスチャブレンドモードを取得します。
int	getTextureFilter(int ix, int type) テクスチャフィルタモードを取得します。
boolean	getTextureHint(int ix) Texture に対するヒントを取得します(環境マップに関してのみ有効です)。
int	getTextureRefGid(int ix) 関連付けるテクスチャのグローバルID を取得します。
int	getTextureType(int ix) テクスチャ種別を取得します。
int	getTextureUvStream(int ix) 使用するUV情報を取得します。
int	getTextureWrapModeS(int ix) Texture の S 方向のラッピングモードを取得します。
int	getTextureWrapModeT(int ix) Texture の T 方向のラッピングモードを取得します。
void	getTransform(int ix, Transform dst) テクスチャ座標に対する変換行列を取得します。
int	getUserData(int ix) ユーザデータを取得します。
void	setAlphaThreshold(int alphaThreshold) アルファテストの閾値を設定します。
void	setBlendMode(int mode) ブレンドモードを設定します。
void	setBlendMode(int src, int dst) source blending factor と destination blending factor を別々にブレンドモードを設定します。
void	setColor(int colorType, int abgr) Appearance の色を設定します。
void	setCullingMode(int mode) カリングモードを設定します。
void	setDrawOrder(int order) 描画順位を設定します。
void	setIdentity(int ix) テクスチャ座標の変換行列を恒等変換に設定します。
void	setPolygonOffset(float factor, float unit) デプスオフセットを設定します。
void	setProjector(int ix, Camera projector) 投影テクスチャでプロジェクタとして使用するカメラを設定します。
void	setProperties(int properties) Appearance のプロパティを設定します。
void	setRotateEuler(int ix, int type, Vector3D v) テクスチャ座標の変換行列の回転成分を設定します(オイラー指定)。
void	setScale(int ix, Vector3D v) テクスチャ座標の変換行列のスケール成分を設定します(ベクタ指定)。
void	setShadingMode(int mode) シェーディングモードを設定します。
void	setShininess(int shininess) Appearance の輝度を設定します。
void	setSilhouette(float width, int bgr) 輪郭線描画時のパラメータを設定します。
void	setSoftwareLight(int ix, Light light) ライトマップ、法線マップで使用するライトを設定します。
void	setTexture(int ix, Texture texture) テクスチャを設定します。
void	setTextureBlendColor(int ix, int abgr) テクスチャブレンドカラーを設定します。
void	setTextureBlendMode(int ix, int mode) テクスチャブレンドモードを設定します。
void	setTextureFilter(int ix, int type, int fmode) テクスチャフィルタモードを設定します。
void	setTextureHint(int ix, boolean hint) Texture に対するヒントを設定します(環境マップに関してのみ有効です)。
void	setTextureRefGid(int ix, int rgid) 関連付けるテクスチャのグローバルIDを設定します。
void	setTextureType(int ix, int type) テクスチャ種別を設定します。
void	setTextureUvStream(int ix, int uvStream) 使用するUV情報を設定します。
void	setTextureWrapMode(int ix, int wrapS, int wrapT) Texture のラッピングモードを設定します。
void	setTransform(int ix, Transform src) テクスチャ座標に対する変換行列を設定します。
void	setTranslate(int ix, Vector3D v) テクスチャ座標の変換行列の平行移動成分を設定します。
void	setUserData(int ix, int val) ユーザデータを設定します。

クラス com.docomostar.opt.ui.eruption.Animatable から継承されたメソッド

getAction, getAction, getActionController, getFrame, getRefGid, getRefGid, setAction, setAction, setActionController, setFrame, setRefGid, setRefGid, setUseActionControllerNum, updatePosture

クラス com.docomostar.opt.ui.eruption.Object3D から継承されたメソッド

dispose, equals, findObject3D, findObject3D, getClassType, getUserId, hashCode, isDisposed, isRenderEnable, setRenderEnable, setUserId

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

getClass, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

MCE_BLEND_MODE_ALPHA

public static final int MCE_BLEND_MODE_ALPHA

ポリゴンに対するアルファブレンドを表します(=0)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_ALPHA_ADD

public static final int MCE_BLEND_MODE_ALPHA_ADD

ポリゴンに対する加算ブレンドを表します(=1)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_MODULATE

public static final int MCE_BLEND_MODE_MODULATE

ポリゴンに対する基本変調ブレンドを表します(=2)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_MODULATE_X2

public static final int MCE_BLEND_MODE_MODULATE_X2

ポリゴンに対する高輝度変調ブレンドを表します(=3)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_REPLACE

public static final int MCE_BLEND_MODE_REPLACE

ポリゴンに対する置換モードを表します(=4)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_SRC_ZERO

public static final int MCE_BLEND_MODE_SRC_ZERO

OpenGL^® ES のソース係数である GL_ZERO に相当します(=0)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_SRC_ONE

public static final int MCE_BLEND_MODE_SRC_ONE

OpenGL^® ES のソース係数である GL_ONE に相当します(=1)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_SRC_DST_COLOR

public static final int MCE_BLEND_MODE_SRC_DST_COLOR

OpenGL^® ES のソース係数である GL_DST_COLOR に相当します(=2)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_SRC_ONE_MINUS_DST_COLOR

public static final int MCE_BLEND_MODE_SRC_ONE_MINUS_DST_COLOR

OpenGL^® ES のソース係数である GL_ONE_MINUS_DST_COLOR に相当します(=3)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_SRC_SRC_ALPHA

public static final int MCE_BLEND_MODE_SRC_SRC_ALPHA

OpenGL^® ES のソース係数である GL_SRC_ALPHA に相当します(=4)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_SRC_ONE_MINUS_SRC_ALPHA

public static final int MCE_BLEND_MODE_SRC_ONE_MINUS_SRC_ALPHA

OpenGL^® ES のソース係数である GL_ONE_MINUS_SRC_ALPHA に相当します(=5)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_SRC_DST_ALPHA

public static final int MCE_BLEND_MODE_SRC_DST_ALPHA

OpenGL^® ES のソース係数である GL_DST_ALPHA に相当します(=6)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_SRC_ONE_MINUS_DST_ALPHA

public static final int MCE_BLEND_MODE_SRC_ONE_MINUS_DST_ALPHA

OpenGL^® ES のソース係数である GL_ONE_MINUS_DST_ALPHA に相当します(=7)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_SRC_SRC_ALPHA_SATURATE

public static final int MCE_BLEND_MODE_SRC_SRC_ALPHA_SATURATE

OpenGL^® ES のソース係数である GL_SRC_ALPHA_SATURATE に相当します(=8)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_DST_ZERO

public static final int MCE_BLEND_MODE_DST_ZERO

OpenGL^® ES のデスティネーション係数である GL_ZERO に相当します(=0)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_DST_ONE

public static final int MCE_BLEND_MODE_DST_ONE

OpenGL^® ES のデスティネーション係数である GL_ONE に相当します(=1)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_DST_SRC_COLOR

public static final int MCE_BLEND_MODE_DST_SRC_COLOR

OpenGL^® ES のデスティネーション係数である GL_SRC_COLOR に相当します(=2)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_DST_ONE_MINUS_SRC_COLOR

public static final int MCE_BLEND_MODE_DST_ONE_MINUS_SRC_COLOR

OpenGL^® ES のデスティネーション係数である GL_ONE_MINUS_SRC_COLOR に相当します(=3)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_DST_SRC_ALPHA

public static final int MCE_BLEND_MODE_DST_SRC_ALPHA

OpenGL^® ES のデスティネーション係数である GL_SRC_ALPHA に相当します(=4)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_DST_ONE_MINUS_SRC_ALPHA

public static final int MCE_BLEND_MODE_DST_ONE_MINUS_SRC_ALPHA

OpenGL^® ES のデスティネーション係数である GL_ONE_MINUS_SRC_ALPHA に相当します(=5)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_DST_DST_ALPHA

public static final int MCE_BLEND_MODE_DST_DST_ALPHA

OpenGL^® ES のデスティネーション係数である GL_DST_ALPHA に相当します(=6)。

関連項目:

定数フィールド値

MCE_BLEND_MODE_DST_ONE_MINUS_DST_ALPHA

public static final int MCE_BLEND_MODE_DST_ONE_MINUS_DST_ALPHA

OpenGL^® ES のデスティネーション係数である GL_ONE_MINUS_DST_ALPHA に相当します(=7)。

関連項目:

定数フィールド値

MCE_MATERIAL_TYPE_AMBIENT

public static final int MCE_MATERIAL_TYPE_AMBIENT

マテリアルに対する環境光色を表します(=0)。

関連項目:

定数フィールド値

MCE_MATERIAL_TYPE_DIFFUSE

public static final int MCE_MATERIAL_TYPE_DIFFUSE

マテリアルに対する拡散色を表します(=1)。

関連項目:

定数フィールド値

MCE_MATERIAL_TYPE_EMISSIVE

public static final int MCE_MATERIAL_TYPE_EMISSIVE

マテリアルに対する発光色を表します(=2)。

関連項目:

定数フィールド値

MCE_MATERIAL_TYPE_SPECULAR

public static final int MCE_MATERIAL_TYPE_SPECULAR

マテリアルに対する鏡面反射色を表します(=3)。

関連項目:

定数フィールド値

MCE_CULLING_MODE_CULL_BACK

public static final int MCE_CULLING_MODE_CULL_BACK

背面カリングを表します(=0)。

関連項目:

定数フィールド値

MCE_CULLING_MODE_CULL_FRONT

public static final int MCE_CULLING_MODE_CULL_FRONT

前面カリングを表します(=1)。

関連項目:

定数フィールド値

MCE_CULLING_MODE_CULL_NONE

public static final int MCE_CULLING_MODE_CULL_NONE

カリングなしを表します(=2)。

関連項目:

定数フィールド値

MCE_SHADING_MODE_FLAT

public static final int MCE_SHADING_MODE_FLAT

フラットシェーディングを表します(=0)。

関連項目:

定数フィールド値

MCE_SHADING_MODE_GOURAUD

public static final int MCE_SHADING_MODE_GOURAUD

グーローシェーディングを表します(=1)。

関連項目:

定数フィールド値

MCE_TEXTURE_FUNC_REPLACE

public static final int MCE_TEXTURE_FUNC_REPLACE

テクスチャに対する置き換えモードを表します(=0)。

関連項目:

定数フィールド値

MCE_TEXTURE_FUNC_ADD

public static final int MCE_TEXTURE_FUNC_ADD

テクスチャに対する加算モードを表します(=1)。

関連項目:

定数フィールド値

MCE_TEXTURE_FUNC_BLEND

public static final int MCE_TEXTURE_FUNC_BLEND

テクスチャに対するブレンドモードを表します(=2)。

関連項目:

定数フィールド値

MCE_TEXTURE_FUNC_DECAL

public static final int MCE_TEXTURE_FUNC_DECAL

テクスチャに対する混合モードを表します(=3)。

関連項目:

定数フィールド値

MCE_TEXTURE_FUNC_MODULATE

public static final int MCE_TEXTURE_FUNC_MODULATE

テクスチャに対する乗算モードを表します(=4)。

関連項目:

定数フィールド値

MCE_TEXTURE_TYPE_COLORMAP

public static final int MCE_TEXTURE_TYPE_COLORMAP

通常のテクスチャを表します(=0)。

関連項目:

定数フィールド値

MCE_TEXTURE_TYPE_REFLECTMAP

public static final int MCE_TEXTURE_TYPE_REFLECTMAP

環境マップテクスチャを表します(=1)。

関連項目:

定数フィールド値

MCE_TEXTURE_TYPE_LIGHTMAP

public static final int MCE_TEXTURE_TYPE_LIGHTMAP

ライトマップテクスチャを表します(=2)。

関連項目:

定数フィールド値

MCE_TEXTURE_TYPE_NORMALMAP

public static final int MCE_TEXTURE_TYPE_NORMALMAP

法線マップテクスチャを表します(=3)。

関連項目:

定数フィールド値

MCE_TEXTURE_TYPE_PROJECTIVE

public static final int MCE_TEXTURE_TYPE_PROJECTIVE

投影テクスチャを表します(=4)。

関連項目:

定数フィールド値

MCE_LIGHTING

public static final int MCE_LIGHTING

ライティング有効を表します(=0x00000001)。

関連項目:

定数フィールド値

MCE_ALPHA_WRITE

public static final int MCE_ALPHA_WRITE

カラーバッファへのアルファ要素の書き込みを表します(=0x00000002)。

関連項目:

定数フィールド値

MCE_COLOR_WRITE

public static final int MCE_COLOR_WRITE

カラーバッファへの色要素の書き込みを表します(=0x00000004)。

関連項目:

定数フィールド値

MCE_DEPTH_TEST

public static final int MCE_DEPTH_TEST

デプステストを表します(=0x00000008)。

関連項目:

定数フィールド値

MCE_DEPTH_WRITE

public static final int MCE_DEPTH_WRITE

デプスバッファへの書き込みを表します(=0x00000010)。

関連項目:

定数フィールド値

MCE_PERSPECTIVE_CORRECT

public static final int MCE_PERSPECTIVE_CORRECT

パースペクティブコレクションを表します(=0x00000020)。

関連項目:

定数フィールド値

MCE_VERTEX_COLOR

public static final int MCE_VERTEX_COLOR

頂点カラーを表します(=0x00000040)。

関連項目:

定数フィールド値

MCE_DEPTH_OFFSET

public static final int MCE_DEPTH_OFFSET

デプスオフセットを表します(=0x00000080)。

関連項目:

定数フィールド値

MCE_LIGHT_TWO_SIDE

public static final int MCE_LIGHT_TWO_SIDE

両面ライティングを表します(=0x00000100)。

関連項目:

定数フィールド値

MCE_DRAW_SILHOUETTE

public static final int MCE_DRAW_SILHOUETTE

輪郭線の描画を表します(=0x00000200)。

関連項目:

定数フィールド値

MCE_VISIBLE

public static final int MCE_VISIBLE

描画有効を表します(=0x00000400)。

関連項目:

定数フィールド値

MCE_USE_FIGURE_APPEARANCE

public static final int MCE_USE_FIGURE_APPEARANCE

Figure の Appearance を使用します(=0x00000800)。

関連項目:

定数フィールド値

MCE_TEXTURE_WRAP_REPEAT

public static final int MCE_TEXTURE_WRAP_REPEAT

テクスチャのラッピングモード：リピートを表します(=0)。

関連項目:

定数フィールド値

MCE_TEXTURE_WRAP_CLAMP

public static final int MCE_TEXTURE_WRAP_CLAMP

テクスチャのラッピングモード：クランプを表します(=1)。

関連項目:

定数フィールド値

MCE_TEXTURE_FILTER_TYPE_MIN

public static final int MCE_TEXTURE_FILTER_TYPE_MIN

テクスチャ縮小時のフィルタタイプを表します(=0)。

関連項目:

定数フィールド値

MCE_TEXTURE_FILTER_TYPE_MAG

public static final int MCE_TEXTURE_FILTER_TYPE_MAG

テクスチャ拡大時のフィルタタイプを表します(=1)。

関連項目:

定数フィールド値

MCE_TEXTURE_FILTER_NEAREST

public static final int MCE_TEXTURE_FILTER_NEAREST

最近傍を表します(=0)。

関連項目:

定数フィールド値

MCE_TEXTURE_FILTER_LINEAR

public static final int MCE_TEXTURE_FILTER_LINEAR

4 近傍の加重平均を表します(=1)。

関連項目:

定数フィールド値

MCE_TEXTURE_FILTER_NEAREST_MIPMAP_NEAREST

public static final int MCE_TEXTURE_FILTER_NEAREST_MIPMAP_NEAREST

最適なミップマップレベルにおける最近傍を表します(=2)。

関連項目:

定数フィールド値

MCE_TEXTURE_FILTER_LINEAR_MIPMAP_NEAREST

public static final int MCE_TEXTURE_FILTER_LINEAR_MIPMAP_NEAREST

最適なミップマップレベルにおける 4 近傍の加重平均を表します(=3)。

関連項目:

定数フィールド値

MCE_TEXTURE_FILTER_NEAREST_MIPMAP_LINEAR

public static final int MCE_TEXTURE_FILTER_NEAREST_MIPMAP_LINEAR

最適な 2 つのミップマップのそれぞれに対し最近傍を取得しそれらの加重平均を表します(=4)。

関連項目:

定数フィールド値

MCE_TEXTURE_FILTER_LINEAR_MIPMAP_LINEAR

public static final int MCE_TEXTURE_FILTER_LINEAR_MIPMAP_LINEAR

最適な 2 つのミップマップのそれぞれに対し 4 近傍の加重平均を取得しそれらの加重平均を表します(=5)。

関連項目:

定数フィールド値

MCE_MAX_TEXTURE_NUM

public static final int MCE_MAX_TEXTURE_NUM

使用可能テクスチャ数を表します(=2)。

関連項目:

定数フィールド値

コンストラクタの詳細

Appearance

public Appearance()

Appearance を生成します。 初期値は以下の通りです。

• 環境光色 : 0x00333333
• 拡散色 : 0xffcccccc
• 発光色 : 0x00000000
• 鏡面反射色 : 0x00000000
• 輝度 : 0.0
• プロパティ: MCE_ALPHA_WRITE|MCE_COLOR_WRITE |MCE_DEPTH_TEST |MCE_DEPTH_WRITE |MCE_VISIBLE
• アルファの閾値 : 0.0
• PolygonOffsetFactor : 0.0
• PolygonOffsetUnits : 0.0
• 輪郭線の色 : 0x00000000
• 輪郭線の太さ : 0.0
• BlendModeSrc : MCE_BLEND_MODE_SRC_ONE
• BlendModeDst : MCE_BLEND_MODE_DST_ZERO
• カリングモード : MCE_CULLING_MODE_CULL_BACK
• シェーディングモード : MCE_SHADING_MODE_GOURAUD
• 描画順位 : 0
• ユーザーデータ : null

以下は 各テクスチャに関する初期値です。

• ブレンドモード : MCE_TEXTURE_FUNC_REPLACE
• ブレンドカラー : 0x00000000
• タイプ : MCE_TEXTURE_TYPE_COLORMAP
• S 方向のラッピングモード : MCE_TEXTURE_WRAP_REPEAT
• T 方向のラッピングモード : MCE_TEXTURE_WRAP_REPEAT
• minフィルタ : MCE_TEXTURE_FILTER_NEAREST
• maxフィルタ : MCE_TEXTURE_FILTER_NEAREST
• グローバルID : -1
• Texture 本体 : null
• ライト/ノーマルマップ用 Light : null
• 投影テクスチャ用 Camera : null
• ヒント : false

メソッドの詳細

setColor

public final void setColor(int colorType,
                           int abgr)

Appearance の色を設定します。

パラメータ:

colorType - カラータイプを指定します。指定できる値は以下の通りです。

• 環境光色指定 - MCE_MATERIAL_TYPE_AMBIENT
• 拡散色指定 - MCE_MATERIAL_TYPE_DIFFUSE
• 発光色指定 - MCE_MATERIAL_TYPE_EMISSIVE
• 鏡面反射色指定 - MCE_MATERIAL_TYPE_SPECULAR

abgr - 色(0xAABBGGRR) を指定します。

例外:

IllegalArgumentException -
colorType が不正な場合に発生します。

getColor

public final int getColor(int colorType)

Appearance の色を取得します。

パラメータ:

colorType - カラータイプを指定します。指定できる値は、以下の通りです。

• 環境光色指定 - MCE_MATERIAL_TYPE_AMBIENT
• 拡散色指定 - MCE_MATERIAL_TYPE_DIFFUSE
• 発光色指定 - MCE_MATERIAL_TYPE_EMISSIVE
• 鏡面反射色指定 - MCE_MATERIAL_TYPE_SPECULAR

戻り値:

色(0xAABBGGRR) を返します。
内部では処理に最適化された値が保持されているため、setColor(int, int) でセットした値とは必ずしも一致せず、若干の誤差を含む場合があります。

例外:

IllegalArgumentException -
colorType が不正な場合に発生します。

setShininess

public final void setShininess(int shininess)

Appearance の輝度を設定します。

輝度は鏡面反射光の計算に用いられます。この値が大きくなるにつれ、鏡面反射によるハイライトは狭い範囲に集中します。

パラメータ:

shininess - 輝度を指定します。

例外:

IllegalArgumentException -
shininess が [0, 255] 以外の場合に発生します。

getShininess

public final int getShininess()

Appearance の輝度を取得します。

戻り値:

輝度を返します。
内部では処理に最適化された値が保持されているため、setShininess(int) でセットした値とは必ずしも一致せず、若干の誤差を含む場合があります。

setProperties

public final void setProperties(int properties)

Appearance のプロパティを設定します。

パラメータ:

properties - プロパティを指定します。指定できる値は以下の通りです(複数指定可)。

• ライティング指定 - MCE_LIGHTING
• アルファ書き込み指定 - MCE_ALPHA_WRITE
• カラー書き込み指定 - MCE_COLOR_WRITE
• デプステスト指定 - MCE_DEPTH_TEST
• デプス書き込み指定 - MCE_DEPTH_WRITE
• パースペクティブコレクション指定 - MCE_PERSPECTIVE_CORRECT
• 頂点カラー指定 - MCE_VERTEX_COLOR
• デプスオフセット指定 - MCE_DEPTH_OFFSET
• 両面ライティング指定 - MCE_LIGHT_TWO_SIDE
• 輪郭線の描画指定 - MCE_DRAW_SILHOUETTE
• 描画有効 - MCE_VISIBLE
• Figure の Appearance を使用 - MCE_USE_FIGURE_APPEARANCE

getProperties

public final int getProperties()

Appearance のプロパティを取得します。

戻り値:

プロパティを返します。

setAlphaThreshold

public final void setAlphaThreshold(int alphaThreshold)

アルファテストの閾値を設定します。

この値が 0 よりも大きいときにはアルファテストが行われ、閾値を下回るものは描画されなくなります。

パラメータ:

alphaThreshold - アルファテストの閾値を指定します。

例外:

IllegalArgumentException -
alphaThreshold が [0, 255] 以外の場合に発生します。

getAlphaThreshold

public final int getAlphaThreshold()

アルファテストの閾値を取得します。

戻り値:

アルファテストの閾値を返します。

setPolygonOffset

public final void setPolygonOffset(float factor,
                                   float unit)

デプスオフセットを設定します。

デプステストとデプス書き込みの直前にピクセルの画面空間z座標に追加される値を設定します。
デプスオフセットは各ポリゴンについて以下の計算式が適用されます。
オフセット = m * factor + r * unit
m = ポリゴンの最大デプススロープ(z 勾配)
r = デプスバッファの識別可能な最小インクリメント

パラメータ:

factor - スロープに依存するデプスオフセットを指定します。

unit - コンスタントデプスオフセットを指定します。

getPolygonOffsetFactor

public final float getPolygonOffsetFactor()

デプスオフセットの factor を取得します。

戻り値:

setPolygonOffset(float, float) で設定された factor を返します。

getPolygonOffsetUnits

public final float getPolygonOffsetUnits()

デプスオフセットの unit を取得します。

戻り値:

setPolygonOffset(float, float) で設定された unit を返します。

setBlendMode

public final void setBlendMode(int mode)

ブレンドモードを設定します。

パラメータ:

mode - ブレンドモードを指定します。指定できる値は、以下の通りです。

• アルファブレンド指定 - MCE_BLEND_MODE_ALPHA
• 加算ブレンド指定 - MCE_BLEND_MODE_ALPHA_ADD
• 基本変調ブレンド指定 - MCE_BLEND_MODE_MODULATE
• 高輝度変調ブレンド指定 - MCE_BLEND_MODE_MODULATE_X2
• 置換モード指定 - MCE_BLEND_MODE_REPLACE

当 API の引数 と setBlendMode(int, int) の引数との関係は以下の通りです (プレフィックス は省略しています)。

例外:

IllegalArgumentException -
mode が不正な場合に発生します。

setBlendMode

public final void setBlendMode(int src,
                               int dst)

source blending factor と destination blending factor を別々にブレンドモードを設定します。

パラメータ:

src - source blending factorを指定します。指定できる値は以下の通りです。(sR, sG, sB, sA)

• (0, 0, 0, 0) - MCE_BLEND_MODE_SRC_ZERO
• (1, 1, 1, 1) - MCE_BLEND_MODE_SRC_ONE
• (Rd / kR , Gd / kG , Bd / kB, Ad / kA) - MCE_BLEND_MODE_SRC_DST_COLOR
• (1 −Rd / kR, 1 −Gd / kG, 1 −Bd / kB, 1 −Ad / kA) - MCE_BLEND_MODE_SRC_ONE_MINUS_DST_COLOR
• (As / kA, As / kA, As / kA, As / kA) - MCE_BLEND_MODE_SRC_SRC_ALPHA
• (1 −As / kA, 1 −As / kA, 1 −As / kA, 1 −As / kA) - MCE_BLEND_MODE_SRC_ONE_MINUS_SRC_ALPHA
• (Ad / kA, Ad / kA, Ad / kA, Ad / kA) - MCE_BLEND_MODE_SRC_DST_ALPHA
• (1 −Ad / kA, 1 −Ad / kA, 1 −Ad / kA, 1 −Ad / kA) - MCE_BLEND_MODE_SRC_ONE_MINUS_DST_ALPHA
• (f, f, f, 1); f = min(As / kA, 1 - Ad / kA) - MCE_BLEND_MODE_SRC_SRC_ALPHA_SATURATE

dst - destination blending factorを指定します。指定できる値は以下の通りです。 (dR, dG, dB, dA)

• (0, 0, 0, 0) - MCE_BLEND_MODE_DST_ZERO
• (1, 1, 1, 1) - MCE_BLEND_MODE_DST_ONE
• (Rs / kR, Gs / kG, Bs / kB, As / kA) - MCE_BLEND_MODE_DST_SRC_COLOR
• (1 - Rs / kR, 1 - Gs / kG, 1 - Bs / kB, 1 - As / kA) - MCE_BLEND_MODE_DST_ONE_MINUS_SRC_COLOR
• (Rs / kR, Gs / kG, Bs / kB, As / kA) - MCE_BLEND_MODE_DST_SRC_ALPHA
• (1 - As / kA, 1 - As / kA, 1 - As / kA, 1 - As / kA) - MCE_BLEND_MODE_DST_ONE_MINUS_SRC_ALPHA
• (Ad / kA, Ad / kA, Ad / kA, Ad / kA) - MCE_BLEND_MODE_DST_DST_ALPHA
• (1 - Ad / kA, 1 - Ad / kA, 1 - Ad / kA, 1 - Ad / kA) - MCE_BLEND_MODE_DST_ONE_MINUS_DST_ALPHA

Cs (C は R, G, B, A のいずれか) は source の各成分値、Cd はdestination の各成分値、kC は各成分を [0, 1] の区間内に収めるためのスケール値であり、 kC = s^ mC - 1 になります。
(mR, mG, mB, mA) はそれぞれ R, G, B, A のビットプレーン数です。

ブレンドの式は Rd = min( kR, Rs sR + Rd dR )
Gd = min( kG, Gs sG + Gd dG )
Bd = min( kB, Bs sB + Bd dB )
Ad = min( kA, As sA + Ad dA )

例外:

IllegalArgumentException -
src または dst が不正な場合に発生します。

getBlendModeSrc

public final int getBlendModeSrc()

source blending factor を取得します。

戻り値:

source blending factor を返します。

getBlendModeDst

public final int getBlendModeDst()

destination blending factor を取得します。

戻り値:

destination blending factor を返します。

setCullingMode

public final void setCullingMode(int mode)

カリングモードを設定します。

パラメータ:

mode - カリングモードを指定します。指定できる値は、以下の通りです。

• 背面カリング指定 - MCE_CULLING_MODE_CULL_BACK
• 前面カリング指定 - MCE_CULLING_MODE_CULL_FRONT
• カリングなし - MCE_CULLING_MODE_CULL_NONE

ポリゴンの裏表に関しては IndexBuffer を参照してください。

例外:

IllegalArgumentException -
mode が不正な場合に発生します。

getCullingMode

public final int getCullingMode()

カリングモードを取得します。

戻り値:

カリングモードを返します。

setShadingMode

public final void setShadingMode(int mode)

シェーディングモードを設定します。

パラメータ:

mode - シェーディングモードを指定します。指定できる値は、以下の通りです。

• フラットシェーディング指定 - MCE_SHADING_MODE_FLAT
• グーローシェーディング指定 - MCE_SHADING_MODE_GOURAUD

例外:

IllegalArgumentException -
mode が不正な場合に発生します。

getShadingMode

public final int getShadingMode()

シェーディングモードを取得します。

戻り値:

シェーディングモードを返します。

setDrawOrder

public final void setDrawOrder(int order)

描画順位を設定します。

orderが小さいものから描画します。

パラメータ:

order - 描画順位を指定します。

例外:

IllegalArgumentException -
order が [-32768, 32767] 以外の場合に発生します。

getDrawOrder

public final int getDrawOrder()

描画順位を取得します。

戻り値:

描画順位を返します。

setTextureBlendMode

public final void setTextureBlendMode(int ix,
                                      int mode)

テクスチャブレンドモードを設定します。

パラメータ:

ix - Texture のインデックスを指定します。

mode - テクスチャブレンドモードを指定します。指定できる値は、以下の通りです。

• 置き換えモード指定 - MCE_TEXTURE_FUNC_REPLACE
• 加算モード指定 - MCE_TEXTURE_FUNC_ADD
• ブレンドモード指定 - MCE_TEXTURE_FUNC_BLEND
• 混合モード指定 - MCE_TEXTURE_FUNC_DECAL
• 乗算モード指定 - MCE_TEXTURE_FUNC_MODULATE

アルファ有り、なしそれぞれのテクスチャに関して、各モードの意味は以下の通りです。ここで、C は各色、A はアルファ値を示します。添字は v が出力、t がテクスチャ、f が前段までの結果を表します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

IllegalArgumentException -
mode が不正な場合に発生します。

getTextureBlendMode

public final int getTextureBlendMode(int ix)

テクスチャブレンドモードを取得します。

パラメータ:

ix - Texture のインデックスを指定します。

戻り値:

テクスチャブレンドモードを返します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

setTextureBlendColor

public final void setTextureBlendColor(int ix,
                                       int abgr)

テクスチャブレンドカラーを設定します。

アルファ値の設定が可能ですが、現状の描画実装では無視されます。

パラメータ:

ix - Texture のインデックスを指定します。

abgr - ブレンドカラー(0xAABBGGRR)を指定します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

getTextureBlendColor

public final int getTextureBlendColor(int ix)

テクスチャブレンドカラーを取得します。

パラメータ:

ix - Texture のインデックスを指定します。

戻り値:

ブレンドカラー(0xAABBGGRR)を返します。 内部では処理に最適化された値が保持されているため、setTextureBlendColor(int, int) でセットした値とは必ずしも一致せず、若干の誤差を含む場合があります。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

setTextureWrapMode

public final void setTextureWrapMode(int ix,
                                     int wrapS,
                                     int wrapT)

Texture のラッピングモードを設定します。

パラメータ:

ix - Texture のインデックス(0 〜 1)を指定します。

wrapS - S方向(U方向)のラッピングモード(MCE_TEXTURE_WRAP_REPEAT or MCE_TEXTURE_WRAP_CLAMP)を指定します。

wrapT - T方向(V方向)のラッピングモード(MCE_TEXTURE_WRAP_REPEAT or MCE_TEXTURE_WRAP_CLAMP)を指定します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

IllegalArgumentException -
wrapS が不正な場合に発生します。

IllegalArgumentException -
wrapT が不正な場合に発生します。

getTextureWrapModeS

public final int getTextureWrapModeS(int ix)

Texture の S 方向のラッピングモードを取得します。

パラメータ:

ix - Texture を指定します。(0 〜 1)

戻り値:

Texture のラッピングモードを返します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

getTextureWrapModeT

public final int getTextureWrapModeT(int ix)

Texture の T 方向のラッピングモードを取得します。

パラメータ:

ix - Texture を指定します。(0 〜 1)

戻り値:

Texture のラッピングモードを返します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

setTextureFilter

public final void setTextureFilter(int ix,
                                   int type,
                                   int fmode)

テクスチャフィルタモードを設定します。

パラメータ:

ix - Texture のインデックスを指定します。

type - テクスチャフィルタタイプを指定します。指定できる値は、以下の通りです。

• テクスチャ縮小時のフィルタ指定 - MCE_TEXTURE_FILTER_TYPE_MIN
• テクスチャ拡大時のフィルタ指定 - MCE_TEXTURE_FILTER_TYPE_MAG

fmode - テクスチャフィルタモードを指定します。指定できる値は、以下の通りです。

• 最近傍 - MCE_TEXTURE_FILTER_NEAREST
• 4 近傍の加重平均 - MCE_TEXTURE_FILTER_LINEAR
• 最適なミップマップレベルにおける最近傍- MCE_TEXTURE_FILTER_NEAREST_MIPMAP_NEAREST
• 最適なミップマップレベルにおける4 近傍の加重平均- MCE_TEXTURE_FILTER_LINEAR_MIPMAP_NEAREST
• 最適な 2 つのミップマップのそれぞれに対し最近傍を取得しそれらの加重平均 - MCE_TEXTURE_FILTER_NEAREST_MIPMAP_LINEAR
• 最適な 2 つのミップマップのそれぞれに対し4 近傍の加重平均を取得しそれらの加重平均 - MCE_TEXTURE_FILTER_LINEAR_MIPMAP_LINEAR

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

IllegalArgumentException -
type が不正な場合に発生します。

IllegalArgumentException -
ix 番目に設定されているテクスチャがミップマップを使用しておらず、fmode が MCE_TEXTURE_FILTER_NEAREST_MIPMAP_NEAREST, MCE_TEXTURE_FILTER_LINEAR_MIPMAP_NEAREST, MCE_TEXTURE_FILTER_NEAREST_MIPMAP_LINEAR, MCE_TEXTURE_FILTER_LINEAR_MIPMAP_LINEAR のいずれかの場合に発生します。

IllegalArgumentException -
type が MCE_TEXTURE_FILTER_TYPE_MAG かつ fmode が MCE_TEXTURE_FILTER_NEAREST、MCE_TEXTURE_FILTER_LINEAR 以外の場合に発生します。

IllegalArgumentException -
type が MCE_TEXTURE_FILTER_TYPE_MIN かつ fmode が 不正な場合に発生します。

getTextureFilter

public final int getTextureFilter(int ix,
                                  int type)

テクスチャフィルタモードを取得します。

パラメータ:

ix - Texture のインデックスを指定します。

type - テクスチャフィルタタイプを指定します。指定できる値は、以下の通りです。

• テクスチャ縮小時のフィルタ指定 - MCE_TEXTURE_FILTER_TYPE_MIN
• テクスチャ拡大時のフィルタ指定 - MCE_TEXTURE_FILTER_TYPE_MAG

戻り値:

テクスチャフィルタモードを返します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

IllegalArgumentException -
type が不正な場合に発生します。

setTransform

public final void setTransform(int ix,
                               Transform src)

テクスチャ座標に対する変換行列を設定します。

パラメータ:

ix - Texture のインデックスを指定します。

src - 変換行列を指定します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

NullPointerException -
src が null の場合に発生します。

getTransform

public final void getTransform(int ix,
                               Transform dst)

テクスチャ座標に対する変換行列を取得します。

パラメータ:

ix - Texture のインデックスを指定します。

dst - 取得する変換行列の格納先を指定します。一度内部状態に変換されるため、セットされた値と同じ値になるとは限りません。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

NullPointerException -
dst が null の場合に発生します。

setIdentity

public final void setIdentity(int ix)

テクスチャ座標の変換行列を恒等変換に設定します。

パラメータ:

ix - Texture のインデックスを指定します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

setTranslate

public final void setTranslate(int ix,
                               Vector3D v)

テクスチャ座標の変換行列の平行移動成分を設定します。

パラメータ:

ix - Texture のインデックスを指定します。

v - 平行移動成分を表すベクトルを指定します。

例外:

NullPointerException -
v が null の場合に発生します。

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

setRotateEuler

public final void setRotateEuler(int ix,
                                 int type,
                                 Vector3D v)

テクスチャ座標の変換行列の回転成分を設定します(オイラー指定)。

パラメータ:

ix - Texture のインデックスを指定します。

type - 回転順を指定します。指定できる値は、以下の通りです。

• XYZ順 - Transform.MCE_ROTATE_EULER_XYZ
• XZY順 - Transform.MCE_ROTATE_EULER_XZY
• YXZ順 - Transform.MCE_ROTATE_EULER_YXZ
• YZX順 - Transform.MCE_ROTATE_EULER_YZX
• ZXY順 - Transform.MCE_ROTATE_EULER_ZXY
• ZYX順 - Transform.MCE_ROTATE_EULER_ZYX

v - 各軸の回転成分を表す Vector3D を指定します(1.0=360度)。

例外:

NullPointerException -
v が null の場合に発生します。

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

IllegalArgumentException -
type が不正な場合に発生します。

setScale

public final void setScale(int ix,
                           Vector3D v)

テクスチャ座標の変換行列のスケール成分を設定します(ベクタ指定)。

パラメータ:

ix - Texture のインデックスを指定します。

v - スケール成分を表すベクトルを指定します。

例外:

NullPointerException -
v が null の場合に発生します。

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

setTexture

public final void setTexture(int ix,
                             Texture texture)

テクスチャを設定します。

パラメータ:

ix - Texture のインデックスを指定します。

texture - 設定する Texture を指定します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

IllegalArgumentException -
Texture がミップマップを使用していない状態で、This 内の Appearance の MCE_TEXTURE_FILTER_TYPE_MIN に対応するテクスチャフィルタが MCE_TEXTURE_FILTER_NEAREST_MIPMAP_NEAREST, MCE_TEXTURE_FILTER_LINEAR_MIPMAP_NEAREST, MCE_TEXTURE_FILTER_NEAREST_MIPMAP_LINEAR, MCE_TEXTURE_FILTER_LINEAR_MIPMAP_LINEAR のいずれかの場合に発生します。

getTexture

public final Texture getTexture(int ix)

テクスチャを取得します。

パラメータ:

ix - Texture のインデックスを指定します。

戻り値:

Texture を返します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

setTextureRefGid

public final void setTextureRefGid(int ix,
                                   int rgid)

関連付けるテクスチャのグローバルIDを設定します。

パラメータ:

ix - Texture のインデックスを指定します。

rgid - 関連付けるテクスチャのグローバルID を指定します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

getTextureRefGid

public final int getTextureRefGid(int ix)

関連付けるテクスチャのグローバルID を取得します。

パラメータ:

ix - Texture のインデックスを指定します。

戻り値:

グローバルID を返します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

setTextureType

public final void setTextureType(int ix,
                                 int type)

テクスチャ種別を設定します。

パラメータ:

ix - Texture のインデックスを指定します。

type - テクスチャタイプを指定します。指定できる値は、以下の通りです。

• 通常テクスチャ指定 - MCE_TEXTURE_TYPE_COLORMAP
• 環境マップテクスチャ指定 - MCE_TEXTURE_TYPE_REFLECTMAP
• ライトマップテクスチャ指定 - MCE_TEXTURE_TYPE_LIGHTMAP
• 法線マップテクスチャ指定 - MCE_TEXTURE_TYPE_NORMALMAP
• 投影テクスチャ指定 - MCE_TEXTURE_TYPE_PROJECTIVE

各種別のマッピング手法は以下の通りです。

• スフィアマップ - 環境マッピングに使われ、視線と法線からテクスチャ座標が計算されます。
• ライトマップ - 視線の代わりにライト位置を用いてスフィアマップを適用します。ただしヒントは効かず、平行光源は平行投影、点光源は透視投影に対応します。計算手法はスフィアマップと同じであるため、平行光源の場合は光源に対して裏面を見せているポリゴンに対しても表側を向けているポリゴンと同じようにテクスチャが張られ、点光源の場合は特異点が発生します。
• 法線マップ - マッピング自体は通常のテクスチャと同じですが、テクスチャのRGB を法線の X, Y, Z 成分とみなし、ライトとの間でシェーディングの計算を行います。
• 投影テクスチャ - プロジェクタを設定し、そこからモデルに向けてテクスチャを投影します。プロジェクションシャドウ等に用いられます。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

IllegalArgumentException -
type が不正な場合に発生します。

getTextureType

public final int getTextureType(int ix)

テクスチャ種別を取得します。

パラメータ:

ix - Texture のインデックスを指定します。

戻り値:

テクスチャ種別を返します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

setSilhouette

public final void setSilhouette(float width,
                                int bgr)

輪郭線描画時のパラメータを設定します。

パラメータ:

width - 輪郭線の太さ(実際には元のモデルに対する拡大量となります。0.0 指定で等倍を表します)を指定します。

width は pixel 幅ではないことに注意してください。輪郭線描画は簡易的な描画手法を用いて行われます。 具体的には描画前に描画対象のカリングモードを前面カリングにしたうえで、width を元に拡大率を指定し、color の色で描画した後、通常の描画を行います。 そのため、アルファブレンドなどを併用した場合の描画結果は通常期待されるものとは異なります。拡大はメッシュの中心位置を基準に行われます。

bgr - 輪郭線の描画色(0xBBGGRR)を指定します。

例外:

IllegalArgumentException -
width が 0 未満の場合に発生します。

getSilhouetteWidth

public final float getSilhouetteWidth()

輪郭線描画時の太さを取得します。

戻り値:

輪郭線の太さを返します。

getSilhouetteColor

public final int getSilhouetteColor()

輪郭線描画時の色を取得します。

戻り値:

輪郭線の色(0xBBGGRR)を返します。

setSoftwareLight

public final void setSoftwareLight(int ix,
                                   Light light)

ライトマップ、法線マップで使用するライトを設定します。

パラメータ:

ix - Texture のインデックスを指定します。

light - Light オブジェクトを指定します。

ライトマップ、法線マップの効果を得るには事前にこのAPIで使用する Light を設定する必要があります。 Light.MCE_LIGHT_TYPE_DIRECTION の場合は 位置と方向、Light.MCE_LIGHT_TYPE_OMNI の場合は 位置情報のみが使用されます。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

IllegalArgumentException -
light が null以外、 かつ light のタイプが Light.MCE_LIGHT_TYPE_DIRECTION, Light.MCE_LIGHT_TYPE_OMNI 以外の場合に発生します。

getSoftwareLight

public final Light getSoftwareLight(int ix)

設定されているライトマップ、法線マップで使用するライトを取得します。

パラメータ:

ix - Texture のインデックスを指定します。

戻り値:

Light オブジェクトを返します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

setProjector

public final void setProjector(int ix,
                               Camera projector)

投影テクスチャでプロジェクタとして使用するカメラを設定します。

パラメータ:

ix - Texture のインデックスを指定します。

projector - Camera オブジェクトを指定します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

getProjector

public final Camera getProjector(int ix)

投影テクスチャでプロジェクタとして使用するカメラを取得します。

パラメータ:

ix - Texture のインデックスを指定します。

戻り値:

Camera オブジェクトを返します。

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

setTextureHint

public final void setTextureHint(int ix,
                                 boolean hint)

Texture に対するヒントを設定します(環境マップに関してのみ有効です)。

パラメータ:

ix - Texture のインデックスを指定します。

hint - ヒントを指定します。指定できる値は、以下の通りです。

• 品質優先 - true
• 速度優先 - false

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

getTextureHint

public final boolean getTextureHint(int ix)

Texture に対するヒントを取得します(環境マップに関してのみ有効です)。

パラメータ:

ix - Texture のインデックスを指定します。

戻り値:

ヒントを返します。返す値は以下の通りです。

• 品質優先 - true
• 速度優先 - false

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

setUserData

public final void setUserData(int ix,
                              int val)

ユーザデータを設定します。

1 つの Appearanceに対し、64個(インデックス[0, 63])までのユーザデータ(符号付32ビット)を 格納することが出来ます。初回呼び出し時にユーザデータ格納用の領域が確保されます。

パラメータ:

ix - ユーザデータのインデックスを指定します。

val - 設定する値を指定します。

例外:

IllegalArgumentException -
ix が [0, 63] 以外の場合に発生します。

getUserData

public final int getUserData(int ix)

ユーザデータを取得します。

パラメータ:

ix - ユーザデータのインデックスを指定します。

戻り値:

設定されたユーザデータを返します。

例外:

IllegalArgumentException -
ix が [0, 63] 以外の場合に発生します。

com.docomostar.lang.IllegalStateException -
ユーザデータ格納用の領域が存在しない ( setUserData(int, int) を一度も呼んでいない ) 場合に発生します。

getTextureUvStream

public final int getTextureUvStream(int ix)

使用するUV情報を取得します。

パラメータ:

ix - テクスチャのインデックスを指定します。

戻り値:

設定された使用するUV値を返します。返す値は以下の通りです。

• Texture0 - VertexBuffer.MCE_TEXTURE2D_0
• Texture1 - VertexBuffer.MCE_TEXTURE2D_1

例外:

IllegalArgumentException -
ix が [0, 1] 以外のな場合に発生します。

setTextureUvStream

public final void setTextureUvStream(int ix,
                                     int uvStream)

使用するUV情報を設定します。

パラメータ:

ix - テクスチャのインデックスを指定します。

uvStream - 使用するUV値を指定します。指定できる値は、以下の通りです。

• Texture0 - VertexBuffer.MCE_TEXTURE2D_0
• Texture1 - VertexBuffer.MCE_TEXTURE2D_1

例外:

IllegalArgumentException -
ix が [0, 1] 以外の場合に発生します。

IllegalArgumentException -
uvStream が不正な場合に発生します。