From 061094ae40ce6bf4d3cd5e2cd1979234b4bc1ab8 Mon Sep 17 00:00:00 2001 From: Robert Osfield Date: Wed, 24 Apr 2002 13:05:03 +0000 Subject: [PATCH] Futher work on documentation - added seperate context.html, a new demos.html directory and moved the previous doc/index.html to doc/documentation.html. --- doc/contents.html | 166 ++++++++++++++++++++++++++++++++++ doc/demos.html | 103 +++++++++++++++++++++ doc/documentation.html | 46 ++++++++++ doc/images/hangglide.jpg | Bin 0 -> 2504 bytes doc/images/osgbillboard.jpg | Bin 0 -> 1449 bytes doc/images/osgcube.jpg | Bin 0 -> 1632 bytes doc/images/osghud.jpg | Bin 0 -> 4057 bytes doc/images/osgimpostor.jpg | Bin 0 -> 3700 bytes doc/images/osgreflect.jpg | Bin 0 -> 2886 bytes doc/images/osgscribe.jpg | Bin 0 -> 5283 bytes doc/images/osgstereoimage.jpg | Bin 0 -> 2763 bytes doc/images/osgtext.jpg | Bin 0 -> 1718 bytes doc/images/osgtexture.jpg | Bin 0 -> 2220 bytes doc/images/osgviews.jpg | Bin 0 -> 1759 bytes doc/images/sgv_cow.jpg | Bin 0 -> 1970 bytes doc/images/sgv_stereo.jpg | Bin 0 -> 1949 bytes doc/introduction.html | 66 ++++++++++++-- 17 files changed, 373 insertions(+), 8 deletions(-) create mode 100644 doc/contents.html create mode 100644 doc/demos.html create mode 100644 doc/documentation.html create mode 100644 doc/images/hangglide.jpg create mode 100644 doc/images/osgbillboard.jpg create mode 100644 doc/images/osgcube.jpg create mode 100644 doc/images/osghud.jpg create mode 100644 doc/images/osgimpostor.jpg create mode 100644 doc/images/osgreflect.jpg create mode 100644 doc/images/osgscribe.jpg create mode 100644 doc/images/osgstereoimage.jpg create mode 100644 doc/images/osgtext.jpg create mode 100644 doc/images/osgtexture.jpg create mode 100644 doc/images/osgviews.jpg create mode 100644 doc/images/sgv_cow.jpg create mode 100644 doc/images/sgv_stereo.jpg diff --git a/doc/contents.html b/doc/contents.html new file mode 100644 index 000000000..5f35b8fdc --- /dev/null +++ b/doc/contents.html @@ -0,0 +1,166 @@ + + + + + + OSG Distribution + + + +
Installation    Contents +of Distribution    Documentation   Plugin +Dependencies   Data Sources   +Contacts + +

+Contents of distribution

+./        Root directory. +
README     text +bare bones readme file. +
COPYING    text  +file containing the details of the OSG's Open Source LGPL license. +
AUTHORS    text file +containing names of contributors to the osg. +
NEWS       text +file listing coarse grained changes between releases. +
ChangeLog  text file listing +fine grained changes between releases. +
TODO       text +file listing  left to implement/extend/rewrite. +
FAQ         +text file listing Frequently asked questions. +
Makefile   Unix makefile. +
index.html This file!
+ +


doc/   Documentation directory +

index.html       +Documentation index +
osg/             +Scene graph reference guide. +
osgUtil/         +Scene graph utilities reference guide. +
osgDB/           +Scene graph database utilities reference guide. +
osgText/         +Scene graph text reference guide. +
osgGLUT/         +Simple GLUT based viewer base classes reference guide.
+ + +

include/     External includes +(i.e. files which would be installed in /usr/include) +

include/osg/       +The OSG library header files. +
include/osgUtil/  The OSG +Util library header files. +
include/osgDB/    The +OSG Database library header files. +
include/osgText/  The +OSG text library header files. +
include/osgGLUT/  The OSG +GLUT utiltiy library header files.
+ + +

src/    source files (including internal +includes) +

src/osg       +The OSG library source files. +
              +Contains all core osg classes, including reader/writer support for +
              +the .osg ascii format, and sgi's rgb image format. +

src/osgUtil  The OSG utility +library source files. +
              +Contains useful utility classes such as for setting +
              +up and rendering/draw. +

