Visual Studio Community 2019 を使用した場合のDXライブラリの使い方


Visual Studio Community 2019 を使用してDXライブラリを使ったソフトを制作するには以下のような手順を踏みます。

1.DXライブラリを使うために必要なものを揃える

2.プロジェクトの作成

3.プロジェクトへ新規プログラムファイルを作成・追加

4.DXライブラリを使用するためのプロジェクトの設定を行う

5.プログラムを組む

6.プロジェクトのビルド、実行



1.DXライブラリを使うために必要なものを揃える

Visual Studio Community 2019 でDXライブラリを使うには以下のものが必要です。

・Visual Studio Community 2019
・DXライブラリ Windows版 VisualStudio( C++ )用

まず Visual Studio Community 2019 は、 プログラムをコンパイルして実行可能なソフトを作成する為のメインとなるソフトです。
こちらはマイクロソフトのこちらのページ『Visual Studio のダウンロード』 と書かれている項目から無償で入手することができますので、ありがたくインストールさせてもらって下さい。

インストールの際ですが、インストーラー( vs_community__745684224.1554021705.exe などのファイル名のファイル )を起動すると最初に『Visual Studio の何のバージョンをインストールするのかを選択するウィンドウ』が表示されますので、 Visual Studio Community 2019『インストール』ボタンを押してください。

『インストール』ボタンを押すと、次にインストールする機能を選択するダイアログが表示されますので、そこでは上部のタブを『ワークロード』を選択した状態にした後、 下の項目からは『C++ によるデスクトップ開発』にチェックを入れてからダイアログ右下にある『インストール』を押してインストールを開始してください。

二つ目の DXライブラリ Windows版 VisualStudio( C++ )用は本サイトのこちらのページからダウンロードすることができます。 これがないとDXライブラリを使うことができませんので、まだダウンロードされていない方は『DXライブラリ Windows版 VisualStudio( C++ )用』をダウンロードしておいてください。



2.プロジェクトの作成

ソフトウエアを開発する準備ができましたので、早速一つ簡単なソフトを作ってみましょう。
ここでは『画面の中心に点を打つ』という動作をするソフトを作る手順を記したいと思います。
Visual Studio Community 2019 でソフトを作るにはまず『プロジェクト』を作成する必要があるので以下にその方法を記します。

① Visual Studio Community 2019 の起動メニューで『新しいプロジェクトを作成』をクリックして、
  『新しいプロジェクトの作成』ダイアログを表示します。

② ダイアログ上部の『プラットフォーム』の右側にある下矢印マークをクリックして『Windows』を選択した後、
  下のリストから『Windows デスクトップ ウィザード』を選択してから、
  ダイアログ右下の『次へ(N)』をクリックします。

③ 次に『新しいプロジェクトを構成します』というダイアログが表示されたら、最初にプロジェクトの名前を
  『プロジェクト名』に入力します。ここでは仮に『test』とします。

④ 次にプロジェクトのプロジェクトを作成するフォルダパスを『場所』に入力します。

⑤ 『ソリューションとプロジェクトを同じディレクトリに配置する』の
  チェックを付けてから『作成(C)』をクリックします。

⑥ 次に『Windows デスクトップ プロジェクト』ダイアログが表示されるので、
  最初に『アプリケーションの種類(T)』の項目を『デスクトップ アプリケーション (.exe)』に変更します。

⑦ 次に『空のプロジェクト(E)』にチェックを入れて右下の『OK』ボタンを押します。

これでプロジェクトの作成は完了です。



3.プロジェクトへ新規プログラムファイルを作成・追加

『プロジェクト』の作成が済みましたので、 次にソフトウエアの本体であるプログラムを記述するためプログラムファイルを新規に一つ作成してプロジェクトに追加します。

① Visual Studio Community 2019 のメニューから
  『プロジェクト(P)』→『新しい項目の追加(W)...』を選び、『新しい項目の追加』ダイアログを開きます。

② ウインドウ左側の『インストール済み』から『VisualC++』を選び、
  右側の項目からは『C++ファイル(.cpp)』を選び、下の『名前(N):』欄にファイル名
  を入力し(ここでは仮に『DrawPixel.cppとします』)、『追加(A)』ボタンをクリックします。

これでプログラムファイルの新規追加は完了ですが、
一番最初のプログラムファイルを追加した時だけ、次の作業を行ってください。



4.DXライブラリを使用するためのプロジェクトの設定を行う

早速プログラムを組みたいところですが、最初のプログラムファイルを追加した後はDXライブラリを使用するプログラムのコンパイルに必要なプロジェクトの設定を行います。
ちょっと操作の数が多くてうんざりしますが、ソフト1つにつき一回だけですので、根気よく手順を追ってください。

① Visual Studio Community 2019 のメニューの
  『プロジェクト(P)』→『(プロジェクト名) のプロパティ(E)...』を選んで、
  プロジェクトのプロパティダイアログを開きます。
  ( ( プロジェクト名 ) の部分は、今回は『test』になっている筈です )

② 次にダイアログの左上にある『構成(C):』と書かれている項目を『アクティブ(Debug)』から『すべての構成』に、
  『構成(C):』の右側にある『プラットフォーム(P):』と書かれている項目を『アクティブ(Win32)』から
  『すべてのプラットフォーム』変更します。

③ 次にダイアログの左側のリストから『構成プロパティ』→『詳細』を選びます。

