OpenGL3D 導入の始末記（Borland C++ Compilerへ）

初版作成：不明。2001年度内であることは確か。
二版作成：2002/10/18

2002/10/18:このページで説明してるOpenGL3DのDLL, LIB, Hファイルのインストールを、含まれているreadme.txtを追っていけば出来るようにした詰め合わせパックを用意しました。
SpecialSet.lzh(1.7MB)
　SGIのSDKに含まれている膨大なファイルの中から、必要なDLL, LIB, Hファイルを詰め込み、BCC用に変換し直したLIBファイルも含んでいます。また、VCを持っていなく、BCCで使う人のために、後々必要になるVCのwinmm.libもコソーリと含んでいたりします。
　とにかくこの詰め合わせパックに含まれているreadme.txtを追っていけばどうにかインストールできるかも。
　質問はメールにて、遠慮無くどうぞ。

前書き

ああ・・・一体何をやっているのだ？俺は・・・。
そう。
　・・・何から話したものか。実際、今だ心が興奮の渦に突き上げられ定まらないのだ。
　ああ。俺のいつものパターン。一瞬のひらめきの後に続く、大量の失敗。
　目に見えている。dllからのlibの切り出し。VC++用のlibファイルをBorland用のOMFコードへの変換。
　手動の.dllの交換、調整。

　今回はまだ良い。本の中でも一等最初のプログラムだから。たまたま動いたと言うこともできるのさ。
・・・まあいい。とにかく、俺はここに記すのみだ。
　どうやってVC++用に調整されたOpenGLライブラリ、GLUTをBorland C++ Compilerに組み込んだのかを。

　発端はいつも小さな事だ。glut-3.7.5-binを作ってくれた奴が、親切にもREADME-win32.txtの中でこんな事をアドバイスしてくれていた。本当にそれだけなんだ。

BORLAND NOTES:

    From what I understand, Borland supplies a utility that
    converts Microsoft Visual C++ .libs into Borland compatible
    files.  Therefore, the best method for Borland users is
    probably to get the precompiled versions of the library and
    convert the library.  To create an import library for Borland 
    from the DLLs, use the following command (from a command prompt):
          IMPLIB glut32.lib glut32.dll
    If IMPLIB crashes when called this way, try
          IMPLIB glut32.lib glut32.def
    using the glut32.def file in this distribution.

　最初は俺も何を言っているのかさっぱりだった。どうも、 glut-3.7.5-binの中に入っている glut32.libというライブラリはVC++用でそのままではBCC32では使えない。だから、BCCのツールの一つであるIMPLIBというのを使ってglut32.dllから
直接インポートライブラリを切り出せ、と言っているらしい。
　半信半疑でやってみたら、・・・ホントにライブラリファイルができてた。とにかく作られた以上は試してみる。俺は素直に
bcc55\libフォルダに突っ込んだ。

・・・おっと、状況説明がまだだったな。
　んー、まーあれだ。3Dプログラミングと言う奴を試してみたくなった俺は、さて何を使おうかと考えたのよ。
　以前から3Dプログラミング専用のライブラリにDirectXとOpenGL3D とかいうのがあるのは知っていた。DirectXはWindows専用なのは知っていたが、OpenGL3Dとは何か？まあ、１年に一度くらい考えたって訳だ。いずれ挑戦したい分野でもあったし。
　そんなある日。RedHatLinux 7.0Jの本の後ろのAppendixに載っていたパッケージリストに目を通していた俺はある文章に眼が止まった。「～OpenGLライクな～ライブラリ～」・・・そう、後に分かることだがOpenGL3DはLinuxにも移植可能なライブラリだった。このときからだな。DirectXではなく、3DをやるならOpenGL3Dを勉強しようとぼんやりと思い始めたのは。
　とはいっても、TurboC++でちまちまとしたDOS学習プログラムしかしたことのないずぶの素人には、3D云々よりもまずWin32APIの勉強をしなければならなかった。そこでまあ、足かけ１年くらいか。Win32API について二冊ほど読み終えたのは。そして、今ようやくOpenGL3D でもやろうかな、とこわごわ足を踏み出したってわけよ。

