プラグインがオブジェクト情報を取得・設定する関数

1,GetName
このプラグインを使用しているオブジェクト名を取得します。

int GetName
(

char* szName

);

引数

szName

オブジェクト名文字列の先頭アドレスを取得するためのポインタ変数です。

返り値

オブジェクト名の取得に成功した時、0を返し、取得に失敗した時、0以外の整数を返します。

---

2,GetParent
このプラグインを使用しているオブジェクトの、親オブジェクト番号を取得します。

int GetParent(void);

引数

無し。

返り値

親オブジェクトの番号を返します。

現在、親オブジェクトが無いオブジェクトにこの関数を使用するとエラーが発生するという不具合が報告されています。

---

3,GetChild
このプラグインを使用しているオブジェクトの子オブジェクト番号を取得します。

int GetChild
(

int iOrder

);

引数

iOrder

0か1を入力。どちらを入力したかによって返り値が異なります。

0 … 最初の子オブジェクト番号です。
1 … この関数で取得された子オブジェクトの、次の子オブジェクトです。

返り値

子オブジェクトの番号を返します。これ以上子オブジェクトが検出されないという状態になった時には、-1を返します。

---

4,GetVertices
このプラグインを使用しているオブジェクトの頂点データを取得します。

int GetVertices
(

void* pVertices,
DWORD* pVertexCount

);

引数

pVertices

頂点座標の先頭アドレスを取得するためのポインタ変数です。

pVertexCount

頂点数を取得するためのポインタ変数です。pVerticesがNULLの時、pVertexCountにオブジェクトの頂点数が出力されます。

返り値

pVerticesがNULLで、頂点数の取得に成功した時、0を返し、取得に失敗した時、0以外の整数を返します。
pVerticesがNULLでは無い場合で、頂点座標の先頭アドレス取得に成功した場合、返り値は頂点数になります。

---

5,GetFaces
このプラグインを使用しているオブジェクトの面データを取得します。

int GetFaces
(

void* pFaces,
DWORD* pFaceCount

);

引数

pFaces

面データ（面を構成する頂点の番号）の先頭アドレスを取得するためのポインタ変数です。

pFaceCount

面数を取得するためのポインタ変数です。pFacesがNULLの時、pFaceCountにオブジェクトの面数が出力されます。

返り値

pFacesがNULLで、面数の取得に成功した時、0を返し、取得に失敗した時、0以外の整数を返します。
pFacesがNULLでは無い場合で、面データの先頭アドレス取得に成功した場合、返り値は面数を3倍した数値になります。

---

6,SetVerticesAndFaces
このプラグインを使用しているオブジェクトの頂点データと面データを設定します。

int GetFaces
(

void* pVertices,
DWORD dwVertexCount,
void* pFaces,
DWORD dwFaceCount

);

引数

pVertices

入力する頂点座標の先頭アドレスを格納するのポインタ変数です。

dwVertexCount

入力する頂点数です。

pFaces

入力する面データの先頭アドレスを格納するのポインタ変数です。

pFaceCount

入力する面数です。

返り値

データの設定に成功した時、0を返し、設定に失敗した時、0以外の整数を返します。

---

7,GetPosition
このプラグインを使用しているオブジェクトの移動量を取得します。

int GetPosition
(

float* pPosition

);

引数

pPosition

オブジェクトの移動量を取得するためのポインタ変数です。

返り値

移動量の取得に成功した時、0を返し、取得に失敗した時、0以外の整数を返します。

---

8,SetPosition
このプラグインを使用しているオブジェクトの移動量を設定します。

int SetPosition
(

float* pPosition

);

引数

pPosition

入力するオブジェクトの移動量を格納するポインタ変数です。

返り値

移動量の設定に成功した時、0を返し、設定に失敗した時、0以外の整数を返します。

---

9,GetRotation
このプラグインを使用しているオブジェクトの回転量を取得します。

int GetRotation
(

float* pRotation

);

引数

pRotation

オブジェクトの回転量を取得するためのポインタ変数。

返り値

回転量の取得に成功した時、0を返し、取得に失敗した時、0以外の整数を返します。

---

10,SetRotation
このプラグインを使用しているオブジェクトの回転量を設定します。

int SetRotation
(

float* pRotation

);

引数

pRotation

入力するオブジェクトの回転量を格納するポインタ変数です。

返り値

回転量の設定に成功した時、0を返し、設定に失敗した時、0以外の整数を返します。

---

11,SetRenderMode
このプラグインを使用しているオブジェクトの表示方法を設定します。

int SetRenderMode
(

int iRenderMode

);

引数

iRenderMode

以下のパラメーターを入力します。

0 … ワイヤーフレーム
1 … フラットシェーディング
2 … グローシェーディング
3 … テクスチャーつき
4 … ボックス表示

返り値

表示方法の設定に成功した時、0を返し、設定に失敗した時、0以外の整数を返します。

---

12,GetVertexColors
このプラグインを使用しているオブジェクトの、レンダリング時の頂点色を取得します。

int GetVertexColors
(

DWORD* pColor,
DLONG* pCount

);

引数

pColor

頂点の色データを取得するためのポインタ変数です。

pCount

頂点数を取得するためのポインタ変数です。pColorがNULLの時、pCountにオブジェクトの頂点数が出力されます。

返り値

pColorがNULLで、頂点数の取得に成功した時0を返し、取得に失敗した時、0以外の整数を返します。
pColorがNULLでは無い場合で、色データの先頭アドレス取得に成功した場合、返り値は頂点数になります。

---

13,SetVertexColors
このプラグインを使用しているオブジェクトの、レンダリング時の頂点色を設定します。

int SetVertexColors
(

DWORD* pColor,
ULONG ulCount

);

引数

pColor

入力する頂点の色を格納するポインタ変数です。

pCount

入力する頂点数です。

返り値

色情報の設定に成功した時、0を返し、設定に失敗した時、0以外の整数を返します。

---

14,GetFaceAttribute
このプラグインを使用しているオブジェクトの、面のアトリビュート（ラインの可視、不可視など）を取得します。

int GetFaceAttribute
(

ULONG ulFaceIndex,
ULONG* pAttribute

);

引数

ulFaceIndex

アトリビュートを取得したい面番号です。

pAttribute

アトリビュートを取得するためのポインタ変数です。

返り値

アトリビュートの取得に成功した時、0を返し、取得に失敗した時、0以外の整数を返します。

---

15,SetFaceAttribute
このプラグインを使用しているオブジェクトの、

int SetFaceAttribute
(

ULONG ulFaceIndex,
ULONG ulAttribute

);

引数

ulFaceIndex

アトリビュートを設定したい面番号です。

ulAttribute

設定したいアトリビュートです。

返り値

アトリビュートの設定に成功した時、0を返し、設定に失敗した時、0以外の整数を返します。