src/osgDB    The OSG +database utility library source files. +
              +Contains useful utility classes such as for reading +
              +and writing 3D databases and image files. +

src/osgText  The OSG +text library source files. +
              +Contains true type font rendering classes. +

src/osgGLUT  The OSG GLUT library +source files. +
              +Contains basic GLUT viewer base classes used by +
              +demo programs to bring up window and provide keyboard +
              +and mouse interaction. +

src/osgPlugins/     +Import/Export/Node kit plug-ins to the OSG. +
           osg/     +.osg native ASCII reader/write plugin. +
           flt/     +.flt Open Flight reader plugin. +
           lib3ds/  +.3ds Auto Studio Maxx reader plugin. +
           lwo/     +.lwo Light Wave binary (.lwo,.lw & .geo) reader plugin. +
           obj/     +.obj Alias Wavefront reader plugin. +
           pfb/     +.pfb (and others) Performer reader and writer plugin. +
           dw/      +.dw Design Workshop reader plugin. +
           rgb/     +.rgb RGB image file format reader plugin. +
           png/     +.png PNG image file format reader plugin. +
           gif/     +.gif GIF image file format reader plugin. +
           jpeg/    +.jpg JPEG image file format reader plugin. +
           pic/     +.pic PIC image file format reader plugin. +
           tga/     +.tga TGA image file format reader plugin. +
           tiff/    +.tif TIFF image file format reader plugin. +

src/Demos/ sgv/           +A basic scene graph viewer for the OSG which is loads .osg files and +above formats. +
           osgconv/       +A program which reads input files into a single scene graph and outputs +the results. +
           hangglide/     +A program which of creates a flying site and allows users to fly over +the scene. +
           osgtexture/    +A simple program which demonstrates how to use various textures modes. +
           osgcube/       +A basic animation of an oscillating cube. +
           osgreflect/    +A demonstration of multi-pass stencil buffer based planar reflections. +
           osgimpostor/   +A basic demo to show how to use the osg::Impostor node. +
           osgviews/      +A demo of multiple views of the same or multiple scenes. +
           osgtext/       +A demo of true type fonts support provided by osgText. +

+ +


lib/             +The local repository for the OSG library and plugins (files to be +installed in /usr/lib/ or /usr/local/lib) +

lib/osgPlugins/  The local +repository for the OSG plugins (files to be installed in /usr/lib/osgPlugins +or /usr/local/lib/osgPlugins) +

bin/             +The local repository for the OSG binary files (files to be installed +in /usr/bin or /usr/local/bin) +

Make/            +Unix platform specific make rules and dependencies. +

VisualStudio/    MS +VisualC++ 6.0 Make/Workspace files for Windows. +

dist/            +Distribution make files for RedHat Linux and IRIX. + + + diff --git a/doc/demos.html b/doc/demos.html new file mode 100644 index 000000000..4ce3360f2 --- /dev/null +++ b/doc/demos.html @@ -0,0 +1,103 @@ + + + + + + OSG Distribution + + + + +

+Running the demos

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
sgv cow.osgThe scene graph viewer demo uses osgGLUT::Viewer to bring up a basic viewer. To find out what + command line arguments it takes simply run sgv without any arguments. To load a model simple + run sgv filename.ext. The osgGLUT::Viewer provides an extensive set of operations that can be + used to display information about the loaded database such as peformance stas, through to + output a snapshot of the screen, which is how these thumbnails were created. For a full list + of key presses and mouse interaction read the sgv documentaion.
sgv -stereo cessna.osgThe scene graph viewer also supports anaglyphic, quad buffered, and split screen stereo modes, + for a full list of options and environmental variables see the sgv documentaion.
hangglideThe hang glide demo creates a simple flying site (Don Burns local hang glide site infact!), + demonstrating how to create simple terrain, trees and skydomes, and how to implement a simple + flight camera manipulator to allow the user to fly around. + .
osgbillboard lz.rgb + .
osgcube + .
osghud glider.osg + .
osgimpostor Town.osg + .
osgreflect cow.osg + .
osgscribe.cow.osg + .
osgstereoimage left.rgb right.rgb + .
osgtext + .
osgtexture lz.rgb reflect.rgb + .
osgviews.cow.osg + .
+ + + \ No newline at end of file diff --git a/doc/documentation.html b/doc/documentation.html new file mode 100644 index 000000000..f2d7d4a2c --- /dev/null +++ b/doc/documentation.html @@ -0,0 +1,46 @@ + + + + + + OSG Documentation + + + + + +

