BitmapTexture : TextureMap

Bitmaptexture - superclass: textureMap; super-superclass:material - classID: #(576, 0)

値 > MAXWrapper > マテリアル > テクスチャマップ > BitmapTexture

マテリアルとマップ - クイックナビゲーション

コンストラクタ

bitmaptexture... 	 
bitmaptex...

プロパティ

<Bitmaptexture>.bitmap Bitmap default: Bitmap:

テクスチャマップのビットマップです。

スクリプトは、このビットマップ上のビットマップを操作でき、テクスチャマップに変更が反映されます。

マテリアルエディタやビューポートで変更したビットマップの結果を参照するには、マテリアルエディタのユーザインタフェースを使っていずれかのビットマップの Texture プロパティを修正する必要があります。

<Bitmaptexture>.filename Filenamedefault: "" -- alias: file_name

ビットマップファイル名です。

<Bitmaptexture>.filtering Integer default: 0

ビットマップのアンチエイリアシングに使用するピクセル平均化メソッド:

0 - [ピラミッド](Pyramidal) (必須メモリが少なく、多目的に利用できます。)

1 - [合計領域](Summed Area) (より多くのメモリが必要ですが、一般に優れた結果が得られます。)

2 - [なし](None) (フィルタリングをオフにします。)

<Bitmaptexture>.monoOutput Integer default: 0

不透明度や鏡面反射光レベルなどのパラメータは、3 つの値からなるカラーコンポーネントなどと異なり、単一の値を保持します。このグループのコントロールは、出力モノクロチャネルのソースを、入力ビットマップとの関係で決定します。

0 - [RGB 強度](RGB Intensity) (マッピングに赤、緑、青のチャネルの強度を使用します。ピクセルの色は無視され、ピクセルの値または輝度だけが使用されます。カラーは、0 (黒) から 255 (白) までのグレーの値として計算されます。)

