initial commit

1 files changed, 43 insertions, 0 deletions

diff --git a/files/ja/web/api/webgl_api/webgl_best_practices/index.html b/files/ja/web/api/webgl_api/webgl_best_practices/index.html
new file mode 100644
index 0000000000..6ff0290612
--- /dev/null
+++ b/files/ja/web/api/webgl_api/webgl_best_practices/index.html
@@ -0,0 +1,43 @@
+---
+title: WebGL best practices
+slug: Web/API/WebGL_API/WebGL_best_practices
+tags:
+  - WebGL
+translation_of: Web/API/WebGL_API/WebGL_best_practices
+---
+<p>{{WebGLSidebar}}</p>
+
+<p>この文書は WebGL を使ったコンテンツの向上のための Tips について書きます。これらの提案に従うことで、多くの機器への互換性を高めたり、パフォーマンスを上げることにもなります。</p>
+
+<h2 id="避けたほうがいいこと">避けたほうがいいこと</h2>
+
+<ul>
+ <li>WebGL のエラーを出さないように注意しましょう。エラーは <code>getError()</code> で得られますが、Firefox では <code>webgl.verbose</code> の設定を有効にすることで、ウェブコンソールに WebGL のエラーと警告を出力します。ユーザーのコンソールにエラーを吐き出す必要はないでしょう？（訳註：パフォーマンスの理由もある。下参照）</li>
+ <li><code>#ifdef GL_ES</code> は絶対に使ってはいけません。初期の例ではこれが使われていましたが、WebGL では必ず true になるので必要ありません。</li>
+ <li>フラグメントシェーダで <code>highp</code> 精度を使うのはやめましょう。<code>mediump</code> を代わりに使いましょう。<code>highp</code> を使うと今のモバイルのハードウェアのほとんどで動きません。Firefox 11 からは <code>getShaderPrecisionFormat()</code> 関数が実装されるので、<code>highp</code> 精度が使えるかどうかだけでなく、それぞれの精度の名称について実際の精度を知ることができます。</li>
+</ul>
+
+<h2 id="覚えておいたほうがいいこと">覚えておいたほうがいいこと</h2>
+
+<ul>
+ <li>WebGL の機能の中にはクライアントによって制限があるものがあります。そういうものを使う前には <code>getParameter()</code> を使って調べましょう。例えば、2D テクスチャのサイズは <code>webgl.getParameter(webgl.MAX_TEXTURE_SIZE)</code> でわかります。Firefox 10 からは <code>webgl.min_capability_mode</code> の設定があり、最低限の機能の環境をシミュレートすることができます。</li>
+ <li>特に、頂点シェーダでのテクスチャの使用は <code>webgl.getParameter(webgl.MAX_VERTEX_TEXTURE_IMAGE_UNITS)</code>がゼロより大きくなければ使えません。現在のモバイルのハードウェアではまず使えないでしょう。</li>
+ <li>WebGL の拡張が使えるかどうかはクライアントに依存します。できるならそれらの使用をオプションとし、サポートされていない環境にも対応できるようにしましょう。Firefox 10 からは <code>webgl.disable-extensions</code> の設定があり、拡張のない環境をシミュレートすることができます。</li>
+ <li><code>OES_texture_float</code> 拡張がサポートされていたとしても、浮動小数点数テクスチャへのレンダリングはサポートされていないかもしれません。モバイルのハードウェアではまず動かないでしょう。サポートされているかを調べるには <code>checkFramebufferStatus()</code> を使ってください。</li>
+</ul>
+
+<h2 id="一般的なパフォーマンスの_tips">一般的なパフォーマンスの tips</h2>
+
+<ul>
+ <li>CPU と GPU の同期を必要とするものはすべて、とても遅い可能性があり、メインのレンダリングループでは避けたほうがいいでしょう。<code>getError()</code>、<code>readPixels()</code>、<code>finish()</code> などの関数がそれです。<code>getParameter()</code> や <code>getUniformLocation()</code> といった WebGL のゲッタも遅いので、JS 側で変数にキャッシュしてください。</li>
+ <li>大きい描画を少数だけしたほうがパフォーマンスが向上します（訳註：小さな描画をたくさん行うより）。1000 回の小さなものを描画するなら、一回の <code>drawArrays()</code> や <code>drawElements()</code> でやりましょう。一回の <code>drawArrays()</code> で離れたオブジェクトを描画するなら、3 点が一直線上にある三角形が使えます。</li>
+ <li>状態の変更が少ないほどパフォーマンスが向上します。特に、複数の画像をひとつのテクスチャにまとめて適切な座標を使うことでバインドしているテクスチャの変更が少なくて済みます。</li>
+ <li>小さなテクスチャは大きなテクスチャよりパフォーマンスが良いです。そのため mipmap が有効です。</li>
+ <li>簡単なシェーダーは複雑なものよりもパフォーマンスが良いです。特に、<code>if</code> 文を減らせば速くなります。割り算や <code>log()</code> などの数学の演算もコストが高いです。</li>
+</ul>
+
+<h2 id="参照">参照</h2>
+
+<ul>
+ <li><a href="/ja/WebGL" title="WebGL">WebGL</a></li>
+</ul>