Network System Laboratory - Source of OAR Converter

View the diff.
Go to OAR Converter.
** OAR Converter 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
-- Copyright (c) 2014 Fumi.Iseki, Austin Tate, D.Mizumaki and K.Suzuki, http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?OAR%20Converter , All rights reserved.
- %%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]
- OAR Converter is provided under the following BSD type license.  

 OAR Converter Copyright (c) 2014-2016 Fumi.Iseki, Austin Tate, D.Mizumaki and K.Suzuki, 
 http://www.nsl.tuis.ac.jp/, 
 All rights reserved.
 
  Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
 
 * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
 * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
 * Neither the name of the OAR Converter nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
 * Please respect the copyright of content providers when using OAR Converter.
 
  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.



#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
Source of OAR Converter

Site Search

Login

Sub Menu

Books

mini Calendar

Who's Online

Access Counter
