CSL::DevLog

xcode8でdoxygen commentのwarningが出る問題の回避策

2016-10-08T07:39:00.000+09:00

こんにちは．@rootxです．

最近xcode8にアップデートしましたが，glfw3のプロジェクトを作っていたら大量の警告が発生しました．

Documentation Issue Group

/usr/local/include/GLFW/glfw3.h:744:8: Empty paragraph passed to '@sa' command/main.cpp:12:10: In file included from /User/main.cpp:12:

どうやらdoxygenコメントに不備があると，警告を出すようになったみたいですね．

暫定的に，次のように警告を抑制することで回避しました．

#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wdocumentation"
#include <GLFW/glfw3.h>
#pragma clang pop

外部ライブラリのヘッダではでないように設定したいですね；

でわでわ．

開発環境構築 Win7 x64

2016-02-07T12:53:00.001+09:00

Windows の開発環境構築

インストールするもの

Atom

GLSL Preview
atom-typescript
autocomplete-webgl

VirtualBox
Vagrant

vagrant init bent/centos-6.7

Visual Studio Community 2015
Visual Studio Code
TypeScript
Putty

UTF-8

WinSCP

トラブル対応

Vagrantの共有フォルダが参照できない

==> default: Mounting shared folders...
    default: /vagrant => D:/Vagrant/mycentos
Failed to mount folders in Linux guest. This is usually because
the "vboxsf" file system is not available. Please verify that
the guest additions are properly installed in the guest and
can work properly. The command attempted was:

mount -t vboxsf -o uid=`id -u vagrant`,gid=`getent group vagrant | cut -d: -f3`
vagrant /vagrant
mount -t vboxsf -o uid=`id -u vagrant`,gid=`id -g vagrant` vagrant /vagrant

The error output from the last command was:

/sbin/mount.vboxsf: mounting failed with the error: No such device

こんな風にマウント失敗のエラーが出ていた．
どうもVirtualBoxのGuestAdditionsがおかしくなっているようなので，次の対応を実施：

稼働OSを停止： vagrant halt
プラグインインストール： vagrant plugin install vagrant-vbguestd:\Vagrant\mycentos>vagrant plugin install vagrant-vbguestInstalling the 'vagrant-vbguest' plugin. This can take a few minutes...Installed the plugin 'vagrant-vbguest (0.11.0)'!
再起動する途中でインストールされる： vagrant up

References

http://dotinstall.com/lessons/basic_localdev_win/

VirtualBoxにUbuntuをインストールしてnode.jsを立ち上げるまでのメモ

2015-12-16T23:33:00.001+09:00

こんにちは．@rootxです．

所要でubuntuを使いたくなったので，VirutalBoxで環境を整えます．

環境

Win7 Pro 64bit
CPU i7-6700
MEM 16GB (pc3-12800)
GPU GeForce970

手順

1. VirutalBoxをインストール

ここから． https://www.virtualbox.org/wiki/Downloads

> VirtualBox 5.0.10 for Windows hosts
と
> VirtualBox 5.0.10 Oracle VM VirtualBox Extension Pack All supported platforms
の両方をダウンロード．
前者はVirtualBox本体．後者は物理的なPCのデバイスサポートみたいなイメージ．（Support for USB 2.0 and USB 3.0 devices, VirtualBox RDP and PXE boot for Intel cards. ）

VirtualBox-5.X.XX-XXXXX-Win.exeを実行して，デフォルトでインストール．
起動だけ確認して一旦終了．
# 日本語化されているんですね．少し驚き．

続いて，
Oracle_VM_VirtualBox_Extension_Pack-5.0.10-104061.vbox-extpackをダブルクリックするとVirtualBoxが起動され，「機能拡張パッケージをインストールする？」と聞かれるのでダイアログにしたがって進める．
「インストールに成功しました」などとダイアログが出ればOK．

2. VirtualBoxにubuntuをインストール

ubuntuのISOイメージからインストールする手段もありますが，
ubuntu JapaneseTeamで仮想ハードディスクイメージが公開されているので，それを使います．
（少しバージョンが古いですが）

https://www.ubuntulinux.jp/download/ja-remix-vhd から，「Ubuntu 14.04 LTS - 2019年4月までサポート」にある「ubuntu-ja-14.04-desktop-amd64-vhd.zip 」

手順もそこにある通りだが，linux 32bitしかメニューから選択でてきませんでした．
BIOSが怪しいのかな？と思いましたが，一旦windowsを再起動したら，出てくるようになりました（謎）．

ハードディスクで「すでにある仮想ハードディスクファイルを使用する」から，先ほどダウンロードしたZIP，を解凍して作成されたvhdファイルを指定．（100GB指定）

起動すると，ubuntuの初回セットアップが始まるので適当に進める．

さくっと動作できたので一旦VMシャットダウン．

設定を変更
* システム>プロセッサ：2コア
* システム>マザーボード>メインメモリー：１GB
* ディスプレイ> スクリーン>ビデオメモリー:128MB
* ディスプレイ> スクリーン>アクセラレーション:3Dアクセラレーションを有効化をON

再度起動して，（なにかエラーが出ましたが無視して），ウィンドウの「デバイス」メニューを開き、「Guest Additions のCDイメージを挿入」を選択 (これは忘れがち)

あとは，ubuntuのソフトウェアアップデートがあるはずなので，適宜適用する．
左のメニューの一番上から，updateと入力して，「ソフトウェアの更新」を実行．
終わるまで結構時間がかかるので，一服してから再開します．

3. node.jsを起動する

でわでわ．

Unityでレイトレ

2015-09-30T19:35:00.000+09:00

こんにちは．@rootxです．

Unityをアセット管理として用いたレイトレプログラムを書いてみましょう．

Unity5でレイトレーシング

はじめに

なぜUnityで行うか？

先日から少しだけUnityを操作しているのですが，最近のゲームエンジンらしく物理ベースマテリアルに対応している上に，いろんなローダやアセットがたくさんあって，自分で書くよりこれでいいじゃん，と思ったところが始まりです．

ベタのレンダラを書いたことのある人はお分かりかと思いますが，最初に絵を出力するまでに，レンダリング以外の処理を書くのがすごく大変です．例えば，ファイルの読み込みや，画像として保存する，テクスチャに対応する，などなどです．ちょっとプレビューしたいと思ったり，それにGUIを付けたいと思っても，なんだかよくわからないことを，たくさんたくさん調べて書く必要があります．

そこで，

本論の目的は，初学者（私も含め）向けにレンダラの本質（と思われるところ）に焦点を

また，高速化や多くのテクニックの必要性を体験してもらうことです．

なお他のアプローチとしては，任意のフレームをobj等に出力して，自作あるいは既存のレンダラでレンダリングする，という方法もあります．

開発環境

os x 10.10

Unity 5.2.0f3