1 - [アルファ](Alpha) (アルファチャネルの強度をマッピングに使用します。

<Bitmaptexture>.RGBOutput Integer default: 0

RGB がどこから出力したかを指定します。この領域のコントロールは、カラーを表示するマテリアル要素のマップにのみ影響します。すなわち、周囲光、拡散反射光、鏡面反射光、フィルタカラー、反射、屈折です。

0　- [RGB] (ピクセルのフルカラー値を表示します。)

1 - [アルファ(グレー)](Alpha as Gray) (アルファチャネルのレベルに基づき、グレーの濃淡で表示します。)

<Bitmaptexture>.apply Boolean default: false

クロップまたは配置設定を使用する場合、オンにします。

<Bitmaptexture>.cropPlace Integer default: 0

クロップまたは配置をアクティブにするかどうかを設定します。

0 - クロップ

1 - 配置

<Bitmaptexture>.clipu Float default: 0.0 -- animatable, alias: clip_u_offset

ビットマップ位置を U 軸に沿って調整します。

<Bitmaptexture>.clipv Float default: 0.0 -- animatable, alias: clip_v_offset

ビットマップ位置を V 軸に沿って調整します。

<Bitmaptexture>.clipw Float default: 1.0 -- animatable, alias: clip_u_width

ビットマップの幅を調整します。

<Bitmaptexture>.cliph Float default: 1.0 -- animatable, alias: clip_v_width

ビットマップの高さを調整します。

<Bitmaptexture>.jitter Float default: 1.0 -- animatable, alias: jitter_placement

ランダムオフセットの量です。0 を指定するとランダムオフセットは使用されません。

<BitmapTex>.useJitter Boolean default: false -- boolean

.jitter (ジッター) 値を適用します。

<Bitmaptexture>.alphasource Integer default: 0

このグループのコントロールは、出力アルファチャネルのソースを、入力ビットマップとの関係で決定します。

0 - [イメージアルファ](Image Alpha) (イメージのアルファチャネルを使用します。)

1 - [RGB 強度](RGB Intensity) (ビットマップのカラーをグレースケール値に変換して、透明度に使用します。黒は透明に、白は不透明になります。)

2 - [なし](None) (不透明。透明度を使用しません。)

<Bitmaptexture>.preMultAlpha Boolean default: true

ビットマップでのアルファの処理方法を設定します。既定値はオンで、事前に掛け合わされたアルファがファイル内に存在すると見なされます。チェックマークを消すと、アルファは乗算なしとして処理され、RGB 値が無視されます。

<Bitmaptexture>.starttime Timedefault: 0f

アニメートされたビットマップ(一連の単一フレームを記述した AVI、MOV、IFL などのマルチフレームファイル)が先頭フレームを再生する、シーンの時間範囲のフレームを取得/設定します

<Bitmaptexture>.playbackrate Float default: 1.0

アニメートされたビットマップ (一連の単一フレームを記述したAVI、MOV、IFL などのマルチフレーム) の再生速度を取得/設定します。このプロパティを利用して、アニメーションの速度を速くしたり遅くしたりすることができます。たとえば、1.0 で通常の速度 (シーンタイムフレームあたり 1 ビットマップフレーム)、2.0 で 2 倍の速度 (シーンタイムフレームごとにビットマップフレームを 1 秒おきに表示)、.333 で元の速度の 3 分の 1 の速度 (各ビットマップフレームを 3 シーンタイムフレーム保持) などのようになります。

<Bitmaptexture>.endcondition Integer default: 0

これらのコントロールでは、アニメーションの最終フレーム終了後の設定を行います。

0 - [ループ](Loop) (アニメーションを繰り返し再生します。)

1 - [ピンポン](Ping Pong) (アニメーションを逆方向に再生し、すべてのアニメート化されたシーケンスを「滑らかにループ」させます。)

2 - [停止](Hold) (シーンが終了するまで、アニメーションの最終フレームをサーフェス上でフリーズさせます。)

<Bitmaptexture>.tieTimeToMatIDs BooleanClass default: false -- boolean; Tie_Time_to_Mat_IDs

[時間](Time)ロールアウト内の[パーティクルエージにフレームを同期](Sync Frames to Particle Age)チェックボックスに対応しています。

<Bitmaptexture>.coords StandardUVGen -- alias: coordinates

StandardUVGen プロパティについては、「UVGenClass」を参照してください。

<Bitmaptexture>.output StandardTextureOutput

StandardTextureOutput については、「TexOutputClass」を参照してください。

メソッド

<Bitmaptexture>.reload()

ビットマップを再ロードします。ユーザインタフェースの[再ロード](Reload)ボタンを押した場合に相当します。

<Bitmaptexture>.viewImage()

イメージソースを表示します。ユーザインタフェースの[表示](View)ボタンを押した場合に相当します。

注: これらのメソッドは、bitmapTexture インタフェースで説明したものと同じであることに注意してください。

例

-- get the diffuse map from the first material in Material Editor
dif_map = meditMaterials[1].diffusemap
-- if the diffuse map is a bitmap texture, show it
if classof dif_map == BitmapTexture do dif_map.viewImage()

関連するメソッド

enumerateFiles [<MAXWrapper_obj>] <function> [<arg>][#inactive] [#videoPost] [#render] [#missing] [#localOnly]

シーンまたは個別のオブジェクトで使用するすべてのビットマップファイルに目を通すことができます。非アクティブビットマップファイルや足りないビットマップファイルだけを返すようにフィルタすることができます。

このメソッドのパラメータの詳細については、「ビットマップファイル」を参照してください。

freeSceneBitmaps()

画像ファイルのビットマップキャッシュが使用しているメモリをすべて解放します。これはメモリがさまざまなビットマップでフラグメント化されており、現在アクティブなものだけを再ロードしたい場合に便利です。

usedMaps()

このメソッドにより、現在のシーンで使用されているすべてのビットマップテクスチャのファイル名文字列を含む配列が返されます。

注:

ビットマップテクスチャは[マテリアルエディタ](Material Editor)のみで表示されますが、シーンへの割り当ては実行されません。

このメソッドには、オプションで次のような MAXWrapper 引数が存在しています。

usedMaps [<MAXWrapper>]

MAXWrapper が指定されたら、メソッドは、そのオブジェクトによって使用されているビットマップテクスチャの一覧を返します。すべてのマテリアルエディタのビットマップテクスチャを含めるには、次の例を使用できます。

例

fn allUsedMaps =
(
sceneMaps = usedMaps()
for m in meditmaterials do join sceneMaps (usedMaps m)
sceneMaps
)

bitmapTexture インタフェース:

Interface: bitmapTex

メソッド

<void>reload()

同じ名前およびパスを使用して、ビットマップファイルを再ロードします。ペイントプログラムでビットマップの更新後に再ロードを行う場合、ファイルブラウザを使用する必要はありません。

マップの任意のインスタンスに対して[再ロード](reload)をクリックすると、すべてのサンプルスロットおよびシーンでマップが更新されます。

<void>viewImage()

領域アウトラインで囲まれたビットマップを示す、仮想フレームバッファを表示します。領域アウトラインの側面と四隅にハンドルが表示されます。[クロップ](cropping)ラジオボタンが選択されているときは、ハンドルをドラッグするとトリミング領域のサイズが変わります。また、トリミング領域内をドラッグして移動することもできます。

[仮想フレームバッファ](VFB)編集ウィンドウのツールバーには、[U]、[V]、および[W]、[H] (幅、高さ) のスピナーがあります。これらを使用して、配置を調整し、イメージまたはトリミング領域のサイズを変更することができます。

[配置](Place)ラジオボタンが選択されているときは、配置領域のハンドルをドラッグすると、ビットマップのスケールが変わります。このとき Ctrl を押しておくと、ビットマップのアスペクト比は変わりません。

[クロップ](Crop)ラジオボタンが選択されているときは、仮想フレームバッファのツールバーの右にある[UV]ボタンまたは[XY]ボタンを使用して、ツールバーのスピナーの UV または XY 座標の使用を切り替えることができます。また、キーボードのShift+ Z を押して縮小、Z を押して拡大することもできます。