DxLib 隠れ関数使用例

DxLibFanに戻る

1.Windowのハンドルを得る

extern HWND GetMainWindowHandle( void ) ;
というMainWindowを取得する関数がDxLib.hで定義されていますので、多分使えます。
よってMessageBoxとかで使用する場合に使うんだと思います。

こんな感じ
MessageBox( GetMainWindowHandle(), "メッセージが表示されました。", "MessageBox", MB_OK);

---

2.ソフトがアクティブかどうかを取得する

extern int GetActiveFlag( void ) ;
という関数でアクティブかどうかを取得できるようです。 さてさて、戻り値はいくらだ？
調べた結果
アクティブ時:return value = 1;
非アクティブ時:return value = 0;
という結果でした。
しかし、この関数はSetAlwaysRunFlag(int Flag);関数(非アクティブ時でも処理を行うかどうか？TRUEで処理を行う) の関数を呼び出しTRUEに設定してやらなきゃなりません。(少なくとも私の環境では)
ソフトをアクティブ状態に保つ場合は重宝するかもしれません。
(￣∧￣)(＿ ＿)フムフム・・・勉強になりました？
//使用したサンプル #include "DxLib.h" int WINAPI WinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow ) { ChangeWindowMode(TRUE); if( DxLib_Init() == -1 ) // ＤＸライブラリ初期化処理 { return -1; // エラーが起きたら直ちに終了 } SetAlwaysRunFlag(TRUE); int result; while(ProcessMessage()==0){ if(0!=CheckHitKey(KEY_INPUT_ESCAPE)) break; ScreenFlip(); if(result=GetActiveFlag()){ DrawFormatString(0,0,GetColor(255,255,255),"Result = %d",result); }else{ char str[128]; sprintf(str,"GetActiveFlagReturnValue = %d",result); MessageBox(GetMainWindowHandle(),str,"Message",MB_OK); DxLib_End(); exit(1); } } DxLib_End() ; // ＤＸライブラリ使用の終了処理 return 0 ;// ソフトの終了 }

---

3.ErrorLogAddとAddLogの違い

ErrorLogAddはDxLibが吐き出すAppLog.txtに吐き出す関数である
AddLogはprintfDxの元の関数である。

(｀□´)　以上である!(爆)

