gpmatprmt

マテリアルのパラメーター設定(テクスチャファイル)

gpmatprmt id,"name","filename"

id(0)      : マテリアルID/オブジェクトID
"name"     : パラメーター名
"filename" : 画像ファイル名
opt(0)     : マテリアルオプション値

(プラグイン / モジュール : hgimg4)

解説

生成されたマテリアルのシェーダーパラメーターを設定します。
gpmatprmt命令は、"filename"で指定されたファイルをテクスチャ画像としてシェーダーパラメーターに設定します。
あらかじめテクスチャが割り当てられているマテリアルを後から変更する際に使用してください。
この命令は、sampler2D型のパラメーターをシェーダーに渡す場合に使用することができます。これにより、マルチテクスチャを独自のシェーダーで扱うことが可能です。
パラメーター名を省略、または空文字("")にした場合は、HGIMG4の標準的なシェーダーパラメーター名「u_diffuseTexture」が使用されます。
optパラメーターに、GPOBJ_MATOPT_NOMIPMAPを指定した場合は、MIPMAPを生成しません。
また、optパラメーターに、GPOBJ_MATOPT_CUBEMAPを指定した場合は、テクスチャをキューブマップとして扱います。
キューブマップは、6面方向の画像をまとめた特殊な形式で環境マップやスカイボックスなどに利用することができます。
(キューブマップ画像は、+X,-X,+Y,-Y,+Z,-Z放送の6画像を縦に連結した1枚の.PNG形式を使用してください。)
既に読み込まれているマテリアルIDを使用してパラメーター設定を行う場合は、gpmatprmp命令をご使用ください。
また、テクスチャ設定を行うgpmatprmf命令も用意されています。

関連項目

gpmatprmマテリアルのパラメーター設定(hgimg4)
gpmatprm1マテリアルのパラメーター設定(1)(hgimg4)
gpmatprm2マテリアルのパラメーター設定(2)(hgimg4)
gpmatprm4マテリアルのパラメーター設定(4)(hgimg4)
gpmatprm16マテリアルのパラメーター設定(マトリクス)(hgimg4)
gpmatprmpマテリアルのパラメーター設定(マテリアルID)(hgimg4)
gpmatprmfマテリアルのテクスチャ詳細設定(hgimg4)

サンプル逆引き (4)

customshader.hsp
pronama3.hsp
pronama_box.hsp
tamane_face.hsp

情報

プラグイン / モジュールhgimg4
バージョン3.7
作成日2025/07/08
著作者onitama
URLhttps://hsp.tv/make/hgimg4.html
備考hgimg4.asまたはhgimg4dx.asをインクルードすること。
タイプ拡張命令
グループ拡張画面制御命令
対応環境
  • Windows 版 HSP
移植のヒントWindows/Linux/android/iOS等HGIMG4をサポートするシステム上で動作します。
Windowsの場合は、OpenGL3.1以降/DirectX9が必要です。
hs ファイルhsphelp\hgimg4.hs