～ガラスのロープを目隠しで渡る
みんな淋しいサーカスの子供さ～（ダブルゼータガンダム後半オープニングテーマより）目次に戻る

本題

　じゃあ、OpenGL3Dの入手経過から話そう。
　参考にしようと兼ねだして買った本は、入門書の中でも比較的統合開発環境にとらわれない書き方をしている本だった。
つまり、VC++専用というわけではなかったんだな。それが気に入った。おれは「OpenGL3Dとはヘッダー、ライブラリ、DLLの一連のセットなのだ。」と言うことを学び、「とにかくこの三点セットを入手すればいいわけか。」と勝手に納得した。そして学校の端末で二時間ほどSGI社のホームページと格闘した。
　どうもOpenGLと一口に言ってもいろんなグレードがあるらしい。もっとも単純なOpenGLは単体ではダウンロードできないらしい。現在は Graphics SDKとして、その他もうちょい上のレベルのセットとかと一緒に、パックされてる。また入門書で使っているGLUTと言うのも入手しなければならないが、これまた２，３バージョン出そろっている。ええい、どうせこちらはMOだ。落としまくってやれと頑張った。

　さて、ここからが問題だ。早速それらのセットを解凍してみたんだが・・・どうも、ライブラリやヘッダー、DLLが重複してるんだ。当たり前の話だけど。ただ悪い予感を感じたのは、ファイルのタイムスタンプなんだ。
　Graphics SDKを解凍すると(SGI\dev\)graphicsの中に、サンプルファイルやそれらの実行ファイル、実行やコンパイルに必要な三点セットが入っていた。実行ファイルもあったので、早速実行・・・の前に。「あ、OpenGL32.dllをwindows\systemにコピーしなくちゃ。」・・・「ん？もうあったのか。でもメーカーが出してるDLLの方が新しいか、最適化されてるに決まってるよね。よし、上書き・・・と。」
　そう。メーカーを信じすぎた俺は、ろくにタイムスタンプも見ずに前のDLLを上書きしてしまったのだ。そして、上書きしたファイルのタイムスタンプは、依然のより確かに古いものだった。
　そして実行ファイルが動かなくなった。
　これには焦った。だって前のDLLは完全に上書きしてしまった。やばい。だが幸運にも、二台目のパソコンは無事だ。よし、二台目の方からOpenGL32.dllをコピーしてきてタイムスタンプを確認しよう。そっちの方が新しければそのまま上書きしてしまう。何しろ、使ってるWin98SEのCDROMは同じなのだから・・・（おっと）。
　そう。なぜ。なぜ、メーカーの提供するDLLより、別のメーカーにバンドルされてきたDLLのタイムスタンプの方が新しいんだ？胸中に渦巻く不審の嵐に気づく暇もなく、事態は次の顔を静かに見せ始めていた。

　OpenGLはそんなに大量のヘッダーファイル、ライブラリファイル、 DLLで構成されているわけではない。
　簡単に解説すると、OpenGLの学習用にGLUTという、簡単にグラフィック用ウインドウを作ってくれるセットがある。このセットのglut-3.7.5-binには以下のファイルが含まれていた。
glut.h
glut32.dll
glut32.lib
README-win32.txt
　ポイントは、glut32.dllをwindows\systemフォルダに。ヘッダーファイルをインクルードし、glut32.libとリンクする。
それだけ・・・のはずだった。まあいい。それは後だ。
　glut.hの中を覗いてみると、以下の記述があった。

/* To disable automatic library usage for GLUT, define GLUT_NO_LIB_PRAGMA
   in your compile preprocessor options. */
# if !defined(GLUT_BUILDING_LIB) && !defined(GLUT_NO_LIB_PRAGMA)
#  pragma comment (lib, "winmm.lib")      /* link with Windows MultiMedia lib */
/* To enable automatic SGI OpenGL for Windows library usage for GLUT,
   define GLUT_USE_SGI_OPENGL in your compile preprocessor options.  */
