Network System Laboratory - Backup source of OAR Converter(No. 40)

View the diff.
View the diff current.
Go to OAR Converter.
** OARCONV for Unity3D [#w9a5caae]
- This system converts from [[OAR]] of OpenSim to Collada files for [[Unity3D]].
- This software was developed by [[Fumi Iseki>Fumi.Hax]], ''[[Austin Tate>http://www.aiai.ed.ac.uk/~bat/]]'', Daichi Mizumaki and Kohe Suzuki
- %%If you need more quality, please use [[Tipodean's service>http://www.tipodean.com/converter/index.html]]. I think that system of Tipodean would be better quality than our system. %%  Tipodean is lost?
- [[Howto Build Unity Appli >./Unity3D]]
- Latest Version is 1.4.4
#br

**** for MS Windows [#j6251fd6]
- Windows UI is available now. Please see [[OARConvWin]].
#br

*** Change Log [#n096cc75]
- [[Change Log of Old Version>./Change Log]]
#br

**** v1.4.x [#h972db58]
- v1.4.4
-- fix "tree rotation bug" that tree does not rotation. re-generate tree images

- v1.4.3
-- correct Gray Scale Sculpt Image

-v1.4.2
-- support MS Windws

- v1.4.1
-- fix memory leak of STLTool, for VS C++

- v1.4.0
-- BREP (Boundary Representation) is used for vertexes arrangement. The data (dae file) size decreases.
-- support of output of STL file(s) using BREP
--- STLView: http://www.nsl.tuis.ac.jp/xoops/modules/d3downloads/index.php?page=singlefile&cid=7&lid=4
#br

*** Attention [#u6c728fc]
Japanese Text
- 全てのデータが問題なく変換できる訳ではありません．正確に変換できないオブジェクトがあります．
- 最大限の変換効果を得るには，エディタ拡張の [[SelectOARShader>http://www.nsl.tuis.ac.jp/svn/linux/oarconv/trunk/Unity3D/Editor/SelectOARShader.cs]] を経由して Unityにインポートする必要があります．
- その他，こちらで把握していない問題点が多数存在するものと思われます．
- SL Viewer は真に偉大なソフトウェアです （とても真似できん!）
#br

**** Not Support （そもそもコーディングしていない機能） [#y0a5b55f]
- サーポートしていないシェーディング方法があります（バンプマップ，スペキュラマップなど）．
- フレキシブルプリム，リンデンツリーはサポートしていません．
- スクリプト（パーティクルシステム）はサポートしてません．
- 水面・水中はサポートしていません．Unityのアセットを使用してください．
#br

**** Known Bugs （能力限界） [#g556f6ad]
- テクスチャが（正確に）読み込めない場合があります．
- アルファチャネルが正確に表示されない場合があります（アルファブレンディングなど）．
- 一部テクスチャが正確に貼り付けられない場合があります（チューブプリムの側面など）．
#br

** Version 1.4 [#qc579508]

*** Functions. [#wc153255]
| Normal Prim | OK |But Test is not enough |
| Sculpted Prim | OK |But Test is not enough |
| Mesh | OK |Textures are limited to 32 pieces |
| Tree & Grass | Middling |Linden Tree is not supported |
| Flexible Prim | No | |
| Terrain | Middling |Terrain Texture is not well |
| Var Region | OK | |
| Mega Region | Middling |Regions of non-root useless |
| Avatar/NPC | No | |
| Script/Particle System | No | |
| Media | No | |
| Water | No |Water level of Terrain will be 0m |
| Others | No | |


#br

*** Download [#f6b9aa88]
- [[OAR Converter Binary v1.4.0 (for x86_64 Linux)>http://www.nsl.tuis.ac.jp/xoops/modules/d3downloads/index.php?page=singlefile&cid=4&lid=46]]
- [[OAR Converter Source Code v1.4.0 (for Linux)>http://www.nsl.tuis.ac.jp/xoops/modules/d3downloads/index.php?page=singlefile&cid=4&lid=43]]
#br
- Subversion Repository (Latest Source Code)
-- JunkBox_Lib: http://www.nsl.tuis.ac.jp/svn/linux/JunkBox_Lib/branches/OARConv
-- oarconv main: http://www.nsl.tuis.ac.jp/svn/linux/oarconv/trunk
#br
- ''[[for MS Windows>OARConvWin]] ''
#br
- ''%%We do not distribute binary code, sorry. Please compile it by yourself.%%''
- Please see [[UnityChan License (Japanese Text)>http://unity-chan.com/contents/license_jp/]]

- [[STLView for STL files at Windows by Fumi.Iseki>http://www.nsl.tuis.ac.jp/xoops/modules/d3downloads/index.php?page=singlefile&cid=7&lid=4]]
#br

*** Install from Binary [#t5fa69f9]
**** If you are root [#i4f6cdac]
- Please extract zip file and execute make command.
- Require sudo command by distribution.
 # unzip oarconv_bin-x.y.z.zip
 # cd oarconv
 # make install
- If /etc/ld.so.conf does not include /usr/local/lib, please insert ''/usr/local/lib'' to ''/etc/ld.so.conf'' . And execute ''ldconfig'' command.
#br

**** If you are not root [#id60ff9a]
- Please exrtract zip file at your home directory.
- And please use ''~/oarconv/oarconv.sh'' shell script instead of ~/oarconv/bin/oarconv command
 $ cd
 $ unzip oarconv_bin-x.y.z.zip
#br

*** Install from Source Code [#t5fa69f9]

**** Needed External Libraries [#zd40935b]
- zlib devel package
-- If you can use yum command, please execute ''yum install zlib-devel'' command.
 # yum install zlib-devel -y

- [[OpenJpeg]] (v1.2) http://www.openjpeg.org/
-- https://github.com/uclouvain/openjpeg/archive/version.1.2.tar.gz
-- do not execute ''cmake .''
 # wget https://github.com/uclouvain/openjpeg/archive/version.1.2.tar.gz
 # tar zxfv version.1.2.tar.gz
 # cd openjpeg-version.1.2
 # make
 # make install
#br

- [[OpenJpeg]] (v2.x) http://www.openjpeg.org/ (This is a option, but we strongly recommend to install.)
-- We recommend to install ''v2.1'', too.
--- Why you install two versions of OpenJpeg?
--- Because there is a case v1.x can not read newer Jpeg2000.
-- https://github.com/uclouvain/openjpeg/archive/version.2.1.tar.gz
 # wget https://github.com/uclouvain/openjpeg/archive/version.2.1.tar.gz
 # tar zxfv version.2.1.tar.gz
 # cd openjpeg-version.2.1
 # cmake .
 # make
 # make install

**** Compile & Install [#tf329e06]
- Download and extract the package.

 # tar zfxv oarconv-x.y.z.tar.gz
 # cd oarconv-x.y.z
 # ./configure --enable-openjpeg
 # cd C++Lib
 # make
 # cd ../src
 # make
 # make install
- If you get ''aclocal error'', when you execute make. Please execute ''./config.sh'' command before ./configure command.
-- In this case, you need autoconf package.
#br

*** Usage [#o31ca9b8]
**** Example [#h438d24d]
- Show help message
 % oarconv -h

- You will get collada files in ./DAE directory.
 % mkdir OAR
 % cd OAR
 % tar zxfv (any directory)/oarfile.oar
 % cd ..
 % oarconv -i OAR -o DAE

- convert only xxxx.xml object.
 % oarconv -i OAR -o DAE -f OAR/objects/xxxx.xml

- convert only terrain data
 %  oarconv -i OAR -o DAE -e 0

- get a STL file of one object
 % oarconv -i ABYSS -o STL -f ABYSS/objects/Venus_428-154-3720__e633f42c-abb2-498b-aadb-ea6781506f98.xml -b
#br

**** Help message [#a90ff5f4]

 oarconv [-i OAR directory] [-o output directory] [-a adding assets directories that separated by ':'] [-f object xml file]
         [-t terrain texture scale] [-c external convert command of jp2]
         [-s start no.] [-e end no.]
         [-x shift of x direction] [-y shift of y direction] [-z shift of z direction]
         [-b] [-p] [-d] [-v] [-h]

   -i : specify OAR directory. default is ./
   -o : specify output directory. default is ./DAE/
   -f : specify object xml file. only specified file is converted.
   -a : specify adding assets directories that separated by ':'. default is /usr/local/share/oarconv/assets/:./assets/
   -t : specify terrain texture scale. default is 7.000000
   -c : specify external convert command from jp2 to other image. default is "/usr/local/bin/opj_decompress -i %s -o %s >/dev/null 2>&1"
   -s : specify start number of xml file. default is 0.
   -e : specify end number of xml file. default is -1 (minus number means infinity).
   -x : specify shift of x direction of all objects. default is 0.0
   -y : specify shift of y direction of all objects. default is 0.0
   -z : specify shift of z direction of all objects. default is 0.0
   -b : output STL file(s) using BREP.
   -p : when linked objects include phantom even one, saved to Phantom directory.
   -d : debug mode. display debug information.
   -v : display version information.
   -h : display this help messages.

 ex.) oarconv -i OAR -a /usr/local/opensim/bin/assets/TexturesAssetSet:./assets -d
#br

*** Bugs or Limitations [#l7c6d7ff]
**** oarconv [#h97c83df]
- %%Planar Texture is not supported.%%
- Texture Bumpmap is not supported.
#br

**** Unity3D [#r79cdfe6]
- Unity3D does not read some parameters from collada file. ex. light, glow, %%specular, bright%%.
- %%コライダー設定（物理設定）は読み込まれない．%%
#br

**** Collada [#v0cf8b88]
- Collada does not support ''BumpMap''
-- oarconv treats BumpMap as extra tag.

#br

*** Trouble Shooting [#s3f53a84]
**** Error messages:  "OARTool::ConvertTexture: ERROR: texture ..... convert error (-21, 127)." [#s73c3046]
- OpenJpeg v1.x can not convert those textures. Please install OpenJpeg v2.x, too.
#br

*** Demo [#m41bf72b]
- http://youtu.be/eOd5Vsb85q4  (OLD by v1.0)
- https://youtu.be/LUhqNJHLCuM (NEW by v.1.2.0)
- http://moon-light.nsl.tuis.ac.jp/unity/GardenOasis/GardenOasis.html  with Unity Chan
- http://moon-light.nsl.tuis.ac.jp/unity/B02/B02.html  with SD Unity Chan
#br

*** License. [#t9bbafac]
- License of this software is same as license of OpenSimulator.

- see also http://opensimulator.org/

#br

*** Exemption from responsibility. [#i7a1fccc]
This software is not guaranteed at all.
The author doesn't assume the responsibility for the problem that occurs along with use, remodeling, and the re-distribution of this software at all.
Please use everything by the self-responsibility.
#br
*** Address of thanks. [#g24aa86c]
- This system uses the source code and resource of OpenSim in part. see also http://opensimulator.org/
- This system uses the source code of OpenMetaverse in part. see also http://openmetaverse.org/
- This system uses OpenJpeg command and library. see also http://www.openjpeg.org/
- This system uses zlib library. http://www.zlib.net/

- This software is based on JunkBox Library. http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?Junk%20Box%20Library

- Thank you very much for all contributors!!
#br

*** [[Memos of Development>./devel]] [#i9436202]
#br
« Prev Next »
Backup source of OAR Converter (No. 40)

Site Search

Login

Sub Menu

Books

mini Calendar

Who's Online

Access Counter
