SyndicatQuebecoisdelaConstr.../SQCSim2021/external/irrKlang-1.6.0/doc/dotnet/IrrKlang.SoundEngineOptionFlag.html

110 lines
6.7 KiB
HTML
Raw Normal View History

2021-10-19 10:27:59 -04:00
<html dir="LTR">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252" />
<meta name="vs_targetSchema" content="http://schemas.microsoft.com/intellisense/ie5" />
<title>SoundEngineOptionFlag Enumeration</title>
<xml>
</xml>
<link rel="stylesheet" type="text/css" href="MSDN.css" />
</head>
<body id="bodyID" class="dtBODY">
<div id="nsbanner">
<div id="bannerrow1">
<table class="bannerparthead" cellspacing="0">
<tr id="hdr">
<td class="runninghead">IrrKlang.NET</td>
<td class="product">
</td>
</tr>
</table>
</div>
<div id="TitleRow">
<h1 class="dtH1">SoundEngineOptionFlag Enumeration</h1>
</div>
</div>
<div id="nstext">
<p> An enumeration for all options for starting up the sound engine When using createSoundEngine, use a combination of this these options parameter to start up the engine. </p>
<div class="syntax">
<span class="lang">[Visual<61>Basic]</span>
<br />Public<EFBFBD>Enum<EFBFBD>SoundEngineOptionFlag</div>
<div class="syntax">
<span class="lang">[C#]</span>
<div>public<EFBFBD>enum<EFBFBD>SoundEngineOptionFlag</div>
</div>
<h4 class="dtH4">Members</h4>
<div class="tablediv">
<table class="dtTABLE" cellspacing="0">
<tr valign="top">
<th width="50%">Member Name</th>
<th width="50%">Description</th>
</tr>
<tr valign="top"><td><b>DefaultOptions</b></td><td> Default parameters when starting up the engine. A combination of MultiThreaded | LoadPlugins | Use3DBuffers | PrintDebugInfoIntoDebugger </td></tr>
<tr valign="top"><td><b>LinearRolloff</b></td><td> If specified, instead of the default logarithmic one, irrKlang will use a linear rolloff model which influences the attenuation of the sounds over distance. The volume is interpolated linearly between the MinDistance and MaxDistance, making it possible to adjust sounds more easily although this is not physically correct. Note that this option may not work when used together with the Use3DBuffers option when using Direct3D for example, irrKlang will then turn off Use3DBuffers automaticly to be able to use this option and write out a warning. </td></tr>
<tr valign="top"><td><b>PrintDebugInfoToStdOut</b></td><td><EFBFBD></td></tr>
<tr valign="top"><td><b>PrintDebugInfoIntoDebugger</b></td><td> In addition to printing debug info to stdout, irrKlang will print debug info to any windows debugger supporting OutputDebugString() (like VisualStudio). This is pretty useful if your application does not capture any console output. </td></tr>
<tr valign="top"><td><b>Use3DBuffers</b></td><td> Uses 3D sound buffers instead of emulating them when playing 3d sounds (default). If this flag is not specified, all buffers will by created in 2D only and 3D positioning will be emulated in software, making the engine run faster if hardware 3d audio is slow on the system. </td></tr>
<tr valign="top"><td><b>LoadPlugins</b></td><td> Automaticly loads external plugins when starting up. Plugins usually are .dll files named for example ikpMP3.dll (= short for irrKlangPluginMP3) which are executed after the startup of the sound engine and modify it for example to make it possible to play back mp3 files. Plugins are being loaded from the current working directory as well as from the position where the .exe using the irrKlang library resides. </td></tr>
<tr valign="top"><td><b>MuteIfNotFocused</b></td><td> If the window of the application doesn't have the focus, irrKlang will be silent if this has been set. This will only work when irrKlang is using the DirectSound output driver. </td></tr>
<tr valign="top"><td><b>MultiThreaded</b></td><td> If specified (default), it will make irrKlang run in a separate thread, updating all streams, sounds, 3d positions and whatever automaticly. You also don't need to call ISoundEngine::update() if irrKlang is running multithreaded. However, if you want to run irrKlang in the same thread as your application (for easier debugging for example), don't set this. But you need to call ISoundEngine::update() as often as you can (at least about 2-3 times per second) to make irrKlang update everything correctly then. </td></tr></table>
</div>
<h4 class="dtH4">Requirements</h4>
<p>
<b>Namespace: </b>
<a href="IrrKlang.html">IrrKlang</a>
</p>
<p>
<b>Assembly: </b>irrKlang.NET (in irrKlang.NET.dll)
</p>
<h4 class="dtH4">See Also</h4>
<p>
<a href="IrrKlang.html">IrrKlang Namespace</a>
</p>
<object type="application/x-oleobject" classid="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e" viewastext="true" style="display: none;">
<param name="Keyword" value="SoundEngineOptionFlag enumeration">
</param>
<param name="Keyword" value="IrrKlang.SoundEngineOptionFlag enumeration">
</param>
<param name="Keyword" value="DefaultOptions enumeration member">
</param>
<param name="Keyword" value="SoundEngineOptionFlag.DefaultOptions enumeration member">
</param>
<param name="Keyword" value="LinearRolloff enumeration member">
</param>
<param name="Keyword" value="SoundEngineOptionFlag.LinearRolloff enumeration member">
</param>
<param name="Keyword" value="PrintDebugInfoToStdOut enumeration member">
</param>
<param name="Keyword" value="SoundEngineOptionFlag.PrintDebugInfoToStdOut enumeration member">
</param>
<param name="Keyword" value="PrintDebugInfoIntoDebugger enumeration member">
</param>
<param name="Keyword" value="SoundEngineOptionFlag.PrintDebugInfoIntoDebugger enumeration member">
</param>
<param name="Keyword" value="Use3DBuffers enumeration member">
</param>
<param name="Keyword" value="SoundEngineOptionFlag.Use3DBuffers enumeration member">
</param>
<param name="Keyword" value="LoadPlugins enumeration member">
</param>
<param name="Keyword" value="SoundEngineOptionFlag.LoadPlugins enumeration member">
</param>
<param name="Keyword" value="MuteIfNotFocused enumeration member">
</param>
<param name="Keyword" value="SoundEngineOptionFlag.MuteIfNotFocused enumeration member">
</param>
<param name="Keyword" value="MultiThreaded enumeration member">
</param>
<param name="Keyword" value="SoundEngineOptionFlag.MultiThreaded enumeration member">
</param>
</object>
<hr />
<div id="footer">
<p>
<a>The irrKlang Sound Engine Documentation <20> 2003-2010 by Nikolaus Gebhardt.</a>
</p>
<p>
</p>
</div>
</div>
</body>
</html>