更新日：2004/11/04 変更履歴 ------ Beta1からの変更点 * DrawTrack()関数を追加 軌跡情報表示のON/OFF デフォルトでは軌跡は表示されなくなった ■CAIBO3D 【機能】コンストラクタ 【戻り値】なし 【機能説明】内部オブジェクトおよび内部変数の初期化 【形式】 CAIBO3D::CAIBO3D() ■~CAIBO3D 【機能】デストラクタ 【戻り値】なし 【機能説明】内部オブジェクトおよび内部変数の後処理 【形式】 CAIBO3D::~CAIBO3D() ■Create3D 【機能】AIBO 3Dオブジェクト作成 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】parentのrect位置に子ウインドウを作成して AIBO 3D オブジェクトをその位置に描画できるように初期化 【形式】 int CAIBO3D::Create3D( DWORD model, // AIBOモデルID char *path, // グラフィックファイル(.Xファイル)のディレクトリパス名 HWND hWndParent, // 親ウインドウ RECT &rect, // 3D表示矩形（親ウインドウ内ローカル座標) COLORREF bkColor, // 背景色 COLORREF fColor) // ワイヤーフレーム色 ■Show 【機能】AIBO 3Dオブジェクトの表示、非表示の切り替え 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】AIBO 3Dオブジェクトの表示、非表示を切り替える 【形式】 int CAIBO3D::Show( BOOL showF) // 表示フラグ ■HomePosition 【機能】AIBO 3Dオブジェクトをホームポジションに移動 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】AIBO 3Dオブジェクトを初期位置に移動する 【形式】 int CAIBO3D::HomePosition( void ) ■RotateBody 【機能】AIBO 3Dオブジェクトの回転 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】AIBO 3Dオブジェクトを回転する 【形式】 int CAIBO3D::RotateBody( float pitch, // Ｘ軸回転角(度) float yaw, // Ｙ軸回転角(度) float roll, // Ｚ軸回転角(度) BOOL redraw) // 再描画フラグ ■GetBodyAngle 【機能】AIBO 3Dオブジェクトの回転角度の取得 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】AIBO 3Dオブジェクトの回転角度を取得する 【形式】 int CAIBO3D::GetBodyAngle( float *pitch, // Ｘ軸回転角(度)格納場所 float *yaw, // Ｙ軸回転角(度)格納場所 float *roll) // Ｚ軸回転角(度)格納場所 ■Set3DPosture 【機能】AIBO 3Dオブジェクトの姿勢の設定 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】AIBO 3Dオブジェクトの姿勢を設定する 【形式】 void CAIBO3D::Set3DPosture( int posture) // 姿勢ID(POSE_3D_NORMAL,..) ■MoveAIBOAnimation 【機能】AIBO 3Dオブジェクトの移動アニメーション 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】AIBO 3Dオブジェクトの移動を開始、終了する 【形式】 int CAIBO3D::MoveAIBOAnimation( BOOL startF, // TRUE: 移動開始、FALSE: 移動停止 float speed) // 移動量( /sec) ■RotateAIBOAnimation 【機能】AIBO 3Dオブジェクトの回転アニメーション 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】AIBO 3Dオブジェクトを回転させる 【形式】 int CAIBO3D::RotateAIBOAnimation( float dYaw, // 回転速度(度/sec) BOOL now) // TRUE: 直ちに回転する ■PlayAnimation 【機能】AIBO 3Dオブジェクトのモーション再生、アニメーションの開始 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】フレーム時間ごとのタイマーを起動してAIBO 3Dオブジェクトのモーション再生、アニメーションの開始させる 【形式】 int CAIBO3D::PlayAnimation( int repeat, // リピート回数(-1なら無限) BOOL bodyOnlyF, // TRUEならばBODYの回転動作だけおこなう DWORD delay) // 遅延時間(msec) ■StopAnimation 【機能】AIBO 3Dオブジェクトのモーション再生、アニメーションの終了 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】AIBO 3Dオブジェクトのモーション再生、アニメーションを終了する 【形式】 int CAIBO3D::StopAnimation() ■ClearTrack 【機能】軌跡情報の消去 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】軌跡情報をクリアして軌跡表示を消す 【形式】 int CAIBO3D::ClearTrack( BOOL resetF) // リセットフラグ TRUE: 原点に戻る、FALSE: 現在位置のまま ■DrawTrack 【機能】軌跡情報の表示 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】軌跡情報の表示、非表示を指定する。デフォルトは、軌跡非表示 【形式】 int CAIBO3D::ClearDraw( BOOL drawF) // 表示フラグ TRUE: 軌跡表示、FALSE: 軌跡非表示 ■RotateJoint 【機能】AIBO 3Dオブジェクトの各関節を回転 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】AIBO 3Dオブジェクトの各関節を回転させる 【形式】 int CAIBO3D::RotateJoint( int jointID, // 関節ID CpcInfo.h の enum JOINTS_ID {} で定義される float angle, // 回転角(度) BOOL redraw) // 再描画フラグ int CAIBO3D::RotateJoint( int *jointL, // 関節IDのリスト // CCpcInfo::GetJointArray(int *joints) で取得 float *angleL, // 回転角(度)のリスト int num, // リスト要素数 BOOL redraw) // 再描画フラグ ■SetColor 【機能】AIBO 3Dオブジェクトの各関節のマテリアル色の設定 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】AIBO 3Dオブジェクトの各関節のマテリアル色を設定する 角度を指定することで回転も同時に行える。 【形式】 int CAIBO3D::SetColor( int joint, // 関節ID CpcInfo.h の enum JOINTS_ID {} で定義される COLORREF rgb, // テクスチャ色 BOOL redrawF) // 再描画フラグ int CAIBO3D::SetColor( int joint, // 関節ID CpcInfo.h の enum JOINTS_ID {} で定義される COLORREF rgb, // テクスチャ色 float angle, // 回転角(度) BOOL redrawF) // 再描画フラグ ■GetColor 【機能】AIBO 3Dオブジェクトの各関節のマテリアル色の取得 【戻り値】関節のマテリアル色 【機能説明】AIBO 3Dオブジェクトの各関節のマテリアル色を取得する 【形式】 COLORREF CAIBO3D::GetColor( int joint) // 関節ID CpcInfo.h の enum JOINTS_ID {} で定義される ■MoveCamera 【機能】カメラの移動 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】カメラを移動する 【形式】 int CAIBO3D::MoveCamera( float x, // Ｘ軸位置 float y) // Ｙ軸位置 ■ZoomCamera 【機能】カメラのズーム 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】カメラをズームする 【形式】 int CAIBO3D::ZoomCamera( float zoom) // ズーム値 ■RotateCamera 【機能】カメラの回転 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】カメラを回転する 【形式】 int CAIBO3D::RotateCamera( float pitch, // Ｘ軸回転角(度) float yaw) // Ｙ軸回転角(度) ■GetCameraPos 【機能】カメラ位置の取得 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】カメラ位置を取得する 【形式】 int CAIBO3D::GetCameraPos( float *x, // カメラ位置Ｘ座標格納場所 float *y, // カメラ位置Ｙ座標格納場所 float *z) // カメラ位置Ｚ座標格納場所 ■GetCameraAngle 【機能】カメラ回転角度の取得 【戻り値】成功 : AIBO3D_NOERROR 失敗 : エラーコード (AIBO3D.h) 【機能説明】カメラ回転角度を取得する 【形式】 int CAIBO3D::GetCameraAngle( float *pitch, // カメラＸ軸回転角(度)格納場所 float *yaw) // カメラＹ軸回転角(度)格納場所 ■SetLight 【機能】ライト色の設定 【戻り値】なし 【機能説明】ライトの色を設定する 【形式】 void CAIBO3D::SetLight( COLORREF directLight, // ディレクショナルライト色 COLORREF pointLight, // ポイントライト色 COLORREF ambient) // アンビエント光色 ■SetFloorTexture 【機能】床面テクスチャの読み込み 【戻り値】なし 【機能説明】床面テクスチャを読み込む 【形式】 void CAIBO3D::SetFloorTexture( char* strFile) // ビットマップファイル名 void CAIBO3D::SetFloorTexture( int nID) // ビットマップリソースID ■SetBackTexture 【機能】背景テクスチャの読み込み 【戻り値】なし 【機能説明】背景テクスチャを読み込む 【形式】 void CAIBO3D::SetBackTexture( char* strFile) // ビットマップファイル名 void CAIBO3D::SetBackTexture( int nID) // ビットマップリソースID ■DeleteFloorTexture 【機能】床面テクスチャの削除 【戻り値】なし 【機能説明】表示中の床面テクスチャの削除 【形式】 void CAIBO3D::DeleteFloorTexture() ■DeleteBackTexture 【機能】背景テクスチャの削除 【戻り値】なし 【機能説明】表示中の背景テクスチャの削除 【形式】 void CAIBO3D::DeleteBackTexture() ■SetLocalRotationX 【機能】AIBO 3Dオブジェクトのローカル座標Ｘ軸回転 【戻り値】なし 【機能説明】AIBO 3Dオブジェクトのローカル座標をＸ軸回転する 【形式】 void CAIBO3D::SetLocalRotationX( float fX, // 回転角(度) BOOL redraw) // 再描画フラグ ■SetLocalRotationY 【機能】AIBO 3Dオブジェクトのローカル座標Ｙ軸回転 【戻り値】なし 【機能説明】AIBO 3Dオブジェクトのローカル座標をＹ軸回転する 【形式】 void CAIBO3D::SetLocalRotationY( float fY, // 回転角(度) BOOL redraw) // 再描画フラグ ■SetLocalRotationZ 【機能】AIBO 3Dオブジェクトのローカル座標Ｚ軸回転 【戻り値】なし 【機能説明】AIBO 3Dオブジェクトのローカル座標をＺ軸回転する 【形式】 void CAIBO3D::SetLocalRotationZ( float fZ, // 回転角(度) BOOL redraw) // 再描画フラグ ■SetLocalRotation 【機能】AIBO 3Dオブジェクトのローカル座標回転 【戻り値】なし 【機能説明】AIBO 3Dオブジェクトのローカル座標を回転する 【形式】 void CAIBO3D::SetLocalRotation( float fX, // Ｘ軸回転角(度) float fY, // Ｙ軸回転角(度) float fZ, // Ｚ軸回転角(度) BOOL redraw) // 再描画フラグ ■SetLocalTransfer 【機能】AIBO 3Dオブジェクトのローカル座標平行移動 【戻り値】なし 【機能説明】AIBO 3Dオブジェクトのローカル座標を平行移動する 【形式】 void CAIBO3D::SetLocalTransfer( float fX, // Ｘ軸移動座標 float fY, // Ｙ軸移動座標 float fZ, // Ｚ軸移動座標 BOOL redraw) // 再描画フラグ ■GetLocalRotation 【機能】AIBO 3Dオブジェクトのローカル座標回転量の取得 【戻り値】なし 【機能説明】AIBO 3Dオブジェクトのローカル座標を回転量を取得する 【形式】 void CAIBO3D::GetLocalRotation( float* pX, // Ｘ軸回転角(度)格納場所 float* pY, // Ｙ軸回転角(度)格納場所 float* pZ) // Ｚ軸回転角(度)格納場所 ■GetLocalTransfer 【機能】AIBO 3Dオブジェクトのローカル座標平行移動量の取得 【戻り値】なし 【機能説明】AIBO 3Dオブジェクトのローカル座標を平行移動量を取得する 【形式】 void CAIBO3D::GetLocalTransfer( float* pX, // Ｘ軸移動座標格納場所 float* pY, // Ｙ軸移動座標格納場所 float* pZ) // Ｚ軸移動座標格納場所 ■ShowCopyModel 【機能】AIBO 3Dオブジェクトのコピーモデルの表示、非表示の切り替え 【戻り値】なし 【機能説明】AIBO 3Dオブジェクトのコピーモデルの表示、非表示を切り替える 【形式】 void CAIBO3D::ShowCopyModel( int nIdx, // コピーモデルID(0〜MAX_COPYMODEL-1) BOOL isShow, // 表示フラグ BOOL redraw) // 再描画フラグ ■IsShowCopyModel 【機能】AIBO 3Dオブジェクトのコピーモデルの表示、非表示情報の取得 【戻り値】表示 : TRUE 非表示 : FALSE 【機能説明】AIBO 3Dオブジェクトのコピーモデルの表示、非表示情報を取得する 【形式】 BOOL CAIBO3D::IsShowCopyModel( int nIdx) // コピーモデルID(0〜MAX_COPYMODEL-1) ■SetCopyModelRotationX 【機能】AIBO 3Dオブジェクトのコピーモデルのローカル座標Ｘ軸回転 【戻り値】なし 【機能説明】AIBO 3Dオブジェクトのコピーモデルのローカル座標をＸ軸回転する 【形式】 void CAIBO3D::SetCopyModelRotationX( int nIdx, // コピーモデルID(0〜MAX_COPYMODEL-1) float fX, // 回転角(度) BOOL redraw) // 再描画フラグ ■SetCopyModelRotationY 【機能】AIBO 3Dオブジェクトのコピーモデルのローカル座標Ｙ軸回転 【戻り値】なし 【機能説明】AIBO 3Dオブジェクトのコピーモデルのローカル座標をＹ軸回転する 【形式】 void CAIBO3D::SetCopyModelRotationY( int nIdx, // コピーモデルID(0〜MAX_COPYMODEL-1) float fY, // 回転角(度) BOOL redraw) // 再描画フラグ ■SetCopyModelRotationZ 【機能】AIBO 3Dオブジェクトのコピーモデルのローカル座標Ｚ軸回転 【戻り値】なし 【機能説明】AIBO 3Dオブジェクトのコピーモデルのローカル座標をＺ軸回転する 【形式】 void CAIBO3D::SetCopyModelRotationZ( int nIdx, // コピーモデルID(0〜MAX_COPYMODEL-1) float fZ, // 回転角(度) BOOL redraw) // 再描画フラグ ■SetCopyModelRotation 【機能】AIBO 3Dオブジェクトのコピーモデルのローカル座標回転 【戻り値】なし 【機能説明】AIBO 3Dオブジェクトのコピーモデルのローカル座標を回転する 【形式】 void CAIBO3D::SetCopyModelRotation( int nIdx, // コピーモデルID(0〜MAX_COPYMODEL-1) float fX, // Ｘ軸回転角(度) float fY, // Ｙ軸回転角(度) float fZ, // Ｚ軸回転角(度) BOOL redraw) // 再描画フラグ ■SetCopyModelTransfer 【機能】AIBO 3Dオブジェクトのコピーモデルのローカル座標平行移動 【戻り値】なし 【機能説明】AIBO 3Dオブジェクトのコピーモデルのローカル座標を平行移動する 【形式】 void CAIBO3D::SetCopyModelTransfer( int nIdx, // コピーモデルID(0〜MAX_COPYMODEL-1) float fX, // Ｘ軸移動座標 float fY, // Ｙ軸移動座標 float fZ, // Ｚ軸移動座標 BOOL redraw) // 再描画フラグ ■GetCopyModelRotation 【機能】AIBO 3Dオブジェクトのコピーモデルのローカル座標回転量の取得 【戻り値】なし 【機能説明】AIBO 3Dオブジェクトのコピーモデルのローカル座標回転量を取得する 【形式】 void CAIBO3D::GetCopyModelRotation( int nIdx, // コピーモデルID(0〜MAX_COPYMODEL-1) float* pX, // Ｘ軸回転角(度)格納場所 float* pY, // Ｙ軸回転角(度)格納場所 float* pZ) // Ｚ軸回転角(度)格納場所 ■GetCopyModelTransfer 【機能】AIBO 3Dオブジェクトのコピーモデルのローカル座標平行移動量の取得 【戻り値】なし 【機能説明】AIBO 3Dオブジェクトのコピーモデルのローカル座標平行移動量を取得する 【形式】 void CAIBO3D::GetCopyModelTransfer( int nIdx, // コピーモデルID(0〜MAX_COPYMODEL-1) float* pX, // Ｘ軸移動座標格納場所 float* pY, // Ｙ軸移動座標格納場所 float* pZ) // Ｚ軸移動座標格納場所 ■IsShowDrawText2D 【機能】2Dテキストの表示フラグの取得 【戻り値】表示 : TRUE 非表示 : FALSE 【機能説明】2Dテキストの表示フラグを取得する 【形式】 BOOL CAIBO3D::IsShowDrawText2D() ■ShowDrawText2D 【機能】2Dテキストの表示、非表示の切り替え 【戻り値】なし 【機能説明】2Dテキストの表示、非表示を切り替える 【形式】 void CAIBO3D::ShowDrawText2D( BOOL isShow) // 表示、非表示 ■CreateDrawText2DSurface 【機能】2Dテキストの表示用サーフェイスの作成 【戻り値】成功 : TRUE 失敗 : FALSE 【機能説明】2Dテキストの表示用サーフェイスを作成する 【形式】 BOOL CAIBO3D::CreateDrawText2DSurface( int nWidth, // サーフェイスの幅 int nHeight) // サーフェイスの高さ ■SetDrawText2DString 【機能】2Dテキストの表示用文字列の登録 【戻り値】なし 【機能説明】2Dテキストの表示用文字列を登録する 【形式】 void CAIBO3D::SetDrawText2DString( char* strText) // 表示文字列 ■SetDrawText2DFont 【機能】2Dテキストの表示用フォントの登録 【戻り値】なし 【機能説明】2Dテキストの表示用フォントを登録する 登録されたフォントのDeleteは内部で行いますので独自にDeleteしないでください 【形式】 void CAIBO3D::SetDrawText2DFont( HFONT hFont) // フォント ■SetDrawText2DColor 【機能】2Dテキストの表示カラーの設定 【戻り値】なし 【機能説明】2Dテキストの表示カラーを設定する 【形式】 void CAIBO3D::SetDrawText2DColor( COLORREF color) // テキストカラー ■SetDrawText2DBackColor 【機能】2Dテキストの背景カラーの設定 【戻り値】なし 【機能説明】2Dテキストの背景カラーを設定する 背景透過をONにした場合は無視される 【形式】 void CAIBO3D::SetDrawText2DBackColor( COLORREF color) // 背景カラー ■SetDrawText2DBackTransparent 【機能】2Dテキストの背景透過の設定 【戻り値】なし 【機能説明】2Dテキストの背景透過を設定する 【形式】 void CAIBO3D::SetDrawText2DBackTransparent( BOOL isTransparent) // 透過フラグ ■SetDrawText2DDrawArea 【機能】2Dテキストの表示範囲の設定 【戻り値】なし 【機能説明】2Dテキストの表示範囲を設定する 【形式】 void CAIBO3D::SetDrawText2DDrawArea( int nSx, // 表示エリア内開始点X座標 int nSy, // 表示エリア内開始点Y座標 int nWidth, // 表示エリア内矩形幅 int nHeight) // 表示エリア内矩形高さ ■IsShowDrawText3D 【機能】3Dテキストの表示フラグの取得 【戻り値】表示 : TRUE 非表示 : FALSE 【機能説明】3Dテキストの表示フラグを取得する 【形式】 BOOL CAIBO3D::IsShowDrawText3D() ■ShowDrawText3D 【機能】3Dテキストの表示、非表示の切り替え 【戻り値】なし 【機能説明】3Dテキストの表示、非表示を切り替える 【形式】 void CAIBO3D::ShowDrawText3D( BOOL isShow) // 表示、非表示 ■CreateDrawText3DSurface 【機能】3Dテキストの表示用サーフェイスの作成 【戻り値】成功 : TRUE 失敗 : FALSE 【機能説明】3Dテキストの表示用サーフェイスを作成する 【形式】 BOOL CAIBO3D::CreateDrawText3DSurface( int nWidth, // サーフェイスの幅 int nHeight) // サーフェイスの高さ ■SetDrawText3DString 【機能】3Dテキストの表示用文字列の登録 【戻り値】なし 【機能説明】3Dテキストの表示用文字列を登録する 【形式】 void CAIBO3D::SetDrawText3DString( char* strText) // 表示文字列 ■SetDrawText3DFont 【機能】3Dテキストの表示用フォントの登録 【戻り値】なし 【機能説明】3Dテキストの表示用フォントを登録する 登録されたフォントのDeleteは内部で行いますので独自にDeleteしないでください 【形式】 void CAIBO3D::SetDrawText3DFont( HFONT hFont) // フォント ■SetDrawText3DColor 【機能】3Dテキストの表示カラーの設定 【戻り値】なし 【機能説明】3Dテキストの表示カラーを設定する 【形式】 void CAIBO3D::SetDrawText3DColor( COLORREF color) // テキストカラー ■SetDrawText3DBackColor 【機能】3Dテキストの背景カラーの設定 【戻り値】なし 【機能説明】3Dテキストの背景カラーを設定する 背景透過をONにした場合は無視される 【形式】 void CAIBO3D::SetDrawText3DBackColor( COLORREF color) // 背景カラー ■SetDrawText3DBackTransparent 【機能】3Dテキストの背景透過の設定 【戻り値】なし 【機能説明】3Dテキストの背景透過を設定する 【形式】 void CAIBO3D::SetDrawText3DBackTransparent( BOOL isTransparent) // 透過フラグ ■SetDrawText3DBasePoint 【機能】3Dテキストの表示位置の基点座標の設定 【戻り値】なし 【機能説明】3Dテキストの表示位置の基点座標を設定する 【形式】 void CAIBO3D::SetDrawText3DBasePoint( float fX, // 基点X座標 float fY, // 基点Y座標 float fZ) // 基点Z座標 ■SetDrawText3DDrawArea 【機能】3Dテキストの表示範囲の設定 【戻り値】なし 【機能説明】3Dテキストの表示範囲を設定する 【形式】 void CAIBO3D::SetDrawText3DDrawArea( float fBaseX, // 矩形内基点座標のX位置 float fBaseY, // 矩形内基点座標のY位置 float fWidth, // 3次元座標内矩形幅 float fHeight) // 3次元座標内矩形高さ ■GetVersion 【機能】バージョン情報取得 【戻り値】なし 【機能説明】ライブラリのバージョン情報を取得する（現在は空関数） 【形式】 void CAIBO3D::GetVersion( char *verString) // バージョン文字列格納先