+Documentation

+The documentation on the OSG is still in its early stages, and far from +complete. If you can't find your answers in what documentation there currently +is, please feel free to post the question on the OSG mailing list. +

Introduction, distribution contents and contacts +

User documention +

sgv                +Documentation on key binding in sgv (Scene Graph Viewer.)

+
stereo            +Details on how to run osg applications in stereo.

+

Reference guides (automatically generated using doc++) +

osg/              +core scene graph reference guide. +
osgUtil/          +scene graph utilities reference guide. +
osgDB/          +scene graph database utilities reference guide. +
osgText/         +scene graph text reference guide. +
osgGLUT/      +simple GLUT based viewer base classes reference guide.
+

Doxygen-generated tarballs are available for download from the website

+

UML Diagrams +

osg                +UML diagram of the osg core library +
osgUtil           +UML diagram of the osg utilities library

+

Mind Maps +

Design +Pattern used in the OSG. +
Mission Statement for OSG.

+ + + diff --git a/doc/images/hangglide.jpg b/doc/images/hangglide.jpg new file mode 100644 index 0000000000000000000000000000000000000000..13b48d5072feb2ee99f97610167c1ea189fcfa7c GIT binary patch literal 2504 zcmbW!dpy(o9|!R7Ha2tJGBTFMFxRpTO_Ad=W7S+Ygj4Qkkz7j5B~+3|HJ8{yxeraq z_0aF&B#}6-A&KKMhjKFAlyY>=@A3OR9>2eSzu)Wg_iBL+w$mLjb$8r#R@Z0RIdK3=tED!X)65QacTe2mlO%K)_-Uad9!Ro$mOZIv|D= z-=#*dgvvYlz|_N0#H5==5;&{6P6g+oHyR}0h-A2=;%+6hvZfYZTSwQ(*yI4&^q{p3 z#g=MkPjhi)Fx}iej{Ers1P1-UIu&{LT-5pK81}_Wms75!UQOd>W@YEx%FW{ymz0*3 zSMV#V>hCu+HZ`}j{?zr$!|q2tk9+%uM@GlSpG{0o&HXmNu(%{#{(WU#wDI=c`wt&C zKYeq70Lb60o%e6pf4Go4F0hywL=5)L1p=Snxe%n7xEcYv%hCzv6E3e#Op-uZ-7Ko> zgyTrgZxnnZh9ng=jOH}gztR4Z{dchB|4a5S*uPy?U;)gTIMr87+V*{F z%SD8g1US^EXL(6})}CaVaOQEwKKgkn?uix$mjs*=O03APWhAS~Hlfdi(Uv-{FaG%@ z%@RJLay@*wmA}-&u6fp6Sz5bsJI#I4Wb15Ac zcdGGOA;q%}^;tF!mdra1F)?{va%=Za3~*QG3}Cm!0v2!(yhTCWm$(%j(U99l?4Gc$ z2Mc|JN}SLemsLy0>@_`9{MGU|GN+1KTPAgn@J$ar2a`8@Mj8D5rx#oi(9YSo^7g5T zeoDX}=4K5i-W)5TBPZ^k@ozhznoumLwXw3FLPa=~1=bXu$%s{M?tAZf&r8Cu4-xk|NGW`kF+0vR`h&lBz{|TjgPK| z9!35dD^E3VNR#zk3+z1e-n$N)d!ezn+8~5O%*WCq6Gif(Ps1@u2j%)2%dQISXLkMI zT!GdzViIO&heN7`{wu_vvnd)rrU36lSZhCiZJZhZ36pL3G%#*+bw_^S1@o^(QB$sq=2CR$=Iv zuWyXuKjs_aXDYp{kKWrgCvsb*6RH)?hF~4p!<$3(@0N;#Z;4<|j!-)Vr8dWWWZE!hXd-1qGi_;3Mcp?(SGYM=I%b8quYGuR zygqC9=4MYb?dFv6iJ#z)!svSCg}RLg)_QNup$(jB2bFa+YPW$T<)m`y1S^MDKYDmu zGG%YNYowQLmwwUVkG-FG8LU)LvAKg4$$4{pIjqB_{bTBvm*wvgHz0v@inRYD}v074@v(h)6&7D=0X?QKf z9xpSgV3`GyFXrHqqlM;r`MR$j)~U4#1-d=cO;GbwV@iTa+517?o!)1*so|ZeaqWr~ zt%k5H_dSfwRm_mW5`JSECMgTKv4u0`eAd*(DK#%{3E69@#-48yr7%fz}9pZ`q&Gx!^t`oc)YlzuOynpjG!(tY4WYi#fmOi(m`M<+Pml;pnnM$r)9o zXJwJyo{>>&47VsUM5N$jP#Pw+RWf4Kc|qRF|B4C~-9vMKu_QE$GOap&)guSz8GW5l zjZHY^qwBZmC|Ap80G)WPiti3eOx+JCHF|QBBmcI_<@Z%neFQk3!pi+9O!GSlN%6Yw zVwLF$v0w8uNg4UMe+$IsFa2+~epIkum4!(T>+1#16KLf^An@DS-88!^%LEL8p?rVA#>XR;m8fs zbdz?DFfO$t!RQzBN>gUf@cs6pWx3(>AE__YZ>!4&QZa(ZZ&Bj~8yUdiQK#eYaCZ`O zR*vnXsmh>S5a`<#G`3xTMSdg&mBWQ_lj_@d<^6ZZ32{CA$rfJ~>gGZMfBi6}-m9n%E&q5YF!Q_T--%KwD%0 literal 0 HcmV?d00001 diff --git a/doc/images/osgbillboard.jpg b/doc/images/osgbillboard.jpg new file mode 100644 index 0000000000000000000000000000000000000000..ad1a2fe7fc5b761cf1ffeb105a9535f823ce687d GIT binary patch literal 1449 zcmex=^(PF6}rMnOeST|r4lSw=>~TvNxu(8R<c1}I=;VrF4wW9Q)H;sz?% zD!{d!pzFb!U9xX3zTPI5o8roG<0MW4oqZMDikqloVbuf*=gfJ(V&YTRE(2~ znmD<{#3dx9RMpfqG__1j&CD$#!{;uIMSGJC7IkSbkd7~3E|GN(Iqb-HqyNv= z$xq|{+Ez+DHks`i+jC}hm{jStr3FgcI<_kqKYr?8R9#|v_vJpp%Wn!k_isJ@TH&XA zT=y5-&zH9*-e!JSFH$@6iQ1(Cwr9%k=Jiw_XIEC=R`G1(w^QMPcgifYG!|`F(OA^Q zfWWh2_^hAHg!nDdTzzuNqI-u|&dZYDb>N@Lnnf;JRZ{EBR=hC(a(r)bQuZm%qS99} z3bU_l-0@YJ%a46;c^v1JJ-0JWUhwbQNI;bage}^+1oU`pUU1!DkaL?cSuiK<0{8#Qb{#>`S?|I-M9BdlJG$ z4EJ0W+Sayi>f*vp?lU)eKAuo(H>K^7MP2Oi!WaG~zn7*pOwC=h=h+ICaB*cmyTA+A zEV}e>ecu@{e^<=b9g*G|2_Ck_fp>3ixzye>!T+A+^4k$hBvhX6-65K_Tk~Sxbd@u6 zw(inWZAoT5nPks%bpcb4216BBly*jNkDZ8j?mLk{*NCPrjRhP}W+uI!RP~^AiEuu1 zhUGiMzg0nJ7A$*wvC`ga-Q}8{J?k9K$7!ECdUd5_(OSX17RRpZu-$Ol%yh=zD^g^N zg=FH1U)O@;HkK-Ke*L*CY)zg@kHP!UmYNGCOMHEQPMoQFVY=begyYLiCPd%abMU(X z_xr{ur+W%-ei!+#H`TSOu(q#kURfY{;Cz(EqTM}*fDUqW6$xO3VkQ9&g`VasQs@4i zOSU{L>QG_%Iw~ZrRMTzgx}Y-cLC2 Iv;V&d0C5{Y!~g&Q literal 0 HcmV?d00001 diff --git a/doc/images/osgcube.jpg b/doc/images/osgcube.jpg new file mode 100644 index 0000000000000000000000000000000000000000..5779067a1bb4ec4aa266ae9651632094314f12da GIT binary patch literal 1632 zcmex=^(PF6}rMnOeST|r4lSw=>~TvNxu(8R<c1}I=;VrF4wW9Q)H;sz?% zD!{d!pzFb!U9xX3zTPI5o8roG<0MW4oqZMDikqloVbuf*=gfJ(V&YTRE(2~ znmD<{#3dx9RMpfqG__1j&CD$#!{;uIMSGJC7IkSbK(Je?tIiuy_aHx3X0Ztq z7EE$rp5&YEzxvpcj)48Y-5W!qJm34hjCpgOq2$m0wMAEtUT(WJ*JQ&~Eo-U%6^A$@ z_E#Lf++Z*NVfn2)CP$}!+);cqZB?s8U}Ml>#jb$AyZ>r;S=`*!xwk*?>4sjhX`4(} zED&&WJYf>PuENn(BtQY?j%D5^1wAKT?GL`T;%?T)V_XN@>w~|$|G3J!ZP%WB!;{Y! zTmFlmTNHNm(7ao7XVl1gojWPEuC#7--u@3}|C&}ldi8U=?4{(L5BOh33B25J%;@LD zy+7oqMuVb|@dDSU?BrDA7X>?2x2{~i>_0>0^uKeTy6?SV%zU9l{_(A8TTZYDR7ssH z(Rk{gb;!8r&YQKZts*t7`Z|7{QFHa0zc=!;{ekto za|HUQGMj&&JvmHc(GKbSu9h|-7}<>6TUrUvw3HCvO5Yjsb)Xk5{GoxVdQw85G8`CAWVoejaUq=C{pc>9;GZ zHERO@?0=B^9T*95g>PF$c6+|{61eu^aM=9AVnw0HA7<7R$JhR6P}~yyjX$dFf^~R^ z(Wy)KPCQsWKQZ~ky?Fi4n!fxqO)BIo9z0qf=vuWS#(YEX?A_^S(*@T)Msg|$v)~Omc9L1X~J`jP(Qu%@h8k0Z%ymc_PE?)Cz`A^bydiZC-+zH R2y_*71LZ45C}#hE697c{tw{g? literal 0 HcmV?d00001 diff --git a/doc/images/osghud.jpg b/doc/images/osghud.jpg new file mode 100644 index 0000000000000000000000000000000000000000..153408e59e43a1faae3039a2ae093ea53004793a GIT binary patch literal 4057 zcmbW&XHe7IwgB*dNPvVQ(tAyi-cd?|ptR7d^rE5^AwcLT2uM*-dXa+y(wm5ML5hF` z=>nk`diPMI7ioET?wj{!-luo(+Ozihu-EL_zu6xaae_DpT-Dal(f~jp003PsfH(=L z0#GtCaxzjVIXO8D2Bn~4pr)dvq++F`r(xh^{3h+hC&DDVIX1%vni5?T<+#>2OzYhbi7ix$mosk zk@I00q{9+(pzzz3ZH&f4+X$KaUe90@Ow25-Z2Z>*1ciiUuiuc9S5Q<{Q`gW$YiXO9 z-Z3+`u(Wb`@X*o8+2xV9kFTG9K;Yx>h{&ktFQQ|Tl2cOCUZ?++k(-xaP*_x4Qd(7A zQ(IU6siCpG<7+3b>sxov@Cbf%Y<%JeVSZt8X?bP!=ih5PyLxqt(U?*mSR<& zx6RCc=F`j*oM-xpu75PlE%`t;qw6bLEbqpN+oKrycA9k?v9anBS7t5d^v-3^7om%Y zx1fv)FNzKKA#*2eaX^Q`$kmQ}Y}e%3HLpLHi(|7{);bwSp1*v$Cis5c7tcj%V3YSer8QSAnlKWp_K&4c`nfO5^@lsMUgtlbFB=j8538(? z@uw@*)~c;G?o1s@GXBg&fYEeI^p_|??b97I-YNF%O{3!dV-}_04oLSarMkZ_X&}4blg=vR)#586-YZh(yx@H&b zn8BJKA`T^3Dq`$rO>CdWZ*Lj4#5#@gTf07;J9{^-;oc-P&w?f4?`$Um^ge^N#^Gz) z@!lyzL8N7C@3g#MIx8lR#8(i3(#D^%gOmaKSBDusWrpy$CXQXe?d?~P-pgH+9H3)! zPV5tsyJ)LS z(vC@+PLvvq&vOku099ag&>uSBv_k$Ris>tH%X+ZcY^u?8_BBaT9yQz&9ZaXO%Wi6E z9^^Kj5W1cuebZgz7Pn!rNJhb9#dc%6M?ZV+lw4aBlF;<{7BF6s5@q5BU7~ei=04s; zWbxt=n1Qj439y(8tvncf94z9vrGXb~S1(a%{n5!Mr8`cmVd6C>&Ey_i`RS)$lA>c( z(RN{}*oO+teVxygzT!uQJ(0H$y4&VXAIHhq#01ElwT3-ET`dG_tg7r?cP4 z^4-z&bL4HLB8B^(DupOU_p2_P+b=y-9EytH_1Kl%IG`*GKtw?oeEiJrZi~JRRXP1~ zk}>?!2)`TvS$7`l*ezv8>*KrcGcV6Qs9bEgUT`H0HCBOzlpgLl1w}(T=~)KQ@nBZ& zOwDUa_Y%U3t@EyVpEjW39DCJ;PzA280`Km7)04527wbd-4jXtiE1Tng!F-{*utQdX z5jAOhvaHQ`GhjYe-$>VWU~0P{%&YQ5Pjb<9$WDlP$WuSzn|5Gs#wOv6a! zRGXjbiVthTzVqrw zZ1pl0rMAlIT`%5^?Qf9qzx=5geVkBfalo8JWFA^Sk` z$j4k`!{Edv-6)O-9Il7tyjsDb-G32r-Ax%S59rKkKOdC|k%H8!1) zSSle_=O4J`sdpS)%Dh&D!(@pwo*8Z}cd;C6i5l`i?k(n&yTW0g;gG8;I1&2x6U^lC zO#2Lrol|XdY=Kk>?;Qkt`U#D<8t?PBHi72$)$T3MMp0bGRnLgP7tHUxqPRuFHw!d} zhM_hV!FBggbZV?>j%HMS=!>7^3QM7ZA0FG&*!4QSpZ<9SyOzpusw-vCuw)?lK2UuS z@AMIIC!57SAZgGJKi86W;O5wnyiq2Dh6{3Jr!WyZsPb5Ns3<}|+VecR^xfQ~aX+aD|DA|MZp`ilf+u?7pOyFuK#_=hf-sd+?Fk zH`e%gn{z_@3x735axm*`8pjotb^M)d=&`27_ZB$eeYPRIpg{iggcuI~(-D0!F<&=}@U@-5o2@F!~UfR2X1gJa;{Fn%6;8Dnha-_xh zQfD3(8Qy9lP10IQb$IPSsC z9GUs1lqumd5xX#w^z@R4cNyb_{hnDkB}h)pwbs^hpFnLxW><&++kPxurM2cbJ!6DV zsT^ND)mFK;f`~c2T|Xrjo|#h}YM}2rD83)=?9RM7X3|8#+SwF|gMp*KE~gzi#jif@ z`e8Q@ZEK%K>3w%m@6yj&U*AQtv(M7noyp7=O|89VjxKYX_CUn*edXoAezQsJ(#5kq zo24PKsgEf?Tq8r{UMqbk0@|J&zhm_M-GJmhs-TYZx6)$lrrGmWs#o3wBB~xO_^5?N zJNL0%0XQmJwPn8@hzYb?^>OjYv=#Qc-LI)^xSxbN9Zg--Xd@I@5+Lyz?9R9 zac`I1Uz@U%l(?OcxKWIN=$LuwI}Ihih~-n2P)!#;C}LIz`)_QPkZ|n5 z29o2jX#TWZ&Y%XbmT2p8WF28{NIqdfN0Hf+&qZT2=r*_bVLPg|(CUYa6@T+e86&F2=yxkFMnvFw{`8dj)T?EUx0#ofn?Q&^hlsas?S;fj+ulA5=<~L- z(PCYz5V;yc;+z|KJIUY3-it0r3t3$8sa&1GtT5+tii7^7tz9?~KoEh>%fYuw1oHG4 TObt9T&Tw(YF@j~Z#2^0!wx5F6 literal 0 HcmV?d00001 diff --git a/doc/images/osgimpostor.jpg b/doc/images/osgimpostor.jpg new file mode 100644 index 0000000000000000000000000000000000000000..3390366863d43e6c4b2a81d3cd232dc5e5cffbe0 GIT binary patch literal 3700 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 C?4o`E literal 0 HcmV?d00001 diff --git a/doc/images/osgstereoimage.jpg b/doc/images/osgstereoimage.jpg new file mode 100644 index 0000000000000000000000000000000000000000..5e2ad5d1bac1f0b121912df9434107f54b86a925 GIT binary patch literal 2763 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 Q_KH`e?T7xGM2m+02HkqvlK=n! literal 0 HcmV?d00001 diff --git a/doc/images/osgviews.jpg b/doc/images/osgviews.jpg new file mode 100644 index 0000000000000000000000000000000000000000..7d83b3a9b6d7812bf299e0c14c2ec2392b87f6fe GIT binary patch literal 1759 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 Scalability - the scene graph not only runs from portables all the way up to Onyx Infinite Reality Monsters, it supports the multiple graphics subsystems -found on the machines like the a mulitpipe Onyx. This is possible since the core scene +found on machines like the a mulitpipe Onyx. This is possible since the core scene graph supports multiple graphics context for both OpenGL DisplayLists and texture objects, and the cull and draw traversals have been designed to cache rendering data locally and use the scene gaph almost entirely as a read only operation. This allows multiple @@ -197,6 +197,42 @@ scene graphs. Numerous companies, university researchers and graphics enthusasts already adopted their projects, and are from all over the world.

+
+ +

Getting started

+ +

+The first thing is to select the distribution which suits you, there are binary, development and +source code distributions, these can be loaded from the +http://www.openscenegraph.org/download page. +The latest developments area available as via a nightly tarball or via cvs. +

+ +

+The binary distribution contains just the libraries (.dll's /.so's) and demo executables. +This is suitable for using the OpenSceneGraph with an application that has already been compiled +but depends at runtime on the OpenSceneGraph. +

+ +

+The development distribution contains the libraries (.dll's /.so's), demo executabls, include files, and source to +the demos. This is suitable for using the developers using the OpenSceneGraph. +

+ +

+The source distribution contains the all the source and include files required to build the OpenSceneGraph from +sratch, and is ideal if you want to learn more about how the scene gaph works, how to extend it, and to track +down and fix any problems that you come across. +

+ +

+If you are using a source disitribution then read the installation instructions +for how to get the OpenSceneGraph compiling and installed on your system. You may also need to download +libraries that parts of the OpenSceneGraph is dependant upon such as glut, check the +dependencies list for futher details. +

+ +

How to learn to use the OpenSceneGraph

@@ -205,24 +241,38 @@ already adopted their projects, and are from all over the world. The OpenSceneGraph distribution comes with a reference guide for each of the componet libraries - osg, osgDB, osgUtil, osgText and osgGLUT, a set of demos - the source of which can be found in src/Demos/.For questions or help which can't be easily be answered by the reference guide and demo source, one should join the openscene -gaph mailing list. A programming guide will be avaialbe in form of a OpenSceneGraph book which is being +gaph mailing list (details below).There is also the beginings of Wiki based FAQ +which may help answer a few of the common querries. + + +

A programming guide will be avaialbe in form of a OpenSceneGraph book which is being written by Don Burns and Robert Osfield, parts of it will be available.online.

Although not directly releated to the OpenSceneGraph, once can learn about scene graph technolgy from -such sources as the Open Inventor Mentor, and Performer Programming Guides. The later is the closest -in design/API structure to the OpenSceneGraph.

+such sources as the Open Inventor Mentor, and Performer Programming Guides. +The later is the closest in design concepts to the OpenSceneGraph, although Performer manuals is in C alas. +

+

+The OpenSceneGraph uses OpenGL and does with a deliberately thin layer, making it easy to control the underlying +OpenGL and to extend it with OpenGL extensions. The close tie with OpenGL is also reflected in the nameing +of many of the OpenGL state related classes, the the parameters that they encapsulate and means that knowledge +of OpenGL itself will go a long way to understanding how to get the best out of the OpenSceneGraph. To this +end it is worth obtaining a copy of the OpenGL programming guide - `Red Book` +and OpenGL reference guide 'Blue Book'. The main OpenGL website is also a good source of links and further information. +

-

Support and discussion - the OpenSceneGraph-news mailing list

+

Support and discussion - the openscenegraph-news mailing list

For scene graph related questions, bug reports, bug fixes, and general design and development discussion one should -join the OpenSceneGraph-news mailing list. +join the openscenegraph-news mailing list, +and check the the mailing list archives.

Professional support is also available in the form of confidential online, phone and onsite support and -consultancy, for details contact robert@openscengraph.com.

+consultancy, for details contact Robert Osfield at robert@openscenegraph.com.

\ No newline at end of file