叠濒别苍诲别谤ソースコート?リーテ?ィンク?
- 2. お前、誰よ? ● みつだ と言います。 ● Twitter ID = @lab1092 ● ただのBlenderヲチャー – この最近はSphinxベースになった Blenderのマニュアルに関心が移ってます ね
- 3. コード リーディング？ ”コード リーディング(code reading)とはプログラムのソース コードを読み解くことです。他人の プログラムをはじめ、自分が昨日書 いたプログラムを読むのです。” コード リーディングについて - http://www.codereading.com/codereading/about_code_reading.html
- 5. “コードは小説より面白い” ”優れたコードを読むことを習慣づ けた人は、間違いなくより優れた コードを書くようになります” Code Reading―オープンソースから学ぶソフトウェア開発技法(毎日コミュニケーションズ) 表紙より
- 7. 対象となる人 ● Blenderの開発で「貢献したい」と漠然と考 えている人 ● 中の仕組みを知りたい人 ● バグトラッカーで繰り広げられている何か、 の先を見たい人 ● 「開発者の気持ちを知りたい」というデザイ ナー?アーティストの人
- 8. Blender のソースコードを 読んでみよう - の前に済ませておきたいこと -
- 9. 目標 ①Blenderのソースコードを展開 して、 ②そのソースコード(.c)を ③テキストエディタを使用して ④眺める入り口まで
- 10. - 導入部 I - 予習しておいてもいいかもしれない、 さわりの部分。 これを終わらせてもまだ始まってもいない状態。
- 11. 準備 ①コードハイライト表示できるテキ ストエディタを用意する ②手がかりになるサイトを見つける ③ソースコードをダウンロードする
- 12. 準備 ①コードハイライト表示できるテキ ストエディタを用意する ②手がかりになるサイトを見つける ③ソースコードをダウンロードする
- 14. どのエディタがいいの？ 「どのエディタがいいですか？」ですっ て？それは宗教戦争になる恐れがあるの で、ここでは特定の「おすすめ」は差し 控えさせていただきます。 「プログラム エディタ」でググろう。
- 16. 準備 ①コードハイライト表示できるテキ ストエディタを用意する ②手がかりになるサイトを見つける ③ソースコードをダウンロードする
- 17. 困った時のBlenderWiki! ソースコードそのものを解説しているわ けではないですが、概念をつかむための 資料があります。 Code Documentation →http://wiki.blender.org/index.php/Dev:Source/Architecture
- 18. ふむふむ…古くない？ Diagram showing code layout
- 19. 新しい機能は Dev:2.6 から。 Blender 2.6 development documentation index →http://wiki.blender.org/index.php/Dev:2.6 例えば BMesh →http://wiki.blender.org/index.php/Dev:2.6/Source/ Modeling/BMesh/Design
- 20. ソースコードを読むための資料が 全て用意されていると思ったら 大間違いです。 - ここをどう解決するか、多分ここがポイントになります -
- 21. 違いの分かる男は… 履歴を追うぜ。 Blenderのリポジト リの下の方とか →https://developer.blender.org/diffus ion/B/
- 22. いや、そうなってくると 「ソースコードリーディング」 ではなくデバッグか何か別のもの ですから飞飞飞
- 23. 準備 ①コードハイライト表示できるテキ ストエディタを用意する ②手がかりになるサイトを見つける ③ソースコードをダウンロードする
- 24. 「tarボール」をダウンロード バージョン毎のソースコードのアーカイ ブが置かれている場所 Index of /source/ →http://download.blender.org/source/
- 25. tar.gz? tar.bz2? ソースコードのアーカイブファイルで す。たくさんのファイルを1つに集めて サイズを小さくするために圧縮したもの です。ソースコードを見るには、この ファイルを展開しなくてはなりません。
- 26. アーカイブソフト ● Windows – Lhaplus など？ ● Mac OS X - アーカイブユーティリ ティ(標準機能) ● Linux – コマンドラインでなんとか してください?(GUIのものもあったは ず)
- 27. ファイル展開、できましたか？ ● *.c *.h などのファイルとディレクトリ がそこにできていると思います。 ●ぶっちゃけ、どこに展開してもらっても 構いません(この段階では)。 ●ここからはじまります。
- 28. git clone? ● ああ、そんな方法ありますね。 ● このスライドでは「ソースコードのtar ボール」で済ませちゃってます。 ● とりあえず「読むところ」まで、ですの で。
- 29. というマエフリ。
- 30. - 導入部 II - これでコードを読めると思ったのかい？ HAHAHA!!甘い、甘いぜ。 金平糖並みだぜ。
- 31. 最初に見るものは？ ●??Dみたいな、コレ読んどけ、 「れどめ」的なものはあるの? ●ありますよ。(その振りおかしいw) いくつか。ビルド関連からかな？ ● えっ、いくつか？
- 32. Linuxだと ● build_files/cmake/exampl e_scripts/cmake_linux_ins tall.txt 見るとビルドの流れがわ かるかと。 ●ん？ cmake?
- 34. CMake ●ソフトウェアのビルドの自動化 ツール ●「ビルド環境情報」と「ビルドに 必要な処理」の面倒を見てくれま す(configure,make)。 ●大まかにわかってればいいよ?
- 35. doc/build_systems/cmake.txt ● cmakeするときのビルド手順のガイド だね。 ● scons.txtっていうのもあるけど？ ●どちらもビルドするときの文書だね。 ●ビルド?
- 37. CMakeLists.txt ● CMakeの設定とか書くところ ●「何の機能を入れる？」ってとこ ろですね。
- 39. 2.72フォルダツアー。
- 40. TextWranglar ● 必要のある時にエディタで見せようと思いま す。 ● (自分的備忘)フォルダ表示モードは View> Go Here in Disk Browser
- 41. ルートフォルダ
- 42. GNUmakefile ●これ、なんだろう？liteとか headlessとかあるけど？ ● cycles単体で、とかコンパイル するとか、その辺だと思います よ?
- 43. externフォルダ ●ライブラリ類ですね。 ● externフォルダは、あまり気に しなくてもいいでしょう…？
- 44. internフォルダ ●いろいろありますね。 ● 'ghost'っていうのがウィ ンドウマネージャだったと 思います。 ●あと'cycles'とかもありま すね。
- 45. 诲辞肠フォルダ
- 46. mystery_of_the_blend.html ● doc/blender_file_format にあります。 ●ブラウザで開いてみてください。
- 48. 本日のメインディッシュ? ●ソースコード(*.cとか*.h)は機能 別に分けられて格納されているよ うですね。 – ./<機能名>/*.h – ./<機能名>/intern/*.c
- 49. Blender のソースコードを 読んでみよう - もうそろそろじゃね？ -
- 50. 始めましょうか。 ● blenfont/intern/blf_dir.c ● *blf_dir_search() を見よう
- 51. さてここで悲しいお知らせ ● “BLI_join_dirfile”ってなんね？ ●かんすう？ ●このファイルには無いとよ？ ●他のファイルも見んといかんと？ テキストエディタだけじゃ太刀打ち出来ない…
- 52. そこに颯爽？と現れる「黒い画面」 ●「コンソール」とか「ターミナ ル」とか「コマンドプロンプト」 とかいろいろ呼ばれます。 ●コマンド入力してみよう。
- 53. grepコマンド ● “cd source/blender” ● “grep -rn BLI_join_dirfile”
- 54. 関数があるところを確認 .//blenlib/intern/path_ util.c ファイルパス 1904 行数 void BLI_join_dirfile(char *__restrict dst, const size_t maxlen, const char *__restrict dir, const char *__restrict file) 関数の型宣言していると ころ(常にvoidが来ると は限りませんよ？)
- 56. 他にもいろいろありますけど ● 大まかにこんな感じです。流れを追っ ていくのが大体の感じ。 ● 他にもおぼえることありますよ？ – if文の分岐などの制御文
- 57. そういえば関数名の「BLI」って？ ●関数名の名前に規則を付けていま す。 ●どのモジュールで定義されている かがわかるようになっています。 –blenlib → BLI –blenkernel → BKE
- 58. ctags ● ああ、そういえば「関数宣言している ところに飛べる機能」とか持っている テキストエディタ、あるね。 ● “ctags”でググってみよう。
- 59. まとめ
- 60. ● ソースコードリーディングの定義 ● 読むための準備 – テキストエディタ/サイト/ソースコード ● Blenderのソースコード ● 最初に見るもの ● 関数？ ● grepコマンド ● ctags?
- 61. おまけ ● ん？ blenderって Cなの？C＋＋な の？ ● 2.72だと – “find ./ -name *.c | wc -l” 1142 – “find ./ -name *.cpp | wc -l” 1213
- 62. おまけ2 ● 新しいBlenderのマニュアル – http://www.blender.org/manual/ ● スマホでも見てね ● Wiki→Sphinxベースに。 ● ただし英語(国際化の話はまだ？) ● bf-docboardで何かやってるよ
- 64. Thanks4Watching & Happy Blending!!