Yamyam: 1版をインポートしました

2018-06-28T17:51:46Z

1版をインポートしました

wiki>Mindrones bot: Bot: Fixing redirects

2010-05-26T18:57:21Z

Bot: Fixing redirects

新規ページ

{{Page/Header|2.4|prevpage|nextpage}}

== Introduction ==
The purpose of this document is to provide user's guide for Uni-Verse Acoustic Simulation (UVAS), which is a computer software for room acoustic simulation. The UVAS can be used with other Uni-Verse tools for creating acoustic simulations and interactive spatial audio environments from dynamic 3D geometries.

The UVAS is closely related to the [[Extensions:Uni-Verse/Uni-Verse Sound Renderer|Uni-Verse Sound Renderer]]. UVAS does the modelling of sound propagation in the given geometry. The instructions how to render the audio environment is sent through Uni-Verse Sound Rendering Protocol (UVSRP) to the Uni-Verse Sound Renderer. The renderer is the back end for a chain of acoustic simulation modules and reproduces the sound for the listener using loudspeakers or headphones.

== Installation ==
The installation procedure is depending on the operating system, but the general requirements and building instruction are given in this section is valid on the Linux platform.

=== Supported operating systems ===
UVAS currently only works in Linux. It should be relativly easy to build UVAS on Windows using [http://www.cygwin.com/ Cygwin] as earlier versions of UVAS has been running on this platform.

=== Requirements ===

Some other software libraries are required to build the Acoustic Simulation module. On most operating systems, most of these libraries are shared or dynamic libraries which must be installed at proper locations.

The dependencies are:

;Pthread
:POSIX thread libraries are native in Unix and Linux distributions, but not in Windows. However, they can be found as [http://sourceware.org/pthreads-win32/ open source].

;Verse
:Of course, the Verse library is required to build the Acoustic Simulation module. More information can be found at the [http://verse.blender.org/ Verse main site].

;OpenGL
:This library is needed for the graphical display. It is commonly used on many operating systems and might be already installed. More information can be found at [http://www.opengl.org/ OpenGL's official site].

;GLU
:This is a third party utility library for OpenGL which is used to simplify some tasks related to graphics. More information can be found at [http://www.opengl.org/ OpenGL's official site].

;GLUT
:This is OpenGL Utility Toolkit by Mark Kilgard. More information can be found at [http://www.opengl.org/ OpenGL's official site].

;CppUnit
:CppUnit is a unit testing framework for C++. More information and the sources can be found at: the [http://cppunit.sourceforge.net/cppunit-wiki CppUnit homepage].

;TNT
:The Template Numerical Toolkit (TNT) is a collection of interfaces and reference implementations of numerical objects useful for scientific computing in C++. More information and the sources can be found at: the [http://math.nist.gov/tnt/index.html TNT homepage].

;JAMA/C++
:JAMA/C++: a translation of the Java Matrix Library, developed by the Mathworks and NIST, into C++. More information and the sources can be found at: the [http://math.nist.gov/tnt/index.html TNT homepage].

;GPC
:The University of Manchester General Polygon Clipper (GPC) library. More information and the sources can be obtained at: the [http://www.cs.man.ac.uk/~toby/alan/software/ GPC home page]. The files from the GPC distribution is included in the source distribution of UVAS.

;SGIGLU
: Incoperated example code from the SGI GLU implementation. This code is included in the UVAS release.

=== Building UVAS ===
The source can be downloaded from: [[Image:Uni-Verse-Uvas_1_0_0_src.tgz|sources]].

Unpacking the distribution file:

<source lang="bash">
$ tar xzf uvas_1_0_0_src.tgz
</source>

This will create the <code>uvas_1_0_0</code> directory.

To build UVAS change the working directory to <code>$uvas_1_0_0/src</code>. Before you start to build UVAS check the paths varables in the Makefile. To start the buld process type:

<source lang="bash">
$ make
</source>

== Running UVAS ==
To run UVAS in normal cases a verse server must be attached to the fornt-end using the ''-v'' option and to get any audible result a audio renderer must be attached to the back-end using the ''-u'' option.

=== Comand-line syntax ===
Comand-line syntax is:

$ uvas <nowiki>[options]</nowiki>

The options are:
;-a <nowiki><integer></nowiki>
:The number candidates tested for each new partition in the BSP tree.

;-B
:Sets the program to Beam-tracing mode. this is the default. Can not be use together with -P.

;-d
:Show graphics window, plots a visual interactive representation of the scene.

;-e
:Print a trace of events at the back-end in to the standard output

;-l <nowiki><integer></nowiki>
:Set the trace level. Value greater that zero cause a trace of the program execution to be printed to the standard output. The higher value the more will be traced. Warning, setting this option can generate a huge amount of data.

;-M
:Filter out all geometry without any acoustic materials attached. (Only materials with names containing “##” are considered as acoustic materials)

;-o <nowiki><integer></nowiki>
:Sets the maximum order of reflection in the simulation, default is 2.

;-p <nowiki><real></nowiki>
:Maximum length of refection paths, default is 50.

;-P
:Set program to Perceptual simulation mode, can not be used at the same time as -B.

;-q <nowiki><integer></nowiki>
:Sets the maximum number of transmissions in a reflection path, default is 4.

;-r <nowiki><real></nowiki>
:Set the approximate frame rate of the simulation, in frames per second, default is 30.

;-T <nowiki><real></nowiki>
:Set the tolerance for clustering of plans in the BSP tree, default is 0.03.

;-u <nowiki><ip address[:port]></nowiki>
:Direct the output to an audio renderer, default is to use no renderer.

;-v <nowiki><ip address[:port]></nowiki>
:Verse server to load the simulated world from.

=== Key Commands ===
The major use of key commands in UVAS is for the navigation in the visualisation window.
N.B. the key commands are in effect only when the graphics window is visible and focused, UVAS must have been started with the ''-d'' option.

The navigation is in Quake style.

==== Navigation ====
;{{Shortcut|w}}
:forward

;{{Shortcut|s}}
:backward

;{{Shortcut|a}}
:step left

;{{Shortcut|d}}
:step right

;{{shortcut|mmb}}
:steering the direction with mouse movents

;{{shortcut|lmb}}
:fast movements foreward and backwards.

;{{shortcut|rmb}}
:popup menu

==== Clipping plane ====
;{{Shortcut|c}}
:toggle clipping plane

;{{shortcut|shift|lmb}}
:moves the clipping plane with mouse (left-right)

;{{shortcut|ctrl|lmb}}
:rotate the clipping plane with mouse, left-right movement rotates around vertical axis, up-down rotates around horizontal axis.

[[Category:Script]]

← 古い版	2018年6月28日 (木) 17:51時点における版
(相違点なし)

Extensions:Uni-Verse/UVAS - 版の履歴

Yamyam: 1版 をインポートしました

wiki>Mindrones bot: Bot: Fixing redirects

Yamyam: 1版をインポートしました