/
index.html
212 lines (161 loc) · 8.19 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
<!DOCTYPE html>
<html lang='ja'>
<head>
<meta charset="UTF-8">
<link rel='stylesheet' type='text/css' href='dxruby-code-highlight.css' />
<link rel='stylesheet' type='text/css' href='dxruby.css' />
<title>DXRuby 1.4.6 リファレンスマニュアル</title>
</head>
<body>
<header>DXRuby 1.4.6 <span class="title">Reference Manual</span></header>
<section id="document">
<section id="content">
<h1>DXRuby 1.4.6 リファレンスマニュアル</h1>
<h2>目次</h2>
<ol>
<li><a href="#AUTOINDEXANCHOR_0">はじめに</a></li>
<li><a href="#AUTOINDEXANCHOR_1">マニュアル</a></li>
<li><a href="#AUTOINDEXANCHOR_2">DXRubyの特徴</a></li>
<li><a href="#AUTOINDEXANCHOR_3">インストール方法</a></li>
<li><a href="#AUTOINDEXANCHOR_4">ライセンス</a></li>
</ol>
<hr>
<p><a name='AUTOINDEXANCHOR_0'></a></p>
<h2>はじめに</h2>
<p>DXRubyは、オブジェクト指向スクリプト言語RubyからDirectXを扱う為の拡張ライブラリです。<br>
Rubyを使ってWindows用2Dアクションゲームなどを作ることができます。<br>
このヘルプファイルはDXRubyのリファレンスマニュアルとなっております。</p>
<ul>
<li>プロジェクトWeb
<a href="http://dxruby.osdn.jp/">http://dxruby.osdn.jp/</a></li>
</ul>
<p>また、貧弱なオーディオ関連を補間するためのオーディオライブラリAyame/RubyをWikiに置いてありますのでご利用ください。DXRuby用のサンプルコードもここに置いてあります。</p>
<ul>
<li>プロジェクトWiki
<a href="https://github.com/mirichi/dxruby-doc/wiki">https://github.com/mirichi/dxruby-doc/wiki</a></li>
</ul>
<p><a name='AUTOINDEXANCHOR_1'></a></p>
<h2>マニュアル</h2>
<ul>
<li><p>チュートリアル</p>
<ul>
<li><a href="tutorial/basic.html">基本</a></li>
<li><a href="tutorial/soundeffect.html">応用/SoundEffect</a></li>
<li><a href="tutorial/sprite.html">応用/Sprite</a></li>
<li><a href="tutorial/shader.html">応用/Shader</a></li>
</ul></li>
<li><p>リファレンス</p>
<ul>
<li><a href="api/index.html">APIリファレンス</a></li>
<li><a href="api/constant_keycode.html">キーコード定数</a></li>
<li><a href="api/constant_color.html">色定数</a></li>
</ul></li>
<li><p>TIPS</p>
<ul>
<li><a href="tips/zindex.html">描画順序</a></li>
<li><a href="tips/draw_effects.html">画像効果</a></li>
<li><a href="tips/draw_reservation.html">描画予約と破棄</a></li>
<li><a href="tips/encoding.html">エンコーディング</a></li>
<li><a href="tips/release_resources.html">リソースの解放</a></li>
<li><a href="tips/cancel_window_closing.html">'ウィンドウを閉じる'のキャンセル</a></li>
<li><a href="tips/ocra.html">ocraによるexe化</a></li>
</ul></li>
<li><p><a href="CHANGELOG.html">更新履歴</a></p></li>
</ul>
<p><a name='AUTOINDEXANCHOR_2'></a></p>
<h2>DXRubyの特徴</h2>
<p>DXRubyは以下のような特徴を持つライブラリです。</p>
<ul>
<li>RubyからDirectXを自然に扱える、Rubyと親和性の高い設計がされています。</li>
<li>初心者でも簡単に使えるよう、非常にシンプルなAPI構成になっています。</li>
<li>描画が速いので、遅いといわれるRubyでも普通にゲームが作れるぐらいの実行速度が出ます。</li>
<li>Ruby2.3～2.6に対応しています。自分でコンパイルできればそれ以降でも動くと思います。</li>
<li>配布しやすいよう、コンパクトな拡張ライブラリとなっています。</li>
</ul>
<p>また、デメリットとしては以下のものがあります。</p>
<ul>
<li>DirectXを扱うのでWindows専用となります。</li>
<li>2Dゲーム専用です。</li>
<li>複雑なことを行うAPIは提供していません。</li>
</ul>
<p>DXRubyが提供する機能は大まかに以下のものです。</p>
<ul>
<li>画像の読み込み、描画</li>
<li>画像の編集</li>
<li>キーボード、マウス、ゲームパッド(アナログ含)の入力</li>
<li>MIDI、WAVファイルの読み込み、再生、ループ設定、フェードイン/アウト</li>
<li>文字表示</li>
<li>FPS自動調整</li>
<li>高速な衝突判定</li>
<li>HLSLを使ってシェーダプログラミングが可能</li>
</ul>
<p>DXRubyを実行するのに必要な環境は以下のものです。</p>
<ul>
<li>Ruby本体
<ul>
<li>mingw32のRuby2.3～2.6(RubyInstallerでインストールすればOKです)。</li>
<li>ActiveScriptRuby同梱版など、mswin32/mingw32以外でもそれ用にコンパイルされていれば動作します。</li>
<li>64bit版Rubyでは動作しません。64bitOSでも32bit版Rubyをお使いください。</li>
</ul></li>
<li>OS
<ul>
<li>Windows2000以降</li>
</ul></li>
<li>DirectX
<ul>
<li>9.0c以降</li>
</ul></li>
</ul>
<p><a name='AUTOINDEXANCHOR_3'></a></p>
<h2>インストール方法</h2>
<p><strong>注意</strong><br>
arton氏作のActiveScriptRubyの場合は、ActiveScriptRuby同梱のバージョンをお使いください(入っていれば)。<br>
その他のWindows用パッケージでmingw32のRuby(RubyInstller for Windowsなど)を使っている方は<br>
gem install dxruby<br>
でどうぞ。</p>
<p><a name='AUTOINDEXANCHOR_4'></a></p>
<h2>ライセンス</h2>
<p>DXRuby本体は1.2.0安定版から、DXRubyExtensionは1.0.3からzlib/libpngライセンスを採用しています。</p>
<p>添付のサンプルスクリプト及びドキュメント内のスクリプトは全てパブリックドメインとします。著作者人格権は行使しません。<br>
そのまま使うなり、改造するなり、著作権表示など一切いりませんのでご自由にどうぞ。</p>
<p>添付のさる画像はあみさんの著作物ですので、勝手な転載・複製などは固く禁じます。<br>
他、画像を頂いた先は以下です。</p>
<ul>
<li><p>ルール画像</p>
<ul>
<li><a href="http://kikyou.info/tvp/">吉里吉里のトランジションライブラリ</a></li>
</ul></li>
<li><p>背景画像</p>
<ul>
<li><a href="http://gakaiblog.at.webry.info/">きまぐれアフターさま</a></li>
</ul></li>
<li><p>世界地図</p>
<ul>
<li><a href="http://kantan-net.main.jp/worldmap/">かんたんネットさま</a></li>
</ul></li>
<li><p>デフォルトアイコンは鳴海つかささま。</p></li>
<li><p>それ以外の絵は水視アズマさま(GPL)。</p></li>
</ul>
<p>zlib/libpngライセンスの詳細は原文(英語)を読んでいただくのが一番よいのですが、簡単に説明するとこんな感じです。</p>
<ul>
<li>無制限に扱うことを無償で許可する。</li>
<li>ソースを改変する場合に限り、著作権表示を含めること。</li>
<li>何が起きても責任は持ちません。</li>
</ul>
<p>要するに、何かあっても知らないけど自由にどうぞ、ということです。<br>
使うだけでは著作権表示がいらないぶん、1.0.9以前で採用していたMITライセンスよりももうちょっとゆるくなっています。<br>
また、著作権表示は以下のものです。<br>
これそのものがzlib/libpngライセンス自体の原文で、上記のようなことが書いてあります。</p>
<div class="highlight"><pre class="highlight plaintext"><code>The zlib/libpng License
Copyright (c) <2012> <DXRubyDevelopers>
This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.
Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.
</code></pre></div>
</section>
</section>
<footer>© 2009-2019 mirichi</footer>
</body>
</html>