#  ifdef GLUT_USE_SGI_OPENGL
#   pragma comment (lib, "opengl.lib")    /* link with SGI OpenGL for Windows lib */
#   pragma comment (lib, "glu.lib")       /* link with SGI OpenGL Utility lib */
#   pragma comment (lib, "glut.lib")      /* link with Win32 GLUT for SGI OpenGL lib */
#  else
#   pragma comment (lib, "opengl32.lib")  /* link with Microsoft OpenGL lib */
#   pragma comment (lib, "glu32.lib")     /* link with Microsoft OpenGL Utility lib */
#   pragma comment (lib, "glut32.lib")    /* link with Win32 GLUT lib */
#  endif
# endif

～

#include 
#include

つまり、このヘッダーファイルをインクルードしたプログラムを完成させるにはGL/gl.h, GL/glu.h の二つのヘッダーファイル。さらにライブラリとして opengl32.lib glu32.lib glut32.lib が必要だと言うことだ。 glut32.libは既にある。他のファイルについてもGraphics SDKのなかに収められていた。例えばGraphics SDK 1.1の中にはこれらのライブラリが収められていた。

dlls\glmf32.dll(98/11/24)
dlls\glu32.dll(98/11/24)
dlls\glut32.dll(98/11/30)
dlls\opengl32.dll(98/11/24)

include\GL\gl.h(99/01/14前後)
include\GL\glaux.h(99/01/14前後)
include\GL\glSGI.h(99/01/14前後)
include\GL\glu.h(99/01/14前後)
include\GL\glut.h(99/01/14前後)
include\GL\wglSGI.h(99/01/14前後)

lib\glaux.lib(99/01/14)
lib\glu32.lib(99/01/14)
lib\glut32.lib(99/01/22)
lib\opengl32.lib(99/01/14)

さらに、glut-3.7.5-binの中には
glut.h(00/12/13)
glut32.dll(01/10/04)
glut32.lib(01/10/04)
README-win32.txt(01/10/04)
があることはさっきも書いた。ああ。既に三つもファイルが重複している。

　他にも... (for Windows98SE)　windows\systemの中に
glu32.dll(99/05/05)
Opengl32.dll(99/05/05)

(for Win2kPro)　winnt\system32の中に
glu32.dll(99/12/17)
Opengl32.dll(99/12/17)（SPが適用されていると日付がより新しくなる）

　がある。

　これらのタイムスタンプから勘案するに・・・。
ヘッダーファイル：glut.h 以外はGraphics SDKのものを使う。
ライブラリ：同じくglut32.lib 以外はgraphics SDKのものを使う。
dll：glut32.dllはglut3.7.5を。glu32.dllとOpengl32.dllは動かさない。glmf32.dllは仕方ないのでSDKを使う。

と言うことで落ち着く。ところがだ。ここでようやく冒頭で話したこの文章が出てくるわけ。

BORLAND NOTES:

    From what I understand, Borland supplies a utility that
    converts Microsoft Visual C++ .libs into Borland compatible
    files.  Therefore, the best method for Borland users is
    probably to get the precompiled versions of the library and
    convert the library.  To create an import library for Borland 
    from the DLLs, use the following command (from a command prompt):
          IMPLIB glut32.lib glut32.dll
    If IMPLIB crashes when called this way, try
          IMPLIB glut32.lib glut32.def
    using the glut32.def file in this distribution.