UnityScript (C#)

開発指針

レイキャスト，古典的レイトレ，パストレの流れを追う．

マテリアルはstandard shaderの設定を使う．

テクスチャ対応．

高速化手段はあまり考えない．

MMDモデルのレンダリングくらいまで．

ここから

準備（適当に）

新規プロジェクトを作成．

適当なオブジェクトの配置．

カメラの設定．
スクリプトを作成．
カメラに，作成したスクリプトをアタッチ．

とりあえず，こんな感じにしてみました．

絵を出す（モノクロから）

レイトレーシングの基本的な考え方は，視点（カメラ）からたくさんの視線（レイ）を飛ばして，当たったオブジェクトの位置に基づいていろいろ計算して，色を決定します．

Unityでは便利なAPIがたくさん用意されているのでそれを使って，色の決定の部分を書いていく，という感じで進めます．

レンダリング結果を保持するキャンバスを用意して画面に表示する

レンダリング結果は，テクスチャに描画します．

最初にテクスチャを用意します．今回は，スクリーンサイズと同じサイズのテクスチャをStart()で確保し，レンダリングのためのRendering()を呼びだします，

全画素について処理を行うため，横方向(width)と縦方向(height)の2重ループとなります．
レイトレースを行うには，各ピクセルにおいて，カメラから発するその画素位置を向いたレイを生成し，その結果に応じて色を計算します．

この時点では，まず単純な背景色（黒）をテクスチャへ書き込み，そして画面への表示を行うだけの処理にします．
UnityのColorは不透明度を持っているので，黒の場合は (0.0f, 0.0f, 0.0f, 1.0f)とします．
また，数値で場合は必ずfloat精度として記述してください．うっかり new Color(0.0, 0.0, 0.0 1.0)のように記述すると，コンパイルに失敗してUnityがエラーとなってしまいます．

すべてのピクセルに色を設定したら，テクスチャのApply()で反映することを忘れないようにしてください．
描画した内容を画面に表示するために，OnGUI()コールバックを用意して，テクスチャを画面を覆うような領域に描画します．

https://gist.github.com/cslroot/c66ebadf2ad3651bcab3
この状態で実行すると，真っ黒になると思います．
背景色として指定したbackgroundColorの値をいろいろ変えて，指定した色になることを確認してみましょう．
ここまでできれば，各ピクセルの色をどのように決定するか，という部分に集中して取り組むことができるでしょう．

レイを飛ばして，当たったところを表示する

Unityでは，Physics.Raycast()という大変便利な関数が用意されています．このAPIは，任意の位置（座標）と指定の方向（ベクトル）を指定することで，その半直線の交差情報を取得することができます．
交差情報は，単純に当たった/当たっていないだけではなく，どの物体（シーン内のGameObject）にあたったか，その位置，法線，uv座標なども取得することが可能です．

注意：当たったかどうか，はCollider（コライダ）と呼ばれるコンポーネントで判定されます．Colliderがアタッチされていない要素には当たり判定がないため，Raycast()では無視されてしまいます．

これを使うには，各ピクセルに対しするレイの位置と方向を算出する必要がありますが，Unityにはその計算を自動的に行なってくれるAPIが用意されています：

mainCamera.ScreenPointToRay(Vector3(w, h, 0));

それではまず，当たった場合に白，当たらない場合に黒で表示するように改造してみます．
https://gist.github.com/cslroot/4eb475710a11f87f174e

オブジェクトの色を表示する

物体が表示されましたが，陰影もなく色もない状態です．

そこで，当たった点の情報を利用して物体色を反映させたいと思います，

現時点では2つの物体（CubeとSphere）に材質情報がありませんので，まずはマテリアルを用意します．

Unity上の操作

プロジェクトビューから，新規のマテリアルを作成します(Create > Material)．

それぞれの物体に別々のマテリアルを持たせるので2つ作成しておきましょう(MatCube, MatSphere)．

それらのマテリアルを選択して，Albedoの色を指定します．とりあえず赤と青にしておきます．

マテリアルを，Hierarchy内のCubeとSphereにそれぞれドラッグ＆ドロップしてアタッチします．

ここまでの操作で，Unity上の物体に色が反映されたと思います．

ScriptからAlbedoカラーの取得

色を取得するには，レイと交差した物体のマテリアルを参照する必要があります．

これは，Raycast()のout引数であるRaycastHit構造体から，collider経由で取得します．

https://gist.github.com/cslroot/ce44b752bedce904c6ac

テクスチャマッピングを有効にする

マテリアルが取得できればテクスチャも簡単に習得できます．
テクスチャが設定されている場合は，Material.mainTextureプロパティでアクセスできます．
また，レイと交差した箇所のテクスチャ座標は，RaycastHit.textureCoordに格納されています．

https://gist.github.com/cslroot/ddcff7c39476e19da582

テクスチャを使うときに重要な点が1つあります．
スクリプトからテクスチャの値を取得する場合は，テクスチャの設定で「Read/Write Enble」を変更しなければなりません．これをしない場合，実行時にエラーが発生します．
テクスチャを選択「Texture Type > Advanced」にして「Read/Write Enable」をONにしてください．

今回はこのへんでー．

参考文献

https://github.com/BenjaminSchaaf/Unity-Raytracer

でわでわ．

Unityの画面を動画にする

2015-09-13T11:37:00.002+09:00

こんにちは．@rootxです．

前回の続きで，Unityで遊んでいます．
今回は，Unity画面を連番キャプチャして

きっと他の開発者の方が作られていると思いますが，Unityスクリプトの勉強として作成しています．

まずは連番出力
かるく調べた感じですと，3つの方法がありそうです：

「Application.CaptureScreenShot」というそのまんまなAPIを使う方法
RenderTextureを使う方法
Texture2DのReadPixelsを使う方法

今回は任意のサイズで保存したかったので，3番目の方法を採用します．
ちなみに，1番目の方法は遅い，とのこと．

とりあえずザクッと書いてみました．

連番画像を動画にする

ffmpegで簡単に作成できます．

30と書いた箇所は，指定したFrameRate（出力時のフレームレート）と同じにしてください．

参考文献

http://blog.almostlogical.com/2009/12/11/render-to-texture-unity3d/
http://answers.unity3d.com/questions/22954/how-to-save-a-picture-take-screenshot-from-a-camer.html

でわでわ．

はじめてのUnityプロジェクト：MMDを動かす

2015-09-12T10:35:00.000+09:00

こんにちは．@rootxです．

はじめに

とあるところで「主婦ゆに」（サイン入り）を手に入れました！
Unityにはあまり興味がなかったのですが，せっかくなので触ってみようと思います．

とりあえずはお手本通りに，MMDモデル(PMD, VMD)を読み込み，踊ってもらおうと思います．

なお，Unity5のインストール，アカウント作成を完了したところからスタートとします．

環境

MacBook (Retina, 12-inch, Early 2015)
OS X 10.10 Yosemite
Unity 5.2.0f3

プロジェクトの作成

Newで新規プロジェクトを作成

3Dを選択

アセットはあとから追加できるので，Asset Packagesは特に変更なし

Create Project

とりあえずシーンを保存する

シーンは，ゲーム開発でいう"レベル"に相当．

Save Scene

Asset直下はいろいろなアセットが増えていくのでScenesフォルダを作ってそこに保存．

MMDファイルの読込み

MMD4Mecanim.unitypackageをダブルクリックしてインポート．

各種MMDファイル(pmd, vmd)をアセットに追加（Projectタブにドラッグ＆ドロップ）

〜〜.pmdファイルの対応する箇所に，〜〜.MMD4Mecanimが生成されているので選択

Inspectorウィンドウに利用条件が出てくるので確認し，チェックONで右下の「同意する」を押す

Inspectorをロックしておく

モーション(*.vmdファイル)をVMD欄にドラッグ&ドロップする．

Processボタンを押す

#変換処理が完了するまで暫く待つ．

pmdと同フォルダにfbxファイルができているので，それをHierarchy（またはScene）にドラッグ＆ドロップ．

動かす

空のAnimator Controllerを追加（Create > Animator Controller）

作成したAnimator Controllerをシーンに配置したMMDモデルのinspectorのAnimator > Controllerにドラッグ＆ドロップで設定

作成したAnimator ControllerをダブルクリックしてAnimatorウィンドウを開く

プロジェクト内のモデルデータを（三角形を押して）展開し，読込み時に指定した*.vmdファイルをAnimatorウィンドウにドラッグ＆ドロップする

ここまでで，再生を押すと踊るよ．

でも残念な感じのカメラなので調整しましょう．

カメラを自動追従に変更する

既存のMainCameraは削除．

メニューの Assets > Import Package > Cameras をインポート

ProjectウィンドウのAssetからHandheldCamera(Standard Assets > Cameras > Prefab)をシーンに追加

カメラの向きがいまいちなので，適当に位置合わせ

Position > X: 0 / Y: 0.5 / Z: 2.0

Rotation > X: -10 / Y: 180 / Z: 0

デフォルトのクリッピングを変更 Clipping Planes > Near: 0.1 / Far: 100

FOVも気に入らないので変更 Field of view: 50

追従するように設定 Hand Held Cam (Script) > Target: 適当なジョイント（67.joint_Neck）

再生して確認

→ あまりにも激しく動いて良いそうなので，カメラの追従速度を調整する

Following Speed: 0.5

FOV: 35

Position: Y: 1

Rotation: 355

でわでわ．

Xcodeでも「上の行に改行」したい！

2015-08-10T15:58:00.001+09:00

こんにちは．@rootxです．

普段はWindowsのVisual Studioを使っていたりいなかったりするのだけれど，
VSでよく使うショートカットの1つに「CTRL + ENTER」があります．

これはエディタ上で，「1つ上の行に改行を入れる」という操作を

例えば，コード補完等によって，次のような状態担っているとします（★印がカーソル位置）．
-------------
if (false) {
}★
-------------
ここでおもむろに「CTRL+ENTER」を押下すると，
-------------
if (false) {
★
}
-------------

こんなふうになります．

先にフローの構造を作ってから編集する，という思考ルーチンなのでこの手順が極めて大切なのです．

xcodeにもそれっぽいのがあるはず！と思っていましたが，
どうやらなさそうなので，Karabinar（旧 KeyRemap4MacBook）で独自ショートカットを定義しました．
gistに置いときます．
https://gist.github.com/cslroot/376f6ac7724e9f1ff705

これで開発効率が5%くらいアップしたはず！

でわでわ．

GUI付きのビューアをつくりたいのでocornut/imguiを使ってみた

2015-08-10T02:21:00.001+09:00

こんにちは．@rootxです．

レイトレした結果をどう確認していますか？

PNGファイル出力をしていますが，毎回開くのも嫌だし，
入力ファイル指定や途中経過などなどをGUIから行いたいです．

でサクッとビューアをつくろうと思って，
過去に使ったことのあるGLUIを使おうと思いましたが，今回はGLFWを使ってウィンドウ表示するため使えません．

そこで最近のGUIライブラリを調べつつ，ImGuiというライブラリを使うことにしました．

試したGUI

（参考： OpenGL な UI を作るライブラリ一覧）

AntTweakBar (http://anttweakbar.sourceforge.net/doc/)

見た目も良さげでhomebrewでインストールできたので試してみましたが，
osxのretinaディスプレイに対応しておらず，描画は可能なもののマウス位置と整合性がとれておらず使用を断念しました．

GWEN(https://github.com/garrynewman/GWEN)

1年くらい更新されていないのと，osx対応されていなさそうなのでやめ．

見た目は一番好みだったのだけれど．

CEGUI

ヘビィそうなのでやめとく．

AdrienHerubel/imgui (https://github.com/AdrienHerubel/imgui)

かなり良さそうだったけれど，あまりにもコミットが少なくメンテされてなさそうなのでNG．

blendish

blender-likeすぎて辛い．あと依存関係がヘビィ．

ocornut/imgui

ハマりポイント

1. 文字がちっちゃい＝全体が小さい

retinaに完全対応していないのか，文字が極めて小さく表示されてしまいました．

ボタン等はちゃんとマウス位置に反応しているので，次の2通りの方法のどちらかで，暫定的に回避できました．

フォント読み込み時に，フォントサイズを大きくする．

io.Fonts->AddFontFromFileTTF("resource/uzura.ttf", 16.0f, NULL, io.Fonts->GetGlyphRangesJapanese());

→ "16.0f"を"32.0f" にするとか．

※ README.mdの文字列サンプルは間違ってるので注意．第3引数にNULLを指定する必要があります．

グローバルスケールなるパラメータを2倍にする

次のようにウィンドウサイズとフレームバッファサイズを比べて掛けとく．

{

// osx retina 2x

int w, h;

glfwGetWindowSize(window, &w, &h);

int ww, hh;

glfwGetFramebufferSize(window, &ww, &hh);

io.FontGlobalScale = ww / w;

fprintf(stderr, "window(%d, %d) : frameBuffer(%d, %d)\n", w, h, ww, hh);

io.UserData = &input;

}

2. 2フレーム目から描画されない；

描画は次のような感じで行けますが，適当に拾ってきたModernなOpenGLサンプルでテクスチャ付き四角形を描画していたら，2フレーム目から描画されませんでした．

while (!glfwWindowShouldClose(window))

{

//----- ImGui のセットアップ ----

ImGuiIO& io = ImGui::GetIO();

ImGui_ImplGlfwGL3_NewFrame();

{ // 〜〜 ImGuiのメニューなど

}

// ここら辺に自分の描画したいコードを書く

ImGui::Render();

glfwSwapBuffers(window);

glfwPollEvents();

}

かなり悩ましい問題でしたが，GUIコントロールのレンダリング時に glEnable(GL_BLEND)されているためでした．
まあそういうこともあるよね．

あまり使用実績がないので，ググってもあまり情報が出てこないのが辛いかな．
コンパクトにいろんな機能が用意されていることと，活発に更新されていることが優位な点なので，今後もウォッチしていきます．

でわでわ．

買った本

2015-08-02T13:47:00.004+09:00

こんにちは．@rootxです．

昨日のお昼くらいにポチったのですが，約8時間で受け取れました．
お急ぎ便は早いな！

でわでわ．

読んだ

2015-08-01T09:00:00.007+09:00

とりま

2015-07-25T11:39:00.001+09:00

こんにちは．@rootxです．

> RenderTime: 28171.4

いけてなさすぎる．

でわでわ．

メモ

2015-07-25T11:24:00.003+09:00

レイトレ系の話は，別のblogに書いてたのだけれど，
bloggerがエラーを出して死んでしまったのでこちらに移植しました．

何が行けなかったんだろう…．
独自ドメインで動かそうとしたからかなあ．
でも設定自体は済んでて，ちゃんと独自ドメインでアクセスできるようになってたのに．

ううん．

XCodeのLLVM(clang)でOpenMPを使おう(解決)

2015-07-25T10:53:00.002+09:00

こんにちは．@rootxです．

高速化って大切ですよね．
結果が出るまで待てない，AWSに余計なお金を払いたくない，などなど，進化した計算機といえどもCPU資源を使いきって高速に処理する需要はなくなることはありません．

CPU自体の進化も，クロックの高速化競争の集結を迎え，シングルスレッド性能は頭打ちになってきています．
この背景には，半導体プロセス微細化によるリーク電流や，数GHzを超えると電子の移動速度も際どくなる等が要因として挙げられていたと記憶しています．
＃消費電力あたりの性能，という指標は個人的には好きではありません…．

そのため，現在のCPUではマルチコア，ハイパースレッド等の技術によって，処理を複数同時に実行できることでCPU全体としての性能向上を維持しています．

プログラミング技術においてもその方向に進んでいて，いかに並列処理をするか，というのが現代的なプログラムの重要なポイントの1つとなっています．

様々な並列処理手法がありますが，C++で開発する際に，お手軽に並列化する方法の1つにOpenMPというライブラリがあります．
このOpenMPは，名前がちょっとOpenGLに似ていますが全然関係なくて，並列処理を簡易的に実装する

しかも最近のVisual Studio(VS2010以降？)では標準的に使えるようになっていて，
プロジェクト設定をちょいちょいと変えてあげるだけで有効になる，とってもとっても便利なライブラリで，特にレイトレのような並列化の容易なアプリケーションでは，たった1行追加するだけでバリバリ並列化できちゃう夢のような仕組みです．

しかし残念なことに，OSX上のXCodeで開発している場合は，VSほど簡単に有効にすることはできないようです．これはXcodeの標準コンパイラがLLVM clang3.5であり(MacOS 10.9.5 Xcode6.2時点)，ちゃんと対応されていないバージョンのためです．
そのうち標準対応されるのではないか，と想像していますが，現時点では望めません．

# 10.10の環境は未調査．今のところ，あのフォルダアイコンのださいOSをメイン環境として使う気がないため．

ということで，自前でスレッド処理するが，gccに切り替えて使うべきか，いっそのことWindowで開発するか，といった悩ましい問題が目の前に立ちはだかっているのです．

いろいろ探していましたが，OpenMPを有効化したclang-ompが配布されていたので導入す

ここから本題です．

Xcodeで clang-omp の使い方

https://clang-omp.github.io/

homebrew でclang-ompをインストール: brew install clang-omp
Xcodeプロジェクトを作成
ビルドセッティング(Build Setting)で：

新しいユーザ定義設定 CC を次の値で作成：/usr/local/bin/clang-omp
-fopenmpをOther C Flagsに追加
/usr/local/includeをHeader Search Pathsに追加
Enable Modules (C and Objective-C)をNoにセット

ビルドフェーズ(Build Phases)で：

/usr/local/lib/libiopm5.dylibをLink Binary With Librarianに追加

（＊）/usr/local/binにhomebrewでインストールされたclang-omp++というエイリアスがあるので，clang++-ompに名前を変更

これで完了．あとは #include <libiomp/omp.h>して，#pragma omp〜〜を使うだけ？．

注意

なぜかビルドできませんでしたが，上記手順の5を追加することで上手く動くようになりました．
どうやらXcodeは，C++のコンパイル時にCCに定義されたものを自動的に置換しているようです．その際に，末尾に++を追加するのではなく，clangをclang++に置換するようです．（途中のバージョンで仕様が変わったのかな…）

ということで，暫定的な対策ですが，clang-omp++の名前をclang++-ompにすることで，上手くそれを使ってくれるようにできました．

補足

glmがコンパイラを認識できずに次のエラーを出しましたので対応しました．

/usr/local/include/glm/detail/setup.hpp:287:2: error: "GLM_COMPILER undefined, your compiler may not be supported by GLM. Add #define GLM_COMPILER 0 to ignore this message."#error "GLM_COMPILER undefined, your compiler may not be supported by GLM. Add #define GLM_COMPILER 0 to ignore this message." ^1 error generated.Command /usr/local/bin/clang-omp failed with exit code 1

TODO

後日，効果を検証します．

なんかビルド時のエラーの出かたが変化した気がする…

でわでわ．

1024 x 768 with 20 path /subpx and 2x2 subpixel

2015-07-25T10:51:00.002+09:00

こんにちは．@rootxです．

うーん遅い．

でわでわ．

遅いのでAABBを導入してちょっとだけ早くする

2015-07-25T10:42:00.005+09:00

こんにちは．@rootxです．

簡単なレイトレができましたが，単純なシーンの割に遅いです．
先ほどの偽コーネルボックス(640x480)のレイキャストで約1.0秒もかかっています．
これは由々しき事態です！

というわけで，本筋としてはBVHなどの高速な衝突検出（O(log(n)）を使うべきですが，
とりあえずAABBを導入します．

AABBとは，Axis Aligned Bounding Boxの略で，要するに当たり判定用のBOXです．
ポイントはXYZ軸に沿っていることですね．そのため，斜め方向を向いている細長い物体だと，大きくなりすぎる問題もあります．
物体の向きに関係なく，任意方向の境界BOXであるOBB(Oriented Bounding Box)というものもありますが，OBB算出が面倒なのとシーンが複雑になった時の構築時間が増えてしまうので，今回は後々の拡張も考慮してAABBを採用します．

AABBの実装は簡単で，プリミティブの最小最大座標をx,y,zそれぞれ求めて上げればOKです．
現在，プリミティブとして用意しているのは，三角形と球なのでちょいちょいと求めてあげます．

メッシュ（モデル）毎にもAABB持たせてあげましょう．
メッシュを構成する全プリミティブのAABBをガッチャンコします．
MergeAABBみたいな関数を用意すると便利ですね．

次はAABBとレイとの衝突判定を実装します．

とりあえずこれを参考にします．

ゲームプログラミングのためのリアルタイム衝突判定

サンプルコードがここ（http://www.borndigital.co.jp/book/164.html）からダウンロードできるので買わなくてもいいけれど，一冊持っていると良いと思います．
ちなみに，この本は学生の時にお世話になりました．
その当時は日本語版がなくて，英語を読むのに苦労した覚えがあります……；

でわでわ．

単純なレイキャスティング

2015-07-25T10:42:00.002+09:00

こんにちは．@rootxです．

とりあえず，単純なレイキャスティングを行うプログラムを書いてみました．

シーンがしょぼいのと，光源を設定していないので陰影も出てませんが；

でわでわ．

使うライブラリ

2015-07-25T10:40:00.004+09:00

こんにちは．@rootxです．

今回はレイトレ作るのに使いそうなライブラリを選んでみたよ．
あ，C++です．

glm OpenGL Mathematics (http://glm.g-truc.net/)

ベクトルとかマトリクスとか，いつも出てくる子たちですね．
普段ならフルスクラッチで書くこともあるけれど，今回はこのglmというライブラリを利用してみます．
特徴としては，ヘッダオンリライブラリで，GLSL風の機能が備わっていること．OpenGL系と
あんまり早くは無いはず．

stb single-file public domain libraries for C/C++ (https://github.com/nothings/stb)

いろんなファイルフォーマットに対応したヘッダオンリライブラリ．
画像出力（PNG）に使うつもり．
読込みもできるので，テクスチャロードもできるかな．
# でもglmの開発者の作っているgliも良さそうなんですよね．

assimp : Open Asset Import Library (http://assimp.sourceforge.net/)

いろんなアセットを読込みたいときに使えるよ．
基本的なフォーマット(collada, obj, stl, ply)でエクスポートもできるみたい．

とりあえずここまで．
他に使えそうなライブラリがあったら追加するよ．

でわでわ．

レイトレはじめます

2015-07-25T10:40:00.001+09:00

こんにちは。@rootxです。

先日、ドワンゴがとっても興味深い人材募集を始めましたね。

新しい時代のエンジニアについて

http://info.dwango.co.jp/recruit/beyondtheweb/index.html

【新規事業】3DCGエンジニア(正社員)

https://progres05.jposting.net/pgdwango/u/job.phtml?job_code=1015

具体的には次のような条件が示されてるよ。

> ＜必須条件＞

> • プログラマブルシェーダの実装経験者

> • SIGGRAPHなどで発表された論文を元に実装をしたことのある方

> • 3DCGの分野で何か研究したいテーマを持っている方

> ＜歓迎条件＞

> • SIGGRAPHなどにおけるCG関連論文の発表経験者

> • 物理ベースのオフラインレンダリングを研究開発できる人

> • リアルタイムへの自動リトポロジーアルゴリズムや光学エフェクトの研究開発ができる人

ドワンゴというと、やっぱりニコニコ動画のイメージが先行してるので、まさかこんなにガチな人材を求めるとは思っていなかった、というのが正直なところです。

3DCG関連でいうと、短期的には、WebGLやunityみたいなネットと相性の良いテクノロジを志向するかと考えていました。実際、ニコニ立体でそちら方面は手を出しているし。

そんなわけで、普段は興味分野と関係ないお仕事をしてるから、グッときちゃったね。

でも、全然実績がないから、どうしようかなと思ってたけど、折角なので今から実績を作れるか挑戦してみようと思います。

でわでわ。

GLFW: Oculus Rift ガイド日本語訳

2015-06-20T10:49:00.000+09:00

GLFW: Oculus Rift ガイド

Oculus Rift guide の日本語訳です．途中．
http://www.glfw.org/docs/latest/rift.html

このガイドは，Oculus PC SDK ドキュメントと GLFWのドキュメントとの間にあるギャップを埋めることを目的にしていて，それらを置き換えるものではありません．ネイティブアクセス(native access)の使用が必要で，LibOVR，プラットフォーム固有API，利用する開発環境に関してある程度慣れ親しんでいることを前提としています．
GLFWはLibOVRを明示的にはサポートしていませんが，テストはされていて，LibOVRとの相互運用についても実施中です（While GLFW has no explicit support for LibOVR, it is tested with and tries to interoperate well with it）．

Note: Oculus SDKの開発速度によって，このガイドは次の（GLFWの）リリース前に時代遅れになっていると思います．もしこのドキュメントがローカルにコピーされたものなら，最新の情報をGLFWウェブサイトでチェックしてください．ガイドのこの版は，Oculus SDK のバージョン0.4.4を対象として記述されています．

LibOVRとGLFWヘッダファイルのインクルード

OpneGL LibOVRヘッダとGLFWのネイティブヘッダの両方で，ビルドしようとしているOSが何かを伝えるマクロが必要です．LibOVRは主要なデスクトッププラットフォームだけをサポートしているため，標準的な事前定義マクロで解決できます．

#if defined(_WIN32)

 #define GLFW_EXPOSE_NATIVE_WIN32

 #define GLFW_EXPOSE_NATIVE_WGL

 #define OVR_OS_WIN32

#elif defined(__APPLE__)

 #define GLFW_EXPOSE_NATIVE_COCOA

 #define GLFW_EXPOSE_NATIVE_NSGL

 #define OVR_OS_MAC

#elif defined(__linux__)

 #define GLFW_EXPOSE_NATIVE_X11

 #define GLFW_EXPOSE_NATIVE_GLX

 #define OVR_OS_LINUX

#endif

#include <GLFW/glfw3.h>

#include <GLFW/glfw3native.h>

#include <OVR_CAPI_GL.h>

GLFWとLibOVRのヘッダ両方は，デフォルトで標準のOpenGL GL/gl.h ヘッダ (OpenGL/gl.h on OS X)のインクルードを試みます．もし異なる標準ヘッダやGL拡張ロードライブラリを使いたい場合は，これらの記述の前にインクルードしてください．

LibOVRとGLFWの初期化

LibOVRはGLFWより前に初期化される必要があります．つまり少なくとも ovr_Initialize, ovrHmd_Create, ovrHmd_ConfigureTracking をglfwInit より前に呼び出すことを意味します．同様に，GLFWより後にLibOVRを終了しければなりません．
これは，ovrHmd_Destroy, ovr_Shutdown を glfwTerminateの後に呼ぶことを意味します．

Direct HMD モード

Direct HMDモードは，新しいアプリケーションで推奨されている表示モードですが，Oculus Riftランタイムは現在（2015年1月時点）Windowsだけがこのモードをサポートしています．Direct HMDモードでは，HMDはGLFWモニターとして検出されません．

ウィンドウとコンテキストの作成

もし、HMDがダイレクトモードならフルスクリーンモードかウィンドウモードのどちらかを使用できますが、フルスクリーンはHMDの解像度をサポートしている場合だけ推奨されます。

LibOVRの制限のため、ウィンドウのクライアントエリアのサイズとHMDの解像度は必ず一致してなければなりません。

もしHMDの解像度が通常のモニタ解像度より大きい場合、

If the resolution of the HMD is much larger than the regular monitor, the window may be resized by the window manager on creation. One way to avoid this is to make it undecorated with the GLFW_DECORATED window hint.

HMDへのウィンドウのアタッチ

Once you have created the window and context, you need to attach the native handle of the GLFW window to the HMD.

ovrHmd_AttachToWindow(hmd, glfwGetWin32Window(window), NULL, NULL);

拡張デスクトップ(Extend Desktop) モード

拡張デスクトップモードは旧来の表示モードですが，OS XやLinux上では，技術的な理由でDirect HMDモードをサポートされていないため，このモードだけが利用可能です（2015年1月時点）．Windows機でも同様に．

GLFWでHMDを検出する

HMDが拡張デスクトップモードになっている場合，どちらのGLFWモニタがHMDと一致しているかを推定して，そのモニタにフルスクリーンウィンドウを作成します．
Windowsでは，GLFWモニタのネイティブデバイス名は，検出されたHDMのディスプレイデバイス名と対応しています（ovrHmdDescのDisplayDeviceNameメンバに保持されています）．
OSX上では，GLFWモニタのネイティブディスプレイIDが検出されたHMDのディスプレイIDに対応しています（ofovrHmdDescのDisplayIdメンバに保持されています）．

執筆時点（2015年1月）で，Oculus SDKはどちらのモニタがHMDなのかをちゃんとした方法で検出する方法はサポートしていませんが，
HMDが適切にセットアップと回転されている限り，LibOVRによって提供されるスクリーン位置と解像度を通じて発見することができます．
この方法はHMDをミラリングしている他のモニタを見つけてしまうかもしれませんが，もしそのビデオモードを変更使用としている場合にだけ問題となります．

int i, count;

GLFWmonitor** monitors = glfwGetMonitors(&count);

for (i = 0;  i < count;  i++)

{

#if defined(_WIN32)

    if (strcmp(glfwGetWin32Monitor(monitors[i]), hmd->DisplayDeviceName) == 0)

return monitors[i];

#elif defined(__APPLE__)

    if (glfwGetCocoaMonitor(monitors[i]) == hmd->DisplayId)

return monitors[i];

#elif defined(__linux__)

    int xpos, ypos;

const GLFWvidmode* mode = glfwGetVideoMode(monitors[i]);

glfwGetMonitorPos(monitors[i], &xpos, &ypos);

if (hmd->WindowsPos.x == xpos &&

hmd->WindowsPos.y == ypos &&

hmd->Resolution.w == mode->width &&

hmd->Resolution.h == mode->height)

{

return monitors[i];

}

#endif

}

ウィンドウとコンテキストの作成

検出されたモニタ上に通常のフルスクリーンウィンドウとして，ウィンドウが作成されます．HMDが正しいビデオモードに既に設定されている場合には，windowed full screenウィンドウを作成することは通常良いアイディアです．しかし，拡張デスクトップモードは通常のモニタとして振る舞い，いくつかのサポートされているビデオモードの受付け可能です．

もし他のモニタだがHDMをミラリングしていて，異なるビデオモードをリクエストしている場合，すべてのミラリング設定されているモニタは新しいビデオモードになります．

HMDへのレンダリング

SDK歪曲レンダリング

もしSDK歪曲（ディストーション）レンダリングを使おうとするなら，レンダラを設定するためにGLFWからいくつかの情報を取り出す必要があります．

GLFWから情報を埋める必要のある ovrGLConfig ユニオンの一部を示します．
他のフィールドも ovrHmd_ConfigureRenderingのために設定する必要があることに注意してください．
SDKディストーションレンダリングを設定する前に，あなたのコンテキストをカレントにしてください．

int width, height;

union ovrGLConfig config;

glfwGetFramebufferSize(window, &width, &height);

config.OGL.Header.BackBufferSize.w = width;

config.OGL.Header.BackBufferSize.h = height;

#if defined(_WIN32)

    config.OGL.Window = glfwGetWin32Window(window);

#elif defined(__APPLE__)

#elif defined(__linux__)

    config.OGL.Disp = glfwGetX11Display();

#endif

SDKディストーションレンダリングを使う場合，ovrHmd_EndFrameによってHMDが更新されたときに，自分でバッファスワップをしてはいけません．

クライアント歪曲レンダリング

クライアント側で歪曲レンダリングするときは，HMDのコンテンツを完全な制御下におき，通常のレンダリングとバッファスワップを実施します．

MacBook Pro Retina, Mid 2012でOculus DK2を動かす

2014-09-07T23:36:00.000+09:00

はじめに

みなさんOculus Rift DK2 活用していますか？
高スペックPCを所有していないので，かるーいやつしか動かせていません．

SDKがver 0.4.1でosxにも対応されましたので，MBP retinaとりあえず動かしてみた次第です．※ 現時点（2014/09/07）の最新SDKは ver0.4.2です．

導入にあたりいくつか戸惑った点があったので，記録しておきます．

利用したもの

MacBook Pro Retina, Mid 2012

Processor 2.6 GHz Intel Core i7
Memory 16 GB 1600 MHz DDR3
Graphics NVIDIA GeForce GT 650M 1024 MB
Software OS X 10.9.4

Oculus Rift

Oculus Rift DK2 本体（HDM，カメラ）
Oculus SDK v 0.4.2 Beta (https://developer.oculusvr.com/?action=dl)

Oculus Runtime for Mac OS
Oculus SDK for Mac OS

導入方法

接続

oculus DK2本体およびトラッキング用カメラを接続します．

本体直挿しで，外部電源は不要でした．

Oculus Runtime for Mac OSのインストール

ドライバを入れないと認識しないので，上述のOculus Runtime for Mac OSをインストールします．dmgになっているので，叩くとマウントされます．

最近のosxはセキュリティが厳しいのでそのままでは動かないので，oculus_runtime_rev_1_sdk_0.4.2_osx.app を右クリックして「Open」から実行してください．

※ 多分私だけだと思いますが，ここでRuntimeのdmgを叩いてもインストーラが強制終了するという，不可解なエラーに遭遇しました．

原因はよく分かりませんが，ログ的にはメモリ確保にしくじっていました．

ググってみたのですが，英語圏でもそのような問題は出ていないようで，対処方法が見つかりませんでした．

結局，OSを再インストールしたら動くようになりました．
（OSのみ再インストールで，データはすべて残った状態で再インストールできたので良かったです…）

ファームウェア更新

firmware が最新じゃない場合は，最新にしておきます．（2014/09/07時点では，2.12です）

設定ユーティリティ (/Applications/Oculus/Tools/OculusConfigUtil.app)を起動して，メニューのTools/Advanced/Update firmware...から次のファイルを選択します．

/Applications/Oculus/Tools/Firmware/DK2/DK2Firmware_2_12.ovrf

画面の設定

ランタイムをインストールできたら，次はHMDの電源を入れて動作確認です．
osxの場合は，Extendモード（？）では動かないので，セカンドモニタとして認識されます．

ただい，接続しても画面周りがよく分からないことになっているので次の方法をとりました．

osxの画面設定（Preferences/Display）を ⌘+altを押しながらクリックして開く（画面の回転を有効にするため）
アレンジメントタブへ移り，画面のミラーを無効にする．
"Gather windows"ボタンをクリック（言語環境が英語の場合．日本語だと何か不明）
出てきた画面で，90°回転にして，default/native解像度を選ぶ
画面設定に戻って，ミラーを有効にする．（メイン画面の色が変になるけどそういうもんらしいです）

（参考URL: http://www.reddit.com/r/oculus/comments/2dbxve/041_with_dk2_on_a_mac_incompatible_resolution/）

あとは適当なデモを起動してoculusライフを楽しんでください！

所感

どうにか，MBPでOculus DK2を動かせました．
とりあえず動くという感じ．重い奴はFPSが出ないので酔いが厳しい．

osx対応のデモはまだ少ないので見つけにくいと思いますが，だんだん増えてくることと思います．Matrixのやつ(http://www.tipatat.com/TheMatrixVR/)はosx版もありました．ジャンプが成功しませんのでコツがあれば教えて欲しいです……．

だいたいのデモは，PS3コントローラで操作できるっぽいので一つ買っておくと良いです．
多分Xbox360のコントローラでも大丈夫だと思いますが，所持していないためosxで動作するか不明です．readme.txtにはxboxコントローラの説明ばかりなのですよね．
ちなみにPS3コントローラの場合は，ドライバなど不要で，BluetoothをONにするだけで使えます．

GLFWマルチモニタガイド日本語訳

2014-08-20T00:22:00.001+09:00

GLFWマルチモニタガイド

GLFW: Multi-monitor guide http://www.glfw.org/docs/latest/monitor.html

の勝手な日本語訳です．

モニタオブジェクト

GLFWmonitorオブジェクトは現在接続されているモニタを表現します。

モニタの取得

プライマリモニタはglfwGetPrimaryMonitorで返されます。通常、ユーザの優先モニタで、タスクバーやメニューバーのようなグローバルUI要素を備えています。

GLFWmonitor* primary = glfwGetPrimaryMonitor();

glfwGetMonitorsで、接続されているすべてのモニタを取得できます。

int count;
GLFWmonitor** monitors = glfwGetMonitors(&count);

ビデオモードの取得

GLFWは通常、フルスクリーンウィンドウを開く際に適切なビデオモードを選択してくれますが、あるシステムで正確にどのモードが利用可能であるかを知ることは時々役立ちます。例えば、ビデオモードの一覧をユーザに提示して、そこから選ばせるような場合です。利用可能なビデオモードの一覧を取得するには、関数glfwGetVideoModesを使うことができます。

int count;
GLFWvidmode* modes = glfwGetVideoModes(monitor, &count);

モニタの現在のビデオモードを取得するには、glfwGetVideoModeを呼び出してください。

const GLFWvidmode* mode = glfwGetVideoMode(monitor);

モニタの物理サイズ

モニタのミリメータ単位の物理的な大きさ、あるいはその近似値は、glfwGetMonitorPhysicalSizeで取得できます。

int widthMM, heightMM;
glfwGetMonitorPhysicalSize(monitor, &widthMM, &heightMM);

例えば、これによって、現在のビデオモードと合わせて、モニタのDPIを計算することができます。

const double dpi = mode->width / (widthMM / 25.4);

モニタ名

glfwGetMonitorNameでモニタ名を取得できます。

const char* name = glfwGetMonitorName(monitor);

モニタ名は、UTF–8エンコーディングのC文字列です。モニタ名は一意とは限らないことに注意してください。

モニタのガンマランプ

モニタのガンマランプはglfwSetGammaRampでセットすることができ、モニタハンドルとGLFWgammaramp構造体へのポインタを受け付けます。

glfwSetGammaRamp(monitor, &ramp);

モニタの現在のガンマランプは、glfwGetGammaRampで受け取れます。

const GLFWgammaramp* ramp = glfwGetGammaRamp(monitor);

一般的なガンマランプをセットしたいなら、glfwSetGammaで望みの指数からGLFWにそれを算出させることができ、それは結果のランプでglfwSetGammaRampを順に呼び出します。

glfwSetGamma(monitor, 1.0);

GLFW3の新機能

2014-07-20T11:31:00.000+09:00

V3.0の新機能

New features in version 3.0 http://www.glfw.org/docs/latest/news.html

CMakeビルドシステム

以前バージョンのGLFWでは各種makefileやプロジェクトファイルを利用していましたが、それ代わって，CMakeビルドシステムを使うようになりました．CMakeはGLFWがサポートするすべてのプラットフォームで利用可能で，ほとんどのパッケージシステムで提供されており，ほとんどのメジャーな開発環境用のmakefileやプロジェクトファイルを生成できます．

CMakeの使い方に関する詳しい情報は，CMakeのマニュアルを参照してください．

マルチウィンドウサポート

GLFWは複数のウィンドウ生成をサポートしました．各ウィンドウは、それぞれがOpenGLまたはOpenGL ESコンテキストを所有し，すべてのウィンドウ関数はウィンドウハンドルを持ちます．イベントコールバックはウィンドウ毎になり，イベントを受信したウィンドウのハンドルも渡されるようになっています．与えたスレッド上の現在のコンテキストを選択するためにglfwMakeContextCurrent関数が追加されています．

マルチモニタのサポート

GLFWはマルチモニタをきちんとサポートします．glfwGetMonitorsで列挙することができ，各種の取得にはglfwGetVideoModes, glfwGetMonitorPos, glfwGetMonitorName, glfwGetMonitorPhysicalSizeを使います。また、特定のモニタにフルスクリーンウィンドウ表示するための指定が可能になっています．

Unicodeのサポート

GLFW関数へ渡されるすべての文字列引数と戻り値は，UTF-8エンコーディングを使うようになりました．（ASCIIはUTF-8のサブセットなので）拡張関数引数はもちろんのこと，ウィンドウタイトル，エラー文字列，クリップボードテキスト，モニタやジョイスティック名を含みます．

クリップボードテキストI/O

GLFWは、システムクリップボードへのプレーンテキストの書込みおよび読込みをサポートしました．これには，glfwGetClipboardString とglfwSetClipboardString関数を使います．

ガンマランプのサポート

GLFWはモニタのガンマランプの設定と読取りをサポートします．これにはglfwGetGammaRampとglfwSetGammaRamp関数を使います．ガンマ値からランプを生成して設定するglfwSetGammaもあります．

（訳注: ガンマランプとは、「各色成分の強さの段階ごとのガンマ補正後の実際に出力される強さの値」を順に並べた配列で，ガンマ補正のパラメータのようなもの，という認識です）

OpenGL ESのサポート

GLFWはOpenGL ESコンテキストの作成をサポートするようになりました．GLFW_CLIENT_APIウィンドウヒントをGLFW_OPENGL_ES_APIへセットすることによって、OpenGL ESコンテキストの生成がサポートされます．GLFWはOpenGL ES自体を実装しているわけではないので，使っているドライバがGLFWで利用できる方法のサポートを提供しなければならないことに注意してください．最近のnVIDIAとintelドライバはGLXとWGL APIを用いることでOpenGL ESコンテキストの生成をサポートしていますが，AMDはEGL実装を代わりに提供しています．

（実験的な）EGLサポート

GLFWは，CMakeオプションで選択できる，実験的なEGLコンテキスト生成バックエンドを持ちます．

高解像度モニタのサポート

GLFWはWindowsとOS Xの両方で高DPIモニタをサポートします．これは，フル解像度のフレームバッファを与えますが，他のUI要素はスケールアップされます．これを実現するために，glfwGetFramebufferSizeとglfwSetFramebufferSizeCallbackが追加されました．これらはピクセルで動作し，残りのGLFW APIはスクリーン座標で動作します．

エラーコールバック

GLFWは，より詳細な診断情報をアプリケーションへ渡せるエラーコールバックを提供するようになりました．コールバックにはエラーコードと詳細文字列が渡されます．

ウィンドウ単位のユーザポインタ

各ウィンドウはユーザ定義ポインタを持つようになりました．GLFWをC++コードへ統合するのをもっと簡単にするために，glfwGetWindowUserPointerで受け取り，glfwSetWindowUserPointerで設定します．

ウィンドウのアイコン化コールバック

各ウィンドウはアイコン化とその復元イベントのコールバックを持っています．それは glfwSetWindowIconifyCallbackで設定できます．

ウィンドウ位置コールバック

各ウィンドウは，位置イベントのコールバックを備えました．glfwSetWindowPosCallbackで設定できます．

ウィンドウ位置クエリ

ウィンドウ位置をglfwGetWindowPosで取得できるようになりました．

ウィンドウフォーカスコールバック

各ウィンドウはフォーカスイベントコールバックを備えました．glfwSetWindowFocusCallbackで設定できます．

カーソル enter/leave コールバック

各ウィンドウはマウスカーソルがクライアントエリアに入ってきた、あるいは、出て行った時のためのコールバックを持っています． glfwSetCursorEnterCallbackで設定できます．

初期ウィンドウタイトル

作成時にウィンドウタイトルを指定できるようになりました．glfwCreateWindowの引数の一つとして設定します．

隠しウィンドウ

ウィンドウはglfwHideWindowで非表示に，glfwShowWindowで表示できるようになりました．作成時の初期値として非表示にする場合は，GLFW_VISIBLEウィンドウヒントを使います．スクリーンに表示される前に指定した位置へウィンドウを動かすのと同じように，ほとんどのドライバで互換性のあるオフスクリーンレンダリングの実現方法です．

装飾なしウィンドウ

装飾（つまり，フレームやタイトルバーのようなもの）なしのウィンドウモードのウィンドウを作成できるようになりました．GLFW_DECORATEDウィンドウヒントを使います．スプラッシュスクリーンのようなものを作成できます．

修飾キービットマスク

修飾キービットマスクのパラメータが，マウスボタンコールバックとキーコールバックに追加されました．

プラットフォーム依存スキャンコード

スキャンコードパラメータがキーコールバックに追加されました．キートークンを持たないキーでも，GLFW_KEY_UNKNOWNに設定されたパラメータとして渡されて取得可能になっています．これらのスキャンコードは端末によって様々で，キーバインディングのために利用される予定です．

ジョイスティック名

ジョイスティック名をglfwGetJoystickNameで取得できるようになりました．

Doxygen ドキュメント

http://www.glfw.org/docs/latest/index.html

GLFW2から3への移行ガイド日本語訳

2014-07-05T10:43:00.003+09:00

GLFW2から3への移行ガイド日本語訳

Moving from GLFW 2 to 3 も翻訳しました．

削除された機能
- スレッド関数
- 画像とテクスチャのロード
- 文字アクション
- マウスホイール位置
- GLFWCALLマクロ
- Win32 MBCSのサポート
- XP以前のWindowsバージョンのサポート
- システム管理ホットキーのキャプチャ
- ウィンドウオープンのパラメータ
- イベントの自動ポーリング
- 自動終了
- GLUヘッダの読込み
既存機能の変更
- ウィンドウハンドル
- マルチモニタのサポート
- ウィンドウの終了
- 明示的なコンテキスト管理
- キーリビート
- 物理キー入力
- ジョイスティック入力
- ビデオモードenum
- カーソル位置
- 永続的なウィンドウヒント
名前の変更
- ライブラリとヘッダファイル
- 関数
- トークン

これはGLFW2から3への移行ガイドです。どんな変更や削除があったかを説明していますが、既存コードから新しいAPIへの移行時に必要な場合を除いて、新機能の説明しません。例えば、GLFW3でフルスクリーンウィンドウを作成するために、新しいマルチモニタ関数の使用が必要です。

削除された機能

スレッド関数

スリープ関数を含め、スレッド関数は削除されました。それらは、極めて原始的で、利用に際して統合化されておらず、GLFWの趣旨（すなわち、コンテキストや入力やウィンドウ）から外れ、時間を浪費します。もっと良いスレッドライブラリがありますし、C++11やC11の両方にネイティブなスレッドサポートが利用可能で、それらは牽引を獲得しています。
もしC++11やC11の機能を使いたいけれどコンパイラがサポートしていない場合は、GLFWの原作者が作成しているTinyThread++やTinyCThreadプロジェクトを参照してください。これらのライブラリは、C++11やC11のスレッドAPIの使いやすいサブセットを実装していて、実際にいくつかのGLFW3のテストプログラムではTinyCThreadを使っています。
とは言え、GLFW3は、GLFW2よりも良い、複数スレッドからの利用をサポートしています。セカンダリスレッドから、コンテキストをカレントにしてレンダリングすることができ、ドキュメントには明示的に関数がセカンダリスレッドから利用できるか、メインスレッドつまりmainを呼び出すスレッドからの利用のみを想定しているかを記述しています。

画像とテクスチャのロード

画像とテクスチャのロード関数は削除されました。 Targa画像フォーマットのみがサポートされており、それらのほとんどが初級者レベルのサンプルに利用されています。 GLFW3でそれらを十分高い品質を保証するためには、他のフォーマットをサポートするだけでなく、OpenGLのテクスチャ機能への現代的な拡張も必要です。それには、外部依存関係（libjpegやlibpngなど）を数多く追加したり、これらのライブラリのバージョンを固定してGLFWを出荷しなければなりません。
それを実現するためのライブラリが既にあり、この作業を重複することやGLFWへこの複製を紐付けることは不必要であると思います。 freeglutのようなGLFWに似たプロジェクトは、それらのライブラリから得ることもできます、そして、GLFWはOpenGLや標準入出力のようにどこでも利用可能であるためには、それらのライブラリのプラットフォーム依存の部分があってはいけません。

文字アクション

文字列コールバックのアクションパラメータは削除されました。これは、元々のGLFW、つまりスウェーデン人によって英国で開発していた時からありました。けれど、多くのキーボードレイアウトでは、ダイアクリティカルマーク（発音記号）を入力するのに1つ以上のキーが必要です。スウェーデン語キーボードでさえ、üのような稀なケースで同時押しが必要です。
文字列コールバックのアクション引数だけの削除であり、文字列コールバック自体の削除ではないことに注意してください。

マウスホイール位置

glfwGetMousWheel関数は削除されました。スクロールイベントは絶対的な状態を表現しませんが、代わりに文字列入力のような相対的な状態変化を解釈します。よって、文字列入力と同様に、返すための正常な“現在の状態”はありません。マウスホイールコールバックは、スクロールコールバックに置き換えられ、2軸のスクロール量を受け取れます。

GLFWCALLマクロ

Windowsで__stdcallを使うコールバック関数を作成するGLFWCALLマクロは削除されました。 GLFWはCで書かれていて、Pascalではありません。このマクロの削除は、GLFWユーザが覚えておくべき事項、つまり、すべてのコールバック関数をGLFWCALLでマークする必要があること、が1つ減ることを意味します。 DLLとDLLリンクライブラリの作成も単純化し、明示的に@nエントリポイント接尾語を無効にする必要がなくなります。

Win32 MBCSのサポート

GLFW3のWin32版は、MBCSモードでコンパインできなくなります。しかし、Win32 APIのUnicode版を使えば処理全体にはまったく影響しませんし、それを用いてウィンドウ作成するだけで、同じアプリケーションの他の箇所からMBCS関数を呼び出すことも完璧にできます。したがって、MBCSモードのコードを持つGLFWを用いたアプリショーションがあっても、GLFW自体がそれをサポートする必要はありません。

XP以前のWindowsバージョンのサポート

XP以前のWindowsバージョンの明示的なサポートは削除されました。これらの以前のバージョンでGLFW3を動かすことを妨げるようなコードはありませんが、それらのバージョンにないWin32関数を使っています。
WindowsXPは2001年にリリースされ、現在（2013年）までにそれ以前のすべてのバージョンのWindowsを置き換えましたが、今は急速にWindows7や8に切り替えられつつあります。 MSDNライブラリはWindows2000以前のバージョンのドキュメントを既に提供していませんので、たとえ努力する価値があったとしても、これらのバージョンとの互換性を維持するのが困難になっています。
Win32 APIはまだ残っていますし、GLFW3はWindowsXP以降で利用可能な関数のみを使っています。（Windows95をまだサポートしているGLFW2から見て新しい）XP以前のOSをサポートするとしても、最近のWindowsバージョンだけで用意されている多くの関数のためにランタイムチェックが必要となってしまいます。

システム管理ホットキーのキャプチャ

ALT+TABのようなシステム管理ホットキーを無効化して取得する機能は削除されました。ゲームや科学的な可視化やそれ以外であっても、モダンなアプリケーションは行儀の良いデスクトップ市民であることが望まれていて、フルスクリーンモードで動作している時でさえ、これらのホットキーが機能することを期待されています。

ウィンドウオープンのパラメータ

GLFW_OPENEDウィンドウパラメータは削除されました。ウィンドウオブジェクトが存在している限り、ウィンドウは“open”です。ユーザがウィンドウを閉じようとしたことを検知するためには、glfwWindowShouldCloseと閉じるコールバックを参照してください。

イベントの自動ポーリング

GLFW3は、glfwSwapBuffers上でイベントの自動ポーリングを行いません。これはglfwPollEventsまたはglfwWaitEventを自分で呼び出す必要があることを意味します。バッファスワップと異なり、イベント処理関数はすべてのウィンドウで1度だけ実行されます。

自動終了

GLFW3は、初期化時に、atexitにglfwTerminateを登録しません。したがって、GLFWが確保したすべてのリソースを適切に解放するには、glfwTerminateを終了前に自分で呼び出さなければなりません。

GLUヘッダの読込み

GLFW3は、GLUヘッダをデフォルトでインクルードしなくなり、GLU自体が非推奨になっています。ですが、GLFW3ヘッダのインクルード前にGLFW_INCLUDE_GLUを定義しておくことで、GLFW3ヘッダがGLUをインクルードするようにできます。

既存機能の変更

Window handlesウィンドウハンドル

GLFW3はマルチウィンドウをサポートしているので、ウィンドウハンドル引数がすべてのウィンドウ関連GLFW関数とコールバックに追加されました。新しく作成したウィンドウのハンドルは、glfwCreateWindow（以前はglfwOpenWindow）によって返されます。ウィンドウハンドルはGLFWWindow*型で、つまり、不透明な（訳注：opaque = 実装が隠蔽された）構造体へのポインタです。

マルチモニタのサポート

GLFW3はマルチモニタサポートを提供し、GLFWmonitor*ハンドル型と関連する関数群が追加されています。フルスクリーンモードのウィンドウを要求するには、GLFW_FULLSCREENを渡す代わりに、そのウィンドウでどのモニタを使うかを指定します。 GLFW2と同様の振る舞いを提供するために、glfwGetPrimaryMonitorがあります。

ウィンドウの終了

ウィンドウの終了は、他と同様にユーザがイベントイベントを引き起こすことで始まります。 GLFW2と異なり、GLFW3で作成されたウィンドウとコンテキストは、足元から消えたりしません。各ウィンドウは閉じるフラグを持つようになり、それはユーザがそのウィンドウを閉じようとした時にセットされます。デフォルトでは、何もせず、ウィンドウは開いたままで見えた状態を維持します。そこで、そのウィンドウを破棄する、他のアクションをする、あるいはその要求を単に無視するといった処理を自分で行います。閉じるフラグの状態をglfwWindowShouldCloseで取得することや、いつでもglfwSetWindowShouldCloseを使ってフラグをセットすることが可能です。
閉じるコールバックは、値を返さなくなりました。代わりに、閉じるフラグがセットされた直後に呼び出されます。そして、その値を上書きすることもできます。そうする場合は、イベント処理が完了する前にそれを行います。しかしながら、閉じるコールバックの中で（あるいは、他のウィンドウ関連コールバックで）、glfwDestoryWindowを呼び出せないかも知れません。
GLFW自体は閉じるフラグをクリアすることはありませんが、実装者はウィンドウを閉じるためにいくつかの理由でそれをセットすることが許可されています。例えば、ユーザがメインメニューから終了を選択した場合などです。

明示的なコンテキスト管理

各GLFW3ウィンドウはOpenGLコンテキストを所有しており、実装者とユーザだけが、どんなときでもスレッド上でどのコンテキストがカレントになっているべきかを知っています。したがって、GLFW3は、そのコンテキストがいつカレントになって、いつカレントじゃなくなるか、を仮定しません。それを決定するのはあなたです。
これは、他のことと合わせて、ウィンドウを作成した後で、OpenGL関数を呼出す前に、glfwMakeContextCurrentを呼出す必要があることを意味しています。

キーリピート

GLFW_KEY_REPEATの有効化は削除され、キーリピートはキーと文字列の両方で常に有効にになっています。キーコールバックでリピートの中から最初のキー押下を区別するために、新しいキーアクションGLFW_REPEATが追加されました。 glfwGetKeyはGLFW_PRESSまたはGLFW_RELEASEのどちらかだけを返すままであることに注意してください。

物理キー入力

GLFW2では現在のキーボード配列によって生成された値になっていましたが、それと異なり、GLFW3のキートークンは物理キーにマッピングされています。そのトークンは、標準US配列のキーボードを用いた値と対応する名前が付けられていますが、これは便利なだけでなく、ほとんどのプログラマがキー配列を知っていると仮定されています。
（例として） GLFW_KEY_LEFT_BRACKETは常に単一のキーであり、ユーザが使うキーボード配列がどんなものでも、同じ位置にある同じキーだということを意味しています。
キー入力機器は必ずしもテキストを入力することを意味しません、GLFW2ではとりあえず動いていたのでその方法を使っていましたけれど。テキスト入力のためにそれを使っているなら、GLFW2でも3でも、文字列入力コールバックを使わなければなりません。押下されたキーではなく、入力された文字列が取得できます。
GLFW3では、標準的な105キーのキーボードにおけるすべてのキーのトークンが用意されていますので、文字の ’a’や’A’をチェックする代わりに、GLFW_KEY_Aをチェックしてください。

ジョイスティック入力

glfwGetJoystickPos関数はglfwGetJoystickAxesへ名前が変更されました。
glfwGetJoystickParam関数とGLFW_PRESENT、GLFW_AXES、GLFW_BUTTONSトークンは、glfwJoystickPresent関数、軸とボタンカウントを返すglfwGetJoystickAxes関数とglfwGetJoystickButtons関数に置き換えられました。

ビデオモードenum

ビデオモードenumはモニタごとの値になっています。 glfwGetVideoModes関数は、必要な配列の大きさがどれくらいかを推定する必要はなく、指定したモニタのすべての利用可能なモードを返します。貧弱な定義された挙動をしていたglfwGetDesktopMode関数は、glfwGetVideoMode関数に変更されています。それは、現在のモニタのモードを返します。

カーソル位置

GLFW3は、ウィンドウがアクティブな場合だけglfwSetCursorPos (以前は glfwSetMousePos)を用いて、ウィンドウ上のカーソルの位置を設定することだけが可能です。ウィンドウがアクティブになっていない場合は、この関数は暗黙的に失敗します。

永続的なウィンドウヒント

ウィンドウヒントはウィンドウ作成時のデフォルト値へリセットされなくなりましたが、代わりに、glfwWindowHint（以前はglfwOpenWindowHint）やglfwDefaultWindowHintsによって変更されるまで、あるいはライブラリが終了して再度初期化されるまで、それらの値が維持されます。

名前の変更

ライブラリとヘッダファイル

メジャーバージョンのヘッダとの衝突を避けるため、GLFW3ヘッダはglfw3。hという名前になってGLFWディレクトリへ移動されました。同様に、GLFW3ライブラリはglfw3という名前になっています。ただし、Unix-likeなシステムの共有ライブラリとしてインストールされた場合を除きます。その場合はlibglfw。so。3というso名が利用されます。

関数

GLFW 2	GLFW 3	Notes
`glfwOpenWindow`	glfwCreateWindow	すべてのチャンネルビット深度はヒントになりました
`glfwCloseWindow`	glfwDestroyWindow
`glfwOpenWindowHint`	glfwWindowHint	すべての`GLFW_*_BITS`トークンを受け付けるようになりました
`glfwEnable`	glfwSetInputMode
`glfwDisable`	glfwSetInputMode
`glfwGetMousePos`	glfwGetCursorPos
`glfwSetMousePos`	glfwSetCursorPos
`glfwSetMousePosCallback`	glfwSetCursorPosCallback
`glfwSetMouseWheelCallback`	glfwSetScrollCallback	2軸のスクロールオフセットをdouble型で受け取ります
`glfwGetJoystickPos`	glfwGetJoystickAxes
`glfwGetWindowParam`	glfwGetWindowAttrib
`glfwGetGLVersion`	glfwGetWindowAttrib	`GLFW_CONTEXT_VERSION_MAJOR`， `GLFW_CONTEXT_VERSION_MINOR`，`GLFW_CONTEXT_REVISION` を使います
`glfwGetDesktopMode`	glfwGetVideoMode	現在のモニタモードを返します
`glfwGetJoystickParam`	glfwJoystickPresent	軸とボタン数は glfwGetJoystickAxes とglfwGetJoystickButtons によって提供される

トークン

GLFW 2	GLFW 3	Notes
`GLFW_OPENGL_VERSION_MAJOR`	`GLFW_CONTEXT_VERSION_MAJOR`	OpenGL ES にも適用するために名前を変更
`GLFW_OPENGL_VERSION_MINOR`	`GLFW_CONTEXT_VERSION_MINOR`	OpenGL ES にも適用するために名前を変更
`GLFW_FSAA_SAMPLES`	`GLFW_SAMPLES`	OpenGL API に沿って名前を変更
`GLFW_ACTIVE`	`GLFW_FOCUSED`	ウィンドウフォーカスコールバックに合わせて名前を変更
`GLFW_WINDOW_NO_RESIZE`	`GLFW_RESIZABLE`	デフォルトを逆にした
`GLFW_MOUSE_CURSOR`	`GLFW_CURSOR`	glfwSetInputModeで利用される
`GLFW_KEY_ESC`	`GLFW_KEY_ESCAPE`
`GLFW_KEY_DEL`	`GLFW_KEY_DELETE`
`GLFW_KEY_PAGEUP`	`GLFW_KEY_PAGE_UP`
`GLFW_KEY_PAGEDOWN`	`GLFW_KEY_PAGE_DOWN`
`GLFW_KEY_KP_NUM_LOCK`	`GLFW_KEY_NUM_LOCK`
`GLFW_KEY_LCTRL`	`GLFW_KEY_LEFT_CONTROL`
`GLFW_KEY_LSHIFT`	`GLFW_KEY_LEFT_SHIFT`
`GLFW_KEY_LALT`	`GLFW_KEY_LEFT_ALT`
`GLFW_KEY_LSUPER`	`GLFW_KEY_LEFT_SUPER`
`GLFW_KEY_RCTRL`	`GLFW_KEY_RIGHT_CONTROL`
`GLFW_KEY_RSHIFT`	`GLFW_KEY_RIGHT_SHIFT`
`GLFW_KEY_RALT`	`GLFW_KEY_RIGHT_ALT`
`GLFW_KEY_RSUPER`	`GLFW_KEY_RIGHT_SUPER`

Last update on Wed Nov 20 2013 for GLFW 3.0.4

GLFW3 Getting Started 日本語訳

2014-06-28T09:33:00.001+09:00

GLFW3 Getting Started 日本語訳

GLFW: Getting Startedの勝手な日本語翻訳です．GLFWを使い始める方は目を通しておくとよいでしょう．これを読めば，GLFWの大まかな使い方はわかるかと思います．

あ，オリジナル文書に用意されているリンクは機能してません＞＜

GLFWヘッダのインクルード
GLFWの初期化と終了
エラーコールバックの設定
ウィンドウとコンテキストの作成
OpenGLコンテキストをカレントにする
ウィンドウの閉じるフラグのチェック
入力イベントの受信
OpenGLによるレンダリング
タイマーの読み取り
バッファのスワップ
イベント処理
書いてみよう: 小さなGLFWアプリケーション

このガイドは、GLFW3を用いたシンプルなOpenGLアプリケーションを作る方法を解説します。ここでは、最も頻繁に利用される幾つかの機能を紹介しますが、それら以外にも多くの機能が存在します。 GLFW関数の詳細なドキュメントを見る場合は、関数名をクリックしてください（訳注：リンクしてません:-(）．
このガイドは、以前のバージョンのGLFWを使った経験がない方を対象としています。もしGLFW2を使ったことのある方は、移行ガイド（日本語訳）もご覧ください。

GLFWヘッダのインクルード

プログラムのOpenGLやGLFWを使うファイルでは、GLFW3ヘッダファイルをインクルードする必要があります。

#include <GLFW/glfw3.h>

これはGLFWのAPIの全ての定数、型、関数プロトタイプを定義します。また、OpenGLヘッダもインクルードされ、プラットフォームで動作させるのに必要な全ての定数と型が定義されます。
例えば、Windowsでは通常GL/gl.hをインクルードする前に、windows.hをインクルードする必要があります。これは、ソースファイルがWindowsに紐付けられて、コードの名前空間がWin32APIに汚染されます。
その代わりに、GLFWヘッダがそれを行いますが、windows.hをインクルードするのではなく、その必要部分だけを複製することで処理します。これは必要な場合にだけ実施されるので、もしwindows.hをインクルード済みであればGLFWヘッダはそれらのシンボルの再定義は行いません。

つまり:

自分でOpenGLヘッダをインクルードしないこと。GLFWが行います。
windows.hあるいはプラットフォーム固有のヘッダは、それらのAPIを直接利用するまでインクルードしないこと。
それらのヘッダが必要になった場合は、GLFWヘッダをインクルードする前にインクルードすること。GLFWはこれを検出する。

バージョン3.0からは、GLUヘッダglu.hはデフォルトでインクルードされなくなりました。もしインクルードしたい場合は、GLFW_INCLUDE_GLUをGLFWヘッダのインクルードの前に定義してください。

#define GLFW_INCLUDE_GLU
#include <GLFW/glfw3.h>

GLFWの初期化と終了

GLFWの機能を使う前に、ライブラリを初期化しなければなりません。これは、glfwInitで実行され、成功したなら非ゼロ、エラーが発生した場合はゼロを返します。

if (!glfwInit())
    exit(EXIT_FAILURE);

GLFWを使用しているときは、通常、プログラムの最後にglfwTerminateを呼び出す必要があります。

glfwTerminate();

これは、すべての残っているウィンドウを破棄して、すべての他のリソースを解放します。これの呼出した後は、GLFW機能を利用する前に、再度glfwInitを呼び出す必要があります。

エラーコールバックの設定

ほとんどのイベント(キーが押されたとか、GLFWウィンドウが移動したとか、エラーが発生しているとか)は、コールバックを介して報告されます。コールバックは単なるCの関数（またはC++の静的メソッド）で、イベントに関する引数を持ってGLFWによって呼び出されます。
glfwInitまたはその他GLFW関数が失敗した場合、GLFWエラーコールバックにエラーがレポートされます。エラーコールバックを設定することで、これらのレポートを受け取ることができます。コールバック関数自体はGLFWerrorfunのシグネチャと一致する必要があります。ここに挙げるのは、単にstderrにエラーの説明を出力する単純なエラーコールバックです。

void error_callback(int error, const char* description)
{
    fputs(description, stderr);
}

コールバックを設定することで、GLFWはそれを呼び出せることを知らせるには、glfwSetErrorCallbackを使います。これは、glfwInitより前に呼び出すことのできるGLFW関数のひとつで、初期化中にエラーが発生を通知を受け取るために、他のGLFWを使う前に設定するべきです。

glfwSetErrorCallback(error_callback);

ウィンドウとコンテキストの作成

ウィンドウ (とそのコンテキスト)glfwCreateWindowで作成され、作成されたウィンドウハンドルを返します。例えば、640x480のウィンドウモードのウィンドウを作成するには次のようにします:

GLFWwindow* window = glfwCreateWindow(640, 480, "My Title", NULL, NULL);

ウィンドウ作成に失敗した場合は、NULLが返されるので、それを確認する必要があります。

if (!window)
{
    glfwTerminate();
    exit(EXIT_FAILURE);
}

このハンドルは、すべてのウィンドウ関連関数に渡され、入力イベントと共に提供されるので、どのウィンドウがその入力を受け取ったかを知ることができます。
フルスクリーンウィンドウを作成するには、どのモニタにそのウィンドウを表示するかを指定する必要があります。ほとんどの場合、ユーザのプライマリモニタを選ぶのが良いです。 glfwGetPrimaryMonitorを使うとプライマリモニタを取得できます。上述のウィンドウをフルスクリーンにするには、単にモニタハンドルを渡すだけです:

GLFWwindow* window = glfwCreateWindow(640, 480, "My Title", glfwGetPrimaryMonitor(), NULL);

フルスクリーンウィンドウは、モニタの表示エリア全体をカバーし、境界や装飾を持たず、そして、モニタの解像度を要求したウィンドウサイズに最も近いものに変更します。
そのウィンドウを使い終えた時は、glfwDestroyWindow関数でウィンドウを破棄します。

glfwDestroyWindow(window);

この関数が一度呼び出されたら、そのウィンドウにはそれ以上イベントが届けられなくなり、そのハンドルは無効になります。

OpenGLコンテキストをカレントにする

OpenGLのAPIを使う前に、OpenGLコンテキストを取得しなければなりません。ウィンドウのコンテキストをglfwMakeContextCurrentを用いてカレントにします。他のコンテキストをカレントにするまで、あるいはコンテキストを所有するウィンドウが破棄されるまで、カレントコンテキストのままになります。

glfwMakeContextCurrent(window);

ウィンドウ閉じるフラグのチェック

各ウィンドウは、そのウィンドウが閉じられるべきであるかを示すフラグを持っています。このフラグは、glfwWindowShouldCloseでチェックすることができます。
ユーザが、タイトルバーの閉じるボタンを押す、あるいはAlt+F4のようなショートカットで、ウィンドウを閉じようとした時、このフラグは1にセットされます。その際、実際にはウィンドウはまだ閉じられていないことに注意してください。このフラグをモニタリングすることで、ウィンドウを破棄するか、ユーザに何らかのフィードバックを与えることができます。

while (!glfwWindowShouldClose(window))
{
    // Keep running
}

glfwSetWindowCloseCallbackでクローズコールバックを設定することで、ユーザがウィンドウを閉じようとした時に通知を受け取ることができます。そのコールバックはクローズフラグがセットされた直後に呼び出されます。
glfwSetWindowShouldCloseを用いて、自分自身でそれをセットすることも可能です。これは他の入力をウィンドウを閉じるに変換したいとき、例えば、エスケープキーの押下で閉じるようにしたいときに便利です。

入力イベントの受信

各ウィンドウは、すべての様々な種類のイベントを受け取るために設定できるコールバックを数多く持っています。キー押下、押下解除イベントを受け取るには、glfwSetKeyCallbackでキーコールバックを設定します。

static void key_callback(GLFWwindow* window, int key, int scancode, int action, int mods)
{
    if (key == GLFW_KEY_ESCAPE && action == GLFW_PRESS)
        glfwSetWindowShouldClose(window, GL_TRUE);
}

イベント発生時に実際に呼び出されるイベントコールバックに、上述したようなイベント処理が必要です。

OpenGLによるレンダリング

カレントOpenGLコンテキストを取得したあとは、OpenGLを普通に使えます。このチュートリアルでは、多色の回転する三角形をレンダリングしてみます。この例ではglViewportやglOrthoで必要とされるフレームバッファのサイズは、glfwGetFramebufferSizeで受け取ることができます。

int width, height;
glfwGetFramebufferSize(window, &width, &height);
glViewport(0, 0, width, height);

しかし、コールバックglfwSetFramebufferSizeCallbackを用いて、そこでglViewportを呼ぶことで、フレームバッファサイズを設定することも可能です。

void framebuffer_size_callback(GLFWwindow* window, int width, int height)
{
    glViewport(0, 0, width, height);
}

タイマーの読み取り

三角形を適切に回転させるには、時間の情報源が必要です。 GLFWは、glfwInitからの経過秒数をdouble型で返すglfwGetTimeを提供しています。時間の情報源は各プラットフォームにおける最も精確なものが利用され、一般にはマイクロ秒あるいはナノ秒の分解能を持っています。

double time = glfwGetTime();

バッファのスワップ

GLFWウィンドウは常にダブルバッファリングを使います。 2つのレンダリングバッファを持つことを意味しています; フロントバッファとバックバッファ。フロントバッファは画面に表示されているもので、バックバッファはレンダリングの対象のものです。
フレーム全体のレンダリングが完了した時、レンダリングしたフレームを表示し、そして、新しいフレームのレンダリングを開始するために、バックとフロントを入れ替えます。これはglfwSwapBuffersで行えます。

glfwSwapBuffers(window);

イベント処理

GLFWは、イベントの受け取りのため、および、ロックされていないことを示すための両方の目的のために、ウィンドウシステムと定期的に通信する必要があります。イベント処理は定期的に行う必要があり、通常、各フレームのレンダリングの前にとバッファスワップの後に行われます。
保留中のイベントを処理する方法は2つあります。 glfwPollEventsはそれらの受信済みイベントだけを処理して、すぐにリターンします。これは、ほとんどのゲームが行うように継続的にレンダリングする場合に最良のチョイスです。

glfwPollEvents();

新しい入力を受け取ったときにだけレンダリングの更新が必要な場合は、代わりに、glfwWaitEventsを使うのがベターです。それは、少なくとも1つのイベントが受信されるまで待ち、その間はスレッドをスリープしておき、それから、glfwPollEventsが行うようにすべての受信イベントを処理します。この方法は、CPUサイクルをかなり抑えることができ、例えば、いろんなエディットツールにおいて有用です。

glfwWaitEvents();

書いてみよう: 小さなGLFWアプリケーション

いま、GLFWを初期化し、ウィンドウを作成し、キーボード入力を取得する方法がわかったので、シンプルなプログラムを作成できるようになりました。

#include <GLFW/glfw3.h>
#include <stdlib.h>
#include <stdio.h>
static void error_callback(int error, const char* description)
{
    fputs(description, stderr);
}
static void key_callback(GLFWwindow* window, int key, int scancode, int action, int mods)
{
    if (key == GLFW_KEY_ESCAPE && action == GLFW_PRESS)
        glfwSetWindowShouldClose(window, GL_TRUE);
}
int main(void)
{
    GLFWwindow* window;
    glfwSetErrorCallback(error_callback);
    if (!glfwInit())
        exit(EXIT_FAILURE);
    window = glfwCreateWindow(640, 480, "Simple example", NULL, NULL);
    if (!window)
    {
        glfwTerminate();
        exit(EXIT_FAILURE);
    }
    glfwMakeContextCurrent(window);
    glfwSetKeyCallback(window, key_callback);
    while (!glfwWindowShouldClose(window))
    {
        float ratio;
        int width, height;
        glfwGetFramebufferSize(window, &width, &height);
        ratio = width / (float) height;
        glViewport(0, 0, width, height);
        glClear(GL_COLOR_BUFFER_BIT);
        glMatrixMode(GL_PROJECTION);
        glLoadIdentity();
        glOrtho(-ratio, ratio, -1.f, 1.f, 1.f, -1.f);
        glMatrixMode(GL_MODELVIEW);
        glLoadIdentity();
        glRotatef((float) glfwGetTime() * 50.f, 0.f, 0.f, 1.f);
        glBegin(GL_TRIANGLES);
        glColor3f(1.f, 0.f, 0.f);
        glVertex3f(-0.6f, -0.4f, 0.f);
        glColor3f(0.f, 1.f, 0.f);
        glVertex3f(0.6f, -0.4f, 0.f);
        glColor3f(0.f, 0.f, 1.f);
        glVertex3f(0.f, 0.6f, 0.f);
        glEnd();
        glfwSwapBuffers(window);
        glfwPollEvents();
}
glfwDestroyWindow(window);
glfwTerminate();
    exit(EXIT_SUCCESS);
}

このプログラムは、640x480のウィンドウモードの画面を作成してから、スクリーンの消去、三角形のレンダリング、イベント処理のループを、ウィンドウがユーザに閉じるまで行います。これはソースコード配布のexamples/simple.cにあり、GLFWをビルドする時に、デフォルトで他のサンプルと一緒にコンパイルされます。
コンパイル GLFWを使うプログラムをコンパイル・リンクする方法について知りたい場合は、Building programs that use GLFWを参照してください。

glfw3の使い方(VS2013)

2014-05-17T23:48:00.001+09:00

目的

glutがいけてないので，glfwを使ったOpenGLウィンドウの作り方をメモする．
久しぶりのウィンドウズ環境なので，いろいろ戸惑ったりすると思うので，備忘録として．

glfw3を静的ライブラリとして使う．

開発環境

Visual C++2013 Express Edition
Windows 8.1 (64bit)

準備

glfw3をダウンロード，配置
VCプロジェクトの作成
プロジェクトの設定

glfw3をダウンロード，配置

GLFWのダウンロードページへ行って「Windows pre-compiled binaries」からダウンロードします．

http://www.glfw.org/download.html

2つのパッケージがあるので，32bitか64bitの適切な方を選びましょう．

あとで作るVC++のプロジェクト設定にも関係するので，あとで決める，どっちも使うかも，という場合は，両方ダウンロードしちゃいましょう．

ダウンロードした「glfw-3.0.4.bin.WIN32.zip」か「glfw-3.0.4.bin.WIN64.zip」を解凍します．

解凍したファイルの中を次のようなライブラリ用のフォルダに配置します．以下の例は，私の場合の配置場所になっていますので，分かっている人はイイ感じのところにおいてください．

（※ VSから参照できる場所(C:\Program Files (x86)\Microsoft SDKs\Windows\v7.0A\Include\gl とか)に置いてもいいんですが，私の個人的なルールに従い別の場所に置きます）

こういう構成のフォルダを作ってあります：
c:\
└ usr\
　　└ local\
　　　　└include\
　　　　└lib32\
　　　　└lib64\

解凍ファイル内のincludeフォルダ内のGLFWフォルダを，上記includeにコピー．
lib-msvc120内のファイルをlib32またはlib64へコピーします．

osxならhomebrewで勝手に入ってくれて楽ちんなんですけどね...

nuGetでも入れられるようですが．

VCプロジェクトの作成

「ファイル」-「新しいプロジェクト」から，「Win32 コンソールアプリケーション」を作成．

プロジェクトの設定

メニュー「プロジェクト」-「～～のプロパティ」
構成プロパティの「VC++ディレクトリ」に，includeディレクトリとlibディレクトリへのパスを追加する．
ここで，$(PlatformArchitecture)を用いて，lib32とlib64が自動的に切り替わるようにしておくと32bitと64bitを気軽にスイッチできる．

インクルードディレクトリ： C:\usr\local\include
ライブラリディレクトリ： C:\usr\local\lib$(PlatformArchitecture)
「親を継承」的なチェックボックスはON．

さらに，続けてライブラリも設定する．
「リンカー」「入力」の「追加の依存ファイル」にライブラリファイルを追加．
opengl32.lib;glfw3.lib

サンプルを動かす

#include <GLFW/glfw3.h>
int main(void)
{
GLFWwindow* window;
/* Initialize the library */
if (!glfwInit())
return -1;
/* Create a windowed mode window and its OpenGL context */
window = glfwCreateWindow(640, 480, "Hello World", NULL, NULL);
if (!window)
{
glfwTerminate();
return -1;
}
/* Make the window's context current */
glfwMakeContextCurrent(window);
/* Loop until the user closes the window */
while (!glfwWindowShouldClose(window))
{
/* Render here */
/* Swap front and back buffers */
glfwSwapBuffers(window);
/* Poll for and process events */
glfwPollEvents();
}
glfwTerminate();
return 0;
}

（http://www.glfw.org/documentation.html のExample Codeから）

あとはビルドしてウィンドウが表示されることを確認しておしまい．

参考

GLFW: Getting started

床井研究室 2012年09月06日 [OpenGL][GLFW] (1) GLFW で OpenGL を使う

CSL::DevLog

xcode8でdoxygen commentのwarningが出る問題の回避策

開発環境構築 Win7 x64

Windows の開発環境構築

インストールするもの

トラブル対応

Vagrantの共有フォルダが参照できない

References

VirtualBoxにUbuntuをインストールしてnode.jsを立ち上げるまでのメモ

環境

手順

1. VirutalBoxをインストール

2. VirtualBoxにubuntuをインストール

Unityでレイトレ

Unity5でレイトレーシング

はじめに

なぜUnityで行うか？

なお他のアプローチとしては，任意のフレームをobj等に出力して，自作あるいは既存のレンダラでレンダリングする，という方法もあります．

開発環境

開発指針

ここから

準備（適当に）

絵を出す（モノクロから）

レンダリング結果を保持するキャンバスを用意して画面に表示する

レイを飛ばして，当たったところを表示する

オブジェクトの色を表示する

テクスチャマッピングを有効にする

参考文献

Unityの画面を動画にする

連番画像を動画にする

参考文献

はじめてのUnityプロジェクト：MMDを動かす

はじめに

環境

プロジェクトの作成

MMDファイルの読込み

動かす

カメラを自動追従に変更する

Xcodeでも「上の行に改行」したい！

GUI付きのビューアをつくりたいのでocornut/imguiを使ってみた

試したGUI

AntTweakBar (http://anttweakbar.sourceforge.net/doc/)

GWEN(https://github.com/garrynewman/GWEN)

CEGUI

AdrienHerubel/imgui (https://github.com/AdrienHerubel/imgui)

blendish

ハマりポイント

1. 文字がちっちゃい＝全体が小さい

2. 2フレーム目から描画されない；

買った本

読んだ

とりま

メモ

XCodeのLLVM(clang)でOpenMPを使おう(解決)

ここから本題です．

Xcodeで clang-omp の使い方

注意

補足

TODO

1024 x 768 with 20 path /subpx and 2x2 subpixel

遅いのでAABBを導入してちょっとだけ早くする

単純なレイキャスティング

使うライブラリ

glm OpenGL Mathematics (http://glm.g-truc.net/)

stb single-file public domain libraries for C/C++ (https://github.com/nothings/stb)

assimp : Open Asset Import Library (http://assimp.sourceforge.net/)

レイトレはじめます

GLFW: Oculus Rift ガイド 日本語訳

GLFW: Oculus Rift ガイド

LibOVRとGLFWヘッダファイルのインクルード

LibOVRとGLFWの初期化

Direct HMD モード

ウィンドウとコンテキストの作成

HMDへのウィンドウのアタッチ

拡張デスクトップ(Extend Desktop) モード

GLFWでHMDを検出する

ウィンドウとコンテキストの作成

HMDへのレンダリング

SDK歪曲レンダリング

クライアント歪曲レンダリング

GLFW: Oculus Rift ガイド日本語訳

GLFWマルチモニタガイド日本語訳

GLFW2から3への移行ガイド日本語訳

GLFW2から3への移行ガイド日本語訳