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

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]].
- %%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]]
#br

**** Version 1.2 [#b2989113]
- It is more high Quality compared to previous version!
- It is not almost require manual operation on Unity3D.
- [[UnityChan>http://unity-chan.com/]] is supported.
- Auto selection of Shader and import of parameters using [[SelectOARShader>http://www.nsl.tuis.ac.jp/svn/linux/oarconv/trunk/Unity3D/Editor/SelectOARShader.cs]]
**** Version 1.3 [#l2b9293e]
- more high Quality. ([[SelectOARShader>http://www.nsl.tuis.ac.jp/svn/linux/oarconv/trunk/Unity3D/Editor/SelectOARShader.cs]])
- correct grass position
- decrease the number of texture files.
- correct to treat material xml file.
- modify to treat material name (add 32Byte Base64 name).
- ''Version 1.3.1''
-- support comps->factor of OpenJpeg
-- Ummmm. I forgot to include License Docs and UnityChan, sorry. orz
- ''Version 1.3.2''
-- change Shader in SelectOARShader
- ''Version 1.3.3''
-- fix ProfileCurve and HollowShape Bug
- ''Version 1.3.4''
-- add position offset function
#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.3 [#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.3.4 (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.3.4 (for Linux)>http://www.nsl.tuis.ac.jp/xoops/modules/d3downloads/index.php?page=singlefile&cid=4&lid=43]]

- Subversion Repository
-- 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

- ''%%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/]]
#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 -s 0 -e 0
#br

**** Help message [#a90ff5f4]
 oarconv [-i OAR directory] [-o output directory] [-a adding assets directores 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]
         [-p] [-d] [-v] [-h]

   -i : specify OAR directory. default is ./
   -f : specify object xml file. only specified file is converted.
   -o : specify output directory. default is ./DAE/
   -a : specify adding assets directores 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
   -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]
- This is Japanese Text

このソフトウェアに含まれるライブラリのライセンスの効力がこのソフトウェアにもおよぶ場合は，そのライセンスに従います．
この限りでない場合は，以下のライセンスに従います．

このソフトウェアは非商用に限りフリーで使用できます．再配布，改造等も非商用であれば作者に断り無く行うことができます．　ただし，再配布（改造後の再配布も含む）する場合は，元の配布物を完全に配布し，以下のコピーライトを必ず明記してください．

''OAR Converter: Copyright (C) 2014 Fumi.Iseki and K.Suzuki''

商用（このソフトウェアを使用したサービスで対価を得る場合も含む）で使用する場合は iseki@solar-system.tuis.ac.jp  までご連絡をください．(使用状況をお知らせください)
#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. 31)

Site Search

Login

Sub Menu

Books

mini Calendar

Who's Online

Access Counter