　んーー・・・つまりアレか？IMPLIBっつーミニプログラムは、 DLLファイルから、DLLファイルに収められてる関数を呼び出す用の LIBファイルを作ってくれるっちゅーこと？良く分かんないけど。って、何だこのツールは！？こんなのがあるのか。うーん、勉強になった。さて作ってみるか・・・。とまあ、こんな感じで作ったわけ。
　glut32.dllの最新はglut3.7.5。ここからまー、指示の通りに
IMPLIB glut32.lib glut32.dll
　と打ち込むと・・・できました！！ホントかなー、動くのかなー、とどきわくしながらLibフォルダにコピー。その他のファイルも所定位置に置きました。さあ、コンパイルー！！って。あれ・・・。
　最初のエラーはこれ。
Error: 'D:\ORIGIN\BCC55\LIB\GLUT32.LIB' contains invalid OMF record, type 0x21 (posibly COFF)
　・・・きたよ。OMFレコードだよ。俺はこれが未だに良くわからんのだ。このOMFレコードとCOFFっつーやつは別の場面でもお目にかかったことがある。そう、さすがにリソースファイル(*.rc)で手動でコントロールの位置決めをするのにうんざりしてた頃。生成された.RES ファイルを、VC++が関連づけされた状態でダブルクリックしてしまったのだ。するとVC++がなぜかまともに起動してくれて、おまけにリソースエディタで開いてくれたりしたもんだ。おまけに.RESファイルのまま編集したのを保存したりして・・・。ひょっとして、この.RESファイル、ILINK32でリンクし直せるのかも・・・。
　無理だった。そう、COFF と OMF がどーのこーのと言ったエラーが出たのだ。
　ひょっとして・・・OMF とか COFFってのは、VC++とBCBそれぞれの、リソースやライブラリに使われている汎用データフォーマットみたいな奴じゃないのか？
　そんなことを考えながらIMPLIBをしたDOS窓でふとdir を打ち込んだら・・・。ん？「coff2omf.exe」ぇぇえええ！？
ま、ましゃか・・・

COFF to OMF Converter Version 1.0.0.74 Copyright (c) 1999, 2000 Inprise Corporation
Syntax:   COFF2OMF [options] InputFile OutputFile
  -h, -?  Display help
  -q      Quiet mode
  -v      Verbose mode
  -r      Remove (delete) output file if empty
  -lib:xx Specify options for OMF import library generation:
       ms - Allow entries that have MS C++ name mangling (default: no)
       st - Normalize names instead of aliasing MS stdcall mangling
       ca - Don't perform MS cdecl aliasing (default is to alias)

COFF2OMF will convert a COFF import library file (InputFile)
to the corresponding OMF type import library file (OutputFile).

　・・・うっっっっわーーーーーーーー！！！！！！！！！これって、よーするにVC++用のライブラリをbcc用に変換すると言う意味かーーーーーーー？？？？？？？
　そして、俺は試した。
　成功した。
　・・・エラーは、出なかった。

　と言うわけで、GLU32.LIBとOPENGL32.LIBについてもなるべくタイムスタンプの新しいものからIMPLIBでLIB生成、COFF2OMFでbcc用に変換。これにて、以下のエラーにも対処できた。
Error: 'D:\ORIGIN\BCC55\LIB\GLU32.LIB' contains invalid OMF record, type 0x21 (posibly COFF)
Error: 'D:\ORIGIN\BCC55\LIB\OPENGL32.LIB' contains invalid OMF record, type 0x21 (posibly COFF)

　何よりその威力が如実に現れていたのがこの部分。winmm.libがないと動かなかったのだが、幸運にもVC++を持っていたのでそこからコピー。 COFF2OMFでbcc用に変換した。見事に（多分）成功！！
D:\Origin\bcc55\Bin>coff2omf d:\origin\winmm.lib d:\origin\winmm_1.lib
COFF to OMF Converter Version 1.0.0.74 Copyright (c) 1999, 2000 Inprise Corporation

目次に戻る

後書き或いは感想

　かくして、入門書の最初のプログラムはどうにか作れた。
　が。
　一抹の不安がある。
　dllから切り出したLibだが、もとのLibと比べてファイルサイズが異様に小さいのだ。数キロから数十キロバイトしかない。
・・・もしかして。本来はdllの呼び出し以外にもいろいろな関数がリンクされていたりして・・・。
　ま、やばかったらそれなりのエラーが出てくれるだろう・・・。目次に戻る

トップページ＞＞＞「いろいろ」目次