d金魚→ヽ(TдT(☆○=(｀◇´*)o 偉そうにするな！

てな訳で、自分のソフトが吐き出すTEXTファイルを作りたいですよね＾＾；
よって以下の関数を用意しました。DxLibを解剖して持ってきました。
(未完成品なので稀な条件によってバグが起こる。しかし実用上は問題ないと思う)
カレントディレクトリを変更するとおかしな場所にファイルが生成されます^^;
よってdSetCurrentDirectory関数を用意しました＾＾；
dAddLogの内部で呼び出せば常にカレントディレクトリです^^;が遅くなります。
#define DLOG "dLog.txt" bool dInitLog( void ) { FILE *fp; // エラーログファイルを開く if(NULL==(fp = fopen( D_LOG , "wt" ))){ return false; } fclose( fp ) ; return true; } bool dAddLog( char *str ){ FILE *fp; if(debug==true){ if(NULL != (fp = fopen( D_LOG , "at" ))){ // エラーログファイルに書き出す fputs( str , fp ) ; fclose( fp ) ; }else{//もし、ふぁいるがなかったら dInitLog(); dAddLog("ログファイルが無かったので初期化しなおしてます。\n"); dAddLog("よって、途中のログが無い場合があります。\n"); return false; } } return true; } bool dAddLogNum( char *str , ... ){ FILE *fp; char s[1024]; va_list VaList ; va_start( VaList , str ) ; vsprintf( s , str , VaList ) ; va_end( VaList ) ; if(NULL != (fp = fopen( D_LOG , "at" ))){ // エラーログファイルに書き出す fputs( s , fp ) ; fclose( fp ) ; }else{//もし、ふぁいるがなかったら dInitLog(); dAddLog("ログファイルが無かったので初期化しなおしてます。\n"); dAddLog("よって、途中のログが無い場合があります。\n"); return false; } return true; } /*貴方のソフトのディレクトリを カレントディレクトリに設定するらしい。 しかし、実験してない＾＾；*/ bool dSetCurrentDirectory(void){ char str[_MAX_PATH]; GetCurrentDirectory(//カレントディレクトリをゲット _MAX_PATH, // size, in characters, of directory buffer str // pointer to buffer for current directory ); //カレントﾃﾞｨレクトりにセット if(0 == SetCurrentDirectory(str/* パス名へのポインタ*/)){ return false; } return true; }

---

4.Windowのスタイルを変える

DxLibプログラミング質問掲示板より引用
新しい int SetWindowStyleMode( int Mode ) ; という関数を 追加しました。
今のところモードは０から２までの三つで、以下のようになっています。

０：今までどおりの普通のウインドウ
１：タイトルバーなし、縁あり
２：タイトルバーも縁もなし
使い方はそのまんま SetWindowStyleMode( 2 ) ; 等とやるだけです。
この関数は DxLib_Init 関数を呼ぶ前に使っておくと、起動時から ウインドウのスタイルを変えておくことが出来ます。

2002年12月17日現在の仕様
管理人さん。新しい関数有り難う　by　d金魚

5.GDI描画を必要とする場合

さて、DirectXでフルスクリーンにした時、ダイアログボックスとか表示したくなったことありませんか？
いや、私だけですか？DirectDrawで自分で実装するのは楽なのですが、さすがに大規模ライブラリのDxLibに手を加えるのは難しいです＾＾；
ソンな方の為に。奥さんチョット聞いて〜(意味不明)
int SetUseGDIFlag( int Flag ) ;// ＧＤＩ描画を必要とするか、を変更する
このような関数があります。
引数：TRUE=GDI描画を使用。FALSE=使用しない(デフォルト)
しかし、TRUEにしてしまうとバックバッファに書きこまないと上手く動作しないそうです。
ちなみにDxLibScreenSaverLibraryでも内部でこの関数を使用しています。

---

6.GUIDを設定してDualDisplayでも画面が選べるようにしよう

int SetDDrawUseGuid( GUID FAR *Guid ) ; // ＤｉｒｅｃｔＤｒａｗが使用するＧＵＤＩを設定する

d金魚が管理人さんに無理やり頼んで作っていただいた関数。
(管理人さん有り難うございます。ペコリ(o_ _)ｏ)))
DualDisplay(デュアルディスプレイ)とは、Windows98あたり？？からサポートされたらしい〜〜(爆)
ディスプレイを沢山用意してPCにつなげて画面領域を広げようという技術(だと思う)です。
Microsoftのフライトシミュレーターとかこれに対応してたような気がします。
さて、d金魚の環境ではAGPにGeForce256、PCIにSiS何たらとかのふる〜いGraphicCard(グラフィックカード)が刺さっていて、 普通ならAGPのから画面に出力します。が、しかし、他のグラフィックカードも試したい場合があるのです。
よってもう一つのディスプレイを隣のPC(d金魚の家のPCは2台並んで設置してある)からかっぱらってきてPCIのカードにつけて、 画面のプロパティで設定してDualDisplayにするのです。
画面領域が広くなり、快感ですよ〜〜＾＾
自慢するな〜！！！　　川｀0´)/☆#Ｔ。Ｔ）　アウッ！
ってなわけで、そのグラフィックカードでDxLibがどのような動作がするかが見たいわけです。
なのでこちら側でディスプレイアダプタのGUIDを列挙して選択し、 この関数に渡せば見事PCIの方のグラフィックカード(性能が悪い方)が選択されるわけです。
実際、DxLibでは内部で性能のよさそうなグラフィックアダプタを選んで描画させるようです。(いや？プライマリのまんまで描画かな？)
前、調べたんだけど忘れてしまった＾＾；
いつか確認します。また、GUIDの列挙の方法も後々解説します。
余談：普通にDirectDrawでコーディングしているとたしかデュアルディスプレイ環境では画面を使用するのが一つ二つにかかわらずに自動的にHELデバイスになると思った。(d金魚も経験)それで某ゲームがものすごく遅くなって使用不能になったことがある。市販品ならこのくらいの対処はしていて欲しい。