④ 次にダイアログ右側に表示されている『文字セット』の項目を
  『マルチ バイト文字セットを使用する』に変更したあと、ダイアログ右下にある『適用(A)』ボタンを押します。

⑤ 次に左側のリストから『構成プロパティ』→『C/C++』→『全般』を選びます。

⑥ 次に右側に表示されている『追加のインクルードディレクトリ』の項目にDXライブラリのパッケージ内に
  入っている『プロジェクトに追加すべきファイル_VC用』フォルダのパスを入力してから、
  再度ダイアログ右下にある『適用(A)』ボタンを押します。
  ( パスの例→  c:\DxLib_VC\プロジェクトに追加すべきファイル_VC用
  尚、DXライブラリをマイドキュメントフォルダに入れるとこれらのパス指定が面倒になりますので
  DXライブラリはなるべく浅いフォルダに入れておくことをお勧めします )

⑦ 次に左側のリストから『構成プロパティ』→『リンカー』→『全般』を選びます。

⑧ 次に右側に表示されている『追加のライブラリディレクトリ』の項目に⑥と全く同じDXライブラリの
  パッケージ内に入っている『プロジェクトに追加すべきファイル_VC用』フォルダのパスを
  入力してから、再度ダイアログ右下にある『適用(A)』ボタンを押します。

⑨ 次にダイアログの左上にある『構成(C):』と書かれている項目を『すべての構成』から
  『Release』に変更します。

⑩ 左側のリストから今度は『構成プロパティ』→『C/C++』→『コード生成』を選びます。

⑪ ダイアログ右側に表示されている『ランタイム ライブラリ』の項目を
  『マルチスレッド(/MT)』に変更したあと、ダイアログ右下にある『適用(A)』ボタンを押します。

⑫ ダイアログの左上にある『構成(C):』と書かれている項目を『Release』から
  『Debug』に変更します。

⑬ ダイアログ右側に表示されている『ランタイム ライブラリ』の項目を
  今度は『マルチスレッド デバッグ(/MTd)』に変更します。

⑭ 最後にダイアログの下の方にある『OK』を押してダイアログを閉じます。

以上です、お疲れ様でした。
さて、新たに作成されたプログラムファイルには何も書かれていないので、
次に示すプログラムを入力します。



5.プログラムを組む

後はプログラムを組むだけです。
今回サンプルとして実行するプログラムは次のようになります。

#include "DxLib.h" // プログラムは WinMain から始まります int WINAPI WinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow ) { if( DxLib_Init() == -1 ) // DXライブラリ初期化処理 { return -1 ; // エラーが起きたら直ちに終了 } DrawPixel( 320 , 240 , GetColor( 255,255,255 ) ) ; // 点を打つ WaitKey() ; // キー入力待ち DxLib_End() ; // DXライブラリ使用の終了処理 return 0 ; // ソフトの終了 }



プログラムはこれだけです、どの部分が何をしているのか簡単に説明します。 まず最初の1行はDXライブラリを使用するために必要なファイル( DxLib.h )をインクルードしています。
次の 『int WINAPI WinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow )』 は Windows用ソフトのプログラムのスタート地点となる関数の宣言です。それぞれの単語が何を意味しているかは特に考える必要はありません。 ウインドウ環境のスタート関数はすべてこの形の宣言をとります。
中括弧関数最初の文『if( DxLib_Init() == -1 ){ return -1 ; }』はDXライブラリを初期化して使える状態にするために必要な関数『DxLib_Init』を呼んでいます。 この関数はDXライブラリを使うプログラムを組む際には例外を除いてまず最初に呼び出す必要があります。 因みに『if(...』と書かれているのは初期化が失敗したらその時点でソフトを終了させるという処理を行うための物です。
『DrawPixel』はそのまま点を描画するための関数です。
その次の『WaitKey』はキーが押されるまで処理を止める関数です。
最後の『DxLib_End() ;』は注釈にも書いてある通りDXライブラリの使用を終了する処理を行う関数を呼んでいる文です。 DXライブラリを使用しているプログラムは最後に必ずこの関数を呼ばなくてはなりません。



6.プロジェクトのビルド、実行

入力が終ったら実行してみましょう。実行するためには

① Visual Studio Community 2019 のメニューから『デバッグ(D)』→『デバッグの開始(S)』

② すると『このプロジェクトは変更されています(T): ビルドしますか?』と出るので『はい(Y)』を押します。

③ エラーがなければ実行されます。エラーがあった場合は画面下のウインドウ
  にエラー内容が出てきますので指示にしたがって修正してください。

画面中心に点が描画されたでしょうか?
実行するまでにかなり長かったような気がしますがその殆どが Visual Studio Community 2019 でのソフトウエア制作に必ず必要な作業ですので幾つかプログラムを組んでいけばすぐに慣れてしまう筈です。


さてできあがった実行可能ファイルですが、それはプロジェクトのフォルダの中の『Debug』フォルダか『Release』フォルダの中に作成されます。これがこれまでの作業の成果となります。
これでDXライブラリを使ってのソフト制作の方法はわかりました。後は好きにプログラムを組んでゲームを作るだけです。ですがまだDXライブラリの機能は初期化と終了とドットを描画する関数しかわかっていません。
この他の関数はDXライブラリ関数リファレンスのページで解説されていますのでそちらを参照して下さい。





戻る