Let's begin 3D with Eggx(このページは2006年12月現在管理しておりません。)

簡単な紹介:

libeggx3dは３次元表示を可能にする EGGX用追加ライブラリです。

libeggx3d が出来る事:

ワイヤ・フレーム・グラフィクスを描くこともさながら、 条件付きで陰面処理されたグラフィクスを描くこと。ワイヤ・フレームのみに 限っているので軽いです。DRIを使わない MESAよりも30％位速いです。 (gears.cで計測しました。) 複数のウィンドウに同時に描画する事も得意です。

で、得意なこと:

計算結果を三次元ワイヤフレームグラフィクスで表示すること。 陰面処理は可能ですがあまり得意ではありません。 サンプル

必要な環境

1. 山内千里様がご提供されている　EGGX ライブラリ及びそれらが使える環境。 http://phe.phyas.aichi-edu.ac.jp/~cyamauch/eggx_procall/ からダウンロードできます。
2. UNIX X11コンパチブルでC言語での開発が出来る環境。 (3D accelerationハードウェアは必要ありません！)

試した環境:

Debian GNU/Linux 3.0 with Athlon XP 2000+ CPU, 512Mbyte RAM, ATI 3D Rage 128 video board.

今後の課題:
まず関数を全て‘EGGX3D’から始め、EGGX080（本家）との違和感をなくす。
これはバージョン030で対応させる予定。
画像マッピング、立体視、その他いろいろ。.
TODO:2011年正月をめどに、本家の090-093シリーズに対応できるように
このページを全面的に書き換えるつもりでおります

Contents:

紹介
コンパイルトラブルに見舞われた方へ
EGGXとは
libeggx3d とは

インストール
インストールの前に(旧バージョン利用の方へ)
インストール
ローカルディレクトリにライブラリを置いて使う方法

資料
資料：関数の仕様

紹介：

EGGXとは?

有名なライブラリなので説明するまでもないでしょう、が一応触れておきます。山内千里様が開発・管理されているライブラリで、http://phe.phyas.aichi-edu.ac.jp/~cyamauch/eggx_procall/.からダウンロードできます。X11絵画関数以外何も使わないシンプルな、しかし強力なライブラリです。``Software Design''2003年１月号でも詳しく紹介されていますので、ご参照下さい。

EGGXとは山内千里様が開発されたUNIX（Linuxを含む）用2次元可視化ライブ ラリ、及びそれを使いやすくする為のコマンドを合わせた総称です。含まれ ているもっとも主な(FORTRANの事を考えなければ唯一の)実行コマンド「egg」 コマンドは単にEGGXで必要なライブラリ（x11やEggXライブラリ）等をリン クしてくれる以外はGCCとまったく同じ作法で使えるコマンドです。誤解を 恐れずに言えばCコンパイラを別の名前で呼び出しているだけのものです。 現にEGGXの機能を用いるにはGCCからでも利用できます。設計思想が大変素 晴らしく、8bit時代のグラフィクスの扱いの簡単さを最新の技術で実現して おり、初心者のプログラム学習から専門家のデータの可視化ツールの為の利 用まではば広く使える、大変強力なライブラリ及びコマンドセットとなって います。またFORTRANからも利用出来るようになっています（ここでは触れ ませんが）。

で、 ``libeggx3d''て何？

``libeggx3d'' とは、EGGX上で、三次元グラフィクスが扱えないかと模索し、 私（小渡　英）が作ったライブラリです。 知識の無さからワイヤフレームグラフィクスしか主に扱えませんが、 うまくごまかせば、陰面処理されたポリゴンも扱えます。 OpenGL/MESAは使わない方針です。OpenGLを使えば三次元を扱う上で近道ですが、 なんと言っても複雑で大きく、ハードウェア資源を必要とします。 世の中にはOpenGLを使えない環境もきっとあるでしょう（？）。 X11しか使わないことにこだわりました。

