2023-11-09 18:28:02 +00:00
< !DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
< html >
< meta http-equiv = "Content-Type" content = "text/html; charset=UTF-8" / >
< head >
2024-11-16 22:07:57 +11:00
< title > TombEngine 1.6 (Developer Version) Lua API< / title >
2023-11-09 18:28:02 +00:00
< link rel = "stylesheet" href = "../ldoc.css" type = "text/css" / >
< / head >
< body >
< div id = "container" >
< div id = "product" >
< div id = "product_logo" > < / div >
< div id = "product_name" > < big > < b > < / b > < / big > < / div >
< div id = "product_description" > < / div >
< / div > <!-- id="product" -->
< div id = "main" >
<!-- Menu -->
< div id = "navigation" >
< br / >
< h1 > TombEngine< / h1 >
< ul >
< li > < a href = "../index.html" > Index< / a > < / li >
< / ul >
< h2 > 1 Modules< / h2 >
< ul class = "nowrap" >
< li > < a href = "../1 modules/Effects.html" > Effects< / a > < / li >
< li > < a href = "../1 modules/Flow.html" > Flow< / a > < / li >
< li > < a href = "../1 modules/Input.html" > Input< / a > < / li >
< li > < a href = "../1 modules/Inventory.html" > Inventory< / a > < / li >
< li > < a href = "../1 modules/Logic.html" > Logic< / a > < / li >
< li > < a href = "../1 modules/Objects.html" > Objects< / a > < / li >
< li > < here > Sound< / here > < / li >
< li > < a href = "../1 modules/Strings.html" > Strings< / a > < / li >
< li > < a href = "../1 modules/Util.html" > Util< / a > < / li >
< li > < a href = "../1 modules/View.html" > View< / a > < / li >
< / ul >
< h2 > 2 Classes< / h2 >
< ul class = "nowrap" >
2023-11-11 12:16:23 +00:00
< li > < a href = "../2 classes/View.DisplaySprite.html" > View.DisplaySprite< / a > < / li >
2023-11-09 18:28:02 +00:00
< li > < a href = "../2 classes/Flow.Animations.html" > Flow.Animations< / a > < / li >
< li > < a href = "../2 classes/Flow.Fog.html" > Flow.Fog< / a > < / li >
< li > < a href = "../2 classes/Flow.InventoryItem.html" > Flow.InventoryItem< / a > < / li >
2024-04-28 06:31:59 +02:00
< li > < a href = "../2 classes/Flow.LensFlare.html" > Flow.LensFlare< / a > < / li >
2023-11-09 18:28:02 +00:00
< li > < a href = "../2 classes/Flow.Level.html" > Flow.Level< / a > < / li >
< li > < a href = "../2 classes/Flow.Mirror.html" > Flow.Mirror< / a > < / li >
< li > < a href = "../2 classes/Flow.Settings.html" > Flow.Settings< / a > < / li >
< li > < a href = "../2 classes/Flow.SkyLayer.html" > Flow.SkyLayer< / a > < / li >
2024-04-28 06:31:59 +02:00
< li > < a href = "../2 classes/Flow.Starfield.html" > Flow.Starfield< / a > < / li >
2023-11-09 18:28:02 +00:00
< li > < a href = "../2 classes/Objects.AIObject.html" > Objects.AIObject< / a > < / li >
< li > < a href = "../2 classes/Objects.Camera.html" > Objects.Camera< / a > < / li >
< li > < a href = "../2 classes/Objects.LaraObject.html" > Objects.LaraObject< / a > < / li >
< li > < a href = "../2 classes/Objects.Moveable.html" > Objects.Moveable< / a > < / li >
< li > < a href = "../2 classes/Objects.Room.html" > Objects.Room< / a > < / li >
< li > < a href = "../2 classes/Objects.Sink.html" > Objects.Sink< / a > < / li >
< li > < a href = "../2 classes/Objects.SoundSource.html" > Objects.SoundSource< / a > < / li >
< li > < a href = "../2 classes/Objects.Static.html" > Objects.Static< / a > < / li >
< li > < a href = "../2 classes/Objects.Volume.html" > Objects.Volume< / a > < / li >
< li > < a href = "../2 classes/Strings.DisplayString.html" > Strings.DisplayString< / a > < / li >
< / ul >
< h2 > 3 Primitive Classes< / h2 >
< ul class = "nowrap" >
< li > < a href = "../3 primitive classes/Color.html" > Color< / a > < / li >
< li > < a href = "../3 primitive classes/Rotation.html" > Rotation< / a > < / li >
< li > < a href = "../3 primitive classes/Vec2.html" > Vec2< / a > < / li >
< li > < a href = "../3 primitive classes/Vec3.html" > Vec3< / a > < / li >
< / ul >
< h2 > 4 Enums< / h2 >
< ul class = "nowrap" >
< li > < a href = "../4 enums/Effects.BlendID.html" > Effects.BlendID< / a > < / li >
< li > < a href = "../4 enums/Effects.EffectID.html" > Effects.EffectID< / a > < / li >
2024-11-20 23:54:39 +03:00
< li > < a href = "../4 enums/Flow.FreezeMode.html" > Flow.FreezeMode< / a > < / li >
2023-12-26 20:47:08 +00:00
< li > < a href = "../4 enums/Flow.GameStatus.html" > Flow.GameStatus< / a > < / li >
2023-11-09 18:28:02 +00:00
< li > < a href = "../4 enums/Input.ActionID.html" > Input.ActionID< / a > < / li >
< li > < a href = "../4 enums/Objects.AmmoType.html" > Objects.AmmoType< / a > < / li >
2023-12-26 20:47:08 +00:00
< li > < a href = "../4 enums/Objects.MoveableStatus.html" > Objects.MoveableStatus< / a > < / li >
2023-11-09 18:28:02 +00:00
< li > < a href = "../4 enums/Objects.ObjID.html" > Objects.ObjID< / a > < / li >
< li > < a href = "../4 enums/Objects.RoomFlagID.html" > Objects.RoomFlagID< / a > < / li >
< li > < a href = "../4 enums/Objects.RoomReverb.html" > Objects.RoomReverb< / a > < / li >
< li > < a href = "../4 enums/Sound.SoundTrackType.html" > Sound.SoundTrackType< / a > < / li >
2024-11-16 22:07:57 +11:00
< li > < a href = "../4 enums/Strings.DisplayStringOption.html" > Strings.DisplayStringOption< / a > < / li >
2023-11-09 18:28:02 +00:00
< li > < a href = "../4 enums/Util.LogLevel.html" > Util.LogLevel< / a > < / li >
2023-11-11 12:16:23 +00:00
< li > < a href = "../4 enums/View.AlignMode.html" > View.AlignMode< / a > < / li >
2023-11-09 18:28:02 +00:00
< li > < a href = "../4 enums/View.CameraType.html" > View.CameraType< / a > < / li >
2024-01-07 13:22:52 +00:00
< li > < a href = "../4 enums/View.PostProcessMode.html" > View.PostProcessMode< / a > < / li >
2023-11-11 12:16:23 +00:00
< li > < a href = "../4 enums/View.ScaleMode.html" > View.ScaleMode< / a > < / li >
2023-11-09 18:28:02 +00:00
< / ul >
< h2 > 5 Lua utility modules< / h2 >
< ul class = "nowrap" >
< li > < a href = "../5 lua utility modules/EventSequence.html" > EventSequence< / a > < / li >
< li > < a href = "../5 lua utility modules/Timer.html" > Timer< / a > < / li >
< / ul >
< / div >
< div id = "content" >
< h1 > Table < code > Sound< / code > < / h1 >
< p > Functions for sound management.< / p >
< p >
< / p >
< h2 > < a href = "#Functions" > Functions< / a > < / h2 >
< table class = "function_list" >
< tr >
< td class = "name" > < a href = "#PlayAudioTrack" > PlayAudioTrack(name, type)< / a > < / td >
< td class = "summary" > Play an audio track< / td >
< / tr >
< tr >
2024-11-16 22:07:57 +11:00
< td class = "name" > < a href = "#SetAmbientTrack" > SetAmbientTrack(name, specifies)< / a > < / td >
2023-11-09 18:28:02 +00:00
< td class = "summary" > Set and play an ambient track< / td >
< / tr >
< tr >
< td class = "name" > < a href = "#StopAudioTracks" > StopAudioTracks()< / a > < / td >
< td class = "summary" > Stop any audio tracks currently playing< / td >
< / tr >
< tr >
< td class = "name" > < a href = "#StopAudioTrack" > StopAudioTrack(type)< / a > < / td >
< td class = "summary" > Stop audio track that is currently playing< / td >
< / tr >
< tr >
< td class = "name" > < a href = "#GetAudioTrackLoudness" > GetAudioTrackLoudness(type)< / a > < / td >
< td class = "summary" > Get current loudness level for specified track type< / td >
< / tr >
< tr >
< td class = "name" > < a href = "#PlaySound" > PlaySound(sound[, position])< / a > < / td >
< td class = "summary" > Play sound effect< / td >
< / tr >
< tr >
< td class = "name" > < a href = "#StopSound" > StopSound(sound)< / a > < / td >
< td class = "summary" > Stop sound effect< / td >
< / tr >
< tr >
< td class = "name" > < a href = "#IsSoundPlaying" > IsSoundPlaying(Sound)< / a > < / td >
< td class = "summary" > Check if the sound effect is playing< / td >
< / tr >
< tr >
< td class = "name" > < a href = "#IsAudioTrackPlaying" > IsAudioTrackPlaying(Track)< / a > < / td >
< td class = "summary" > Check if the audio track is playing< / td >
< / tr >
< tr >
< td class = "name" > < a href = "#GetCurrentSubtitle" > GetCurrentSubtitle()< / a > < / td >
< td class = "summary" > Get current subtitle string for a voice track currently playing.< / td >
< / tr >
< / table >
< br / >
< br / >
< h2 class = "section-header " > < a name = "Functions" > < / a > Functions< / h2 >
< dl class = "function" >
< dt >
< a name = "PlayAudioTrack" > < / a >
< strong > PlayAudioTrack(name, type)< / strong >
< / dt >
< dd >
Play an audio track
< h3 > Parameters:< / h3 >
< ul >
< li > < span class = "parameter" > name< / span >
< span class = "types" > < a class = "type" href = "https://www.lua.org/manual/5.4/manual.html#6.4" > string< / a > < / span >
of track (without file extension) to play
< / li >
< li > < span class = "parameter" > type< / span >
< span class = "types" > < a class = "type" href = "../4 enums/Sound.SoundTrackType.html#" > SoundTrackType< / a > < / span >
of the audio track to play
< / li >
< / ul >
< / dd >
< dt >
< a name = "SetAmbientTrack" > < / a >
2024-11-16 22:07:57 +11:00
< strong > SetAmbientTrack(name, specifies)< / strong >
2023-11-09 18:28:02 +00:00
< / dt >
< dd >
Set and play an ambient track
< h3 > Parameters:< / h3 >
< ul >
< li > < span class = "parameter" > name< / span >
< span class = "types" > < a class = "type" href = "https://www.lua.org/manual/5.4/manual.html#6.4" > string< / a > < / span >
of track (without file extension) to play
< / li >
2024-11-16 22:07:57 +11:00
< li > < span class = "parameter" > specifies< / span >
< span class = "types" > < span class = "type" > bool< / span > < / span >
whether ambient track should play from the beginning, or crossfade at a random position
< / li >
2023-11-09 18:28:02 +00:00
< / ul >
< / dd >
< dt >
< a name = "StopAudioTracks" > < / a >
< strong > StopAudioTracks()< / strong >
< / dt >
< dd >
Stop any audio tracks currently playing
< / dd >
< dt >
< a name = "StopAudioTrack" > < / a >
< strong > StopAudioTrack(type)< / strong >
< / dt >
< dd >
Stop audio track that is currently playing
< h3 > Parameters:< / h3 >
< ul >
< li > < span class = "parameter" > type< / span >
< span class = "types" > < a class = "type" href = "../4 enums/Sound.SoundTrackType.html#" > SoundTrackType< / a > < / span >
of the audio track
< / li >
< / ul >
< / dd >
< dt >
< a name = "GetAudioTrackLoudness" > < / a >
< strong > GetAudioTrackLoudness(type)< / strong >
< / dt >
< dd >
Get current loudness level for specified track type
< h3 > Parameters:< / h3 >
< ul >
< li > < span class = "parameter" > type< / span >
< span class = "types" > < a class = "type" href = "../4 enums/Sound.SoundTrackType.html#" > SoundTrackType< / a > < / span >
of the audio track
< / li >
< / ul >
< h3 > Returns:< / h3 >
< ol >
< span class = "types" > < span class = "type" > float< / span > < / span >
current loudness of a specified audio track
< / ol >
< / dd >
< dt >
< a name = "PlaySound" > < / a >
< strong > PlaySound(sound[, position])< / strong >
< / dt >
< dd >
Play sound effect
< h3 > Parameters:< / h3 >
< ul >
< li > < span class = "parameter" > sound< / span >
< span class = "types" > < span class = "type" > int< / span > < / span >
ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window.
< / li >
< li > < span class = "parameter" > position< / span >
< span class = "types" > < a class = "type" href = "../3 primitive classes/Vec3.html#" > Vec3< / a > < / span >
The 3D position of the sound, i.e. where the sound "comes from". If not given, the sound will not be positional.
(< em > optional< / em > )
< / li >
< / ul >
< / dd >
< dt >
< a name = "StopSound" > < / a >
< strong > StopSound(sound)< / strong >
< / dt >
< dd >
Stop sound effect
< h3 > Parameters:< / h3 >
< ul >
< li > < span class = "parameter" > sound< / span >
< span class = "types" > < span class = "type" > int< / span > < / span >
ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window.
< / li >
< / ul >
< / dd >
< dt >
< a name = "IsSoundPlaying" > < / a >
< strong > IsSoundPlaying(Sound)< / strong >
< / dt >
< dd >
Check if the sound effect is playing
< h3 > Parameters:< / h3 >
< ul >
< li > < span class = "parameter" > Sound< / span >
< span class = "types" > < span class = "type" > int< / span > < / span >
ID to check. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window.
< / li >
< / ul >
< / dd >
< dt >
< a name = "IsAudioTrackPlaying" > < / a >
< strong > IsAudioTrackPlaying(Track)< / strong >
< / dt >
< dd >
Check if the audio track is playing
< h3 > Parameters:< / h3 >
< ul >
< li > < span class = "parameter" > Track< / span >
< span class = "types" > < a class = "type" href = "https://www.lua.org/manual/5.4/manual.html#6.4" > string< / a > < / span >
filename to check. Should be without extension and without full directory path.
< / li >
< / ul >
< / dd >
< dt >
< a name = "GetCurrentSubtitle" > < / a >
< strong > GetCurrentSubtitle()< / strong >
< / dt >
< dd >
Get current subtitle string for a voice track currently playing.
Subtitle file must be in .srt format, have same filename as voice track, and be placed in same directory as voice track.
Returns nil if no voice track is playing or no subtitle present.
< h3 > Returns:< / h3 >
< ol >
< span class = "types" > < a class = "type" href = "https://www.lua.org/manual/5.4/manual.html#6.4" > string< / a > < / span >
current subtitle string
< / ol >
< / dd >
< / dl >
< / div > <!-- id="content" -->
< / div > <!-- id="main" -->
< div id = "about" >
< i > generated by < a href = "https://github.com/hispidence/TEN-LDoc" > TEN-LDoc< / a > (a fork of < a href = "http://github.com/stevedonovan/LDoc" > LDoc 1.4.6< / a > )< / i >
< / div > <!-- id="about" -->
< / div > <!-- id="container" -->
< / body >
< / html >