---

7.Get XX 系関数は使えるかも！？

__inline extern int GetDrawScreenSize( int *XBuf , int *YBuf ) ;// 描画サイズを取得する

int GetDrawArea( RECT *Rect ) ;// 描画可能領域を得る

DxLibで定義されているGet XX 系関数の一部です。XXとは、隠語の○○禁関連の意味ではなくて、 Get何たらかんたら系関数って意味です。(なんか分かりにくいかな？)

DxLib.hを見れば分かりますが、このGet系の関数は沢山あるのです。
その中でd金魚がよく使うものをちょっとだけ挙げてみました。
GetDrawScreenSizeはSetGraphModeで設定した奴(デフォでは640X480)のスクリーンのサイズが得られます。
GetDrawAreaはSetDrawAreaで指定した描画領域のサイズが得られると思いました。
これらの関数であなたが欲しい関数とかがあるかもしれません。
DxLibプログラミング質問検事版で質問する前によくよく捜したほうが無難だと思いますが＾＾どうでしょうか？

---

8.DxLibでマルチスレッドのアプリを作りたいんだけど…

int SetMultiThreadFlag( int Flag ); この関数を使います。(DxLibプログラミング掲示板より)

説明：
DirectDraw の協調レベルをマルチスレッド対応にするかどうかをセットする
この関数に TRUE を渡して呼んでやれば協調レベルの設定時にDDSCL_MULTITHREADED を使用します。

まぁ、DirectDrawの基礎知識が無いと意味分からないかもしれませんが^^;
DirectX7以前が好きなd金魚にはかなり興味深い関数なんですが＾＾；

2003/12/11追記
DxLib Extension Library Project 研究事項:DxLibでマルチスレッドは可能か？

---

9.メモリ上に展開したWAVEデータを読む

DxLibのVersionが2.00eの時に話題になったもの。
その時、このような関数が作られました。ogg等を読み込むのに必要だったのですが、2003年3月3日現在ではDxLibはoggをサポートしてます。
ちなみにoggとはオッグボービス（圧縮した音楽データのひとつ）の拡張子です。また、それの略称です。
今では、自分で暗号化したWAVEファイル等をメモリ上に複合化展開した時に必要になります。

int LoadSoundMemByMemImage2( void *UData, int UDataSize, WAVEFORMATEX *UFormat, int UHeaderSize ) ;
引数説明：
void *UData:メモリ上に展開されたＷＡＶＥデータが存在しているアドレス
int UDataSize:ＷＡＶＥデータのサイズ
WAVEFORMATEX *UFormat:ＷＡＶＥデータのフォーマット
int UHeaderSize:ＷＡＶＥデータのフォーマット情報のサイズを渡す

何故、第四引数にサイズを渡さなきゃいけないかと言うと、 WAVEFORMATEX 構造体の拡張構造体としてこの世のどこかで定義されているらしいからだそうです。

---

10.マウスのホイールの回転量を得よう！

int GetMouseWheelRotVol( void ) ; // マウスホイールの回転量を得る
です。
戻り値の説明：
＋だったら奥に回された。
−だったら手前に回された。

マウスのホイールは回転させるとキチキチ音がしますよね。（しないのもありますが）
個々のマウスによって違いますが、「あ！ひとつ回ったな！」みたいな感じが指に伝わりませんか？
それで数値１つ分になるそうです。
じゃぁ、ホイールを押した時の状態は何の関数で得るの！？
d金魚->　ウーン (Θ_Θ;)
(ノ>。☆)ノ 自分で実装してください

(▼▼;)σ オマエツカエネー
d金魚 -> (　┰_┰) シクシク

---