`libeggx3d'は EGGX及びX11のみを利用していますので、EGGXとX11が動く環境さえ整っていれば手軽に三次元 （但し針金）グラフィクスが楽しめます。Visualizing（可視化）ツールに使えるのではと 考えて作りました。
インストールした後はeggコマンドあるいは C-Compiler（GCC,CC等）から引数に`` -leggx3d'' を付け加 える事で利用出来るようになります。

ごたくくだくだ

自重気味に小文字で命名したのですが、 libeggx3dのお粗末さには自分でも恥ずかしくなるくらいで、小文字であろう ともeggxを名乗るに値しないライブラリだと考えています。（これを読まれた 皆様、何か良い命名があったらお教え下さい）。とりあえず現在の所、針金 （ワイヤフレーム）グラフィクスのみに使うのが妥当な利用方法だと考えてい ます。基本的にはワールド座標系内で視点と目標点を定めた後は単に三次元か ら二次元に座標変換するだけのライブラリですから、物体の前後処理さえ施せ ばポリゴンも扱えます。で、一応ワールド座標から視点座標に写す際に視点か らの距離をもとめる関数も用意してありますので、力の余っている方はポリゴ ンの利用もチャレンジしてみて下さい。（ポリゴンを描く関数も用意してあり ます。使い道あまり無いですが。）

ライセンス

なお、libeggx3d と EGGXは同時に利用で きます。いくつか機能の重複する関数もありますが、 それらはgopen3d()関数で 開いた限りlibeggx3d関数の方がEGGX関数の上位互換となっております。

``libeggx3d'' は GNU Public License下で配布します。.

インストール

新しい``libeggx3d''をインストールする 前に

ダイナミックリンクにしたのでこれまでのeggx3d.h, libeggx3d.a は削除して下さい。恐らく、それぞれ /usr/local/include と /usr/local/lib に配置されていると思います。

``libeggx3d''はEGGX追加ライブラリです。 EGGX を　先にインストールして下さい。

山内千里様が提供してくださっているウェブサイトから EGGX http://phe.phyas.aichi-edu.ac.jp/~cyamauch/eggx_procall/ をインストールして下さい。 2004年3月15日現在最新のバージョンはEGGX080です。 2010年11月現在のEGGXの最新バージョンはEGGX09xであり、 libeggx3d_029シリーズで動作しないことが判明しました。 ので、libeggx3d_029シリーズのリンクを外しました。 古いlibeggx3d_020r2シリーズからlibeggx3d_030r1.tar.gzを派生させました。 EGGXを設定し、それから libeggx3d_030r1.tar.gz, をこのページからダウンロードし以下の説明にある通り設定して下さい。 これには肝心なlibeggx3d.c と eggx3d.h, そしてデモ・プログラムが含まれています。 環境に応じてお使い下さい。

ダウンロードしたら

$ tar tzvf ./libeggx3d_0xxrx.tar.gz

を実行しソースファイルしか含まれていないことを確認されるのをお勧めします。その後コマンドラインから

$ tar xzvf ./libeggx3d_0xxrx.tar.gz

その後

$ ./configure
$ make
$ su
# make install
# ldconfig

を実行すれば、 libeggx3d.a が/usr/local/lib/に、eggx3d.hが/usr/local/include/に配置されます。私の環境ではうまく動きますが、他の環境では試していません。


3D プログラムは次のようにコンパイルして下さい。:

$ egg -o axis3d axis3d.c -leggx3d

前もって ソースプログラム、この場合は axis3d.cにヘッダファイルをインクルードしておくのを忘れないで下さい。（＾＾;

#include <eggx.h> 
#include <eggx3d.h>

./configure;make;su;make install がうまく行かない場合

$ egg -o axis3d axis3d.c libeggx3d.c

でコンパイル可能です。ヘッダファイルの配置位置に注意して下さい。ローカルディレクトリに入れる場合は以下のようにして注意して下さい。

#include <eggx.h>
#include "eggx3d.h" 
/* note quoted with double quotation mark
in this case. */

/usr/local/lib

# ldconfig

資料：ライブラリ libeggx3dの使い方:

バージョン010r1から関数の数が11つから19に増えました。 しかしこの変更は主なしよう変更であるマルチウィンドウ化に伴うもので、 必ず使わなければならない関数はむしろその半分です。

`libeggx3d'関数群：

	int gopen3d(float xsize, float ysize);

	void gclose_window(int win)

	void gclose3dall(void)

	
	void pset3d(int win, float x, float y, float z);

	void line3d(int win,float x, float y, float z,int mode);

	void circle3d(int win, float radius, float centerx, float centery, float centerz
			,float normalx, float normaly, float normalz);

	void drawarrow3d(int win, float xhead, float yhead, float zhead
				,float s, float w, int 10*i+j );

	void gcoord3d_to_2d(int win, float x, float y, float z, float *fx, float *fy);

より詳細な設定関数：

	void gset_eye_at(int win, float vx, float vy, float vz);

	void gset_look_at(int win, float hx, float hy, float hz);

	void gset_screen_distance(int win, float screen_distance);

その他の関数：
平面座標系設定関数：

	window_range(int win, float sx, float sy, float ex, float ey);

描画関数：

	fillpoly3d(int win, float x[], float y[], float z[], int datanum);

				
	float gdepth(int win);

視点座標系座標を得る為に、またそれを使う為に用意された関数：

	gviewx(int win);
	gviewy(int win);

	gcoordv3d_to_2d(int win, float x, float y, float z, float *fx, float *fy);

おまけ的関数：

	void gget_eye_at(int win, float *vx, float *vy, float *vz);

	void gget_look_at(int win, float *hx, float *hy, float *hz);

何か御意見、a庫fkowata atmark g02 dot itscom dot net までメールを下さい！

/eof

References：([1] [2] and [4] are written in Japanese)
[1] PC9801/PC-8801 3次元グラフィックス入門、永山嘉昭・著、日刊工業新聞社、昭和61年（1986年）4月25日発行
[2] 実習グラフィックス　（アスキー・ラーニングシステム２実習コース）、佐藤義雄・著、アスキー出版局、1986年6月25日発行
[3] ANGEL, Edward, Interactive Computer Graphics --- A Top-Down Approach Using OpenGL, Third Edition, Addison-Wesley, Reading, MA, 2003
[4] YAMAUCHI,Chisato, EGGX/ProCALL version 0.78 (EGGX manual), Dec.19th, 2002

Back to TOP>LINUX



多摩丘陵の一部。標高は十倍に拡大。実際には非常になだらかな地形です。

近隣に建設予定の公園の予想図