From 7fee647c84fab993fc7ba7df7747d6238e41193b Mon Sep 17 00:00:00 2001 From: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Tue, 3 Sep 2024 09:44:53 +0100 Subject: [PATCH 001/160] Update to bug report form --- .github/ISSUE_TEMPLATE/bug_report.yaml | 22 ++++++---------------- 1 file changed, 6 insertions(+), 16 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml index 9b3f25f37..c2fc74cb2 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yaml +++ b/.github/ISSUE_TEMPLATE/bug_report.yaml @@ -1,6 +1,6 @@ name: Bug report -description: Create a report to help us improve -title: "[ bug Report ]" +description: Create a report to help the development team understand and replicate the issue you are facing. +title: "[ Bug Report ]" labels: Awaiting Triage body: @@ -16,10 +16,9 @@ body: description: | Please select the TombEngine Version from the dropdown list. options: + - v1.5 (development build) - v1.4 - v1.3 - - v1.2 - - v1.1 validations: required: true @@ -29,6 +28,7 @@ body: description: | Please select the Tomb Editor version used from the dropdown list. options: + - v1.7.2 (development build) - v1.7.1 - v1.7.0 - v1.6.9 @@ -58,16 +58,6 @@ body: validations: required: true -- type: textarea - attributes: - label: Expected Behaviour - description: | - A clear and concise description of what you expected to happen. - placeholder: | - A description of what should happen here. - validations: - required: true - - type: textarea attributes: label: Screenshots @@ -80,14 +70,14 @@ body: validations: required: true -- type: textarea +- type: checkboxes attributes: label: Additional Content description: | Add any other context about the problem here. * Are you testing an build of a TombEngine that has not yet been released? If so please give some context. - * Did you get any asset from the TombEngine website that has presented a bug? + * Did you get any asset from the TombEngine website that has presented a bug? placeholder: | A description of any additional content here. validations: From eca79130a0acef2c4371054ef0ef40367a1c905a Mon Sep 17 00:00:00 2001 From: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Tue, 3 Sep 2024 09:45:21 +0100 Subject: [PATCH 002/160] Update bug_report.yaml --- .github/ISSUE_TEMPLATE/bug_report.yaml | 21 ++++++++------------- 1 file changed, 8 insertions(+), 13 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml index c2fc74cb2..3f31d49cc 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yaml +++ b/.github/ISSUE_TEMPLATE/bug_report.yaml @@ -1,6 +1,6 @@ name: Bug report -description: Create a report to help the development team understand and replicate the issue you are facing. -title: "[ Bug Report ]" +description: Create a report to help us understand and diagnose your issue. Your contribution is welcomed and valued! +title: "[ bug Report ]" labels: Awaiting Triage body: @@ -18,7 +18,6 @@ body: options: - v1.5 (development build) - v1.4 - - v1.3 validations: required: true @@ -28,11 +27,9 @@ body: description: | Please select the Tomb Editor version used from the dropdown list. options: - - v1.7.2 (development build) + - v1.7.2 (development version) - v1.7.1 - v1.7.0 - - v1.6.9 - - v1.6.8 validations: required: true @@ -60,24 +57,22 @@ body: - type: textarea attributes: - label: Screenshots + label: Expected Behaviour description: | - Please check this box if you have provided screenshots or any other media for this issue - **note** If you do not provide screenshots or anything else, it may be hard for devs to investigate - provide a link to your screenshot here or simply drag and drop your screenshot into this textbox + A clear and concise description of what you expected to happen. placeholder: | - A description of any additional content here. + A description of what should happen here. validations: required: true -- type: checkboxes +- type: textarea attributes: label: Additional Content description: | Add any other context about the problem here. * Are you testing an build of a TombEngine that has not yet been released? If so please give some context. - * Did you get any asset from the TombEngine website that has presented a bug? + * Did you get any asset from the TombEngine website that has presented a bug? placeholder: | A description of any additional content here. validations: From 30e053dc935646a3c8d900b2adbd90b107995048 Mon Sep 17 00:00:00 2001 From: Nemoel-Tomo Date: Wed, 30 Oct 2024 18:00:21 +0100 Subject: [PATCH 003/160] Update AUTHORS.md - Tomo (general coding, special FX coding, bug fixing) --- AUTHORS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/AUTHORS.md b/AUTHORS.md index d7122440f..096d4944c 100644 --- a/AUTHORS.md +++ b/AUTHORS.md @@ -18,7 +18,7 @@ This is the credit list of **all** the people who contributed to TombEngine in a - Squidshire (Hispidence) (Lua implementation, bug fixing) - Stranger1992 (sound asset refactoring and organisation, assets) - TokyoSU (entity and vehicle decompilation) -- Tomo (general coding, bug fixing) +- Tomo (general coding, special FX coding, bug fixing) - Troye (general coding, refactoring) - Nickelony (general coding) - JesseG, aka WolfCheese (general coding) From fae8744e4bc950f962a4824e8a6e1ff485a08be7 Mon Sep 17 00:00:00 2001 From: Jakub <80340234+Jakub768@users.noreply.github.com> Date: Sun, 3 Nov 2024 14:16:05 +0000 Subject: [PATCH 004/160] Update CHANGELOG.md --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index ee74d0abb..bffb81bb0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,7 +3,7 @@ The dates are in European standard format where date is presented as **YYYY-MM-DD**. TombEngine releases are located in this repository (alongside with Tomb Editor): https://github.com/TombEngine/TombEditorReleases -## Version 1.5 - xxxx-xx-xx +## Version 1.5 - 2024-11-03 ### Bug fixes From 1affcce9b95727ab110e77e55538835465442cba Mon Sep 17 00:00:00 2001 From: Jakub <80340234+Jakub768@users.noreply.github.com> Date: Sun, 3 Nov 2024 14:18:34 +0000 Subject: [PATCH 005/160] Update CHANGELOG.md --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index bffb81bb0..499dcefc4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,7 +3,7 @@ The dates are in European standard format where date is presented as **YYYY-MM-DD**. TombEngine releases are located in this repository (alongside with Tomb Editor): https://github.com/TombEngine/TombEditorReleases -## Version 1.5 - 2024-11-03 +## [Version 1.5](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.7.2) - 2024-11-03 ### Bug fixes From d256fe1efe9474bac52620d21d26c15a53c23efc Mon Sep 17 00:00:00 2001 From: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Sun, 3 Nov 2024 22:19:11 +0000 Subject: [PATCH 006/160] Update bug_report.yaml --- .github/ISSUE_TEMPLATE/bug_report.yaml | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml index 3f31d49cc..30aa5c96d 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yaml +++ b/.github/ISSUE_TEMPLATE/bug_report.yaml @@ -16,7 +16,8 @@ body: description: | Please select the TombEngine Version from the dropdown list. options: - - v1.5 (development build) + - Development Build + - v1.5.0.2 (Latest Release) - v1.4 validations: required: true @@ -27,7 +28,8 @@ body: description: | Please select the Tomb Editor version used from the dropdown list. options: - - v1.7.2 (development version) + - Development Build + - v1.7.2 - v1.7.1 - v1.7.0 validations: From b27ba26b6b48cdec79a2340b9f189c3c7e78c312 Mon Sep 17 00:00:00 2001 From: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Fri, 27 Dec 2024 21:22:13 +0000 Subject: [PATCH 007/160] Update bug_report.yaml --- .github/ISSUE_TEMPLATE/bug_report.yaml | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml index 30aa5c96d..f0e368c77 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yaml +++ b/.github/ISSUE_TEMPLATE/bug_report.yaml @@ -17,8 +17,8 @@ body: Please select the TombEngine Version from the dropdown list. options: - Development Build - - v1.5.0.2 (Latest Release) - - v1.4 + - v1.7 (Latest release) + - v1.6 validations: required: true @@ -29,6 +29,7 @@ body: Please select the Tomb Editor version used from the dropdown list. options: - Development Build + - v1.7.3 (Latest release) - v1.7.2 - v1.7.1 - v1.7.0 @@ -74,7 +75,7 @@ body: Add any other context about the problem here. * Are you testing an build of a TombEngine that has not yet been released? If so please give some context. - * Did you get any asset from the TombEngine website that has presented a bug? + * Did you get any asset from the TombEngine website that has presented a bug? placeholder: | A description of any additional content here. validations: From f61c9cf4fff4ffcb6e5317998b5b2caf6ecf1796 Mon Sep 17 00:00:00 2001 From: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Sat, 4 Jan 2025 18:32:12 +0000 Subject: [PATCH 008/160] Release cleanup --- .github/ISSUE_TEMPLATE/bug_report.yaml | 6 ++++-- CHANGELOG.md | 2 +- TombEngine/version.h | 2 +- 3 files changed, 6 insertions(+), 4 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml index f0e368c77..540bfcbd3 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yaml +++ b/.github/ISSUE_TEMPLATE/bug_report.yaml @@ -17,7 +17,8 @@ body: Please select the TombEngine Version from the dropdown list. options: - Development Build - - v1.7 (Latest release) + - v1.7.1 (Latest release) + - v1.7 - v1.6 validations: required: true @@ -29,7 +30,8 @@ body: Please select the Tomb Editor version used from the dropdown list. options: - Development Build - - v1.7.3 (Latest release) + - v1.7.4 (Latest release) + - v1.7.3 - v1.7.2 - v1.7.1 - v1.7.0 diff --git a/CHANGELOG.md b/CHANGELOG.md index 1c3ab55f8..b81eedcc2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,7 +3,7 @@ The dates are in European standard format where date is presented as **YYYY-MM-DD**. TombEngine releases are located in this repository (alongside with Tomb Editor): https://github.com/TombEngine/TombEditorReleases -## Version 1.7.1 - xxxx-xx-xx +## [Version 1.7.1] (https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.7.4) - 2025-04-01 ### Bug fixes * Fixed static meshes with dynamic light mode not accepting room lights. diff --git a/TombEngine/version.h b/TombEngine/version.h index 81b6bde52..bc0f103cf 100644 --- a/TombEngine/version.h +++ b/TombEngine/version.h @@ -10,7 +10,7 @@ #define TEN_BUILD_NUMBER 1 #define TEN_REVISION_NUMBER 0 -#define TEST_BUILD 1 +#define TEST_BUILD 0 #define TOSTR(x) #x #define MAKE_VERSION_STRING(major, minor, build, revision) TOSTR(major) "." TOSTR(minor) "." TOSTR(build) "." TOSTR(revision) From 75144d877e037b107dde78e1e339dcf38eb2adad Mon Sep 17 00:00:00 2001 From: Jakub <80340234+Jakub768@users.noreply.github.com> Date: Sat, 1 Feb 2025 12:06:42 +0000 Subject: [PATCH 009/160] Update LICENSE --- LICENSE | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/LICENSE b/LICENSE index a49810cf6..350616db7 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ MIT License -Copyright (c) 2024 TombEngine Team +Copyright (c) 2025 TombEngine Team Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal From 7381ff0843f2e34cb3408fd20e4f28ace1ae0586 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 8 Mar 2025 02:51:19 +0100 Subject: [PATCH 010/160] Update CHANGELOG.md --- CHANGELOG.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 663db9c1e..22f615177 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,7 +13,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed incorrect handling of dynamic light shadows. * Fixed ricochet flashes after using explosive weapons. * Fixed incorrect flare draw in crawl state. -* Fixed starfield remaining active in the next level if next level does not have a starfield specified. +* Fixed starfield remaining active in the next level if it does not have a starfield specified. * Fixed wetness player attribute not being preserved in savegames. * Fixed invisible HK ammo in the inventory. * Fixed flickering rat emitter. @@ -29,7 +29,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): - You must use this version: https://github.com/TombEngine/Resources/raw/refs/heads/main/Wad2%20Objects/Interactables/TEN_Waterfall_Emitter.wad2 ### Lua API changes -* Added Collision.Probe class for basic collision detection. +* Added Collision.Probe class for basic room collision detection. * Added diary module. * Added View.GetFlyByPosition() and View.GetFlyByRotation() functions to get flyby sequence parameters at a specified time point. * Added Effects.EmitAirBubble() function to spawn air bubbles. From 7701fb5fd00880a5625e330c3725a39ea20524eb Mon Sep 17 00:00:00 2001 From: davidmarr <116632612+davidmarr@users.noreply.github.com> Date: Sat, 8 Mar 2025 10:57:10 +0100 Subject: [PATCH 011/160] Update CSS of Lua documentation (#1576) * Update VolumeObject.cpp fixed Volume:GetActive() method * Update CHANGELOG.md * function description LevelFuncs.OnUseItem * Revert "function description LevelFuncs.OnUseItem" This reverts commit 2478afca68f1e0ce11c610f07da6c6588cc4f35f. * Update ldoc.css --- Documentation/ldoc.css | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/Documentation/ldoc.css b/Documentation/ldoc.css index 306dcd9f5..109cd5720 100644 --- a/Documentation/ldoc.css +++ b/Documentation/ldoc.css @@ -32,7 +32,9 @@ span.types:after { content:")"; } body, td, th { font-size: .95em; line-height: 1.2em;} p { line-height: 1.2em;} -p, ul { margin: 10px 0 0 0px;} +ul { margin: 10px 0 0 0px;} + +p { margin: 3px 0px 0px 0px; } strong { font-weight: bold;} @@ -63,6 +65,10 @@ blockquote { margin-left: 3em; } ul { list-style-type: disc; } +ul li:not(:last-child) { + margin-bottom: 0.3em; +} + p.name { font-family: "Andale Mono", monospace; padding-top: 1em; @@ -103,11 +109,11 @@ table.index td { text-align: left; vertical-align: top; } #main { background-color: #f0f0f0; border-left: 2px solid #cccccc; + display: flex } #navigation { - float: left; - width: 16em; + width: 18em; vertical-align: top; background-color: #f0f0f0; overflow: visible; @@ -141,7 +147,6 @@ table.index td { text-align: left; vertical-align: top; } } #content { - margin-left: 18em; padding: 2em; width: 900px; border-left: 2px solid #cccccc; From a9482054cd98f3eece557a15e0aa9d2ab447d0e6 Mon Sep 17 00:00:00 2001 From: Sezz Date: Sat, 8 Mar 2025 22:32:02 +1100 Subject: [PATCH 012/160] Input binding manager (#1566) * First clean iteration of BindingManager class * Fix key alignment errors; allow keys to have analog values * Allow any input action to have an analog value * Update comment * Update key names * Update queue state * Update names * Add comments * Fix merge * Fix mouse input * Update constant name * Fix merge errors * Update formatting * Fix merge errors; count game frames in input action class properly * float -> unsigned long, renames * Formatting * Constants for key offsets * New registry version * Minor changes * Fix saving * Update InputAction.cpp * Renames * Minor changes * Temporary rename + comments * Update InputAction.cpp --------- Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com> --- TombEngine/Game/Lara/lara_helpers.cpp | 10 +- TombEngine/Game/camera.cpp | 2 +- TombEngine/Game/gui.cpp | 29 +- TombEngine/Game/gui.h | 4 +- TombEngine/Game/savegame.cpp | 8 +- TombEngine/Objects/Utils/VehicleHelpers.cpp | 6 +- TombEngine/Renderer/RendererDrawMenu.cpp | 37 +- .../Renderer/Structures/RendererSprite2D.h | 46 +-- .../Scripting/Internal/TEN/Input/ActionIDs.h | 2 +- .../Internal/TEN/Input/InputHandler.cpp | 14 +- TombEngine/Shaders/FullscreenQuad.fx | 62 +-- TombEngine/Specific/Input/Bindings.cpp | 199 +++++++++ TombEngine/Specific/Input/Bindings.h | 63 +++ TombEngine/Specific/Input/Input.cpp | 385 ++++++++---------- TombEngine/Specific/Input/Input.h | 84 +--- TombEngine/Specific/Input/InputAction.cpp | 85 ++-- TombEngine/Specific/Input/InputAction.h | 33 +- TombEngine/Specific/Input/Keys.cpp | 181 ++++++++ TombEngine/Specific/Input/Keys.h | 126 ++++++ TombEngine/Specific/configuration.cpp | 30 +- TombEngine/Specific/configuration.h | 5 +- TombEngine/TombEngine.vcxproj | 4 + 22 files changed, 947 insertions(+), 468 deletions(-) create mode 100644 TombEngine/Specific/Input/Bindings.cpp create mode 100644 TombEngine/Specific/Input/Bindings.h create mode 100644 TombEngine/Specific/Input/Keys.cpp create mode 100644 TombEngine/Specific/Input/Keys.h diff --git a/TombEngine/Game/Lara/lara_helpers.cpp b/TombEngine/Game/Lara/lara_helpers.cpp index f3be03a8e..e9a9d475a 100644 --- a/TombEngine/Game/Lara/lara_helpers.cpp +++ b/TombEngine/Game/Lara/lara_helpers.cpp @@ -476,14 +476,14 @@ void HandlePlayerLookAround(ItemInfo& item, bool invertXAxis) if ((IsHeld(In::Forward) || IsHeld(In::Back)) && (player.Control.Look.Mode == LookMode::Free || player.Control.Look.Mode == LookMode::Vertical)) { - axisCoeff.x = AxisMap[(int)InputAxis::Move].y; + axisCoeff.x = AxisMap[InputAxisID::Move].y; } // Determine Y axis coefficient. if ((IsHeld(In::Left) || IsHeld(In::Right)) && (player.Control.Look.Mode == LookMode::Free || player.Control.Look.Mode == LookMode::Horizontal)) { - axisCoeff.y = AxisMap[(int)InputAxis::Move].x; + axisCoeff.y = AxisMap[InputAxisID::Move].x; } // Determine turn rate base values. @@ -583,7 +583,7 @@ void HandlePlayerLean(ItemInfo* item, CollisionInfo* coll, short baseRate, short if (!item->Animation.Velocity.z) return; - float axisCoeff = AxisMap[(int)InputAxis::Move].x; + float axisCoeff = AxisMap[InputAxisID::Move].x; int sign = copysign(1, axisCoeff); short maxAngleNormalized = maxAngle * axisCoeff; @@ -604,7 +604,7 @@ void HandlePlayerCrawlFlex(ItemInfo& item) if (item.Animation.Velocity.z == 0.0f) return; - float axisCoeff = AxisMap[(int)InputAxis::Move].x; + float axisCoeff = AxisMap[InputAxisID::Move].x; int sign = copysign(1, axisCoeff); short maxAngleNormalized = FLEX_ANGLE_MAX * axisCoeff; @@ -1230,7 +1230,7 @@ void ModulateLaraTurnRateY(ItemInfo* item, short accelRate, short minTurnRate, s { auto* lara = GetLaraInfo(item); - float axisCoeff = AxisMap[(int)InputAxis::Move].x; + float axisCoeff = AxisMap[InputAxisID::Move].x; if (item->Animation.IsAirborne) { int sign = std::copysign(1, axisCoeff); diff --git a/TombEngine/Game/camera.cpp b/TombEngine/Game/camera.cpp index 3fe1ef9f7..fa5f62f02 100644 --- a/TombEngine/Game/camera.cpp +++ b/TombEngine/Game/camera.cpp @@ -93,7 +93,7 @@ void DoThumbstickCamera() if (Camera.laraNode == -1 && Camera.target.ToVector3i() == OldCam.target) { - const auto& axisCoeff = AxisMap[(int)InputAxis::Camera]; + const auto& axisCoeff = AxisMap[InputAxisID::Camera]; if (abs(axisCoeff.x) > EPSILON && abs(Camera.targetAngle) == 0) Camera.targetAngle = ANGLE(VERTICAL_CONSTRAINT_ANGLE * axisCoeff.x); diff --git a/TombEngine/Game/gui.cpp b/TombEngine/Game/gui.cpp index 66ac2e759..4bcd58a6b 100644 --- a/TombEngine/Game/gui.cpp +++ b/TombEngine/Game/gui.cpp @@ -23,7 +23,6 @@ #include "Scripting/Include/ScriptInterfaceLevel.h" #include "Sound/sound.h" #include "Specific/Input/Input.h" -#include "Specific/Input/InputAction.h" #include "Specific/clock.h" #include "Specific/configuration.h" #include "Specific/level.h" @@ -124,7 +123,7 @@ namespace TEN::Gui STRING_ACTIONS_LOAD }; - bool GuiController::GuiIsPulsed(ActionID actionID) const + bool GuiController::GuiIsPulsed(InputActionID actionID) const { constexpr auto DELAY = 0.1f; constexpr auto INITIAL_DELAY = 0.4f; @@ -134,7 +133,7 @@ namespace TEN::Gui return false; // Pulse only directional inputs. - auto oppositeAction = std::optional(std::nullopt); + auto oppositeAction = std::optional(std::nullopt); switch (actionID) { case In::Forward: @@ -239,7 +238,7 @@ namespace TEN::Gui { if (mode != InvMode) { - TimeInMenu = 0.0f; + TimeInMenu = 0; InvMode = mode; } } @@ -723,17 +722,17 @@ namespace TEN::Gui } else { - int selectedKey = 0; - for (selectedKey = 0; selectedKey < MAX_INPUT_SLOTS; selectedKey++) + int selectedKeyID = 0; + for (selectedKeyID = 0; selectedKeyID < KEY_COUNT; selectedKeyID++) { - if (KeyMap[selectedKey]) + if (KeyMap[selectedKeyID]) break; } - if (selectedKey == MAX_INPUT_SLOTS) - selectedKey = 0; + if (selectedKeyID == KEY_COUNT) + selectedKeyID = 0; - if (selectedKey && !g_KeyNames[selectedKey].empty()) + if (selectedKeyID && !GetKeyName(selectedKeyID).empty()) { unsigned int baseIndex = 0; switch (MenuToDisplay) @@ -754,7 +753,7 @@ namespace TEN::Gui break; } - Bindings[1][baseIndex + SelectedOption] = selectedKey; + g_Bindings.SetKeyBinding(InputDeviceID::Custom, InputActionID(baseIndex + SelectedOption), selectedKeyID); DefaultConflict(); CurrentSettings.NewKeyWaitTimer = 0.0f; @@ -855,8 +854,8 @@ namespace TEN::Gui if (SelectedOption == (OptionCount - 1)) { SoundEffect(SFX_TR4_MENU_SELECT, nullptr, SoundEnvironment::Always); - CurrentSettings.Configuration.Bindings = Bindings[1]; - g_Configuration.Bindings = Bindings[1]; + CurrentSettings.Configuration.Bindings = g_Bindings.GetBindingProfile(InputDeviceID::Custom); + g_Configuration.Bindings = g_Bindings.GetBindingProfile(InputDeviceID::Custom); SaveConfiguration(); MenuToDisplay = fromPauseMenu ? Menu::Pause : Menu::Options; SelectedOption = 2; @@ -867,7 +866,7 @@ namespace TEN::Gui if (SelectedOption == OptionCount) { SoundEffect(SFX_TR4_MENU_SELECT, nullptr, SoundEnvironment::Always); - Bindings[1] = CurrentSettings.Configuration.Bindings; + g_Bindings.SetBindingProfile(InputDeviceID::Custom, CurrentSettings.Configuration.Bindings); MenuToDisplay = fromPauseMenu ? Menu::Pause : Menu::Options; SelectedOption = 2; return; @@ -2190,7 +2189,7 @@ namespace TEN::Gui { // HACK. ClearAllActions(); - ActionMap[(int)In::Flare].Update(1.0f); + ActionMap[In::Flare].Update(1.0f); HandleWeapon(item); ClearAllActions(); diff --git a/TombEngine/Game/gui.h b/TombEngine/Game/gui.h index 70b5754d0..bca6f8b3a 100644 --- a/TombEngine/Game/gui.h +++ b/TombEngine/Game/gui.h @@ -120,7 +120,7 @@ namespace TEN::Gui { private: // Input inquirers - bool GuiIsPulsed(ActionID actionID) const; + bool GuiIsPulsed(InputActionID actionID) const; bool GuiIsSelected(bool onClicked = true) const; bool GuiIsDeselected() const; bool CanSelect() const; @@ -132,7 +132,7 @@ namespace TEN::Gui int OptionCount; int SelectedSaveSlot; - float TimeInMenu = -1.0f; + int TimeInMenu = NO_VALUE; SettingsData CurrentSettings; // Inventory variables diff --git a/TombEngine/Game/savegame.cpp b/TombEngine/Game/savegame.cpp index 6725159cd..86b8fd77e 100644 --- a/TombEngine/Game/savegame.cpp +++ b/TombEngine/Game/savegame.cpp @@ -970,8 +970,8 @@ const std::vector SaveGame::Build() // Action queue std::vector actionQueue; - for (int i = 0; i < ActionQueue.size(); i++) - actionQueue.push_back((int)ActionQueue[i]); + for (int i = 0; i < ActionQueueMap.size(); i++) + actionQueue.push_back((int)ActionQueueMap[(InputActionID)i]); auto actionQueueOffset = fbb.CreateVector(actionQueue); // Flipmaps @@ -2373,8 +2373,8 @@ static void ParseLevel(const Save::SaveGame* s, bool hubMode) // Restore action queue. for (int i = 0; i < s->action_queue()->size(); i++) { - TENAssert(i < ActionQueue.size(), "Action queue size was changed"); - ActionQueue[i] = (QueueState)s->action_queue()->Get(i); + TENAssert(i < ActionQueueMap.size(), "Action queue size was changed."); + ActionQueueMap[(InputActionID)i] = (ActionQueueState)s->action_queue()->Get(i); } // Legacy soundtrack map. diff --git a/TombEngine/Objects/Utils/VehicleHelpers.cpp b/TombEngine/Objects/Utils/VehicleHelpers.cpp index 85ae29007..88bc07abc 100644 --- a/TombEngine/Objects/Utils/VehicleHelpers.cpp +++ b/TombEngine/Objects/Utils/VehicleHelpers.cpp @@ -300,17 +300,17 @@ namespace TEN::Entities::Vehicles void ModulateVehicleTurnRateX(short* turnRate, short accelRate, short minTurnRate, short maxTurnRate) { - *turnRate = ModulateVehicleTurnRate(*turnRate, accelRate, minTurnRate, maxTurnRate, -AxisMap[(int)InputAxis::Move].y); + *turnRate = ModulateVehicleTurnRate(*turnRate, accelRate, minTurnRate, maxTurnRate, -AxisMap[InputAxisID::Move].y); } void ModulateVehicleTurnRateY(short* turnRate, short accelRate, short minTurnRate, short maxTurnRate) { - *turnRate = ModulateVehicleTurnRate(*turnRate, accelRate, minTurnRate, maxTurnRate, AxisMap[(int)InputAxis::Move].x); + *turnRate = ModulateVehicleTurnRate(*turnRate, accelRate, minTurnRate, maxTurnRate, AxisMap[InputAxisID::Move].x); } void ModulateVehicleLean(ItemInfo* vehicleItem, short baseRate, short maxAngle) { - float axisCoeff = AxisMap[(int)InputAxis::Move].x; + float axisCoeff = AxisMap[InputAxisID::Move].x; int sign = copysign(1, axisCoeff); short maxAngleNormalized = maxAngle * axisCoeff; vehicleItem->Pose.Orientation.z += std::min(baseRate, abs(maxAngleNormalized - vehicleItem->Pose.Orientation.z) / 3) * sign; diff --git a/TombEngine/Renderer/RendererDrawMenu.cpp b/TombEngine/Renderer/RendererDrawMenu.cpp index 14c265a76..87de33b5c 100644 --- a/TombEngine/Renderer/RendererDrawMenu.cpp +++ b/TombEngine/Renderer/RendererDrawMenu.cpp @@ -12,6 +12,7 @@ #include "Math/Math.h" #include "Scripting/Internal/TEN/Flow//Level/FlowLevel.h" #include "Specific/configuration.h" +#include "Specific/Input/InputAction.h" #include "Specific/level.h" #include "Specific/trutils.h" #include "Specific/winmain.h" @@ -315,8 +316,11 @@ namespace TEN::Renderer } else { - int index = Bindings[1][k] ? Bindings[1][k] : Bindings[0][k]; - AddString(MenuRightSideEntry, y, g_KeyNames[index].c_str(), PRINTSTRING_COLOR_ORANGE, SF(false)); + int defaultKeyID = g_Bindings.GetBoundKeyID(InputDeviceID::Default, (InputActionID)k); + int userKeyID = g_Bindings.GetBoundKeyID(InputDeviceID::Custom, (InputActionID)k); + + int key = userKeyID ? userKeyID : defaultKeyID; + AddString(MenuRightSideEntry, y, GetKeyName(key).c_str(), PRINTSTRING_COLOR_ORANGE, SF(false)); } if (k < (GeneralActionStrings.size() - 1)) @@ -365,8 +369,11 @@ namespace TEN::Renderer } else { - int index = Bindings[1][baseIndex + k] ? Bindings[1][baseIndex + k] : Bindings[0][baseIndex + k]; - AddString(MenuRightSideEntry, y, g_KeyNames[index].c_str(), PRINTSTRING_COLOR_ORANGE, SF(false)); + int defaultKeyID = g_Bindings.GetBoundKeyID(InputDeviceID::Default, (InputActionID)(baseIndex + k)); + int userKeyID = g_Bindings.GetBoundKeyID(InputDeviceID::Custom, (InputActionID)(baseIndex + k)); + + int key = userKeyID ? userKeyID : defaultKeyID; + AddString(MenuRightSideEntry, y, GetKeyName(key).c_str(), PRINTSTRING_COLOR_ORANGE, SF(false)); } if (k < (VehicleActionStrings.size() - 1)) @@ -421,8 +428,11 @@ namespace TEN::Renderer } else { - int index = Bindings[1][baseIndex + k] ? Bindings[1][baseIndex + k] : Bindings[0][baseIndex + k]; - AddString(MenuRightSideEntry, y, g_KeyNames[index].c_str(), PRINTSTRING_COLOR_ORANGE, SF(false)); + int defaultKeyID = g_Bindings.GetBoundKeyID(InputDeviceID::Default, (InputActionID)(baseIndex + k)); + int userKeyID = g_Bindings.GetBoundKeyID(InputDeviceID::Custom, (InputActionID)(baseIndex + k)); + + int key = userKeyID ? userKeyID : defaultKeyID; + AddString(MenuRightSideEntry, y, GetKeyName(key).c_str(), PRINTSTRING_COLOR_ORANGE, SF(false)); } if (k < (QuickActionStrings.size() - 1)) @@ -470,8 +480,11 @@ namespace TEN::Renderer } else { - int index = Bindings[1][baseIndex + k] ? Bindings[1][baseIndex + k] : Bindings[0][baseIndex + k]; - AddString(MenuRightSideEntry, y, g_KeyNames[index].c_str(), PRINTSTRING_COLOR_ORANGE, SF(false)); + int defaultKeyID = g_Bindings.GetBoundKeyID(InputDeviceID::Default, (InputActionID)(baseIndex + k)); + int userKeyID = g_Bindings.GetBoundKeyID(InputDeviceID::Custom, (InputActionID)(baseIndex + k)); + + int key = userKeyID ? userKeyID : defaultKeyID; + AddString(MenuRightSideEntry, y, GetKeyName(key).c_str(), PRINTSTRING_COLOR_ORANGE, SF(false)); } if (k < (MenuActionStrings.size() - 1)) @@ -1347,7 +1360,7 @@ namespace TEN::Renderer auto heldActions = BitField((int)In::Count); auto releasedActions = BitField((int)In::Count); - for (const auto& action : ActionMap) + for (const auto& [actionID, action] : ActionMap) { if (action.IsClicked()) clickedActions.Set((int)action.GetID()); @@ -1363,9 +1376,9 @@ namespace TEN::Renderer PrintDebugMessage(("Clicked actions: " + clickedActions.ToString()).c_str()); PrintDebugMessage(("Held actions: " + heldActions.ToString()).c_str()); PrintDebugMessage(("Released actions: " + releasedActions.ToString()).c_str()); - PrintDebugMessage("Move axes: %.3f, %.3f", AxisMap[(int)InputAxis::Move].x, AxisMap[(int)InputAxis::Move].y); - PrintDebugMessage("Camera axes: %.3f, %.3f", AxisMap[(int)InputAxis::Camera].x, AxisMap[(int)InputAxis::Camera].y); - PrintDebugMessage("Mouse axes: %.3f, %.3f", AxisMap[(int)InputAxis::Mouse].x, AxisMap[(int)InputAxis::Mouse].y); + PrintDebugMessage("Move axes: %.3f, %.3f", AxisMap[InputAxisID::Move].x, AxisMap[InputAxisID::Move].y); + PrintDebugMessage("Camera axes: %.3f, %.3f", AxisMap[InputAxisID::Camera].x, AxisMap[InputAxisID::Camera].y); + PrintDebugMessage("Mouse axes: %.3f, %.3f", AxisMap[InputAxisID::Mouse].x, AxisMap[InputAxisID::Mouse].y); PrintDebugMessage("Cursor pos: %.3f, %.3f", GetMouse2DPosition().x, GetMouse2DPosition().y); } break; diff --git a/TombEngine/Renderer/Structures/RendererSprite2D.h b/TombEngine/Renderer/Structures/RendererSprite2D.h index 2e0dda9ed..50c4ecb01 100644 --- a/TombEngine/Renderer/Structures/RendererSprite2D.h +++ b/TombEngine/Renderer/Structures/RendererSprite2D.h @@ -1,24 +1,22 @@ -#pragma once -#include -#include "Renderer/Structures/RendererSprite.h" -#include "Renderer/RendererEnums.h" - -namespace TEN::Renderer::Structures -{ - using namespace DirectX::SimpleMath; - - struct RendererDisplaySpriteToDraw - { - const RendererSprite* SpritePtr = nullptr; - - Vector2 Position = Vector2::Zero; - short Orientation = 0; - Vector2 Size = Vector2::Zero; - Vector4 Color = Vector4::Zero; - - int Priority = 0; - BlendMode BlendMode = BlendMode::AlphaBlend; - - Vector2 AspectCorrection = Vector2::One; - }; -} +#pragma once + +#include "Renderer/Structures/RendererSprite.h" +#include "Renderer/RendererEnums.h" + +namespace TEN::Renderer::Structures +{ + struct RendererDisplaySpriteToDraw + { + const RendererSprite* SpritePtr = nullptr; + + Vector2 Position = Vector2::Zero; + short Orientation = 0; + Vector2 Size = Vector2::Zero; + Vector4 Color = Vector4::Zero; + + int Priority = 0; + BlendMode BlendMode = BlendMode::AlphaBlend; + + Vector2 AspectCorrection = Vector2::One; + }; +} diff --git a/TombEngine/Scripting/Internal/TEN/Input/ActionIDs.h b/TombEngine/Scripting/Internal/TEN/Input/ActionIDs.h index 93b5a5614..788d0a0e2 100644 --- a/TombEngine/Scripting/Internal/TEN/Input/ActionIDs.h +++ b/TombEngine/Scripting/Internal/TEN/Input/ActionIDs.h @@ -63,7 +63,7 @@ To be used with @{Input.KeyIsHit}, @{Input.KeyIsHeld}, and similar functions. @table Input.ActionID */ -static const std::unordered_map ACTION_IDS +static const std::unordered_map ACTION_IDS { { "FORWARD", In::Forward }, { "BACK", In::Back }, diff --git a/TombEngine/Scripting/Internal/TEN/Input/InputHandler.cpp b/TombEngine/Scripting/Internal/TEN/Input/InputHandler.cpp index 5db8c91f2..2352d3c35 100644 --- a/TombEngine/Scripting/Internal/TEN/Input/InputHandler.cpp +++ b/TombEngine/Scripting/Internal/TEN/Input/InputHandler.cpp @@ -28,7 +28,7 @@ namespace TEN::Scripting::Input static bool CheckInput(int actionID) { - if (actionID > (int)ActionID::Count) + if (actionID > (int)InputActionID::Count) { ScriptAssertF(false, "Input action {} does not exist.", actionID); return false; @@ -45,7 +45,7 @@ namespace TEN::Scripting::Input if (!CheckInput(actionID)) return false; - if (IsHeld((ActionID)actionID)) + if (IsHeld((InputActionID)actionID)) return true; return false; @@ -59,7 +59,7 @@ namespace TEN::Scripting::Input if (!CheckInput(actionID)) return false; - if (IsClicked((ActionID)actionID)) + if (IsClicked((InputActionID)actionID)) return true; return false; @@ -73,7 +73,7 @@ namespace TEN::Scripting::Input if (!CheckInput(actionID)) return; - ActionQueue[actionID] = QueueState::Push; + ActionQueueMap[(InputActionID)actionID] = ActionQueueState::Update; } /// Clear an action key. @@ -84,15 +84,15 @@ namespace TEN::Scripting::Input if (!CheckInput(actionID)) return; - ActionQueue[actionID] = QueueState::Clear; + ActionQueueMap[(InputActionID)actionID] = ActionQueueState::Clear; } /// Clear all action keys. // @function KeyClearAll static void KeyClearAll() { - for (auto& queue : ActionQueue) - queue = QueueState::Clear; + for (auto& [actionID, queue] : ActionQueueMap) + queue = ActionQueueState::Clear; } /// Get the display position of the cursor in percent. diff --git a/TombEngine/Shaders/FullscreenQuad.fx b/TombEngine/Shaders/FullscreenQuad.fx index 6f59a855b..3d13f667c 100644 --- a/TombEngine/Shaders/FullscreenQuad.fx +++ b/TombEngine/Shaders/FullscreenQuad.fx @@ -1,31 +1,31 @@ -#include "./VertexInput.hlsli" - -struct PixelShaderInput -{ - float4 Position: SV_POSITION; - float2 UV: TEXCOORD; - float4 Color: COLOR; -}; - -Texture2D Texture : register(t0); -SamplerState Sampler : register(s0); - -PixelShaderInput VS(VertexShaderInput input) -{ - PixelShaderInput output; - - output.Position = float4(input.Position, 1.0f); - output.Color = input.Color; - output.UV = input.UV; - - return output; -} - -float4 PS(PixelShaderInput input) : SV_TARGET -{ - float4 output = Texture.Sample(Sampler, input.UV); - float4 colorMul = min(input.Color, 1.0f); - output = output * colorMul; - - return output; -} +#include "./VertexInput.hlsli" + +struct PixelShaderInput +{ + float4 Position: SV_POSITION; + float2 UV: TEXCOORD; + float4 Color: COLOR; +}; + +Texture2D Texture : register(t0); +SamplerState Sampler : register(s0); + +PixelShaderInput VS(VertexShaderInput input) +{ + PixelShaderInput output; + + output.Position = float4(input.Position, 1.0f); + output.Color = input.Color; + output.UV = input.UV; + + return output; +} + +float4 PS(PixelShaderInput input) : SV_TARGET +{ + float4 output = Texture.Sample(Sampler, input.UV); + float4 colorMul = min(input.Color, 1.0f); + output = output * colorMul; + + return output; +} diff --git a/TombEngine/Specific/Input/Bindings.cpp b/TombEngine/Specific/Input/Bindings.cpp new file mode 100644 index 000000000..641c940a4 --- /dev/null +++ b/TombEngine/Specific/Input/Bindings.cpp @@ -0,0 +1,199 @@ +#include "framework.h" +#include "Specific/Input/Bindings.h" + +#include "Specific/Input/InputAction.h" +#include "Specific/Input/Keys.h" + +#include + +using namespace OIS; + +namespace TEN::Input +{ + const BindingProfile BindingManager::DEFAULT_KEYBOARD_MOUSE_BINDING_PROFILE = + { + { In::Forward, KC_UP }, + { In::Back, KC_DOWN }, + { In::Left, KC_LEFT }, + { In::Right, KC_RIGHT }, + { In::StepLeft, KC_DELETE }, + { In::StepRight, KC_PGDOWN }, + { In::Action, KC_RCONTROL }, + { In::Walk, KC_RSHIFT }, + { In::Sprint, KC_SLASH }, + { In::Crouch, KC_PERIOD }, + { In::Jump, KC_RMENU }, + { In::Roll, KC_END }, + { In::Draw, KC_SPACE }, + { In::Look, KC_NUMPAD0 }, + + { In::Accelerate, KC_RCONTROL }, + { In::Reverse, KC_DOWN }, + { In::Faster, KC_SLASH }, + { In::Slower, KC_RSHIFT }, + { In::Brake, KC_RMENU }, + { In::Fire, KC_SPACE }, + + { In::Flare, KC_COMMA }, + { In::SmallMedipack, KC_MINUS }, + { In::LargeMedipack, KC_EQUALS }, + { In::PreviousWeapon, KC_LBRACKET }, + { In::NextWeapon, KC_RBRACKET }, + { In::Weapon1, KC_1 }, + { In::Weapon2, KC_2 }, + { In::Weapon3, KC_3 }, + { In::Weapon4, KC_4 }, + { In::Weapon5, KC_5 }, + { In::Weapon6, KC_6 }, + { In::Weapon7, KC_7 }, + { In::Weapon8, KC_8 }, + { In::Weapon9, KC_9 }, + { In::Weapon10, KC_0 }, + + { In::Select, KC_RETURN }, + { In::Deselect, KC_ESCAPE }, + { In::Pause, KC_P }, + { In::Inventory, KC_ESCAPE }, + { In::Save, KC_F5 }, + { In::Load, KC_F6 } + }; + + const BindingProfile BindingManager::DEFAULT_XBOX_CONTROLLER_BINDING_PROFILE = + { + { In::Forward, XK_AXIS_X_NEG }, + { In::Back, XK_AXIS_X_POS }, + { In::Left, XK_AXIS_Y_NEG }, + { In::Right, XK_AXIS_Y_POS }, + { In::StepLeft, XK_L_STICK }, + { In::StepRight, XK_R_STICK }, + { In::Action, XK_A }, + { In::Walk, XK_R_SHIFT }, + { In::Sprint, XK_AXIS_R_TRIGGER_NEG }, + { In::Crouch, XK_AXIS_L_TRIGGER_NEG }, + { In::Jump, XK_X }, + { In::Roll, XK_B }, + { In::Draw, XK_Y }, + { In::Look, XK_L_SHIFT }, + + { In::Accelerate, XK_A }, + { In::Reverse, XK_AXIS_X_POS }, + { In::Faster, XK_AXIS_R_TRIGGER_NEG }, + { In::Slower, XK_R_SHIFT }, + { In::Brake, XK_X }, + { In::Fire, XK_AXIS_L_TRIGGER_NEG }, + + { In::Flare, XK_DPAD_DOWN }, + { In::SmallMedipack, KC_MINUS }, + { In::LargeMedipack, KC_EQUALS }, + { In::PreviousWeapon, KC_LBRACKET }, + { In::NextWeapon, KC_RBRACKET }, + { In::Weapon1, KC_1 }, + { In::Weapon2, KC_2 }, + { In::Weapon3, KC_3 }, + { In::Weapon4, KC_4 }, + { In::Weapon5, KC_5 }, + { In::Weapon6, KC_6 }, + { In::Weapon7, KC_7 }, + { In::Weapon8, KC_8 }, + { In::Weapon9, KC_9 }, + { In::Weapon10, KC_0 }, + + { In::Select, KC_RETURN }, + { In::Deselect, XK_SELECT }, + { In::Pause, XK_START }, + { In::Inventory, XK_SELECT }, + { In::Save, KC_F5 }, + { In::Load, KC_F6 } + }; + + BindingManager::BindingManager() + { + // Initialize default bindings. + _bindings = + { + { InputDeviceID::Default, DEFAULT_KEYBOARD_MOUSE_BINDING_PROFILE }, + { InputDeviceID::Custom, DEFAULT_KEYBOARD_MOUSE_BINDING_PROFILE } + }; + + // Initialize conflicts. + for (int i = 0; i < (int)InputActionID::Count; i++) + { + auto actionID = (InputActionID)i; + _conflicts.insert({ actionID, false }); + } + } + + const BindingProfile& BindingManager::GetBindingProfile(InputDeviceID deviceID) + { + // Find binding profile. + auto bindingProfileIt = _bindings.find(deviceID); + TENAssert(bindingProfileIt != _bindings.end(), "Attempted to get missing binding profile " + std::to_string((int)deviceID) + "."); + + // Get and return binding profile. + const auto& [inputDeviceID, bindingProfile] = *bindingProfileIt; + return bindingProfile; + } + + int BindingManager::GetBoundKeyID(InputDeviceID deviceID, InputActionID actionID) + { + // Find binding profile. + auto bindingProfileIt = _bindings.find(deviceID); + if (bindingProfileIt == _bindings.end()) + return KC_UNASSIGNED; + + // Get binding profile. + const auto& [inputDeviceID, bindingProfile] = *bindingProfileIt; + + // Find key binding. + auto keyIt = bindingProfile.find(actionID); + if (keyIt == bindingProfile.end()) + return KC_UNASSIGNED; + + // Get and return key binding. + auto [inputActionID, keyID] = *keyIt; + return keyID; + } + + void BindingManager::SetKeyBinding(InputDeviceID deviceID, InputActionID actionID, int keyID) + { + // Overwrite or add key binding. + _bindings[deviceID][actionID] = keyID; + } + + void BindingManager::SetBindingProfile(InputDeviceID deviceID, const BindingProfile& bindingProfile) + { + // Overwrite or create binding profile. + _bindings[deviceID] = bindingProfile; + } + + void BindingManager::SetDefaultBindingProfile(InputDeviceID deviceID) + { + // Reset binding profile defaults. + switch (deviceID) + { + case InputDeviceID::Default: + _bindings[deviceID] = DEFAULT_KEYBOARD_MOUSE_BINDING_PROFILE; + break; + + case InputDeviceID::Custom: + _bindings[deviceID] = DEFAULT_KEYBOARD_MOUSE_BINDING_PROFILE; + break; + + default: + TENLog("Failed to reset defaults for binding profile " + std::to_string((int)deviceID) + ".", LogLevel::Warning); + return; + } + } + + void BindingManager::SetConflict(InputActionID actionID, bool value) + { + _conflicts.insert({ actionID, value }); + } + + bool BindingManager::TestConflict(InputActionID actionID) + { + return _conflicts.at(actionID); + } + + BindingManager g_Bindings; +} diff --git a/TombEngine/Specific/Input/Bindings.h b/TombEngine/Specific/Input/Bindings.h new file mode 100644 index 000000000..2f7665079 --- /dev/null +++ b/TombEngine/Specific/Input/Bindings.h @@ -0,0 +1,63 @@ +#pragma once + +namespace TEN::Input +{ + enum class InputActionID; + + using BindingProfile = std::unordered_map; // Key = input action ID, value = key ID. + + // TODO: These don't represent devices yet, it's still the legacy way + // (i.e. default binding + custom binding on top). + // A future refactor should modernise this system. + enum class InputDeviceID // ProfileID + { + Default, + Custom, + + //KeyboardMouse, + //Gamepad, + //XBox, + //Dualshock, + //Dancepad, + + Count + }; + + // TODO: Allow different binding profiles for each device. Default, Custom1, Custom2. + class BindingManager + { + private: + // Fields + + std::unordered_map _bindings = {}; // Key = input action ID, value = binding profile. + std::unordered_map _conflicts = {}; // Key = Input action ID, value = has conflict. + + public: + // Constants + + static const BindingProfile DEFAULT_KEYBOARD_MOUSE_BINDING_PROFILE; + static const BindingProfile DEFAULT_XBOX_CONTROLLER_BINDING_PROFILE; + + // Constructors + + BindingManager(); + + // Getters + + int GetBoundKeyID(InputDeviceID deviceID, InputActionID actionID); + const BindingProfile& GetBindingProfile(InputDeviceID deviceID); + + // Setters + + void SetKeyBinding(InputDeviceID deviceID, InputActionID actionID, int keyID); + void SetBindingProfile(InputDeviceID deviceID, const BindingProfile& profile); + void SetDefaultBindingProfile(InputDeviceID deviceID); + void SetConflict(InputActionID actionID, bool value); + + // Inquirers + + bool TestConflict(InputActionID actionID); + }; + + extern BindingManager g_Bindings; +} diff --git a/TombEngine/Specific/Input/Input.cpp b/TombEngine/Specific/Input/Input.cpp index 3dd14e36b..d657cc077 100644 --- a/TombEngine/Specific/Input/Input.cpp +++ b/TombEngine/Specific/Input/Input.cpp @@ -22,9 +22,10 @@ using namespace OIS; using namespace TEN::Gui; using namespace TEN::Math; +using namespace TEN::Utils; using TEN::Renderer::g_Renderer; -// Big TODO: Entire input system shouldn't be left exposed like this. +// Big TODO: Make an Input class and handle everything inside it. namespace TEN::Input { @@ -33,97 +34,22 @@ namespace TEN::Input constexpr auto AXIS_OFFSET = 0.2f; constexpr auto MOUSE_AXIS_CONSTRAINT = 100.0f; - // OIS interfaces - InputManager* OisInputManager = nullptr; - Keyboard* OisKeyboard = nullptr; - Mouse* OisMouse = nullptr; - JoyStick* OisGamepad = nullptr; - ForceFeedback* OisRumble = nullptr; - Effect* OisEffect = nullptr; - // Globals - RumbleData RumbleInfo = {}; - std::vector ActionMap = {}; - std::vector ActionQueue = {}; - std::vector KeyMap = {}; - std::vector AxisMap = {}; - const std::vector g_KeyNames = - { - "", "Esc", "1", "2", "3", "4", "5", "6", - "7", "8", "9", "0", "-", "+", "Back", "Tab", - "Q", "W", "E", "R", "T", "Y", "U", "I", - "O", "P", "[", "]", "Enter", "Ctrl", "A", "S", - "D", "F", "G", "H", "J", "K", "L", ";", - "'", "`", "Shift", "#", "Z", "X", "C", "V", - "B", "N", "M", ",", ".", "/", "Shift", "Pad X", - "Alt", "Space", "Caps Lock", "F1", "F2", "F3", "F4", "F5", + RumbleData RumbleInfo = {}; + std::unordered_map KeyMap; // Key = key ID, value = key value. + std::unordered_map AxisMap; // Key = input axis ID, value = axis. + std::unordered_map ActionMap; // Key = input action ID, value = input action. + std::unordered_map ActionQueueMap; // Key = inputActionID, value = action queue state. - "F6", "F7", "F8", "F9", "F10", "Num Lock", "Scroll Lock", "Pad 7", - "Pad 8", "Pad 9", "Pad -", "Pad 4", "Pad 5", "Pad 6", "Pad +", "Pad 1", - "Pad 2", "Pad 3", "Pad 0", "Pad .", "", "", "\\", "F11", - "F12", "", "", "", "", "", "", "", - "", "", "", "", "", "", "", "", - "", "", "", "", "", "", "", "", - "", "", "", "", "", "", "", "", - "", "", "", "", "", "", "", "", + // OIS interfaces - "", "", "", "", "", "", "", "", - "", "", "", "", "", "", "", "", - "", "", "", "", "", "", "", "", - "", "", "", "", "Pad Enter", "Ctrl", "", "", - "", "", "", "", "", "", "", "", - "", "", "Shift", "", "", "", "", "", - "", "", "", "", "", "Pad /", "", "", - "Alt", "", "", "", "", "", "", "", - - "", "", "", "", "", "", "", "Home", - "Up", "Page Up", "", "Left", "", "Right", "", "End", - "Down", "Page Down", "Insert", "Del", "", "", "", "", - "", "", "", "", "", "", "", "", - "", "", "", "", "", "", "", "", - "", "", "", "", "", "", "", "", - "", "", "", "", "", "", "", "", - "", "", "", "", "", "", "", "", - - "Joy 1", "Joy 2", "Joy 3", "Joy 4", "Joy 5", "Joy 6", "Joy 7", "Joy 8", - "Joy 9", "Joy 10", "Joy 11", "Joy 12", "Joy 13", "Joy 14", "Joy 15", "Joy 16", - - "X-", "X+", "Y-", "Y+", "Z-", "Z+", "W-", "W+", - "Joy LT", "Joy LT", "Joy RT", "Joy RT", "D-Pad Up", "D-Pad Down", "D-Pad Left", "D-Pad Right", - - "Left-Click", "Right-Click", "Middle-Click", "Mouse 4", "Mouse 5", "Mouse 6", "Mouse 7", "Mouse 8", - "Mouse X-", "Mouse X+", "Mouse Y-", "Mouse Y+", "Mouse Z-", "Mouse Z+" - }; - - // Binding rows: - // 1. General actions - // 2. Vehicle actions - // 3. Quick actions - // 4. Menu actions - - const auto DefaultGenericBindings = std::vector - { - KC_UP, KC_DOWN, KC_LEFT, KC_RIGHT, KC_DELETE, KC_PGDOWN, KC_RSHIFT, KC_SLASH, KC_PERIOD, KC_RMENU, KC_END, KC_RCONTROL, KC_SPACE, KC_NUMPAD0, - KC_RCONTROL, KC_DOWN, KC_SLASH, KC_RSHIFT, KC_RMENU, KC_SPACE, - KC_COMMA, KC_MINUS, KC_EQUALS, KC_LBRACKET, KC_RBRACKET, KC_1, KC_2, KC_3, KC_4, KC_5, KC_6, KC_7, KC_8, KC_9, KC_0, - KC_RETURN, KC_ESCAPE, KC_P, KC_ESCAPE, KC_F5, KC_F6 - }; - const auto DefaultXInputBindings = std::vector - { - XB_AXIS_X_NEG, XB_AXIS_X_POS, XB_AXIS_Y_NEG, XB_AXIS_Y_POS, XB_LSTICK, XB_RSTICK, XB_RSHIFT, XB_AXIS_RTRIGGER_NEG, XB_AXIS_LTRIGGER_NEG, XB_X, XB_B, XB_A, XB_Y, XB_LSHIFT, - XB_A, XB_B, XB_AXIS_RTRIGGER_NEG, XB_AXIS_LTRIGGER_NEG, XB_X, XB_RSHIFT, - XB_DPAD_DOWN, XB_DPAD_RIGHT, XB_DPAD_LEFT, KC_LBRACKET, XB_DPAD_UP, KC_1, KC_2, KC_3, KC_4, KC_5, KC_6, KC_7, KC_8, KC_9, KC_0, - XB_A, XB_Y, XB_START, XB_SELECT, KC_F5, KC_F6 - }; - - std::vector> Bindings = - { - DefaultGenericBindings, - DefaultGenericBindings - }; - - auto ConflictingKeys = std::array{}; + static InputManager* OisInputManager = nullptr; + static Keyboard* OisKeyboard = nullptr; + static Mouse* OisMouse = nullptr; + static JoyStick* OisGamepad = nullptr; + static ForceFeedback* OisRumble = nullptr; + static Effect* OisEffect = nullptr; void InitializeEffect() { @@ -147,17 +73,26 @@ namespace TEN::Input { TENLog("Initializing input system...", LogLevel::Info); - // Initialize maps. - for (int i = 0; i < (int)ActionID::Count; i++) + RumbleInfo = {}; + + // Initialize key map. + for (int i = 0; i < KEY_COUNT; i++) + KeyMap[i] = 0.0f; + + // Initialize input axis map. + for (int i = 0; i < (int)InputAxisID::Count; i++) { - ActionMap.push_back(InputAction((ActionID)i)); - ActionQueue.push_back(QueueState::None); + auto inputAxis = (InputAxisID)i; + AxisMap[inputAxis] = Vector2::Zero; } - KeyMap.resize(MAX_INPUT_SLOTS); - AxisMap.resize((int)InputAxis::Count); - - RumbleInfo = {}; + // Initialize input action and input action queue maps. + for (int i = 0; i < (int)InputActionID::Count; i++) + { + auto actionID = (InputActionID)i; + ActionMap[actionID] = InputAction(actionID); + ActionQueueMap[actionID] = ActionQueueState::None; + } try { @@ -194,7 +129,7 @@ namespace TEN::Input } catch (OIS::Exception& ex) { - TENLog("An exception occured during input system init: " + std::string(ex.eText), LogLevel::Error); + TENLog("Exception occured during input system initialization: " + std::string(ex.eText), LogLevel::Error); } int deviceCount = OisInputManager->getNumberOfDevices(OISJoyStick); @@ -225,7 +160,7 @@ namespace TEN::Input } catch (OIS::Exception& ex) { - TENLog("An exception occured during game controller init: " + std::string(ex.eText), LogLevel::Error); + TENLog("Exception occured during game controller initialization: " + std::string(ex.eText), LogLevel::Error); } } } @@ -252,44 +187,47 @@ namespace TEN::Input void ClearInputData() { - for (auto& key : KeyMap) - key = false; + for (auto& [keyID, value] : KeyMap) + value = 0.0f; - for (auto& axis : AxisMap) + for (auto& [axisID, axis] : AxisMap) axis = Vector2::Zero; } void ApplyActionQueue() { - for (int i = 0; i < (int)In::Count; i++) + for (int i = 0; i < (int)InputActionID::Count; i++) { - switch (ActionQueue[i]) + auto actionID = (InputActionID)i; + switch (ActionQueueMap[actionID]) { default: - case QueueState::None: + case ActionQueueState::None: break; - case QueueState::Push: - ActionMap[i].Update(true); + case ActionQueueState::Update: + ActionMap[actionID].Update(true); break; - case QueueState::Clear: - ActionMap[i].Clear(); + case ActionQueueState::Clear: + ActionMap[actionID].Clear(); break; } } - for (auto& queue : ActionQueue) - queue = QueueState::None; + for (auto& [actionID, queue] : ActionQueueMap) + queue = ActionQueueState::None; } - bool LayoutContainsIndex(int index) + static bool TestBoundKey(int keyID) { - for (int layout = 1; layout >= 0; layout--) + for (int i = 1; i >= 0; i--) { - for (int i = 0; i < (int)In::Count; i++) + auto deviceID = (InputDeviceID)i; + for (int j = 0; j < (int)InputActionID::Count; j++) { - if (Bindings[layout][i] == index) + auto actionID = (InputActionID)j; + if (g_Bindings.GetBoundKeyID(deviceID, actionID) != KC_UNASSIGNED) return true; } } @@ -298,7 +236,7 @@ namespace TEN::Input } // Merge right and left Ctrl, Shift, and Alt keys. - int WrapSimilarKeys(int source) + static int WrapSimilarKeys(int source) { switch (source) { @@ -317,42 +255,44 @@ namespace TEN::Input void DefaultConflict() { - for (int i = 0; i < (int)In::Count; i++) + for (int i = 0; i < (int)InputActionID::Count; i++) { - int key = Bindings[0][i]; + auto actionID = (InputActionID)i; - ConflictingKeys[i] = false; + g_Bindings.SetConflict(actionID, false); - for (int j = 0; j < (int)In::Count; j++) + int key = g_Bindings.GetBoundKeyID(InputDeviceID::Default, (InputActionID)i); + for (int j = 0; j < (int)InputActionID::Count; j++) { - if (key != Bindings[1][j]) + if (key != g_Bindings.GetBoundKeyID(InputDeviceID::Custom, (InputActionID)j)) continue; - ConflictingKeys[i] = true; + g_Bindings.SetConflict(actionID, true); break; } } } - void SetDiscreteAxisValues(int index) + static void SetDiscreteAxisValues(unsigned int keyID) { - for (int layout = 0; layout <= 1; layout++) + for (int i = 0; i < (int)InputDeviceID::Count; i++) { - if (Bindings[layout][(int)In::Forward] == index) + auto deviceID = (InputDeviceID)i; + if (g_Bindings.GetBoundKeyID(deviceID, In::Forward) == keyID) { - AxisMap[(int)InputAxis::Move].y = 1.0f; + AxisMap[InputAxisID::Move].y = 1.0f; } - else if (Bindings[layout][(int)In::Back] == index) + else if (g_Bindings.GetBoundKeyID(deviceID, In::Back) == keyID) { - AxisMap[(int)InputAxis::Move].y = -1.0f; + AxisMap[InputAxisID::Move].y = -1.0f; } - else if (Bindings[layout][(int)In::Left] == index) + else if (g_Bindings.GetBoundKeyID(deviceID, In::Left) == keyID) { - AxisMap[(int)InputAxis::Move].x = -1.0f; + AxisMap[InputAxisID::Move].x = -1.0f; } - else if (Bindings[layout][(int)In::Right] == index) + else if (g_Bindings.GetBoundKeyID(deviceID, In::Right) == keyID) { - AxisMap[(int)InputAxis::Move].x = 1.0f; + AxisMap[InputAxisID::Move].x = 1.0f; } } } @@ -366,14 +306,14 @@ namespace TEN::Input { OisKeyboard->capture(); - // Poll keys. - for (int i = 0; i < MAX_KEYBOARD_KEYS; i++) + // Poll keyboard keys. + for (int i = 0; i < KEYBOARD_KEY_COUNT; i++) { if (!OisKeyboard->isKeyDown((KeyCode)i)) continue; int key = WrapSimilarKeys(i); - KeyMap[key] = true; + KeyMap[key] = 1.0f; // Interpret discrete directional keypresses as analog axis values. SetDiscreteAxisValues(key); @@ -400,13 +340,13 @@ namespace TEN::Input state.width = screenRes.x; state.height = screenRes.y; - // Poll buttons. - for (int i = 0; i < MAX_MOUSE_KEYS; i++) - KeyMap[ACTION_OFFSET_MOUSE + i] = state.buttonDown((MouseButtonID)i); + // Poll mouse buttons. + for (int i = 0; i < MOUSE_BUTTON_COUNT; i++) + KeyMap[KEY_OFFSET_MOUSE + i] = state.buttonDown((MouseButtonID)i) ? 1.0f : 0.0f; // Register multiple directional keypresses mapped to mouse axes. - int baseIndex = ACTION_OFFSET_MOUSE + MAX_MOUSE_KEYS; - for (int pass = 0; pass < MAX_MOUSE_AXES; pass++) + int baseIndex = KEY_OFFSET_MOUSE + MOUSE_BUTTON_COUNT; + for (int pass = 0; pass < (MOUSE_AXIS_COUNT * 2); pass++) { switch (pass) { @@ -447,7 +387,7 @@ namespace TEN::Input break; } - KeyMap[baseIndex + pass] = true; + KeyMap[baseIndex + pass] = 1.0f; // Interpret discrete directional keypresses as mouse axis values. SetDiscreteAxisValues(baseIndex + pass); @@ -465,7 +405,7 @@ namespace TEN::Input normAxes *= sensitivity; // Set mouse axis values. - AxisMap[(int)InputAxis::Mouse] = normAxes; + AxisMap[InputAxisID::Mouse] = normAxes; } catch (OIS::Exception& ex) { @@ -484,83 +424,84 @@ namespace TEN::Input const auto& state = OisGamepad->getJoyStickState(); // Poll buttons. - for (int key = 0; key < state.mButtons.size(); key++) - KeyMap[ACTION_OFFSET_GAMEPAD + key] = state.mButtons[key]; + for (int keyID = 0; keyID < state.mButtons.size(); keyID++) + KeyMap[KEY_OFFSET_GAMEPAD + keyID] = state.mButtons[keyID] ? 1.0f : 0.0f; // Poll axes. for (int axis = 0; axis < state.mAxes.size(); axis++) { - // NOTE: We don't support anything above 6 existing XBOX/PS controller axes (2 sticks plus 2 triggers = 6). - if (axis >= MAX_GAMEPAD_AXES) + // NOTE: Anything above 6 existing XBOX/PS controller axes not supported (2 sticks plus 2 triggers). + if (axis >= GAMEPAD_AXIS_COUNT) break; // Filter out deadzone. if (abs(state.mAxes[axis].abs) < AXIS_DEADZONE) continue; - // Calculate raw normalized analog value for camera. - float axisValue = (state.mAxes[axis].abs > 0) ? -AXIS_DEADZONE : AXIS_DEADZONE; - float normalizedValue = (state.mAxes[axis].abs + axisValue) / (SHRT_MAX - AXIS_DEADZONE); + // Calculate raw normalized analog value (for camera). + float normalizedValue = float(state.mAxes[axis].abs + (state.mAxes[axis].abs > 0 ? -AXIS_DEADZONE : AXIS_DEADZONE)) / + float(SHRT_MAX - AXIS_DEADZONE); // Calculate scaled analog value for movement. // NOTE: [0.2f, 1.7f] range gives most organic rates. float scaledValue = (abs(normalizedValue) * AXIS_SCALE) + AXIS_OFFSET; // Calculate and reset discrete input slots. - int negKeyIndex = ACTION_OFFSET_GAMEPAD + MAX_GAMEPAD_KEYS + (axis * 2); - int posKeyIndex = ACTION_OFFSET_GAMEPAD + MAX_GAMEPAD_KEYS + (axis * 2) + 1; - KeyMap[negKeyIndex] = false; - KeyMap[posKeyIndex] = false; + int negKeyID = (KEY_OFFSET_GAMEPAD + GAMEPAD_BUTTON_COUNT) + (axis * 2); + int posKeyID = (KEY_OFFSET_GAMEPAD + GAMEPAD_BUTTON_COUNT) + (axis * 2) + 1; + KeyMap[negKeyID] = (normalizedValue > 0) ? abs(normalizedValue) : 0.0f; + KeyMap[posKeyID] = (normalizedValue < 0) ? abs(normalizedValue) : 0.0f; // Determine discrete input registering based on analog value. - int usedIndex = (normalizedValue > 0) ? negKeyIndex : posKeyIndex; - KeyMap[usedIndex] = true; + int usedKeyID = (normalizedValue > 0) ? negKeyID : posKeyID; // Register analog input in certain direction. // If axis is bound as directional controls, register axis as directional input. // Otherwise, register as camera movement input (for future). // NOTE: abs() operations are needed to avoid issues with inverted axes on different controllers. - if (Bindings[1][(int)In::Forward] == usedIndex) + if (g_Bindings.GetBoundKeyID(InputDeviceID::Custom, In::Forward) == usedKeyID) { - AxisMap[(int)InputAxis::Move].y = abs(scaledValue); + AxisMap[InputAxisID::Move].y = abs(scaledValue); } - else if (Bindings[1][(int)In::Back] == usedIndex) + else if (g_Bindings.GetBoundKeyID(InputDeviceID::Custom, In::Back) == usedKeyID) { - AxisMap[(int)InputAxis::Move].y = -abs(scaledValue); + AxisMap[InputAxisID::Move].y = -abs(scaledValue); } - else if (Bindings[1][(int)In::Left] == usedIndex) + else if (g_Bindings.GetBoundKeyID(InputDeviceID::Custom, In::Left) == usedKeyID) { - AxisMap[(int)InputAxis::Move].x = -abs(scaledValue); + AxisMap[InputAxisID::Move].x = -abs(scaledValue); } - else if (Bindings[1][(int)In::Right] == usedIndex) + else if (g_Bindings.GetBoundKeyID(InputDeviceID::Custom, In::Right) == usedKeyID) { - AxisMap[(int)InputAxis::Move].x = abs(scaledValue); + AxisMap[InputAxisID::Move].x = abs(scaledValue); } - else if (!LayoutContainsIndex(usedIndex)) + else if (!TestBoundKey(usedKeyID)) { if ((axis % 2) == 0) { - AxisMap[(int)InputAxis::Camera].y = normalizedValue; + AxisMap[InputAxisID::Camera].y = normalizedValue; } else { - AxisMap[(int)InputAxis::Camera].x = normalizedValue; + AxisMap[InputAxisID::Camera].x = normalizedValue; } } } // Poll POVs. // NOTE: Controllers usually have one, but scan all just in case. - for (int pov = 0; pov < MAX_GAMEPAD_POV_AXES; pov++) + for (int pov = 0; pov < GAMEPAD_POV_AXIS_COUNT; pov++) { if (state.mPOV[pov].direction == Pov::Centered) continue; // Register multiple directional keypresses mapped to analog axes. - int baseIndex = ACTION_OFFSET_GAMEPAD + MAX_GAMEPAD_KEYS + (MAX_GAMEPAD_AXES * 2); - for (int pass = 0; pass < MAX_GAMEPAD_POV_AXES; pass++) + int baseKeyID = (KEY_OFFSET_GAMEPAD + GAMEPAD_BUTTON_COUNT) + (GAMEPAD_AXIS_COUNT * 2); + for (int pass = 0; pass < GAMEPAD_POV_AXIS_COUNT; pass++) { + int keyID = (KEY_OFFSET_GAMEPAD + GAMEPAD_BUTTON_COUNT) + (GAMEPAD_AXIS_COUNT * 2); + switch (pass) { // D-Pad Up @@ -588,8 +529,9 @@ namespace TEN::Input break; } - KeyMap[baseIndex + pass] = true; - SetDiscreteAxisValues(baseIndex + pass); + keyID += pass; + KeyMap[keyID] = 1.0f; + SetDiscreteAxisValues(keyID); } } } @@ -599,20 +541,21 @@ namespace TEN::Input } } - bool Key(int number) + static float Key(InputActionID actionID) { - for (int layout = 1; layout >= 0; layout--) + for (int i = (int)InputDeviceID::Count - 1; i >= 0; i--) { - int key = Bindings[layout][number]; - - if (layout == 0 && ConflictingKeys[number]) + auto deviceID = (InputDeviceID)i; + + if (deviceID == InputDeviceID::Default && g_Bindings.TestConflict(actionID)) continue; - if (KeyMap[key]) - return true; + int keyID = g_Bindings.GetBoundKeyID((InputDeviceID)i, actionID); + if (KeyMap[keyID] != 0.0f) + return KeyMap[keyID]; } - return false; + return 0.0f; } void SolveActionCollisions() @@ -667,8 +610,7 @@ namespace TEN::Input RumbleInfo.Power -= RumbleInfo.FadeSpeed; // Don't update effect too frequently if its value hasn't changed much. - if (RumbleInfo.Power >= 0.2f && - RumbleInfo.LastPower - RumbleInfo.Power < 0.1f) + if (RumbleInfo.Power >= 0.2f && (RumbleInfo.LastPower - RumbleInfo.Power) < 0.1f) return; if (RumbleInfo.Power <= 0.0f) @@ -722,8 +664,8 @@ namespace TEN::Input DefaultConflict(); // Update action map. - for (auto& action : ActionMap) - action.Update(Key((int)action.GetID())); + for (auto& [actionID, action] : ActionMap) + action.Update(Key(action.GetID())); if (applyQueue) ApplyActionQueue(); @@ -735,11 +677,11 @@ namespace TEN::Input void ClearAllActions() { - for (auto& action : ActionMap) + for (auto& [actionID, action] : ActionMap) action.Clear(); - for (auto& queue : ActionQueue) - queue = QueueState::None; + for (auto& [actionID, queue] : ActionQueueMap) + queue = ActionQueueState::None; } void Rumble(float power, float delayInSec, RumbleMode mode) @@ -774,20 +716,14 @@ namespace TEN::Input RumbleInfo = {}; } - static void ApplyBindings(const std::vector& bindings) + static void ApplyBindings(const BindingProfile& set) { - for (int i = 0; i < bindings.size(); i++) - { - if (i >= (int)In::Count) - break; - - Bindings[1][i] = bindings[i]; - } + g_Bindings.SetBindingProfile(InputDeviceID::Custom, set); } void ApplyDefaultBindings() { - ApplyBindings(DefaultGenericBindings); + ApplyBindings(BindingManager::DEFAULT_KEYBOARD_MOUSE_BINDING_PROFILE); ApplyDefaultXInputBindings(); } @@ -796,22 +732,29 @@ namespace TEN::Input if (!OisGamepad) return false; - for (int i = 0; i < (int)In::Count; i++) + for (int i = 0; i < (int)InputActionID::Count; i++) { - if (Bindings[1][i] != KC_UNASSIGNED && Bindings[1][i] != Bindings[0][i]) + auto actionID = (InputActionID)i; + + int defaultKeyID = g_Bindings.GetBoundKeyID(InputDeviceID::Default, actionID); + int userKeyID = g_Bindings.GetBoundKeyID(InputDeviceID::Custom, actionID); + + if (userKeyID != KC_UNASSIGNED && + userKeyID != defaultKeyID) + { return false; + } } - auto vendor = TEN::Utils::ToLower(OisGamepad->vendor()); + auto vendor = ToLower(OisGamepad->vendor()); if (vendor.find("xbox") != std::string::npos || vendor.find("xinput") != std::string::npos) { - ApplyBindings(DefaultXInputBindings); + ApplyBindings(BindingManager::DEFAULT_XBOX_CONTROLLER_BINDING_PROFILE); + g_Configuration.Bindings = g_Bindings.GetBindingProfile(InputDeviceID::Custom); - for (int i = 0; i < (int)In::Count; i++) - g_Configuration.Bindings[i] = Bindings[1][i]; - - // Additionally turn on thumbstick camera and vibration. - g_Configuration.EnableRumble = g_Configuration.EnableThumbstickCamera = true; + // Additionally enable rumble and thumbstick camera. + g_Configuration.EnableRumble = true; + g_Configuration.EnableThumbstickCamera = true; return true; } @@ -830,14 +773,14 @@ namespace TEN::Input return (DISPLAY_SPACE_RES * (areaPos / areaRes)); } - void ClearAction(ActionID actionID) + void ClearAction(InputActionID actionID) { - ActionMap[(int)actionID].Clear(); + ActionMap[actionID].Clear(); } bool NoAction() { - for (const auto& action : ActionMap) + for (const auto& [actionID, action] : ActionMap) { if (action.IsHeld()) return false; @@ -846,39 +789,41 @@ namespace TEN::Input return true; } - bool IsClicked(ActionID actionID) + bool IsClicked(InputActionID actionID) { - return ActionMap[(int)actionID].IsClicked(); + return ActionMap[actionID].IsClicked(); } - bool IsHeld(ActionID actionID, float delayInSec) + bool IsHeld(InputActionID actionID, float delayInSec) { - return ActionMap[(int)actionID].IsHeld(delayInSec); + return ActionMap[actionID].IsHeld(delayInSec); } - bool IsPulsed(ActionID actionID, float delayInSec, float initialDelayInSec) + bool IsPulsed(InputActionID actionID, float delayInSec, float initialDelayInSec) { - return ActionMap[(int)actionID].IsPulsed(delayInSec, initialDelayInSec); + return ActionMap[actionID].IsPulsed(delayInSec, initialDelayInSec); } - bool IsReleased(ActionID actionID, float maxDelayInSec) + bool IsReleased(InputActionID actionID, float maxDelayInSec) { - return ActionMap[(int)actionID].IsReleased(maxDelayInSec); + return ActionMap[actionID].IsReleased(maxDelayInSec); } - float GetActionValue(ActionID actionID) + float GetActionValue(InputActionID actionID) { - return ActionMap[(int)actionID].GetValue(); + return ActionMap[actionID].GetValue(); } - float GetActionTimeActive(ActionID actionID) + // Time in game frames. + unsigned int GetActionTimeActive(InputActionID actionID) { - return ActionMap[(int)actionID].GetTimeActive(); + return ActionMap[actionID].GetTimeActive(); } - float GetActionTimeInactive(ActionID actionID) + // Time in game frames. + unsigned int GetActionTimeInactive(InputActionID actionID) { - return ActionMap[(int)actionID].GetTimeInactive(); + return ActionMap[actionID].GetTimeInactive(); } bool IsDirectionalActionHeld() diff --git a/TombEngine/Specific/Input/Input.h b/TombEngine/Specific/Input/Input.h index 9789a4da4..6b704e41a 100644 --- a/TombEngine/Specific/Input/Input.h +++ b/TombEngine/Specific/Input/Input.h @@ -1,6 +1,9 @@ #pragma once + #include "Math/Math.h" +#include "Specific/Input/Bindings.h" #include "Specific/Input/InputAction.h" +#include "Specific/Input/Keys.h" using namespace TEN::Math; @@ -8,52 +11,7 @@ struct ItemInfo; namespace TEN::Input { - constexpr auto MAX_KEYBOARD_KEYS = 256; - constexpr auto MAX_GAMEPAD_KEYS = 16; - constexpr auto MAX_GAMEPAD_AXES = 6; - constexpr auto MAX_GAMEPAD_POV_AXES = 4; - constexpr auto MAX_MOUSE_KEYS = 8; - constexpr auto MAX_MOUSE_AXES = 6; - - constexpr auto ACTION_OFFSET_GAMEPAD = MAX_KEYBOARD_KEYS; - constexpr auto ACTION_OFFSET_MOUSE = ACTION_OFFSET_GAMEPAD + MAX_GAMEPAD_KEYS + (MAX_GAMEPAD_AXES * 2) + MAX_GAMEPAD_POV_AXES; - - constexpr auto MAX_INPUT_SLOTS = ACTION_OFFSET_MOUSE + MAX_MOUSE_KEYS + MAX_MOUSE_AXES; - - enum XInputButton - { - XB_START = ACTION_OFFSET_GAMEPAD, - XB_SELECT, - XB_LSTICK, - XB_RSTICK, - XB_LSHIFT, - XB_RSHIFT, - XB_UNUSED1, - XB_UNUSED2, - XB_A, - XB_B, - XB_X, - XB_Y, - XB_LOGO, - XB_AXIS_X_POS = ACTION_OFFSET_GAMEPAD + MAX_GAMEPAD_KEYS, - XB_AXIS_X_NEG, - XB_AXIS_Y_POS, - XB_AXIS_Y_NEG, - XB_AXIS_Z_POS, - XB_AXIS_Z_NEG, - XB_AXIS_W_POS, - XB_AXIS_W_NEG, - XB_AXIS_LTRIGGER_NEG, - XB_AXIS_LTRIGGER_POS, - XB_AXIS_RTRIGGER_NEG, - XB_AXIS_RTRIGGER_POS, - XB_DPAD_UP, - XB_DPAD_DOWN, - XB_DPAD_LEFT, - XB_DPAD_RIGHT - }; - - enum class InputAxis + enum class InputAxisID { Move, Camera, @@ -62,10 +20,10 @@ namespace TEN::Input Count }; - enum class QueueState + enum class ActionQueueState { None, - Push, + Update, Clear }; @@ -85,13 +43,10 @@ namespace TEN::Input float FadeSpeed = 0.0f; }; - extern std::vector ActionMap; - extern std::vector ActionQueue; - extern std::vector KeyMap; - extern std::vector AxisMap; - - extern const std::vector g_KeyNames; - extern std::vector> Bindings; + extern std::unordered_map KeyMap; + extern std::unordered_map AxisMap; + extern std::unordered_map ActionMap; + extern std::unordered_map ActionQueueMap; void InitializeInput(HWND handle); void DeinitializeInput(); @@ -106,16 +61,15 @@ namespace TEN::Input Vector2 GetMouse2DPosition(); - // TODO: Move global query functions to player input object (not happening soon). -- Sezz 2023.08.07 - void ClearAction(ActionID actionID); - bool NoAction(); - bool IsClicked(ActionID actionID); - bool IsHeld(ActionID actionID, float delayInSec = 0.0f); - bool IsPulsed(ActionID actionID, float delayInSec, float initialDelayInSec = 0.0f); - bool IsReleased(ActionID actionID, float maxDelayInSec = INFINITY); - float GetActionValue(ActionID actionID); - float GetActionTimeActive(ActionID actionID); - float GetActionTimeInactive(ActionID actionID); + void ClearAction(InputActionID actionID); + bool NoAction(); + bool IsClicked(InputActionID actionID); + bool IsHeld(InputActionID actionID, float delayInSec = 0.0f); + bool IsPulsed(InputActionID actionID, float delayInSec, float initialDelayInSec = 0.0f); + bool IsReleased(InputActionID actionID, float maxDelayInSec = INFINITY); + float GetActionValue(InputActionID actionID); + unsigned int GetActionTimeActive(InputActionID actionID); + unsigned int GetActionTimeInactive(InputActionID actionID); bool IsDirectionalActionHeld(); bool IsWakeActionHeld(); diff --git a/TombEngine/Specific/Input/InputAction.cpp b/TombEngine/Specific/Input/InputAction.cpp index 48b28f6c2..8ec9f1a06 100644 --- a/TombEngine/Specific/Input/InputAction.cpp +++ b/TombEngine/Specific/Input/InputAction.cpp @@ -5,12 +5,12 @@ namespace TEN::Input { - InputAction::InputAction(ActionID actionID) + InputAction::InputAction(InputActionID actionID) { _id = actionID; } - ActionID InputAction::GetID() const + InputActionID InputAction::GetID() const { return _id; } @@ -20,56 +20,53 @@ namespace TEN::Input return _value; } - float InputAction::GetTimeActive() const + // Time in game frames. + unsigned int InputAction::GetTimeActive() const { return _timeActive; } - float InputAction::GetTimeInactive() const + // Time in game frames. + unsigned int InputAction::GetTimeInactive() const { return _timeInactive; } bool InputAction::IsClicked() const { - return ((_value != 0.0f) && (_prevValue == 0.0f)); + return (_value != 0.0f && _prevValue == 0.0f); } - bool InputAction::IsHeld(float delayInSec) const + bool InputAction::IsHeld(float delaySecs) const { - float delayInFrameTime = (delayInSec == 0.0f) ? 0.0f : round(delayInSec / DELTA_TIME); - return ((_value != 0.0f) && (_timeActive >= delayInFrameTime)); + unsigned int delayGameFrames = (delaySecs == 0.0f) ? 0 : (unsigned int)round(delaySecs / DELTA_TIME); + return (_value != 0.0f && _timeActive >= delayGameFrames); } - // NOTE: To avoid stutter on second pulse, ensure initialDelayInSec is multiple of delayInSec. - bool InputAction::IsPulsed(float delayInSec, float initialDelayInSec) const + // NOTE: To avoid stutter on second pulse, ensure initialDelaySecs is multiple of delaySecs. + bool InputAction::IsPulsed(float delaySecs, float initialDelaySecs) const { if (IsClicked()) return true; - if (!IsHeld() || _prevTimeActive == 0.0f || _timeActive == _prevTimeActive) + if (!IsHeld() || _prevTimeActive == 0 || _timeActive == _prevTimeActive) return false; - float activeDelayInFrameTime = (_timeActive > round(initialDelayInSec / DELTA_TIME)) ? round(delayInSec / DELTA_TIME) : round(initialDelayInSec / DELTA_TIME); - float delayInFrameTime = std::floor(_timeActive / activeDelayInFrameTime) * activeDelayInFrameTime; - if (delayInFrameTime > (std::floor(_prevTimeActive / activeDelayInFrameTime) * activeDelayInFrameTime)) + float activeDelaySecs = (_timeActive > (unsigned int)round(initialDelaySecs / DELTA_TIME)) ? delaySecs : initialDelaySecs; + unsigned int activeDelayGameFrames = (unsigned int)round(activeDelaySecs / DELTA_TIME); + + unsigned int delayGameFrames = (unsigned int)floor(_timeActive / activeDelayGameFrames) * activeDelayGameFrames; + unsigned int prevDelayGameFrames = (unsigned int)floor(_prevTimeActive / activeDelayGameFrames) * activeDelayGameFrames; + if (delayGameFrames > prevDelayGameFrames) return true; - // Keeping version counting real time for future reference. -- Sezz 2022.10.01 - /*float syncedTimeActive = TimeActive - std::fmod(TimeActive, DELTA_TIME); - float activeDelay = (TimeActive > initialDelayInSec) ? delayInSeconds : initialDelayInSec; - - float delayTime = std::floor(syncedTimeActive / activeDelay) * activeDelay; - if (delayTime >= PrevTimeActive) - return true;*/ - return false; } - bool InputAction::IsReleased(float maxDelayInSec) const + bool InputAction::IsReleased(float delaySecsMax) const { - float maxDelayInFrameTime = (maxDelayInSec == INFINITY) ? INFINITY : round(maxDelayInSec / DELTA_TIME); - return ((_value == 0.0f) && (_prevValue != 0.0f) && (_timeActive <= maxDelayInFrameTime)); + unsigned int delayGameFramesMax = (delaySecsMax == INFINITY) ? UINT_MAX : (unsigned int)round(delaySecsMax / DELTA_TIME); + return (_value == 0.0f && _prevValue != 0.0f && _timeActive <= delayGameFramesMax); } void InputAction::Update(bool value) @@ -81,34 +78,29 @@ namespace TEN::Input { UpdateValue(value); - // TODO: Because our delta time is a placeholder constant and we cannot properly account for time drift, - // count whole frames instead of actual time passed for now to avoid occasional stutter. - // Inquiry methods take this into account. -- Sezz 2022.10.01 - constexpr auto FRAME_TIME = 1.0f; - if (IsClicked()) { - _prevTimeActive = 0.0f; - _timeActive = 0.0f; - _timeInactive += FRAME_TIME;// DELTA_TIME; + _prevTimeActive = 0; + _timeActive = 0; + _timeInactive++; } else if (IsReleased()) { _prevTimeActive = _timeActive; - _timeActive += FRAME_TIME;// DELTA_TIME; - _timeInactive = 0.0f; + _timeActive++; + _timeInactive = 0; } else if (IsHeld()) { _prevTimeActive = _timeActive; - _timeActive += FRAME_TIME;// DELTA_TIME; - _timeInactive = 0.0f; + _timeActive++; + _timeInactive = 0; } else { - _prevTimeActive = 0.0f; - _timeActive = 0.0f; - _timeInactive += FRAME_TIME;// DELTA_TIME; + _prevTimeActive = 0; + _timeActive = 0; + _timeInactive++; } } @@ -116,13 +108,14 @@ namespace TEN::Input { _value = 0.0f; _prevValue = 0.0f; - _timeActive = 0.0f; - _prevTimeActive = 0.0f; - _timeInactive = 0.0f; + _timeActive = 0; + _prevTimeActive = 0; + _timeInactive = 0; } void InputAction::DrawDebug() const { + PrintDebugMessage("INPUT ACTION DEBUG"); PrintDebugMessage("ID: %d", (int)_id); PrintDebugMessage("IsClicked: %d", IsClicked()); PrintDebugMessage("IsHeld: %d", IsHeld()); @@ -131,9 +124,9 @@ namespace TEN::Input PrintDebugMessage(""); PrintDebugMessage("Value: %.3f", _value); PrintDebugMessage("PrevValue: %.3f", _prevValue); - PrintDebugMessage("TimeActive: %.3f", _timeActive); - PrintDebugMessage("PrevTimeActive: %.3f", _prevTimeActive); - PrintDebugMessage("TimeInactive: %.3f", _timeInactive); + PrintDebugMessage("TimeActive: %d", _timeActive); + PrintDebugMessage("PrevTimeActive: %d", _prevTimeActive); + PrintDebugMessage("TimeInactive: %d", _timeInactive); } void InputAction::UpdateValue(float value) diff --git a/TombEngine/Specific/Input/InputAction.h b/TombEngine/Specific/Input/InputAction.h index 3287b85c7..fc213f46c 100644 --- a/TombEngine/Specific/Input/InputAction.h +++ b/TombEngine/Specific/Input/InputAction.h @@ -2,7 +2,7 @@ namespace TEN::Input { - typedef enum class ActionID + typedef enum class InputActionID { // General actions @@ -63,33 +63,34 @@ namespace TEN::Input class InputAction { private: - // Members + // Fields - ActionID _id = In::Forward; - float _value = 0.0f; - float _prevValue = 0.0f; - float _timeActive = 0.0f; - float _prevTimeActive = 0.0f; - float _timeInactive = 0.0f; + InputActionID _id = In::Forward; + float _value = 0.0f; + float _prevValue = 0.0f; + unsigned int _timeActive = 0; + unsigned int _prevTimeActive = 0; + unsigned int _timeInactive = 0; public: // Constructors - InputAction(ActionID actionID); + InputAction() = default; + InputAction(InputActionID actionID); // Getters - ActionID GetID() const; - float GetValue() const; - float GetTimeActive() const; - float GetTimeInactive() const; + InputActionID GetID() const; + float GetValue() const; + unsigned int GetTimeActive() const; + unsigned int GetTimeInactive() const; // Inquirers bool IsClicked() const; - bool IsHeld(float delayInSec = 0.0f) const; - bool IsPulsed(float delayInSec, float initialDelayInSec = 0.0f) const; - bool IsReleased(float maxDelayInSec = INFINITY) const; + bool IsHeld(float delaySecs = 0.0f) const; + bool IsPulsed(float delaySecs, float initialDelaySecs = 0.0f) const; + bool IsReleased(float delaySecsMax = INFINITY) const; // Utilities diff --git a/TombEngine/Specific/Input/Keys.cpp b/TombEngine/Specific/Input/Keys.cpp new file mode 100644 index 000000000..c2c783c59 --- /dev/null +++ b/TombEngine/Specific/Input/Keys.cpp @@ -0,0 +1,181 @@ +#include "framework.h" +#include "Specific/Input/Keys.h" + +#include +#include + +using namespace OIS; + +namespace TEN::Input +{ + static const auto KEY_NAME_MAP = std::unordered_map + { + { KC_UNASSIGNED, "" }, + + // Keyboard keys + { KC_ESCAPE, "Esc" }, + { KC_1, "1" }, + { KC_2, "2" }, + { KC_3, "3" }, + { KC_4, "4" }, + { KC_5, "5" }, + { KC_6, "6" }, + { KC_7, "7" }, + { KC_8, "8" }, + { KC_9, "9" }, + { KC_0, "0" }, + { KC_MINUS, "-" }, + { KC_EQUALS, "+" }, + { KC_BACK, "Back" }, + { KC_TAB, "Tab" }, + { KC_Q, "Q" }, + { KC_W, "W" }, + { KC_E, "E" }, + { KC_R, "R" }, + { KC_T, "T" }, + { KC_Y, "Y" }, + { KC_U, "U" }, + { KC_I, "I" }, + { KC_O, "O" }, + { KC_P, "P" }, + { KC_LBRACKET, "[" }, + { KC_RBRACKET, "]" }, + { KC_RETURN, "Enter" }, + { KC_LCONTROL, "Ctrl" }, + { KC_A, "A" }, + { KC_S, "S" }, + { KC_D, "D" }, + { KC_F, "F" }, + { KC_G, "G" }, + { KC_H, "H" }, + { KC_J, "J" }, + { KC_K, "K" }, + { KC_L, "L" }, + { KC_SEMICOLON, ";" }, + { KC_APOSTROPHE, "'" }, + { KC_GRAVE, "`" }, + { KC_LSHIFT, "Shift" }, + { KC_BACKSLASH, "Back Slash" }, + { KC_Z, "Z" }, + { KC_X, "X" }, + { KC_C, "C" }, + { KC_V, "V" }, + { KC_B, "B" }, + { KC_N, "N" }, + { KC_M, "M" }, + { KC_COMMA, "," }, + { KC_PERIOD, "." }, + { KC_SLASH, "/" }, + { KC_RSHIFT, "Shift" }, + { KC_MULTIPLY, "Pad X" }, + { KC_LMENU, "Alt" }, + { KC_SPACE, "Space" }, + { KC_CAPITAL, "Caps Lock" }, + { KC_F1, "F1" }, + { KC_F2, "F2" }, + { KC_F3, "F3" }, + { KC_F4, "F4" }, + { KC_F5, "F5" }, + { KC_F6, "F6" }, + { KC_F7, "F7" }, + { KC_F8, "F8" }, + { KC_F9, "F9" }, + { KC_F10, "F10" }, + { KC_NUMLOCK, "Num Lock" }, + { KC_SCROLL, "Scroll Lock" }, + { KC_NUMPAD7, "Pad 7" }, + { KC_NUMPAD8, "Pad 8" }, + { KC_NUMPAD9, "Pad 9" }, + { KC_SUBTRACT, "Pad -" }, + { KC_NUMPAD4, "Pad 4" }, + { KC_NUMPAD5, "Pad 5" }, + { KC_NUMPAD6, "Pad 6" }, + { KC_ADD, "Pad +" }, + { KC_NUMPAD1, "Pad 1" }, + { KC_NUMPAD2, "Pad 2" }, + { KC_NUMPAD3, "Pad 3" }, + { KC_NUMPAD0, "Pad 0" }, + { KC_DECIMAL, "Pad ." }, + { KC_OEM_102, "\\" }, + { KC_F11, "F11" }, + { KC_F12, "F12" }, + { KC_NUMPADENTER, "Pad Enter" }, + { KC_RCONTROL, "Ctrl" }, + { KC_DIVIDE, "Pad /" }, + { KC_RMENU, "Alt" }, + { KC_HOME, "Home" }, + { KC_UP, "Up" }, + { KC_PGUP, "Page Up" }, + { KC_LEFT, "Left" }, + { KC_RIGHT, "Right" }, + { KC_END, "End" }, + { KC_DOWN, "Down" }, + { KC_PGDOWN, "Page Down" }, + { KC_INSERT, "Insert" }, + { KC_DELETE, "Del" }, + + // Mouse keys + { MK_LCLICK, "Left-Click" }, + { MK_RCLICK, "Right-Click" }, + { MK_MCLICK, "Middle-Click" }, + { MK_BUTTON_4, "Mouse 4" }, + { MK_BUTTON_5, "Mouse 5" }, + { MK_BUTTON_6, "Mouse 6" }, + { MK_BUTTON_7, "Mouse 7" }, + { MK_BUTTON_8, "Mouse 8" }, + { MK_AXIS_X_NEG, "Mouse X-" }, + { MK_AXIS_X_POS, "Mouse X+" }, + { MK_AXIS_Y_NEG, "Mouse Y-" }, + { MK_AXIS_Y_POS, "Mouse Y+" }, + { MK_AXIS_Z_NEG, "Mouse Z-" }, + { MK_AXIS_Z_POS, "Mouse Z+" }, + + // Gamepad keys + // TODO: Find a way to display XBox controller keys when using that controller type. + { GK_BUTTON_1, "Gamepad 1" }, + { GK_BUTTON_2, "Gamepad 2" }, + { GK_BUTTON_3, "Gamepad 3" }, + { GK_BUTTON_4, "Gamepad 4" }, + { GK_BUTTON_5, "Gamepad 5" }, + { GK_BUTTON_6, "Gamepad 6" }, + { GK_BUTTON_7, "Gamepad 7" }, + { GK_BUTTON_8, "Gamepad 8" }, + { GK_BUTTON_9, "Gamepad 9" }, + { GK_BUTTON_10, "Gamepad 10" }, + { GK_BUTTON_11, "Gamepad 11" }, + { GK_BUTTON_12, "Gamepad 12" }, + { GK_BUTTON_13, "Gamepad 13" }, + { GK_BUTTON_14, "Gamepad 14" }, + { GK_BUTTON_15, "Gamepad 15" }, + { GK_BUTTON_16, "Gamepad 16" }, + { GK_AXIS_X_NEG, "Stick X-" }, + { GK_AXIS_X_POS, "Stick X+" }, + { GK_AXIS_Y_NEG, "Stick Y-" }, + { GK_AXIS_Y_POS, "Stick Y+" }, + { GK_AXIS_Z_NEG, "Stick Z-" }, + { GK_AXIS_Z_POS, "Stick Z+" }, + { GK_AXIS_W_NEG, "Stick W-" }, + { GK_AXIS_W_POS, "Stick W+" }, + { GK_AXIS_L_TRIGGER_1, "Left Trigger 1" }, + { GK_AXIS_L_TRIGGER_2, "Left Trigger 2" }, + { GK_AXIS_R_TRIGGER_1, "Right Trigger 1" }, + { GK_AXIS_R_TRIGGER_2, "Right Trigger 2" }, + { GK_DPAD_UP, "D-Pad Up" }, + { GK_DPAD_DOWN, "D-Pad Down" }, + { GK_DPAD_LEFT, "D-Pad Left" }, + { GK_DPAD_RIGHT, "D-Pad Right" } + }; + + const std::string& GetKeyName(int keyID) + { + // Find and return key name. + auto it = KEY_NAME_MAP.find(keyID); + if (it != KEY_NAME_MAP.end()) + { + const auto& [keyID, name] = *it; + return name; + } + + return KEY_NAME_MAP.at(KC_UNASSIGNED); + } +} diff --git a/TombEngine/Specific/Input/Keys.h b/TombEngine/Specific/Input/Keys.h new file mode 100644 index 000000000..5fc86a6b7 --- /dev/null +++ b/TombEngine/Specific/Input/Keys.h @@ -0,0 +1,126 @@ +#pragma once + +namespace TEN::Input +{ + constexpr auto KEYBOARD_KEY_COUNT = 256; + constexpr auto MOUSE_BUTTON_COUNT = 8; + constexpr auto MOUSE_AXIS_COUNT = 3; + constexpr auto GAMEPAD_BUTTON_COUNT = 16; + constexpr auto GAMEPAD_AXIS_COUNT = 6; + constexpr auto GAMEPAD_POV_AXIS_COUNT = 4; + + constexpr auto KEY_COUNT = KEYBOARD_KEY_COUNT + + MOUSE_BUTTON_COUNT + (MOUSE_AXIS_COUNT * 2) + + GAMEPAD_BUTTON_COUNT + (GAMEPAD_AXIS_COUNT * 2) + GAMEPAD_POV_AXIS_COUNT; + + constexpr auto KEY_OFFSET_MOUSE = KEYBOARD_KEY_COUNT; + constexpr auto KEY_OFFSET_GAMEPAD = KEY_OFFSET_MOUSE + (MOUSE_BUTTON_COUNT + (MOUSE_AXIS_COUNT * 2)); + + // Mouse + // 8 buttons + (3 * 2) axes. + enum MouseKey + { + // Buttons + MK_LCLICK = KEY_OFFSET_MOUSE, + MK_RCLICK, + MK_MCLICK, + MK_BUTTON_4, + MK_BUTTON_5, + MK_BUTTON_6, + MK_BUTTON_7, + MK_BUTTON_8, + + // Axes + MK_AXIS_X_NEG, + MK_AXIS_X_POS, + MK_AXIS_Y_NEG, + MK_AXIS_Y_POS, + MK_AXIS_Z_NEG, + MK_AXIS_Z_POS + }; + + // Gamepad + // 16 buttons + (6 * 2) axes + 4 POV axes. + enum GamepadKey + { + // Buttons + GK_BUTTON_1 = KEY_OFFSET_GAMEPAD, + GK_BUTTON_2, + GK_BUTTON_3, + GK_BUTTON_4, + GK_BUTTON_5, + GK_BUTTON_6, + GK_BUTTON_7, + GK_BUTTON_8, + GK_BUTTON_9, + GK_BUTTON_10, + GK_BUTTON_11, + GK_BUTTON_12, + GK_BUTTON_13, + GK_BUTTON_14, + GK_BUTTON_15, + GK_BUTTON_16, + + // Axes + GK_AXIS_X_NEG, + GK_AXIS_X_POS, + GK_AXIS_Y_NEG, + GK_AXIS_Y_POS, + GK_AXIS_Z_NEG, + GK_AXIS_Z_POS, + GK_AXIS_W_NEG, + GK_AXIS_W_POS, + GK_AXIS_L_TRIGGER_1, + GK_AXIS_L_TRIGGER_2, + GK_AXIS_R_TRIGGER_1, + GK_AXIS_R_TRIGGER_2, + + // POV axes + GK_DPAD_UP, + GK_DPAD_DOWN, + GK_DPAD_LEFT, + GK_DPAD_RIGHT + }; + + // XBox Controller (GamepadKey mirror). + // 11 buttons + (6 * 2) axes + 4 POV axes. + enum XInputKey + { + // Buttons + XK_START = GK_BUTTON_1, + XK_SELECT, + XK_L_STICK, + XK_R_STICK, + XK_L_SHIFT, + XK_R_SHIFT, + XK_UNUSED_1, + XK_UNUSED_2, + XK_A, + XK_B, + XK_X, + XK_Y, + XK_LOGO, + + // Axes + XK_AXIS_X_POS = GK_AXIS_X_NEG, + XK_AXIS_X_NEG, + XK_AXIS_Y_POS, + XK_AXIS_Y_NEG, + XK_AXIS_Z_POS, + XK_AXIS_Z_NEG, + XK_AXIS_W_POS, + XK_AXIS_W_NEG, + XK_AXIS_L_TRIGGER_NEG, + XK_AXIS_L_TRIGGER_POS, + XK_AXIS_R_TRIGGER_NEG, + XK_AXIS_R_TRIGGER_POS, + + // POV axes + XK_DPAD_UP, + XK_DPAD_DOWN, + XK_DPAD_LEFT, + XK_DPAD_RIGHT + }; + + const std::string& GetKeyName(int keyID); +} diff --git a/TombEngine/Specific/configuration.cpp b/TombEngine/Specific/configuration.cpp index 188bbd75d..754ac37d4 100644 --- a/TombEngine/Specific/configuration.cpp +++ b/TombEngine/Specific/configuration.cpp @@ -268,14 +268,16 @@ bool SaveConfiguration() return false; } + if (g_Configuration.Bindings.empty()) + g_Configuration.Bindings = BindingManager::DEFAULT_KEYBOARD_MOUSE_BINDING_PROFILE; + // Set Input binding keys. - g_Configuration.Bindings.resize((int)In::Count); - for (int i = 0; i < (int)In::Count; i++) + for (int i = 0; i < (int)InputActionID::Count; i++) { char buffer[9]; sprintf(buffer, "Action%d", i); - if (SetDWORDRegKey(inputKey, buffer, g_Configuration.Bindings[i]) != ERROR_SUCCESS) + if (SetDWORDRegKey(inputKey, buffer, g_Configuration.Bindings.at((InputActionID)i)) != ERROR_SUCCESS) { RegCloseKey(rootKey); RegCloseKey(graphicsKey); @@ -465,13 +467,16 @@ bool LoadConfiguration() return false; } - for (int i = 0; i < (int)In::Count; i++) + for (int i = 0; i < (int)InputActionID::Count; i++) { - DWORD tempAction = 0; + DWORD tempKeyID = 0; char buffer[9]; sprintf(buffer, "Action%d", i); - if (GetDWORDRegKey(inputKey, buffer, &tempAction, Bindings[0][i]) != ERROR_SUCCESS) + auto actionID = (InputActionID)i; + int boundKeyID = g_Bindings.GetBoundKeyID(InputDeviceID::Default, actionID); + + if (GetDWORDRegKey(inputKey, buffer, &tempKeyID, boundKeyID) != ERROR_SUCCESS) { RegCloseKey(rootKey); RegCloseKey(graphicsKey); @@ -481,16 +486,16 @@ bool LoadConfiguration() return false; } - g_Configuration.Bindings.push_back(tempAction); - Bindings[1][i] = tempAction; + g_Configuration.Bindings.insert({ (InputActionID)i, tempKeyID }); + g_Bindings.SetKeyBinding(InputDeviceID::Custom, actionID, tempKeyID); } RegCloseKey(inputKey); } + // Input key doesn't exist; use default bindings. else { - // "Input" key does not exist; use default bindings. - g_Configuration.Bindings = Bindings[0]; + g_Configuration.Bindings = g_Bindings.GetBindingProfile(InputDeviceID::Default); } RegCloseKey(rootKey); @@ -502,10 +507,10 @@ bool LoadConfiguration() g_Configuration.ScreenWidth = screenWidth; g_Configuration.ScreenHeight = screenHeight; g_Configuration.EnableWindowedMode = enableWindowedMode; - g_Configuration.ShadowType = ShadowMode(shadowMode); + g_Configuration.ShadowType = (ShadowMode)shadowMode; g_Configuration.ShadowBlobsMax = shadowBlobsMax; g_Configuration.EnableCaustics = enableCaustics; - g_Configuration.AntialiasingMode = AntialiasingMode(antialiasingMode); + g_Configuration.AntialiasingMode = (AntialiasingMode)antialiasingMode; g_Configuration.ShadowMapSize = shadowMapSize; g_Configuration.EnableAmbientOcclusion = enableAmbientOcclusion; g_Configuration.EnableHighFramerate = enableHighFramerate; @@ -582,7 +587,6 @@ LONG GetBoolRegKey(HKEY hKey, LPCSTR strValueName, bool* bValue, bool bDefaultVa return nError; } - LONG GetStringRegKey(HKEY hKey, LPCSTR strValueName, char** strValue, char* strDefaultValue) { *strValue = strDefaultValue; diff --git a/TombEngine/Specific/configuration.h b/TombEngine/Specific/configuration.h index 51f70ca4e..0d6ab6cea 100644 --- a/TombEngine/Specific/configuration.h +++ b/TombEngine/Specific/configuration.h @@ -8,7 +8,7 @@ using namespace TEN::Math; // Directories -constexpr auto REGKEY_ROOT = "Software\\TombEngine\\1.1.0"; +constexpr auto REGKEY_ROOT = "Software\\TombEngine\\1.7.0"; constexpr auto REGKEY_GRAPHICS = "Graphics"; constexpr auto REGKEY_SOUND = "Sound"; constexpr auto REGKEY_GAMEPLAY = "Gameplay"; @@ -93,10 +93,9 @@ struct GameConfiguration bool EnableThumbstickCamera = false; // Input - int MouseSensitivity = DEFAULT_MOUSE_SENSITIVITY; MenuOptionLoopingMode MenuOptionLoopingMode = MenuOptionLoopingMode::SaveLoadOnly; - std::vector Bindings = {}; + BindingProfile Bindings = {}; std::vector SupportedScreenResolutions = {}; std::string AdapterName = {}; diff --git a/TombEngine/TombEngine.vcxproj b/TombEngine/TombEngine.vcxproj index 567871c78..d60786780 100644 --- a/TombEngine/TombEngine.vcxproj +++ b/TombEngine/TombEngine.vcxproj @@ -948,6 +948,8 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. + + @@ -1373,8 +1375,10 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. + + From b3b8b73c5535e47015ac548f6dd0c31e7ea3e22e Mon Sep 17 00:00:00 2001 From: iagoesp <32596872+iagoesp@users.noreply.github.com> Date: Sat, 8 Mar 2025 08:39:24 -0300 Subject: [PATCH 013/160] Sort Screenshots by YYYYMMDD #1372 (#1599) * Sort screenshots by YYYYMMDD (#1372) * Sort screenshots by YYYYMMDD (#1372) * Fixes --------- Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com> --- TombEngine/Renderer/RendererHelper.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TombEngine/Renderer/RendererHelper.cpp b/TombEngine/Renderer/RendererHelper.cpp index 671d41bda..cefc7879d 100644 --- a/TombEngine/Renderer/RendererHelper.cpp +++ b/TombEngine/Renderer/RendererHelper.cpp @@ -619,7 +619,7 @@ namespace TEN::Renderer time(&rawtime); auto time = localtime(&rawtime); - strftime(buffer, sizeof(buffer), "/TEN-%d-%m-%Y-%H-%M-%S.png", time); + strftime(buffer, sizeof(buffer), "/TEN-%Y-%m-%d_%H-%M-%S.png", time); auto screenPath = g_GameFlow->GetGameDir() + "Screenshots"; From ba99f41fa003853e71f242f4b37aa3c37ecb4544 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 8 Mar 2025 13:53:51 +0100 Subject: [PATCH 014/160] Update version.h --- TombEngine/version.h | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/TombEngine/version.h b/TombEngine/version.h index 59a420922..e012d5156 100644 --- a/TombEngine/version.h +++ b/TombEngine/version.h @@ -1,13 +1,13 @@ #pragma once #define TE_MAJOR_VERSION 1 -#define TE_MINOR_VERSION 7 -#define TE_BUILD_NUMBER 5 +#define TE_MINOR_VERSION 8 +#define TE_BUILD_NUMBER 0 #define TE_REVISION_NUMBER 0 #define TEN_MAJOR_VERSION 1 #define TEN_MINOR_VERSION 7 -#define TEN_BUILD_NUMBER 2 +#define TEN_BUILD_NUMBER 3 #define TEN_REVISION_NUMBER 0 #define TEST_BUILD 1 From e54fba1e4a12de274b8f9e015d4b6a9452f8d3f2 Mon Sep 17 00:00:00 2001 From: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Sat, 8 Mar 2025 22:45:25 -0500 Subject: [PATCH 015/160] Advanced particles (#1555) * Update to bug report form * Update bug_report.yaml * Update AUTHORS.md - Tomo (general coding, special FX coding, bug fixing) * Update CHANGELOG.md * Update CHANGELOG.md * Update bug_report.yaml * Expose ObjectSlot * Docs * Code Update * FinalPush * Update CHANGELOG.md * Update CHANGELOG.md * Update CHANGELOG.md * Expose startRot * Expose startRot * Remove Space. * FirstCommit * Cast gameobj to int * Update * WIP * WIP * wip * Checks * WIP * WIP * WIP * Enum * Enum revision * Update CHANGELOG.md * Revisions due to Develop changes * CodeCleanup * Revision to Code as per revised structure. * Add friction and YVel * Revisions * LUA Docs * RevisionDocs * x * Revisions * Docs * Docs * Docs * Docs * Make wind default * Light effect * LightFinish * Added Sounds * Add sound docs * Update particle anim types file * Update EffectsFunctions.cpp * Update EffectsFunctions.cpp * FixAngle * Fix StartRot * Cleanup * Add Savegame fields * Add loadgame data. * Fix bug on develop related to save value of xVel * Address Comments --------- Co-authored-by: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Co-authored-by: Nemoel-Tomo Co-authored-by: Jakub Co-authored-by: Jakub <80340234+Jakub768@users.noreply.github.com> Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com> Co-authored-by: Sezz --- CHANGELOG.md | 2 + Documentation/doc/1 modules/Effects.html | 222 ++++++++++++++++++ Documentation/doc/1 modules/Flow.html | 1 + Documentation/doc/1 modules/Input.html | 1 + Documentation/doc/1 modules/Inventory.html | 1 + Documentation/doc/1 modules/Logic.html | 1 + Documentation/doc/1 modules/Objects.html | 1 + Documentation/doc/1 modules/Sound.html | 1 + Documentation/doc/1 modules/Strings.html | 1 + Documentation/doc/1 modules/Util.html | 1 + Documentation/doc/1 modules/View.html | 1 + Documentation/doc/2 classes/Flow.Level.html | 1 + .../doc/2 classes/Flow.Settings.html | 1 + .../doc/2 classes/Flow.Statistics.html | 1 + .../doc/2 classes/Objects.AIObject.html | 1 + .../doc/2 classes/Objects.Camera.html | 1 + .../doc/2 classes/Objects.LaraObject.html | 1 + .../doc/2 classes/Objects.Moveable.html | 1 + Documentation/doc/2 classes/Objects.Room.html | 1 + Documentation/doc/2 classes/Objects.Sink.html | 1 + .../doc/2 classes/Objects.SoundSource.html | 1 + .../doc/2 classes/Objects.Static.html | 1 + .../doc/2 classes/Objects.Volume.html | 1 + .../doc/2 classes/Strings.DisplayString.html | 1 + .../doc/2 classes/View.DisplaySprite.html | 1 + .../doc/3 primitive classes/Color.html | 1 + .../doc/3 primitive classes/Flow.Fog.html | 1 + .../Flow.InventoryItem.html | 1 + .../3 primitive classes/Flow.LensFlare.html | 1 + .../3 primitive classes/Flow.SkyLayer.html | 1 + .../3 primitive classes/Flow.Starfield.html | 1 + .../doc/3 primitive classes/Rotation.html | 1 + .../doc/3 primitive classes/Time.html | 1 + .../doc/3 primitive classes/Vec2.html | 1 + .../doc/3 primitive classes/Vec3.html | 1 + .../doc/4 enums/Effects.BlendID.html | 1 + .../doc/4 enums/Effects.EffectID.html | 1 + .../Effects.ParticleAnimationType.html | 169 +++++++++++++ Documentation/doc/4 enums/Flow.ErrorMode.html | 1 + .../doc/4 enums/Flow.FreezeMode.html | 1 + .../doc/4 enums/Flow.GameStatus.html | 1 + Documentation/doc/4 enums/Input.ActionID.html | 1 + .../doc/4 enums/Objects.AmmoType.html | 1 + .../doc/4 enums/Objects.HandStatus.html | 1 + .../doc/4 enums/Objects.MoveableStatus.html | 1 + Documentation/doc/4 enums/Objects.ObjID.html | 1 + .../doc/4 enums/Objects.RoomFlagID.html | 1 + .../doc/4 enums/Objects.RoomReverb.html | 1 + .../doc/4 enums/Objects.WeaponType.html | 1 + .../doc/4 enums/Sound.SoundTrackType.html | 1 + .../4 enums/Strings.DisplayStringOption.html | 1 + Documentation/doc/4 enums/Util.LogLevel.html | 1 + Documentation/doc/4 enums/View.AlignMode.html | 1 + .../doc/4 enums/View.CameraType.html | 1 + .../doc/4 enums/View.PostProcessMode.html | 1 + Documentation/doc/4 enums/View.ScaleMode.html | 1 + .../doc/5 lua utility modules/Diary.html | 1 + .../5 lua utility modules/EventSequence.html | 1 + .../doc/5 lua utility modules/Timer.html | 1 + .../doc/5 lua utility modules/Type.html | 1 + Documentation/doc/index.html | 5 + TombEngine/Game/effects/effects.cpp | 135 ++++++++++- TombEngine/Game/effects/effects.h | 27 ++- TombEngine/Game/savegame.cpp | 17 +- .../Scripting/Internal/ReservedScriptNames.h | 2 + .../Scripting/Internal/TEN/Effects/BlendIDs.h | 36 +-- .../Internal/TEN/Effects/EffectIDs.h | 37 +-- .../Internal/TEN/Effects/EffectsFunctions.cpp | 195 ++++++++++++++- .../Internal/TEN/Effects/ParticleAnimTypes.h | 27 +++ .../flatbuffers/ten_savegame_generated.h | 104 +++++++- .../Specific/savegame/schema/ten_savegame.fbs | 7 + TombEngine/TombEngine.vcxproj | 1 + 72 files changed, 993 insertions(+), 50 deletions(-) create mode 100644 Documentation/doc/4 enums/Effects.ParticleAnimationType.html create mode 100644 TombEngine/Scripting/Internal/TEN/Effects/ParticleAnimTypes.h diff --git a/CHANGELOG.md b/CHANGELOG.md index 22f615177..a3e15fe19 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -29,6 +29,8 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): - You must use this version: https://github.com/TombEngine/Resources/raw/refs/heads/main/Wad2%20Objects/Interactables/TEN_Waterfall_Emitter.wad2 ### Lua API changes + +* Implemented advanced particles allowing animations and other effects. * Added Collision.Probe class for basic room collision detection. * Added diary module. * Added View.GetFlyByPosition() and View.GetFlyByRotation() functions to get flyby sequence parameters at a specified time point. diff --git a/Documentation/doc/1 modules/Effects.html b/Documentation/doc/1 modules/Effects.html index 668142f9b..209a34899 100644 --- a/Documentation/doc/1 modules/Effects.html +++ b/Documentation/doc/1 modules/Effects.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • @@ -128,6 +129,10 @@ Emit a particle. + EmitAdvancedParticle(particleData) + Emit a particle with extensive configuration options including animations. + + EmitShockwave(pos, innerRadius, outerRadius, color, lifetime, speed, angle, hurtsLara) Emit a shockwave, similar to that seen when a harpy projectile hits something. @@ -164,6 +169,13 @@ Get the wind vector for the current game frame. +

    Tables

    + + + + + +
    particleDataStructure for EmitAdvancedParticle table.


    @@ -327,6 +339,61 @@ ) + +
    + + EmitAdvancedParticle(particleData) +
    +
    + Emit a particle with extensive configuration options including animations. + + + +

    Parameters:

    +
      +
    • particleData + particleData + The table holding all the particle data. +
      • +
    + + + + +

    Usage:

    +
      + 
      local particle = {
+position = GetMoveableByName("camera_target_6") :GetPosition(),
+velocity = Vec3(0, 0, 10),
+objectID = TEN.Objects.ObjID.CUSTOM_BAR_GRAPHIC,
+spriteIndex = 0,
+lifetime = 10,
+maxYVelocity = 0,
+gravity = 0,
+friction = 10,
+startRotation = 0,
+rotationSpeed = 0,
+startSize = 80,
+endSize = 80,
+wind = false,
+startColor = TEN.Color(128, 128, 128),
+endColor = TEN.Color(128, 128, 128),
+blendMode = TEN.Effects.BlendID.ADDITIVE,
+damage = true,
+poison = false,
+burn = false,
+damageHit = 80,
+sound = 197,
+light = true,
+lightRadius = 6,
+lightFlicker = 5,
+animated = true,
+frameRate = .25,
+animationType = TEN.Effects.ParticleAnimationType.LOOP,
+}
+EmitAdvancedParticle(particle)
      +
    +
    @@ -641,6 +708,161 @@ + + +

    Tables

    + +
    +
    + + particleData +
    +
    + Structure for EmitAdvancedParticle table. + + + +

    Fields:

    +
      +
    • position + Vec3 + World position. +
      • +
    • velocity + Vec3 + Velocity. +
      • +
    • spriteSeqID + ObjID + ID of the sprite sequence object. Default: Objects.ObjID.DEFAULT_SPRITES + (optional) +
      • +
    • spriteIndex + int + ID of the sprite in the sprite sequence object.Default: 0 + (optional) +
      • +
    • lifetime + float + Lifespan in seconds. Default: 2 + (optional) +
      • +
    • maxYVelocity + float + Specifies ithe maximum Y velocity for the particle. Default: 0 + (optional) +
      • +
    • gravity + float + Specifies if the particle will fall over time. Positive values ascend, negative values descend. Recommended range: [-1000 and 1000]. Default: 0 + (optional) +
      • +
    • friction + float + Specifies the friction with which the particle will slow down over time. Default: 0 + (optional) +
      • +
    • startRot + float + Rotation at start of life. Default: random + (optional) +
      • +
    • rotationSpeed + float + Rotational velocity in degrees. Default: 0 + (optional) +
      • +
    • startSize + float + Size at start of life. Default: 10 + (optional) +
      • +
    • endSize + float + Size at end of life. The particle will linearly shrink or grow toward this size over its lifespan. Default: 0 + (optional) +
      • +
    • startColor + Color + Color at start of life. Default: Color(255, 255, 255) + (optional) +
      • +
    • endColor + Color + Color to fade toward. This will finish long before the end of the particle's life due to internal math. Default: Color(255, 255, 255) + (optional) +
      • +
    • blendMode + BlendID + Render blend mode. TEN.Effects.BlendID.ALPHABLEND + (optional) +
      • +
    • damage + bool + Specify if the particle will harm the player on collision. Default: false + (optional) +
      • +
    • poison + bool + Specify if the particle will poison the player on collision. Default: false + (optional) +
      • +
    • burn + bool + Specify if the particle will burn the player on collision. Default: false + (optional) +
      • +
    • wind + bool + Specify if the particle will be affected by wind in outside rooms. Default: false + (optional) +
      • +
    • damageHit + int + Specify the damage particle will harm the player on collision. Default: 2 + (optional) +
      • +
    • light + bool + Specify if the particle will be emit a light based on its color. Recommended for single particles. Default: false + (optional) +
      • +
    • lightRadius + int + measured in "clicks" or 256 world units. Default: 0 + (optional) +
      • +
    • lightFlicker + int + The interval at which light should flicker. Default: 0 + (optional) +
      • +
    • sound + int + ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. Looping sounds recommended. Default: None + (optional) +
      • +
    • animated + bool + Specify if the particle will be animated. Default: false + (optional) +
      • +
    • animationType + ParticleAnimationType + Specify the the type of animation the particle will use. Default: TEN.Effects.ParticleAnimationType.LOOP + (optional) +
      • +
    • frameRate + float + The framerate with which the particle will be animated. Default: 1 + (optional) +
      • +
    + + + + +
    diff --git a/Documentation/doc/1 modules/Flow.html b/Documentation/doc/1 modules/Flow.html index 743e3d7c8..abcade863 100644 --- a/Documentation/doc/1 modules/Flow.html +++ b/Documentation/doc/1 modules/Flow.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/1 modules/Input.html b/Documentation/doc/1 modules/Input.html index 4d1f5dffc..c0f0cd2a5 100644 --- a/Documentation/doc/1 modules/Input.html +++ b/Documentation/doc/1 modules/Input.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/1 modules/Inventory.html b/Documentation/doc/1 modules/Inventory.html index ceac41649..31aecad31 100644 --- a/Documentation/doc/1 modules/Inventory.html +++ b/Documentation/doc/1 modules/Inventory.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/1 modules/Logic.html b/Documentation/doc/1 modules/Logic.html index 1842572d2..76b468fc5 100644 --- a/Documentation/doc/1 modules/Logic.html +++ b/Documentation/doc/1 modules/Logic.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/1 modules/Objects.html b/Documentation/doc/1 modules/Objects.html index 032f9dc95..70bcf0bcd 100644 --- a/Documentation/doc/1 modules/Objects.html +++ b/Documentation/doc/1 modules/Objects.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/1 modules/Sound.html b/Documentation/doc/1 modules/Sound.html index b621dbddd..3c99ddf06 100644 --- a/Documentation/doc/1 modules/Sound.html +++ b/Documentation/doc/1 modules/Sound.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/1 modules/Strings.html b/Documentation/doc/1 modules/Strings.html index 519476f74..c06056aa6 100644 --- a/Documentation/doc/1 modules/Strings.html +++ b/Documentation/doc/1 modules/Strings.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/1 modules/Util.html b/Documentation/doc/1 modules/Util.html index caf818c90..ad694660f 100644 --- a/Documentation/doc/1 modules/Util.html +++ b/Documentation/doc/1 modules/Util.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/1 modules/View.html b/Documentation/doc/1 modules/View.html index ece60eef2..7bf9188e6 100644 --- a/Documentation/doc/1 modules/View.html +++ b/Documentation/doc/1 modules/View.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/2 classes/Flow.Level.html b/Documentation/doc/2 classes/Flow.Level.html index 8f69753ca..baae8e3c7 100644 --- a/Documentation/doc/2 classes/Flow.Level.html +++ b/Documentation/doc/2 classes/Flow.Level.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/2 classes/Flow.Settings.html b/Documentation/doc/2 classes/Flow.Settings.html index 36f4ba00e..50f234fad 100644 --- a/Documentation/doc/2 classes/Flow.Settings.html +++ b/Documentation/doc/2 classes/Flow.Settings.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/2 classes/Flow.Statistics.html b/Documentation/doc/2 classes/Flow.Statistics.html index 4762489e3..feede1263 100644 --- a/Documentation/doc/2 classes/Flow.Statistics.html +++ b/Documentation/doc/2 classes/Flow.Statistics.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/2 classes/Objects.AIObject.html b/Documentation/doc/2 classes/Objects.AIObject.html index d3b18255a..faa3040c3 100644 --- a/Documentation/doc/2 classes/Objects.AIObject.html +++ b/Documentation/doc/2 classes/Objects.AIObject.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/2 classes/Objects.Camera.html b/Documentation/doc/2 classes/Objects.Camera.html index 4778fdf51..46fd73e74 100644 --- a/Documentation/doc/2 classes/Objects.Camera.html +++ b/Documentation/doc/2 classes/Objects.Camera.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/2 classes/Objects.LaraObject.html b/Documentation/doc/2 classes/Objects.LaraObject.html index dbd6ea34a..415031c0c 100644 --- a/Documentation/doc/2 classes/Objects.LaraObject.html +++ b/Documentation/doc/2 classes/Objects.LaraObject.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/2 classes/Objects.Moveable.html b/Documentation/doc/2 classes/Objects.Moveable.html index 12a13bef8..d97814d6d 100644 --- a/Documentation/doc/2 classes/Objects.Moveable.html +++ b/Documentation/doc/2 classes/Objects.Moveable.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/2 classes/Objects.Room.html b/Documentation/doc/2 classes/Objects.Room.html index d9588a12a..bc3b6af33 100644 --- a/Documentation/doc/2 classes/Objects.Room.html +++ b/Documentation/doc/2 classes/Objects.Room.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/2 classes/Objects.Sink.html b/Documentation/doc/2 classes/Objects.Sink.html index 9ec996ac9..7c536f0f3 100644 --- a/Documentation/doc/2 classes/Objects.Sink.html +++ b/Documentation/doc/2 classes/Objects.Sink.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/2 classes/Objects.SoundSource.html b/Documentation/doc/2 classes/Objects.SoundSource.html index 34d46d407..f1b7a4c60 100644 --- a/Documentation/doc/2 classes/Objects.SoundSource.html +++ b/Documentation/doc/2 classes/Objects.SoundSource.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/2 classes/Objects.Static.html b/Documentation/doc/2 classes/Objects.Static.html index 11a877ac2..4460c6691 100644 --- a/Documentation/doc/2 classes/Objects.Static.html +++ b/Documentation/doc/2 classes/Objects.Static.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/2 classes/Objects.Volume.html b/Documentation/doc/2 classes/Objects.Volume.html index fad783f63..354cd3d8b 100644 --- a/Documentation/doc/2 classes/Objects.Volume.html +++ b/Documentation/doc/2 classes/Objects.Volume.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/2 classes/Strings.DisplayString.html b/Documentation/doc/2 classes/Strings.DisplayString.html index c4c42536d..e71333641 100644 --- a/Documentation/doc/2 classes/Strings.DisplayString.html +++ b/Documentation/doc/2 classes/Strings.DisplayString.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/2 classes/View.DisplaySprite.html b/Documentation/doc/2 classes/View.DisplaySprite.html index 28b4952ab..3c8f3a4ae 100644 --- a/Documentation/doc/2 classes/View.DisplaySprite.html +++ b/Documentation/doc/2 classes/View.DisplaySprite.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/3 primitive classes/Color.html b/Documentation/doc/3 primitive classes/Color.html index e89893395..670bf1ecf 100644 --- a/Documentation/doc/3 primitive classes/Color.html +++ b/Documentation/doc/3 primitive classes/Color.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/3 primitive classes/Flow.Fog.html b/Documentation/doc/3 primitive classes/Flow.Fog.html index 43f300c68..0d90aedad 100644 --- a/Documentation/doc/3 primitive classes/Flow.Fog.html +++ b/Documentation/doc/3 primitive classes/Flow.Fog.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/3 primitive classes/Flow.InventoryItem.html b/Documentation/doc/3 primitive classes/Flow.InventoryItem.html index ac010c2e2..572b9c683 100644 --- a/Documentation/doc/3 primitive classes/Flow.InventoryItem.html +++ b/Documentation/doc/3 primitive classes/Flow.InventoryItem.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/3 primitive classes/Flow.LensFlare.html b/Documentation/doc/3 primitive classes/Flow.LensFlare.html index 3962571f2..177dc8fc3 100644 --- a/Documentation/doc/3 primitive classes/Flow.LensFlare.html +++ b/Documentation/doc/3 primitive classes/Flow.LensFlare.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/3 primitive classes/Flow.SkyLayer.html b/Documentation/doc/3 primitive classes/Flow.SkyLayer.html index 4ad93cb38..06e20e9d8 100644 --- a/Documentation/doc/3 primitive classes/Flow.SkyLayer.html +++ b/Documentation/doc/3 primitive classes/Flow.SkyLayer.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/3 primitive classes/Flow.Starfield.html b/Documentation/doc/3 primitive classes/Flow.Starfield.html index c87708d4e..4b77d5d05 100644 --- a/Documentation/doc/3 primitive classes/Flow.Starfield.html +++ b/Documentation/doc/3 primitive classes/Flow.Starfield.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/3 primitive classes/Rotation.html b/Documentation/doc/3 primitive classes/Rotation.html index cb2236d64..9ee5bd243 100644 --- a/Documentation/doc/3 primitive classes/Rotation.html +++ b/Documentation/doc/3 primitive classes/Rotation.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/3 primitive classes/Time.html b/Documentation/doc/3 primitive classes/Time.html index 7b291f94d..02ea23327 100644 --- a/Documentation/doc/3 primitive classes/Time.html +++ b/Documentation/doc/3 primitive classes/Time.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/3 primitive classes/Vec2.html b/Documentation/doc/3 primitive classes/Vec2.html index 9b73f8a80..ee464e5aa 100644 --- a/Documentation/doc/3 primitive classes/Vec2.html +++ b/Documentation/doc/3 primitive classes/Vec2.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/3 primitive classes/Vec3.html b/Documentation/doc/3 primitive classes/Vec3.html index 7976a2254..97a57dc1e 100644 --- a/Documentation/doc/3 primitive classes/Vec3.html +++ b/Documentation/doc/3 primitive classes/Vec3.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Effects.BlendID.html b/Documentation/doc/4 enums/Effects.BlendID.html index b6f9a497a..b8c32339a 100644 --- a/Documentation/doc/4 enums/Effects.BlendID.html +++ b/Documentation/doc/4 enums/Effects.BlendID.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Effects.EffectID.html b/Documentation/doc/4 enums/Effects.EffectID.html index aa86e705d..2707464af 100644 --- a/Documentation/doc/4 enums/Effects.EffectID.html +++ b/Documentation/doc/4 enums/Effects.EffectID.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html new file mode 100644 index 000000000..1932ba425 --- /dev/null +++ b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html @@ -0,0 +1,169 @@ + + + + + TombEngine 1.7.2 (Developer) Lua API + + + + +
    + +
    + +
    +
    +
    + + +
    + + + + + + +
    + +

    Enum Effects.ParticleAnimationType

    +

    Constants for particle animation type constants.

    +

    + +

    + + +

    Tables

    + + + + + +
    Effects.ParticleAnimationTypeTable of Effects.ParticleAnimationType type constants.
    + +
    +
    + + +

    Tables

    + +
    +
    + + Effects.ParticleAnimationType +
    +
    + +

    Table of Effects.ParticleAnimationType type constants. To be used with particles.

    + +
      +
    • LOOP - Frames loop sequentially.
      • +
    • ONE_SHOT - Frames play once and freeze on the last frame.
      • +
    • BACK_AND_FORTH - Frames bounce back and forth.
      • +
    • LIFE_TIME_SPREAD - Frames are distributed over the particle's lifetime
      • +
    + + + + + + + + + + +
    +
    + + +
    +
    +
    +generated by TEN-LDoc (a fork of LDoc 1.4.6) +
    +
    + + diff --git a/Documentation/doc/4 enums/Flow.ErrorMode.html b/Documentation/doc/4 enums/Flow.ErrorMode.html index 2d0b7dab7..d0831c5f7 100644 --- a/Documentation/doc/4 enums/Flow.ErrorMode.html +++ b/Documentation/doc/4 enums/Flow.ErrorMode.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Flow.FreezeMode.html b/Documentation/doc/4 enums/Flow.FreezeMode.html index 074bedd81..82cd76f20 100644 --- a/Documentation/doc/4 enums/Flow.FreezeMode.html +++ b/Documentation/doc/4 enums/Flow.FreezeMode.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Flow.GameStatus.html b/Documentation/doc/4 enums/Flow.GameStatus.html index 955d7a5cd..c0b72793a 100644 --- a/Documentation/doc/4 enums/Flow.GameStatus.html +++ b/Documentation/doc/4 enums/Flow.GameStatus.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Input.ActionID.html b/Documentation/doc/4 enums/Input.ActionID.html index ac3ba5f7e..a6946f688 100644 --- a/Documentation/doc/4 enums/Input.ActionID.html +++ b/Documentation/doc/4 enums/Input.ActionID.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Objects.AmmoType.html b/Documentation/doc/4 enums/Objects.AmmoType.html index 3f9711c25..cf75c2e47 100644 --- a/Documentation/doc/4 enums/Objects.AmmoType.html +++ b/Documentation/doc/4 enums/Objects.AmmoType.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Objects.HandStatus.html b/Documentation/doc/4 enums/Objects.HandStatus.html index 75c3dec50..88ed9edaa 100644 --- a/Documentation/doc/4 enums/Objects.HandStatus.html +++ b/Documentation/doc/4 enums/Objects.HandStatus.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Objects.MoveableStatus.html b/Documentation/doc/4 enums/Objects.MoveableStatus.html index edee47c8e..39f63a31c 100644 --- a/Documentation/doc/4 enums/Objects.MoveableStatus.html +++ b/Documentation/doc/4 enums/Objects.MoveableStatus.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Objects.ObjID.html b/Documentation/doc/4 enums/Objects.ObjID.html index b8a5bafce..1531a01ba 100644 --- a/Documentation/doc/4 enums/Objects.ObjID.html +++ b/Documentation/doc/4 enums/Objects.ObjID.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Objects.RoomFlagID.html b/Documentation/doc/4 enums/Objects.RoomFlagID.html index 7bb77ff27..1d4189b0f 100644 --- a/Documentation/doc/4 enums/Objects.RoomFlagID.html +++ b/Documentation/doc/4 enums/Objects.RoomFlagID.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Objects.RoomReverb.html b/Documentation/doc/4 enums/Objects.RoomReverb.html index a728399b5..201865f7d 100644 --- a/Documentation/doc/4 enums/Objects.RoomReverb.html +++ b/Documentation/doc/4 enums/Objects.RoomReverb.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Objects.WeaponType.html b/Documentation/doc/4 enums/Objects.WeaponType.html index 9dfbc7b5b..dbeb7d23b 100644 --- a/Documentation/doc/4 enums/Objects.WeaponType.html +++ b/Documentation/doc/4 enums/Objects.WeaponType.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Sound.SoundTrackType.html b/Documentation/doc/4 enums/Sound.SoundTrackType.html index e57bb2fbd..0b424003d 100644 --- a/Documentation/doc/4 enums/Sound.SoundTrackType.html +++ b/Documentation/doc/4 enums/Sound.SoundTrackType.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Strings.DisplayStringOption.html b/Documentation/doc/4 enums/Strings.DisplayStringOption.html index 2f469bd78..88bb56b10 100644 --- a/Documentation/doc/4 enums/Strings.DisplayStringOption.html +++ b/Documentation/doc/4 enums/Strings.DisplayStringOption.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Util.LogLevel.html b/Documentation/doc/4 enums/Util.LogLevel.html index b4824fc0d..8c587a21f 100644 --- a/Documentation/doc/4 enums/Util.LogLevel.html +++ b/Documentation/doc/4 enums/Util.LogLevel.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/View.AlignMode.html b/Documentation/doc/4 enums/View.AlignMode.html index 85abe33ff..63d6ac8cc 100644 --- a/Documentation/doc/4 enums/View.AlignMode.html +++ b/Documentation/doc/4 enums/View.AlignMode.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/View.CameraType.html b/Documentation/doc/4 enums/View.CameraType.html index b1db0ce92..133bf7a7a 100644 --- a/Documentation/doc/4 enums/View.CameraType.html +++ b/Documentation/doc/4 enums/View.CameraType.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/View.PostProcessMode.html b/Documentation/doc/4 enums/View.PostProcessMode.html index 7d80a57ca..ac179455f 100644 --- a/Documentation/doc/4 enums/View.PostProcessMode.html +++ b/Documentation/doc/4 enums/View.PostProcessMode.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/View.ScaleMode.html b/Documentation/doc/4 enums/View.ScaleMode.html index 1336eab9f..571e52304 100644 --- a/Documentation/doc/4 enums/View.ScaleMode.html +++ b/Documentation/doc/4 enums/View.ScaleMode.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/5 lua utility modules/Diary.html b/Documentation/doc/5 lua utility modules/Diary.html index 0f44992ca..483a1ea91 100644 --- a/Documentation/doc/5 lua utility modules/Diary.html +++ b/Documentation/doc/5 lua utility modules/Diary.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/5 lua utility modules/EventSequence.html b/Documentation/doc/5 lua utility modules/EventSequence.html index 81fb79793..381f10f46 100644 --- a/Documentation/doc/5 lua utility modules/EventSequence.html +++ b/Documentation/doc/5 lua utility modules/EventSequence.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/5 lua utility modules/Timer.html b/Documentation/doc/5 lua utility modules/Timer.html index 85364b632..fd36e2664 100644 --- a/Documentation/doc/5 lua utility modules/Timer.html +++ b/Documentation/doc/5 lua utility modules/Timer.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/5 lua utility modules/Type.html b/Documentation/doc/5 lua utility modules/Type.html index b7be0f357..0cccf7b95 100644 --- a/Documentation/doc/5 lua utility modules/Type.html +++ b/Documentation/doc/5 lua utility modules/Type.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/index.html b/Documentation/doc/index.html index 28f720d02..d698f7760 100644 --- a/Documentation/doc/index.html +++ b/Documentation/doc/index.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • @@ -296,6 +297,10 @@ local door = GetMoveableByName("door_type4_14") Effects.EffectID Constants for effect IDs. + + Effects.ParticleAnimationType + Constants for particle animation type constants. + Flow.ErrorMode Constants for error modes. diff --git a/TombEngine/Game/effects/effects.cpp b/TombEngine/Game/effects/effects.cpp index d810b67bb..9d9c1f251 100644 --- a/TombEngine/Game/effects/effects.cpp +++ b/TombEngine/Game/effects/effects.cpp @@ -30,6 +30,7 @@ #include "Sound/sound.h" #include "Specific/clock.h" #include "Specific/level.h" +#include "Specific/trutils.h" using namespace TEN::Collision::Point; using namespace TEN::Effects::Blood; @@ -188,6 +189,86 @@ void SetSpriteSequence(Particle& particle, GAME_OBJECT_ID objectID) particle.SpriteID = (int)round(Lerp(0.0f, spriteCount, normalizedAge)); } +void SetAdvancedSpriteSequence(Particle& particle, GAME_OBJECT_ID objectID, ParticleAnimType animationType, float frameRate) +{ + // Ensure valid lifespan + if (particle.life <= 0) + { + particle.on = false; + ParticleDynamics[particle.dynamic].On = false; + return; + } + + // Calculate particle's age and normalized progress + float particleAge = particle.sLife - particle.life; // Elapsed time since spawn + float normalizedAge = particleAge / particle.sLife; // Progress as a fraction [0.0, 1.0] + + // Retrieve sprite sequence information + //int firstFrame = Objects[objectID].meshIndex; // Starting sprite index + int totalFrames = -Objects[objectID].nmeshes; // Total frames (assuming nmeshes is negative) + if (totalFrames <= 0) + { + particle.SpriteSeqID = objectID; + particle.SpriteID = 0; // Default to the first frame if no valid frames exist + return; + } + + particle.SpriteSeqID = objectID; + + // Handle animation modes + switch (animationType) + { + case ParticleAnimType::Loop: // Frames loop sequentially + { + float frameDuration = frameRate > 0 ? 1.0f / frameRate : 1.0f / totalFrames; // Duration per frame + int currentFrame = (int)(particleAge / frameDuration) % totalFrames; // Wrap frames + particle.SpriteID = currentFrame; + break; + } + + case ParticleAnimType::OneShot: // Frames play once, then freeze on the last frame + { + float totalDuration = frameRate > 0 ? totalFrames / frameRate : particle.sLife; + int currentFrame = (int)(particleAge / (totalDuration / totalFrames)); + if (currentFrame >= totalFrames) + currentFrame = totalFrames - 1; // Clamp to the last frame + particle.SpriteID = currentFrame; + break; + } + + case ParticleAnimType::BackAndForth: // Frames go forward and then backward + { + float frameDuration = frameRate > 0 ? 1.0f / frameRate : 1.0f / totalFrames; + int totalFrameSteps = totalFrames * 2 - 2; // Forward and backward frames (avoiding double-count of last frame) + int step = (int)(particleAge / frameDuration) % totalFrameSteps; + int currentFrame = step < totalFrames ? step : totalFrames - (step - totalFrames) - 1; + particle.SpriteID = currentFrame; + break; + } + + case ParticleAnimType::LifetimeSpread: // Distribute all frames evenly over lifetime + { + int currentFrame = (int)(normalizedAge * totalFrames); + if (currentFrame >= totalFrames) + currentFrame = totalFrames - 1; // Clamp to the last frame + particle.SpriteID = currentFrame; + break; + } + + case ParticleAnimType::None: // Distribute all frames evenly over lifetime + { + particle.SpriteID = 0; + break; + } + + + default: // Default behavior: keep the first frame + particle.SpriteID = 0; + break; + } +} + + void UpdateWibble() { // Update oscillator seed. @@ -351,8 +432,56 @@ void UpdateSparks() if (spark.flags & SP_EXPLOSION) SetSpriteSequence(spark, ID_EXPLOSION_SPRITES); + + if (spark.flags & SP_ANIMATED) + { + ParticleAnimType animationType = static_cast(spark.animationType); + GAME_OBJECT_ID spriteObject = static_cast(spark.SpriteSeqID); + SetAdvancedSpriteSequence(spark, spriteObject, animationType, spark.framerate); + } + + if (spark.flags & SP_SOUND) + SoundEffect(spark.sound, &Pose(Vector3(spark.x, spark.y, spark.z)), SoundEnvironment::Always); + + if (spark.flags & SP_LIGHT) + { + float radius = spark.lightRadius * spark.size / spark.sSize; + // Decrease flicker timer if set + if (spark.lightFlicker > 0) + { + spark.lightFlicker--; + + if (spark.lightFlicker <= 0) + { + // Apply random flicker effect + int random = GetRandomControl(); + int colorOffset = (random % 21) - 10; // Random change between -10 and +10 + + byte r = std::clamp(spark.r + colorOffset, 0, 255); + byte g = std::clamp(spark.g + colorOffset, 0, 255); + byte b = std::clamp(spark.b + colorOffset, 0, 255); + + // Reset flicker timer + spark.lightFlicker = spark.lightFlickerS; + + // Emit flickering light + SpawnDynamicPointLight(Vector3(spark.x, spark.y, spark.z), ScriptColor(r, g, b), radius, false, GetHash(std::string())); + } + else + { + // Normal light emission while flicker is counting down + SpawnDynamicPointLight(Vector3(spark.x, spark.y, spark.z), ScriptColor(spark.r, spark.g, spark.b), radius, false, GetHash(std::string())); + } + } + else + { + // If flicker is disabled or 0, just emit normal light + SpawnDynamicPointLight(Vector3(spark.x, spark.y, spark.z), ScriptColor(spark.r, spark.g, spark.b), radius, false, GetHash(std::string())); + } + } + if ((spark.flags & SP_FIRE && LaraItem->Effect.Type == EffectType::None) || - (spark.flags & SP_DAMAGE) || + (spark.flags & SP_DAMAGE) || (spark.flags & SP_POISON)) { int ds = spark.size * (spark.scalar / 2.0); @@ -367,10 +496,10 @@ void UpdateSparks() ItemBurn(LaraItem); if (spark.flags & SP_DAMAGE) - DoDamage(LaraItem, 2); + DoDamage(LaraItem, spark.damage); if (spark.flags & SP_POISON) - Lara.Status.Poison += 5; + Lara.Status.Poison += spark.damage; } } } diff --git a/TombEngine/Game/effects/effects.h b/TombEngine/Game/effects/effects.h index d0bd7ce34..0960c82e8 100644 --- a/TombEngine/Game/effects/effects.h +++ b/TombEngine/Game/effects/effects.h @@ -42,6 +42,18 @@ enum SpriteEnumFlag SP_PLASMAEXP = (1 << 13), SP_POISON = (1 << 14), SP_COLOR = (1 << 15), + SP_ANIMATED = (1 << 16), + SP_LIGHT = (1 << 17), + SP_SOUND = (1 << 18), +}; + +enum ParticleAnimType +{ + None, + OneShot, + Loop, + BackAndForth, + LifetimeSpread }; // Used by Particle.nodeNumber. @@ -130,8 +142,8 @@ struct Particle short rotAdd; // TODO: Due to legacy conventions, assigned values must be shifted >> 4. short gravity; - unsigned short flags; // SP_enum - + unsigned int flags; // SP_enum + float sSize; float dSize; float size; @@ -160,6 +172,16 @@ struct Particle unsigned char extras; signed char dynamic; unsigned char nodeNumber; // ParticleNodeOffsetIDs enum. + + int damage; + float framerate; + ParticleAnimType animationType; + + int lightRadius; + int lightFlicker; + int lightFlickerS; + + int sound; int PrevX; int PrevY; @@ -245,6 +267,7 @@ void ClearInactiveEffects(std::vector& effects) Particle* GetFreeParticle(); void SetSpriteSequence(Particle& particle, GAME_OBJECT_ID objectID); +void SetAdvancedSpriteSequence(Particle& particle, GAME_OBJECT_ID objectID, ParticleAnimType animationType, float frameRate); void DetatchSpark(int num, SpriteEnumFlag type); void UpdateSparks(); diff --git a/TombEngine/Game/savegame.cpp b/TombEngine/Game/savegame.cpp index 86b8fd77e..fcfaf604d 100644 --- a/TombEngine/Game/savegame.cpp +++ b/TombEngine/Game/savegame.cpp @@ -1149,11 +1149,13 @@ const std::vector SaveGame::Build() Save::ParticleInfoBuilder particleInfo{ fbb }; + particleInfo.add_animation_type(particle->animationType); particleInfo.add_b(particle->b); particleInfo.add_col_fade_speed(particle->colFadeSpeed); particleInfo.add_d_b(particle->dB); particleInfo.add_sprite_index(particle->SpriteSeqID); particleInfo.add_sprite_id(particle->SpriteID); + particleInfo.add_damage(particle->damage); particleInfo.add_d_g(particle->dG); particleInfo.add_d_r(particle->dR); particleInfo.add_d_size(particle->dSize); @@ -1161,11 +1163,15 @@ const std::vector SaveGame::Build() particleInfo.add_extras(particle->extras); particleInfo.add_fade_to_black(particle->fadeToBlack); particleInfo.add_flags(particle->flags); + particleInfo.add_framerate(particle->framerate); particleInfo.add_friction(particle->friction); particleInfo.add_fx_obj(particle->fxObj); particleInfo.add_g(particle->g); particleInfo.add_gravity(particle->gravity); particleInfo.add_life(particle->life); + particleInfo.add_light_radius(particle->lightRadius); + particleInfo.add_light_flicker(particle->lightFlicker); + particleInfo.add_light_flicker_s(particle->lightFlickerS); particleInfo.add_max_y_vel(particle->maxYvel); particleInfo.add_node_number(particle->nodeNumber); particleInfo.add_on(particle->on); @@ -1180,9 +1186,10 @@ const std::vector SaveGame::Build() particleInfo.add_s_life(particle->sLife); particleInfo.add_s_r(particle->sR); particleInfo.add_s_size(particle->sSize); + particleInfo.add_sound(particle->sound); particleInfo.add_blend_mode((int)particle->blendMode); particleInfo.add_x(particle->x); - particleInfo.add_x_vel(particle->sSize); + particleInfo.add_x_vel(particle->xVel); particleInfo.add_y(particle->y); particleInfo.add_y_vel(particle->yVel); particleInfo.add_z(particle->z); @@ -2224,6 +2231,14 @@ static void ParseEffects(const Save::SaveGame* s) particle->roomNumber = particleInfo->room_number(); particle->nodeNumber = particleInfo->node_number(); particle->targetPos = ToVector3(particleInfo->target_pos()); + particle->animationType = (ParticleAnimType)particleInfo->animation_type(); + particle->damage = particleInfo->damage(); + particle->framerate = particleInfo->framerate(); + particle->lightRadius = particleInfo->light_radius(); + particle->lightFlicker = particleInfo->light_flicker(); + particle->lightFlickerS = particleInfo->light_flicker_s(); + particle->sound = particleInfo->sound(); + } for (int i = 0; i < s->bats()->size(); i++) diff --git a/TombEngine/Scripting/Internal/ReservedScriptNames.h b/TombEngine/Scripting/Internal/ReservedScriptNames.h index 6b250364b..01c10eb85 100644 --- a/TombEngine/Scripting/Internal/ReservedScriptNames.h +++ b/TombEngine/Scripting/Internal/ReservedScriptNames.h @@ -312,6 +312,7 @@ static constexpr char ScriptReserved_EnableEvent[] = "EnableEvent"; static constexpr char ScriptReserved_DisableEvent[] = "DisableEvent"; static constexpr char ScriptReserved_EmitParticle[] = "EmitParticle"; +static constexpr char ScriptReserved_EmitAdvancedParticle[] = "EmitAdvancedParticle"; static constexpr char ScriptReserved_EmitLightningArc[] = "EmitLightningArc"; static constexpr char ScriptReserved_EmitShockwave[] = "EmitShockwave"; static constexpr char ScriptReserved_EmitLight[] = "EmitLight"; @@ -384,6 +385,7 @@ static constexpr char ScriptReserved_EndReason[] = "EndReason"; static constexpr char ScriptReserved_EventType[] = "EventType"; static constexpr char ScriptReserved_AlignMode[] = "AlignMode"; static constexpr char ScriptReserved_ScaleMode[] = "ScaleMode"; +static constexpr char ScriptReserved_ParticleAnimationType[] = "ParticleAnimationType"; static constexpr char ScriptReserved_LevelVars[] = "LevelVars"; static constexpr char ScriptReserved_GameVars[] = "GameVars"; diff --git a/TombEngine/Scripting/Internal/TEN/Effects/BlendIDs.h b/TombEngine/Scripting/Internal/TEN/Effects/BlendIDs.h index af1c1c4f7..a68d656b9 100644 --- a/TombEngine/Scripting/Internal/TEN/Effects/BlendIDs.h +++ b/TombEngine/Scripting/Internal/TEN/Effects/BlendIDs.h @@ -2,26 +2,26 @@ #include "Renderer/RendererEnums.h" -/// Constants for blend mode IDs. -// @enum Effects.BlendID -// @pragma nostrip - -/// Table of Effects.BlendID constants. -// -// - `OPAQUE` -// - `ALPHA_TEST` -// - `ADDITIVE` -// - `NO_DEPTH_TEST` -// - `SUBTRACTIVE` -// - `EXCLUDE` -// - `SCREEN` -// - `LIGHTEN` -// - `ALPHA_BLEND` -// -// @table Effects.BlendID - namespace TEN::Scripting::Effects { + /// Constants for blend mode IDs. + // @enum Effects.BlendID + // @pragma nostrip + + /// Table of Effects.BlendID constants. + // + // - `OPAQUE` + // - `ALPHA_TEST` + // - `ADDITIVE` + // - `NO_DEPTH_TEST` + // - `SUBTRACTIVE` + // - `EXCLUDE` + // - `SCREEN` + // - `LIGHTEN` + // - `ALPHA_BLEND` + // + // @table Effects.BlendID + static const auto BLEND_IDS = std::unordered_map { { "OPAQUE", BlendMode::Opaque }, diff --git a/TombEngine/Scripting/Internal/TEN/Effects/EffectIDs.h b/TombEngine/Scripting/Internal/TEN/Effects/EffectIDs.h index 27d4e9bf1..93e3cd54b 100644 --- a/TombEngine/Scripting/Internal/TEN/Effects/EffectIDs.h +++ b/TombEngine/Scripting/Internal/TEN/Effects/EffectIDs.h @@ -2,26 +2,26 @@ #include "Game/items.h" -/// Constants for effect IDs. -// @enum Effects.EffectID -// @pragma nostrip - -/// Table of Effects.EffectID constants. -// To be used with @{Objects.Moveable.SetEffect} and @{Objects.Moveable.GetEffect} functions. -// -// - `NONE` -// - `FIRE` -// - `SPARKS` -// - `SMOKE` -// - `ELECTRIC_IGNITE` -// - `RED_IGNITE` -// - `CADAVER` -// - `CUSTOM` -// -// @table Effects.EffectID - namespace TEN::Scripting::Effects { + /// Constants for effect IDs. + // @enum Effects.EffectID + // @pragma nostrip + + /// Table of Effects.EffectID constants. + // To be used with @{Objects.Moveable.SetEffect} and @{Objects.Moveable.GetEffect} functions. + // + // - `NONE` + // - `FIRE` + // - `SPARKS` + // - `SMOKE` + // - `ELECTRIC_IGNITE` + // - `RED_IGNITE` + // - `CADAVER` + // - `CUSTOM` + // + // @table Effects.EffectID + static const auto EFFECT_IDS = std::unordered_map { { "NONE", EffectType::None }, @@ -37,3 +37,4 @@ namespace TEN::Scripting::Effects { "REDIGNITE", EffectType::RedIgnite } }; } + diff --git a/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp b/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp index a30a1426b..0acd85d4c 100644 --- a/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp +++ b/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp @@ -20,6 +20,7 @@ #include "Scripting/Internal/ScriptUtil.h" #include "Scripting/Internal/TEN/Effects/BlendIDs.h" #include "Scripting/Internal/TEN/Effects/EffectIDs.h" +#include "Scripting/Internal/TEN/Effects/ParticleAnimTypes.h" #include "Scripting/Internal/TEN/Types/Color/Color.h" #include "Scripting/Internal/TEN/Types/Vec3/Vec3.h" #include "Scripting/Internal/TEN/Types/Vec2/Vec2.h" @@ -210,6 +211,156 @@ namespace TEN::Scripting::Effects if (TestEnvironment(RoomEnvFlags::ENV_FLAG_WIND, part.roomNumber)) part.flags |= SP_WIND; } + + /// Emit a particle with extensive configuration options including animations. + // @function EmitAdvancedParticle + // @tparam ParticleData ParticleData The table holding all the particle data. + // @usage + // local particle = { + // position = GetMoveableByName("camera_target_6") :GetPosition(), + // velocity = Vec3(0, 0, 10), + // spriteSeqID = TEN.Objects.ObjID.CUSTOM_BAR_GRAPHIC, + // spriteID = 0, + // lifetime = 10, + // maxYVelocity = 0, + // gravity = 0, + // friction = 10, + // startRotation = 0, + // rotationSpeed = 0, + // startSize = 80, + // endSize = 80, + // startColor = TEN.Color(128, 128, 128), + // endColor = TEN.Color(128, 128, 128), + // blendMode = TEN.Effects.BlendID.ADDITIVE, + // wind = false, + // damage = true, + // poison = false, + // burn = false, + // damageHit = 80, + // sound = 197, + // light = true, + // lightRadius = 6, + // lightFlicker = 5, + // animated = true, + // frameRate = .25, + // animationType = TEN.Effects.ParticleAnimationType.LOOP, + // } + // EmitAdvancedParticle(particle) + static void EmitAdvancedParticle(sol::table ParticleData) + { + constexpr auto DEFAULT_START_SIZE = 10.0f; + constexpr auto DEFAULT_LIFE = 2.0f; + constexpr auto SECS_PER_FRAME = 1.0f / (float)FPS; + + auto convertedSpriteSeqID = ParticleData.get_or("spriteSeqID", ID_DEFAULT_SPRITES); + if (!CheckIfSlotExists(convertedSpriteSeqID, "EmitParticle() script function.")) + return; + + auto& part = *GetFreeParticle(); + + part.on = true; + part.SpriteSeqID = convertedSpriteSeqID; + part.SpriteID = ParticleData.get_or("spriteID", 0); + + auto bMode = ParticleData.get_or("blendMode", BlendMode::AlphaBlend); + part.blendMode = bMode; + + Vec3 pos = ParticleData["position"]; + part.x = pos.x; + part.y = pos.y; + part.z = pos.z; + part.roomNumber = FindRoomNumber(Vector3i(pos.x, pos.y, pos.z)); + + Vec3 vel = ParticleData["velocity"]; + part.xVel = short(vel.x * 32); + part.yVel = short(vel.y * 32); + part.zVel = short(vel.z * 32); + + float rotAdd = ParticleData.get_or("rotationSpeed", 0.0f); + float rotAng = ParticleData.get_or("startRotation", TO_DEGREES(Random::GenerateAngle())); + part.rotAng = ANGLE(rotAng) >> 4; + part.rotAdd = ANGLE(rotAdd) >> 4; + + part.sSize = + part.size = ParticleData.get_or("startSize", DEFAULT_START_SIZE); + part.dSize = ParticleData.get_or("endSize", 0.0f); + part.scalar = 2; + + part.gravity = (short)std::clamp((float) ParticleData.get_or("gravity", 0.0f), (float)SHRT_MIN, (float)SHRT_MAX); + part.friction = ParticleData.get_or("friction", 0); + part.maxYvel = ParticleData.get_or("maxYVelocity", 0); + + auto convertedStartColor = ParticleData.get_or("startColor", ScriptColor(255, 255, 255)); + part.sR = convertedStartColor.GetR(); + part.sG = convertedStartColor.GetG(); + part.sB = convertedStartColor.GetB(); + + auto convertedEndColor = ParticleData.get_or("endColor", ScriptColor(255, 255, 255)); + part.dR = convertedEndColor.GetR(); + part.dG = convertedEndColor.GetG(); + part.dB = convertedEndColor.GetB(); + + float convertedLife = std::max(0.1f, (float) ParticleData.get_or("lifetime", DEFAULT_LIFE)); + part.life = + part.sLife = (int)round(convertedLife / SECS_PER_FRAME); + part.colFadeSpeed = part.life / 2; + part.fadeToBlack = part.life / 3; + + part.flags = SP_SCALE | SP_ROTATE | SP_DEF | SP_EXPDEF; + + part.damage = ParticleData.get_or("damageHit", 2); + + bool convertedApplyPoison = ParticleData.get_or("poison", false); + if (convertedApplyPoison) + part.flags |= SP_POISON; + + bool convertedApplyDamage = ParticleData.get_or("damage", false); + if (convertedApplyDamage) + part.flags |= SP_DAMAGE; + + bool convertedApplyBurn = ParticleData.get_or("burn", false); + if (convertedApplyBurn) + part.flags |= SP_FIRE; + + int convertedApplySound = ParticleData.get_or("sound", -1); + if (convertedApplySound > 0) + { + part.flags |= SP_SOUND; + part.sound = convertedApplySound; + } + bool convertedApplyLight = ParticleData.get_or("light", false); + if (convertedApplyLight) + { + part.flags |= SP_LIGHT; + int lightRadius = ParticleData.get_or("lightRadius", 0); + part.lightRadius = lightRadius * BLOCK(0.25f); + int flicker = ParticleData.get_or("lightFlicker", 0); + + if (flicker > 0) + { + part.lightFlicker = ParticleData.get_or("lightFlicker", 0); + part.lightFlickerS = ParticleData.get_or("lightFlicker", 0); + } + } + bool animatedSpr = ParticleData.get_or("animated", false); + if (animatedSpr) + { + ParticleAnimType applyAnim = ParticleData.get_or("animationType", ParticleAnimType::Loop); + float applyFramerate = ParticleData.get_or("frameRate", 1.0f); + part.flags |= SP_ANIMATED; + part.framerate = applyFramerate; + part.animationType = ParticleAnimType(std::clamp(int(applyAnim), int(ParticleAnimType::None), int(ParticleAnimType::LifetimeSpread))); + + } + + bool convertedApplyWind = ParticleData.get_or("wind", false); + if (convertedApplyWind) + { + if (TestEnvironment(RoomEnvFlags::ENV_FLAG_WIND, part.roomNumber)) + part.flags |= SP_WIND; + } + + } /***Emit a shockwave, similar to that seen when a harpy projectile hits something. @function EmitShockwave @@ -299,11 +450,11 @@ namespace TEN::Scripting::Effects TriggerBlood(pos.x, pos.y, pos.z, -1, ValueOr(count, 1)); } - /// Emit air bubble in a water room. - // @function EmitAirBubble - // @tparam Vec3 pos World position where the effect will be spawned. Must be in a water room. - // @tparam[opt] float size Sprite size. __Default: 32__ - // @tparam[opt] float amp Oscillation amplitude. __Default: 32__ +/// Emit air bubble in a water room. +// @function EmitAirBubble +// @tparam Vec3 pos World position where the effect will be spawned. Must be in a water room. +// @tparam[opt] float size Sprite size. __Default: 32__ +// @tparam[opt] float amp Oscillation amplitude. __Default: 32__ static void EmitAirBubble(const Vec3& pos, TypeOrNil size, TypeOrNil amp) { constexpr auto DEFAULT_SIZE = 128.0f; @@ -362,6 +513,7 @@ namespace TEN::Scripting::Effects tableEffects.set_function(ScriptReserved_EmitLightningArc, &EmitLightningArc); tableEffects.set_function(ScriptReserved_EmitParticle, &EmitParticle); + tableEffects.set_function(ScriptReserved_EmitAdvancedParticle, &EmitAdvancedParticle); tableEffects.set_function(ScriptReserved_EmitShockwave, &EmitShockwave); tableEffects.set_function(ScriptReserved_EmitLight, &EmitLight); tableEffects.set_function(ScriptReserved_EmitSpotLight, &EmitSpotLight); @@ -375,5 +527,38 @@ namespace TEN::Scripting::Effects auto handler = LuaHandler{ state }; handler.MakeReadOnlyTable(tableEffects, ScriptReserved_BlendID, BLEND_IDS); handler.MakeReadOnlyTable(tableEffects, ScriptReserved_EffectID, EFFECT_IDS); + handler.MakeReadOnlyTable(tableEffects, ScriptReserved_ParticleAnimationType, PARTICLE_ANIM_TYPES); } } + +/// Structure for EmitAdvancedParticle table. +// @table ParticleData +// @tfield Vec3 position World position. +// @tfield Vec3 velocity Velocity. +// @tfield[opt] Objects.ObjID spriteSeqID ID of the sprite sequence object. __Default: Objects.ObjID.DEFAULT_SPRITES__ +// @tfield[opt] int spriteID ID of the sprite in the sprite sequence object.__Default: 0__ +// @tfield[opt] float lifetime Lifespan in seconds. __Default: 2__ +// @tfield[opt] float maxYVelocity Specifies ithe maximum Y velocity for the particle. __Default: 0__ +// @tfield[opt] float gravity Specifies if the particle will fall over time. Positive values ascend, negative values descend. Recommended range: [-1000 and 1000]. __Default: 0__ +// @tfield[opt] float friction Specifies the friction with which the particle will slow down over time. __Default: 0__ +// @tfield[opt] float startRotation Rotation at start of life. __Default: random__ +// @tfield[opt] float rotationSpeed Rotational velocity in degrees. __Default: 0__ +// @tfield[opt] float startSize Size at start of life. __Default: 10__ +// @tfield[opt] float endSize Size at end of life. The particle will linearly shrink or grow toward this size over its lifespan. __Default: 0__ +// @tfield[opt] Color startColor Color at start of life. __Default: Color(255, 255, 255)__ +// @tfield[opt] Color endColor Color to fade toward. This will finish long before the end of the particle's life due to internal math. __Default: Color(255, 255, 255)__ +// @tfield[opt] Effects.BlendID blendMode Render blend mode. __TEN.Effects.BlendID.ALPHA_BLEND__ +// @tfield[opt] bool damage Specify if the particle will harm the player on collision. __Default: false__ +// @tfield[opt] bool poison Specify if the particle will poison the player on collision. __Default: false__ +// @tfield[opt] bool burn Specify if the particle will burn the player on collision. __Default: false__ +// @tfield[opt] bool wind Specify if the particle will be affected by wind in outside rooms. __Default: false__ +// @tfield[opt] int damageHit Specify the damage particle will harm the player on collision. __Default: 2__ +// @tfield[opt] bool light Specify if the particle will be emit a light based on its color. Caution: Recommended only for a single particle. Having too many particles with lights can overflow the light system. __Default: false__ +// @tfield[opt] int lightRadius measured in "clicks" or 256 world units. __Default: 0__ +// @tfield[opt] int lightFlicker The interval at which light should flicker. __Default: 0__ +// @tfield[opt] int sound ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. Looping sounds recommended. Caution: Recommended only for a single particle. Having too many particles with sounds can overflow the sound system. __Default: None__ +// @tfield[opt] bool animated Specify if the particle will be animated. __Default: false__ +// @tfield[opt] Effects.ParticleAnimationType animationType Specify the the type of animation the particle will use. __Default: TEN.Effects.ParticleAnimationType.LOOP__ +// @tfield[opt] float frameRate The framerate with which the particle will be animated. __Default: 1__ + + diff --git a/TombEngine/Scripting/Internal/TEN/Effects/ParticleAnimTypes.h b/TombEngine/Scripting/Internal/TEN/Effects/ParticleAnimTypes.h new file mode 100644 index 000000000..d992641fa --- /dev/null +++ b/TombEngine/Scripting/Internal/TEN/Effects/ParticleAnimTypes.h @@ -0,0 +1,27 @@ +#pragma once + +#include "Game/effects/effects.h" + +namespace TEN::Scripting::Effects +{ + /// Constants for particle animation type constants. + // @enum Effects.ParticleAnimationType + // @pragma nostrip + + /// Table of Effects.ParticleAnimationType type constants. To be used with particles. + // + // - `LOOP` - Frames loop sequentially. + // - `ONE_SHOT` - Frames play once and freeze on the last frame. + // - `BACK_AND_FORTH` - Frames bounce back and forth. + // - `LIFE_TIME_SPREAD` - Frames are distributed over the particle's lifetime + // + // @table Effects.ParticleAnimationType + + static const auto PARTICLE_ANIM_TYPES = std::unordered_map + { + { "LOOP", ParticleAnimType::Loop }, + { "ONE_SHOT", ParticleAnimType::OneShot }, + { "BACK_AND_FORTH", ParticleAnimType::BackAndForth }, + { "LIFE_TIME_SPREAD", ParticleAnimType::LifetimeSpread } // TODO: Rename to LIFETIME_SPREAD. + }; +} diff --git a/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h b/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h index f256c9104..72be08b3f 100644 --- a/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h +++ b/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h @@ -4954,6 +4954,13 @@ struct ParticleInfoT : public flatbuffers::NativeTable { int32_t node_number = 0; std::unique_ptr target_pos{}; int32_t sprite_id = 0; + int32_t damage = 0; + float framerate = 0.0f; + int32_t animation_type = 0; + int32_t light_radius = 0; + int32_t light_flicker = 0; + int32_t light_flicker_s = 0; + int32_t sound = 0; }; struct ParticleInfo FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { @@ -4999,7 +5006,14 @@ struct ParticleInfo FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { VT_ROOM_NUMBER = 74, VT_NODE_NUMBER = 76, VT_TARGET_POS = 78, - VT_SPRITE_ID = 80 + VT_SPRITE_ID = 80, + VT_DAMAGE = 82, + VT_FRAMERATE = 84, + VT_ANIMATION_TYPE = 86, + VT_LIGHT_RADIUS = 88, + VT_LIGHT_FLICKER = 90, + VT_LIGHT_FLICKER_S = 92, + VT_SOUND = 94 }; int32_t x() const { return GetField(VT_X, 0); @@ -5118,6 +5132,27 @@ struct ParticleInfo FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { int32_t sprite_id() const { return GetField(VT_SPRITE_ID, 0); } + int32_t damage() const { + return GetField(VT_DAMAGE, 0); + } + float framerate() const { + return GetField(VT_FRAMERATE, 0.0f); + } + int32_t animation_type() const { + return GetField(VT_ANIMATION_TYPE, 0); + } + int32_t light_radius() const { + return GetField(VT_LIGHT_RADIUS, 0); + } + int32_t light_flicker() const { + return GetField(VT_LIGHT_FLICKER, 0); + } + int32_t light_flicker_s() const { + return GetField(VT_LIGHT_FLICKER_S, 0); + } + int32_t sound() const { + return GetField(VT_SOUND, 0); + } bool Verify(flatbuffers::Verifier &verifier) const { return VerifyTableStart(verifier) && VerifyField(verifier, VT_X) && @@ -5159,6 +5194,13 @@ struct ParticleInfo FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { VerifyField(verifier, VT_NODE_NUMBER) && VerifyField(verifier, VT_TARGET_POS) && VerifyField(verifier, VT_SPRITE_ID) && + VerifyField(verifier, VT_DAMAGE) && + VerifyField(verifier, VT_FRAMERATE) && + VerifyField(verifier, VT_ANIMATION_TYPE) && + VerifyField(verifier, VT_LIGHT_RADIUS) && + VerifyField(verifier, VT_LIGHT_FLICKER) && + VerifyField(verifier, VT_LIGHT_FLICKER_S) && + VerifyField(verifier, VT_SOUND) && verifier.EndTable(); } ParticleInfoT *UnPack(const flatbuffers::resolver_function_t *_resolver = nullptr) const; @@ -5287,6 +5329,27 @@ struct ParticleInfoBuilder { void add_sprite_id(int32_t sprite_id) { fbb_.AddElement(ParticleInfo::VT_SPRITE_ID, sprite_id, 0); } + void add_damage(int32_t damage) { + fbb_.AddElement(ParticleInfo::VT_DAMAGE, damage, 0); + } + void add_framerate(float framerate) { + fbb_.AddElement(ParticleInfo::VT_FRAMERATE, framerate, 0.0f); + } + void add_animation_type(int32_t animation_type) { + fbb_.AddElement(ParticleInfo::VT_ANIMATION_TYPE, animation_type, 0); + } + void add_light_radius(int32_t light_radius) { + fbb_.AddElement(ParticleInfo::VT_LIGHT_RADIUS, light_radius, 0); + } + void add_light_flicker(int32_t light_flicker) { + fbb_.AddElement(ParticleInfo::VT_LIGHT_FLICKER, light_flicker, 0); + } + void add_light_flicker_s(int32_t light_flicker_s) { + fbb_.AddElement(ParticleInfo::VT_LIGHT_FLICKER_S, light_flicker_s, 0); + } + void add_sound(int32_t sound) { + fbb_.AddElement(ParticleInfo::VT_SOUND, sound, 0); + } explicit ParticleInfoBuilder(flatbuffers::FlatBufferBuilder &_fbb) : fbb_(_fbb) { start_ = fbb_.StartTable(); @@ -5338,8 +5401,22 @@ inline flatbuffers::Offset CreateParticleInfo( int32_t room_number = 0, int32_t node_number = 0, const TEN::Save::Vector3 *target_pos = 0, - int32_t sprite_id = 0) { + int32_t sprite_id = 0, + int32_t damage = 0, + float framerate = 0.0f, + int32_t animation_type = 0, + int32_t light_radius = 0, + int32_t light_flicker = 0, + int32_t light_flicker_s = 0, + int32_t sound = 0) { ParticleInfoBuilder builder_(_fbb); + builder_.add_sound(sound); + builder_.add_light_flicker_s(light_flicker_s); + builder_.add_light_flicker(light_flicker); + builder_.add_light_radius(light_radius); + builder_.add_animation_type(animation_type); + builder_.add_framerate(framerate); + builder_.add_damage(damage); builder_.add_sprite_id(sprite_id); builder_.add_target_pos(target_pos); builder_.add_node_number(node_number); @@ -9810,6 +9887,13 @@ inline void ParticleInfo::UnPackTo(ParticleInfoT *_o, const flatbuffers::resolve { auto _e = node_number(); _o->node_number = _e; } { auto _e = target_pos(); if (_e) _o->target_pos = std::unique_ptr(new TEN::Save::Vector3(*_e)); } { auto _e = sprite_id(); _o->sprite_id = _e; } + { auto _e = damage(); _o->damage = _e; } + { auto _e = framerate(); _o->framerate = _e; } + { auto _e = animation_type(); _o->animation_type = _e; } + { auto _e = light_radius(); _o->light_radius = _e; } + { auto _e = light_flicker(); _o->light_flicker = _e; } + { auto _e = light_flicker_s(); _o->light_flicker_s = _e; } + { auto _e = sound(); _o->sound = _e; } } inline flatbuffers::Offset ParticleInfo::Pack(flatbuffers::FlatBufferBuilder &_fbb, const ParticleInfoT* _o, const flatbuffers::rehasher_function_t *_rehasher) { @@ -9859,6 +9943,13 @@ inline flatbuffers::Offset CreateParticleInfo(flatbuffers::FlatBuf auto _node_number = _o->node_number; auto _target_pos = _o->target_pos ? _o->target_pos.get() : 0; auto _sprite_id = _o->sprite_id; + auto _damage = _o->damage; + auto _framerate = _o->framerate; + auto _animation_type = _o->animation_type; + auto _light_radius = _o->light_radius; + auto _light_flicker = _o->light_flicker; + auto _light_flicker_s = _o->light_flicker_s; + auto _sound = _o->sound; return TEN::Save::CreateParticleInfo( _fbb, _x, @@ -9899,7 +9990,14 @@ inline flatbuffers::Offset CreateParticleInfo(flatbuffers::FlatBuf _room_number, _node_number, _target_pos, - _sprite_id); + _sprite_id, + _damage, + _framerate, + _animation_type, + _light_radius, + _light_flicker, + _light_flicker_s, + _sound); } inline SoundtrackT *Soundtrack::UnPack(const flatbuffers::resolver_function_t *_resolver) const { diff --git a/TombEngine/Specific/savegame/schema/ten_savegame.fbs b/TombEngine/Specific/savegame/schema/ten_savegame.fbs index 4b2000a37..cdd4ddfa1 100644 --- a/TombEngine/Specific/savegame/schema/ten_savegame.fbs +++ b/TombEngine/Specific/savegame/schema/ten_savegame.fbs @@ -375,6 +375,13 @@ table ParticleInfo { node_number: int32; target_pos: Vector3; sprite_id: int32; + damage: int32; + framerate: float; + animation_type: int32; + light_radius: int32; + light_flicker: int32; + light_flicker_s: int32; + sound: int32; } table Soundtrack { diff --git a/TombEngine/TombEngine.vcxproj b/TombEngine/TombEngine.vcxproj index d60786780..05fb4ffb8 100644 --- a/TombEngine/TombEngine.vcxproj +++ b/TombEngine/TombEngine.vcxproj @@ -883,6 +883,7 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. + From e047da7257d36e27ab86629b5c9f0ff76d6380ce Mon Sep 17 00:00:00 2001 From: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Sat, 8 Mar 2025 23:19:08 -0500 Subject: [PATCH 016/160] Streamer emitter (#1589) * WIP * Committ * LUA DOCS * Expose Moveable Scale (#1587) * Done * Update CHANGELOG.md * Cleanup * Minor fixes * Update CHANGELOG.md --------- Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com> * Cleanup * Improve streamer effect implementation * Shorten names * Update Streamer.h * Point to Moveable * Change to Const * Doc revisions * Doc revisions * Update CHANGELOG.md * Use precise names * Do things over seconds * Make tag optional again * Integrate start and end colour * Update doc comment * Regenerate docs; update strings * Update doc comment * Update ReservedScriptNames.h * Update EffectsFunctions.cpp * Minor fixes * Update EffectsFunctions.cpp * Update EffectsFunctions.cpp * Update EffectsFunctions.cpp * Rename Item * Renames * Add compiled docs --------- Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com> Co-authored-by: Sezz --- CHANGELOG.md | 1 + .../doc/2 classes/Collision.Probe.html | 180 ++++++++++++------ .../doc/4 enums/Collision.MaterialType.html | 1 + .../doc/4 enums/Effects.FeatherMode.html | 172 +++++++++++++++++ Documentation/doc/ldoc.css | 13 +- TombEngine/Game/effects/Streamer.cpp | 22 +-- TombEngine/Game/effects/Streamer.h | 14 +- TombEngine/Objects/TR4/Entity/Wraith.cpp | 6 +- TombEngine/Objects/Utils/VehicleHelpers.cpp | 4 +- TombEngine/Renderer/RendererDrawEffect.cpp | 10 +- .../Internal/TEN/Effects/FeatherModes.h | 30 +++ TombEngine/TombEngine.vcxproj | 1 + 12 files changed, 366 insertions(+), 88 deletions(-) create mode 100644 Documentation/doc/4 enums/Effects.FeatherMode.html create mode 100644 TombEngine/Scripting/Internal/TEN/Effects/FeatherModes.h diff --git a/CHANGELOG.md b/CHANGELOG.md index a3e15fe19..09d04971f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -35,6 +35,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added diary module. * Added View.GetFlyByPosition() and View.GetFlyByRotation() functions to get flyby sequence parameters at a specified time point. * Added Effects.EmitAirBubble() function to spawn air bubbles. +* Added Effects.EmitStreamer() function to emit streamers. * Added Moveable:GetScale() and Movebale:SetScale() methods to set visible scale of moveables. * Added Rotation:Lerp() function to allow linear interpolation between rotations. * Added various Translate() methods to Vec2 and Vec3 script objects. diff --git a/Documentation/doc/2 classes/Collision.Probe.html b/Documentation/doc/2 classes/Collision.Probe.html index e6fc8bf34..e9d2ad8ef 100644 --- a/Documentation/doc/2 classes/Collision.Probe.html +++ b/Documentation/doc/2 classes/Collision.Probe.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.FeatherMode
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • @@ -114,8 +115,6 @@

    Represents a collision probe in the game world.

    Provides collision information from a reference world position.

    -

    pragma nostrip

    -

    Functions

    @@ -124,22 +123,30 @@ - + - - + + - - + + + + + + + + + + @@ -177,11 +184,11 @@ - + - + @@ -189,11 +196,15 @@ - + - + + + + +
    Create a Probe at a specified world position in a room.
    Probe(pos, originRoomNumber, dir, dist)Probe(pos, roomNumber, dir, dist) Create a Probe that casts from an origin world position in a room in a given direction for a specified distance.
    Probe(Origin, originRoomNumber, rot, dist)Create a Probe that casts from an origin world position in a room in the direction of a given Rotation for a specified distance.Probe(pos, roomNumber, rot, dist)Create a Probe that casts from an origin world position in a room in the direction of a given rotation for a specified distance.
    Probe(Origin, originRoomNumber, rot, relOffset)Create a Probe that casts from an origin world position, where a given relative offset is rotated according to a given Rotation.Probe(pos, roomNumber, rot, relOffset)Create a Probe that casts from an origin world position, where a given relative offset is rotated according to a given rotation.
    GetPosition() Get the world position of this Probe.
    GetRoom()Get the Room object of this Probe.
    GetRoomName()Get the room name of this Probe.
    GetFloorHeight() Get the floor height at this Probe.
    IsWall()Check if there is a wall at this Probe.Check if the Probe is inside a wall.
    IsInsideSolidGeometry()Check if this Probe is inside solid geometry, i.e.Check if this Probe is inside solid geometry (below a floor, above a ceiling, inside a bridge, or inside a wall).
    IsClimbableWall(headingAngle)
    IsMonkeySwing()Check if there is a monkey swing at this Probe.Check if there is a monkey swing sector at this Probe.
    IsDeath()Check if there is a death tile at this Probe.Check if there is a death sector at this Probe.
    Preview()Preview this Probe in the Collision Stats debug page.
    @@ -221,7 +232,7 @@
  • roomNumber int - Room number. + [opt] Room number. Must be used if probing a position in an overlapping room.
    • @@ -229,7 +240,7 @@
      Probe - a new Probe. + A new Probe.
    @@ -238,7 +249,7 @@
    - Probe(pos, originRoomNumber, dir, dist) + Probe(pos, roomNumber, dir, dist)
    Create a Probe that casts from an origin world position in a room in a given direction for a specified distance. @@ -252,9 +263,9 @@ Vec3 Origin world position to cast from. -
  • originRoomNumber +
  • roomNumber int - Origin's room number. + Origin room number.
  • dir Vec3 @@ -270,7 +281,7 @@
      Probe - a new Probe. + A new Probe.
    @@ -279,23 +290,23 @@
    • - Probe(Origin, originRoomNumber, rot, dist) + Probe(pos, roomNumber, rot, dist)
    - Create a Probe that casts from an origin world position in a room in the direction of a given Rotation for a specified distance. + Create a Probe that casts from an origin world position in a room in the direction of a given rotation for a specified distance. Required to correctly traverse between rooms.

    Parameters:

      -
    • Origin +
    • pos Vec3 - world position to cast from. + Origin world position to cast from.
      • -
    • originRoomNumber +
    • roomNumber int - Origin's room number. + Origin room number.
    • rot Rotation @@ -311,7 +322,7 @@
        Probe - a new Probe. + A new Probe.
      @@ -320,23 +331,23 @@
    - Probe(Origin, originRoomNumber, rot, relOffset) + Probe(pos, roomNumber, rot, relOffset)
    - Create a Probe that casts from an origin world position, where a given relative offset is rotated according to a given Rotation. + Create a Probe that casts from an origin world position, where a given relative offset is rotated according to a given rotation. Required to correctly traverse between rooms.

    Parameters:

      -
    • Origin +
    • pos Vec3 - world position to cast from. + Origin world position to cast from.
      • -
    • originRoomNumber +
    • roomNumber int - Origin's room number. + Origin room number.
    • rot Rotation @@ -352,7 +363,7 @@
        Probe - a new Probe. + A new Probe.
      @@ -379,6 +390,48 @@ +
    +
    + + GetRoom() +
    +
    + Get the Room object of this Probe. + + + + +

    Returns:

    +
      + + Room + Room object. +
    + + + + +
    +
    + + GetRoomName() +
    +
    + Get the room name of this Probe. + + + + +

    Returns:

    +
      + + string + Room name. +
    + + + +
    @@ -393,8 +446,8 @@

    Returns:

      - int[opt] - Floor height. nil: no floor exists. + int + Floor height. nil: no floor exists
    @@ -414,8 +467,8 @@

    Returns:

      - int[opt] - Ceiling height. nil: no ceiling exists. + int + Ceiling height. nil: no ceiling exists
    @@ -435,8 +488,8 @@

    Returns:

      - int[opt] - Water surface height. nil: no water surface exists. + int + Water surface height. nil: no water surface exists
    @@ -456,8 +509,8 @@

    Returns:

      - Vec3[opt] - Floor normal. nil: no floor exists. + Vec3 + Floor normal. nil: no floor exists
    @@ -477,8 +530,8 @@

    Returns:

      - Vec3[opt] - Ceiling normal. nil: no ceiling exists. + Vec3 + Ceiling normal. nil: no ceiling exists
    @@ -498,8 +551,8 @@

    Returns:

      - Collision.MaterialType[opt] - Floor material type. nil: no floor exists. + MaterialType + Floor material type. nil: no floor exists
    @@ -519,8 +572,8 @@

    Returns:

      - Collision.MaterialType[opt] - Ceiling material type. nil: no ceiling exists. + MaterialType + Ceiling material type. nil: no ceiling exists
    @@ -540,8 +593,8 @@

    Returns:

      - bool[opt] - Steep floor status. true: is a steep floor, false: isn't a steep floor, nil: no floor exists. + bool + Steep floor status. true: is a steep floor, false: isn't a steep floor, nil: no floor exists
    @@ -561,8 +614,8 @@

    Returns:

      - bool[opt] - Steep ceiling status. true: is a steep ceiling, false: isn't a steep ceiling, nil: no ceiling exists. + bool + Steep ceiling status. true: is a steep ceiling, false: isn't a steep ceiling, nil: no ceiling exists
    @@ -574,7 +627,7 @@ IsWall()
    - Check if there is a wall at this Probe. Can be used to determine if a wall and ceiling exist. + Check if the Probe is inside a wall. Can be used to determine if a wall and ceiling exist. @@ -595,7 +648,7 @@ IsInsideSolidGeometry()
    - Check if this Probe is inside solid geometry, i.e. below a floor, above a ceiling, or inside a wall. + Check if this Probe is inside solid geometry (below a floor, above a ceiling, inside a bridge, or inside a wall). @@ -632,7 +685,7 @@
      bool - Climbable wall status. true: is climbable, false: isn't climbable + Climbable wall status. true: is climbable wall, false: isn't climbable
    @@ -644,7 +697,7 @@ IsMonkeySwing()
    - Check if there is a monkey swing at this Probe. + Check if there is a monkey swing sector at this Probe. @@ -653,7 +706,7 @@
      bool - Monkey swing status. true: is a monkey swing, false: isn't a monkey swing + Monkey swing sector status. true: is a monkey swing, false: isn't a monkey swing
    @@ -665,7 +718,7 @@ IsDeath()
    - Check if there is a death tile at this Probe. + Check if there is a death sector at this Probe. @@ -674,12 +727,27 @@
      bool - Death tile status. true: is a death tile, false: isn't a death tile + Death sector status. true: is a death sector, false: isn't a death sector
    +
    +
    + + Preview() +
    +
    + Preview this Probe in the Collision Stats debug page. + + + + + + + +
    diff --git a/Documentation/doc/4 enums/Collision.MaterialType.html b/Documentation/doc/4 enums/Collision.MaterialType.html index 869027788..cfaf45565 100644 --- a/Documentation/doc/4 enums/Collision.MaterialType.html +++ b/Documentation/doc/4 enums/Collision.MaterialType.html @@ -79,6 +79,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • +
  • Effects.FeatherMode
  • Flow.ErrorMode
  • Flow.FreezeMode
  • Flow.GameStatus
    • diff --git a/Documentation/doc/4 enums/Effects.FeatherMode.html b/Documentation/doc/4 enums/Effects.FeatherMode.html new file mode 100644 index 000000000..94758a2be --- /dev/null +++ b/Documentation/doc/4 enums/Effects.FeatherMode.html @@ -0,0 +1,172 @@ + + + + + TombEngine 1.7.2 (Developer) Lua API + + + + +
    + +
    + +
    +
    +
    + + +
    + + + + + + +
    + +

    Enum Effects.FeatherMode

    +

    Constants for feather modes.

    +

    + +

    + + +

    Tables

    + + + + + +
    Effects.FeatherModeTable of Effects.FeatherMode constants.
    + +
    +
    + + +

    Tables

    + +
    +
    + + Effects.FeatherMode +
    +
    + +

    Table of Effects.FeatherMode constants. + To be used with Effects.EmitStreamer function.

    + +
      +
    • NONE
      • +
    • CENTER
      • +
    • LEFT
      • +
    • RIGHT
      • +
    + + + + + + + + + + +
    +
    + + +
    +
    +
    +generated by TEN-LDoc (a fork of LDoc 1.4.6) +
    +
    + + diff --git a/Documentation/doc/ldoc.css b/Documentation/doc/ldoc.css index b00cfcf57..fad2a0c62 100644 --- a/Documentation/doc/ldoc.css +++ b/Documentation/doc/ldoc.css @@ -32,7 +32,9 @@ span.types:after { content:")"; } body, td, th { font-size: .95em; line-height: 1.2em;} p { line-height: 1.2em;} -p, ul { margin: 10px 0 0 0px;} +ul { margin: 10px 0 0 0px;} + +p { margin: 3px 0px 0px 0px; } strong { font-weight: bold;} @@ -63,6 +65,10 @@ blockquote { margin-left: 3em; } ul { list-style-type: disc; } +ul li:not(:last-child) { + margin-bottom: 0.3em; +} + p.name { font-family: "Andale Mono", monospace; padding-top: 1em; @@ -103,11 +109,11 @@ table.index td { text-align: left; vertical-align: top; } #main { background-color: #f0f0f0; border-left: 2px solid #cccccc; + display: flex } #navigation { - float: left; - width: 16em; + width: 18em; vertical-align: top; background-color: #f0f0f0; overflow: visible; @@ -141,7 +147,6 @@ table.index td { text-align: left; vertical-align: top; } } #content { - margin-left: 18em; padding: 2em; width: 900px; border-left: 2px solid #cccccc; diff --git a/TombEngine/Game/effects/Streamer.cpp b/TombEngine/Game/effects/Streamer.cpp index 1b1a1a8e1..b836b2d67 100644 --- a/TombEngine/Game/effects/Streamer.cpp +++ b/TombEngine/Game/effects/Streamer.cpp @@ -73,10 +73,10 @@ namespace TEN::Effects::Streamer } } - Streamer::Streamer(StreamerFeatherType featherType, BlendMode blendMode) + Streamer::Streamer(StreamerFeatherMode featherMode, BlendMode blendMode) { _segmentSpawnTimeOffset = GlobalCounter % SEGMENT_SPAWN_INTERVAL_TIME; - _featherType = featherType; + _featherMode = featherMode; _blendMode = blendMode; } @@ -85,9 +85,9 @@ namespace TEN::Effects::Streamer return _segments; } - StreamerFeatherType Streamer::GetFeatherType() const + StreamerFeatherMode Streamer::GetFeatherMode() const { - return _featherType; + return _featherMode; } BlendMode Streamer::GetBlendMode() const @@ -110,7 +110,7 @@ namespace TEN::Effects::Streamer // Avoid creating "clipped" streamers by clamping max life according to max segment count. int lifeMax = (int)std::min(round(life * FPS), (float)SEGMENT_COUNT_MAX); - float alpha = (float(segmentCount + SEGMENT_SPAWN_INTERVAL_TIME) / (float)lifeMax) * FADE_IN_COEFF; + float alpha = (float(segmentCount * SEGMENT_SPAWN_INTERVAL_TIME) / (float)lifeMax) * FADE_IN_COEFF; float opacityMax = EaseInOutSine(colorEnd.w, colorStart.w, alpha); segment.Orientation = AxisAngle(dir, orient); @@ -165,7 +165,7 @@ namespace TEN::Effects::Streamer void StreamerGroup::AddStreamer(int tag, const Vector3& pos, const Vector3& dir, short orient, const Color& colorStart, const Color& colorEnd, float width, float life, float vel, float expRate, short rot, - StreamerFeatherType featherType, BlendMode blendMode) + StreamerFeatherMode featherMode, BlendMode blendMode) { TENAssert(_pools.size() <= POOL_COUNT_MAX, "Streamer pool count overflow."); @@ -174,7 +174,7 @@ namespace TEN::Effects::Streamer return; // Get and extend streamer iteration. - auto& streamer = GetStreamerIteration(tag, featherType, blendMode); + auto& streamer = GetStreamerIteration(tag, featherMode, blendMode); streamer.Extend(pos, dir, orient, colorStart, colorEnd, width, life, vel, expRate, rot, (unsigned int)streamer.GetSegments().size()); } @@ -202,7 +202,7 @@ namespace TEN::Effects::Streamer return pool; } - Streamer& StreamerGroup::GetStreamerIteration(int tag, StreamerFeatherType featherType, BlendMode blendMode) + Streamer& StreamerGroup::GetStreamerIteration(int tag, StreamerFeatherMode featherMode, BlendMode blendMode) { auto& pool = GetPool(tag); TENAssert(pool.size() <= STREAMER_COUNT_MAX, "Streamer pool size overflow."); @@ -220,7 +220,7 @@ namespace TEN::Effects::Streamer pool.erase(pool.begin()); // Add and return new streamer iteration. - return pool.emplace_back(Streamer(featherType, blendMode)); + return pool.emplace_back(Streamer(featherMode, blendMode)); } void StreamerGroup::ClearInactivePools() @@ -259,7 +259,7 @@ namespace TEN::Effects::Streamer void StreamerEffectController::Spawn(int itemNumber, int tag, const Vector3& pos, const Vector3& dir, short orient, const Color& colorStart, const Color& colorEnd, float width, float life, float vel, float expRate, short rot, - StreamerFeatherType featherType, BlendMode blendMode) + StreamerFeatherMode featherMode, BlendMode blendMode) { TENAssert(_groups.size() <= GROUP_COUNT_MAX, "Streamer group count overflow."); @@ -269,7 +269,7 @@ namespace TEN::Effects::Streamer // Add new or extend existing streamer. auto& group = GetGroup(itemNumber); - group.AddStreamer(tag, pos, dir, orient, colorStart, colorEnd, width, life, vel, expRate, rot, featherType, blendMode); + group.AddStreamer(tag, pos, dir, orient, colorStart, colorEnd, width, life, vel, expRate, rot, featherMode, blendMode); } void StreamerEffectController::Update() diff --git a/TombEngine/Game/effects/Streamer.h b/TombEngine/Game/effects/Streamer.h index 9779da6d6..b2700a6fd 100644 --- a/TombEngine/Game/effects/Streamer.h +++ b/TombEngine/Game/effects/Streamer.h @@ -9,7 +9,7 @@ struct ItemInfo; namespace TEN::Effects::Streamer { - enum class StreamerFeatherType + enum class StreamerFeatherMode { None, Center, @@ -62,7 +62,7 @@ namespace TEN::Effects::Streamer std::vector _segments = {}; int _segmentSpawnTimeOffset = 0; // Time in game frames. - StreamerFeatherType _featherType = StreamerFeatherType::None; + StreamerFeatherMode _featherMode = StreamerFeatherMode::None; BlendMode _blendMode = BlendMode::AlphaBlend; bool _isBroken = false; @@ -70,12 +70,12 @@ namespace TEN::Effects::Streamer public: // Constructors - Streamer(StreamerFeatherType featherType, BlendMode blendMode); + Streamer(StreamerFeatherMode featherMode, BlendMode blendMode); // Getters const std::vector& GetSegments() const; - StreamerFeatherType GetFeatherType() const; + StreamerFeatherMode GetFeatherMode() const; BlendMode GetBlendMode() const; // Inquirers @@ -116,14 +116,14 @@ namespace TEN::Effects::Streamer void AddStreamer(int tag, const Vector3& pos, const Vector3& dir, short orient, const Color& colorStart, const Color& colorEnd, float width, float life, float vel, float expRate, short rot, - StreamerFeatherType featherType, BlendMode blendMode); + StreamerFeatherMode featherMode, BlendMode blendMode); void Update(); private: // Helpers std::vector& GetPool(int tag); - Streamer& GetStreamerIteration(int tag, StreamerFeatherType featherType, BlendMode blendMode); + Streamer& GetStreamerIteration(int tag, StreamerFeatherMode featherMode, BlendMode blendMode); void ClearInactivePools(); void ClearInactiveStreamers(int tag); }; @@ -149,7 +149,7 @@ namespace TEN::Effects::Streamer // TODO: Use seconds. void Spawn(int itemNumber, int tag, const Vector3& pos, const Vector3& dir, short orient, const Color& colorStart, const Color& colorEnd, float width, float life, float vel, float expRate, short rot, - StreamerFeatherType featherType = StreamerFeatherType::None, BlendMode blendMode = BlendMode::AlphaBlend); + StreamerFeatherMode featherMode = StreamerFeatherMode::None, BlendMode blendMode = BlendMode::AlphaBlend); void Update(); void Clear(); diff --git a/TombEngine/Objects/TR4/Entity/Wraith.cpp b/TombEngine/Objects/TR4/Entity/Wraith.cpp index 75b719344..90860c590 100644 --- a/TombEngine/Objects/TR4/Entity/Wraith.cpp +++ b/TombEngine/Objects/TR4/Entity/Wraith.cpp @@ -84,21 +84,21 @@ namespace TEN::Entities::TR4 item.Index, (int)TailTag::First, pos, dir0, orient2D, colorStart, COLOR_END, WIDTH, LIFE_MAX, VEL, EXP_RATE, 0, - StreamerFeatherType::Center, BlendMode::Additive); + StreamerFeatherMode::Center, BlendMode::Additive); // Spawn second tail. StreamerEffect.Spawn( item.Index, (int)TailTag::Second, pos, dir1, orient2D, colorStart, COLOR_END, WIDTH, LIFE_MAX, VEL, EXP_RATE, 0, - StreamerFeatherType::Center, BlendMode::Additive); + StreamerFeatherMode::Center, BlendMode::Additive); // Spawn third tail. StreamerEffect.Spawn( item.Index, (int)TailTag::Third, pos, dir2, orient2D, colorStart, COLOR_END, WIDTH, LIFE_MAX, VEL, EXP_RATE, 0, - StreamerFeatherType::Center, BlendMode::Additive); + StreamerFeatherMode::Center, BlendMode::Additive); } static void WraithWallEffect(Vector3i pos, short yRot, int objectNumber) diff --git a/TombEngine/Objects/Utils/VehicleHelpers.cpp b/TombEngine/Objects/Utils/VehicleHelpers.cpp index 88bc07abc..d17ca1ae3 100644 --- a/TombEngine/Objects/Utils/VehicleHelpers.cpp +++ b/TombEngine/Objects/Utils/VehicleHelpers.cpp @@ -385,14 +385,14 @@ namespace TEN::Entities::Vehicles vehicleItem.Index, (int)tagLeft, positions.first, dir, orient2D, COLOR_START, COLOR_END, 0.0f, life, vel, expRate, 0, - StreamerFeatherType::Right, BlendMode::Additive); + StreamerFeatherMode::Right, BlendMode::Additive); // Spawn right wake. StreamerEffect.Spawn( vehicleItem.Index, (int)tagRight, positions.second, dir, orient2D, COLOR_START, COLOR_END, 0.0f, life, vel, expRate, 0, - StreamerFeatherType::Left, BlendMode::Additive); + StreamerFeatherMode::Left, BlendMode::Additive); } void HandleVehicleSpeedometer(float vel, float velMax) diff --git a/TombEngine/Renderer/RendererDrawEffect.cpp b/TombEngine/Renderer/RendererDrawEffect.cpp index ebabe1a2d..3b00f6c5f 100644 --- a/TombEngine/Renderer/RendererDrawEffect.cpp +++ b/TombEngine/Renderer/RendererDrawEffect.cpp @@ -134,10 +134,10 @@ namespace TEN::Renderer auto color = Vector4::Lerp(segment.PrevColor, segment.Color, GetInterpolationFactor()); auto prevColor = Vector4::Lerp(prevSegment.PrevColor, prevSegment.Color, GetInterpolationFactor()); - switch (streamer.GetFeatherType()) + switch (streamer.GetFeatherMode()) { default: - case StreamerFeatherType::None: + case StreamerFeatherMode::None: AddColoredQuad( vertex0, vertex1, prevVertex1, @@ -149,7 +149,7 @@ namespace TEN::Renderer streamer.GetBlendMode(), view); break; - case StreamerFeatherType::Center: + case StreamerFeatherMode::Center: { auto center = (vertex0 + vertex1) / 2; auto prevCenter = (prevVertex0 + prevVertex1) / 2; @@ -165,14 +165,14 @@ namespace TEN::Renderer } break; - case StreamerFeatherType::Left: + case StreamerFeatherMode::Left: AddColoredQuad( vertex0, vertex1, prevVertex1, prevVertex0, color, Vector4::Zero, Vector4::Zero, prevColor, streamer.GetBlendMode(), view); break; - case StreamerFeatherType::Right: + case StreamerFeatherMode::Right: AddColoredQuad( vertex0, vertex1, prevVertex1, prevVertex0, Vector4::Zero, color, prevColor, Vector4::Zero, diff --git a/TombEngine/Scripting/Internal/TEN/Effects/FeatherModes.h b/TombEngine/Scripting/Internal/TEN/Effects/FeatherModes.h new file mode 100644 index 000000000..f0571f4eb --- /dev/null +++ b/TombEngine/Scripting/Internal/TEN/Effects/FeatherModes.h @@ -0,0 +1,30 @@ +#pragma once + +#include "Game/effects/Streamer.h" + +/// Constants for feather modes. +// @enum Effects.FeatherMode +// @pragma nostrip + +/// Table of Effects.FeatherMode constants. +// To be used with @{Effects.EmitStreamer} function. +// +// - `NONE` +// - `CENTER` +// - `LEFT` +// - `RIGHT` +// +// @table Effects.FeatherMode + +using namespace TEN::Effects::Streamer; + +namespace TEN::Scripting::Effects +{ + static const auto FEATHER_MODES = std::unordered_map + { + { "NONE", StreamerFeatherMode::None }, + { "CENTER", StreamerFeatherMode::Center }, + { "LEFT", StreamerFeatherMode::Left }, + { "RIGHT",StreamerFeatherMode::Right} + }; +} diff --git a/TombEngine/TombEngine.vcxproj b/TombEngine/TombEngine.vcxproj index 05fb4ffb8..09e3b0de1 100644 --- a/TombEngine/TombEngine.vcxproj +++ b/TombEngine/TombEngine.vcxproj @@ -883,6 +883,7 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. + From 2f675b0069e5c7c4b81854dcbfd01e27715fce39 Mon Sep 17 00:00:00 2001 From: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Sat, 8 Mar 2025 23:20:18 -0500 Subject: [PATCH 017/160] TR1 hammer (#1588) * First * Implementation * Add retract * Fixing * Finished * Update CHANGELOG.md * Fix Incorrect Death height * Rename file * Formatting; minor fixes * Update Hammer.cpp * Update Hammer.cpp * Reset scale when enabling fly cheat * Update tr1_objects.cpp * Address comments. * Fix Hammer code --------- Co-authored-by: Sezz --- CHANGELOG.md | 2 + TombEngine/Game/Lara/lara.cpp | 32 ++-- TombEngine/Game/Lara/lara_helpers.cpp | 1 + TombEngine/Objects/TR1/Trap/ThorHammer.cpp | 197 +++++++++++++++++++++ TombEngine/Objects/TR1/Trap/ThorHammer.h | 13 ++ TombEngine/Objects/TR1/tr1_objects.cpp | 23 ++- TombEngine/Objects/game_object_ids.h | 2 + TombEngine/TombEngine.vcxproj | 2 + 8 files changed, 252 insertions(+), 20 deletions(-) create mode 100644 TombEngine/Objects/TR1/Trap/ThorHammer.cpp create mode 100644 TombEngine/Objects/TR1/Trap/ThorHammer.h diff --git a/CHANGELOG.md b/CHANGELOG.md index 09d04971f..ff469dd33 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -27,6 +27,8 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): - You must update your Lara object: https://github.com/TombEngine/Resources/raw/main/Wad2%20Objects/Lara/TEN_Lara.wad2 * Added a particle based waterfall emitter object and associated sprite slots. - You must use this version: https://github.com/TombEngine/Resources/raw/refs/heads/main/Wad2%20Objects/Interactables/TEN_Waterfall_Emitter.wad2 +* Added TR1 hammer. + - You must use this version: ### Lua API changes diff --git a/TombEngine/Game/Lara/lara.cpp b/TombEngine/Game/Lara/lara.cpp index 34ba37031..827dc8e42 100644 --- a/TombEngine/Game/Lara/lara.cpp +++ b/TombEngine/Game/Lara/lara.cpp @@ -1,25 +1,6 @@ #include "framework.h" #include "Game/Lara/lara.h" -#include "Game/Lara/lara_basic.h" -#include "Game/Lara/lara_cheat.h" -#include "Game/Lara/lara_climb.h" -#include "Game/Lara/lara_collide.h" -#include "Game/Lara/lara_crawl.h" -#include "Game/Lara/lara_fire.h" -#include "Game/Lara/lara_hang.h" -#include "Game/Lara/lara_helpers.h" -#include "Game/Lara/lara_helpers.h" -#include "Game/Lara/lara_initialise.h" -#include "Game/Lara/lara_jump.h" -#include "Game/Lara/lara_monkey.h" -#include "Game/Lara/lara_objects.h" -#include "Game/Lara/lara_one_gun.h" -#include "Game/Lara/lara_overhang.h" -#include "Game/Lara/lara_slide.h" -#include "Game/Lara/lara_surface.h" -#include "Game/Lara/lara_swim.h" -#include "Game/Lara/lara_tests.h" #include "Game/animation.h" #include "Game/camera.h" #include "Game/collision/collide_item.h" @@ -32,11 +13,24 @@ #include "Game/effects/tomb4fx.h" #include "Game/Gui.h" #include "Game/items.h" +#include "Game/Lara/lara_basic.h" #include "Game/Lara/lara_cheat.h" +#include "Game/Lara/lara_climb.h" #include "Game/Lara/lara_collide.h" +#include "Game/Lara/lara_crawl.h" #include "Game/Lara/lara_fire.h" +#include "Game/Lara/lara_hang.h" #include "Game/Lara/lara_helpers.h" #include "Game/Lara/lara_initialise.h" +#include "Game/Lara/lara_jump.h" +#include "Game/Lara/lara_monkey.h" +#include "Game/Lara/lara_objects.h" +#include "Game/Lara/lara_one_gun.h" +#include "Game/Lara/lara_overhang.h" +#include "Game/Lara/lara_slide.h" +#include "Game/Lara/lara_surface.h" +#include "Game/Lara/lara_swim.h" +#include "Game/Lara/lara_tests.h" #include "Game/Lara/PlayerStateMachine.h" #include "Game/misc.h" #include "Game/savegame.h" diff --git a/TombEngine/Game/Lara/lara_helpers.cpp b/TombEngine/Game/Lara/lara_helpers.cpp index e9a9d475a..63bb5878e 100644 --- a/TombEngine/Game/Lara/lara_helpers.cpp +++ b/TombEngine/Game/Lara/lara_helpers.cpp @@ -802,6 +802,7 @@ void HandlePlayerFlyCheat(ItemInfo& item) item.Animation.Velocity = Vector3::Zero; item.Animation.IsAirborne = true; item.Pose.Position.y -= CLICK(0.5f); + item.Pose.Scale = Vector3::One; item.HitPoints = LARA_HEALTH_MAX; player.Control.WaterStatus = WaterStatus::FlyCheat; diff --git a/TombEngine/Objects/TR1/Trap/ThorHammer.cpp b/TombEngine/Objects/TR1/Trap/ThorHammer.cpp new file mode 100644 index 000000000..4c7c0221a --- /dev/null +++ b/TombEngine/Objects/TR1/Trap/ThorHammer.cpp @@ -0,0 +1,197 @@ +#include "framework.h" +#include "Objects/TR1/Trap/ThorHammer.h" + +#include "Game/camera.h" +#include "Game/collision/collide_item.h" +#include "Game/collision/collide_room.h" +#include "Game/collision/Point.h" +#include "Game/collision/Sphere.h" +#include "Game/effects/effects.h" +#include "Game/Lara/lara.h" +#include "Game/Setup.h" +#include "Math/Math.h" +#include "Scripting/Include/Flow/ScriptInterfaceFlowHandler.h" +#include "Specific/level.h" + +using namespace TEN::Collision::Point; +using namespace TEN::Collision::Sphere; +using namespace TEN::Math; + +// NOTES: +// item.TriggerFlags = 0; Default TR1 behavior. +// item.TriggerFlags = 1; Retract after striking once. +// item.TriggerFlags = 2; Strike continuously. + +namespace TEN::Entities::Traps +{ + constexpr auto HAMMER_HIT_FRAME = 30; + + enum HammerState + { + HAMMER_STATE_IDLE = 0, + HAMMER_STATE_UNSTABLE = 1, + HAMMER_STATE_FALL_START = 2, + HAMMER_STATE_FALL_END = 3, + HAMMER_STATE_RETRACT = 4 + }; + + enum HammerAnim + { + HAMMER_ANIM_IDLE = 0, + HAMMER_ANIM_UNSTABLE = 1, + HAMMER_ANIM_FALL_START = 2, + HAMMER_ANIM_FALL_END = 3, + HAMMER_ANIM_RETRACT = 4 + }; + + void InitializeThorHammer(short itemNumber) + { + auto& headItem = g_Level.Items[itemNumber]; + + int handleItemNumber = SpawnItem(headItem, ID_HAMMER_HEAD); + if (handleItemNumber == NO_VALUE) + { + TENLog("Failed to create hammer handle moveable.", LogLevel::Warning); + return; + } + + auto& handleItem = g_Level.Items[handleItemNumber]; + + // Store hammer handle item number. + headItem.ItemFlags[0] = handleItemNumber; + handleItem.ItemFlags[0] = NO_VALUE; + } + + static void SyncThorHammerHandle(ItemInfo& headItem) + { + int handleItemNumber = headItem.ItemFlags[0]; + auto& handleItem = g_Level.Items[handleItemNumber]; + + // Sync item status. + handleItem.Status = headItem.Status; + + //Sync item TriggerFlag + handleItem.TriggerFlags = headItem.TriggerFlags; + + // Sync animation. + SetAnimation(handleItem, GetAnimNumber(headItem), GetFrameNumber(headItem)); + + // Sync position. + handleItem.Pose = headItem.Pose; + if (handleItem.RoomNumber != headItem.RoomNumber) + ItemNewRoom(handleItem.Index, headItem.RoomNumber); + } + + void ControlThorHammer(short itemNumber) + { + auto& item = g_Level.Items[itemNumber]; + const auto& playerItem = *LaraItem; + + switch (item.Animation.ActiveState) + { + case HAMMER_STATE_IDLE: + if (TriggerActive(&item)) + { + if (std::abs(item.TriggerFlags) == 1 && item.ItemFlags[1] == 1) + { + item.Status = ITEM_NOT_ACTIVE; + break; + + } + + if (std::abs(item.TriggerFlags) == 2) + { + item.Animation.TargetState = HAMMER_STATE_FALL_START; + break; + + } + + item.Animation.TargetState = HAMMER_STATE_UNSTABLE; + } + else + { + RemoveActiveItem(itemNumber); + item.Status = ITEM_NOT_ACTIVE; + } + + break; + + case HAMMER_STATE_UNSTABLE: + if (TriggerActive(&item)) + { + item.Animation.TargetState = HAMMER_STATE_FALL_START; + } + else + { + item.Animation.TargetState = HAMMER_STATE_IDLE; + } + + break; + + case HAMMER_STATE_FALL_START: + break; + + case HAMMER_STATE_FALL_END: + if (std::abs(item.TriggerFlags) > 0) + { + item.Animation.TargetState = HAMMER_STATE_RETRACT; + + if (std::abs(item.TriggerFlags) == 1) + { + item.ItemFlags[1] = 1; + } + } + else + { + item.Status = ITEM_NOT_ACTIVE; + RemoveActiveItem(itemNumber); + } + + break; + } + + AnimateItem(&item); + SyncThorHammerHandle(item); + } + + void CollideThorHammer(short itemNumber, ItemInfo* playerItem, CollisionInfo* coll) + { + auto& item = g_Level.Items[itemNumber]; + + if (!TestBoundsCollide(&item, playerItem, coll->Setup.Radius)) + return; + + if (!HandleItemSphereCollision(item, *playerItem)) + return; + + if (item.Animation.ActiveState == HAMMER_STATE_FALL_START && (item.Animation.FrameNumber - GetAnimData(item).frameBase) <= HAMMER_HIT_FRAME) + { + auto pointColl = GetPointCollision(*playerItem); + + playerItem->Pose.Position.y = pointColl.GetFloorHeight(); + playerItem->Animation.Velocity = Vector3::Zero; + playerItem->Animation.IsAirborne = false; + + if (item.TriggerFlags < 0) + playerItem->Pose.Scale = Vector3(1.0f, 0.1f, 1.0f); + + DoDamage(playerItem, INT_MAX); + SetAnimation(playerItem, LA_BOULDER_DEATH); + } + else if (playerItem->HitPoints > 0) + { + ItemPushItem(&item, playerItem, coll, false, 1); + } + } + + void CollideThorHammerHandle(short itemNumber, ItemInfo* playerItem, CollisionInfo* coll) + { + auto& item = g_Level.Items[itemNumber]; + + if (!TestBoundsCollide(&item, playerItem, coll->Setup.Radius)) + return; + + if (coll->Setup.EnableObjectPush) + ItemPushItem(&item, playerItem, coll, false, 1); + } +} diff --git a/TombEngine/Objects/TR1/Trap/ThorHammer.h b/TombEngine/Objects/TR1/Trap/ThorHammer.h new file mode 100644 index 000000000..97736f830 --- /dev/null +++ b/TombEngine/Objects/TR1/Trap/ThorHammer.h @@ -0,0 +1,13 @@ +#pragma once + +struct CollisionInfo; +struct ItemInfo; +struct ObjectInfo; + +namespace TEN::Entities::Traps +{ + void InitializeThorHammer(short itemNumber); + void ControlThorHammer(short itemNumber); + void CollideThorHammer(short itemNumber, ItemInfo* playerItem, CollisionInfo* coll); + void CollideThorHammerHandle(short itemNumber, ItemInfo* playerItem, CollisionInfo* coll); +} diff --git a/TombEngine/Objects/TR1/tr1_objects.cpp b/TombEngine/Objects/TR1/tr1_objects.cpp index 998a5556b..dcfeb4a6c 100644 --- a/TombEngine/Objects/TR1/tr1_objects.cpp +++ b/TombEngine/Objects/TR1/tr1_objects.cpp @@ -26,9 +26,10 @@ // Traps #include "Objects/TR1/Trap/DamoclesSword.h" +#include "Objects/TR1/Trap/ElectricBall.h" +#include "Objects/TR1/Trap/ThorHammer.h" #include "Objects/TR1/Trap/SlammingDoors.h" #include "Objects/TR1/Trap/SwingingBlade.h" -#include "Objects/TR1/Trap/ElectricBall.h" using namespace TEN::Entities::Creatures::TR1; using namespace TEN::Entities::Traps; @@ -250,6 +251,26 @@ static void StartTrap(ObjectInfo* obj) obj->shadowType = ShadowMode::All; obj->SetHitEffect(true); } + + obj = &Objects[ID_HAMMER_HANDLE]; + if (obj->loaded) + { + CheckIfSlotExists(ID_HAMMER_HEAD, "ID_HAMMER_HEAD"); + obj->Initialize = InitializeThorHammer; + obj->collision = CollideThorHammerHandle; + obj->control = ControlThorHammer; + obj->shadowType = ShadowMode::All; + obj->SetHitEffect(true); + } + + obj = &Objects[ID_HAMMER_HEAD]; + if (obj->loaded) + { + CheckIfSlotExists(ID_HAMMER_HANDLE, "ID_HAMMER_HANDLE"); + obj->collision = CollideThorHammer; + obj->shadowType = ShadowMode::All; + obj->SetHitEffect(true); + } obj = &Objects[ID_SLAMMING_DOORS]; if (obj->loaded) diff --git a/TombEngine/Objects/game_object_ids.h b/TombEngine/Objects/game_object_ids.h index 2b4433f93..f05e14200 100644 --- a/TombEngine/Objects/game_object_ids.h +++ b/TombEngine/Objects/game_object_ids.h @@ -371,6 +371,8 @@ enum GAME_OBJECT_ID : short ID_SWINGING_BLADE, ID_ELECTRIC_BALL, ID_ELECTRIC_BALL_IMPACT_POINT, + ID_HAMMER_HANDLE, + ID_HAMMER_HEAD, ID_PUZZLE_ITEM1 = 500, ID_PUZZLE_ITEM2, diff --git a/TombEngine/TombEngine.vcxproj b/TombEngine/TombEngine.vcxproj index 09e3b0de1..0a7a2b2cf 100644 --- a/TombEngine/TombEngine.vcxproj +++ b/TombEngine/TombEngine.vcxproj @@ -605,6 +605,7 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. + @@ -1140,6 +1141,7 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. + From f1bb383baaed84f8dfea467040184ac48e2e0a0c Mon Sep 17 00:00:00 2001 From: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Sat, 8 Mar 2025 23:30:07 -0500 Subject: [PATCH 018/160] Horizon Effects (#1583) * First Commit * Check * Check * Check * Is it done? * GetHorizonDone * Add HorizonSwap * Fix Interpolation * Update CHANGELOG.md * Update EffectsFunctions.cpp * Update EffectsFunctions.h * Docs * Create Horizon Class and implement it. * Fix Interpolation * Make HorizonObject part of WeatherController * Implement horizon fading * Save horizon parameters * Update CHANGELOG.md * Update RendererDraw.cpp * Update EffectsFunctions.cpp * Invert current horizon transition value if another transition is queued * Add missing shader change * StartPosition * Cleaup * Start working on Position * Code commit * Fix interpolation checks distance for position. * Docs * Update CHANGELOG.md * SavePosition in savegame * Major cleanup * Update weather.cpp * First commit * Some fixes * Reworked horizon workflow * Update CHANGELOG.md * Update docs * Added missing rumble parameter * String constants; use TypeOrNil; general cleanup * Fix documentation * Fix documentation * Update documentation --------- Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com> Co-authored-by: Sezz --- CHANGELOG.md | 4 +- Documentation/doc/1 modules/Effects.html | 38 +- Documentation/doc/1 modules/Flow.html | 2 + Documentation/doc/1 modules/Input.html | 2 + Documentation/doc/1 modules/Inventory.html | 2 + Documentation/doc/1 modules/Logic.html | 2 + Documentation/doc/1 modules/Objects.html | 2 + Documentation/doc/1 modules/Sound.html | 2 + Documentation/doc/1 modules/Strings.html | 2 + Documentation/doc/1 modules/Util.html | 2 + Documentation/doc/1 modules/View.html | 8 +- .../doc/2 classes/Collision.Probe.html | 2 + Documentation/doc/2 classes/Flow.Level.html | 102 +-- .../doc/2 classes/Flow.Settings.html | 2 + .../doc/2 classes/Flow.Statistics.html | 2 + .../doc/2 classes/Objects.AIObject.html | 2 + .../doc/2 classes/Objects.Camera.html | 2 + .../doc/2 classes/Objects.LaraObject.html | 2 + .../doc/2 classes/Objects.Moveable.html | 69 +- Documentation/doc/2 classes/Objects.Room.html | 2 + Documentation/doc/2 classes/Objects.Sink.html | 2 + .../doc/2 classes/Objects.SoundSource.html | 2 + .../doc/2 classes/Objects.Static.html | 2 + .../doc/2 classes/Objects.Volume.html | 2 + .../doc/2 classes/Strings.DisplayString.html | 2 + .../doc/2 classes/View.DisplaySprite.html | 2 + .../doc/3 primitive classes/Color.html | 2 + .../doc/3 primitive classes/Flow.Fog.html | 28 +- .../doc/3 primitive classes/Flow.Horizon.html | 441 ++++++++++++ .../Flow.InventoryItem.html | 2 + .../3 primitive classes/Flow.LensFlare.html | 52 +- .../3 primitive classes/Flow.SkyLayer.html | 2 + .../3 primitive classes/Flow.Starfield.html | 46 +- .../doc/3 primitive classes/Rotation.html | 2 + .../doc/3 primitive classes/Time.html | 2 + .../doc/3 primitive classes/Vec2.html | 2 + .../doc/3 primitive classes/Vec3.html | 2 + .../doc/4 enums/Collision.MaterialType.html | 2 + .../doc/4 enums/Effects.BlendID.html | 2 + .../doc/4 enums/Effects.EffectID.html | 2 + .../doc/4 enums/Effects.FeatherMode.html | 4 +- .../Effects.ParticleAnimationType.html | 4 + Documentation/doc/4 enums/Flow.ErrorMode.html | 2 + .../doc/4 enums/Flow.FreezeMode.html | 2 + .../doc/4 enums/Flow.GameStatus.html | 2 + Documentation/doc/4 enums/Input.ActionID.html | 2 + .../doc/4 enums/Objects.AmmoType.html | 2 + .../doc/4 enums/Objects.HandStatus.html | 2 + .../doc/4 enums/Objects.MoveableStatus.html | 2 + Documentation/doc/4 enums/Objects.ObjID.html | 2 + .../doc/4 enums/Objects.RoomFlagID.html | 2 + .../doc/4 enums/Objects.RoomReverb.html | 2 + .../doc/4 enums/Objects.WeaponType.html | 2 + .../doc/4 enums/Sound.SoundTrackType.html | 2 + .../4 enums/Strings.DisplayStringOption.html | 2 + Documentation/doc/4 enums/Util.LogLevel.html | 2 + Documentation/doc/4 enums/View.AlignMode.html | 2 + .../doc/4 enums/View.CameraType.html | 2 + .../doc/4 enums/View.PostProcessMode.html | 2 + Documentation/doc/4 enums/View.ScaleMode.html | 2 + .../doc/5 lua utility modules/Diary.html | 2 + .../5 lua utility modules/EventSequence.html | 2 + .../doc/5 lua utility modules/Timer.html | 2 + .../doc/5 lua utility modules/Type.html | 2 + Documentation/doc/index.html | 10 + TombEngine/Game/control/control.cpp | 14 +- TombEngine/Game/effects/weather.cpp | 4 +- TombEngine/Game/effects/weather.h | 85 ++- TombEngine/Game/savegame.cpp | 101 +++ TombEngine/Renderer/Renderer.cpp | 1 + TombEngine/Renderer/RendererDraw.cpp | 79 ++- TombEngine/Renderer/RendererFrame.cpp | 4 +- .../Scripting/Include/ScriptInterfaceLevel.h | 13 +- .../Scripting/Internal/ReservedScriptNames.h | 80 ++- .../Internal/TEN/Effects/EffectsFunctions.cpp | 209 +++--- .../Internal/TEN/Flow/FlowHandler.cpp | 3 + .../Scripting/Internal/TEN/Flow/FlowHandler.h | 3 - .../Scripting/Internal/TEN/Flow/Fog/Fog.cpp | 12 +- .../Internal/TEN/Flow/Horizon/Horizon.cpp | 156 +++++ .../Internal/TEN/Flow/Horizon/Horizon.h | 55 ++ .../Internal/TEN/Flow/LensFlare/LensFlare.cpp | 14 +- .../Internal/TEN/Flow/Level/FlowLevel.cpp | 131 ++-- .../Internal/TEN/Flow/Level/FlowLevel.h | 32 +- .../Internal/TEN/Flow/Starfield/Starfield.cpp | 10 +- .../TEN/Objects/Moveable/MoveableObject.cpp | 2 +- .../Internal/TEN/View/ViewHandler.cpp | 6 +- TombEngine/Shaders/Sky.fx | 1 + .../flatbuffers/ten_savegame_generated.h | 663 ++++++++++++++++-- .../Specific/savegame/schema/ten_savegame.fbs | 46 ++ TombEngine/TombEngine.vcxproj | 2 + 90 files changed, 2159 insertions(+), 479 deletions(-) create mode 100644 Documentation/doc/3 primitive classes/Flow.Horizon.html create mode 100644 TombEngine/Scripting/Internal/TEN/Flow/Horizon/Horizon.cpp create mode 100644 TombEngine/Scripting/Internal/TEN/Flow/Horizon/Horizon.h diff --git a/CHANGELOG.md b/CHANGELOG.md index ff469dd33..c40290b1c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -35,6 +35,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Implemented advanced particles allowing animations and other effects. * Added Collision.Probe class for basic room collision detection. * Added diary module. +* Added Flow.Horizon class with and use two layers of horizons in a Flow.Level class. * Added View.GetFlyByPosition() and View.GetFlyByRotation() functions to get flyby sequence parameters at a specified time point. * Added Effects.EmitAirBubble() function to spawn air bubbles. * Added Effects.EmitStreamer() function to emit streamers. @@ -43,7 +44,8 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added various Translate() methods to Vec2 and Vec3 script objects. * Added alpha transparency functionality for statics and moveables by using SetColor() method. * Added extra arguments for sprite object slots and starting rotation value for EmitParticle function. - +* Added ability to save Flow.Level fields such as fog or horizon to a savegame. + ## [Version 1.7.1](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.7.4) - 2025-04-01 ### Bug fixes diff --git a/Documentation/doc/1 modules/Effects.html b/Documentation/doc/1 modules/Effects.html index 209a34899..68c602977 100644 --- a/Documentation/doc/1 modules/Effects.html +++ b/Documentation/doc/1 modules/Effects.html @@ -64,6 +64,7 @@

    3 Primitive Classes

    @@ -578,7 +580,7 @@ EmitAdvancedParticle(particle) EmitAirBubble(pos[, size][, amp])
    - Emit air bubble in a water room. + Emit an air bubble in a water room. @@ -714,8 +716,8 @@ EmitAdvancedParticle(particle)
    - - particleData + + ParticleData
    Structure for EmitAdvancedParticle table. @@ -737,7 +739,7 @@ EmitAdvancedParticle(particle) ID of the sprite sequence object. Default: Objects.ObjID.DEFAULT_SPRITES (optional) -
  • spriteIndex +
  • spriteID int ID of the sprite in the sprite sequence object.Default: 0 (optional) @@ -762,7 +764,7 @@ EmitAdvancedParticle(particle) Specifies the friction with which the particle will slow down over time. Default: 0 (optional)
    • -
  • startRot +
  • startRotation float Rotation at start of life. Default: random (optional) @@ -794,7 +796,7 @@ EmitAdvancedParticle(particle)
  • blendMode BlendID - Render blend mode. TEN.Effects.BlendID.ALPHABLEND + Render blend mode. TEN.Effects.BlendID.ALPHA_BLEND (optional)
  • damage @@ -824,7 +826,7 @@ EmitAdvancedParticle(particle)
  • light bool - Specify if the particle will be emit a light based on its color. Recommended for single particles. Default: false + Specify if the particle will be emit a light based on its color. Caution: Recommended only for a single particle. Having too many particles with lights can overflow the light system. Default: false (optional)
  • lightRadius @@ -839,7 +841,7 @@ EmitAdvancedParticle(particle)
  • sound int - ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. Looping sounds recommended. Default: None + ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. Looping sounds recommended. Caution: Recommended only for a single particle. Having too many particles with sounds can overflow the sound system. Default: None (optional)
  • animated diff --git a/Documentation/doc/1 modules/Flow.html b/Documentation/doc/1 modules/Flow.html index abcade863..251cdc1ac 100644 --- a/Documentation/doc/1 modules/Flow.html +++ b/Documentation/doc/1 modules/Flow.html @@ -64,6 +64,7 @@

    3 Primitive Classes

    • - Starfield:SetStarCount(New) + Starfield:SetStarCount(count)
    Set this starfield's number of stars. @@ -374,9 +384,9 @@

    Parameters:

      -
    • New +
    • count int - star count. + New star count.
    @@ -387,7 +397,7 @@
    - Starfield:SetMeteorCount(New) + Starfield:SetMeteorCount(count)
    Set this starfield's number of meteors. @@ -396,9 +406,9 @@

    Parameters:

      -
    • New +
    • count int - meteor count. + New meteor count.
    @@ -409,7 +419,7 @@
    - Starfield:SetMeteorSpawnDensity(New) + Starfield:SetMeteorSpawnDensity(density)
    Set this starfield's meteor spawn density. @@ -418,9 +428,9 @@

    Parameters:

      -
    • New +
    • density int - meteor spawn density. + New meteor spawn density.
    @@ -431,7 +441,7 @@
    - Starfield:SetMeteorVelocity(New) + Starfield:SetMeteorVelocity(velocity)
    Set this starfield's meteor velocity. @@ -440,9 +450,9 @@

    Parameters:

      -
    • New +
    • velocity float - meteor velocity. + New meteor velocity.
    diff --git a/Documentation/doc/3 primitive classes/Rotation.html b/Documentation/doc/3 primitive classes/Rotation.html index 9ee5bd243..bc19be436 100644 --- a/Documentation/doc/3 primitive classes/Rotation.html +++ b/Documentation/doc/3 primitive classes/Rotation.html @@ -64,6 +64,7 @@

    3 Primitive Classes

    • Flow.Fog
      • +
    • Flow.Horizon
    • Flow.InventoryItem
    • Flow.LensFlare
    • Flow.SkyLayer
      • @@ -79,6 +80,7 @@
    • Collision.MaterialType
    • Effects.BlendID
    • Effects.EffectID
      • +
    • Effects.FeatherMode
    • Effects.ParticleAnimationType
    • Flow.ErrorMode
    • Flow.FreezeMode
      • diff --git a/Documentation/doc/3 primitive classes/Time.html b/Documentation/doc/3 primitive classes/Time.html index 02ea23327..c80e6636e 100644 --- a/Documentation/doc/3 primitive classes/Time.html +++ b/Documentation/doc/3 primitive classes/Time.html @@ -64,6 +64,7 @@

      3 Primitive Classes

      • Flow.Fog
        • +
      • Flow.Horizon
      • Flow.InventoryItem
      • Flow.LensFlare
      • Flow.SkyLayer
        • @@ -79,6 +80,7 @@
      • Collision.MaterialType
      • Effects.BlendID
      • Effects.EffectID
        • +
      • Effects.FeatherMode
      • Effects.ParticleAnimationType
      • Flow.ErrorMode
      • Flow.FreezeMode
        • diff --git a/Documentation/doc/3 primitive classes/Vec2.html b/Documentation/doc/3 primitive classes/Vec2.html index ee464e5aa..7c6dce268 100644 --- a/Documentation/doc/3 primitive classes/Vec2.html +++ b/Documentation/doc/3 primitive classes/Vec2.html @@ -64,6 +64,7 @@

        3 Primitive Classes

        • Flow.Fog
          • +
        • Flow.Horizon
        • Flow.InventoryItem
        • Flow.LensFlare
        • Flow.SkyLayer
          • @@ -79,6 +80,7 @@
        • Collision.MaterialType
        • Effects.BlendID
        • Effects.EffectID
          • +
        • Effects.FeatherMode
        • Effects.ParticleAnimationType
        • Flow.ErrorMode
        • Flow.FreezeMode
          • diff --git a/Documentation/doc/3 primitive classes/Vec3.html b/Documentation/doc/3 primitive classes/Vec3.html index 97a57dc1e..51c9700d1 100644 --- a/Documentation/doc/3 primitive classes/Vec3.html +++ b/Documentation/doc/3 primitive classes/Vec3.html @@ -64,6 +64,7 @@

          3 Primitive Classes

          • Flow.Fog
            • +
          • Flow.Horizon
          • Flow.InventoryItem
          • Flow.LensFlare
          • Flow.SkyLayer
            • @@ -79,6 +80,7 @@
          • Collision.MaterialType
          • Effects.BlendID
          • Effects.EffectID
            • +
          • Effects.FeatherMode
          • Effects.ParticleAnimationType
          • Flow.ErrorMode
          • Flow.FreezeMode
            • diff --git a/Documentation/doc/4 enums/Collision.MaterialType.html b/Documentation/doc/4 enums/Collision.MaterialType.html index cfaf45565..940554fba 100644 --- a/Documentation/doc/4 enums/Collision.MaterialType.html +++ b/Documentation/doc/4 enums/Collision.MaterialType.html @@ -64,6 +64,7 @@

            3 Primitive Classes

            • Flow.Fog
              • +
            • Flow.Horizon
            • Flow.InventoryItem
            • Flow.LensFlare
            • Flow.SkyLayer
              • @@ -80,6 +81,7 @@
            • Effects.BlendID
            • Effects.EffectID
            • Effects.FeatherMode
              • +
            • Effects.ParticleAnimationType
            • Flow.ErrorMode
            • Flow.FreezeMode
            • Flow.GameStatus
              • diff --git a/Documentation/doc/4 enums/Effects.BlendID.html b/Documentation/doc/4 enums/Effects.BlendID.html index b8c32339a..9e264a172 100644 --- a/Documentation/doc/4 enums/Effects.BlendID.html +++ b/Documentation/doc/4 enums/Effects.BlendID.html @@ -64,6 +64,7 @@

              3 Primitive Classes

              • Flow.Fog
                • +
              • Flow.Horizon
              • Flow.InventoryItem
              • Flow.LensFlare
              • Flow.SkyLayer
                • @@ -79,6 +80,7 @@
              • Collision.MaterialType
              • Effects.BlendID
              • Effects.EffectID
                • +
              • Effects.FeatherMode
              • Effects.ParticleAnimationType
              • Flow.ErrorMode
              • Flow.FreezeMode
                • diff --git a/Documentation/doc/4 enums/Effects.EffectID.html b/Documentation/doc/4 enums/Effects.EffectID.html index 2707464af..ff79e7033 100644 --- a/Documentation/doc/4 enums/Effects.EffectID.html +++ b/Documentation/doc/4 enums/Effects.EffectID.html @@ -64,6 +64,7 @@

                3 Primitive Classes

                • Flow.Fog
                  • +
                • Flow.Horizon
                • Flow.InventoryItem
                • Flow.LensFlare
                • Flow.SkyLayer
                  • @@ -79,6 +80,7 @@
                • Collision.MaterialType
                • Effects.BlendID
                • Effects.EffectID
                  • +
                • Effects.FeatherMode
                • Effects.ParticleAnimationType
                • Flow.ErrorMode
                • Flow.FreezeMode
                  • diff --git a/Documentation/doc/4 enums/Effects.FeatherMode.html b/Documentation/doc/4 enums/Effects.FeatherMode.html index 94758a2be..0cd3fee96 100644 --- a/Documentation/doc/4 enums/Effects.FeatherMode.html +++ b/Documentation/doc/4 enums/Effects.FeatherMode.html @@ -64,6 +64,7 @@

                  3 Primitive Classes

                  • Flow.Fog
                    • +
                  • Flow.Horizon
                  • Flow.InventoryItem
                  • Flow.LensFlare
                  • Flow.SkyLayer
                    • @@ -80,6 +81,7 @@
                  • Effects.BlendID
                  • Effects.EffectID
                  • Effects.FeatherMode
                    • +
                  • Effects.ParticleAnimationType
                  • Flow.ErrorMode
                  • Flow.FreezeMode
                  • Flow.GameStatus
                    • @@ -140,7 +142,7 @@

                    Table of Effects.FeatherMode constants. - To be used with Effects.EmitStreamer function.

                    + To be used with ??? function.

                    • NONE
                      • diff --git a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html index 1932ba425..e78b9afbc 100644 --- a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html +++ b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html @@ -45,6 +45,7 @@

                    2 Classes

                      +
                    • Collision.Probe
                    • Flow.Level
                    • Flow.Settings
                    • Flow.Statistics
                      • @@ -63,6 +64,7 @@

                      3 Primitive Classes

                      4 Enums

                        +
                      • Collision.MaterialType
                      • Effects.BlendID
                      • Effects.EffectID
                        • +
                      • Effects.FeatherMode
                      • Effects.ParticleAnimationType
                      • Flow.ErrorMode
                      • Flow.FreezeMode
                        • diff --git a/Documentation/doc/4 enums/Flow.ErrorMode.html b/Documentation/doc/4 enums/Flow.ErrorMode.html index d0831c5f7..ea2882299 100644 --- a/Documentation/doc/4 enums/Flow.ErrorMode.html +++ b/Documentation/doc/4 enums/Flow.ErrorMode.html @@ -64,6 +64,7 @@

                        3 Primitive Classes

                        • Flow.Fog
                          • +
                        • Flow.Horizon
                        • Flow.InventoryItem
                        • Flow.LensFlare
                        • Flow.SkyLayer
                          • @@ -79,6 +80,7 @@
                        • Collision.MaterialType
                        • Effects.BlendID
                        • Effects.EffectID
                          • +
                        • Effects.FeatherMode
                        • Effects.ParticleAnimationType
                        • Flow.ErrorMode
                        • Flow.FreezeMode
                          • diff --git a/Documentation/doc/4 enums/Flow.FreezeMode.html b/Documentation/doc/4 enums/Flow.FreezeMode.html index 82cd76f20..b0b7b74d0 100644 --- a/Documentation/doc/4 enums/Flow.FreezeMode.html +++ b/Documentation/doc/4 enums/Flow.FreezeMode.html @@ -64,6 +64,7 @@

                          3 Primitive Classes

                          • Flow.Fog
                            • +
                          • Flow.Horizon
                          • Flow.InventoryItem
                          • Flow.LensFlare
                          • Flow.SkyLayer
                            • @@ -79,6 +80,7 @@
                          • Collision.MaterialType
                          • Effects.BlendID
                          • Effects.EffectID
                            • +
                          • Effects.FeatherMode
                          • Effects.ParticleAnimationType
                          • Flow.ErrorMode
                          • Flow.FreezeMode
                            • diff --git a/Documentation/doc/4 enums/Flow.GameStatus.html b/Documentation/doc/4 enums/Flow.GameStatus.html index c0b72793a..aa9b3e8da 100644 --- a/Documentation/doc/4 enums/Flow.GameStatus.html +++ b/Documentation/doc/4 enums/Flow.GameStatus.html @@ -64,6 +64,7 @@

                            3 Primitive Classes

                            • Flow.Fog
                              • +
                            • Flow.Horizon
                            • Flow.InventoryItem
                            • Flow.LensFlare
                            • Flow.SkyLayer
                              • @@ -79,6 +80,7 @@
                            • Collision.MaterialType
                            • Effects.BlendID
                            • Effects.EffectID
                              • +
                            • Effects.FeatherMode
                            • Effects.ParticleAnimationType
                            • Flow.ErrorMode
                            • Flow.FreezeMode
                              • diff --git a/Documentation/doc/4 enums/Input.ActionID.html b/Documentation/doc/4 enums/Input.ActionID.html index a6946f688..ede13bb3a 100644 --- a/Documentation/doc/4 enums/Input.ActionID.html +++ b/Documentation/doc/4 enums/Input.ActionID.html @@ -64,6 +64,7 @@

                              3 Primitive Classes

                              • Flow.Fog
                                • +
                              • Flow.Horizon
                              • Flow.InventoryItem
                              • Flow.LensFlare
                              • Flow.SkyLayer
                                • @@ -79,6 +80,7 @@
                              • Collision.MaterialType
                              • Effects.BlendID
                              • Effects.EffectID
                                • +
                              • Effects.FeatherMode
                              • Effects.ParticleAnimationType
                              • Flow.ErrorMode
                              • Flow.FreezeMode
                                • diff --git a/Documentation/doc/4 enums/Objects.AmmoType.html b/Documentation/doc/4 enums/Objects.AmmoType.html index cf75c2e47..1cc6aa18f 100644 --- a/Documentation/doc/4 enums/Objects.AmmoType.html +++ b/Documentation/doc/4 enums/Objects.AmmoType.html @@ -64,6 +64,7 @@

                                3 Primitive Classes

                                • Flow.Fog
                                  • +
                                • Flow.Horizon
                                • Flow.InventoryItem
                                • Flow.LensFlare
                                • Flow.SkyLayer
                                  • @@ -79,6 +80,7 @@
                                • Collision.MaterialType
                                • Effects.BlendID
                                • Effects.EffectID
                                  • +
                                • Effects.FeatherMode
                                • Effects.ParticleAnimationType
                                • Flow.ErrorMode
                                • Flow.FreezeMode
                                  • diff --git a/Documentation/doc/4 enums/Objects.HandStatus.html b/Documentation/doc/4 enums/Objects.HandStatus.html index 88ed9edaa..8cab70060 100644 --- a/Documentation/doc/4 enums/Objects.HandStatus.html +++ b/Documentation/doc/4 enums/Objects.HandStatus.html @@ -64,6 +64,7 @@

                                  3 Primitive Classes

                                  • Flow.Fog
                                    • +
                                  • Flow.Horizon
                                  • Flow.InventoryItem
                                  • Flow.LensFlare
                                  • Flow.SkyLayer
                                    • @@ -79,6 +80,7 @@
                                  • Collision.MaterialType
                                  • Effects.BlendID
                                  • Effects.EffectID
                                    • +
                                  • Effects.FeatherMode
                                  • Effects.ParticleAnimationType
                                  • Flow.ErrorMode
                                  • Flow.FreezeMode
                                    • diff --git a/Documentation/doc/4 enums/Objects.MoveableStatus.html b/Documentation/doc/4 enums/Objects.MoveableStatus.html index 39f63a31c..a0c273c0e 100644 --- a/Documentation/doc/4 enums/Objects.MoveableStatus.html +++ b/Documentation/doc/4 enums/Objects.MoveableStatus.html @@ -64,6 +64,7 @@

                                    3 Primitive Classes

                                    • Flow.Fog
                                      • +
                                    • Flow.Horizon
                                    • Flow.InventoryItem
                                    • Flow.LensFlare
                                    • Flow.SkyLayer
                                      • @@ -79,6 +80,7 @@
                                    • Collision.MaterialType
                                    • Effects.BlendID
                                    • Effects.EffectID
                                      • +
                                    • Effects.FeatherMode
                                    • Effects.ParticleAnimationType
                                    • Flow.ErrorMode
                                    • Flow.FreezeMode
                                      • diff --git a/Documentation/doc/4 enums/Objects.ObjID.html b/Documentation/doc/4 enums/Objects.ObjID.html index 1531a01ba..9b1367920 100644 --- a/Documentation/doc/4 enums/Objects.ObjID.html +++ b/Documentation/doc/4 enums/Objects.ObjID.html @@ -64,6 +64,7 @@

                                      3 Primitive Classes

                                      • Flow.Fog
                                        • +
                                      • Flow.Horizon
                                      • Flow.InventoryItem
                                      • Flow.LensFlare
                                      • Flow.SkyLayer
                                        • @@ -79,6 +80,7 @@
                                      • Collision.MaterialType
                                      • Effects.BlendID
                                      • Effects.EffectID
                                        • +
                                      • Effects.FeatherMode
                                      • Effects.ParticleAnimationType
                                      • Flow.ErrorMode
                                      • Flow.FreezeMode
                                        • diff --git a/Documentation/doc/4 enums/Objects.RoomFlagID.html b/Documentation/doc/4 enums/Objects.RoomFlagID.html index 1d4189b0f..1e099fcad 100644 --- a/Documentation/doc/4 enums/Objects.RoomFlagID.html +++ b/Documentation/doc/4 enums/Objects.RoomFlagID.html @@ -64,6 +64,7 @@

                                        3 Primitive Classes

                                        • Flow.Fog
                                          • +
                                        • Flow.Horizon
                                        • Flow.InventoryItem
                                        • Flow.LensFlare
                                        • Flow.SkyLayer
                                          • @@ -79,6 +80,7 @@
                                        • Collision.MaterialType
                                        • Effects.BlendID
                                        • Effects.EffectID
                                          • +
                                        • Effects.FeatherMode
                                        • Effects.ParticleAnimationType
                                        • Flow.ErrorMode
                                        • Flow.FreezeMode
                                          • diff --git a/Documentation/doc/4 enums/Objects.RoomReverb.html b/Documentation/doc/4 enums/Objects.RoomReverb.html index 201865f7d..846d0228b 100644 --- a/Documentation/doc/4 enums/Objects.RoomReverb.html +++ b/Documentation/doc/4 enums/Objects.RoomReverb.html @@ -64,6 +64,7 @@

                                          3 Primitive Classes

                                          • Flow.Fog
                                            • +
                                          • Flow.Horizon
                                          • Flow.InventoryItem
                                          • Flow.LensFlare
                                          • Flow.SkyLayer
                                            • @@ -79,6 +80,7 @@
                                          • Collision.MaterialType
                                          • Effects.BlendID
                                          • Effects.EffectID
                                            • +
                                          • Effects.FeatherMode
                                          • Effects.ParticleAnimationType
                                          • Flow.ErrorMode
                                          • Flow.FreezeMode
                                            • diff --git a/Documentation/doc/4 enums/Objects.WeaponType.html b/Documentation/doc/4 enums/Objects.WeaponType.html index dbeb7d23b..0f0f62c2c 100644 --- a/Documentation/doc/4 enums/Objects.WeaponType.html +++ b/Documentation/doc/4 enums/Objects.WeaponType.html @@ -64,6 +64,7 @@

                                            3 Primitive Classes

                                            • Flow.Fog
                                              • +
                                            • Flow.Horizon
                                            • Flow.InventoryItem
                                            • Flow.LensFlare
                                            • Flow.SkyLayer
                                              • @@ -79,6 +80,7 @@
                                            • Collision.MaterialType
                                            • Effects.BlendID
                                            • Effects.EffectID
                                              • +
                                            • Effects.FeatherMode
                                            • Effects.ParticleAnimationType
                                            • Flow.ErrorMode
                                            • Flow.FreezeMode
                                              • diff --git a/Documentation/doc/4 enums/Sound.SoundTrackType.html b/Documentation/doc/4 enums/Sound.SoundTrackType.html index 0b424003d..a62e76557 100644 --- a/Documentation/doc/4 enums/Sound.SoundTrackType.html +++ b/Documentation/doc/4 enums/Sound.SoundTrackType.html @@ -64,6 +64,7 @@

                                              3 Primitive Classes

                                              • Flow.Fog
                                                • +
                                              • Flow.Horizon
                                              • Flow.InventoryItem
                                              • Flow.LensFlare
                                              • Flow.SkyLayer
                                                • @@ -79,6 +80,7 @@
                                              • Collision.MaterialType
                                              • Effects.BlendID
                                              • Effects.EffectID
                                                • +
                                              • Effects.FeatherMode
                                              • Effects.ParticleAnimationType
                                              • Flow.ErrorMode
                                              • Flow.FreezeMode
                                                • diff --git a/Documentation/doc/4 enums/Strings.DisplayStringOption.html b/Documentation/doc/4 enums/Strings.DisplayStringOption.html index 88bb56b10..00bbc3e43 100644 --- a/Documentation/doc/4 enums/Strings.DisplayStringOption.html +++ b/Documentation/doc/4 enums/Strings.DisplayStringOption.html @@ -64,6 +64,7 @@

                                                3 Primitive Classes

                                                • Flow.Fog
                                                  • +
                                                • Flow.Horizon
                                                • Flow.InventoryItem
                                                • Flow.LensFlare
                                                • Flow.SkyLayer
                                                  • @@ -79,6 +80,7 @@
                                                • Collision.MaterialType
                                                • Effects.BlendID
                                                • Effects.EffectID
                                                  • +
                                                • Effects.FeatherMode
                                                • Effects.ParticleAnimationType
                                                • Flow.ErrorMode
                                                • Flow.FreezeMode
                                                  • diff --git a/Documentation/doc/4 enums/Util.LogLevel.html b/Documentation/doc/4 enums/Util.LogLevel.html index 8c587a21f..c8ff448e4 100644 --- a/Documentation/doc/4 enums/Util.LogLevel.html +++ b/Documentation/doc/4 enums/Util.LogLevel.html @@ -64,6 +64,7 @@

                                                  3 Primitive Classes

                                                  • Flow.Fog
                                                    • +
                                                  • Flow.Horizon
                                                  • Flow.InventoryItem
                                                  • Flow.LensFlare
                                                  • Flow.SkyLayer
                                                    • @@ -79,6 +80,7 @@
                                                  • Collision.MaterialType
                                                  • Effects.BlendID
                                                  • Effects.EffectID
                                                    • +
                                                  • Effects.FeatherMode
                                                  • Effects.ParticleAnimationType
                                                  • Flow.ErrorMode
                                                  • Flow.FreezeMode
                                                    • diff --git a/Documentation/doc/4 enums/View.AlignMode.html b/Documentation/doc/4 enums/View.AlignMode.html index 63d6ac8cc..3696dd12c 100644 --- a/Documentation/doc/4 enums/View.AlignMode.html +++ b/Documentation/doc/4 enums/View.AlignMode.html @@ -64,6 +64,7 @@

                                                    3 Primitive Classes

                                                    • Flow.Fog
                                                      • +
                                                    • Flow.Horizon
                                                    • Flow.InventoryItem
                                                    • Flow.LensFlare
                                                    • Flow.SkyLayer
                                                      • @@ -79,6 +80,7 @@
                                                    • Collision.MaterialType
                                                    • Effects.BlendID
                                                    • Effects.EffectID
                                                      • +
                                                    • Effects.FeatherMode
                                                    • Effects.ParticleAnimationType
                                                    • Flow.ErrorMode
                                                    • Flow.FreezeMode
                                                      • diff --git a/Documentation/doc/4 enums/View.CameraType.html b/Documentation/doc/4 enums/View.CameraType.html index 133bf7a7a..37d7656b7 100644 --- a/Documentation/doc/4 enums/View.CameraType.html +++ b/Documentation/doc/4 enums/View.CameraType.html @@ -64,6 +64,7 @@

                                                      3 Primitive Classes

                                                      • Flow.Fog
                                                        • +
                                                      • Flow.Horizon
                                                      • Flow.InventoryItem
                                                      • Flow.LensFlare
                                                      • Flow.SkyLayer
                                                        • @@ -79,6 +80,7 @@
                                                      • Collision.MaterialType
                                                      • Effects.BlendID
                                                      • Effects.EffectID
                                                        • +
                                                      • Effects.FeatherMode
                                                      • Effects.ParticleAnimationType
                                                      • Flow.ErrorMode
                                                      • Flow.FreezeMode
                                                        • diff --git a/Documentation/doc/4 enums/View.PostProcessMode.html b/Documentation/doc/4 enums/View.PostProcessMode.html index ac179455f..cb22d26d0 100644 --- a/Documentation/doc/4 enums/View.PostProcessMode.html +++ b/Documentation/doc/4 enums/View.PostProcessMode.html @@ -64,6 +64,7 @@

                                                        3 Primitive Classes

                                                        • Flow.Fog
                                                          • +
                                                        • Flow.Horizon
                                                        • Flow.InventoryItem
                                                        • Flow.LensFlare
                                                        • Flow.SkyLayer
                                                          • @@ -79,6 +80,7 @@
                                                        • Collision.MaterialType
                                                        • Effects.BlendID
                                                        • Effects.EffectID
                                                          • +
                                                        • Effects.FeatherMode
                                                        • Effects.ParticleAnimationType
                                                        • Flow.ErrorMode
                                                        • Flow.FreezeMode
                                                          • diff --git a/Documentation/doc/4 enums/View.ScaleMode.html b/Documentation/doc/4 enums/View.ScaleMode.html index 571e52304..3e90fbcda 100644 --- a/Documentation/doc/4 enums/View.ScaleMode.html +++ b/Documentation/doc/4 enums/View.ScaleMode.html @@ -64,6 +64,7 @@

                                                          3 Primitive Classes

                                                          • Flow.Fog
                                                            • +
                                                          • Flow.Horizon
                                                          • Flow.InventoryItem
                                                          • Flow.LensFlare
                                                          • Flow.SkyLayer
                                                            • @@ -79,6 +80,7 @@
                                                          • Collision.MaterialType
                                                          • Effects.BlendID
                                                          • Effects.EffectID
                                                            • +
                                                          • Effects.FeatherMode
                                                          • Effects.ParticleAnimationType
                                                          • Flow.ErrorMode
                                                          • Flow.FreezeMode
                                                            • diff --git a/Documentation/doc/5 lua utility modules/Diary.html b/Documentation/doc/5 lua utility modules/Diary.html index 483a1ea91..492298007 100644 --- a/Documentation/doc/5 lua utility modules/Diary.html +++ b/Documentation/doc/5 lua utility modules/Diary.html @@ -64,6 +64,7 @@

                                                            3 Primitive Classes

                                                            • Flow.Fog
                                                              • +
                                                            • Flow.Horizon
                                                            • Flow.InventoryItem
                                                            • Flow.LensFlare
                                                            • Flow.SkyLayer
                                                              • @@ -79,6 +80,7 @@
                                                            • Collision.MaterialType
                                                            • Effects.BlendID
                                                            • Effects.EffectID
                                                              • +
                                                            • Effects.FeatherMode
                                                            • Effects.ParticleAnimationType
                                                            • Flow.ErrorMode
                                                            • Flow.FreezeMode
                                                              • diff --git a/Documentation/doc/5 lua utility modules/EventSequence.html b/Documentation/doc/5 lua utility modules/EventSequence.html index 381f10f46..f12fd2f6f 100644 --- a/Documentation/doc/5 lua utility modules/EventSequence.html +++ b/Documentation/doc/5 lua utility modules/EventSequence.html @@ -64,6 +64,7 @@

                                                              3 Primitive Classes

                                                              • Flow.Fog
                                                                • +
                                                              • Flow.Horizon
                                                              • Flow.InventoryItem
                                                              • Flow.LensFlare
                                                              • Flow.SkyLayer
                                                                • @@ -79,6 +80,7 @@
                                                              • Collision.MaterialType
                                                              • Effects.BlendID
                                                              • Effects.EffectID
                                                                • +
                                                              • Effects.FeatherMode
                                                              • Effects.ParticleAnimationType
                                                              • Flow.ErrorMode
                                                              • Flow.FreezeMode
                                                                • diff --git a/Documentation/doc/5 lua utility modules/Timer.html b/Documentation/doc/5 lua utility modules/Timer.html index fd36e2664..550d1d189 100644 --- a/Documentation/doc/5 lua utility modules/Timer.html +++ b/Documentation/doc/5 lua utility modules/Timer.html @@ -64,6 +64,7 @@

                                                                3 Primitive Classes

                                                                • Flow.Fog
                                                                  • +
                                                                • Flow.Horizon
                                                                • Flow.InventoryItem
                                                                • Flow.LensFlare
                                                                • Flow.SkyLayer
                                                                  • @@ -79,6 +80,7 @@
                                                                • Collision.MaterialType
                                                                • Effects.BlendID
                                                                • Effects.EffectID
                                                                  • +
                                                                • Effects.FeatherMode
                                                                • Effects.ParticleAnimationType
                                                                • Flow.ErrorMode
                                                                • Flow.FreezeMode
                                                                  • diff --git a/Documentation/doc/5 lua utility modules/Type.html b/Documentation/doc/5 lua utility modules/Type.html index 0cccf7b95..be9f19aa1 100644 --- a/Documentation/doc/5 lua utility modules/Type.html +++ b/Documentation/doc/5 lua utility modules/Type.html @@ -64,6 +64,7 @@

                                                                  3 Primitive Classes

                                                                  • Flow.Fog
                                                                    • +
                                                                  • Flow.Horizon
                                                                  • Flow.InventoryItem
                                                                  • Flow.LensFlare
                                                                  • Flow.SkyLayer
                                                                    • @@ -79,6 +80,7 @@
                                                                  • Collision.MaterialType
                                                                  • Effects.BlendID
                                                                  • Effects.EffectID
                                                                    • +
                                                                  • Effects.FeatherMode
                                                                  • Effects.ParticleAnimationType
                                                                  • Flow.ErrorMode
                                                                  • Flow.FreezeMode
                                                                    • diff --git a/Documentation/doc/index.html b/Documentation/doc/index.html index d698f7760..d743234d1 100644 --- a/Documentation/doc/index.html +++ b/Documentation/doc/index.html @@ -64,6 +64,7 @@

                                                                    3 Primitive Classes

                                                                    • Flow.Fog
                                                                      • +
                                                                    • Flow.Horizon
                                                                    • Flow.InventoryItem
                                                                    • Flow.LensFlare
                                                                    • Flow.SkyLayer
                                                                      • @@ -79,6 +80,7 @@
                                                                    • Collision.MaterialType
                                                                    • Effects.BlendID
                                                                    • Effects.EffectID
                                                                      • +
                                                                    • Effects.FeatherMode
                                                                    • Effects.ParticleAnimationType
                                                                    • Flow.ErrorMode
                                                                    • Flow.FreezeMode
                                                                      • @@ -246,6 +248,10 @@ local door = GetMoveableByName("door_type4_14") Flow.Fog Distance fog. + + Flow.Horizon + Represents a horizon. + Flow.InventoryItem Represents the properties of an object as it appears in the inventory. @@ -297,6 +303,10 @@ local door = GetMoveableByName("door_type4_14") Effects.EffectID Constants for effect IDs. + + Effects.FeatherMode + Constants for feather modes. + Effects.ParticleAnimationType Constants for particle animation type constants. diff --git a/TombEngine/Game/control/control.cpp b/TombEngine/Game/control/control.cpp index d4bf35e5b..446dbac9c 100644 --- a/TombEngine/Game/control/control.cpp +++ b/TombEngine/Game/control/control.cpp @@ -53,6 +53,7 @@ #include "Scripting/Include/Objects/ScriptInterfaceObjectsHandler.h" #include "Scripting/Include/ScriptInterfaceGame.h" #include "Scripting/Include/Strings/ScriptInterfaceStringsHandler.h" +#include "Scripting/Internal/TEN/Flow/Level/FlowLevel.h" #include "Sound/sound.h" #include "Specific/clock.h" #include "Specific/Input/Input.h" @@ -217,7 +218,7 @@ GameStatus GamePhase(bool insideMenu) UpdateFadeScreenAndCinematicBars(); // Rumble screen (like in submarine level of TRC). - if (g_GameFlow->GetLevel(CurrentLevel)->Rumble) + if (g_GameFlow->GetLevel(CurrentLevel)->GetRumbleEnabled()) RumbleScreen(); DoFlipEffect(FlipEffect, LaraItem); @@ -579,9 +580,13 @@ void InitializeScripting(int levelIndex, bool loadGame) void DeInitializeScripting(int levelIndex, GameStatus reason) { + // Reload gameflow script to clear level script variables. + g_GameFlow->LoadFlowScript(); + g_GameScript->FreeLevelScripts(); g_GameScriptEntities->FreeEntities(); + // If level index is 0, it means we are in a title level and game variables should be cleared. if (levelIndex == 0) g_GameScript->ResetScripts(true); } @@ -698,6 +703,13 @@ void SetupInterpolation() { for (auto& item : g_Level.Items) item.DisableInterpolation = false; + + // HACK: Remove after ScriptInterfaceFlowHandler is deprecated. + auto* level = (Level*)g_GameFlow->GetLevel(CurrentLevel); + level->Horizon1.SetPosition(level->Horizon1.GetPosition(), true); + level->Horizon2.SetPosition(level->Horizon2.GetPosition(), true); + level->Horizon1.SetRotation(level->Horizon1.GetRotation(), true); + level->Horizon2.SetRotation(level->Horizon2.GetRotation(), true); } void HandleControls(bool isTitle) diff --git a/TombEngine/Game/effects/weather.cpp b/TombEngine/Game/effects/weather.cpp index fae652147..472e76fe0 100644 --- a/TombEngine/Game/effects/weather.cpp +++ b/TombEngine/Game/effects/weather.cpp @@ -9,7 +9,7 @@ #include "Game/effects/tomb4fx.h" #include "Game/savegame.h" #include "Game/Setup.h" -#include "Math.h" +#include "Math/Math.h" #include "Objects/game_object_ids.h" #include "Sound/sound.h" #include "Scripting/Include/ScriptInterfaceLevel.h" @@ -19,7 +19,7 @@ using namespace TEN::Collision::Point; using namespace TEN::Effects::Ripple; using namespace TEN::Math; -namespace TEN::Effects::Environment +namespace TEN::Effects::Environment { EnvironmentController Weather; diff --git a/TombEngine/Game/effects/weather.h b/TombEngine/Game/effects/weather.h index ad06bbc9b..b112554ff 100644 --- a/TombEngine/Game/effects/weather.h +++ b/TombEngine/Game/effects/weather.h @@ -1,6 +1,7 @@ #pragma once -#include "Math/Math.h" + #include "Objects/Effects/LensFlare.h" +#include "Objects/game_object_ids.h" #include "Scripting/Include/ScriptInterfaceLevel.h" using namespace TEN::Entities::Effects; @@ -100,6 +101,48 @@ namespace TEN::Effects::Environment class EnvironmentController { + private: + // Weather + + std::vector Particles = {}; + + // Sky + + Vector4 SkyCurrentColor[2] = {}; + short SkyCurrentPosition[2] = {}; + + // Wind + + int WindX = 0; + int WindZ = 0; + int WindAngle = 0; + int WindDAngle = 0; + int WindCurrent = 0; + + // Flash fader + + Vector3 FlashColorBase = Vector3::Zero; + float FlashSpeed = 1.0f; + float FlashProgress = 0.0f; + + // Lightning + + int StormCount = 0; + int StormRand = 0; + int StormTimer = 0; + byte StormSkyColor = 1; + byte StormSkyColor2 = 1; + + // Starfield + + std::vector Stars = {}; + std::vector Meteors = {}; + bool ResetStarField = true; + + // Lens flare + + LensFlare GlobalLensFlare = {}; + public: EnvironmentController(); @@ -117,47 +160,13 @@ namespace TEN::Effects::Environment const std::vector& GetMeteors() const { return Meteors; } private: - // Weather - std::vector Particles = {}; - - // Sky - Vector4 SkyCurrentColor[2] = {}; - short SkyCurrentPosition[2] = {}; - - // Wind - int WindX = 0; - int WindZ = 0; - int WindAngle = 0; - int WindDAngle = 0; - int WindCurrent = 0; - - // Flash fader - Vector3 FlashColorBase = Vector3::Zero; - float FlashSpeed = 1.0f; - float FlashProgress = 0.0f; - - // Lightning - int StormCount = 0; - int StormRand = 0; - int StormTimer = 0; - byte StormSkyColor = 1; - byte StormSkyColor2 = 1; - - // Starfield - std::vector Stars = {}; - std::vector Meteors = {}; - bool ResetStarField = true; - - // Lens flare - LensFlare GlobalLensFlare = {}; - - void UpdateStarfield(const ScriptInterfaceLevel& level); + void UpdateWeather(const ScriptInterfaceLevel& level); void UpdateSky(const ScriptInterfaceLevel& level); - void UpdateStorm(const ScriptInterfaceLevel& level); void UpdateWind(const ScriptInterfaceLevel& level); void UpdateFlash(const ScriptInterfaceLevel& level); - void UpdateWeather(const ScriptInterfaceLevel& level); void UpdateLightning(); + void UpdateStarfield(const ScriptInterfaceLevel& level); + void UpdateStorm(const ScriptInterfaceLevel& level); void SpawnDustParticles(const ScriptInterfaceLevel& level); void SpawnWeatherParticles(const ScriptInterfaceLevel& level); diff --git a/TombEngine/Game/savegame.cpp b/TombEngine/Game/savegame.cpp index fcfaf604d..b98d05f69 100644 --- a/TombEngine/Game/savegame.cpp +++ b/TombEngine/Game/savegame.cpp @@ -12,6 +12,7 @@ #include "Game/control/volume.h" #include "Game/effects/item_fx.h" #include "Game/effects/effects.h" +#include "Game/effects/weather.h" #include "Game/items.h" #include "Game/itemdata/creature_info.h" #include "Game/Lara/lara.h" @@ -30,6 +31,7 @@ #include "Objects/TR5/Emitter/tr5_bats_emitter.h" #include "Objects/TR5/Emitter/tr5_spider_emitter.h" #include "Renderer/Renderer.h" +#include "Scripting/Internal/TEN/Flow//Level/FlowLevel.h" #include "Scripting/Include/ScriptInterfaceGame.h" #include "Scripting/Include/ScriptInterfaceLevel.h" #include "Scripting/Include/Objects/ScriptInterfaceObjectsHandler.h" @@ -42,6 +44,7 @@ using namespace flatbuffers; using namespace TEN::Collision::Floordata; using namespace TEN::Control::Volumes; using namespace TEN::Effects::Items; +using namespace TEN::Effects::Environment; using namespace TEN::Entities::Creatures::TR3; using namespace TEN::Entities::Generic; using namespace TEN::Entities::Switches; @@ -1086,6 +1089,54 @@ const std::vector SaveGame::Build() auto staticMeshesOffset = fbb.CreateVector(staticMeshes); auto volumesOffset = fbb.CreateVector(volumes); + // Level state + auto* level = (Level*)g_GameFlow->GetLevel(CurrentLevel); + Save::LevelDataBuilder levelData { fbb }; + + levelData.add_level_far_view(level->LevelFarView); + + levelData.add_fog_enabled(level->Fog.Enabled); + levelData.add_fog_color(level->Fog.GetColor()); + levelData.add_fog_min_distance(level->Fog.MinDistance); + levelData.add_fog_max_distance(level->Fog.MaxDistance); + + levelData.add_sky_layer_1_enabled(level->GetSkyLayerEnabled(0)); + levelData.add_sky_layer_1_color(level->GetSkyLayerColor(0)); + levelData.add_sky_layer_1_speed(level->GetSkyLayerSpeed(0)); + + levelData.add_sky_layer_2_enabled(level->GetSkyLayerEnabled(1)); + levelData.add_sky_layer_2_color(level->GetSkyLayerColor(1)); + levelData.add_sky_layer_2_speed(level->GetSkyLayerSpeed(1)); + + levelData.add_lensflare_color(level->LensFlare.GetColor()); + levelData.add_lensflare_pitch(level->LensFlare.GetPitch()); + levelData.add_lensflare_yaw(level->LensFlare.GetYaw()); + levelData.add_lensflare_sprite_id(level->LensFlare.GetSunSpriteID()); + + levelData.add_starfield_meteor_count(level->Starfield.GetMeteorCount()); + levelData.add_starfield_meteor_spawn_density(level->Starfield.GetMeteorSpawnDensity()); + levelData.add_starfield_meteor_velocity(level->Starfield.GetMeteorVelocity()); + levelData.add_starfield_star_count(level->Starfield.GetStarCount()); + + levelData.add_horizon1_enabled(level->Horizon1.GetEnabled()); + levelData.add_horizon1_object_id(level->Horizon1.GetObjectID()); + levelData.add_horizon1_position(&FromVector3(level->GetHorizonPosition(0))); + levelData.add_horizon1_orientation(&FromEulerAngles(level->GetHorizonOrientation(0))); + levelData.add_horizon1_transparency(level->Horizon1.GetTransparency()); + + levelData.add_horizon2_enabled(level->Horizon2.GetEnabled()); + levelData.add_horizon2_object_id(level->Horizon2.GetObjectID()); + levelData.add_horizon2_position(&FromVector3(level->GetHorizonPosition(1))); + levelData.add_horizon2_orientation(&FromEulerAngles(level->GetHorizonOrientation(1))); + levelData.add_horizon2_transparency(level->Horizon2.GetTransparency()); + + levelData.add_storm_enabled(level->Storm); + levelData.add_rumble_enabled(level->Rumble); + levelData.add_weather_type((int)level->Weather); + levelData.add_weather_strength(level->WeatherStrength); + + auto levelDataOffset = levelData.Finish(); + // Global event sets std::vector> globalEventSets{}; for (int j = 0; j < g_Level.GlobalEventSets.size(); j++) @@ -1484,6 +1535,7 @@ const std::vector SaveGame::Build() sgb.add_header(headerOffset); sgb.add_level(levelStatisticsOffset); sgb.add_game(gameStatisticsOffset); + sgb.add_level_data(levelDataOffset); sgb.add_secret_bits(SaveGame::Statistics.SecretBits); sgb.add_camera(cameraOffset); sgb.add_lara(laraOffset); @@ -1499,6 +1551,7 @@ const std::vector SaveGame::Build() sgb.add_postprocess_strength(g_Renderer.GetPostProcessStrength()); sgb.add_postprocess_tint(&FromVector3(g_Renderer.GetPostProcessTint())); sgb.add_soundtracks(soundtrackOffset); + sgb.add_cd_flags(soundtrackMapOffset); sgb.add_action_queue(actionQueueOffset); sgb.add_flip_maps(flipMapsOffset); @@ -1737,6 +1790,50 @@ static void ParseStatistics(const Save::SaveGame* s, bool isHub) static void ParseLua(const Save::SaveGame* s, bool hubMode) { + // Global level data + + auto* level = (Level*)g_GameFlow->GetLevel(CurrentLevel); + + level->Fog.Enabled = s->level_data()->fog_enabled(); + level->Fog.MaxDistance = s->level_data()->fog_max_distance(); + level->Fog.MinDistance = s->level_data()->fog_min_distance(); + level->Fog.SetColor(s->level_data()->fog_color()); + + level->Layer1.Enabled = s->level_data()->sky_layer_1_enabled(); + level->Layer1.CloudSpeed = s->level_data()->sky_layer_1_speed(); + level->Layer1.SetColor(s->level_data()->sky_layer_1_color()); + + level->Layer2.Enabled = s->level_data()->sky_layer_2_enabled(); + level->Layer2.CloudSpeed = s->level_data()->sky_layer_2_speed(); + level->Layer2.SetColor(s->level_data()->sky_layer_2_color()); + + level->LensFlare.SetSunSpriteID(s->level_data()->lensflare_sprite_id()); + level->LensFlare.SetPitch(s->level_data()->lensflare_pitch()); + level->LensFlare.SetYaw(s->level_data()->lensflare_yaw()); + level->LensFlare.SetColor(s->level_data()->lensflare_color()); + + level->Starfield.SetStarCount(s->level_data()->starfield_star_count()); + level->Starfield.SetMeteorCount(s->level_data()->starfield_meteor_count()); + level->Starfield.SetMeteorSpawnDensity(s->level_data()->starfield_meteor_spawn_density()); + level->Starfield.SetMeteorVelocity(s->level_data()->starfield_meteor_velocity()); + + level->Horizon1.SetEnabled(s->level_data()->horizon1_enabled()); + level->Horizon1.SetObjectID((GAME_OBJECT_ID)s->level_data()->horizon1_object_id()); + level->Horizon1.SetPosition(ToVector3(s->level_data()->horizon1_position()), true); + level->Horizon1.SetRotation(ToEulerAngles(s->level_data()->horizon1_orientation()), true); + level->Horizon1.SetTransparency(s->level_data()->horizon1_transparency()); + + level->Horizon2.SetEnabled(s->level_data()->horizon2_enabled()); + level->Horizon2.SetObjectID((GAME_OBJECT_ID)s->level_data()->horizon2_object_id()); + level->Horizon2.SetPosition(ToVector3(s->level_data()->horizon2_position()), true); + level->Horizon2.SetRotation(ToEulerAngles(s->level_data()->horizon2_orientation()), true); + level->Horizon2.SetTransparency(s->level_data()->horizon2_transparency()); + + level->Storm = s->level_data()->storm_enabled(); + level->Rumble = s->level_data()->rumble_enabled(); + level->Weather = (WeatherType)s->level_data()->weather_type(); + level->WeatherStrength = s->level_data()->weather_strength(); + // Event sets if (g_Level.VolumeEventSets.size() == s->volume_event_sets()->size()) @@ -1765,6 +1862,8 @@ static void ParseLua(const Save::SaveGame* s, bool hubMode) } } + // Variables + auto loadedVars = std::vector{}; auto unionVec = s->script_vars(); @@ -1850,6 +1949,8 @@ static void ParseLua(const Save::SaveGame* s, bool hubMode) g_GameScript->SetVariables(loadedVars, hubMode); + // Callbacks + auto populateCallbackVecs = [&s](auto callbackFunc) { auto callbacksVec = std::vector{}; diff --git a/TombEngine/Renderer/Renderer.cpp b/TombEngine/Renderer/Renderer.cpp index 39d3e5e76..b4c83e8d9 100644 --- a/TombEngine/Renderer/Renderer.cpp +++ b/TombEngine/Renderer/Renderer.cpp @@ -16,6 +16,7 @@ namespace TEN::Renderer { using namespace TEN::Renderer::Structures; using namespace Utils; + Renderer g_Renderer; Renderer::Renderer() : diff --git a/TombEngine/Renderer/RendererDraw.cpp b/TombEngine/Renderer/RendererDraw.cpp index a08ada9cd..948264df7 100644 --- a/TombEngine/Renderer/RendererDraw.cpp +++ b/TombEngine/Renderer/RendererDraw.cpp @@ -33,14 +33,13 @@ #include "Specific/level.h" #include "Specific/winmain.h" -using namespace std::chrono; using namespace TEN::Effects::Hair; -using namespace TEN::Entities::Creatures::TR3; -using namespace TEN::Entities::Generic; using namespace TEN::Hud; -using namespace TEN::Renderer::Structures; using namespace TEN::Effects::Environment; using namespace TEN::Effects::DisplaySprite; +using namespace TEN::Entities::Creatures::TR3; +using namespace TEN::Entities::Generic; +using namespace TEN::Renderer::Structures; extern GUNSHELL_STRUCT Gunshells[MAX_GUNSHELL]; @@ -1932,6 +1931,8 @@ namespace TEN::Renderer void Renderer::RenderSimpleSceneToParaboloid(RenderTarget2D* renderTarget, Vector3 position, int emisphere) { + // TODO: Update the horizon draw code here once paraboloids are required. TrainWreck Feb 2, 2025. + // Reset GPU state SetBlendMode(BlendMode::Opaque); SetCullMode(CullMode::CounterClockwise); @@ -1981,10 +1982,10 @@ namespace TEN::Renderer view.FillConstantBuffer(cameraConstantBuffer); _cbCameraMatrices.UpdateData(cameraConstantBuffer, _context.Get()); - // Draw horizon and the sky + // Draw horizon and sky. auto* levelPtr = g_GameFlow->GetLevel(CurrentLevel); - if (levelPtr->Horizon) + if (levelPtr->GetHorizonEnabled(0) || levelPtr->GetHorizonEnabled(1)) { _shaders.Bind(Shader::RoomAmbientSky); @@ -2026,31 +2027,26 @@ namespace TEN::Renderer _context->ClearDepthStencilView(renderTarget->DepthStencilView.Get(), D3D11_CLEAR_DEPTH | D3D11_CLEAR_STENCIL, 1, 0); // Draw horizon. - if (_moveableObjects[ID_HORIZON].has_value()) + if (_moveableObjects[ID_HORIZON].has_value()) // FIXME: Replace with same function as in the main pipeline! { _context->IASetVertexBuffers(0, 1, _moveablesVertexBuffer.Buffer.GetAddressOf(), &stride, &offset); _context->IASetIndexBuffer(_moveablesIndexBuffer.Buffer.Get(), DXGI_FORMAT_R32_UINT, 0); - auto& moveableObj = *_moveableObjects[ID_HORIZON]; + const auto& moveableObj = *_moveableObjects[ID_HORIZON]; // FIXME: Replace with same function as in the main pipeline! _stStatic.World = Matrix::CreateTranslation(LaraItem->Pose.Position.ToVector3()); _stStatic.Color = Vector4::One; _stStatic.ApplyFogBulbs = 1; _cbStatic.UpdateData(_stStatic, _context.Get()); - for (int k = 0; k < moveableObj.ObjectMeshes.size(); k++) + for (const auto* mesh : moveableObj.ObjectMeshes) { - auto* meshPtr = moveableObj.ObjectMeshes[k]; - - for (auto& bucket : meshPtr->Buckets) + for (const auto& bucket : mesh->Buckets) { if (bucket.NumVertices == 0) - { continue; - } - BindTexture(TextureRegister::ColorMap, &std::get<0>(_moveablesTextures[bucket.Texture]), - SamplerStateRegister::AnisotropicClamp); + BindTexture(TextureRegister::ColorMap, &std::get<0>(_moveablesTextures[bucket.Texture]), SamplerStateRegister::AnisotropicClamp); // Always render horizon as alpha-blended surface. SetBlendMode(bucket.BlendMode == BlendMode::AlphaTest ? BlendMode::AlphaBlend : bucket.BlendMode); @@ -2071,8 +2067,8 @@ namespace TEN::Renderer _shaders.Bind(Shader::RoomAmbient); // Draw rooms - UINT stride = sizeof(Vertex); - UINT offset = 0; + unsigned int stride = sizeof(Vertex); + unsigned int offset = 0; // Bind vertex and index buffer. _context->IASetVertexBuffers(0, 1, _roomsVertexBuffer.Buffer.GetAddressOf(), &stride, &offset); @@ -2081,8 +2077,8 @@ namespace TEN::Renderer for (int i = 0; i < _rooms.size(); i++) { int index = i; - RendererRoom* room = &_rooms[index]; - ROOM_INFO* nativeRoom = &g_Level.Rooms[room->RoomNumber]; + auto* room = &_rooms[index]; + auto* nativeRoom = &g_Level.Rooms[room->RoomNumber]; // Avoid drawing of too far rooms... Environment map is tiny, blurred, so very far rooms would not contribute to the // final pixel colors @@ -2103,9 +2099,7 @@ namespace TEN::Renderer for (auto& bucket : room->Buckets) { if (bucket.NumVertices == 0) - { continue; - } SetBlendMode(bucket.BlendMode); SetAlphaTest(AlphaTestMode::GreatherThan, ALPHA_TEST_THRESHOLD); @@ -2850,7 +2844,7 @@ namespace TEN::Renderer } } - if (!levelPtr->Horizon || !anyOutsideRooms) + if ((!levelPtr->GetHorizonEnabled(0) && !levelPtr->GetHorizonEnabled(1)) || !anyOutsideRooms) return; if (Lara.Control.Look.OpticRange != 0) @@ -2870,21 +2864,21 @@ namespace TEN::Renderer SetBlendMode(BlendMode::Additive); - for (int s = 0; s < 2; s++) + for (int layer = 0; layer < 2; layer++) { for (int i = 0; i < 2; i++) { auto weather = TEN::Effects::Environment::Weather; auto translation = Matrix::CreateTranslation( - renderView.Camera.WorldPosition.x + weather.SkyPosition(s) - i * SKY_SIZE, + renderView.Camera.WorldPosition.x + weather.SkyPosition(layer) - i * SKY_SIZE, renderView.Camera.WorldPosition.y - 1536.0f, renderView.Camera.WorldPosition.z); auto world = rotation * translation; _stStatic.World = (rotation * translation); - _stStatic.Color = weather.SkyColor(s); - _stStatic.ApplyFogBulbs = s == 0 ? 1 : 0; + _stStatic.Color = weather.SkyColor(layer); + _stStatic.ApplyFogBulbs = layer == 0 ? 1 : 0; _cbStatic.UpdateData(_stStatic, _context.Get()); DrawIndexedTriangles(SKY_INDICES_COUNT, 0, 0); @@ -3033,8 +3027,11 @@ namespace TEN::Renderer } // Draw horizon. - if (_moveableObjects[ID_HORIZON].has_value()) + for (int layer = 0; layer < 2; layer++) { + if (!levelPtr->GetHorizonEnabled(layer)) + continue; + SetDepthState(DepthState::None); SetBlendMode(BlendMode::Opaque); SetCullMode(CullMode::CounterClockwise); @@ -3044,29 +3041,31 @@ namespace TEN::Renderer _shaders.Bind(Shader::Sky); - auto& moveableObj = *_moveableObjects[ID_HORIZON]; + auto pos = Vector3::Lerp(levelPtr->GetHorizonPrevPosition(layer), levelPtr->GetHorizonPosition(layer), GetInterpolationFactor()); + auto orient = EulerAngles::Lerp(levelPtr->GetHorizonPrevOrientation(layer), levelPtr->GetHorizonOrientation(layer), GetInterpolationFactor()); + auto rotMatrix = orient.ToRotationMatrix(); + auto translationMatrix = Matrix::CreateTranslation(pos); + auto cameraMatrix = Matrix::CreateTranslation(renderView.Camera.WorldPosition); - _stStatic.World = Matrix::CreateTranslation(renderView.Camera.WorldPosition); - _stStatic.Color = Vector4::One; + float alpha = levelPtr->GetHorizonTransparency(layer); + + _stStatic.World = rotMatrix * translationMatrix * cameraMatrix; + _stStatic.Color = Color(1.0f, 1.0f, 1.0f, alpha); _stStatic.ApplyFogBulbs = 1; _cbStatic.UpdateData(_stStatic, _context.Get()); - for (int k = 0; k < moveableObj.ObjectMeshes.size(); k++) + const auto& moveableObj = *_moveableObjects[levelPtr->GetHorizonObjectID(layer)]; + for (const auto* mesh : moveableObj.ObjectMeshes) { - auto* meshPtr = moveableObj.ObjectMeshes[k]; - - for (auto& bucket : meshPtr->Buckets) + for (const auto& bucket : mesh->Buckets) { if (bucket.NumVertices == 0) - { continue; - } - BindTexture(TextureRegister::ColorMap, &std::get<0>(_moveablesTextures[bucket.Texture]), - SamplerStateRegister::AnisotropicClamp); + BindTexture(TextureRegister::ColorMap, &std::get<0>(_moveablesTextures[bucket.Texture]), SamplerStateRegister::AnisotropicClamp); // Always render horizon as alpha-blended surface. - SetBlendMode(bucket.BlendMode == BlendMode::AlphaTest ? BlendMode::AlphaBlend : bucket.BlendMode); + SetBlendMode(GetBlendModeFromAlpha((bucket.BlendMode == BlendMode::AlphaTest) ? BlendMode::AlphaBlend : bucket.BlendMode, alpha)); SetAlphaTest(AlphaTestMode::None, ALPHA_TEST_THRESHOLD); // Draw vertices. diff --git a/TombEngine/Renderer/RendererFrame.cpp b/TombEngine/Renderer/RendererFrame.cpp index 0d4d2318a..d52752af6 100644 --- a/TombEngine/Renderer/RendererFrame.cpp +++ b/TombEngine/Renderer/RendererFrame.cpp @@ -5,6 +5,7 @@ #include "Game/camera.h" #include "Game/collision/Sphere.h" #include "Game/effects/effects.h" +#include "Game/effects/weather.h" #include "Game/items.h" #include "Game/Lara/lara.h" #include "Game/Setup.h" @@ -16,8 +17,9 @@ #include "Specific/level.h" #include "Specific/trutils.h" -using namespace TEN::Entities::Effects; using namespace TEN::Collision::Sphere; +using namespace TEN::Effects::Environment; +using namespace TEN::Entities::Effects; using namespace TEN::Math; using namespace TEN::Utils; diff --git a/TombEngine/Scripting/Include/ScriptInterfaceLevel.h b/TombEngine/Scripting/Include/ScriptInterfaceLevel.h index 484f3a45f..0453d4cee 100644 --- a/TombEngine/Scripting/Include/ScriptInterfaceLevel.h +++ b/TombEngine/Scripting/Include/ScriptInterfaceLevel.h @@ -22,9 +22,6 @@ enum class LaraType class ScriptInterfaceLevel { public: - bool Horizon = false; - bool Rumble = false; - std::string NameStringKey = {}; std::string FileName = {}; std::string ScriptFileName = {}; @@ -36,6 +33,7 @@ public: virtual short GetSkyLayerSpeed(int index) const = 0; virtual LaraType GetLaraType() const = 0; virtual bool GetStormEnabled() const = 0; + virtual bool GetRumbleEnabled() const = 0; virtual float GetWeatherStrength() const = 0; virtual WeatherType GetWeatherType() const = 0; virtual RGBAColor8Byte GetSkyLayerColor(int index) const = 0; @@ -48,6 +46,15 @@ public: virtual std::string GetAmbientTrack() const = 0; virtual bool GetResetHubEnabled() const = 0; + // Horizon getters + virtual bool GetHorizonEnabled(int index) const = 0; + virtual GAME_OBJECT_ID GetHorizonObjectID(int index) const = 0; + virtual float GetHorizonTransparency(int index) const = 0; + virtual Vector3 GetHorizonPosition(int index) const = 0; + virtual EulerAngles GetHorizonOrientation(int index) const = 0; + virtual Vector3 GetHorizonPrevPosition(int index) const = 0; + virtual EulerAngles GetHorizonPrevOrientation(int index) const = 0; + // Lens flare getters virtual bool GetLensFlareEnabled() const = 0; virtual int GetLensFlareSunSpriteID() const = 0; diff --git a/TombEngine/Scripting/Internal/ReservedScriptNames.h b/TombEngine/Scripting/Internal/ReservedScriptNames.h index 01c10eb85..641244bd9 100644 --- a/TombEngine/Scripting/Internal/ReservedScriptNames.h +++ b/TombEngine/Scripting/Internal/ReservedScriptNames.h @@ -322,7 +322,8 @@ static constexpr char ScriptReserved_EmitAirBubble[] = "EmitAirBubble"; static constexpr char ScriptReserved_EmitFire[] = "EmitFire"; static constexpr char ScriptReserved_MakeExplosion[] = "MakeExplosion"; static constexpr char ScriptReserved_MakeEarthquake[] = "MakeEarthquake"; -static constexpr char ScriptReserved_GetWind[] = "GetWind"; + +static constexpr char ScriptReserved_GetWind[] = "GetWind"; static constexpr char ScriptReserved_Vibrate[] = "Vibrate"; static constexpr char ScriptReserved_FlashScreen[] = "FlashScreen"; static constexpr char ScriptReserved_FadeIn[] = "FadeIn"; @@ -400,6 +401,54 @@ static constexpr char ScriptReserved_LogLevelError[] = "ERROR"; // Internal static constexpr char ScriptReserved_LaraObject[] = "LaraObject"; +// ========= +// COLLISION +// ========= + +constexpr char ScriptReserved_Collision[] = "Collision"; + +constexpr char ScriptReserved_Probe[] = "Probe"; +constexpr char ScriptReserved_ProbeGetCeilingHeight[] = "GetCeilingHeight"; +constexpr char ScriptReserved_ProbeGetCeilingMaterialType[] = "GetCeilingMaterialType"; +constexpr char ScriptReserved_ProbeGetCeilingNormal[] = "GetCeilingNormal"; +constexpr char ScriptReserved_ProbeGetFloorHeight[] = "GetFloorHeight"; +constexpr char ScriptReserved_ProbeGetFloorMaterialType[] = "GetFloorMaterialType"; +constexpr char ScriptReserved_ProbeGetFloorNormal[] = "GetFloorNormal"; +constexpr char ScriptReserved_ProbeGetPosition[] = "GetPosition"; +constexpr char ScriptReserved_ProbeGetRoom[] = "GetRoom"; +constexpr char ScriptReserved_ProbeGetRoomName[] = "GetRoomName"; +constexpr char ScriptReserved_ProbeGetRoomNumber[] = "GetRoomNumber"; +constexpr char ScriptReserved_ProbeGetWaterSurfaceHeight[] = "GetWaterSurfaceHeight"; +constexpr char ScriptReserved_ProbeIsClimbableWall[] = "IsClimbableWall"; +constexpr char ScriptReserved_ProbeIsDeathTile[] = "IsDeathTile"; +constexpr char ScriptReserved_ProbeIsInsideSolidGeometry[] = "IsInsideSolidGeometry"; +constexpr char ScriptReserved_ProbeIsMonkeySwing[] = "IsMonkeySwing"; +constexpr char ScriptReserved_ProbeIsSteepCeiling[] = "IsSteepCeiling"; +constexpr char ScriptReserved_ProbeIsSteepFloor[] = "IsSteepFloor"; +constexpr char ScriptReserved_ProbeIsWall[] = "IsWall"; +constexpr char ScriptReserved_ProbePreview[] = "Preview"; + +constexpr char ScriptReserved_MaterialType[] = "MaterialType"; + +// ==== +// FLOW +// ==== + +// Horizon + +constexpr char ScriptReserved_Horizon[] = "Horizon"; +constexpr char ScriptReserved_HorizonGetEnabled[] = "GetEnabled"; +constexpr char ScriptReserved_HorizonGetObjectID[] = "GetObjectID"; +constexpr char ScriptReserved_HorizonGetPosition[] = "GetPosition"; +constexpr char ScriptReserved_HorizonGetRotation[] = "GetRotation"; +constexpr char ScriptReserved_HorizonGetTransparency[] = "GetTransparency"; +constexpr char ScriptReserved_HorizonSetEnabled[] = "SetEnabled"; +constexpr char ScriptReserved_HorizonSetObjectID[] = "SetObjectID"; +constexpr char ScriptReserved_HorizonSetPosition[] = "SetPosition"; +constexpr char ScriptReserved_HorizonSetRotation[] = "SetRotation"; +constexpr char ScriptReserved_HorizonSetTransparency[] = "SetTransparency"; + + // ======= // OBJECTS // ======= @@ -452,35 +501,6 @@ constexpr char ScriptReserved_StaticSetSlot[] = "SetSlot"; constexpr char ScriptReserved_StaticSetSolid[] = "SetSolid"; constexpr char ScriptReserved_StaticShatter[] = "Shatter"; -// ========= -// COLLISION -// ========= - -constexpr char ScriptReserved_Collision[] = "Collision"; - -constexpr char ScriptReserved_Probe[] = "Probe"; -constexpr char ScriptReserved_ProbeGetCeilingHeight[] = "GetCeilingHeight"; -constexpr char ScriptReserved_ProbeGetCeilingMaterialType[] = "GetCeilingMaterialType"; -constexpr char ScriptReserved_ProbeGetCeilingNormal[] = "GetCeilingNormal"; -constexpr char ScriptReserved_ProbeGetFloorHeight[] = "GetFloorHeight"; -constexpr char ScriptReserved_ProbeGetFloorMaterialType[] = "GetFloorMaterialType"; -constexpr char ScriptReserved_ProbeGetFloorNormal[] = "GetFloorNormal"; -constexpr char ScriptReserved_ProbeGetPosition[] = "GetPosition"; -constexpr char ScriptReserved_ProbeGetRoom[] = "GetRoom"; -constexpr char ScriptReserved_ProbeGetRoomName[] = "GetRoomName"; -constexpr char ScriptReserved_ProbeGetRoomNumber[] = "GetRoomNumber"; -constexpr char ScriptReserved_ProbeGetWaterSurfaceHeight[] = "GetWaterSurfaceHeight"; -constexpr char ScriptReserved_ProbeIsClimbableWall[] = "IsClimbableWall"; -constexpr char ScriptReserved_ProbeIsDeathTile[] = "IsDeathTile"; -constexpr char ScriptReserved_ProbeIsInsideSolidGeometry[] = "IsInsideSolidGeometry"; -constexpr char ScriptReserved_ProbeIsMonkeySwing[] = "IsMonkeySwing"; -constexpr char ScriptReserved_ProbeIsSteepCeiling[] = "IsSteepCeiling"; -constexpr char ScriptReserved_ProbeIsSteepFloor[] = "IsSteepFloor"; -constexpr char ScriptReserved_ProbeIsWall[] = "IsWall"; -constexpr char ScriptReserved_ProbePreview[] = "Preview"; - -constexpr char ScriptReserved_MaterialType[] = "MaterialType"; - // ===== // TYPES // ===== diff --git a/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp b/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp index 0acd85d4c..25ef6013d 100644 --- a/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp +++ b/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp @@ -22,6 +22,7 @@ #include "Scripting/Internal/TEN/Effects/EffectIDs.h" #include "Scripting/Internal/TEN/Effects/ParticleAnimTypes.h" #include "Scripting/Internal/TEN/Types/Color/Color.h" +#include "Scripting/Internal/TEN/Types/Rotation/Rotation.h" #include "Scripting/Internal/TEN/Types/Vec3/Vec3.h" #include "Scripting/Internal/TEN/Types/Vec2/Vec2.h" #include "Sound/sound.h" @@ -43,17 +44,19 @@ using namespace TEN::Scripting::Types; namespace TEN::Scripting::Effects { - ///Emit a lightning arc. - //@function EmitLightningArc - //@tparam Vec3 src - //@tparam Vec3 dest - //@tparam Color color (default Color(255, 255, 255)) - //@tparam float lifetime Lifetime in seconds. Clamped to [0, 4.233] for now because of strange internal maths. (default 1.0) - //@tparam int amplitude "strength" of the lightning - the higher the value, the "taller" the arcs. Clamped to [1, 255]. (default 20) - //@tparam int beamWidth Clamped to [1, 127]. (default 2) - //@tparam int detail Higher numbers equal more segments, but it's not a 1:1 correlation. Clamped to [1, 127]. (default 10) - //@tparam bool smooth If true, the arc will have large, smooth curves; if false, it will have small, jagged spikes. (default false) - //@tparam bool endDrift If true, the end of the arc will be able to gradually drift away from its destination in a random direction (default false) + + /// Emit a lightning arc. + // @function EmitLightningArc + // @tparam Vec3 src + // @tparam Vec3 dest + // @tparam Color color (default Color(255, 255, 255)) + // @tparam float lifetime Lifetime in seconds. Clamped to [0, 4.233] for now because of strange internal maths. (default 1.0) + // @tparam int amplitude "strength" of the lightning - the higher the value, the "taller" the arcs. Clamped to [1, 255]. (default 20) + // @tparam int beamWidth Clamped to [1, 127]. (default 2) + // @tparam int detail Higher numbers equal more segments, but it's not a 1:1 correlation. Clamped to [1, 127]. (default 10) + // @tparam bool smooth If true, the arc will have large, smooth curves; if false, it will have small, jagged spikes. (default false) + // @tparam bool endDrift If true, the end of the arc will be able to gradually drift away from its destination in a random direction (default false) + static void EmitLightningArc(Vec3 src, Vec3 dest, TypeOrNil color, TypeOrNil lifetime, TypeOrNil amplitude, TypeOrNil beamWidth, TypeOrNil segments, TypeOrNil smooth, TypeOrNil endDrift) { auto p1 = Vector3(src.x, src.y, src.z); @@ -136,6 +139,7 @@ namespace TEN::Scripting::Effects // Objects.ObjID.DEFAULT_SPRITES, -- spriteSeqID // 180 -- startRot // ) + static void EmitParticle(const Vec3& pos, const Vec3& vel, int spriteID, TypeOrNil gravity, TypeOrNil rotVel, TypeOrNil startColor, TypeOrNil endColor, TypeOrNil blendMode, TypeOrNil startSize, TypeOrNil endSize, TypeOrNil life, @@ -246,6 +250,37 @@ namespace TEN::Scripting::Effects // animationType = TEN.Effects.ParticleAnimationType.LOOP, // } // EmitAdvancedParticle(particle) + + /// Structure for EmitAdvancedParticle table. + // @table ParticleData + // @tfield Vec3 position World position. + // @tfield Vec3 velocity Velocity. + // @tfield[opt] Objects.ObjID spriteSeqID ID of the sprite sequence object. __Default: Objects.ObjID.DEFAULT_SPRITES__ + // @tfield[opt] int spriteID ID of the sprite in the sprite sequence object.__Default: 0__ + // @tfield[opt] float lifetime Lifespan in seconds. __Default: 2__ + // @tfield[opt] float maxYVelocity Specifies ithe maximum Y velocity for the particle. __Default: 0__ + // @tfield[opt] float gravity Specifies if the particle will fall over time. Positive values ascend, negative values descend. Recommended range: [-1000 and 1000]. __Default: 0__ + // @tfield[opt] float friction Specifies the friction with which the particle will slow down over time. __Default: 0__ + // @tfield[opt] float startRotation Rotation at start of life. __Default: random__ + // @tfield[opt] float rotationSpeed Rotational velocity in degrees. __Default: 0__ + // @tfield[opt] float startSize Size at start of life. __Default: 10__ + // @tfield[opt] float endSize Size at end of life. The particle will linearly shrink or grow toward this size over its lifespan. __Default: 0__ + // @tfield[opt] Color startColor Color at start of life. __Default: Color(255, 255, 255)__ + // @tfield[opt] Color endColor Color to fade toward. This will finish long before the end of the particle's life due to internal math. __Default: Color(255, 255, 255)__ + // @tfield[opt] Effects.BlendID blendMode Render blend mode. __TEN.Effects.BlendID.ALPHA_BLEND__ + // @tfield[opt] bool damage Specify if the particle will harm the player on collision. __Default: false__ + // @tfield[opt] bool poison Specify if the particle will poison the player on collision. __Default: false__ + // @tfield[opt] bool burn Specify if the particle will burn the player on collision. __Default: false__ + // @tfield[opt] bool wind Specify if the particle will be affected by wind in outside rooms. __Default: false__ + // @tfield[opt] int damageHit Specify the damage particle will harm the player on collision. __Default: 2__ + // @tfield[opt] bool light Specify if the particle will be emit a light based on its color. Caution: Recommended only for a single particle. Having too many particles with lights can overflow the light system. __Default: false__ + // @tfield[opt] int lightRadius measured in "clicks" or 256 world units. __Default: 0__ + // @tfield[opt] int lightFlicker The interval at which light should flicker. __Default: 0__ + // @tfield[opt] int sound ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. Looping sounds recommended. Caution: Recommended only for a single particle. Having too many particles with sounds can overflow the sound system. __Default: None__ + // @tfield[opt] bool animated Specify if the particle will be animated. __Default: false__ + // @tfield[opt] Effects.ParticleAnimationType animationType Specify the the type of animation the particle will use. __Default: TEN.Effects.ParticleAnimationType.LOOP__ + // @tfield[opt] float frameRate The framerate with which the particle will be animated. __Default: 1__ + static void EmitAdvancedParticle(sol::table ParticleData) { constexpr auto DEFAULT_START_SIZE = 10.0f; @@ -362,17 +397,17 @@ namespace TEN::Scripting::Effects } -/***Emit a shockwave, similar to that seen when a harpy projectile hits something. - @function EmitShockwave - @tparam Vec3 pos Origin position - @tparam int innerRadius (default 0) Initial inner radius of the shockwave circle - 128 will be approx a click, 512 approx a block - @tparam int outerRadius (default 128) Initial outer radius of the shockwave circle - @tparam Color color (default Color(255, 255, 255)) - @tparam float lifetime (default 1.0) Lifetime in seconds (max 8.5 because of inner maths weirdness) - @tparam int speed (default 50) Initial speed of the shockwave's expansion (the shockwave will always slow as it goes) - @tparam int angle (default 0) Angle about the X axis - a value of 90 will cause the shockwave to be entirely vertical - @tparam bool hurtsLara (default false) If true, the shockwave will hurt Lara, with the damage being relative to the shockwave's current speed -*/ + /// Emit a shockwave, similar to that seen when a harpy projectile hits something. + // @function EmitShockwave + // @tparam Vec3 pos Origin position + // @tparam int innerRadius (default 0) Initial inner radius of the shockwave circle - 128 will be approx a click, 512 approx a block + // @tparam int outerRadius (default 128) Initial outer radius of the shockwave circle + // @tparam Color color (default Color(255, 255, 255)) + // @tparam float lifetime (default 1.0) Lifetime in seconds (max 8.5 because of inner maths weirdness) + // @tparam int speed (default 50) Initial speed of the shockwave's expansion (the shockwave will always slow as it goes) + // @tparam int angle (default 0) Angle about the X axis - a value of 90 will cause the shockwave to be entirely vertical + // @tparam bool hurtsLara (default false) If true, the shockwave will hurt Lara, with the damage being relative to the shockwave's current speed + static void EmitShockwave(Vec3 pos, TypeOrNil innerRadius, TypeOrNil outerRadius, TypeOrNil col, TypeOrNil lifetime, TypeOrNil speed, TypeOrNil angle, TypeOrNil hurtPlayer) { @@ -403,15 +438,15 @@ namespace TEN::Scripting::Effects (short)doDamage, true, false, false, (int)ShockwaveStyle::Normal); } -/***Emit dynamic light that lasts for a single frame. - * If you want a light that sticks around, you must call this each frame. -@function EmitLight -@tparam Vec3 pos position of the light -@tparam[opt] Color color light color (default Color(255, 255, 255)) -@tparam[opt] int radius measured in "clicks" or 256 world units (default 20) -@tparam[opt] bool shadows determines whether light should generate dynamic shadows for applicable moveables (default is false) -@tparam[opt] string name if provided, engine will interpolate this light for high framerate mode (be careful not to use same name for different lights) -*/ + /// Emit dynamic light that lasts for a single frame. + // If you want a light that sticks around, you must call this each frame. + // @function EmitLight + // @tparam Vec3 pos position of the light + // @tparam[opt] Color color light color (default Color(255, 255, 255)) + // @tparam[opt] int radius measured in "clicks" or 256 world units (default 20) + // @tparam[opt] bool shadows determines whether light should generate dynamic shadows for applicable moveables (default is false) + // @tparam[opt] string name if provided, engine will interpolate this light for high framerate mode (be careful not to use same name for different lights) + static void EmitLight(Vec3 pos, TypeOrNil col, TypeOrNil radius, TypeOrNil castShadows, TypeOrNil name) { auto color = ValueOr(col, ScriptColor(255, 255, 255)); @@ -419,18 +454,18 @@ namespace TEN::Scripting::Effects SpawnDynamicPointLight(pos.ToVector3(), color, rad, ValueOr(castShadows, false), GetHash(ValueOr(name, std::string()))); } -/***Emit dynamic directional spotlight that lasts for a single frame. -* If you want a light that sticks around, you must call this each frame. -@function EmitSpotLight -@tparam Vec3 pos position of the light -@tparam Vec3 dir normal which indicates light direction -@tparam[opt] Color color (default Color(255, 255, 255)) -@tparam[opt] int radius overall radius at the endpoint of a light cone, measured in "clicks" or 256 world units (default 10) -@tparam[opt] int falloff radius, at which light starts to fade out, measured in "clicks" (default 5) -@tparam[opt] int distance distance, at which light cone fades out, measured in "clicks" (default 20) -@tparam[opt] bool shadows determines whether light should generate dynamic shadows for applicable moveables (default is false) -@tparam[opt] string name if provided, engine will interpolate this light for high framerate mode (be careful not to use same name for different lights) -*/ + /// Emit dynamic directional spotlight that lasts for a single frame. + // If you want a light that sticks around, you must call this each frame. + // @function EmitSpotLight + // @tparam Vec3 pos position of the light + // @tparam Vec3 dir normal which indicates light direction + // @tparam[opt] Color color (default Color(255, 255, 255)) + // @tparam[opt] int radius overall radius at the endpoint of a light cone, measured in "clicks" or 256 world units (default 10) + // @tparam[opt] int falloff radius, at which light starts to fade out, measured in "clicks" (default 5) + // @tparam[opt] int distance distance, at which light cone fades out, measured in "clicks" (default 20) + // @tparam[opt] bool shadows determines whether light should generate dynamic shadows for applicable moveables (default is false) + // @tparam[opt] string name if provided, engine will interpolate this light for high framerate mode (be careful not to use same name for different lights) + static void EmitSpotLight(Vec3 pos, Vec3 dir, TypeOrNil col, TypeOrNil radius, TypeOrNil falloff, TypeOrNil distance, TypeOrNil castShadows, TypeOrNil name) { auto color = ValueOr(col, ScriptColor(255, 255, 255)); @@ -440,21 +475,22 @@ namespace TEN::Scripting::Effects SpawnDynamicSpotLight(pos.ToVector3(), dir.ToVector3(), color, rad, fallOff, dist, ValueOr(castShadows, false), GetHash(ValueOr(name, std::string()))); } -/***Emit blood. -@function EmitBlood -@tparam Vec3 pos -@tparam int count (default 1) "amount" of blood. Higher numbers won't add more blood but will make it more "flickery", with higher numbers turning it into a kind of red orb. -*/ + /// Emit blood. + // @function EmitBlood + // @tparam Vec3 pos + // @tparam int count Sprite count. __default: 1__ + static void EmitBlood(const Vec3& pos, TypeOrNil count) { TriggerBlood(pos.x, pos.y, pos.z, -1, ValueOr(count, 1)); } -/// Emit air bubble in a water room. -// @function EmitAirBubble -// @tparam Vec3 pos World position where the effect will be spawned. Must be in a water room. -// @tparam[opt] float size Sprite size. __Default: 32__ -// @tparam[opt] float amp Oscillation amplitude. __Default: 32__ + /// Emit an air bubble in a water room. + // @function EmitAirBubble + // @tparam Vec3 pos World position where the effect will be spawned. Must be in a water room. + // @tparam[opt] float size Sprite size. __Default: 32__ + // @tparam[opt] float amp Oscillation amplitude. __Default: 32__ + static void EmitAirBubble(const Vec3& pos, TypeOrNil size, TypeOrNil amp) { constexpr auto DEFAULT_SIZE = 128.0f; @@ -466,31 +502,31 @@ namespace TEN::Scripting::Effects SpawnBubble(pos.ToVector3(), roomNumber, convertedSize, convertedAmp); } -/***Emit fire for one frame. Will not hurt player. Call this each frame if you want a continuous fire. -@function EmitFire -@tparam Vec3 pos -@tparam float size (default 1.0) -*/ + /// Emit fire for one frame. Will not hurt player. Call this each frame if you want a continuous fire. + // @function EmitFire + // @tparam Vec3 pos + // @tparam float size (default 1.0) + static void EmitFire(const Vec3& pos, TypeOrNil size) { AddFire(pos.x, pos.y, pos.z, FindRoomNumber(Vector3i(pos.x, pos.y, pos.z)), ValueOr(size, 1)); } -/***Make an explosion. Does not hurt Lara -@function MakeExplosion -@tparam Vec3 pos -@tparam float size (default 512.0) this will not be the size of the sprites, but rather the distance between the origin and any additional sprites -@tparam bool shockwave (default false) if true, create a very faint white shockwave which will not hurt Lara -*/ + /// Make an explosion. Does not hurt Lara + // @function MakeExplosion + // @tparam Vec3 pos + // @tparam float size (default 512.0) this will not be the size of the sprites, but rather the distance between the origin and any additional sprites + // @tparam bool shockwave (default false) if true, create a very faint white shockwave which will not hurt Lara + static void MakeExplosion(Vec3 pos, TypeOrNil size, TypeOrNil shockwave) { TriggerExplosion(Vector3(pos.x, pos.y, pos.z), ValueOr(size, 512.0f), true, false, ValueOr(shockwave, false), FindRoomNumber(Vector3i(pos.x, pos.y, pos.z))); } -/***Make an earthquake -@function MakeEarthquake -@tparam int strength (default 100) How strong should the earthquake be? Increasing this value also increases the lifespan of the earthquake. -*/ + /// Make an earthquake + // @function MakeEarthquake + // @tparam int strength (default 100) How strong should the earthquake be? Increasing this value also increases the lifespan of the earthquake. + static void Earthquake(TypeOrNil strength) { int str = ValueOr(strength, 100); @@ -501,6 +537,7 @@ namespace TEN::Scripting::Effects // This represents the 3D displacement applied by the engine on things like particles affected by wind. // @function GetWind() // @treturn Vec3 Wind vector. + static Vec3 GetWind() { return Vec3(Weather.Wind()); @@ -511,6 +548,7 @@ namespace TEN::Scripting::Effects auto tableEffects = sol::table(state->lua_state(), sol::create); parent.set(ScriptReserved_Effects, tableEffects); + // Emitters tableEffects.set_function(ScriptReserved_EmitLightningArc, &EmitLightningArc); tableEffects.set_function(ScriptReserved_EmitParticle, &EmitParticle); tableEffects.set_function(ScriptReserved_EmitAdvancedParticle, &EmitAdvancedParticle); @@ -519,46 +557,17 @@ namespace TEN::Scripting::Effects tableEffects.set_function(ScriptReserved_EmitSpotLight, &EmitSpotLight); tableEffects.set_function(ScriptReserved_EmitBlood, &EmitBlood); tableEffects.set_function(ScriptReserved_EmitAirBubble, &EmitAirBubble); - tableEffects.set_function(ScriptReserved_MakeExplosion, &MakeExplosion); tableEffects.set_function(ScriptReserved_EmitFire, &EmitFire); + + tableEffects.set_function(ScriptReserved_MakeExplosion, &MakeExplosion); tableEffects.set_function(ScriptReserved_MakeEarthquake, &Earthquake); tableEffects.set_function(ScriptReserved_GetWind, &GetWind); - auto handler = LuaHandler{ state }; + auto handler = LuaHandler(state); handler.MakeReadOnlyTable(tableEffects, ScriptReserved_BlendID, BLEND_IDS); handler.MakeReadOnlyTable(tableEffects, ScriptReserved_EffectID, EFFECT_IDS); handler.MakeReadOnlyTable(tableEffects, ScriptReserved_ParticleAnimationType, PARTICLE_ANIM_TYPES); } } -/// Structure for EmitAdvancedParticle table. -// @table ParticleData -// @tfield Vec3 position World position. -// @tfield Vec3 velocity Velocity. -// @tfield[opt] Objects.ObjID spriteSeqID ID of the sprite sequence object. __Default: Objects.ObjID.DEFAULT_SPRITES__ -// @tfield[opt] int spriteID ID of the sprite in the sprite sequence object.__Default: 0__ -// @tfield[opt] float lifetime Lifespan in seconds. __Default: 2__ -// @tfield[opt] float maxYVelocity Specifies ithe maximum Y velocity for the particle. __Default: 0__ -// @tfield[opt] float gravity Specifies if the particle will fall over time. Positive values ascend, negative values descend. Recommended range: [-1000 and 1000]. __Default: 0__ -// @tfield[opt] float friction Specifies the friction with which the particle will slow down over time. __Default: 0__ -// @tfield[opt] float startRotation Rotation at start of life. __Default: random__ -// @tfield[opt] float rotationSpeed Rotational velocity in degrees. __Default: 0__ -// @tfield[opt] float startSize Size at start of life. __Default: 10__ -// @tfield[opt] float endSize Size at end of life. The particle will linearly shrink or grow toward this size over its lifespan. __Default: 0__ -// @tfield[opt] Color startColor Color at start of life. __Default: Color(255, 255, 255)__ -// @tfield[opt] Color endColor Color to fade toward. This will finish long before the end of the particle's life due to internal math. __Default: Color(255, 255, 255)__ -// @tfield[opt] Effects.BlendID blendMode Render blend mode. __TEN.Effects.BlendID.ALPHA_BLEND__ -// @tfield[opt] bool damage Specify if the particle will harm the player on collision. __Default: false__ -// @tfield[opt] bool poison Specify if the particle will poison the player on collision. __Default: false__ -// @tfield[opt] bool burn Specify if the particle will burn the player on collision. __Default: false__ -// @tfield[opt] bool wind Specify if the particle will be affected by wind in outside rooms. __Default: false__ -// @tfield[opt] int damageHit Specify the damage particle will harm the player on collision. __Default: 2__ -// @tfield[opt] bool light Specify if the particle will be emit a light based on its color. Caution: Recommended only for a single particle. Having too many particles with lights can overflow the light system. __Default: false__ -// @tfield[opt] int lightRadius measured in "clicks" or 256 world units. __Default: 0__ -// @tfield[opt] int lightFlicker The interval at which light should flicker. __Default: 0__ -// @tfield[opt] int sound ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. Looping sounds recommended. Caution: Recommended only for a single particle. Having too many particles with sounds can overflow the sound system. __Default: None__ -// @tfield[opt] bool animated Specify if the particle will be animated. __Default: false__ -// @tfield[opt] Effects.ParticleAnimationType animationType Specify the the type of animation the particle will use. __Default: TEN.Effects.ParticleAnimationType.LOOP__ -// @tfield[opt] float frameRate The framerate with which the particle will be animated. __Default: 1__ - diff --git a/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.cpp b/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.cpp index 90369bdc6..f5d304a4b 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.cpp @@ -317,6 +317,7 @@ Specify which translations in the strings table correspond to which languages. InventoryItem::Register(tableFlow); Settings::Register(tableFlow); Fog::Register(tableFlow); + Horizon::Register(tableFlow); LensFlare::Register(tableFlow); Starfield::Register(tableFlow); @@ -414,6 +415,8 @@ void FlowHandler::LoadFlowScript() { TENLog("Loading gameflow script, strings, and settings...", LogLevel::Info); + Levels.clear(); + _handler.ExecuteScript(_gameDir + "Scripts/Gameflow.lua"); _handler.ExecuteScript(_gameDir + "Scripts/SystemStrings.lua", true); _handler.ExecuteScript(_gameDir + "Scripts/Strings.lua", true); diff --git a/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.h b/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.h index 17b496bfe..9dafce539 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.h +++ b/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.h @@ -27,9 +27,6 @@ private: void PrepareInventoryObjects(); public: - int FogInDistance = 0; - int FogOutDistance = 0; - bool LevelSelect = true; bool HomeLevel = false; bool LoadSave = true; diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp index 7cb1b424e..95c2b15c1 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp @@ -19,16 +19,16 @@ void Fog::Register(sol::table& parent) ctors(), sol::call_constructor, ctors(), - /// (@{Color}) RGB fog color + /// (@{Color}) RGB fog color. // @mem color "color", sol::property(&Fog::GetColor, &Fog::SetColor), - /// (int) min distance. + /// (int) Minimum distance. // This is the distance at which the fog starts. - // @mem minDistance* + // @mem minDistance "minDistance", &Fog::MinDistance, - /// (int) max distance. + /// (int) Maximum distance. // This is the distance at which the fog reaches the maximum strength. // @mem maxDistance "maxDistance", &Fog::MaxDistance @@ -37,8 +37,8 @@ void Fog::Register(sol::table& parent) /*** @tparam Color color RGB color -@tparam int Min Distance fog starts (in Sectors) -@tparam int Max Distance fog ends (in Sectors) +@tparam int min Distance at which fog starts (in sectors) +@tparam int max Distance at which fog reaches the maximum strength (in sectors) @treturn Fog A fog object. @function Fog */ diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Horizon/Horizon.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Horizon/Horizon.cpp new file mode 100644 index 000000000..52f24820d --- /dev/null +++ b/TombEngine/Scripting/Internal/TEN/Flow/Horizon/Horizon.cpp @@ -0,0 +1,156 @@ +#include "framework.h" +#include "Scripting/Internal/TEN/Flow/Horizon/Horizon.h" + +#include "Objects/game_object_ids.h" +#include "Scripting/Internal/ReservedScriptNames.h" +#include "Scripting/Internal/ScriptUtil.h" +#include "Scripting/Internal/TEN/Types/Color/Color.h" +#include "Scripting/Internal/TEN/Types/Rotation/Rotation.h" + +namespace TEN::Scripting +{ + /// Represents a horizon. + // + // @tenprimitive Flow.Horizon + // @pragma nostrip + + void Horizon::Register(sol::table& parent) + { + using ctors = sol::constructors< + Horizon(GAME_OBJECT_ID), + Horizon(bool)>; + + // Register type. + parent.new_usertype( + ScriptReserved_Horizon, + ctors(), sol::call_constructor, ctors(), + + // Getters + ScriptReserved_HorizonGetEnabled, &Horizon::GetEnabled, + ScriptReserved_HorizonGetObjectID, &Horizon::GetObjectID, + ScriptReserved_HorizonGetPosition, &Horizon::GetPosition, + ScriptReserved_HorizonGetRotation, &Horizon::GetRotation, + ScriptReserved_HorizonGetTransparency, &Horizon::GetTransparency, + + // Setters + ScriptReserved_HorizonSetEnabled, &Horizon::SetEnabled, + ScriptReserved_HorizonSetObjectID, &Horizon::SetObjectID, + ScriptReserved_HorizonSetPosition, &Horizon::SetPosition, + ScriptReserved_HorizonSetRotation, &Horizon::SetRotation, + ScriptReserved_HorizonSetTransparency, &Horizon::SetTransparency); + } + + /// Create a horizon object. + // @function Horizon + // @tparam Objects.ObjID objectID Object ID for the horizon to use. + // @treturn Horizon A new Horizon object. + Horizon::Horizon(GAME_OBJECT_ID objectID) + { + _enabled = true; + _objectID = objectID; + } + + // Legacy constructor to maintain backwards compatibility. + Horizon::Horizon(bool enabled) + { + _enabled = enabled; + } + + /// Get the horizon's enabled state. + // @function GetEnabled + // @treturn bool Enabled state. + bool Horizon::GetEnabled() const + { + return _enabled; + } + + /// Get the horizon's slot object ID. + // @function GetObjectID + // @treturn Objects.ObjID Object ID. + GAME_OBJECT_ID Horizon::GetObjectID() const + { + return _objectID; + } + + /// Get the horizon's world position. + // @function GetPosition + // @treturn Vec3 Position. + const Vec3 Horizon::GetPosition() const + { + return _position; + } + + /// Get the horizon's rotation. + // @function GetRotation + // @treturn Rotation Rotation. + const Rotation Horizon::GetRotation() const + { + return _rotation; + } + + /// Get the horizon's transparency. + // @function GetTransparency + // @treturn float Transparency. + const float Horizon::GetTransparency() const + { + return _transparency; + } + + /// Set the horizon's enabled state. + // @function SetEnabled + // @tparam bool enabled New enabled state. + void Horizon::SetEnabled(bool value) + { + _enabled = value; + } + + /// Set the horizon's object ID. + // @function SetObjectID + // @tparam Objects.ObjID objectID Object ID. + void Horizon::SetObjectID(GAME_OBJECT_ID objectID) + { + _objectID = objectID; + } + + /// Set the horizon's world position. + // @function SetPosition + // @tparam Vec3 pos New world position. + // @tparam[opt] bool noInterpolation Disable interpolation with the previous frame's position. __default: false__ + void Horizon::SetPosition(const Vec3& pos, TypeOrNil noInterpolation) + { + bool convertedDisableInterp = ValueOr(noInterpolation, false); + + _prevPosition = convertedDisableInterp ? pos : _position; + _position = pos; + } + + /// Set the horizon's rotation. + // @function SetRotation + // @tparam Rotation rot New rotation. + // @tparam[opt] bool noInterpolation Disable interpolation with the previous frame's rotation. __default: false__ + void Horizon::SetRotation(const Rotation& rot, TypeOrNil noInterpolation) + { + bool convertedDisableInterp = ValueOr(noInterpolation, false); + + _prevRotation = convertedDisableInterp ? rot : _rotation; + _rotation = rot; + } + + /// Set the horizon's transparency. + // @function SetTransparency + // @tparam float transparency New transparency alpha. + void Horizon::SetTransparency(float value) + { + _transparency = value; + } + + const Vec3 Horizon::GetPrevPosition() const + { + return _prevPosition; + } + + const Rotation Horizon::GetPrevRotation() const + { + return _prevRotation; + } +} diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Horizon/Horizon.h b/TombEngine/Scripting/Internal/TEN/Flow/Horizon/Horizon.h new file mode 100644 index 000000000..02b1a5a69 --- /dev/null +++ b/TombEngine/Scripting/Internal/TEN/Flow/Horizon/Horizon.h @@ -0,0 +1,55 @@ +#pragma once + +#include "Objects/game_object_ids.h" +#include "Scripting/Internal/ScriptUtil.h" +#include "Scripting/Internal/TEN/Types/Rotation/Rotation.h" +#include "Scripting/Internal/TEN/Types/Vec3/Vec3.h" + +namespace TEN::Scripting +{ + class Horizon + { + public: + static void Register(sol::table& parent); + + private: + // Fields + + bool _enabled = false; + GAME_OBJECT_ID _objectID = GAME_OBJECT_ID::ID_HORIZON; + Vec3 _position = {}; + Rotation _rotation = {}; + float _scale = 1.0f; + float _transparency = 1.0f; + + Vec3 _prevPosition = {}; + Rotation _prevRotation = {}; + float _prevScale = 1.0f; + + public: + // Constructors + + Horizon() = default; + Horizon(bool enabled); + Horizon(GAME_OBJECT_ID objectID); + + // Getters + + bool GetEnabled() const; + GAME_OBJECT_ID GetObjectID() const; + const Vec3 GetPosition() const; + const Rotation GetRotation() const; + const float GetTransparency() const; + + const Vec3 GetPrevPosition() const; + const Rotation GetPrevRotation() const; + + // Setters + + void SetEnabled(bool value); + void SetObjectID(GAME_OBJECT_ID objectID); + void SetPosition(const Vec3& pos, TypeOrNil disableInterpolation); + void SetRotation(const Rotation& orient, TypeOrNil disableInterpolation); + void SetTransparency(float value); + }; +} \ No newline at end of file diff --git a/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp b/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp index fc777b61e..30e0718a0 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp @@ -39,9 +39,9 @@ namespace TEN::Scripting /// Create a LensFlare object. // @function LensFlare - // @tparam float Pitch angle in degrees. - // @tparam float Yaw angle in degrees. - // @tparam Color Color. + // @tparam float pitch Pitch angle in degrees. + // @tparam float yaw Yaw angle in degrees. + // @tparam Color color Color of the lensflare. // @treturn LensFlare A new LensFlare object. LensFlare::LensFlare(float pitch, float yaw, const ScriptColor& color) { @@ -91,7 +91,7 @@ namespace TEN::Scripting /// Set this lens flare's sun sprite ID. // @function LensFlare:SetSunSpriteID - // @tparam int New sun sprite ID. + // @tparam int spriteID New sun sprite ID. void LensFlare::SetSunSpriteID(int spriteID) { // Sprite ID out of range; return early. @@ -106,7 +106,7 @@ namespace TEN::Scripting /// Set this lens flare's pitch angle. // @function LensFlare:SetPitch - // @tparam float New pitch angle in degrees. + // @tparam float pitch New pitch angle in degrees. void LensFlare::SetPitch(float pitch) { _rotation.x = pitch; @@ -114,7 +114,7 @@ namespace TEN::Scripting /// Set this lens flare's yaw angle. // @function LensFlare:SetYaw - // @tparam float New yaw angle in degrees. + // @tparam float yaw New yaw angle in degrees. void LensFlare::SetYaw(float yaw) { _rotation.y = yaw; @@ -122,7 +122,7 @@ namespace TEN::Scripting /// Set this lens flare's color. // @function LensFlare:SetColor - // @tparam Color New color. + // @tparam Color color New color. void LensFlare::SetColor(const ScriptColor& color) { _color = color; diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp index dc86d8c5e..566d05a4f 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp @@ -13,10 +13,9 @@ These are things things which aren't present in the compiled level file itself. @pragma nostrip */ -/*** Make a new Level object. - @function Level - @treturn Level a Level object - */ +/// Make a new Level object. +//@function Level +//@treturn Level a Level object void Level::Register(sol::table& parent) { // Register type. @@ -58,6 +57,15 @@ void Level::Register(sol::table& parent) //@mem layer2 "layer2", &Level::Layer2, +/// (@{Flow.Horizon}) First horizon layer. +//@mem horizon1 + "horizon1", &Level::Horizon1, + "horizon", sol::property(&Level::GetHorizon1Enabled, &Level::SetHorizon1Enabled), // Compatibility. + +/// (@{Flow.Horizon}) Second horizon layer. +//@mem horizon1 + "horizon2", &Level::Horizon2, + /// (@{Flow.Starfield}) Starfield. // @mem starfield "starfield", &Level::Starfield, @@ -72,25 +80,18 @@ void Level::Register(sol::table& parent) //@mem fog "fog", &Level::Fog, -/// (bool) Draw sky layer? (default: false) -//@mem horizon - "horizon", &Level::Horizon, - /// (bool) Enable flickering lightning in the sky. // Equivalent to classic TRLE's LIGHTNING setting. As in the TRC Ireland levels. -// //@mem storm "storm", &Level::Storm, /// (WeatherType) Choose weather effect. // Must be one of the values `WeatherType.None`, `WeatherType.Rain`, or `WeatherType.Snow`. -// //@mem weather "weather", &Level::Weather, /// (float) Choose weather strength. // Must be value between `0.1` and `1.0`. -// //@mem weatherStrength "weatherStrength", sol::property(&Level::SetWeatherStrength), @@ -115,6 +116,9 @@ e.g. `myLevel.laraType = LaraType.Divesuit` //@mem rumble "rumble", &Level::Rumble, +/// (int) The maximum draw distance for level. +// Given in sectors (blocks). Must be at least 4. +//@mem farView "farView", sol::property(&Level::SetLevelFarView), /// (bool) Reset hub data. @@ -129,7 +133,7 @@ e.g. `myLevel.laraType = LaraType.Divesuit` /// (short) Set Secrets for Level //@mem secrets "secrets", sol::property(&Level::SetSecrets) - ); + ); } void Level::SetWeatherStrength(float val) @@ -147,14 +151,6 @@ void Level::SetWeatherStrength(float val) } } -/*** (int) The maximum draw distance for level. -Given in sectors (blocks). -Must be at least 4. - -This is equivalent to TRNG's LevelFarView variable. - -@mem farView -*/ void Level::SetLevelFarView(short val) { static_assert(MIN_FAR_VIEW == 3200.0f, "Please update the comment, docs, and warning message if this number changes."); @@ -173,46 +169,25 @@ void Level::SetLevelFarView(short val) } } -RGBAColor8Byte Level::GetSkyLayerColor(int index) const +const SkyLayer& Level::GetSkyLayer(int index) const { TENAssert(index == 0 || index == 1, "Sky layer index must be 0 or 1."); + return (index == 0 ? Layer1 : Layer2); +} - if (index == 0) - { - return Layer1.GetColor(); - } - else - { - return Layer2.GetColor(); - } +RGBAColor8Byte Level::GetSkyLayerColor(int index) const +{ + return GetSkyLayer(index).GetColor(); } bool Level::GetSkyLayerEnabled(int index) const { - TENAssert(index == 0 || index == 1, "Sky layer index must be 0 or 1."); - - if (index == 0) - { - return Layer1.Enabled; - } - else - { - return Layer2.Enabled; - } + return GetSkyLayer(index).Enabled; } short Level::GetSkyLayerSpeed(int index) const { - TENAssert(index == 0 || index == 1, "Sky layer index must be 0 or 1."); - - if (index == 0) - { - return Layer1.CloudSpeed; - } - else - { - return Layer2.CloudSpeed; - } + return GetSkyLayer(index).CloudSpeed; } LaraType Level::GetLaraType() const @@ -230,9 +205,14 @@ bool Level::GetStormEnabled() const return Storm; } +bool Level::GetRumbleEnabled() const +{ + return Rumble; +} + float Level::GetWeatherStrength() const { - return WeatherStrength; + return WeatherStrength; } WeatherType Level::GetWeatherType() const @@ -280,6 +260,57 @@ std::string Level::GetAmbientTrack() const return AmbientTrack; } +const TEN::Scripting::Horizon& Level::GetHorizon(int index) const +{ + TENAssert(index == 0 || index == 1, "Horizon index must be 0 or 1."); + return (index == 0 ? Horizon1 : Horizon2); +} + +bool Level::GetHorizon1Enabled() const +{ + return Horizon1.GetEnabled(); +} + +void Level::SetHorizon1Enabled(bool enabled) +{ + Horizon1.SetEnabled(enabled); +} + +bool Level::GetHorizonEnabled(int index) const +{ + return GetHorizon(index).GetEnabled(); +} + +GAME_OBJECT_ID Level::GetHorizonObjectID(int index) const +{ + return GetHorizon(index).GetObjectID(); +} + +float Level::GetHorizonTransparency(int index) const +{ + return GetHorizon(index).GetTransparency(); +} + +Vector3 Level::GetHorizonPosition(int index) const +{ + return GetHorizon(index).GetPosition().ToVector3(); +} + +EulerAngles Level::GetHorizonOrientation(int index) const +{ + return GetHorizon(index).GetRotation().ToEulerAngles(); +} + +Vector3 Level::GetHorizonPrevPosition(int index) const +{ + return GetHorizon(index).GetPrevPosition().ToVector3(); +} + +EulerAngles Level::GetHorizonPrevOrientation(int index) const +{ + return GetHorizon(index).GetPrevRotation().ToEulerAngles(); +} + bool Level::GetLensFlareEnabled() const { return LensFlare.GetEnabledStatus(); diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.h b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.h index 13bcae96a..38125cb11 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.h +++ b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.h @@ -1,6 +1,7 @@ #pragma once -#include "Scripting/Internal/TEN/Flow/SkyLayer/SkyLayer.h" +#include "Scripting/Internal/TEN/Flow/Horizon/Horizon.h" #include "Scripting/Internal/TEN/Flow/LensFlare/LensFlare.h" +#include "Scripting/Internal/TEN/Flow/SkyLayer/SkyLayer.h" #include "Scripting/Internal/TEN/Flow/Starfield/Starfield.h" #include "Scripting/Internal/TEN/Flow/Fog/Fog.h" #include "Scripting/Include/ScriptInterfaceLevel.h" @@ -27,18 +28,21 @@ static const std::unordered_map PLAYER_TYPES struct Level : public ScriptInterfaceLevel { - SkyLayer Layer1 = {}; - SkyLayer Layer2 = {}; Fog Fog = {}; int LevelFarView = 0; std::string AmbientTrack = {}; - LensFlare LensFlare = {}; - Starfield Starfield = {}; + SkyLayer Layer1 = {}; + SkyLayer Layer2 = {}; + TEN::Scripting::Horizon Horizon1 = {}; + TEN::Scripting::Horizon Horizon2 = {}; + TEN::Scripting::LensFlare LensFlare = {}; + TEN::Scripting::Starfield Starfield = {}; WeatherType Weather = WeatherType::None; float WeatherStrength = 1.0f; bool Storm = false; + bool Rumble = false; LaraType Type = LaraType::Normal; int LevelSecrets = 0; @@ -53,6 +57,7 @@ struct Level : public ScriptInterfaceLevel float GetWeatherStrength() const override; bool GetSkyLayerEnabled(int index) const override; bool GetStormEnabled() const override; + bool GetRumbleEnabled() const override; short GetSkyLayerSpeed(int index) const override; RGBAColor8Byte GetSkyLayerColor(int index) const override; LaraType GetLaraType() const override; @@ -68,6 +73,19 @@ struct Level : public ScriptInterfaceLevel std::string GetAmbientTrack() const override; bool GetResetHubEnabled() const override; + // Horizon getters + bool GetHorizonEnabled(int index) const override; + GAME_OBJECT_ID GetHorizonObjectID(int index) const override; + float GetHorizonTransparency(int index) const override; + Vector3 GetHorizonPosition(int index) const override; + EulerAngles GetHorizonOrientation(int index) const override; + Vector3 GetHorizonPrevPosition(int index) const override; + EulerAngles GetHorizonPrevOrientation(int index) const override; + + // Compatibility + bool GetHorizon1Enabled() const; + void SetHorizon1Enabled(bool enabled); + // Lens flare getters bool GetLensFlareEnabled() const override; int GetLensFlareSunSpriteID() const override; @@ -82,4 +100,8 @@ struct Level : public ScriptInterfaceLevel int GetStarfieldMeteorCount() const override; int GetStarfieldMeteorSpawnDensity() const override; float GetStarfieldMeteorVelocity() const override; + + // Utility + const SkyLayer& GetSkyLayer(int index) const; + const TEN::Scripting::Horizon& GetHorizon(int index) const; }; diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp index 5b1b3de47..5502b8d59 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp @@ -50,6 +50,8 @@ namespace TEN::Scripting // @function Starfield // @tparam int starCount Star count. __Max: 6000__ // @tparam int meteorCount Meteor count. __Max: 100__ + // @tparam int meteorSpawnDensity Meteor spawn density. + // @tparam int meteorVel Meteor velocity. // @treturn Starfield A new Starfield object. Starfield::Starfield(int starCount, int meteorCount, int meteorSpawnDensity, float meteorVel) { @@ -115,7 +117,7 @@ namespace TEN::Scripting /// Set this starfield's number of stars. // @function Starfield:SetStarCount - // @tparam int New star count. + // @tparam int count New star count. void Starfield::SetStarCount(int count) { if (count < 0 || count > STAR_COUNT_MAX) @@ -126,7 +128,7 @@ namespace TEN::Scripting /// Set this starfield's number of meteors. // @function Starfield:SetMeteorCount - // @tparam int New meteor count. + // @tparam int count New meteor count. void Starfield::SetMeteorCount(int count) { if (count < 0 || count > METEOR_COUNT_MAX) @@ -137,7 +139,7 @@ namespace TEN::Scripting /// Set this starfield's meteor spawn density. // @function Starfield:SetMeteorSpawnDensity - // @tparam int New meteor spawn density. + // @tparam int density New meteor spawn density. void Starfield::SetMeteorSpawnDensity(int spawnDensity) { _meteorSpawnDensity = spawnDensity; @@ -145,7 +147,7 @@ namespace TEN::Scripting /// Set this starfield's meteor velocity. // @function Starfield:SetMeteorVelocity - // @tparam float New meteor velocity. + // @tparam float velocity New meteor velocity. void Starfield::SetMeteorVelocity(float vel) { _meteorVelocity = vel; diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp index 7b7e1f1dd..70f2ca4aa 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp +++ b/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp @@ -244,7 +244,7 @@ void Moveable::Initialize() /// Retrieve the object ID // @function Moveable:GetObjectID -// @treturn int a number representing the ID of the object +// @treturn Objects.ObjID a number representing the ID of the object GAME_OBJECT_ID Moveable::GetObjectID() const { return _moveable->ObjectNumber; diff --git a/TombEngine/Scripting/Internal/TEN/View/ViewHandler.cpp b/TombEngine/Scripting/Internal/TEN/View/ViewHandler.cpp index 31630886d..501784af1 100644 --- a/TombEngine/Scripting/Internal/TEN/View/ViewHandler.cpp +++ b/TombEngine/Scripting/Internal/TEN/View/ViewHandler.cpp @@ -166,12 +166,12 @@ namespace TEN::Scripting::View ///Do a full-screen fade-in from black. //@function FadeIn - //@tparam float speed (default 1.0). Speed in "amount" per second. A value of 1 will make the fade take one second. + //@tparam float speed (default 1.0). Speed in units per second. A value of 1 will make the fade take one second. tableView.set_function(ScriptReserved_FadeIn, &FadeIn); ///Do a full-screen fade-to-black. The screen will remain black until a call to FadeIn. //@function FadeOut - //@tparam float speed (default 1.0). Speed in "amount" per second. A value of 1 will make the fade take one second. + //@tparam float speed (default 1.0). Speed in units per second. A value of 1 will make the fade take one second. tableView.set_function(ScriptReserved_FadeOut, &FadeOut); ///Check if fade out is complete and screen is completely black. @@ -261,7 +261,7 @@ namespace TEN::Scripting::View /// Flash screen. //@function FlashScreen //@tparam Color color (default Color(255, 255, 255)) - //@tparam float speed (default 1.0). Speed in "amount" per second. Value of 1 will make flash take one second. Clamped to [0.005, 1.0]. + //@tparam float speed (default 1.0). Speed in units per second. Value of 1 will make flash take one second. Clamped to [0.005, 1.0]. tableView.set_function(ScriptReserved_FlashScreen, &FlashScreen); /// Get the display resolution's aspect ratio. diff --git a/TombEngine/Shaders/Sky.fx b/TombEngine/Shaders/Sky.fx index d0ba7c0c7..7d43a0bb6 100644 --- a/TombEngine/Shaders/Sky.fx +++ b/TombEngine/Shaders/Sky.fx @@ -41,6 +41,7 @@ float4 PS(PixelShaderInput input) : SV_TARGET float3 light = saturate(Color.xyz - float3(input.FogBulbs.w, input.FogBulbs.w, input.FogBulbs.w) * 1.4f); output.xyz *= light; output.xyz += saturate(input.FogBulbs.xyz); + output.w *= Color.w; return output; } \ No newline at end of file diff --git a/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h b/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h index 72be08b3f..708c6ba43 100644 --- a/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h +++ b/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h @@ -13,6 +13,10 @@ namespace Save { struct RoomVector; +struct LevelData; +struct LevelDataBuilder; +struct LevelDataT; + struct Room; struct RoomBuilder; struct RoomT; @@ -537,6 +541,416 @@ struct KeyValPair::Traits { using type = KeyValPair; }; +struct LevelDataT : public flatbuffers::NativeTable { + typedef LevelData TableType; + int32_t level_far_view = 0; + bool storm_enabled = false; + bool rumble_enabled = false; + int32_t weather_type = 0; + float weather_strength = 0.0f; + bool fog_enabled = false; + int32_t fog_color = 0; + int32_t fog_min_distance = 0; + int32_t fog_max_distance = 0; + bool sky_layer_1_enabled = false; + int32_t sky_layer_1_color = 0; + int32_t sky_layer_1_speed = 0; + bool sky_layer_2_enabled = false; + int32_t sky_layer_2_color = 0; + int32_t sky_layer_2_speed = 0; + bool horizon1_enabled = false; + int32_t horizon1_object_id = 0; + std::unique_ptr horizon1_position{}; + std::unique_ptr horizon1_orientation{}; + float horizon1_transparency = 0.0f; + bool horizon2_enabled = false; + int32_t horizon2_object_id = 0; + std::unique_ptr horizon2_position{}; + std::unique_ptr horizon2_orientation{}; + float horizon2_transparency = 0.0f; + int32_t lensflare_sprite_id = 0; + float lensflare_pitch = 0.0f; + float lensflare_yaw = 0.0f; + int32_t lensflare_color = 0; + int32_t starfield_star_count = 0; + int32_t starfield_meteor_count = 0; + int32_t starfield_meteor_spawn_density = 0; + int32_t starfield_meteor_velocity = 0; +}; + +struct LevelData FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { + typedef LevelDataT NativeTableType; + typedef LevelDataBuilder Builder; + struct Traits; + enum FlatBuffersVTableOffset FLATBUFFERS_VTABLE_UNDERLYING_TYPE { + VT_LEVEL_FAR_VIEW = 4, + VT_STORM_ENABLED = 6, + VT_RUMBLE_ENABLED = 8, + VT_WEATHER_TYPE = 10, + VT_WEATHER_STRENGTH = 12, + VT_FOG_ENABLED = 14, + VT_FOG_COLOR = 16, + VT_FOG_MIN_DISTANCE = 18, + VT_FOG_MAX_DISTANCE = 20, + VT_SKY_LAYER_1_ENABLED = 22, + VT_SKY_LAYER_1_COLOR = 24, + VT_SKY_LAYER_1_SPEED = 26, + VT_SKY_LAYER_2_ENABLED = 28, + VT_SKY_LAYER_2_COLOR = 30, + VT_SKY_LAYER_2_SPEED = 32, + VT_HORIZON1_ENABLED = 34, + VT_HORIZON1_OBJECT_ID = 36, + VT_HORIZON1_POSITION = 38, + VT_HORIZON1_ORIENTATION = 40, + VT_HORIZON1_TRANSPARENCY = 42, + VT_HORIZON2_ENABLED = 44, + VT_HORIZON2_OBJECT_ID = 46, + VT_HORIZON2_POSITION = 48, + VT_HORIZON2_ORIENTATION = 50, + VT_HORIZON2_TRANSPARENCY = 52, + VT_LENSFLARE_SPRITE_ID = 54, + VT_LENSFLARE_PITCH = 56, + VT_LENSFLARE_YAW = 58, + VT_LENSFLARE_COLOR = 60, + VT_STARFIELD_STAR_COUNT = 62, + VT_STARFIELD_METEOR_COUNT = 64, + VT_STARFIELD_METEOR_SPAWN_DENSITY = 66, + VT_STARFIELD_METEOR_VELOCITY = 68 + }; + int32_t level_far_view() const { + return GetField(VT_LEVEL_FAR_VIEW, 0); + } + bool storm_enabled() const { + return GetField(VT_STORM_ENABLED, 0) != 0; + } + bool rumble_enabled() const { + return GetField(VT_RUMBLE_ENABLED, 0) != 0; + } + int32_t weather_type() const { + return GetField(VT_WEATHER_TYPE, 0); + } + float weather_strength() const { + return GetField(VT_WEATHER_STRENGTH, 0.0f); + } + bool fog_enabled() const { + return GetField(VT_FOG_ENABLED, 0) != 0; + } + int32_t fog_color() const { + return GetField(VT_FOG_COLOR, 0); + } + int32_t fog_min_distance() const { + return GetField(VT_FOG_MIN_DISTANCE, 0); + } + int32_t fog_max_distance() const { + return GetField(VT_FOG_MAX_DISTANCE, 0); + } + bool sky_layer_1_enabled() const { + return GetField(VT_SKY_LAYER_1_ENABLED, 0) != 0; + } + int32_t sky_layer_1_color() const { + return GetField(VT_SKY_LAYER_1_COLOR, 0); + } + int32_t sky_layer_1_speed() const { + return GetField(VT_SKY_LAYER_1_SPEED, 0); + } + bool sky_layer_2_enabled() const { + return GetField(VT_SKY_LAYER_2_ENABLED, 0) != 0; + } + int32_t sky_layer_2_color() const { + return GetField(VT_SKY_LAYER_2_COLOR, 0); + } + int32_t sky_layer_2_speed() const { + return GetField(VT_SKY_LAYER_2_SPEED, 0); + } + bool horizon1_enabled() const { + return GetField(VT_HORIZON1_ENABLED, 0) != 0; + } + int32_t horizon1_object_id() const { + return GetField(VT_HORIZON1_OBJECT_ID, 0); + } + const TEN::Save::Vector3 *horizon1_position() const { + return GetStruct(VT_HORIZON1_POSITION); + } + const TEN::Save::EulerAngles *horizon1_orientation() const { + return GetStruct(VT_HORIZON1_ORIENTATION); + } + float horizon1_transparency() const { + return GetField(VT_HORIZON1_TRANSPARENCY, 0.0f); + } + bool horizon2_enabled() const { + return GetField(VT_HORIZON2_ENABLED, 0) != 0; + } + int32_t horizon2_object_id() const { + return GetField(VT_HORIZON2_OBJECT_ID, 0); + } + const TEN::Save::Vector3 *horizon2_position() const { + return GetStruct(VT_HORIZON2_POSITION); + } + const TEN::Save::EulerAngles *horizon2_orientation() const { + return GetStruct(VT_HORIZON2_ORIENTATION); + } + float horizon2_transparency() const { + return GetField(VT_HORIZON2_TRANSPARENCY, 0.0f); + } + int32_t lensflare_sprite_id() const { + return GetField(VT_LENSFLARE_SPRITE_ID, 0); + } + float lensflare_pitch() const { + return GetField(VT_LENSFLARE_PITCH, 0.0f); + } + float lensflare_yaw() const { + return GetField(VT_LENSFLARE_YAW, 0.0f); + } + int32_t lensflare_color() const { + return GetField(VT_LENSFLARE_COLOR, 0); + } + int32_t starfield_star_count() const { + return GetField(VT_STARFIELD_STAR_COUNT, 0); + } + int32_t starfield_meteor_count() const { + return GetField(VT_STARFIELD_METEOR_COUNT, 0); + } + int32_t starfield_meteor_spawn_density() const { + return GetField(VT_STARFIELD_METEOR_SPAWN_DENSITY, 0); + } + int32_t starfield_meteor_velocity() const { + return GetField(VT_STARFIELD_METEOR_VELOCITY, 0); + } + bool Verify(flatbuffers::Verifier &verifier) const { + return VerifyTableStart(verifier) && + VerifyField(verifier, VT_LEVEL_FAR_VIEW) && + VerifyField(verifier, VT_STORM_ENABLED) && + VerifyField(verifier, VT_RUMBLE_ENABLED) && + VerifyField(verifier, VT_WEATHER_TYPE) && + VerifyField(verifier, VT_WEATHER_STRENGTH) && + VerifyField(verifier, VT_FOG_ENABLED) && + VerifyField(verifier, VT_FOG_COLOR) && + VerifyField(verifier, VT_FOG_MIN_DISTANCE) && + VerifyField(verifier, VT_FOG_MAX_DISTANCE) && + VerifyField(verifier, VT_SKY_LAYER_1_ENABLED) && + VerifyField(verifier, VT_SKY_LAYER_1_COLOR) && + VerifyField(verifier, VT_SKY_LAYER_1_SPEED) && + VerifyField(verifier, VT_SKY_LAYER_2_ENABLED) && + VerifyField(verifier, VT_SKY_LAYER_2_COLOR) && + VerifyField(verifier, VT_SKY_LAYER_2_SPEED) && + VerifyField(verifier, VT_HORIZON1_ENABLED) && + VerifyField(verifier, VT_HORIZON1_OBJECT_ID) && + VerifyField(verifier, VT_HORIZON1_POSITION) && + VerifyField(verifier, VT_HORIZON1_ORIENTATION) && + VerifyField(verifier, VT_HORIZON1_TRANSPARENCY) && + VerifyField(verifier, VT_HORIZON2_ENABLED) && + VerifyField(verifier, VT_HORIZON2_OBJECT_ID) && + VerifyField(verifier, VT_HORIZON2_POSITION) && + VerifyField(verifier, VT_HORIZON2_ORIENTATION) && + VerifyField(verifier, VT_HORIZON2_TRANSPARENCY) && + VerifyField(verifier, VT_LENSFLARE_SPRITE_ID) && + VerifyField(verifier, VT_LENSFLARE_PITCH) && + VerifyField(verifier, VT_LENSFLARE_YAW) && + VerifyField(verifier, VT_LENSFLARE_COLOR) && + VerifyField(verifier, VT_STARFIELD_STAR_COUNT) && + VerifyField(verifier, VT_STARFIELD_METEOR_COUNT) && + VerifyField(verifier, VT_STARFIELD_METEOR_SPAWN_DENSITY) && + VerifyField(verifier, VT_STARFIELD_METEOR_VELOCITY) && + verifier.EndTable(); + } + LevelDataT *UnPack(const flatbuffers::resolver_function_t *_resolver = nullptr) const; + void UnPackTo(LevelDataT *_o, const flatbuffers::resolver_function_t *_resolver = nullptr) const; + static flatbuffers::Offset Pack(flatbuffers::FlatBufferBuilder &_fbb, const LevelDataT* _o, const flatbuffers::rehasher_function_t *_rehasher = nullptr); +}; + +struct LevelDataBuilder { + typedef LevelData Table; + flatbuffers::FlatBufferBuilder &fbb_; + flatbuffers::uoffset_t start_; + void add_level_far_view(int32_t level_far_view) { + fbb_.AddElement(LevelData::VT_LEVEL_FAR_VIEW, level_far_view, 0); + } + void add_storm_enabled(bool storm_enabled) { + fbb_.AddElement(LevelData::VT_STORM_ENABLED, static_cast(storm_enabled), 0); + } + void add_rumble_enabled(bool rumble_enabled) { + fbb_.AddElement(LevelData::VT_RUMBLE_ENABLED, static_cast(rumble_enabled), 0); + } + void add_weather_type(int32_t weather_type) { + fbb_.AddElement(LevelData::VT_WEATHER_TYPE, weather_type, 0); + } + void add_weather_strength(float weather_strength) { + fbb_.AddElement(LevelData::VT_WEATHER_STRENGTH, weather_strength, 0.0f); + } + void add_fog_enabled(bool fog_enabled) { + fbb_.AddElement(LevelData::VT_FOG_ENABLED, static_cast(fog_enabled), 0); + } + void add_fog_color(int32_t fog_color) { + fbb_.AddElement(LevelData::VT_FOG_COLOR, fog_color, 0); + } + void add_fog_min_distance(int32_t fog_min_distance) { + fbb_.AddElement(LevelData::VT_FOG_MIN_DISTANCE, fog_min_distance, 0); + } + void add_fog_max_distance(int32_t fog_max_distance) { + fbb_.AddElement(LevelData::VT_FOG_MAX_DISTANCE, fog_max_distance, 0); + } + void add_sky_layer_1_enabled(bool sky_layer_1_enabled) { + fbb_.AddElement(LevelData::VT_SKY_LAYER_1_ENABLED, static_cast(sky_layer_1_enabled), 0); + } + void add_sky_layer_1_color(int32_t sky_layer_1_color) { + fbb_.AddElement(LevelData::VT_SKY_LAYER_1_COLOR, sky_layer_1_color, 0); + } + void add_sky_layer_1_speed(int32_t sky_layer_1_speed) { + fbb_.AddElement(LevelData::VT_SKY_LAYER_1_SPEED, sky_layer_1_speed, 0); + } + void add_sky_layer_2_enabled(bool sky_layer_2_enabled) { + fbb_.AddElement(LevelData::VT_SKY_LAYER_2_ENABLED, static_cast(sky_layer_2_enabled), 0); + } + void add_sky_layer_2_color(int32_t sky_layer_2_color) { + fbb_.AddElement(LevelData::VT_SKY_LAYER_2_COLOR, sky_layer_2_color, 0); + } + void add_sky_layer_2_speed(int32_t sky_layer_2_speed) { + fbb_.AddElement(LevelData::VT_SKY_LAYER_2_SPEED, sky_layer_2_speed, 0); + } + void add_horizon1_enabled(bool horizon1_enabled) { + fbb_.AddElement(LevelData::VT_HORIZON1_ENABLED, static_cast(horizon1_enabled), 0); + } + void add_horizon1_object_id(int32_t horizon1_object_id) { + fbb_.AddElement(LevelData::VT_HORIZON1_OBJECT_ID, horizon1_object_id, 0); + } + void add_horizon1_position(const TEN::Save::Vector3 *horizon1_position) { + fbb_.AddStruct(LevelData::VT_HORIZON1_POSITION, horizon1_position); + } + void add_horizon1_orientation(const TEN::Save::EulerAngles *horizon1_orientation) { + fbb_.AddStruct(LevelData::VT_HORIZON1_ORIENTATION, horizon1_orientation); + } + void add_horizon1_transparency(float horizon1_transparency) { + fbb_.AddElement(LevelData::VT_HORIZON1_TRANSPARENCY, horizon1_transparency, 0.0f); + } + void add_horizon2_enabled(bool horizon2_enabled) { + fbb_.AddElement(LevelData::VT_HORIZON2_ENABLED, static_cast(horizon2_enabled), 0); + } + void add_horizon2_object_id(int32_t horizon2_object_id) { + fbb_.AddElement(LevelData::VT_HORIZON2_OBJECT_ID, horizon2_object_id, 0); + } + void add_horizon2_position(const TEN::Save::Vector3 *horizon2_position) { + fbb_.AddStruct(LevelData::VT_HORIZON2_POSITION, horizon2_position); + } + void add_horizon2_orientation(const TEN::Save::EulerAngles *horizon2_orientation) { + fbb_.AddStruct(LevelData::VT_HORIZON2_ORIENTATION, horizon2_orientation); + } + void add_horizon2_transparency(float horizon2_transparency) { + fbb_.AddElement(LevelData::VT_HORIZON2_TRANSPARENCY, horizon2_transparency, 0.0f); + } + void add_lensflare_sprite_id(int32_t lensflare_sprite_id) { + fbb_.AddElement(LevelData::VT_LENSFLARE_SPRITE_ID, lensflare_sprite_id, 0); + } + void add_lensflare_pitch(float lensflare_pitch) { + fbb_.AddElement(LevelData::VT_LENSFLARE_PITCH, lensflare_pitch, 0.0f); + } + void add_lensflare_yaw(float lensflare_yaw) { + fbb_.AddElement(LevelData::VT_LENSFLARE_YAW, lensflare_yaw, 0.0f); + } + void add_lensflare_color(int32_t lensflare_color) { + fbb_.AddElement(LevelData::VT_LENSFLARE_COLOR, lensflare_color, 0); + } + void add_starfield_star_count(int32_t starfield_star_count) { + fbb_.AddElement(LevelData::VT_STARFIELD_STAR_COUNT, starfield_star_count, 0); + } + void add_starfield_meteor_count(int32_t starfield_meteor_count) { + fbb_.AddElement(LevelData::VT_STARFIELD_METEOR_COUNT, starfield_meteor_count, 0); + } + void add_starfield_meteor_spawn_density(int32_t starfield_meteor_spawn_density) { + fbb_.AddElement(LevelData::VT_STARFIELD_METEOR_SPAWN_DENSITY, starfield_meteor_spawn_density, 0); + } + void add_starfield_meteor_velocity(int32_t starfield_meteor_velocity) { + fbb_.AddElement(LevelData::VT_STARFIELD_METEOR_VELOCITY, starfield_meteor_velocity, 0); + } + explicit LevelDataBuilder(flatbuffers::FlatBufferBuilder &_fbb) + : fbb_(_fbb) { + start_ = fbb_.StartTable(); + } + flatbuffers::Offset Finish() { + const auto end = fbb_.EndTable(start_); + auto o = flatbuffers::Offset(end); + return o; + } +}; + +inline flatbuffers::Offset CreateLevelData( + flatbuffers::FlatBufferBuilder &_fbb, + int32_t level_far_view = 0, + bool storm_enabled = false, + bool rumble_enabled = false, + int32_t weather_type = 0, + float weather_strength = 0.0f, + bool fog_enabled = false, + int32_t fog_color = 0, + int32_t fog_min_distance = 0, + int32_t fog_max_distance = 0, + bool sky_layer_1_enabled = false, + int32_t sky_layer_1_color = 0, + int32_t sky_layer_1_speed = 0, + bool sky_layer_2_enabled = false, + int32_t sky_layer_2_color = 0, + int32_t sky_layer_2_speed = 0, + bool horizon1_enabled = false, + int32_t horizon1_object_id = 0, + const TEN::Save::Vector3 *horizon1_position = 0, + const TEN::Save::EulerAngles *horizon1_orientation = 0, + float horizon1_transparency = 0.0f, + bool horizon2_enabled = false, + int32_t horizon2_object_id = 0, + const TEN::Save::Vector3 *horizon2_position = 0, + const TEN::Save::EulerAngles *horizon2_orientation = 0, + float horizon2_transparency = 0.0f, + int32_t lensflare_sprite_id = 0, + float lensflare_pitch = 0.0f, + float lensflare_yaw = 0.0f, + int32_t lensflare_color = 0, + int32_t starfield_star_count = 0, + int32_t starfield_meteor_count = 0, + int32_t starfield_meteor_spawn_density = 0, + int32_t starfield_meteor_velocity = 0) { + LevelDataBuilder builder_(_fbb); + builder_.add_starfield_meteor_velocity(starfield_meteor_velocity); + builder_.add_starfield_meteor_spawn_density(starfield_meteor_spawn_density); + builder_.add_starfield_meteor_count(starfield_meteor_count); + builder_.add_starfield_star_count(starfield_star_count); + builder_.add_lensflare_color(lensflare_color); + builder_.add_lensflare_yaw(lensflare_yaw); + builder_.add_lensflare_pitch(lensflare_pitch); + builder_.add_lensflare_sprite_id(lensflare_sprite_id); + builder_.add_horizon2_transparency(horizon2_transparency); + builder_.add_horizon2_orientation(horizon2_orientation); + builder_.add_horizon2_position(horizon2_position); + builder_.add_horizon2_object_id(horizon2_object_id); + builder_.add_horizon1_transparency(horizon1_transparency); + builder_.add_horizon1_orientation(horizon1_orientation); + builder_.add_horizon1_position(horizon1_position); + builder_.add_horizon1_object_id(horizon1_object_id); + builder_.add_sky_layer_2_speed(sky_layer_2_speed); + builder_.add_sky_layer_2_color(sky_layer_2_color); + builder_.add_sky_layer_1_speed(sky_layer_1_speed); + builder_.add_sky_layer_1_color(sky_layer_1_color); + builder_.add_fog_max_distance(fog_max_distance); + builder_.add_fog_min_distance(fog_min_distance); + builder_.add_fog_color(fog_color); + builder_.add_weather_strength(weather_strength); + builder_.add_weather_type(weather_type); + builder_.add_level_far_view(level_far_view); + builder_.add_horizon2_enabled(horizon2_enabled); + builder_.add_horizon1_enabled(horizon1_enabled); + builder_.add_sky_layer_2_enabled(sky_layer_2_enabled); + builder_.add_sky_layer_1_enabled(sky_layer_1_enabled); + builder_.add_fog_enabled(fog_enabled); + builder_.add_rumble_enabled(rumble_enabled); + builder_.add_storm_enabled(storm_enabled); + return builder_.Finish(); +} + +struct LevelData::Traits { + using type = LevelData; + static auto constexpr Create = CreateLevelData; +}; + +flatbuffers::Offset CreateLevelData(flatbuffers::FlatBufferBuilder &_fbb, const LevelDataT *_o, const flatbuffers::rehasher_function_t *_rehasher = nullptr); + struct RoomT : public flatbuffers::NativeTable { typedef Room TableType; int32_t index = 0; @@ -7576,6 +7990,7 @@ struct SaveGameT : public flatbuffers::NativeTable { std::unique_ptr header{}; std::unique_ptr game{}; std::unique_ptr level{}; + std::unique_ptr level_data{}; int32_t secret_bits = 0; std::unique_ptr camera{}; std::unique_ptr lara{}; @@ -7641,61 +8056,62 @@ struct SaveGame FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { VT_HEADER = 4, VT_GAME = 6, VT_LEVEL = 8, - VT_SECRET_BITS = 10, - VT_CAMERA = 12, - VT_LARA = 14, - VT_ROOMS = 16, - VT_ITEMS = 18, - VT_NEXT_ITEM_FREE = 20, - VT_NEXT_ITEM_ACTIVE = 22, - VT_ROOM_ITEMS = 24, - VT_FISH_SWARM = 26, - VT_FXINFOS = 28, - VT_NEXT_FX_FREE = 30, - VT_NEXT_FX_ACTIVE = 32, - VT_FIXED_CAMERAS = 34, - VT_SINKS = 36, - VT_STATIC_MESHES = 38, - VT_FLYBY_CAMERAS = 40, - VT_PARTICLES = 42, - VT_RATS = 44, - VT_SPIDERS = 46, - VT_SCARABS = 48, - VT_BATS = 50, - VT_FLIP_MAPS = 52, - VT_FLIP_STATS = 54, - VT_FLIP_EFFECT = 56, - VT_FLIP_TIMER = 58, - VT_FLIP_STATUS = 60, - VT_CURRENT_FOV = 62, - VT_LAST_INV_ITEM = 64, - VT_ACTION_QUEUE = 66, - VT_SOUNDTRACKS = 68, - VT_CD_FLAGS = 70, - VT_POSTPROCESS_MODE = 72, - VT_POSTPROCESS_STRENGTH = 74, - VT_POSTPROCESS_TINT = 76, - VT_ROPE = 78, - VT_PENDULUM = 80, - VT_ALTERNATE_PENDULUM = 82, - VT_VOLUMES = 84, - VT_GLOBAL_EVENT_SETS = 86, - VT_VOLUME_EVENT_SETS = 88, - VT_SCRIPT_VARS = 90, - VT_CALLBACKS_PRE_START = 92, - VT_CALLBACKS_POST_START = 94, - VT_CALLBACKS_PRE_END = 96, - VT_CALLBACKS_POST_END = 98, - VT_CALLBACKS_PRE_SAVE = 100, - VT_CALLBACKS_POST_SAVE = 102, - VT_CALLBACKS_PRE_LOAD = 104, - VT_CALLBACKS_POST_LOAD = 106, - VT_CALLBACKS_PRE_LOOP = 108, - VT_CALLBACKS_POST_LOOP = 110, - VT_CALLBACKS_PRE_USEITEM = 112, - VT_CALLBACKS_POST_USEITEM = 114, - VT_CALLBACKS_PRE_FREEZE = 116, - VT_CALLBACKS_POST_FREEZE = 118 + VT_LEVEL_DATA = 10, + VT_SECRET_BITS = 12, + VT_CAMERA = 14, + VT_LARA = 16, + VT_ROOMS = 18, + VT_ITEMS = 20, + VT_NEXT_ITEM_FREE = 22, + VT_NEXT_ITEM_ACTIVE = 24, + VT_ROOM_ITEMS = 26, + VT_FISH_SWARM = 28, + VT_FXINFOS = 30, + VT_NEXT_FX_FREE = 32, + VT_NEXT_FX_ACTIVE = 34, + VT_FIXED_CAMERAS = 36, + VT_SINKS = 38, + VT_STATIC_MESHES = 40, + VT_FLYBY_CAMERAS = 42, + VT_PARTICLES = 44, + VT_RATS = 46, + VT_SPIDERS = 48, + VT_SCARABS = 50, + VT_BATS = 52, + VT_FLIP_MAPS = 54, + VT_FLIP_STATS = 56, + VT_FLIP_EFFECT = 58, + VT_FLIP_TIMER = 60, + VT_FLIP_STATUS = 62, + VT_CURRENT_FOV = 64, + VT_LAST_INV_ITEM = 66, + VT_ACTION_QUEUE = 68, + VT_SOUNDTRACKS = 70, + VT_CD_FLAGS = 72, + VT_POSTPROCESS_MODE = 74, + VT_POSTPROCESS_STRENGTH = 76, + VT_POSTPROCESS_TINT = 78, + VT_ROPE = 80, + VT_PENDULUM = 82, + VT_ALTERNATE_PENDULUM = 84, + VT_VOLUMES = 86, + VT_GLOBAL_EVENT_SETS = 88, + VT_VOLUME_EVENT_SETS = 90, + VT_SCRIPT_VARS = 92, + VT_CALLBACKS_PRE_START = 94, + VT_CALLBACKS_POST_START = 96, + VT_CALLBACKS_PRE_END = 98, + VT_CALLBACKS_POST_END = 100, + VT_CALLBACKS_PRE_SAVE = 102, + VT_CALLBACKS_POST_SAVE = 104, + VT_CALLBACKS_PRE_LOAD = 106, + VT_CALLBACKS_POST_LOAD = 108, + VT_CALLBACKS_PRE_LOOP = 110, + VT_CALLBACKS_POST_LOOP = 112, + VT_CALLBACKS_PRE_USEITEM = 114, + VT_CALLBACKS_POST_USEITEM = 116, + VT_CALLBACKS_PRE_FREEZE = 118, + VT_CALLBACKS_POST_FREEZE = 120 }; const TEN::Save::SaveGameHeader *header() const { return GetPointer(VT_HEADER); @@ -7706,6 +8122,9 @@ struct SaveGame FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { const TEN::Save::SaveGameStatistics *level() const { return GetPointer(VT_LEVEL); } + const TEN::Save::LevelData *level_data() const { + return GetPointer(VT_LEVEL_DATA); + } int32_t secret_bits() const { return GetField(VT_SECRET_BITS, 0); } @@ -7879,6 +8298,8 @@ struct SaveGame FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { verifier.VerifyTable(game()) && VerifyOffset(verifier, VT_LEVEL) && verifier.VerifyTable(level()) && + VerifyOffset(verifier, VT_LEVEL_DATA) && + verifier.VerifyTable(level_data()) && VerifyField(verifier, VT_SECRET_BITS) && VerifyOffset(verifier, VT_CAMERA) && verifier.VerifyTable(camera()) && @@ -8027,6 +8448,9 @@ struct SaveGameBuilder { void add_level(flatbuffers::Offset level) { fbb_.AddOffset(SaveGame::VT_LEVEL, level); } + void add_level_data(flatbuffers::Offset level_data) { + fbb_.AddOffset(SaveGame::VT_LEVEL_DATA, level_data); + } void add_secret_bits(int32_t secret_bits) { fbb_.AddElement(SaveGame::VT_SECRET_BITS, secret_bits, 0); } @@ -8208,6 +8632,7 @@ inline flatbuffers::Offset CreateSaveGame( flatbuffers::Offset header = 0, flatbuffers::Offset game = 0, flatbuffers::Offset level = 0, + flatbuffers::Offset level_data = 0, int32_t secret_bits = 0, flatbuffers::Offset camera = 0, flatbuffers::Offset lara = 0, @@ -8318,6 +8743,7 @@ inline flatbuffers::Offset CreateSaveGame( builder_.add_lara(lara); builder_.add_camera(camera); builder_.add_secret_bits(secret_bits); + builder_.add_level_data(level_data); builder_.add_level(level); builder_.add_game(game); builder_.add_header(header); @@ -8335,6 +8761,7 @@ inline flatbuffers::Offset CreateSaveGameDirect( flatbuffers::Offset header = 0, flatbuffers::Offset game = 0, flatbuffers::Offset level = 0, + flatbuffers::Offset level_data = 0, int32_t secret_bits = 0, flatbuffers::Offset camera = 0, flatbuffers::Offset lara = 0, @@ -8431,6 +8858,7 @@ inline flatbuffers::Offset CreateSaveGameDirect( header, game, level, + level_data, secret_bits, camera, lara, @@ -8490,6 +8918,128 @@ inline flatbuffers::Offset CreateSaveGameDirect( flatbuffers::Offset CreateSaveGame(flatbuffers::FlatBufferBuilder &_fbb, const SaveGameT *_o, const flatbuffers::rehasher_function_t *_rehasher = nullptr); +inline LevelDataT *LevelData::UnPack(const flatbuffers::resolver_function_t *_resolver) const { + auto _o = std::make_unique(); + UnPackTo(_o.get(), _resolver); + return _o.release(); +} + +inline void LevelData::UnPackTo(LevelDataT *_o, const flatbuffers::resolver_function_t *_resolver) const { + (void)_o; + (void)_resolver; + { auto _e = level_far_view(); _o->level_far_view = _e; } + { auto _e = storm_enabled(); _o->storm_enabled = _e; } + { auto _e = rumble_enabled(); _o->rumble_enabled = _e; } + { auto _e = weather_type(); _o->weather_type = _e; } + { auto _e = weather_strength(); _o->weather_strength = _e; } + { auto _e = fog_enabled(); _o->fog_enabled = _e; } + { auto _e = fog_color(); _o->fog_color = _e; } + { auto _e = fog_min_distance(); _o->fog_min_distance = _e; } + { auto _e = fog_max_distance(); _o->fog_max_distance = _e; } + { auto _e = sky_layer_1_enabled(); _o->sky_layer_1_enabled = _e; } + { auto _e = sky_layer_1_color(); _o->sky_layer_1_color = _e; } + { auto _e = sky_layer_1_speed(); _o->sky_layer_1_speed = _e; } + { auto _e = sky_layer_2_enabled(); _o->sky_layer_2_enabled = _e; } + { auto _e = sky_layer_2_color(); _o->sky_layer_2_color = _e; } + { auto _e = sky_layer_2_speed(); _o->sky_layer_2_speed = _e; } + { auto _e = horizon1_enabled(); _o->horizon1_enabled = _e; } + { auto _e = horizon1_object_id(); _o->horizon1_object_id = _e; } + { auto _e = horizon1_position(); if (_e) _o->horizon1_position = std::unique_ptr(new TEN::Save::Vector3(*_e)); } + { auto _e = horizon1_orientation(); if (_e) _o->horizon1_orientation = std::unique_ptr(new TEN::Save::EulerAngles(*_e)); } + { auto _e = horizon1_transparency(); _o->horizon1_transparency = _e; } + { auto _e = horizon2_enabled(); _o->horizon2_enabled = _e; } + { auto _e = horizon2_object_id(); _o->horizon2_object_id = _e; } + { auto _e = horizon2_position(); if (_e) _o->horizon2_position = std::unique_ptr(new TEN::Save::Vector3(*_e)); } + { auto _e = horizon2_orientation(); if (_e) _o->horizon2_orientation = std::unique_ptr(new TEN::Save::EulerAngles(*_e)); } + { auto _e = horizon2_transparency(); _o->horizon2_transparency = _e; } + { auto _e = lensflare_sprite_id(); _o->lensflare_sprite_id = _e; } + { auto _e = lensflare_pitch(); _o->lensflare_pitch = _e; } + { auto _e = lensflare_yaw(); _o->lensflare_yaw = _e; } + { auto _e = lensflare_color(); _o->lensflare_color = _e; } + { auto _e = starfield_star_count(); _o->starfield_star_count = _e; } + { auto _e = starfield_meteor_count(); _o->starfield_meteor_count = _e; } + { auto _e = starfield_meteor_spawn_density(); _o->starfield_meteor_spawn_density = _e; } + { auto _e = starfield_meteor_velocity(); _o->starfield_meteor_velocity = _e; } +} + +inline flatbuffers::Offset LevelData::Pack(flatbuffers::FlatBufferBuilder &_fbb, const LevelDataT* _o, const flatbuffers::rehasher_function_t *_rehasher) { + return CreateLevelData(_fbb, _o, _rehasher); +} + +inline flatbuffers::Offset CreateLevelData(flatbuffers::FlatBufferBuilder &_fbb, const LevelDataT *_o, const flatbuffers::rehasher_function_t *_rehasher) { + (void)_rehasher; + (void)_o; + struct _VectorArgs { flatbuffers::FlatBufferBuilder *__fbb; const LevelDataT* __o; const flatbuffers::rehasher_function_t *__rehasher; } _va = { &_fbb, _o, _rehasher}; (void)_va; + auto _level_far_view = _o->level_far_view; + auto _storm_enabled = _o->storm_enabled; + auto _rumble_enabled = _o->rumble_enabled; + auto _weather_type = _o->weather_type; + auto _weather_strength = _o->weather_strength; + auto _fog_enabled = _o->fog_enabled; + auto _fog_color = _o->fog_color; + auto _fog_min_distance = _o->fog_min_distance; + auto _fog_max_distance = _o->fog_max_distance; + auto _sky_layer_1_enabled = _o->sky_layer_1_enabled; + auto _sky_layer_1_color = _o->sky_layer_1_color; + auto _sky_layer_1_speed = _o->sky_layer_1_speed; + auto _sky_layer_2_enabled = _o->sky_layer_2_enabled; + auto _sky_layer_2_color = _o->sky_layer_2_color; + auto _sky_layer_2_speed = _o->sky_layer_2_speed; + auto _horizon1_enabled = _o->horizon1_enabled; + auto _horizon1_object_id = _o->horizon1_object_id; + auto _horizon1_position = _o->horizon1_position ? _o->horizon1_position.get() : 0; + auto _horizon1_orientation = _o->horizon1_orientation ? _o->horizon1_orientation.get() : 0; + auto _horizon1_transparency = _o->horizon1_transparency; + auto _horizon2_enabled = _o->horizon2_enabled; + auto _horizon2_object_id = _o->horizon2_object_id; + auto _horizon2_position = _o->horizon2_position ? _o->horizon2_position.get() : 0; + auto _horizon2_orientation = _o->horizon2_orientation ? _o->horizon2_orientation.get() : 0; + auto _horizon2_transparency = _o->horizon2_transparency; + auto _lensflare_sprite_id = _o->lensflare_sprite_id; + auto _lensflare_pitch = _o->lensflare_pitch; + auto _lensflare_yaw = _o->lensflare_yaw; + auto _lensflare_color = _o->lensflare_color; + auto _starfield_star_count = _o->starfield_star_count; + auto _starfield_meteor_count = _o->starfield_meteor_count; + auto _starfield_meteor_spawn_density = _o->starfield_meteor_spawn_density; + auto _starfield_meteor_velocity = _o->starfield_meteor_velocity; + return TEN::Save::CreateLevelData( + _fbb, + _level_far_view, + _storm_enabled, + _rumble_enabled, + _weather_type, + _weather_strength, + _fog_enabled, + _fog_color, + _fog_min_distance, + _fog_max_distance, + _sky_layer_1_enabled, + _sky_layer_1_color, + _sky_layer_1_speed, + _sky_layer_2_enabled, + _sky_layer_2_color, + _sky_layer_2_speed, + _horizon1_enabled, + _horizon1_object_id, + _horizon1_position, + _horizon1_orientation, + _horizon1_transparency, + _horizon2_enabled, + _horizon2_object_id, + _horizon2_position, + _horizon2_orientation, + _horizon2_transparency, + _lensflare_sprite_id, + _lensflare_pitch, + _lensflare_yaw, + _lensflare_color, + _starfield_star_count, + _starfield_meteor_count, + _starfield_meteor_spawn_density, + _starfield_meteor_velocity); +} + inline RoomT *Room::UnPack(const flatbuffers::resolver_function_t *_resolver) const { auto _o = std::make_unique(); UnPackTo(_o.get(), _resolver); @@ -10763,6 +11313,7 @@ inline void SaveGame::UnPackTo(SaveGameT *_o, const flatbuffers::resolver_functi { auto _e = header(); if (_e) _o->header = std::unique_ptr(_e->UnPack(_resolver)); } { auto _e = game(); if (_e) _o->game = std::unique_ptr(_e->UnPack(_resolver)); } { auto _e = level(); if (_e) _o->level = std::unique_ptr(_e->UnPack(_resolver)); } + { auto _e = level_data(); if (_e) _o->level_data = std::unique_ptr(_e->UnPack(_resolver)); } { auto _e = secret_bits(); _o->secret_bits = _e; } { auto _e = camera(); if (_e) _o->camera = std::unique_ptr(_e->UnPack(_resolver)); } { auto _e = lara(); if (_e) _o->lara = std::unique_ptr(_e->UnPack(_resolver)); } @@ -10831,6 +11382,7 @@ inline flatbuffers::Offset CreateSaveGame(flatbuffers::FlatBufferBuild auto _header = _o->header ? CreateSaveGameHeader(_fbb, _o->header.get(), _rehasher) : 0; auto _game = _o->game ? CreateSaveGameStatistics(_fbb, _o->game.get(), _rehasher) : 0; auto _level = _o->level ? CreateSaveGameStatistics(_fbb, _o->level.get(), _rehasher) : 0; + auto _level_data = _o->level_data ? CreateLevelData(_fbb, _o->level_data.get(), _rehasher) : 0; auto _secret_bits = _o->secret_bits; auto _camera = _o->camera ? CreateCamera(_fbb, _o->camera.get(), _rehasher) : 0; auto _lara = _o->lara ? CreateLara(_fbb, _o->lara.get(), _rehasher) : 0; @@ -10891,6 +11443,7 @@ inline flatbuffers::Offset CreateSaveGame(flatbuffers::FlatBufferBuild _header, _game, _level, + _level_data, _secret_bits, _camera, _lara, diff --git a/TombEngine/Specific/savegame/schema/ten_savegame.fbs b/TombEngine/Specific/savegame/schema/ten_savegame.fbs index cdd4ddfa1..f887b9561 100644 --- a/TombEngine/Specific/savegame/schema/ten_savegame.fbs +++ b/TombEngine/Specific/savegame/schema/ten_savegame.fbs @@ -6,6 +6,50 @@ struct RoomVector { y_location: uint32; } +table LevelData { + level_far_view: int32; + + storm_enabled: bool; + rumble_enabled: bool; + weather_type: int32; + weather_strength: float; + + fog_enabled: bool; + fog_color: int32; + fog_min_distance: int32; + fog_max_distance: int32; + + sky_layer_1_enabled: bool; + sky_layer_1_color: int32; + sky_layer_1_speed: int32; + + sky_layer_2_enabled: bool; + sky_layer_2_color: int32; + sky_layer_2_speed: int32; + + horizon1_enabled: bool; + horizon1_object_id: int32; + horizon1_position: Vector3; + horizon1_orientation: EulerAngles; + horizon1_transparency: float; + + horizon2_enabled: bool; + horizon2_object_id: int32; + horizon2_position: Vector3; + horizon2_orientation: EulerAngles; + horizon2_transparency: float; + + lensflare_sprite_id: int32; + lensflare_pitch: float; + lensflare_yaw: float; + lensflare_color: int32; + + starfield_star_count: int32; + starfield_meteor_count: int32; + starfield_meteor_spawn_density: int32; + starfield_meteor_velocity: int32; +} + table Room { index: int32; name: string; @@ -548,6 +592,7 @@ table SaveGame { header: SaveGameHeader; game: SaveGameStatistics; level: SaveGameStatistics; + level_data: LevelData; secret_bits: int32; camera: Camera; lara: Lara; @@ -579,6 +624,7 @@ table SaveGame { action_queue: [int32]; soundtracks: [Soundtrack]; cd_flags: [int32]; + postprocess_mode: int32; postprocess_strength: float; postprocess_tint: Vector3; diff --git a/TombEngine/TombEngine.vcxproj b/TombEngine/TombEngine.vcxproj index 0a7a2b2cf..e9163569d 100644 --- a/TombEngine/TombEngine.vcxproj +++ b/TombEngine/TombEngine.vcxproj @@ -888,6 +888,7 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. + @@ -1341,6 +1342,7 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. + From d35bd90a12b180ade9111755e4dbebf26576e3ae Mon Sep 17 00:00:00 2001 From: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Sat, 8 Mar 2025 23:36:56 -0500 Subject: [PATCH 019/160] Tr4 statue plinth (#1580) * Update to bug report form * Update bug_report.yaml * Update AUTHORS.md - Tomo (general coding, special FX coding, bug fixing) * Update CHANGELOG.md * Update CHANGELOG.md * Update bug_report.yaml * FirstComitt * Committ * Update * MeshBit * Backup * Working * Fixed * Final * Squashed commit of the following: commit 77d0865c8a37dea33d2573b8079b8c9b59f2665a Author: Nemoel-Tomo Date: Sun Feb 16 08:20:58 2025 +0100 Waterfall emitter formatting fix (#1570) commit 92329741adac17807a79850dfd401fbec988ce6b Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat Feb 15 07:46:37 2025 +0100 Clarify EmitSpotLight description commit 562637f5993f4bea2b883919fbd42fde497cc8ec Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Fri Feb 14 23:10:40 2025 +0100 Fixed #1574 commit a64825b6f166d5d1bb99304af32496bbea242f3e Author: Sezz Date: Fri Feb 14 04:30:00 2025 +1100 Add missing shift in EmitParticle() commit 455d547de77975e881ef57d6643758d18a715838 Author: Sezz Date: Fri Feb 14 04:25:55 2025 +1100 Add lock to parallel task class commit 918237113f02d57a1535c99a9e4ff34b5c52f158 Author: Sezz Date: Thu Feb 13 14:59:16 2025 +1100 Make script utils more idiomatic to C++ commit b78376b0abdec97fab0a0321a3d5005ec56b221f Author: Sezz Date: Thu Feb 13 12:44:06 2025 +1100 Use correct angle conversion in EmitPatricle() commit 3e00302ade9a153024fba2ad0c6b15387c7d90b7 Author: Sezz Date: Thu Feb 13 05:38:56 2025 +1100 Update Rotation.cpp commit f1c1fd2f63d5ab7ef77779535d609a77617646d8 Author: Sezz Date: Thu Feb 13 04:12:34 2025 +1100 Add Lerp() method to script Rotation class commit 6ef9675bcbc93fe26044ead572e1d9612e642814 Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Wed Feb 12 09:08:45 2025 +0100 Update CHANGELOG.md commit ca56f62f540a1e2616089010f779bfd3a472a4e5 Author: Sezz Date: Wed Feb 12 18:59:54 2025 +1100 Multithreading (#1541) * Create Worker class for multithreading * Update TombEngine.vcxproj * Rename GetWorkerCount() to GetThreadCount() * Add ProcessInParallel template for vectors * Add multiThreaded flag to settings, process sprites in parallel * Update Flow.Settings.html * Refine WorkerManager class conventions; deinit threads properly * Don't require explicit destruction * Address basic PR notes * Update Worker.cpp * Simplify ThreadManager class * Add method for running single task * Use singleton pattern; use more appropriate Controller suffix * Update WorkerController template method * Revise method * Handle exception in ~WorkerController() * Grammar * Correctly init single-threaded mode * Update CHANGELOG.md * Defer thread init until g_GameFlow is valid * unsigned int -> int * Rename class --------- Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com> commit d37ac17a39acf9ad255a7033ad6f3da3b5c9b173 Author: Sezz Date: Wed Feb 12 17:36:12 2025 +1100 Formatting commit 62ce2f043d53a45360fb51132561316d649980be Author: Sezz Date: Tue Feb 11 18:05:07 2025 +1100 Fix bridges moving the player when the player is underwater commit 0bb9af989432a122a8d7a2185dec9b2d6f927f3e Author: Sezz Date: Tue Feb 11 17:31:51 2025 +1100 puzzle_keys.cpp formatting commit 7d18d7506f7fe9ff4d542072b63607f3d73a7575 Author: davidmarr <116632612+davidmarr@users.noreply.github.com> Date: Sun Feb 9 15:58:15 2025 +0100 Update Type module (#1569) * Update VolumeObject.cpp fixed Volume:GetActive() method * Update CHANGELOG.md * function description LevelFuncs.OnUseItem * Revert "function description LevelFuncs.OnUseItem" This reverts commit 2478afca68f1e0ce11c610f07da6c6588cc4f35f. * Update Type.lua commit 909f631c2f1d2cab7a46eeba8eb92ea1020efce9 Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat Feb 8 11:04:40 2025 +0100 Fixed mistake in electricity rendering commit a840c2200c0f5b6a231d9d51d3539db25626d6b7 Merge: 2c6331f58 a31faffec Author: Sezz Date: Sat Feb 8 02:58:13 2025 +1100 Merge branch 'develop' of https://github.com/MontyTRC89/TombEngine into develop commit 2c6331f583a7669a0ab6a645ead9623f967b4d29 Author: Sezz Date: Sat Feb 8 02:58:03 2025 +1100 Deprecate CalculateDistance() script function commit a31faffec52e93f3a1ef9ed04e03a8fe50d5cd2e Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Fri Feb 7 08:31:14 2025 +0100 Update CHANGELOG.md commit 1f81ccf44dd126b53f757fca31fd97ae5f49c25b Author: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Thu Feb 6 18:05:25 2025 -0500 Diary module (TEN side) (#1509) * Update to bug report form * Update bug_report.yaml * Update AUTHORS.md - Tomo (general coding, special FX coding, bug fixing) * Update CHANGELOG.md * Update CHANGELOG.md * Update bug_report.yaml * Add files via upload * Add files via upload * Add ID_DIARY_SPRITES (1384) and DIARY_ENTRY_SPRITES (1385) * Delete Scripts/Engine/Diarymodule.lua * Add files via upload * Add files via upload * Add files via upload * Add files via upload * Delete Scripts/Engine/CustomBar.lua * Add files via upload * Update CustomDiary.lua * Add files via upload * Add files via upload * Add files via upload * Update CustomDiary.lua * Upload * Update CHANGELOG.md * Revisions * Doc revisions * Remove GameVars.Engine everywhere. * Added error warnings by integrating type module * Update bug_report.yaml * Fixed the bug with GameVars resetting each level. * Added .Engine back. * Added missing checks. * Removed nil from textOptions loop * Added full TEN name for printlogs. * LatestChanges * Added section for import. --------- Co-authored-by: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> commit 34ff933e5bcf6fec469b88da4f128a7b6dfb3d63 Author: Sezz Date: Thu Feb 6 18:48:45 2025 +1100 Update LogicHandler.cpp commit 5500b13659896a63698d150fe26debfe722e9c2d Author: Sezz Date: Thu Feb 6 18:47:33 2025 +1100 Update LogicHandler.cpp commit acb1bb15187d6f54bdaf177bbad7d7bc23c1071f Author: Sezz Date: Thu Feb 6 18:46:16 2025 +1100 Enforce proper convention for the few Lua table constants that didn't use it yet commit 89d5b7429894338b694d3fa45f0dd2eea4f707db Author: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Thu Feb 6 02:09:53 2025 -0500 Fix Trigger Triggerer (#1565) * Fix * Update CHANGELOG.md * Update trigger.cpp --------- Co-authored-by: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> commit 8316062e3a808912504075586f2f31a3a646a6fe Merge: 5f447d95c 599a651b6 Author: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Thu Feb 6 06:03:41 2025 +0000 Merge branch 'develop' of https://github.com/MontyTRC89/TombEngine into develop commit 5f447d95c511d3eefd111298a3b37fd106d96eef Author: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Thu Feb 6 06:03:18 2025 +0000 Fix stopwatch display in inventory (due to removal of trademarked item) Now the trademarked item from Tomb Raider Chronicles has been removed and replaced with the stopwatch from Tomb Raider III commit 599a651b6fdb17eca7c8136c10af823de2c335ad Author: Sezz Date: Thu Feb 6 16:56:19 2025 +1100 Update lens flare and starfield Lua docs commit 94ede801bc50500a1e0388f167752a19d76aacb8 Author: Sezz Date: Thu Feb 6 16:35:59 2025 +1100 Misc. script doc tidying; move some script classes to namespaces commit be8048407efc6aed145a1c28376100c1f4f99d13 Author: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Wed Feb 5 23:51:35 2025 -0500 Underwater keys/puzzles (#1529) * Update to bug report form * Update bug_report.yaml * Update AUTHORS.md - Tomo (general coding, special FX coding, bug fixing) * Update CHANGELOG.md * Update CHANGELOG.md * Update bug_report.yaml * First Push * Updae LaraStruct to use animation 280 * Update puzzles_keys.cpp * Update CHANGELOG.md * Squashed commit of the following: commit e50a4f8c27091fcae1d22bfe91ed90d849fd8280 Author: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Wed Dec 25 20:07:56 2024 -0500 Doc Revision commit 39a6e713ce51a2e55f4cacb30af28affacaf23b4 Author: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Wed Dec 25 20:02:47 2024 -0500 Doc revisions commit c3303438205692a4f817cc0bd1c4d1c71cdaebbf Author: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Wed Dec 25 19:52:59 2024 -0500 Update CHANGELOG.md commit ad62d7b605a48e89087648d8b40948289eea96f6 Author: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Wed Dec 25 19:42:32 2024 -0500 Check commit e135195641e463bb1013c7a1e2565f3a0ecb7eac Author: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Wed Dec 25 19:26:23 2024 -0500 First Commit commit 4a6c6ee2705dd3999681cf3b28b1593b2da60e44 Author: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Wed Dec 25 19:19:05 2024 -0500 Update EffectsFunctions.cpp * Revert "Squashed commit of the following:" This reverts commit ff2e49c6ed780f0aa6c87676cb2e0b27089b6fe0. * Formatting. * Formatting. * Update CHANGELOG.md --------- Co-authored-by: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Co-authored-by: Nemoel-Tomo Co-authored-by: Jakub Co-authored-by: Jakub <80340234+Jakub768@users.noreply.github.com> Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com> Co-authored-by: TrainWreck commit 106787d911031d1b42ee3b07f9bddae354e2527f Author: Sezz Date: Thu Feb 6 04:34:28 2025 +1100 Doc corrections commit 737f5aa742cf408c3309cba6748c760700462b1d Author: Sezz Date: Thu Feb 6 04:28:58 2025 +1100 Make getters const commit 2b41ae743a2529c95de8a72e21488df99bde8135 Author: Sezz Date: Thu Feb 6 02:35:16 2025 +1100 Tidy up Lua doc for Static class commit 437ce7c139256f659363ada8b7ebd07ac95f5b25 Author: Sezz Date: Thu Feb 6 01:22:59 2025 +1100 Complete short -> int conversions for Lua commit 237ceca0f4cb25f4c0b256328d880b673cc06263 Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Wed Feb 5 08:04:23 2025 +0100 Fixed custom shatter sounds commit 64e0c303ba644d56d06620f098084c405aa4bded Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Tue Feb 4 20:58:09 2025 +0100 Update CHANGELOG.md commit d2b692cb3bcce96a99ab3ba3aa7b6743ac3556b4 Author: Sezz Date: Mon Feb 3 16:15:41 2025 +1100 ShadowMode::Lara -> ShadowMode::Player commit ebb20121ac580e2b48a000f543b32418543fee94 Author: Sezz Date: Sat Feb 1 23:57:54 2025 +1100 -1 -> NO_VALUE and other formatting commit 4a6f30a152508d8bad9bad268d510ce2ecaf2254 Author: Jakub <80340234+Jakub768@users.noreply.github.com> Date: Sat Feb 1 12:07:10 2025 +0000 Update LICENSE commit 45d46e0e6b33c355fad3a37c2054de87c1e2d3c6 Author: Sezz Date: Sat Feb 1 22:55:35 2025 +1100 Fix display pickup string not being interpolated in 60FPS mode commit 903fdf288fc5524e6df9babac62302b2c2ad006b Author: Sezz Date: Sat Feb 1 22:40:50 2025 +1100 Optimise BitField class (#1511) * Optimise BitField class * DebugBuild -> DEBUG_BUILD * Fix merge error commit 48902b00a9d5d34cd0d9c4dd4f98000f3354315e Author: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Sat Feb 1 06:23:04 2025 -0500 Emit air bubble exposed (#1537) * Update to bug report form * Update bug_report.yaml * Update AUTHORS.md - Tomo (general coding, special FX coding, bug fixing) * Update CHANGELOG.md * Update CHANGELOG.md * Update bug_report.yaml * Update EffectsFunctions.cpp * First Commit * Check * Update CHANGELOG.md * Doc revisions * Doc Revision * Update EffectsFunctions.cpp * Remove room from arguements. * Doc clarification. * Make Size and Amplitude Optional * Update EffectsFunctions.cpp --------- Co-authored-by: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Co-authored-by: Nemoel-Tomo Co-authored-by: Jakub Co-authored-by: Jakub <80340234+Jakub768@users.noreply.github.com> Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com> Co-authored-by: Sezz commit fa0e125f59c77d09091b857edf394c0473d73a06 Author: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Sat Feb 1 06:22:49 2025 -0500 Emit particle upgrade (#1542) * Update to bug report form * Update bug_report.yaml * Update AUTHORS.md - Tomo (general coding, special FX coding, bug fixing) * Update CHANGELOG.md * Update CHANGELOG.md * Update bug_report.yaml * Expose ObjectSlot * Docs * Code Update * FinalPush * Update CHANGELOG.md * Update CHANGELOG.md * Update CHANGELOG.md * Expose startRot * Expose startRot * Remove Space. * Code cleanup, revise doc comment * Nicer defaults in doc --------- Co-authored-by: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Co-authored-by: Nemoel-Tomo Co-authored-by: Jakub Co-authored-by: Jakub <80340234+Jakub768@users.noreply.github.com> Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com> Co-authored-by: Sezz commit bcbe21650818a60942a4baa0aa8a6e094c1df9c7 Author: Sezz Date: Sat Feb 1 20:17:11 2025 +1100 Update Vec3.cpp commit 06c33908d97a7b83999a0c6fd946d7626be8de2f Author: Sezz Date: Sat Feb 1 20:13:34 2025 +1100 Explicit conversion commit c99b8abf2529a3a7c2704b38608cdb8ac6931491 Author: Sezz Date: Sat Feb 1 20:01:55 2025 +1100 Add Translate() functions to script Vec2 and Vec3 classes commit d8c646fabdf2c1ce698d5ba0d1ab6d1d58a756d1 Author: Sezz Date: Sat Feb 1 17:47:29 2025 +1100 Start restructuring script Moveable class commit 98b01ff64ada9227de8faa1da8374e08e2119d7f Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Thu Jan 30 22:25:57 2025 +0100 Fixed #1562 commit d163d1ec30729cd00890915d9a71e483f09fc7ed Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Mon Jan 27 19:27:08 2025 +0100 Fixed #1558 commit 6ef8a562e582abefae7bb9bd4b5eefda4a3e1364 Author: Sezz Date: Tue Jan 28 04:10:12 2025 +1100 Update doc comment for moveable commit d919e1679034b693f1448321a8478177fb046095 Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat Jan 25 23:03:28 2025 +0100 Fixed player model submerging into the floor while swimming underwater commit faf17cd03adf2c32517c1e99ab6b8996b9bed128 Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Fri Jan 24 23:18:14 2025 +0100 Fixed #1557 commit 5f402e380bc0e64d21b635cad99111a4daa5e4b7 Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Fri Jan 24 22:55:08 2025 +0100 Fixed #1556 commit ae20a49eb2e8fe50fcb359d3b1be5b03e8afd99e Author: Sezz Date: Thu Jan 23 17:02:26 2025 +1100 Update VS hint comments for various classes commit fb97628ac92133526e422cbfceb2c730dbb1d7c4 Author: Sezz Date: Thu Jan 23 16:48:46 2025 +1100 Add `Scale` field to `Pose` class (#1546) * Reapply "Add functional Scale field to Pose class" This reverts commit 92305a5d25f3968531d703153fc37797c437db62. * Update lara.cpp commit fc0c260ea1cd3617f193bb9e454919ba1f076c37 Author: Sezz Date: Thu Jan 23 15:25:09 2025 +1100 Update script Rotation class and its doc commit 0dd0061a94a93ef7997edcf398da125dbf607b8d Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Tue Jan 21 20:55:57 2025 +0100 Update CHANGELOG.md commit 7735f660ab622e1ac9e7b18e4d1babe6df383650 Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Tue Jan 21 20:49:32 2025 +0100 Fixed #1553 commit 5764965230ffa1f513a6c40b296efdfa7d6b0633 Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Tue Jan 21 20:47:06 2025 +0100 Fixed #1554 commit b55675b9ced4e1f4a775aed69bc21ae58de3f87c Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Tue Jan 21 20:46:47 2025 +0100 Fixed #1552 commit 7be096f86abd129725e75fe45d3142e9271f8933 Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun Jan 19 05:41:05 2025 +0100 Fixed dynamic light shadows not being handled correctly commit db2649e93660628cf8d770d04cc061d42bc2a4b8 Author: Sezz Date: Sat Jan 18 19:54:04 2025 +1100 Fix two block platform sometimes not traversing room portals correctly; cleanup commit ff41900bd967a6955d120a13ec2e35019097f777 Author: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Sun Jan 12 16:35:44 2025 +0000 Updated to reflect develop branch after merging Pull Request commit 2a89abe66d946fa425e2579daf06a99d72e75844 Author: Nemoel-Tomo Date: Sun Jan 12 17:15:45 2025 +0100 Tr1 electric ball (#1413) Implementation of the Electric Ball from Tomb Raider I, inside Level 5: St Francis Folly commit a97548467e5c35e8416d47bc0f2b976e853e5ea0 Author: Nemoel-Tomo Date: Fri Jan 10 23:27:48 2025 +0100 Waterfall_Emitter (#1359) * waterfall emitter. warning for the test I changed waterfallmist object * test * update * update * update * formatting * formatting * formatting * update mist color * import develop * bugfix sprite * added mor sprite particles * waterfall intensity * update waterfall to be more filled * update * Create a new sprite sequence for waterfall * Fixed texture order * removed GetParticleDistanceFade() from waterfall * Order * Update Particle struct; update waterfall * Update Particle struct * Simplify waterfall emitter * Simplify waterfall emitter * Simplify waterfall emitter * Simplify * Fix waterfall density; move sprite slot * Update Waterfall.cpp * fixed some small bugs with the waterfall after simplify * commit * imported develop 60fps branch * fixed waterfall errors * update * commit * update/test * update Waterfall * fixed last bugs * formatting * added option for sound * update * update, fixing errors * update * formatting * Formatting * fixed color issue, now only savegame is left * formatting * added new fields to savegame * targetpos is now Vector3 * import develop * Fixes according to GH notes + move waterfall-specific code out of effects.cpp * Rollback object ID rename, add missing enum * renamed ID_WATERFALL_ into ID_WATERFALL_SPRITES * fixed SpriteSeqID for spark in spark.cpp * Update CHANGELOG.md * rewritten waterfall code * Update waterfall impact point --------- Co-authored-by: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Co-authored-by: Sezz Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com> commit bfe07f6e21c369d64d9256c6e31fe1b3af4946dd Author: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Sun Jan 5 16:45:30 2025 +0000 Bump version in Lua API for development commit 4dce1576651ee2b8663a6ae3c5fbb2949226d2eb Author: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Sun Jan 5 16:27:38 2025 +0000 Bump Tomb Editor version for next dev cycle Amended also in the Development branch for TE commit c25c7a1c96a327adc82662368f4ff4e6cb09878f Author: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Sun Jan 5 15:10:17 2025 +0000 Update CHANGELOG.md commit 2da7401c28fa731c729356d100a421959f6ab67b Author: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Sun Jan 5 15:09:41 2025 +0000 Update changelog with template for the next version. commit 66d7e51f5d3218c72e281c16ea6bb11f258df1f8 Author: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Sat Jan 4 18:41:11 2025 +0000 Bump dev version to 1.7.2 This has been done to draw a line post-release and any commits after this to form the next release. Version number may change. commit cebc0175c9f132f75d8b58cc9db26c2e12d4cf29 Author: Sezz Date: Sat Jan 4 17:03:46 2025 +1100 Move splash effect to its own file commit b81b28039c9ce4b84cfde14aea1791de0d5c2421 Author: Sezz Date: Sat Jan 4 16:03:07 2025 +1100 Fix gravity being applied when vaulting on the same frame as the player lands commit 5444ede2a8fd079c2793e792a09715ea561ddb05 Author: Sezz Date: Sat Jan 4 15:51:52 2025 +1100 Reliably stop at edge when running at it while holding Walk commit 43d5bb9639cc9667875c82f360684e03e565166a Author: Sezz Date: Fri Jan 3 23:31:59 2025 +1100 Update CHANGELOG.md commit fb7e4dce70e9f5ed1882e45973a1ca30001315a3 Merge: 9baf5222f 12ac1219e Author: Sezz Date: Fri Jan 3 23:06:28 2025 +1100 Merge branch 'develop' of https://github.com/MontyTRC89/TombEngine into develop commit 9baf5222f8cc315d5cf4c65a3f865187b0d78059 Author: Sezz Date: Fri Jan 3 23:06:25 2025 +1100 Reset IsAirborne flag properly when exiting fly cheat commit 12ac1219e959ecf18ae34e2a7b4229b15198930d Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Thu Jan 2 13:10:57 2025 +0100 Update spark.cpp commit 7f071b5ec51e041cb0bd1e9a54756e9fb93c6f72 Author: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Thu Jan 2 11:15:04 2025 +0100 Port additional ricochet effect from tomb4 * Revert "Squashed commit of the following:" This reverts commit f4570211a5c304f2c7a50af52904adf8b0ada135. * Update CHANGELOG.md * Demagicify framenumber * Fix Statue Plinth * Fix bounds and add ItemFlag[0] for custom activation frame * Rename files * Cleanup * Remove unnecessary includes * Update documentation --------- Co-authored-by: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Co-authored-by: Nemoel-Tomo Co-authored-by: Jakub Co-authored-by: Jakub <80340234+Jakub768@users.noreply.github.com> Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com> Co-authored-by: Sezz --- CHANGELOG.md | 5 +- .../Objects/TR4/Object/StatuePlinth.cpp | 157 ++++++++++++++++++ TombEngine/Objects/TR4/Object/StatuePlinth.h | 10 ++ TombEngine/Objects/TR4/tr4_objects.cpp | 9 + TombEngine/TombEngine.vcxproj | 2 + 5 files changed, 181 insertions(+), 2 deletions(-) create mode 100644 TombEngine/Objects/TR4/Object/StatuePlinth.cpp create mode 100644 TombEngine/Objects/TR4/Object/StatuePlinth.h diff --git a/CHANGELOG.md b/CHANGELOG.md index c40290b1c..6a0edd047 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -27,13 +27,14 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): - You must update your Lara object: https://github.com/TombEngine/Resources/raw/main/Wad2%20Objects/Lara/TEN_Lara.wad2 * Added a particle based waterfall emitter object and associated sprite slots. - You must use this version: https://github.com/TombEngine/Resources/raw/refs/heads/main/Wad2%20Objects/Interactables/TEN_Waterfall_Emitter.wad2 +* Added TR4 statue plinth. * Added TR1 hammer. - You must use this version: ### Lua API changes -* Implemented advanced particles allowing animations and other effects. * Added Collision.Probe class for basic room collision detection. +* Added advanced particle emitter allowing animations and other effects. * Added diary module. * Added Flow.Horizon class with and use two layers of horizons in a Flow.Level class. * Added View.GetFlyByPosition() and View.GetFlyByRotation() functions to get flyby sequence parameters at a specified time point. @@ -42,7 +43,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added Moveable:GetScale() and Movebale:SetScale() methods to set visible scale of moveables. * Added Rotation:Lerp() function to allow linear interpolation between rotations. * Added various Translate() methods to Vec2 and Vec3 script objects. -* Added alpha transparency functionality for statics and moveables by using SetColor() method. +* Added alpha transparency functionality for statics and moveables to be used with SetColor() method. * Added extra arguments for sprite object slots and starting rotation value for EmitParticle function. * Added ability to save Flow.Level fields such as fog or horizon to a savegame. diff --git a/TombEngine/Objects/TR4/Object/StatuePlinth.cpp b/TombEngine/Objects/TR4/Object/StatuePlinth.cpp new file mode 100644 index 000000000..bf1ee0b93 --- /dev/null +++ b/TombEngine/Objects/TR4/Object/StatuePlinth.cpp @@ -0,0 +1,157 @@ +#include "framework.h" +#include "Objects/TR4/Object/StatuePlinth.h" + +#include "Game/animation.h" +#include "Game/collision/collide_room.h" +#include "Game/collision/collide_item.h" +#include "Game/control/control.h" +#include "Game/effects/effects.h" +#include "Game/effects/tomb4fx.h" +#include "Game/Gui.h" +#include "Game/items.h" +#include "Game/Lara/lara.h" +#include "Game/Lara/lara_helpers.h" +#include "Game/pickup/pickup.h" +#include "Game/Setup.h" +#include "Sound/sound.h" +#include "Specific/Input/Input.h" +#include "Specific/level.h" + +using namespace TEN::Gui; +using namespace TEN::Input; + +namespace TEN::Entities::TR4 +{ + constexpr auto PLACE_PLINTHITEM_FRAME = 45; + + const auto KeyHolePosition = Vector3i(0, 0, -390); + const ObjectCollisionBounds KeyHoleBounds = + { + GameBoundingBox( + -CLICK(1), CLICK(1), + -BLOCK(0.5f), 0, + -BLOCK(0.5f), 0), + std::pair( + EulerAngles(ANGLE(-10.0f), ANGLE(-30.0f), ANGLE(-10.0f)), + EulerAngles(ANGLE(10.0f), ANGLE(30.0f), ANGLE(10.0f))) + }; + + void InitializeStatuePlinth(short itemNumber) + { + auto* item = &g_Level.Items[itemNumber]; + + // Hide mesh 1. + item->MeshBits = 1; + } + + void CollideStatuePlinth(short itemNumber, ItemInfo* playerItem, CollisionInfo* coll) + { + auto& keyHoleItem = g_Level.Items[itemNumber]; + const auto& player = GetLaraInfo(playerItem); + + short* triggerIndexPtr = GetTriggerIndex(&keyHoleItem); + + if (!keyHoleItem.ItemFlags[0]) + keyHoleItem.ItemFlags[0] = PLACE_PLINTHITEM_FRAME; + + GAME_OBJECT_ID keyItem; + + // There are only 16 puzzle items. -1 is added to keep OCB aligned with puzzle item number. + if (keyHoleItem.TriggerFlags < 17 && keyHoleItem.TriggerFlags > 0) + { + keyItem = GAME_OBJECT_ID(keyHoleItem.TriggerFlags + ID_PUZZLE_ITEM1 - 1); + + } + else + { + keyItem = ID_PUZZLE_ITEM1; + } + + if (triggerIndexPtr == nullptr) + return; + + short triggerType = (*(triggerIndexPtr++) >> 8) & TRIGGER_BITS; + + bool hasAction = (IsHeld(In::Action) || g_Gui.GetInventoryItemChosen() != NO_VALUE); + bool isPlayerAvailable = (player->Control.Look.OpticRange == 0 && + playerItem->Animation.ActiveState == LS_IDLE && + playerItem->Animation.AnimNumber == LA_STAND_IDLE); + + if (hasAction && isPlayerAvailable && !keyHoleItem.ItemFlags[3]) + { + if (!keyHoleItem.ItemFlags[1]) + { + short prevYOrient = keyHoleItem.Pose.Orientation.y; + + int quadrant = GetQuadrant(LaraItem->Pose.Orientation.y); + keyHoleItem.DisableInterpolation = true; + switch (quadrant) + { + case NORTH: + keyHoleItem.Pose.Orientation.y = ANGLE(0.0f); + break; + + case EAST: + keyHoleItem.Pose.Orientation.y = ANGLE(90.0f); + break; + + case SOUTH: + keyHoleItem.Pose.Orientation.y = ANGLE(180.0f); + break; + + case WEST: + keyHoleItem.Pose.Orientation.y = ANGLE(270.0f); + break; + + default: + break; + } + + if (TestLaraPosition(KeyHoleBounds, &keyHoleItem, playerItem)) + { + if (g_Gui.IsObjectInInventory(keyItem)) + { + g_Gui.SetEnterInventory(keyItem); + keyHoleItem.ItemFlags[1] = 1; + } + } + + keyHoleItem.Pose.Orientation.y = prevYOrient; + return; + } + + if (g_Gui.GetInventoryItemChosen() == keyItem) + { + ResetPlayerFlex(playerItem); + SetAnimation(*playerItem, LA_PICKUP_PEDESTAL_HIGH); + playerItem->Animation.ActiveState = LS_INSERT_KEY; + + player->Control.HandStatus = HandStatus::Busy; + g_Gui.SetInventoryItemChosen(NO_VALUE); + keyHoleItem.ItemFlags[2] = 1; + return; + } + } + + if (playerItem->Animation.AnimNumber == LA_PICKUP_PEDESTAL_HIGH && + playerItem->Animation.FrameNumber == (GetAnimData(LA_PICKUP_PEDESTAL_HIGH).frameBase + keyHoleItem.ItemFlags[0]) && + keyHoleItem.ItemFlags[2]) + { + TestTriggers(&keyHoleItem, true, keyHoleItem.Flags & 0x3E00); + keyHoleItem.Flags |= TRIGGERED; + keyHoleItem.Status = ITEM_ACTIVE; + keyHoleItem.MeshBits = 255; + + // TODO: Allow meshswap of puzzle items. + //keyHoleItem.Model.MeshIndex[1] = Objects[keyItem].meshIndex + 0; + //keyHoleItem.Model.Mutators[0].Offset = Vector3(0.0f, -896.0f, 0.0f); + keyHoleItem.ItemFlags[3] = 1; + RemoveObjectFromInventory(keyItem, 1); + } + else + { + keyHoleItem.ItemFlags[1] = 0; + ObjectCollision(itemNumber, playerItem, coll); + } + } +} diff --git a/TombEngine/Objects/TR4/Object/StatuePlinth.h b/TombEngine/Objects/TR4/Object/StatuePlinth.h new file mode 100644 index 000000000..b4bdce750 --- /dev/null +++ b/TombEngine/Objects/TR4/Object/StatuePlinth.h @@ -0,0 +1,10 @@ +#pragma once + +struct CollisionInfo; +struct ItemInfo; + +namespace TEN::Entities::TR4 +{ + void InitializeStatuePlinth(short itemNumber); + void CollideStatuePlinth(short itemNumber, ItemInfo* playerItem, CollisionInfo* coll); +} diff --git a/TombEngine/Objects/TR4/tr4_objects.cpp b/TombEngine/Objects/TR4/tr4_objects.cpp index 441ec3b40..f91d32c9f 100644 --- a/TombEngine/Objects/TR4/tr4_objects.cpp +++ b/TombEngine/Objects/TR4/tr4_objects.cpp @@ -43,6 +43,7 @@ #include "Objects/TR4/Entity/tr4_setha.h" // Objects +#include "Objects/TR4/Object/StatuePlinth.h" #include "Objects/TR4/Object/WraithTrap.h" #include "Objects/TR4/Object/tr4_element_puzzle.h" #include "Objects/TR4/Object/tr4_mapper.h" @@ -695,6 +696,14 @@ namespace TEN::Entities obj->SetHitEffect(true); } + obj = &Objects[ID_STATUE_PLINTH]; + if (obj->loaded) + { + obj->Initialize = InitializeStatuePlinth; + obj->collision = CollideStatuePlinth; + obj->SetHitEffect(true); + } + obj = &Objects[ID_WHEEL_OF_FORTUNE]; if (obj->loaded) { diff --git a/TombEngine/TombEngine.vcxproj b/TombEngine/TombEngine.vcxproj index e9163569d..0cf2b10f2 100644 --- a/TombEngine/TombEngine.vcxproj +++ b/TombEngine/TombEngine.vcxproj @@ -709,6 +709,7 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. + @@ -1236,6 +1237,7 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. + From 602acb4bae2f9cb2323bff2598b9675416420741 Mon Sep 17 00:00:00 2001 From: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Sat, 8 Mar 2025 23:44:10 -0500 Subject: [PATCH 020/160] Underwater Floor trapdoor (#1600) * First Committ * Finished * Update CHANGELOG.md * Declog conditions. * Formatting --------- Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com> --- CHANGELOG.md | 2 +- TombEngine/Game/Lara/lara_struct.h | 4 +- .../Generic/Object/generic_trapdoor.cpp | 40 ++++++++++++++----- 3 files changed, 34 insertions(+), 12 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 6a0edd047..52cb4c1ef 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -23,7 +23,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): ### New Features * Added multithreading and an option for it to flow system settings. -* Added ability to use keys and puzzle items underwater. +* Added ability to use floor trapdoors, keys and puzzle items underwater. - You must update your Lara object: https://github.com/TombEngine/Resources/raw/main/Wad2%20Objects/Lara/TEN_Lara.wad2 * Added a particle based waterfall emitter object and associated sprite slots. - You must use this version: https://github.com/TombEngine/Resources/raw/refs/heads/main/Wad2%20Objects/Interactables/TEN_Waterfall_Emitter.wad2 diff --git a/TombEngine/Game/Lara/lara_struct.h b/TombEngine/Game/Lara/lara_struct.h index 42a446380..65a0ef80c 100644 --- a/TombEngine/Game/Lara/lara_struct.h +++ b/TombEngine/Game/Lara/lara_struct.h @@ -611,7 +611,7 @@ enum LaraAnim LA_LADDER_RIGHT_CORNER_OUTER_START = 365, // Ladder around outer right corner LA_PUSHABLE_BLOCK_PUSH_EDGE_SLIP = 366, LA_LADDER_LEFT_CORNER_INNER_START = 367, // Ladder around inner left corner - LA_LADDER_LEFT_CORNER_INNER_END = 368, // TODO: Remove. + LA_UNDERWATER_FLOOR_TRAPDOOR = 368, // Underwater Floor Trapdoor LA_LADDER_RIGHT_CORNER_INNER_START = 369, // Ladder around inner right corner LA_LADDER_RIGHT_CORNER_INNER_END = 370, // TODO: Remove. LA_JUMP_UP_TO_ROPE_START = 371, // Jump up > rope idle (1/2) @@ -828,7 +828,7 @@ enum LaraAnim NUM_LARA_ANIMS // TRASHED ANIMS (reuse slots before going any higher and remove entries from this list when you do): - // 368, 370, + // 370, // 442 }; diff --git a/TombEngine/Objects/Generic/Object/generic_trapdoor.cpp b/TombEngine/Objects/Generic/Object/generic_trapdoor.cpp index f9fa318ab..893d51aec 100644 --- a/TombEngine/Objects/Generic/Object/generic_trapdoor.cpp +++ b/TombEngine/Objects/Generic/Object/generic_trapdoor.cpp @@ -48,8 +48,23 @@ namespace TEN::Entities::Generic EulerAngles(ANGLE(-10.0f), ANGLE(-30.0f), ANGLE(-10.0f)), EulerAngles(ANGLE(10.0f), ANGLE(30.0f), ANGLE(10.0f))) }; + static auto FloorTrapDoorPos = Vector3i(0, 0, -655); + static auto WaterFloorTrapDoorPos = Vector3i(0, -CLICK(1), -655); + const ObjectCollisionBounds WaterFloorTrapDoorBounds = + { + GameBoundingBox( + -BLOCK(3.0f / 8), BLOCK(3.0f / 8), + -BLOCK(0.5f), 0, + -BLOCK(3 / 4.0f), BLOCK(1 / 4.0f) + ), + std::pair( + EulerAngles(ANGLE(-80.0f), ANGLE(-80.0f), ANGLE(-80.0f)), + EulerAngles(ANGLE(80.0f), ANGLE(80.0f), ANGLE(80.0f)) + ) + }; + static std::optional GetTrapDoorFloorHeight(const ItemInfo& item, const Vector3i& pos) { if (!item.MeshBits.TestAny() || item.ItemFlags[2] == 0) @@ -162,19 +177,26 @@ namespace TEN::Entities::Generic auto* laraInfo = GetLaraInfo(laraItem); auto* trapDoorItem = &g_Level.Items[itemNumber]; - if ((IsHeld(In::Action) && - laraItem->Animation.ActiveState == LS_IDLE && - laraItem->Animation.AnimNumber == LA_STAND_IDLE && - laraInfo->Control.HandStatus == HandStatus::Free && - trapDoorItem->Status != ITEM_ACTIVE) || - (laraInfo->Control.IsMoving && laraInfo->Context.InteractedItem == itemNumber)) + bool isUnderwater = (laraInfo->Control.WaterStatus == WaterStatus::Underwater); + + const auto& bounds = isUnderwater ? WaterFloorTrapDoorBounds : FloorTrapDoorBounds; + const auto& position = isUnderwater ? WaterFloorTrapDoorPos : FloorTrapDoorPos; + + bool isActionActive = laraInfo->Control.IsMoving && laraInfo->Context.InteractedItem == itemNumber; + bool isActionReady = IsHeld(In::Action); + bool isPlayerAvailable = laraInfo->Control.HandStatus == HandStatus::Free && trapDoorItem->Status != ITEM_ACTIVE; + + bool isPlayerIdle = (!isUnderwater && laraItem->Animation.ActiveState == LS_IDLE && laraItem->Animation.AnimNumber == LA_STAND_IDLE) || + ( isUnderwater && laraItem->Animation.ActiveState == LS_UNDERWATER_IDLE && laraItem->Animation.AnimNumber == LA_UNDERWATER_IDLE); + + if (isActionActive || (isActionReady && isPlayerAvailable && isPlayerIdle)) { - if (TestLaraPosition(FloorTrapDoorBounds, trapDoorItem, laraItem)) + if (TestLaraPosition(bounds, trapDoorItem, laraItem)) { - if (MoveLaraPosition(FloorTrapDoorPos, trapDoorItem, laraItem)) + if (MoveLaraPosition(position, trapDoorItem, laraItem)) { ResetPlayerFlex(laraItem); - laraItem->Animation.AnimNumber = LA_TRAPDOOR_FLOOR_OPEN; + laraItem->Animation.AnimNumber = isUnderwater ? LA_UNDERWATER_FLOOR_TRAPDOOR : LA_TRAPDOOR_FLOOR_OPEN; laraItem->Animation.FrameNumber = GetAnimData(laraItem).frameBase; laraItem->Animation.ActiveState = LS_TRAPDOOR_FLOOR_OPEN; laraInfo->Control.IsMoving = false; From e0b50439b36bb1cff1de0a0a9309cdd850e04628 Mon Sep 17 00:00:00 2001 From: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Sat, 8 Mar 2025 23:59:49 -0500 Subject: [PATCH 021/160] Custom bar module (#1492) * Update to bug report form * Update bug_report.yaml * Update AUTHORS.md - Tomo (general coding, special FX coding, bug fixing) * Update CHANGELOG.md * Update CHANGELOG.md * Update bug_report.yaml * Add files via upload * Update CHANGELOG.md * Add files via upload * Update CustomBar.lua * Fix bugs with bar property setters * Update CustomBar.lua * Update documentation --------- Co-authored-by: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Co-authored-by: Nemoel-Tomo Co-authored-by: Jakub Co-authored-by: Jakub <80340234+Jakub768@users.noreply.github.com> Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com> --- CHANGELOG.md | 1 + Documentation/doc/1 modules/Effects.html | 1 + Documentation/doc/1 modules/Flow.html | 1 + Documentation/doc/1 modules/Input.html | 1 + Documentation/doc/1 modules/Inventory.html | 1 + Documentation/doc/1 modules/Logic.html | 1 + Documentation/doc/1 modules/Objects.html | 1 + Documentation/doc/1 modules/Sound.html | 1 + Documentation/doc/1 modules/Strings.html | 1 + Documentation/doc/1 modules/Util.html | 1 + Documentation/doc/1 modules/View.html | 1 + .../doc/2 classes/Collision.Probe.html | 1 + Documentation/doc/2 classes/Flow.Level.html | 1 + .../doc/2 classes/Flow.Settings.html | 1 + .../doc/2 classes/Flow.Statistics.html | 1 + .../doc/2 classes/Objects.AIObject.html | 1 + .../doc/2 classes/Objects.Camera.html | 1 + .../doc/2 classes/Objects.LaraObject.html | 1 + .../doc/2 classes/Objects.Moveable.html | 1 + Documentation/doc/2 classes/Objects.Room.html | 1 + Documentation/doc/2 classes/Objects.Sink.html | 1 + .../doc/2 classes/Objects.SoundSource.html | 1 + .../doc/2 classes/Objects.Static.html | 1 + .../doc/2 classes/Objects.Volume.html | 1 + .../doc/2 classes/Strings.DisplayString.html | 1 + .../doc/2 classes/View.DisplaySprite.html | 1 + .../doc/3 primitive classes/Color.html | 1 + .../doc/3 primitive classes/Flow.Fog.html | 1 + .../doc/3 primitive classes/Flow.Horizon.html | 1 + .../Flow.InventoryItem.html | 1 + .../3 primitive classes/Flow.LensFlare.html | 1 + .../3 primitive classes/Flow.SkyLayer.html | 1 + .../3 primitive classes/Flow.Starfield.html | 1 + .../doc/3 primitive classes/Rotation.html | 1 + .../doc/3 primitive classes/Time.html | 1 + .../doc/3 primitive classes/Vec2.html | 1 + .../doc/3 primitive classes/Vec3.html | 1 + .../doc/4 enums/Collision.MaterialType.html | 1 + .../doc/4 enums/Effects.BlendID.html | 1 + .../doc/4 enums/Effects.EffectID.html | 1 + .../doc/4 enums/Effects.FeatherMode.html | 1 + .../Effects.ParticleAnimationType.html | 1 + Documentation/doc/4 enums/Flow.ErrorMode.html | 1 + .../doc/4 enums/Flow.FreezeMode.html | 1 + .../doc/4 enums/Flow.GameStatus.html | 1 + Documentation/doc/4 enums/Input.ActionID.html | 1 + .../doc/4 enums/Objects.AmmoType.html | 1 + .../doc/4 enums/Objects.HandStatus.html | 1 + .../doc/4 enums/Objects.MoveableStatus.html | 1 + Documentation/doc/4 enums/Objects.ObjID.html | 1 + .../doc/4 enums/Objects.RoomFlagID.html | 1 + .../doc/4 enums/Objects.RoomReverb.html | 1 + .../doc/4 enums/Objects.WeaponType.html | 1 + .../doc/4 enums/Sound.SoundTrackType.html | 1 + .../4 enums/Strings.DisplayStringOption.html | 1 + Documentation/doc/4 enums/Util.LogLevel.html | 1 + Documentation/doc/4 enums/View.AlignMode.html | 1 + .../doc/4 enums/View.CameraType.html | 1 + .../doc/4 enums/View.PostProcessMode.html | 1 + Documentation/doc/4 enums/View.ScaleMode.html | 1 + .../doc/5 lua utility modules/CustomBar.html | 1510 +++++++++++++++++ .../doc/5 lua utility modules/Diary.html | 4 +- .../5 lua utility modules/EventSequence.html | 1 + .../doc/5 lua utility modules/Timer.html | 1 + .../doc/5 lua utility modules/Type.html | 1 + Documentation/doc/index.html | 8 +- Scripts/Engine/CustomBar.lua | 951 +++++++++++ Scripts/Engine/CustomDiary.lua | 3 +- 68 files changed, 2533 insertions(+), 6 deletions(-) create mode 100644 Documentation/doc/5 lua utility modules/CustomBar.html create mode 100644 Scripts/Engine/CustomBar.lua diff --git a/CHANGELOG.md b/CHANGELOG.md index 52cb4c1ef..a3671788d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -36,6 +36,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added Collision.Probe class for basic room collision detection. * Added advanced particle emitter allowing animations and other effects. * Added diary module. +* Added custom bar module. * Added Flow.Horizon class with and use two layers of horizons in a Flow.Level class. * Added View.GetFlyByPosition() and View.GetFlyByRotation() functions to get flyby sequence parameters at a specified time point. * Added Effects.EmitAirBubble() function to spawn air bubbles. diff --git a/Documentation/doc/1 modules/Effects.html b/Documentation/doc/1 modules/Effects.html index 68c602977..5f3c6e3f0 100644 --- a/Documentation/doc/1 modules/Effects.html +++ b/Documentation/doc/1 modules/Effects.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/1 modules/Flow.html b/Documentation/doc/1 modules/Flow.html index 251cdc1ac..87f02974d 100644 --- a/Documentation/doc/1 modules/Flow.html +++ b/Documentation/doc/1 modules/Flow.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/1 modules/Input.html b/Documentation/doc/1 modules/Input.html index 726d63197..ab68d0a53 100644 --- a/Documentation/doc/1 modules/Input.html +++ b/Documentation/doc/1 modules/Input.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/1 modules/Inventory.html b/Documentation/doc/1 modules/Inventory.html index f479a77cf..b16cba1f0 100644 --- a/Documentation/doc/1 modules/Inventory.html +++ b/Documentation/doc/1 modules/Inventory.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/1 modules/Logic.html b/Documentation/doc/1 modules/Logic.html index 022f32f39..607c77c99 100644 --- a/Documentation/doc/1 modules/Logic.html +++ b/Documentation/doc/1 modules/Logic.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/1 modules/Objects.html b/Documentation/doc/1 modules/Objects.html index f891741b2..ae8c45650 100644 --- a/Documentation/doc/1 modules/Objects.html +++ b/Documentation/doc/1 modules/Objects.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/1 modules/Sound.html b/Documentation/doc/1 modules/Sound.html index e2bd199bf..5cfa41484 100644 --- a/Documentation/doc/1 modules/Sound.html +++ b/Documentation/doc/1 modules/Sound.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/1 modules/Strings.html b/Documentation/doc/1 modules/Strings.html index d218b1fd5..0dde6ad65 100644 --- a/Documentation/doc/1 modules/Strings.html +++ b/Documentation/doc/1 modules/Strings.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/1 modules/Util.html b/Documentation/doc/1 modules/Util.html index 75a96f3ca..97a387d2a 100644 --- a/Documentation/doc/1 modules/Util.html +++ b/Documentation/doc/1 modules/Util.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/1 modules/View.html b/Documentation/doc/1 modules/View.html index 2438302a5..e1bb7aa4d 100644 --- a/Documentation/doc/1 modules/View.html +++ b/Documentation/doc/1 modules/View.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/2 classes/Collision.Probe.html b/Documentation/doc/2 classes/Collision.Probe.html index 1d15d3361..7470c4456 100644 --- a/Documentation/doc/2 classes/Collision.Probe.html +++ b/Documentation/doc/2 classes/Collision.Probe.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/2 classes/Flow.Level.html b/Documentation/doc/2 classes/Flow.Level.html index 7108791b1..780c9ba38 100644 --- a/Documentation/doc/2 classes/Flow.Level.html +++ b/Documentation/doc/2 classes/Flow.Level.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/2 classes/Flow.Settings.html b/Documentation/doc/2 classes/Flow.Settings.html index 3c3d02879..092587e0b 100644 --- a/Documentation/doc/2 classes/Flow.Settings.html +++ b/Documentation/doc/2 classes/Flow.Settings.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/2 classes/Flow.Statistics.html b/Documentation/doc/2 classes/Flow.Statistics.html index f3d98b654..2f16e90a9 100644 --- a/Documentation/doc/2 classes/Flow.Statistics.html +++ b/Documentation/doc/2 classes/Flow.Statistics.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/2 classes/Objects.AIObject.html b/Documentation/doc/2 classes/Objects.AIObject.html index 3f81de9d9..fcb918837 100644 --- a/Documentation/doc/2 classes/Objects.AIObject.html +++ b/Documentation/doc/2 classes/Objects.AIObject.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/2 classes/Objects.Camera.html b/Documentation/doc/2 classes/Objects.Camera.html index edfafcf92..c79508433 100644 --- a/Documentation/doc/2 classes/Objects.Camera.html +++ b/Documentation/doc/2 classes/Objects.Camera.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/2 classes/Objects.LaraObject.html b/Documentation/doc/2 classes/Objects.LaraObject.html index 2e9d879f1..ef3373f39 100644 --- a/Documentation/doc/2 classes/Objects.LaraObject.html +++ b/Documentation/doc/2 classes/Objects.LaraObject.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/2 classes/Objects.Moveable.html b/Documentation/doc/2 classes/Objects.Moveable.html index d7b89fd6b..b088b9ea2 100644 --- a/Documentation/doc/2 classes/Objects.Moveable.html +++ b/Documentation/doc/2 classes/Objects.Moveable.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/2 classes/Objects.Room.html b/Documentation/doc/2 classes/Objects.Room.html index 82e8a24a7..e4eb0369b 100644 --- a/Documentation/doc/2 classes/Objects.Room.html +++ b/Documentation/doc/2 classes/Objects.Room.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/2 classes/Objects.Sink.html b/Documentation/doc/2 classes/Objects.Sink.html index f81ec4196..e9e57c4fe 100644 --- a/Documentation/doc/2 classes/Objects.Sink.html +++ b/Documentation/doc/2 classes/Objects.Sink.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/2 classes/Objects.SoundSource.html b/Documentation/doc/2 classes/Objects.SoundSource.html index c9223f69a..2a93e9b12 100644 --- a/Documentation/doc/2 classes/Objects.SoundSource.html +++ b/Documentation/doc/2 classes/Objects.SoundSource.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/2 classes/Objects.Static.html b/Documentation/doc/2 classes/Objects.Static.html index 9a995cd3b..f8afe4407 100644 --- a/Documentation/doc/2 classes/Objects.Static.html +++ b/Documentation/doc/2 classes/Objects.Static.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/2 classes/Objects.Volume.html b/Documentation/doc/2 classes/Objects.Volume.html index 4d0c47805..7b8534235 100644 --- a/Documentation/doc/2 classes/Objects.Volume.html +++ b/Documentation/doc/2 classes/Objects.Volume.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/2 classes/Strings.DisplayString.html b/Documentation/doc/2 classes/Strings.DisplayString.html index 86c258db7..d1a494957 100644 --- a/Documentation/doc/2 classes/Strings.DisplayString.html +++ b/Documentation/doc/2 classes/Strings.DisplayString.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/2 classes/View.DisplaySprite.html b/Documentation/doc/2 classes/View.DisplaySprite.html index fe3ff45c1..4548df0db 100644 --- a/Documentation/doc/2 classes/View.DisplaySprite.html +++ b/Documentation/doc/2 classes/View.DisplaySprite.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/3 primitive classes/Color.html b/Documentation/doc/3 primitive classes/Color.html index 22af2ca4f..0d2993bd9 100644 --- a/Documentation/doc/3 primitive classes/Color.html +++ b/Documentation/doc/3 primitive classes/Color.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/3 primitive classes/Flow.Fog.html b/Documentation/doc/3 primitive classes/Flow.Fog.html index d9a361a05..3bd25c6b4 100644 --- a/Documentation/doc/3 primitive classes/Flow.Fog.html +++ b/Documentation/doc/3 primitive classes/Flow.Fog.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/3 primitive classes/Flow.Horizon.html b/Documentation/doc/3 primitive classes/Flow.Horizon.html index 61025ca74..5beccaa2b 100644 --- a/Documentation/doc/3 primitive classes/Flow.Horizon.html +++ b/Documentation/doc/3 primitive classes/Flow.Horizon.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/3 primitive classes/Flow.InventoryItem.html b/Documentation/doc/3 primitive classes/Flow.InventoryItem.html index 8449b9cc3..1586a6072 100644 --- a/Documentation/doc/3 primitive classes/Flow.InventoryItem.html +++ b/Documentation/doc/3 primitive classes/Flow.InventoryItem.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/3 primitive classes/Flow.LensFlare.html b/Documentation/doc/3 primitive classes/Flow.LensFlare.html index b93607fc6..ad3f0f67a 100644 --- a/Documentation/doc/3 primitive classes/Flow.LensFlare.html +++ b/Documentation/doc/3 primitive classes/Flow.LensFlare.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/3 primitive classes/Flow.SkyLayer.html b/Documentation/doc/3 primitive classes/Flow.SkyLayer.html index 0109dba88..03d2a46af 100644 --- a/Documentation/doc/3 primitive classes/Flow.SkyLayer.html +++ b/Documentation/doc/3 primitive classes/Flow.SkyLayer.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/3 primitive classes/Flow.Starfield.html b/Documentation/doc/3 primitive classes/Flow.Starfield.html index f1ea0feb6..05934ae6b 100644 --- a/Documentation/doc/3 primitive classes/Flow.Starfield.html +++ b/Documentation/doc/3 primitive classes/Flow.Starfield.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/3 primitive classes/Rotation.html b/Documentation/doc/3 primitive classes/Rotation.html index bc19be436..607218c1a 100644 --- a/Documentation/doc/3 primitive classes/Rotation.html +++ b/Documentation/doc/3 primitive classes/Rotation.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/3 primitive classes/Time.html b/Documentation/doc/3 primitive classes/Time.html index c80e6636e..5cc1949f6 100644 --- a/Documentation/doc/3 primitive classes/Time.html +++ b/Documentation/doc/3 primitive classes/Time.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/3 primitive classes/Vec2.html b/Documentation/doc/3 primitive classes/Vec2.html index 7c6dce268..5c7f7e5c4 100644 --- a/Documentation/doc/3 primitive classes/Vec2.html +++ b/Documentation/doc/3 primitive classes/Vec2.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/3 primitive classes/Vec3.html b/Documentation/doc/3 primitive classes/Vec3.html index 51c9700d1..715d39062 100644 --- a/Documentation/doc/3 primitive classes/Vec3.html +++ b/Documentation/doc/3 primitive classes/Vec3.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Collision.MaterialType.html b/Documentation/doc/4 enums/Collision.MaterialType.html index 940554fba..560cb4d9f 100644 --- a/Documentation/doc/4 enums/Collision.MaterialType.html +++ b/Documentation/doc/4 enums/Collision.MaterialType.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Effects.BlendID.html b/Documentation/doc/4 enums/Effects.BlendID.html index 9e264a172..540ac8415 100644 --- a/Documentation/doc/4 enums/Effects.BlendID.html +++ b/Documentation/doc/4 enums/Effects.BlendID.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Effects.EffectID.html b/Documentation/doc/4 enums/Effects.EffectID.html index ff79e7033..577ca2670 100644 --- a/Documentation/doc/4 enums/Effects.EffectID.html +++ b/Documentation/doc/4 enums/Effects.EffectID.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Effects.FeatherMode.html b/Documentation/doc/4 enums/Effects.FeatherMode.html index 0cd3fee96..aeab018ee 100644 --- a/Documentation/doc/4 enums/Effects.FeatherMode.html +++ b/Documentation/doc/4 enums/Effects.FeatherMode.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html index e78b9afbc..5da6ba0e8 100644 --- a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html +++ b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Flow.ErrorMode.html b/Documentation/doc/4 enums/Flow.ErrorMode.html index ea2882299..a972c1369 100644 --- a/Documentation/doc/4 enums/Flow.ErrorMode.html +++ b/Documentation/doc/4 enums/Flow.ErrorMode.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Flow.FreezeMode.html b/Documentation/doc/4 enums/Flow.FreezeMode.html index b0b7b74d0..cff19f990 100644 --- a/Documentation/doc/4 enums/Flow.FreezeMode.html +++ b/Documentation/doc/4 enums/Flow.FreezeMode.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Flow.GameStatus.html b/Documentation/doc/4 enums/Flow.GameStatus.html index aa9b3e8da..27324b7b4 100644 --- a/Documentation/doc/4 enums/Flow.GameStatus.html +++ b/Documentation/doc/4 enums/Flow.GameStatus.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Input.ActionID.html b/Documentation/doc/4 enums/Input.ActionID.html index ede13bb3a..270c5a9e7 100644 --- a/Documentation/doc/4 enums/Input.ActionID.html +++ b/Documentation/doc/4 enums/Input.ActionID.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Objects.AmmoType.html b/Documentation/doc/4 enums/Objects.AmmoType.html index 1cc6aa18f..80d10b754 100644 --- a/Documentation/doc/4 enums/Objects.AmmoType.html +++ b/Documentation/doc/4 enums/Objects.AmmoType.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Objects.HandStatus.html b/Documentation/doc/4 enums/Objects.HandStatus.html index 8cab70060..639793907 100644 --- a/Documentation/doc/4 enums/Objects.HandStatus.html +++ b/Documentation/doc/4 enums/Objects.HandStatus.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Objects.MoveableStatus.html b/Documentation/doc/4 enums/Objects.MoveableStatus.html index a0c273c0e..abc608b8a 100644 --- a/Documentation/doc/4 enums/Objects.MoveableStatus.html +++ b/Documentation/doc/4 enums/Objects.MoveableStatus.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Objects.ObjID.html b/Documentation/doc/4 enums/Objects.ObjID.html index 9b1367920..0daeb40f0 100644 --- a/Documentation/doc/4 enums/Objects.ObjID.html +++ b/Documentation/doc/4 enums/Objects.ObjID.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Objects.RoomFlagID.html b/Documentation/doc/4 enums/Objects.RoomFlagID.html index 1e099fcad..a472524ec 100644 --- a/Documentation/doc/4 enums/Objects.RoomFlagID.html +++ b/Documentation/doc/4 enums/Objects.RoomFlagID.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Objects.RoomReverb.html b/Documentation/doc/4 enums/Objects.RoomReverb.html index 846d0228b..9ecacbbbf 100644 --- a/Documentation/doc/4 enums/Objects.RoomReverb.html +++ b/Documentation/doc/4 enums/Objects.RoomReverb.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Objects.WeaponType.html b/Documentation/doc/4 enums/Objects.WeaponType.html index 0f0f62c2c..ded6644fb 100644 --- a/Documentation/doc/4 enums/Objects.WeaponType.html +++ b/Documentation/doc/4 enums/Objects.WeaponType.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Sound.SoundTrackType.html b/Documentation/doc/4 enums/Sound.SoundTrackType.html index a62e76557..322be1ca6 100644 --- a/Documentation/doc/4 enums/Sound.SoundTrackType.html +++ b/Documentation/doc/4 enums/Sound.SoundTrackType.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Strings.DisplayStringOption.html b/Documentation/doc/4 enums/Strings.DisplayStringOption.html index 00bbc3e43..193062a2a 100644 --- a/Documentation/doc/4 enums/Strings.DisplayStringOption.html +++ b/Documentation/doc/4 enums/Strings.DisplayStringOption.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/Util.LogLevel.html b/Documentation/doc/4 enums/Util.LogLevel.html index c8ff448e4..e460b478b 100644 --- a/Documentation/doc/4 enums/Util.LogLevel.html +++ b/Documentation/doc/4 enums/Util.LogLevel.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/View.AlignMode.html b/Documentation/doc/4 enums/View.AlignMode.html index 3696dd12c..c1f559c82 100644 --- a/Documentation/doc/4 enums/View.AlignMode.html +++ b/Documentation/doc/4 enums/View.AlignMode.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/View.CameraType.html b/Documentation/doc/4 enums/View.CameraType.html index 37d7656b7..a6a4f12ba 100644 --- a/Documentation/doc/4 enums/View.CameraType.html +++ b/Documentation/doc/4 enums/View.CameraType.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/View.PostProcessMode.html b/Documentation/doc/4 enums/View.PostProcessMode.html index cb22d26d0..83657e992 100644 --- a/Documentation/doc/4 enums/View.PostProcessMode.html +++ b/Documentation/doc/4 enums/View.PostProcessMode.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/4 enums/View.ScaleMode.html b/Documentation/doc/4 enums/View.ScaleMode.html index 3e90fbcda..3ced09b6a 100644 --- a/Documentation/doc/4 enums/View.ScaleMode.html +++ b/Documentation/doc/4 enums/View.ScaleMode.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/5 lua utility modules/CustomBar.html b/Documentation/doc/5 lua utility modules/CustomBar.html new file mode 100644 index 000000000..293044e74 --- /dev/null +++ b/Documentation/doc/5 lua utility modules/CustomBar.html @@ -0,0 +1,1510 @@ + + + + + TombEngine 1.7.2 (Developer) Lua API + + + + +
                                                                      + +
                                                                      + +
                                                                      +
                                                                      +
                                                                      + + +
                                                                      + + + + + + +
                                                                      + +

                                                                      Lua utility module CustomBar

                                                                      +

                                                                      This module provides functions for creating and managing custom progress bars.

                                                                      +

                                                                      +

                                                                      It stores bar definitions and configurations in LevelVars.Engine.CustomBars, enabling seamless state management. + Each bar is independently controlled through its associated functions.

                                                                      + +

                                                                      Example usage:

                                                                      + + +
                                                                      +local CustomBar = require("Engine.CustomBar")
+
+-- Create a table with all the bar properties
+local barData = {
+    barName             = "water",
+    startValue          = 0,
+    maxValue            = 1000,
+    objectIdBg          = TEN.Objects.ObjID.CUSTOM_BAR_GRAPHIC,
+    spriteIdBg          = 0,
+    colorBg             = TEN.Color(255,255,255),
+    posBg               = TEN.Vec2(20, 20),
+    rotBg               = 0,
+    scaleBg             = TEN.Vec2(19.05, 19.1),
+    alignModeBg         = TEN.View.AlignMode.CENTER_LEFT,
+    scaleModeBg         = TEN.View.ScaleMode.FIT,
+    blendModeBg         = TEN.Effects.BlendID.ALPHABLEND,
+    objectIdBar         = TEN.Objects.ObjID.CUSTOM_BAR_GRAPHIC,
+    spriteIdBar         = 1,
+    colorBar            = TEN.Color(255,0,0),
+    posBar              = TEN.Vec2(20.15, 20),
+    rot                 = 0,
+    scaleBar            = TEN.Vec2(18.7, 18.48),
+    alignMode           = TEN.View.AlignMode.CENTER_LEFT,
+    scaleMode           = TEN.View.ScaleMode.FIT,
+    blendMode           = TEN.Effects.BlendID.ALPHABLEND,
+    text                = "Water Bar",
+    textPos             = TEN.Vec2(20, 15),
+    textOptions         = {TEN.Strings.DisplayStringOption.SHADOW,TEN.Strings.DisplayStringOption.CENTER},
+    textScale           = 1,
+    textColor           = TEN.Color(255,0,0),
+    hideText            = false,
+    alphaBlendSpeed     = 50,
+    blink               = false,
+    blinkLimit          = 0.25
+}
+
+-- This function creates the bar.
+CustomBar.Create(barData)
+
+-- This method gets the bar with name "water" and stores it in variable bar.
+local bar = CustomBar.Get("water")
+-- This method displays the bar
+bar:SetVisibility(true)
+-- This method sets the bar value to 1000 over 5 seconds.
+bar:SetBarValue(1000,5)
+
                                                                      + +

                                                                      + + +

                                                                      Functions

                                                                      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                                                                      Create(barData)Creates a custom progress bar with extensive configuration options.
                                                                      CreatePlayerBar(playerBarData)Creates a bar tied to Players's attributes (Health, Air, Stamina).
                                                                      CreateEnemyHpBar(enemyBarData)Creates a custom health bar for a specific enemy (like a boss).
                                                                      SetEnemiesHpGenericBar(enemiesBarData)Creates health bars for all enemies.
                                                                      Get(barName)The function retrieves an existing bar instance by its unique identifier (barName).
                                                                      Delete(barName)The function removes a custom bar and its associated data from the system.
                                                                      SetBarValue(value, time)The function sets the value of a custom bar over a specified time period.
                                                                      ChangeBarValueOverTimespan(value, time)The function adjusts the bar's value relative to its current or target value over a specified time span.
                                                                      SetVisibility(visible)The function controls the visibility of a custom bar.
                                                                      IsVisible()The function checks whether a custom bar is currently visible.
                                                                      GetValue()The function retrieves the current value of a custom bar.
                                                                      DeleteAllBars()The function deletes all custom bars.
                                                                      ShowEnemiesHpGenericBar(value)This function prevents the creation of new health bars for enemies when set to false.
                                                                      DeleteExistingHpGenericBars()The function deletes all the enemy health bars excluding those created by CustomBar.CreateEnemyHpBar.
                                                                      SetBackgroundPosition(pos)Sets the custom bar background sprite position.
                                                                      SetBackgroundRotation(rot)Sets the custom bar background sprite rotation.
                                                                      SetBackgroundScale(scale)Sets the custom bar background sprite scale.
                                                                      SetBackgroundSpriteSlot(slot, id)Sets the custom bar background sprite slot and sprite ID.
                                                                      SetBackgroundAlignMode(alignMode)Sets the custom bar background sprite align mode.
                                                                      SetBackgroundScaleMode(scaleMode)Sets the custom bar background sprite scale mode.
                                                                      SetBackgroundBlendMode(blendMode)Sets the custom bar background sprite blend mode.
                                                                      SetBarPosition(pos)Sets the custom bar sprite position.
                                                                      SetBarRotation(rot)Sets the custom bar sprite rotation.
                                                                      SetBarColor(color)Sets the custom bar sprite color.
                                                                      SetBarScale(scale)Sets the custom bar sprite scale.
                                                                      SetBarSpriteSlot(slot, id)Sets the custom bar sprite slot and sprite ID.
                                                                      SetBarAlignMode(alignMode)Sets the custom bar sprite alignment mode.
                                                                      SetBarScaleMode(scaleMode)Sets the custom bar sprite scale mode.
                                                                      SetBarBlendMode(blendMode)Sets the custom bar sprite blend mode.
                                                                      +

                                                                      Tables

                                                                      + + + + + + + + + + + + + + + + + +
                                                                      barDataTable setup for creating custom bar.
                                                                      playerBarDataTable setup for creating custom player attribute bar.
                                                                      enemyBarDataTable setup for creating a specific enemy health bar.
                                                                      enemiesBarDataTable setup for creating health bars for all enemies.
                                                                      + +
                                                                      +
                                                                      + + +

                                                                      Functions

                                                                      + +
                                                                      +
                                                                      + + Create(barData) +
                                                                      +
                                                                      + Creates a custom progress bar with extensive configuration options. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • barData + table + The table that contains all the bar data. Refer to table setup for barData. +
                                                                        • +
                                                                      + +

                                                                      Returns:

                                                                      +
                                                                        + + CustomBar + The custombar in its hidden state +
                                                                      + + + + +
                                                                      +
                                                                      + + CreatePlayerBar(playerBarData) +
                                                                      +
                                                                      + Creates a bar tied to Players's attributes (Health, Air, Stamina). + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • playerBarData + table + The table that contains all the player bar data. Refer to table setup for playerBarData. +
                                                                        • +
                                                                      + +

                                                                      Returns:

                                                                      +
                                                                        + + CustomBar + Player attribute bar. +
                                                                      + + + + +
                                                                      +
                                                                      + + CreateEnemyHpBar(enemyBarData) +
                                                                      +
                                                                      + Creates a custom health bar for a specific enemy (like a boss). Ensure this function is called before Lara aims at the enemy if using generic enemy HP bars as well. + Also be sure to call this function after increasing the HP of the enemy via LUA. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • enemyBarData + table + The table that contains all the enemy bar data. Refer to table setup for enemyBarData. +
                                                                        • +
                                                                      + +

                                                                      Returns:

                                                                      +
                                                                        + + CustomBar + Enemy health bar. +
                                                                      + + + + +
                                                                      +
                                                                      + + SetEnemiesHpGenericBar(enemiesBarData) +
                                                                      +
                                                                      + Creates health bars for all enemies. A new bar is generated whenever Lara targets an enemy. If the "hide text" option is disabled, the enemy's name (as set in the editor) is displayed. + Multiple enemies can share the same name by appending _number to the name in the editor. If adjusting an enemy's max HP, ensure this is done before Lara targets the enemy. + To create health bars for specific enemies, use CustomBar.CreateEnemyHpBar, ensuring the bar is created prior to targeting. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • enemiesBarData + table + The table that contains all the enemies bar data. Refer to table setup for enemiesBarData. +
                                                                        • +
                                                                      + +

                                                                      Returns:

                                                                      +
                                                                        + + CustomBar + Enemy health bars. +
                                                                      + + + + +
                                                                      +
                                                                      + + Get(barName) +
                                                                      +
                                                                      + The function retrieves an existing bar instance by its unique identifier (barName). This function is useful when you need to access or manipulate a bar that has already been created. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • barName + string + The unique identifier assigned to the bar when it was created using CustomBar.New +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + Delete(barName) +
                                                                      +
                                                                      + The function removes a custom bar and its associated data from the system. It ensures that the bar is no longer tracked or accessible in the LevelVars.Engine.CustomBars.bars table. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • barName + string + The name of the custom bar to be deleted. +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + SetBarValue(value, time) +
                                                                      +
                                                                      + The function sets the value of a custom bar over a specified time period. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • value + number + The new target to which the bar's current value should transition. (Must be a non-negative number; between 0 and the bar's maxValue. +
                                                                        • +
                                                                      • time + number + The time (in seconds) over which the bar's value should transition to the target value. +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + ChangeBarValueOverTimespan(value, time) +
                                                                      +
                                                                      + The function adjusts the bar's value relative to its current or target value over a specified time span. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • value + number + The relative value to add (positive or negative) to the current bar value. +
                                                                        • +
                                                                      • time + number + The duration (in seconds) over which the change should occur. +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + SetVisibility(visible) +
                                                                      +
                                                                      + The function controls the visibility of a custom bar. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • visible + bool + true: Makes the bar visible.; false: Hides the bar. +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + IsVisible() +
                                                                      +
                                                                      + The function checks whether a custom bar is currently visible. + + + + +

                                                                      Returns:

                                                                      +
                                                                        + + bool + true if the bar is visible and false if it is not. +
                                                                      + + + + +
                                                                      +
                                                                      + + GetValue() +
                                                                      +
                                                                      + The function retrieves the current value of a custom bar. + + + + +

                                                                      Returns:

                                                                      +
                                                                        + + float + returns the current value of a custom bar. +
                                                                      + + + + +
                                                                      +
                                                                      + + DeleteAllBars() +
                                                                      +
                                                                      + The function deletes all custom bars. + + + + + + + + +
                                                                      +
                                                                      + + ShowEnemiesHpGenericBar(value) +
                                                                      +
                                                                      + This function prevents the creation of new health bars for enemies when set to false. However, it does not affect the health bars that have already been created. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • value + bool + Specifies whether new health bars for enemies should be created. +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + DeleteExistingHpGenericBars() +
                                                                      +
                                                                      + The function deletes all the enemy health bars excluding those created by CustomBar.CreateEnemyHpBar. + + + + + + + + +
                                                                      +
                                                                      + + SetBackgroundPosition(pos) +
                                                                      +
                                                                      + Sets the custom bar background sprite position. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • pos + Vec2 + X,Y position of the bar's background in screen percent (0-100). +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + SetBackgroundRotation(rot) +
                                                                      +
                                                                      + Sets the custom bar background sprite rotation. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • rot + number + rotation of the bar's background. sprite (0-360). +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + SetBackgroundScale(scale) +
                                                                      +
                                                                      + Sets the custom bar background sprite scale. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • scale + Vec2 + X,Y Scaling factor for the bar's background sprite. +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + SetBackgroundSpriteSlot(slot, id) +
                                                                      +
                                                                      + Sets the custom bar background sprite slot and sprite ID. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • slot + ObjID + Object ID for the bar's background sprite. +
                                                                        • +
                                                                      • id + number + SpriteID from the specified object for the bar's background. +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + SetBackgroundAlignMode(alignMode) +
                                                                      +
                                                                      + Sets the custom bar background sprite align mode. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • alignMode + AlignMode + Alignment for the bar's background. +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + SetBackgroundScaleMode(scaleMode) +
                                                                      +
                                                                      + Sets the custom bar background sprite scale mode. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • scaleMode + ScaleMode + Scaling for the bar's background. +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + SetBackgroundBlendMode(blendMode) +
                                                                      +
                                                                      + Sets the custom bar background sprite blend mode. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • blendMode + BlendID + Blending modes for the bar's background. +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + SetBarPosition(pos) +
                                                                      +
                                                                      + Sets the custom bar sprite position. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • pos + Vec2 + X,Y position of the bar in screen percent (0-100). +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + SetBarRotation(rot) +
                                                                      +
                                                                      + Sets the custom bar sprite rotation. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • rot + number + rotation of the bar's sprite (0-360). +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + SetBarColor(color) +
                                                                      +
                                                                      + Sets the custom bar sprite color. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • color + Color + Color of the bar. +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + SetBarScale(scale) +
                                                                      +
                                                                      + Sets the custom bar sprite scale. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • scale + Vec2 + X,Y Scaling factor for the bar's sprite. +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + SetBarSpriteSlot(slot, id) +
                                                                      +
                                                                      + Sets the custom bar sprite slot and sprite ID. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • slot + ObjID + Object ID for the bar sprite. +
                                                                        • +
                                                                      • id + number + SpriteID from the specified object for the bar. +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + SetBarAlignMode(alignMode) +
                                                                      +
                                                                      + Sets the custom bar sprite alignment mode. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • alignMode + AlignMode + Alignment for the bar. +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + SetBarScaleMode(scaleMode) +
                                                                      +
                                                                      + Sets the custom bar sprite scale mode. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • scaleMode + ScaleMode + Scaling for the bar. +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + SetBarBlendMode(blendMode) +
                                                                      +
                                                                      + Sets the custom bar sprite blend mode. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • blendMode + BlendID + Blending modes for the bar. +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      +

                                                                      Tables

                                                                      + +
                                                                      +
                                                                      + + barData +
                                                                      +
                                                                      + Table setup for creating custom bar. + + + +

                                                                      Fields:

                                                                      +
                                                                        +
                                                                      • barName + string + Unique identifier for the bar. +
                                                                        • +
                                                                      • startValue + float + Initial value of the bar. +
                                                                        • +
                                                                      • maxValue + float + Maximum value of the bar. +
                                                                        • +
                                                                      • objectIdBg + ObjID + Object ID for the bar's background sprite. +
                                                                        • +
                                                                      • spriteIdBg + number + SpriteID from the specified object for the bar's background. +
                                                                        • +
                                                                      • colorBg + Color + Color of bar's background. +
                                                                        • +
                                                                      • posBg + Vec2 + X,Y position of the bar's background in screen percent (0-100). +
                                                                        • +
                                                                      • rotBg + float + rotation of the bar's background. sprite (0-360). +
                                                                        • +
                                                                      • scaleBg + Vec2 + X,Y Scaling factor for the bar's background sprite. +
                                                                        • +
                                                                      • alignModeBg + AlignMode + Alignment for the bar's background. +
                                                                        • +
                                                                      • scaleModeBg + ScaleMode + Scaling for the bar's background. +
                                                                        • +
                                                                      • blendModeBg + BlendID + Blending modes for the bar's background. +
                                                                        • +
                                                                      • objectIdBar + ObjID + Object ID for the bar sprite. +
                                                                        • +
                                                                      • spriteIdBar + number + SpriteID from the specified object for the bar. +
                                                                        • +
                                                                      • colorBar + Color + Color of the bar. +
                                                                        • +
                                                                      • posBar + Vec2 + X,Y position of the bar in screen percent (0-100). +
                                                                        • +
                                                                      • rot + float + rotation of the bar's sprite (0-360). +
                                                                        • +
                                                                      • scaleBar + Vec2 + X,Y Scaling factor for the bar's sprite. +
                                                                        • +
                                                                      • alignMode + AlignMode + Alignment for the bar. +
                                                                        • +
                                                                      • scaleMode + ScaleMode + Scaling for the bar. +
                                                                        • +
                                                                      • blendMode + BlendID + Blending modes for the bar. +
                                                                        • +
                                                                      • text + string + Text to display on the bar. +
                                                                        • +
                                                                      • textPos + Vec2 + X,Y position of the text. +
                                                                        • +
                                                                      • textOptions + DisplayStringOption + alignment and effects for the text. Default: None. Please note text is automatically aligned to the LEFT +
                                                                        • +
                                                                      • textScale + number + Scale factor for the text. +
                                                                        • +
                                                                      • textColor + Color + Color of the text. +
                                                                        • +
                                                                      • hideText + bool + Whether to hide the text. +
                                                                        • +
                                                                      • alphaBlendSpeed + number + Speed of alpha blending for bar visibility (0-255). +
                                                                        • +
                                                                      • blink + bool + Whether the bar blinks. +
                                                                        • +
                                                                      • blinkLimit + number + % Limit below which bar starts blinking (0-1). +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + playerBarData +
                                                                      +
                                                                      + Table setup for creating custom player attribute bar. + + + +

                                                                      Fields:

                                                                      +
                                                                        +
                                                                      • getActionType + number + Determines the bar type: 1: Health, 2: Air, 3: Stamina. +
                                                                        • +
                                                                      • objectIdBg + ObjID + Object ID for the bar's background sprite. +
                                                                        • +
                                                                      • spriteIdBg + number + SpriteID from the specified object for the bar's background. +
                                                                        • +
                                                                      • colorBg + Color + Color of bar's background. +
                                                                        • +
                                                                      • posBg + Vec2 + X,Y position of the bar's background in screen percent (0-100). +
                                                                        • +
                                                                      • rotBg + number + rotation of the bar's background. sprite (0-360). +
                                                                        • +
                                                                      • scaleBg + Vec2 + X,Y Scaling factor for the bar's background sprite. +
                                                                        • +
                                                                      • alignModeBg + AlignMode + Alignment for the bar's background. +
                                                                        • +
                                                                      • scaleModeBg + ScaleMode + Scaling for the bar's background. +
                                                                        • +
                                                                      • blendModeBg + BlendID + Blending modes for the bar's background. +
                                                                        • +
                                                                      • objectIdBar + ObjID + Object ID for the bar sprite. +
                                                                        • +
                                                                      • spriteIdBar + number + SpriteID from the specified object for the bar. +
                                                                        • +
                                                                      • colorBar + Color + Color of the bar. +
                                                                        • +
                                                                      • posBar + Vec2 + X,Y position of the bar in screen percent (0-100). +
                                                                        • +
                                                                      • rot + number + rotation of the bar's sprite (0-360). +
                                                                        • +
                                                                      • scaleBar + Vec2 + X,Y Scaling factor for the bar's sprite. +
                                                                        • +
                                                                      • alignMode + AlignMode + Alignment for the bar. +
                                                                        • +
                                                                      • scaleMode + ScaleMode + Scaling for the bar. +
                                                                        • +
                                                                      • blendMode + BlendID + Blending modes for the bar. +
                                                                        • +
                                                                      • alphaBlendSpeed + number + Speed of alpha blending for bar visibility (0-255). +
                                                                        • +
                                                                      • showBar + bool + Option to always show the bar. If set to false, the bars will automatically hide when they stop updating. +
                                                                        • +
                                                                      • blink + bool + Whether the bar blinks. +
                                                                        • +
                                                                      • blinkLimit + number + % Limit below which bar starts blinking (0-1). +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + enemyBarData +
                                                                      +
                                                                      + Table setup for creating a specific enemy health bar. + + + +

                                                                      Fields:

                                                                      +
                                                                        +
                                                                      • barName + string + Unique identifier for the bar. +
                                                                        • +
                                                                      • objectIdBg + ObjID + Object ID for the bar's background sprite. +
                                                                        • +
                                                                      • spriteIdBg + number + SpriteID from the specified object for the bar's background. +
                                                                        • +
                                                                      • colorBg + Color + Color of bar's background. +
                                                                        • +
                                                                      • posBg + Vec2 + X,Y position of the bar's background in screen percent (0-100). +
                                                                        • +
                                                                      • rotBg + number + rotation of the bar's background. sprite (0-360). +
                                                                        • +
                                                                      • scaleBg + Vec2 + X,Y Scaling factor for the bar's background sprite. +
                                                                        • +
                                                                      • alignModeBg + AlignMode + Alignment for the bar's background. +
                                                                        • +
                                                                      • scaleModeBg + ScaleMode + Scaling for the bar's background. +
                                                                        • +
                                                                      • blendModeBg + BlendID + Blending modes for the bar's background. +
                                                                        • +
                                                                      • objectIdBar + ObjID + Object ID for the bar sprite. +
                                                                        • +
                                                                      • spriteIdBar + number + SpriteID from the specified object for the bar. +
                                                                        • +
                                                                      • colorBar + Color + Color of the bar. +
                                                                        • +
                                                                      • posBar + Vec2 + X,Y position of the bar in screen percent (0-100). +
                                                                        • +
                                                                      • rot + number + rotation of the bar's sprite (0-360). +
                                                                        • +
                                                                      • scaleBar + Vec2 + X,Y Scaling factor for the bar's sprite. +
                                                                        • +
                                                                      • alignMode + AlignMode + Alignment for the bar. +
                                                                        • +
                                                                      • scaleMode + ScaleMode + Scaling for the bar. +
                                                                        • +
                                                                      • blendMode + BlendID + Blending modes for the bar. +
                                                                        • +
                                                                      • text + string + Text to display for the enemy. +
                                                                        • +
                                                                      • textPos + Vec2 + X,Y position of the text. +
                                                                        • +
                                                                      • textOptions + DisplayStringOption + alignment and effects for the text. Default: None. Please note text is automatically aligned to the LEFT +
                                                                        • +
                                                                      • textScale + number + Scale factor for the text. +
                                                                        • +
                                                                      • textColor + Color + Color of the text. +
                                                                        • +
                                                                      • hideText + bool + Whether to hide the text. +
                                                                        • +
                                                                      • alphaBlendSpeed + number + Speed of alpha blending for bar visibility (0-255). +
                                                                        • +
                                                                      • object + string + Enemy name set in Editor for which to create HP for. +
                                                                        • +
                                                                      • showBar + bool + Option to always show the bar whether the enemy is current target or not. Useful for boss health bars. +
                                                                        • +
                                                                      • blink + bool + Whether the bar blinks. +
                                                                        • +
                                                                      • blinkLimit + number + %Limit below which bar starts blinking (0-1). +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + enemiesBarData +
                                                                      +
                                                                      + Table setup for creating health bars for all enemies. + + + +

                                                                      Fields:

                                                                      +
                                                                        +
                                                                      • objectIdBg + ObjID + Object ID for the bar's background sprite. +
                                                                        • +
                                                                      • spriteIdBg + number + SpriteID from the specified object for the bar's background. +
                                                                        • +
                                                                      • colorBg + Color + Color of bar's background. +
                                                                        • +
                                                                      • posBg + Vec2 + X,Y position of the bar's background in screen percent (0-100). +
                                                                        • +
                                                                      • rotBg + number + rotation of the bar's background. sprite (0-360). +
                                                                        • +
                                                                      • scaleBg + Vec2 + X,Y Scaling factor for the bar's background sprite. +
                                                                        • +
                                                                      • alignModeBg + AlignMode + Alignment for the bar's background. +
                                                                        • +
                                                                      • scaleModeBg + ScaleMode + Scaling for the bar's background. +
                                                                        • +
                                                                      • blendModeBg + BlendID + Blending modes for the bar's background. +
                                                                        • +
                                                                      • objectIdBar + ObjID + Object ID for the bar sprite. +
                                                                        • +
                                                                      • spriteIdBar + number + SpriteID from the specified object for the bar. +
                                                                        • +
                                                                      • colorBar + Color + Color of the bar. +
                                                                        • +
                                                                      • posBar + Vec2 + X,Y position of the bar in screen percent (0-100). +
                                                                        • +
                                                                      • rot + number + rotation of the bar's sprite (0-360). +
                                                                        • +
                                                                      • scaleBar + Vec2 + X,Y Scaling factor for the bar's sprite. +
                                                                        • +
                                                                      • alignMode + AlignMode + Alignment for the bar. +
                                                                        • +
                                                                      • scaleMode + ScaleMode + Scaling for the bar. +
                                                                        • +
                                                                      • blendMode + BlendID + Blending modes for the bar. +
                                                                        • +
                                                                      • textPos + number + X position of the text. +
                                                                        • +
                                                                      • textOptions + DisplayStringOption + alignment and effects for the text. Default: None. Please note text is automatically aligned to the LEFT +
                                                                        • +
                                                                      • textScale + number + Scale factor for the text. +
                                                                        • +
                                                                      • textColor + Color + Color of the text. +
                                                                        • +
                                                                      • hideText + bool + Whether to hide the enemy name text. +
                                                                        • +
                                                                      • alphaBlendSpeed + number + Speed of alpha blending for bar visibility (0-255). +
                                                                        • +
                                                                      • blink + bool + Whether the bar blinks. +
                                                                        • +
                                                                      • blinkLimit + number + %Limit below which bar starts blinking (0-1). +
                                                                        • +
                                                                      + + + + + +
                                                                      +
                                                                      + + +
                                                                      +
                                                                      +
                                                                      +generated by TEN-LDoc (a fork of LDoc 1.4.6) +
                                                                      +
                                                                      + + diff --git a/Documentation/doc/5 lua utility modules/Diary.html b/Documentation/doc/5 lua utility modules/Diary.html index 492298007..3a0a4c6d5 100644 --- a/Documentation/doc/5 lua utility modules/Diary.html +++ b/Documentation/doc/5 lua utility modules/Diary.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • @@ -114,8 +115,7 @@

                                                                      Lua utility module Diary

                                                                      -

                                                                      Diaries: - The module provides functions to create and manage Diaries.

                                                                      +

                                                                      This module provides functions to create and manage diaries.

                                                                      It maintains diary definitions and entries through all levels and hubs. Each diary is accessed by the object that was used to create it.

                                                                      diff --git a/Documentation/doc/5 lua utility modules/EventSequence.html b/Documentation/doc/5 lua utility modules/EventSequence.html index f12fd2f6f..21199ec26 100644 --- a/Documentation/doc/5 lua utility modules/EventSequence.html +++ b/Documentation/doc/5 lua utility modules/EventSequence.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/5 lua utility modules/Timer.html b/Documentation/doc/5 lua utility modules/Timer.html index 550d1d189..263709641 100644 --- a/Documentation/doc/5 lua utility modules/Timer.html +++ b/Documentation/doc/5 lua utility modules/Timer.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/5 lua utility modules/Type.html b/Documentation/doc/5 lua utility modules/Type.html index be9f19aa1..ab0d9dcff 100644 --- a/Documentation/doc/5 lua utility modules/Type.html +++ b/Documentation/doc/5 lua utility modules/Type.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • diff --git a/Documentation/doc/index.html b/Documentation/doc/index.html index d743234d1..1d5a3c407 100644 --- a/Documentation/doc/index.html +++ b/Documentation/doc/index.html @@ -103,6 +103,7 @@

                                                                    5 Lua utility modules

                                                                      +
                                                                    • CustomBar
                                                                    • Diary
                                                                    • EventSequence
                                                                    • Timer
                                                                      • @@ -386,10 +387,13 @@ local door = GetMoveableByName("door_type4_14")

                                                                      5 Lua utility modules

                                                                      + + + + - + diff --git a/Scripts/Engine/CustomBar.lua b/Scripts/Engine/CustomBar.lua new file mode 100644 index 000000000..a0404199f --- /dev/null +++ b/Scripts/Engine/CustomBar.lua @@ -0,0 +1,951 @@ +------ +-- This module provides functions for creating and managing custom progress bars. It stores bar definitions and configurations in `LevelVars.Engine.CustomBars`, enabling seamless state management. +-- Each bar is independently controlled through its associated functions. +-- +-- Example usage: +-- +-- local CustomBar = require("Engine.CustomBar") +-- +-- -- Create a table with all the bar properties +-- local barData = { +-- barName = "water", +-- startValue = 0, +-- maxValue = 1000, +-- objectIdBg = TEN.Objects.ObjID.CUSTOM_BAR_GRAPHIC, +-- spriteIdBg = 0, +-- colorBg = TEN.Color(255,255,255), +-- posBg = TEN.Vec2(20, 20), +-- rotBg = 0, +-- scaleBg = TEN.Vec2(19.05, 19.1), +-- alignModeBg = TEN.View.AlignMode.CENTER_LEFT, +-- scaleModeBg = TEN.View.ScaleMode.FIT, +-- blendModeBg = TEN.Effects.BlendID.ALPHABLEND, +-- objectIdBar = TEN.Objects.ObjID.CUSTOM_BAR_GRAPHIC, +-- spriteIdBar = 1, +-- colorBar = TEN.Color(255,0,0), +-- posBar = TEN.Vec2(20.15, 20), +-- rot = 0, +-- scaleBar = TEN.Vec2(18.7, 18.48), +-- alignMode = TEN.View.AlignMode.CENTER_LEFT, +-- scaleMode = TEN.View.ScaleMode.FIT, +-- blendMode = TEN.Effects.BlendID.ALPHABLEND, +-- text = "Water Bar", +-- textPos = TEN.Vec2(20, 15), +-- textOptions = {TEN.Strings.DisplayStringOption.SHADOW,TEN.Strings.DisplayStringOption.CENTER}, +-- textScale = 1, +-- textColor = TEN.Color(255,0,0), +-- hideText = false, +-- alphaBlendSpeed = 50, +-- blink = false, +-- blinkLimit = 0.25 +-- } +-- +-- -- This function creates the bar. +-- CustomBar.Create(barData) +-- +-- -- This method gets the bar with name "water" and stores it in variable bar. +-- local bar = CustomBar.Get("water") +-- -- This method displays the bar +-- bar:SetVisibility(true) +-- -- This method sets the bar value to 1000 over 5 seconds. +-- bar:SetBarValue(1000,5) +-- +-- @luautil CustomBar + + +local CustomBar = {} + +CustomBar.__index = CustomBar + +LevelFuncs.Engine.CustomBar = {} +LevelVars.Engine.CustomBars = {bars = {}, enemiesHpBar = {status = nil}} + +--- +-- Creates a custom progress bar with extensive configuration options. +-- @tparam table barData The table that contains all the bar data. Refer to table setup for barData. +-- +-- @treturn CustomBar The custombar in its hidden state +-- +CustomBar.Create = function (barData) + + local dataName = barData.barName .. "_bar_data" + local self = {name = dataName} + + if LevelVars.Engine.CustomBars.bars[dataName] then + print("Warning: a customBar with name " .. dataName .. " already exists; overwriting it with a new one...") + end +--- +-- Table setup for creating custom bar. +-- @table barData +-- @tfield string barName Unique identifier for the bar. +-- @tfield float startValue Initial value of the bar. +-- @tfield float maxValue Maximum value of the bar. +-- @tfield Objects.ObjID objectIdBg Object ID for the bar's background sprite. +-- @tfield number spriteIdBg SpriteID from the specified object for the bar's background. +-- @tfield Color colorBg Color of bar's background. +-- @tfield Vec2 posBg X,Y position of the bar's background in screen percent (0-100). +-- @tfield float rotBg rotation of the bar's background. sprite (0-360). +-- @tfield Vec2 scaleBg X,Y Scaling factor for the bar's background sprite. +-- @tfield View.AlignMode alignModeBg Alignment for the bar's background. +-- @tfield View.ScaleMode scaleModeBg Scaling for the bar's background. +-- @tfield Effects.BlendID blendModeBg Blending modes for the bar's background. +-- @tfield Objects.ObjID objectIdBar Object ID for the bar sprite. +-- @tfield number spriteIdBar SpriteID from the specified object for the bar. +-- @tfield Color colorBar Color of the bar. +-- @tfield Vec2 posBar X,Y position of the bar in screen percent (0-100). +-- @tfield float rot rotation of the bar's sprite (0-360). +-- @tfield Vec2 scaleBar X,Y Scaling factor for the bar's sprite. +-- @tfield View.AlignMode alignMode Alignment for the bar. +-- @tfield View.ScaleMode scaleMode Scaling for the bar. +-- @tfield Effects.BlendID blendMode Blending modes for the bar. +-- @tfield string text Text to display on the bar. +-- @tfield Vec2 textPos X,Y position of the text. +-- @tfield Strings.DisplayStringOption textOptions alignment and effects for the text. Default: None. Please note text is automatically aligned to the LEFT +-- @tfield number textScale Scale factor for the text. +-- @tfield Color textColor Color of the text. +-- @tfield bool hideText Whether to hide the text. +-- @tfield number alphaBlendSpeed Speed of alpha blending for bar visibility (0-255). +-- @tfield bool blink Whether the bar blinks. +-- @tfield number blinkLimit % Limit below which bar starts blinking (0-1). + + LevelVars.Engine.CustomBars.bars[dataName] = {} + LevelVars.Engine.CustomBars.bars[dataName].name = dataName + LevelVars.Engine.CustomBars.bars[dataName].fixedInterval = 1/30 + LevelVars.Engine.CustomBars.bars[dataName].progress = barData.startValue / barData.maxValue -- Set initial progress from start value + LevelVars.Engine.CustomBars.bars[dataName].objectIdBg = barData.objectIdBg + LevelVars.Engine.CustomBars.bars[dataName].spriteIdBg = barData.spriteIdBg + LevelVars.Engine.CustomBars.bars[dataName].colorBg = barData.colorBg + LevelVars.Engine.CustomBars.bars[dataName].posBg = barData.posBg + LevelVars.Engine.CustomBars.bars[dataName].scaleBg = barData.scaleBg + LevelVars.Engine.CustomBars.bars[dataName].rotBg = barData.rotBg + LevelVars.Engine.CustomBars.bars[dataName].alignModeBg = barData.alignModeBg + LevelVars.Engine.CustomBars.bars[dataName].scaleModeBg = barData.scaleModeBg + LevelVars.Engine.CustomBars.bars[dataName].blendModeBg = barData.blendModeBg + LevelVars.Engine.CustomBars.bars[dataName].objectIdBar = barData.objectIdBar + LevelVars.Engine.CustomBars.bars[dataName].spriteIdBar = barData.spriteIdBar + LevelVars.Engine.CustomBars.bars[dataName].colorBar = barData.colorBar + LevelVars.Engine.CustomBars.bars[dataName].posBar = barData.posBar + LevelVars.Engine.CustomBars.bars[dataName].scaleBar = barData.scaleBar + LevelVars.Engine.CustomBars.bars[dataName].rot = barData.rot + LevelVars.Engine.CustomBars.bars[dataName].alignMode = barData.alignMode + LevelVars.Engine.CustomBars.bars[dataName].scaleMode = barData.scaleMode + LevelVars.Engine.CustomBars.bars[dataName].blendMode = barData.blendMode + LevelVars.Engine.CustomBars.bars[dataName].oldValue = barData.startValue -- stores the current bar value + LevelVars.Engine.CustomBars.bars[dataName].targetValue = barData.startValue -- target value to reach + LevelVars.Engine.CustomBars.bars[dataName].maxValue = barData.maxValue + LevelVars.Engine.CustomBars.bars[dataName].text = barData.text + LevelVars.Engine.CustomBars.bars[dataName].textPos = barData.textPos + LevelVars.Engine.CustomBars.bars[dataName].textOptions = barData.textOptions + LevelVars.Engine.CustomBars.bars[dataName].textScale = barData.textScale + LevelVars.Engine.CustomBars.bars[dataName].textColor = barData.textColor + LevelVars.Engine.CustomBars.bars[dataName].hideText = barData.hideText -- required to hide bar text + LevelVars.Engine.CustomBars.bars[dataName].visible = false + LevelVars.Engine.CustomBars.bars[dataName].currentAlpha = 0 + LevelVars.Engine.CustomBars.bars[dataName].targetAlpha = 0 + LevelVars.Engine.CustomBars.bars[dataName].alphaBlendSpeed = barData.alphaBlendSpeed + LevelVars.Engine.CustomBars.bars[dataName].blink = barData.blink + LevelVars.Engine.CustomBars.bars[dataName].blinkLimit = barData.blinkLimit + LevelVars.Engine.CustomBars.bars[dataName].blinkSpeed = 8 + LevelVars.Engine.CustomBars.bars[dataName].showBar = nil --required to hide bar when enemy is not targeted + LevelVars.Engine.CustomBars.bars[dataName].object = nil + LevelVars.Engine.CustomBars.bars[dataName].getActionType = nil + LevelVars.Engine.CustomBars.bars[dataName].currentTimer = 0 + return setmetatable(self, CustomBar) +end + +--- +-- Creates a bar tied to Players's attributes (Health, Air, Stamina). +-- @tparam table playerBarData The table that contains all the player bar data. Refer to table setup for playerBarData. +-- @treturn CustomBar Player attribute bar. + +CustomBar.CreatePlayerBar = function (playerBarData) + + local barName = "Player" .. playerBarData.getActionType + local dataName = barName .. "_bar_data" + + if playerBarData.getActionType >= 1 and playerBarData.getActionType <= 3 then + local startValue = playerBarData.getActionType == 1 and Lara:GetHP() or + (playerBarData.getActionType == 2 and Lara:GetAir() or + (playerBarData.getActionType == 3 and Lara:GetStamina())) + local maxValue = playerBarData.getActionType == 1 and 1000 or (playerBarData.getActionType == 2 and 1800 or (playerBarData.getActionType == 3 and 120)) + +--- +-- Table setup for creating custom player attribute bar. +-- @table playerBarData +-- @tfield number getActionType Determines the bar type: 1: Health, 2: Air, 3: Stamina. +-- @tfield Objects.ObjID objectIdBg Object ID for the bar's background sprite. +-- @tfield number spriteIdBg SpriteID from the specified object for the bar's background. +-- @tfield Color colorBg Color of bar's background. +-- @tfield Vec2 posBg X,Y position of the bar's background in screen percent (0-100). +-- @tfield number rotBg rotation of the bar's background. sprite (0-360). +-- @tfield Vec2 scaleBg X,Y Scaling factor for the bar's background sprite. +-- @tfield View.AlignMode alignModeBg Alignment for the bar's background. +-- @tfield View.ScaleMode scaleModeBg Scaling for the bar's background. +-- @tfield Effects.BlendID blendModeBg Blending modes for the bar's background. +-- @tfield Objects.ObjID objectIdBar Object ID for the bar sprite. +-- @tfield number spriteIdBar SpriteID from the specified object for the bar. +-- @tfield Color colorBar Color of the bar. +-- @tfield Vec2 posBar X,Y position of the bar in screen percent (0-100). +-- @tfield number rot rotation of the bar's sprite (0-360). +-- @tfield Vec2 scaleBar X,Y Scaling factor for the bar's sprite. +-- @tfield View.AlignMode alignMode Alignment for the bar. +-- @tfield View.ScaleMode scaleMode Scaling for the bar. +-- @tfield Effects.BlendID blendMode Blending modes for the bar. +-- @tfield number alphaBlendSpeed Speed of alpha blending for bar visibility (0-255). +-- @tfield bool showBar Option to always show the bar. If set to false, the bars will automatically hide when they stop updating. +-- @tfield bool blink Whether the bar blinks. +-- @tfield number blinkLimit % Limit below which bar starts blinking (0-1). + + local playerBar = { + barName = barName, + startValue = startValue, + maxValue = maxValue, + objectIdBg = playerBarData.objectIdBg, + spriteIdBg = playerBarData.spriteIdBg, + colorBg = playerBarData.colorBg, + posBg = playerBarData.posBg, + rotBg = playerBarData.rotBg, + scaleBg = playerBarData.scaleBg, + alignModeBg = playerBarData.alignModeBg, + scaleModeBg = playerBarData.scaleModeBg, + blendModeBg = playerBarData.blendModeBg, + objectIdBar = playerBarData.objectIdBar, + spriteIdBar = playerBarData.spriteIdBar, + colorBar = playerBarData.colorBar, + posBar = playerBarData.posBar, + rot = playerBarData.rot, + scaleBar = playerBarData.scaleBar, + alignMode = playerBarData.alignMode, + scaleMode = playerBarData.scaleMode, + blendMode = playerBarData.blendMode, + text = "BLANK", + textPos = TEN.Vec2(0,0), + textOptions = {}, + textScale = 0, + textColor = TEN.Color(0,0,0), + hideText = true, + alphaBlendSpeed = playerBarData.alphaBlendSpeed, + blink = playerBarData.blink, + blinkLimit = playerBarData.blinkLimit, + } + + CustomBar.Create(playerBar) + + end + + LevelVars.Engine.CustomBars.bars[dataName].getActionType = playerBarData.getActionType + LevelVars.Engine.CustomBars.bars[dataName].showBar = playerBarData.showBar + LevelVars.Engine.CustomBars.bars[dataName].visible = true + LevelVars.Engine.CustomBars.bars[dataName].targetAlpha = 255 + +end + +--- +-- Creates a custom health bar for a specific enemy (like a boss). Ensure this function is called before Lara aims at the enemy if using generic enemy HP bars as well. +-- Also be sure to call this function after increasing the HP of the enemy via LUA. +-- @tparam table enemyBarData The table that contains all the enemy bar data. Refer to table setup for enemyBarData. +-- @treturn CustomBar Enemy health bar. +CustomBar.CreateEnemyHpBar = function (enemyBarData) + + local dataName = enemyBarData.barName .. "_bar_data" + local enemyHP = TEN.Objects.GetMoveableByName(enemyBarData.object):GetHP() + +--- +-- Table setup for creating a specific enemy health bar. +-- @table enemyBarData +-- @tfield string barName Unique identifier for the bar. +-- @tfield Objects.ObjID objectIdBg Object ID for the bar's background sprite. +-- @tfield number spriteIdBg SpriteID from the specified object for the bar's background. +-- @tfield Color colorBg Color of bar's background. +-- @tfield Vec2 posBg X,Y position of the bar's background in screen percent (0-100). +-- @tfield number rotBg rotation of the bar's background. sprite (0-360). +-- @tfield Vec2 scaleBg X,Y Scaling factor for the bar's background sprite. +-- @tfield View.AlignMode alignModeBg Alignment for the bar's background. +-- @tfield View.ScaleMode scaleModeBg Scaling for the bar's background. +-- @tfield Effects.BlendID blendModeBg Blending modes for the bar's background. +-- @tfield Objects.ObjID objectIdBar Object ID for the bar sprite. +-- @tfield number spriteIdBar SpriteID from the specified object for the bar. +-- @tfield Color colorBar Color of the bar. +-- @tfield Vec2 posBar X,Y position of the bar in screen percent (0-100). +-- @tfield number rot rotation of the bar's sprite (0-360). +-- @tfield Vec2 scaleBar X,Y Scaling factor for the bar's sprite. +-- @tfield View.AlignMode alignMode Alignment for the bar. +-- @tfield View.ScaleMode scaleMode Scaling for the bar. +-- @tfield Effects.BlendID blendMode Blending modes for the bar. +-- @tfield string text Text to display for the enemy. +-- @tfield Vec2 textPos X,Y position of the text. +-- @tfield Strings.DisplayStringOption textOptions alignment and effects for the text. Default: None. Please note text is automatically aligned to the LEFT +-- @tfield number textScale Scale factor for the text. +-- @tfield Color textColor Color of the text. +-- @tfield bool hideText Whether to hide the text. +-- @tfield number alphaBlendSpeed Speed of alpha blending for bar visibility (0-255). +-- @tfield string object Enemy name set in Editor for which to create HP for. +-- @tfield bool showBar Option to always show the bar whether the enemy is current target or not. Useful for boss health bars. +-- @tfield bool blink Whether the bar blinks. +-- @tfield number blinkLimit %Limit below which bar starts blinking (0-1). + + local enemyBar = { + barName = enemyBarData.barName, + startValue = enemyHP, + maxValue = enemyHP, + objectIdBg = enemyBarData.objectIdBg, + spriteIdBg = enemyBarData.spriteIdBg, + colorBg = enemyBarData.colorBg, + posBg = enemyBarData.posBg, + rotBg = enemyBarData.rotBg, + scaleBg = enemyBarData.scaleBg, + alignModeBg = enemyBarData.alignModeBg, + scaleModeBg = enemyBarData.scaleModeBg, + blendModeBg = enemyBarData.blendModeBg, + objectIdBar = enemyBarData.objectIdBar, + spriteIdBar = enemyBarData.spriteIdBar, + colorBar = enemyBarData.colorBar, + posBar = enemyBarData.posBar, + rot = enemyBarData.rot, + scaleBar = enemyBarData.scaleBar, + alignMode = enemyBarData.alignMode, + scaleMode = enemyBarData.scaleMode, + blendMode = enemyBarData.blendMode, + text = enemyBarData.text, + textPos = enemyBarData.textPos, + textOptions = enemyBarData.textOptions, + textScale = enemyBarData.textScale, + textColor = enemyBarData.textColor, + hideText = enemyBarData.hideText, + alphaBlendSpeed = enemyBarData.alphaBlendSpeed, + blink = enemyBarData.blink, + blinkLimit = enemyBarData.blinkLimit + } + + CustomBar.Create(enemyBar) + + LevelVars.Engine.CustomBars.bars[dataName].showBar = enemyBarData.showBar + LevelVars.Engine.CustomBars.bars[dataName].object = enemyBarData.object + LevelVars.Engine.CustomBars.bars[dataName].getActionType = 0 + LevelVars.Engine.CustomBars.bars[dataName].visible = true + LevelVars.Engine.CustomBars.bars[dataName].fixedInterval = 1/3 + LevelVars.Engine.CustomBars.bars[dataName].currentAlpha = 0 + LevelVars.Engine.CustomBars.bars[dataName].targetAlpha = 255 + +end + +--- +-- Creates health bars for all enemies. A new bar is generated whenever Lara targets an enemy. If the "hide text" option is disabled, the enemy's name (as set in the editor) is displayed. +-- Multiple enemies can share the same name by appending _number to the name in the editor. If adjusting an enemy's max HP, ensure this is done before Lara targets the enemy. +-- To create health bars for specific enemies, use CustomBar.CreateEnemyHpBar, ensuring the bar is created prior to targeting. +-- @tparam table enemiesBarData The table that contains all the enemies bar data. Refer to table setup for enemiesBarData. +-- @treturn CustomBar Enemy health bars. + +CustomBar.SetEnemiesHpGenericBar = function (enemiesBarData) + + if LevelVars.Engine.CustomBars.enemiesHpBar.objectIdBg then + print("Warning: Overwriting enemy HP bar definitions") + end + +--- +-- Table setup for creating health bars for all enemies. +-- @table enemiesBarData +-- @tfield Objects.ObjID objectIdBg Object ID for the bar's background sprite. +-- @tfield number spriteIdBg SpriteID from the specified object for the bar's background. +-- @tfield Color colorBg Color of bar's background. +-- @tfield Vec2 posBg X,Y position of the bar's background in screen percent (0-100). +-- @tfield number rotBg rotation of the bar's background. sprite (0-360). +-- @tfield Vec2 scaleBg X,Y Scaling factor for the bar's background sprite. +-- @tfield View.AlignMode alignModeBg Alignment for the bar's background. +-- @tfield View.ScaleMode scaleModeBg Scaling for the bar's background. +-- @tfield Effects.BlendID blendModeBg Blending modes for the bar's background. +-- @tfield Objects.ObjID objectIdBar Object ID for the bar sprite. +-- @tfield number spriteIdBar SpriteID from the specified object for the bar. +-- @tfield Color colorBar Color of the bar. +-- @tfield Vec2 posBar X,Y position of the bar in screen percent (0-100). +-- @tfield number rot rotation of the bar's sprite (0-360). +-- @tfield Vec2 scaleBar X,Y Scaling factor for the bar's sprite. +-- @tfield View.AlignMode alignMode Alignment for the bar. +-- @tfield View.ScaleMode scaleMode Scaling for the bar. +-- @tfield Effects.BlendID blendMode Blending modes for the bar. +-- @tfield number textPos X position of the text. +-- @tfield Strings.DisplayStringOption textOptions alignment and effects for the text. Default: None. Please note text is automatically aligned to the LEFT +-- @tfield number textScale Scale factor for the text. +-- @tfield Color textColor Color of the text. +-- @tfield bool hideText Whether to hide the enemy name text. +-- @tfield number alphaBlendSpeed Speed of alpha blending for bar visibility (0-255). +-- @tfield bool blink Whether the bar blinks. +-- @tfield number blinkLimit %Limit below which bar starts blinking (0-1). + + LevelVars.Engine.CustomBars.enemiesHpBar.objectIdBg = enemiesBarData.objectIdBg + LevelVars.Engine.CustomBars.enemiesHpBar.spriteIdBg = enemiesBarData.spriteIdBg + LevelVars.Engine.CustomBars.enemiesHpBar.colorBg = enemiesBarData.colorBg + LevelVars.Engine.CustomBars.enemiesHpBar.posBg = enemiesBarData.posBg + LevelVars.Engine.CustomBars.enemiesHpBar.scaleBg = enemiesBarData.scaleBg + LevelVars.Engine.CustomBars.enemiesHpBar.rotBg = enemiesBarData.rotBg + LevelVars.Engine.CustomBars.enemiesHpBar.alignModeBg = enemiesBarData.alignModeBg + LevelVars.Engine.CustomBars.enemiesHpBar.scaleModeBg = enemiesBarData.scaleModeBg + LevelVars.Engine.CustomBars.enemiesHpBar.blendModeBg = enemiesBarData.blendModeBg + LevelVars.Engine.CustomBars.enemiesHpBar.objectIdBar = enemiesBarData.objectIdBar + LevelVars.Engine.CustomBars.enemiesHpBar.spriteIdBar = enemiesBarData.spriteIdBar + LevelVars.Engine.CustomBars.enemiesHpBar.colorBar = enemiesBarData.colorBar + LevelVars.Engine.CustomBars.enemiesHpBar.posBar = enemiesBarData.posBar + LevelVars.Engine.CustomBars.enemiesHpBar.scaleBar = enemiesBarData.scaleBar + LevelVars.Engine.CustomBars.enemiesHpBar.rot = enemiesBarData.rot + LevelVars.Engine.CustomBars.enemiesHpBar.alignMode = enemiesBarData.alignMode + LevelVars.Engine.CustomBars.enemiesHpBar.scaleMode = enemiesBarData.scaleMode + LevelVars.Engine.CustomBars.enemiesHpBar.blendMode = enemiesBarData.blendMode + LevelVars.Engine.CustomBars.enemiesHpBar.textPos = enemiesBarData.textPos + LevelVars.Engine.CustomBars.enemiesHpBar.textOptions = enemiesBarData.textOptions + LevelVars.Engine.CustomBars.enemiesHpBar.textScale = enemiesBarData.textScale + LevelVars.Engine.CustomBars.enemiesHpBar.textColor = enemiesBarData.textColor + LevelVars.Engine.CustomBars.enemiesHpBar.hideText = enemiesBarData.hideText + LevelVars.Engine.CustomBars.enemiesHpBar.alphaBlendSpeed = enemiesBarData.alphaBlendSpeed + LevelVars.Engine.CustomBars.enemiesHpBar.blink = enemiesBarData.blink + LevelVars.Engine.CustomBars.enemiesHpBar.blinkLimit = enemiesBarData.blinkLimit + + + LevelVars.Engine.CustomBars.enemiesHpBar.status = true + +end + +--- The function retrieves an existing bar instance by its unique identifier (barName). This function is useful when you need to access or manipulate a bar that has already been created. +-- @string barName The unique identifier assigned to the bar when it was created using CustomBar.New +CustomBar.Get = function(barName) + local dataName = barName .. "_bar_data" + if LevelVars.Engine.CustomBars.bars[dataName] then + local self = {name = dataName} + return setmetatable(self, CustomBar) + end +end + +--- The function removes a custom bar and its associated data from the system. It ensures that the bar is no longer tracked or accessible in the LevelVars.Engine.CustomBars.bars table. +-- @string barName The name of the custom bar to be deleted. +CustomBar.Delete = function (barName) + local dataName = barName .. "_bar_data" + if LevelVars.Engine.CustomBars.bars[dataName] then + LevelVars.Engine.CustomBars.bars[dataName] = nil + end +end + +--- The function sets the value of a custom bar over a specified time period. +-- @number value The new target to which the bar's current value should transition. (Must be a non-negative number; between 0 and the bar's maxValue. +-- @number time The time (in seconds) over which the bar's value should transition to the target value. +function CustomBar:SetBarValue(value, time) + if LevelVars.Engine.CustomBars.bars[self.name] then + if type(value) =="number" and value >= 0 then + local currentValue = LevelVars.Engine.CustomBars.bars[self.name].oldValue + local maxValue = LevelVars.Engine.CustomBars.bars[self.name].maxValue + local newTargetValue = math.max(0, math.min(maxValue, value)) + LevelVars.Engine.CustomBars.bars[self.name].targetValue = newTargetValue + LevelVars.Engine.CustomBars.bars[self.name].fixedInterval = (newTargetValue - currentValue) / (time * 30) + end + end +end + +--- The function adjusts the bar's value relative to its current or target value over a specified time span. +-- @number value The relative value to add (positive or negative) to the current bar value. +-- @number time The duration (in seconds) over which the change should occur. +function CustomBar:ChangeBarValueOverTimespan(value, time) + -- Check if bar data and timer exist + if LevelVars.Engine.CustomBars.bars[self.name] then + + -- Get the current target value or old value if no target value exists + local currentValue = LevelVars.Engine.CustomBars.bars[self.name].oldValue + local maxValue = LevelVars.Engine.CustomBars.bars[self.name].maxValue + local currentTarget = LevelVars.Engine.CustomBars.bars[self.name].targetValue or currentValue + + -- Calculate new target value by adding the relative 'value' and clamp between 0 and 1000 + local newTargetValue = math.max(0, math.min(maxValue, currentTarget + value)) + + -- Set the new target value + LevelVars.Engine.CustomBars.bars[self.name].targetValue = newTargetValue + + -- Calculate total frames based on time and FPS (30 FPS) + local totalFrames = time * 30 + + -- Calculate the fixed interval for the entire transition + LevelVars.Engine.CustomBars.bars[self.name].fixedInterval = (newTargetValue - currentValue) / totalFrames + end +end + +--- The function controls the visibility of a custom bar. +-- @bool visible true: Makes the bar visible.; false: Hides the bar. +function CustomBar:SetVisibility(visible) + --the visible variable is a boolean + if LevelVars.Engine.CustomBars.bars[self.name] then + if visible and type(visible) == "boolean" then + LevelVars.Engine.CustomBars.bars[self.name].targetAlpha = 255 + LevelVars.Engine.CustomBars.bars[self.name].visible = true + else + LevelVars.Engine.CustomBars.bars[self.name].targetAlpha = 0 + end + end +end + +--- The function checks whether a custom bar is currently visible. +-- @treturn bool true if the bar is visible and false if it is not. +function CustomBar:IsVisible() + + if LevelVars.Engine.CustomBars.bars[self.name] then + if LevelVars.Engine.CustomBars.bars[self.name].visible then + return true + else + return false + end + end +end + +--- The function retrieves the current value of a custom bar. +-- @treturn float returns the current value of a custom bar. +function CustomBar:GetValue() + + if LevelVars.Engine.CustomBars.bars[self.name] then + return LevelVars.Engine.CustomBars.bars[self.name].oldValue + end +end + +--- The function deletes all custom bars. +CustomBar.DeleteAllBars = function () + for _, customBar in pairs (LevelVars.Engine.CustomBars.bars) do + LevelVars.Engine.CustomBars.bars[customBar.name] = nil + end +end + +--- This function prevents the creation of new health bars for enemies when set to false. However, it does not affect the health bars that have already been created. +-- @bool value Specifies whether new health bars for enemies should be created. +CustomBar.ShowEnemiesHpGenericBar = function(value) + if type(value) == "boolean" then + LevelVars.Engine.CustomBars.enemiesHpBar.status = value + end +end + +--- The function deletes all the enemy health bars excluding those created by CustomBar.CreateEnemyHpBar. +CustomBar.DeleteExistingHpGenericBars = function () + for _, customBar in pairs (LevelVars.Engine.CustomBars.bars) do + if customBar.getActionType == 4 then + LevelVars.Engine.CustomBars.bars[customBar.name] = nil + end + end +end + +--- Sets the custom bar background sprite position. +-- @tparam Vec2 pos X,Y position of the bar's background in screen percent (0-100). +-- +function CustomBar:SetBackgroundPosition(pos) + if pos and LevelVars.Engine.CustomBars.bars[self.name] then + LevelVars.Engine.CustomBars.bars[self.name].posBg = pos + end +end + +--- Sets the custom bar background sprite rotation. +-- @tparam number rot rotation of the bar's background. sprite (0-360). +-- +function CustomBar:SetBackgroundRotation(rot) + if rot and LevelVars.Engine.CustomBars.bars[self.name] then + LevelVars.Engine.CustomBars.bars[self.name].rotBg = rot + end +end + +-- Sets the custom bar background sprite color. +-- @tparam Color color Color of bar's background. +-- +function CustomBar:SetBackgroundColor(color) + if color and LevelVars.Engine.CustomBars.bars[self.name] then + LevelVars.Engine.CustomBars.bars[self.name].colorBg = color + end +end + +--- +-- Sets the custom bar background sprite scale. +-- @tparam Vec2 scale X,Y Scaling factor for the bar's background sprite. +-- +function CustomBar:SetBackgroundScale(scale) + if scale and LevelVars.Engine.CustomBars.bars[self.name] then + LevelVars.Engine.CustomBars.bars[self.name].scaleBg = scale + end +end + +--- +-- Sets the custom bar background sprite slot and sprite ID. +-- @tparam Objects.ObjID slot Object ID for the bar's background sprite. +-- @tparam number id SpriteID from the specified object for the bar's background. +-- +function CustomBar:SetBackgroundSpriteSlot(slot, id) + if slot and id and LevelVars.Engine.CustomBars.bars[self.name] then + LevelVars.Engine.CustomBars.bars[self.name].objectIdBg = slot + LevelVars.Engine.CustomBars.bars[self.name].spriteIdBg = id + end +end + +--- +-- Sets the custom bar background sprite align mode. +-- @tparam View.AlignMode alignMode Alignment for the bar's background. +-- +function CustomBar:SetBackgroundAlignMode(alignMode) + if alignMode and LevelVars.Engine.CustomBars.bars[self.name] then + LevelVars.Engine.CustomBars.bars[self.name].alignModeBg = alignMode + end +end +--- +-- Sets the custom bar background sprite scale mode. +-- @tparam View.ScaleMode scaleMode Scaling for the bar's background. +-- +function CustomBar:SetBackgroundScaleMode(scaleMode) + if scaleMode and LevelVars.Engine.CustomBars.bars[self.name] then + LevelVars.Engine.CustomBars.bars[self.name].scaleModeBg = scaleMode + end +end +--- +-- Sets the custom bar background sprite blend mode. +-- @tparam Effects.BlendID blendMode Blending modes for the bar's background. +-- +function CustomBar:SetBackgroundBlendMode(blendMode) + if blendMode and LevelVars.Engine.CustomBars.bars[self.name] then + LevelVars.Engine.CustomBars.bars[self.name].blendModeBg = blendMode + end +end + +--- +-- Sets the custom bar sprite position. +-- @tparam Vec2 pos X,Y position of the bar in screen percent (0-100). +-- +function CustomBar:SetBarPosition(pos) + if pos and LevelVars.Engine.CustomBars.bars[self.name] then + LevelVars.Engine.CustomBars.bars[self.name].posBar = pos + end +end +--- +-- Sets the custom bar sprite rotation. +-- @tparam number rot rotation of the bar's sprite (0-360). +-- +function CustomBar:SetBarRotation(rot) + if rot and LevelVars.Engine.CustomBars.bars[self.name] then + LevelVars.Engine.CustomBars.bars[self.name].rot = rot + end +end +--- +-- Sets the custom bar sprite color. +-- @tparam Color color Color of the bar. +-- +function CustomBar:SetBarColor(color) + if color and LevelVars.Engine.CustomBars.bars[self.name] then + LevelVars.Engine.CustomBars.bars[self.name].colorBar = color + end +end +--- +-- Sets the custom bar sprite scale. +-- @tparam Vec2 scale X,Y Scaling factor for the bar's sprite. +-- +function CustomBar:SetBarScale(scale) + if scale and LevelVars.Engine.CustomBars.bars[self.name] then + LevelVars.Engine.CustomBars.bars[self.name].scaleBar = scale + end +end +--- +-- Sets the custom bar sprite slot and sprite ID. +-- @tparam Objects.ObjID slot Object ID for the bar sprite. +-- @tparam number id SpriteID from the specified object for the bar. +-- +function CustomBar:SetBarSpriteSlot(slot, id) + if slot and id and LevelVars.Engine.CustomBars.bars[self.name] then + LevelVars.Engine.CustomBars.bars[self.name].objectIdBar = slot + LevelVars.Engine.CustomBars.bars[self.name].spriteIdBar = id + end +end +--- +-- Sets the custom bar sprite alignment mode. +-- @tparam View.AlignMode alignMode Alignment for the bar. +-- +function CustomBar:SetBarAlignMode(alignMode) + if alignMode and LevelVars.Engine.CustomBars.bars[self.name] then + LevelVars.Engine.CustomBars.bars[self.name].alignMode = alignMode + end +end +--- +-- Sets the custom bar sprite scale mode. +-- @tparam View.ScaleMode scaleMode Scaling for the bar. +-- +function CustomBar:SetBarScaleMode(scaleMode) + if scaleMode and LevelVars.Engine.CustomBars.bars[self.name] then + LevelVars.Engine.CustomBars.bars[self.name].scaleMode = scaleMode + end +end +--- +-- Sets the custom bar sprite blend mode. +-- @tparam Effects.BlendID blendMode Blending modes for the bar. +-- +function CustomBar:SetBarBlendMode(blendMode) + if blendMode and LevelVars.Engine.CustomBars.bars[self.name] then + LevelVars.Engine.CustomBars.bars[self.name].blendMode = blendMode + end +end + +LevelFuncs.Engine.CustomBar.UpdateCustomBars = function() + + local playerTarget = Lara:GetTarget() + + if playerTarget ~= nil and LevelVars.Engine.CustomBars.enemiesHpBar.status then + local playerTargetName = playerTarget:GetName() + local displayName = LevelFuncs.Engine.Node.SplitString(playerTargetName, "_") + local enemytable = playerTargetName .. "_bar_data" + if LevelVars.Engine.CustomBars.bars[enemytable] == nil then + local eB = LevelVars.Engine.CustomBars.enemiesHpBar + + local enemyBar = { + barName = playerTargetName, + objectIdBg = eB.objectIdBg, + spriteIdBg = eB.spriteIdBg, + colorBg = eB.colorBg, + posBg = eB.posBg, + rotBg = eB.rotBg, + scaleBg = eB.scaleBg, + alignModeBg = eB.alignModeBg, + scaleModeBg = eB.scaleModeBg, + blendModeBg = eB.blendModeBg, + objectIdBar = eB.objectIdBar, + spriteIdBar = eB.spriteIdBar, + colorBar = eB.colorBar, + posBar = eB.posBar, + rot = eB.rot, + scaleBar = eB.scaleBar, + alignMode = eB.alignMode, + scaleMode = eB.scaleMode, + blendMode = eB.blendMode, + text = displayName[1], + textPos = eB.textPos, + textOptions = eB.textOptions, + textScale = eB.textScale, + textColor = eB.textColor, + hideText = eB.hideText, + alphaBlendSpeed = eB.alphaBlendSpeed, + blink = eB.blink, + blinkLimit = eB.blinkLimit, + showBar = false, + object = playerTargetName + } + + CustomBar.CreateEnemyHpBar(enemyBar) + LevelVars.Engine.CustomBars.bars[enemytable].getActionType = 4 + + end + end + + for _, customBar in pairs (LevelVars.Engine.CustomBars.bars) do + + if customBar ~= nil then + -- Smoothly transition to target value + local currentValue = customBar.oldValue or 0 + local targetValue = customBar.targetValue or 0 + local delta = customBar.fixedInterval + + if customBar.object ~=nil and (customBar.getActionType == 0 or customBar.getActionType == 4) then + local enemy = GetMoveableByName(customBar.object) + currentValue = enemy:GetHP() + + targetValue = currentValue + + customBar.progress = math.max(0, math.min(currentValue / customBar.maxValue, 1)) + + if customBar.showBar == true then + -- If showBar is true, the bar is always visible at full alpha + customBar.targetAlpha = 255 + customBar.visible = true + else + -- If showBar is false, only show the bar if the enemy is the player's current target + if playerTarget == enemy then + customBar.targetAlpha = 255 -- Set to full alpha if this enemy is the target + customBar.visible = true + else + customBar.targetAlpha = 0 -- Set to 0 alpha if this enemy is not the target + end + end + + if currentValue <= 0 then + customBar.targetAlpha = 0 + end + + -- When Alpha reaches 0 set visibility to false + if currentValue <= 0 and customBar.currentAlpha == 0 then + customBar.visible = false + LevelVars.Engine.CustomBars.bars[customBar.name] = nil + end + end + + if customBar.getActionType == 1 then + + currentValue = Lara:GetHP() + targetValue = currentValue + + customBar.progress = math.max(0, math.min(currentValue / customBar.maxValue, 1)) + + -- Check if `hideBar` is true, which overrides all other behaviors + if customBar.showBar == true then + customBar.targetAlpha = 255 -- Bar is always visible + customBar.visible = true + + elseif currentValue ~= (customBar.oldValue or currentValue) then + customBar.targetAlpha = 255 -- Show the bar if value changes + customBar.visible = true + + customBar.currentTimer = customBar.currentTimer + 1 + + if customBar.currentTimer >= 90 then + customBar.oldValue = currentValue + customBar.currentTimer = 0 + end + + elseif Lara:GetHandStatus() == 0 and currentValue >= customBar.blinkLimit*1000 then + -- Hide bar if hands are free and HP is 200 or more + customBar.targetAlpha = 0 + customBar.visible = false + + elseif Lara:GetHandStatus() == 2 or Lara:GetHandStatus() == 3 or Lara:GetHandStatus() == 4 then + -- Show bar if hand status is 2, 3, or 4 (weapon drawn) + customBar.targetAlpha = 255 + customBar.visible = true + + elseif Lara:GetHandStatus() == 0 and currentValue < customBar.blinkLimit*1000 then + -- Show bar if hands are free and HP is less than 200 + customBar.targetAlpha = 255 + customBar.visible = true + end + + elseif customBar.getActionType == 2 then + currentValue = Lara:GetAir() + targetValue = currentValue + + customBar.progress = math.max(0, math.min(currentValue / customBar.maxValue, 1)) + + if customBar.showBar == true then + -- If showBar is true, the bar is always visible + customBar.targetAlpha = 255 + customBar.visible = true + else + -- If showBar is false, hide the bar when currentValue is at max + if currentValue == customBar.maxValue then + customBar.targetAlpha = 0 -- Hide the bar when at max value + else + customBar.targetAlpha = 255 -- Show the bar if currentValue is not max + customBar.visible = true + end + end + + elseif customBar.getActionType == 3 then + currentValue = Lara:GetStamina() + targetValue = currentValue + + customBar.progress = math.max(0, math.min(currentValue / customBar.maxValue, 1)) + + if customBar.showBar == true then + -- If showBar is true, the bar is always visible + customBar.targetAlpha = 255 + customBar.visible = true + else + -- If showBar is false, hide the bar when currentValue is at max + if currentValue == customBar.maxValue then + customBar.targetAlpha = 0 -- Hide the bar when at max value + else + customBar.targetAlpha = 255 -- Show the bar if currentValue is not max + customBar.visible = true + end + end + + end + + if currentValue ~= targetValue then + -- Update current value by delta (increment or decrement) + if currentValue < targetValue then + currentValue = math.min(currentValue + delta, targetValue) + else + currentValue = math.max(currentValue + delta, targetValue) + end + + -- Update the bar's progress (0-1 scale) + customBar.oldValue = currentValue + customBar.progress = currentValue / customBar.maxValue + end + -- Smoothly transition alpha + if customBar.currentAlpha ~= customBar.targetAlpha then + local alphaDelta = customBar.alphaBlendSpeed + if customBar.currentAlpha < customBar.targetAlpha then + customBar.currentAlpha = math.floor(math.min(customBar.currentAlpha + alphaDelta, customBar.targetAlpha)) + else + customBar.currentAlpha = math.floor(math.max(customBar.currentAlpha - alphaDelta, customBar.targetAlpha)) + end + end + + -- Set parameters to draw the background + local posBg = customBar.posBg + local scaleBg = customBar.scaleBg + local rotBg = customBar.rotBg + local alignMBg = LevelFuncs.Engine.Node.GetDisplaySpriteAlignMode(customBar.alignModeBg) + local scaleMBg = LevelFuncs.Engine.Node.GetDisplaySpriteScaleMode(customBar.scaleModeBg) + local blendIdBg = LevelFuncs.Engine.Node.GetBlendMode(customBar.blendModeBg) + + -- Adjust color with alpha blending + local bgColor = Color(customBar.colorBg.r,customBar.colorBg.g,customBar.colorBg.b,customBar.currentAlpha) + + -- Set parameters to draw the bar + local pos = customBar.posBar + local rot = customBar.rot + local alignM = LevelFuncs.Engine.Node.GetDisplaySpriteAlignMode(customBar.alignMode) + local scaleM = LevelFuncs.Engine.Node.GetDisplaySpriteScaleMode(customBar.scaleMode) + local blendID = LevelFuncs.Engine.Node.GetBlendMode(customBar.blendMode) + local barColor = TEN.Color(customBar.colorBar.r,customBar.colorBar.g,customBar.colorBar.b,customBar.currentAlpha) + + -- when Alpha reaches 0 set visibility to false + if customBar.currentAlpha > 0 then + customBar.visible = true + elseif customBar.currentAlpha == 0 then + customBar.visible = false + end + + --draw bar if alpha is greater than 1 and visibility is true + if customBar.visible and customBar.currentAlpha > 0 then + -- Draw background sprite + local bgSprite = TEN.DisplaySprite(customBar.objectIdBg, customBar.spriteIdBg, posBg, rotBg, scaleBg, bgColor) + bgSprite:Draw(0, alignMBg, scaleMBg, blendIdBg) + + -- Draw foreground sprite (the bar itself) proportional to Progress + local barScale = TEN.Vec2(customBar.scaleBar.x * customBar.progress, customBar.scaleBar.y) + local barSprite = TEN.DisplaySprite(customBar.objectIdBar, customBar.spriteIdBar, pos, rot, barScale, barColor) + + if customBar.frameCounter == nil then + customBar.frameCounter = 0 + end + + -- Calculate HP percentage + local Percentage = (currentValue / customBar.maxValue) + + -- Update frame counter + customBar.frameCounter = customBar.frameCounter + 1 + + -- Check if blink is enabled and value is below blinkLimit + if customBar.blink == true and Percentage <= customBar.blinkLimit then + -- Only draw the sprite every other frame + if customBar.frameCounter % (customBar.blinkSpeed * 2) < customBar.blinkSpeed then + barSprite:Draw(1, alignM, scaleM, blendID) + end + else + -- Draw the sprite normally if blink is off or value is above blinkLimit + barSprite:Draw(1, alignM, scaleM, blendID) + end + + -- Reset the frame counter if it reaches the blinkSpeed limit to prevent overflow + if customBar.frameCounter >= customBar.blinkSpeed * 2 then + customBar.frameCounter = 0 + end + + if customBar.hideText == false then + -- Draw text (enemy name and health) + local barText = tostring(customBar.text) --debug text .. " (" .. currentHP .. " / " .. totalHP .. ")" + local textColor = TEN.Color(customBar.textColor.r, customBar.textColor.g, customBar.textColor.b, customBar.currentAlpha) + local posInPixel = TEN.Vec2(TEN.Util.PercentToScreen(customBar.textPos.x, customBar.textPos.y)) + local IsString = TEN.Flow.IsStringPresent(barText) + local myText = TEN.Strings.DisplayString(barText, posInPixel, customBar.textScale, textColor, IsString, customBar.textOptions) + TEN.Strings.ShowString(myText, 1/30) + end + end + end + end +end + +TEN.Logic.AddCallback(TEN.Logic.CallbackPoint.PRELOOP, LevelFuncs.Engine.CustomBar.UpdateCustomBars) + +return CustomBar diff --git a/Scripts/Engine/CustomDiary.lua b/Scripts/Engine/CustomDiary.lua index 17ab7b27a..e62e2424d 100644 --- a/Scripts/Engine/CustomDiary.lua +++ b/Scripts/Engine/CustomDiary.lua @@ -1,6 +1,5 @@ ----- ---- Diaries: --- The module provides functions to create and manage Diaries. It maintains diary definitions and entries through all levels and hubs. +-- This module provides functions to create and manage diaries. It maintains diary definitions and entries through all levels and hubs. -- Each diary is accessed by the object that was used to create it. -- -- Example usage: From 9b119d03a236229cd52fd7073bc7a31277fb1fc9 Mon Sep 17 00:00:00 2001 From: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Sun, 9 Mar 2025 00:08:06 -0500 Subject: [PATCH 022/160] TR5 Moving Laser (#1598) * First * First * Finished * Update CHANGELOG.md * Change default speed to 10 * SimplifyLogic * Revert "SimplifyLogic" This reverts commit be0aeefaa4ac6ce2ea8619cd6211c9f2932c2606. * Reapply "SimplifyLogic" This reverts commit c7b8e1442e7647028764c035c99f72271012eca3. * Add moving sound. * Add acceleration * Update tr5_movinglaser.cpp * Fix merge --------- Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com> --- CHANGELOG.md | 6 +- .../Objects/TR5/Trap/tr5_movinglaser.cpp | 134 ++++++++++++++++++ TombEngine/Objects/TR5/Trap/tr5_movinglaser.h | 11 ++ TombEngine/Objects/TR5/tr5_objects.cpp | 10 ++ TombEngine/Objects/game_object_ids.h | 1 + TombEngine/Sound/sound_effects.h | 2 +- TombEngine/TombEngine.vcxproj | 2 + 7 files changed, 163 insertions(+), 3 deletions(-) create mode 100644 TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp create mode 100644 TombEngine/Objects/TR5/Trap/tr5_movinglaser.h diff --git a/CHANGELOG.md b/CHANGELOG.md index a3671788d..89ef4a7aa 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -27,9 +27,11 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): - You must update your Lara object: https://github.com/TombEngine/Resources/raw/main/Wad2%20Objects/Lara/TEN_Lara.wad2 * Added a particle based waterfall emitter object and associated sprite slots. - You must use this version: https://github.com/TombEngine/Resources/raw/refs/heads/main/Wad2%20Objects/Interactables/TEN_Waterfall_Emitter.wad2 -* Added TR4 statue plinth. -* Added TR1 hammer. +* Added TR1 Hammer. - You must use this version: +* Added TR3 Moving Laser. + - You must use this version: +* Added TR4 Statue Plinth. ### Lua API changes diff --git a/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp b/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp new file mode 100644 index 000000000..79d0b7bba --- /dev/null +++ b/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp @@ -0,0 +1,134 @@ +#include "framework.h" +#include "Objects/TR5/Trap/tr5_movinglaser.h" + +#include "Game/animation.h" +#include "Game/collision/collide_item.h" +#include "Game/collision/collide_room.h" +#include "Game/collision/Point.h" +#include "Game/collision/Sphere.h" +#include "Game/control/control.h" +#include "Game/effects/effects.h" +#include "Game/effects/light.h" +#include "Game/items.h" +#include "Game/Lara/lara.h" +#include "Sound/sound.h" +#include "Math/Utils.h" +#include "Specific/level.h" + +using namespace TEN::Collision::Sphere; + +namespace TEN::Entities::Traps +{ + enum MovingLaserFlags + { + Speed, + PauseCounter, + Direction, + DistanceTravelled, + SpeedCalc + }; + + constexpr auto MOVING_LASER_DAMAGE = 100; + constexpr int PAUSE_FRAMES = 30; + constexpr float MAX_SPEED_THRESHOLD = 0.9f; + constexpr float MIN_SPEED = 1.0f; + constexpr float ACCELERATION = 1.0f; + + void InitializeMovingLaser(short itemNumber) + { + auto& item = g_Level.Items[itemNumber]; + item.ItemFlags[MovingLaserFlags::Direction] = 1; + item.ItemFlags[MovingLaserFlags::Speed] = 10; + item.Pose.Translate(item.Pose.Orientation, -CLICK(1)); // Offset by one click to make it dangerous at the edges of the block. + } + + void ControlMovingLaser(short itemNumber) + { + auto& item = g_Level.Items[itemNumber]; + + if (!TriggerActive(&item)) + return; + + float moveDistance = (BLOCK(1) * item.TriggerFlags) + CLICK(2); // Use OCB to calculate the distance and add 2 clicks. + + float distancePerFrame = ((float)(CLICK(1)) * item.ItemFlags[MovingLaserFlags::Speed]) / FPS; // Calculate distance per frame + + item.Animation.ActiveState = 0; + SpawnDynamicLight(item.Pose.Position.x, item.Pose.Position.y - 64, item.Pose.Position.z, (Random::GenerateInt() % 2) + 8, (Random::GenerateInt() % 4) + 24, Random::GenerateInt() % 4, Random::GenerateInt() % 2); + item.MeshBits = -1 - (GetRandomControl() & 0x14); // To make lasers flicker + + if (item.TriggerFlags == 0) + { + AnimateItem(&item); + return; + } + + if (item.ItemFlags[MovingLaserFlags::PauseCounter] > 0) + { + item.ItemFlags[MovingLaserFlags::PauseCounter]--; + + if (item.ItemFlags[MovingLaserFlags::PauseCounter] == 0) + { + item.ItemFlags[MovingLaserFlags::Direction] *= -1; + item.ItemFlags[MovingLaserFlags::DistanceTravelled] = 0; + } + + AnimateItem(&item); + return; + } + + item.Pose.Translate(item.Pose.Orientation, (item.ItemFlags[MovingLaserFlags::Direction] * item.ItemFlags[MovingLaserFlags::SpeedCalc])); + + item.ItemFlags[MovingLaserFlags::DistanceTravelled] += item.ItemFlags[MovingLaserFlags::SpeedCalc]; + + if (item.ItemFlags[DistanceTravelled] < (moveDistance -BLOCK(0.5f))) + item.ItemFlags[SpeedCalc] = std::min(distancePerFrame, item.ItemFlags[MovingLaserFlags::SpeedCalc] + ACCELERATION); + else + item.ItemFlags[SpeedCalc] = std::max(MIN_SPEED, item.ItemFlags[MovingLaserFlags::SpeedCalc] - ACCELERATION); + + + if (item.ItemFlags[MovingLaserFlags::DistanceTravelled] >= moveDistance) + { + item.ItemFlags[MovingLaserFlags::PauseCounter] = PAUSE_FRAMES; + } + + if (item.ItemFlags[MovingLaserFlags::PauseCounter] == 0) + { + SoundEffect(SFX_TR5_MOVING_LASER_LOOP, &item.Pose, SoundEnvironment::Always); + } + + // Update room if necessary. + short new_room = item.RoomNumber; + GetPointCollision(item).GetRoomNumber(); + if (new_room != item.RoomNumber) + ItemNewRoom(itemNumber, new_room); + + AnimateItem(&item); + } + + void CollideMovingLaser(short itemNumber, ItemInfo* playerItem, CollisionInfo* coll) + { + auto& item = g_Level.Items[itemNumber]; + + // Collide with objects. + if (item.Status == ITEM_ACTIVE) + { + if (!TestBoundsCollide(&item, playerItem, coll->Setup.Radius)) + return; + + HandleItemSphereCollision(item, *playerItem); + } + else if (item.Status != ITEM_INVISIBLE) + { + ObjectCollision(itemNumber, playerItem, coll); + } + + // Damage entity. + if (TestBoundsCollide(&item, playerItem, coll->Setup.Radius)) + { + DoDamage(playerItem, MOVING_LASER_DAMAGE); + DoLotsOfBlood(playerItem->Pose.Position.x, playerItem->Pose.Position.y + CLICK(3), playerItem->Pose.Position.z, 4, playerItem->Pose.Orientation.y, playerItem->RoomNumber, 3); + playerItem->TouchBits.ClearAll(); + } + } +} diff --git a/TombEngine/Objects/TR5/Trap/tr5_movinglaser.h b/TombEngine/Objects/TR5/Trap/tr5_movinglaser.h new file mode 100644 index 000000000..5884c63cf --- /dev/null +++ b/TombEngine/Objects/TR5/Trap/tr5_movinglaser.h @@ -0,0 +1,11 @@ +#pragma once + +struct CollisionInfo; +struct ItemInfo; + +namespace TEN::Entities::Traps +{ + void InitializeMovingLaser(short itemNumber); + void ControlMovingLaser(short itemNumber); + void CollideMovingLaser(short itemNumber, ItemInfo* item, CollisionInfo* coll); +} diff --git a/TombEngine/Objects/TR5/tr5_objects.cpp b/TombEngine/Objects/TR5/tr5_objects.cpp index 794f4da20..05921eb01 100644 --- a/TombEngine/Objects/TR5/tr5_objects.cpp +++ b/TombEngine/Objects/TR5/tr5_objects.cpp @@ -65,6 +65,7 @@ #include "Objects/TR5/Trap/tr5_ventilator.h" #include "Objects/TR5/Trap/tr5_romehammer.h" #include "Objects/TR5/Trap/tr5_fallingceiling.h" +#include "Objects/TR5/Trap/tr5_movinglaser.h" #include "Objects/TR5/Trap/tr5_explosion.h" #include "Objects/TR5/Trap/tr5_wreckingball.h" @@ -963,6 +964,15 @@ static void StartTrap(ObjectInfo *obj) obj->drawRoutine = nullptr; obj->usingDrawAnimatingItem = false; } + + obj = &Objects[ID_MOVING_LASER]; + if (obj->loaded) + { + obj->Initialize = InitializeMovingLaser; + obj->control = ControlMovingLaser; + obj->collision = CollideMovingLaser; + obj->SetHitEffect(true); + } } static void StartSwitch(ObjectInfo *obj) diff --git a/TombEngine/Objects/game_object_ids.h b/TombEngine/Objects/game_object_ids.h index f05e14200..226f5c317 100644 --- a/TombEngine/Objects/game_object_ids.h +++ b/TombEngine/Objects/game_object_ids.h @@ -373,6 +373,7 @@ enum GAME_OBJECT_ID : short ID_ELECTRIC_BALL_IMPACT_POINT, ID_HAMMER_HANDLE, ID_HAMMER_HEAD, + ID_MOVING_LASER, ID_PUZZLE_ITEM1 = 500, ID_PUZZLE_ITEM2, diff --git a/TombEngine/Sound/sound_effects.h b/TombEngine/Sound/sound_effects.h index 37b3d2ae2..1268c5f89 100644 --- a/TombEngine/Sound/sound_effects.h +++ b/TombEngine/Sound/sound_effects.h @@ -1163,7 +1163,7 @@ enum SOUND_EFFECTS SFX_TR1_SLAMDOOR_CLOSE = 1144, SFX_TR2_DRAGON_FALL = 1145, SFX_TR2_MARCO_BARTOLLI_TRANSFORM = 1146, - + SFX_TR5_MOVING_LASER_LOOP = 1147, // TombEngine sounds SFX_TEN_CUSTOM_FOOTSTEPS_1 = 1150, diff --git a/TombEngine/TombEngine.vcxproj b/TombEngine/TombEngine.vcxproj index 0cf2b10f2..0fe4faed2 100644 --- a/TombEngine/TombEngine.vcxproj +++ b/TombEngine/TombEngine.vcxproj @@ -786,6 +786,7 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. + @@ -1311,6 +1312,7 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. + From e85a1e63d1966e226379ea5230f0785b688230c3 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 9 Mar 2025 06:22:08 +0100 Subject: [PATCH 023/160] Fixed sound IDs --- TombEngine/Objects/TR2/Entity/Bartoli.cpp | 6 +++--- TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp | 2 +- TombEngine/Sound/sound_effects.h | 7 ++++--- 3 files changed, 8 insertions(+), 7 deletions(-) diff --git a/TombEngine/Objects/TR2/Entity/Bartoli.cpp b/TombEngine/Objects/TR2/Entity/Bartoli.cpp index be31d6b96..e7c6237d4 100644 --- a/TombEngine/Objects/TR2/Entity/Bartoli.cpp +++ b/TombEngine/Objects/TR2/Entity/Bartoli.cpp @@ -81,21 +81,21 @@ namespace TEN::Entities::Creatures::TR2 { SpawnDynamicPointLight(lightPos, lightColor, Random::GenerateFloat(BLOCK(12), BLOCK(24))); SpawnBartoliTransformEffect(item, ID_SPHERE_OF_DOOM); - SoundEffect(SFX_TR2_MARCO_BARTOLLI_TRANSFORM, &item.Pose); + SoundEffect(SFX_TR2_MARCO_BARTOLI_TRANSFORM, &item.Pose); } if (effectTimer == timeExplosion2) { SpawnDynamicPointLight(lightPos, lightColor, Random::GenerateFloat(BLOCK(12), BLOCK(24))); SpawnBartoliTransformEffect(item, ID_SPHERE_OF_DOOM2); - SoundEffect(SFX_TR2_MARCO_BARTOLLI_TRANSFORM, &item.Pose); + SoundEffect(SFX_TR2_MARCO_BARTOLI_TRANSFORM, &item.Pose); } if (effectTimer == timeExplosion3) { SpawnDynamicPointLight(lightPos, lightColor, Random::GenerateFloat(BLOCK(12), BLOCK(24))); SpawnBartoliTransformEffect(item, ID_SPHERE_OF_DOOM3); - SoundEffect(SFX_TR2_MARCO_BARTOLLI_TRANSFORM, &item.Pose); + SoundEffect(SFX_TR2_MARCO_BARTOLI_TRANSFORM, &item.Pose); item.Animation.FrameNumber = animationFrameEnd; } diff --git a/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp b/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp index 79d0b7bba..bd46be523 100644 --- a/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp +++ b/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp @@ -94,7 +94,7 @@ namespace TEN::Entities::Traps if (item.ItemFlags[MovingLaserFlags::PauseCounter] == 0) { - SoundEffect(SFX_TR5_MOVING_LASER_LOOP, &item.Pose, SoundEnvironment::Always); + SoundEffect(SFX_TEN_MOVING_LASER_LOOP, &item.Pose, SoundEnvironment::Always); } // Update room if necessary. diff --git a/TombEngine/Sound/sound_effects.h b/TombEngine/Sound/sound_effects.h index 1268c5f89..b06249ade 100644 --- a/TombEngine/Sound/sound_effects.h +++ b/TombEngine/Sound/sound_effects.h @@ -1162,8 +1162,8 @@ enum SOUND_EFFECTS SFX_TR1_SLAMDOOR_OPEN = 1143, SFX_TR1_SLAMDOOR_CLOSE = 1144, SFX_TR2_DRAGON_FALL = 1145, - SFX_TR2_MARCO_BARTOLLI_TRANSFORM = 1146, - SFX_TR5_MOVING_LASER_LOOP = 1147, + SFX_TR2_MARCO_BARTOLI_TRANSFORM = 1146, + // TombEngine sounds SFX_TEN_CUSTOM_FOOTSTEPS_1 = 1150, @@ -1217,8 +1217,9 @@ enum SOUND_EFFECTS // New sounds SFX_TEN_STEAM_EMITTER_LOOP = 1194, + SFX_TEN_MOVING_LASER_LOOP = 1195, - // Custom sounds from 1195 onward + // Custom sounds from 1196 onward NUM_SFX }; From 45a58d4e5b24131cb26be416ff7a555d33ea1e9d Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 9 Mar 2025 06:27:32 +0100 Subject: [PATCH 024/160] Fix sound IDs --- .../Objects/TR5/Emitter/tr5_smoke_emitter.cpp | 2 +- TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp | 2 +- TombEngine/Sound/sound_effects.h | 16 +++++++++------- 3 files changed, 11 insertions(+), 9 deletions(-) diff --git a/TombEngine/Objects/TR5/Emitter/tr5_smoke_emitter.cpp b/TombEngine/Objects/TR5/Emitter/tr5_smoke_emitter.cpp index 2febc14b8..83a8d0143 100644 --- a/TombEngine/Objects/TR5/Emitter/tr5_smoke_emitter.cpp +++ b/TombEngine/Objects/TR5/Emitter/tr5_smoke_emitter.cpp @@ -384,7 +384,7 @@ namespace TEN::Effects::SmokeEmitter steamPauseTimer = item.TriggerFlags >> 4; } - SoundEffect(SFX_TEN_STEAM_EMITTER_LOOP, &item.Pose); + SoundEffect(SFX_TR4_STEAM_EMITTER_LOOP, &item.Pose); } if (!drawNormalSmoke) diff --git a/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp b/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp index bd46be523..79d0b7bba 100644 --- a/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp +++ b/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp @@ -94,7 +94,7 @@ namespace TEN::Entities::Traps if (item.ItemFlags[MovingLaserFlags::PauseCounter] == 0) { - SoundEffect(SFX_TEN_MOVING_LASER_LOOP, &item.Pose, SoundEnvironment::Always); + SoundEffect(SFX_TR5_MOVING_LASER_LOOP, &item.Pose, SoundEnvironment::Always); } // Update room if necessary. diff --git a/TombEngine/Sound/sound_effects.h b/TombEngine/Sound/sound_effects.h index b06249ade..f252bdd92 100644 --- a/TombEngine/Sound/sound_effects.h +++ b/TombEngine/Sound/sound_effects.h @@ -1159,10 +1159,6 @@ enum SOUND_EFFECTS SFX_TR5_LOW_RUMBLE = 1140, SFX_TR5_FLOOR_METAL_OPEN = 1141, SFX_TR5_AIRCON_LOOP = 1142, - SFX_TR1_SLAMDOOR_OPEN = 1143, - SFX_TR1_SLAMDOOR_CLOSE = 1144, - SFX_TR2_DRAGON_FALL = 1145, - SFX_TR2_MARCO_BARTOLI_TRANSFORM = 1146, // TombEngine sounds @@ -1214,10 +1210,16 @@ enum SOUND_EFFECTS SFX_TEN_PUSHABLES_STOP_CONCRETE = 1192, SFX_TEN_PUSHABLES_COLLIDE_CONCRETE = 1193, - // New sounds + // Additional version-specific sounds - SFX_TEN_STEAM_EMITTER_LOOP = 1194, - SFX_TEN_MOVING_LASER_LOOP = 1195, + SFX_TR1_SLAMDOOR_OPEN = 1143, + SFX_TR1_SLAMDOOR_CLOSE = 1144, + SFX_TR2_DRAGON_FALL = 1145, + SFX_TR2_MARCO_BARTOLI_TRANSFORM = 1146, + SFX_TR4_STEAM_EMITTER_LOOP = 1194, + SFX_TR5_MOVING_LASER_LOOP = 1195, + + // New sounds // Custom sounds from 1196 onward From 3acb07fe5349f8e6e5744bdacb36115f9f579e1b Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 9 Mar 2025 06:51:19 +0100 Subject: [PATCH 025/160] Fix sound IDs again --- CHANGELOG.md | 1 - TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp | 2 +- TombEngine/Sound/sound_effects.h | 1 - 3 files changed, 1 insertion(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 89ef4a7aa..3dcc0cc5b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -30,7 +30,6 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added TR1 Hammer. - You must use this version: * Added TR3 Moving Laser. - - You must use this version: * Added TR4 Statue Plinth. ### Lua API changes diff --git a/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp b/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp index 79d0b7bba..ac48c8343 100644 --- a/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp +++ b/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp @@ -94,7 +94,7 @@ namespace TEN::Entities::Traps if (item.ItemFlags[MovingLaserFlags::PauseCounter] == 0) { - SoundEffect(SFX_TR5_MOVING_LASER_LOOP, &item.Pose, SoundEnvironment::Always); + SoundEffect(SFX_TR3_LASER_LOOP, &item.Pose, SoundEnvironment::Always); } // Update room if necessary. diff --git a/TombEngine/Sound/sound_effects.h b/TombEngine/Sound/sound_effects.h index f252bdd92..303733282 100644 --- a/TombEngine/Sound/sound_effects.h +++ b/TombEngine/Sound/sound_effects.h @@ -1217,7 +1217,6 @@ enum SOUND_EFFECTS SFX_TR2_DRAGON_FALL = 1145, SFX_TR2_MARCO_BARTOLI_TRANSFORM = 1146, SFX_TR4_STEAM_EMITTER_LOOP = 1194, - SFX_TR5_MOVING_LASER_LOOP = 1195, // New sounds From 019dccae5723f034c2152c13005ab07d639be318 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 9 Mar 2025 08:24:48 +0100 Subject: [PATCH 026/160] Fixed slot problems --- TombEngine/Objects/TR1/Trap/ThorHammer.cpp | 2 +- TombEngine/Objects/TR1/tr1_objects.cpp | 8 ++++---- TombEngine/Objects/TR2/tr2_objects.cpp | 14 +++++++------- TombEngine/Objects/game_object_ids.h | 4 ++-- 4 files changed, 14 insertions(+), 14 deletions(-) diff --git a/TombEngine/Objects/TR1/Trap/ThorHammer.cpp b/TombEngine/Objects/TR1/Trap/ThorHammer.cpp index 4c7c0221a..ba468670a 100644 --- a/TombEngine/Objects/TR1/Trap/ThorHammer.cpp +++ b/TombEngine/Objects/TR1/Trap/ThorHammer.cpp @@ -48,7 +48,7 @@ namespace TEN::Entities::Traps { auto& headItem = g_Level.Items[itemNumber]; - int handleItemNumber = SpawnItem(headItem, ID_HAMMER_HEAD); + int handleItemNumber = SpawnItem(headItem, ID_THOR_HAMMER_HEAD); if (handleItemNumber == NO_VALUE) { TENLog("Failed to create hammer handle moveable.", LogLevel::Warning); diff --git a/TombEngine/Objects/TR1/tr1_objects.cpp b/TombEngine/Objects/TR1/tr1_objects.cpp index dcfeb4a6c..c611a171b 100644 --- a/TombEngine/Objects/TR1/tr1_objects.cpp +++ b/TombEngine/Objects/TR1/tr1_objects.cpp @@ -252,10 +252,10 @@ static void StartTrap(ObjectInfo* obj) obj->SetHitEffect(true); } - obj = &Objects[ID_HAMMER_HANDLE]; + obj = &Objects[ID_THOR_HAMMER_HANDLE]; if (obj->loaded) { - CheckIfSlotExists(ID_HAMMER_HEAD, "ID_HAMMER_HEAD"); + CheckIfSlotExists(ID_THOR_HAMMER_HEAD, "Thor hammer"); obj->Initialize = InitializeThorHammer; obj->collision = CollideThorHammerHandle; obj->control = ControlThorHammer; @@ -263,10 +263,10 @@ static void StartTrap(ObjectInfo* obj) obj->SetHitEffect(true); } - obj = &Objects[ID_HAMMER_HEAD]; + obj = &Objects[ID_THOR_HAMMER_HEAD]; if (obj->loaded) { - CheckIfSlotExists(ID_HAMMER_HANDLE, "ID_HAMMER_HANDLE"); + CheckIfSlotExists(ID_THOR_HAMMER_HANDLE, "Thor hammer"); obj->collision = CollideThorHammer; obj->shadowType = ShadowMode::All; obj->SetHitEffect(true); diff --git a/TombEngine/Objects/TR2/tr2_objects.cpp b/TombEngine/Objects/TR2/tr2_objects.cpp index 308bfb5ee..1be6656b1 100644 --- a/TombEngine/Objects/TR2/tr2_objects.cpp +++ b/TombEngine/Objects/TR2/tr2_objects.cpp @@ -432,7 +432,7 @@ static void StartEntity(ObjectInfo* obj) obj = &Objects[ID_DRAGON_FRONT]; if (obj->loaded) { - CheckIfSlotExists(ID_DRAGON_BACK, "ID_DRAGON_BACK"); + CheckIfSlotExists(ID_DRAGON_BACK, "Dragon"); obj->Initialize = InitializeDragon; obj->collision = CollideDragonFront; obj->control = ControlDragon; @@ -449,9 +449,9 @@ static void StartEntity(ObjectInfo* obj) obj = &Objects[ID_DRAGON_BACK]; if (obj->loaded) { - CheckIfSlotExists(ID_DRAGON_FRONT, "ID_DRAGON_FRONT"); - CheckIfSlotExists(ID_DRAGON_BONE_FRONT, "ID_DRAGON_BONE_FRONT"); - CheckIfSlotExists(ID_DRAGON_BONE_BACK, "ID_DRAGON_BONE_BACK"); + CheckIfSlotExists(ID_DRAGON_FRONT, "Dragon"); + CheckIfSlotExists(ID_DRAGON_BONE_FRONT, "Dragon"); + CheckIfSlotExists(ID_DRAGON_BONE_BACK, "Dragon"); obj->collision = CollideDragonBack; obj->SetHitEffect(false, true); obj->shadowType = ShadowMode::All; @@ -472,9 +472,9 @@ static void StartEntity(ObjectInfo* obj) obj = &Objects[ID_MARCO_BARTOLI]; if (obj->loaded) { - CheckIfSlotExists(ID_SPHERE_OF_DOOM, "ID_SPHERE_OF_DOOM"); - CheckIfSlotExists(ID_SPHERE_OF_DOOM2, "ID_SPHERE_OF_DOOM2"); - CheckIfSlotExists(ID_SPHERE_OF_DOOM3, "ID_SPHERE_OF_DOOM3"); + CheckIfSlotExists(ID_SPHERE_OF_DOOM, "Marco Bartoli"); + CheckIfSlotExists(ID_SPHERE_OF_DOOM2, "Marco Bartoli"); + CheckIfSlotExists(ID_SPHERE_OF_DOOM3, "Marco Bartoli"); obj->Initialize = InitializeBartoli; obj->control = ControlBartoli; } diff --git a/TombEngine/Objects/game_object_ids.h b/TombEngine/Objects/game_object_ids.h index 226f5c317..ab81af1db 100644 --- a/TombEngine/Objects/game_object_ids.h +++ b/TombEngine/Objects/game_object_ids.h @@ -371,8 +371,8 @@ enum GAME_OBJECT_ID : short ID_SWINGING_BLADE, ID_ELECTRIC_BALL, ID_ELECTRIC_BALL_IMPACT_POINT, - ID_HAMMER_HANDLE, - ID_HAMMER_HEAD, + ID_THOR_HAMMER_HANDLE, + ID_THOR_HAMMER_HEAD, ID_MOVING_LASER, ID_PUZZLE_ITEM1 = 500, From 248fb114525a744b699798244784bfcd64067b20 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 9 Mar 2025 08:31:35 +0100 Subject: [PATCH 027/160] Fixed backwards alpha color conversion --- TombEngine/Specific/RGBAColor8Byte.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TombEngine/Specific/RGBAColor8Byte.cpp b/TombEngine/Specific/RGBAColor8Byte.cpp index 7ee99ead7..858b93a48 100644 --- a/TombEngine/Specific/RGBAColor8Byte.cpp +++ b/TombEngine/Specific/RGBAColor8Byte.cpp @@ -51,7 +51,7 @@ RGBAColor8Byte::RGBAColor8Byte(const Vector4& color) r = FloatComponentToByte(color.x); g = FloatComponentToByte(color.y); b = FloatComponentToByte(color.z); - a = FloatComponentToByte(color.w); + a = FloatComponentToByte(color.w * 2); } byte RGBAColor8Byte::GetR() const From 39a23fb7553c497d1a54c9142181767aea18c2e8 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 9 Mar 2025 09:00:00 +0100 Subject: [PATCH 028/160] Update ObjectIDs.h --- TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h b/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h index dbd5816ce..eeeb8e7fa 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h +++ b/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h @@ -372,6 +372,11 @@ The following constants are inside ObjID. ELECTRIC_CLEANER SLAMMING_DOORS SWINGING_BLADE + ELECTRIC_BALL + ELECTRIC_BALL_IMPACT_POINT + THOR_HAMMER_HANDLE + THOR_HAMMER_HEAD + MOVING_LASER PUZZLE_ITEM1 PUZZLE_ITEM2 PUZZLE_ITEM3 @@ -807,6 +812,7 @@ The following constants are inside ObjID. DOPPELGANGER_ORIGIN CORPSE WRAITH_TRAP + WATERFALL_EMITTER MESHSWAP1 MESHSWAP2 MESHSWAP3 @@ -1558,6 +1564,9 @@ static const auto GAME_OBJECT_IDS = std::unordered_map Date: Sun, 9 Mar 2025 19:07:28 +0100 Subject: [PATCH 029/160] Added pickups count to Flow.Statistics class --- CHANGELOG.md | 1 + .../doc/2 classes/Flow.Statistics.html | 25 +++++++++++++++++++ TombEngine/Game/pickup/pickup.cpp | 6 +++++ TombEngine/Game/savegame.cpp | 4 +++ .../TEN/Flow/Statistics/Statistics.cpp | 5 ++++ .../Internal/TEN/Flow/Statistics/Statistics.h | 1 + .../flatbuffers/ten_savegame_generated.h | 18 +++++++++++-- .../Specific/savegame/schema/ten_savegame.fbs | 1 + 8 files changed, 59 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3dcc0cc5b..49b577777 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -47,6 +47,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added various Translate() methods to Vec2 and Vec3 script objects. * Added alpha transparency functionality for statics and moveables to be used with SetColor() method. * Added extra arguments for sprite object slots and starting rotation value for EmitParticle function. +* Added pickups count to Flow.Statistics class. * Added ability to save Flow.Level fields such as fog or horizon to a savegame. ## [Version 1.7.1](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.7.4) - 2025-04-01 diff --git a/Documentation/doc/2 classes/Flow.Statistics.html b/Documentation/doc/2 classes/Flow.Statistics.html index 2f16e90a9..030cb81b1 100644 --- a/Documentation/doc/2 classes/Flow.Statistics.html +++ b/Documentation/doc/2 classes/Flow.Statistics.html @@ -146,6 +146,10 @@ + + + + @@ -287,6 +291,27 @@ + +
                                                                      + + pickups +
                                                                      +
                                                                      + Pickups. + + + +
                                                                        +
                                                                      • pickups + int + amount of picked up items. +
                                                                        • +
                                                                      + + + + +
                                                                      diff --git a/TombEngine/Game/pickup/pickup.cpp b/TombEngine/Game/pickup/pickup.cpp index f9e5cf5c2..3059baac0 100644 --- a/TombEngine/Game/pickup/pickup.cpp +++ b/TombEngine/Game/pickup/pickup.cpp @@ -22,6 +22,7 @@ #include "Game/pickup/pickup_misc_items.h" #include "Game/pickup/pickup_weapon.h" #include "Game/room.h" +#include "Game/savegame.h" #include "Game/Setup.h" #include "Math/Math.h" #include "Objects/Generic/Object/burning_torch.h" @@ -158,6 +159,11 @@ void PickedUpObject(GAME_OBJECT_ID objectID, std::optional count) { // Item isn't any of the above; do nothing. } + else + { + SaveGame::Statistics.Level.Pickups++; + SaveGame::Statistics.Game.Pickups++; + } } void PickedUpObject(ItemInfo& item) diff --git a/TombEngine/Game/savegame.cpp b/TombEngine/Game/savegame.cpp index b98d05f69..a029164dc 100644 --- a/TombEngine/Game/savegame.cpp +++ b/TombEngine/Game/savegame.cpp @@ -274,6 +274,7 @@ const std::vector SaveGame::Build() sgLevelStatisticsBuilder.add_medipacks_used(Statistics.Level.HealthUsed); sgLevelStatisticsBuilder.add_damage_taken(Statistics.Level.DamageTaken); sgLevelStatisticsBuilder.add_distance(Statistics.Level.Distance); + sgLevelStatisticsBuilder.add_pickups(Statistics.Level.Pickups); sgLevelStatisticsBuilder.add_secrets(Statistics.Level.Secrets); sgLevelStatisticsBuilder.add_timer(SaveGame::Statistics.Level.TimeTaken); auto levelStatisticsOffset = sgLevelStatisticsBuilder.Finish(); @@ -285,6 +286,7 @@ const std::vector SaveGame::Build() sgGameStatisticsBuilder.add_medipacks_used(Statistics.Game.HealthUsed); sgGameStatisticsBuilder.add_damage_taken(Statistics.Game.DamageTaken); sgGameStatisticsBuilder.add_distance(Statistics.Game.Distance); + sgGameStatisticsBuilder.add_pickups(Statistics.Game.Pickups); sgGameStatisticsBuilder.add_secrets(Statistics.Game.Secrets); sgGameStatisticsBuilder.add_timer(SaveGame::Statistics.Game.TimeTaken); auto gameStatisticsOffset = sgGameStatisticsBuilder.Finish(); @@ -1771,6 +1773,7 @@ static void ParseStatistics(const Save::SaveGame* s, bool isHub) SaveGame::Statistics.Level.HealthUsed = s->level()->medipacks_used(); SaveGame::Statistics.Level.DamageTaken = s->level()->damage_taken(); SaveGame::Statistics.Level.Kills = s->level()->kills(); + SaveGame::Statistics.Level.Pickups = s->level()->pickups(); SaveGame::Statistics.Level.Secrets = s->level()->secrets(); SaveGame::Statistics.Level.TimeTaken = s->level()->timer(); @@ -1784,6 +1787,7 @@ static void ParseStatistics(const Save::SaveGame* s, bool isHub) SaveGame::Statistics.Game.HealthUsed = s->game()->medipacks_used(); SaveGame::Statistics.Game.DamageTaken = s->game()->damage_taken(); SaveGame::Statistics.Game.Kills = s->game()->kills(); + SaveGame::Statistics.Game.Pickups = s->game()->pickups(); SaveGame::Statistics.Game.Secrets = s->game()->secrets(); SaveGame::Statistics.Game.TimeTaken = s->game()->timer(); } diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Statistics/Statistics.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Statistics/Statistics.cpp index d84b3bec4..1dc5cbf69 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Statistics/Statistics.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Statistics/Statistics.cpp @@ -50,6 +50,11 @@ namespace TEN::Scripting */ "kills", &Statistics::Kills, + /*** Pickups. + @tfield int pickups amount of picked up items. + */ + "pickups", &Statistics::Pickups, + /*** Secrets. @tfield int secrets amount of found secrets. */ diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Statistics/Statistics.h b/TombEngine/Scripting/Internal/TEN/Flow/Statistics/Statistics.h index 46ce309c2..b289a2849 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Statistics/Statistics.h +++ b/TombEngine/Scripting/Internal/TEN/Flow/Statistics/Statistics.h @@ -15,6 +15,7 @@ namespace TEN::Scripting unsigned int HealthUsed = 0; unsigned int DamageTaken = 0; unsigned int Kills = 0; + unsigned int Pickups = 0; unsigned int Secrets = 0; static void Register(sol::table&); diff --git a/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h b/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h index 708c6ba43..902c1d7b1 100644 --- a/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h +++ b/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h @@ -7858,6 +7858,7 @@ struct SaveGameStatisticsT : public flatbuffers::NativeTable { int32_t damage_taken = 0; int32_t distance = 0; int32_t kills = 0; + int32_t pickups = 0; int32_t secrets = 0; int32_t timer = 0; }; @@ -7873,8 +7874,9 @@ struct SaveGameStatistics FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { VT_DAMAGE_TAKEN = 10, VT_DISTANCE = 12, VT_KILLS = 14, - VT_SECRETS = 16, - VT_TIMER = 18 + VT_PICKUPS = 16, + VT_SECRETS = 18, + VT_TIMER = 20 }; int32_t ammo_hits() const { return GetField(VT_AMMO_HITS, 0); @@ -7894,6 +7896,9 @@ struct SaveGameStatistics FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { int32_t kills() const { return GetField(VT_KILLS, 0); } + int32_t pickups() const { + return GetField(VT_PICKUPS, 0); + } int32_t secrets() const { return GetField(VT_SECRETS, 0); } @@ -7908,6 +7913,7 @@ struct SaveGameStatistics FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { VerifyField(verifier, VT_DAMAGE_TAKEN) && VerifyField(verifier, VT_DISTANCE) && VerifyField(verifier, VT_KILLS) && + VerifyField(verifier, VT_PICKUPS) && VerifyField(verifier, VT_SECRETS) && VerifyField(verifier, VT_TIMER) && verifier.EndTable(); @@ -7939,6 +7945,9 @@ struct SaveGameStatisticsBuilder { void add_kills(int32_t kills) { fbb_.AddElement(SaveGameStatistics::VT_KILLS, kills, 0); } + void add_pickups(int32_t pickups) { + fbb_.AddElement(SaveGameStatistics::VT_PICKUPS, pickups, 0); + } void add_secrets(int32_t secrets) { fbb_.AddElement(SaveGameStatistics::VT_SECRETS, secrets, 0); } @@ -7964,11 +7973,13 @@ inline flatbuffers::Offset CreateSaveGameStatistics( int32_t damage_taken = 0, int32_t distance = 0, int32_t kills = 0, + int32_t pickups = 0, int32_t secrets = 0, int32_t timer = 0) { SaveGameStatisticsBuilder builder_(_fbb); builder_.add_timer(timer); builder_.add_secrets(secrets); + builder_.add_pickups(pickups); builder_.add_kills(kills); builder_.add_distance(distance); builder_.add_damage_taken(damage_taken); @@ -11269,6 +11280,7 @@ inline void SaveGameStatistics::UnPackTo(SaveGameStatisticsT *_o, const flatbuff { auto _e = damage_taken(); _o->damage_taken = _e; } { auto _e = distance(); _o->distance = _e; } { auto _e = kills(); _o->kills = _e; } + { auto _e = pickups(); _o->pickups = _e; } { auto _e = secrets(); _o->secrets = _e; } { auto _e = timer(); _o->timer = _e; } } @@ -11287,6 +11299,7 @@ inline flatbuffers::Offset CreateSaveGameStatistics(flatbuff auto _damage_taken = _o->damage_taken; auto _distance = _o->distance; auto _kills = _o->kills; + auto _pickups = _o->pickups; auto _secrets = _o->secrets; auto _timer = _o->timer; return TEN::Save::CreateSaveGameStatistics( @@ -11297,6 +11310,7 @@ inline flatbuffers::Offset CreateSaveGameStatistics(flatbuff _damage_taken, _distance, _kills, + _pickups, _secrets, _timer); } diff --git a/TombEngine/Specific/savegame/schema/ten_savegame.fbs b/TombEngine/Specific/savegame/schema/ten_savegame.fbs index f887b9561..4b239e19a 100644 --- a/TombEngine/Specific/savegame/schema/ten_savegame.fbs +++ b/TombEngine/Specific/savegame/schema/ten_savegame.fbs @@ -584,6 +584,7 @@ table SaveGameStatistics { damage_taken: int32; distance: int32; kills: int32; + pickups: int32; secrets: int32; timer: int32; } From f87d592ce645c77ba540b0fffee32c5897a499ac Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 9 Mar 2025 19:14:39 +0100 Subject: [PATCH 030/160] Added Flow.GetTotalSecretCount() --- CHANGELOG.md | 1 + Documentation/doc/1 modules/Flow.html | 41 +++++++++++++++---- .../Scripting/Internal/ReservedScriptNames.h | 1 + .../Internal/TEN/Flow/FlowHandler.cpp | 17 ++++++-- .../Scripting/Internal/TEN/Flow/FlowHandler.h | 1 + 5 files changed, 50 insertions(+), 11 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 49b577777..259eb2fd3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -39,6 +39,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added diary module. * Added custom bar module. * Added Flow.Horizon class with and use two layers of horizons in a Flow.Level class. +* Added Flow.GetTotalSecretCount() function to get total amount of secrets in the game. * Added View.GetFlyByPosition() and View.GetFlyByRotation() functions to get flyby sequence parameters at a specified time point. * Added Effects.EmitAirBubble() function to spawn air bubbles. * Added Effects.EmitStreamer() function to emit streamers. diff --git a/Documentation/doc/1 modules/Flow.html b/Documentation/doc/1 modules/Flow.html index 87f02974d..4d7ffc676 100644 --- a/Documentation/doc/1 modules/Flow.html +++ b/Documentation/doc/1 modules/Flow.html @@ -227,8 +227,12 @@ scripts too.

                                                                      - - + + + + + + @@ -876,20 +880,41 @@ The index argument corresponds to the secret's unique ID, the same that would go
                                                                      - - SetTotalSecretCount(total) + + GetTotalSecretCount()
                                                                      - Total number of secrets in game. + Get total number of secrets in the game. + + + + +

                                                                      Returns:

                                                                      +
                                                                        + + int + Total number of secrets in the game. +
                                                                      + + + + +
                                                                      +
                                                                      + + SetTotalSecretCount(count) +
                                                                      +
                                                                      + Set total number of secrets in the game. Must be an integer value (0 means no secrets).

                                                                      Parameters:

                                                                        -
                                                                      • total +
                                                                      • count int - number of secrets + Total number of secrets in the game.
                                                                      @@ -911,7 +936,7 @@ Must be an integer value (0 means no secrets).
                                                                      • flipmap int - (ID of flipmap group to actuvate / deactivate) + ID of flipmap group to actuvate / deactivate.
                                                                      diff --git a/TombEngine/Scripting/Internal/ReservedScriptNames.h b/TombEngine/Scripting/Internal/ReservedScriptNames.h index 641244bd9..ab9c556b8 100644 --- a/TombEngine/Scripting/Internal/ReservedScriptNames.h +++ b/TombEngine/Scripting/Internal/ReservedScriptNames.h @@ -237,6 +237,7 @@ static constexpr char ScriptReserved_DeleteSaveGame[] = "DeleteSaveGame"; static constexpr char ScriptReserved_DoesSaveGameExist[] = "DoesSaveGameExist"; static constexpr char ScriptReserved_GetSecretCount[] = "GetSecretCount"; static constexpr char ScriptReserved_SetSecretCount[] = "SetSecretCount"; +static constexpr char ScriptReserved_GetTotalSecretCount[] = "GetTotalSecretCount"; static constexpr char ScriptReserved_SetTotalSecretCount[] = "SetTotalSecretCount"; static constexpr char ScriptReserved_AddSecret[] = "AddSecret"; static constexpr char ScriptReserved_EnableFlyCheat[] = "EnableFlyCheat"; diff --git a/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.cpp b/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.cpp index f5d304a4b..705143056 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.cpp @@ -240,16 +240,22 @@ The index argument corresponds to the secret's unique ID, the same that would go */ tableFlow.set_function(ScriptReserved_AddSecret, &FlowHandler::AddSecret, this); -/*** Total number of secrets in game. +/*** Get total number of secrets in the game. +@function GetTotalSecretCount +@treturn int Total number of secrets in the game. +*/ + tableFlow.set_function(ScriptReserved_GetTotalSecretCount, &FlowHandler::GetTotalSecretCount, this); + +/*** Set total number of secrets in the game. Must be an integer value (0 means no secrets). @function SetTotalSecretCount -@tparam int total number of secrets +@tparam int count Total number of secrets in the game. */ tableFlow.set_function(ScriptReserved_SetTotalSecretCount, &FlowHandler::SetTotalSecretCount, this); /*** Do FlipMap with specific group ID. @function FlipMap -@tparam int flipmap (ID of flipmap group to actuvate / deactivate) +@tparam int flipmap ID of flipmap group to actuvate / deactivate. */ tableFlow.set_function(ScriptReserved_FlipMap, &FlowHandler::FlipMap, this); @@ -406,6 +412,11 @@ void FlowHandler::SetTitleScreenImagePath(const std::string& path) TitleScreenImagePath = path; } +int FlowHandler::GetTotalSecretCount() +{ + return TotalNumberOfSecrets; +} + void FlowHandler::SetTotalSecretCount(int secretsNumber) { TotalNumberOfSecrets = secretsNumber; diff --git a/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.h b/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.h index 9dafce539..976397ca9 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.h +++ b/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.h @@ -70,6 +70,7 @@ public: void AddSecret(int levelSecretIndex); void SetIntroImagePath(const std::string& path); void SetTitleScreenImagePath(const std::string& path); + int GetTotalSecretCount(); void SetTotalSecretCount(int secretsNumber); bool IsFlyCheatEnabled() const; void EnableFlyCheat(bool enable); From d33ebbe417510f28f2a6cfa91cdd902d01095022 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 9 Mar 2025 19:29:45 +0100 Subject: [PATCH 031/160] Fixed level medipacks count in Flow.Statistics class --- CHANGELOG.md | 3 ++- TombEngine/Game/Lara/lara_one_gun.cpp | 2 +- TombEngine/Game/gui.cpp | 2 ++ 3 files changed, 5 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 259eb2fd3..f1e658b1a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -48,8 +48,9 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added various Translate() methods to Vec2 and Vec3 script objects. * Added alpha transparency functionality for statics and moveables to be used with SetColor() method. * Added extra arguments for sprite object slots and starting rotation value for EmitParticle function. -* Added pickups count to Flow.Statistics class. * Added ability to save Flow.Level fields such as fog or horizon to a savegame. +* Added pickups count to Flow.Statistics class. +* Fixed level medipacks count in Flow.Statistics class. ## [Version 1.7.1](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.7.4) - 2025-04-01 diff --git a/TombEngine/Game/Lara/lara_one_gun.cpp b/TombEngine/Game/Lara/lara_one_gun.cpp index e9f7a7f56..592b9d99c 100644 --- a/TombEngine/Game/Lara/lara_one_gun.cpp +++ b/TombEngine/Game/Lara/lara_one_gun.cpp @@ -1339,8 +1339,8 @@ void DoExplosiveDamage(ItemInfo& emitter, ItemInfo& target, ItemInfo& projectile SaveGame::Statistics.Level.AmmoHits++; if (target.HitPoints <= 0) { - SaveGame::Statistics.Level.Kills++; SaveGame::Statistics.Game.Kills++; + SaveGame::Statistics.Level.Kills++; CreatureDie(target.Index, true); } } diff --git a/TombEngine/Game/gui.cpp b/TombEngine/Game/gui.cpp index 4bcd58a6b..82ef55324 100644 --- a/TombEngine/Game/gui.cpp +++ b/TombEngine/Game/gui.cpp @@ -2233,6 +2233,7 @@ namespace TEN::Gui item.HitPoints = LARA_HEALTH_MAX; SoundEffect(SFX_TR4_MENU_MEDI, nullptr, SoundEnvironment::Always); + SaveGame::Statistics.Level.HealthUsed++; SaveGame::Statistics.Game.HealthUsed++; } else @@ -2259,6 +2260,7 @@ namespace TEN::Gui item.HitPoints = LARA_HEALTH_MAX; SoundEffect(SFX_TR4_MENU_MEDI, nullptr, SoundEnvironment::Always); + SaveGame::Statistics.Level.HealthUsed++; SaveGame::Statistics.Game.HealthUsed++; } else From 9d0fe6a1d8c812b5f6a8df9dd9039d61999d0fea Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 9 Mar 2025 20:01:43 +0100 Subject: [PATCH 032/160] Ribbon particle (#1606) --- Documentation/doc/1 modules/Effects.html | 93 +++++++++++++++++++ .../doc/4 enums/Effects.FeatherMode.html | 2 +- Documentation/doc/4 enums/Objects.ObjID.html | 6 ++ .../Scripting/Internal/ReservedScriptNames.h | 2 + .../Internal/TEN/Effects/EffectsFunctions.cpp | 51 ++++++++++ 5 files changed, 153 insertions(+), 1 deletion(-) diff --git a/Documentation/doc/1 modules/Effects.html b/Documentation/doc/1 modules/Effects.html index 5f3c6e3f0..3e7751034 100644 --- a/Documentation/doc/1 modules/Effects.html +++ b/Documentation/doc/1 modules/Effects.html @@ -171,6 +171,10 @@
                                                                      + + + +
                                                                      CustomBarThis module provides functions for creating and managing custom progress bars.
                                                                      DiaryDiaries: - The module provides functions to create and manage Diaries.This module provides functions to create and manage diaries.
                                                                      EventSequenceKills.
                                                                      pickupsPickups.
                                                                      secrets Secrets.
                                                                      Adds one secret to current level secret count and also plays secret music track.
                                                                      SetTotalSecretCount(total)Total number of secrets in game.GetTotalSecretCount()Get total number of secrets in the game.
                                                                      SetTotalSecretCount(count)Set total number of secrets in the game.
                                                                      FlipMap(flipmap) GetWind() Get the wind vector for the current game frame.
                                                                      EmitStreamer(mov, tag, pos, dir[, rot][, startColor][, endColor][, width][, life][, vel][, expRate][, rotRate][, edgeFeatherMode][, lengthFeatherMode][, blendID])Emit an extending streamer effect.

                                                                      Tables

                                                                      @@ -711,6 +715,95 @@ EmitAdvancedParticle(particle) + +
                                                                      + + EmitStreamer(mov, tag, pos, dir[, rot][, startColor][, endColor][, width][, life][, vel][, expRate][, rotRate][, edgeFeatherMode][, lengthFeatherMode][, blendID]) +
                                                                      +
                                                                      + Emit an extending streamer effect. + + + +

                                                                      Parameters:

                                                                      +
                                                                        +
                                                                      • mov + Moveable + Moveable object with which to associate the effect. +
                                                                        • +
                                                                      • tag + int[opt] + Numeric tag with which to associate the effect on the moveable. Default: 0 +
                                                                        • +
                                                                      • pos + Vec3 + World position. +
                                                                        • +
                                                                      • dir + Vec3 + Direction vector of movement velocity. +
                                                                        • +
                                                                      • rot + float + Start rotation in degrees. Default: 0 + (optional) +
                                                                        • +
                                                                      • startColor + Color + Color at the start of life. Default: Color(255, 255, 255, 255)) + (optional) +
                                                                        • +
                                                                      • endColor + Color + Color at the end of life. Default: Color(0, 0, 0, 0)) + (optional) +
                                                                        • +
                                                                      • width + float + Width in world units. Default: 0 + (optional) +
                                                                        • +
                                                                      • life + float + Lifetime in seconds. Default: 1 + (optional) +
                                                                        • +
                                                                      • vel + float + Movement velocity in world units per second. Default: 0 + (optional) +
                                                                        • +
                                                                      • expRate + float + Width expansion rate in world units per second. Default: 0 + (optional) +
                                                                        • +
                                                                      • rotRate + float + Rotation rate in degrees per second. Default: 0 + (optional) +
                                                                        • +
                                                                      • edgeFeatherMode + Effects.StreamerFeatherMode + Edge feather mode. Default: Effects.FeatherID.NONE + (optional) +
                                                                        • +
                                                                      • lengthFeatherMode + Effects.StreamerFeatherMode + Length feather mode. Not implemented yet. + (optional) +
                                                                        • +
                                                                      • blendID + BlendID + Renderer blend ID. Default: Effects.BlendID.ALPHA_BLEND + (optional) +
                                                                        • +
                                                                      + + + + +

                                                                      Tables

                                                                      diff --git a/Documentation/doc/4 enums/Effects.FeatherMode.html b/Documentation/doc/4 enums/Effects.FeatherMode.html index aeab018ee..f4a4fb39f 100644 --- a/Documentation/doc/4 enums/Effects.FeatherMode.html +++ b/Documentation/doc/4 enums/Effects.FeatherMode.html @@ -143,7 +143,7 @@

                                                                      Table of Effects.FeatherMode constants. - To be used with ??? function.

                                                                      + To be used with Effects.EmitStreamer function.

                                                                      • NONE
                                                                        • diff --git a/Documentation/doc/4 enums/Objects.ObjID.html b/Documentation/doc/4 enums/Objects.ObjID.html index 0daeb40f0..7d7426efa 100644 --- a/Documentation/doc/4 enums/Objects.ObjID.html +++ b/Documentation/doc/4 enums/Objects.ObjID.html @@ -505,6 +505,11 @@ DAMOCLES_SWORD ELECTRIC_CLEANER SLAMMING_DOORS SWINGING_BLADE +ELECTRIC_BALL +ELECTRIC_BALL_IMPACT_POINT +THOR_HAMMER_HANDLE +THOR_HAMMER_HEAD +MOVING_LASER PUZZLE_ITEM1 PUZZLE_ITEM2 PUZZLE_ITEM3 @@ -940,6 +945,7 @@ FISHTANK DOPPELGANGER_ORIGIN CORPSE WRAITH_TRAP +WATERFALL_EMITTER MESHSWAP1 MESHSWAP2 MESHSWAP3 diff --git a/TombEngine/Scripting/Internal/ReservedScriptNames.h b/TombEngine/Scripting/Internal/ReservedScriptNames.h index ab9c556b8..7db33a007 100644 --- a/TombEngine/Scripting/Internal/ReservedScriptNames.h +++ b/TombEngine/Scripting/Internal/ReservedScriptNames.h @@ -321,6 +321,7 @@ static constexpr char ScriptReserved_EmitSpotLight[] = "EmitSpotLight"; static constexpr char ScriptReserved_EmitBlood[] = "EmitBlood"; static constexpr char ScriptReserved_EmitAirBubble[] = "EmitAirBubble"; static constexpr char ScriptReserved_EmitFire[] = "EmitFire"; +static constexpr char ScriptReserved_EmitStreamer[] = "EmitStreamer"; static constexpr char ScriptReserved_MakeExplosion[] = "MakeExplosion"; static constexpr char ScriptReserved_MakeEarthquake[] = "MakeEarthquake"; @@ -388,6 +389,7 @@ static constexpr char ScriptReserved_EventType[] = "EventType"; static constexpr char ScriptReserved_AlignMode[] = "AlignMode"; static constexpr char ScriptReserved_ScaleMode[] = "ScaleMode"; static constexpr char ScriptReserved_ParticleAnimationType[] = "ParticleAnimationType"; +static constexpr char ScriptReserved_FeatherMode[] = "StreamerFeatherMode"; static constexpr char ScriptReserved_LevelVars[] = "LevelVars"; static constexpr char ScriptReserved_GameVars[] = "GameVars"; diff --git a/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp b/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp index 25ef6013d..3c1effb87 100644 --- a/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp +++ b/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp @@ -10,6 +10,7 @@ #include "Game/effects/Electricity.h" #include "Game/effects/explosion.h" #include "Game/effects/spark.h" +#include "Game/effects/Streamer.h" #include "Game/effects/tomb4fx.h" #include "Game/effects/weather.h" #include "Game/Setup.h" @@ -21,6 +22,7 @@ #include "Scripting/Internal/TEN/Effects/BlendIDs.h" #include "Scripting/Internal/TEN/Effects/EffectIDs.h" #include "Scripting/Internal/TEN/Effects/ParticleAnimTypes.h" +#include "Scripting/Internal/TEN/Effects/FeatherModes.h" #include "Scripting/Internal/TEN/Types/Color/Color.h" #include "Scripting/Internal/TEN/Types/Rotation/Rotation.h" #include "Scripting/Internal/TEN/Types/Vec3/Vec3.h" @@ -28,6 +30,7 @@ #include "Sound/sound.h" #include "Specific/clock.h" #include "Specific/trutils.h" +#include /// Functions to generate effects. // @tentable Effects @@ -39,6 +42,7 @@ using namespace TEN::Effects::Electricity; using namespace TEN::Effects::Environment; using namespace TEN::Effects::Explosion; using namespace TEN::Effects::Spark; +using namespace TEN::Effects::Streamer; using namespace TEN::Math; using namespace TEN::Scripting::Types; @@ -543,6 +547,51 @@ namespace TEN::Scripting::Effects return Vec3(Weather.Wind()); } +/// Emit an extending streamer effect. +// @function EmitStreamer +// @tparam Moveable mov Moveable object with which to associate the effect. +// @tparam int[opt] tag Numeric tag with which to associate the effect on the moveable. __Default: 0__ +// @tparam Vec3 pos World position. +// @tparam Vec3 dir Direction vector of movement velocity. +// @tparam[opt] float rot Start rotation in degrees. __Default: 0__ +// @tparam[opt] Color startColor Color at the start of life. __Default: Color(255, 255, 255, 255))__ +// @tparam[opt] Color endColor Color at the end of life. __Default: Color(0, 0, 0, 0))__ +// @tparam[opt] float width Width in world units. __Default: 0__ +// @tparam[opt] float life Lifetime in seconds. __Default: 1__ +// @tparam[opt] float vel Movement velocity in world units per second. __Default: 0__ +// @tparam[opt] float expRate Width expansion rate in world units per second. __Default: 0__ +// @tparam[opt] float rotRate Rotation rate in degrees per second. __Default: 0__ +// @tparam[opt] Effects.StreamerFeatherMode edgeFeatherMode Edge feather mode. __Default: Effects.FeatherID.NONE__ +// @tparam[opt] Effects.StreamerFeatherMode lengthFeatherMode Length feather mode. __Not implemented yet.__ +// @tparam[opt] Effects.BlendID blendID Renderer blend ID. __Default: Effects.BlendID.ALPHA_BLEND__ + static void EmitStreamer(const Moveable& mov, TypeOrNil tag, const Vec3& pos, const Vec3& dir, TypeOrNil rot, TypeOrNil startColor, TypeOrNil endColor, + TypeOrNil width, TypeOrNil life, TypeOrNil vel, TypeOrNil expRate, TypeOrNil rotRate, + TypeOrNil edgeFeatherMode, TypeOrNil lengthFeatherMode, TypeOrNil blendID) + { + int movID = mov.GetIndex(); + int convertedTag = ValueOr(tag, 0); + auto convertedPos = pos.ToVector3(); + auto convertedDir = dir.ToVector3(); + auto convertedRot = ANGLE(ValueOr(rot, 0)); + auto convertedStartColor = ValueOr(startColor, ScriptColor(255, 255, 255, 255)); + auto convertedEndColor = ValueOr(endColor, ScriptColor(0, 0, 0, 0)); + + auto convertedWidth = ValueOr(width, 0.0f); + auto convertedLife = ValueOr(life, 1.0f); + auto convertedVel = ValueOr(vel, 0.0f) / (float)FPS; + auto convertedExpRate = ValueOr(expRate, 0.0f) / (float)FPS; + auto convertedRotRate = ANGLE(ValueOr(rotRate, 0.0f) / (float)FPS); + + auto convertedEdgeFeatherID = ValueOr(edgeFeatherMode, StreamerFeatherMode::None); + auto convertedLengthFeatherID = ValueOr(lengthFeatherMode, StreamerFeatherMode::None); + auto convertedBlendID = ValueOr(blendID, BlendMode::AlphaBlend); + + StreamerEffect.Spawn( + movID, convertedTag, convertedPos, convertedDir, convertedRot, convertedStartColor, convertedEndColor, + convertedWidth, convertedLife, convertedVel, convertedExpRate, convertedRotRate, + convertedEdgeFeatherID, convertedBlendID); + } + void Register(sol::state* state, sol::table& parent) { auto tableEffects = sol::table(state->lua_state(), sol::create); @@ -557,6 +606,7 @@ namespace TEN::Scripting::Effects tableEffects.set_function(ScriptReserved_EmitSpotLight, &EmitSpotLight); tableEffects.set_function(ScriptReserved_EmitBlood, &EmitBlood); tableEffects.set_function(ScriptReserved_EmitAirBubble, &EmitAirBubble); + tableEffects.set_function(ScriptReserved_EmitStreamer, &EmitStreamer); tableEffects.set_function(ScriptReserved_EmitFire, &EmitFire); tableEffects.set_function(ScriptReserved_MakeExplosion, &MakeExplosion); @@ -566,6 +616,7 @@ namespace TEN::Scripting::Effects auto handler = LuaHandler(state); handler.MakeReadOnlyTable(tableEffects, ScriptReserved_BlendID, BLEND_IDS); handler.MakeReadOnlyTable(tableEffects, ScriptReserved_EffectID, EFFECT_IDS); + handler.MakeReadOnlyTable(tableEffects, ScriptReserved_FeatherMode, FEATHER_MODES); handler.MakeReadOnlyTable(tableEffects, ScriptReserved_ParticleAnimationType, PARTICLE_ANIM_TYPES); } } From 839d9a47199351a722c369a275183bd4e24f833b Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 9 Mar 2025 20:42:01 +0100 Subject: [PATCH 033/160] Added back laser sound --- TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp | 2 +- TombEngine/Sound/sound_effects.h | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp b/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp index ac48c8343..79d0b7bba 100644 --- a/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp +++ b/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp @@ -94,7 +94,7 @@ namespace TEN::Entities::Traps if (item.ItemFlags[MovingLaserFlags::PauseCounter] == 0) { - SoundEffect(SFX_TR3_LASER_LOOP, &item.Pose, SoundEnvironment::Always); + SoundEffect(SFX_TR5_MOVING_LASER_LOOP, &item.Pose, SoundEnvironment::Always); } // Update room if necessary. diff --git a/TombEngine/Sound/sound_effects.h b/TombEngine/Sound/sound_effects.h index 303733282..f252bdd92 100644 --- a/TombEngine/Sound/sound_effects.h +++ b/TombEngine/Sound/sound_effects.h @@ -1217,6 +1217,7 @@ enum SOUND_EFFECTS SFX_TR2_DRAGON_FALL = 1145, SFX_TR2_MARCO_BARTOLI_TRANSFORM = 1146, SFX_TR4_STEAM_EMITTER_LOOP = 1194, + SFX_TR5_MOVING_LASER_LOOP = 1195, // New sounds From 163594a6b9b05bab909bef20e3059a617a146934 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 9 Mar 2025 22:27:37 +0100 Subject: [PATCH 034/160] Fix secrets property being write-only --- TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp index 566d05a4f..dfde00339 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp @@ -132,7 +132,7 @@ e.g. `myLevel.laraType = LaraType.Divesuit` /// (short) Set Secrets for Level //@mem secrets - "secrets", sol::property(&Level::SetSecrets) + "secrets", sol::property(&Level::GetSecrets, &Level::SetSecrets) ); } From df3fda8d3351dd06079362d5bd0a80c49338f6d5 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 9 Mar 2025 23:23:56 +0100 Subject: [PATCH 035/160] Rename method --- TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp | 8 ++++---- TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.h | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp b/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp index 2253f4bcc..2c23ff09a 100644 --- a/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp +++ b/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp @@ -504,7 +504,7 @@ void LogicHandler::FreeLevelScripts() m_onSave = sol::nil; m_onEnd = sol::nil; m_onUseItem = sol::nil; - m_onBreak = sol::nil; + m_onFreeze = sol::nil; m_handler.GetState()->collect_garbage(); } @@ -1096,8 +1096,8 @@ void LogicHandler::OnFreeze() for (const auto& name : m_callbacksPreFreeze) CallLevelFuncByName(name); - if (m_onBreak.valid()) - CallLevelFunc(m_onBreak); + if (m_onFreeze.valid()) + CallLevelFunc(m_onFreeze); for (const auto& name : m_callbacksPostFreeze) CallLevelFuncByName(name); @@ -1248,7 +1248,7 @@ void LogicHandler::InitCallbacks() assignCB(m_onSave, ScriptReserved_OnSave); assignCB(m_onEnd, ScriptReserved_OnEnd); assignCB(m_onUseItem, ScriptReserved_OnUseItem); - assignCB(m_onBreak, ScriptReserved_OnFreeze); + assignCB(m_onFreeze, ScriptReserved_OnFreeze); // COMPATIBILITY assignCB(m_onLoop, "OnControlPhase"); diff --git a/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.h b/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.h index 556564d75..82c1404e5 100644 --- a/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.h +++ b/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.h @@ -72,7 +72,7 @@ private: sol::protected_function m_onSave{}; sol::protected_function m_onEnd{}; sol::protected_function m_onUseItem{}; - sol::protected_function m_onBreak{}; + sol::protected_function m_onFreeze{}; std::unordered_map *> m_callbacks; From 3064535f62fe0e3881168d54e00b61f41d8ff375 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 9 Mar 2025 23:58:27 +0100 Subject: [PATCH 036/160] Removed unnecessary enabled flag from fog structure --- TombEngine/Game/savegame.cpp | 2 - TombEngine/Renderer/RendererDraw.cpp | 2 +- .../Scripting/Include/ScriptInterfaceLevel.h | 1 - .../Scripting/Internal/TEN/Flow/Fog/Fog.cpp | 1 - .../Scripting/Internal/TEN/Flow/Fog/Fog.h | 1 - .../Internal/TEN/Flow/Level/FlowLevel.cpp | 5 -- .../Internal/TEN/Flow/Level/FlowLevel.h | 1 - .../flatbuffers/ten_savegame_generated.h | 68 ++++++++----------- .../Specific/savegame/schema/ten_savegame.fbs | 1 - 9 files changed, 28 insertions(+), 54 deletions(-) diff --git a/TombEngine/Game/savegame.cpp b/TombEngine/Game/savegame.cpp index a029164dc..b2ae7ec0c 100644 --- a/TombEngine/Game/savegame.cpp +++ b/TombEngine/Game/savegame.cpp @@ -1097,7 +1097,6 @@ const std::vector SaveGame::Build() levelData.add_level_far_view(level->LevelFarView); - levelData.add_fog_enabled(level->Fog.Enabled); levelData.add_fog_color(level->Fog.GetColor()); levelData.add_fog_min_distance(level->Fog.MinDistance); levelData.add_fog_max_distance(level->Fog.MaxDistance); @@ -1798,7 +1797,6 @@ static void ParseLua(const Save::SaveGame* s, bool hubMode) auto* level = (Level*)g_GameFlow->GetLevel(CurrentLevel); - level->Fog.Enabled = s->level_data()->fog_enabled(); level->Fog.MaxDistance = s->level_data()->fog_max_distance(); level->Fog.MinDistance = s->level_data()->fog_min_distance(); level->Fog.SetColor(s->level_data()->fog_color()); diff --git a/TombEngine/Renderer/RendererDraw.cpp b/TombEngine/Renderer/RendererDraw.cpp index 948264df7..bd6b84344 100644 --- a/TombEngine/Renderer/RendererDraw.cpp +++ b/TombEngine/Renderer/RendererDraw.cpp @@ -1821,7 +1821,7 @@ namespace TEN::Renderer cameraConstantBuffer.CameraUnderwater = g_Level.Rooms[cameraConstantBuffer.RoomNumber].flags & ENV_FLAG_WATER; cameraConstantBuffer.DualParaboloidView = Matrix::CreateLookAt(LaraItem->Pose.Position.ToVector3(), LaraItem->Pose.Position.ToVector3() + Vector3(0, 0, 1024), -Vector3::UnitY); - if (level.GetFogEnabled()) + if (level.GetFogMaxDistance() > 0) { auto fogColor = level.GetFogColor(); cameraConstantBuffer.FogColor = Vector4(fogColor.GetR() / 255.0f, fogColor.GetG() / 255.0f, fogColor.GetB() / 255.0f, 1.0f); diff --git a/TombEngine/Scripting/Include/ScriptInterfaceLevel.h b/TombEngine/Scripting/Include/ScriptInterfaceLevel.h index 0453d4cee..0bef47771 100644 --- a/TombEngine/Scripting/Include/ScriptInterfaceLevel.h +++ b/TombEngine/Scripting/Include/ScriptInterfaceLevel.h @@ -37,7 +37,6 @@ public: virtual float GetWeatherStrength() const = 0; virtual WeatherType GetWeatherType() const = 0; virtual RGBAColor8Byte GetSkyLayerColor(int index) const = 0; - virtual bool GetFogEnabled() const = 0; virtual RGBAColor8Byte GetFogColor() const = 0; virtual short GetFogMinDistance() const = 0; virtual short GetFogMaxDistance() const = 0; diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp index 95c2b15c1..ffc6032f9 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp @@ -47,7 +47,6 @@ Fog::Fog(ScriptColor const& col, short minDistance, short maxDistance) SetColor(col); MinDistance = minDistance; MaxDistance = maxDistance; - Enabled = true; } void Fog::SetColor(ScriptColor const& col) diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.h b/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.h index e24dc3577..6958e3041 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.h +++ b/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.h @@ -10,7 +10,6 @@ using namespace TEN::Scripting::Types; struct Fog { - bool Enabled{ false }; byte R{ 0 }; byte G{ 0 }; byte B{ 0 }; diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp index dfde00339..837b6af77 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp @@ -220,11 +220,6 @@ WeatherType Level::GetWeatherType() const return Weather; } -bool Level::GetFogEnabled() const -{ - return Fog.Enabled; -} - RGBAColor8Byte Level::GetFogColor() const { return Fog.GetColor(); diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.h b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.h index 38125cb11..d9b46a253 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.h +++ b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.h @@ -53,7 +53,6 @@ struct Level : public ScriptInterfaceLevel // TODO: Clean up this mess. RGBAColor8Byte GetFogColor() const override; - bool GetFogEnabled() const override; float GetWeatherStrength() const override; bool GetSkyLayerEnabled(int index) const override; bool GetStormEnabled() const override; diff --git a/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h b/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h index 902c1d7b1..6cf572a17 100644 --- a/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h +++ b/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h @@ -548,7 +548,6 @@ struct LevelDataT : public flatbuffers::NativeTable { bool rumble_enabled = false; int32_t weather_type = 0; float weather_strength = 0.0f; - bool fog_enabled = false; int32_t fog_color = 0; int32_t fog_min_distance = 0; int32_t fog_max_distance = 0; @@ -588,34 +587,33 @@ struct LevelData FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { VT_RUMBLE_ENABLED = 8, VT_WEATHER_TYPE = 10, VT_WEATHER_STRENGTH = 12, - VT_FOG_ENABLED = 14, - VT_FOG_COLOR = 16, - VT_FOG_MIN_DISTANCE = 18, - VT_FOG_MAX_DISTANCE = 20, - VT_SKY_LAYER_1_ENABLED = 22, - VT_SKY_LAYER_1_COLOR = 24, - VT_SKY_LAYER_1_SPEED = 26, - VT_SKY_LAYER_2_ENABLED = 28, - VT_SKY_LAYER_2_COLOR = 30, - VT_SKY_LAYER_2_SPEED = 32, - VT_HORIZON1_ENABLED = 34, - VT_HORIZON1_OBJECT_ID = 36, - VT_HORIZON1_POSITION = 38, - VT_HORIZON1_ORIENTATION = 40, - VT_HORIZON1_TRANSPARENCY = 42, - VT_HORIZON2_ENABLED = 44, - VT_HORIZON2_OBJECT_ID = 46, - VT_HORIZON2_POSITION = 48, - VT_HORIZON2_ORIENTATION = 50, - VT_HORIZON2_TRANSPARENCY = 52, - VT_LENSFLARE_SPRITE_ID = 54, - VT_LENSFLARE_PITCH = 56, - VT_LENSFLARE_YAW = 58, - VT_LENSFLARE_COLOR = 60, - VT_STARFIELD_STAR_COUNT = 62, - VT_STARFIELD_METEOR_COUNT = 64, - VT_STARFIELD_METEOR_SPAWN_DENSITY = 66, - VT_STARFIELD_METEOR_VELOCITY = 68 + VT_FOG_COLOR = 14, + VT_FOG_MIN_DISTANCE = 16, + VT_FOG_MAX_DISTANCE = 18, + VT_SKY_LAYER_1_ENABLED = 20, + VT_SKY_LAYER_1_COLOR = 22, + VT_SKY_LAYER_1_SPEED = 24, + VT_SKY_LAYER_2_ENABLED = 26, + VT_SKY_LAYER_2_COLOR = 28, + VT_SKY_LAYER_2_SPEED = 30, + VT_HORIZON1_ENABLED = 32, + VT_HORIZON1_OBJECT_ID = 34, + VT_HORIZON1_POSITION = 36, + VT_HORIZON1_ORIENTATION = 38, + VT_HORIZON1_TRANSPARENCY = 40, + VT_HORIZON2_ENABLED = 42, + VT_HORIZON2_OBJECT_ID = 44, + VT_HORIZON2_POSITION = 46, + VT_HORIZON2_ORIENTATION = 48, + VT_HORIZON2_TRANSPARENCY = 50, + VT_LENSFLARE_SPRITE_ID = 52, + VT_LENSFLARE_PITCH = 54, + VT_LENSFLARE_YAW = 56, + VT_LENSFLARE_COLOR = 58, + VT_STARFIELD_STAR_COUNT = 60, + VT_STARFIELD_METEOR_COUNT = 62, + VT_STARFIELD_METEOR_SPAWN_DENSITY = 64, + VT_STARFIELD_METEOR_VELOCITY = 66 }; int32_t level_far_view() const { return GetField(VT_LEVEL_FAR_VIEW, 0); @@ -632,9 +630,6 @@ struct LevelData FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { float weather_strength() const { return GetField(VT_WEATHER_STRENGTH, 0.0f); } - bool fog_enabled() const { - return GetField(VT_FOG_ENABLED, 0) != 0; - } int32_t fog_color() const { return GetField(VT_FOG_COLOR, 0); } @@ -723,7 +718,6 @@ struct LevelData FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { VerifyField(verifier, VT_RUMBLE_ENABLED) && VerifyField(verifier, VT_WEATHER_TYPE) && VerifyField(verifier, VT_WEATHER_STRENGTH) && - VerifyField(verifier, VT_FOG_ENABLED) && VerifyField(verifier, VT_FOG_COLOR) && VerifyField(verifier, VT_FOG_MIN_DISTANCE) && VerifyField(verifier, VT_FOG_MAX_DISTANCE) && @@ -777,9 +771,6 @@ struct LevelDataBuilder { void add_weather_strength(float weather_strength) { fbb_.AddElement(LevelData::VT_WEATHER_STRENGTH, weather_strength, 0.0f); } - void add_fog_enabled(bool fog_enabled) { - fbb_.AddElement(LevelData::VT_FOG_ENABLED, static_cast(fog_enabled), 0); - } void add_fog_color(int32_t fog_color) { fbb_.AddElement(LevelData::VT_FOG_COLOR, fog_color, 0); } @@ -879,7 +870,6 @@ inline flatbuffers::Offset CreateLevelData( bool rumble_enabled = false, int32_t weather_type = 0, float weather_strength = 0.0f, - bool fog_enabled = false, int32_t fog_color = 0, int32_t fog_min_distance = 0, int32_t fog_max_distance = 0, @@ -938,7 +928,6 @@ inline flatbuffers::Offset CreateLevelData( builder_.add_horizon1_enabled(horizon1_enabled); builder_.add_sky_layer_2_enabled(sky_layer_2_enabled); builder_.add_sky_layer_1_enabled(sky_layer_1_enabled); - builder_.add_fog_enabled(fog_enabled); builder_.add_rumble_enabled(rumble_enabled); builder_.add_storm_enabled(storm_enabled); return builder_.Finish(); @@ -8943,7 +8932,6 @@ inline void LevelData::UnPackTo(LevelDataT *_o, const flatbuffers::resolver_func { auto _e = rumble_enabled(); _o->rumble_enabled = _e; } { auto _e = weather_type(); _o->weather_type = _e; } { auto _e = weather_strength(); _o->weather_strength = _e; } - { auto _e = fog_enabled(); _o->fog_enabled = _e; } { auto _e = fog_color(); _o->fog_color = _e; } { auto _e = fog_min_distance(); _o->fog_min_distance = _e; } { auto _e = fog_max_distance(); _o->fog_max_distance = _e; } @@ -8986,7 +8974,6 @@ inline flatbuffers::Offset CreateLevelData(flatbuffers::FlatBufferBui auto _rumble_enabled = _o->rumble_enabled; auto _weather_type = _o->weather_type; auto _weather_strength = _o->weather_strength; - auto _fog_enabled = _o->fog_enabled; auto _fog_color = _o->fog_color; auto _fog_min_distance = _o->fog_min_distance; auto _fog_max_distance = _o->fog_max_distance; @@ -9021,7 +9008,6 @@ inline flatbuffers::Offset CreateLevelData(flatbuffers::FlatBufferBui _rumble_enabled, _weather_type, _weather_strength, - _fog_enabled, _fog_color, _fog_min_distance, _fog_max_distance, diff --git a/TombEngine/Specific/savegame/schema/ten_savegame.fbs b/TombEngine/Specific/savegame/schema/ten_savegame.fbs index 4b239e19a..647c3246d 100644 --- a/TombEngine/Specific/savegame/schema/ten_savegame.fbs +++ b/TombEngine/Specific/savegame/schema/ten_savegame.fbs @@ -14,7 +14,6 @@ table LevelData { weather_type: int32; weather_strength: float; - fog_enabled: bool; fog_color: int32; fog_min_distance: int32; fog_max_distance: int32; From 431b5e2fa788fd679f10fd2813bf823a879afc40 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Mon, 10 Mar 2025 00:38:26 +0100 Subject: [PATCH 037/160] Update CHANGELOG.md --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index f1e658b1a..85ddef4e3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -38,7 +38,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added advanced particle emitter allowing animations and other effects. * Added diary module. * Added custom bar module. -* Added Flow.Horizon class with and use two layers of horizons in a Flow.Level class. +* Added Flow.Horizon class and two layers of horizons in a Flow.Level class. * Added Flow.GetTotalSecretCount() function to get total amount of secrets in the game. * Added View.GetFlyByPosition() and View.GetFlyByRotation() functions to get flyby sequence parameters at a specified time point. * Added Effects.EmitAirBubble() function to spawn air bubbles. From fcba21dd347db7fa7bce0089c9c10746ab8d7f4f Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Mon, 10 Mar 2025 08:29:46 +0100 Subject: [PATCH 038/160] Update SoundSourceObject.cpp --- .../Internal/TEN/Objects/SoundSource/SoundSourceObject.cpp | 1 - 1 file changed, 1 deletion(-) diff --git a/TombEngine/Scripting/Internal/TEN/Objects/SoundSource/SoundSourceObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/SoundSource/SoundSourceObject.cpp index 7a1ccf031..54e1b0b27 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/SoundSource/SoundSourceObject.cpp +++ b/TombEngine/Scripting/Internal/TEN/Objects/SoundSource/SoundSourceObject.cpp @@ -53,7 +53,6 @@ void SoundSource::Register(sol::table& parent) ScriptReserved_GetSoundID, &SoundSource::GetSoundID, /// Set the sound source's ID - // __TODO__ this and getSoundID should use enums // @function SoundSource:SetSoundID // @tparam int name The sound source's new name ScriptReserved_SetSoundID, &SoundSource::SetSoundID From c3cdace9fb95abf683f13b83545282a865a7bc3f Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Mon, 10 Mar 2025 08:42:57 +0100 Subject: [PATCH 039/160] Update CHANGELOG.md --- CHANGELOG.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 85ddef4e3..a093d2c6c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -49,8 +49,8 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added alpha transparency functionality for statics and moveables to be used with SetColor() method. * Added extra arguments for sprite object slots and starting rotation value for EmitParticle function. * Added ability to save Flow.Level fields such as fog or horizon to a savegame. -* Added pickups count to Flow.Statistics class. -* Fixed level medipacks count in Flow.Statistics class. +* Added pickup count to Flow.Statistics class. +* Fixed medipack level count in Flow.Statistics class. ## [Version 1.7.1](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.7.4) - 2025-04-01 From b2ab5f65b173e22a4f70ef29aa09c22e59b1b061 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Tue, 11 Mar 2025 08:25:51 +0100 Subject: [PATCH 040/160] Upgrade to O2 optimizations --- CHANGELOG.md | 1 + TombEngine/TombEngine.vcxproj | 4 ++-- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index a093d2c6c..15c36a6f1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): ## [Version 1.8](link to release) - yyyy-mm-dd ### Bug fixes +* Improved engine performance (up to 15-30%). * Fixed bridges moving the player when the player is underwater. * Fixed trigger triggerer not working. * Fixed display pickup numeric string not being interpolated in high framerate mode. diff --git a/TombEngine/TombEngine.vcxproj b/TombEngine/TombEngine.vcxproj index 0fe4faed2..e12e2e668 100644 --- a/TombEngine/TombEngine.vcxproj +++ b/TombEngine/TombEngine.vcxproj @@ -297,7 +297,7 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. stdcpp17 framework.h ProgramDatabase - MinSpace + MaxSpeed Default AnySuitable true @@ -377,7 +377,7 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. stdcpp17 framework.h ProgramDatabase - MinSpace + MaxSpeed Default AnySuitable true From 6f6a07e6960e8d3dcc13a27a809e49a2c961f09f Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Tue, 11 Mar 2025 08:28:01 +0100 Subject: [PATCH 041/160] Update CHANGELOG.md --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 15c36a6f1..301a29fcb 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,7 +6,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): ## [Version 1.8](link to release) - yyyy-mm-dd ### Bug fixes -* Improved engine performance (up to 15-30%). +* Improved engine performance up to 20%. * Fixed bridges moving the player when the player is underwater. * Fixed trigger triggerer not working. * Fixed display pickup numeric string not being interpolated in high framerate mode. From e97c47315e9ebda78b8bbf130e4af246ae3275ff Mon Sep 17 00:00:00 2001 From: Sezz Date: Wed, 12 Mar 2025 00:10:05 +1100 Subject: [PATCH 042/160] Remove m prefix from private logic handler fields --- .../Internal/TEN/Logic/LogicHandler.cpp | 343 +++++++++--------- .../Internal/TEN/Logic/LogicHandler.h | 64 ++-- 2 files changed, 205 insertions(+), 202 deletions(-) diff --git a/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp b/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp index 2c23ff09a..e85c98ce5 100644 --- a/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp +++ b/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp @@ -194,11 +194,11 @@ sol::object GetVariable(sol::table tab, sol::object key) return tab.raw_get(key); } -LogicHandler::LogicHandler(sol::state* lua, sol::table & parent) : m_handler{ lua } +LogicHandler::LogicHandler(sol::state* lua, sol::table& parent) : _handler{ lua } { - m_handler.GetState()->set_function("print", &LogicHandler::LogPrint, this); + _handler.GetState()->set_function("print", &LogicHandler::LogPrint, this); - sol::table tableLogic{ m_handler.GetState()->lua_state(), sol::create }; + auto tableLogic = sol::table(_handler.GetState()->lua_state(), sol::create); parent.set(ScriptReserved_Logic, tableLogic); @@ -208,24 +208,24 @@ LogicHandler::LogicHandler(sol::state* lua, sol::table & parent) : m_handler{ lu tableLogic.set_function(ScriptReserved_EnableEvent, &LogicHandler::EnableEvent, this); tableLogic.set_function(ScriptReserved_DisableEvent, &LogicHandler::DisableEvent, this); - m_handler.MakeReadOnlyTable(tableLogic, ScriptReserved_EndReason, LEVEL_END_REASONS); - m_handler.MakeReadOnlyTable(tableLogic, ScriptReserved_CallbackPoint, CALLBACK_POINTS); - m_handler.MakeReadOnlyTable(tableLogic, ScriptReserved_EventType, EVENT_TYPES); + _handler.MakeReadOnlyTable(tableLogic, ScriptReserved_EndReason, LEVEL_END_REASONS); + _handler.MakeReadOnlyTable(tableLogic, ScriptReserved_CallbackPoint, CALLBACK_POINTS); + _handler.MakeReadOnlyTable(tableLogic, ScriptReserved_EventType, EVENT_TYPES); - m_callbacks.insert(std::make_pair(CallbackPoint::PreStart, &m_callbacksPreStart)); - m_callbacks.insert(std::make_pair(CallbackPoint::PostStart, &m_callbacksPostStart)); - m_callbacks.insert(std::make_pair(CallbackPoint::PreLoad, &m_callbacksPreLoad)); - m_callbacks.insert(std::make_pair(CallbackPoint::PostLoad, &m_callbacksPostLoad)); - m_callbacks.insert(std::make_pair(CallbackPoint::PreLoop, &m_callbacksPreLoop)); - m_callbacks.insert(std::make_pair(CallbackPoint::PostLoop, &m_callbacksPostLoop)); - m_callbacks.insert(std::make_pair(CallbackPoint::PreSave, &m_callbacksPreSave)); - m_callbacks.insert(std::make_pair(CallbackPoint::PostSave, &m_callbacksPostSave)); - m_callbacks.insert(std::make_pair(CallbackPoint::PreEnd, &m_callbacksPreEnd)); - m_callbacks.insert(std::make_pair(CallbackPoint::PostEnd, &m_callbacksPostEnd)); - m_callbacks.insert(std::make_pair(CallbackPoint::PreUseItem, &m_callbacksPreUseItem)); - m_callbacks.insert(std::make_pair(CallbackPoint::PostUseItem, &m_callbacksPostUseItem)); - m_callbacks.insert(std::make_pair(CallbackPoint::PreFreeze, &m_callbacksPreFreeze)); - m_callbacks.insert(std::make_pair(CallbackPoint::PostFreeze, &m_callbacksPostFreeze)); + _callbacks.insert(std::make_pair(CallbackPoint::PreStart, &_callbacksPreStart)); + _callbacks.insert(std::make_pair(CallbackPoint::PostStart, &_callbacksPostStart)); + _callbacks.insert(std::make_pair(CallbackPoint::PreLoad, &_callbacksPreLoad)); + _callbacks.insert(std::make_pair(CallbackPoint::PostLoad, &_callbacksPostLoad)); + _callbacks.insert(std::make_pair(CallbackPoint::PreLoop, &_callbacksPreLoop)); + _callbacks.insert(std::make_pair(CallbackPoint::PostLoop, &_callbacksPostLoop)); + _callbacks.insert(std::make_pair(CallbackPoint::PreSave, &_callbacksPreSave)); + _callbacks.insert(std::make_pair(CallbackPoint::PostSave, &_callbacksPostSave)); + _callbacks.insert(std::make_pair(CallbackPoint::PreEnd, &_callbacksPreEnd)); + _callbacks.insert(std::make_pair(CallbackPoint::PostEnd, &_callbacksPostEnd)); + _callbacks.insert(std::make_pair(CallbackPoint::PreUseItem, &_callbacksPreUseItem)); + _callbacks.insert(std::make_pair(CallbackPoint::PostUseItem, &_callbacksPostUseItem)); + _callbacks.insert(std::make_pair(CallbackPoint::PreFreeze, &_callbacksPreFreeze)); + _callbacks.insert(std::make_pair(CallbackPoint::PostFreeze, &_callbacksPostFreeze)); LevelFunc::Register(tableLogic); @@ -234,10 +234,10 @@ LogicHandler::LogicHandler(sol::state* lua, sol::table & parent) : m_handler{ lu void LogicHandler::ResetGameTables() { - auto state = m_handler.GetState(); + auto state = _handler.GetState(); MakeSpecialTable(state, ScriptReserved_GameVars, &GetVariable, &SetVariable); - (*state)[ScriptReserved_GameVars][ScriptReserved_Engine] = sol::table{ *state, sol::create }; + (*state)[ScriptReserved_GameVars][ScriptReserved_Engine] = sol::table(*state, sol::create); } /*** Register a function as a callback. @@ -286,9 +286,8 @@ Any returned value will be discarded. */ void LogicHandler::AddCallback(CallbackPoint point, const LevelFunc& levelFunc) { - auto it = m_callbacks.find(point); - - if (it == m_callbacks.end()) + auto it = _callbacks.find(point); + if (it == _callbacks.end()) { TENLog("Error: callback point not found. Attempted to access missing value.", LogLevel::Error, LogConfig::All, false); return; @@ -315,8 +314,8 @@ Will have no effect if the function was not registered as a callback */ void LogicHandler::RemoveCallback(CallbackPoint point, const LevelFunc& levelFunc) { - auto it = m_callbacks.find(point); - if (it == m_callbacks.end()) + auto it = _callbacks.find(point); + if (it == _callbacks.end()) { TENLog("Error: callback point not found. Attempted to access missing value.", LogLevel::Error, LogConfig::All, false); return; @@ -374,7 +373,7 @@ void LogicHandler::DisableEvent(const std::string& name, EventType type) void LogicHandler::ResetLevelTables() { - auto state = m_handler.GetState(); + auto state = _handler.GetState(); MakeSpecialTable(state, ScriptReserved_LevelVars, &GetVariable, &SetVariable); (*state)[ScriptReserved_LevelVars][ScriptReserved_Engine] = sol::table{ *state, sol::create }; @@ -382,15 +381,15 @@ void LogicHandler::ResetLevelTables() sol::object LogicHandler::GetLevelFuncsMember(sol::table tab, const std::string& name) { - std::string partName = tab.raw_get(strKey); - auto& map = m_levelFuncs_tablesOfNames[partName]; + auto partName = tab.raw_get(strKey); + auto& map = _levelFuncs_tablesOfNames[partName]; auto fullNameIt = map.find(name); if (fullNameIt != std::cend(map)) { std::string_view key = fullNameIt->second; - if (m_levelFuncs_levelFuncObjects[key].valid()) - return m_levelFuncs_levelFuncObjects[key]; + if (_levelFuncs_levelFuncObjects[key].valid()) + return _levelFuncs_levelFuncObjects[key]; } return sol::nil; @@ -400,7 +399,7 @@ bool LogicHandler::SetLevelFuncsMember(sol::table tab, const std::string& name, { if (sol::type::lua_nil == value.get_type()) { - std::string error{ "Tried to set " + std::string{ScriptReserved_LevelFuncs} + " member " }; + auto error = std::string("Tried to set " + std::string{ScriptReserved_LevelFuncs} + " member "); error += name + " to nil; this not permitted at this time."; return ScriptAssert(false, error); } @@ -409,27 +408,27 @@ bool LogicHandler::SetLevelFuncsMember(sol::table tab, const std::string& name, // Add name to table of names. auto partName = tab.raw_get(strKey); auto fullName = partName + "." + name; - auto& parentNameTab = m_levelFuncs_tablesOfNames[partName]; + auto& parentNameTab = _levelFuncs_tablesOfNames[partName]; parentNameTab.insert_or_assign(name, fullName); // Create LevelFunc userdata and add that too. LevelFunc levelFuncObject; levelFuncObject.m_funcName = fullName; levelFuncObject.m_handler = this; - m_levelFuncs_levelFuncObjects[fullName] = levelFuncObject; + _levelFuncs_levelFuncObjects[fullName] = levelFuncObject; // Add function itself. - m_levelFuncs_luaFunctions[fullName] = value; + _levelFuncs_luaFunctions[fullName] = value; } else if (sol::type::table == value.get_type()) { // Create and add new name map. - std::unordered_map newNameMap; + auto newNameMap = std::unordered_map{}; auto fullName = tab.raw_get(strKey) + "." + name; - m_levelFuncs_tablesOfNames.insert_or_assign(fullName, newNameMap); + _levelFuncs_tablesOfNames.insert_or_assign(fullName, newNameMap); // Create new table to put in the LevelFuncs hierarchy. - auto newLevelFuncsTab = MakeSpecialTable(m_handler.GetState(), name, &LogicHandler::GetLevelFuncsMember, &LogicHandler::SetLevelFuncsMember, this); + auto newLevelFuncsTab = MakeSpecialTable(_handler.GetState(), name, &LogicHandler::GetLevelFuncsMember, &LogicHandler::SetLevelFuncsMember, this); newLevelFuncsTab.raw_set(strKey, fullName); tab.raw_set(name, newLevelFuncsTab); @@ -440,7 +439,7 @@ bool LogicHandler::SetLevelFuncsMember(sol::table tab, const std::string& name, } else { - std::string error{ "Failed to add " }; + auto error = std::string("Failed to add "); error += name + " to " + ScriptReserved_LevelFuncs + " or one of its tables; it must be a function or a table of functions."; return ScriptAssert(false, error); } @@ -450,10 +449,10 @@ bool LogicHandler::SetLevelFuncsMember(sol::table tab, const std::string& name, void LogicHandler::LogPrint(sol::variadic_args args) { - std::string str; + auto str = std::string(); for (const sol::object& o : args) { - auto strPart = (*m_handler.GetState())["tostring"](o).get(); + auto strPart = (*_handler.GetState())["tostring"](o).get(); str += strPart; str += "\t"; } @@ -465,10 +464,10 @@ void LogicHandler::ResetScripts(bool clearGameVars) { FreeLevelScripts(); - for (auto& [first, second] : m_callbacks) + for (auto& [first, second] : _callbacks) second->clear(); - auto currentPackage = m_handler.GetState()->get("package"); + auto currentPackage = _handler.GetState()->get("package"); auto currentLoaded = currentPackage.get("loaded"); for (auto& [first, second] : currentLoaded) @@ -477,35 +476,35 @@ void LogicHandler::ResetScripts(bool clearGameVars) if (clearGameVars) ResetGameTables(); - m_handler.ResetGlobals(); + _handler.ResetGlobals(); - m_shortenedCalls = false; + _shortenedCalls = false; - m_handler.GetState()->collect_garbage(); + _handler.GetState()->collect_garbage(); } void LogicHandler::FreeLevelScripts() { - m_levelFuncs = MakeSpecialTable(m_handler.GetState(), ScriptReserved_LevelFuncs, &LogicHandler::GetLevelFuncsMember, &LogicHandler::SetLevelFuncsMember, this); - m_levelFuncs.raw_set(strKey, ScriptReserved_LevelFuncs); + _levelFuncs = MakeSpecialTable(_handler.GetState(), ScriptReserved_LevelFuncs, &LogicHandler::GetLevelFuncsMember, &LogicHandler::SetLevelFuncsMember, this); + _levelFuncs.raw_set(strKey, ScriptReserved_LevelFuncs); - m_levelFuncs[ScriptReserved_Engine] = sol::table{ *m_handler.GetState(), sol::create }; + _levelFuncs[ScriptReserved_Engine] = sol::table(*_handler.GetState(), sol::create); - m_levelFuncs_tablesOfNames.clear(); - m_levelFuncs_luaFunctions.clear(); - m_levelFuncs_levelFuncObjects = sol::table{ *m_handler.GetState(), sol::create }; + _levelFuncs_tablesOfNames.clear(); + _levelFuncs_luaFunctions.clear(); + _levelFuncs_levelFuncObjects = sol::table(*_handler.GetState(), sol::create); - m_levelFuncs_tablesOfNames.emplace(std::make_pair(ScriptReserved_LevelFuncs, std::unordered_map{})); + _levelFuncs_tablesOfNames.emplace(std::make_pair(ScriptReserved_LevelFuncs, std::unordered_map{})); ResetLevelTables(); - m_onStart = sol::nil; - m_onLoad = sol::nil; - m_onLoop = sol::nil; - m_onSave = sol::nil; - m_onEnd = sol::nil; - m_onUseItem = sol::nil; - m_onFreeze = sol::nil; - m_handler.GetState()->collect_garbage(); + _onStart = sol::nil; + _onLoad = sol::nil; + _onLoop = sol::nil; + _onSave = sol::nil; + _onEnd = sol::nil; + _onUseItem = sol::nil; + _onFreeze = sol::nil; + _handler.GetState()->collect_garbage(); } // Used when loading. @@ -516,13 +515,13 @@ void LogicHandler::SetVariables(const std::vector& vars, bool onlyLeve ResetLevelTables(); - std::unordered_map solTables; + auto solTables = std::unordered_map{}; for(int i = 0; i < vars.size(); ++i) { if (std::holds_alternative(vars[i])) { - solTables.try_emplace(i, *m_handler.GetState(), sol::create); + solTables.try_emplace(i, *_handler.GetState(), sol::create); auto indexTab = std::get(vars[i]); for (auto& [first, second] : indexTab) { @@ -530,7 +529,7 @@ void LogicHandler::SetVariables(const std::vector& vars, bool onlyLeve // create it if need be if (std::holds_alternative(vars[second])) { - solTables.try_emplace(second, *m_handler.GetState(), sol::create); + solTables.try_emplace(second, *_handler.GetState(), sol::create); solTables[i][vars[first]] = solTables[second]; } else if (std::holds_alternative(vars[second])) @@ -594,14 +593,14 @@ void LogicHandler::SetVariables(const std::vector& vars, bool onlyLeve sol::table levelVars = rootTable[ScriptReserved_LevelVars]; for (auto& [first, second] : levelVars) - (*m_handler.GetState())[ScriptReserved_LevelVars][first] = second; + (*_handler.GetState())[ScriptReserved_LevelVars][first] = second; if (onlyLevelVars) return; sol::table gameVars = rootTable[ScriptReserved_GameVars]; for (auto& [first, second] : gameVars) - (*m_handler.GetState())[ScriptReserved_GameVars][first] = second; + (*_handler.GetState())[ScriptReserved_GameVars][first] = second; } template @@ -623,10 +622,10 @@ int Handle(TypeFrom& var, MapType& varsMap, size_t& numVars, std::vector(key)) { path += "[" + std::to_string(std::get(key)) + "]"; @@ -635,9 +634,13 @@ std::string LogicHandler::GetRequestedPath() const { auto part = std::get(key); if (i > 0) + { path += "." + part; + } else + { path += part; + } } } @@ -647,15 +650,15 @@ std::string LogicHandler::GetRequestedPath() const // Used when saving. void LogicHandler::GetVariables(std::vector& vars) { - sol::table tab{ *m_handler.GetState(), sol::create }; - tab[ScriptReserved_LevelVars] = (*m_handler.GetState())[ScriptReserved_LevelVars]; - tab[ScriptReserved_GameVars] = (*m_handler.GetState())[ScriptReserved_GameVars]; + auto tab = sol::table(*_handler.GetState(), sol::create); + tab[ScriptReserved_LevelVars] = (*_handler.GetState())[ScriptReserved_LevelVars]; + tab[ScriptReserved_GameVars] = (*_handler.GetState())[ScriptReserved_GameVars]; - std::unordered_map varsMap; - std::unordered_map numMap; - std::unordered_map boolMap; + auto varsMap = std::unordered_map{}; + auto numMap = std::unordered_map{}; + auto boolMap = std::unordered_map{}; - size_t numVars = 0; + size_t varCount = 0; // The following functions will all try to put their values in a map. If it succeeds // then the value was not already in the map, so we can put it into the var vector. @@ -667,12 +670,12 @@ void LogicHandler::GetVariables(std::vector& vars) auto handleNum = [&](auto num, auto map) { - auto [first, second] = map.insert(std::make_pair(num, (int)numVars)); + auto [first, second] = map.insert(std::make_pair(num, (int)varCount)); if (second) { vars.push_back(num); - ++numVars; + ++varCount; } return first->second; @@ -681,12 +684,12 @@ void LogicHandler::GetVariables(std::vector& vars) auto handleStr = [&](const sol::object& obj) { auto str = obj.as(); - auto [first, second] = varsMap.insert(std::make_pair(str.data(), (int)numVars)); + auto [first, second] = varsMap.insert(std::make_pair(str.data(), (int)varCount)); if (second) { vars.push_back(std::string{ str.data() }); - ++numVars; + ++varCount; } return first->second; @@ -694,12 +697,12 @@ void LogicHandler::GetVariables(std::vector& vars) auto handleFuncName = [&](const LevelFunc& fnh) { - auto [first, second] = varsMap.insert(std::make_pair(&fnh, (int)numVars)); + auto [first, second] = varsMap.insert(std::make_pair(&fnh, (int)varCount)); if (second) { vars.push_back(FuncName{ std::string{ fnh.m_funcName } }); - ++numVars; + ++varCount; } return first->second; @@ -707,11 +710,11 @@ void LogicHandler::GetVariables(std::vector& vars) std::function populate = [&](const sol::table& obj) { - auto [first, second] = varsMap.insert(std::make_pair(obj.pointer(), (int)numVars)); + auto [first, second] = varsMap.insert(std::make_pair(obj.pointer(), (int)varCount)); if(second) { - ++numVars; + ++varCount; auto id = first->second; vars.push_back(IndexTable{}); @@ -729,7 +732,7 @@ void LogicHandler::GetVariables(std::vector& vars) { keyIndex = handleStr(first); key = std::string{ first.as().data() }; - m_savedVarPath.push_back(key); + _savedVarPath.push_back(key); } break; @@ -744,7 +747,7 @@ void LogicHandler::GetVariables(std::vector& vars) { keyIndex = handleNum(data, numMap); key = static_cast(data); - m_savedVarPath.push_back(key); + _savedVarPath.push_back(key); } } break; @@ -784,23 +787,23 @@ void LogicHandler::GetVariables(std::vector& vars) { if (second.is()) { - putInVars(Handle(second.as(), varsMap, numVars, vars)); + putInVars(Handle(second.as(), varsMap, varCount, vars)); } else if (second.is()) { - putInVars(Handle(second.as(), varsMap, numVars, vars)); + putInVars(Handle(second.as(), varsMap, varCount, vars)); } else if (second.is()) { - putInVars(Handle(second.as(), varsMap, numVars, vars)); + putInVars(Handle(second.as(), varsMap, varCount, vars)); } else if (second.is
                                                                      - +
                                                                      SoundSource:SetSoundID(name)Set the sound source's ID - TODO this and getSoundID should use enumsSet the sound source's ID
                                                                      @@ -270,7 +269,6 @@
                                                                      Set the sound source's ID - TODO this and getSoundID should use enums diff --git a/Documentation/doc/2 classes/View.DisplaySprite.html b/Documentation/doc/2 classes/View.DisplaySprite.html index 4548df0db..f9d3c07f0 100644 --- a/Documentation/doc/2 classes/View.DisplaySprite.html +++ b/Documentation/doc/2 classes/View.DisplaySprite.html @@ -200,7 +200,7 @@

                                                                      Parameters:

                                                                      • ID - ObjID + SpriteConstants of the sprite sequence object.
                                                                      • int @@ -250,7 +250,7 @@

                                                                        Returns:

                                                                          - ObjID + SpriteConstants Sprite sequence object ID.
                                                                        @@ -368,14 +368,14 @@ DisplaySprite:SetObjectID(New)
                                                                        - Set the sprite sequence object ID used by the display sprite. (Objects.ObjID) + Set the sprite sequence object ID used by the display sprite. (Objects.ObjID.SpriteConstants)

                                                                        Parameters:

                                                                        diff --git a/Documentation/doc/4 enums/Objects.ObjID.html b/Documentation/doc/4 enums/Objects.ObjID.html index 7d7426efa..74e2413d8 100644 --- a/Documentation/doc/4 enums/Objects.ObjID.html +++ b/Documentation/doc/4 enums/Objects.ObjID.html @@ -131,6 +131,10 @@ PickupConstants Objects.ObjID pickup constants. + + SpriteConstants + Objects.ObjID sprite constants. +
                                                                        @@ -145,7 +149,8 @@ Members
                                                                        - Objects.ObjID constants.

                                                                        + +

                                                                        Objects.ObjID constants.

                                                                        The following constants are inside ObjID.

                                                                        @@ -298,6 +303,7 @@ GLADIATOR CYBORG SNIPER CHEF +KOLD WINGED_MUMMY CENTAUR_MUTANT DOPPELGANGER @@ -322,14 +328,14 @@ SWORD_GUARDIAN SWORD_GUARDIAN_STATUE SHIVA SHIVA_STATUE -TRIBEBOSS +WILLARD CIVVY MUTANT2 LIZARD TONY_BOSS TONY_BOSS_FLAME PUNA_BOSS -SOPHIA_LEE_BOSS +SOPHIA_LEIGH_BOSS LASER_BOLT SKELETON MUMMY @@ -361,7 +367,7 @@ ATTACK_SUB IMP IMP_ROCK GUNSHIP -AUTOGUN +AUTO_GUN_VCI ROMAN_GOD1 ROMAN_GOD2 LAGOON_WITCH @@ -370,6 +376,7 @@ BOSS_EXPLOSION_SHOCKWAVE BOSS_EXPLOSION_RING CLAW_MUTANT WASP_MUTANT +TWIN_AUTO_GUN SKATEBOARD SKATEBOARD_KID WINSTON @@ -505,11 +512,6 @@ DAMOCLES_SWORD ELECTRIC_CLEANER SLAMMING_DOORS SWINGING_BLADE -ELECTRIC_BALL -ELECTRIC_BALL_IMPACT_POINT -THOR_HAMMER_HANDLE -THOR_HAMMER_HEAD -MOVING_LASER PUZZLE_ITEM1 PUZZLE_ITEM2 PUZZLE_ITEM3 @@ -742,7 +744,6 @@ BURNING_TORCH_ITEM CLOCKWORK_BEETLE CLOCKWORK_BEETLE_COMBO1 CLOCKWORK_BEETLE_COMBO2 - SWITCH_TYPE1 SWITCH_TYPE2 SWITCH_TYPE3 @@ -764,10 +765,10 @@ SHOOT_SWITCH2 SHOOT_SWITCH3 SHOOT_SWITCH4 AIRLOCK_SWITCH -ID_UNDERWATER_WALL_SWITCH_1 -ID_UNDERWATER_WALL_SWITCH_2 -ID_UNDERWATER_CEILING_SWITCH_1 -ID_UNDERWATER_CEILING_SWITCH_2 +UNDERWATER_WALL_SWITCH1 +UNDERWATER_WALL_SWITCH2 +UNDERWATER_CEILING_SWITCH1 +UNDERWATER_CEILING_SWITCH2 TURN_SWITCH COG_SWITCH LEVER_SWITCH @@ -914,7 +915,7 @@ FLOOR_LASERS KILL_ALL_TRIGGERS TRIGGER_TRIGGERER HIGH_OBJECT1 -HIGH_OBJECT2 +EMBER_EMITTER SMASH_OBJECT1 SMASH_OBJECT2 SMASH_OBJECT3 @@ -945,7 +946,6 @@ FISHTANK DOPPELGANGER_ORIGIN CORPSE WRAITH_TRAP -WATERFALL_EMITTER MESHSWAP1 MESHSWAP2 MESHSWAP3 @@ -1103,8 +1103,6 @@ BRIDGE_TILT3 BRIDGE_TILT4 BRIDGE_CUSTOM HORIZON -BINOCULAR_GRAPHICS -TARGET_GRAPHICS SKY_GRAPHICS DEFAULT_SPRITES MISC_SPRITES @@ -1119,31 +1117,20 @@ RUBBER_BOAT_WAVE_SPRITES SKIDOO_SNOW_TRAIL_SPRITES KAYAK_PADDLE_TRAIL_SPRITE KAYAK_WAKE_SPRTIES -BINOCULAR_GRAPHIC -LASER_SIGHT_GRAPHIC -CAUSTICS_TEXTURES -BAR_BORDER_GRAPHIC +BINOCULAR_GRAPHICS +LASERSIGHT_GRAPHICS +CAUSTIC_TEXTURES +BAR_BORDER_GRAPHICS HEALTH_BAR_TEXTURE AIR_BAR_TEXTURE DASH_BAR_TEXTURE SFX_BAR_TEXTURE -SPEEDOMETER -WATERFALL -CUSTOM_BAR_GRAPHIC -CUSTOM_AMMO_GRAPHIC -DIARY_SPRITES -DIARY_ENTRY_SPRITES - -PANEL_BORDER -PANEL_MIDDLE -PANEL_CORNER -PANEL_DIAGONAL -PANEL_STRIP -PANEL_HALF_BORDER1 -PANEL_HALF_BORDER2 -PANEL_MIDDLE_CORNER +CROSSHAIR_GRAPHICS +SPEEDOMETER_GRAPHICS +CUSTOM_BAR_GRAPHICS +CUSTOM_AMMO_GRAPHICS -

                                                                        Table of constants. + @@ -1158,7 +1145,8 @@ PANEL_MIDDLE_CORNER PickupConstants

                                                                        - Objects.ObjID pickup constants.

                                                                        + +

                                                                        Objects.ObjID pickup constants.

                                                                        The following ObjID members refer to pickups.

                                                                        @@ -1306,6 +1294,30 @@ PICKUP_ITEM15_COMBO1 PICKUP_ITEM15_COMBO2 PICKUP_ITEM16_COMBO1 PICKUP_ITEM16_COMBO2 +EXAMINE1 +EXAMINE2 +EXAMINE3 +EXAMINE4 +EXAMINE5 +EXAMINE6 +EXAMINE7 +EXAMINE8 +EXAMINE1_COMBO1 +EXAMINE1_COMBO2 +EXAMINE2_COMBO1 +EXAMINE2_COMBO2 +EXAMINE3_COMBO1 +EXAMINE3_COMBO2 +EXAMINE4_COMBO1 +EXAMINE4_COMBO2 +EXAMINE5_COMBO1 +EXAMINE5_COMBO2 +EXAMINE6_COMBO1 +EXAMINE6_COMBO2 +EXAMINE7_COMBO1 +EXAMINE7_COMBO2 +EXAMINE8_COMBO1 +EXAMINE8_COMBO2 HAMMER_ITEM CROWBAR_ITEM BURNING_TORCH_ITEM @@ -1343,10 +1355,57 @@ FLARE_INV_ITEM COMPASS_ITEM DIARY_ITEM STOPWATCH_ITEM +MEMCARD_LOAD_INV_ITEM +MEMCARD_SAVE_INV_ITEM PC_LOAD_INV_ITEM PC_SAVE_INV_ITEM -

                                                                        Table of constants. + + + + + + + + + +

                                                                        +
                                                                        + + SpriteConstants +
                                                                        +
                                                                        + +

                                                                        Objects.ObjID sprite constants.

                                                                        + +

                                                                        The following ObjID members refer to sprites.

                                                                        + +
                                                                        SKY_GRAPHICS
+DEFAULT_SPRITES
+MISC_SPRITES
+CUSTOM_SPRITES
+FIRE_SPRITES
+SMOKE_SPRITES
+SPARK_SPRITE
+DRIP_SPRITE
+EXPLOSION_SPRITES
+MOTORBOAT_FOAM_SPRITES
+RUBBER_BOAT_WAVE_SPRITES
+SKIDOO_SNOW_TRAIL_SPRITES
+KAYAK_PADDLE_TRAIL_SPRITE
+LASERSIGHT_GRAPHICS
+CAUSTIC_TEXTURES
+BAR_BORDER_GRAPHICS
+HEALTH_BAR_TEXTURE
+AIR_BAR_TEXTURE
+DASH_BAR_TEXTURE
+SFX_BAR_TEXTURE
+CROSSHAIR_GRAPHICS
+SPEEDOMETER_GRAPHICS
+CUSTOM_BAR_GRAPHICS
+CUSTOM_AMMO_GRAPHICS
+
                                                                        + diff --git a/Documentation/generate_objectlist.ps1 b/Documentation/generate_objectlist.ps1 new file mode 100644 index 000000000..c1c45b354 --- /dev/null +++ b/Documentation/generate_objectlist.ps1 @@ -0,0 +1,148 @@ +# PowerShell script to generate ObjectIDs.h from game_object_ids.h + +$inputFile = "../TombEngine/Objects/game_object_ids.h" # Adjust path if necessary. +$tempOutputFile = "../TombEngine/Scripting/Internal/TEN/Objects/temp.h" +$outputFile = "../TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h" + +# Read the input file +if (-Not (Test-Path $inputFile)) +{ + Write-Host "Error: File '$inputFile' not found." + exit 1 +} + +# Get the last modified times for both files. +$inputFileLastModified = (Get-Item $inputFile).LastWriteTime +if (Test-Path $outputFile) { + $outputFileLastModified = (Get-Item $outputFile).LastWriteTime +} else { + $outputFileLastModified = [datetime]::MinValue # If output file doesn't exist, treat it as very old. +} + +# Exit early if the output file is newer than the input file. +if ($outputFileLastModified -ge $inputFileLastModified) { + Write-Host "$outputFile is up to date. No changes made." + exit 0 +} + +$content = Get-Content $inputFile + +# Extract enum values and categorize them. +$enumValues = @() +$pickupConstants = @() +$spriteConstants = @() + +$inPickupSection = $false +$inSpriteSection = $false + +foreach ($line in $content) +{ + if ($line -match "^\s*ID_([A-Za-z0-9_]+)") + { + $enumName = $matches[1] + $enumValues += $enumName + + if ($enumName -match "_ITEM|EXAMINE") + { + $pickupConstants += $enumName + } + elseif ($enumName -match "_SPRITE|_GRAPHIC|TEXTURE") + { + # These two object IDs are deprecated 3D objects, not sprites. + if ($enumName -in @("BINOCULAR_GRAPHICS", "TARGET_GRAPHICS")) + { + continue + } + + $spriteConstants += $enumName + } + + } +} + +if ($enumValues.Count -gt 0) { $enumValues = $enumValues[1..($enumValues.Count - 2)] } + +# Generate ObjectIDs.h content. +$header = @" +#pragma once + +// Last generated on $(Get-Date -Format "dd/MM/yyyy") + +#include +#include +#include "Objects/game_object_ids.h" + +/*** +Constants for object IDs. +@enum Objects.ObjID +@pragma nostrip +*/ + +/*** Objects.ObjID constants. + +The following constants are inside ObjID. + +"@ + +$body = $enumValues | ForEach-Object { "`t$_" } +$footer = @" +@table Members +*/ +"@ + +# Pickup Constants Section. +$pickupHeader = @" + +/*** Objects.ObjID pickup constants. + +The following ObjID members refer to pickups. + +"@ + +$pickupBody = $pickupConstants | ForEach-Object { "`t$_" } +$pickupFooter = @" +@table PickupConstants +*/ +"@ + +# Sprite Constants Section. +$spriteHeader = @" + +/*** Objects.ObjID sprite constants. + +The following ObjID members refer to sprites. + +"@ + +$spriteBody = $spriteConstants | ForEach-Object { "`t$_" } +$spriteFooter = @" +@table SpriteConstants +*/ +"@ + +# Map definition. +$mapHeader = "static const std::unordered_map kObjIDs {" +$mapBody = ($enumValues | ForEach-Object { "`t" + '{ "' + "$_" + '", ID_' + "$_" + ' }' }) -join ",`r`n" +$mapFooter = "};" + +# Write to output file +$header | Set-Content $tempOutputFile +$body | Add-Content $tempOutputFile +$footer | Add-Content $tempOutputFile +$pickupHeader | Add-Content $tempOutputFile +$pickupBody | Add-Content $tempOutputFile +$pickupFooter | Add-Content $tempOutputFile +$spriteHeader | Add-Content $tempOutputFile +$spriteBody | Add-Content $tempOutputFile +$spriteFooter | Add-Content $tempOutputFile +$mapHeader | Add-Content $tempOutputFile +$mapBody | ForEach-Object { Add-Content $tempOutputFile $_ } +$mapFooter | Add-Content $tempOutputFile + +# Rename the temporary file to the final name. +if (Test-Path $outputFile) { + Remove-Item $outputFile -Force +} +Move-Item -Path $tempOutputFile -Destination $outputFile -Force + +Write-Host "Generated $outputFile successfully." \ No newline at end of file diff --git a/TombEngine/Game/Hud/Speedometer.cpp b/TombEngine/Game/Hud/Speedometer.cpp index 6253fc6ac..6167b203c 100644 --- a/TombEngine/Game/Hud/Speedometer.cpp +++ b/TombEngine/Game/Hud/Speedometer.cpp @@ -70,14 +70,14 @@ namespace TEN::Hud // Draw dial. AddDisplaySprite( - ID_SPEEDOMETER, DIAL_ELEMENT_SPRITE_ID, + ID_SPEEDOMETER_GRAPHICS, DIAL_ELEMENT_SPRITE_ID, POS, 0, SCALE, color, DIAL_PRIORITY, DisplaySpriteAlignMode::Center, DisplaySpriteScaleMode::Fit, BlendMode::AlphaBlend, DisplaySpritePhase::Draw); // Draw pointer. AddDisplaySprite( - ID_SPEEDOMETER, POINTER_ELEMENT_SPRITE_ID, + ID_SPEEDOMETER_GRAPHICS, POINTER_ELEMENT_SPRITE_ID, POS, pointerAngle + POINTER_ANGLE_OFFSET, SCALE, color, POINTER_PRIORITY, DisplaySpriteAlignMode::Center, DisplaySpriteScaleMode::Fit, BlendMode::AlphaBlend, DisplaySpritePhase::Draw); diff --git a/TombEngine/Game/Hud/TargetHighlighter.cpp b/TombEngine/Game/Hud/TargetHighlighter.cpp index a1d895216..fc30b0714 100644 --- a/TombEngine/Game/Hud/TargetHighlighter.cpp +++ b/TombEngine/Game/Hud/TargetHighlighter.cpp @@ -132,7 +132,7 @@ namespace TEN::Hud void CrosshairData::Draw() const { - constexpr auto SPRITE_SEQUENCE_OBJECT_ID = ID_CROSSHAIR; + constexpr auto SPRITE_SEQUENCE_OBJECT_ID = ID_CROSSHAIR_GRAPHICS; constexpr auto STATIC_ELEMENT_SPRITE_ID = 0; constexpr auto SEGMENT_ELEMENT_SPRITE_ID = 1; constexpr auto PRIORITY = 0; // TODO: Check later. May interfere with Lua display sprites. -- Sezz 2023.10.06 diff --git a/TombEngine/Objects/Generic/generic_objects.cpp b/TombEngine/Objects/Generic/generic_objects.cpp index 5e09d44ba..8f10a3420 100644 --- a/TombEngine/Objects/Generic/generic_objects.cpp +++ b/TombEngine/Objects/Generic/generic_objects.cpp @@ -176,7 +176,7 @@ void StartSwitches(ObjectInfo* object) object->shadowType = ShadowMode::All; } - for (int objectID = ID_UNDERWATER_WALL_SWITCH_1; objectID <= ID_UNDERWATER_WALL_SWITCH_2; objectID++) + for (int objectID = ID_UNDERWATER_WALL_SWITCH1; objectID <= ID_UNDERWATER_WALL_SWITCH2; objectID++) { object = &Objects[objectID]; if (object->loaded) @@ -186,7 +186,7 @@ void StartSwitches(ObjectInfo* object) } } - for (int objectID = ID_UNDERWATER_CEILING_SWITCH_1; objectID <= ID_UNDERWATER_CEILING_SWITCH_2; objectID++) + for (int objectID = ID_UNDERWATER_CEILING_SWITCH1; objectID <= ID_UNDERWATER_CEILING_SWITCH2; objectID++) { object = &Objects[objectID]; if (object->loaded) diff --git a/TombEngine/Objects/game_object_ids.h b/TombEngine/Objects/game_object_ids.h index ab81af1db..edeacf284 100644 --- a/TombEngine/Objects/game_object_ids.h +++ b/TombEngine/Objects/game_object_ids.h @@ -630,10 +630,10 @@ enum GAME_OBJECT_ID : short ID_SHOOT_SWITCH3, ID_SHOOT_SWITCH4, ID_AIRLOCK_SWITCH, - ID_UNDERWATER_WALL_SWITCH_1, - ID_UNDERWATER_WALL_SWITCH_2, - ID_UNDERWATER_CEILING_SWITCH_1, - ID_UNDERWATER_CEILING_SWITCH_2, + ID_UNDERWATER_WALL_SWITCH1, + ID_UNDERWATER_WALL_SWITCH2, + ID_UNDERWATER_CEILING_SWITCH1, + ID_UNDERWATER_CEILING_SWITCH2, ID_TURN_SWITCH, ID_COG_SWITCH, ID_LEVER_SWITCH, @@ -979,9 +979,10 @@ enum GAME_OBJECT_ID : short ID_BRIDGE_CUSTOM, ID_HORIZON = 1350, - ID_BINOCULAR_GRAPHICS, - ID_TARGET_GRAPHICS, - ID_SKY_GRAPHICS, + + // Sprite sequences. + + ID_SKY_GRAPHICS = 1353, ID_DEFAULT_SPRITES, ID_MISC_SPRITES, ID_CUSTOM_SPRITES, @@ -996,30 +997,22 @@ enum GAME_OBJECT_ID : short ID_SKIDOO_SNOW_TRAIL_SPRITES, ID_KAYAK_PADDLE_TRAIL_SPRITE, ID_KAYAK_WAKE_SPRTIES, - ID_BINOCULAR_GRAPHIC, - ID_LASER_SIGHT_GRAPHIC, - ID_CAUSTICS_TEXTURES, - ID_BAR_BORDER_GRAPHIC, + ID_BINOCULAR_GRAPHICS, + ID_LASERSIGHT_GRAPHICS, + ID_CAUSTIC_TEXTURES, + ID_BAR_BORDER_GRAPHICS, ID_HEALTH_BAR_TEXTURE, ID_AIR_BAR_TEXTURE, ID_DASH_BAR_TEXTURE, ID_SFX_BAR_TEXTURE, ID_WATERFALL_SPRITES, // 1379 - ID_CROSSHAIR = 1380, - ID_SPEEDOMETER, - ID_CUSTOM_BAR_GRAPHIC, - ID_CUSTOM_AMMO_GRAPHIC, + ID_CROSSHAIR_GRAPHICS = 1380, + ID_SPEEDOMETER_GRAPHICS, + ID_CUSTOM_BAR_GRAPHICS, + ID_CUSTOM_AMMO_GRAPHICS, ID_DIARY_SPRITES, ID_DIARY_ENTRY_SPRITES, - ID_PANEL_BORDER = 1400, - ID_PANEL_MIDDLE, - ID_PANEL_CORNER, - ID_PANEL_DIAGONAL, - ID_PANEL_STRIP, - ID_PANEL_HALF_BORDER1, - ID_PANEL_HALF_BORDER2, - ID_PANEL_MIDDLE_CORNER, ID_NUMBER_OBJECTS }; diff --git a/TombEngine/Renderer/RendererCompatibility.cpp b/TombEngine/Renderer/RendererCompatibility.cpp index e8cc46136..7ae2ef7d5 100644 --- a/TombEngine/Renderer/RendererCompatibility.cpp +++ b/TombEngine/Renderer/RendererCompatibility.cpp @@ -883,7 +883,7 @@ namespace TEN::Renderer _spriteSequences[SpriteSequencesIds[i]] = sequence; - if (SpriteSequencesIds[i] == ID_CAUSTICS_TEXTURES) + if (SpriteSequencesIds[i] == ID_CAUSTIC_TEXTURES) { _causticTextures.clear(); for (int j = 0; j < sequence.SpritesList.size(); j++) diff --git a/TombEngine/Renderer/RendererDraw.cpp b/TombEngine/Renderer/RendererDraw.cpp index bd6b84344..de5ab3544 100644 --- a/TombEngine/Renderer/RendererDraw.cpp +++ b/TombEngine/Renderer/RendererDraw.cpp @@ -2704,8 +2704,8 @@ namespace TEN::Renderer // Bind caustics texture. if (_causticTextures.size() > 0) { - int nmeshes = -Objects[ID_CAUSTICS_TEXTURES].nmeshes; - int meshIndex = Objects[ID_CAUSTICS_TEXTURES].meshIndex; + int nmeshes = -Objects[ID_CAUSTIC_TEXTURES].nmeshes; + int meshIndex = Objects[ID_CAUSTIC_TEXTURES].meshIndex; int causticsFrame = GlobalCounter % _causticTextures.size(); BindTexture(TextureRegister::CausticsMap, &_causticTextures[causticsFrame], SamplerStateRegister::AnisotropicClamp); } diff --git a/TombEngine/Renderer/RendererDraw2D.cpp b/TombEngine/Renderer/RendererDraw2D.cpp index 8dd4434a8..cf5648e3f 100644 --- a/TombEngine/Renderer/RendererDraw2D.cpp +++ b/TombEngine/Renderer/RendererDraw2D.cpp @@ -119,7 +119,7 @@ namespace TEN::Renderer void Renderer::DrawBar(float percent, const RendererHudBar& bar, GAME_OBJECT_ID textureSlot, int frame, bool isPoisoned) { - if (!CheckIfSlotExists(ID_BAR_BORDER_GRAPHIC, "Bar rendering")) + if (!CheckIfSlotExists(ID_BAR_BORDER_GRAPHICS, "Bar rendering")) return; unsigned int strides = sizeof(Vertex); @@ -141,7 +141,7 @@ namespace TEN::Renderer BindConstantBufferVS(ConstantBufferRegister::Hud, _cbHUD.get()); - RendererSprite* borderSprite = &_sprites[Objects[ID_BAR_BORDER_GRAPHIC].meshIndex]; + RendererSprite* borderSprite = &_sprites[Objects[ID_BAR_BORDER_GRAPHICS].meshIndex]; _stHUDBar.BarStartUV = borderSprite->UV[0]; _stHUDBar.BarScale = Vector2(borderSprite->Width / (float)borderSprite->Texture->Width, borderSprite->Height / (float)borderSprite->Texture->Height); _cbHUDBar.UpdateData(_stHUDBar, _context.Get()); @@ -266,11 +266,11 @@ namespace TEN::Renderer if (Lara.Control.Look.OpticRange != 0 && !Lara.Control.Look.IsUsingLasersight) { - DrawFullScreenSprite(&_sprites[Objects[ID_BINOCULAR_GRAPHIC].meshIndex], Vector3::One, false); + DrawFullScreenSprite(&_sprites[Objects[ID_BINOCULAR_GRAPHICS].meshIndex], Vector3::One, false); } else if (Lara.Control.Look.OpticRange != 0 && Lara.Control.Look.IsUsingLasersight) { - DrawFullScreenSprite(&_sprites[Objects[ID_LASER_SIGHT_GRAPHIC].meshIndex], Vector3::One); + DrawFullScreenSprite(&_sprites[Objects[ID_LASERSIGHT_GRAPHICS].meshIndex], Vector3::One); SetBlendMode(BlendMode::Opaque); diff --git a/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h b/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h index eeeb8e7fa..ac4294029 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h +++ b/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h @@ -1,6 +1,6 @@ #pragma once -// Last generated on 18/11/2022 +// Last generated on 11/03/2025 #include #include @@ -165,6 +165,7 @@ The following constants are inside ObjID. CYBORG SNIPER CHEF + KOLD WINGED_MUMMY CENTAUR_MUTANT DOPPELGANGER @@ -189,14 +190,14 @@ The following constants are inside ObjID. SWORD_GUARDIAN_STATUE SHIVA SHIVA_STATUE - TRIBEBOSS + WILLARD CIVVY MUTANT2 LIZARD TONY_BOSS TONY_BOSS_FLAME PUNA_BOSS - SOPHIA_LEE_BOSS + SOPHIA_LEIGH_BOSS LASER_BOLT SKELETON MUMMY @@ -228,7 +229,7 @@ The following constants are inside ObjID. IMP IMP_ROCK GUNSHIP - AUTOGUN + AUTO_GUN_VCI ROMAN_GOD1 ROMAN_GOD2 LAGOON_WITCH @@ -237,6 +238,7 @@ The following constants are inside ObjID. BOSS_EXPLOSION_RING CLAW_MUTANT WASP_MUTANT + TWIN_AUTO_GUN SKATEBOARD SKATEBOARD_KID WINSTON @@ -372,11 +374,6 @@ The following constants are inside ObjID. ELECTRIC_CLEANER SLAMMING_DOORS SWINGING_BLADE - ELECTRIC_BALL - ELECTRIC_BALL_IMPACT_POINT - THOR_HAMMER_HANDLE - THOR_HAMMER_HEAD - MOVING_LASER PUZZLE_ITEM1 PUZZLE_ITEM2 PUZZLE_ITEM3 @@ -609,7 +606,6 @@ The following constants are inside ObjID. CLOCKWORK_BEETLE CLOCKWORK_BEETLE_COMBO1 CLOCKWORK_BEETLE_COMBO2 - SWITCH_TYPE1 SWITCH_TYPE2 SWITCH_TYPE3 @@ -631,10 +627,10 @@ The following constants are inside ObjID. SHOOT_SWITCH3 SHOOT_SWITCH4 AIRLOCK_SWITCH - ID_UNDERWATER_WALL_SWITCH_1 - ID_UNDERWATER_WALL_SWITCH_2 - ID_UNDERWATER_CEILING_SWITCH_1 - ID_UNDERWATER_CEILING_SWITCH_2 + UNDERWATER_WALL_SWITCH1 + UNDERWATER_WALL_SWITCH2 + UNDERWATER_CEILING_SWITCH1 + UNDERWATER_CEILING_SWITCH2 TURN_SWITCH COG_SWITCH LEVER_SWITCH @@ -781,7 +777,7 @@ The following constants are inside ObjID. KILL_ALL_TRIGGERS TRIGGER_TRIGGERER HIGH_OBJECT1 - HIGH_OBJECT2 + EMBER_EMITTER SMASH_OBJECT1 SMASH_OBJECT2 SMASH_OBJECT3 @@ -812,7 +808,6 @@ The following constants are inside ObjID. DOPPELGANGER_ORIGIN CORPSE WRAITH_TRAP - WATERFALL_EMITTER MESHSWAP1 MESHSWAP2 MESHSWAP3 @@ -970,8 +965,6 @@ The following constants are inside ObjID. BRIDGE_TILT4 BRIDGE_CUSTOM HORIZON - BINOCULAR_GRAPHICS - TARGET_GRAPHICS SKY_GRAPHICS DEFAULT_SPRITES MISC_SPRITES @@ -986,30 +979,18 @@ The following constants are inside ObjID. SKIDOO_SNOW_TRAIL_SPRITES KAYAK_PADDLE_TRAIL_SPRITE KAYAK_WAKE_SPRTIES - BINOCULAR_GRAPHIC - LASER_SIGHT_GRAPHIC - CAUSTICS_TEXTURES - BAR_BORDER_GRAPHIC + BINOCULAR_GRAPHICS + LASERSIGHT_GRAPHICS + CAUSTIC_TEXTURES + BAR_BORDER_GRAPHICS HEALTH_BAR_TEXTURE AIR_BAR_TEXTURE DASH_BAR_TEXTURE SFX_BAR_TEXTURE - SPEEDOMETER - WATERFALL - CUSTOM_BAR_GRAPHIC - CUSTOM_AMMO_GRAPHIC - DIARY_SPRITES - DIARY_ENTRY_SPRITES - - PANEL_BORDER - PANEL_MIDDLE - PANEL_CORNER - PANEL_DIAGONAL - PANEL_STRIP - PANEL_HALF_BORDER1 - PANEL_HALF_BORDER2 - PANEL_MIDDLE_CORNER -Table of constants. + CROSSHAIR_GRAPHICS + SPEEDOMETER_GRAPHICS + CUSTOM_BAR_GRAPHICS + CUSTOM_AMMO_GRAPHICS @table Members */ @@ -1161,6 +1142,30 @@ The following ObjID members refer to pickups. PICKUP_ITEM15_COMBO2 PICKUP_ITEM16_COMBO1 PICKUP_ITEM16_COMBO2 + EXAMINE1 + EXAMINE2 + EXAMINE3 + EXAMINE4 + EXAMINE5 + EXAMINE6 + EXAMINE7 + EXAMINE8 + EXAMINE1_COMBO1 + EXAMINE1_COMBO2 + EXAMINE2_COMBO1 + EXAMINE2_COMBO2 + EXAMINE3_COMBO1 + EXAMINE3_COMBO2 + EXAMINE4_COMBO1 + EXAMINE4_COMBO2 + EXAMINE5_COMBO1 + EXAMINE5_COMBO2 + EXAMINE6_COMBO1 + EXAMINE6_COMBO2 + EXAMINE7_COMBO1 + EXAMINE7_COMBO2 + EXAMINE8_COMBO1 + EXAMINE8_COMBO2 HAMMER_ITEM CROWBAR_ITEM BURNING_TORCH_ITEM @@ -1198,14 +1203,44 @@ The following ObjID members refer to pickups. COMPASS_ITEM DIARY_ITEM STOPWATCH_ITEM + MEMCARD_LOAD_INV_ITEM + MEMCARD_SAVE_INV_ITEM PC_LOAD_INV_ITEM PC_SAVE_INV_ITEM -Table of constants. @table PickupConstants */ -static const auto GAME_OBJECT_IDS = std::unordered_map -{ +/*** Objects.ObjID sprite constants. + +The following ObjID members refer to sprites. + + SKY_GRAPHICS + DEFAULT_SPRITES + MISC_SPRITES + CUSTOM_SPRITES + FIRE_SPRITES + SMOKE_SPRITES + SPARK_SPRITE + DRIP_SPRITE + EXPLOSION_SPRITES + MOTORBOAT_FOAM_SPRITES + RUBBER_BOAT_WAVE_SPRITES + SKIDOO_SNOW_TRAIL_SPRITES + KAYAK_PADDLE_TRAIL_SPRITE + LASERSIGHT_GRAPHICS + CAUSTIC_TEXTURES + BAR_BORDER_GRAPHICS + HEALTH_BAR_TEXTURE + AIR_BAR_TEXTURE + DASH_BAR_TEXTURE + SFX_BAR_TEXTURE + CROSSHAIR_GRAPHICS + SPEEDOMETER_GRAPHICS + CUSTOM_BAR_GRAPHICS + CUSTOM_AMMO_GRAPHICS +@table SpriteConstants +*/ +static const std::unordered_map GAME_OBJECT_IDS { { "LARA", ID_LARA }, { "LARA_EXTRA_ANIMS", ID_LARA_EXTRA_ANIMS }, { "PISTOLS_ANIM", ID_PISTOLS_ANIM }, @@ -1355,6 +1390,7 @@ static const auto GAME_OBJECT_IDS = std::unordered_map - SETLOCAL EnableDelayedExpansion - -SET SchemaDir=$(ProjectDir)Specific\savegame\schema -SET TimestampFile=$(TargetDir)flatbuffers.timestamp - -FOR %%F IN ("%SchemaDir%\ten_itemdata.fbs" "%SchemaDir%\ten_savegame.fbs") DO ( - SET "CurrentTimestamp=!CurrentTimestamp! %%~tF" -) - -IF EXIST "%TimestampFile%" ( - SET /P LastTimestamp=<"%TimestampFile%" -) - -SET CurrentTimestamp=%CurrentTimestamp: =% -SET LastTimestamp=%LastTimestamp: =% - -IF "%CurrentTimestamp%" == "%LastTimestamp%" ( - ECHO Skipping gen.bat, schema files are unchanged -) ELSE ( - ECHO Generating savegame code from flatbuffer schema... - CD "%SchemaDir%" - CALL gen.bat - ECHO !CurrentTimestamp! > "%TimestampFile%" -) - -ENDLOCAL + powershell -ExecutionPolicy Bypass -File "$(SolutionDir)\Documentation\generate_objectlist.ps1" +powershell -ExecutionPolicy Bypass -File "$(ProjectDir)Specific\savegame\schema\generate_code.ps1" CD "$(ProjectDir)..\Documentation\" CALL compile.bat . @@ -228,32 +204,8 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. - SETLOCAL EnableDelayedExpansion - -SET SchemaDir=$(ProjectDir)Specific\savegame\schema -SET TimestampFile=$(TargetDir)flatbuffers.timestamp - -FOR %%F IN ("%SchemaDir%\ten_itemdata.fbs" "%SchemaDir%\ten_savegame.fbs") DO ( - SET "CurrentTimestamp=!CurrentTimestamp! %%~tF" -) - -IF EXIST "%TimestampFile%" ( - SET /P LastTimestamp=<"%TimestampFile%" -) - -SET CurrentTimestamp=%CurrentTimestamp: =% -SET LastTimestamp=%LastTimestamp: =% - -IF "%CurrentTimestamp%" == "%LastTimestamp%" ( - ECHO Skipping gen.bat, schema files are unchanged -) ELSE ( - ECHO Generating savegame code from flatbuffer schema... - CD "%SchemaDir%" - CALL gen.bat - ECHO !CurrentTimestamp! > "%TimestampFile%" -) - -ENDLOCAL + powershell -ExecutionPolicy Bypass -File "$(SolutionDir)\Documentation\generate_objectlist.ps1" +powershell -ExecutionPolicy Bypass -File "$(ProjectDir)Specific\savegame\schema\generate_code.ps1" CD "$(ProjectDir)..\Documentation\" CALL compile.bat . @@ -330,7 +282,9 @@ del "$(TargetDir)*.exp" /q del "$(TargetDir)OIS_d.dll" /q - CD "$(ProjectDir)..\Documentation\" + powershell -ExecutionPolicy Bypass -File "$(SolutionDir)\Documentation\generate_objectlist.ps1" + +CD "$(ProjectDir)..\Documentation\" CALL compile.bat . CD "$(ProjectDir)Specific\savegame\schema\" @@ -409,7 +363,9 @@ del "$(TargetDir)*.exp" /q del "$(TargetDir)OIS_d.dll" /q - CD "$(ProjectDir)..\Documentation\" + powershell -ExecutionPolicy Bypass -File "$(SolutionDir)\Documentation\generate_objectlist.ps1" + +CD "$(ProjectDir)..\Documentation\" CALL compile.bat . CD "$(ProjectDir)Specific\savegame\schema\" From 3046f5f4a2c0a8985e4e35bf852ff941376fbdd9 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Wed, 12 Mar 2025 01:34:48 +0300 Subject: [PATCH 044/160] Refactor scripting documentation and flow data types to use fields instead of getters and setters (#1609) * Initial commit * Minor changes * Rename Flow.Starfield to Flow.StarField * Added cross-referencing, fixed some descriptions * Start page LDoc cleanup * Proofread sound module documentation * Fixed Vec2 docs * Update FlowLevel.cpp * Fixed incorrect tag * Update CHANGELOG.md * Allow to refresh starfield in runtime * Update weather.cpp * Dynamically change amount of stars * Update CHANGELOG.md * Update CHANGELOG.md * Remove brackets in room class documentation * Added operators for Rotation class * Rephrase a little * Minor nitpicks --------- Co-authored-by: Sezz --- CHANGELOG.md | 5 +- Documentation/config.ld | 18 +- Documentation/doc/1 modules/Effects.html | 4 +- Documentation/doc/1 modules/Flow.html | 4 +- Documentation/doc/1 modules/Input.html | 4 +- Documentation/doc/1 modules/Inventory.html | 4 +- Documentation/doc/1 modules/Logic.html | 4 +- Documentation/doc/1 modules/Objects.html | 4 +- Documentation/doc/1 modules/Sound.html | 92 ++--- Documentation/doc/1 modules/Strings.html | 4 +- Documentation/doc/1 modules/Util.html | 4 +- Documentation/doc/1 modules/View.html | 4 +- .../doc/2 classes/Collision.Probe.html | 4 +- Documentation/doc/2 classes/Flow.Level.html | 49 ++- .../doc/2 classes/Flow.Settings.html | 4 +- .../doc/2 classes/Flow.Statistics.html | 4 +- .../doc/2 classes/Objects.AIObject.html | 4 +- .../doc/2 classes/Objects.Camera.html | 4 +- .../doc/2 classes/Objects.LaraObject.html | 4 +- .../doc/2 classes/Objects.Moveable.html | 6 +- Documentation/doc/2 classes/Objects.Room.html | 24 +- Documentation/doc/2 classes/Objects.Sink.html | 4 +- .../doc/2 classes/Objects.SoundSource.html | 4 +- .../doc/2 classes/Objects.Static.html | 4 +- .../doc/2 classes/Objects.Volume.html | 4 +- .../doc/2 classes/Strings.DisplayString.html | 4 +- .../doc/2 classes/View.DisplaySprite.html | 4 +- .../doc/3 primitive classes/Color.html | 4 +- .../doc/3 primitive classes/Flow.Fog.html | 10 +- .../doc/3 primitive classes/Flow.Horizon.html | 379 +++++------------- .../Flow.InventoryItem.html | 8 +- .../3 primitive classes/Flow.LensFlare.html | 334 +++++---------- .../3 primitive classes/Flow.SkyLayer.html | 6 +- .../3 primitive classes/Flow.Starfield.html | 369 +++++------------ .../doc/3 primitive classes/Rotation.html | 4 +- .../doc/3 primitive classes/Time.html | 4 +- .../doc/3 primitive classes/Vec2.html | 86 ++-- .../doc/3 primitive classes/Vec3.html | 4 +- .../doc/4 enums/Collision.MaterialType.html | 4 +- .../doc/4 enums/Effects.BlendID.html | 4 +- .../doc/4 enums/Effects.EffectID.html | 4 +- .../doc/4 enums/Effects.FeatherMode.html | 4 +- .../Effects.ParticleAnimationType.html | 8 +- Documentation/doc/4 enums/Flow.ErrorMode.html | 4 +- .../doc/4 enums/Flow.FreezeMode.html | 4 +- .../doc/4 enums/Flow.GameStatus.html | 4 +- Documentation/doc/4 enums/Input.ActionID.html | 4 +- .../doc/4 enums/Objects.AmmoType.html | 4 +- .../doc/4 enums/Objects.HandStatus.html | 4 +- .../doc/4 enums/Objects.MoveableStatus.html | 4 +- Documentation/doc/4 enums/Objects.ObjID.html | 4 +- .../doc/4 enums/Objects.RoomFlagID.html | 4 +- .../doc/4 enums/Objects.RoomReverb.html | 4 +- .../doc/4 enums/Objects.WeaponType.html | 4 +- .../doc/4 enums/Sound.SoundTrackType.html | 4 +- .../4 enums/Strings.DisplayStringOption.html | 4 +- Documentation/doc/4 enums/Util.LogLevel.html | 4 +- Documentation/doc/4 enums/View.AlignMode.html | 4 +- .../doc/4 enums/View.CameraType.html | 4 +- .../doc/4 enums/View.PostProcessMode.html | 4 +- Documentation/doc/4 enums/View.ScaleMode.html | 4 +- .../doc/5 lua utility modules/CustomBar.html | 4 +- .../doc/5 lua utility modules/Diary.html | 4 +- .../5 lua utility modules/EventSequence.html | 4 +- .../doc/5 lua utility modules/Timer.html | 4 +- .../doc/5 lua utility modules/Type.html | 4 +- Documentation/doc/index.html | 30 +- TombEngine/Game/effects/weather.cpp | 73 ++-- .../Scripting/Include/ScriptInterfaceLevel.h | 2 - .../Scripting/Internal/ReservedScriptNames.h | 19 - .../Internal/TEN/Effects/ParticleAnimTypes.h | 2 +- .../Scripting/Internal/TEN/Flow/Fog/Fog.cpp | 2 +- .../Internal/TEN/Flow/Horizon/Horizon.cpp | 78 ++-- .../TEN/Flow/InventoryItem/InventoryItem.cpp | 4 +- .../Internal/TEN/Flow/LensFlare/LensFlare.cpp | 64 +-- .../Internal/TEN/Flow/LensFlare/LensFlare.h | 3 +- .../Internal/TEN/Flow/Level/FlowLevel.cpp | 38 +- .../Internal/TEN/Flow/Level/FlowLevel.h | 2 - .../Internal/TEN/Flow/SkyLayer/SkyLayer.cpp | 4 +- .../Internal/TEN/Flow/Starfield/Starfield.cpp | 76 ++-- .../Internal/TEN/Flow/Starfield/Starfield.h | 2 - .../TEN/Objects/Moveable/MoveableObject.cpp | 2 +- .../Internal/TEN/Objects/Room/RoomObject.cpp | 20 +- .../Internal/TEN/Sound/SoundHandler.cpp | 68 ++-- .../Internal/TEN/Types/Rotation/Rotation.cpp | 40 ++ .../Internal/TEN/Types/Rotation/Rotation.h | 11 + .../Internal/TEN/Types/Vec2/Vec2.cpp | 24 +- 87 files changed, 840 insertions(+), 1326 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 301a29fcb..983158c3e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -34,7 +34,6 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added TR4 Statue Plinth. ### Lua API changes - * Added Collision.Probe class for basic room collision detection. * Added advanced particle emitter allowing animations and other effects. * Added diary module. @@ -46,11 +45,13 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added Effects.EmitStreamer() function to emit streamers. * Added Moveable:GetScale() and Movebale:SetScale() methods to set visible scale of moveables. * Added Rotation:Lerp() function to allow linear interpolation between rotations. +* Added ability to perform additive and subtractive operations on Rotation class and compare one Rotation to another. * Added various Translate() methods to Vec2 and Vec3 script objects. * Added alpha transparency functionality for statics and moveables to be used with SetColor() method. * Added extra arguments for sprite object slots and starting rotation value for EmitParticle function. -* Added ability to save Flow.Level fields such as fog or horizon to a savegame. +* Added ability to dynamically change Flow.Level fields such as fog, starfield or horizon, and save them to a savegame. * Added pickup count to Flow.Statistics class. +* Changed Flow.StarField and Flow.LensFlare primitive types to use parameters instead of getters and setters. * Fixed medipack level count in Flow.Statistics class. ## [Version 1.7.1](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.7.4) - 2025-04-01 diff --git a/Documentation/config.ld b/Documentation/config.ld index bae3388cd..abc23eb0c 100644 --- a/Documentation/config.ld +++ b/Documentation/config.ld @@ -12,27 +12,27 @@ new_type("luautil", "5 Lua utility modules", true) not_luadoc = true -local version = "1.7.2 (Developer)" +local version = "1.8" project = " TombEngine" title = "TombEngine " .. version .. " Lua API" description = "TombEngine " .. version .. " scripting interface" -full_description = [[Welcome to the TombEngine scripting API. This is a work in progress and some information might be wrong or outdated. Please also note that this is primarily a reference document, not a tutorial, so expect descriptions to be fairly sparse. +full_description = [[Welcome to the TombEngine scripting API. +Note that this is primarily a reference document, not a tutorial, so expect descriptions to be fairly sparse. At the time of writing, there is a tutorial describing the basics of Lua, as well as a number of example scripts, on the TombEngine website. -####Module Hierarchy (boring but important) -Other than the "special tables" (GameVars, LevelVars and LevelFuncs), every module described herein is held in a master table called TEN. + +####Module Hierarchy +Other than the "special tables" (`GameVars`, `LevelVars` and `LevelFuncs`), every module described herein is held in a master table called TEN. For convenience, these modules and classes are automatically put in the global table. For example, you can call GetMoveableByName either of these two ways: local door = TEN.Objects.GetMoveableByName("door_type4_14") local door = GetMoveableByName("door_type4_14") ####Always check logs/TENLog.txt -If you are scripting levels, TombEngine will often kick you back to the title screen, even if `errorMode` (see Flow.Settings) is set to `ErrorMode.WARN` or `ErrorMode.SILENT`. +If you are scripting levels, TombEngine will often kick you back to the title screen, even if `errorMode` (see @{Flow.Settings}) is set to `ErrorMode.WARN` or `ErrorMode.SILENT`. -This might get annoying, but it's on purpose. If your Lua script contains a syntax error (e.g. you're missing `end` at the end of a function), the Lua interpreter will not be able to continue running the script. If it tried to keep running, you'd probably see some pretty strange behaviour, and would possibly get a crash regardless. +This might get annoying, but it's on purpose. If your Lua script contains a syntax error (e.g. you're missing `end` at the end of a function), the Lua interpreter will not be able to continue running the script. If it tried to keep running, you'd probably see some pretty strange behaviour, and would possibly get a crash regardless. If this happens, check __logs/TENLog.txt__ and look for an error message with the word "unrecoverable". -If this happens, check __logs/TENLog.txt__ and look for an error message with the word "unrecoverable". - -Enjoy. +Happy building! \- _squidshire and the TombEngine development team._ ]] diff --git a/Documentation/doc/1 modules/Effects.html b/Documentation/doc/1 modules/Effects.html index 3e7751034..1a475096e 100644 --- a/Documentation/doc/1 modules/Effects.html +++ b/Documentation/doc/1 modules/Effects.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/1 modules/Flow.html b/Documentation/doc/1 modules/Flow.html index 4d7ffc676..2adf40fd9 100644 --- a/Documentation/doc/1 modules/Flow.html +++ b/Documentation/doc/1 modules/Flow.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/1 modules/Input.html b/Documentation/doc/1 modules/Input.html index ab68d0a53..7e0bbc989 100644 --- a/Documentation/doc/1 modules/Input.html +++ b/Documentation/doc/1 modules/Input.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/1 modules/Inventory.html b/Documentation/doc/1 modules/Inventory.html index b16cba1f0..67a567fc8 100644 --- a/Documentation/doc/1 modules/Inventory.html +++ b/Documentation/doc/1 modules/Inventory.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/1 modules/Logic.html b/Documentation/doc/1 modules/Logic.html index 607c77c99..e1e0aa7df 100644 --- a/Documentation/doc/1 modules/Logic.html +++ b/Documentation/doc/1 modules/Logic.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/1 modules/Objects.html b/Documentation/doc/1 modules/Objects.html index ae8c45650..3f9e4d031 100644 --- a/Documentation/doc/1 modules/Objects.html +++ b/Documentation/doc/1 modules/Objects.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/1 modules/Sound.html b/Documentation/doc/1 modules/Sound.html index 5cfa41484..4c8cf0da5 100644 --- a/Documentation/doc/1 modules/Sound.html +++ b/Documentation/doc/1 modules/Sound.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • @@ -124,40 +124,40 @@

                                                                        Functions

                                                                        - - + + - + - + - + - + - - + + - - + + - - + + - + @@ -174,22 +174,22 @@
                                                                        - PlayAudioTrack(name, type) + PlayAudioTrack(filename, type)
                                                                        - Play an audio track + Play an audio track. Supported formats are wav, mp3 and ogg.

                                                                        Parameters:

                                                                          -
                                                                        • name +
                                                                        • filename string - of track (without file extension) to play + Filename of a track (without file extension) to play.
                                                                        • type SoundTrackType - of the audio track to play + Type of the audio track to play.
                                                                        @@ -203,7 +203,7 @@ SetAmbientTrack(name, fromStart)
                                                                        - Set and play an ambient track + Set and play an ambient track. @@ -211,11 +211,11 @@
                                                                        • name string - of track (without file extension) to play + Name of track (without file extension) to play.
                                                                        • fromStart bool - specifies whether ambient track should play from the start, or crossfade at a random position + Specifies whether ambient track should play from the start, or crossfade at a random position.
                                                                        @@ -229,7 +229,7 @@ StopAudioTracks()
                                                                        - Stop any audio tracks currently playing + Stop any audio tracks currently playing. @@ -244,7 +244,7 @@ StopAudioTrack(type)
                                                                        - Stop audio track that is currently playing + Stop audio track that is currently playing. @@ -252,7 +252,7 @@ @@ -266,7 +266,7 @@ GetAudioTrackLoudness(type)
                                                                        - Get current loudness level for specified track type + Get current loudness level for specified track type. @@ -274,7 +274,7 @@ @@ -282,7 +282,7 @@
                                                                          float - current loudness of a specified audio track + Current loudness of a specified audio track.
                                                                        @@ -291,18 +291,18 @@
                                                                        - PlaySound(sound[, position]) + PlaySound(soundID[, position])
                                                                        - Play sound effect + Play sound effect.

                                                                        Parameters:

                                                                          -
                                                                        • sound +
                                                                        • soundID int - ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. + Sound ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window.
                                                                        • position Vec3 @@ -318,18 +318,18 @@
                                                                        - StopSound(sound) + StopSound(soundID)
                                                                        - Stop sound effect + Stop sound effect.

                                                                        Parameters:

                                                                          -
                                                                        • sound +
                                                                        • soundID int - ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. + Sound ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window.
                                                                        @@ -340,18 +340,18 @@
                                                                        - IsSoundPlaying(Sound) + IsSoundPlaying(soundID)
                                                                        - Check if the sound effect is playing + Check if the sound effect is playing.

                                                                        Parameters:

                                                                          -
                                                                        • Sound +
                                                                        • soundID int - ID to check. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. + Sound ID to check. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window.
                                                                        @@ -365,7 +365,7 @@ IsAudioTrackPlaying(Track)
                                                                        - Check if the audio track is playing + Check if the audio track is playing. @@ -373,7 +373,7 @@
                                                                        • Track string - filename to check. Should be without extension and without full directory path. + Filename to check. Should be without extension and without full directory path.
                                                                        @@ -388,8 +388,8 @@
                                                                        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. + 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. @@ -398,7 +398,7 @@ Returns nil if no voice track is playing or no subtitle present.
                                                                          string - current subtitle string + Current subtitle string.
                                                                        diff --git a/Documentation/doc/1 modules/Strings.html b/Documentation/doc/1 modules/Strings.html index 0dde6ad65..c3c57ea92 100644 --- a/Documentation/doc/1 modules/Strings.html +++ b/Documentation/doc/1 modules/Strings.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/1 modules/Util.html b/Documentation/doc/1 modules/Util.html index 97a387d2a..6e7bf0f91 100644 --- a/Documentation/doc/1 modules/Util.html +++ b/Documentation/doc/1 modules/Util.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/1 modules/View.html b/Documentation/doc/1 modules/View.html index e1bb7aa4d..45bcd0fc5 100644 --- a/Documentation/doc/1 modules/View.html +++ b/Documentation/doc/1 modules/View.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/2 classes/Collision.Probe.html b/Documentation/doc/2 classes/Collision.Probe.html index 7470c4456..d897d847f 100644 --- a/Documentation/doc/2 classes/Collision.Probe.html +++ b/Documentation/doc/2 classes/Collision.Probe.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/2 classes/Flow.Level.html b/Documentation/doc/2 classes/Flow.Level.html index 780c9ba38..88af887a2 100644 --- a/Documentation/doc/2 classes/Flow.Level.html +++ b/Documentation/doc/2 classes/Flow.Level.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • @@ -143,31 +143,31 @@
                                                                        - + - + - + - - + + - + - + @@ -199,11 +199,11 @@ - + - +
                                                                        PlayAudioTrack(name, type)Play an audio trackPlayAudioTrack(filename, type)Play an audio track.
                                                                        SetAmbientTrack(name, fromStart)Set and play an ambient trackSet and play an ambient track.
                                                                        StopAudioTracks()Stop any audio tracks currently playingStop any audio tracks currently playing.
                                                                        StopAudioTrack(type)Stop audio track that is currently playingStop audio track that is currently playing.
                                                                        GetAudioTrackLoudness(type)Get current loudness level for specified track typeGet current loudness level for specified track type.
                                                                        PlaySound(sound[, position])Play sound effectPlaySound(soundID[, position])Play sound effect.
                                                                        StopSound(sound)Stop sound effectStopSound(soundID)Stop sound effect.
                                                                        IsSoundPlaying(Sound)Check if the sound effect is playingIsSoundPlaying(soundID)Check if the sound effect is playing.
                                                                        IsAudioTrackPlaying(Track)Check if the audio track is playingCheck if the audio track is playing.
                                                                        GetCurrentSubtitle()
                                                                        layer1(Flow.SkyLayer) Primary sky layer(Flow.SkyLayer) Primary sky cloud layer.
                                                                        layer2(Flow.SkyLayer) Secondary sky layer(Flow.SkyLayer) Secondary sky cloud layer.
                                                                        horizon1 (Flow.Horizon) First horizon layer.
                                                                        horizon1horizon2 (Flow.Horizon) Second horizon layer.
                                                                        starfield(Flow.Starfield) Starfield.starField(Flow.StarField) Starfield in the sky.
                                                                        lensFlare(Flow.LensFlare) Global lens flare .(Flow.LensFlare) Global lens flare.
                                                                        fog(Flow.Fog) omni fog RGB color and distance.(Flow.Fog) Global distance fog, with specified RGB color and distance.
                                                                        storm
                                                                        objects(table of Flow.InventoryItems) table of inventory object overrides(table of Flow.InventoryItems) A table of inventory object layout overrides.
                                                                        secrets(short) Set Secrets for Level(short) Set total secret count for current level.

                                                                        Functions

                                                                        @@ -306,7 +306,7 @@ layer1
                                                                        - (Flow.SkyLayer) Primary sky layer + (Flow.SkyLayer) Primary sky cloud layer. @@ -321,7 +321,7 @@ layer2
                                                                        - (Flow.SkyLayer) Secondary sky layer + (Flow.SkyLayer) Secondary sky cloud layer. @@ -347,8 +347,8 @@
                                                                        - - horizon1 + + horizon2
                                                                        (Flow.Horizon) Second horizon layer. @@ -362,11 +362,11 @@
                                                                        - - starfield + + starField
                                                                        - (Flow.Starfield) Starfield. + (Flow.StarField) Starfield in the sky. @@ -381,7 +381,7 @@ lensFlare
                                                                        - (Flow.LensFlare) Global lens flare . + (Flow.LensFlare) Global lens flare. @@ -396,9 +396,8 @@ fog
                                                                        - (Flow.Fog) omni fog RGB color and distance. - As seen in TR4's Desert Railroad. - If not provided, distance fog will be black. + (Flow.Fog) Global distance fog, with specified RGB color and distance. + If not provided, distance fog will not be visible. @@ -537,7 +536,7 @@ Invisible objects
                                                                        - (table of Flow.InventoryItems) table of inventory object overrides + (table of Flow.InventoryItems) A table of inventory object layout overrides. @@ -552,7 +551,7 @@ Invisible secrets
                                                                        - (short) Set Secrets for Level + (short) Set total secret count for current level. @@ -580,7 +579,7 @@ Invisible
                                                                          Level - a Level object + a Level object.
                                                                        diff --git a/Documentation/doc/2 classes/Flow.Settings.html b/Documentation/doc/2 classes/Flow.Settings.html index 092587e0b..dd633bb6d 100644 --- a/Documentation/doc/2 classes/Flow.Settings.html +++ b/Documentation/doc/2 classes/Flow.Settings.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/2 classes/Flow.Statistics.html b/Documentation/doc/2 classes/Flow.Statistics.html index 030cb81b1..ce7559423 100644 --- a/Documentation/doc/2 classes/Flow.Statistics.html +++ b/Documentation/doc/2 classes/Flow.Statistics.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/2 classes/Objects.AIObject.html b/Documentation/doc/2 classes/Objects.AIObject.html index fcb918837..49df5459e 100644 --- a/Documentation/doc/2 classes/Objects.AIObject.html +++ b/Documentation/doc/2 classes/Objects.AIObject.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/2 classes/Objects.Camera.html b/Documentation/doc/2 classes/Objects.Camera.html index c79508433..385089252 100644 --- a/Documentation/doc/2 classes/Objects.Camera.html +++ b/Documentation/doc/2 classes/Objects.Camera.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/2 classes/Objects.LaraObject.html b/Documentation/doc/2 classes/Objects.LaraObject.html index ef3373f39..950ff7df3 100644 --- a/Documentation/doc/2 classes/Objects.LaraObject.html +++ b/Documentation/doc/2 classes/Objects.LaraObject.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/2 classes/Objects.Moveable.html b/Documentation/doc/2 classes/Objects.Moveable.html index b088b9ea2..f2b624dc6 100644 --- a/Documentation/doc/2 classes/Objects.Moveable.html +++ b/Documentation/doc/2 classes/Objects.Moveable.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • @@ -118,8 +118,6 @@

                                                                        Represents a moveable object in the game world.

                                                                        Examples include the player, traps, enemies, doors, and pickups. See also Objects.LaraObject for player-specific features.

                                                                        -

                                                                        pragma nostrip

                                                                        -

                                                                        Functions

                                                                        diff --git a/Documentation/doc/2 classes/Objects.Room.html b/Documentation/doc/2 classes/Objects.Room.html index e4eb0369b..8e2a5ac4c 100644 --- a/Documentation/doc/2 classes/Objects.Room.html +++ b/Documentation/doc/2 classes/Objects.Room.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • @@ -177,7 +177,7 @@ Room:GetRoomNumber()
                                                                        - Get the room's number. () + Get the room's number. @@ -198,7 +198,7 @@ Room:GetName()
                                                                        - Get the room's unique string identifier. () + Get the room's unique string identifier. @@ -219,7 +219,7 @@ Room:GetColor()
                                                                        - Get the room's ambient light color. () + Get the room's ambient light color. @@ -240,7 +240,7 @@ Room:GetReverbType()
                                                                        - Get the room's reverb type. () + Get the room's reverb type. @@ -261,7 +261,7 @@ Room:SetName(name)
                                                                        - Set the room's unique string identifier. () + Set the room's unique string identifier. @@ -283,7 +283,7 @@ Room:SetReverbType(Reverb)
                                                                        - Set the room's reverb type. () + Set the room's reverb type. @@ -305,7 +305,7 @@ Room:SetFlag(flagID, Boolean)
                                                                        - Set the room's specified flag. () + Set the room's specified flag. @@ -331,7 +331,7 @@ Room:GetFlag(flagID)
                                                                        - Get the room's specified flag value (true or false). () + Get the room's specified flag value (true or false). @@ -353,7 +353,7 @@ Room:IsTagPresent(tag)
                                                                        - Check if the specified tag is set for the room. () + Check if the specified tag is set for the room. @@ -381,7 +381,7 @@ Room:GetActive()
                                                                        - Check if the room is active. () + Check if the room is active. diff --git a/Documentation/doc/2 classes/Objects.Sink.html b/Documentation/doc/2 classes/Objects.Sink.html index e9e57c4fe..84b307826 100644 --- a/Documentation/doc/2 classes/Objects.Sink.html +++ b/Documentation/doc/2 classes/Objects.Sink.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/2 classes/Objects.SoundSource.html b/Documentation/doc/2 classes/Objects.SoundSource.html index 5c685ab95..051f35de9 100644 --- a/Documentation/doc/2 classes/Objects.SoundSource.html +++ b/Documentation/doc/2 classes/Objects.SoundSource.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/2 classes/Objects.Static.html b/Documentation/doc/2 classes/Objects.Static.html index f8afe4407..4adcdd058 100644 --- a/Documentation/doc/2 classes/Objects.Static.html +++ b/Documentation/doc/2 classes/Objects.Static.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/2 classes/Objects.Volume.html b/Documentation/doc/2 classes/Objects.Volume.html index 7b8534235..7976ec63a 100644 --- a/Documentation/doc/2 classes/Objects.Volume.html +++ b/Documentation/doc/2 classes/Objects.Volume.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/2 classes/Strings.DisplayString.html b/Documentation/doc/2 classes/Strings.DisplayString.html index d1a494957..df98e9f4f 100644 --- a/Documentation/doc/2 classes/Strings.DisplayString.html +++ b/Documentation/doc/2 classes/Strings.DisplayString.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/2 classes/View.DisplaySprite.html b/Documentation/doc/2 classes/View.DisplaySprite.html index f9d3c07f0..a17294a5b 100644 --- a/Documentation/doc/2 classes/View.DisplaySprite.html +++ b/Documentation/doc/2 classes/View.DisplaySprite.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/3 primitive classes/Color.html b/Documentation/doc/3 primitive classes/Color.html index 0d2993bd9..c2ae23ee2 100644 --- a/Documentation/doc/3 primitive classes/Color.html +++ b/Documentation/doc/3 primitive classes/Color.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • diff --git a/Documentation/doc/3 primitive classes/Flow.Fog.html b/Documentation/doc/3 primitive classes/Flow.Fog.html index 3bd25c6b4..c2aa2554e 100644 --- a/Documentation/doc/3 primitive classes/Flow.Fog.html +++ b/Documentation/doc/3 primitive classes/Flow.Fog.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • @@ -115,10 +115,8 @@

                                                                        Primitive Class Flow.Fog

                                                                        -

                                                                        Distance fog.

                                                                        -

                                                                        - -

                                                                        +

                                                                        Represesnts distance fog.

                                                                        +

                                                                        To be used with Flow.Level.fog property.

                                                                        Members

                                                                        diff --git a/Documentation/doc/3 primitive classes/Flow.Horizon.html b/Documentation/doc/3 primitive classes/Flow.Horizon.html index 5beccaa2b..fd74cd004 100644 --- a/Documentation/doc/3 primitive classes/Flow.Horizon.html +++ b/Documentation/doc/3 primitive classes/Flow.Horizon.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
                                                                      • Flow.InventoryItem
                                                                      • Flow.LensFlare
                                                                      • Flow.SkyLayer
                                                                        • -
                                                                      • Flow.Starfield
                                                                        • +
                                                                      • Flow.StarField
                                                                      • Color
                                                                      • Rotation
                                                                      • Time
                                                                        • @@ -116,63 +116,127 @@

                                                                        Primitive Class Flow.Horizon

                                                                        Represents a horizon.

                                                                        -

                                                                        - -

                                                                        +

                                                                        To be used with Flow.Level.horizon1 and Flow.Level.horizon2 properties.

                                                                        +

                                                                        Members

                                                                        +
                                                                        + + + + + + + + + + + + + + + + + + + + +
                                                                        enabled(bool) Horizon enabled state.
                                                                        objectID(Objects.ObjID) Horizon object ID.
                                                                        position(Vec3) Horizon position.
                                                                        rotation(Rotation) Horizon rotation.
                                                                        transparency(float) Horizon transparency.

                                                                        Functions

                                                                        - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                                                                        Horizon(objectID) Create a horizon object.
                                                                        GetEnabled()Get the horizon's enabled state.
                                                                        GetObjectID()Get the horizon's slot object ID.
                                                                        GetPosition()Get the horizon's world position.
                                                                        GetRotation()Get the horizon's rotation.
                                                                        GetTransparency()Get the horizon's transparency.
                                                                        SetEnabled(enabled)Set the horizon's enabled state.
                                                                        SetObjectID(objectID)Set the horizon's object ID.
                                                                        SetPosition(pos[, noInterpolation])Set the horizon's world position.
                                                                        SetRotation(rot[, noInterpolation])Set the horizon's rotation.
                                                                        SetTransparency(transparency)Set the horizon's transparency.


                                                                        +

                                                                        Members

                                                                        + +
                                                                        +
                                                                        + + enabled +
                                                                        +
                                                                        + (bool) Horizon enabled state. + If set to true, horizon will be visible. + + + + + + + + +
                                                                        +
                                                                        + + objectID +
                                                                        +
                                                                        + (Objects.ObjID) Horizon object ID. + + + + + + + + +
                                                                        +
                                                                        + + position +
                                                                        +
                                                                        + (Vec3) Horizon position. + Specifies an offset from the camera origin. + + + + + + + + +
                                                                        +
                                                                        + + rotation +
                                                                        +
                                                                        + (Rotation) Horizon rotation. + Specifies horizon rotation. + + + + + + + + +
                                                                        +
                                                                        + + transparency +
                                                                        +
                                                                        + (float) Horizon transparency. + Specifies horizon transparency on a range from 0 to 1. + + + + + + + + +
                                                                        +

                                                                        Functions

                                                                        @@ -203,231 +267,6 @@ -
                                                                        -
                                                                        - - GetEnabled() -
                                                                        -
                                                                        - Get the horizon's enabled state. - - - - -

                                                                        Returns:

                                                                        -
                                                                          - - bool - Enabled state. -
                                                                        - - - - -
                                                                        -
                                                                        - - GetObjectID() -
                                                                        -
                                                                        - Get the horizon's slot object ID. - - - - -

                                                                        Returns:

                                                                        -
                                                                          - - ObjID - Object ID. -
                                                                        - - - - -
                                                                        -
                                                                        - - GetPosition() -
                                                                        -
                                                                        - Get the horizon's world position. - - - - -

                                                                        Returns:

                                                                        -
                                                                          - - Vec3 - Position. -
                                                                        - - - - -
                                                                        -
                                                                        - - GetRotation() -
                                                                        -
                                                                        - Get the horizon's rotation. - - - - -

                                                                        Returns:

                                                                        -
                                                                          - - Rotation - Rotation. -
                                                                        - - - - -
                                                                        -
                                                                        - - GetTransparency() -
                                                                        -
                                                                        - Get the horizon's transparency. - - - - -

                                                                        Returns:

                                                                        -
                                                                          - - float - Transparency. -
                                                                        - - - - -
                                                                        -
                                                                        - - SetEnabled(enabled) -
                                                                        -
                                                                        - Set the horizon's enabled state. - - - -

                                                                        Parameters:

                                                                        -
                                                                          -
                                                                        • enabled - bool - New enabled state. -
                                                                          • -
                                                                        - - - - - -
                                                                        -
                                                                        - - SetObjectID(objectID) -
                                                                        -
                                                                        - Set the horizon's object ID. - - - -

                                                                        Parameters:

                                                                        -
                                                                          -
                                                                        • objectID - ObjID - Object ID. -
                                                                          • -
                                                                        - - - - - -
                                                                        -
                                                                        - - SetPosition(pos[, noInterpolation]) -
                                                                        -
                                                                        - Set the horizon's world position. - - - -

                                                                        Parameters:

                                                                        -
                                                                          -
                                                                        • pos - Vec3 - New world position. -
                                                                          • -
                                                                        • noInterpolation - bool - Disable interpolation with the previous frame's position. default: false - (optional) -
                                                                          • -
                                                                        - - - - - -
                                                                        -
                                                                        - - SetRotation(rot[, noInterpolation]) -
                                                                        -
                                                                        - Set the horizon's rotation. - - - -

                                                                        Parameters:

                                                                        -
                                                                          -
                                                                        • rot - Rotation - New rotation. -
                                                                          • -
                                                                        • noInterpolation - bool - Disable interpolation with the previous frame's rotation. default: false - (optional) -
                                                                          • -
                                                                        - - - - - -
                                                                        -
                                                                        - - SetTransparency(transparency) -
                                                                        -
                                                                        - Set the horizon's transparency. - - - -

                                                                        Parameters:

                                                                        -
                                                                          -
                                                                        • transparency - float - New transparency alpha. -
                                                                          • -
                                                                        - - - - -
    diff --git a/Documentation/doc/3 primitive classes/Flow.InventoryItem.html b/Documentation/doc/3 primitive classes/Flow.InventoryItem.html index 1586a6072..0fc41f7b1 100644 --- a/Documentation/doc/3 primitive classes/Flow.InventoryItem.html +++ b/Documentation/doc/3 primitive classes/Flow.InventoryItem.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • @@ -116,9 +116,7 @@

    Primitive Class Flow.InventoryItem

    Represents the properties of an object as it appears in the inventory.

    -

    - -

    +

    To be used in Flow.Level.objects list.

    Functions

    diff --git a/Documentation/doc/3 primitive classes/Flow.LensFlare.html b/Documentation/doc/3 primitive classes/Flow.LensFlare.html index ad3f0f67a..c2e8a2807 100644 --- a/Documentation/doc/3 primitive classes/Flow.LensFlare.html +++ b/Documentation/doc/3 primitive classes/Flow.LensFlare.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • @@ -116,59 +116,124 @@

    Primitive Class Flow.LensFlare

    Represents a global lens flare (not to be confused with the lens flare object).

    -

    - -

    +

    To be used with Flow.Level.lensFlare property.

    +

    Members

    + + + + + + + + + + + + + + + + + + + + + +
    enabled(bool) Lens flare enabled state.
    spriteID(int) Lens flare's sun sprite object ID.
    pitch(float) Lens flare's pitch (vertical) angle in degrees.
    yaw(float) Lens flare's yaw (horizontal) angle in degrees.
    color(Color) Lens flare's color.

    Functions

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    LensFlare(pitch, yaw, color) Create a LensFlare object.
    LensFlare:GetSunSpriteID()Get this lens flare's sun sprite ID.
    LensFlare:GetPitch()Get this lens flare's pitch angle in degrees.
    LensFlare:GetYaw()Get this lens flare's yaw angle in degrees.
    LensFlare:GetColor()Get the lens flare's color.
    LensFlare:GetEnabled()Get this lens flare's enabled status.
    LensFlare:SetSunSpriteID(spriteID)Set this lens flare's sun sprite ID.
    LensFlare:SetPitch(pitch)Set this lens flare's pitch angle.
    LensFlare:SetYaw(yaw)Set this lens flare's yaw angle.
    LensFlare:SetColor(color)Set this lens flare's color.


    +

    Members

    + +
    +
    + + enabled +
    +
    + (bool) Lens flare enabled state. + If set to true, lens flare will be visible. + + + + + + + + +
    +
    + + spriteID +
    +
    + (int) Lens flare's sun sprite object ID. + + + + + + + + +
    +
    + + pitch +
    +
    + (float) Lens flare's pitch (vertical) angle in degrees. + + + + + + + + +
    +
    + + yaw +
    +
    + (float) Lens flare's yaw (horizontal) angle in degrees. + + + + + + + + +
    +
    + + color +
    +
    + (Color) Lens flare's color. + + + + + + + + +
    +

    Functions

    @@ -207,193 +272,6 @@ -
    -
    - - LensFlare:GetSunSpriteID() -
    -
    - Get this lens flare's sun sprite ID. - - - - -

    Returns:

    -
      - - int - Sprite ID. -
    - - - - -
    -
    - - LensFlare:GetPitch() -
    -
    - Get this lens flare's pitch angle in degrees. - - - - -

    Returns:

    -
      - - float - Pitch angle in degrees. -
    - - - - -
    -
    - - LensFlare:GetYaw() -
    -
    - Get this lens flare's yaw angle in degrees. - - - - -

    Returns:

    -
      - - float - Yaw angle in degrees. -
    - - - - -
    -
    - - LensFlare:GetColor() -
    -
    - Get the lens flare's color. - - - - - - - - -
    -
    - - LensFlare:GetEnabled() -
    -
    - Get this lens flare's enabled status. - - - - -

    Returns:

    -
      - - bool - Enabled status. true: enabled, false: disabled -
    - - - - -
    -
    - - LensFlare:SetSunSpriteID(spriteID) -
    -
    - Set this lens flare's sun sprite ID. - - - -

    Parameters:

    -
      -
    • spriteID - int - New sun sprite ID. -
      • -
    - - - - - -
    -
    - - LensFlare:SetPitch(pitch) -
    -
    - Set this lens flare's pitch angle. - - - -

    Parameters:

    -
      -
    • pitch - float - New pitch angle in degrees. -
      • -
    - - - - - -
    -
    - - LensFlare:SetYaw(yaw) -
    -
    - Set this lens flare's yaw angle. - - - -

    Parameters:

    -
      -
    • yaw - float - New yaw angle in degrees. -
      • -
    - - - - - -
    -
    - - LensFlare:SetColor(color) -
    -
    - Set this lens flare's color. - - - -

    Parameters:

    -
      -
    • color - Color - New color. -
      • -
    - - - - -
    diff --git a/Documentation/doc/3 primitive classes/Flow.SkyLayer.html b/Documentation/doc/3 primitive classes/Flow.SkyLayer.html index 03d2a46af..b64f57108 100644 --- a/Documentation/doc/3 primitive classes/Flow.SkyLayer.html +++ b/Documentation/doc/3 primitive classes/Flow.SkyLayer.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • @@ -116,7 +116,7 @@

    Primitive Class Flow.SkyLayer

    Describes a layer of moving clouds.

    -

    As seen in TR4's City of the Dead.

    +

    To be used with Flow.Level.layer1 and Flow.Level.layer2 properties.

    Members

    diff --git a/Documentation/doc/3 primitive classes/Flow.Starfield.html b/Documentation/doc/3 primitive classes/Flow.Starfield.html index 05934ae6b..df49ddf8b 100644 --- a/Documentation/doc/3 primitive classes/Flow.Starfield.html +++ b/Documentation/doc/3 primitive classes/Flow.Starfield.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • @@ -114,75 +114,116 @@
    -

    Primitive Class Flow.Starfield

    -

    Represents a starfield in the sky.

    -

    - -

    +

    Primitive Class Flow.StarField

    +

    Represents a star field in the sky.

    +

    To be used with Flow.Level.starField property.

    +

    Members

    + + + + + + + + + + + + + + + + + +
    starCount(int) Amount of visible stars.
    meteorCount(int) Amount of visible meteors.
    meteorSpawnDensity(int) Meteor spawn density.
    meteorVelocity(int) Meteor velocity.

    Functions

    - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Starfield(starCount)StarField(starCount) Create a starfield object with only stars.
    Starfield(starCount, meteorCount, meteorSpawnDensity, meteorVel)StarField(starCount, meteorCount, meteorSpawnDensity, meteorVel) Create a starfield object with stars and meteors.
    Starfield:GetStarCount()Get this starfield's number of stars.
    Starfield:GetMeteorCount()Get this starfield's number of meteors.
    Starfield:GetMeteorSpawnDensity()Get this starfield's meteor spawn density.
    Starfield:GetMeteorVelocity()Get this starfield's meteor velocity.
    Starfield:GetStarsEnabled()Get this starfield's stars enabled status.
    Starfield:GetMeteorsEnabled()Get this starfield's meteors enabled status.
    Starfield:SetStarCount(count)Set this starfield's number of stars.
    Starfield:SetMeteorCount(count)Set this starfield's number of meteors.
    Starfield:SetMeteorSpawnDensity(density)Set this starfield's meteor spawn density.
    Starfield:SetMeteorVelocity(velocity)Set this starfield's meteor velocity.


    +

    Members

    + +
    +
    + + starCount +
    +
    + (int) Amount of visible stars. + + + + + + + + +
    +
    + + meteorCount +
    +
    + (int) Amount of visible meteors. + + + + + + + + +
    +
    + + meteorSpawnDensity +
    +
    + (int) Meteor spawn density. + + + + + + + + +
    +
    + + meteorVelocity +
    +
    + (int) Meteor velocity. + + + + + + + + +
    +

    Functions

    - - Starfield(starCount) + + StarField(starCount)
    Create a starfield object with only stars. @@ -200,8 +241,8 @@

    Returns:

      - Starfield - A new Starfield object. + Starfield + A new StarField object.
    @@ -209,8 +250,8 @@
    - - Starfield(starCount, meteorCount, meteorSpawnDensity, meteorVel) + + StarField(starCount, meteorCount, meteorSpawnDensity, meteorVel)
    Create a starfield object with stars and meteors. @@ -240,227 +281,13 @@

    Returns:

      - Starfield - A new Starfield object. + StarField + A new StarField object.
    -
    -
    - - Starfield:GetStarCount() -
    -
    - Get this starfield's number of stars. - - - - -

    Returns:

    -
      - - int - Count. -
    - - - - -
    -
    - - Starfield:GetMeteorCount() -
    -
    - Get this starfield's number of meteors. - - - - -

    Returns:

    -
      - - int - Count. -
    - - - - -
    -
    - - Starfield:GetMeteorSpawnDensity() -
    -
    - Get this starfield's meteor spawn density. - - - - -

    Returns:

    -
      - - int - Spawn density. -
    - - - - -
    -
    - - Starfield:GetMeteorVelocity() -
    -
    - Get this starfield's meteor velocity. - - - - -

    Returns:

    -
      - - float - Velocity. -
    - - - - -
    -
    - - Starfield:GetStarsEnabled() -
    -
    - Get this starfield's stars enabled status. - - - - -

    Returns:

    -
      - - bool - Stars enabled status. true: enabled, false: disabled -
    - - - - -
    -
    - - Starfield:GetMeteorsEnabled() -
    -
    - Get this starfield's meteors enabled status. - - - - -

    Returns:

    -
      - - bool - Meteors enabled status. true: enabled, false: disabled -
    - - - - -
    -
    - - Starfield:SetStarCount(count) -
    -
    - Set this starfield's number of stars. - - - -

    Parameters:

    -
      -
    • count - int - New star count. -
      • -
    - - - - - -
    -
    - - Starfield:SetMeteorCount(count) -
    -
    - Set this starfield's number of meteors. - - - -

    Parameters:

    -
      -
    • count - int - New meteor count. -
      • -
    - - - - - -
    -
    - - Starfield:SetMeteorSpawnDensity(density) -
    -
    - Set this starfield's meteor spawn density. - - - -

    Parameters:

    -
      -
    • density - int - New meteor spawn density. -
      • -
    - - - - - -
    -
    - - Starfield:SetMeteorVelocity(velocity) -
    -
    - Set this starfield's meteor velocity. - - - -

    Parameters:

    -
      -
    • velocity - float - New meteor velocity. -
      • -
    - - - - -
    diff --git a/Documentation/doc/3 primitive classes/Rotation.html b/Documentation/doc/3 primitive classes/Rotation.html index 607218c1a..900fda280 100644 --- a/Documentation/doc/3 primitive classes/Rotation.html +++ b/Documentation/doc/3 primitive classes/Rotation.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/3 primitive classes/Time.html b/Documentation/doc/3 primitive classes/Time.html index 5cc1949f6..6de872b0c 100644 --- a/Documentation/doc/3 primitive classes/Time.html +++ b/Documentation/doc/3 primitive classes/Time.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/3 primitive classes/Vec2.html b/Documentation/doc/3 primitive classes/Vec2.html index 5c7f7e5c4..de9e80f16 100644 --- a/Documentation/doc/3 primitive classes/Vec2.html +++ b/Documentation/doc/3 primitive classes/Vec2.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • @@ -143,23 +143,19 @@ Create a Vec2 object. - __tostring(This) - Metafunction. - - Vec2:Normalize() Get a copy of this Vec2 normalized to length 1. - Translate(dir, dist) + Vec2:Translate(dir, dist) Get a copy of this Vec2 translated in the input Vec2 direction by the input distance. - Translate(rot, dist) + Vec2:Translate(rot, dist) Get a copy of this Vec2 translated in the direction of the input rotation in degrees by the input distance. - Translate(rot, relOffset) + Vec2:Translate(rot, relOffset) Get a copy of this Vec2 translated by an offset, where the input relative offset Vec2 is rotated according to the input rotation in degrees. @@ -186,6 +182,10 @@ Vec2:Length() Get the length of this Vec2. + + __tostring(This) + Metafunction. +
    @@ -288,34 +288,6 @@ - -
    - - __tostring(This) -
    -
    - Metafunction. Use tostring(vector). - - - -

    Parameters:

    -
      -
    • This - Vec2 - Vec2. -
      • -
    - -

    Returns:

    -
      - - string - A string showing the X and Y components of the Vec2. -
    - - - -
    @@ -339,8 +311,8 @@
    - - Translate(dir, dist) + + Vec2:Translate(dir, dist)
    Get a copy of this Vec2 translated in the input Vec2 direction by the input distance. @@ -371,8 +343,8 @@
    - - Translate(rot, dist) + + Vec2:Translate(rot, dist)
    Get a copy of this Vec2 translated in the direction of the input rotation in degrees by the input distance. @@ -403,8 +375,8 @@
    - - Translate(rot, relOffset) + + Vec2:Translate(rot, relOffset)
    Get a copy of this Vec2 translated by an offset, where the input relative offset Vec2 is rotated according to the input rotation in degrees. @@ -598,6 +570,34 @@ +
    +
    + + __tostring(This) +
    +
    + Metafunction. Use tostring(vector). + + + +

    Parameters:

    +
      +
    • This + Vec2 + Vec2. +
      • +
    + +

    Returns:

    +
      + + string + A string showing the X and Y components of the Vec2. +
    + + + +
    diff --git a/Documentation/doc/3 primitive classes/Vec3.html b/Documentation/doc/3 primitive classes/Vec3.html index 715d39062..bf9c41551 100644 --- a/Documentation/doc/3 primitive classes/Vec3.html +++ b/Documentation/doc/3 primitive classes/Vec3.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Collision.MaterialType.html b/Documentation/doc/4 enums/Collision.MaterialType.html index 560cb4d9f..693d6c9ae 100644 --- a/Documentation/doc/4 enums/Collision.MaterialType.html +++ b/Documentation/doc/4 enums/Collision.MaterialType.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Effects.BlendID.html b/Documentation/doc/4 enums/Effects.BlendID.html index 540ac8415..eecc444ff 100644 --- a/Documentation/doc/4 enums/Effects.BlendID.html +++ b/Documentation/doc/4 enums/Effects.BlendID.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Effects.EffectID.html b/Documentation/doc/4 enums/Effects.EffectID.html index 577ca2670..9072c82aa 100644 --- a/Documentation/doc/4 enums/Effects.EffectID.html +++ b/Documentation/doc/4 enums/Effects.EffectID.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Effects.FeatherMode.html b/Documentation/doc/4 enums/Effects.FeatherMode.html index f4a4fb39f..8fbae4b2c 100644 --- a/Documentation/doc/4 enums/Effects.FeatherMode.html +++ b/Documentation/doc/4 enums/Effects.FeatherMode.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html index 5da6ba0e8..8799d2677 100644 --- a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html +++ b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • @@ -116,9 +116,7 @@

    Enum Effects.ParticleAnimationType

    Constants for particle animation type constants.

    -

    - -

    +

    To be used with Effects.EmitAdvancedParticle function.

    Tables

    diff --git a/Documentation/doc/4 enums/Flow.ErrorMode.html b/Documentation/doc/4 enums/Flow.ErrorMode.html index a972c1369..625510196 100644 --- a/Documentation/doc/4 enums/Flow.ErrorMode.html +++ b/Documentation/doc/4 enums/Flow.ErrorMode.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Flow.FreezeMode.html b/Documentation/doc/4 enums/Flow.FreezeMode.html index cff19f990..c24cf87bb 100644 --- a/Documentation/doc/4 enums/Flow.FreezeMode.html +++ b/Documentation/doc/4 enums/Flow.FreezeMode.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Flow.GameStatus.html b/Documentation/doc/4 enums/Flow.GameStatus.html index 27324b7b4..556a27170 100644 --- a/Documentation/doc/4 enums/Flow.GameStatus.html +++ b/Documentation/doc/4 enums/Flow.GameStatus.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Input.ActionID.html b/Documentation/doc/4 enums/Input.ActionID.html index 270c5a9e7..c198d7fcd 100644 --- a/Documentation/doc/4 enums/Input.ActionID.html +++ b/Documentation/doc/4 enums/Input.ActionID.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Objects.AmmoType.html b/Documentation/doc/4 enums/Objects.AmmoType.html index 80d10b754..b094c086f 100644 --- a/Documentation/doc/4 enums/Objects.AmmoType.html +++ b/Documentation/doc/4 enums/Objects.AmmoType.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Objects.HandStatus.html b/Documentation/doc/4 enums/Objects.HandStatus.html index 639793907..9e74accee 100644 --- a/Documentation/doc/4 enums/Objects.HandStatus.html +++ b/Documentation/doc/4 enums/Objects.HandStatus.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Objects.MoveableStatus.html b/Documentation/doc/4 enums/Objects.MoveableStatus.html index abc608b8a..5b55c96b6 100644 --- a/Documentation/doc/4 enums/Objects.MoveableStatus.html +++ b/Documentation/doc/4 enums/Objects.MoveableStatus.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Objects.ObjID.html b/Documentation/doc/4 enums/Objects.ObjID.html index 74e2413d8..ad84d4d32 100644 --- a/Documentation/doc/4 enums/Objects.ObjID.html +++ b/Documentation/doc/4 enums/Objects.ObjID.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Objects.RoomFlagID.html b/Documentation/doc/4 enums/Objects.RoomFlagID.html index a472524ec..820cc66fd 100644 --- a/Documentation/doc/4 enums/Objects.RoomFlagID.html +++ b/Documentation/doc/4 enums/Objects.RoomFlagID.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Objects.RoomReverb.html b/Documentation/doc/4 enums/Objects.RoomReverb.html index 9ecacbbbf..66b7ff482 100644 --- a/Documentation/doc/4 enums/Objects.RoomReverb.html +++ b/Documentation/doc/4 enums/Objects.RoomReverb.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Objects.WeaponType.html b/Documentation/doc/4 enums/Objects.WeaponType.html index ded6644fb..868204528 100644 --- a/Documentation/doc/4 enums/Objects.WeaponType.html +++ b/Documentation/doc/4 enums/Objects.WeaponType.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Sound.SoundTrackType.html b/Documentation/doc/4 enums/Sound.SoundTrackType.html index 322be1ca6..e5f87781c 100644 --- a/Documentation/doc/4 enums/Sound.SoundTrackType.html +++ b/Documentation/doc/4 enums/Sound.SoundTrackType.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Strings.DisplayStringOption.html b/Documentation/doc/4 enums/Strings.DisplayStringOption.html index 193062a2a..2f723c0c8 100644 --- a/Documentation/doc/4 enums/Strings.DisplayStringOption.html +++ b/Documentation/doc/4 enums/Strings.DisplayStringOption.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Util.LogLevel.html b/Documentation/doc/4 enums/Util.LogLevel.html index e460b478b..17187a588 100644 --- a/Documentation/doc/4 enums/Util.LogLevel.html +++ b/Documentation/doc/4 enums/Util.LogLevel.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/View.AlignMode.html b/Documentation/doc/4 enums/View.AlignMode.html index c1f559c82..03e0c821d 100644 --- a/Documentation/doc/4 enums/View.AlignMode.html +++ b/Documentation/doc/4 enums/View.AlignMode.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/View.CameraType.html b/Documentation/doc/4 enums/View.CameraType.html index a6a4f12ba..43a092345 100644 --- a/Documentation/doc/4 enums/View.CameraType.html +++ b/Documentation/doc/4 enums/View.CameraType.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/View.PostProcessMode.html b/Documentation/doc/4 enums/View.PostProcessMode.html index 83657e992..ba5d9076f 100644 --- a/Documentation/doc/4 enums/View.PostProcessMode.html +++ b/Documentation/doc/4 enums/View.PostProcessMode.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/View.ScaleMode.html b/Documentation/doc/4 enums/View.ScaleMode.html index 3ced09b6a..c2fed2a54 100644 --- a/Documentation/doc/4 enums/View.ScaleMode.html +++ b/Documentation/doc/4 enums/View.ScaleMode.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/5 lua utility modules/CustomBar.html b/Documentation/doc/5 lua utility modules/CustomBar.html index 293044e74..d809f3d8e 100644 --- a/Documentation/doc/5 lua utility modules/CustomBar.html +++ b/Documentation/doc/5 lua utility modules/CustomBar.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/5 lua utility modules/Diary.html b/Documentation/doc/5 lua utility modules/Diary.html index 3a0a4c6d5..ff4412fa6 100644 --- a/Documentation/doc/5 lua utility modules/Diary.html +++ b/Documentation/doc/5 lua utility modules/Diary.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/5 lua utility modules/EventSequence.html b/Documentation/doc/5 lua utility modules/EventSequence.html index 21199ec26..8b1aeeff6 100644 --- a/Documentation/doc/5 lua utility modules/EventSequence.html +++ b/Documentation/doc/5 lua utility modules/EventSequence.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/5 lua utility modules/Timer.html b/Documentation/doc/5 lua utility modules/Timer.html index 263709641..a8ac29923 100644 --- a/Documentation/doc/5 lua utility modules/Timer.html +++ b/Documentation/doc/5 lua utility modules/Timer.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/5 lua utility modules/Type.html b/Documentation/doc/5 lua utility modules/Type.html index ab0d9dcff..acadc9fc1 100644 --- a/Documentation/doc/5 lua utility modules/Type.html +++ b/Documentation/doc/5 lua utility modules/Type.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/index.html b/Documentation/doc/index.html index 1d5a3c407..dab35622b 100644 --- a/Documentation/doc/index.html +++ b/Documentation/doc/index.html @@ -3,7 +3,7 @@ - TombEngine 1.7.2 (Developer) Lua API + TombEngine 1.8 Lua API @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.Starfield
    • +
  • Flow.StarField
  • Color
  • Rotation
  • Time
    • @@ -115,25 +115,25 @@
    -

    TombEngine 1.7.2 (Developer) scripting interface

    -

    Welcome to the TombEngine scripting API. This is a work in progress and some information might be wrong or outdated. Please also note that this is primarily a reference document, not a tutorial, so expect descriptions to be fairly sparse.

    +

    TombEngine 1.8 scripting interface

    +

    Welcome to the TombEngine scripting API.

    -

    At the time of writing, there is a tutorial describing the basics of Lua, as well as a number of example scripts, on the TombEngine website.

    -

    Module Hierarchy (boring but important)

    -

    Other than the "special tables" (GameVars, LevelVars and LevelFuncs), every module described herein is held in a master table called TEN. +

    Note that this is primarily a reference document, not a tutorial, so expect descriptions to be fairly sparse. +At the time of writing, there is a tutorial describing the basics of Lua, as well as a number of example scripts, on the TombEngine website.

    + +

    Module Hierarchy

    +

    Other than the "special tables" (GameVars, LevelVars and LevelFuncs), every module described herein is held in a master table called TEN. For convenience, these modules and classes are automatically put in the global table. For example, you can call GetMoveableByName either of these two ways:

    local door = TEN.Objects.GetMoveableByName("door_type4_14")
 local door = GetMoveableByName("door_type4_14")

    Always check logs/TENLog.txt

    -

    If you are scripting levels, TombEngine will often kick you back to the title screen, even if errorMode (see Flow.Settings) is set to ErrorMode.WARN or ErrorMode.SILENT.

    +

    If you are scripting levels, TombEngine will often kick you back to the title screen, even if errorMode (see Flow.Settings) is set to ErrorMode.WARN or ErrorMode.SILENT.

    -

    This might get annoying, but it's on purpose. If your Lua script contains a syntax error (e.g. you're missing end at the end of a function), the Lua interpreter will not be able to continue running the script. If it tried to keep running, you'd probably see some pretty strange behaviour, and would possibly get a crash regardless.

    +

    This might get annoying, but it's on purpose. If your Lua script contains a syntax error (e.g. you're missing end at the end of a function), the Lua interpreter will not be able to continue running the script. If it tried to keep running, you'd probably see some pretty strange behaviour, and would possibly get a crash regardless. If this happens, check logs/TENLog.txt and look for an error message with the word "unrecoverable".

    -

    If this happens, check logs/TENLog.txt and look for an error message with the word "unrecoverable".

    - -

    Enjoy.

    +

    Happy building!

    - squidshire and the TombEngine development team.

    @@ -247,7 +247,7 @@ local door = GetMoveableByName("door_type4_14") - + @@ -266,8 +266,8 @@ local door = GetMoveableByName("door_type4_14") - - + + diff --git a/TombEngine/Game/effects/weather.cpp b/TombEngine/Game/effects/weather.cpp index 472e76fe0..34a235054 100644 --- a/TombEngine/Game/effects/weather.cpp +++ b/TombEngine/Game/effects/weather.cpp @@ -232,52 +232,65 @@ namespace TEN::Effects::Environment void EnvironmentController::UpdateStarfield(const ScriptInterfaceLevel& level) { - if (!level.GetStarfieldStarsEnabled()) + int starCount = level.GetStarfieldStarCount(); + if (starCount == 0) return; if (ResetStarField) { - int starCount = level.GetStarfieldStarCount(); - Stars.clear(); - Stars.reserve(starCount); + ResetStarField = false; + } - for (int i = 0; i < starCount; i++) + if (starCount != Stars.size()) + { + // If starCount increased, add new stars to existing list. + if (starCount > Stars.size()) { - auto starDir = Random::GenerateDirectionInCone(-Vector3::UnitY, 70.0f); - starDir.Normalize(); + // Reserve space for new stars if necessary. + Stars.reserve(starCount); - auto star = StarParticle{}; - star.Direction = starDir; - star.Color = Vector3( - Random::GenerateFloat(0.6f, 1.0f), - Random::GenerateFloat(0.6f, 1.0f), - Random::GenerateFloat(0.6f, 1.0f)); - star.Scale = Random::GenerateFloat(0.5f, 1.5f); - - float cosine = Vector3::UnitY.Dot(starDir); - float maxCosine = cos(DEG_TO_RAD(50.0f)); - float minCosine = cos(DEG_TO_RAD(70.0f)); - - if (cosine >= minCosine && cosine <= maxCosine) + for (int i = (int)Stars.size(); i < starCount; i++) { - star.Extinction = (cosine - minCosine) / (maxCosine - minCosine); - } - else - { - star.Extinction = 1.0f; - } + auto starDir = Random::GenerateDirectionInCone(-Vector3::UnitY, 70.0f); + starDir.Normalize(); - Stars.push_back(star); + auto star = StarParticle{}; + star.Direction = starDir; + star.Color = Vector3( + Random::GenerateFloat(0.6f, 1.0f), + Random::GenerateFloat(0.6f, 1.0f), + Random::GenerateFloat(0.6f, 1.0f)); + star.Scale = Random::GenerateFloat(0.5f, 1.5f); + + float cosine = Vector3::UnitY.Dot(starDir); + float maxCosine = cos(DEG_TO_RAD(50.0f)); + float minCosine = cos(DEG_TO_RAD(70.0f)); + + if (cosine >= minCosine && cosine <= maxCosine) + { + star.Extinction = (cosine - minCosine) / (maxCosine - minCosine); + } + else + { + star.Extinction = 1.0f; + } + + Stars.push_back(star); + } + } + // If starCount decreased, resize vector without reinitializing. + else + { + Stars.resize(starCount); } - ResetStarField = false; } for (auto& star : Stars) star.Blinking = Random::GenerateFloat(0.5f, 1.0f); - if (level.GetStarfieldMeteorsEnabled()) + if (level.GetStarfieldMeteorCount() > 0) { for (auto& meteor : Meteors) { @@ -639,7 +652,7 @@ namespace TEN::Effects::Environment Meteors.end()); } - if (!level.GetStarfieldMeteorsEnabled()) + if (level.GetStarfieldMeteorCount() == 0) return; int density = level.GetStarfieldMeteorSpawnDensity(); diff --git a/TombEngine/Scripting/Include/ScriptInterfaceLevel.h b/TombEngine/Scripting/Include/ScriptInterfaceLevel.h index 0bef47771..e091044b0 100644 --- a/TombEngine/Scripting/Include/ScriptInterfaceLevel.h +++ b/TombEngine/Scripting/Include/ScriptInterfaceLevel.h @@ -62,8 +62,6 @@ public: virtual Color GetLensFlareColor() const = 0; // Starfield getters - virtual bool GetStarfieldStarsEnabled() const = 0; - virtual bool GetStarfieldMeteorsEnabled() const = 0; virtual int GetStarfieldStarCount() const = 0; virtual int GetStarfieldMeteorCount() const = 0; virtual int GetStarfieldMeteorSpawnDensity() const = 0; diff --git a/TombEngine/Scripting/Internal/ReservedScriptNames.h b/TombEngine/Scripting/Internal/ReservedScriptNames.h index 7db33a007..c3307b918 100644 --- a/TombEngine/Scripting/Internal/ReservedScriptNames.h +++ b/TombEngine/Scripting/Internal/ReservedScriptNames.h @@ -433,25 +433,6 @@ constexpr char ScriptReserved_ProbePreview[] = "Preview"; constexpr char ScriptReserved_MaterialType[] = "MaterialType"; -// ==== -// FLOW -// ==== - -// Horizon - -constexpr char ScriptReserved_Horizon[] = "Horizon"; -constexpr char ScriptReserved_HorizonGetEnabled[] = "GetEnabled"; -constexpr char ScriptReserved_HorizonGetObjectID[] = "GetObjectID"; -constexpr char ScriptReserved_HorizonGetPosition[] = "GetPosition"; -constexpr char ScriptReserved_HorizonGetRotation[] = "GetRotation"; -constexpr char ScriptReserved_HorizonGetTransparency[] = "GetTransparency"; -constexpr char ScriptReserved_HorizonSetEnabled[] = "SetEnabled"; -constexpr char ScriptReserved_HorizonSetObjectID[] = "SetObjectID"; -constexpr char ScriptReserved_HorizonSetPosition[] = "SetPosition"; -constexpr char ScriptReserved_HorizonSetRotation[] = "SetRotation"; -constexpr char ScriptReserved_HorizonSetTransparency[] = "SetTransparency"; - - // ======= // OBJECTS // ======= diff --git a/TombEngine/Scripting/Internal/TEN/Effects/ParticleAnimTypes.h b/TombEngine/Scripting/Internal/TEN/Effects/ParticleAnimTypes.h index d992641fa..1adae829e 100644 --- a/TombEngine/Scripting/Internal/TEN/Effects/ParticleAnimTypes.h +++ b/TombEngine/Scripting/Internal/TEN/Effects/ParticleAnimTypes.h @@ -4,7 +4,7 @@ namespace TEN::Scripting::Effects { - /// Constants for particle animation type constants. + /// Constants for particle animation type constants. To be used with @{Effects.EmitAdvancedParticle} function. // @enum Effects.ParticleAnimationType // @pragma nostrip diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp index ffc6032f9..bb7612114 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp @@ -6,7 +6,7 @@ using namespace TEN::Scripting::Types; /*** -Distance fog. +Represesnts distance fog. To be used with @{Flow.Level.fog} property. @tenprimitive Flow.Fog @pragma nostrip diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Horizon/Horizon.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Horizon/Horizon.cpp index 52f24820d..1d4ef80a4 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Horizon/Horizon.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Horizon/Horizon.cpp @@ -9,7 +9,7 @@ namespace TEN::Scripting { - /// Represents a horizon. + /// Represents a horizon. To be used with @{Flow.Level.horizon1} and @{Flow.Level.horizon2} properties. // // @tenprimitive Flow.Horizon // @pragma nostrip @@ -22,22 +22,32 @@ namespace TEN::Scripting // Register type. parent.new_usertype( - ScriptReserved_Horizon, + "Horizon", ctors(), sol::call_constructor, ctors(), - // Getters - ScriptReserved_HorizonGetEnabled, &Horizon::GetEnabled, - ScriptReserved_HorizonGetObjectID, &Horizon::GetObjectID, - ScriptReserved_HorizonGetPosition, &Horizon::GetPosition, - ScriptReserved_HorizonGetRotation, &Horizon::GetRotation, - ScriptReserved_HorizonGetTransparency, &Horizon::GetTransparency, + /// (bool) Horizon enabled state. + // If set to true, horizon will be visible. + // @mem enabled + "enabled", sol::property(&Horizon::GetEnabled, &Horizon::SetEnabled), - // Setters - ScriptReserved_HorizonSetEnabled, &Horizon::SetEnabled, - ScriptReserved_HorizonSetObjectID, &Horizon::SetObjectID, - ScriptReserved_HorizonSetPosition, &Horizon::SetPosition, - ScriptReserved_HorizonSetRotation, &Horizon::SetRotation, - ScriptReserved_HorizonSetTransparency, &Horizon::SetTransparency); + /// (Objects.ObjID) Horizon object ID. + // @mem objectID + "objectID", sol::property(&Horizon::GetObjectID, &Horizon::SetObjectID), + + /// (Vec3) Horizon position. + // Specifies an offset from the camera origin. + // @mem position + "position", sol::property(&Horizon::GetPosition, &Horizon::SetPosition), + + /// (Rotation) Horizon rotation. + // Specifies horizon rotation. + // @mem rotation + "rotation", sol::property(&Horizon::GetRotation, &Horizon::SetRotation), + + /// (float) Horizon transparency. + // Specifies horizon transparency on a range from 0 to 1. + // @mem transparency + "transparency", sol::property(&Horizon::GetTransparency, &Horizon::SetTransparency)); } /// Create a horizon object. @@ -56,89 +66,53 @@ namespace TEN::Scripting _enabled = enabled; } - /// Get the horizon's enabled state. - // @function GetEnabled - // @treturn bool Enabled state. bool Horizon::GetEnabled() const { return _enabled; } - /// Get the horizon's slot object ID. - // @function GetObjectID - // @treturn Objects.ObjID Object ID. GAME_OBJECT_ID Horizon::GetObjectID() const { return _objectID; } - /// Get the horizon's world position. - // @function GetPosition - // @treturn Vec3 Position. const Vec3 Horizon::GetPosition() const { return _position; } - /// Get the horizon's rotation. - // @function GetRotation - // @treturn Rotation Rotation. const Rotation Horizon::GetRotation() const { return _rotation; } - /// Get the horizon's transparency. - // @function GetTransparency - // @treturn float Transparency. const float Horizon::GetTransparency() const { return _transparency; } - /// Set the horizon's enabled state. - // @function SetEnabled - // @tparam bool enabled New enabled state. void Horizon::SetEnabled(bool value) { _enabled = value; } - /// Set the horizon's object ID. - // @function SetObjectID - // @tparam Objects.ObjID objectID Object ID. void Horizon::SetObjectID(GAME_OBJECT_ID objectID) { _objectID = objectID; } - /// Set the horizon's world position. - // @function SetPosition - // @tparam Vec3 pos New world position. - // @tparam[opt] bool noInterpolation Disable interpolation with the previous frame's position. __default: false__ void Horizon::SetPosition(const Vec3& pos, TypeOrNil noInterpolation) { - bool convertedDisableInterp = ValueOr(noInterpolation, false); - - _prevPosition = convertedDisableInterp ? pos : _position; + _prevPosition = ValueOr(noInterpolation, false) ? pos : _position; _position = pos; } - /// Set the horizon's rotation. - // @function SetRotation - // @tparam Rotation rot New rotation. - // @tparam[opt] bool noInterpolation Disable interpolation with the previous frame's rotation. __default: false__ void Horizon::SetRotation(const Rotation& rot, TypeOrNil noInterpolation) { - bool convertedDisableInterp = ValueOr(noInterpolation, false); - - _prevRotation = convertedDisableInterp ? rot : _rotation; + _prevRotation = ValueOr(noInterpolation, false) ? rot : _rotation; _rotation = rot; } - /// Set the horizon's transparency. - // @function SetTransparency - // @tparam float transparency New transparency alpha. void Horizon::SetTransparency(float value) { _transparency = value; diff --git a/TombEngine/Scripting/Internal/TEN/Flow/InventoryItem/InventoryItem.cpp b/TombEngine/Scripting/Internal/TEN/Flow/InventoryItem/InventoryItem.cpp index 5037763ca..9d229fb41 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/InventoryItem/InventoryItem.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/InventoryItem/InventoryItem.cpp @@ -4,9 +4,7 @@ #include "Scripting/Internal/ReservedScriptNames.h" #include "Scripting/Internal/ScriptAssert.h" -/*** -Represents the properties of an object as it appears in the inventory. - +/*** Represents the properties of an object as it appears in the inventory. To be used in @{Flow.Level.objects} list. @tenprimitive Flow.InventoryItem @pragma nostrip */ diff --git a/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp b/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp index 30e0718a0..2db27d8db 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp @@ -8,7 +8,7 @@ using namespace TEN::Scripting::Types; -/// Represents a global lens flare (not to be confused with the lens flare object). +/// Represents a global lens flare (not to be confused with the lens flare object). To be used with @{Flow.Level.lensFlare} property. // // @tenprimitive Flow.LensFlare // @pragma nostrip @@ -25,16 +25,39 @@ namespace TEN::Scripting "LensFlare", ctors(), sol::call_constructor, ctors(), + /// (bool) Lens flare enabled state. + // If set to true, lens flare will be visible. + // @mem enabled + "enabled", sol::property(&LensFlare::GetEnabled, &LensFlare::SetEnabled), + + /// (int) Lens flare's sun sprite object ID. + // @mem spriteID + "spriteID", sol::property(&LensFlare::GetSunSpriteID, &LensFlare::SetSunSpriteID), + + /// (float) Lens flare's pitch (vertical) angle in degrees. + // @mem pitch + "pitch", sol::property(&LensFlare::GetPitch, &LensFlare::SetPitch), + + /// (float) Lens flare's yaw (horizontal) angle in degrees. + // @mem yaw + "yaw", sol::property(&LensFlare::GetYaw, &LensFlare::SetYaw), + + /// (Color) Lens flare's color. + // @mem color + "color", sol::property(&LensFlare::GetColor, &LensFlare::SetColor), + + // Compatibility. "GetSunSpriteID", &LensFlare::GetSunSpriteID, "GetPitch", &LensFlare::GetPitch, "GetYaw", &LensFlare::GetYaw, "GetColor", &LensFlare::GetColor, - "GetEnabled", &LensFlare::GetEnabledStatus, + "GetEnabled", &LensFlare::GetEnabled, "SetSunSpriteID", &LensFlare::SetSunSpriteID, "SetPitch", &LensFlare::SetPitch, "SetYaw", &LensFlare::SetYaw, - "SetColor", &LensFlare::SetColor); + "SetColor", &LensFlare::SetColor, + "SetEnabled", &LensFlare::SetEnabled); } /// Create a LensFlare object. @@ -50,48 +73,31 @@ namespace TEN::Scripting _rotation = Rotation(pitch, yaw, 0.0f); } - /// Get this lens flare's sun sprite ID. - // @function LensFlare:GetSunSpriteID - // @treturn int Sprite ID. int LensFlare::GetSunSpriteID() const { return _sunSpriteID; } - /// Get this lens flare's pitch angle in degrees. - // @function LensFlare:GetPitch - // @treturn float Pitch angle in degrees. float LensFlare::GetPitch() const { return _rotation.x; } - /// Get this lens flare's yaw angle in degrees. - // @function LensFlare:GetYaw - // @treturn float Yaw angle in degrees. float LensFlare::GetYaw() const { return _rotation.y; } - /// Get the lens flare's color. - // @function LensFlare:GetColor ScriptColor LensFlare::GetColor() const { return _color; } - /// Get this lens flare's enabled status. - // @function LensFlare:GetEnabled - // @treturn bool Enabled status. __true: enabled__, __false: disabled__ - bool LensFlare::GetEnabledStatus() const + bool LensFlare::GetEnabled() const { return _isEnabled; } - /// Set this lens flare's sun sprite ID. - // @function LensFlare:SetSunSpriteID - // @tparam int spriteID New sun sprite ID. void LensFlare::SetSunSpriteID(int spriteID) { // Sprite ID out of range; return early. @@ -104,27 +110,23 @@ namespace TEN::Scripting _sunSpriteID = spriteID; } - /// Set this lens flare's pitch angle. - // @function LensFlare:SetPitch - // @tparam float pitch New pitch angle in degrees. void LensFlare::SetPitch(float pitch) { _rotation.x = pitch; } - /// Set this lens flare's yaw angle. - // @function LensFlare:SetYaw - // @tparam float yaw New yaw angle in degrees. void LensFlare::SetYaw(float yaw) { _rotation.y = yaw; } - - /// Set this lens flare's color. - // @function LensFlare:SetColor - // @tparam Color color New color. + void LensFlare::SetColor(const ScriptColor& color) { _color = color; } + + void LensFlare::SetEnabled(bool value) + { + _isEnabled = value; + } } diff --git a/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.h b/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.h index d1585ac5d..bbf2f1cff 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.h +++ b/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.h @@ -39,7 +39,7 @@ namespace TEN::Scripting float GetPitch() const; float GetYaw() const; ScriptColor GetColor() const; - bool GetEnabledStatus() const; + bool GetEnabled() const; // Setters @@ -47,5 +47,6 @@ namespace TEN::Scripting void SetPitch(float pitch); void SetYaw(float yaw); void SetColor(const ScriptColor& color); + void SetEnabled(bool value); }; } diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp index 837b6af77..410311789 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp @@ -15,7 +15,7 @@ These are things things which aren't present in the compiled level file itself. /// Make a new Level object. //@function Level -//@treturn Level a Level object +//@treturn Level a Level object. void Level::Register(sol::table& parent) { // Register type. @@ -49,11 +49,11 @@ void Level::Register(sol::table& parent) //@mem ambientTrack "ambientTrack", &Level::AmbientTrack, -/// (@{Flow.SkyLayer}) Primary sky layer +/// (@{Flow.SkyLayer}) Primary sky cloud layer. //@mem layer1 "layer1", &Level::Layer1, -/// (@{Flow.SkyLayer}) Secondary sky layer +/// (@{Flow.SkyLayer}) Secondary sky cloud layer. //@mem layer2 "layer2", &Level::Layer2, @@ -63,20 +63,20 @@ void Level::Register(sol::table& parent) "horizon", sol::property(&Level::GetHorizon1Enabled, &Level::SetHorizon1Enabled), // Compatibility. /// (@{Flow.Horizon}) Second horizon layer. -//@mem horizon1 +//@mem horizon2 "horizon2", &Level::Horizon2, -/// (@{Flow.Starfield}) Starfield. -// @mem starfield - "starfield", &Level::Starfield, +/// (@{Flow.StarField}) Starfield in the sky. +// @mem starField + "starField", &Level::Starfield, + "starfield", &Level::Starfield, // Compatibility. -/// (@{Flow.LensFlare}) Global lens flare . +/// (@{Flow.LensFlare}) Global lens flare. // @mem lensFlare "lensFlare", &Level::LensFlare, -/// (@{Flow.Fog}) omni fog RGB color and distance. -// As seen in TR4's Desert Railroad. -// If not provided, distance fog will be black. +/// (@{Flow.Fog}) Global distance fog, with specified RGB color and distance. +// If not provided, distance fog will not be visible. //@mem fog "fog", &Level::Fog, @@ -126,11 +126,11 @@ e.g. `myLevel.laraType = LaraType.Divesuit` //@mem resetHub "resetHub", &Level::ResetHub, -/// (table of @{Flow.InventoryItem}s) table of inventory object overrides +/// (table of @{Flow.InventoryItem}s) A table of inventory object layout overrides. //@mem objects "objects", &Level::InventoryObjects, -/// (short) Set Secrets for Level +/// (short) Set total secret count for current level. //@mem secrets "secrets", sol::property(&Level::GetSecrets, &Level::SetSecrets) ); @@ -308,7 +308,7 @@ EulerAngles Level::GetHorizonPrevOrientation(int index) const bool Level::GetLensFlareEnabled() const { - return LensFlare.GetEnabledStatus(); + return LensFlare.GetEnabled(); } int Level::GetLensFlareSunSpriteID() const @@ -331,16 +331,6 @@ Color Level::GetLensFlareColor() const return LensFlare.GetColor(); } -bool Level::GetStarfieldStarsEnabled() const -{ - return Starfield.GetStarsEnabledStatus(); -} - -bool Level::GetStarfieldMeteorsEnabled() const -{ - return Starfield.GetMeteorsEnabledStatus(); -} - int Level::GetStarfieldStarCount() const { return Starfield.GetStarCount(); diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.h b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.h index d9b46a253..4abfd5c23 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.h +++ b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.h @@ -93,8 +93,6 @@ struct Level : public ScriptInterfaceLevel Color GetLensFlareColor() const override; // Starfield getters - bool GetStarfieldStarsEnabled() const override; - bool GetStarfieldMeteorsEnabled() const override; int GetStarfieldStarCount() const override; int GetStarfieldMeteorCount() const override; int GetStarfieldMeteorSpawnDensity() const override; diff --git a/TombEngine/Scripting/Internal/TEN/Flow/SkyLayer/SkyLayer.cpp b/TombEngine/Scripting/Internal/TEN/Flow/SkyLayer/SkyLayer.cpp index 027572219..33bf45fa1 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/SkyLayer/SkyLayer.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/SkyLayer/SkyLayer.cpp @@ -7,9 +7,7 @@ namespace TEN::Scripting::Types { class ScriptColor; } using namespace TEN::Scripting::Types; -/*** Describes a layer of moving clouds. -As seen in TR4's City of the Dead. - +/*** Describes a layer of moving clouds. To be used with @{Flow.Level.layer1} and @{Flow.Level.layer2} properties. @tenprimitive Flow.SkyLayer @pragma nostrip */ diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp index 5502b8d59..35c857b47 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp @@ -6,9 +6,8 @@ using namespace TEN::Effects::Environment; -/// Represents a starfield in the sky. -// -// @tenprimitive Flow.Starfield +/// Represents a star field in the sky. To be used with @{Flow.Level.starField} property. +// @tenprimitive Flow.StarField // @pragma nostrip namespace TEN::Scripting @@ -21,38 +20,55 @@ namespace TEN::Scripting // Register type. parent.new_usertype( - "Starfield", + "StarField", ctors(), sol::call_constructor, ctors(), + /// (int) Amount of visible stars. + // @mem starCount + "starCount", sol::property(&Starfield::GetStarCount, &Starfield::SetStarCount), + + /// (int) Amount of visible meteors. + // @mem meteorCount + "meteorCount", sol::property(&Starfield::GetMeteorCount, &Starfield::SetMeteorCount), + + /// (int) Meteor spawn density. + // @mem meteorSpawnDensity + "meteorSpawnDensity", sol::property(&Starfield::GetMeteorSpawnDensity, &Starfield::SetMeteorSpawnDensity), + + /// (int) Meteor velocity. + // @mem meteorVelocity + "meteorVelocity", sol::property(&Starfield::GetMeteorVelocity, &Starfield::SetMeteorVelocity), + + // Compatibility. "GetStarCount", &Starfield::GetStarCount, "GetMeteorCount", &Starfield::GetMeteorCount, "GetMeteorSpawnDensity", &Starfield::GetMeteorSpawnDensity, "GetMeteorVelocity", &Starfield::GetMeteorVelocity, - "GetStarsEnabled", &Starfield::GetStarsEnabledStatus, - "GetMeteorsEnabled", &Starfield::GetMeteorsEnabledStatus, "SetStarCount", &Starfield::SetStarCount, "SetMeteorCount", &Starfield::SetMeteorCount, "SetMeteorSpawnDensity", &Starfield::SetMeteorSpawnDensity, "SetMeteorVelocity", &Starfield::SetMeteorVelocity); + + parent["StarField"] = parent["Starfield"]; } /// Create a starfield object with only stars. - // @function Starfield + // @function StarField // @tparam int starCount Star count. - // @treturn Starfield A new Starfield object. + // @treturn Starfield A new StarField object. Starfield::Starfield(int starCount) { _starCount = starCount; } /// Create a starfield object with stars and meteors. - // @function Starfield + // @function StarField // @tparam int starCount Star count. __Max: 6000__ // @tparam int meteorCount Meteor count. __Max: 100__ // @tparam int meteorSpawnDensity Meteor spawn density. // @tparam int meteorVel Meteor velocity. - // @treturn Starfield A new Starfield object. + // @treturn StarField A new StarField object. Starfield::Starfield(int starCount, int meteorCount, int meteorSpawnDensity, float meteorVel) { if (starCount < 0 || starCount > STAR_COUNT_MAX) @@ -67,57 +83,26 @@ namespace TEN::Scripting _meteorVelocity = meteorVel; } - /// Get this starfield's number of stars. - // @function Starfield:GetStarCount - // @treturn int Count. int Starfield::GetStarCount() const { return _starCount; } - /// Get this starfield's number of meteors. - // @function Starfield:GetMeteorCount - // @treturn int Count. int Starfield::GetMeteorCount() const { return _meteorCount; } - /// Get this starfield's meteor spawn density. - // @function Starfield:GetMeteorSpawnDensity - // @treturn int Spawn density. int Starfield::GetMeteorSpawnDensity() const { return _meteorSpawnDensity; } - /// Get this starfield's meteor velocity. - // @function Starfield:GetMeteorVelocity - // @treturn float Velocity. float Starfield::GetMeteorVelocity() const { return _meteorVelocity; } - /// Get this starfield's stars enabled status. - // @function Starfield:GetStarsEnabled - // @treturn bool Stars enabled status. __true: enabled__, __false: disabled__ - bool Starfield::GetStarsEnabledStatus() const - { - return (_starCount > 0); - } - - /// Get this starfield's meteors enabled status. - // @function Starfield:GetMeteorsEnabled - // @treturn bool Meteors enabled status. __true: enabled__, __false: disabled__ - bool Starfield::GetMeteorsEnabledStatus() const - { - return (_meteorCount > 0); - } - - /// Set this starfield's number of stars. - // @function Starfield:SetStarCount - // @tparam int count New star count. void Starfield::SetStarCount(int count) { if (count < 0 || count > STAR_COUNT_MAX) @@ -126,9 +111,6 @@ namespace TEN::Scripting _starCount = std::clamp(count, 0, STAR_COUNT_MAX); } - /// Set this starfield's number of meteors. - // @function Starfield:SetMeteorCount - // @tparam int count New meteor count. void Starfield::SetMeteorCount(int count) { if (count < 0 || count > METEOR_COUNT_MAX) @@ -137,17 +119,11 @@ namespace TEN::Scripting _meteorCount = std::clamp(count, 0, METEOR_COUNT_MAX); } - /// Set this starfield's meteor spawn density. - // @function Starfield:SetMeteorSpawnDensity - // @tparam int density New meteor spawn density. void Starfield::SetMeteorSpawnDensity(int spawnDensity) { _meteorSpawnDensity = spawnDensity; } - /// Set this starfield's meteor velocity. - // @function Starfield:SetMeteorVelocity - // @tparam float velocity New meteor velocity. void Starfield::SetMeteorVelocity(float vel) { _meteorVelocity = vel; diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.h b/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.h index 4f7045b8c..7e918e996 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.h +++ b/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.h @@ -35,8 +35,6 @@ namespace TEN::Scripting int GetMeteorCount() const; int GetMeteorSpawnDensity() const; float GetMeteorVelocity() const; - bool GetStarsEnabledStatus() const; - bool GetMeteorsEnabledStatus() const; // Setters diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp index 70f2ca4aa..30fd28657 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp +++ b/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp @@ -30,7 +30,7 @@ using namespace TEN::Scripting::Types; // Examples include the player, traps, enemies, doors, and pickups. See also @{Objects.LaraObject} for player-specific features. // // @tenclass Objects.Moveable -// pragma nostrip +// @pragma nostrip static auto IndexError = IndexErrorMaker(Moveable, ScriptReserved_Moveable); static auto NewIndexError = NewIndexErrorMaker(Moveable, ScriptReserved_Moveable); diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Room/RoomObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Room/RoomObject.cpp index dfd348284..1dc91890a 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/Room/RoomObject.cpp +++ b/TombEngine/Scripting/Internal/TEN/Objects/Room/RoomObject.cpp @@ -51,7 +51,7 @@ using namespace TEN::Scripting::Types; } /// Get the room's number. - // @function Room:GetRoomNumber() + // @function Room:GetRoomNumber // @treturn int Room number. int Room::GetRoomNumber() const { @@ -59,7 +59,7 @@ using namespace TEN::Scripting::Types; } /// Get the room's unique string identifier. - // @function Room:GetName() + // @function Room:GetName // @treturn string Room name. std::string Room::GetName() const { @@ -67,7 +67,7 @@ using namespace TEN::Scripting::Types; } /// Get the room's ambient light color. - // @function Room:GetColor() + // @function Room:GetColor // @treturn Color Ambient light color. ScriptColor Room::GetColor() const { @@ -75,7 +75,7 @@ using namespace TEN::Scripting::Types; } /// Get the room's reverb type. - // @function Room:GetReverbType() + // @function Room:GetReverbType // @treturn Objects.RoomReverb Reverb type. ReverbType Room::GetReverbType() const { @@ -83,7 +83,7 @@ using namespace TEN::Scripting::Types; } /// Set the room's unique string identifier. - // @function Room:SetName() + // @function Room:SetName // @tparam string name New name. void Room::SetName(const std::string& name) { @@ -104,7 +104,7 @@ using namespace TEN::Scripting::Types; } /// Set the room's reverb type. - // @function Room:SetReverbType() + // @function Room:SetReverbType // @tparam Objects.RoomReverb Reverb type. void Room::SetReverbType(ReverbType reverb) { @@ -112,7 +112,7 @@ using namespace TEN::Scripting::Types; } /// Set the room's specified flag. - // @function Room:SetFlag() + // @function Room:SetFlag // @tparam Objects.RoomFlagID flagID Room flag ID. // @tparam bool Boolean to set the flag to. void Room::SetFlag(RoomEnvFlags flag, bool value) @@ -128,7 +128,7 @@ using namespace TEN::Scripting::Types; } /// Get the room's specified flag value (true or false). - // @function Room:GetFlag() + // @function Room:GetFlag // @tparam Objects.RoomFlagID flagID Room flag ID. bool Room::IsTagPresent(const std::string& tag) const { @@ -144,7 +144,7 @@ using namespace TEN::Scripting::Types; } /// Check if the specified tag is set for the room. - // @function Room:IsTagPresent() + // @function Room:IsTagPresent // @tparam string tag Text tag to check (case sensitive). // @treturn bool Boolean of the tag's presence. bool Room::GetActive() const @@ -153,7 +153,7 @@ using namespace TEN::Scripting::Types; } /// Check if the room is active. - // @function Room:GetActive() + // @function Room:GetActive // @treturn bool Boolean of the room's active status. bool Room::GetFlag(RoomEnvFlags flag) const { diff --git a/TombEngine/Scripting/Internal/TEN/Sound/SoundHandler.cpp b/TombEngine/Scripting/Internal/TEN/Sound/SoundHandler.cpp index 713b7f2d5..73522ae03 100644 --- a/TombEngine/Scripting/Internal/TEN/Sound/SoundHandler.cpp +++ b/TombEngine/Scripting/Internal/TEN/Sound/SoundHandler.cpp @@ -14,90 +14,90 @@ namespace TEN::Scripting::Sound { - /// Play an audio track - //@function PlayAudioTrack - //@tparam string name of track (without file extension) to play - //@tparam Sound.SoundTrackType type of the audio track to play + /// Play an audio track. Supported formats are wav, mp3 and ogg. + // @function PlayAudioTrack + // @tparam string filename Filename of a track (without file extension) to play. + // @tparam Sound.SoundTrackType type Type of the audio track to play. static void PlayAudioTrack(const std::string& trackName, TypeOrNil mode) { auto playMode = ValueOr(mode, SoundTrackType::OneShot); PlaySoundTrack(trackName, playMode); } - /// Set and play an ambient track + /// Set and play an ambient track. // @function SetAmbientTrack - // @tparam string name of track (without file extension) to play - // @tparam bool fromStart specifies whether ambient track should play from the start, or crossfade at a random position + // @tparam string name Name of track (without file extension) to play. + // @tparam bool fromStart Specifies whether ambient track should play from the start, or crossfade at a random position. static void SetAmbientTrack(const std::string& trackName, TypeOrNil fromTheBeginning) { auto pos = ValueOr(fromTheBeginning, false) ? std::optional(0) : std::optional(); PlaySoundTrack(trackName, SoundTrackType::BGM, pos, pos.has_value() ? SOUND_XFADETIME_ONESHOT : SOUND_XFADETIME_BGM); } - ///Stop any audio tracks currently playing - //@function StopAudioTracks + /// Stop any audio tracks currently playing. + // @function StopAudioTracks static void StopAudioTracks() { StopSoundTracks(); } - ///Stop audio track that is currently playing - //@function StopAudioTrack - //@tparam Sound.SoundTrackType type of the audio track + /// Stop audio track that is currently playing. + // @function StopAudioTrack + // @tparam Sound.SoundTrackType type Type of the audio track. static void StopAudioTrack(TypeOrNil mode) { auto playMode = ValueOr(mode, SoundTrackType::OneShot); StopSoundTrack(playMode, SOUND_XFADETIME_ONESHOT); } - ///Get current loudness level for specified track type - //@function GetAudioTrackLoudness - //@tparam Sound.SoundTrackType type of the audio track - //@treturn float current loudness of a specified audio track + /// Get current loudness level for specified track type. + // @function GetAudioTrackLoudness + // @tparam Sound.SoundTrackType type Type of the audio track. + // @treturn float Current loudness of a specified audio track. static float GetAudioTrackLoudness(TypeOrNil mode) { auto playMode = ValueOr(mode, SoundTrackType::OneShot); return GetSoundTrackLoudness(playMode); } - /// Play sound effect - //@function PlaySound - //@tparam int sound ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. - ////@tparam[opt] Vec3 position The 3D position of the sound, i.e. where the sound "comes from". If not given, the sound will not be positional. + /// Play sound effect. + // @function PlaySound + // @tparam int soundID Sound ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. + // @tparam[opt] Vec3 position The 3D position of the sound, i.e. where the sound "comes from". If not given, the sound will not be positional. static void PlaySoundEffect(int soundID, sol::optional pos) { SoundEffect(soundID, pos.has_value() ? &Pose(pos->ToVector3i()) : nullptr, SoundEnvironment::Always); } - /// Stop sound effect - //@function StopSound - //@tparam int sound ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. + /// Stop sound effect. + // @function StopSound + // @tparam int soundID Sound ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. static void StopSound(int id) { StopSoundEffect(id); } - /// Check if the sound effect is playing - //@function IsSoundPlaying - //@tparam int Sound ID to check. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. + /// Check if the sound effect is playing. + // @function IsSoundPlaying + // @tparam int soundID Sound ID to check. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. static bool IsSoundPlaying(int effectID) { return (Sound_EffectIsPlaying(effectID, nullptr) != SOUND_NO_CHANNEL); } - /// Check if the audio track is playing - //@function IsAudioTrackPlaying - //@tparam string Track filename to check. Should be without extension and without full directory path. + /// Check if the audio track is playing. + // @function IsAudioTrackPlaying + // @tparam string Track Filename to check. Should be without extension and without full directory path. static bool IsAudioTrackPlaying(const std::string& trackName) { return Sound_TrackIsPlaying(trackName); } - ///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. - //@function GetCurrentSubtitle - //@treturn string current subtitle string + /// 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. + // @function GetCurrentSubtitle + // @treturn string Current subtitle string. static TypeOrNil GetCurrentVoiceTrackSubtitle() { auto& result = GetCurrentSubtitle(); diff --git a/TombEngine/Scripting/Internal/TEN/Types/Rotation/Rotation.cpp b/TombEngine/Scripting/Internal/TEN/Types/Rotation/Rotation.cpp index 8b8b5e25f..e5d93f2e5 100644 --- a/TombEngine/Scripting/Internal/TEN/Types/Rotation/Rotation.cpp +++ b/TombEngine/Scripting/Internal/TEN/Types/Rotation/Rotation.cpp @@ -25,6 +25,9 @@ namespace TEN::Scripting // Meta functions sol::meta_function::to_string, &Rotation::ToString, + sol::meta_function::equal_to, &Rotation::operator ==, + sol::meta_function::addition, &Rotation::operator +, + sol::meta_function::subtraction, &Rotation::operator -, // Utilities ScriptReserved_RotationLerp, &Rotation::Lerp, @@ -108,4 +111,41 @@ namespace TEN::Scripting { return Vector3(x, y, z); }; + + bool Rotation::operator ==(const Rotation& rot) const + { + return (rot.x == x && rot.y == y && rot.z == z); + } + + Rotation Rotation::operator +(const Rotation& rot) const + { + return Rotation(WrapAngle(x + rot.x), WrapAngle(y + rot.y), WrapAngle(z + rot.z)); + } + + Rotation Rotation::operator -(const Rotation& rot) const + { + return Rotation(WrapAngle(x - rot.x), WrapAngle(y - rot.y), WrapAngle(z - rot.z)); + } + + Rotation& Rotation::operator +=(const Rotation& rot) + { + x = WrapAngle(x + rot.x); + y = WrapAngle(y + rot.y); + z = WrapAngle(z + rot.z); + return *this; + } + + Rotation& Rotation::operator -=(const Rotation& rot) + { + x = WrapAngle(x - rot.x); + y = WrapAngle(y - rot.y); + z = WrapAngle(z - rot.z); + return *this; + } + + float Rotation::WrapAngle(float angle) const + { + angle -= std::floor(angle / 360.0f) * 360.0f; + return ((angle < 0.0f) ? (angle + 360.0f) : angle); + } } diff --git a/TombEngine/Scripting/Internal/TEN/Types/Rotation/Rotation.h b/TombEngine/Scripting/Internal/TEN/Types/Rotation/Rotation.h index af835a1c3..084977b4b 100644 --- a/TombEngine/Scripting/Internal/TEN/Types/Rotation/Rotation.h +++ b/TombEngine/Scripting/Internal/TEN/Types/Rotation/Rotation.h @@ -40,5 +40,16 @@ namespace TEN::Scripting // Operators operator Vector3() const; + + bool operator ==(const Rotation& rot) const; + Rotation operator +(const Rotation& rot) const; + Rotation operator -(const Rotation& rot) const; + Rotation& operator +=(const Rotation& rot); + Rotation& operator -=(const Rotation& rot); + + private: + // Helpers + + float WrapAngle(float angle) const; }; } diff --git a/TombEngine/Scripting/Internal/TEN/Types/Vec2/Vec2.cpp b/TombEngine/Scripting/Internal/TEN/Types/Vec2/Vec2.cpp index cb99bc588..33b8caac9 100644 --- a/TombEngine/Scripting/Internal/TEN/Types/Vec2/Vec2.cpp +++ b/TombEngine/Scripting/Internal/TEN/Types/Vec2/Vec2.cpp @@ -84,15 +84,6 @@ Vec2::Vec2(const Vector2& vector) y = vector.y; }*/ -/// Metafunction. Use tostring(vector). -// @tparam Vec2 This Vec2. -// @treturn string A string showing the X and Y components of the Vec2. -// @function __tostring -std::string Vec2::ToString() const -{ - return "{" + std::to_string(x) + ", " + std::to_string(y) + "}"; -} - /// Get a copy of this Vec2 normalized to length 1. // @function Vec2:Normalize // @treturn Vec2 Normalized vector. @@ -105,7 +96,7 @@ Vec2 Vec2::Normalize() const } /// Get a copy of this Vec2 translated in the input Vec2 direction by the input distance. -// @function Translate +// @function Vec2:Translate // @tparam Vec2 dir Direction vector. Normalized automatically to length 1. // @tparam float dist Distance. // @treturn Vec2 Translated vector. @@ -115,7 +106,7 @@ Vec2 Vec2::Translate(const Vec2& dir, float dist) } /// Get a copy of this Vec2 translated in the direction of the input rotation in degrees by the input distance. -// @function Translate +// @function Vec2:Translate // @tparam Rotation rot Rotation in degrees defining the direction. // @tparam float dist Distance. // @treturn Vec2 Translated vector. @@ -125,7 +116,7 @@ Vec2 Vec2::Translate(float rot, float dist) } /// Get a copy of this Vec2 translated by an offset, where the input relative offset Vec2 is rotated according to the input rotation in degrees. -// @function Translate +// @function Vec2:Translate // @tparam float rot Rotation in degrees rotating the input relative offset vector. // @tparam Vec2 relOffset Relative offset vector before rotation. // @treturn Vec2 Translated vector. @@ -203,6 +194,15 @@ float Vec2::Length() const return ToVector2().Length(); } +/// Metafunction. Use tostring(vector). +// @tparam Vec2 This Vec2. +// @treturn string A string showing the X and Y components of the Vec2. +// @function __tostring +std::string Vec2::ToString() const +{ + return "{" + std::to_string(x) + ", " + std::to_string(y) + "}"; +} + Vec2 Vec2::Add(const Vec2& vector0, const Vec2& vector1) { return Vec2(vector0.x + vector1.x, vector0.y + vector1.y); From ed938bfeb963825822581ff808bb48807772c271 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Tue, 11 Mar 2025 23:46:31 +0100 Subject: [PATCH 045/160] Type updates --- Documentation/doc/1 modules/Effects.html | 4 ++-- .../Scripting/Internal/TEN/Effects/EffectsFunctions.cpp | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Documentation/doc/1 modules/Effects.html b/Documentation/doc/1 modules/Effects.html index 1a475096e..b84fdf1e2 100644 --- a/Documentation/doc/1 modules/Effects.html +++ b/Documentation/doc/1 modules/Effects.html @@ -313,7 +313,7 @@ Specify if the particle will poison the player on collision. Default: false
  • spriteSeqID - ObjID + SpriteConstants ID of the sprite sequence object. Default: Objects.ObjID.DEFAULT_SPRITES
  • startRot @@ -829,7 +829,7 @@ EmitAdvancedParticle(particle) Velocity.
  • spriteSeqID - ObjID + SpriteConstants ID of the sprite sequence object. Default: Objects.ObjID.DEFAULT_SPRITES (optional)
    • diff --git a/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp b/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp index 3c1effb87..755a1fadf 100644 --- a/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp +++ b/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp @@ -123,7 +123,7 @@ namespace TEN::Scripting::Effects // @tparam float life Lifespan in seconds. __Default: 2__ // @tparam bool applyDamage Specify if the particle will harm the player on collision. __Default: false__ // @tparam bool applyPoison Specify if the particle will poison the player on collision. __Default: false__ - // @tparam Objects.ObjID spriteSeqID ID of the sprite sequence object. __Default: Objects.ObjID.DEFAULT_SPRITES__ + // @tparam Objects.ObjID.SpriteConstants spriteSeqID ID of the sprite sequence object. __Default: Objects.ObjID.DEFAULT_SPRITES__ // @tparam float startRot Rotation at start of life. __Default: random__ // @usage // EmitParticle( @@ -259,7 +259,7 @@ namespace TEN::Scripting::Effects // @table ParticleData // @tfield Vec3 position World position. // @tfield Vec3 velocity Velocity. - // @tfield[opt] Objects.ObjID spriteSeqID ID of the sprite sequence object. __Default: Objects.ObjID.DEFAULT_SPRITES__ + // @tfield[opt] Objects.ObjID.SpriteConstants spriteSeqID ID of the sprite sequence object. __Default: Objects.ObjID.DEFAULT_SPRITES__ // @tfield[opt] int spriteID ID of the sprite in the sprite sequence object.__Default: 0__ // @tfield[opt] float lifetime Lifespan in seconds. __Default: 2__ // @tfield[opt] float maxYVelocity Specifies ithe maximum Y velocity for the particle. __Default: 0__ From 74fa394bd79e8e0878dd3ef185b4cb907bcd6af8 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Tue, 11 Mar 2025 23:52:11 +0100 Subject: [PATCH 046/160] Update enums and documentation --- Documentation/doc/4 enums/Objects.ObjID.html | 12 +++++++++ Documentation/generate_objectlist.ps1 | 5 ++-- .../Internal/TEN/Objects/ObjectIDs.h | 26 +++++++++++++++++-- 3 files changed, 39 insertions(+), 4 deletions(-) diff --git a/Documentation/doc/4 enums/Objects.ObjID.html b/Documentation/doc/4 enums/Objects.ObjID.html index ad84d4d32..e25106e81 100644 --- a/Documentation/doc/4 enums/Objects.ObjID.html +++ b/Documentation/doc/4 enums/Objects.ObjID.html @@ -512,6 +512,11 @@ DAMOCLES_SWORD ELECTRIC_CLEANER SLAMMING_DOORS SWINGING_BLADE +ELECTRIC_BALL +ELECTRIC_BALL_IMPACT_POINT +THOR_HAMMER_HANDLE +THOR_HAMMER_HEAD +MOVING_LASER PUZZLE_ITEM1 PUZZLE_ITEM2 PUZZLE_ITEM3 @@ -946,6 +951,7 @@ FISHTANK DOPPELGANGER_ORIGIN CORPSE WRAITH_TRAP +WATERFALL_EMITTER MESHSWAP1 MESHSWAP2 MESHSWAP3 @@ -1125,10 +1131,13 @@ HEALTH_BAR_TEXTURE AIR_BAR_TEXTURE DASH_BAR_TEXTURE SFX_BAR_TEXTURE +WATERFALL_SPRITES CROSSHAIR_GRAPHICS SPEEDOMETER_GRAPHICS CUSTOM_BAR_GRAPHICS CUSTOM_AMMO_GRAPHICS +DIARY_SPRITES +DIARY_ENTRY_SPRITES @@ -1400,10 +1409,13 @@ HEALTH_BAR_TEXTURE AIR_BAR_TEXTURE DASH_BAR_TEXTURE SFX_BAR_TEXTURE +WATERFALL_SPRITES CROSSHAIR_GRAPHICS SPEEDOMETER_GRAPHICS CUSTOM_BAR_GRAPHICS CUSTOM_AMMO_GRAPHICS +DIARY_SPRITES +DIARY_ENTRY_SPRITES diff --git a/Documentation/generate_objectlist.ps1 b/Documentation/generate_objectlist.ps1 index c1c45b354..d86cd5c4e 100644 --- a/Documentation/generate_objectlist.ps1 +++ b/Documentation/generate_objectlist.ps1 @@ -66,7 +66,8 @@ if ($enumValues.Count -gt 0) { $enumValues = $enumValues[1..($enumValues.Count - $header = @" #pragma once -// Last generated on $(Get-Date -Format "dd/MM/yyyy") +// This file is generated automatically, do not edit it. +// Last generated on $(Get-Date -Format "dd/MM/yyyy"). #include #include @@ -121,7 +122,7 @@ $spriteFooter = @" "@ # Map definition. -$mapHeader = "static const std::unordered_map kObjIDs {" +$mapHeader = "static const std::unordered_map GAME_OBJECT_IDS {" $mapBody = ($enumValues | ForEach-Object { "`t" + '{ "' + "$_" + '", ID_' + "$_" + ' }' }) -join ",`r`n" $mapFooter = "};" diff --git a/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h b/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h index ac4294029..b302b21c0 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h +++ b/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h @@ -1,6 +1,7 @@ #pragma once -// Last generated on 11/03/2025 +// This file is generated automatically, do not edit it. +// Last generated on 11/03/2025. #include #include @@ -374,6 +375,11 @@ The following constants are inside ObjID. ELECTRIC_CLEANER SLAMMING_DOORS SWINGING_BLADE + ELECTRIC_BALL + ELECTRIC_BALL_IMPACT_POINT + THOR_HAMMER_HANDLE + THOR_HAMMER_HEAD + MOVING_LASER PUZZLE_ITEM1 PUZZLE_ITEM2 PUZZLE_ITEM3 @@ -808,6 +814,7 @@ The following constants are inside ObjID. DOPPELGANGER_ORIGIN CORPSE WRAITH_TRAP + WATERFALL_EMITTER MESHSWAP1 MESHSWAP2 MESHSWAP3 @@ -987,10 +994,13 @@ The following constants are inside ObjID. AIR_BAR_TEXTURE DASH_BAR_TEXTURE SFX_BAR_TEXTURE + WATERFALL_SPRITES CROSSHAIR_GRAPHICS SPEEDOMETER_GRAPHICS CUSTOM_BAR_GRAPHICS CUSTOM_AMMO_GRAPHICS + DIARY_SPRITES + DIARY_ENTRY_SPRITES @table Members */ @@ -1234,10 +1244,13 @@ The following ObjID members refer to sprites. AIR_BAR_TEXTURE DASH_BAR_TEXTURE SFX_BAR_TEXTURE + WATERFALL_SPRITES CROSSHAIR_GRAPHICS SPEEDOMETER_GRAPHICS CUSTOM_BAR_GRAPHICS CUSTOM_AMMO_GRAPHICS + DIARY_SPRITES + DIARY_ENTRY_SPRITES @table SpriteConstants */ static const std::unordered_map GAME_OBJECT_IDS { @@ -1599,6 +1612,11 @@ static const std::unordered_map GAME_OBJECT_IDS { { "ELECTRIC_CLEANER", ID_ELECTRIC_CLEANER }, { "SLAMMING_DOORS", ID_SLAMMING_DOORS }, { "SWINGING_BLADE", ID_SWINGING_BLADE }, + { "ELECTRIC_BALL", ID_ELECTRIC_BALL }, + { "ELECTRIC_BALL_IMPACT_POINT", ID_ELECTRIC_BALL_IMPACT_POINT }, + { "THOR_HAMMER_HANDLE", ID_THOR_HAMMER_HANDLE }, + { "THOR_HAMMER_HEAD", ID_THOR_HAMMER_HEAD }, + { "MOVING_LASER", ID_MOVING_LASER }, { "PUZZLE_ITEM1", ID_PUZZLE_ITEM1 }, { "PUZZLE_ITEM2", ID_PUZZLE_ITEM2 }, { "PUZZLE_ITEM3", ID_PUZZLE_ITEM3 }, @@ -2033,6 +2051,7 @@ static const std::unordered_map GAME_OBJECT_IDS { { "DOPPELGANGER_ORIGIN", ID_DOPPELGANGER_ORIGIN }, { "CORPSE", ID_CORPSE }, { "WRAITH_TRAP", ID_WRAITH_TRAP }, + { "WATERFALL_EMITTER", ID_WATERFALL_EMITTER }, { "MESHSWAP1", ID_MESHSWAP1 }, { "MESHSWAP2", ID_MESHSWAP2 }, { "MESHSWAP3", ID_MESHSWAP3 }, @@ -2212,8 +2231,11 @@ static const std::unordered_map GAME_OBJECT_IDS { { "AIR_BAR_TEXTURE", ID_AIR_BAR_TEXTURE }, { "DASH_BAR_TEXTURE", ID_DASH_BAR_TEXTURE }, { "SFX_BAR_TEXTURE", ID_SFX_BAR_TEXTURE }, + { "WATERFALL_SPRITES", ID_WATERFALL_SPRITES }, { "CROSSHAIR_GRAPHICS", ID_CROSSHAIR_GRAPHICS }, { "SPEEDOMETER_GRAPHICS", ID_SPEEDOMETER_GRAPHICS }, { "CUSTOM_BAR_GRAPHICS", ID_CUSTOM_BAR_GRAPHICS }, - { "CUSTOM_AMMO_GRAPHICS", ID_CUSTOM_AMMO_GRAPHICS } + { "CUSTOM_AMMO_GRAPHICS", ID_CUSTOM_AMMO_GRAPHICS }, + { "DIARY_SPRITES", ID_DIARY_SPRITES }, + { "DIARY_ENTRY_SPRITES", ID_DIARY_ENTRY_SPRITES } }; From 0ea5f3cdc030417bc380ee5643b696e4ec66b042 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Wed, 12 Mar 2025 00:41:16 +0100 Subject: [PATCH 047/160] Update data types in LDoc --- .../doc/3 primitive classes/Flow.Horizon.html | 12 ++++++------ .../doc/3 primitive classes/Flow.LensFlare.html | 9 ++++----- .../Scripting/Internal/TEN/Flow/Horizon/Horizon.cpp | 6 +++--- .../Internal/TEN/Flow/LensFlare/LensFlare.cpp | 6 +++--- 4 files changed, 16 insertions(+), 17 deletions(-) diff --git a/Documentation/doc/3 primitive classes/Flow.Horizon.html b/Documentation/doc/3 primitive classes/Flow.Horizon.html index fd74cd004..b432e533a 100644 --- a/Documentation/doc/3 primitive classes/Flow.Horizon.html +++ b/Documentation/doc/3 primitive classes/Flow.Horizon.html @@ -127,15 +127,15 @@     - + - + - + @@ -178,7 +178,7 @@ objectID
    - (Objects.ObjID) Horizon object ID. + (Objects.ObjID) Horizon object ID. @@ -193,7 +193,7 @@ position
    - (Vec3) Horizon position. + (Vec3) Horizon position. Specifies an offset from the camera origin. @@ -209,7 +209,7 @@ rotation
    - (Rotation) Horizon rotation. + (Rotation) Horizon rotation. Specifies horizon rotation. diff --git a/Documentation/doc/3 primitive classes/Flow.LensFlare.html b/Documentation/doc/3 primitive classes/Flow.LensFlare.html index c2e8a2807..d0739432e 100644 --- a/Documentation/doc/3 primitive classes/Flow.LensFlare.html +++ b/Documentation/doc/3 primitive classes/Flow.LensFlare.html @@ -127,7 +127,7 @@
    - + @@ -139,7 +139,7 @@ - +
    Flow.FogDistance fog.Represesnts distance fog.
    Flow.HorizonDescribes a layer of moving clouds.
    Flow.StarfieldRepresents a starfield in the sky.Flow.StarFieldRepresents a star field in the sky.
    Color
    objectID(Objects.ObjID) Horizon object ID.(Objects.ObjID) Horizon object ID.
    position(Vec3) Horizon position.(Vec3) Horizon position.
    rotation(Rotation) Horizon rotation.(Rotation) Horizon rotation.
    transparency
    spriteID(int) Lens flare's sun sprite object ID.(Objects.ObjID.SpriteConstants) Lens flare's sun sprite object ID.
    pitch
    color(Color) Lens flare's color.(Color) Lens flare's color.

    Functions

    @@ -178,7 +178,7 @@ spriteID
    - (int) Lens flare's sun sprite object ID. + (Objects.ObjID.SpriteConstants) Lens flare's sun sprite object ID. @@ -223,7 +223,7 @@ color
    - (Color) Lens flare's color. + (Color) Lens flare's color. @@ -257,7 +257,6 @@ Yaw angle in degrees.
  • color - Color Color of the lensflare.
    • diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Horizon/Horizon.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Horizon/Horizon.cpp index 1d4ef80a4..ca27087c6 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Horizon/Horizon.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Horizon/Horizon.cpp @@ -30,16 +30,16 @@ namespace TEN::Scripting // @mem enabled "enabled", sol::property(&Horizon::GetEnabled, &Horizon::SetEnabled), - /// (Objects.ObjID) Horizon object ID. + /// (@{Objects.ObjID}) Horizon object ID. // @mem objectID "objectID", sol::property(&Horizon::GetObjectID, &Horizon::SetObjectID), - /// (Vec3) Horizon position. + /// (@{Vec3}) Horizon position. // Specifies an offset from the camera origin. // @mem position "position", sol::property(&Horizon::GetPosition, &Horizon::SetPosition), - /// (Rotation) Horizon rotation. + /// (@{Rotation}) Horizon rotation. // Specifies horizon rotation. // @mem rotation "rotation", sol::property(&Horizon::GetRotation, &Horizon::SetRotation), diff --git a/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp b/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp index 2db27d8db..564b278ef 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp @@ -30,7 +30,7 @@ namespace TEN::Scripting // @mem enabled "enabled", sol::property(&LensFlare::GetEnabled, &LensFlare::SetEnabled), - /// (int) Lens flare's sun sprite object ID. + /// (@{Objects.ObjID.SpriteConstants}) Lens flare's sun sprite object ID. // @mem spriteID "spriteID", sol::property(&LensFlare::GetSunSpriteID, &LensFlare::SetSunSpriteID), @@ -42,7 +42,7 @@ namespace TEN::Scripting // @mem yaw "yaw", sol::property(&LensFlare::GetYaw, &LensFlare::SetYaw), - /// (Color) Lens flare's color. + /// (@{Color}) Lens flare's color. // @mem color "color", sol::property(&LensFlare::GetColor, &LensFlare::SetColor), @@ -64,7 +64,7 @@ namespace TEN::Scripting // @function LensFlare // @tparam float pitch Pitch angle in degrees. // @tparam float yaw Yaw angle in degrees. - // @tparam Color color Color of the lensflare. + // @tparam @{Color} color Color of the lensflare. // @treturn LensFlare A new LensFlare object. LensFlare::LensFlare(float pitch, float yaw, const ScriptColor& color) { From 892b69fc800b3579186fd1f8cdcac445fb114060 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Wed, 12 Mar 2025 08:14:52 +0100 Subject: [PATCH 048/160] Fixed some Level parameters being write-only --- TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp index 410311789..efec1ae48 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp @@ -93,7 +93,7 @@ void Level::Register(sol::table& parent) /// (float) Choose weather strength. // Must be value between `0.1` and `1.0`. //@mem weatherStrength - "weatherStrength", sol::property(&Level::SetWeatherStrength), + "weatherStrength", &Level::WeatherStrength, /*** (LaraType) Must be one of the LaraType values. These are: @@ -119,7 +119,7 @@ e.g. `myLevel.laraType = LaraType.Divesuit` /// (int) The maximum draw distance for level. // Given in sectors (blocks). Must be at least 4. //@mem farView - "farView", sol::property(&Level::SetLevelFarView), + "farView", &Level::LevelFarView, /// (bool) Reset hub data. // Resets the state for all previous levels, including items, flipmaps and statistics. @@ -132,7 +132,7 @@ e.g. `myLevel.laraType = LaraType.Divesuit` /// (short) Set total secret count for current level. //@mem secrets - "secrets", sol::property(&Level::GetSecrets, &Level::SetSecrets) + "secrets", &Level::LevelSecrets ); } From 506deb966d4d66ddf2e7c0d9c61627741fcdb5ff Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Wed, 12 Mar 2025 09:45:10 +0100 Subject: [PATCH 049/160] Don't draw horizon if transparency value is too low --- TombEngine/Renderer/RendererDraw.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TombEngine/Renderer/RendererDraw.cpp b/TombEngine/Renderer/RendererDraw.cpp index de5ab3544..a43dbce25 100644 --- a/TombEngine/Renderer/RendererDraw.cpp +++ b/TombEngine/Renderer/RendererDraw.cpp @@ -3029,7 +3029,7 @@ namespace TEN::Renderer // Draw horizon. for (int layer = 0; layer < 2; layer++) { - if (!levelPtr->GetHorizonEnabled(layer)) + if (!levelPtr->GetHorizonEnabled(layer) || levelPtr->GetHorizonTransparency(layer) <= EPSILON) continue; SetDepthState(DepthState::None); From 7babcb33a88bf1a69ce9563e33426561240b69b3 Mon Sep 17 00:00:00 2001 From: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Wed, 12 Mar 2025 20:32:17 +0000 Subject: [PATCH 050/160] Update changelog with links to assets --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 983158c3e..64229b672 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -29,7 +29,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added a particle based waterfall emitter object and associated sprite slots. - You must use this version: https://github.com/TombEngine/Resources/raw/refs/heads/main/Wad2%20Objects/Interactables/TEN_Waterfall_Emitter.wad2 * Added TR1 Hammer. - - You must use this version: + - You must use this version: * Added TR3 Moving Laser. * Added TR4 Statue Plinth. From e7003e1ad5dab848c17cfbfcc1509512d7972748 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Thu, 13 Mar 2025 09:44:18 +0100 Subject: [PATCH 051/160] Bypass unnecessary sky calculations if it's not active --- TombEngine/Renderer/RendererDraw.cpp | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/TombEngine/Renderer/RendererDraw.cpp b/TombEngine/Renderer/RendererDraw.cpp index a43dbce25..1c7a8d52d 100644 --- a/TombEngine/Renderer/RendererDraw.cpp +++ b/TombEngine/Renderer/RendererDraw.cpp @@ -2866,18 +2866,20 @@ namespace TEN::Renderer for (int layer = 0; layer < 2; layer++) { + if (Vector3(Weather.SkyColor(layer)) == Vector3::Zero) + continue; + for (int i = 0; i < 2; i++) { - auto weather = TEN::Effects::Environment::Weather; auto translation = Matrix::CreateTranslation( - renderView.Camera.WorldPosition.x + weather.SkyPosition(layer) - i * SKY_SIZE, + renderView.Camera.WorldPosition.x + Weather.SkyPosition(layer) - i * SKY_SIZE, renderView.Camera.WorldPosition.y - 1536.0f, renderView.Camera.WorldPosition.z); auto world = rotation * translation; _stStatic.World = (rotation * translation); - _stStatic.Color = weather.SkyColor(layer); + _stStatic.Color = Weather.SkyColor(layer); _stStatic.ApplyFogBulbs = layer == 0 ? 1 : 0; _cbStatic.UpdateData(_stStatic, _context.Get()); From 1d6052426932af1eec42207842f9208666f28f53 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Thu, 13 Mar 2025 11:17:13 +0100 Subject: [PATCH 052/160] Update CHANGELOG.md --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 64229b672..666e0e49c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -18,6 +18,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed wetness player attribute not being preserved in savegames. * Fixed invisible HK ammo in the inventory. * Fixed flickering rat emitter. +* Fixed camera glitch when going into quicksand rooms with weapons drawn. * Fixed player model submerging into the floor while swimming underwater. * Fixed custom shatter sounds with custom sound IDs not playing correctly. * Fixed crashes with sound samples larger than 2 megabytes. From f0ddc22da80f26537bef99bd00fffc4e1b5a5526 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Thu, 13 Mar 2025 12:57:12 +0100 Subject: [PATCH 053/160] Fixed AA settings not updating correctly after screen resolution change --- TombEngine/Game/gui.cpp | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/TombEngine/Game/gui.cpp b/TombEngine/Game/gui.cpp index 82ef55324..a024419a2 100644 --- a/TombEngine/Game/gui.cpp +++ b/TombEngine/Game/gui.cpp @@ -616,12 +616,16 @@ namespace TEN::Gui { // Save the configuration. auto screenResolution = g_Configuration.SupportedScreenResolutions[CurrentSettings.SelectedScreenResolution]; + + bool screenResolutionChanged = CurrentSettings.Configuration.ScreenWidth != screenResolution.x || + CurrentSettings.Configuration.ScreenHeight != screenResolution.y; + CurrentSettings.Configuration.ScreenWidth = screenResolution.x; CurrentSettings.Configuration.ScreenHeight = screenResolution.y; // Determine whether we should update AA shaders. - bool shouldRecompileAAShaders = g_Configuration.AntialiasingMode != CurrentSettings.Configuration.AntialiasingMode && - CurrentSettings.Configuration.AntialiasingMode != AntialiasingMode::Low; + bool shouldRecompileAAShaders = CurrentSettings.Configuration.AntialiasingMode != AntialiasingMode::Low && + (screenResolutionChanged || g_Configuration.AntialiasingMode != CurrentSettings.Configuration.AntialiasingMode); g_Configuration = CurrentSettings.Configuration; SaveConfiguration(); From 5c230aaeae1c6ee0fc2f9d2888cd6304d27a69b7 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Thu, 13 Mar 2025 18:23:58 +0100 Subject: [PATCH 054/160] Update CHANGELOG.md --- CHANGELOG.md | 34 +++++++++++++++++----------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 666e0e49c..664c314a5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -35,25 +35,25 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added TR4 Statue Plinth. ### Lua API changes -* Added Collision.Probe class for basic room collision detection. -* Added advanced particle emitter allowing animations and other effects. * Added diary module. * Added custom bar module. -* Added Flow.Horizon class and two layers of horizons in a Flow.Level class. -* Added Flow.GetTotalSecretCount() function to get total amount of secrets in the game. -* Added View.GetFlyByPosition() and View.GetFlyByRotation() functions to get flyby sequence parameters at a specified time point. -* Added Effects.EmitAirBubble() function to spawn air bubbles. -* Added Effects.EmitStreamer() function to emit streamers. -* Added Moveable:GetScale() and Movebale:SetScale() methods to set visible scale of moveables. -* Added Rotation:Lerp() function to allow linear interpolation between rotations. -* Added ability to perform additive and subtractive operations on Rotation class and compare one Rotation to another. -* Added various Translate() methods to Vec2 and Vec3 script objects. -* Added alpha transparency functionality for statics and moveables to be used with SetColor() method. -* Added extra arguments for sprite object slots and starting rotation value for EmitParticle function. -* Added ability to dynamically change Flow.Level fields such as fog, starfield or horizon, and save them to a savegame. -* Added pickup count to Flow.Statistics class. -* Changed Flow.StarField and Flow.LensFlare primitive types to use parameters instead of getters and setters. -* Fixed medipack level count in Flow.Statistics class. +* Added `Collision.Probe` class for basic room collision detection. +* Added `Flow.Horizon` class and two layers of horizons in a `Flow.Level` class. +* Added `Effects.EmitAdvancedParticle` function, allowing animations and other effects. +* Added `Effects.EmitAirBubble` function to spawn air bubbles. +* Added `Effects.EmitStreamer` function to emit streamers. +* Added `Flow.GetTotalSecretCount` function to get total amount of secrets in the game. +* Added `View.GetFlyByPosition` and `View.GetFlyByRotation` functions to get flyby sequence parameters at a specified time point. +* Added `Moveable:GetScale` and `Movebale:SetScale` methods to set visible scale of moveables. +* Added `Rotation:Lerp` function to allow linear interpolation between rotations. +* Added ability to perform additive and subtractive operations on `Rotation` class and compare one `Rotation` to another. +* Added various `Translate` methods to `Vec2` and `Vec3` script objects. +* Added alpha transparency functionality for statics and moveables to be used with `SetColor` method. +* Added extra arguments for sprite object slots and starting rotation value for `EmitParticle` function. +* Added ability to dynamically change `Flow.Level` weather and environment parameters and save them to a savegame. +* Added pickup count to `Flow.Statistics` class. +* Changed `Flow.StarField` and `Flow.LensFlare` primitive types to use parameters instead of getters and setters. +* Fixed medipack level count in `Flow.Statistics` class. ## [Version 1.7.1](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.7.4) - 2025-04-01 From c49619d80e8cd89a86810a419ec8e7fb7662e6cf Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Thu, 13 Mar 2025 18:48:17 +0100 Subject: [PATCH 055/160] Fixed underwater dust particles overflowing when camera is underwater --- CHANGELOG.md | 1 + TombEngine/Game/effects/weather.cpp | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 664c314a5..e38231218 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -15,6 +15,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed ricochet flashes after using explosive weapons. * Fixed incorrect flare draw in crawl state. * Fixed starfield remaining active in the next level if it does not have a starfield specified. +* Fixed underwater dust particles overflowing when camera is underwater. * Fixed wetness player attribute not being preserved in savegames. * Fixed invisible HK ammo in the inventory. * Fixed flickering rat emitter. diff --git a/TombEngine/Game/effects/weather.cpp b/TombEngine/Game/effects/weather.cpp index 34a235054..0c3f184f7 100644 --- a/TombEngine/Game/effects/weather.cpp +++ b/TombEngine/Game/effects/weather.cpp @@ -526,7 +526,7 @@ namespace TEN::Effects::Environment if (!IsPointInRoom(pos, roomNumber)) roomNumber = FindRoomNumber(pos, Camera.pos.RoomNumber, true); - if (roomNumber == NO_VALUE) + if (!IsPointInRoom(pos, roomNumber) || roomNumber == NO_VALUE) continue; // Check if water room. From ed342f089da7b5d744cc343af4c23d8a916a2e72 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Thu, 13 Mar 2025 20:03:32 +0100 Subject: [PATCH 056/160] Update Lara docs and dummy title level --- TombEngine/Resources/title.bin | Bin 80388 -> 124817 bytes .../Internal/TEN/Objects/Lara/LaraObject.cpp | 62 +++++++++--------- 2 files changed, 30 insertions(+), 32 deletions(-) diff --git a/TombEngine/Resources/title.bin b/TombEngine/Resources/title.bin index 2ec56664610a5eef8a15f27a6657b7715fe2c424..a68304d00c869beec98f460b503ec693c997dbe7 100644 GIT binary patch delta 59396 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 O4%HP5499B)PXhq1CO(A# delta 14679 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 WC^AK?nUkUP*5V`^1_s?}{4)VC?WF$z diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp index bd88cd526..a0083aa01 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp +++ b/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp @@ -24,7 +24,7 @@ using namespace TEN::Entities::Generic; /// Set player poison. // @function LaraObject:SetPoison -// @tparam[opt] int Poison; maximum value is 128 (default 0) +// @tparam[opt] int poison Poison strength. Maximum value is 128 (default 0) // @usage // Lara:SetPoison(10) void LaraObject::SetPoison(sol::optional potency) @@ -41,9 +41,9 @@ void LaraObject::SetPoison(sol::optional potency) } } -/// Get poison potency of Lara +/// Get poison potency of Lara. // @function LaraObject:GetPoison -// @treturn int current poison potency +// @treturn int Current poison potency. // @usage // local poisonPotency = Lara:GetPoison() int LaraObject::GetPoison() const @@ -52,9 +52,9 @@ int LaraObject::GetPoison() const return lara->Status.Poison; } -/// Set air value of Lara +/// Set air value of Lara. // @function LaraObject:SetAir -// @tparam int Air value to give Lara. Maximum value is 1800. +// @tparam int air Air value to give Lara. Maximum value is 1800. // @usage // Lara:SetAir(100) void LaraObject::SetAir(sol::optional air) @@ -67,9 +67,9 @@ void LaraObject::SetAir(sol::optional air) lara->Status.Air = LARA_AIR_MAX; } -/// Get air value of Lara +/// Get air value of Lara. // @function LaraObject:GetAir -// @treturn int current air value +// @treturn int Current air value. // @usage // local currentAir = Lara:GetAir() int LaraObject::GetAir() const @@ -78,9 +78,9 @@ int LaraObject::GetAir() const return lara->Status.Air; } -/// Set wetness value of Lara (causes dripping) +/// Set wetness value of Lara (causes dripping). // @function LaraObject:SetWet -// @tparam int Wetness value. Maximum 255 +// @tparam int wetness Wetness value. Maximum value is 255. // @usage // Lara:SetWet(100) void LaraObject::SetWet(sol::optional wetness) @@ -92,9 +92,9 @@ void LaraObject::SetWet(sol::optional wetness) i = value; } -/// Get wetness value of Lara +/// Get wetness value of Lara. // @function LaraObject:GetWet -// @treturn int current wetness value +// @treturn int Current wetness value. // @usage // local dripAmount = Lara:GetWet() int LaraObject::GetWet() const @@ -103,9 +103,9 @@ int LaraObject::GetWet() const return lara->Effect.DripNodes[0]; } -/// Set sprint energy value of Lara +/// Set sprint energy value of Lara. // @function LaraObject:SetStamina -// @tparam int stamina to give to Lara; maximum value is 120. +// @tparam int stamina Stamina to give to Lara. Maximum value is 120. // @usage // Lara:SetStamina(120) void LaraObject::SetStamina(sol::optional value) @@ -118,7 +118,7 @@ void LaraObject::SetStamina(sol::optional value) lara->Status.Stamina = LARA_STAMINA_MAX; } -/// Get stamina value of Lara +/// Get stamina value of Lara. // @function LaraObject:GetStamina // @treturn int current sprint value // @usage @@ -129,17 +129,17 @@ int LaraObject::GetStamina() const return lara->Status.Stamina; } -/// Get the moveable's airborne status +/// Get the moveable's airborne status. // @function Moveable:GetAirborne -// @treturn (bool) true if Lara state must react to aerial forces. +// @treturn bool True if Lara state must react to aerial forces. bool LaraObject::GetAirborne() const { return _moveable->Animation.IsAirborne; } -/// Set the moveable's airborne status +/// Set the moveable's airborne status. // @function Moveable:SetAirborne -// @tparam (bool) New airborn status for Lara. +// @tparam bool airborne New airborne status for Lara. void LaraObject::SetAirborne(bool newAirborne) { _moveable->Animation.IsAirborne = newAirborne; @@ -174,36 +174,34 @@ void LaraObject::ThrowAwayTorch() } } -//todo make these into enums - Squidshire 18/11/2022 - -/// Get actual hand status of Lara +/// Get actual hand status of Lara. // @function LaraObject:GetHandStatus // @usage // local handStatus = Lara:GetHandStatus() -// @treturn int hand status 0=HandsFree, 1=Busy(climbing,etc), 2=WeaponDraw, 3=WeaponUndraw, 4=WeaponInHand. +// @treturn Objects.HandStatus Current hand status. HandStatus LaraObject::GetHandStatus() const { auto* lara = GetLaraInfo(_moveable); return HandStatus{ lara->Control.HandStatus }; } -/// Get actual weapon type of Lara +/// Get actual weapon type of Lara. // @function LaraObject:GetWeaponType // @usage // local weaponType = Lara:GetWeaponType() -// @treturn Flow.WeaponType current weapon type. +// @treturn Objects.WeaponType Current weapon type. LaraWeaponType LaraObject::GetWeaponType() const { auto* lara = GetLaraInfo(_moveable); return LaraWeaponType{ lara->Control.Weapon.GunType }; } -/// Set Lara weapon type +/// Set Lara weapon type. // @function LaraObject:SetWeaponType // @usage // Lara:SetWeaponType(WeaponType.PISTOLS, false) -// @tparam Flow.WeaponType weaponType -// @tparam bool activate if `true`, also draw the weapons or set torch lit. If `false`, keep weapons holstered or leave torch unlit. +// @tparam Objects.WeaponType weaponType New weapon type to set. +// @tparam bool activate If `true`, also draw the weapons or set torch lit. If `false`, keep weapons holstered or leave torch unlit. void LaraObject::SetWeaponType(LaraWeaponType weaponType, bool activate) { auto* lara = GetLaraInfo(_moveable); @@ -231,7 +229,7 @@ void LaraObject::SetWeaponType(LaraWeaponType weaponType, bool activate) /// Get player weapon ammo type. // @function LaraObject:GetAmmoType -// @treturn Flow.AmmoType player weapon ammo type +// @treturn Objects.AmmoType Player weapon ammo type. // @usage // local CurrentAmmoType = Lara:GetAmmoType() int LaraObject::GetAmmoType() const @@ -322,9 +320,9 @@ int LaraObject::GetAmmoType() const return (int)*ammoType; } -/// Get current weapon's ammo count +/// Get current weapon's ammo count. // @function LaraObject:GetAmmoCount -// @treturn int current ammo count (-1 if infinite) +// @treturn int Current ammo count (-1 if infinite). // @usage // local equippedWeaponAmmoLeft = Lara:GetAmmoCount() int LaraObject::GetAmmoCount() const @@ -334,9 +332,9 @@ int LaraObject::GetAmmoCount() const return (ammo.HasInfinite()) ? -1 : (int)ammo.GetCount(); } -/// Get current vehicle, if it exists +/// Get current vehicle, if it exists. // @function LaraObject:GetVehicle -// @treturn Objects.Moveable current vehicle (nil if no vehicle present) +// @treturn Objects.Moveable current vehicle (nil if no vehicle present). // @usage // local vehicle = Lara:GetVehicle() std::unique_ptr LaraObject::GetVehicle() const From 1daf39471a50e675b62af53fe70aa4ddd07969a0 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Thu, 13 Mar 2025 20:16:22 +0100 Subject: [PATCH 057/160] Update Objects.LaraObject.html --- .../doc/2 classes/Objects.LaraObject.html | 126 +++++++++--------- 1 file changed, 62 insertions(+), 64 deletions(-) diff --git a/Documentation/doc/2 classes/Objects.LaraObject.html b/Documentation/doc/2 classes/Objects.LaraObject.html index 950ff7df3..bbf90f697 100644 --- a/Documentation/doc/2 classes/Objects.LaraObject.html +++ b/Documentation/doc/2 classes/Objects.LaraObject.html @@ -123,44 +123,44 @@ - + - + - - + + - + - - + + - + - + - + - + - - + + @@ -172,15 +172,15 @@ - + - + - + @@ -188,11 +188,11 @@ - + - + @@ -217,7 +217,7 @@
    - LaraObject:SetPoison([Poison]) + LaraObject:SetPoison([poison])
    Set player poison. @@ -226,9 +226,9 @@

    Parameters:

      -
    • Poison +
    • poison int - ; maximum value is 128 (default 0) + Poison strength. Maximum value is 128 (default 0) (optional)
    @@ -247,7 +247,7 @@ LaraObject:GetPoison()
    - Get poison potency of Lara + Get poison potency of Lara. @@ -256,7 +256,7 @@
      int - current poison potency + Current poison potency.
    @@ -269,18 +269,18 @@
    - LaraObject:SetAir(Air) + LaraObject:SetAir(air)
    - Set air value of Lara + Set air value of Lara.

    Parameters:

      -
    • Air +
    • air int - value to give Lara. Maximum value is 1800. + Air value to give Lara. Maximum value is 1800.
    @@ -298,7 +298,7 @@ LaraObject:GetAir()
    - Get air value of Lara + Get air value of Lara. @@ -307,7 +307,7 @@
      int - current air value + Current air value.
    @@ -320,18 +320,18 @@
    - LaraObject:SetWet(Wetness) + LaraObject:SetWet(wetness)
    - Set wetness value of Lara (causes dripping) + Set wetness value of Lara (causes dripping).

    Parameters:

      -
    • Wetness +
    • wetness int - value. Maximum 255 + Wetness value. Maximum value is 255.
    @@ -349,7 +349,7 @@ LaraObject:GetWet()
    - Get wetness value of Lara + Get wetness value of Lara. @@ -358,7 +358,7 @@
      int - current wetness value + Current wetness value.
    @@ -374,7 +374,7 @@ LaraObject:SetStamina(stamina)
    - Set sprint energy value of Lara + Set sprint energy value of Lara. @@ -382,7 +382,7 @@
    • stamina int - to give to Lara; maximum value is 120. + Stamina to give to Lara. Maximum value is 120.
    @@ -400,7 +400,7 @@ LaraObject:GetStamina()
    - Get stamina value of Lara + Get stamina value of Lara. @@ -425,7 +425,7 @@ Moveable:GetAirborne()
    - Get the moveable's airborne status + Get the moveable's airborne status. @@ -433,8 +433,8 @@

    Returns:

      - (bool) - true if Lara state must react to aerial forces. + bool + True if Lara state must react to aerial forces.
    @@ -443,18 +443,18 @@
    - Moveable:SetAirborne(New) + Moveable:SetAirborne(airborne)
    - Set the moveable's airborne status + Set the moveable's airborne status.

    Parameters:

      -
    • New - (bool) - airborn status for Lara. +
    • airborne + bool + New airborne status for Lara.
    @@ -506,7 +506,7 @@ LaraObject:GetHandStatus()
    - Get actual hand status of Lara + Get actual hand status of Lara. @@ -514,8 +514,8 @@

    Returns:

      - int - hand status 0=HandsFree, 1=Busy(climbing,etc), 2=WeaponDraw, 3=WeaponUndraw, 4=WeaponInHand. + HandStatus + Current hand status.
    @@ -531,7 +531,7 @@ LaraObject:GetWeaponType()
    - Get actual weapon type of Lara + Get actual weapon type of Lara. @@ -539,8 +539,8 @@

    Returns:

      - Flow.WeaponType - current weapon type. + WeaponType + Current weapon type.
    @@ -556,21 +556,19 @@ LaraObject:SetWeaponType(weaponType, activate)
    - Set Lara weapon type + Set Lara weapon type.

    Parameters:

    • weaponType - Flow.WeaponType - - - + WeaponType + New weapon type to set.
    • activate bool - if true, also draw the weapons or set torch lit. If false, keep weapons holstered or leave torch unlit. + If true, also draw the weapons or set torch lit. If false, keep weapons holstered or leave torch unlit.
    @@ -596,8 +594,8 @@

    Returns:

      - Flow.AmmoType - player weapon ammo type + AmmoType + Player weapon ammo type.
    @@ -613,7 +611,7 @@ LaraObject:GetAmmoCount()
    - Get current weapon's ammo count + Get current weapon's ammo count. @@ -622,7 +620,7 @@
      int - current ammo count (-1 if infinite) + Current ammo count (-1 if infinite).
    @@ -638,7 +636,7 @@ LaraObject:GetVehicle()
    - Get current vehicle, if it exists + Get current vehicle, if it exists. @@ -647,7 +645,7 @@
      Moveable - current vehicle (nil if no vehicle present) + current vehicle (nil if no vehicle present).
    From 28773e23871d6900717352d833a0fa32a9bb3818 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Thu, 13 Mar 2025 20:32:14 +0100 Subject: [PATCH 058/160] Fix crash with old panel objects present in a level --- TombEngine/Objects/game_object_ids.h | 2 +- TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h | 2 +- TombEngine/Specific/level.cpp | 6 ++++++ 3 files changed, 8 insertions(+), 2 deletions(-) diff --git a/TombEngine/Objects/game_object_ids.h b/TombEngine/Objects/game_object_ids.h index edeacf284..26138ce91 100644 --- a/TombEngine/Objects/game_object_ids.h +++ b/TombEngine/Objects/game_object_ids.h @@ -1014,5 +1014,5 @@ enum GAME_OBJECT_ID : short ID_DIARY_SPRITES, ID_DIARY_ENTRY_SPRITES, - ID_NUMBER_OBJECTS + ID_NUMBER_OBJECTS = 1408 // Compatibility. Remove this constant when slot count is nearing 1408. }; diff --git a/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h b/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h index b302b21c0..41dba67cb 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h +++ b/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h @@ -1,7 +1,7 @@ #pragma once // This file is generated automatically, do not edit it. -// Last generated on 11/03/2025. +// Last generated on 13/03/2025. #include #include diff --git a/TombEngine/Specific/level.cpp b/TombEngine/Specific/level.cpp index a08041f27..89b03f445 100644 --- a/TombEngine/Specific/level.cpp +++ b/TombEngine/Specific/level.cpp @@ -440,6 +440,12 @@ void LoadObjects() int objNum = ReadInt32(); MoveablesIds.push_back(objNum); + if (objNum >= GAME_OBJECT_ID::ID_NUMBER_OBJECTS) + { + TENLog("Unsupported object slot is detected in a level. Make sure you delete unsupported objects from your wads.", LogLevel::Warning); + continue; + } + Objects[objNum].loaded = true; Objects[objNum].nmeshes = ReadInt32(); Objects[objNum].meshIndex = ReadInt32(); From 973e35c10aa63d7d6b681f3cafb78bd9b287f145 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Thu, 13 Mar 2025 20:58:07 +0100 Subject: [PATCH 059/160] Move underwater floor trapdoor animation to slot 442 --- TombEngine/Game/Lara/lara_struct.h | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/TombEngine/Game/Lara/lara_struct.h b/TombEngine/Game/Lara/lara_struct.h index 65a0ef80c..075b2f78e 100644 --- a/TombEngine/Game/Lara/lara_struct.h +++ b/TombEngine/Game/Lara/lara_struct.h @@ -611,7 +611,7 @@ enum LaraAnim LA_LADDER_RIGHT_CORNER_OUTER_START = 365, // Ladder around outer right corner LA_PUSHABLE_BLOCK_PUSH_EDGE_SLIP = 366, LA_LADDER_LEFT_CORNER_INNER_START = 367, // Ladder around inner left corner - LA_UNDERWATER_FLOOR_TRAPDOOR = 368, // Underwater Floor Trapdoor + LA_LADDER_LEFT_CORNER_INNER_END = 368, LA_LADDER_RIGHT_CORNER_INNER_START = 369, // Ladder around inner right corner LA_LADDER_RIGHT_CORNER_INNER_END = 370, // TODO: Remove. LA_JUMP_UP_TO_ROPE_START = 371, // Jump up > rope idle (1/2) @@ -688,7 +688,7 @@ enum LaraAnim LA_PICKUP_SARCOPHAGUS = 439, // Pickup from sarcophagus LA_DRAG_BODY = 440, // Drag dead body LA_BINOCULARS_IDLE = 441, // Stand, looking through binoculars - LA_UNUSED_442 = 442, // Formelly, LA_BIG_SCORPION_DEATH, but that animation is now in LARA EXTRA ANIMS so this slot is unused. + LA_UNDERWATER_FLOOR_TRAPDOOR = 442, // Underwater floor trapdoor LA_ELEVATOR_RECOVER = 443, // Recover from elevator crash LA_MECHANICAL_BEETLE_USE = 444, // Wind mechanical beetle, place on floor LA_FLY_CHEAT = 445, // Fly cheat From 6a71b857f0d2c4fc6b2ab58f7837509f6e8d29a1 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Thu, 13 Mar 2025 21:15:57 +0100 Subject: [PATCH 060/160] Fixes to starfield --- TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp index 35c857b47..8cd952e62 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp @@ -50,7 +50,7 @@ namespace TEN::Scripting "SetMeteorSpawnDensity", &Starfield::SetMeteorSpawnDensity, "SetMeteorVelocity", &Starfield::SetMeteorVelocity); - parent["StarField"] = parent["Starfield"]; + parent["Starfield"] = parent["StarField"]; } /// Create a starfield object with only stars. From e983bcb2d3158e5aac0a7d5cc1c6cde1715d84b2 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Thu, 13 Mar 2025 22:13:31 +0100 Subject: [PATCH 061/160] Fixed docs --- Documentation/doc/2 classes/Objects.LaraObject.html | 2 +- TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/doc/2 classes/Objects.LaraObject.html b/Documentation/doc/2 classes/Objects.LaraObject.html index bbf90f697..d34d996a0 100644 --- a/Documentation/doc/2 classes/Objects.LaraObject.html +++ b/Documentation/doc/2 classes/Objects.LaraObject.html @@ -409,7 +409,7 @@
      int - current sprint value + Current sprint value.
    diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp index a0083aa01..01516a829 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp +++ b/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp @@ -120,7 +120,7 @@ void LaraObject::SetStamina(sol::optional value) /// Get stamina value of Lara. // @function LaraObject:GetStamina -// @treturn int current sprint value +// @treturn int Current sprint value. // @usage // local sprintEnergy = Lara:GetStamina() int LaraObject::GetStamina() const From 66f5f6762053deda94d53b645a2f0ea9da96dc1f Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Thu, 13 Mar 2025 22:39:26 +0100 Subject: [PATCH 062/160] Add more cross-references to documentation --- Documentation/doc/4 enums/Collision.MaterialType.html | 2 +- TombEngine/Scripting/Internal/TEN/Collision/MaterialTypes.h | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/doc/4 enums/Collision.MaterialType.html b/Documentation/doc/4 enums/Collision.MaterialType.html index 693d6c9ae..23d383f27 100644 --- a/Documentation/doc/4 enums/Collision.MaterialType.html +++ b/Documentation/doc/4 enums/Collision.MaterialType.html @@ -142,7 +142,7 @@
    -

    Table of MaterialType constants.

    +

    Table of MaterialType constants. To be used with Collision.Probe.GetFloorMaterialType and Collision.Probe.GetCeilingMaterialType.

    • MUD
      • diff --git a/TombEngine/Scripting/Internal/TEN/Collision/MaterialTypes.h b/TombEngine/Scripting/Internal/TEN/Collision/MaterialTypes.h index 434a41a20..5d9f078f9 100644 --- a/TombEngine/Scripting/Internal/TEN/Collision/MaterialTypes.h +++ b/TombEngine/Scripting/Internal/TEN/Collision/MaterialTypes.h @@ -6,7 +6,7 @@ // @enum Collision.MaterialType // @pragma nostrip -/// Table of MaterialType constants. +/// Table of MaterialType constants. To be used with @{Collision.Probe.GetFloorMaterialType} and @{Collision.Probe.GetCeilingMaterialType}. // // - `MUD` // - `SNOW` From 61ca421fb86876524edd22ebbcd26fb4c5dff5b8 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Fri, 14 Mar 2025 02:42:23 +0100 Subject: [PATCH 063/160] Fixed fast moving items interpolation --- TombEngine/Renderer/RendererFrame.cpp | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/TombEngine/Renderer/RendererFrame.cpp b/TombEngine/Renderer/RendererFrame.cpp index d52752af6..90ff3f756 100644 --- a/TombEngine/Renderer/RendererFrame.cpp +++ b/TombEngine/Renderer/RendererFrame.cpp @@ -451,7 +451,11 @@ namespace TEN::Renderer // Renderer slot has no interpolation flag set in case it is fetched for first time (e.g. item first time in frustum). newItem.DisableInterpolation = item.DisableInterpolation || newItem.DisableInterpolation; - if (newItem.DisableInterpolation) + // Disable interpolation when object has traveled significant distance. + // It's needed because when object gets out of frustum, its previous position doesn't update. + bool positionChanged = Vector3::Distance(newItem.PrevPosition, newItem.Position) > BLOCK(1); + + if (newItem.DisableInterpolation || positionChanged) { // NOTE: Interpolation always returns same result. newItem.PrevPosition = newItem.Position; @@ -469,12 +473,13 @@ namespace TEN::Renderer // Force interpolation only for player in player freeze mode. bool forceValue = g_GameFlow->CurrentFreezeMode == FreezeMode::Player && item.ObjectNumber == ID_LARA; + float interpFactor = GetInterpolationFactor(forceValue); - newItem.InterpolatedPosition = Vector3::Lerp(newItem.PrevPosition, newItem.Position, GetInterpolationFactor(forceValue)); - newItem.InterpolatedTranslation = Matrix::Lerp(newItem.PrevTranslation, newItem.Translation, GetInterpolationFactor(forceValue)); - newItem.InterpolatedRotation = Matrix::Lerp(newItem.InterpolatedRotation, newItem.Rotation, GetInterpolationFactor(forceValue)); - newItem.InterpolatedScale = Matrix::Lerp(newItem.InterpolatedScale, newItem.Scale, GetInterpolationFactor(forceValue)); - newItem.InterpolatedWorld = Matrix::Lerp(newItem.PrevWorld, newItem.World, GetInterpolationFactor(forceValue)); + newItem.InterpolatedPosition = Vector3::Lerp(newItem.PrevPosition, newItem.Position, interpFactor); + newItem.InterpolatedTranslation = Matrix::Lerp(newItem.PrevTranslation, newItem.Translation, interpFactor); + newItem.InterpolatedRotation = Matrix::Lerp(newItem.InterpolatedRotation, newItem.Rotation, interpFactor); + newItem.InterpolatedScale = Matrix::Lerp(newItem.InterpolatedScale, newItem.Scale, interpFactor); + newItem.InterpolatedWorld = Matrix::Lerp(newItem.PrevWorld, newItem.World, interpFactor); for (int j = 0; j < MAX_BONES; j++) newItem.InterpolatedAnimTransforms[j] = Matrix::Lerp(newItem.PrevAnimTransforms[j], newItem.AnimTransforms[j], GetInterpolationFactor(forceValue)); From 6d4bc4207e705f065ffeca1c8d9ff8d588292107 Mon Sep 17 00:00:00 2001 From: Sezz Date: Fri, 14 Mar 2025 15:41:47 +1100 Subject: [PATCH 064/160] Fix input action conflicts not updating properly --- TombEngine/Renderer/RendererFrame.cpp | 6 +++--- TombEngine/Specific/Input/Bindings.cpp | 2 +- TombEngine/Specific/Input/Input.cpp | 9 +++++---- 3 files changed, 9 insertions(+), 8 deletions(-) diff --git a/TombEngine/Renderer/RendererFrame.cpp b/TombEngine/Renderer/RendererFrame.cpp index 90ff3f756..065504723 100644 --- a/TombEngine/Renderer/RendererFrame.cpp +++ b/TombEngine/Renderer/RendererFrame.cpp @@ -452,10 +452,10 @@ namespace TEN::Renderer newItem.DisableInterpolation = item.DisableInterpolation || newItem.DisableInterpolation; // Disable interpolation when object has traveled significant distance. - // It's needed because when object gets out of frustum, its previous position doesn't update. - bool positionChanged = Vector3::Distance(newItem.PrevPosition, newItem.Position) > BLOCK(1); + // Needed because when object goes out of frustum, previous position doesn't update. + bool posChanged = Vector3::Distance(newItem.PrevPosition, newItem.Position) > BLOCK(1); - if (newItem.DisableInterpolation || positionChanged) + if (newItem.DisableInterpolation || posChanged) { // NOTE: Interpolation always returns same result. newItem.PrevPosition = newItem.Position; diff --git a/TombEngine/Specific/Input/Bindings.cpp b/TombEngine/Specific/Input/Bindings.cpp index 641c940a4..a30349586 100644 --- a/TombEngine/Specific/Input/Bindings.cpp +++ b/TombEngine/Specific/Input/Bindings.cpp @@ -187,7 +187,7 @@ namespace TEN::Input void BindingManager::SetConflict(InputActionID actionID, bool value) { - _conflicts.insert({ actionID, value }); + _conflicts[actionID] = value; } bool BindingManager::TestConflict(InputActionID actionID) diff --git a/TombEngine/Specific/Input/Input.cpp b/TombEngine/Specific/Input/Input.cpp index d657cc077..40c55d79c 100644 --- a/TombEngine/Specific/Input/Input.cpp +++ b/TombEngine/Specific/Input/Input.cpp @@ -261,10 +261,12 @@ namespace TEN::Input g_Bindings.SetConflict(actionID, false); - int key = g_Bindings.GetBoundKeyID(InputDeviceID::Default, (InputActionID)i); + int key = g_Bindings.GetBoundKeyID(InputDeviceID::Default, actionID); for (int j = 0; j < (int)InputActionID::Count; j++) { - if (key != g_Bindings.GetBoundKeyID(InputDeviceID::Custom, (InputActionID)j)) + auto conflictActionID = (InputActionID)j; + + if (key != g_Bindings.GetBoundKeyID(InputDeviceID::Custom, conflictActionID)) continue; g_Bindings.SetConflict(actionID, true); @@ -546,11 +548,10 @@ namespace TEN::Input for (int i = (int)InputDeviceID::Count - 1; i >= 0; i--) { auto deviceID = (InputDeviceID)i; - if (deviceID == InputDeviceID::Default && g_Bindings.TestConflict(actionID)) continue; - int keyID = g_Bindings.GetBoundKeyID((InputDeviceID)i, actionID); + int keyID = g_Bindings.GetBoundKeyID(deviceID, actionID); if (KeyMap[keyID] != 0.0f) return KeyMap[keyID]; } From fa9a56f627808c92d56d1984d4779a652bcfa6d3 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Fri, 14 Mar 2025 08:29:37 +0100 Subject: [PATCH 065/160] Throw exception if unknown object slot is encountered --- TombEngine/Specific/level.cpp | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/TombEngine/Specific/level.cpp b/TombEngine/Specific/level.cpp index 89b03f445..e87d162d5 100644 --- a/TombEngine/Specific/level.cpp +++ b/TombEngine/Specific/level.cpp @@ -442,8 +442,8 @@ void LoadObjects() if (objNum >= GAME_OBJECT_ID::ID_NUMBER_OBJECTS) { - TENLog("Unsupported object slot is detected in a level. Make sure you delete unsupported objects from your wads.", LogLevel::Warning); - continue; + throw std::exception(("Unsupported object slot " + std::to_string(objNum) + + " is detected in a level. Make sure you delete unsupported objects from your wads.").c_str()); } Objects[objNum].loaded = true; From d7d9aad0d9ee73ceb556625eb8d1732fc53b4c99 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Fri, 14 Mar 2025 08:34:16 +0100 Subject: [PATCH 066/160] Update RoomObject.cpp --- TombEngine/Scripting/Internal/TEN/Objects/Room/RoomObject.cpp | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Room/RoomObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Room/RoomObject.cpp index 1dc91890a..da55a00b4 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/Room/RoomObject.cpp +++ b/TombEngine/Scripting/Internal/TEN/Objects/Room/RoomObject.cpp @@ -105,7 +105,7 @@ using namespace TEN::Scripting::Types; /// Set the room's reverb type. // @function Room:SetReverbType - // @tparam Objects.RoomReverb Reverb type. + // @tparam Objects.RoomReverb reverb Reverb type. void Room::SetReverbType(ReverbType reverb) { _room.reverbType = reverb; @@ -114,7 +114,7 @@ using namespace TEN::Scripting::Types; /// Set the room's specified flag. // @function Room:SetFlag // @tparam Objects.RoomFlagID flagID Room flag ID. - // @tparam bool Boolean to set the flag to. + // @tparam bool value Boolean to set the flag to. void Room::SetFlag(RoomEnvFlags flag, bool value) { if (value) From bed466be9d46571a9fb095d0b70fce88a14f49d9 Mon Sep 17 00:00:00 2001 From: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Fri, 14 Mar 2025 19:49:18 -0400 Subject: [PATCH 067/160] Fix damage Commit (#1614) * Fix Commit * Revision --- TombEngine/Game/effects/tomb4fx.cpp | 1 + TombEngine/Objects/Effects/EmberEmitter.cpp | 2 ++ TombEngine/Objects/TR5/Emitter/tr5_smoke_emitter.cpp | 5 ++++- .../Scripting/Internal/TEN/Effects/EffectsFunctions.cpp | 4 +++- 4 files changed, 10 insertions(+), 2 deletions(-) diff --git a/TombEngine/Game/effects/tomb4fx.cpp b/TombEngine/Game/effects/tomb4fx.cpp index 1f45448e9..c97fd5a8b 100644 --- a/TombEngine/Game/effects/tomb4fx.cpp +++ b/TombEngine/Game/effects/tomb4fx.cpp @@ -355,6 +355,7 @@ void ThrowPoison(const ItemInfo& item, int boneID, const Vector3& offset, const auto& part = SetupPoisonParticle(colorStart, colorEnd); AttachAndCreateSpark(&part, &item, boneID, offset, vel, spriteID); part.flags = SP_POISON | SP_SCALE | SP_DEF | SP_ROTATE | SP_EXPDEF; + part.damage = 5; } } diff --git a/TombEngine/Objects/Effects/EmberEmitter.cpp b/TombEngine/Objects/Effects/EmberEmitter.cpp index ac87a2a20..850064dfd 100644 --- a/TombEngine/Objects/Effects/EmberEmitter.cpp +++ b/TombEngine/Objects/Effects/EmberEmitter.cpp @@ -76,6 +76,7 @@ namespace TEN::Effects::EmberEmitter spark.scalar = 3.0f; spark.gravity = Random::GenerateFloat(32.0f, 96.0f); spark.flags = SP_DAMAGE | SP_ROTATE | SP_DEF | SP_SCALE | SP_EXPDEF; + spark.damage = 2; } else { @@ -150,6 +151,7 @@ namespace TEN::Effects::EmberEmitter spark.size = Random::GenerateFloat(32.0f, 48.0f); spark.dSize = spark.size; spark.flags = SP_DAMAGE | SP_ROTATE | SP_DEF | SP_SCALE; + spark.damage = 2; } } } diff --git a/TombEngine/Objects/TR5/Emitter/tr5_smoke_emitter.cpp b/TombEngine/Objects/TR5/Emitter/tr5_smoke_emitter.cpp index 83a8d0143..a7e748787 100644 --- a/TombEngine/Objects/TR5/Emitter/tr5_smoke_emitter.cpp +++ b/TombEngine/Objects/TR5/Emitter/tr5_smoke_emitter.cpp @@ -140,8 +140,11 @@ namespace TEN::Effects::SmokeEmitter bool ignoreDamage = item.ItemFlags[3] & SmokeEmitterFlags::NoDamage; if (!ignoreDamage && TestGlobalTimeInterval(DAMAGE_TIME_INTERVAL)) + { part.flags |= SP_DAMAGE; - + part.damage = 2; + } + part.rotAng = Random::GenerateAngle(ANGLE(0.0f), ANGLE(22.5f)); part.rotAdd = Random::GenerateAngle(ANGLE(0.04f), ANGLE(0.08f)) * (Random::TestProbability(1 / 2.0f) ? 1 : -1); diff --git a/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp b/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp index 755a1fadf..dde3c2ba8 100644 --- a/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp +++ b/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp @@ -213,8 +213,10 @@ namespace TEN::Scripting::Effects bool convertedApplyDamage = ValueOr(applyDamage, false); if (convertedApplyDamage) + { part.flags |= SP_DAMAGE; - + part.damage = 2; + } // TODO: Add option to turn off wind. if (TestEnvironment(RoomEnvFlags::ENV_FLAG_WIND, part.roomNumber)) part.flags |= SP_WIND; From f758bab1872eb151d8ea81831c91ca038138590b Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 15 Mar 2025 01:01:05 +0100 Subject: [PATCH 068/160] Rollback Starfield naming --- Documentation/doc/1 modules/Effects.html | 2 +- Documentation/doc/1 modules/Flow.html | 2 +- Documentation/doc/1 modules/Input.html | 2 +- Documentation/doc/1 modules/Inventory.html | 2 +- Documentation/doc/1 modules/Logic.html | 2 +- Documentation/doc/1 modules/Objects.html | 2 +- Documentation/doc/1 modules/Sound.html | 2 +- Documentation/doc/1 modules/Strings.html | 2 +- Documentation/doc/1 modules/Util.html | 2 +- Documentation/doc/1 modules/View.html | 2 +- .../doc/2 classes/Collision.Probe.html | 2 +- Documentation/doc/2 classes/Flow.Level.html | 12 ++++----- .../doc/2 classes/Flow.Settings.html | 2 +- .../doc/2 classes/Flow.Statistics.html | 2 +- .../doc/2 classes/Objects.AIObject.html | 2 +- .../doc/2 classes/Objects.Camera.html | 2 +- .../doc/2 classes/Objects.LaraObject.html | 2 +- .../doc/2 classes/Objects.Moveable.html | 2 +- Documentation/doc/2 classes/Objects.Room.html | 18 ++++++------- Documentation/doc/2 classes/Objects.Sink.html | 2 +- .../doc/2 classes/Objects.SoundSource.html | 2 +- .../doc/2 classes/Objects.Static.html | 2 +- .../doc/2 classes/Objects.Volume.html | 2 +- .../doc/2 classes/Strings.DisplayString.html | 2 +- .../doc/2 classes/View.DisplaySprite.html | 2 +- .../doc/3 primitive classes/Color.html | 2 +- .../doc/3 primitive classes/Flow.Fog.html | 2 +- .../doc/3 primitive classes/Flow.Horizon.html | 2 +- .../Flow.InventoryItem.html | 2 +- .../3 primitive classes/Flow.LensFlare.html | 2 +- .../3 primitive classes/Flow.SkyLayer.html | 2 +- .../3 primitive classes/Flow.Starfield.html | 26 +++++++++---------- .../doc/3 primitive classes/Rotation.html | 2 +- .../doc/3 primitive classes/Time.html | 2 +- .../doc/3 primitive classes/Vec2.html | 2 +- .../doc/3 primitive classes/Vec3.html | 2 +- .../doc/4 enums/Collision.MaterialType.html | 2 +- .../doc/4 enums/Effects.BlendID.html | 2 +- .../doc/4 enums/Effects.EffectID.html | 2 +- .../doc/4 enums/Effects.FeatherMode.html | 2 +- .../Effects.ParticleAnimationType.html | 2 +- Documentation/doc/4 enums/Flow.ErrorMode.html | 2 +- .../doc/4 enums/Flow.FreezeMode.html | 2 +- .../doc/4 enums/Flow.GameStatus.html | 2 +- Documentation/doc/4 enums/Input.ActionID.html | 2 +- .../doc/4 enums/Objects.AmmoType.html | 2 +- .../doc/4 enums/Objects.HandStatus.html | 2 +- .../doc/4 enums/Objects.MoveableStatus.html | 2 +- Documentation/doc/4 enums/Objects.ObjID.html | 2 +- .../doc/4 enums/Objects.RoomFlagID.html | 2 +- .../doc/4 enums/Objects.RoomReverb.html | 2 +- .../doc/4 enums/Objects.WeaponType.html | 2 +- .../doc/4 enums/Sound.SoundTrackType.html | 2 +- .../4 enums/Strings.DisplayStringOption.html | 2 +- Documentation/doc/4 enums/Util.LogLevel.html | 2 +- Documentation/doc/4 enums/View.AlignMode.html | 2 +- .../doc/4 enums/View.CameraType.html | 2 +- .../doc/4 enums/View.PostProcessMode.html | 2 +- Documentation/doc/4 enums/View.ScaleMode.html | 2 +- .../doc/5 lua utility modules/CustomBar.html | 2 +- .../doc/5 lua utility modules/Diary.html | 2 +- .../5 lua utility modules/EventSequence.html | 2 +- .../doc/5 lua utility modules/Timer.html | 2 +- .../doc/5 lua utility modules/Type.html | 2 +- Documentation/doc/index.html | 4 +-- .../Internal/TEN/Flow/Level/FlowLevel.cpp | 7 +++-- .../Internal/TEN/Flow/Starfield/Starfield.cpp | 16 +++++------- 67 files changed, 101 insertions(+), 104 deletions(-) diff --git a/Documentation/doc/1 modules/Effects.html b/Documentation/doc/1 modules/Effects.html index b84fdf1e2..92b0fb480 100644 --- a/Documentation/doc/1 modules/Effects.html +++ b/Documentation/doc/1 modules/Effects.html @@ -68,7 +68,7 @@
    • Flow.InventoryItem
    • Flow.LensFlare
    • Flow.SkyLayer
      • -
    • Flow.StarField
      • +
    • Flow.Starfield
    • Color
    • Rotation
    • Time
      • diff --git a/Documentation/doc/1 modules/Flow.html b/Documentation/doc/1 modules/Flow.html index 2adf40fd9..a8af377fd 100644 --- a/Documentation/doc/1 modules/Flow.html +++ b/Documentation/doc/1 modules/Flow.html @@ -68,7 +68,7 @@
    • Flow.InventoryItem
    • Flow.LensFlare
    • Flow.SkyLayer
      • -
    • Flow.StarField
      • +
    • Flow.Starfield
    • Color
    • Rotation
    • Time
      • diff --git a/Documentation/doc/1 modules/Input.html b/Documentation/doc/1 modules/Input.html index 7e0bbc989..d895fb863 100644 --- a/Documentation/doc/1 modules/Input.html +++ b/Documentation/doc/1 modules/Input.html @@ -68,7 +68,7 @@
    • Flow.InventoryItem
    • Flow.LensFlare
    • Flow.SkyLayer
      • -
    • Flow.StarField
      • +
    • Flow.Starfield
    • Color
    • Rotation
    • Time
      • diff --git a/Documentation/doc/1 modules/Inventory.html b/Documentation/doc/1 modules/Inventory.html index 67a567fc8..2aad7fda5 100644 --- a/Documentation/doc/1 modules/Inventory.html +++ b/Documentation/doc/1 modules/Inventory.html @@ -68,7 +68,7 @@
    • Flow.InventoryItem
    • Flow.LensFlare
    • Flow.SkyLayer
      • -
    • Flow.StarField
      • +
    • Flow.Starfield
    • Color
    • Rotation
    • Time
      • diff --git a/Documentation/doc/1 modules/Logic.html b/Documentation/doc/1 modules/Logic.html index e1e0aa7df..fa7dc6e57 100644 --- a/Documentation/doc/1 modules/Logic.html +++ b/Documentation/doc/1 modules/Logic.html @@ -68,7 +68,7 @@
    • Flow.InventoryItem
    • Flow.LensFlare
    • Flow.SkyLayer
      • -
    • Flow.StarField
      • +
    • Flow.Starfield
    • Color
    • Rotation
    • Time
      • diff --git a/Documentation/doc/1 modules/Objects.html b/Documentation/doc/1 modules/Objects.html index 3f9e4d031..fa8430af0 100644 --- a/Documentation/doc/1 modules/Objects.html +++ b/Documentation/doc/1 modules/Objects.html @@ -68,7 +68,7 @@
    • Flow.InventoryItem
    • Flow.LensFlare
    • Flow.SkyLayer
      • -
    • Flow.StarField
      • +
    • Flow.Starfield
    • Color
    • Rotation
    • Time
      • diff --git a/Documentation/doc/1 modules/Sound.html b/Documentation/doc/1 modules/Sound.html index 4c8cf0da5..76d850aa4 100644 --- a/Documentation/doc/1 modules/Sound.html +++ b/Documentation/doc/1 modules/Sound.html @@ -68,7 +68,7 @@
    • Flow.InventoryItem
    • Flow.LensFlare
    • Flow.SkyLayer
      • -
    • Flow.StarField
      • +
    • Flow.Starfield
    • Color
    • Rotation
    • Time
      • diff --git a/Documentation/doc/1 modules/Strings.html b/Documentation/doc/1 modules/Strings.html index c3c57ea92..fe511f379 100644 --- a/Documentation/doc/1 modules/Strings.html +++ b/Documentation/doc/1 modules/Strings.html @@ -68,7 +68,7 @@
    • Flow.InventoryItem
    • Flow.LensFlare
    • Flow.SkyLayer
      • -
    • Flow.StarField
      • +
    • Flow.Starfield
    • Color
    • Rotation
    • Time
      • diff --git a/Documentation/doc/1 modules/Util.html b/Documentation/doc/1 modules/Util.html index 6e7bf0f91..6365605b9 100644 --- a/Documentation/doc/1 modules/Util.html +++ b/Documentation/doc/1 modules/Util.html @@ -68,7 +68,7 @@
    • Flow.InventoryItem
    • Flow.LensFlare
    • Flow.SkyLayer
      • -
    • Flow.StarField
      • +
    • Flow.Starfield
    • Color
    • Rotation
    • Time
      • diff --git a/Documentation/doc/1 modules/View.html b/Documentation/doc/1 modules/View.html index 45bcd0fc5..6e99c337d 100644 --- a/Documentation/doc/1 modules/View.html +++ b/Documentation/doc/1 modules/View.html @@ -68,7 +68,7 @@
    • Flow.InventoryItem
    • Flow.LensFlare
    • Flow.SkyLayer
      • -
    • Flow.StarField
      • +
    • Flow.Starfield
    • Color
    • Rotation
    • Time
      • diff --git a/Documentation/doc/2 classes/Collision.Probe.html b/Documentation/doc/2 classes/Collision.Probe.html index d897d847f..8be1e951a 100644 --- a/Documentation/doc/2 classes/Collision.Probe.html +++ b/Documentation/doc/2 classes/Collision.Probe.html @@ -68,7 +68,7 @@
    • Flow.InventoryItem
    • Flow.LensFlare
    • Flow.SkyLayer
      • -
    • Flow.StarField
      • +
    • Flow.Starfield
    • Color
    • Rotation
    • Time
      • diff --git a/Documentation/doc/2 classes/Flow.Level.html b/Documentation/doc/2 classes/Flow.Level.html index 88af887a2..6cb778133 100644 --- a/Documentation/doc/2 classes/Flow.Level.html +++ b/Documentation/doc/2 classes/Flow.Level.html @@ -68,7 +68,7 @@
    • Flow.InventoryItem
    • Flow.LensFlare
    • Flow.SkyLayer
      • -
    • Flow.StarField
      • +
    • Flow.Starfield
    • Color
    • Rotation
    • Time
      • @@ -158,8 +158,8 @@
    - - + + @@ -362,11 +362,11 @@
    - - starField + + starfield
    - (Flow.StarField) Starfield in the sky. + (Flow.Starfield) Starfield in the sky. diff --git a/Documentation/doc/2 classes/Flow.Settings.html b/Documentation/doc/2 classes/Flow.Settings.html index dd633bb6d..96e83ad22 100644 --- a/Documentation/doc/2 classes/Flow.Settings.html +++ b/Documentation/doc/2 classes/Flow.Settings.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/2 classes/Flow.Statistics.html b/Documentation/doc/2 classes/Flow.Statistics.html index ce7559423..fef4baf27 100644 --- a/Documentation/doc/2 classes/Flow.Statistics.html +++ b/Documentation/doc/2 classes/Flow.Statistics.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/2 classes/Objects.AIObject.html b/Documentation/doc/2 classes/Objects.AIObject.html index 49df5459e..e3417bdff 100644 --- a/Documentation/doc/2 classes/Objects.AIObject.html +++ b/Documentation/doc/2 classes/Objects.AIObject.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/2 classes/Objects.Camera.html b/Documentation/doc/2 classes/Objects.Camera.html index 385089252..e5e8fde01 100644 --- a/Documentation/doc/2 classes/Objects.Camera.html +++ b/Documentation/doc/2 classes/Objects.Camera.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/2 classes/Objects.LaraObject.html b/Documentation/doc/2 classes/Objects.LaraObject.html index d34d996a0..e9047c5de 100644 --- a/Documentation/doc/2 classes/Objects.LaraObject.html +++ b/Documentation/doc/2 classes/Objects.LaraObject.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/2 classes/Objects.Moveable.html b/Documentation/doc/2 classes/Objects.Moveable.html index f2b624dc6..6ef4a0404 100644 --- a/Documentation/doc/2 classes/Objects.Moveable.html +++ b/Documentation/doc/2 classes/Objects.Moveable.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/2 classes/Objects.Room.html b/Documentation/doc/2 classes/Objects.Room.html index 8e2a5ac4c..1b36cd4bb 100644 --- a/Documentation/doc/2 classes/Objects.Room.html +++ b/Documentation/doc/2 classes/Objects.Room.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • @@ -144,11 +144,11 @@
    - + - + @@ -280,7 +280,7 @@
    - Room:SetReverbType(Reverb) + Room:SetReverbType(reverb)
    Set the room's reverb type. @@ -289,9 +289,9 @@

    Parameters:

      -
    • Reverb +
    • reverb RoomReverb - type. + Reverb type.
    @@ -302,7 +302,7 @@
    - Room:SetFlag(flagID, Boolean) + Room:SetFlag(flagID, value)
    Set the room's specified flag. @@ -315,9 +315,9 @@ RoomFlagID Room flag ID. -
  • Boolean +
  • value bool - to set the flag to. + Boolean to set the flag to.
    • diff --git a/Documentation/doc/2 classes/Objects.Sink.html b/Documentation/doc/2 classes/Objects.Sink.html index 84b307826..0ba93f4a6 100644 --- a/Documentation/doc/2 classes/Objects.Sink.html +++ b/Documentation/doc/2 classes/Objects.Sink.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/2 classes/Objects.SoundSource.html b/Documentation/doc/2 classes/Objects.SoundSource.html index 051f35de9..4f658cb93 100644 --- a/Documentation/doc/2 classes/Objects.SoundSource.html +++ b/Documentation/doc/2 classes/Objects.SoundSource.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/2 classes/Objects.Static.html b/Documentation/doc/2 classes/Objects.Static.html index 4adcdd058..a8009b0a2 100644 --- a/Documentation/doc/2 classes/Objects.Static.html +++ b/Documentation/doc/2 classes/Objects.Static.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/2 classes/Objects.Volume.html b/Documentation/doc/2 classes/Objects.Volume.html index 7976ec63a..5db162a3e 100644 --- a/Documentation/doc/2 classes/Objects.Volume.html +++ b/Documentation/doc/2 classes/Objects.Volume.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/2 classes/Strings.DisplayString.html b/Documentation/doc/2 classes/Strings.DisplayString.html index df98e9f4f..f1f29c123 100644 --- a/Documentation/doc/2 classes/Strings.DisplayString.html +++ b/Documentation/doc/2 classes/Strings.DisplayString.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/2 classes/View.DisplaySprite.html b/Documentation/doc/2 classes/View.DisplaySprite.html index a17294a5b..9f9c723fa 100644 --- a/Documentation/doc/2 classes/View.DisplaySprite.html +++ b/Documentation/doc/2 classes/View.DisplaySprite.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/3 primitive classes/Color.html b/Documentation/doc/3 primitive classes/Color.html index c2ae23ee2..a54514919 100644 --- a/Documentation/doc/3 primitive classes/Color.html +++ b/Documentation/doc/3 primitive classes/Color.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/3 primitive classes/Flow.Fog.html b/Documentation/doc/3 primitive classes/Flow.Fog.html index c2aa2554e..f8dd36f4d 100644 --- a/Documentation/doc/3 primitive classes/Flow.Fog.html +++ b/Documentation/doc/3 primitive classes/Flow.Fog.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/3 primitive classes/Flow.Horizon.html b/Documentation/doc/3 primitive classes/Flow.Horizon.html index b432e533a..4d9d69be1 100644 --- a/Documentation/doc/3 primitive classes/Flow.Horizon.html +++ b/Documentation/doc/3 primitive classes/Flow.Horizon.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/3 primitive classes/Flow.InventoryItem.html b/Documentation/doc/3 primitive classes/Flow.InventoryItem.html index 0fc41f7b1..2623737c0 100644 --- a/Documentation/doc/3 primitive classes/Flow.InventoryItem.html +++ b/Documentation/doc/3 primitive classes/Flow.InventoryItem.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/3 primitive classes/Flow.LensFlare.html b/Documentation/doc/3 primitive classes/Flow.LensFlare.html index d0739432e..5c666ea9d 100644 --- a/Documentation/doc/3 primitive classes/Flow.LensFlare.html +++ b/Documentation/doc/3 primitive classes/Flow.LensFlare.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/3 primitive classes/Flow.SkyLayer.html b/Documentation/doc/3 primitive classes/Flow.SkyLayer.html index b64f57108..27427363c 100644 --- a/Documentation/doc/3 primitive classes/Flow.SkyLayer.html +++ b/Documentation/doc/3 primitive classes/Flow.SkyLayer.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/3 primitive classes/Flow.Starfield.html b/Documentation/doc/3 primitive classes/Flow.Starfield.html index df49ddf8b..0efed6489 100644 --- a/Documentation/doc/3 primitive classes/Flow.Starfield.html +++ b/Documentation/doc/3 primitive classes/Flow.Starfield.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • @@ -114,9 +114,9 @@
    -

    Primitive Class Flow.StarField

    +

    Primitive Class Flow.Starfield

    Represents a star field in the sky.

    -

    To be used with Flow.Level.starField property.

    +

    To be used with Flow.Level.starfield property.

    Members

    @@ -141,11 +141,11 @@

    Functions

    LaraObject:SetPoison([Poison])LaraObject:SetPoison([poison]) Set player poison.
    LaraObject:GetPoison()Get poison potency of LaraGet poison potency of Lara.
    LaraObject:SetAir(Air)Set air value of LaraLaraObject:SetAir(air)Set air value of Lara.
    LaraObject:GetAir()Get air value of LaraGet air value of Lara.
    LaraObject:SetWet(Wetness)Set wetness value of Lara (causes dripping)LaraObject:SetWet(wetness)Set wetness value of Lara (causes dripping).
    LaraObject:GetWet()Get wetness value of LaraGet wetness value of Lara.
    LaraObject:SetStamina(stamina)Set sprint energy value of LaraSet sprint energy value of Lara.
    LaraObject:GetStamina()Get stamina value of LaraGet stamina value of Lara.
    Moveable:GetAirborne()Get the moveable's airborne statusGet the moveable's airborne status.
    Moveable:SetAirborne(New)Set the moveable's airborne statusMoveable:SetAirborne(airborne)Set the moveable's airborne status.
    LaraObject:UndrawWeapon()
    LaraObject:GetHandStatus()Get actual hand status of LaraGet actual hand status of Lara.
    LaraObject:GetWeaponType()Get actual weapon type of LaraGet actual weapon type of Lara.
    LaraObject:SetWeaponType(weaponType, activate)Set Lara weapon typeSet Lara weapon type.
    LaraObject:GetAmmoType()
    LaraObject:GetAmmoCount()Get current weapon's ammo countGet current weapon's ammo count.
    LaraObject:GetVehicle()Get current vehicle, if it existsGet current vehicle, if it exists.
    LaraObject:GetTarget()(Flow.Horizon) Second horizon layer.
    starField(Flow.StarField) Starfield in the sky.starfield(Flow.Starfield) Starfield in the sky.
    lensFlare Set the room's unique string identifier.
    Room:SetReverbType(Reverb)Room:SetReverbType(reverb) Set the room's reverb type.
    Room:SetFlag(flagID, Boolean)Room:SetFlag(flagID, value) Set the room's specified flag.
    - + - +
    StarField(starCount)Starfield(starCount) Create a starfield object with only stars.
    StarField(starCount, meteorCount, meteorSpawnDensity, meteorVel)Starfield(starCount, meteorCount, meteorSpawnDensity, meteorVel) Create a starfield object with stars and meteors.
    @@ -222,8 +222,8 @@
    - - StarField(starCount) + + Starfield(starCount)
    Create a starfield object with only stars. @@ -241,8 +241,8 @@

    Returns:

      - Starfield - A new StarField object. + Starfield + A new Starfield object.
    @@ -250,8 +250,8 @@
    - - StarField(starCount, meteorCount, meteorSpawnDensity, meteorVel) + + Starfield(starCount, meteorCount, meteorSpawnDensity, meteorVel)
    Create a starfield object with stars and meteors. @@ -281,8 +281,8 @@

    Returns:

      - StarField - A new StarField object. + StarField + A new Starfield object.
    diff --git a/Documentation/doc/3 primitive classes/Rotation.html b/Documentation/doc/3 primitive classes/Rotation.html index 900fda280..7fad8cac1 100644 --- a/Documentation/doc/3 primitive classes/Rotation.html +++ b/Documentation/doc/3 primitive classes/Rotation.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/3 primitive classes/Time.html b/Documentation/doc/3 primitive classes/Time.html index 6de872b0c..c51d6a015 100644 --- a/Documentation/doc/3 primitive classes/Time.html +++ b/Documentation/doc/3 primitive classes/Time.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/3 primitive classes/Vec2.html b/Documentation/doc/3 primitive classes/Vec2.html index de9e80f16..2cef44350 100644 --- a/Documentation/doc/3 primitive classes/Vec2.html +++ b/Documentation/doc/3 primitive classes/Vec2.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/3 primitive classes/Vec3.html b/Documentation/doc/3 primitive classes/Vec3.html index bf9c41551..15a50a1dc 100644 --- a/Documentation/doc/3 primitive classes/Vec3.html +++ b/Documentation/doc/3 primitive classes/Vec3.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Collision.MaterialType.html b/Documentation/doc/4 enums/Collision.MaterialType.html index 23d383f27..4d6bd8af7 100644 --- a/Documentation/doc/4 enums/Collision.MaterialType.html +++ b/Documentation/doc/4 enums/Collision.MaterialType.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Effects.BlendID.html b/Documentation/doc/4 enums/Effects.BlendID.html index eecc444ff..55662a65e 100644 --- a/Documentation/doc/4 enums/Effects.BlendID.html +++ b/Documentation/doc/4 enums/Effects.BlendID.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Effects.EffectID.html b/Documentation/doc/4 enums/Effects.EffectID.html index 9072c82aa..62e5adfcc 100644 --- a/Documentation/doc/4 enums/Effects.EffectID.html +++ b/Documentation/doc/4 enums/Effects.EffectID.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Effects.FeatherMode.html b/Documentation/doc/4 enums/Effects.FeatherMode.html index 8fbae4b2c..c0534f46f 100644 --- a/Documentation/doc/4 enums/Effects.FeatherMode.html +++ b/Documentation/doc/4 enums/Effects.FeatherMode.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html index 8799d2677..35ac618af 100644 --- a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html +++ b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Flow.ErrorMode.html b/Documentation/doc/4 enums/Flow.ErrorMode.html index 625510196..2c34b0af0 100644 --- a/Documentation/doc/4 enums/Flow.ErrorMode.html +++ b/Documentation/doc/4 enums/Flow.ErrorMode.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Flow.FreezeMode.html b/Documentation/doc/4 enums/Flow.FreezeMode.html index c24cf87bb..3cedf2c1b 100644 --- a/Documentation/doc/4 enums/Flow.FreezeMode.html +++ b/Documentation/doc/4 enums/Flow.FreezeMode.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Flow.GameStatus.html b/Documentation/doc/4 enums/Flow.GameStatus.html index 556a27170..c6ceaed62 100644 --- a/Documentation/doc/4 enums/Flow.GameStatus.html +++ b/Documentation/doc/4 enums/Flow.GameStatus.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Input.ActionID.html b/Documentation/doc/4 enums/Input.ActionID.html index c198d7fcd..7543a8366 100644 --- a/Documentation/doc/4 enums/Input.ActionID.html +++ b/Documentation/doc/4 enums/Input.ActionID.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Objects.AmmoType.html b/Documentation/doc/4 enums/Objects.AmmoType.html index b094c086f..cd2bd79ad 100644 --- a/Documentation/doc/4 enums/Objects.AmmoType.html +++ b/Documentation/doc/4 enums/Objects.AmmoType.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Objects.HandStatus.html b/Documentation/doc/4 enums/Objects.HandStatus.html index 9e74accee..e5bd505b2 100644 --- a/Documentation/doc/4 enums/Objects.HandStatus.html +++ b/Documentation/doc/4 enums/Objects.HandStatus.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Objects.MoveableStatus.html b/Documentation/doc/4 enums/Objects.MoveableStatus.html index 5b55c96b6..9432736cc 100644 --- a/Documentation/doc/4 enums/Objects.MoveableStatus.html +++ b/Documentation/doc/4 enums/Objects.MoveableStatus.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Objects.ObjID.html b/Documentation/doc/4 enums/Objects.ObjID.html index e25106e81..89f7433b4 100644 --- a/Documentation/doc/4 enums/Objects.ObjID.html +++ b/Documentation/doc/4 enums/Objects.ObjID.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Objects.RoomFlagID.html b/Documentation/doc/4 enums/Objects.RoomFlagID.html index 820cc66fd..a180900b0 100644 --- a/Documentation/doc/4 enums/Objects.RoomFlagID.html +++ b/Documentation/doc/4 enums/Objects.RoomFlagID.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Objects.RoomReverb.html b/Documentation/doc/4 enums/Objects.RoomReverb.html index 66b7ff482..267676ff2 100644 --- a/Documentation/doc/4 enums/Objects.RoomReverb.html +++ b/Documentation/doc/4 enums/Objects.RoomReverb.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Objects.WeaponType.html b/Documentation/doc/4 enums/Objects.WeaponType.html index 868204528..bb8bd5eb7 100644 --- a/Documentation/doc/4 enums/Objects.WeaponType.html +++ b/Documentation/doc/4 enums/Objects.WeaponType.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Sound.SoundTrackType.html b/Documentation/doc/4 enums/Sound.SoundTrackType.html index e5f87781c..09c61531c 100644 --- a/Documentation/doc/4 enums/Sound.SoundTrackType.html +++ b/Documentation/doc/4 enums/Sound.SoundTrackType.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Strings.DisplayStringOption.html b/Documentation/doc/4 enums/Strings.DisplayStringOption.html index 2f723c0c8..b7bb2d0ee 100644 --- a/Documentation/doc/4 enums/Strings.DisplayStringOption.html +++ b/Documentation/doc/4 enums/Strings.DisplayStringOption.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/Util.LogLevel.html b/Documentation/doc/4 enums/Util.LogLevel.html index 17187a588..3621c96d1 100644 --- a/Documentation/doc/4 enums/Util.LogLevel.html +++ b/Documentation/doc/4 enums/Util.LogLevel.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/View.AlignMode.html b/Documentation/doc/4 enums/View.AlignMode.html index 03e0c821d..dbbd64adb 100644 --- a/Documentation/doc/4 enums/View.AlignMode.html +++ b/Documentation/doc/4 enums/View.AlignMode.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/View.CameraType.html b/Documentation/doc/4 enums/View.CameraType.html index 43a092345..ff920be2f 100644 --- a/Documentation/doc/4 enums/View.CameraType.html +++ b/Documentation/doc/4 enums/View.CameraType.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/View.PostProcessMode.html b/Documentation/doc/4 enums/View.PostProcessMode.html index ba5d9076f..c33764ce3 100644 --- a/Documentation/doc/4 enums/View.PostProcessMode.html +++ b/Documentation/doc/4 enums/View.PostProcessMode.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/4 enums/View.ScaleMode.html b/Documentation/doc/4 enums/View.ScaleMode.html index c2fed2a54..e649a6403 100644 --- a/Documentation/doc/4 enums/View.ScaleMode.html +++ b/Documentation/doc/4 enums/View.ScaleMode.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/5 lua utility modules/CustomBar.html b/Documentation/doc/5 lua utility modules/CustomBar.html index d809f3d8e..7dcd65fe5 100644 --- a/Documentation/doc/5 lua utility modules/CustomBar.html +++ b/Documentation/doc/5 lua utility modules/CustomBar.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/5 lua utility modules/Diary.html b/Documentation/doc/5 lua utility modules/Diary.html index ff4412fa6..752fe3569 100644 --- a/Documentation/doc/5 lua utility modules/Diary.html +++ b/Documentation/doc/5 lua utility modules/Diary.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/5 lua utility modules/EventSequence.html b/Documentation/doc/5 lua utility modules/EventSequence.html index 8b1aeeff6..3fa6249f6 100644 --- a/Documentation/doc/5 lua utility modules/EventSequence.html +++ b/Documentation/doc/5 lua utility modules/EventSequence.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/5 lua utility modules/Timer.html b/Documentation/doc/5 lua utility modules/Timer.html index a8ac29923..cd52ae85b 100644 --- a/Documentation/doc/5 lua utility modules/Timer.html +++ b/Documentation/doc/5 lua utility modules/Timer.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/5 lua utility modules/Type.html b/Documentation/doc/5 lua utility modules/Type.html index acadc9fc1..a16041ec9 100644 --- a/Documentation/doc/5 lua utility modules/Type.html +++ b/Documentation/doc/5 lua utility modules/Type.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • diff --git a/Documentation/doc/index.html b/Documentation/doc/index.html index dab35622b..2109237b0 100644 --- a/Documentation/doc/index.html +++ b/Documentation/doc/index.html @@ -68,7 +68,7 @@
  • Flow.InventoryItem
  • Flow.LensFlare
  • Flow.SkyLayer
    • -
  • Flow.StarField
    • +
  • Flow.Starfield
  • Color
  • Rotation
  • Time
    • @@ -266,7 +266,7 @@ local door = GetMoveableByName("door_type4_14") Describes a layer of moving clouds. - Flow.StarField + Flow.Starfield Represents a star field in the sky. diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp index efec1ae48..e722650bf 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp @@ -66,10 +66,9 @@ void Level::Register(sol::table& parent) //@mem horizon2 "horizon2", &Level::Horizon2, -/// (@{Flow.StarField}) Starfield in the sky. -// @mem starField - "starField", &Level::Starfield, - "starfield", &Level::Starfield, // Compatibility. +/// (@{Flow.Starfield}) Starfield in the sky. +// @mem starfield + "starfield", &Level::Starfield, /// (@{Flow.LensFlare}) Global lens flare. // @mem lensFlare diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp index 8cd952e62..09176ce75 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp @@ -6,8 +6,8 @@ using namespace TEN::Effects::Environment; -/// Represents a star field in the sky. To be used with @{Flow.Level.starField} property. -// @tenprimitive Flow.StarField +/// Represents a star field in the sky. To be used with @{Flow.Level.starfield} property. +// @tenprimitive Flow.Starfield // @pragma nostrip namespace TEN::Scripting @@ -20,7 +20,7 @@ namespace TEN::Scripting // Register type. parent.new_usertype( - "StarField", + "Starfield", ctors(), sol::call_constructor, ctors(), /// (int) Amount of visible stars. @@ -49,26 +49,24 @@ namespace TEN::Scripting "SetMeteorCount", &Starfield::SetMeteorCount, "SetMeteorSpawnDensity", &Starfield::SetMeteorSpawnDensity, "SetMeteorVelocity", &Starfield::SetMeteorVelocity); - - parent["Starfield"] = parent["StarField"]; } /// Create a starfield object with only stars. - // @function StarField + // @function Starfield // @tparam int starCount Star count. - // @treturn Starfield A new StarField object. + // @treturn Starfield A new Starfield object. Starfield::Starfield(int starCount) { _starCount = starCount; } /// Create a starfield object with stars and meteors. - // @function StarField + // @function Starfield // @tparam int starCount Star count. __Max: 6000__ // @tparam int meteorCount Meteor count. __Max: 100__ // @tparam int meteorSpawnDensity Meteor spawn density. // @tparam int meteorVel Meteor velocity. - // @treturn StarField A new StarField object. + // @treturn StarField A new Starfield object. Starfield::Starfield(int starCount, int meteorCount, int meteorSpawnDensity, float meteorVel) { if (starCount < 0 || starCount > STAR_COUNT_MAX) From 234192f9edf8f7286ccde971607f0e614f979b3d Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 15 Mar 2025 01:03:09 +0100 Subject: [PATCH 069/160] Update CHANGELOG.md --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index e38231218..270e4aa5d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -53,7 +53,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added extra arguments for sprite object slots and starting rotation value for `EmitParticle` function. * Added ability to dynamically change `Flow.Level` weather and environment parameters and save them to a savegame. * Added pickup count to `Flow.Statistics` class. -* Changed `Flow.StarField` and `Flow.LensFlare` primitive types to use parameters instead of getters and setters. +* Changed `Flow.Starfield` and `Flow.LensFlare` primitive types to use parameters instead of getters and setters. * Fixed medipack level count in `Flow.Statistics` class. ## [Version 1.7.1](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.7.4) - 2025-04-01 From b9c3856c090bce17f273ae867f25a313879f998d Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 15 Mar 2025 02:55:30 +0100 Subject: [PATCH 070/160] Fix alpha tested polys not fading --- TombEngine/Renderer/Renderer.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TombEngine/Renderer/Renderer.h b/TombEngine/Renderer/Renderer.h index 09939c63e..53fc9e433 100644 --- a/TombEngine/Renderer/Renderer.h +++ b/TombEngine/Renderer/Renderer.h @@ -587,7 +587,7 @@ namespace TEN::Renderer static inline BlendMode GetBlendModeFromAlpha(BlendMode blendMode, float alpha) { - if (alpha < ALPHA_BLEND_THRESHOLD && (blendMode == BlendMode::Opaque || blendMode == BlendMode::FastAlphaBlend)) + if (alpha < ALPHA_BLEND_THRESHOLD && (blendMode == BlendMode::Opaque || blendMode == BlendMode::AlphaTest || blendMode == BlendMode::FastAlphaBlend)) return BlendMode::AlphaBlend; return blendMode; From 92b8ed821fdd35c81ff5fde692d505208da81bbc Mon Sep 17 00:00:00 2001 From: Sezz Date: Sat, 15 Mar 2025 18:01:27 +1100 Subject: [PATCH 071/160] Update Lua advanced particle emitter --- Documentation/doc/1 modules/Effects.html | 224 +++++------ TombEngine/Renderer/Renderer.h | 5 +- .../Internal/TEN/Effects/EffectsFunctions.cpp | 348 +++++++++--------- 3 files changed, 284 insertions(+), 293 deletions(-) diff --git a/Documentation/doc/1 modules/Effects.html b/Documentation/doc/1 modules/Effects.html index 92b0fb480..24f9a971a 100644 --- a/Documentation/doc/1 modules/Effects.html +++ b/Documentation/doc/1 modules/Effects.html @@ -124,16 +124,16 @@

    Functions

    - + - + - + @@ -193,7 +193,7 @@
    - EmitLightningArc(src, dest, color, lifetime, amplitude, beamWidth, detail, smooth, endDrift) + EmitLightningArc(origin, target, color, life, amplitude, beamWidth, detail, smooth, endDrift)
    Emit a lightning arc. @@ -202,13 +202,13 @@

    Parameters:

      -
    • src +
    • origin Vec3
      • -
    • dest +
    • target Vec3 @@ -218,29 +218,29 @@ Color (default Color(255, 255, 255))
      • -
    • lifetime +
    • life float - Lifetime in seconds. Clamped to [0, 4.233] for now because of strange internal maths. (default 1.0) + Lifetime in seconds. Clamped to [0, 4.233] for now because of strange internal maths. default: 1
    • amplitude int - "strength" of the lightning - the higher the value, the "taller" the arcs. Clamped to [1, 255]. (default 20) + "strength" of the lightning - the higher the value, the "taller" the arcs. Clamped to [1, 255]. default: 20
    • beamWidth int - Clamped to [1, 127]. (default 2) + Clamped to [1, 127]. default 2
    • detail int - Higher numbers equal more segments, but it's not a 1:1 correlation. Clamped to [1, 127]. (default 10) + Higher numbers equal more segments, but it's not a 1:1 correlation. Clamped to [1, 127]. default: 10
    • smooth bool - If true, the arc will have large, smooth curves; if false, it will have small, jagged spikes. (default false) + If true, the arc will have large, smooth curves; if false, it will have small, jagged spikes. default: false
    • endDrift bool - If true, the end of the arc will be able to gradually drift away from its destination in a random direction (default false) + If true, the end of the arc will be able to gradually drift away from its destination in a random direction default: false
    @@ -251,7 +251,7 @@
    - EmitParticle(pos, vel, spriteID, gravity, rotVel, startColor, endColor, blendMode, startSize, endSize, life, applyDamage, applyPoison, spriteSeqID, startRot) + EmitParticle(pos, vel, spriteID, gravity, rotVel, startColor, endColor, blendMode, startSize, endSize, life, damage, poison, spriteSeqID, startRot)
    Emit a particle. @@ -266,59 +266,59 @@
  • vel Vec3 - Velocity. + Directional velocity.
  • spriteID int - ID of the sprite in the sprite sequence object. + Sprite ID in the sprite sequence slot.
  • gravity float - Specifies if the particle will fall over time. Positive values ascend, negative values descend. Recommended range: [-1000 and 1000]. Default: 0 + Effect of gravity. Positive value ascends, negative value descends. default: 0
  • rotVel float - Rotational velocity in degrees. Default: 0 + Rotational velocity in degrees. default: 0
  • startColor Color - Color at start of life. Default: Color(255, 255, 255) + Color at start of life. default: Color(255, 255, 255)
  • endColor Color - Color to fade toward. This will finish long before the end of the particle's life due to internal math. Default: Color(255, 255, 255) + Color at end of life. This will finish long before the end of the particle's life due to internal math. default: Color(255, 255, 255)
  • blendMode BlendID - Render blend mode. TEN.Effects.BlendID.ALPHABLEND + Render blend mode. TEN.Effects.BlendID.ALPHA_BLEND
  • startSize float - Size at start of life. Default: 10 + Size at start of life. default: 10
  • endSize float - Size at end of life. The particle will linearly shrink or grow toward this size over its lifespan. Default: 0 + Size at end of life. default: 0
  • life float - Lifespan in seconds. Default: 2 + Lifespan in seconds. default: 2
    • -
  • applyDamage +
  • damage bool - Specify if the particle will harm the player on collision. Default: false + Harm the player on collision. default: false
    • -
  • applyPoison +
  • poison bool - Specify if the particle will poison the player on collision. Default: false + Poison the player on collision. default: false
  • spriteSeqID SpriteConstants - ID of the sprite sequence object. Default: Objects.ObjID.DEFAULT_SPRITES + Sprite sequence slot ID. default: Objects.ObjID.DEFAULT_SPRITES
  • startRot float - Rotation at start of life. Default: random + Rotation at start of life. default: random
    • @@ -328,22 +328,21 @@

    Usage:

      EmitParticle(
-	pos,
-	Vec3(math.random(), math.random(), math.random()),
-	22, -- spriteID
-	0, -- gravity
-	-2, -- rotVel
-	Color(255, 0, 0), -- startColor
-	Color(0,  255, 0), -- endColor
-	TEN.Effects.BlendID.ADDITIVE, -- blendMode
-	15, -- startSize
-	50, -- endSize
-	20, -- life
-	false, -- applyDamage
-	true, -- applyPoison
- Objects.ObjID.DEFAULT_SPRITES, -- spriteSeqID
- 180 -- startRot
- )
      + pos, + Vec3(math.random(), math.random(), math.random()), + 22, -- spriteID + 0, -- gravity + -2, -- rotVel + Color(255, 0, 0), -- startColor + Color(0, 255, 0), -- endColor + TEN.Effects.BlendID.ADDITIVE, -- blendMode + 15, -- startSize + 50, -- endSize + 20, -- life + false, -- damage + true, -- poison + Objects.ObjID.DEFAULT_SPRITES, -- spriteSeqID + 180) -- startRot
    @@ -352,7 +351,7 @@ EmitAdvancedParticle(ParticleData)
    - Emit a particle with extensive configuration options including animations. + Emit a particle with extensive configuration options, including sprite sequence animation, lights, sounds, and damage effects. @@ -360,7 +359,7 @@
    • ParticleData ParticleData - The table holding all the particle data. + Table containing particle data.
    @@ -369,34 +368,35 @@

    Usage:

      - 
      local particle = {
-position = GetMoveableByName("camera_target_6") :GetPosition(),
-velocity = Vec3(0, 0, 10),
-spriteSeqID = TEN.Objects.ObjID.CUSTOM_BAR_GRAPHIC,
-spriteID = 0,
-lifetime = 10,
-maxYVelocity = 0,
-gravity = 0,
-friction = 10,
-startRotation = 0,
-rotationSpeed = 0,
-startSize = 80,
-endSize = 80,
-startColor = TEN.Color(128, 128, 128),
-endColor = TEN.Color(128, 128, 128),
-blendMode = TEN.Effects.BlendID.ADDITIVE,
-wind = false,
-damage = true,
-poison = false,
-burn = false,
-damageHit = 80,
-sound = 197,
-light = true,
-lightRadius = 6,
-lightFlicker = 5,
-animated = true,
-frameRate = .25,
-animationType = TEN.Effects.ParticleAnimationType.LOOP,
+        
      local particle =
+{
+    pos = GetMoveableByName("camera_target_6"):GetPosition(),
+    vel = Vec3(0, 0, 10),
+    spriteSeqID = TEN.Objects.ObjID.CUSTOM_BAR_GRAPHIC,
+    spriteID = 0,
+    life = 10,
+    maxYVel = 0,
+    gravity = 0,
+    friction = 10,
+    startRot = 0,
+    rotVel = 0,
+    startSize = 80,
+    endSize = 80,
+    startColor = TEN.Color(128, 128, 128),
+    endColor = TEN.Color(128, 128, 128),
+    blendMode = TEN.Effects.BlendID.ADDITIVE,
+    wind = false,
+    damage = true,
+    poison = false,
+    burn = false,
+    damageHit = 80,
+    sound = 197,
+    light = true,
+    lightRadius = 6,
+    lightFlicker = 5,
+    animated = true,
+    frameRate = 0.25,
+    animType = TEN.Effects.ParticleAnimationType.LOOP,
 }
 EmitAdvancedParticle(particle)
    @@ -631,7 +631,7 @@ EmitAdvancedParticle(particle)
  • size float - (default 1.0) + Fire size. default: 1
    • @@ -790,7 +790,7 @@ EmitAdvancedParticle(particle)
  • lengthFeatherMode Effects.StreamerFeatherMode - Length feather mode. Not implemented yet. + Length feather mode. UNIMPLEMENTED, currently will always leave a fading tail (optional)
  • blendID @@ -820,137 +820,137 @@ EmitAdvancedParticle(particle)

    Fields:

      -
    • position +
    • pos Vec3 World position.
      • -
    • velocity +
    • vel Vec3 - Velocity. + Directional velocity in world units per second.
    • spriteSeqID SpriteConstants - ID of the sprite sequence object. Default: Objects.ObjID.DEFAULT_SPRITES + Sprite sequence slot ID. default: Objects.ObjID.DEFAULT_SPRITES (optional)
    • spriteID int - ID of the sprite in the sprite sequence object.Default: 0 + Sprite ID in the sprite sequence slot. default: 0 (optional)
      • -
    • lifetime +
    • life float - Lifespan in seconds. Default: 2 + Lifespan in seconds. default: 2 (optional)
      • -
    • maxYVelocity +
    • maxYVel float - Specifies ithe maximum Y velocity for the particle. Default: 0 + Maximum vertical velocity in world units per second. default: 0 (optional)
    • gravity float - Specifies if the particle will fall over time. Positive values ascend, negative values descend. Recommended range: [-1000 and 1000]. Default: 0 + Effect of gravity in world units per second. Positive value ascend, negative value descend. default: 0 (optional)
    • friction float - Specifies the friction with which the particle will slow down over time. Default: 0 + Friction affecting velocity over time in world units per second. default: 0 (optional)
      • -
    • startRotation +
    • startRot float - Rotation at start of life. Default: random + Rotation at start of life. default: random (optional)
      • -
    • rotationSpeed +
    • rotVel float - Rotational velocity in degrees. Default: 0 + Rotational velocity in degrees per second. default: 0 (optional)
    • startSize float - Size at start of life. Default: 10 + Size at start of life. default: 10 (optional)
    • endSize float - Size at end of life. The particle will linearly shrink or grow toward this size over its lifespan. Default: 0 + Size at end of life. default: 0 (optional)
    • startColor Color - Color at start of life. Default: Color(255, 255, 255) + Color at start of life. default: Color(255, 255, 255) (optional)
    • endColor Color - Color to fade toward. This will finish long before the end of the particle's life due to internal math. Default: Color(255, 255, 255) + Color at end of life. Note that this will finish long before the end of life due to internal math. default: Color(255, 255, 255) (optional)
    • blendMode BlendID - Render blend mode. TEN.Effects.BlendID.ALPHA_BLEND + Render blend mode. default: TEN.Effects.BlendID.ALPHA_BLEND (optional)
    • damage bool - Specify if the particle will harm the player on collision. Default: false + Harm the player on collision. default: false (optional)
    • poison bool - Specify if the particle will poison the player on collision. Default: false + Poison the player on collision. default: false (optional)
    • burn bool - Specify if the particle will burn the player on collision. Default: false + Burn the player on collision. default: false (optional)
    • wind bool - Specify if the particle will be affected by wind in outside rooms. Default: false + Affect position by wind in outside rooms. default: false (optional)
    • damageHit int - Specify the damage particle will harm the player on collision. Default: 2 + Player damage amount on collision. default: 2 (optional)
    • light bool - Specify if the particle will be emit a light based on its color. Caution: Recommended only for a single particle. Having too many particles with lights can overflow the light system. Default: false + Emit a colored light. CAUTION: Recommended only for a single particle. Too many particles with lights can overwhelm the lighting system. default: false (optional)
    • lightRadius int - measured in "clicks" or 256 world units. Default: 0 + Light radius in 1/4 blocks. default: 0 (optional)
    • lightFlicker int - The interval at which light should flicker. Default: 0 + Interval at which the light should flicker. default: 0 (optional)
      • -
    • sound +
    • soundID int - ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. Looping sounds recommended. Caution: Recommended only for a single particle. Having too many particles with sounds can overflow the sound system. Default: None + Sound ID to play. CAUTION: Recommended only for a single particle. Too many particles with sounds can overwhelm the sound system. default: none (optional)
    • animated bool - Specify if the particle will be animated. Default: false + Play animates sprite sequence. default: false (optional)
      • -
    • animationType +
    • animType ParticleAnimationType - Specify the the type of animation the particle will use. Default: TEN.Effects.ParticleAnimationType.LOOP + Animation type of the sprite sequence. default: TEN.Effects.ParticleAnimationType.LOOP (optional)
    • frameRate float - The framerate with which the particle will be animated. Default: 1 + Sprite sequence animation framerate. default: 1 (optional)
    diff --git a/TombEngine/Renderer/Renderer.h b/TombEngine/Renderer/Renderer.h index 53fc9e433..cfe315b4c 100644 --- a/TombEngine/Renderer/Renderer.h +++ b/TombEngine/Renderer/Renderer.h @@ -587,8 +587,11 @@ namespace TEN::Renderer static inline BlendMode GetBlendModeFromAlpha(BlendMode blendMode, float alpha) { - if (alpha < ALPHA_BLEND_THRESHOLD && (blendMode == BlendMode::Opaque || blendMode == BlendMode::AlphaTest || blendMode == BlendMode::FastAlphaBlend)) + if (alpha < ALPHA_BLEND_THRESHOLD && + (blendMode == BlendMode::Opaque || blendMode == BlendMode::AlphaTest || blendMode == BlendMode::FastAlphaBlend)) + { return BlendMode::AlphaBlend; + } return blendMode; } diff --git a/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp b/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp index dde3c2ba8..db1c25834 100644 --- a/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp +++ b/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp @@ -48,23 +48,24 @@ using namespace TEN::Scripting::Types; namespace TEN::Scripting::Effects { - /// Emit a lightning arc. // @function EmitLightningArc - // @tparam Vec3 src - // @tparam Vec3 dest + // @tparam Vec3 origin + // @tparam Vec3 target // @tparam Color color (default Color(255, 255, 255)) - // @tparam float lifetime Lifetime in seconds. Clamped to [0, 4.233] for now because of strange internal maths. (default 1.0) - // @tparam int amplitude "strength" of the lightning - the higher the value, the "taller" the arcs. Clamped to [1, 255]. (default 20) - // @tparam int beamWidth Clamped to [1, 127]. (default 2) - // @tparam int detail Higher numbers equal more segments, but it's not a 1:1 correlation. Clamped to [1, 127]. (default 10) - // @tparam bool smooth If true, the arc will have large, smooth curves; if false, it will have small, jagged spikes. (default false) - // @tparam bool endDrift If true, the end of the arc will be able to gradually drift away from its destination in a random direction (default false) - - static void EmitLightningArc(Vec3 src, Vec3 dest, TypeOrNil color, TypeOrNil lifetime, TypeOrNil amplitude, TypeOrNil beamWidth, TypeOrNil segments, TypeOrNil smooth, TypeOrNil endDrift) + // @tparam float life Lifetime in seconds. Clamped to [0, 4.233] for now because of strange internal maths. __default: 1__ + // @tparam int amplitude "strength" of the lightning - the higher the value, the "taller" the arcs. Clamped to [1, 255]. __default: 20__ + // @tparam int beamWidth Clamped to [1, 127]. __default 2__ + // @tparam int detail Higher numbers equal more segments, but it's not a 1:1 correlation. Clamped to [1, 127]. __default: 10__ + // @tparam bool smooth If true, the arc will have large, smooth curves; if false, it will have small, jagged spikes. __default: false__ + // @tparam bool endDrift If true, the end of the arc will be able to gradually drift away from its destination in a random direction __default: false__ + static void EmitLightningArc(const Vec3& origin, const Vec3& target, TypeOrNil color, TypeOrNil life, TypeOrNil amplitude, + TypeOrNil beamWidth, TypeOrNil segments, TypeOrNil smooth, TypeOrNil endDrift) { - auto p1 = Vector3(src.x, src.y, src.z); - auto p2 = Vector3(dest.x, dest.y, dest.z); + constexpr auto LIFE_SEC_MAX = 4.233f; + + auto convertedOrigin = origin.ToVector3(); + auto convertedTarget = target.ToVector3(); int segs = ValueOr(segments, 10); @@ -77,21 +78,20 @@ namespace TEN::Scripting::Effects // Nearest number of milliseconds equating to approx 254, the max even byte value for "life". // This takes into account a "hardcoded" FPS of 30 and the fact that // lightning loses two "life" each frame. - constexpr auto kMaxLifeSeconds = 4.233f; - float life = ValueOr(lifetime, 1.0f); - life = std::clamp(life, 0.0f, kMaxLifeSeconds); + float convertedLife = ValueOr(life, 1.0f); + convertedLife = std::clamp(convertedLife, 0.0f, LIFE_SEC_MAX); constexpr float secsPerFrame = 1.0f / (float)FPS; // This will put us in the range [0, 127] - int lifeInFrames = (int)round(life / secsPerFrame); + int lifeInFrames = (int)round(convertedLife / secsPerFrame); // Multiply by two since a) lightning loses two "life" each frame, and b) it must be // an even number to avoid overshooting a value of 0 and wrapping around. byte byteLife = lifeInFrames * 2; int amp = ValueOr(amplitude, 20); - byte byteAmplitude = std::clamp(amp, 1, 255); + byte byteAmp = std::clamp(amp, 1, 255); bool isSmooth = ValueOr(smooth, false); bool isDrift = ValueOr(endDrift, false); @@ -103,47 +103,45 @@ namespace TEN::Scripting::Effects if(isDrift) flags |= 2; - ScriptColor col = ValueOr(color, ScriptColor( 255, 255, 255 )); + auto convertedColor = ValueOr(color, ScriptColor( 255, 255, 255 )); - SpawnElectricity(p1, p2, byteAmplitude, col.GetR(), col.GetG(), col.GetB(), byteLife, flags, width, segs); + SpawnElectricity(convertedOrigin, convertedTarget, byteAmp, convertedColor.GetR(), convertedColor.GetG(), convertedColor.GetB(), byteLife, flags, width, segs); } /// Emit a particle. // @function EmitParticle // @tparam Vec3 pos World position. - // @tparam Vec3 vel Velocity. - // @tparam int spriteID ID of the sprite in the sprite sequence object. - // @tparam float gravity Specifies if the particle will fall over time. Positive values ascend, negative values descend. Recommended range: [-1000 and 1000]. __Default: 0__ - // @tparam float rotVel Rotational velocity in degrees. __Default: 0__ - // @tparam Color startColor Color at start of life. __Default: Color(255, 255, 255)__ - // @tparam Color endColor Color to fade toward. This will finish long before the end of the particle's life due to internal math. __Default: Color(255, 255, 255)__ - // @tparam Effects.BlendID blendMode Render blend mode. __TEN.Effects.BlendID.ALPHABLEND__ - // @tparam float startSize Size at start of life. __Default: 10__ - // @tparam float endSize Size at end of life. The particle will linearly shrink or grow toward this size over its lifespan. __Default: 0__ - // @tparam float life Lifespan in seconds. __Default: 2__ - // @tparam bool applyDamage Specify if the particle will harm the player on collision. __Default: false__ - // @tparam bool applyPoison Specify if the particle will poison the player on collision. __Default: false__ - // @tparam Objects.ObjID.SpriteConstants spriteSeqID ID of the sprite sequence object. __Default: Objects.ObjID.DEFAULT_SPRITES__ - // @tparam float startRot Rotation at start of life. __Default: random__ + // @tparam Vec3 vel Directional velocity. + // @tparam int spriteID Sprite ID in the sprite sequence slot. + // @tparam float gravity Effect of gravity. Positive value ascends, negative value descends. __default: 0__ + // @tparam float rotVel Rotational velocity in degrees. __default: 0__ + // @tparam Color startColor Color at start of life. __default: Color(255, 255, 255)__ + // @tparam Color endColor Color at end of life. This will finish long before the end of the particle's life due to internal math. __default: Color(255, 255, 255)__ + // @tparam Effects.BlendID blendMode Render blend mode. __TEN.Effects.BlendID.ALPHA_BLEND__ + // @tparam float startSize Size at start of life. __default: 10__ + // @tparam float endSize Size at end of life. __default: 0__ + // @tparam float life Lifespan in seconds. __default: 2__ + // @tparam bool damage Harm the player on collision. __default: false__ + // @tparam bool poison Poison the player on collision. __default: false__ + // @tparam Objects.ObjID.SpriteConstants spriteSeqID Sprite sequence slot ID. __default: Objects.ObjID.DEFAULT_SPRITES__ + // @tparam float startRot Rotation at start of life. __default: random__ // @usage // EmitParticle( - // pos, - // Vec3(math.random(), math.random(), math.random()), - // 22, -- spriteID - // 0, -- gravity - // -2, -- rotVel - // Color(255, 0, 0), -- startColor - // Color(0, 255, 0), -- endColor - // TEN.Effects.BlendID.ADDITIVE, -- blendMode - // 15, -- startSize - // 50, -- endSize - // 20, -- life - // false, -- applyDamage - // true, -- applyPoison - // Objects.ObjID.DEFAULT_SPRITES, -- spriteSeqID - // 180 -- startRot - // ) - + // pos, + // Vec3(math.random(), math.random(), math.random()), + // 22, -- spriteID + // 0, -- gravity + // -2, -- rotVel + // Color(255, 0, 0), -- startColor + // Color(0, 255, 0), -- endColor + // TEN.Effects.BlendID.ADDITIVE, -- blendMode + // 15, -- startSize + // 50, -- endSize + // 20, -- life + // false, -- damage + // true, -- poison + // Objects.ObjID.DEFAULT_SPRITES, -- spriteSeqID + // 180) -- startRot static void EmitParticle(const Vec3& pos, const Vec3& vel, int spriteID, TypeOrNil gravity, TypeOrNil rotVel, TypeOrNil startColor, TypeOrNil endColor, TypeOrNil blendMode, TypeOrNil startSize, TypeOrNil endSize, TypeOrNil life, @@ -217,83 +215,83 @@ namespace TEN::Scripting::Effects part.flags |= SP_DAMAGE; part.damage = 2; } + // TODO: Add option to turn off wind. if (TestEnvironment(RoomEnvFlags::ENV_FLAG_WIND, part.roomNumber)) part.flags |= SP_WIND; } - /// Emit a particle with extensive configuration options including animations. + /// Emit a particle with extensive configuration options, including sprite sequence animation, lights, sounds, and damage effects. // @function EmitAdvancedParticle - // @tparam ParticleData ParticleData The table holding all the particle data. + // @tparam ParticleData ParticleData Table containing particle data. // @usage - // local particle = { - // position = GetMoveableByName("camera_target_6") :GetPosition(), - // velocity = Vec3(0, 0, 10), - // spriteSeqID = TEN.Objects.ObjID.CUSTOM_BAR_GRAPHIC, - // spriteID = 0, - // lifetime = 10, - // maxYVelocity = 0, - // gravity = 0, - // friction = 10, - // startRotation = 0, - // rotationSpeed = 0, - // startSize = 80, - // endSize = 80, - // startColor = TEN.Color(128, 128, 128), - // endColor = TEN.Color(128, 128, 128), - // blendMode = TEN.Effects.BlendID.ADDITIVE, - // wind = false, - // damage = true, - // poison = false, - // burn = false, - // damageHit = 80, - // sound = 197, - // light = true, - // lightRadius = 6, - // lightFlicker = 5, - // animated = true, - // frameRate = .25, - // animationType = TEN.Effects.ParticleAnimationType.LOOP, + // local particle = + // { + // pos = GetMoveableByName("camera_target_6"):GetPosition(), + // vel = Vec3(0, 0, 10), + // spriteSeqID = TEN.Objects.ObjID.CUSTOM_BAR_GRAPHIC, + // spriteID = 0, + // life = 10, + // maxYVel = 0, + // gravity = 0, + // friction = 10, + // startRot = 0, + // rotVel = 0, + // startSize = 80, + // endSize = 80, + // startColor = TEN.Color(128, 128, 128), + // endColor = TEN.Color(128, 128, 128), + // blendMode = TEN.Effects.BlendID.ADDITIVE, + // wind = false, + // damage = true, + // poison = false, + // burn = false, + // damageHit = 80, + // sound = 197, + // light = true, + // lightRadius = 6, + // lightFlicker = 5, + // animated = true, + // frameRate = 0.25, + // animType = TEN.Effects.ParticleAnimationType.LOOP, // } // EmitAdvancedParticle(particle) /// Structure for EmitAdvancedParticle table. // @table ParticleData - // @tfield Vec3 position World position. - // @tfield Vec3 velocity Velocity. - // @tfield[opt] Objects.ObjID.SpriteConstants spriteSeqID ID of the sprite sequence object. __Default: Objects.ObjID.DEFAULT_SPRITES__ - // @tfield[opt] int spriteID ID of the sprite in the sprite sequence object.__Default: 0__ - // @tfield[opt] float lifetime Lifespan in seconds. __Default: 2__ - // @tfield[opt] float maxYVelocity Specifies ithe maximum Y velocity for the particle. __Default: 0__ - // @tfield[opt] float gravity Specifies if the particle will fall over time. Positive values ascend, negative values descend. Recommended range: [-1000 and 1000]. __Default: 0__ - // @tfield[opt] float friction Specifies the friction with which the particle will slow down over time. __Default: 0__ - // @tfield[opt] float startRotation Rotation at start of life. __Default: random__ - // @tfield[opt] float rotationSpeed Rotational velocity in degrees. __Default: 0__ - // @tfield[opt] float startSize Size at start of life. __Default: 10__ - // @tfield[opt] float endSize Size at end of life. The particle will linearly shrink or grow toward this size over its lifespan. __Default: 0__ - // @tfield[opt] Color startColor Color at start of life. __Default: Color(255, 255, 255)__ - // @tfield[opt] Color endColor Color to fade toward. This will finish long before the end of the particle's life due to internal math. __Default: Color(255, 255, 255)__ - // @tfield[opt] Effects.BlendID blendMode Render blend mode. __TEN.Effects.BlendID.ALPHA_BLEND__ - // @tfield[opt] bool damage Specify if the particle will harm the player on collision. __Default: false__ - // @tfield[opt] bool poison Specify if the particle will poison the player on collision. __Default: false__ - // @tfield[opt] bool burn Specify if the particle will burn the player on collision. __Default: false__ - // @tfield[opt] bool wind Specify if the particle will be affected by wind in outside rooms. __Default: false__ - // @tfield[opt] int damageHit Specify the damage particle will harm the player on collision. __Default: 2__ - // @tfield[opt] bool light Specify if the particle will be emit a light based on its color. Caution: Recommended only for a single particle. Having too many particles with lights can overflow the light system. __Default: false__ - // @tfield[opt] int lightRadius measured in "clicks" or 256 world units. __Default: 0__ - // @tfield[opt] int lightFlicker The interval at which light should flicker. __Default: 0__ - // @tfield[opt] int sound ID to play. Corresponds to the value in the sound XML file or Tomb Editor's "Sound Infos" window. Looping sounds recommended. Caution: Recommended only for a single particle. Having too many particles with sounds can overflow the sound system. __Default: None__ - // @tfield[opt] bool animated Specify if the particle will be animated. __Default: false__ - // @tfield[opt] Effects.ParticleAnimationType animationType Specify the the type of animation the particle will use. __Default: TEN.Effects.ParticleAnimationType.LOOP__ - // @tfield[opt] float frameRate The framerate with which the particle will be animated. __Default: 1__ - - static void EmitAdvancedParticle(sol::table ParticleData) + // @tfield Vec3 pos World position. + // @tfield Vec3 vel Directional velocity in world units per second. + // @tfield[opt] Objects.ObjID.SpriteConstants spriteSeqID Sprite sequence slot ID. __default: Objects.ObjID.DEFAULT_SPRITES__ + // @tfield[opt] int spriteID Sprite ID in the sprite sequence slot. __default: 0__ + // @tfield[opt] float life Lifespan in seconds. __default: 2__ + // @tfield[opt] float maxYVel Maximum vertical velocity in world units per second. __default: 0__ + // @tfield[opt] float gravity Effect of gravity in world units per second. Positive value ascend, negative value descend. __default: 0__ + // @tfield[opt] float friction Friction affecting velocity over time in world units per second. __default: 0__ + // @tfield[opt] float startRot Rotation at start of life. __default: random__ + // @tfield[opt] float rotVel Rotational velocity in degrees per second. __default: 0__ + // @tfield[opt] float startSize Size at start of life. __default: 10__ + // @tfield[opt] float endSize Size at end of life. __default: 0__ + // @tfield[opt] Color startColor Color at start of life. __default: Color(255, 255, 255)__ + // @tfield[opt] Color endColor Color at end of life. Note that this will finish long before the end of life due to internal math. __default: Color(255, 255, 255)__ + // @tfield[opt] Effects.BlendID blendMode Render blend mode. __default: TEN.Effects.BlendID.ALPHA_BLEND__ + // @tfield[opt] bool damage Harm the player on collision. __default: false__ + // @tfield[opt] bool poison Poison the player on collision. __default: false__ + // @tfield[opt] bool burn Burn the player on collision. __default: false__ + // @tfield[opt] bool wind Affect position by wind in outside rooms. __default: false__ + // @tfield[opt] int damageHit Player damage amount on collision. __default: 2__ + // @tfield[opt] bool light Emit a colored light. CAUTION: Recommended only for a single particle. Too many particles with lights can overwhelm the lighting system. __default: false__ + // @tfield[opt] int lightRadius Light radius in 1/4 blocks. __default: 0__ + // @tfield[opt] int lightFlicker Interval at which the light should flicker. __default: 0__ + // @tfield[opt] int soundID Sound ID to play. CAUTION: Recommended only for a single particle. Too many particles with sounds can overwhelm the sound system. __default: none__ + // @tfield[opt] bool animated Play animates sprite sequence. __default: false__ + // @tfield[opt] Effects.ParticleAnimationType animType Animation type of the sprite sequence. __default: TEN.Effects.ParticleAnimationType.LOOP__ + // @tfield[opt] float frameRate Sprite sequence animation framerate. __default: 1__ + static void EmitAdvancedParticle(const sol::table& table) { constexpr auto DEFAULT_START_SIZE = 10.0f; - constexpr auto DEFAULT_LIFE = 2.0f; - constexpr auto SECS_PER_FRAME = 1.0f / (float)FPS; + constexpr auto DEFAULT_LIFE = 2.0f; - auto convertedSpriteSeqID = ParticleData.get_or("spriteSeqID", ID_DEFAULT_SPRITES); + auto convertedSpriteSeqID = table.get_or("spriteSeqID", ID_DEFAULT_SPRITES); if (!CheckIfSlotExists(convertedSpriteSeqID, "EmitParticle() script function.")) return; @@ -301,106 +299,105 @@ namespace TEN::Scripting::Effects part.on = true; part.SpriteSeqID = convertedSpriteSeqID; - part.SpriteID = ParticleData.get_or("spriteID", 0); + part.SpriteID = table.get_or("spriteID", 0); - auto bMode = ParticleData.get_or("blendMode", BlendMode::AlphaBlend); + auto bMode = table.get_or("blendMode", BlendMode::AlphaBlend); part.blendMode = bMode; - Vec3 pos = ParticleData["position"]; + auto pos = (Vec3)table["pos"]; part.x = pos.x; part.y = pos.y; part.z = pos.z; - part.roomNumber = FindRoomNumber(Vector3i(pos.x, pos.y, pos.z)); + part.roomNumber = FindRoomNumber(pos.ToVector3i()); - Vec3 vel = ParticleData["velocity"]; + auto vel = ((Vec3)table["vel"]) / (float)FPS; part.xVel = short(vel.x * 32); part.yVel = short(vel.y * 32); part.zVel = short(vel.z * 32); - float rotAdd = ParticleData.get_or("rotationSpeed", 0.0f); - float rotAng = ParticleData.get_or("startRotation", TO_DEGREES(Random::GenerateAngle())); - part.rotAng = ANGLE(rotAng) >> 4; - part.rotAdd = ANGLE(rotAdd) >> 4; + float startRot = table.get_or("startRot", TO_DEGREES(Random::GenerateAngle())); + float rotVel = table.get_or("rotVel", 0.0f) / (float)FPS; + part.rotAng = ANGLE(startRot) >> 4; + part.rotAdd = ANGLE(rotVel) >> 4; part.sSize = - part.size = ParticleData.get_or("startSize", DEFAULT_START_SIZE); - part.dSize = ParticleData.get_or("endSize", 0.0f); + part.size = table.get_or("startSize", DEFAULT_START_SIZE); + part.dSize = table.get_or("endSize", 0.0f); part.scalar = 2; - part.gravity = (short)std::clamp((float) ParticleData.get_or("gravity", 0.0f), (float)SHRT_MIN, (float)SHRT_MAX); - part.friction = ParticleData.get_or("friction", 0); - part.maxYvel = ParticleData.get_or("maxYVelocity", 0); + part.gravity = (short)(std::clamp(table.get_or("gravity", 0.0f), SHRT_MIN, SHRT_MAX) / (float)FPS); + part.friction = table.get_or("friction", 0.0f) / (float)FPS; + part.maxYvel = table.get_or("maxYVel", 0.0f) / (float)FPS; - auto convertedStartColor = ParticleData.get_or("startColor", ScriptColor(255, 255, 255)); + auto convertedStartColor = table.get_or("startColor", ScriptColor(255, 255, 255)); part.sR = convertedStartColor.GetR(); part.sG = convertedStartColor.GetG(); part.sB = convertedStartColor.GetB(); - auto convertedEndColor = ParticleData.get_or("endColor", ScriptColor(255, 255, 255)); + auto convertedEndColor = table.get_or("endColor", ScriptColor(255, 255, 255)); part.dR = convertedEndColor.GetR(); part.dG = convertedEndColor.GetG(); part.dB = convertedEndColor.GetB(); - float convertedLife = std::max(0.1f, (float) ParticleData.get_or("lifetime", DEFAULT_LIFE)); + float convertedLife = std::max(0.1f, (float)table.get_or("life", DEFAULT_LIFE)); part.life = - part.sLife = (int)round(convertedLife / SECS_PER_FRAME); + part.sLife = (int)round(convertedLife / (1.0f / (float)FPS)); part.colFadeSpeed = part.life / 2; part.fadeToBlack = part.life / 3; part.flags = SP_SCALE | SP_ROTATE | SP_DEF | SP_EXPDEF; - part.damage = ParticleData.get_or("damageHit", 2); + part.damage = table.get_or("damageHit", 2); - bool convertedApplyPoison = ParticleData.get_or("poison", false); + bool convertedApplyPoison = table.get_or("poison", false); if (convertedApplyPoison) part.flags |= SP_POISON; - bool convertedApplyDamage = ParticleData.get_or("damage", false); + bool convertedApplyDamage = table.get_or("damage", false); if (convertedApplyDamage) part.flags |= SP_DAMAGE; - bool convertedApplyBurn = ParticleData.get_or("burn", false); + bool convertedApplyBurn = table.get_or("burn", false); if (convertedApplyBurn) part.flags |= SP_FIRE; - int convertedApplySound = ParticleData.get_or("sound", -1); - if (convertedApplySound > 0) + int convertedSoundID = table.get_or("sound", NO_VALUE); + if (convertedSoundID != NO_VALUE) { part.flags |= SP_SOUND; - part.sound = convertedApplySound; + part.sound = convertedSoundID; } - bool convertedApplyLight = ParticleData.get_or("light", false); + bool convertedApplyLight = table.get_or("light", false); if (convertedApplyLight) { part.flags |= SP_LIGHT; - int lightRadius = ParticleData.get_or("lightRadius", 0); + int lightRadius = table.get_or("lightRadius", 0); part.lightRadius = lightRadius * BLOCK(0.25f); - int flicker = ParticleData.get_or("lightFlicker", 0); + int flicker = table.get_or("lightFlicker", 0); if (flicker > 0) { - part.lightFlicker = ParticleData.get_or("lightFlicker", 0); - part.lightFlickerS = ParticleData.get_or("lightFlicker", 0); + part.lightFlicker = table.get_or("lightFlicker", 0); + part.lightFlickerS = table.get_or("lightFlicker", 0); } } - bool animatedSpr = ParticleData.get_or("animated", false); + bool animatedSpr = table.get_or("animated", false); if (animatedSpr) { - ParticleAnimType applyAnim = ParticleData.get_or("animationType", ParticleAnimType::Loop); - float applyFramerate = ParticleData.get_or("frameRate", 1.0f); + auto applyAnim = (ParticleAnimType)table.get_or("animType", ParticleAnimType::Loop); + float applyFramerate = table.get_or("frameRate", 1.0f); part.flags |= SP_ANIMATED; part.framerate = applyFramerate; part.animationType = ParticleAnimType(std::clamp(int(applyAnim), int(ParticleAnimType::None), int(ParticleAnimType::LifetimeSpread))); } - bool convertedApplyWind = ParticleData.get_or("wind", false); + bool convertedApplyWind = table.get_or("wind", false); if (convertedApplyWind) { if (TestEnvironment(RoomEnvFlags::ENV_FLAG_WIND, part.roomNumber)) part.flags |= SP_WIND; } - } /// Emit a shockwave, similar to that seen when a harpy projectile hits something. @@ -413,7 +410,6 @@ namespace TEN::Scripting::Effects // @tparam int speed (default 50) Initial speed of the shockwave's expansion (the shockwave will always slow as it goes) // @tparam int angle (default 0) Angle about the X axis - a value of 90 will cause the shockwave to be entirely vertical // @tparam bool hurtsLara (default false) If true, the shockwave will hurt Lara, with the damage being relative to the shockwave's current speed - static void EmitShockwave(Vec3 pos, TypeOrNil innerRadius, TypeOrNil outerRadius, TypeOrNil col, TypeOrNil lifetime, TypeOrNil speed, TypeOrNil angle, TypeOrNil hurtPlayer) { @@ -452,7 +448,6 @@ namespace TEN::Scripting::Effects // @tparam[opt] int radius measured in "clicks" or 256 world units (default 20) // @tparam[opt] bool shadows determines whether light should generate dynamic shadows for applicable moveables (default is false) // @tparam[opt] string name if provided, engine will interpolate this light for high framerate mode (be careful not to use same name for different lights) - static void EmitLight(Vec3 pos, TypeOrNil col, TypeOrNil radius, TypeOrNil castShadows, TypeOrNil name) { auto color = ValueOr(col, ScriptColor(255, 255, 255)); @@ -471,7 +466,6 @@ namespace TEN::Scripting::Effects // @tparam[opt] int distance distance, at which light cone fades out, measured in "clicks" (default 20) // @tparam[opt] bool shadows determines whether light should generate dynamic shadows for applicable moveables (default is false) // @tparam[opt] string name if provided, engine will interpolate this light for high framerate mode (be careful not to use same name for different lights) - static void EmitSpotLight(Vec3 pos, Vec3 dir, TypeOrNil col, TypeOrNil radius, TypeOrNil falloff, TypeOrNil distance, TypeOrNil castShadows, TypeOrNil name) { auto color = ValueOr(col, ScriptColor(255, 255, 255)); @@ -485,7 +479,6 @@ namespace TEN::Scripting::Effects // @function EmitBlood // @tparam Vec3 pos // @tparam int count Sprite count. __default: 1__ - static void EmitBlood(const Vec3& pos, TypeOrNil count) { TriggerBlood(pos.x, pos.y, pos.z, -1, ValueOr(count, 1)); @@ -496,7 +489,6 @@ namespace TEN::Scripting::Effects // @tparam Vec3 pos World position where the effect will be spawned. Must be in a water room. // @tparam[opt] float size Sprite size. __Default: 32__ // @tparam[opt] float amp Oscillation amplitude. __Default: 32__ - static void EmitAirBubble(const Vec3& pos, TypeOrNil size, TypeOrNil amp) { constexpr auto DEFAULT_SIZE = 128.0f; @@ -511,11 +503,10 @@ namespace TEN::Scripting::Effects /// Emit fire for one frame. Will not hurt player. Call this each frame if you want a continuous fire. // @function EmitFire // @tparam Vec3 pos - // @tparam float size (default 1.0) - + // @tparam float size Fire size. __default: 1__ static void EmitFire(const Vec3& pos, TypeOrNil size) { - AddFire(pos.x, pos.y, pos.z, FindRoomNumber(Vector3i(pos.x, pos.y, pos.z)), ValueOr(size, 1)); + AddFire(pos.x, pos.y, pos.z, FindRoomNumber(pos.ToVector3i()), ValueOr(size, 1)); } /// Make an explosion. Does not hurt Lara @@ -523,7 +514,6 @@ namespace TEN::Scripting::Effects // @tparam Vec3 pos // @tparam float size (default 512.0) this will not be the size of the sprites, but rather the distance between the origin and any additional sprites // @tparam bool shockwave (default false) if true, create a very faint white shockwave which will not hurt Lara - static void MakeExplosion(Vec3 pos, TypeOrNil size, TypeOrNil shockwave) { TriggerExplosion(Vector3(pos.x, pos.y, pos.z), ValueOr(size, 512.0f), true, false, ValueOr(shockwave, false), FindRoomNumber(Vector3i(pos.x, pos.y, pos.z))); @@ -532,7 +522,6 @@ namespace TEN::Scripting::Effects /// Make an earthquake // @function MakeEarthquake // @tparam int strength (default 100) How strong should the earthquake be? Increasing this value also increases the lifespan of the earthquake. - static void Earthquake(TypeOrNil strength) { int str = ValueOr(strength, 100); @@ -543,32 +532,31 @@ namespace TEN::Scripting::Effects // This represents the 3D displacement applied by the engine on things like particles affected by wind. // @function GetWind() // @treturn Vec3 Wind vector. - static Vec3 GetWind() { return Vec3(Weather.Wind()); } -/// Emit an extending streamer effect. -// @function EmitStreamer -// @tparam Moveable mov Moveable object with which to associate the effect. -// @tparam int[opt] tag Numeric tag with which to associate the effect on the moveable. __Default: 0__ -// @tparam Vec3 pos World position. -// @tparam Vec3 dir Direction vector of movement velocity. -// @tparam[opt] float rot Start rotation in degrees. __Default: 0__ -// @tparam[opt] Color startColor Color at the start of life. __Default: Color(255, 255, 255, 255))__ -// @tparam[opt] Color endColor Color at the end of life. __Default: Color(0, 0, 0, 0))__ -// @tparam[opt] float width Width in world units. __Default: 0__ -// @tparam[opt] float life Lifetime in seconds. __Default: 1__ -// @tparam[opt] float vel Movement velocity in world units per second. __Default: 0__ -// @tparam[opt] float expRate Width expansion rate in world units per second. __Default: 0__ -// @tparam[opt] float rotRate Rotation rate in degrees per second. __Default: 0__ -// @tparam[opt] Effects.StreamerFeatherMode edgeFeatherMode Edge feather mode. __Default: Effects.FeatherID.NONE__ -// @tparam[opt] Effects.StreamerFeatherMode lengthFeatherMode Length feather mode. __Not implemented yet.__ -// @tparam[opt] Effects.BlendID blendID Renderer blend ID. __Default: Effects.BlendID.ALPHA_BLEND__ + /// Emit an extending streamer effect. + // @function EmitStreamer + // @tparam Moveable mov Moveable object with which to associate the effect. + // @tparam int[opt] tag Numeric tag with which to associate the effect on the moveable. __Default: 0__ + // @tparam Vec3 pos World position. + // @tparam Vec3 dir Direction vector of movement velocity. + // @tparam[opt] float rot Start rotation in degrees. __Default: 0__ + // @tparam[opt] Color startColor Color at the start of life. __Default: Color(255, 255, 255, 255))__ + // @tparam[opt] Color endColor Color at the end of life. __Default: Color(0, 0, 0, 0))__ + // @tparam[opt] float width Width in world units. __Default: 0__ + // @tparam[opt] float life Lifetime in seconds. __Default: 1__ + // @tparam[opt] float vel Movement velocity in world units per second. __Default: 0__ + // @tparam[opt] float expRate Width expansion rate in world units per second. __Default: 0__ + // @tparam[opt] float rotRate Rotation rate in degrees per second. __Default: 0__ + // @tparam[opt] Effects.StreamerFeatherMode edgeFeatherMode Edge feather mode. __Default: Effects.FeatherID.NONE__ + // @tparam[opt] Effects.StreamerFeatherMode lengthFeatherMode Length feather mode. __UNIMPLEMENTED, currently will always leave a fading tail__ + // @tparam[opt] Effects.BlendID blendID Renderer blend ID. __Default: Effects.BlendID.ALPHA_BLEND__ static void EmitStreamer(const Moveable& mov, TypeOrNil tag, const Vec3& pos, const Vec3& dir, TypeOrNil rot, TypeOrNil startColor, TypeOrNil endColor, - TypeOrNil width, TypeOrNil life, TypeOrNil vel, TypeOrNil expRate, TypeOrNil rotRate, - TypeOrNil edgeFeatherMode, TypeOrNil lengthFeatherMode, TypeOrNil blendID) + TypeOrNil width, TypeOrNil life, TypeOrNil vel, TypeOrNil expRate, TypeOrNil rotRate, + TypeOrNil edgeFeatherMode, TypeOrNil lengthFeatherMode, TypeOrNil blendID) { int movID = mov.GetIndex(); int convertedTag = ValueOr(tag, 0); @@ -585,13 +573,13 @@ namespace TEN::Scripting::Effects auto convertedRotRate = ANGLE(ValueOr(rotRate, 0.0f) / (float)FPS); auto convertedEdgeFeatherID = ValueOr(edgeFeatherMode, StreamerFeatherMode::None); - auto convertedLengthFeatherID = ValueOr(lengthFeatherMode, StreamerFeatherMode::None); + auto convertedLengthFeatherID = ValueOr(lengthFeatherMode, StreamerFeatherMode::Left); auto convertedBlendID = ValueOr(blendID, BlendMode::AlphaBlend); StreamerEffect.Spawn( movID, convertedTag, convertedPos, convertedDir, convertedRot, convertedStartColor, convertedEndColor, convertedWidth, convertedLife, convertedVel, convertedExpRate, convertedRotRate, - convertedEdgeFeatherID, convertedBlendID); + convertedEdgeFeatherID, /*convertedLengthFeatherID, */convertedBlendID); } void Register(sol::state* state, sol::table& parent) From 8bbc2df8eb97031206da4373a0aa7ba8e8e0073f Mon Sep 17 00:00:00 2001 From: Sezz Date: Sat, 15 Mar 2025 18:06:04 +1100 Subject: [PATCH 072/160] Update EffectsFunctions.cpp --- .../Scripting/Internal/TEN/Effects/EffectsFunctions.cpp | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp b/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp index db1c25834..d65853268 100644 --- a/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp +++ b/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp @@ -247,7 +247,7 @@ namespace TEN::Scripting::Effects // poison = false, // burn = false, // damageHit = 80, - // sound = 197, + // soundID = 197, // light = true, // lightRadius = 6, // lightFlicker = 5, @@ -361,7 +361,7 @@ namespace TEN::Scripting::Effects if (convertedApplyBurn) part.flags |= SP_FIRE; - int convertedSoundID = table.get_or("sound", NO_VALUE); + int convertedSoundID = table.get_or("soundID", NO_VALUE); if (convertedSoundID != NO_VALUE) { part.flags |= SP_SOUND; From f2d7044dfb56e579081baadd9c80c8dbe6dacd77 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 15 Mar 2025 08:42:25 +0100 Subject: [PATCH 073/160] Bypass rendering for objects and statics with near-zero transparency --- TombEngine/Renderer/RendererFrame.cpp | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/TombEngine/Renderer/RendererFrame.cpp b/TombEngine/Renderer/RendererFrame.cpp index 065504723..6fddadff9 100644 --- a/TombEngine/Renderer/RendererFrame.cpp +++ b/TombEngine/Renderer/RendererFrame.cpp @@ -403,6 +403,9 @@ namespace TEN::Renderer if (item.Status == ITEM_INVISIBLE) continue; + if (item.Model.Color.w < EPSILON) + continue; + if (item.ObjectNumber == ID_LARA && (SpotcamOverlay || SpotcamDontDrawLara)) continue; @@ -524,6 +527,9 @@ namespace TEN::Renderer if (!(nativeMesh->flags & StaticMeshFlags::SM_VISIBLE)) continue; + if (nativeMesh->color.w < EPSILON) + continue; + if (!_staticObjects[Statics.GetIndex(mesh->ObjectNumber)].has_value()) continue; From edf3fbf68f75a2bd3cd30e49797e65a943d1fb94 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 15 Mar 2025 10:51:59 +0100 Subject: [PATCH 074/160] Added script API methods for static mesh collision --- CHANGELOG.md | 3 +- Documentation/doc/1 modules/Effects.html | 2 +- .../doc/2 classes/Objects.Static.html | 51 +++++++++++++++++++ TombEngine/Game/collision/collide_item.cpp | 9 ++++ TombEngine/Game/control/los.cpp | 4 ++ TombEngine/Game/room.h | 5 +- .../Scripting/Internal/ReservedScriptNames.h | 2 + .../TEN/Objects/Static/StaticObject.cpp | 25 +++++++++ .../TEN/Objects/Static/StaticObject.h | 2 + 9 files changed, 99 insertions(+), 4 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 270e4aa5d..4a0b7ac08 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -45,7 +45,8 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added `Effects.EmitStreamer` function to emit streamers. * Added `Flow.GetTotalSecretCount` function to get total amount of secrets in the game. * Added `View.GetFlyByPosition` and `View.GetFlyByRotation` functions to get flyby sequence parameters at a specified time point. -* Added `Moveable:GetScale` and `Movebale:SetScale` methods to set visible scale of moveables. +* Added `Moveable:GetScale` and `Movebale:SetScale` methods to get or set visible scale of moveables. +* Added `Static:GetCollidable` and `Static:SetCollidable` methods to get or set collision status of static meshes. * Added `Rotation:Lerp` function to allow linear interpolation between rotations. * Added ability to perform additive and subtractive operations on `Rotation` class and compare one `Rotation` to another. * Added various `Translate` methods to `Vec2` and `Vec3` script objects. diff --git a/Documentation/doc/1 modules/Effects.html b/Documentation/doc/1 modules/Effects.html index 24f9a971a..45b15294c 100644 --- a/Documentation/doc/1 modules/Effects.html +++ b/Documentation/doc/1 modules/Effects.html @@ -390,7 +390,7 @@ poison = false, burn = false, damageHit = 80, - sound = 197, + soundID = 197, light = true, lightRadius = 6, lightFlicker = 5, diff --git a/Documentation/doc/2 classes/Objects.Static.html b/Documentation/doc/2 classes/Objects.Static.html index a8009b0a2..5259af90f 100644 --- a/Documentation/doc/2 classes/Objects.Static.html +++ b/Documentation/doc/2 classes/Objects.Static.html @@ -156,6 +156,10 @@
    • + + + + @@ -192,6 +196,10 @@ + + + + @@ -379,6 +387,27 @@ + +
    + + Static:GetCollidable() +
    +
    + Get this static's collision status. + + + + +

    Returns:

    +
      + + bool + Collision status. true: can be collided with, false: no collision +
    + + + +
    @@ -576,6 +605,28 @@ + +
    + + Static:SetCollidable(collidable) +
    +
    + Set this static's collision status. + + + +

    Parameters:

    +
      +
    • collidable + bool + New collision status. true: can be collided with, false: no collision +
      • +
    + + + + +
    diff --git a/TombEngine/Game/collision/collide_item.cpp b/TombEngine/Game/collision/collide_item.cpp index 1e9dc1ca2..42af317b6 100644 --- a/TombEngine/Game/collision/collide_item.cpp +++ b/TombEngine/Game/collision/collide_item.cpp @@ -946,6 +946,10 @@ void CollideSolidStatics(ItemInfo* item, CollisionInfo* coll) if (!(mesh.flags & StaticMeshFlags::SM_VISIBLE)) continue; + // Bypass static meshes which are marked as non-collidable. + if (!(mesh.flags & StaticMeshFlags::SM_COLLISION)) + continue; + // Only process meshes which are solid, or if solid mode is set by the setup. if (!coll->Setup.ForceSolidStatics && !(mesh.flags & StaticMeshFlags::SM_SOLID)) continue; @@ -1894,9 +1898,14 @@ void DoObjectCollision(ItemInfo* item, CollisionInfo* coll) for (auto& staticObject : neighborRoom.mesh) { + // Check if static is visible. if (!(staticObject.flags & StaticMeshFlags::SM_VISIBLE)) continue; + // Check if static is collidable. + if (!(staticObject.flags & StaticMeshFlags::SM_COLLISION)) + continue; + // For Lara, solid static mesh collisions are directly managed by GetCollisionInfo, // so we bypass them here to avoid interference. if (isPlayer && (staticObject.flags & StaticMeshFlags::SM_SOLID)) diff --git a/TombEngine/Game/control/los.cpp b/TombEngine/Game/control/los.cpp index 861b92bb4..3f1c0b2ab 100644 --- a/TombEngine/Game/control/los.cpp +++ b/TombEngine/Game/control/los.cpp @@ -705,6 +705,10 @@ std::optional GetStaticObjectLos(const Vector3& origin, int roomNumber, if (!(staticObject.flags & StaticMeshFlags::SM_VISIBLE)) continue; + // Check if static is collidable. + if (!(staticObject.flags & StaticMeshFlags::SM_COLLISION)) + continue; + // Check if static is solid (if applicable). if (onlySolid && !(staticObject.flags & StaticMeshFlags::SM_SOLID)) continue; diff --git a/TombEngine/Game/room.h b/TombEngine/Game/room.h index eec49f807..a43e2c428 100644 --- a/TombEngine/Game/room.h +++ b/TombEngine/Game/room.h @@ -37,8 +37,9 @@ enum RoomEnvFlags enum StaticMeshFlags : short { - SM_VISIBLE = 1, - SM_SOLID = 2 + SM_VISIBLE = (1 << 0), + SM_SOLID = (1 << 1), + SM_COLLISION = (1 << 2) }; struct ROOM_VERTEX diff --git a/TombEngine/Scripting/Internal/ReservedScriptNames.h b/TombEngine/Scripting/Internal/ReservedScriptNames.h index c3307b918..c21c3f3e3 100644 --- a/TombEngine/Scripting/Internal/ReservedScriptNames.h +++ b/TombEngine/Scripting/Internal/ReservedScriptNames.h @@ -474,6 +474,7 @@ constexpr char ScriptReserved_StaticGetPosition[] = "GetPosition"; constexpr char ScriptReserved_StaticGetRotation[] = "GetRotation"; constexpr char ScriptReserved_StaticGetScale[] = "GetScale"; constexpr char ScriptReserved_StaticGetSlot[] = "GetSlot"; +constexpr char ScriptReserved_StaticGetCollidable[] = "GetCollidable"; constexpr char ScriptReserved_StaticGetSolid[] = "GetSolid"; constexpr char ScriptReserved_StaticSetColor[] = "SetColor"; constexpr char ScriptReserved_StaticSetHitPoints[] = "SetHP"; @@ -483,6 +484,7 @@ constexpr char ScriptReserved_StaticSetRotation[] = "SetRotation"; constexpr char ScriptReserved_StaticSetScale[] = "SetScale"; constexpr char ScriptReserved_StaticSetSlot[] = "SetSlot"; constexpr char ScriptReserved_StaticSetSolid[] = "SetSolid"; +constexpr char ScriptReserved_StaticSetCollidable[] = "SetCollidable"; constexpr char ScriptReserved_StaticShatter[] = "Shatter"; // ===== diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Static/StaticObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Static/StaticObject.cpp index ff42fdbf0..c2fd4ddbb 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/Static/StaticObject.cpp +++ b/TombEngine/Scripting/Internal/TEN/Objects/Static/StaticObject.cpp @@ -38,6 +38,7 @@ namespace TEN::Scripting ScriptReserved_StaticGetColor, &Static::GetColor, ScriptReserved_StaticGetHP, &Static::GetHitPoints, // TODO: Deprecate. ScriptReserved_StaticGetActive, &Static::GetActiveStatus, // TODO: Deprecate. Rename Lua func to GetActiveStatus. + ScriptReserved_StaticGetCollidable, &Static::GetCollidable, ScriptReserved_StaticGetSolid, &Static::GetSolidStatus, // TODO: Deprecate. Rename Lua func to GetSolidStatus. ScriptReserved_StaticSetName, &Static::SetName, @@ -47,6 +48,7 @@ namespace TEN::Scripting ScriptReserved_StaticSetScale, &Static::SetScale, ScriptReserved_StaticSetColor, &Static::SetColor, ScriptReserved_StaticSetHitPoints, &Static::SetHitPoints, // TODO: Deprecate. Rename Lua func to SetHitPoints. + ScriptReserved_StaticSetCollidable, &Static::SetCollidable, ScriptReserved_StaticSetSolid, &Static::SetSolidStatus, // TODO: Deprecate. Rename Lua func to SetSolidStatus. ScriptReserved_StaticEnable, &Static::Enable, @@ -123,6 +125,14 @@ namespace TEN::Scripting return ((_static.flags & StaticMeshFlags::SM_VISIBLE) != 0); } + /// Get this static's collision status. + // @function Static:GetCollidable + // @treturn bool Collision status. __true: can be collided with__, __false: no collision__ + bool Static::GetCollidable() const + { + return ((_static.flags & StaticMeshFlags::SM_COLLISION) != 0); + } + /// Get this static's solid collision status. // @function Static:GetSolid // @treturn bool Solid Status. __true: solid__, __false: soft__ @@ -219,6 +229,21 @@ namespace TEN::Scripting } } + /// Set this static's collision status. + // @function Static:SetCollidable + // @tparam bool collidable New collision status. __true: can be collided with__, __false: no collision__ + void Static::SetCollidable(bool collidable) + { + if (collidable) + { + _static.flags |= StaticMeshFlags::SM_COLLISION; + } + else + { + _static.flags &= ~StaticMeshFlags::SM_COLLISION; + } + } + /// Enable this static. Used when previously shattered disabled manually. // @function Static:Enable void Static::Enable() diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Static/StaticObject.h b/TombEngine/Scripting/Internal/TEN/Objects/Static/StaticObject.h index 82123db6a..33906b8da 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/Static/StaticObject.h +++ b/TombEngine/Scripting/Internal/TEN/Objects/Static/StaticObject.h @@ -45,6 +45,7 @@ namespace TEN::Scripting ScriptColor GetColor() const; int GetHitPoints() const; bool GetActiveStatus() const; + bool GetCollidable() const; bool GetSolidStatus() const; // Setters @@ -56,6 +57,7 @@ namespace TEN::Scripting void SetScale(float scale); void SetColor(const ScriptColor& color); void SetHitPoints(int hitPoints); + void SetCollidable(bool status); void SetSolidStatus(bool status); // Utilities From 33dd1461adfbdb289ab1304cbc033a914286594e Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 15 Mar 2025 16:27:57 +0100 Subject: [PATCH 075/160] Change fog distance data type to float --- .../doc/3 primitive classes/Flow.Fog.html | 12 ++++---- .../ConstantBuffers/CameraMatrixBuffer.h | 4 +-- TombEngine/Renderer/RendererDraw.cpp | 2 +- .../Scripting/Include/ScriptInterfaceLevel.h | 4 +-- .../Scripting/Internal/TEN/Flow/Fog/Fog.cpp | 10 +++---- .../Scripting/Internal/TEN/Flow/Fog/Fog.h | 6 ++-- .../Internal/TEN/Flow/Level/FlowLevel.cpp | 4 +-- .../Internal/TEN/Flow/Level/FlowLevel.h | 4 +-- TombEngine/Shaders/CBCamera.hlsli | 4 +-- .../flatbuffers/ten_savegame_generated.h | 28 +++++++++---------- .../Specific/savegame/schema/ten_savegame.fbs | 4 +-- 11 files changed, 41 insertions(+), 41 deletions(-) diff --git a/Documentation/doc/3 primitive classes/Flow.Fog.html b/Documentation/doc/3 primitive classes/Flow.Fog.html index f8dd36f4d..d3f8f6297 100644 --- a/Documentation/doc/3 primitive classes/Flow.Fog.html +++ b/Documentation/doc/3 primitive classes/Flow.Fog.html @@ -127,11 +127,11 @@
    - + - +
    EmitLightningArc(src, dest, color, lifetime, amplitude, beamWidth, detail, smooth, endDrift)EmitLightningArc(origin, target, color, life, amplitude, beamWidth, detail, smooth, endDrift) Emit a lightning arc.
    EmitParticle(pos, vel, spriteID, gravity, rotVel, startColor, endColor, blendMode, startSize, endSize, life, applyDamage, applyPoison, spriteSeqID, startRot)EmitParticle(pos, vel, spriteID, gravity, rotVel, startColor, endColor, blendMode, startSize, endSize, life, damage, poison, spriteSeqID, startRot) Emit a particle.
    EmitAdvancedParticle(ParticleData)Emit a particle with extensive configuration options including animations.Emit a particle with extensive configuration options, including sprite sequence animation, lights, sounds, and damage effects.
    EmitShockwave(pos, innerRadius, outerRadius, color, lifetime, speed, angle, hurtsLara)Get this static's visibility status.
    Static:GetCollidable()Get this static's collision status.
    Static:GetSolid() Get this static's solid collision status.
    Set this static's solid collision status.
    Static:SetCollidable(collidable)Set this static's collision status.
    Static:Enable() Enable this static.
    minDistance(int) Minimum distance.(float) Minimum distance.
    maxDistance(int) Maximum distance.(float) Maximum distance.

    Functions

    @@ -171,8 +171,8 @@ minDistance
    - (int) Minimum distance. - This is the distance at which the fog starts. + (float) Minimum distance. + This is the distance at which the fog starts (in sectors). @@ -187,8 +187,8 @@ maxDistance
    - (int) Maximum distance. - This is the distance at which the fog reaches the maximum strength. + (float) Maximum distance. + This is the distance at which the fog reaches the maximum strength (in sectors). diff --git a/TombEngine/Renderer/ConstantBuffers/CameraMatrixBuffer.h b/TombEngine/Renderer/ConstantBuffers/CameraMatrixBuffer.h index 9be9b953b..2ededb96b 100644 --- a/TombEngine/Renderer/ConstantBuffers/CameraMatrixBuffer.h +++ b/TombEngine/Renderer/ConstantBuffers/CameraMatrixBuffer.h @@ -37,8 +37,8 @@ namespace TEN::Renderer::ConstantBuffers //-- Vector4 FogColor; //-- - int FogMinDistance; - int FogMaxDistance; + float FogMinDistance; + float FogMaxDistance; float NearPlane; float FarPlane; //-- diff --git a/TombEngine/Renderer/RendererDraw.cpp b/TombEngine/Renderer/RendererDraw.cpp index 1c7a8d52d..98e29e66f 100644 --- a/TombEngine/Renderer/RendererDraw.cpp +++ b/TombEngine/Renderer/RendererDraw.cpp @@ -1830,7 +1830,7 @@ namespace TEN::Renderer } else { - cameraConstantBuffer.FogMaxDistance = 0; + cameraConstantBuffer.FogMaxDistance = 0.0f; cameraConstantBuffer.FogColor = Vector4::Zero; } diff --git a/TombEngine/Scripting/Include/ScriptInterfaceLevel.h b/TombEngine/Scripting/Include/ScriptInterfaceLevel.h index e091044b0..67d976b63 100644 --- a/TombEngine/Scripting/Include/ScriptInterfaceLevel.h +++ b/TombEngine/Scripting/Include/ScriptInterfaceLevel.h @@ -38,8 +38,8 @@ public: virtual WeatherType GetWeatherType() const = 0; virtual RGBAColor8Byte GetSkyLayerColor(int index) const = 0; virtual RGBAColor8Byte GetFogColor() const = 0; - virtual short GetFogMinDistance() const = 0; - virtual short GetFogMaxDistance() const = 0; + virtual float GetFogMinDistance() const = 0; + virtual float GetFogMaxDistance() const = 0; virtual short GetFarView() const = 0; virtual int GetSecrets() const = 0; virtual std::string GetAmbientTrack() const = 0; diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp index bb7612114..b269ff2cb 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp @@ -23,13 +23,13 @@ void Fog::Register(sol::table& parent) // @mem color "color", sol::property(&Fog::GetColor, &Fog::SetColor), - /// (int) Minimum distance. - // This is the distance at which the fog starts. + /// (float) Minimum distance. + // This is the distance at which the fog starts (in sectors). // @mem minDistance "minDistance", &Fog::MinDistance, - /// (int) Maximum distance. - // This is the distance at which the fog reaches the maximum strength. + /// (float) Maximum distance. + // This is the distance at which the fog reaches the maximum strength (in sectors). // @mem maxDistance "maxDistance", &Fog::MaxDistance ); @@ -42,7 +42,7 @@ void Fog::Register(sol::table& parent) @treturn Fog A fog object. @function Fog */ -Fog::Fog(ScriptColor const& col, short minDistance, short maxDistance) +Fog::Fog(ScriptColor const& col, float minDistance, float maxDistance) { SetColor(col); MinDistance = minDistance; diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.h b/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.h index 6958e3041..dc21d7c97 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.h +++ b/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.h @@ -13,11 +13,11 @@ struct Fog byte R{ 0 }; byte G{ 0 }; byte B{ 0 }; - short MinDistance{ 0 }; - short MaxDistance{ 0 }; + float MinDistance{ 0 }; + float MaxDistance{ 0 }; Fog() = default; - Fog(ScriptColor const& color, short minDistance, short maxDistance); + Fog(ScriptColor const& color, float minDistance, float maxDistance); void SetColor(ScriptColor const& color); ScriptColor GetColor() const; diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp index e722650bf..e356bf2b5 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp @@ -224,12 +224,12 @@ RGBAColor8Byte Level::GetFogColor() const return Fog.GetColor(); } -short Level::GetFogMinDistance() const +float Level::GetFogMinDistance() const { return Fog.MinDistance; } -short Level::GetFogMaxDistance() const +float Level::GetFogMaxDistance() const { return Fog.MaxDistance; } diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.h b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.h index 4abfd5c23..dda7e23a1 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.h +++ b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.h @@ -64,8 +64,8 @@ struct Level : public ScriptInterfaceLevel void SetLevelFarView(short val); static void Register(sol::table& parent); WeatherType GetWeatherType() const override; - short GetFogMinDistance() const override; - short GetFogMaxDistance() const override; + float GetFogMinDistance() const override; + float GetFogMaxDistance() const override; short GetFarView() const override; void SetSecrets(int secrets); int GetSecrets() const override; diff --git a/TombEngine/Shaders/CBCamera.hlsli b/TombEngine/Shaders/CBCamera.hlsli index 2c627acb5..34a7709c0 100644 --- a/TombEngine/Shaders/CBCamera.hlsli +++ b/TombEngine/Shaders/CBCamera.hlsli @@ -28,8 +28,8 @@ cbuffer CBCamera : register(b0) //-- float4 FogColor; //-- - int FogMinDistance; - int FogMaxDistance; + float FogMinDistance; + float FogMaxDistance; float NearPlane; float FarPlane; //-- diff --git a/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h b/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h index 6cf572a17..5c8333d07 100644 --- a/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h +++ b/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h @@ -549,8 +549,8 @@ struct LevelDataT : public flatbuffers::NativeTable { int32_t weather_type = 0; float weather_strength = 0.0f; int32_t fog_color = 0; - int32_t fog_min_distance = 0; - int32_t fog_max_distance = 0; + float fog_min_distance = 0.0f; + float fog_max_distance = 0.0f; bool sky_layer_1_enabled = false; int32_t sky_layer_1_color = 0; int32_t sky_layer_1_speed = 0; @@ -633,11 +633,11 @@ struct LevelData FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { int32_t fog_color() const { return GetField(VT_FOG_COLOR, 0); } - int32_t fog_min_distance() const { - return GetField(VT_FOG_MIN_DISTANCE, 0); + float fog_min_distance() const { + return GetField(VT_FOG_MIN_DISTANCE, 0.0f); } - int32_t fog_max_distance() const { - return GetField(VT_FOG_MAX_DISTANCE, 0); + float fog_max_distance() const { + return GetField(VT_FOG_MAX_DISTANCE, 0.0f); } bool sky_layer_1_enabled() const { return GetField(VT_SKY_LAYER_1_ENABLED, 0) != 0; @@ -719,8 +719,8 @@ struct LevelData FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { VerifyField(verifier, VT_WEATHER_TYPE) && VerifyField(verifier, VT_WEATHER_STRENGTH) && VerifyField(verifier, VT_FOG_COLOR) && - VerifyField(verifier, VT_FOG_MIN_DISTANCE) && - VerifyField(verifier, VT_FOG_MAX_DISTANCE) && + VerifyField(verifier, VT_FOG_MIN_DISTANCE) && + VerifyField(verifier, VT_FOG_MAX_DISTANCE) && VerifyField(verifier, VT_SKY_LAYER_1_ENABLED) && VerifyField(verifier, VT_SKY_LAYER_1_COLOR) && VerifyField(verifier, VT_SKY_LAYER_1_SPEED) && @@ -774,11 +774,11 @@ struct LevelDataBuilder { void add_fog_color(int32_t fog_color) { fbb_.AddElement(LevelData::VT_FOG_COLOR, fog_color, 0); } - void add_fog_min_distance(int32_t fog_min_distance) { - fbb_.AddElement(LevelData::VT_FOG_MIN_DISTANCE, fog_min_distance, 0); + void add_fog_min_distance(float fog_min_distance) { + fbb_.AddElement(LevelData::VT_FOG_MIN_DISTANCE, fog_min_distance, 0.0f); } - void add_fog_max_distance(int32_t fog_max_distance) { - fbb_.AddElement(LevelData::VT_FOG_MAX_DISTANCE, fog_max_distance, 0); + void add_fog_max_distance(float fog_max_distance) { + fbb_.AddElement(LevelData::VT_FOG_MAX_DISTANCE, fog_max_distance, 0.0f); } void add_sky_layer_1_enabled(bool sky_layer_1_enabled) { fbb_.AddElement(LevelData::VT_SKY_LAYER_1_ENABLED, static_cast(sky_layer_1_enabled), 0); @@ -871,8 +871,8 @@ inline flatbuffers::Offset CreateLevelData( int32_t weather_type = 0, float weather_strength = 0.0f, int32_t fog_color = 0, - int32_t fog_min_distance = 0, - int32_t fog_max_distance = 0, + float fog_min_distance = 0.0f, + float fog_max_distance = 0.0f, bool sky_layer_1_enabled = false, int32_t sky_layer_1_color = 0, int32_t sky_layer_1_speed = 0, diff --git a/TombEngine/Specific/savegame/schema/ten_savegame.fbs b/TombEngine/Specific/savegame/schema/ten_savegame.fbs index 647c3246d..b4e852148 100644 --- a/TombEngine/Specific/savegame/schema/ten_savegame.fbs +++ b/TombEngine/Specific/savegame/schema/ten_savegame.fbs @@ -15,8 +15,8 @@ table LevelData { weather_strength: float; fog_color: int32; - fog_min_distance: int32; - fog_max_distance: int32; + fog_min_distance: float; + fog_max_distance: float; sky_layer_1_enabled: bool; sky_layer_1_color: int32; From 6b1ca045d0c3aba5135598edd5d35e0fc8be4fd4 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 15 Mar 2025 20:19:13 +0100 Subject: [PATCH 076/160] Update documentation for streamer feather mode --- Documentation/doc/1 modules/Effects.html | 8 ++++---- Documentation/doc/1 modules/Flow.html | 2 +- Documentation/doc/1 modules/Input.html | 2 +- Documentation/doc/1 modules/Inventory.html | 2 +- Documentation/doc/1 modules/Logic.html | 2 +- Documentation/doc/1 modules/Objects.html | 2 +- Documentation/doc/1 modules/Sound.html | 2 +- Documentation/doc/1 modules/Strings.html | 2 +- Documentation/doc/1 modules/Util.html | 2 +- Documentation/doc/1 modules/View.html | 2 +- Documentation/doc/2 classes/Collision.Probe.html | 2 +- Documentation/doc/2 classes/Flow.Level.html | 2 +- Documentation/doc/2 classes/Flow.Settings.html | 2 +- Documentation/doc/2 classes/Flow.Statistics.html | 2 +- Documentation/doc/2 classes/Objects.AIObject.html | 2 +- Documentation/doc/2 classes/Objects.Camera.html | 2 +- .../doc/2 classes/Objects.LaraObject.html | 2 +- Documentation/doc/2 classes/Objects.Moveable.html | 2 +- Documentation/doc/2 classes/Objects.Room.html | 2 +- Documentation/doc/2 classes/Objects.Sink.html | 2 +- .../doc/2 classes/Objects.SoundSource.html | 2 +- Documentation/doc/2 classes/Objects.Static.html | 2 +- Documentation/doc/2 classes/Objects.Volume.html | 2 +- .../doc/2 classes/Strings.DisplayString.html | 2 +- .../doc/2 classes/View.DisplaySprite.html | 2 +- Documentation/doc/3 primitive classes/Color.html | 2 +- .../doc/3 primitive classes/Flow.Fog.html | 2 +- .../doc/3 primitive classes/Flow.Horizon.html | 2 +- .../3 primitive classes/Flow.InventoryItem.html | 2 +- .../doc/3 primitive classes/Flow.LensFlare.html | 2 +- .../doc/3 primitive classes/Flow.SkyLayer.html | 2 +- .../doc/3 primitive classes/Flow.Starfield.html | 2 +- .../doc/3 primitive classes/Rotation.html | 2 +- Documentation/doc/3 primitive classes/Time.html | 2 +- Documentation/doc/3 primitive classes/Vec2.html | 2 +- Documentation/doc/3 primitive classes/Vec3.html | 2 +- .../doc/4 enums/Collision.MaterialType.html | 2 +- Documentation/doc/4 enums/Effects.BlendID.html | 2 +- Documentation/doc/4 enums/Effects.EffectID.html | 2 +- .../doc/4 enums/Effects.ParticleAnimationType.html | 2 +- ...rMode.html => Effects.StreamerFeatherMode.html} | 14 +++++++------- Documentation/doc/4 enums/Flow.ErrorMode.html | 2 +- Documentation/doc/4 enums/Flow.FreezeMode.html | 2 +- Documentation/doc/4 enums/Flow.GameStatus.html | 2 +- Documentation/doc/4 enums/Input.ActionID.html | 2 +- Documentation/doc/4 enums/Objects.AmmoType.html | 2 +- Documentation/doc/4 enums/Objects.HandStatus.html | 2 +- .../doc/4 enums/Objects.MoveableStatus.html | 2 +- Documentation/doc/4 enums/Objects.ObjID.html | 2 +- Documentation/doc/4 enums/Objects.RoomFlagID.html | 2 +- Documentation/doc/4 enums/Objects.RoomReverb.html | 2 +- Documentation/doc/4 enums/Objects.WeaponType.html | 2 +- .../doc/4 enums/Sound.SoundTrackType.html | 2 +- .../doc/4 enums/Strings.DisplayStringOption.html | 2 +- Documentation/doc/4 enums/Util.LogLevel.html | 2 +- Documentation/doc/4 enums/View.AlignMode.html | 2 +- Documentation/doc/4 enums/View.CameraType.html | 2 +- .../doc/4 enums/View.PostProcessMode.html | 2 +- Documentation/doc/4 enums/View.ScaleMode.html | 2 +- .../doc/5 lua utility modules/CustomBar.html | 2 +- Documentation/doc/5 lua utility modules/Diary.html | 2 +- .../doc/5 lua utility modules/EventSequence.html | 2 +- Documentation/doc/5 lua utility modules/Timer.html | 2 +- Documentation/doc/5 lua utility modules/Type.html | 2 +- Documentation/doc/index.html | 4 ++-- .../Internal/TEN/Effects/EffectsFunctions.cpp | 2 +- .../Scripting/Internal/TEN/Effects/FeatherModes.h | 6 +++--- 67 files changed, 79 insertions(+), 79 deletions(-) rename Documentation/doc/4 enums/{Effects.FeatherMode.html => Effects.StreamerFeatherMode.html} (93%) diff --git a/Documentation/doc/1 modules/Effects.html b/Documentation/doc/1 modules/Effects.html index 45b15294c..1ba87f3f0 100644 --- a/Documentation/doc/1 modules/Effects.html +++ b/Documentation/doc/1 modules/Effects.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • @@ -784,12 +784,12 @@ EmitAdvancedParticle(particle) (optional)
  • edgeFeatherMode - Effects.StreamerFeatherMode - Edge feather mode. Default: Effects.FeatherID.NONE + StreamerFeatherMode + Edge feather mode. Default: Effects.StreamerFeatherMode.NONE (optional)
  • lengthFeatherMode - Effects.StreamerFeatherMode + StreamerFeatherMode Length feather mode. UNIMPLEMENTED, currently will always leave a fading tail (optional)
    • diff --git a/Documentation/doc/1 modules/Flow.html b/Documentation/doc/1 modules/Flow.html index a8af377fd..9ca9202e8 100644 --- a/Documentation/doc/1 modules/Flow.html +++ b/Documentation/doc/1 modules/Flow.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/1 modules/Input.html b/Documentation/doc/1 modules/Input.html index d895fb863..789bad1c6 100644 --- a/Documentation/doc/1 modules/Input.html +++ b/Documentation/doc/1 modules/Input.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/1 modules/Inventory.html b/Documentation/doc/1 modules/Inventory.html index 2aad7fda5..14f4f6be5 100644 --- a/Documentation/doc/1 modules/Inventory.html +++ b/Documentation/doc/1 modules/Inventory.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/1 modules/Logic.html b/Documentation/doc/1 modules/Logic.html index fa7dc6e57..83b919387 100644 --- a/Documentation/doc/1 modules/Logic.html +++ b/Documentation/doc/1 modules/Logic.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/1 modules/Objects.html b/Documentation/doc/1 modules/Objects.html index fa8430af0..1e77c2f79 100644 --- a/Documentation/doc/1 modules/Objects.html +++ b/Documentation/doc/1 modules/Objects.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/1 modules/Sound.html b/Documentation/doc/1 modules/Sound.html index 76d850aa4..d7c87bb04 100644 --- a/Documentation/doc/1 modules/Sound.html +++ b/Documentation/doc/1 modules/Sound.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/1 modules/Strings.html b/Documentation/doc/1 modules/Strings.html index fe511f379..d5aaeda4a 100644 --- a/Documentation/doc/1 modules/Strings.html +++ b/Documentation/doc/1 modules/Strings.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/1 modules/Util.html b/Documentation/doc/1 modules/Util.html index 6365605b9..cc0443c3d 100644 --- a/Documentation/doc/1 modules/Util.html +++ b/Documentation/doc/1 modules/Util.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/1 modules/View.html b/Documentation/doc/1 modules/View.html index 6e99c337d..f1725ceb1 100644 --- a/Documentation/doc/1 modules/View.html +++ b/Documentation/doc/1 modules/View.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/2 classes/Collision.Probe.html b/Documentation/doc/2 classes/Collision.Probe.html index 8be1e951a..86465e30c 100644 --- a/Documentation/doc/2 classes/Collision.Probe.html +++ b/Documentation/doc/2 classes/Collision.Probe.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/2 classes/Flow.Level.html b/Documentation/doc/2 classes/Flow.Level.html index 6cb778133..655db8998 100644 --- a/Documentation/doc/2 classes/Flow.Level.html +++ b/Documentation/doc/2 classes/Flow.Level.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/2 classes/Flow.Settings.html b/Documentation/doc/2 classes/Flow.Settings.html index 96e83ad22..c0e7994a1 100644 --- a/Documentation/doc/2 classes/Flow.Settings.html +++ b/Documentation/doc/2 classes/Flow.Settings.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/2 classes/Flow.Statistics.html b/Documentation/doc/2 classes/Flow.Statistics.html index fef4baf27..0c3663c4b 100644 --- a/Documentation/doc/2 classes/Flow.Statistics.html +++ b/Documentation/doc/2 classes/Flow.Statistics.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/2 classes/Objects.AIObject.html b/Documentation/doc/2 classes/Objects.AIObject.html index e3417bdff..951d0e4d3 100644 --- a/Documentation/doc/2 classes/Objects.AIObject.html +++ b/Documentation/doc/2 classes/Objects.AIObject.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/2 classes/Objects.Camera.html b/Documentation/doc/2 classes/Objects.Camera.html index e5e8fde01..4899f78e0 100644 --- a/Documentation/doc/2 classes/Objects.Camera.html +++ b/Documentation/doc/2 classes/Objects.Camera.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/2 classes/Objects.LaraObject.html b/Documentation/doc/2 classes/Objects.LaraObject.html index e9047c5de..2b43e2d46 100644 --- a/Documentation/doc/2 classes/Objects.LaraObject.html +++ b/Documentation/doc/2 classes/Objects.LaraObject.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/2 classes/Objects.Moveable.html b/Documentation/doc/2 classes/Objects.Moveable.html index 6ef4a0404..d4dd0f7f0 100644 --- a/Documentation/doc/2 classes/Objects.Moveable.html +++ b/Documentation/doc/2 classes/Objects.Moveable.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/2 classes/Objects.Room.html b/Documentation/doc/2 classes/Objects.Room.html index 1b36cd4bb..04cd67ef3 100644 --- a/Documentation/doc/2 classes/Objects.Room.html +++ b/Documentation/doc/2 classes/Objects.Room.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/2 classes/Objects.Sink.html b/Documentation/doc/2 classes/Objects.Sink.html index 0ba93f4a6..322a09400 100644 --- a/Documentation/doc/2 classes/Objects.Sink.html +++ b/Documentation/doc/2 classes/Objects.Sink.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/2 classes/Objects.SoundSource.html b/Documentation/doc/2 classes/Objects.SoundSource.html index 4f658cb93..19e05dff7 100644 --- a/Documentation/doc/2 classes/Objects.SoundSource.html +++ b/Documentation/doc/2 classes/Objects.SoundSource.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/2 classes/Objects.Static.html b/Documentation/doc/2 classes/Objects.Static.html index 5259af90f..cddabdcf2 100644 --- a/Documentation/doc/2 classes/Objects.Static.html +++ b/Documentation/doc/2 classes/Objects.Static.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/2 classes/Objects.Volume.html b/Documentation/doc/2 classes/Objects.Volume.html index 5db162a3e..af6e4b1ed 100644 --- a/Documentation/doc/2 classes/Objects.Volume.html +++ b/Documentation/doc/2 classes/Objects.Volume.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/2 classes/Strings.DisplayString.html b/Documentation/doc/2 classes/Strings.DisplayString.html index f1f29c123..005c134f0 100644 --- a/Documentation/doc/2 classes/Strings.DisplayString.html +++ b/Documentation/doc/2 classes/Strings.DisplayString.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/2 classes/View.DisplaySprite.html b/Documentation/doc/2 classes/View.DisplaySprite.html index 9f9c723fa..1dbe32283 100644 --- a/Documentation/doc/2 classes/View.DisplaySprite.html +++ b/Documentation/doc/2 classes/View.DisplaySprite.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/3 primitive classes/Color.html b/Documentation/doc/3 primitive classes/Color.html index a54514919..9ccc6e9d6 100644 --- a/Documentation/doc/3 primitive classes/Color.html +++ b/Documentation/doc/3 primitive classes/Color.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/3 primitive classes/Flow.Fog.html b/Documentation/doc/3 primitive classes/Flow.Fog.html index d3f8f6297..49d245efb 100644 --- a/Documentation/doc/3 primitive classes/Flow.Fog.html +++ b/Documentation/doc/3 primitive classes/Flow.Fog.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/3 primitive classes/Flow.Horizon.html b/Documentation/doc/3 primitive classes/Flow.Horizon.html index 4d9d69be1..c8097d43b 100644 --- a/Documentation/doc/3 primitive classes/Flow.Horizon.html +++ b/Documentation/doc/3 primitive classes/Flow.Horizon.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/3 primitive classes/Flow.InventoryItem.html b/Documentation/doc/3 primitive classes/Flow.InventoryItem.html index 2623737c0..4daff8cd5 100644 --- a/Documentation/doc/3 primitive classes/Flow.InventoryItem.html +++ b/Documentation/doc/3 primitive classes/Flow.InventoryItem.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/3 primitive classes/Flow.LensFlare.html b/Documentation/doc/3 primitive classes/Flow.LensFlare.html index 5c666ea9d..5f7538fba 100644 --- a/Documentation/doc/3 primitive classes/Flow.LensFlare.html +++ b/Documentation/doc/3 primitive classes/Flow.LensFlare.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/3 primitive classes/Flow.SkyLayer.html b/Documentation/doc/3 primitive classes/Flow.SkyLayer.html index 27427363c..1289afc53 100644 --- a/Documentation/doc/3 primitive classes/Flow.SkyLayer.html +++ b/Documentation/doc/3 primitive classes/Flow.SkyLayer.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/3 primitive classes/Flow.Starfield.html b/Documentation/doc/3 primitive classes/Flow.Starfield.html index 0efed6489..f4aa48998 100644 --- a/Documentation/doc/3 primitive classes/Flow.Starfield.html +++ b/Documentation/doc/3 primitive classes/Flow.Starfield.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/3 primitive classes/Rotation.html b/Documentation/doc/3 primitive classes/Rotation.html index 7fad8cac1..728815250 100644 --- a/Documentation/doc/3 primitive classes/Rotation.html +++ b/Documentation/doc/3 primitive classes/Rotation.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/3 primitive classes/Time.html b/Documentation/doc/3 primitive classes/Time.html index c51d6a015..c1b159661 100644 --- a/Documentation/doc/3 primitive classes/Time.html +++ b/Documentation/doc/3 primitive classes/Time.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/3 primitive classes/Vec2.html b/Documentation/doc/3 primitive classes/Vec2.html index 2cef44350..825d7fa48 100644 --- a/Documentation/doc/3 primitive classes/Vec2.html +++ b/Documentation/doc/3 primitive classes/Vec2.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/3 primitive classes/Vec3.html b/Documentation/doc/3 primitive classes/Vec3.html index 15a50a1dc..696df8778 100644 --- a/Documentation/doc/3 primitive classes/Vec3.html +++ b/Documentation/doc/3 primitive classes/Vec3.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/4 enums/Collision.MaterialType.html b/Documentation/doc/4 enums/Collision.MaterialType.html index 4d6bd8af7..69c90fa69 100644 --- a/Documentation/doc/4 enums/Collision.MaterialType.html +++ b/Documentation/doc/4 enums/Collision.MaterialType.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/4 enums/Effects.BlendID.html b/Documentation/doc/4 enums/Effects.BlendID.html index 55662a65e..738be8a6b 100644 --- a/Documentation/doc/4 enums/Effects.BlendID.html +++ b/Documentation/doc/4 enums/Effects.BlendID.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/4 enums/Effects.EffectID.html b/Documentation/doc/4 enums/Effects.EffectID.html index 62e5adfcc..9b33780a8 100644 --- a/Documentation/doc/4 enums/Effects.EffectID.html +++ b/Documentation/doc/4 enums/Effects.EffectID.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html index 35ac618af..82bc18a38 100644 --- a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html +++ b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • diff --git a/Documentation/doc/4 enums/Effects.FeatherMode.html b/Documentation/doc/4 enums/Effects.StreamerFeatherMode.html similarity index 93% rename from Documentation/doc/4 enums/Effects.FeatherMode.html rename to Documentation/doc/4 enums/Effects.StreamerFeatherMode.html index c0534f46f..7415e2354 100644 --- a/Documentation/doc/4 enums/Effects.FeatherMode.html +++ b/Documentation/doc/4 enums/Effects.StreamerFeatherMode.html @@ -80,7 +80,7 @@
  • Collision.MaterialType
  • Effects.BlendID
  • Effects.EffectID
    • -
  • Effects.FeatherMode
    • +
  • Effects.StreamerFeatherMode
  • Effects.ParticleAnimationType
  • Flow.ErrorMode
  • Flow.FreezeMode
    • @@ -114,7 +114,7 @@
    -

    Enum Effects.FeatherMode

    +

    Enum Effects.StreamerFeatherMode

    Constants for feather modes.

    @@ -124,8 +124,8 @@

    Tables

    - - + +
    Effects.FeatherModeTable of Effects.FeatherMode constants.Effects.StreamerFeatherModeTable of Effects.StreamerFeatherMode constants.
    @@ -137,12 +137,12 @@
    - - Effects.FeatherMode + + Effects.StreamerFeatherMode
    -

    Table of Effects.FeatherMode constants. +

    Table of Effects.StreamerFeatherMode constants. To be used with Effects.EmitStreamer function.

    - Moveable:SetObjectID(ID) + Moveable:SetObjectID(objectID)
    Change the object's ID. This will literally change the object. @@ -536,7 +536,7 @@ most can just be ignored (see usage).

    Parameters:

      -
    • ID +
    • objectID ObjID the new ID
      • @@ -795,7 +795,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
        Vec3 - pos World position. + World position.
      @@ -815,7 +815,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
      • index int - of a joint to get rotation + Index of a joint to get rotation.
      @@ -1053,7 +1053,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    - Moveable:SetCustomEffect(Color1, Color2[, timeout]) + Moveable:SetCustomEffect(color1, color2[, timeout])
    Set custom colored burn effect to moveable @@ -1062,17 +1062,17 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)

    Parameters:

      -
    • Color1 +
    • color1 Color - color the primary color of the effect (also used for lighting). + The primary color of the effect (also used for lighting).
      • -
    • Color2 +
    • color2 Color - color the secondary color of the effect. + The secondary color of the effect.
    • timeout float - time (in seconds) after which effect turns off. + Time (in seconds) after which effect turns off. (optional)
    @@ -1096,7 +1096,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
      EffectID - Sffect type currently assigned. + Effect type currently assigned.
    @@ -1116,7 +1116,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    • index int - of the ItemFlags, can be between 0 and 7. + Index of the ItemFlag, can be between 0 and 7.
    @@ -1144,11 +1144,11 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    • value short - to store in the moveable's ItemFlags[index] + Value to store in the moveable's ItemFlags[index].
    • index int - of the ItemFlags where store the value. + Index of the ItemFlag where to store the value.
    @@ -1191,7 +1191,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    • value short - to store. + Value to store.
    @@ -1248,18 +1248,22 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:GetAIBits()
    - Get AIBits of object + +

    Get AIBits of object This will return a table with six values, each corresponding to an active behaviour. If the object is in a certain AI mode, the table will have a 1 in the corresponding cell. Otherwise, the cell will hold a 0.

    -


    1 - guard -
    2 - ambush -
    3 - patrol 1 -
    4 - modify -
    5 - follow -
    6 - patrol 2 +

    1 - Guard
+2 - Ambush
+3 - Patrol 1
+4 - Modify
+5 - Follow
+6 - Patrol 2
+
    + + @@ -1681,7 +1685,7 @@ sas:SetPosition(newPos, false) Moveable:GetStatus()
    - Get the moveable's status. () + Get the moveable's status. @@ -1702,7 +1706,7 @@ sas:SetPosition(newPos, false) Moveable:SetStatus(status)
    - Set the moveable's status. () + Set the moveable's status. @@ -2103,15 +2107,15 @@ sas:SetPosition(newPos, false)
    • mesh int - of a target moveable to use as a camera target + Mesh of a target moveable to use as a camera target.
    • target Moveable - moveable to attach camera to + Target moveable to attach camera to.
    • mesh int - of a target moveable to use as a camera target + Mesh of a target moveable to use as a camera target.
    @@ -2122,7 +2126,7 @@ sas:SetPosition(newPos, false)
    - Moveable:AnimFromObject(ObjectID, animNumber, stateID) + Moveable:AnimFromObject(objectID, animNumber, stateID)
    Borrow animation from an object @@ -2131,17 +2135,17 @@ sas:SetPosition(newPos, false)

    Parameters:

      -
    • ObjectID +
    • objectID ObjID - to take animation and stateID from, + Object ID to take animation and stateID from.
    • animNumber int - animation from object + Animation from object.
    • stateID int - state from object + state State from object.
    diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp index e356bf2b5..2b5c0aea8 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp @@ -106,7 +106,7 @@ These are: e.g. `myLevel.laraType = LaraType.Divesuit` - __(not yet fully implemented)__ + __Not yet fully implemented.__ Only types `Normal` and `Young` are guaranteed to work. @mem laraType*/ "laraType", &Level::Type, diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp index 30fd28657..eb1ef5760 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp +++ b/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp @@ -244,7 +244,7 @@ void Moveable::Initialize() /// Retrieve the object ID // @function Moveable:GetObjectID -// @treturn Objects.ObjID a number representing the ID of the object +// @treturn Objects.ObjID a number representing the ID of the object. GAME_OBJECT_ID Moveable::GetObjectID() const { return _moveable->ObjectNumber; @@ -252,7 +252,7 @@ GAME_OBJECT_ID Moveable::GetObjectID() const /// Change the object's ID. This will literally change the object. // @function Moveable:SetObjectID -// @tparam Objects.ObjID ID the new ID +// @tparam Objects.ObjID objectID the new ID // @usage // shiva = TEN.Objects.GetMoveableByName("shiva_60") // shiva:SetObjectID(TEN.Objects.ObjID.BIGMEDI_ITEM) @@ -432,7 +432,7 @@ void Moveable::SetPosition(const Vec3& pos, sol::optional updateRoom) // @function Moveable:GetJointPosition // @tparam int jointID Joint ID. // @tparam[opt] Vec3 offset Offset relative to the joint. -// @treturn Vec3 pos World position. +// @treturn Vec3 World position. Vec3 Moveable::GetJointPos(int jointID, sol::optional offset) const { auto convertedOffset = offset.has_value() ? offset->ToVector3i() : Vector3i::Zero; @@ -441,7 +441,7 @@ Vec3 Moveable::GetJointPos(int jointID, sol::optional offset) const /// Get the object's joint rotation // @function Moveable:GetJointRotation -// @tparam int index of a joint to get rotation +// @tparam int index Index of a joint to get rotation. // @treturn Rotation a calculated copy of the moveable's joint rotation Rotation Moveable::GetJointRot(int jointIndex) const { @@ -606,9 +606,9 @@ void Moveable::SetEffect(EffectType effectType, sol::optional timeout) /// Set custom colored burn effect to moveable // @function Moveable:SetCustomEffect -// @tparam Color Color1 color the primary color of the effect (also used for lighting). -// @tparam Color Color2 color the secondary color of the effect. -// @tparam[opt] float timeout time (in seconds) after which effect turns off. +// @tparam Color color1 The primary color of the effect (also used for lighting). +// @tparam Color color2 The secondary color of the effect. +// @tparam[opt] float timeout Time (in seconds) after which effect turns off. void Moveable::SetCustomEffect(const ScriptColor& col1, const ScriptColor& col2, sol::optional timeout) { int realTimeout = timeout.has_value() ? int(timeout.value() * FPS) : -1; @@ -619,7 +619,7 @@ void Moveable::SetCustomEffect(const ScriptColor& col1, const ScriptColor& col2, /// Get current moveable effect // @function Moveable:GetEffect -// @treturn Effects.EffectID Sffect type currently assigned. +// @treturn Effects.EffectID Effect type currently assigned. EffectType Moveable::GetEffect() const { return _moveable->Effect.Type; @@ -627,7 +627,7 @@ EffectType Moveable::GetEffect() const /// Get the value stored in ItemFlags[index] // @function Moveable:GetItemFlags -// @tparam int index of the ItemFlags, can be between 0 and 7. +// @tparam int index Index of the ItemFlag, can be between 0 and 7. // @treturn int the value contained in the ItemFlags[index] short Moveable::GetItemFlags(int index) const { @@ -636,8 +636,8 @@ short Moveable::GetItemFlags(int index) const /// Stores a value in ItemFlags[index] // @function Moveable:SetItemFlags -// @tparam short value to store in the moveable's ItemFlags[index] -// @tparam int index of the ItemFlags where store the value. +// @tparam short value Value to store in the moveable's ItemFlags[index]. +// @tparam int index Index of the ItemFlag where to store the value. void Moveable::SetItemFlags(short value, int index) { _moveable->ItemFlags[index] = value; @@ -660,7 +660,7 @@ short Moveable::GetLocationAI() const /// Updates the location in the enemy AI with the given value. // @function Moveable:SetLocationAI -// @tparam short value to store. +// @tparam short value Value to store. void Moveable::SetLocationAI(short value) { if (_moveable->IsCreature()) @@ -696,12 +696,13 @@ void Moveable::SetColor(const ScriptColor& color) // have a *1* in the corresponding cell. Otherwise, the cell will hold // a *0*. // -//
    1 - guard -//
    2 - ambush -//
    3 - patrol 1 -//
    4 - modify -//
    5 - follow -//
    6 - patrol 2 +// 1 - Guard +// 2 - Ambush +// 3 - Patrol 1 +// 4 - Modify +// 5 - Follow +// 6 - Patrol 2 +// // @function Moveable:GetAIBits // @treturn table a table of AI bits aiBitsType Moveable::GetAIBits() const @@ -934,7 +935,7 @@ void Moveable::SetRoomNumber(int roomNumber) } /// Get the moveable's status. -// @function Moveable:GetStatus() +// @function Moveable:GetStatus // @treturn Objects.MoveableStatus Status. short Moveable::GetStatus() const { @@ -942,7 +943,7 @@ short Moveable::GetStatus() const } /// Set the moveable's status. -// @function Moveable:SetStatus() +// @function Moveable:SetStatus // @tparam Objects.MoveableStatus status The new status of the moveable. void Moveable::SetStatus(ItemStatus status) { @@ -1234,9 +1235,9 @@ bool Moveable::MeshExists(int index) const /// Attach camera to an object. // @function Moveable:AttachObjCamera -// @tparam int mesh of a moveable to use as a camera position -// @tparam Moveable target moveable to attach camera to -// @tparam int mesh of a target moveable to use as a camera target +// @tparam int mesh Mesh of a moveable to use as a camera position. +// @tparam Moveable target Target moveable to attach camera to. +// @tparam int mesh Mesh of a target moveable to use as a camera target. void Moveable::AttachObjCamera(short camMeshId, Moveable& mov, short targetMeshId) { if ((_moveable->Active || _moveable->IsLara()) && (mov._moveable->Active || mov._moveable->IsLara())) @@ -1245,9 +1246,9 @@ void Moveable::AttachObjCamera(short camMeshId, Moveable& mov, short targetMeshI /// Borrow animation from an object // @function Moveable:AnimFromObject -// @tparam Objects.ObjID ObjectID to take animation and stateID from, -// @tparam int animNumber animation from object -// @tparam int stateID state from object +// @tparam Objects.ObjID objectID Object ID to take animation and stateID from. +// @tparam int animNumber Animation from object. +// @tparam int stateID state State from object. void Moveable::AnimFromObject(GAME_OBJECT_ID objectID, int animNumber, int stateID) { _moveable->Animation.AnimObjectID = objectID; From db3b9cc41118b4784d2560360911a9bd5f6dbe69 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 16 Mar 2025 10:47:34 +0100 Subject: [PATCH 078/160] Update version.h --- TombEngine/version.h | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/TombEngine/version.h b/TombEngine/version.h index e012d5156..464c2b659 100644 --- a/TombEngine/version.h +++ b/TombEngine/version.h @@ -6,8 +6,8 @@ #define TE_REVISION_NUMBER 0 #define TEN_MAJOR_VERSION 1 -#define TEN_MINOR_VERSION 7 -#define TEN_BUILD_NUMBER 3 +#define TEN_MINOR_VERSION 8 +#define TEN_BUILD_NUMBER 0 #define TEN_REVISION_NUMBER 0 #define TEST_BUILD 1 From 9a08c05a19b546b129f839fabdd50c8bc50e4dfe Mon Sep 17 00:00:00 2001 From: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Sun, 16 Mar 2025 10:41:23 +0000 Subject: [PATCH 079/160] Update bug_report.yaml --- .github/ISSUE_TEMPLATE/bug_report.yaml | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml index 30aa5c96d..e123eab74 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yaml +++ b/.github/ISSUE_TEMPLATE/bug_report.yaml @@ -1,5 +1,5 @@ name: Bug report -description: Create a report to help us understand and diagnose your issue. Your contribution is welcomed and valued! +description: Create a report to help us understand and diagnose your issue. Your contribution is welcomed and valued! It is highly recommended that you are using the latest version before submitting a bug report. title: "[ bug Report ]" labels: Awaiting Triage @@ -8,17 +8,19 @@ body: - type: markdown attributes: value: | - Please follow this document in order to report a bug + Please follow this document in order to report a bug. It is highly recommended that you are using the latest version before submitting a bug report. - type: dropdown attributes: label: TombEngine version description: | - Please select the TombEngine Version from the dropdown list. + Please select the TombEngine Version from the dropdown list. options: - Development Build - - v1.5.0.2 (Latest Release) - - v1.4 + - v1.8.0 (latest version) + - v1.7.1 + - v1.7.0 + - v1.5 validations: required: true @@ -29,6 +31,7 @@ body: Please select the Tomb Editor version used from the dropdown list. options: - Development Build + - v1.8.0 (latest version) - v1.7.2 - v1.7.1 - v1.7.0 From a4b3019ce9832d6cd92e66cae3e5efe5c4b4abf0 Mon Sep 17 00:00:00 2001 From: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Sun, 16 Mar 2025 10:56:18 +0000 Subject: [PATCH 080/160] Update changelog for 1.8 release --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4a0b7ac08..8fe88a532 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,7 +3,7 @@ The dates are in European standard format where date is presented as **YYYY-MM-DD**. TombEngine releases are located in this repository (alongside with Tomb Editor): https://github.com/TombEngine/TombEditorReleases -## [Version 1.8](link to release) - yyyy-mm-dd +## [Version 1.8](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.8) - 2025-03-16 ### Bug fixes * Improved engine performance up to 20%. From 74e13fc6783014ba5bac483cbdf6d10f50ba5ddc Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 16 Mar 2025 15:41:47 +0100 Subject: [PATCH 081/160] Remove formatting leftovers from doc --- Documentation/doc/2 classes/Flow.Settings.html | 4 ++-- TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Documentation/doc/2 classes/Flow.Settings.html b/Documentation/doc/2 classes/Flow.Settings.html index c0e7994a1..4f76f9212 100644 --- a/Documentation/doc/2 classes/Flow.Settings.html +++ b/Documentation/doc/2 classes/Flow.Settings.html @@ -1255,7 +1255,7 @@
    • errorMode ErrorMode - error mode to use. */ + error mode to use.
    @@ -1278,7 +1278,7 @@
    • multithreaded bool - determines whether to use multithreading or not. */ + determines whether to use multithreading or not.
    diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp index ba2cf5e71..c72382a24 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp @@ -325,13 +325,13 @@ namespace TEN::Scripting sol::meta_function::new_index, NewIndexErrorMaker(SystemSettings, ScriptReserved_SystemSettings), /// How should the application respond to script errors? - // @tfield Flow.ErrorMode errorMode error mode to use. */ + // @tfield Flow.ErrorMode errorMode error mode to use. "errorMode", &SystemSettings::ErrorMode, /// Use multithreading in certain calculations.
    // When set to `true`, some performance-critical calculations will be performed in parallel, which can give // a significant performance boost. Don't disable unless you have problems with launching or using TombEngine. - // @tfield bool multithreaded determines whether to use multithreading or not. */ + // @tfield bool multithreaded determines whether to use multithreading or not. "multithreaded", &SystemSettings::Multithreaded, /// Can the game utilize the fast reload feature?
    From cb37bda329e36ff564d25407923cbf8fd4abf91f Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 16 Mar 2025 18:17:11 +0100 Subject: [PATCH 082/160] Move particle init to proper function, always reinit objects on level reload --- TombEngine/Game/Setup.cpp | 5 ++--- TombEngine/Game/control/control.cpp | 1 + TombEngine/Specific/level.cpp | 5 ++--- 3 files changed, 5 insertions(+), 6 deletions(-) diff --git a/TombEngine/Game/Setup.cpp b/TombEngine/Game/Setup.cpp index 733989cb6..076acc185 100644 --- a/TombEngine/Game/Setup.cpp +++ b/TombEngine/Game/Setup.cpp @@ -208,6 +208,8 @@ void CustomObjects() void InitializeObjects() { + TENLog("Initializing objects...", LogLevel::Info); + AllocTR4Objects(); AllocTR5Objects(); @@ -250,9 +252,6 @@ void InitializeObjects() // User defined objects CustomObjects(); - HairEffect.Initialize(); - InitializeSpecialEffects(); - NumRPickups = 0; CurrentSequence = 0; SequenceResults[0][1][2] = 0; diff --git a/TombEngine/Game/control/control.cpp b/TombEngine/Game/control/control.cpp index 446dbac9c..412c974dd 100644 --- a/TombEngine/Game/control/control.cpp +++ b/TombEngine/Game/control/control.cpp @@ -389,6 +389,7 @@ GameStatus DoLevel(int levelIndex, bool loadGame) InitializeCamera(); InitializeSpotCamSequences(isTitle); InitializeItemBoxData(); + InitializeSpecialEffects(); // Initialize scripting. InitializeScripting(levelIndex, loadGame); diff --git a/TombEngine/Specific/level.cpp b/TombEngine/Specific/level.cpp index e87d162d5..aa42a4e55 100644 --- a/TombEngine/Specific/level.cpp +++ b/TombEngine/Specific/level.cpp @@ -219,6 +219,8 @@ std::string ReadString() void LoadItems() { + InitializeObjects(); + g_Level.NumItems = ReadCount(); TENLog("Moveables: " + std::to_string(g_Level.NumItems), LogLevel::Info); @@ -454,9 +456,6 @@ void LoadObjects() Objects[objNum].animIndex = ReadInt32(); } - TENLog("Initializing objects...", LogLevel::Info); - InitializeObjects(); - int staticCount = ReadCount(); TENLog("Statics: " + std::to_string(staticCount), LogLevel::Info); From 4ed26b1c2d8bc30619f8988e6291e6c93bf1f4c0 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 16 Mar 2025 20:48:40 +0100 Subject: [PATCH 083/160] Move InitializeObjets back, only reinit regenerated pickups counter --- TombEngine/Game/Setup.cpp | 2 +- TombEngine/Specific/level.cpp | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/TombEngine/Game/Setup.cpp b/TombEngine/Game/Setup.cpp index 076acc185..42bfb08df 100644 --- a/TombEngine/Game/Setup.cpp +++ b/TombEngine/Game/Setup.cpp @@ -174,6 +174,7 @@ void InitializeGameFlags() FlipEffect = NO_VALUE; FlipStatus = false; + NumRPickups = 0; Camera.underwater = false; } @@ -252,7 +253,6 @@ void InitializeObjects() // User defined objects CustomObjects(); - NumRPickups = 0; CurrentSequence = 0; SequenceResults[0][1][2] = 0; SequenceResults[0][2][1] = 1; diff --git a/TombEngine/Specific/level.cpp b/TombEngine/Specific/level.cpp index aa42a4e55..3addd27f9 100644 --- a/TombEngine/Specific/level.cpp +++ b/TombEngine/Specific/level.cpp @@ -219,8 +219,6 @@ std::string ReadString() void LoadItems() { - InitializeObjects(); - g_Level.NumItems = ReadCount(); TENLog("Moveables: " + std::to_string(g_Level.NumItems), LogLevel::Info); @@ -456,6 +454,8 @@ void LoadObjects() Objects[objNum].animIndex = ReadInt32(); } + InitializeObjects(); + int staticCount = ReadCount(); TENLog("Statics: " + std::to_string(staticCount), LogLevel::Info); From 092346925ebcdae511fd97cd688c0222e39d824b Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Mon, 17 Mar 2025 21:01:15 +0100 Subject: [PATCH 084/160] Fixed particles being canceled by fog bulbs --- CHANGELOG.md | 8 +++++++- TombEngine/Shaders/InstancedSprites.fx | 2 +- TombEngine/Shaders/Sprites.fx | 2 +- 3 files changed, 9 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4a0b7ac08..dcb9e654f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,7 +3,13 @@ The dates are in European standard format where date is presented as **YYYY-MM-DD**. TombEngine releases are located in this repository (alongside with Tomb Editor): https://github.com/TombEngine/TombEditorReleases -## [Version 1.8](link to release) - yyyy-mm-dd +## [Version 1.8.1](link to release) - yyyy-mm-dd + +### Bug fixes +* Fixed particles remaining in the level after reloading from the savegame. +* Fixed particles being canceled by fog bulbs. + +## [Version 1.8](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.8) - 2025-03-16 ### Bug fixes * Improved engine performance up to 20%. diff --git a/TombEngine/Shaders/InstancedSprites.fx b/TombEngine/Shaders/InstancedSprites.fx index 0e9287137..5320f03d3 100644 --- a/TombEngine/Shaders/InstancedSprites.fx +++ b/TombEngine/Shaders/InstancedSprites.fx @@ -106,7 +106,7 @@ float4 PS(PixelShaderInput input) : SV_TARGET output.w = min(output.w, fade); } - output.xyz -= float3(input.FogBulbs.w, input.FogBulbs.w, input.FogBulbs.w); + output.xyz *= 1.0f - Luma(input.FogBulbs.xyz); output.xyz = saturate(output.xyz); output = DoDistanceFogForPixel(output, float4(0.0f, 0.0f, 0.0f, 0.0f), input.DistanceFog); diff --git a/TombEngine/Shaders/Sprites.fx b/TombEngine/Shaders/Sprites.fx index 54433f35e..50fb85b5c 100644 --- a/TombEngine/Shaders/Sprites.fx +++ b/TombEngine/Shaders/Sprites.fx @@ -82,7 +82,7 @@ float4 PS(PixelShaderInput input) : SV_TARGET output = DoLaserBeamEffect(input.Position, output, input.UV, FADE_FACTOR, Frame); } - output.xyz -= float3(input.FogBulbs.w, input.FogBulbs.w, input.FogBulbs.w); + output.xyz *= 1.0f - Luma(input.FogBulbs.xyz); output.xyz = saturate(output.xyz); output = DoDistanceFogForPixel(output, float4(0.0f, 0.0f, 0.0f, 0.0f), input.DistanceFog); From 67f4fe3d1d18339a2d56f418dd76db9020b26538 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Mon, 17 Mar 2025 23:29:44 +0100 Subject: [PATCH 085/160] Added probe constructor without room number --- Documentation/doc/2 classes/Collision.Probe.html | 7 ++++--- Documentation/doc/2 classes/Flow.Settings.html | 2 +- .../Scripting/Internal/TEN/Collision/Probe.cpp | 13 +++++++++---- TombEngine/Scripting/Internal/TEN/Collision/Probe.h | 3 ++- .../Internal/TEN/Flow/Settings/Settings.cpp | 2 +- 5 files changed, 17 insertions(+), 10 deletions(-) diff --git a/Documentation/doc/2 classes/Collision.Probe.html b/Documentation/doc/2 classes/Collision.Probe.html index 86465e30c..4ff672202 100644 --- a/Documentation/doc/2 classes/Collision.Probe.html +++ b/Documentation/doc/2 classes/Collision.Probe.html @@ -122,7 +122,7 @@

    Functions

    - + @@ -220,7 +220,7 @@
    - Probe(pos, roomNumber) + Probe(pos[, roomNumber])
    Create a Probe at a specified world position in a room. @@ -235,7 +235,8 @@
  • roomNumber int - [opt] Room number. Must be used if probing a position in an overlapping room. + Room number. Must be used if probing a position in an overlapping room. + (optional)
    • diff --git a/Documentation/doc/2 classes/Flow.Settings.html b/Documentation/doc/2 classes/Flow.Settings.html index 4f76f9212..326b6b4ce 100644 --- a/Documentation/doc/2 classes/Flow.Settings.html +++ b/Documentation/doc/2 classes/Flow.Settings.html @@ -517,7 +517,7 @@
    • objectCollision bool - when enabled, camera will collide with moveables and statics. Disable or TR4-like camera behaviour. + when enabled, camera will collide with moveables and statics. Disable for TR4-like camera behaviour.
    diff --git a/TombEngine/Scripting/Internal/TEN/Collision/Probe.cpp b/TombEngine/Scripting/Internal/TEN/Collision/Probe.cpp index 392410c40..765715dbb 100644 --- a/TombEngine/Scripting/Internal/TEN/Collision/Probe.cpp +++ b/TombEngine/Scripting/Internal/TEN/Collision/Probe.cpp @@ -26,6 +26,7 @@ namespace TEN::Scripting::Collision void Probe::Register(sol::table& parent) { using ctors = sol::constructors< + Probe(const Vec3&), Probe(const Vec3&, int), Probe(const Vec3&, int, const Vec3&, float), Probe(const Vec3&, int, const Rotation&, float), @@ -65,13 +66,17 @@ namespace TEN::Scripting::Collision /// Create a Probe at a specified world position in a room. // @function Probe // @tparam Vec3 pos World position. - // @tparam int roomNumber[opt] Room number. Must be used if probing a position in an overlapping room. + // @tparam[opt] int roomNumber Room number. Must be used if probing a position in an overlapping room. // @treturn Probe A new Probe. - Probe::Probe(const Vec3& pos, TypeOrNil roomNumber) + Probe::Probe(const Vec3& pos) { auto convertedPos = pos.ToVector3i(); - int roomNumberValue = ValueOr(roomNumber, FindRoomNumber(convertedPos)); - _pointCollision = GetPointCollision(convertedPos, roomNumberValue); + _pointCollision = GetPointCollision(convertedPos, FindRoomNumber(convertedPos)); + } + + Probe::Probe(const Vec3& pos, int roomNumber) + { + _pointCollision = GetPointCollision(pos.ToVector3i(), roomNumber); } /// Create a Probe that casts from an origin world position in a room in a given direction for a specified distance. diff --git a/TombEngine/Scripting/Internal/TEN/Collision/Probe.h b/TombEngine/Scripting/Internal/TEN/Collision/Probe.h index 86fb90459..d96a78ed8 100644 --- a/TombEngine/Scripting/Internal/TEN/Collision/Probe.h +++ b/TombEngine/Scripting/Internal/TEN/Collision/Probe.h @@ -31,7 +31,8 @@ namespace TEN::Scripting::Collision // Constructors Probe() = default; - Probe(const Vec3& pos, TypeOrNil roomNumber); + Probe(const Vec3& pos); + Probe(const Vec3& pos, int roomNumber); Probe(const Vec3& origin, int roomNumber, const Vec3& dir, float dist); Probe(const Vec3& origin, int roomNumber, const Rotation& rot, float dist); Probe(const Vec3& origin, int roomNumber, const Rotation& rot, const Vec3& relOffset); diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp index c72382a24..51cda08ee 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp @@ -124,7 +124,7 @@ namespace TEN::Scripting "lasersightLightColor", &CameraSettings::LasersightLightColor, /// Specify whether camera can collide with objects. - // @tfield bool objectCollision when enabled, camera will collide with moveables and statics. Disable or TR4-like camera behaviour. + // @tfield bool objectCollision when enabled, camera will collide with moveables and statics. Disable for TR4-like camera behaviour. "objectCollision", &CameraSettings::ObjectCollision); } From 5bdff1bf3ccad9e556a69708555805842a810f9d Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Mon, 17 Mar 2025 23:35:58 +0100 Subject: [PATCH 086/160] Update CHANGELOG.md --- CHANGELOG.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index dcb9e654f..edf146d46 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,9 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed particles remaining in the level after reloading from the savegame. * Fixed particles being canceled by fog bulbs. +### Lua API changes +* Added missing constructor for `Collision.Probe` without room number. + ## [Version 1.8](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.8) - 2025-03-16 ### Bug fixes From b07ee8eed7e7c676fe5ea80103ccb8e259df8567 Mon Sep 17 00:00:00 2001 From: Sezz Date: Wed, 19 Mar 2025 15:36:42 +1100 Subject: [PATCH 087/160] tr5_movinglaser -> MovingLaser --- .../Objects/TR5/Trap/{tr5_movinglaser.cpp => MovingLaser.cpp} | 2 +- .../Objects/TR5/Trap/{tr5_movinglaser.h => MovingLaser.h} | 0 TombEngine/Objects/TR5/tr5_objects.cpp | 4 ++-- TombEngine/TombEngine.vcxproj | 4 ++-- 4 files changed, 5 insertions(+), 5 deletions(-) rename TombEngine/Objects/TR5/Trap/{tr5_movinglaser.cpp => MovingLaser.cpp} (98%) rename TombEngine/Objects/TR5/Trap/{tr5_movinglaser.h => MovingLaser.h} (100%) diff --git a/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp b/TombEngine/Objects/TR5/Trap/MovingLaser.cpp similarity index 98% rename from TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp rename to TombEngine/Objects/TR5/Trap/MovingLaser.cpp index 79d0b7bba..6183b2518 100644 --- a/TombEngine/Objects/TR5/Trap/tr5_movinglaser.cpp +++ b/TombEngine/Objects/TR5/Trap/MovingLaser.cpp @@ -1,5 +1,5 @@ #include "framework.h" -#include "Objects/TR5/Trap/tr5_movinglaser.h" +#include "Objects/TR5/Trap/MovingLaser.h" #include "Game/animation.h" #include "Game/collision/collide_item.h" diff --git a/TombEngine/Objects/TR5/Trap/tr5_movinglaser.h b/TombEngine/Objects/TR5/Trap/MovingLaser.h similarity index 100% rename from TombEngine/Objects/TR5/Trap/tr5_movinglaser.h rename to TombEngine/Objects/TR5/Trap/MovingLaser.h diff --git a/TombEngine/Objects/TR5/tr5_objects.cpp b/TombEngine/Objects/TR5/tr5_objects.cpp index 05921eb01..9b5b878b6 100644 --- a/TombEngine/Objects/TR5/tr5_objects.cpp +++ b/TombEngine/Objects/TR5/tr5_objects.cpp @@ -57,15 +57,15 @@ // Traps #include "Objects/Effects/EmberEmitter.h" -#include "Objects/Effects/tr5_electricity.h" #include "Objects/TR5/Trap/LaserBarrier.h" #include "Objects/TR5/Trap/LaserBeam.h" +#include "Objects/TR5/Trap/MovingLaser.h" #include "Objects/TR5/Trap/ZipLine.h" +#include "Objects/Effects/tr5_electricity.h" #include "Objects/TR5/Object/tr5_rollingball.h" #include "Objects/TR5/Trap/tr5_ventilator.h" #include "Objects/TR5/Trap/tr5_romehammer.h" #include "Objects/TR5/Trap/tr5_fallingceiling.h" -#include "Objects/TR5/Trap/tr5_movinglaser.h" #include "Objects/TR5/Trap/tr5_explosion.h" #include "Objects/TR5/Trap/tr5_wreckingball.h" diff --git a/TombEngine/TombEngine.vcxproj b/TombEngine/TombEngine.vcxproj index 0da249555..19ff7ecfb 100644 --- a/TombEngine/TombEngine.vcxproj +++ b/TombEngine/TombEngine.vcxproj @@ -742,7 +742,7 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. - + @@ -1268,7 +1268,7 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. - + From e0927a9415c482efd3081df5b3b17b82eab1e081 Mon Sep 17 00:00:00 2001 From: Sezz Date: Wed, 19 Mar 2025 16:20:26 +1100 Subject: [PATCH 088/160] Minor refactors to moving laser --- TombEngine/Objects/TR5/Trap/MovingLaser.cpp | 144 +++++++++++--------- 1 file changed, 78 insertions(+), 66 deletions(-) diff --git a/TombEngine/Objects/TR5/Trap/MovingLaser.cpp b/TombEngine/Objects/TR5/Trap/MovingLaser.cpp index 6183b2518..bb07f8c19 100644 --- a/TombEngine/Objects/TR5/Trap/MovingLaser.cpp +++ b/TombEngine/Objects/TR5/Trap/MovingLaser.cpp @@ -12,99 +12,111 @@ #include "Game/items.h" #include "Game/Lara/lara.h" #include "Sound/sound.h" -#include "Math/Utils.h" #include "Specific/level.h" using namespace TEN::Collision::Sphere; namespace TEN::Entities::Traps { - enum MovingLaserFlags - { - Speed, - PauseCounter, - Direction, - DistanceTravelled, - SpeedCalc - }; + constexpr auto MOVING_LASER_DAMAGE = 100; + constexpr auto MOVING_LASER_VELOCITY_MIN = 1.0f; + constexpr auto MOVING_LASER_ACCEL = 1.0f; + constexpr auto MOVING_LASER_PAUSE_FRAME_COUNT = 30; - constexpr auto MOVING_LASER_DAMAGE = 100; - constexpr int PAUSE_FRAMES = 30; - constexpr float MAX_SPEED_THRESHOLD = 0.9f; - constexpr float MIN_SPEED = 1.0f; - constexpr float ACCELERATION = 1.0f; + enum class MovingLaserProperty + { + Velocity, + PauseTimer, + DirectionSign, + DistanceTraveled, + VelocityCalc + }; void InitializeMovingLaser(short itemNumber) { auto& item = g_Level.Items[itemNumber]; - item.ItemFlags[MovingLaserFlags::Direction] = 1; - item.ItemFlags[MovingLaserFlags::Speed] = 10; - item.Pose.Translate(item.Pose.Orientation, -CLICK(1)); // Offset by one click to make it dangerous at the edges of the block. + item.ItemFlags[(int)MovingLaserProperty::DirectionSign] = 1; + item.ItemFlags[(int)MovingLaserProperty::Velocity] = 10; + + // Offset by 1/4 block to make it dangerous at sector edges. + item.Pose.Translate(item.Pose.Orientation, -BLOCK(0.25f)); } - void ControlMovingLaser(short itemNumber) - { - auto& item = g_Level.Items[itemNumber]; + void ControlMovingLaser(short itemNumber) + { + auto& item = g_Level.Items[itemNumber]; - if (!TriggerActive(&item)) - return; + if (!TriggerActive(&item)) + return; - float moveDistance = (BLOCK(1) * item.TriggerFlags) + CLICK(2); // Use OCB to calculate the distance and add 2 clicks. + // Calculate distances. + float moveDist = BLOCK(item.TriggerFlags) + BLOCK(0.5f); + float distPerFrame = (BLOCK(item.ItemFlags[(int)MovingLaserProperty::Velocity]) * 0.25f) / (float)FPS; - float distancePerFrame = ((float)(CLICK(1)) * item.ItemFlags[MovingLaserFlags::Speed]) / FPS; // Calculate distance per frame + item.Animation.ActiveState = 0; - item.Animation.ActiveState = 0; - SpawnDynamicLight(item.Pose.Position.x, item.Pose.Position.y - 64, item.Pose.Position.z, (Random::GenerateInt() % 2) + 8, (Random::GenerateInt() % 4) + 24, Random::GenerateInt() % 4, Random::GenerateInt() % 2); - item.MeshBits = -1 - (GetRandomControl() & 0x14); // To make lasers flicker + // TODO: Use SpawnDynamicPointLight(). + SpawnDynamicLight( + item.Pose.Position.x, item.Pose.Position.y - 64, item.Pose.Position.z, (Random::GenerateInt() % 2) + 8, + (Random::GenerateInt() % 4) + 24, Random::GenerateInt() % 4, Random::GenerateInt() % 2); + /*auto lightPos = item.Pose.Position.ToVector3() + Vector3(0.0f, -64, 0.0f); + auto lightColor = Color(Random::GenerateFloat(0.1f, 0.2f), Random::GenerateFloat(0.0f, 0.01f), Random::GenerateFloat(Random::GenerateFloat(0.0f, 0.01f))); + float lightFalloff = ?? + SpawnDynamicPointLight(lightPos, lightPos, lightFalloff);*/ - if (item.TriggerFlags == 0) - { - AnimateItem(&item); - return; - } + // TODO: Demagic. + // Used for flicker. + item.MeshBits = -1 - (GetRandomControl() & 20); - if (item.ItemFlags[MovingLaserFlags::PauseCounter] > 0) - { - item.ItemFlags[MovingLaserFlags::PauseCounter]--; + if (item.TriggerFlags == 0) + { + AnimateItem(&item); + return; + } - if (item.ItemFlags[MovingLaserFlags::PauseCounter] == 0) - { - item.ItemFlags[MovingLaserFlags::Direction] *= -1; - item.ItemFlags[MovingLaserFlags::DistanceTravelled] = 0; - } + if (item.ItemFlags[(int)MovingLaserProperty::PauseTimer] > 0) + { + item.ItemFlags[(int)MovingLaserProperty::PauseTimer]--; + if (item.ItemFlags[(int)MovingLaserProperty::PauseTimer] == 0) + { + item.ItemFlags[(int)MovingLaserProperty::DirectionSign] *= -1; + item.ItemFlags[(int)MovingLaserProperty::DistanceTraveled] = 0; + } - AnimateItem(&item); - return; - } + AnimateItem(&item); + return; + } - item.Pose.Translate(item.Pose.Orientation, (item.ItemFlags[MovingLaserFlags::Direction] * item.ItemFlags[MovingLaserFlags::SpeedCalc])); + item.Pose.Translate(item.Pose.Orientation, (item.ItemFlags[(int)MovingLaserProperty::DirectionSign] * item.ItemFlags[(int)MovingLaserProperty::VelocityCalc])); - item.ItemFlags[MovingLaserFlags::DistanceTravelled] += item.ItemFlags[MovingLaserFlags::SpeedCalc]; + item.ItemFlags[(int)MovingLaserProperty::DistanceTraveled] += item.ItemFlags[(int)MovingLaserProperty::VelocityCalc]; - if (item.ItemFlags[DistanceTravelled] < (moveDistance -BLOCK(0.5f))) - item.ItemFlags[SpeedCalc] = std::min(distancePerFrame, item.ItemFlags[MovingLaserFlags::SpeedCalc] + ACCELERATION); - else - item.ItemFlags[SpeedCalc] = std::max(MIN_SPEED, item.ItemFlags[MovingLaserFlags::SpeedCalc] - ACCELERATION); + if (item.ItemFlags[(int)MovingLaserProperty::DistanceTraveled] < (moveDist - BLOCK(0.5f))) + { + item.ItemFlags[(int)MovingLaserProperty::VelocityCalc] = std::min(distPerFrame, item.ItemFlags[(int)MovingLaserProperty::VelocityCalc] + MOVING_LASER_ACCEL); + } + else + { + item.ItemFlags[(int)MovingLaserProperty::VelocityCalc] = std::max(MOVING_LASER_VELOCITY_MIN, item.ItemFlags[(int)MovingLaserProperty::VelocityCalc] - MOVING_LASER_ACCEL); + } + if (item.ItemFlags[(int)MovingLaserProperty::DistanceTraveled] >= moveDist) + { + item.ItemFlags[(int)MovingLaserProperty::PauseTimer] = MOVING_LASER_PAUSE_FRAME_COUNT; + } - if (item.ItemFlags[MovingLaserFlags::DistanceTravelled] >= moveDistance) - { - item.ItemFlags[MovingLaserFlags::PauseCounter] = PAUSE_FRAMES; - } + if (item.ItemFlags[(int)MovingLaserProperty::PauseTimer] == 0) + { + SoundEffect(SFX_TR5_MOVING_LASER_LOOP, &item.Pose, SoundEnvironment::Always); + } - if (item.ItemFlags[MovingLaserFlags::PauseCounter] == 0) - { - SoundEffect(SFX_TR5_MOVING_LASER_LOOP, &item.Pose, SoundEnvironment::Always); - } + // Update room if necessary. + int roomNumber = GetPointCollision(item).GetRoomNumber(); + if (roomNumber != item.RoomNumber) + ItemNewRoom(itemNumber, roomNumber); - // Update room if necessary. - short new_room = item.RoomNumber; - GetPointCollision(item).GetRoomNumber(); - if (new_room != item.RoomNumber) - ItemNewRoom(itemNumber, new_room); - - AnimateItem(&item); - } + AnimateItem(&item); + } void CollideMovingLaser(short itemNumber, ItemInfo* playerItem, CollisionInfo* coll) { @@ -123,7 +135,7 @@ namespace TEN::Entities::Traps ObjectCollision(itemNumber, playerItem, coll); } - // Damage entity. + // Damage player. if (TestBoundsCollide(&item, playerItem, coll->Setup.Radius)) { DoDamage(playerItem, MOVING_LASER_DAMAGE); From e5d9285033b8a3b978115d7d5b5745dc9736bb71 Mon Sep 17 00:00:00 2001 From: Sezz Date: Wed, 19 Mar 2025 16:39:32 +1100 Subject: [PATCH 089/160] Adjust Probe preview --- TombEngine/Scripting/Internal/TEN/Collision/Probe.cpp | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/TombEngine/Scripting/Internal/TEN/Collision/Probe.cpp b/TombEngine/Scripting/Internal/TEN/Collision/Probe.cpp index 765715dbb..f8d26bd1d 100644 --- a/TombEngine/Scripting/Internal/TEN/Collision/Probe.cpp +++ b/TombEngine/Scripting/Internal/TEN/Collision/Probe.cpp @@ -332,8 +332,8 @@ namespace TEN::Scripting::Collision void Probe::Preview() { constexpr auto TARGET_RADIUS = 100.0f; - constexpr auto SPHERE_RADIUS = TARGET_RADIUS * 0.6f; - constexpr auto COLOR = Color(1.0f, 1.0f, 1.0f, 0.4f); + constexpr auto SPHERE_RADIUS = TARGET_RADIUS * 0.4f; + constexpr auto COLOR = Color(1.0f, 1.0f, 0.8f, 0.2f); constexpr auto DEBUG_PAGE = RendererDebugPage::CollisionStats; auto pos = _pointCollision.GetPosition().ToVector3(); From dfa817059786b2b26d1639a3a3367b503084f05b Mon Sep 17 00:00:00 2001 From: Sezz Date: Wed, 19 Mar 2025 16:42:07 +1100 Subject: [PATCH 090/160] Demagic a number --- TombEngine/Scripting/Internal/TEN/Collision/Probe.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TombEngine/Scripting/Internal/TEN/Collision/Probe.cpp b/TombEngine/Scripting/Internal/TEN/Collision/Probe.cpp index f8d26bd1d..b7295b7b9 100644 --- a/TombEngine/Scripting/Internal/TEN/Collision/Probe.cpp +++ b/TombEngine/Scripting/Internal/TEN/Collision/Probe.cpp @@ -331,7 +331,7 @@ namespace TEN::Scripting::Collision // @function Preview void Probe::Preview() { - constexpr auto TARGET_RADIUS = 100.0f; + constexpr auto TARGET_RADIUS = BLOCK(0.08f); constexpr auto SPHERE_RADIUS = TARGET_RADIUS * 0.4f; constexpr auto COLOR = Color(1.0f, 1.0f, 0.8f, 0.2f); constexpr auto DEBUG_PAGE = RendererDebugPage::CollisionStats; From 64a2d60d2f9a9cbed525d9e30881f90bae361e3d Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 22 Mar 2025 00:29:33 +0100 Subject: [PATCH 091/160] Added safeguards for problems surfaced in #1618 --- TombEngine/Game/animation.cpp | 4 ++++ TombEngine/Renderer/RendererDraw.cpp | 6 ++++++ 2 files changed, 10 insertions(+) diff --git a/TombEngine/Game/animation.cpp b/TombEngine/Game/animation.cpp index 53d0a6d46..04eb59905 100644 --- a/TombEngine/Game/animation.cpp +++ b/TombEngine/Game/animation.cpp @@ -711,6 +711,10 @@ Vector3i GetJointPosition(const ItemInfo& item, const CreatureBiteInfo& bite) Vector3 GetJointOffset(GAME_OBJECT_ID objectID, int jointIndex) { const auto& object = Objects[objectID]; + int boneIndex = object.boneIndex + (jointIndex * 4); + + if (g_Level.Bones.size() <= boneIndex) + return Vector3::Zero; int* bonePtr = &g_Level.Bones[object.boneIndex + (jointIndex * 4)]; return Vector3(*(bonePtr + 1), *(bonePtr + 2), *(bonePtr + 3)); diff --git a/TombEngine/Renderer/RendererDraw.cpp b/TombEngine/Renderer/RendererDraw.cpp index 98e29e66f..a79e06298 100644 --- a/TombEngine/Renderer/RendererDraw.cpp +++ b/TombEngine/Renderer/RendererDraw.cpp @@ -2571,6 +2571,12 @@ namespace TEN::Renderer if (!SetupBlendModeAndAlphaTest(bucket.BlendMode, rendererPass, p)) continue; + if (_staticTextures.size() <= bucket.Texture) + { + TENLog("Attempted to set incorrect static mesh texture atlas", LogLevel::Warning); + continue; + } + BindTexture(TextureRegister::ColorMap, &std::get<0>(_staticTextures[bucket.Texture]), SamplerStateRegister::AnisotropicClamp); From c608e6dec5d76ee2453486b6405173cf14079e77 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 22 Mar 2025 00:30:52 +0100 Subject: [PATCH 092/160] Update CHANGELOG.md --- CHANGELOG.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index edf146d46..78bf16d1c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,8 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): ### Bug fixes * Fixed particles remaining in the level after reloading from the savegame. * Fixed particles being canceled by fog bulbs. +* Fixed crash in case hair object is the last object in a level. +* Fixed crash with incorrectly applied animated textures on static meshes. ### Lua API changes * Added missing constructor for `Collision.Probe` without room number. From 8c26702678cd4c167a26c87ef5e89cce9aa76365 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 22 Mar 2025 08:31:05 +0100 Subject: [PATCH 093/160] Always warn about different game version --- TombEngine/Specific/level.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TombEngine/Specific/level.cpp b/TombEngine/Specific/level.cpp index 3addd27f9..4935ecb0a 100644 --- a/TombEngine/Specific/level.cpp +++ b/TombEngine/Specific/level.cpp @@ -1317,7 +1317,7 @@ bool LoadLevel(const std::string& path, bool partial) auto assemblyVersion = TEN::Utils::GetProductOrFileVersion(true); for (int i = 0; i < assemblyVersion.size(); i++) { - if (assemblyVersion[i] < version[i]) + if (assemblyVersion[i] != version[i]) { TENLog("Level version is different from TEN version.", LogLevel::Warning); break; From b1ee6a190eb1a4fdf5af76406a2bb18492b5986e Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 22 Mar 2025 09:42:01 +0100 Subject: [PATCH 094/160] Added ability to perform Lua commands in the console window in realtime --- CHANGELOG.md | 37 +++++++++++++++++--------------- TombEngine/Specific/winmain.cpp | 38 +++++++++++++++++++++++++++++++-- 2 files changed, 56 insertions(+), 19 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 78bf16d1c..30710e1f3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,9 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): ## [Version 1.8.1](link to release) - yyyy-mm-dd +### New features +* Added ability to perform Lua commands in the console window in realtime. + ### Bug fixes * Fixed particles remaining in the level after reloading from the savegame. * Fixed particles being canceled by fog bulbs. @@ -35,7 +38,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed custom shatter sounds with custom sound IDs not playing correctly. * Fixed crashes with sound samples larger than 2 megabytes. -### New Features +### New features * Added multithreading and an option for it to flow system settings. * Added ability to use floor trapdoors, keys and puzzle items underwater. - You must update your Lara object: https://github.com/TombEngine/Resources/raw/main/Wad2%20Objects/Lara/TEN_Lara.wad2 @@ -84,7 +87,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed gravity being applied underwater when exiting the fly cheat. * Fixed gravity being applied when vaulting on the same frame as the player lands. -### New Features +### New features * Added realtime shader reloading in debug mode by pressing F9 key. * Added load, save, stopwatch and compass as a functional pick-up items with ability to add or remove them from inventory. * Increased particle limit from 1024 to 4096. @@ -134,7 +137,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed spotlight shadows. * Fixed Skeleton and Mummy not reacting to shotgun hits. -### New Features +### New features * Added classic mirror effect with ability to reflect moveables and static meshes. * Added ability to customize many hardcoded parameters, such as flare, weapon, and hair settings. * Added dynamic shadow casting on objects and static meshes. @@ -210,7 +213,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed display sprites and display strings rendering in the inventory background. * Fixed young Lara hair drawing. https://tombengine.com/docs/level-settings/#young_lara -### New Features +### New features * Added high framerate mode (also known as 60 FPS mode). * Added a customisable global lensflare effect. https://tombengine.com/docs/level-settings/#lensflare * Added a customisable starry sky and meteor effect. https://tombengine.com/docs/level-settings/#stars @@ -270,7 +273,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed bottom collision for solid static meshes. * Fixed T-Rex's head rotation. -### New Features +### New features * Auto-switch to a crawl state if player start position is in a crawlspace. * Allow directional flame emitter (negative OCBs) to be rotated at any angle. * Revise wall spikes: @@ -317,7 +320,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed incorrect light collection in some cases. * Fixed normal mapping for rooms, items, and statics.' -### New Features +### New features * Added ambient occlusion (SSAO). * Added new post-process workflow (monochrome, negative, exclusion) with tinting. * Added SMAA antialiasing instead of MSAA. @@ -376,7 +379,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fix camera snap when disengaging the look-around mode. * Fix TR4 mapper not being visible. -### New Features +### New features * Improve head-on wall collision. * Overhaul pushables: - Separate climbable and non-climbable pushable object slots. @@ -459,7 +462,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fix incorrect culling for scaled static meshes. * Fix normal mapping. -### New Features +### New features * Add ability to save screenshot in the "Screenshots" subfolder by pressing the "Print screen" key. * Implement separate audio track channel for playing voiceovers with subtitles in .srt format. * Don't stop ambience when Lara dies. @@ -507,7 +510,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fix rendering for static meshes with custom blending modes and alpha transparency. * Fix inconsistent multiline string spacing on different display modes. -### New Features +### New features * Remove search object 4 hardcoded meshswap activated with a flipmap. * Add TR1 cowboy. * Add TR3 wall mounted blade. @@ -565,7 +568,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): - Please note you must use the patched version found here: https://github.com/TombEngine/Resources/blob/main/Wad2%20Objects/tr5_Imp.wad2 * Fix and improve wraith tails. -### New Features/Amedments +### New features/Amedments * Add dedicated WRAITH_TRAP object with enhanced effects. - OCB 0: Effect disabled. - OCB 1: Effect enabled. @@ -614,7 +617,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fix TR3 big gun spawning rocket with 0 life which caused an immediate explosion. * Fix TR3 Tony and add boss effect for him. -### New Features +### New features * Add TR3 civvy. * Add TR3 electric cleaner. * Add TR3 Sophia Leigh with following OCBs: @@ -666,7 +669,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fix grenade and rocket launcher lighting. * Fix ceiling trapdoor and floor trapdoor that Lara couldn't open manually. -### New Features +### New features * Make enemies drop pickups at first available bounding box corner point, not centerpoint. * Restore original volumetric explosion effects. * Add TR3 lizard and Puna. @@ -718,7 +721,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fix bone rotations of some entities. * Fix Lara's animation for cog switch release. -### New Features +### New features * Added new OCB to cog switch object: - Use OCB 0 to have the traditional behaviour. - Use any other OCB to can use the Cog Switch without need of any door linked. @@ -732,7 +735,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): ## [Version 1.0.4](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.6.2) - 2022-12-16 -### New Features +### New features * Add generic assignable effects for moveables - fire, sparks, smoke and laser / electric ignite. * Add ability to burn enemies with FLAME_EMITTER_1 and death blocks. * Add wireframe mode and other visual debug information (switch by F10/F11 debug page scroll hotkeys). @@ -804,7 +807,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): ## [Version 1.0.3](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.6.1) - 2022-11-18 -### New Features +### New features * Add ledge jumps (Lara object must be updated with new animations to make it work). * Allow any object slot to be used as a meshswap. * Add OCB 1 for rollingball to make it silent. @@ -872,7 +875,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): ## [Version 1.0.2](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.6) - 2022-09-16 -### New Features +### New features * Fix removing Pistols with TakeItem and SetItemCount. * Allow saving and loading of Vec3s in LevelVars and GameVars. * Support volume triggers made with node editor. @@ -927,7 +930,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): ## [Version 1.0.1](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.5.2) - 2022-08-16 -### New Features +### New features * Added antialiasing support. * Added static mesh scaling support. * Added free rotation for teeth spikes instead of using OCB codes. diff --git a/TombEngine/Specific/winmain.cpp b/TombEngine/Specific/winmain.cpp index bd7b2cefa..d120636c4 100644 --- a/TombEngine/Specific/winmain.cpp +++ b/TombEngine/Specific/winmain.cpp @@ -30,8 +30,8 @@ using std::cout; using std::endl; WINAPP App; -unsigned int ThreadID; -uintptr_t ThreadHandle; +unsigned int ThreadID, ConsoleThreadID; +uintptr_t ThreadHandle, ConsoleThreadHandle; HACCEL hAccTable; bool DebugMode = false; HWND WindowsHandle; @@ -242,6 +242,37 @@ bool GenerateDummyLevel(const std::string& levelPath) return true; } +unsigned CALLBACK ConsoleInput(void*) +{ + std::string input; + + while (!ThreadEnded) + { + if (!std::getline(std::cin, input)) + break; + + if (g_GameScript == nullptr) + { + TENLog("Scripting engine not initialized.", LogLevel::Error); + continue; + } + else + { + try + { + g_GameScript->ExecuteString(input); + } + catch (const exception& ex) + { + std::string error = ex.what(); + TENLog("Error executing " + input + ": " + error.substr(error.find(":1: ") + 4), LogLevel::Error); + } + } + } + + return true; +} + void WinProcMsg() { MSG msg; @@ -406,7 +437,9 @@ int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine #ifndef _DEBUG if (!DebugMode) ShowWindow(GetConsoleWindow(), 0); + else #endif + ConsoleThreadHandle = BeginThread(ConsoleInput, ConsoleThreadID); // Clear application structure. memset(&App, 0, sizeof(WINAPP)); @@ -615,6 +648,7 @@ int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine void WinClose() { + CloseHandle((HANDLE)ConsoleThreadHandle); WaitForSingleObject((HANDLE)ThreadHandle, 5000); DestroyAcceleratorTable(hAccTable); From 075c438b5d4c76e30c623941a61bbc55ca27114a Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 22 Mar 2025 09:49:03 +0100 Subject: [PATCH 095/160] Update CHANGELOG.md --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 30710e1f3..622cb7839 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,7 +6,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): ## [Version 1.8.1](link to release) - yyyy-mm-dd ### New features -* Added ability to perform Lua commands in the console window in realtime. +* Added live console input to perform Lua commands in realtime. ### Bug fixes * Fixed particles remaining in the level after reloading from the savegame. From d47e8d0e6989d5461be7f281005f33989b3818a1 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 22 Mar 2025 09:57:25 +0100 Subject: [PATCH 096/160] Don't try to execute empty lines --- TombEngine/Specific/winmain.cpp | 3 +++ 1 file changed, 3 insertions(+) diff --git a/TombEngine/Specific/winmain.cpp b/TombEngine/Specific/winmain.cpp index d120636c4..5a68753bc 100644 --- a/TombEngine/Specific/winmain.cpp +++ b/TombEngine/Specific/winmain.cpp @@ -251,6 +251,9 @@ unsigned CALLBACK ConsoleInput(void*) if (!std::getline(std::cin, input)) break; + if (std::regex_match(input, std::regex("^\\s*$"))) + continue; + if (g_GameScript == nullptr) { TENLog("Scripting engine not initialized.", LogLevel::Error); From f0f733519fbdc465804cc09abe32371e939908c2 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 22 Mar 2025 10:01:51 +0100 Subject: [PATCH 097/160] Simplify error message --- TombEngine/Specific/winmain.cpp | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/TombEngine/Specific/winmain.cpp b/TombEngine/Specific/winmain.cpp index 5a68753bc..01d13bf8c 100644 --- a/TombEngine/Specific/winmain.cpp +++ b/TombEngine/Specific/winmain.cpp @@ -267,8 +267,7 @@ unsigned CALLBACK ConsoleInput(void*) } catch (const exception& ex) { - std::string error = ex.what(); - TENLog("Error executing " + input + ": " + error.substr(error.find(":1: ") + 4), LogLevel::Error); + TENLog("Error executing " + input + ": " + ex.what(), LogLevel::Error); } } } From e27ec86e853ad0f24c524e8fc8a5139e8f86f908 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 22 Mar 2025 10:28:12 +0100 Subject: [PATCH 098/160] Allow to run console input in freeze modes as well --- .../Scripting/Include/ScriptInterfaceGame.h | 1 + .../Internal/TEN/Logic/LogicHandler.cpp | 26 +++++++++++++++++++ .../Internal/TEN/Logic/LogicHandler.h | 5 +++- TombEngine/Specific/winmain.cpp | 13 +--------- 4 files changed, 32 insertions(+), 13 deletions(-) diff --git a/TombEngine/Scripting/Include/ScriptInterfaceGame.h b/TombEngine/Scripting/Include/ScriptInterfaceGame.h index 73b0be0ee..121cbe2f2 100644 --- a/TombEngine/Scripting/Include/ScriptInterfaceGame.h +++ b/TombEngine/Scripting/Include/ScriptInterfaceGame.h @@ -62,6 +62,7 @@ public: virtual void OnUseItem(GAME_OBJECT_ID objectNumber) = 0; virtual void OnFreeze() = 0; + virtual void AddConsoleInput(const std::string& input) = 0; virtual void ShortenTENCalls() = 0; virtual void FreeLevelScripts() = 0; virtual void ResetScripts(bool clearGameVars) = 0; diff --git a/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp b/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp index e85c98ce5..e1cf4ed6b 100644 --- a/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp +++ b/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp @@ -620,6 +620,28 @@ int Handle(TypeFrom& var, MapType& varsMap, size_t& numVars, std::vectorsecond; } +void LogicHandler::AddConsoleInput(const std::string& input) +{ + _consoleInput = input; +} + +void LogicHandler::PerformConsoleInput() +{ + if (!_consoleInput.empty()) + { + try + { + ExecuteString(_consoleInput); + } + catch (const std::exception& ex) + { + TENLog("Error executing " + _consoleInput + ": " + ex.what(), LogLevel::Error); + } + + _consoleInput.clear(); + } +} + std::string LogicHandler::GetRequestedPath() const { auto path = std::string(); @@ -1027,6 +1049,8 @@ void LogicHandler::OnLoop(float deltaTime, bool postLoop) for (const auto& name : _callbacksPreLoop) CallLevelFuncByName(name, deltaTime); + PerformConsoleInput(); + lua_gc(_handler.GetState()->lua_state(), LUA_GCCOLLECT, 0); if (_onLoop.valid()) CallLevelFunc(_onLoop, deltaTime); @@ -1099,6 +1123,8 @@ void LogicHandler::OnFreeze() for (const auto& name : _callbacksPreFreeze) CallLevelFuncByName(name); + PerformConsoleInput(); + if (_onFreeze.valid()) CallLevelFunc(_onFreeze); diff --git a/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.h b/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.h index f4f7ff481..8ff7be4e2 100644 --- a/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.h +++ b/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.h @@ -75,11 +75,13 @@ private: sol::protected_function _onFreeze = {}; std::unordered_map*> _callbacks; - std::vector> _savedVarPath; bool _shortenedCalls = false; + std::string _consoleInput = ""; + void PerformConsoleInput(); + std::string GetRequestedPath() const; void ResetLevelTables(); @@ -132,6 +134,7 @@ public: void HandleEvent(const std::string& name, EventType type, sol::optional activator); void EnableEvent(const std::string& name, EventType type); void DisableEvent(const std::string& name, EventType type); + void AddConsoleInput(const std::string& input); void ResetScripts(bool clearGameVars) override; void ShortenTENCalls() override; diff --git a/TombEngine/Specific/winmain.cpp b/TombEngine/Specific/winmain.cpp index 01d13bf8c..f4cf4d9da 100644 --- a/TombEngine/Specific/winmain.cpp +++ b/TombEngine/Specific/winmain.cpp @@ -24,10 +24,6 @@ using namespace TEN::Renderer; using namespace TEN::Input; using namespace TEN::Utils; -using std::exception; -using std::string; -using std::cout; -using std::endl; WINAPP App; unsigned int ThreadID, ConsoleThreadID; @@ -261,14 +257,7 @@ unsigned CALLBACK ConsoleInput(void*) } else { - try - { - g_GameScript->ExecuteString(input); - } - catch (const exception& ex) - { - TENLog("Error executing " + input + ": " + ex.what(), LogLevel::Error); - } + g_GameScript->AddConsoleInput(input); } } From 8427ae770621d2cd3f195378d31a4190472b7948 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 22 Mar 2025 10:37:36 +0100 Subject: [PATCH 099/160] Update winmain.cpp --- TombEngine/Specific/winmain.cpp | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/TombEngine/Specific/winmain.cpp b/TombEngine/Specific/winmain.cpp index f4cf4d9da..3efdd8b20 100644 --- a/TombEngine/Specific/winmain.cpp +++ b/TombEngine/Specific/winmain.cpp @@ -639,7 +639,9 @@ int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine void WinClose() { - CloseHandle((HANDLE)ConsoleThreadHandle); + if (ConsoleThreadHandle) + CloseHandle((HANDLE)ConsoleThreadHandle); + WaitForSingleObject((HANDLE)ThreadHandle, 5000); DestroyAcceleratorTable(hAccTable); From 382b9d1ef59425fb9c43272b400f11dab9b47031 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 22 Mar 2025 10:56:17 +0100 Subject: [PATCH 100/160] Fixed incorrect debug line --- TombEngine/Renderer/RendererDrawMenu.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TombEngine/Renderer/RendererDrawMenu.cpp b/TombEngine/Renderer/RendererDrawMenu.cpp index 87de33b5c..e38f1e440 100644 --- a/TombEngine/Renderer/RendererDrawMenu.cpp +++ b/TombEngine/Renderer/RendererDrawMenu.cpp @@ -1331,7 +1331,7 @@ namespace TEN::Renderer PrintDebugMessage("RoomNumber: %d", LaraItem->RoomNumber); PrintDebugMessage("PathfindingBoxID: %d", LaraItem->BoxNumber); PrintDebugMessage((Lara.Context.WaterSurfaceDist == -NO_HEIGHT ? "WaterSurfaceDist: N/A" : "WaterSurfaceDist: %d"), Lara.Context.WaterSurfaceDist); - PrintDebugMessage("Room Position: %d, %d, %d, %d", room.Position.z, room.Position.z, room.Position.z + BLOCK(room.XSize), room.Position.z + BLOCK(room.ZSize)); + PrintDebugMessage("Room Bounds: (%d, %d), (%d, %d)", room.Position.x, room.Position.z, room.Position.x + BLOCK(room.XSize), room.Position.z + BLOCK(room.ZSize)); PrintDebugMessage("Room.y, minFloor, maxCeiling: %d, %d, %d ", room.Position.y, room.BottomHeight, room.TopHeight); PrintDebugMessage("Camera Position: %d, %d, %d", Camera.pos.x, Camera.pos.y, Camera.pos.z); PrintDebugMessage("Camera LookAt: %d, %d, %d", Camera.target.x, Camera.target.y, Camera.target.z); From ac77c5f9ad007944fa89c1bda5b716cac4325088 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 23 Mar 2025 08:24:36 +0100 Subject: [PATCH 101/160] Rollback MovingLaserFlags rename, bump version number --- TombEngine/Objects/TR5/Trap/MovingLaser.cpp | 34 ++++++++++----------- TombEngine/version.h | 4 +-- 2 files changed, 19 insertions(+), 19 deletions(-) diff --git a/TombEngine/Objects/TR5/Trap/MovingLaser.cpp b/TombEngine/Objects/TR5/Trap/MovingLaser.cpp index bb07f8c19..830d14746 100644 --- a/TombEngine/Objects/TR5/Trap/MovingLaser.cpp +++ b/TombEngine/Objects/TR5/Trap/MovingLaser.cpp @@ -23,7 +23,7 @@ namespace TEN::Entities::Traps constexpr auto MOVING_LASER_ACCEL = 1.0f; constexpr auto MOVING_LASER_PAUSE_FRAME_COUNT = 30; - enum class MovingLaserProperty + enum class MovingLaserFlags { Velocity, PauseTimer, @@ -35,8 +35,8 @@ namespace TEN::Entities::Traps void InitializeMovingLaser(short itemNumber) { auto& item = g_Level.Items[itemNumber]; - item.ItemFlags[(int)MovingLaserProperty::DirectionSign] = 1; - item.ItemFlags[(int)MovingLaserProperty::Velocity] = 10; + item.ItemFlags[(int)MovingLaserFlags::DirectionSign] = 1; + item.ItemFlags[(int)MovingLaserFlags::Velocity] = 10; // Offset by 1/4 block to make it dangerous at sector edges. item.Pose.Translate(item.Pose.Orientation, -BLOCK(0.25f)); @@ -51,7 +51,7 @@ namespace TEN::Entities::Traps // Calculate distances. float moveDist = BLOCK(item.TriggerFlags) + BLOCK(0.5f); - float distPerFrame = (BLOCK(item.ItemFlags[(int)MovingLaserProperty::Velocity]) * 0.25f) / (float)FPS; + float distPerFrame = (BLOCK(item.ItemFlags[(int)MovingLaserFlags::Velocity]) * 0.25f) / (float)FPS; item.Animation.ActiveState = 0; @@ -74,38 +74,38 @@ namespace TEN::Entities::Traps return; } - if (item.ItemFlags[(int)MovingLaserProperty::PauseTimer] > 0) + if (item.ItemFlags[(int)MovingLaserFlags::PauseTimer] > 0) { - item.ItemFlags[(int)MovingLaserProperty::PauseTimer]--; - if (item.ItemFlags[(int)MovingLaserProperty::PauseTimer] == 0) + item.ItemFlags[(int)MovingLaserFlags::PauseTimer]--; + if (item.ItemFlags[(int)MovingLaserFlags::PauseTimer] == 0) { - item.ItemFlags[(int)MovingLaserProperty::DirectionSign] *= -1; - item.ItemFlags[(int)MovingLaserProperty::DistanceTraveled] = 0; + item.ItemFlags[(int)MovingLaserFlags::DirectionSign] *= -1; + item.ItemFlags[(int)MovingLaserFlags::DistanceTraveled] = 0; } AnimateItem(&item); return; } - item.Pose.Translate(item.Pose.Orientation, (item.ItemFlags[(int)MovingLaserProperty::DirectionSign] * item.ItemFlags[(int)MovingLaserProperty::VelocityCalc])); + item.Pose.Translate(item.Pose.Orientation, (item.ItemFlags[(int)MovingLaserFlags::DirectionSign] * item.ItemFlags[(int)MovingLaserFlags::VelocityCalc])); - item.ItemFlags[(int)MovingLaserProperty::DistanceTraveled] += item.ItemFlags[(int)MovingLaserProperty::VelocityCalc]; + item.ItemFlags[(int)MovingLaserFlags::DistanceTraveled] += item.ItemFlags[(int)MovingLaserFlags::VelocityCalc]; - if (item.ItemFlags[(int)MovingLaserProperty::DistanceTraveled] < (moveDist - BLOCK(0.5f))) + if (item.ItemFlags[(int)MovingLaserFlags::DistanceTraveled] < (moveDist - BLOCK(0.5f))) { - item.ItemFlags[(int)MovingLaserProperty::VelocityCalc] = std::min(distPerFrame, item.ItemFlags[(int)MovingLaserProperty::VelocityCalc] + MOVING_LASER_ACCEL); + item.ItemFlags[(int)MovingLaserFlags::VelocityCalc] = std::min(distPerFrame, item.ItemFlags[(int)MovingLaserFlags::VelocityCalc] + MOVING_LASER_ACCEL); } else { - item.ItemFlags[(int)MovingLaserProperty::VelocityCalc] = std::max(MOVING_LASER_VELOCITY_MIN, item.ItemFlags[(int)MovingLaserProperty::VelocityCalc] - MOVING_LASER_ACCEL); + item.ItemFlags[(int)MovingLaserFlags::VelocityCalc] = std::max(MOVING_LASER_VELOCITY_MIN, item.ItemFlags[(int)MovingLaserFlags::VelocityCalc] - MOVING_LASER_ACCEL); } - if (item.ItemFlags[(int)MovingLaserProperty::DistanceTraveled] >= moveDist) + if (item.ItemFlags[(int)MovingLaserFlags::DistanceTraveled] >= moveDist) { - item.ItemFlags[(int)MovingLaserProperty::PauseTimer] = MOVING_LASER_PAUSE_FRAME_COUNT; + item.ItemFlags[(int)MovingLaserFlags::PauseTimer] = MOVING_LASER_PAUSE_FRAME_COUNT; } - if (item.ItemFlags[(int)MovingLaserProperty::PauseTimer] == 0) + if (item.ItemFlags[(int)MovingLaserFlags::PauseTimer] == 0) { SoundEffect(SFX_TR5_MOVING_LASER_LOOP, &item.Pose, SoundEnvironment::Always); } diff --git a/TombEngine/version.h b/TombEngine/version.h index 464c2b659..654ddf744 100644 --- a/TombEngine/version.h +++ b/TombEngine/version.h @@ -2,12 +2,12 @@ #define TE_MAJOR_VERSION 1 #define TE_MINOR_VERSION 8 -#define TE_BUILD_NUMBER 0 +#define TE_BUILD_NUMBER 1 #define TE_REVISION_NUMBER 0 #define TEN_MAJOR_VERSION 1 #define TEN_MINOR_VERSION 8 -#define TEN_BUILD_NUMBER 0 +#define TEN_BUILD_NUMBER 1 #define TEN_REVISION_NUMBER 0 #define TEST_BUILD 1 From 78e8d34c005f80497840cb6bc0e6dab16963ac00 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Mon, 24 Mar 2025 22:03:52 +0100 Subject: [PATCH 102/160] Fixed console on Win11 and monkey pathfinding --- CHANGELOG.md | 2 ++ TombEngine/Game/control/box.cpp | 10 +++++++--- TombEngine/Specific/winmain.cpp | 2 +- 3 files changed, 10 insertions(+), 4 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 622cb7839..9dab845db 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,10 +9,12 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added live console input to perform Lua commands in realtime. ### Bug fixes +* Fixed pathfinding for friendly NPCs, such as monkeys. * Fixed particles remaining in the level after reloading from the savegame. * Fixed particles being canceled by fog bulbs. * Fixed crash in case hair object is the last object in a level. * Fixed crash with incorrectly applied animated textures on static meshes. +* Fixed console window not hiding in non-debug mode on Windows 11. ### Lua API changes * Added missing constructor for `Collision.Probe` without room number. diff --git a/TombEngine/Game/control/box.cpp b/TombEngine/Game/control/box.cpp index b60256557..763dfec8b 100644 --- a/TombEngine/Game/control/box.cpp +++ b/TombEngine/Game/control/box.cpp @@ -1150,6 +1150,7 @@ bool StalkBox(ItemInfo* item, ItemInfo* enemy, int boxNumber) { if (enemy == nullptr || boxNumber == NO_VALUE) return false; + auto* box = &g_Level.PathfindingBoxes[boxNumber]; int xRange = STALK_DIST + ((box->bottom - box->top) * BLOCK(1)); @@ -1635,8 +1636,11 @@ void CreatureMood(ItemInfo* item, AI_INFO* AI, bool isViolent) auto* LOT = &creature->LOT; auto* enemy = creature->Enemy; - if (enemy == nullptr) - return; + + // HACK: Fallback to bored mood from attack mood if enemy was cleared. + // Replaces previous "fix" with early exit, because it was breaking friendly NPC pathfinding. -- Lwmte, 24.03.25 + if (enemy == nullptr && creature->Mood == MoodType::Attack) + creature->Mood = MoodType::Bored; int boxNumber; switch (creature->Mood) @@ -1645,7 +1649,7 @@ void CreatureMood(ItemInfo* item, AI_INFO* AI, bool isViolent) boxNumber = LOT->Node[GetRandomControl() * LOT->ZoneCount >> 15].boxNumber; if (ValidBox(item, AI->zoneNumber, boxNumber)) { - if (StalkBox(item, enemy, boxNumber) && enemy->HitPoints > 0 && creature->Enemy) + if (StalkBox(item, enemy, boxNumber) && creature->Enemy && enemy->HitPoints > 0) { TargetBox(LOT, boxNumber); creature->Mood = MoodType::Bored; diff --git a/TombEngine/Specific/winmain.cpp b/TombEngine/Specific/winmain.cpp index 3efdd8b20..6384e29b4 100644 --- a/TombEngine/Specific/winmain.cpp +++ b/TombEngine/Specific/winmain.cpp @@ -427,7 +427,7 @@ int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine // Hide console window if mode isn't debug. #ifndef _DEBUG if (!DebugMode) - ShowWindow(GetConsoleWindow(), 0); + FreeConsole(); else #endif ConsoleThreadHandle = BeginThread(ConsoleInput, ConsoleThreadID); From c2c6b5f0726eebbb0e745691e5651ece67b18dd5 Mon Sep 17 00:00:00 2001 From: Sezz Date: Tue, 25 Mar 2025 15:05:07 +1100 Subject: [PATCH 103/160] Minor changes --- TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.h | 3 ++- TombEngine/Specific/winmain.cpp | 7 +++++-- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.h b/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.h index 8ff7be4e2..cbc659d14 100644 --- a/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.h +++ b/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.h @@ -79,7 +79,8 @@ private: bool _shortenedCalls = false; - std::string _consoleInput = ""; + std::string _consoleInput = {}; + void PerformConsoleInput(); std::string GetRequestedPath() const; diff --git a/TombEngine/Specific/winmain.cpp b/TombEngine/Specific/winmain.cpp index 6384e29b4..560073115 100644 --- a/TombEngine/Specific/winmain.cpp +++ b/TombEngine/Specific/winmain.cpp @@ -240,8 +240,7 @@ bool GenerateDummyLevel(const std::string& levelPath) unsigned CALLBACK ConsoleInput(void*) { - std::string input; - + auto input = std::string(); while (!ThreadEnded) { if (!std::getline(std::cin, input)) @@ -427,10 +426,14 @@ int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine // Hide console window if mode isn't debug. #ifndef _DEBUG if (!DebugMode) + { FreeConsole(); + } else #endif + { ConsoleThreadHandle = BeginThread(ConsoleInput, ConsoleThreadID); + } // Clear application structure. memset(&App, 0, sizeof(WINAPP)); From 22195b32675b0729f4a89abf02f8d380f3bda03e Mon Sep 17 00:00:00 2001 From: Sezz Date: Wed, 26 Mar 2025 23:26:00 +1100 Subject: [PATCH 104/160] Fix key binding settings saving for current session after hitting Esc to cancel --- CHANGELOG.md | 3 ++- TombEngine/Game/gui.cpp | 19 +++++++++++++------ TombEngine/Game/gui.h | 6 +++--- 3 files changed, 18 insertions(+), 10 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9dab845db..4e17ee3ae 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,12 +9,13 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added live console input to perform Lua commands in realtime. ### Bug fixes -* Fixed pathfinding for friendly NPCs, such as monkeys. +* Fixed pathfinding for friendly NPCs such as monkeys. * Fixed particles remaining in the level after reloading from the savegame. * Fixed particles being canceled by fog bulbs. * Fixed crash in case hair object is the last object in a level. * Fixed crash with incorrectly applied animated textures on static meshes. * Fixed console window not hiding in non-debug mode on Windows 11. +* Fixed key binding settings saving for the current play session after hitting Esc to cancel. ### Lua API changes * Added missing constructor for `Collision.Probe` without room number. diff --git a/TombEngine/Game/gui.cpp b/TombEngine/Game/gui.cpp index a024419a2..46558185d 100644 --- a/TombEngine/Game/gui.cpp +++ b/TombEngine/Game/gui.cpp @@ -690,7 +690,7 @@ namespace TEN::Gui CurrentSettings.IgnoreInput = true; } - if (CurrentSettings.NewKeyWaitTimer > 0.0f) + if (CurrentSettings.NewKeyWaitTimer > 0) { ClearAllActions(); @@ -699,15 +699,15 @@ namespace TEN::Gui bool legacy30FpsDoneDraw = false; bool decreaseCounter = false; - while (CurrentSettings.NewKeyWaitTimer > 0.0f) + while (CurrentSettings.NewKeyWaitTimer > 0) { g_Synchronizer.Sync(); while (g_Synchronizer.Synced()) { - CurrentSettings.NewKeyWaitTimer -= 1.0f; - if (CurrentSettings.NewKeyWaitTimer <= 0.0f) - CurrentSettings.NewKeyWaitTimer = 0.0f; + CurrentSettings.NewKeyWaitTimer--; + if (CurrentSettings.NewKeyWaitTimer <= 0) + CurrentSettings.NewKeyWaitTimer = 0; if (!fromPauseMenu) { @@ -760,7 +760,7 @@ namespace TEN::Gui g_Bindings.SetKeyBinding(InputDeviceID::Custom, InputActionID(baseIndex + SelectedOption), selectedKeyID); DefaultConflict(); - CurrentSettings.NewKeyWaitTimer = 0.0f; + CurrentSettings.NewKeyWaitTimer = 0; CurrentSettings.IgnoreInput = true; return; } @@ -850,6 +850,7 @@ namespace TEN::Gui if (SelectedOption == (OptionCount - 2)) { SoundEffect(SFX_TR4_MENU_SELECT, nullptr, SoundEnvironment::Always); + ApplyDefaultBindings(); return; } @@ -858,9 +859,11 @@ namespace TEN::Gui if (SelectedOption == (OptionCount - 1)) { SoundEffect(SFX_TR4_MENU_SELECT, nullptr, SoundEnvironment::Always); + CurrentSettings.Configuration.Bindings = g_Bindings.GetBindingProfile(InputDeviceID::Custom); g_Configuration.Bindings = g_Bindings.GetBindingProfile(InputDeviceID::Custom); SaveConfiguration(); + MenuToDisplay = fromPauseMenu ? Menu::Pause : Menu::Options; SelectedOption = 2; return; @@ -870,7 +873,9 @@ namespace TEN::Gui if (SelectedOption == OptionCount) { SoundEffect(SFX_TR4_MENU_SELECT, nullptr, SoundEnvironment::Always); + g_Bindings.SetBindingProfile(InputDeviceID::Custom, CurrentSettings.Configuration.Bindings); + MenuToDisplay = fromPauseMenu ? Menu::Pause : Menu::Options; SelectedOption = 2; return; @@ -881,6 +886,8 @@ namespace TEN::Gui { SoundEffect(SFX_TR4_MENU_SELECT, nullptr, SoundEnvironment::Always); + g_Bindings.SetBindingProfile(InputDeviceID::Custom, CurrentSettings.Configuration.Bindings); + MenuToDisplay = Menu::Options; SelectedOption = 2; } diff --git a/TombEngine/Game/gui.h b/TombEngine/Game/gui.h index bca6f8b3a..8a04f1e9c 100644 --- a/TombEngine/Game/gui.h +++ b/TombEngine/Game/gui.h @@ -111,9 +111,9 @@ namespace TEN::Gui GameConfiguration Configuration = {}; - int SelectedScreenResolution = 0; - bool IgnoreInput = false; // Ignore input until all actions are inactive. - float NewKeyWaitTimer = 0.0f; + int SelectedScreenResolution = 0; + bool IgnoreInput = false; // Ignore input until all actions are inactive. + int NewKeyWaitTimer = 0; }; class GuiController From 539c19bdee440763adf332ab6301d057e5155824 Mon Sep 17 00:00:00 2001 From: Sezz Date: Thu, 27 Mar 2025 03:43:10 +1100 Subject: [PATCH 105/160] Update README.md --- README.md | 56 +++++++++++++++++++++++++++---------------------------- 1 file changed, 28 insertions(+), 28 deletions(-) diff --git a/README.md b/README.md index 5ad28cfa3..557b222d6 100644 --- a/README.md +++ b/README.md @@ -1,41 +1,41 @@ -# TombEngine +# Tomb Engine ![Logo](https://github.com/MontyTRC89/TombEngine/blob/7c50d26ca898c74978336d41e16ce3ce0c8ecacd/TEN%20logo.png) -TombEngine (TEN) is an open-source, custom level engine which aims to abolish limits and fix bugs of the classic Tomb Raider games, introduce new features while refining old ones, and provide user-friendly level creation process. Current support includes: -- Lua (as the native scripting language) -- Many objects from the original series (1-5) -- Support for high framerate, antialiasing, mipmapping and SSAO -- Full diagonal geometry support -- Uncapped map size -- A streamlined player control scheme. +*Tomb Engine* (*TEN*) is an open-source custom level engine which aims to abolish limits and fix bugs of the classic Tomb Raider games. It aims to introduce new features, refine old ones, and provide a user-friendly level creation process. Current support includes: +- *Lua* as the native scripting language. +- Many objects from the original series (1-5). +- Support for high framerate, antialiasing, mipmapping, and SSAO. +- Full diagonal geometry support. +- Uncapped map size. +- A streamlined player control scheme.. -If you would like to participate in TEN discussion with other TEN devs whether it is contributing, bugs or general discussion, then join this discord server: https://discord.gg/h5tUYFmres +Contributions are welcome. If you would like to participate in development to any degree, whether that be through suggestions, bug reports, or code, join our [Discord server](https://discord.gg/h5tUYFmres). -Tomb Engine should be used in conjuction with Tomb Editor. Tomb Editor is also open source written in C#, you can find the repository here: https://github.com/MontyTRC89/Tomb-Editor +*Tomb Engine* is used in conjunction with *Tomb Editor*. The repository can be found [here](https://github.com/MontyTRC89/Tomb-Editor). -# Compiling TombEngine -To compile TEN, ensure you have installed: -- Microsoft Visual Studio -- Tomb Editor (if you would like to create and test levels) +# Compiling *Tomb Engine* +To compile *TEN*, ensure you have installed: +- *Microsoft Visual Studio* +- *Tomb Editor* (for level creation and testing) Steps: -1) Clone the repository to your GitHub Desktop -2) Open TombEngine.sln -4) Compile the solution -5) Once compiled, create a separate folder to serve as your main TEN directory (or create test TEN project using TombIDE) -6) Copy everything inside the Build folder to the main TEN directory -7) Ensure you have the necessary level data and texture files as well -8) In the case Windows warns about missing DLLs, (bass.dll, etc.) copy the missing DLL files found inside the Libs folder to your main TEN directory. +1) Clone the repository to your GitHub Desktop. +2) Open `TombEngine.sln`. +4) Compile the solution. +5) Once compiled, create a separate folder to serve as your main *TEN* directory (or create a test *TEN* project using *TombIDE*) +6) Copy everything inside the `Build` folder to the main *TEN* directory. +7) Ensure you have the necessary level data and texture files. +8) In case Windows warns about missing DLLs (bass.dll, etc.), copy the missing DLL files found inside the `Libs` folder to your main `TEN` directory. -Visual Studio may also warn about NuGet packages. To fix: -1) Delete the Packages folder -2) Go back to Microsoft Visual Studio -3) Right-click on the TombEngine solution in the Solution Explorer tab and select "Restore NuGet Packages" -4) If it doesn't help, manually install `directxtk_desktop_2019` and `Microsoft.XAudio2.Redist` packages via NuGet Package Manager +*Visual Studio* may warn about NuGet packages. To fix: +1) Delete the `Packages` folder. +2) Go back to *Microsoft Visual Studio*. +3) Right-click on the *TEN* solution in the *Solution Explorer* tab and select "Restore NuGet Packages". +4) If it doesn't help, manually install `directxtk_desktop_2019` and `Microsoft.XAudio2.Redist` packages via NuGet Package Manager. -Once done, you should be able to build a level with TombEditor and run it in TEN. +Once done, you should be able to build a level with *Tomb Editor* and run it in *TEN*. # Disclaimer -This is a community project which is not affiliated with Core Design, Eidos Interactive, or Embracer Group AB. Tomb Raider is a registered trademark of Embracer Group AB. TombEngine is not be sold. The code is open-source to encourage contributions and to be used for study purposes. We are not responsible for illegal uses of this source code. This source code is released as-is and continues to be maintained by non-paid contributors in their free time. +This community project is unaffiliated with Core Design, Eidos Interactive, or Embracer Group AB. *Tomb Raider* is a registered trademark of Embracer Group AB. *Tomb Engine* is not for sale. The code is open-source to encourage contributions and for study purposes. We are not responsible for illegal uses of this source code. This source code is released as-is and continues to be maintained by non-paid contributors in their free time. From 917a86863eb55a3561a4bc7f01f765c2f9e3d169 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Wed, 26 Mar 2025 19:41:53 +0100 Subject: [PATCH 106/160] Changed lensflare formula --- TombEngine/Shaders/PostProcess.fx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TombEngine/Shaders/PostProcess.fx b/TombEngine/Shaders/PostProcess.fx index 79c3ebef2..0c7c232ea 100644 --- a/TombEngine/Shaders/PostProcess.fx +++ b/TombEngine/Shaders/PostProcess.fx @@ -185,7 +185,7 @@ float4 PSLensFlare(PixelShaderInput input) : SV_Target totalLensFlareColor += lensFlareColor; } - color.xyz += totalLensFlareColor; + color.xyz = lerp(color.xyz, color.xyz + totalLensFlareColor, saturate(dot(totalLensFlareColor, float3(0.5f, 0.5f, 0.5f)))); return color; } \ No newline at end of file From 8e5f045d022716d2ef3d7d6a1055bb93727d8c67 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Wed, 26 Mar 2025 22:58:32 +0100 Subject: [PATCH 107/160] Update PostProcess.fx --- TombEngine/Shaders/PostProcess.fx | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/TombEngine/Shaders/PostProcess.fx b/TombEngine/Shaders/PostProcess.fx index 0c7c232ea..10d717245 100644 --- a/TombEngine/Shaders/PostProcess.fx +++ b/TombEngine/Shaders/PostProcess.fx @@ -114,27 +114,27 @@ float3 LensFlare(float2 uv, float2 pos) f0 += f0 * (sin((ang + rotationOffset + 1.0f / 18.0f) * 8.0f) * 0.2f + dist * 0.1f + 0.2f); // Lensflare glow components - float f2 = max(1.0f / (1.0f + 32.0f * pow(length(uvd + 0.8f * pos), 2.0f)), 0.0f) * 0.25f; - float f22 = max(1.0f / (1.0f + 32.0f * pow(length(uvd + 0.85f * pos), 2.0f)), 0.0f) * 0.23f; - float f23 = max(1.0f / (1.0f + 32.0f * pow(length(uvd + 0.9f * pos), 2.0f)), 0.0f) * 0.21f; + float f2 = max(1.0f / (1.0f + 32.0f * pow(length(uvd + 0.8f * pos), 1.0f)), 0.0f) * 0.25f; + float f22 = max(1.0f / (1.0f + 32.0f * pow(length(uvd + 0.85f * pos), 1.0f)), 0.0f) * 0.23f; + float f23 = max(1.0f / (1.0f + 32.0f * pow(length(uvd + 0.9f * pos), 1.0f)), 0.0f) * 0.21f; // Circular lens artifacts float2 uvx = lerp(uv, uvd, -0.5f); - float f4 = max(0.01f - pow(length(uvx + 0.4f * pos), 2.4f), 0.0f) * 6.0f; - float f42 = max(0.01f - pow(length(uvx + 0.45f * pos), 2.4f), 0.0f) * 5.0f; - float f43 = max(0.01f - pow(length(uvx + 0.5f * pos), 2.4f), 0.0f) * 3.0f; + float f4 = max(0.01f - pow(length(uvx + 0.4f * pos), 2.4f), 0.0f) * 9.0f; + float f42 = max(0.01f - pow(length(uvx + 0.45f * pos), 2.4f), 0.0f) * 7.0f; + float f43 = max(0.01f - pow(length(uvx + 0.5f * pos), 2.4f), 0.0f) * 6.0f; // Smaller lens artifacts uvx = lerp(uv, uvd, -0.4f); - float f5 = max(0.01f - pow(length(uvx + 0.2f * pos), 5.5f), 0.0f) * 2.0f; + float f5 = max(0.01f - pow(length(uvx + 0.2f * pos), 5.5f), 0.0f) * 2.0f; float f52 = max(0.01f - pow(length(uvx + 0.4f * pos), 5.5f), 0.0f) * 2.0f; float f53 = max(0.01f - pow(length(uvx + 0.6f * pos), 5.5f), 0.0f) * 2.0f; // Symmetric artifacts uvx = lerp(uv, uvd, -0.5f); - float f6 = max(0.01f - pow(length(uvx - 0.3f * pos), 1.6f), 0.0f) * 6.0f; - float f62 = max(0.01f - pow(length(uvx - 0.325f * pos), 1.6f), 0.0f) * 3.0f; - float f63 = max(0.01f - pow(length(uvx - 0.35f * pos), 1.6f), 0.0f) * 5.0f; + float f6 = max(0.01f - pow(length(uvx - 0.3f * pos), 1.6f), 0.0f) * 9.0f; + float f62 = max(0.01f - pow(length(uvx - 0.325f * pos), 1.6f), 0.0f) * 6.0f; + float f63 = max(0.01f - pow(length(uvx - 0.35f * pos), 1.6f), 0.0f) * 7.0f; // Sunflare and lensflare outputs float3 sunflare = float3(f0, f0, f0); From 9469a0e63a311da5b96918dda46c33d7c0e58e48 Mon Sep 17 00:00:00 2001 From: Nemoel-Tomo Date: Fri, 28 Mar 2025 06:44:07 +0100 Subject: [PATCH 108/160] Tomo - fireflies (#1597) * tests only - nothing to see * update * update * update * update corpse * update savegame, formatting * import develop * formatting * fix broken streamer vertex * update firefly streamer spawn * update effect * Add in objects for fireflies * fixed all reviews, formatting, changing on-off cycle * formatting * reduced the emitted light to two lights per cluster * adding antitrigger * formatting * fixed corpse * fixed a bug with corpse * fixed corpse fall bug * formatting * Small refactors * Fix merge --------- Co-authored-by: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Co-authored-by: Lwmte <3331699+Lwmte@users.noreply.github.com> --- Documentation/doc/4 enums/Objects.ObjID.html | 3 + TombEngine/Game/Setup.cpp | 2 + TombEngine/Game/control/control.cpp | 3 + TombEngine/Game/control/flipeffect.cpp | 3 + TombEngine/Game/savegame.cpp | 69 ++- TombEngine/Objects/Effects/Fireflies.cpp | 445 ++++++++++++++++ TombEngine/Objects/Effects/Fireflies.h | 76 +++ TombEngine/Objects/TR3/Object/corpse.cpp | 100 +++- TombEngine/Objects/TR5/tr5_objects.cpp | 10 + TombEngine/Objects/game_object_ids.h | 5 +- TombEngine/Renderer/Renderer.h | 1 + TombEngine/Renderer/RendererDraw.cpp | 1 + TombEngine/Renderer/RendererDrawEffect.cpp | 45 ++ .../Internal/TEN/Objects/ObjectIDs.h | 7 +- .../flatbuffers/ten_savegame_generated.h | 493 ++++++++++++++++-- .../Specific/savegame/schema/ten_savegame.fbs | 26 + TombEngine/TombEngine.vcxproj | 2 + 17 files changed, 1220 insertions(+), 71 deletions(-) create mode 100644 TombEngine/Objects/Effects/Fireflies.cpp create mode 100644 TombEngine/Objects/Effects/Fireflies.h diff --git a/Documentation/doc/4 enums/Objects.ObjID.html b/Documentation/doc/4 enums/Objects.ObjID.html index 7fa0d1ba0..b10a91473 100644 --- a/Documentation/doc/4 enums/Objects.ObjID.html +++ b/Documentation/doc/4 enums/Objects.ObjID.html @@ -952,6 +952,7 @@ DOPPELGANGER_ORIGIN CORPSE WRAITH_TRAP WATERFALL_EMITTER +FIREFLY_EMITTER MESHSWAP1 MESHSWAP2 MESHSWAP3 @@ -1132,6 +1133,7 @@ AIR_BAR_TEXTURE DASH_BAR_TEXTURE SFX_BAR_TEXTURE WATERFALL_SPRITES +FIREFLY_SPRITES CROSSHAIR_GRAPHICS SPEEDOMETER_GRAPHICS CUSTOM_BAR_GRAPHICS @@ -1410,6 +1412,7 @@ AIR_BAR_TEXTURE DASH_BAR_TEXTURE SFX_BAR_TEXTURE WATERFALL_SPRITES +FIREFLY_SPRITES CROSSHAIR_GRAPHICS SPEEDOMETER_GRAPHICS CUSTOM_BAR_GRAPHICS diff --git a/TombEngine/Game/Setup.cpp b/TombEngine/Game/Setup.cpp index 42bfb08df..22ab28749 100644 --- a/TombEngine/Game/Setup.cpp +++ b/TombEngine/Game/Setup.cpp @@ -27,6 +27,7 @@ #include "Objects/TR4/Entity/tr4_beetle_swarm.h" #include "Objects/Utils/object_helper.h" #include "Specific/level.h" +#include "Objects/Effects/Fireflies.h" using namespace TEN::Effects::Hair; using namespace TEN::Entities; @@ -200,6 +201,7 @@ void InitializeSpecialEffects() TEN::Entities::TR4::ClearBeetleSwarm(); TEN::Entities::Creatures::TR3::ClearFishSwarm(); + TEN::Effects::Fireflies::ClearFireflySwarm(); } void CustomObjects() diff --git a/TombEngine/Game/control/control.cpp b/TombEngine/Game/control/control.cpp index 412c974dd..d5171cbae 100644 --- a/TombEngine/Game/control/control.cpp +++ b/TombEngine/Game/control/control.cpp @@ -59,6 +59,7 @@ #include "Specific/Input/Input.h" #include "Specific/level.h" #include "Specific/winmain.h" +#include "Objects/Effects/Fireflies.h" using namespace std::chrono; using namespace TEN::Effects; @@ -89,6 +90,7 @@ using namespace TEN::Math; using namespace TEN::Renderer; using namespace TEN::Entities::Creatures::TR3; using namespace TEN::Entities::Effects; +using namespace TEN::Effects::Fireflies; constexpr auto DEATH_NO_INPUT_TIMEOUT = 10 * FPS; constexpr auto DEATH_INPUT_TIMEOUT = 3 * FPS; @@ -211,6 +213,7 @@ GameStatus GamePhase(bool insideMenu) UpdateLocusts(); UpdateUnderwaterBloodParticles(); UpdateFishSwarm(); + UpdateFireflySwarm(); UpdateGlobalLensFlare(); // Update HUD. diff --git a/TombEngine/Game/control/flipeffect.cpp b/TombEngine/Game/control/flipeffect.cpp index e1b3af5d4..c473386d0 100644 --- a/TombEngine/Game/control/flipeffect.cpp +++ b/TombEngine/Game/control/flipeffect.cpp @@ -17,6 +17,7 @@ #include "Game/Setup.h" #include "Sound/sound.h" #include "Specific/level.h" +#include "Objects/Effects/Fireflies.h" #include "Objects/Generic/puzzles_keys.h" #include "Objects/TR3/Entity/FishSwarm.h" #include "Objects/TR4/Entity/tr4_beetle_swarm.h" @@ -29,6 +30,7 @@ using namespace TEN::Effects::Environment; using namespace TEN::Effects::Footprint; using namespace TEN::Effects::Hair; using namespace TEN::Entities::Creatures::TR3; +using namespace TEN::Effects::Fireflies; int FlipEffect; @@ -90,6 +92,7 @@ void ClearSwarmEnemies(ItemInfo* item) ClearBeetleSwarm(); ClearLocusts(); ClearFishSwarm(); + ClearFireflySwarm(); } void FlashOrange(ItemInfo* item) diff --git a/TombEngine/Game/savegame.cpp b/TombEngine/Game/savegame.cpp index b2ae7ec0c..8f3f1394c 100644 --- a/TombEngine/Game/savegame.cpp +++ b/TombEngine/Game/savegame.cpp @@ -10,6 +10,7 @@ #include "Game/control/flipeffect.h" #include "Game/control/lot.h" #include "Game/control/volume.h" +#include "Objects/Effects/Fireflies.h" #include "Game/effects/item_fx.h" #include "Game/effects/effects.h" #include "Game/effects/weather.h" @@ -43,8 +44,9 @@ using namespace flatbuffers; using namespace TEN::Collision::Floordata; using namespace TEN::Control::Volumes; -using namespace TEN::Effects::Items; using namespace TEN::Effects::Environment; +using namespace TEN::Effects::Fireflies; +using namespace TEN::Effects::Items; using namespace TEN::Entities::Creatures::TR3; using namespace TEN::Entities::Generic; using namespace TEN::Entities::Switches; @@ -924,6 +926,38 @@ const std::vector SaveGame::Build() } auto fishSwarmOffset = fbb.CreateVector(fishSwarm); + std::vector> fireflySwarm; + for (const auto& firefly : FireflySwarm) + { + Save::FireflyDataBuilder fireflySave{ fbb }; + fireflySave.add_sprite_index(firefly.SpriteSeqID); + fireflySave.add_sprite_id(firefly.SpriteID); + fireflySave.add_blend_mode((int)firefly.blendMode); + fireflySave.add_scalar(firefly.scalar); + fireflySave.add_position(&FromVector3(firefly.Position)); + fireflySave.add_room_number(firefly.RoomNumber); + fireflySave.add_position_target(&FromVector3(firefly.PositionTarget)); + fireflySave.add_orientation(&FromEulerAngles(firefly.Orientation)); + fireflySave.add_velocity(firefly.Velocity); + fireflySave.add_target_item_number((firefly.TargetItemPtr == nullptr) ? -1 : firefly.TargetItemPtr->Index); + fireflySave.add_z_vel(firefly.zVel); + fireflySave.add_life(firefly.Life); + fireflySave.add_number(firefly.Number); + fireflySave.add_d_r(firefly.rB); + fireflySave.add_d_g(firefly.gB); + fireflySave.add_d_b(firefly.bB); + fireflySave.add_r(firefly.r); + fireflySave.add_g(firefly.g); + fireflySave.add_b(firefly.b); + fireflySave.add_on(firefly.on); + fireflySave.add_size(firefly.size); + fireflySave.add_rot_Ang(firefly.rotAng); + + auto fireflySaveOffset = fireflySave.Finish(); + fireflySwarm.push_back(fireflySaveOffset); + } + auto fireflySwarmOffset = fbb.CreateVector(fireflySwarm); + // TODO: In future, we should save only active FX, not whole array. // This may come together with Monty's branch merge -- Lwmte, 10.07.22 @@ -1545,6 +1579,7 @@ const std::vector SaveGame::Build() sgb.add_next_item_active(NextItemActive); sgb.add_items(serializedItemsOffset); sgb.add_fish_swarm(fishSwarmOffset); + sgb.add_firefly_swarm(fireflySwarmOffset); sgb.add_fxinfos(serializedEffectsOffset); sgb.add_next_fx_free(NextFxFree); sgb.add_next_fx_active(NextFxActive); @@ -2289,6 +2324,38 @@ static void ParseEffects(const Save::SaveGame* s) FishSwarm.push_back(fish); } + // Load firefly swarm. + for (int i = 0; i < s->firefly_swarm()->size(); i++) + { + const auto& fireflySave = s->firefly_swarm()->Get(i); + auto firefly = FireflyData{}; + + firefly.SpriteSeqID = fireflySave->sprite_index(); + firefly.SpriteID = fireflySave->sprite_id(); + firefly.blendMode = (BlendMode)fireflySave->blend_mode(); + firefly.scalar = fireflySave->scalar(); + firefly.Position = ToVector3(fireflySave->position()); + firefly.RoomNumber = fireflySave->room_number(); + firefly.PositionTarget = ToVector3(fireflySave->position_target()); + firefly.Orientation = ToEulerAngles(fireflySave->orientation()); + firefly.Velocity = fireflySave->velocity(); + firefly.TargetItemPtr = (fireflySave->target_item_number() == -1) ? nullptr : &g_Level.Items[fireflySave->target_item_number()]; + firefly.zVel = fireflySave->z_vel(); + firefly.Life = fireflySave->life(); + firefly.Number = fireflySave->number(); + firefly.rB = fireflySave->d_r(); + firefly.gB = fireflySave->d_g(); + firefly.bB = fireflySave->d_b(); + firefly.r = fireflySave->r(); + firefly.g = fireflySave->g(); + firefly.b = fireflySave->b(); + firefly.on = fireflySave->on(); + firefly.size = fireflySave->size(); + firefly.rotAng = fireflySave->rot_Ang(); + + FireflySwarm.push_back(firefly); + } + // Load particles. for (int i = 0; i < s->particles()->size(); i++) { diff --git a/TombEngine/Objects/Effects/Fireflies.cpp b/TombEngine/Objects/Effects/Fireflies.cpp new file mode 100644 index 000000000..0510283f9 --- /dev/null +++ b/TombEngine/Objects/Effects/Fireflies.cpp @@ -0,0 +1,445 @@ +#include "framework.h" +#include "Objects/Effects/Fireflies.h" + +#include "Game/collision/collide_item.h" +#include "Game/collision/collide_room.h" +#include "Game/collision/Point.h" +#include "Game/control/box.h" +#include "Game/control/flipeffect.h" +#include "Game/effects/effects.h" +#include "Game/effects/Streamer.h" +#include "Game/effects/tomb4fx.h" +#include "Game/items.h" +#include "Game/Lara/lara.h" +#include "Game/Lara/lara_helpers.h" +#include "Game/misc.h" +#include "Game/Setup.h" +#include "Math/Math.h" +#include "Renderer/Renderer.h" +#include "Specific/clock.h" +#include "Specific/level.h" + +using namespace TEN::Collision::Point; +using namespace TEN::Math; +using namespace TEN::Renderer; +using namespace TEN::Effects::Streamer; + +namespace TEN::Effects::Fireflies +{ + constexpr auto FIREFLY_COHESION_FACTOR = 600.1f; + constexpr auto FIREFLY_SPACING_FACTOR = 600.0f; + constexpr auto FIREFLY_CATCH_UP_FACTOR = 0.2f; + constexpr auto FIREFLY_TARGET_DISTANCE_MAX = SQUARE(BLOCK(1.0f)); + constexpr auto FIREFLY_BASE_SEPARATION_DISTANCE = 10.0f; + constexpr auto FIREFLY_FLEE_DISTANCE = BLOCK(0.7); + constexpr auto MAX_FIREFLIES = 92; + constexpr auto DEFAULT_FIREFLY_COUNT = 20; + constexpr auto FIREFLY_RISE_UP_FACTOR = 200; + constexpr auto MAX_AREA_RANGE = 8; + constexpr auto LIGHT_ALPHA_CYCLE_DURATION = 120.0f; + + std::vector FireflySwarm = {}; + std::unordered_map nextFireflyNumberMap; // Numbering the Fireflies for Streamer effect. + + void InitializeFireflySwarm(short itemNumber) + { + auto& item = g_Level.Items[itemNumber]; + + item.Animation.Velocity.z = Random::GenerateFloat(32.0f, 160.0f); + + item.HitPoints = DEFAULT_FIREFLY_COUNT; + item.ItemFlags[FirefliesItemFlags::TargetItemPtr] = item.Index; + item.ItemFlags[FirefliesItemFlags::Light] = 1; // 0 = Turn off light effect, 1 = turn on light (DEFAULT). + + item.ItemFlags[FirefliesItemFlags::TriggerFlags] = std::clamp((int)item.TriggerFlags, -MAX_AREA_RANGE, MAX_AREA_RANGE); + + item.ItemFlags[FirefliesItemFlags::Spawncounter] = 0; + item.ItemFlags[FirefliesItemFlags::RemoveFliesEffect] = 0; + + // Firefly numbers that has the light. + item.ItemFlags[FirefliesItemFlags::LightIndex1] = NO_VALUE; + item.ItemFlags[FirefliesItemFlags::LightIndex2] = NO_VALUE; + } + + void SpawnFireflySwarm(ItemInfo& item, int triggerFlags) + { + constexpr auto VEL_MAX = 34.0f; + constexpr auto VEL_MIN = 6.0f; + + // Create new firefly. + auto& firefly = GetNewEffect(FireflySwarm, MAX_FIREFLIES); + + unsigned char r = 255; + unsigned char g = 255; + unsigned char b = 255; + + if (triggerFlags >= 0) + { + float brightnessShift = Random::GenerateFloat(-0.1f, 0.1f); + r = std::clamp(item.Model.Color.x / 2.0f + brightnessShift, 0.0f, 1.0f) * UCHAR_MAX; + g = std::clamp(item.Model.Color.y / 2.0f + brightnessShift, 0.0f, 1.0f) * UCHAR_MAX; + b = std::clamp(item.Model.Color.z / 2.0f + brightnessShift, 0.0f, 1.0f) * UCHAR_MAX; + + firefly.SpriteSeqID = ID_FIREFLY_SPRITES; + firefly.SpriteID = 0; + firefly.blendMode = BlendMode::Additive; + firefly.scalar = 3.0f; + firefly.size = 1.0f; + } + else + { + firefly.SpriteSeqID = ID_FIREFLY_SPRITES; + firefly.SpriteID = 1; + firefly.blendMode = BlendMode::Subtractive; + firefly.scalar = 1.2f; + firefly.size = 1.2f; + } + + firefly.r = firefly.rB = r; + firefly.g = firefly.gB = g; + firefly.b = firefly.bB = b; + + firefly.rotAng = ANGLE(0.0f); + + if (item.TriggerFlags > 8) + firefly.rotAng = ANGLE(90.0f); + + firefly.on = true; + + firefly.Position = item.Pose.Position.ToVector3(); + firefly.RoomNumber = item.RoomNumber; + firefly.Orientation = item.Pose.Orientation; + firefly.Velocity = Random::GenerateFloat(VEL_MIN, VEL_MAX); + firefly.zVel = 0.3f; + + firefly.Life = Random::GenerateInt(1, 400); + firefly.TargetItemPtr = &g_Level.Items[item.ItemFlags[FirefliesItemFlags::TargetItemPtr]]; + + int& nextFireflyNumber = nextFireflyNumberMap[item.Index]; + firefly.Number = nextFireflyNumber++; + } + + void ControlFireflySwarm(short itemNumber) + { + auto& item = g_Level.Items[itemNumber]; + + if (!TriggerActive(&item)) + { + // Remove all fireflies associated with this item. + RemoveFireflies(item); + + // Reset ItemFlags. + if (item.HitPoints == NOT_TARGETABLE) + item.HitPoints = item.ItemFlags[FirefliesItemFlags::Spawncounter]; + + item.ItemFlags[FirefliesItemFlags::Spawncounter] = 0; + item.ItemFlags[FirefliesItemFlags::LightIndex1] = NO_VALUE; + item.ItemFlags[FirefliesItemFlags::LightIndex2] = NO_VALUE; + + return; + } + + constexpr auto ALPHA_PAUSE_DURATION = 2.0f; + static float frameCounter = 0.0f; + + // Increment the counter variable in each frame. + frameCounter += 1.0f; + + if (item.HitPoints != NOT_TARGETABLE) + { + int fireflyCount = item.HitPoints - item.ItemFlags[FirefliesItemFlags::Spawncounter]; + + if (fireflyCount < 0) + { + int firefliesToTurnOff = -fireflyCount; + for (auto& firefly : FireflySwarm) + { + if (firefly.TargetItemPtr == &item && firefly.Life > 0.0f) + { + firefly.Life = 0.0f; + firefly.on = false; + firefliesToTurnOff--; + + if (firefliesToTurnOff == 0) + break; + } + } + } + else if (fireflyCount > 0) + { + for (int i = 0; i < fireflyCount; i++) + { + SpawnFireflySwarm(item, item.TriggerFlags); + } + } + + item.ItemFlags[FirefliesItemFlags::Spawncounter] = item.HitPoints; + item.HitPoints = NOT_TARGETABLE; + } + + // Update color values for blinking effect. + float alphaFactor; + + for (auto& firefly : FireflySwarm) + { + auto targetItem = firefly.TargetItemPtr; + + if (targetItem == &item) + { + // Choose one of the available firefly number that has the light. + if (targetItem->ItemFlags[FirefliesItemFlags::LightIndex1] == NO_VALUE && targetItem->ItemFlags[FirefliesItemFlags::TriggerFlags] >= 0) + { + targetItem->ItemFlags[FirefliesItemFlags::LightIndex1] = Random::GenerateInt(0, targetItem->TriggerFlags); + } + // Two lights max for each cluster. + if (targetItem->ItemFlags[FirefliesItemFlags::LightIndex2] == NO_VALUE && targetItem->ItemFlags[FirefliesItemFlags::TriggerFlags] >= 0) + { + targetItem->ItemFlags[FirefliesItemFlags::LightIndex2] = Random::GenerateInt(0, targetItem->TriggerFlags); + } + + auto posBase = firefly.Position; + auto rotMatrix = firefly.Orientation.ToRotationMatrix(); + auto pos = posBase + Vector3::Transform(Vector3(0, 0, 30), rotMatrix); + auto direction0 = Geometry::RotatePoint(posBase, EulerAngles::Identity); + short orient2D = firefly.Orientation.z; + + if (targetItem->ItemFlags[FirefliesItemFlags::TriggerFlags] >= 0) + { + StreamerEffect.Spawn(targetItem->Index, firefly.Number, pos, direction0, orient2D, + Vector4(firefly.r / (float)UCHAR_MAX, firefly.g / (float)UCHAR_MAX, firefly.b / (float)UCHAR_MAX, 1.0f), + Vector4::Zero, + 6.3f - (firefly.zVel / 12), ((firefly.Velocity / 8) + firefly.zVel * 3) / (float)UCHAR_MAX, 0.0f, -0.1f, 90.0f, StreamerFeatherMode::None, BlendMode::Additive); + } + else if (targetItem->ItemFlags[FirefliesItemFlags::TriggerFlags] < 0) + { + StreamerEffect.Spawn(targetItem->Index, firefly.Number, pos, direction0, orient2D, + Vector4((firefly.r / 2) / (float)UCHAR_MAX, (firefly.g / 2) / (float)UCHAR_MAX, (firefly.b / 2) / (float)UCHAR_MAX, 0.2f), + Vector4((firefly.r / 3) / (float)UCHAR_MAX, (firefly.g / 3) / (float)UCHAR_MAX, (firefly.b / 3) / (float)UCHAR_MAX, 0.2f), + 0.0f, 0.4f, 0.0f, 0.2f, 0.0f, StreamerFeatherMode::None, BlendMode::Subtractive); + } + + if ((targetItem->ItemFlags[FirefliesItemFlags::LightIndex1] == firefly.Number || targetItem->ItemFlags[FirefliesItemFlags::LightIndex2] == firefly.Number) && + targetItem->ItemFlags[FirefliesItemFlags::Light] == 1) + { + float totalCycleDuration = 2 * (LIGHT_ALPHA_CYCLE_DURATION + ALPHA_PAUSE_DURATION); + float alphaTime = fmod(frameCounter, totalCycleDuration); + + if (alphaTime < ALPHA_PAUSE_DURATION) + { + alphaFactor = 1.0f; // Pause on Alpha 1. + } + else if (alphaTime < ALPHA_PAUSE_DURATION + LIGHT_ALPHA_CYCLE_DURATION) + { + alphaFactor = 1.0f - ((alphaTime - ALPHA_PAUSE_DURATION) / LIGHT_ALPHA_CYCLE_DURATION); + } + else if (alphaTime < 2 * ALPHA_PAUSE_DURATION + LIGHT_ALPHA_CYCLE_DURATION) + { + alphaFactor = 0.0f; // Pause on Alpha 0. + targetItem->ItemFlags[FirefliesItemFlags::LightIndex1] = NO_VALUE; + targetItem->ItemFlags[FirefliesItemFlags::LightIndex2] = NO_VALUE; + } + else + { + alphaFactor = (alphaTime - 2 * ALPHA_PAUSE_DURATION - LIGHT_ALPHA_CYCLE_DURATION) / LIGHT_ALPHA_CYCLE_DURATION; + } + + SpawnDynamicLight(firefly.Position.x, firefly.Position.y, firefly.Position.z, 3, + static_cast(std::clamp(firefly.r * alphaFactor, 0.0f, (float)firefly.r)), + static_cast(std::clamp(firefly.g * alphaFactor, 0.0f, (float)firefly.g)), + static_cast(std::clamp(firefly.b * alphaFactor, 0.0f, (float)firefly.b))); + } + } + } + } + + void UpdateFireflySwarm() + { + constexpr auto FLEE_VEL = 1.5f; + constexpr auto ALPHA_PAUSE_DURATION = 100.0f; + + static const auto SPHERE = BoundingSphere(Vector3::Zero, BLOCK(1 / 8.0f)); + + if (FireflySwarm.empty()) + return; + + const auto& playerItem = *LaraItem; + static float frameCounter = 0.0f; + + // Increment the counter variable in each frame. + frameCounter += 1.0f; + + for (auto& firefly : FireflySwarm) + { + if (firefly.Life <= 0.0f || !firefly.on) + continue; + + auto targetItem = firefly.TargetItemPtr; + + if (targetItem->ItemFlags[FirefliesItemFlags::RemoveFliesEffect]) + { + firefly.r = 0; + firefly.g = 0; + firefly.b = 0; + continue; + } + + firefly.StoreInterpolationData(); + + firefly.PositionTarget = Random::GeneratePointInSphere(SPHERE); + + int multiplierX = CLICK(targetItem->ItemFlags[FirefliesItemFlags::TriggerFlags] * 2); + int multiplierY = CLICK(targetItem->ItemFlags[FirefliesItemFlags::TriggerFlags] * 4); + int multiplierZ = CLICK(targetItem->ItemFlags[FirefliesItemFlags::TriggerFlags] * 2); + + auto spheroidAxis = Vector3(multiplierX, multiplierY, multiplierZ); + auto itemPos = Vector3i(targetItem->Pose.Position.x, targetItem->Pose.Position.y - FIREFLY_RISE_UP_FACTOR, targetItem->Pose.Position.z); + + // Calculate desired position based on target object and random offsets. + auto desiredPos = itemPos + Random::GeneratePointInSpheroid(firefly.PositionTarget, EulerAngles::Identity, spheroidAxis); + auto dir = desiredPos - firefly.Position; + + auto dirs = dir.ToVector3(); + dirs.Normalize(); + auto dirNorm = dirs; + + // Define cohesion factor to keep fireflies close together. + float distToTarget = dirs.Length(); + + float targetVel = (distToTarget * FIREFLY_COHESION_FACTOR) + Random::GenerateFloat(3.0f, 5.0f); + firefly.Velocity = std::min(targetVel, targetItem->Animation.Velocity.z - 21.0f); + + // If firefly is too far from target, increase velocity to catch up. + if (distToTarget > FIREFLY_TARGET_DISTANCE_MAX) + firefly.Velocity += FIREFLY_CATCH_UP_FACTOR; + + // Translate. + auto moveDir = firefly.Orientation.ToDirection(); + moveDir.Normalize(); + firefly.Position += (moveDir * firefly.Velocity) / 26.0f; + firefly.Position += (moveDir * FIREFLY_SPACING_FACTOR) / 26.0f; + + auto orientTo = Geometry::GetOrientToPoint(firefly.Position, desiredPos.ToVector3()); + firefly.Orientation.Lerp(orientTo, 0.1f); + + // Update color values for blinking effect. + float totalCycleDuration = 2 * (LIGHT_ALPHA_CYCLE_DURATION + ALPHA_PAUSE_DURATION); + float alphaTime = fmod(frameCounter + firefly.Life, totalCycleDuration); + float alphaFactor; + + if (alphaTime < ALPHA_PAUSE_DURATION) + { + alphaFactor = 1.0f; + } + else if (alphaTime < ALPHA_PAUSE_DURATION + LIGHT_ALPHA_CYCLE_DURATION) + { + alphaFactor = 1.0f - ((alphaTime - ALPHA_PAUSE_DURATION) / LIGHT_ALPHA_CYCLE_DURATION); + } + else if (alphaTime < 2 * ALPHA_PAUSE_DURATION + LIGHT_ALPHA_CYCLE_DURATION) + { + alphaFactor = 0.0f; + } + else + { + alphaFactor = (alphaTime - 2 * ALPHA_PAUSE_DURATION - LIGHT_ALPHA_CYCLE_DURATION) / LIGHT_ALPHA_CYCLE_DURATION; + } + + firefly.r = static_cast(firefly.rB * alphaFactor); + firefly.g = static_cast(firefly.gB * alphaFactor); + firefly.b = static_cast(firefly.bB * alphaFactor); + + for (const auto& otherFirefly : FireflySwarm) + { + if (&firefly == &otherFirefly) + continue; + + float distToOtherFirefly = Vector3i::Distance(firefly.Position, otherFirefly.Position); + float distToPlayer = Vector3i::Distance(firefly.Position, playerItem.Pose.Position); + + // If player is too close, flee. + if (distToPlayer < FIREFLY_FLEE_DISTANCE && playerItem.Animation.ActiveState != 2) + { + auto separationDir = firefly.Position - playerItem.Pose.Position.ToVector3(); + separationDir.Normalize(); + + // Reduce the Y component of the escape direction. + separationDir.y *= Random::GenerateFloat(0.0f, 0.4f); + + // Normalize the direction again to get the length of the vector. + separationDir.Normalize(); + + firefly.Position += separationDir * FLEE_VEL; + + auto orientTo = Geometry::GetOrientToPoint(firefly.Position, separationDir); + firefly.Orientation.Lerp(orientTo, 0.05f); + + firefly.Velocity -= std::min(FLEE_VEL, firefly.TargetItemPtr->Animation.Velocity.z - 1.0f); + + if (Random::TestProbability(1.0f / 700.0f) && + targetItem->ItemFlags[FirefliesItemFlags::Light] == 1 && + targetItem->ItemFlags[FirefliesItemFlags::TriggerFlags] >= 0) + { + if (firefly.zVel == 0.3f) + { + firefly.zVel = 50.0f; + } + } + + if (firefly.zVel > 50.0f) + firefly.zVel = 0.3f; + } + + if (distToOtherFirefly < FIREFLY_BASE_SEPARATION_DISTANCE) + { + auto separationDir = firefly.Position - otherFirefly.Position; + separationDir.Normalize(); + + firefly.Position += separationDir * (FIREFLY_BASE_SEPARATION_DISTANCE - distToOtherFirefly); + } + } + + auto pointColl = GetPointCollision(firefly.Position, firefly.RoomNumber); + + // Update firefly room number. + if (pointColl.GetRoomNumber() != firefly.RoomNumber && + pointColl.GetRoomNumber() != NO_VALUE) + { + firefly.RoomNumber = pointColl.GetRoomNumber(); + } + + if (targetItem->ItemFlags[FirefliesItemFlags::Light] == 1 && targetItem->ItemFlags[FirefliesItemFlags::TriggerFlags] >= 0) + { + if (Random::TestProbability(1.0f / (700.0f - (float)(targetItem->ItemFlags[FirefliesItemFlags::Spawncounter] * 2)))) + firefly.zVel = 100.0f; + + if (firefly.zVel > 1.0f) + firefly.zVel -= 2.0f; + if (firefly.zVel <= 1.0f) + firefly.zVel = 0.3f; + } + } + } + + void RemoveFireflies(ItemInfo& item) + { + FireflySwarm.erase(std::remove_if(FireflySwarm.begin(), FireflySwarm.end(), + [&item](FireflyData& firefly) + { + if (firefly.TargetItemPtr == &item) + { + firefly.Life = 0.0f; + firefly.on = false; + return true; + } + return false; + }), FireflySwarm.end()); + nextFireflyNumberMap.erase(item.Index); + } + + void ClearFireflySwarm() + { + FireflySwarm.clear(); + nextFireflyNumberMap.clear(); + } +} + + diff --git a/TombEngine/Objects/Effects/Fireflies.h b/TombEngine/Objects/Effects/Fireflies.h new file mode 100644 index 000000000..807869b81 --- /dev/null +++ b/TombEngine/Objects/Effects/Fireflies.h @@ -0,0 +1,76 @@ +#pragma once +#include "Game/items.h" +#include "Math/Math.h" + +using namespace TEN::Math; + +namespace TEN::Effects::Fireflies +{ + enum FirefliesItemFlags + { + TargetItemPtr, + Light, + TriggerFlags, + Spawncounter, + RemoveFliesEffect, + LightIndex1, + LightIndex2 + }; + + struct FireflyData + { + int SpriteSeqID = ID_DEFAULT_SPRITES; + int SpriteID = SPR_UNDERWATERDUST; + BlendMode blendMode; + unsigned int scalar; + + Vector3 Position = Vector3::Zero; + int RoomNumber = 0; + Vector3 PositionTarget = Vector3::Zero; + EulerAngles Orientation = EulerAngles::Identity; + float Velocity = 0.0f; + + ItemInfo* TargetItemPtr = nullptr; + + float zVel; + float Life = 0.0f; + int Number = 0; + + unsigned char rB; + unsigned char gB; + unsigned char bB; + unsigned char r; + unsigned char g; + unsigned char b; + + bool on; + float size; + short rotAng; + + int PrevX; + int PrevY; + int PrevZ; + byte PrevR; + byte PrevG; + byte PrevB; + + void StoreInterpolationData() + { + PrevX = Position.x; + PrevY = Position.y; + PrevZ = Position.z; + PrevR = r; + PrevG = g; + PrevB = b; + } + }; + + extern std::vector FireflySwarm; + + void InitializeFireflySwarm(short itemNumber); + void ControlFireflySwarm(short itemNumber); + void UpdateFireflySwarm(); + void ClearFireflySwarm(); + void SpawnFireflySwarm(ItemInfo& item, int triggerFlags); + void RemoveFireflies(ItemInfo& item); +} diff --git a/TombEngine/Objects/TR3/Object/corpse.cpp b/TombEngine/Objects/TR3/Object/corpse.cpp index 527f12f1c..3b3da8a3b 100644 --- a/TombEngine/Objects/TR3/Object/corpse.cpp +++ b/TombEngine/Objects/TR3/Object/corpse.cpp @@ -17,6 +17,7 @@ #include "Game/Lara/lara_helpers.h" #include "Game/Setup.h" #include "Math/Math.h" +#include "Objects/Effects/Fireflies.h" #include "Scripting/Include/Flow/ScriptInterfaceFlowHandler.h" #include "Sound/sound.h" #include "Specific/level.h" @@ -25,9 +26,13 @@ using namespace TEN::Collision::Point; using namespace TEN::Effects::Ripple; using namespace TEN::Effects::Splash; using namespace TEN::Math; +using namespace TEN::Effects::Fireflies; namespace TEN::Entities::TR3 { + constexpr auto FLY_EFFECT_MAX_WIDTH = -1; + constexpr auto FLY_AMOUNT = 16; + enum CorpseState { CORPSE_STATE_GROUNDED = 0, @@ -51,19 +56,25 @@ namespace TEN::Entities::TR3 if (item.TriggerFlags == 1) { - item.ItemFlags[1] = (int)CorpseFlag::Hang; + item.ItemFlags[7] = (int)CorpseFlag::Hang; item.Animation.AnimNumber = object.animIndex + CORPSE_ANIM_HANG; item.Animation.ActiveState = CORPSE_STATE_HANG; } else { - item.ItemFlags[1] = (int)CorpseFlag::Grounded; + item.ItemFlags[7] = (int)CorpseFlag::Grounded; item.Animation.AnimNumber = object.animIndex + CORPSE_ANIM_GROUNDED; item.Animation.ActiveState = CORPSE_STATE_GROUNDED; } + item.ItemFlags[FirefliesItemFlags::RemoveFliesEffect] = 0; + AddActiveItem(itemNumber); item.Status = ITEM_ACTIVE; + + item.ItemFlags[FirefliesItemFlags::TargetItemPtr] = item.Index; + item.ItemFlags[FirefliesItemFlags::TriggerFlags] = -1; + item.HitPoints = FLY_AMOUNT; } void ControlCorpse(short itemNumber) @@ -71,9 +82,11 @@ namespace TEN::Entities::TR3 auto& item = g_Level.Items[itemNumber]; const auto& object = Objects[item.ObjectNumber]; - if (item.ItemFlags[1] == (int)CorpseFlag::Fall) + if (item.ItemFlags[7] == (int)CorpseFlag::Fall) { bool isWater = TestEnvironment(RoomEnvFlags::ENV_FLAG_WATER, item.RoomNumber); + bool isSwamp = TestEnvironment(RoomEnvFlags::ENV_FLAG_SWAMP, item.RoomNumber); + float verticalVelCoeff = isWater ? 81.0f : 1.0f; auto pointColl = GetPointCollision(item); @@ -94,31 +107,37 @@ namespace TEN::Entities::TR3 ItemNewRoom(itemNumber, pointColl.GetRoomNumber()); } - pointColl = GetPointCollision(item); + // Remove fly effect when in water. + if (isWater || isSwamp) + { + item.ItemFlags[FirefliesItemFlags::RemoveFliesEffect] = 1; + } + + auto bounds = GameBoundingBox(&item); + item.Animation.IsAirborne = true; - if (pointColl.GetFloorHeight() < item.Pose.Position.y) + if (pointColl.GetFloorHeight() <= item.Pose.Position.y - bounds.Y2) { if (!isWater) { - item.Pose.Position.y = item.Pose.Position.y - item.Animation.Velocity.y; + item.Pose.Position.y = pointColl.GetFloorHeight(); SoundEffect(SFX_TR4_CROCGOD_LAND, &item.Pose); } - else + else { - item.Pose.Position.y = item.Pose.Position.y; + item.Pose.Position.y = pointColl.GetFloorHeight(); } item.Animation.IsAirborne = false; item.Animation.Velocity = Vector3::Zero; item.Animation.TargetState = CORPSE_STATE_LAND; item.Animation.AnimNumber = object.animIndex + CORPSE_ANIM_LAND; - AlignEntityToSurface(&item, Vector2(object.radius)); - item.ItemFlags[1] = (int)CorpseFlag::Grounded; + item.ItemFlags[7] = (int)CorpseFlag::Grounded; return; } - else + else if (item.Animation.ActiveState == CORPSE_STATE_FALL) { if (isWater) { @@ -133,17 +152,56 @@ namespace TEN::Entities::TR3 AnimateItem(&item); - if (!TriggerActive(&item)) - return; - - int meshCount = object.nmeshes; - for (int i = 0; i < meshCount; i++) + if (!TriggerActive(&item) || item.ItemFlags[FirefliesItemFlags::RemoveFliesEffect] == 1) { - if (Random::TestProbability(1 / 72.0f)) + // Remove all fireflies associated with this item. + RemoveFireflies(item); + + // Reset ItemFlags. + if (item.HitPoints == NOT_TARGETABLE) + item.HitPoints = FLY_AMOUNT; + + item.ItemFlags[FirefliesItemFlags::Spawncounter] = 0; + + return; + } + else + { + AddActiveItem(itemNumber); + item.Status = ITEM_ACTIVE; + } + + // Spawn fly effect. + if (item.HitPoints != NOT_TARGETABLE) + { + int fireflyCount = item.HitPoints - item.ItemFlags[FirefliesItemFlags::Spawncounter]; + + if (fireflyCount < 0) { - auto pos = GetJointPosition(&item, i).ToVector3(); - SpawnCorpseEffect(pos); + int firefliesToTurnOff = -fireflyCount; + for (auto& firefly : FireflySwarm) + { + if (firefly.TargetItemPtr == &item && firefly.Life > 0.0f) + { + firefly.Life = 0.0f; + firefly.on = false; + firefliesToTurnOff--; + + if (firefliesToTurnOff == 0) + break; + } + } } + else if (fireflyCount > 0) + { + for (int i = 0; i < fireflyCount; i++) + { + SpawnFireflySwarm(item, FLY_EFFECT_MAX_WIDTH); + } + } + + item.ItemFlags[FirefliesItemFlags::Spawncounter] = item.HitPoints; + item.HitPoints = NOT_TARGETABLE; } } @@ -160,9 +218,9 @@ namespace TEN::Entities::TR3 { DoBloodSplat(pos->x, pos->y, pos->z, Random::GenerateInt(4, 8), source.Pose.Orientation.y, pos->RoomNumber); - if (target.ItemFlags[1] == (int)CorpseFlag::Hang) + if (target.ItemFlags[7] == (int)CorpseFlag::Hang) { - target.ItemFlags[1] = (int)CorpseFlag::Fall; + target.ItemFlags[7] = (int)CorpseFlag::Fall; target.Animation.AnimNumber = object.animIndex + CORPSE_ANIM_FALL; target.Animation.ActiveState = CORPSE_STATE_FALL; } diff --git a/TombEngine/Objects/TR5/tr5_objects.cpp b/TombEngine/Objects/TR5/tr5_objects.cpp index 9b5b878b6..130d7405f 100644 --- a/TombEngine/Objects/TR5/tr5_objects.cpp +++ b/TombEngine/Objects/TR5/tr5_objects.cpp @@ -42,6 +42,7 @@ #include "Objects/TR5/Emitter/tr5_spider_emitter.h" #include "Objects/TR5/Emitter/tr5_smoke_emitter.h" #include "Objects/TR5/Emitter/Waterfall.h" +#include "Objects/Effects/Fireflies.h" // Objects #include "Objects/TR5/Light/tr5_light.h" @@ -81,6 +82,7 @@ using namespace TEN::Effects::WaterfallEmitter; using namespace TEN::Entities::Creatures::TR5; using namespace TEN::Entities::Switches; using namespace TEN::Entities::Traps; +using namespace TEN::Effects::Fireflies; static void StartEntity(ObjectInfo *obj) { @@ -796,6 +798,14 @@ static void StartObject(ObjectInfo *obj) obj->control = ControlEmberEmitter; } + obj = &Objects[ID_FIREFLY_EMITTER]; + if (obj->loaded) + { + obj->Initialize = InitializeFireflySwarm; + obj->control = ControlFireflySwarm; + obj->drawRoutine = NULL; + } + obj = &Objects[ID_GEN_SLOT1]; if (obj->loaded) { diff --git a/TombEngine/Objects/game_object_ids.h b/TombEngine/Objects/game_object_ids.h index 26138ce91..18c64a25b 100644 --- a/TombEngine/Objects/game_object_ids.h +++ b/TombEngine/Objects/game_object_ids.h @@ -817,6 +817,7 @@ enum GAME_OBJECT_ID : short ID_CORPSE, ID_WRAITH_TRAP, ID_WATERFALL_EMITTER, + ID_FIREFLY_EMITTER, ID_MESHSWAP1 = 1100, ID_MESHSWAP2, @@ -1006,8 +1007,8 @@ enum GAME_OBJECT_ID : short ID_DASH_BAR_TEXTURE, ID_SFX_BAR_TEXTURE, ID_WATERFALL_SPRITES, - // 1379 - ID_CROSSHAIR_GRAPHICS = 1380, + ID_FIREFLY_SPRITES, + ID_CROSSHAIR_GRAPHICS, ID_SPEEDOMETER_GRAPHICS, ID_CUSTOM_BAR_GRAPHICS, ID_CUSTOM_AMMO_GRAPHICS, diff --git a/TombEngine/Renderer/Renderer.h b/TombEngine/Renderer/Renderer.h index cfe315b4c..4e643388d 100644 --- a/TombEngine/Renderer/Renderer.h +++ b/TombEngine/Renderer/Renderer.h @@ -409,6 +409,7 @@ namespace TEN::Renderer void PrepareFires(RenderView& view); void PrepareParticles(RenderView& view); void PrepareSmokes(RenderView& view); + void PrepareFireflies(RenderView& view); void PrepareElectricity(RenderView& view); void PrepareHelicalLasers(RenderView& view); void PrepareBlood(RenderView& view); diff --git a/TombEngine/Renderer/RendererDraw.cpp b/TombEngine/Renderer/RendererDraw.cpp index a79e06298..1c63b24d8 100644 --- a/TombEngine/Renderer/RendererDraw.cpp +++ b/TombEngine/Renderer/RendererDraw.cpp @@ -1759,6 +1759,7 @@ namespace TEN::Renderer PrepareStreamers(view); PrepareLaserBarriers(view); PrepareSingleLaserBeam(view); + PrepareFireflies(view); // Sprites grouped in buckets for instancing. Non-commutative sprites are collected at a later stage. SortAndPrepareSprites(view); diff --git a/TombEngine/Renderer/RendererDrawEffect.cpp b/TombEngine/Renderer/RendererDrawEffect.cpp index 3b00f6c5f..e647f86b1 100644 --- a/TombEngine/Renderer/RendererDrawEffect.cpp +++ b/TombEngine/Renderer/RendererDrawEffect.cpp @@ -35,6 +35,7 @@ #include "Scripting/Include/Flow/ScriptInterfaceFlowHandler.h" #include "Specific/level.h" #include "Structures/RendererSpriteBucket.h" +#include "Objects/Effects/Fireflies.h" using namespace TEN::Effects::Blood; using namespace TEN::Effects::Bubble; @@ -48,6 +49,7 @@ using namespace TEN::Effects::Streamer; using namespace TEN::Entities::Creatures::TR5; using namespace TEN::Entities::Traps; using namespace TEN::Math; +using namespace TEN::Effects::Fireflies; extern BLOOD_STRUCT Blood[MAX_SPARKS_BLOOD]; extern FIRE_SPARKS FireSparks[MAX_SPARKS_FIRE]; @@ -330,6 +332,49 @@ namespace TEN::Renderer } } + void Renderer::PrepareFireflies(RenderView& view) + { + if (!Objects[ID_FIREFLY_EMITTER].loaded) + return; + + for (auto& firefly : FireflySwarm) + { + if (!firefly.on) + continue; + + + if (!CheckIfSlotExists(ID_SPARK_SPRITE, "Particle rendering")) + continue; + + auto axis = Vector3(0,0,0); + axis.Normalize(); + + + firefly.scalar = 3; + firefly.size = 3; + + auto pos = Vector3::Lerp( + Vector3(firefly.PrevX, firefly.PrevY, firefly.PrevZ), + Vector3(firefly.Position.x, firefly.Position.y, firefly.Position.z), + GetInterpolationFactor()); + + pos = Vector3(firefly.Position.x, firefly.Position.y, firefly.Position.z); + + // Disallow sprites out of bounds. + int spriteIndex = Objects[firefly.SpriteSeqID].meshIndex + firefly.SpriteID; + spriteIndex = std::clamp(spriteIndex, 0, (int)_sprites.size()); + + AddSpriteBillboard( + &_sprites[spriteIndex], + pos, + Color(firefly.r / (float)UCHAR_MAX, firefly.g / (float)UCHAR_MAX, firefly.b / (float)UCHAR_MAX, 1.0f), + TO_RAD(firefly.rotAng << 4), firefly.scalar, + Vector2(firefly.size, firefly.size), + firefly.blendMode, true, view); + + } + } + void Renderer::PrepareSmokes(RenderView& view) { for (const auto& smoke : SmokeSparks) diff --git a/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h b/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h index 41dba67cb..04e5732a8 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h +++ b/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h @@ -1,7 +1,7 @@ #pragma once // This file is generated automatically, do not edit it. -// Last generated on 13/03/2025. +// Last generated on 17/03/2025. #include #include @@ -815,6 +815,7 @@ The following constants are inside ObjID. CORPSE WRAITH_TRAP WATERFALL_EMITTER + FIREFLY_EMITTER MESHSWAP1 MESHSWAP2 MESHSWAP3 @@ -995,6 +996,7 @@ The following constants are inside ObjID. DASH_BAR_TEXTURE SFX_BAR_TEXTURE WATERFALL_SPRITES + FIREFLY_SPRITES CROSSHAIR_GRAPHICS SPEEDOMETER_GRAPHICS CUSTOM_BAR_GRAPHICS @@ -1245,6 +1247,7 @@ The following ObjID members refer to sprites. DASH_BAR_TEXTURE SFX_BAR_TEXTURE WATERFALL_SPRITES + FIREFLY_SPRITES CROSSHAIR_GRAPHICS SPEEDOMETER_GRAPHICS CUSTOM_BAR_GRAPHICS @@ -2052,6 +2055,7 @@ static const std::unordered_map GAME_OBJECT_IDS { { "CORPSE", ID_CORPSE }, { "WRAITH_TRAP", ID_WRAITH_TRAP }, { "WATERFALL_EMITTER", ID_WATERFALL_EMITTER }, + { "FIREFLY_EMITTER", ID_FIREFLY_EMITTER }, { "MESHSWAP1", ID_MESHSWAP1 }, { "MESHSWAP2", ID_MESHSWAP2 }, { "MESHSWAP3", ID_MESHSWAP3 }, @@ -2232,6 +2236,7 @@ static const std::unordered_map GAME_OBJECT_IDS { { "DASH_BAR_TEXTURE", ID_DASH_BAR_TEXTURE }, { "SFX_BAR_TEXTURE", ID_SFX_BAR_TEXTURE }, { "WATERFALL_SPRITES", ID_WATERFALL_SPRITES }, + { "FIREFLY_SPRITES", ID_FIREFLY_SPRITES }, { "CROSSHAIR_GRAPHICS", ID_CROSSHAIR_GRAPHICS }, { "SPEEDOMETER_GRAPHICS", ID_SPEEDOMETER_GRAPHICS }, { "CUSTOM_BAR_GRAPHICS", ID_CUSTOM_BAR_GRAPHICS }, diff --git a/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h b/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h index 5c8333d07..a99d79882 100644 --- a/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h +++ b/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h @@ -169,6 +169,10 @@ struct FishData; struct FishDataBuilder; struct FishDataT; +struct FireflyData; +struct FireflyDataBuilder; +struct FireflyDataT; + struct KeyValPair; struct ScriptTable; @@ -6861,6 +6865,295 @@ struct FishData::Traits { flatbuffers::Offset CreateFishData(flatbuffers::FlatBufferBuilder &_fbb, const FishDataT *_o, const flatbuffers::rehasher_function_t *_rehasher = nullptr); +struct FireflyDataT : public flatbuffers::NativeTable { + typedef FireflyData TableType; + int32_t sprite_index = 0; + int32_t sprite_id = 0; + int32_t blend_mode = 0; + int32_t scalar = 0; + std::unique_ptr position{}; + int32_t room_number = 0; + std::unique_ptr position_target{}; + std::unique_ptr orientation{}; + float velocity = 0.0f; + int32_t target_item_number = 0; + float z_vel = 0.0f; + float life = 0.0f; + int32_t number = 0; + int32_t d_r = 0; + int32_t d_g = 0; + int32_t d_b = 0; + int32_t r = 0; + int32_t g = 0; + int32_t b = 0; + bool on = false; + float size = 0.0f; + int32_t rot_Ang = 0; +}; + +struct FireflyData FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { + typedef FireflyDataT NativeTableType; + typedef FireflyDataBuilder Builder; + struct Traits; + enum FlatBuffersVTableOffset FLATBUFFERS_VTABLE_UNDERLYING_TYPE { + VT_SPRITE_INDEX = 4, + VT_SPRITE_ID = 6, + VT_BLEND_MODE = 8, + VT_SCALAR = 10, + VT_POSITION = 12, + VT_ROOM_NUMBER = 14, + VT_POSITION_TARGET = 16, + VT_ORIENTATION = 18, + VT_VELOCITY = 20, + VT_TARGET_ITEM_NUMBER = 22, + VT_Z_VEL = 24, + VT_LIFE = 26, + VT_NUMBER = 28, + VT_D_R = 30, + VT_D_G = 32, + VT_D_B = 34, + VT_R = 36, + VT_G = 38, + VT_B = 40, + VT_ON = 42, + VT_SIZE = 44, + VT_ROT_ANG = 46 + }; + int32_t sprite_index() const { + return GetField(VT_SPRITE_INDEX, 0); + } + int32_t sprite_id() const { + return GetField(VT_SPRITE_ID, 0); + } + int32_t blend_mode() const { + return GetField(VT_BLEND_MODE, 0); + } + int32_t scalar() const { + return GetField(VT_SCALAR, 0); + } + const TEN::Save::Vector3 *position() const { + return GetStruct(VT_POSITION); + } + int32_t room_number() const { + return GetField(VT_ROOM_NUMBER, 0); + } + const TEN::Save::Vector3 *position_target() const { + return GetStruct(VT_POSITION_TARGET); + } + const TEN::Save::EulerAngles *orientation() const { + return GetStruct(VT_ORIENTATION); + } + float velocity() const { + return GetField(VT_VELOCITY, 0.0f); + } + int32_t target_item_number() const { + return GetField(VT_TARGET_ITEM_NUMBER, 0); + } + float z_vel() const { + return GetField(VT_Z_VEL, 0.0f); + } + float life() const { + return GetField(VT_LIFE, 0.0f); + } + int32_t number() const { + return GetField(VT_NUMBER, 0); + } + int32_t d_r() const { + return GetField(VT_D_R, 0); + } + int32_t d_g() const { + return GetField(VT_D_G, 0); + } + int32_t d_b() const { + return GetField(VT_D_B, 0); + } + int32_t r() const { + return GetField(VT_R, 0); + } + int32_t g() const { + return GetField(VT_G, 0); + } + int32_t b() const { + return GetField(VT_B, 0); + } + bool on() const { + return GetField(VT_ON, 0) != 0; + } + float size() const { + return GetField(VT_SIZE, 0.0f); + } + int32_t rot_Ang() const { + return GetField(VT_ROT_ANG, 0); + } + bool Verify(flatbuffers::Verifier &verifier) const { + return VerifyTableStart(verifier) && + VerifyField(verifier, VT_SPRITE_INDEX) && + VerifyField(verifier, VT_SPRITE_ID) && + VerifyField(verifier, VT_BLEND_MODE) && + VerifyField(verifier, VT_SCALAR) && + VerifyField(verifier, VT_POSITION) && + VerifyField(verifier, VT_ROOM_NUMBER) && + VerifyField(verifier, VT_POSITION_TARGET) && + VerifyField(verifier, VT_ORIENTATION) && + VerifyField(verifier, VT_VELOCITY) && + VerifyField(verifier, VT_TARGET_ITEM_NUMBER) && + VerifyField(verifier, VT_Z_VEL) && + VerifyField(verifier, VT_LIFE) && + VerifyField(verifier, VT_NUMBER) && + VerifyField(verifier, VT_D_R) && + VerifyField(verifier, VT_D_G) && + VerifyField(verifier, VT_D_B) && + VerifyField(verifier, VT_R) && + VerifyField(verifier, VT_G) && + VerifyField(verifier, VT_B) && + VerifyField(verifier, VT_ON) && + VerifyField(verifier, VT_SIZE) && + VerifyField(verifier, VT_ROT_ANG) && + verifier.EndTable(); + } + FireflyDataT *UnPack(const flatbuffers::resolver_function_t *_resolver = nullptr) const; + void UnPackTo(FireflyDataT *_o, const flatbuffers::resolver_function_t *_resolver = nullptr) const; + static flatbuffers::Offset Pack(flatbuffers::FlatBufferBuilder &_fbb, const FireflyDataT* _o, const flatbuffers::rehasher_function_t *_rehasher = nullptr); +}; + +struct FireflyDataBuilder { + typedef FireflyData Table; + flatbuffers::FlatBufferBuilder &fbb_; + flatbuffers::uoffset_t start_; + void add_sprite_index(int32_t sprite_index) { + fbb_.AddElement(FireflyData::VT_SPRITE_INDEX, sprite_index, 0); + } + void add_sprite_id(int32_t sprite_id) { + fbb_.AddElement(FireflyData::VT_SPRITE_ID, sprite_id, 0); + } + void add_blend_mode(int32_t blend_mode) { + fbb_.AddElement(FireflyData::VT_BLEND_MODE, blend_mode, 0); + } + void add_scalar(int32_t scalar) { + fbb_.AddElement(FireflyData::VT_SCALAR, scalar, 0); + } + void add_position(const TEN::Save::Vector3 *position) { + fbb_.AddStruct(FireflyData::VT_POSITION, position); + } + void add_room_number(int32_t room_number) { + fbb_.AddElement(FireflyData::VT_ROOM_NUMBER, room_number, 0); + } + void add_position_target(const TEN::Save::Vector3 *position_target) { + fbb_.AddStruct(FireflyData::VT_POSITION_TARGET, position_target); + } + void add_orientation(const TEN::Save::EulerAngles *orientation) { + fbb_.AddStruct(FireflyData::VT_ORIENTATION, orientation); + } + void add_velocity(float velocity) { + fbb_.AddElement(FireflyData::VT_VELOCITY, velocity, 0.0f); + } + void add_target_item_number(int32_t target_item_number) { + fbb_.AddElement(FireflyData::VT_TARGET_ITEM_NUMBER, target_item_number, 0); + } + void add_z_vel(float z_vel) { + fbb_.AddElement(FireflyData::VT_Z_VEL, z_vel, 0.0f); + } + void add_life(float life) { + fbb_.AddElement(FireflyData::VT_LIFE, life, 0.0f); + } + void add_number(int32_t number) { + fbb_.AddElement(FireflyData::VT_NUMBER, number, 0); + } + void add_d_r(int32_t d_r) { + fbb_.AddElement(FireflyData::VT_D_R, d_r, 0); + } + void add_d_g(int32_t d_g) { + fbb_.AddElement(FireflyData::VT_D_G, d_g, 0); + } + void add_d_b(int32_t d_b) { + fbb_.AddElement(FireflyData::VT_D_B, d_b, 0); + } + void add_r(int32_t r) { + fbb_.AddElement(FireflyData::VT_R, r, 0); + } + void add_g(int32_t g) { + fbb_.AddElement(FireflyData::VT_G, g, 0); + } + void add_b(int32_t b) { + fbb_.AddElement(FireflyData::VT_B, b, 0); + } + void add_on(bool on) { + fbb_.AddElement(FireflyData::VT_ON, static_cast(on), 0); + } + void add_size(float size) { + fbb_.AddElement(FireflyData::VT_SIZE, size, 0.0f); + } + void add_rot_Ang(int32_t rot_Ang) { + fbb_.AddElement(FireflyData::VT_ROT_ANG, rot_Ang, 0); + } + explicit FireflyDataBuilder(flatbuffers::FlatBufferBuilder &_fbb) + : fbb_(_fbb) { + start_ = fbb_.StartTable(); + } + flatbuffers::Offset Finish() { + const auto end = fbb_.EndTable(start_); + auto o = flatbuffers::Offset(end); + return o; + } +}; + +inline flatbuffers::Offset CreateFireflyData( + flatbuffers::FlatBufferBuilder &_fbb, + int32_t sprite_index = 0, + int32_t sprite_id = 0, + int32_t blend_mode = 0, + int32_t scalar = 0, + const TEN::Save::Vector3 *position = 0, + int32_t room_number = 0, + const TEN::Save::Vector3 *position_target = 0, + const TEN::Save::EulerAngles *orientation = 0, + float velocity = 0.0f, + int32_t target_item_number = 0, + float z_vel = 0.0f, + float life = 0.0f, + int32_t number = 0, + int32_t d_r = 0, + int32_t d_g = 0, + int32_t d_b = 0, + int32_t r = 0, + int32_t g = 0, + int32_t b = 0, + bool on = false, + float size = 0.0f, + int32_t rot_Ang = 0) { + FireflyDataBuilder builder_(_fbb); + builder_.add_rot_Ang(rot_Ang); + builder_.add_size(size); + builder_.add_b(b); + builder_.add_g(g); + builder_.add_r(r); + builder_.add_d_b(d_b); + builder_.add_d_g(d_g); + builder_.add_d_r(d_r); + builder_.add_number(number); + builder_.add_life(life); + builder_.add_z_vel(z_vel); + builder_.add_target_item_number(target_item_number); + builder_.add_velocity(velocity); + builder_.add_orientation(orientation); + builder_.add_position_target(position_target); + builder_.add_room_number(room_number); + builder_.add_position(position); + builder_.add_scalar(scalar); + builder_.add_blend_mode(blend_mode); + builder_.add_sprite_id(sprite_id); + builder_.add_sprite_index(sprite_index); + builder_.add_on(on); + return builder_.Finish(); +} + +struct FireflyData::Traits { + using type = FireflyData; + static auto constexpr Create = CreateFireflyData; +}; + +flatbuffers::Offset CreateFireflyData(flatbuffers::FlatBufferBuilder &_fbb, const FireflyDataT *_o, const flatbuffers::rehasher_function_t *_rehasher = nullptr); + struct ScriptTableT : public flatbuffers::NativeTable { typedef ScriptTable TableType; std::vector keys_vals{}; @@ -8000,6 +8293,7 @@ struct SaveGameT : public flatbuffers::NativeTable { int32_t next_item_active = 0; std::vector room_items{}; std::vector> fish_swarm{}; + std::vector> firefly_swarm{}; std::vector> fxinfos{}; int32_t next_fx_free = 0; int32_t next_fx_active = 0; @@ -8066,52 +8360,53 @@ struct SaveGame FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { VT_NEXT_ITEM_ACTIVE = 24, VT_ROOM_ITEMS = 26, VT_FISH_SWARM = 28, - VT_FXINFOS = 30, - VT_NEXT_FX_FREE = 32, - VT_NEXT_FX_ACTIVE = 34, - VT_FIXED_CAMERAS = 36, - VT_SINKS = 38, - VT_STATIC_MESHES = 40, - VT_FLYBY_CAMERAS = 42, - VT_PARTICLES = 44, - VT_RATS = 46, - VT_SPIDERS = 48, - VT_SCARABS = 50, - VT_BATS = 52, - VT_FLIP_MAPS = 54, - VT_FLIP_STATS = 56, - VT_FLIP_EFFECT = 58, - VT_FLIP_TIMER = 60, - VT_FLIP_STATUS = 62, - VT_CURRENT_FOV = 64, - VT_LAST_INV_ITEM = 66, - VT_ACTION_QUEUE = 68, - VT_SOUNDTRACKS = 70, - VT_CD_FLAGS = 72, - VT_POSTPROCESS_MODE = 74, - VT_POSTPROCESS_STRENGTH = 76, - VT_POSTPROCESS_TINT = 78, - VT_ROPE = 80, - VT_PENDULUM = 82, - VT_ALTERNATE_PENDULUM = 84, - VT_VOLUMES = 86, - VT_GLOBAL_EVENT_SETS = 88, - VT_VOLUME_EVENT_SETS = 90, - VT_SCRIPT_VARS = 92, - VT_CALLBACKS_PRE_START = 94, - VT_CALLBACKS_POST_START = 96, - VT_CALLBACKS_PRE_END = 98, - VT_CALLBACKS_POST_END = 100, - VT_CALLBACKS_PRE_SAVE = 102, - VT_CALLBACKS_POST_SAVE = 104, - VT_CALLBACKS_PRE_LOAD = 106, - VT_CALLBACKS_POST_LOAD = 108, - VT_CALLBACKS_PRE_LOOP = 110, - VT_CALLBACKS_POST_LOOP = 112, - VT_CALLBACKS_PRE_USEITEM = 114, - VT_CALLBACKS_POST_USEITEM = 116, - VT_CALLBACKS_PRE_FREEZE = 118, - VT_CALLBACKS_POST_FREEZE = 120 + VT_FIREFLY_SWARM = 30, + VT_FXINFOS = 32, + VT_NEXT_FX_FREE = 34, + VT_NEXT_FX_ACTIVE = 36, + VT_FIXED_CAMERAS = 38, + VT_SINKS = 40, + VT_STATIC_MESHES = 42, + VT_FLYBY_CAMERAS = 44, + VT_PARTICLES = 46, + VT_RATS = 48, + VT_SPIDERS = 50, + VT_SCARABS = 52, + VT_BATS = 54, + VT_FLIP_MAPS = 56, + VT_FLIP_STATS = 58, + VT_FLIP_EFFECT = 60, + VT_FLIP_TIMER = 62, + VT_FLIP_STATUS = 64, + VT_CURRENT_FOV = 66, + VT_LAST_INV_ITEM = 68, + VT_ACTION_QUEUE = 70, + VT_SOUNDTRACKS = 72, + VT_CD_FLAGS = 74, + VT_POSTPROCESS_MODE = 76, + VT_POSTPROCESS_STRENGTH = 78, + VT_POSTPROCESS_TINT = 80, + VT_ROPE = 82, + VT_PENDULUM = 84, + VT_ALTERNATE_PENDULUM = 86, + VT_VOLUMES = 88, + VT_GLOBAL_EVENT_SETS = 90, + VT_VOLUME_EVENT_SETS = 92, + VT_SCRIPT_VARS = 94, + VT_CALLBACKS_PRE_START = 96, + VT_CALLBACKS_POST_START = 98, + VT_CALLBACKS_PRE_END = 100, + VT_CALLBACKS_POST_END = 102, + VT_CALLBACKS_PRE_SAVE = 104, + VT_CALLBACKS_POST_SAVE = 106, + VT_CALLBACKS_PRE_LOAD = 108, + VT_CALLBACKS_POST_LOAD = 110, + VT_CALLBACKS_PRE_LOOP = 112, + VT_CALLBACKS_POST_LOOP = 114, + VT_CALLBACKS_PRE_USEITEM = 116, + VT_CALLBACKS_POST_USEITEM = 118, + VT_CALLBACKS_PRE_FREEZE = 120, + VT_CALLBACKS_POST_FREEZE = 122 }; const TEN::Save::SaveGameHeader *header() const { return GetPointer(VT_HEADER); @@ -8152,6 +8447,9 @@ struct SaveGame FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { const flatbuffers::Vector> *fish_swarm() const { return GetPointer> *>(VT_FISH_SWARM); } + const flatbuffers::Vector> *firefly_swarm() const { + return GetPointer> *>(VT_FIREFLY_SWARM); + } const flatbuffers::Vector> *fxinfos() const { return GetPointer> *>(VT_FXINFOS); } @@ -8318,6 +8616,9 @@ struct SaveGame FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { VerifyOffset(verifier, VT_FISH_SWARM) && verifier.VerifyVector(fish_swarm()) && verifier.VerifyVectorOfTables(fish_swarm()) && + VerifyOffset(verifier, VT_FIREFLY_SWARM) && + verifier.VerifyVector(firefly_swarm()) && + verifier.VerifyVectorOfTables(firefly_swarm()) && VerifyOffset(verifier, VT_FXINFOS) && verifier.VerifyVector(fxinfos()) && verifier.VerifyVectorOfTables(fxinfos()) && @@ -8478,6 +8779,9 @@ struct SaveGameBuilder { void add_fish_swarm(flatbuffers::Offset>> fish_swarm) { fbb_.AddOffset(SaveGame::VT_FISH_SWARM, fish_swarm); } + void add_firefly_swarm(flatbuffers::Offset>> firefly_swarm) { + fbb_.AddOffset(SaveGame::VT_FIREFLY_SWARM, firefly_swarm); + } void add_fxinfos(flatbuffers::Offset>> fxinfos) { fbb_.AddOffset(SaveGame::VT_FXINFOS, fxinfos); } @@ -8642,6 +8946,7 @@ inline flatbuffers::Offset CreateSaveGame( int32_t next_item_active = 0, flatbuffers::Offset> room_items = 0, flatbuffers::Offset>> fish_swarm = 0, + flatbuffers::Offset>> firefly_swarm = 0, flatbuffers::Offset>> fxinfos = 0, int32_t next_fx_free = 0, int32_t next_fx_active = 0, @@ -8734,6 +9039,7 @@ inline flatbuffers::Offset CreateSaveGame( builder_.add_next_fx_active(next_fx_active); builder_.add_next_fx_free(next_fx_free); builder_.add_fxinfos(fxinfos); + builder_.add_firefly_swarm(firefly_swarm); builder_.add_fish_swarm(fish_swarm); builder_.add_room_items(room_items); builder_.add_next_item_active(next_item_active); @@ -8771,6 +9077,7 @@ inline flatbuffers::Offset CreateSaveGameDirect( int32_t next_item_active = 0, const std::vector *room_items = nullptr, const std::vector> *fish_swarm = nullptr, + const std::vector> *firefly_swarm = nullptr, const std::vector> *fxinfos = nullptr, int32_t next_fx_free = 0, int32_t next_fx_active = 0, @@ -8821,6 +9128,7 @@ inline flatbuffers::Offset CreateSaveGameDirect( auto items__ = items ? _fbb.CreateVector>(*items) : 0; auto room_items__ = room_items ? _fbb.CreateVector(*room_items) : 0; auto fish_swarm__ = fish_swarm ? _fbb.CreateVector>(*fish_swarm) : 0; + auto firefly_swarm__ = firefly_swarm ? _fbb.CreateVector>(*firefly_swarm) : 0; auto fxinfos__ = fxinfos ? _fbb.CreateVector>(*fxinfos) : 0; auto fixed_cameras__ = fixed_cameras ? _fbb.CreateVector>(*fixed_cameras) : 0; auto sinks__ = sinks ? _fbb.CreateVector>(*sinks) : 0; @@ -8868,6 +9176,7 @@ inline flatbuffers::Offset CreateSaveGameDirect( next_item_active, room_items__, fish_swarm__, + firefly_swarm__, fxinfos__, next_fx_free, next_fx_active, @@ -10889,6 +11198,95 @@ inline flatbuffers::Offset CreateFishData(flatbuffers::FlatBufferBuild _velocity); } +inline FireflyDataT *FireflyData::UnPack(const flatbuffers::resolver_function_t *_resolver) const { + auto _o = std::make_unique(); + UnPackTo(_o.get(), _resolver); + return _o.release(); +} + +inline void FireflyData::UnPackTo(FireflyDataT *_o, const flatbuffers::resolver_function_t *_resolver) const { + (void)_o; + (void)_resolver; + { auto _e = sprite_index(); _o->sprite_index = _e; } + { auto _e = sprite_id(); _o->sprite_id = _e; } + { auto _e = blend_mode(); _o->blend_mode = _e; } + { auto _e = scalar(); _o->scalar = _e; } + { auto _e = position(); if (_e) _o->position = std::unique_ptr(new TEN::Save::Vector3(*_e)); } + { auto _e = room_number(); _o->room_number = _e; } + { auto _e = position_target(); if (_e) _o->position_target = std::unique_ptr(new TEN::Save::Vector3(*_e)); } + { auto _e = orientation(); if (_e) _o->orientation = std::unique_ptr(new TEN::Save::EulerAngles(*_e)); } + { auto _e = velocity(); _o->velocity = _e; } + { auto _e = target_item_number(); _o->target_item_number = _e; } + { auto _e = z_vel(); _o->z_vel = _e; } + { auto _e = life(); _o->life = _e; } + { auto _e = number(); _o->number = _e; } + { auto _e = d_r(); _o->d_r = _e; } + { auto _e = d_g(); _o->d_g = _e; } + { auto _e = d_b(); _o->d_b = _e; } + { auto _e = r(); _o->r = _e; } + { auto _e = g(); _o->g = _e; } + { auto _e = b(); _o->b = _e; } + { auto _e = on(); _o->on = _e; } + { auto _e = size(); _o->size = _e; } + { auto _e = rot_Ang(); _o->rot_Ang = _e; } +} + +inline flatbuffers::Offset FireflyData::Pack(flatbuffers::FlatBufferBuilder &_fbb, const FireflyDataT* _o, const flatbuffers::rehasher_function_t *_rehasher) { + return CreateFireflyData(_fbb, _o, _rehasher); +} + +inline flatbuffers::Offset CreateFireflyData(flatbuffers::FlatBufferBuilder &_fbb, const FireflyDataT *_o, const flatbuffers::rehasher_function_t *_rehasher) { + (void)_rehasher; + (void)_o; + struct _VectorArgs { flatbuffers::FlatBufferBuilder *__fbb; const FireflyDataT* __o; const flatbuffers::rehasher_function_t *__rehasher; } _va = { &_fbb, _o, _rehasher}; (void)_va; + auto _sprite_index = _o->sprite_index; + auto _sprite_id = _o->sprite_id; + auto _blend_mode = _o->blend_mode; + auto _scalar = _o->scalar; + auto _position = _o->position ? _o->position.get() : 0; + auto _room_number = _o->room_number; + auto _position_target = _o->position_target ? _o->position_target.get() : 0; + auto _orientation = _o->orientation ? _o->orientation.get() : 0; + auto _velocity = _o->velocity; + auto _target_item_number = _o->target_item_number; + auto _z_vel = _o->z_vel; + auto _life = _o->life; + auto _number = _o->number; + auto _d_r = _o->d_r; + auto _d_g = _o->d_g; + auto _d_b = _o->d_b; + auto _r = _o->r; + auto _g = _o->g; + auto _b = _o->b; + auto _on = _o->on; + auto _size = _o->size; + auto _rot_Ang = _o->rot_Ang; + return TEN::Save::CreateFireflyData( + _fbb, + _sprite_index, + _sprite_id, + _blend_mode, + _scalar, + _position, + _room_number, + _position_target, + _orientation, + _velocity, + _target_item_number, + _z_vel, + _life, + _number, + _d_r, + _d_g, + _d_b, + _r, + _g, + _b, + _on, + _size, + _rot_Ang); +} + inline ScriptTableT *ScriptTable::UnPack(const flatbuffers::resolver_function_t *_resolver) const { auto _o = std::make_unique(); UnPackTo(_o.get(), _resolver); @@ -11323,6 +11721,7 @@ inline void SaveGame::UnPackTo(SaveGameT *_o, const flatbuffers::resolver_functi { auto _e = next_item_active(); _o->next_item_active = _e; } { auto _e = room_items(); if (_e) { _o->room_items.resize(_e->size()); for (flatbuffers::uoffset_t _i = 0; _i < _e->size(); _i++) { _o->room_items[_i] = _e->Get(_i); } } } { auto _e = fish_swarm(); if (_e) { _o->fish_swarm.resize(_e->size()); for (flatbuffers::uoffset_t _i = 0; _i < _e->size(); _i++) { _o->fish_swarm[_i] = std::unique_ptr(_e->Get(_i)->UnPack(_resolver)); } } } + { auto _e = firefly_swarm(); if (_e) { _o->firefly_swarm.resize(_e->size()); for (flatbuffers::uoffset_t _i = 0; _i < _e->size(); _i++) { _o->firefly_swarm[_i] = std::unique_ptr(_e->Get(_i)->UnPack(_resolver)); } } } { auto _e = fxinfos(); if (_e) { _o->fxinfos.resize(_e->size()); for (flatbuffers::uoffset_t _i = 0; _i < _e->size(); _i++) { _o->fxinfos[_i] = std::unique_ptr(_e->Get(_i)->UnPack(_resolver)); } } } { auto _e = next_fx_free(); _o->next_fx_free = _e; } { auto _e = next_fx_active(); _o->next_fx_active = _e; } @@ -11392,6 +11791,7 @@ inline flatbuffers::Offset CreateSaveGame(flatbuffers::FlatBufferBuild auto _next_item_active = _o->next_item_active; auto _room_items = _fbb.CreateVector(_o->room_items); auto _fish_swarm = _fbb.CreateVector> (_o->fish_swarm.size(), [](size_t i, _VectorArgs *__va) { return CreateFishData(*__va->__fbb, __va->__o->fish_swarm[i].get(), __va->__rehasher); }, &_va ); + auto _firefly_swarm = _fbb.CreateVector> (_o->firefly_swarm.size(), [](size_t i, _VectorArgs *__va) { return CreateFireflyData(*__va->__fbb, __va->__o->firefly_swarm[i].get(), __va->__rehasher); }, &_va ); auto _fxinfos = _fbb.CreateVector> (_o->fxinfos.size(), [](size_t i, _VectorArgs *__va) { return CreateFXInfo(*__va->__fbb, __va->__o->fxinfos[i].get(), __va->__rehasher); }, &_va ); auto _next_fx_free = _o->next_fx_free; auto _next_fx_active = _o->next_fx_active; @@ -11453,6 +11853,7 @@ inline flatbuffers::Offset CreateSaveGame(flatbuffers::FlatBufferBuild _next_item_active, _room_items, _fish_swarm, + _firefly_swarm, _fxinfos, _next_fx_free, _next_fx_active, diff --git a/TombEngine/Specific/savegame/schema/ten_savegame.fbs b/TombEngine/Specific/savegame/schema/ten_savegame.fbs index b4e852148..bc41d27be 100644 --- a/TombEngine/Specific/savegame/schema/ten_savegame.fbs +++ b/TombEngine/Specific/savegame/schema/ten_savegame.fbs @@ -499,6 +499,31 @@ table FishData { velocity: float; } +table FireflyData { + sprite_index: int32; + sprite_id: int32; + blend_mode: int32; + scalar: int32; + position: Vector3; + room_number: int32; + position_target: Vector3; + orientation: EulerAngles; + velocity: float; + target_item_number: int32; + z_vel: float; + life: float; + number: int32; + d_r: int32; + d_g: int32; + d_b: int32; + r: int32; + g: int32; + b: int32; + on: bool; + size: float; + rot_Ang: int32; +} + struct KeyValPair { key: uint32; val: uint32; @@ -602,6 +627,7 @@ table SaveGame { next_item_active: int32; room_items: [int32]; fish_swarm: [FishData]; + firefly_swarm: [FireflyData]; fxinfos: [FXInfo]; next_fx_free: int32; next_fx_active: int32; diff --git a/TombEngine/TombEngine.vcxproj b/TombEngine/TombEngine.vcxproj index 19ff7ecfb..64841e2e1 100644 --- a/TombEngine/TombEngine.vcxproj +++ b/TombEngine/TombEngine.vcxproj @@ -506,6 +506,7 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. + @@ -1044,6 +1045,7 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings. + From 7ba93702818ebb86abd94271326b499de7a79075 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Fri, 28 Mar 2025 07:11:04 +0100 Subject: [PATCH 109/160] Update CHANGELOG.md --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4e17ee3ae..7f1ceec64 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): ## [Version 1.8.1](link to release) - yyyy-mm-dd ### New features +* Added Firefly Emitter object (ID 1099) with corresponding sprite slot (ID 1379). * Added live console input to perform Lua commands in realtime. ### Bug fixes From 9fc370833bf3c43127fa250bb86413853123b715 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Fri, 28 Mar 2025 21:36:37 +0100 Subject: [PATCH 110/160] Implement flyby spline looping in lua API --- CHANGELOG.md | 1 + Documentation/doc/1 modules/View.html | 18 ++++++-- TombEngine/Game/spotcam.cpp | 44 +++++++++++++++---- TombEngine/Game/spotcam.h | 2 +- .../Internal/TEN/View/ViewHandler.cpp | 10 +++-- 5 files changed, 58 insertions(+), 17 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 7f1ceec64..3d47c249b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -20,6 +20,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): ### Lua API changes * Added missing constructor for `Collision.Probe` without room number. +* Added optional looping argument for `View.GetFlybyPosition` and `View.GetFlybyRotation` functions. ## [Version 1.8](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.8) - 2025-03-16 diff --git a/Documentation/doc/1 modules/View.html b/Documentation/doc/1 modules/View.html index f1725ceb1..40f491a7b 100644 --- a/Documentation/doc/1 modules/View.html +++ b/Documentation/doc/1 modules/View.html @@ -176,11 +176,11 @@
    - + - + @@ -499,7 +499,7 @@
    - GetFlybyPosition(seqID, progress) + GetFlybyPosition(seqID, progress[, loop])
    Get a flyby sequence's position at a specified progress point in percent. @@ -516,6 +516,11 @@ float Progress point in percent. Clamped to [0, 100]. +
  • loop + bool + Smooth the position near start and end points, as if the sequence is looped. + (optional) +

    • Returns:

    @@ -531,7 +536,7 @@
    - GetFlybyRotation(seqID, progress) + GetFlybyRotation(seqID, progress[, loop])
    Get a flyby sequence's rotation at a specified progress point in percent. @@ -548,6 +553,11 @@ float Progress point in percent. Clamped to [0, 100]. +
  • loop + bool + Smooth the position near start and end points, as if the sequence is looped. + (optional) +

    • Returns:

    diff --git a/TombEngine/Game/spotcam.cpp b/TombEngine/Game/spotcam.cpp index ffa8be942..2b6ea8d10 100644 --- a/TombEngine/Game/spotcam.cpp +++ b/TombEngine/Game/spotcam.cpp @@ -839,7 +839,7 @@ int Spline(int x, int* knots, int nk) return ((__int64)x * (((__int64)x * (((__int64)x * c1 >> 16) + c2) >> 16) + (k[2] >> 1) + ((-k[0] - 1) >> 1)) >> 16) + k[1]; } -Pose GetCameraTransform(int sequence, float alpha) +Pose GetCameraTransform(int sequence, float alpha, bool loop) { alpha = std::clamp(alpha, 0.0f, 1.0f); @@ -873,15 +873,43 @@ Pose GetCameraTransform(int sequence, float alpha) } // Compute spline interpolation of main flyby camera parameters. - auto origin = Vector3(Spline(splineAlpha, xOrigins.data(), splinePoints), - Spline(splineAlpha, yOrigins.data(), splinePoints), - Spline(splineAlpha, zOrigins.data(), splinePoints)); + auto getInterpolatedPoint = [&](float t, std::vector& x, std::vector& y, std::vector& z) + { + int tAlpha = int(t * (float)USHRT_MAX); + return Vector3(Spline(tAlpha, x.data(), splinePoints), + Spline(tAlpha, y.data(), splinePoints), + Spline(tAlpha, z.data(), splinePoints)); + }; - auto target = Vector3(Spline(splineAlpha, xTargets.data(), splinePoints), - Spline(splineAlpha, yTargets.data(), splinePoints), - Spline(splineAlpha, zTargets.data(), splinePoints)); + auto getInterpolatedRoll = [&](float t) + { + int tAlpha = int(t * (float)USHRT_MAX); + return Spline(tAlpha, rolls.data(), splinePoints); + }; - short orientZ = Spline(splineAlpha, rolls.data(), splinePoints); + Vector3 origin = {}; + Vector3 target = {}; + short orientZ = 0; + + constexpr float BLEND_RANGE = 0.1f; + constexpr float BLEND_START = BLEND_RANGE; + constexpr float BLEND_END = 1.0f - BLEND_RANGE; + + // If loop is enabled and we are at the start or end of the sequence, blend between the last and first cameras. + if (loop && (alpha < BLEND_START || alpha >= BLEND_END)) + { + float blendFactor = (alpha < BLEND_START) ? 0.5f + (alpha / BLEND_RANGE) * 0.5f : (alpha - BLEND_END) / BLEND_START * 0.5f; + + origin = Vector3::Lerp(getInterpolatedPoint(BLEND_END, xOrigins, yOrigins, zOrigins), getInterpolatedPoint(BLEND_START, xOrigins, yOrigins, zOrigins), blendFactor); + target = Vector3::Lerp(getInterpolatedPoint(BLEND_END, xTargets, yTargets, zTargets), getInterpolatedPoint(BLEND_START, xTargets, yTargets, zTargets), blendFactor); + orientZ = Lerp(getInterpolatedRoll(BLEND_END), getInterpolatedRoll(BLEND_START), blendFactor); + } + else + { + origin = getInterpolatedPoint(alpha, xOrigins, yOrigins, zOrigins); + target = getInterpolatedPoint(alpha, xTargets, yTargets, zTargets); + orientZ = getInterpolatedRoll(alpha); + } auto pose = Pose(origin, EulerAngles(target - origin)); pose.Orientation.z = orientZ; diff --git a/TombEngine/Game/spotcam.h b/TombEngine/Game/spotcam.h index 035929e93..07917c26d 100644 --- a/TombEngine/Game/spotcam.h +++ b/TombEngine/Game/spotcam.h @@ -64,4 +64,4 @@ void InitializeSpotCam(short sequence); void CalculateSpotCameras(); int Spline(int x, int* knots, int nk); -Pose GetCameraTransform(int sequence, float alpha); +Pose GetCameraTransform(int sequence, float alpha, bool loop); diff --git a/TombEngine/Scripting/Internal/TEN/View/ViewHandler.cpp b/TombEngine/Scripting/Internal/TEN/View/ViewHandler.cpp index 501784af1..8076215b2 100644 --- a/TombEngine/Scripting/Internal/TEN/View/ViewHandler.cpp +++ b/TombEngine/Scripting/Internal/TEN/View/ViewHandler.cpp @@ -111,18 +111,18 @@ namespace TEN::Scripting::View InitializeSpotCam(seqID); } - static Vec3 GetFlybyPosition(int seqID, float progress) + static Vec3 GetFlybyPosition(int seqID, float progress, TypeOrNil loop) { constexpr auto PROGRESS_MAX = 100.0f; - return Vec3(GetCameraTransform(seqID, progress / PROGRESS_MAX).Position); + return Vec3(GetCameraTransform(seqID, progress / PROGRESS_MAX, ValueOr(loop, false)).Position); } - static Rotation GetFlybyRotation(int seqID, float progress) + static Rotation GetFlybyRotation(int seqID, float progress, TypeOrNil loop) { constexpr auto PROGRESS_MAX = 100.0f; - return Rotation(GetCameraTransform(seqID, progress / PROGRESS_MAX).Orientation); + return Rotation(GetCameraTransform(seqID, progress / PROGRESS_MAX, ValueOr(loop, false)).Orientation); } static void FlashScreen(TypeOrNil col, TypeOrNil speed) @@ -244,6 +244,7 @@ namespace TEN::Scripting::View // @function GetFlybyPosition // @tparam int seqID Flyby sequence ID. // @tparam float progress Progress point in percent. Clamped to [0, 100]. + // @tparam[opt] bool loop Smooth the position near start and end points, as if the sequence is looped. // @treturn Vec3 Position at the given progress point. tableView.set_function(ScriptReserved_GetFlybyPosition, &GetFlybyPosition); @@ -251,6 +252,7 @@ namespace TEN::Scripting::View // @function GetFlybyRotation // @tparam int seqID Flyby sequence ID. // @tparam float progress Progress point in percent. Clamped to [0, 100]. + // @tparam[opt] bool loop Smooth the position near start and end points, as if the sequence is looped. // @treturn Rotation Rotation at the given progress point. tableView.set_function(ScriptReserved_GetFlybyRotation, &GetFlybyRotation); From d4c8b72bbe0a31bbe6dd238fedfc7fd5ecfa88a5 Mon Sep 17 00:00:00 2001 From: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Fri, 28 Mar 2025 21:37:07 +0000 Subject: [PATCH 111/160] Test commit for Discord --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3d47c249b..0a92d6d75 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,7 +6,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): ## [Version 1.8.1](link to release) - yyyy-mm-dd ### New features -* Added Firefly Emitter object (ID 1099) with corresponding sprite slot (ID 1379). +* Added Firefly Emitter object (ID 1099) with corresponding sprite slots (ID 1379). * Added live console input to perform Lua commands in realtime. ### Bug fixes From 83f71eaf3bb471d3b7f733b211c5d99a5a1f0159 Mon Sep 17 00:00:00 2001 From: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Fri, 28 Mar 2025 21:39:40 +0000 Subject: [PATCH 112/160] Revert "Test commit for Discord" This reverts commit d4c8b72bbe0a31bbe6dd238fedfc7fd5ecfa88a5. --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 0a92d6d75..3d47c249b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,7 +6,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): ## [Version 1.8.1](link to release) - yyyy-mm-dd ### New features -* Added Firefly Emitter object (ID 1099) with corresponding sprite slots (ID 1379). +* Added Firefly Emitter object (ID 1099) with corresponding sprite slot (ID 1379). * Added live console input to perform Lua commands in realtime. ### Bug fixes From 74b7688c7b777bb742c7c21b78aa804a3b0647e2 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Fri, 28 Mar 2025 23:23:43 +0100 Subject: [PATCH 113/160] Update Settings.lua --- Scripts/Settings.lua | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Scripts/Settings.lua b/Scripts/Settings.lua index 75981eaf7..989c44f8e 100644 --- a/Scripts/Settings.lua +++ b/Scripts/Settings.lua @@ -19,7 +19,7 @@ local settings = Flow.Settings.new() settings.Flare.offset = Vec3(0, 0, 41) settings.Flare.range = 9 settings.Flare.timeout = 60 - settings.Flare.lensflareBrightness = 0.5 + settings.Flare.lensflareBrightness = 1.0 settings.Flare.sparks = true settings.Flare.smoke = true settings.Flare.flicker = true @@ -35,6 +35,7 @@ local settings = Flow.Settings.new() settings.System.errorMode = Flow.ErrorMode.WARN settings.System.fastReload = true + settings.System.multithreaded = true -- Hair[1] is normal player hair. Types [2] and [3] are for left and right young Lara hair. From 3e2a1ccf379f6ff16352d25687424ed2e13db4a4 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Fri, 28 Mar 2025 23:39:49 +0100 Subject: [PATCH 114/160] Update documentation --- Documentation/config.ld | 2 +- Documentation/doc/1 modules/Effects.html | 2 +- Documentation/doc/1 modules/Flow.html | 2 +- Documentation/doc/1 modules/Input.html | 2 +- Documentation/doc/1 modules/Inventory.html | 2 +- Documentation/doc/1 modules/Logic.html | 2 +- Documentation/doc/1 modules/Objects.html | 2 +- Documentation/doc/1 modules/Sound.html | 2 +- Documentation/doc/1 modules/Strings.html | 2 +- Documentation/doc/1 modules/Util.html | 2 +- Documentation/doc/1 modules/View.html | 2 +- Documentation/doc/2 classes/Collision.Probe.html | 2 +- Documentation/doc/2 classes/Flow.Level.html | 2 +- Documentation/doc/2 classes/Flow.Settings.html | 2 +- Documentation/doc/2 classes/Flow.Statistics.html | 2 +- Documentation/doc/2 classes/Objects.AIObject.html | 2 +- Documentation/doc/2 classes/Objects.Camera.html | 2 +- Documentation/doc/2 classes/Objects.LaraObject.html | 2 +- Documentation/doc/2 classes/Objects.Moveable.html | 2 +- Documentation/doc/2 classes/Objects.Room.html | 2 +- Documentation/doc/2 classes/Objects.Sink.html | 2 +- Documentation/doc/2 classes/Objects.SoundSource.html | 2 +- Documentation/doc/2 classes/Objects.Static.html | 2 +- Documentation/doc/2 classes/Objects.Volume.html | 2 +- Documentation/doc/2 classes/Strings.DisplayString.html | 2 +- Documentation/doc/2 classes/View.DisplaySprite.html | 2 +- Documentation/doc/3 primitive classes/Color.html | 2 +- Documentation/doc/3 primitive classes/Flow.Fog.html | 2 +- Documentation/doc/3 primitive classes/Flow.Horizon.html | 2 +- Documentation/doc/3 primitive classes/Flow.InventoryItem.html | 2 +- Documentation/doc/3 primitive classes/Flow.LensFlare.html | 2 +- Documentation/doc/3 primitive classes/Flow.SkyLayer.html | 2 +- Documentation/doc/3 primitive classes/Flow.Starfield.html | 2 +- Documentation/doc/3 primitive classes/Rotation.html | 2 +- Documentation/doc/3 primitive classes/Time.html | 2 +- Documentation/doc/3 primitive classes/Vec2.html | 2 +- Documentation/doc/3 primitive classes/Vec3.html | 2 +- Documentation/doc/4 enums/Collision.MaterialType.html | 2 +- Documentation/doc/4 enums/Effects.BlendID.html | 2 +- Documentation/doc/4 enums/Effects.EffectID.html | 2 +- Documentation/doc/4 enums/Effects.ParticleAnimationType.html | 2 +- Documentation/doc/4 enums/Effects.StreamerFeatherMode.html | 2 +- Documentation/doc/4 enums/Flow.ErrorMode.html | 2 +- Documentation/doc/4 enums/Flow.FreezeMode.html | 2 +- Documentation/doc/4 enums/Flow.GameStatus.html | 2 +- Documentation/doc/4 enums/Input.ActionID.html | 2 +- Documentation/doc/4 enums/Objects.AmmoType.html | 2 +- Documentation/doc/4 enums/Objects.HandStatus.html | 2 +- Documentation/doc/4 enums/Objects.MoveableStatus.html | 2 +- Documentation/doc/4 enums/Objects.ObjID.html | 2 +- Documentation/doc/4 enums/Objects.RoomFlagID.html | 2 +- Documentation/doc/4 enums/Objects.RoomReverb.html | 2 +- Documentation/doc/4 enums/Objects.WeaponType.html | 2 +- Documentation/doc/4 enums/Sound.SoundTrackType.html | 2 +- Documentation/doc/4 enums/Strings.DisplayStringOption.html | 2 +- Documentation/doc/4 enums/Util.LogLevel.html | 2 +- Documentation/doc/4 enums/View.AlignMode.html | 2 +- Documentation/doc/4 enums/View.CameraType.html | 2 +- Documentation/doc/4 enums/View.PostProcessMode.html | 2 +- Documentation/doc/4 enums/View.ScaleMode.html | 2 +- Documentation/doc/5 lua utility modules/CustomBar.html | 2 +- Documentation/doc/5 lua utility modules/Diary.html | 2 +- Documentation/doc/5 lua utility modules/EventSequence.html | 2 +- Documentation/doc/5 lua utility modules/Timer.html | 2 +- Documentation/doc/5 lua utility modules/Type.html | 2 +- Documentation/doc/index.html | 4 ++-- 66 files changed, 67 insertions(+), 67 deletions(-) diff --git a/Documentation/config.ld b/Documentation/config.ld index abc23eb0c..6a3876d25 100644 --- a/Documentation/config.ld +++ b/Documentation/config.ld @@ -12,7 +12,7 @@ new_type("luautil", "5 Lua utility modules", true) not_luadoc = true -local version = "1.8" +local version = "1.8.1" project = " TombEngine" title = "TombEngine " .. version .. " Lua API" description = "TombEngine " .. version .. " scripting interface" diff --git a/Documentation/doc/1 modules/Effects.html b/Documentation/doc/1 modules/Effects.html index 1ba87f3f0..d8d58667e 100644 --- a/Documentation/doc/1 modules/Effects.html +++ b/Documentation/doc/1 modules/Effects.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/1 modules/Flow.html b/Documentation/doc/1 modules/Flow.html index 9ca9202e8..a8ae0a9b0 100644 --- a/Documentation/doc/1 modules/Flow.html +++ b/Documentation/doc/1 modules/Flow.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/1 modules/Input.html b/Documentation/doc/1 modules/Input.html index 789bad1c6..c3439c75c 100644 --- a/Documentation/doc/1 modules/Input.html +++ b/Documentation/doc/1 modules/Input.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/1 modules/Inventory.html b/Documentation/doc/1 modules/Inventory.html index 14f4f6be5..45a377928 100644 --- a/Documentation/doc/1 modules/Inventory.html +++ b/Documentation/doc/1 modules/Inventory.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/1 modules/Logic.html b/Documentation/doc/1 modules/Logic.html index 83b919387..dff8277a1 100644 --- a/Documentation/doc/1 modules/Logic.html +++ b/Documentation/doc/1 modules/Logic.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/1 modules/Objects.html b/Documentation/doc/1 modules/Objects.html index 1e77c2f79..06d84e7c1 100644 --- a/Documentation/doc/1 modules/Objects.html +++ b/Documentation/doc/1 modules/Objects.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/1 modules/Sound.html b/Documentation/doc/1 modules/Sound.html index d7c87bb04..6f1305b02 100644 --- a/Documentation/doc/1 modules/Sound.html +++ b/Documentation/doc/1 modules/Sound.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/1 modules/Strings.html b/Documentation/doc/1 modules/Strings.html index d5aaeda4a..16b10bee4 100644 --- a/Documentation/doc/1 modules/Strings.html +++ b/Documentation/doc/1 modules/Strings.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/1 modules/Util.html b/Documentation/doc/1 modules/Util.html index cc0443c3d..a9b7c3972 100644 --- a/Documentation/doc/1 modules/Util.html +++ b/Documentation/doc/1 modules/Util.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/1 modules/View.html b/Documentation/doc/1 modules/View.html index 40f491a7b..557e35756 100644 --- a/Documentation/doc/1 modules/View.html +++ b/Documentation/doc/1 modules/View.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/2 classes/Collision.Probe.html b/Documentation/doc/2 classes/Collision.Probe.html index 4ff672202..19c7f4ec2 100644 --- a/Documentation/doc/2 classes/Collision.Probe.html +++ b/Documentation/doc/2 classes/Collision.Probe.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/2 classes/Flow.Level.html b/Documentation/doc/2 classes/Flow.Level.html index 0060d532e..c7c23ab6b 100644 --- a/Documentation/doc/2 classes/Flow.Level.html +++ b/Documentation/doc/2 classes/Flow.Level.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/2 classes/Flow.Settings.html b/Documentation/doc/2 classes/Flow.Settings.html index 326b6b4ce..6003f5cdc 100644 --- a/Documentation/doc/2 classes/Flow.Settings.html +++ b/Documentation/doc/2 classes/Flow.Settings.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/2 classes/Flow.Statistics.html b/Documentation/doc/2 classes/Flow.Statistics.html index 0c3663c4b..9cc173115 100644 --- a/Documentation/doc/2 classes/Flow.Statistics.html +++ b/Documentation/doc/2 classes/Flow.Statistics.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/2 classes/Objects.AIObject.html b/Documentation/doc/2 classes/Objects.AIObject.html index 951d0e4d3..0122971a9 100644 --- a/Documentation/doc/2 classes/Objects.AIObject.html +++ b/Documentation/doc/2 classes/Objects.AIObject.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/2 classes/Objects.Camera.html b/Documentation/doc/2 classes/Objects.Camera.html index 4899f78e0..630d1a44f 100644 --- a/Documentation/doc/2 classes/Objects.Camera.html +++ b/Documentation/doc/2 classes/Objects.Camera.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/2 classes/Objects.LaraObject.html b/Documentation/doc/2 classes/Objects.LaraObject.html index 2b43e2d46..41fefa5bc 100644 --- a/Documentation/doc/2 classes/Objects.LaraObject.html +++ b/Documentation/doc/2 classes/Objects.LaraObject.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/2 classes/Objects.Moveable.html b/Documentation/doc/2 classes/Objects.Moveable.html index e4152b181..cddc5ebb0 100644 --- a/Documentation/doc/2 classes/Objects.Moveable.html +++ b/Documentation/doc/2 classes/Objects.Moveable.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/2 classes/Objects.Room.html b/Documentation/doc/2 classes/Objects.Room.html index 04cd67ef3..acc0de38b 100644 --- a/Documentation/doc/2 classes/Objects.Room.html +++ b/Documentation/doc/2 classes/Objects.Room.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/2 classes/Objects.Sink.html b/Documentation/doc/2 classes/Objects.Sink.html index 322a09400..54ee6f9de 100644 --- a/Documentation/doc/2 classes/Objects.Sink.html +++ b/Documentation/doc/2 classes/Objects.Sink.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/2 classes/Objects.SoundSource.html b/Documentation/doc/2 classes/Objects.SoundSource.html index 19e05dff7..6daf287f2 100644 --- a/Documentation/doc/2 classes/Objects.SoundSource.html +++ b/Documentation/doc/2 classes/Objects.SoundSource.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/2 classes/Objects.Static.html b/Documentation/doc/2 classes/Objects.Static.html index cddabdcf2..faa84c20f 100644 --- a/Documentation/doc/2 classes/Objects.Static.html +++ b/Documentation/doc/2 classes/Objects.Static.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/2 classes/Objects.Volume.html b/Documentation/doc/2 classes/Objects.Volume.html index af6e4b1ed..77e6b626a 100644 --- a/Documentation/doc/2 classes/Objects.Volume.html +++ b/Documentation/doc/2 classes/Objects.Volume.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/2 classes/Strings.DisplayString.html b/Documentation/doc/2 classes/Strings.DisplayString.html index 005c134f0..d4b209327 100644 --- a/Documentation/doc/2 classes/Strings.DisplayString.html +++ b/Documentation/doc/2 classes/Strings.DisplayString.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/2 classes/View.DisplaySprite.html b/Documentation/doc/2 classes/View.DisplaySprite.html index 1dbe32283..f6f4917b7 100644 --- a/Documentation/doc/2 classes/View.DisplaySprite.html +++ b/Documentation/doc/2 classes/View.DisplaySprite.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/3 primitive classes/Color.html b/Documentation/doc/3 primitive classes/Color.html index 9ccc6e9d6..e10a2c8ec 100644 --- a/Documentation/doc/3 primitive classes/Color.html +++ b/Documentation/doc/3 primitive classes/Color.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/3 primitive classes/Flow.Fog.html b/Documentation/doc/3 primitive classes/Flow.Fog.html index 49d245efb..dbf35a6b5 100644 --- a/Documentation/doc/3 primitive classes/Flow.Fog.html +++ b/Documentation/doc/3 primitive classes/Flow.Fog.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/3 primitive classes/Flow.Horizon.html b/Documentation/doc/3 primitive classes/Flow.Horizon.html index c8097d43b..891539543 100644 --- a/Documentation/doc/3 primitive classes/Flow.Horizon.html +++ b/Documentation/doc/3 primitive classes/Flow.Horizon.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/3 primitive classes/Flow.InventoryItem.html b/Documentation/doc/3 primitive classes/Flow.InventoryItem.html index 4daff8cd5..ac66af1ac 100644 --- a/Documentation/doc/3 primitive classes/Flow.InventoryItem.html +++ b/Documentation/doc/3 primitive classes/Flow.InventoryItem.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/3 primitive classes/Flow.LensFlare.html b/Documentation/doc/3 primitive classes/Flow.LensFlare.html index 5f7538fba..493f9432b 100644 --- a/Documentation/doc/3 primitive classes/Flow.LensFlare.html +++ b/Documentation/doc/3 primitive classes/Flow.LensFlare.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/3 primitive classes/Flow.SkyLayer.html b/Documentation/doc/3 primitive classes/Flow.SkyLayer.html index 1289afc53..dc92bbb1d 100644 --- a/Documentation/doc/3 primitive classes/Flow.SkyLayer.html +++ b/Documentation/doc/3 primitive classes/Flow.SkyLayer.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/3 primitive classes/Flow.Starfield.html b/Documentation/doc/3 primitive classes/Flow.Starfield.html index f4aa48998..9182b0b89 100644 --- a/Documentation/doc/3 primitive classes/Flow.Starfield.html +++ b/Documentation/doc/3 primitive classes/Flow.Starfield.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/3 primitive classes/Rotation.html b/Documentation/doc/3 primitive classes/Rotation.html index 728815250..08d1dedf6 100644 --- a/Documentation/doc/3 primitive classes/Rotation.html +++ b/Documentation/doc/3 primitive classes/Rotation.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/3 primitive classes/Time.html b/Documentation/doc/3 primitive classes/Time.html index c1b159661..1edf989a5 100644 --- a/Documentation/doc/3 primitive classes/Time.html +++ b/Documentation/doc/3 primitive classes/Time.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/3 primitive classes/Vec2.html b/Documentation/doc/3 primitive classes/Vec2.html index 825d7fa48..eb65b2271 100644 --- a/Documentation/doc/3 primitive classes/Vec2.html +++ b/Documentation/doc/3 primitive classes/Vec2.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/3 primitive classes/Vec3.html b/Documentation/doc/3 primitive classes/Vec3.html index 696df8778..5ff74ce81 100644 --- a/Documentation/doc/3 primitive classes/Vec3.html +++ b/Documentation/doc/3 primitive classes/Vec3.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Collision.MaterialType.html b/Documentation/doc/4 enums/Collision.MaterialType.html index 69c90fa69..564b8ca1f 100644 --- a/Documentation/doc/4 enums/Collision.MaterialType.html +++ b/Documentation/doc/4 enums/Collision.MaterialType.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Effects.BlendID.html b/Documentation/doc/4 enums/Effects.BlendID.html index 738be8a6b..bd2f1aca9 100644 --- a/Documentation/doc/4 enums/Effects.BlendID.html +++ b/Documentation/doc/4 enums/Effects.BlendID.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Effects.EffectID.html b/Documentation/doc/4 enums/Effects.EffectID.html index 9b33780a8..32b783f43 100644 --- a/Documentation/doc/4 enums/Effects.EffectID.html +++ b/Documentation/doc/4 enums/Effects.EffectID.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html index 82bc18a38..f1351b9af 100644 --- a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html +++ b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Effects.StreamerFeatherMode.html b/Documentation/doc/4 enums/Effects.StreamerFeatherMode.html index 7415e2354..47692e9c5 100644 --- a/Documentation/doc/4 enums/Effects.StreamerFeatherMode.html +++ b/Documentation/doc/4 enums/Effects.StreamerFeatherMode.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Flow.ErrorMode.html b/Documentation/doc/4 enums/Flow.ErrorMode.html index 5bab3199b..4bf7d6fab 100644 --- a/Documentation/doc/4 enums/Flow.ErrorMode.html +++ b/Documentation/doc/4 enums/Flow.ErrorMode.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Flow.FreezeMode.html b/Documentation/doc/4 enums/Flow.FreezeMode.html index d3144922d..d01a30a1a 100644 --- a/Documentation/doc/4 enums/Flow.FreezeMode.html +++ b/Documentation/doc/4 enums/Flow.FreezeMode.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Flow.GameStatus.html b/Documentation/doc/4 enums/Flow.GameStatus.html index b3ec60f29..0e9262274 100644 --- a/Documentation/doc/4 enums/Flow.GameStatus.html +++ b/Documentation/doc/4 enums/Flow.GameStatus.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Input.ActionID.html b/Documentation/doc/4 enums/Input.ActionID.html index 0d3e1c9ba..b0c16ee50 100644 --- a/Documentation/doc/4 enums/Input.ActionID.html +++ b/Documentation/doc/4 enums/Input.ActionID.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Objects.AmmoType.html b/Documentation/doc/4 enums/Objects.AmmoType.html index 812f506e8..cf02b25c1 100644 --- a/Documentation/doc/4 enums/Objects.AmmoType.html +++ b/Documentation/doc/4 enums/Objects.AmmoType.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Objects.HandStatus.html b/Documentation/doc/4 enums/Objects.HandStatus.html index 06cc70974..5e6f31be9 100644 --- a/Documentation/doc/4 enums/Objects.HandStatus.html +++ b/Documentation/doc/4 enums/Objects.HandStatus.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Objects.MoveableStatus.html b/Documentation/doc/4 enums/Objects.MoveableStatus.html index 9ce6251e0..21ceb56ef 100644 --- a/Documentation/doc/4 enums/Objects.MoveableStatus.html +++ b/Documentation/doc/4 enums/Objects.MoveableStatus.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Objects.ObjID.html b/Documentation/doc/4 enums/Objects.ObjID.html index b10a91473..87fb56147 100644 --- a/Documentation/doc/4 enums/Objects.ObjID.html +++ b/Documentation/doc/4 enums/Objects.ObjID.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Objects.RoomFlagID.html b/Documentation/doc/4 enums/Objects.RoomFlagID.html index 517ed6b71..3edc7b5ce 100644 --- a/Documentation/doc/4 enums/Objects.RoomFlagID.html +++ b/Documentation/doc/4 enums/Objects.RoomFlagID.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Objects.RoomReverb.html b/Documentation/doc/4 enums/Objects.RoomReverb.html index e8282b8dc..420e1731c 100644 --- a/Documentation/doc/4 enums/Objects.RoomReverb.html +++ b/Documentation/doc/4 enums/Objects.RoomReverb.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Objects.WeaponType.html b/Documentation/doc/4 enums/Objects.WeaponType.html index 219c79085..c45efc459 100644 --- a/Documentation/doc/4 enums/Objects.WeaponType.html +++ b/Documentation/doc/4 enums/Objects.WeaponType.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Sound.SoundTrackType.html b/Documentation/doc/4 enums/Sound.SoundTrackType.html index 359b78984..ad9eb5e39 100644 --- a/Documentation/doc/4 enums/Sound.SoundTrackType.html +++ b/Documentation/doc/4 enums/Sound.SoundTrackType.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Strings.DisplayStringOption.html b/Documentation/doc/4 enums/Strings.DisplayStringOption.html index d561e2684..e43f3200b 100644 --- a/Documentation/doc/4 enums/Strings.DisplayStringOption.html +++ b/Documentation/doc/4 enums/Strings.DisplayStringOption.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/Util.LogLevel.html b/Documentation/doc/4 enums/Util.LogLevel.html index d00c53ea6..3e463cf45 100644 --- a/Documentation/doc/4 enums/Util.LogLevel.html +++ b/Documentation/doc/4 enums/Util.LogLevel.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/View.AlignMode.html b/Documentation/doc/4 enums/View.AlignMode.html index 1f95d4bf0..479a64e04 100644 --- a/Documentation/doc/4 enums/View.AlignMode.html +++ b/Documentation/doc/4 enums/View.AlignMode.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/View.CameraType.html b/Documentation/doc/4 enums/View.CameraType.html index 255946261..8059b3c65 100644 --- a/Documentation/doc/4 enums/View.CameraType.html +++ b/Documentation/doc/4 enums/View.CameraType.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/View.PostProcessMode.html b/Documentation/doc/4 enums/View.PostProcessMode.html index 825aa6742..03b0419d6 100644 --- a/Documentation/doc/4 enums/View.PostProcessMode.html +++ b/Documentation/doc/4 enums/View.PostProcessMode.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/4 enums/View.ScaleMode.html b/Documentation/doc/4 enums/View.ScaleMode.html index 868e2f41e..d00970ef0 100644 --- a/Documentation/doc/4 enums/View.ScaleMode.html +++ b/Documentation/doc/4 enums/View.ScaleMode.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/5 lua utility modules/CustomBar.html b/Documentation/doc/5 lua utility modules/CustomBar.html index 940e0b6bd..2940474c8 100644 --- a/Documentation/doc/5 lua utility modules/CustomBar.html +++ b/Documentation/doc/5 lua utility modules/CustomBar.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/5 lua utility modules/Diary.html b/Documentation/doc/5 lua utility modules/Diary.html index 27e48878c..58d81a722 100644 --- a/Documentation/doc/5 lua utility modules/Diary.html +++ b/Documentation/doc/5 lua utility modules/Diary.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/5 lua utility modules/EventSequence.html b/Documentation/doc/5 lua utility modules/EventSequence.html index 9f68608b1..cea188d4f 100644 --- a/Documentation/doc/5 lua utility modules/EventSequence.html +++ b/Documentation/doc/5 lua utility modules/EventSequence.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/5 lua utility modules/Timer.html b/Documentation/doc/5 lua utility modules/Timer.html index fead185e8..5cff92477 100644 --- a/Documentation/doc/5 lua utility modules/Timer.html +++ b/Documentation/doc/5 lua utility modules/Timer.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/5 lua utility modules/Type.html b/Documentation/doc/5 lua utility modules/Type.html index 290e73067..dad15e9ec 100644 --- a/Documentation/doc/5 lua utility modules/Type.html +++ b/Documentation/doc/5 lua utility modules/Type.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API diff --git a/Documentation/doc/index.html b/Documentation/doc/index.html index e934b8f98..780a8b9e5 100644 --- a/Documentation/doc/index.html +++ b/Documentation/doc/index.html @@ -3,7 +3,7 @@ - TombEngine 1.8 Lua API + TombEngine 1.8.1 Lua API @@ -115,7 +115,7 @@
    -

    TombEngine 1.8 scripting interface

    +

    TombEngine 1.8.1 scripting interface

    Welcome to the TombEngine scripting API.

    Note that this is primarily a reference document, not a tutorial, so expect descriptions to be fairly sparse. From 410250bf2d900810e520c8091ccbe0a1ee92e933 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 29 Mar 2025 09:55:09 +0100 Subject: [PATCH 115/160] Update CHANGELOG.md --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3d47c249b..6c8243091 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -17,6 +17,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed crash with incorrectly applied animated textures on static meshes. * Fixed console window not hiding in non-debug mode on Windows 11. * Fixed key binding settings saving for the current play session after hitting Esc to cancel. +* Fixed lensflare blending formula to avoid screen overbright. ### Lua API changes * Added missing constructor for `Collision.Probe` without room number. From 5c83574a0e1d253cab1bee8a071e0ef07c6f2164 Mon Sep 17 00:00:00 2001 From: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Sat, 29 Mar 2025 14:16:09 +0000 Subject: [PATCH 116/160] Updated changelog for release version Bug Fixes moved to top (as per other version entries) --- CHANGELOG.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 6c8243091..a1be08042 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,11 +3,7 @@ The dates are in European standard format where date is presented as **YYYY-MM-DD**. TombEngine releases are located in this repository (alongside with Tomb Editor): https://github.com/TombEngine/TombEditorReleases -## [Version 1.8.1](link to release) - yyyy-mm-dd - -### New features -* Added Firefly Emitter object (ID 1099) with corresponding sprite slot (ID 1379). -* Added live console input to perform Lua commands in realtime. +## [Version 1.8.1](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.8.1) - 2025-03-29 ### Bug fixes * Fixed pathfinding for friendly NPCs such as monkeys. @@ -19,6 +15,10 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed key binding settings saving for the current play session after hitting Esc to cancel. * Fixed lensflare blending formula to avoid screen overbright. +### New features +* Added Firefly Emitter object (ID 1099) with corresponding sprite slot (ID 1379). +* Added live console input to perform Lua commands in realtime. + ### Lua API changes * Added missing constructor for `Collision.Probe` without room number. * Added optional looping argument for `View.GetFlybyPosition` and `View.GetFlybyRotation` functions. From ed596ba07be092529ba5077d120e71fa5ddb7f32 Mon Sep 17 00:00:00 2001 From: Sezz Date: Sun, 30 Mar 2025 14:26:36 +1100 Subject: [PATCH 117/160] Update spotcam.cpp --- TombEngine/Game/spotcam.cpp | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/TombEngine/Game/spotcam.cpp b/TombEngine/Game/spotcam.cpp index 2b6ea8d10..3225d38d9 100644 --- a/TombEngine/Game/spotcam.cpp +++ b/TombEngine/Game/spotcam.cpp @@ -841,6 +841,10 @@ int Spline(int x, int* knots, int nk) Pose GetCameraTransform(int sequence, float alpha, bool loop) { + constexpr auto BLEND_RANGE = 0.1f; + constexpr auto BLEND_START = BLEND_RANGE; + constexpr auto BLEND_END = 1.0f - BLEND_RANGE; + alpha = std::clamp(alpha, 0.0f, 1.0f); // Retrieve camera count in sequence. @@ -887,18 +891,14 @@ Pose GetCameraTransform(int sequence, float alpha, bool loop) return Spline(tAlpha, rolls.data(), splinePoints); }; - Vector3 origin = {}; - Vector3 target = {}; + auto origin = Vector3::Zero; + auto target = Vector3::Zero; short orientZ = 0; - constexpr float BLEND_RANGE = 0.1f; - constexpr float BLEND_START = BLEND_RANGE; - constexpr float BLEND_END = 1.0f - BLEND_RANGE; - - // If loop is enabled and we are at the start or end of the sequence, blend between the last and first cameras. + // If loop is enabled and alpha is at sequence start or end, blend between last and first cameras. if (loop && (alpha < BLEND_START || alpha >= BLEND_END)) { - float blendFactor = (alpha < BLEND_START) ? 0.5f + (alpha / BLEND_RANGE) * 0.5f : (alpha - BLEND_END) / BLEND_START * 0.5f; + float blendFactor = (alpha < BLEND_START) ? (0.5f + ((alpha / BLEND_RANGE) * 0.5f)) : (((alpha - BLEND_END) / BLEND_START) * 0.5f); origin = Vector3::Lerp(getInterpolatedPoint(BLEND_END, xOrigins, yOrigins, zOrigins), getInterpolatedPoint(BLEND_START, xOrigins, yOrigins, zOrigins), blendFactor); target = Vector3::Lerp(getInterpolatedPoint(BLEND_END, xTargets, yTargets, zTargets), getInterpolatedPoint(BLEND_START, xTargets, yTargets, zTargets), blendFactor); From 8bc15b32006b868571dc5610bfbecb6be77d996b Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 30 Mar 2025 11:29:17 +0200 Subject: [PATCH 118/160] Update spotcam.cpp --- TombEngine/Game/spotcam.cpp | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/TombEngine/Game/spotcam.cpp b/TombEngine/Game/spotcam.cpp index 3225d38d9..e58df71d2 100644 --- a/TombEngine/Game/spotcam.cpp +++ b/TombEngine/Game/spotcam.cpp @@ -847,10 +847,19 @@ Pose GetCameraTransform(int sequence, float alpha, bool loop) alpha = std::clamp(alpha, 0.0f, 1.0f); + if (sequence < 0 || sequence >= MAX_SPOTCAMS) + { + TENLog("Wrong flyby sequence number provided for getting camera coordinates.", LogLevel::Warning); + return Pose::Zero; + } + // Retrieve camera count in sequence. int cameraCount = CameraCnt[SpotCamRemap[sequence]]; if (cameraCount < 2) - return Pose::Zero; // Not enough cameras to interpolate. + { + TENLog("Not enough cameras in flyby sequence to calculate the coordinates.", LogLevel::Warning); + return Pose::Zero; + } // Find first ID for sequence. int firstSeqID = 0; From 7c8b67d2bb10db9c42b418a5da2dde0f00d8e83d Mon Sep 17 00:00:00 2001 From: Jakub <80340234+Jakub768@users.noreply.github.com> Date: Sun, 30 Mar 2025 23:56:01 +0100 Subject: [PATCH 119/160] Update AUTHORS.md --- AUTHORS.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/AUTHORS.md b/AUTHORS.md index 096d4944c..7bff5eeb4 100644 --- a/AUTHORS.md +++ b/AUTHORS.md @@ -49,5 +49,4 @@ This is the credit list of **all** the people who contributed to TombEngine in a - JoeyQuint (Standing 180° turn, monkey swing 180° turn) ### TombEngine Marketing -- Kubsy (Twitter and forum posts) -- Stranger1992 (This website, Facebook, Instagram, Youtube and Twitch. +- Stranger1992 (This website, Facebook, Instagram, Youtube, Twitter, and Twitch. From 6e5d23db6a06ea2b67abefed527a54b0c862e85c Mon Sep 17 00:00:00 2001 From: Jakub <80340234+Jakub768@users.noreply.github.com> Date: Sun, 30 Mar 2025 23:55:16 +0100 Subject: [PATCH 120/160] Update AUTHORS.md Update AUTHORS.md Add TrainWreck to AUTHORS.md Update AUTHORS.md --- AUTHORS.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/AUTHORS.md b/AUTHORS.md index 096d4944c..87c738cfa 100644 --- a/AUTHORS.md +++ b/AUTHORS.md @@ -6,7 +6,7 @@ This is the credit list of **all** the people who contributed to TombEngine in a - MontyTRC (Project Leader) -- Gancian (general coding) +- Gancian (general coding - Krystian (general coding) - Kubsy (Some cleanups and fixes) - l.m. (general coding, Lua enhancements, bug fixing) @@ -17,6 +17,7 @@ This is the credit list of **all** the people who contributed to TombEngine in a - Sezz (player state refactoring, general coding, code cleanups, bug fixing, assets) - Squidshire (Hispidence) (Lua implementation, bug fixing) - Stranger1992 (sound asset refactoring and organisation, assets) +- TrainWreck (asset coding and Lua enhancements - TokyoSU (entity and vehicle decompilation) - Tomo (general coding, special FX coding, bug fixing) - Troye (general coding, refactoring) @@ -49,5 +50,5 @@ This is the credit list of **all** the people who contributed to TombEngine in a - JoeyQuint (Standing 180° turn, monkey swing 180° turn) ### TombEngine Marketing -- Kubsy (Twitter and forum posts) -- Stranger1992 (This website, Facebook, Instagram, Youtube and Twitch. +- Stranger1992 (Tomb Engine website, Discord, Facebook, Instagram, Youtube, X, and Twitch) +- Kubsy (X and Reddit) From 8fbf10b362f94ba8998330f593047e8a514cfb78 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Mon, 31 Mar 2025 08:59:27 +0300 Subject: [PATCH 121/160] Update README.md --- README.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 557b222d6..c5e824255 100644 --- a/README.md +++ b/README.md @@ -8,9 +8,7 @@ - Support for high framerate, antialiasing, mipmapping, and SSAO. - Full diagonal geometry support. - Uncapped map size. -- A streamlined player control scheme.. - -Contributions are welcome. If you would like to participate in development to any degree, whether that be through suggestions, bug reports, or code, join our [Discord server](https://discord.gg/h5tUYFmres). +- A streamlined player control scheme. *Tomb Engine* is used in conjunction with *Tomb Editor*. The repository can be found [here](https://github.com/MontyTRC89/Tomb-Editor). @@ -36,6 +34,9 @@ Steps: Once done, you should be able to build a level with *Tomb Editor* and run it in *TEN*. +# Contributions +Contributions are welcome. If you would like to participate in development to any degree, whether that be through suggestions, bug reports, or code, join our [Discord server](https://discord.gg/h5tUYFmres). + # Disclaimer This community project is unaffiliated with Core Design, Eidos Interactive, or Embracer Group AB. *Tomb Raider* is a registered trademark of Embracer Group AB. *Tomb Engine* is not for sale. The code is open-source to encourage contributions and for study purposes. We are not responsible for illegal uses of this source code. This source code is released as-is and continues to be maintained by non-paid contributors in their free time. From 84a74a80579c49c0e5e6d17839c53a57f6bb3085 Mon Sep 17 00:00:00 2001 From: Jakub <80340234+Jakub768@users.noreply.github.com> Date: Mon, 31 Mar 2025 12:33:57 +0100 Subject: [PATCH 122/160] Update AUTHORS.md --- AUTHORS.md | 1 - 1 file changed, 1 deletion(-) diff --git a/AUTHORS.md b/AUTHORS.md index 87c738cfa..d74b91990 100644 --- a/AUTHORS.md +++ b/AUTHORS.md @@ -51,4 +51,3 @@ This is the credit list of **all** the people who contributed to TombEngine in a ### TombEngine Marketing - Stranger1992 (Tomb Engine website, Discord, Facebook, Instagram, Youtube, X, and Twitch) -- Kubsy (X and Reddit) From 5a71239d7b9a9247b95e81bb1b399a5623a46a99 Mon Sep 17 00:00:00 2001 From: MontyTRC89 Date: Tue, 1 Apr 2025 10:01:57 +0200 Subject: [PATCH 123/160] SSAO fixes for alpha blended surfaces and possibly performance improvements; --- TombEngine/Renderer/RendererDraw.cpp | 8 ++++++-- TombEngine/Shaders/CBCamera.hlsli | 4 ++-- TombEngine/Shaders/SSAO.fx | 14 ++++++++------ 3 files changed, 16 insertions(+), 10 deletions(-) diff --git a/TombEngine/Renderer/RendererDraw.cpp b/TombEngine/Renderer/RendererDraw.cpp index 1c63b24d8..391f07fc6 100644 --- a/TombEngine/Renderer/RendererDraw.cpp +++ b/TombEngine/Renderer/RendererDraw.cpp @@ -3229,13 +3229,17 @@ namespace TEN::Renderer case RendererPass::GBuffer: if (blendMode != BlendMode::Opaque && blendMode != BlendMode::AlphaTest && - blendMode != BlendMode::FastAlphaBlend) + blendMode != BlendMode::FastAlphaBlend && + // WARNING: For G-Buffer step we consider alpha blend like alpha test + // assuming that most of the geometry used in rooms, items and statics + // are fences, foliages, trees... But it could fail with translucent surfaces! + blendMode != BlendMode::AlphaBlend) { return false; } if (blendMode == BlendMode::Opaque) - { + { SetBlendMode(BlendMode::Opaque); SetAlphaTest(AlphaTestMode::None, 1.0f); } diff --git a/TombEngine/Shaders/CBCamera.hlsli b/TombEngine/Shaders/CBCamera.hlsli index 34a7709c0..457b89526 100644 --- a/TombEngine/Shaders/CBCamera.hlsli +++ b/TombEngine/Shaders/CBCamera.hlsli @@ -7,8 +7,8 @@ cbuffer CBCamera : register(b0) { float4x4 ViewProjection; float4x4 View; - float4x4 Projection; - float4x4 InverseProjection; + float4x4 Projection; + float4x4 InverseProjection; float4x4 DualParaboloidView; float4 CamPositionWS; float4 CamDirectionWS; diff --git a/TombEngine/Shaders/SSAO.fx b/TombEngine/Shaders/SSAO.fx index b5a9c5dba..844419b7e 100644 --- a/TombEngine/Shaders/SSAO.fx +++ b/TombEngine/Shaders/SSAO.fx @@ -50,11 +50,12 @@ float PS(PixelShaderInput input) : SV_Target float3 position = ReconstructPositionFromDepth(input.UV); float3 encodedNormal = NormalsTexture.Sample(NormalsSampler, input.UV).xyz; - // Let's avoid SSAO on the skybox and on surfaces with no normals - if (length(encodedNormal) <= 0.0001f) - { - return float4(1.0f, 1.0f, 1.0f, 1.0f); - } + float farMask = step(40960.0f, length(position)); // 1 if too far + float noNormalMask = step(length(encodedNormal), 0.0001f); // 1 if normal is too small + float earlyExit = saturate(farMask + noNormalMask); // 0 if both are fine + + if (earlyExit > 0.0f) + return float4(1.0f, 1.0f, 1.0f, 1.0f); float3 normal = DecodeNormal(encodedNormal); float3 randomVec = NoiseTexture.Sample(NoiseSampler, input.UV * noiseScale).xyz; @@ -82,7 +83,8 @@ float PS(PixelShaderInput input) : SV_Target float sampleDepth = ReconstructPositionFromDepth(offset.xy).z; float rangeCheck = smoothstep(0.0, 1.0, radius / abs(position.z - sampleDepth)); - occlusion += (sampleDepth >= samplePos.z + bias ? 1.0 : 0.0) * rangeCheck; + occlusion += lerp(0.0f, rangeCheck, step(0.0, sampleDepth - samplePos.z - bias)); + //occlusion += (sampleDepth >= samplePos.z + bias ? 1.0 : 0.0) * rangeCheck; } occlusion = 1.0 - (occlusion / kernelSize); From 2fb0a609a3e2aa46d4540df4598550099ceef6d5 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Wed, 2 Apr 2025 05:01:51 +0200 Subject: [PATCH 124/160] Remove duplicate log entry --- TombEngine/Renderer/RendererCompatibility.cpp | 3 --- 1 file changed, 3 deletions(-) diff --git a/TombEngine/Renderer/RendererCompatibility.cpp b/TombEngine/Renderer/RendererCompatibility.cpp index 7ae2ef7d5..ef561320b 100644 --- a/TombEngine/Renderer/RendererCompatibility.cpp +++ b/TombEngine/Renderer/RendererCompatibility.cpp @@ -68,9 +68,6 @@ namespace TEN::Renderer _animatedTextures[i] = tex; } - if (_animatedTextures.size() > 0) - TENLog("Generated " + std::to_string(_animatedTextures.size()) + " animated textures.", LogLevel::Info); - std::transform(g_Level.AnimatedTexturesSequences.begin(), g_Level.AnimatedTexturesSequences.end(), std::back_inserter(_animatedTextureSets), [](ANIMATED_TEXTURES_SEQUENCE& sequence) { RendererAnimatedTextureSet set{}; set.NumTextures = sequence.numFrames; From 4e523957a5940339b034af520384089eb695eb88 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Wed, 2 Apr 2025 05:42:18 +0200 Subject: [PATCH 125/160] Fixed #1603 and gunshell/flash renderer crashes --- CHANGELOG.md | 6 + .../Objects/TR5/Object/tr5_teleporter.cpp | 170 +----------------- .../Objects/TR5/Object/tr5_teleporter.h | 1 - TombEngine/Objects/TR5/tr5_objects.cpp | 1 - TombEngine/Renderer/RendererDraw.cpp | 3 + TombEngine/Renderer/RendererDrawEffect.cpp | 45 ++--- 6 files changed, 42 insertions(+), 184 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index a1be08042..a74dc0ee6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,6 +3,12 @@ The dates are in European standard format where date is presented as **YYYY-MM-DD**. TombEngine releases are located in this repository (alongside with Tomb Editor): https://github.com/TombEngine/TombEditorReleases +## [Version 1.8.2] + +### Bug fixes +* Fixed crashes when shooting, if gunflash or gunshell objects are not present in a level. +* Fixed Teleporter object. + ## [Version 1.8.1](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.8.1) - 2025-03-29 ### Bug fixes diff --git a/TombEngine/Objects/TR5/Object/tr5_teleporter.cpp b/TombEngine/Objects/TR5/Object/tr5_teleporter.cpp index 6ebb9961a..a3166f832 100644 --- a/TombEngine/Objects/TR5/Object/tr5_teleporter.cpp +++ b/TombEngine/Objects/TR5/Object/tr5_teleporter.cpp @@ -7,22 +7,11 @@ #include "Game/effects/weather.h" #include "Game/Lara/lara.h" #include "Game/camera.h" +#include "Game/collision/Point.h" +using namespace TEN::Collision::Point; using namespace TEN::Effects::Environment; -void InitializeTeleporter(short itemNumber) -{ - /*ItemInfo* item = &g_Level.Items[itemNumber]; - - if (item->triggerFlags == 512) - { - ItemInfo* puzzleHoleItem = FindItem(ID_PUZZLE_HOLE2); - v4 = (signed int)((unsigned __int64)(391146079i64 * ((char*)v3 - (char*)items)) >> 32) >> 9; - result = (unsigned int)((unsigned __int64)(391146079i64 * ((char*)v3 - (char*)items)) >> 32) >> 31; - item->itemFlags[1] = result + v4; - }*/ -} - void ControlTeleporter(short itemNumber) { ItemInfo* item = &g_Level.Items[itemNumber]; @@ -30,149 +19,6 @@ void ControlTeleporter(short itemNumber) if (!TriggerActive(item)) return; - /*if (item->triggerFlags == 512) - { - if (item->itemFlags[2]) - { - Lara.Puzzles[1] = 1; - RemoveActiveItem(itemNumber); - item->flags &= 0xC1FF; - } - else - { - item->itemFlags[0] += 2; - - if (item->itemFlags[0] <= 255) - { - int flags = item->itemFlags[0] >> 3; - if (flags >= 4) - { - if (flags > 31) - flags = 31; - } - else - { - flags = 4; - } - - ItemInfo* targetItem = &g_Level.Items[item->itemFlags[1]]; - SoundEffect(SFX_TR5_TELEPORT, &targetItem->pos, SoundEnvironment::Land); - - if (GlobalCounter & 1) - { - Vector3i src; - pos.x = targetItem->pos.Position.x; - pos.y = targetItem->pos.Position.y - 496; - pos.z = targetItem->pos.Position.z + 472; - - int dl = 4 * item->itemFlags[0] + 256; - - Vector3i dest; - dest.x = src.x + GetRandomControl() % dl - (dl >> 1); - dest.y = src.y + GetRandomControl() % dl - (dl >> 1); - dest.z = src.z + GetRandomControl() % dl - (dl >> 1); - - int color = (item->itemFlags[0] >> 2) | (((item->itemFlags[0] - (GetRandomControl() % (item->itemFlags[0] >> 1))) | (item->itemFlags[0] << 8)) << 8); - color |= 0x18; // BYTE1 - - //TriggerEnergyArc(&src, &dest, (GetRandomControl() & 0x1F) + 16, color, 15, 40, 5); - - v20 = v16; - v21 = v12 & 0xFFFFFFFE; - LOBYTE(v20) = v16 & 0xFE; - BYTE1(v21) |= 0x80u; - TriggerLightningGlow(src.x, src.y, src.z, (item->itemFlags[0] >> 3) | ((v20 | (v21 << 8)) << 7)); - v22 = GetRandomControl(); - SpawnDynamicLight(src.x, src.y, src.z, (v22 & 3) + (item->itemFlags[0] >> 5) + 8, v12, v16, v13); - } - LOBYTE(v3) = GetRandomControl(); - if (v3 & 1) - { - v23 = item->itemFlags[0]; - v24 = item->itemFlags[0]; - v25 = GetRandomControl(); - - auto R = v23; - auto G = v24 - v25 % (v24 >> 1); - auto B = v24 >> 2; - Weather.Flash(R, G, B, 0.03f); - - LOBYTE(v3) = SoundEffect(SFX_TR5_TELEPORT_CRACKLES, nullptr); - } - if (!(GlobalCounter & 3)) - { - v26 = GetRandomControl(); - v27 = 0; - v28 = v26 & 3; - v29 = 0; - if (v28) - { - if (v28 == 1) - v29 = 512; - else - v27 = v28 != 2 ? 512 : -512; - } - else - { - v29 = -512; - } - v30 = item->itemFlags[0]; - v31 = &g_Level.Items[item->itemFlags[1]]; - src.Position.x = v29 + v31->pos.Position.x; - src.Position.y = v31->pos.Position.y - 2328; - src.zPos = v27 + v31->pos.Position.z; - *(_DWORD*)& src.xRot = v31->pos.Position.x; - v32 = item->itemFlags[0]; - *(_DWORD*)& src.zRot = v31->pos.Position.y - 496; - v45 = v31->pos.Position.z + 472; - v33 = (v30 >> 2) | (((v30 - GetRandomControl() % (v30 >> 1)) | ((v32 | 0x2400) << 8)) << 8); - v34 = GetRandomControl(); - TriggerEnergyArc((Vector3i*)& src, (Vector3i*)& src.xRot, (v34 & 0xF) + 16, v33, 13, 56, 5); - v35* = GetFreeParticle(); - v35->On = 1; - v36 = item->itemFlags[0]; - v35->dR = v36; - v35->sR = v36; - v37 = item->itemFlags[0] >> 1; - v35->dG = v37; - v35->sG = v37; - v38 = item->itemFlags[0]; - v35->ColFadeSpeed = 20; - v38 >>= 2; - v35->dB = v38; - v35->sB = v38; - v35->FadeToBlack = 4; - v35->Life = 24; - v35->sLife = 24; - v35->blendMode = BlendMode::Additive; - v35->x = src.Position.x; - v35->y = src.Position.y; - v35->z = src.zPos; - v35->Zvel = 0; - v35->Yvel = 0; - v35->Xvel = 0; - v35->Flags = 10; - v39 = objects[458].mesh_index; - v35->Scalar = 3; - v35->MaxYvel = 0; - v35->Def = v39 + 11; - v35->Gravity = 0; - v3 = (GetRandomControl() & 3) + 24; - v35->dSize = v3; - v35->sSize = v3; - v35->Size = v3; - } - return v3; - } - FlashFadeR = 255; - FlashFadeG = 255; - FlashFadeB = 64; - FlashFader = 32; - item->itemFlags[2] = 1; - SoundEffect(SFX_TR5_TELEPORT_FLASH, nullptr, SoundEnvironment::Land); - } - }*/ - Lara.Control.IsLocked = false; if (item->TriggerFlags == 666) @@ -196,12 +42,14 @@ void ControlTeleporter(short itemNumber) LaraItem->Pose.Position.z = item->Pose.Position.z; LaraItem->Pose.Orientation.y = item->Pose.Orientation.y - ANGLE(180.0f); - short roomNumber = item->RoomNumber; - FloorInfo* floor = GetFloor(item->Pose.Position.x, item->Pose.Position.y, item->Pose.Position.z, &roomNumber); - LaraItem->Pose.Position.y = GetFloorHeight(floor, item->Pose.Position.x, item->Pose.Position.y, item->Pose.Position.z); + auto& pointColl = GetPointCollision(*item); + LaraItem->Pose.Position.y = pointColl.GetPosition().y; - if (LaraItem->RoomNumber != roomNumber) - ItemNewRoom(LaraItem->Index, roomNumber); + if (LaraItem->RoomNumber != pointColl.GetRoomNumber()) + { + ItemNewRoom(LaraItem->Index, pointColl.GetRoomNumber()); + LaraItem->Location.RoomNumber = pointColl.GetRoomNumber(); + } if (item->Flags & IFLAG_INVISIBLE) { diff --git a/TombEngine/Objects/TR5/Object/tr5_teleporter.h b/TombEngine/Objects/TR5/Object/tr5_teleporter.h index 547ddcaba..dde7fc827 100644 --- a/TombEngine/Objects/TR5/Object/tr5_teleporter.h +++ b/TombEngine/Objects/TR5/Object/tr5_teleporter.h @@ -1,4 +1,3 @@ #pragma once -void InitializeTeleporter(short itemNumber); void ControlTeleporter(short itemNumber); diff --git a/TombEngine/Objects/TR5/tr5_objects.cpp b/TombEngine/Objects/TR5/tr5_objects.cpp index 130d7405f..76c70133f 100644 --- a/TombEngine/Objects/TR5/tr5_objects.cpp +++ b/TombEngine/Objects/TR5/tr5_objects.cpp @@ -774,7 +774,6 @@ static void StartObject(ObjectInfo *obj) obj = &Objects[ID_TELEPORTER]; if (obj->loaded) { - obj->Initialize = InitializeTeleporter; obj->control = ControlTeleporter; obj->drawRoutine = nullptr; } diff --git a/TombEngine/Renderer/RendererDraw.cpp b/TombEngine/Renderer/RendererDraw.cpp index 391f07fc6..e22c9357c 100644 --- a/TombEngine/Renderer/RendererDraw.cpp +++ b/TombEngine/Renderer/RendererDraw.cpp @@ -263,6 +263,9 @@ namespace TEN::Renderer objectID = gunshell->objectNumber; + if (!_moveableObjects[objectID].has_value()) + continue; + auto translation = Matrix::CreateTranslation(gunshell->pos.Position.ToVector3()); auto rotMatrix = gunshell->pos.Orientation.ToRotationMatrix(); auto worldMatrix = rotMatrix * translation; diff --git a/TombEngine/Renderer/RendererDrawEffect.cpp b/TombEngine/Renderer/RendererDrawEffect.cpp index e647f86b1..cb903c2f6 100644 --- a/TombEngine/Renderer/RendererDrawEffect.cpp +++ b/TombEngine/Renderer/RendererDrawEffect.cpp @@ -1085,31 +1085,10 @@ namespace TEN::Renderer if (!settings.MuzzleFlash) return false; - _shaders.Bind(Shader::Statics); - - unsigned int stride = sizeof(Vertex); - unsigned int offset = 0; - - _context->IASetVertexBuffers(0, 1, _moveablesVertexBuffer.Buffer.GetAddressOf(), &stride, &offset); - _context->IASetPrimitiveTopology(D3D11_PRIMITIVE_TOPOLOGY_TRIANGLELIST); - _context->IASetIndexBuffer(_moveablesIndexBuffer.Buffer.Get(), DXGI_FORMAT_R32_UINT, 0); - - const auto& room = _rooms[LaraItem->RoomNumber]; - auto* itemPtr = &_items[LaraItem->Index]; - - // Divide gunflash tint by 2 because tinting uses multiplication and additive color which doesn't look good with overbright color values. - _stStatic.Color = settings.ColorizeMuzzleFlash ? ((Vector4)settings.FlashColor / 2) : Vector4::One; - _stStatic.AmbientLight = room.AmbientLight; - _stStatic.LightMode = (int)LightMode::Static; - BindStaticLights(itemPtr->LightsToDraw); - short length = 0; short zOffset = 0; short rotationX = 0; - SetAlphaTest(AlphaTestMode::GreatherThan, ALPHA_TEST_THRESHOLD); - SetBlendMode(BlendMode::Additive); - if (Lara.Control.Weapon.GunType != LaraWeaponType::Flare && Lara.Control.Weapon.GunType != LaraWeaponType::Crossbow) { @@ -1151,9 +1130,33 @@ namespace TEN::Renderer zOffset += 10; } + if (!_moveableObjects[gunflash].has_value()) + return false; + const auto& flashMoveable = *_moveableObjects[gunflash]; const auto& flashMesh = *flashMoveable.ObjectMeshes[0]; + _shaders.Bind(Shader::Statics); + + unsigned int stride = sizeof(Vertex); + unsigned int offset = 0; + + _context->IASetVertexBuffers(0, 1, _moveablesVertexBuffer.Buffer.GetAddressOf(), &stride, &offset); + _context->IASetPrimitiveTopology(D3D11_PRIMITIVE_TOPOLOGY_TRIANGLELIST); + _context->IASetIndexBuffer(_moveablesIndexBuffer.Buffer.Get(), DXGI_FORMAT_R32_UINT, 0); + + const auto& room = _rooms[LaraItem->RoomNumber]; + auto* itemPtr = &_items[LaraItem->Index]; + + // Divide gunflash tint by 2 because tinting uses multiplication and additive color which doesn't look good with overbright color values. + _stStatic.Color = settings.ColorizeMuzzleFlash ? ((Vector4)settings.FlashColor / 2) : Vector4::One; + _stStatic.AmbientLight = room.AmbientLight; + _stStatic.LightMode = (int)LightMode::Static; + BindStaticLights(itemPtr->LightsToDraw); + + SetAlphaTest(AlphaTestMode::GreatherThan, ALPHA_TEST_THRESHOLD); + SetBlendMode(BlendMode::Additive); + for (const auto& flashBucket : flashMesh.Buckets) { if (flashBucket.BlendMode == BlendMode::Opaque) From 144a93dfe8ee9c290dc146405175faa4ecda0566 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Wed, 2 Apr 2025 06:02:03 +0200 Subject: [PATCH 126/160] Fixed #1616 --- CHANGELOG.md | 1 + TombEngine/Objects/TR4/Entity/Wraith.cpp | 12 ++++++------ 2 files changed, 7 insertions(+), 6 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index a74dc0ee6..234608089 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): ### Bug fixes * Fixed crashes when shooting, if gunflash or gunshell objects are not present in a level. * Fixed Teleporter object. +* Fixed Wraith objects not working correctly in flipped rooms. ## [Version 1.8.1](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.8.1) - 2025-03-29 diff --git a/TombEngine/Objects/TR4/Entity/Wraith.cpp b/TombEngine/Objects/TR4/Entity/Wraith.cpp index 90860c590..e84ada397 100644 --- a/TombEngine/Objects/TR4/Entity/Wraith.cpp +++ b/TombEngine/Objects/TR4/Entity/Wraith.cpp @@ -308,6 +308,11 @@ namespace TEN::Entities::TR4 item.Pose.Orientation.x += angleV; } + // Translate wraith. + item.Pose.Position.x += item.Animation.Velocity.z * phd_sin(item.Pose.Orientation.y); + item.Pose.Position.y += item.Animation.Velocity.z * phd_sin(item.Pose.Orientation.x); + item.Pose.Position.z += item.Animation.Velocity.z * phd_cos(item.Pose.Orientation.y); + auto pointColl = GetPointCollision(item); bool hasHitWall = false; @@ -317,13 +322,8 @@ namespace TEN::Entities::TR4 hasHitWall = true; } - // Translate wraith. - item.Pose.Position.x += item.Animation.Velocity.z * phd_sin(item.Pose.Orientation.y); - item.Pose.Position.y += item.Animation.Velocity.z * phd_sin(item.Pose.Orientation.x); - item.Pose.Position.z += item.Animation.Velocity.z * phd_cos(item.Pose.Orientation.y); - if (pointColl.GetRoomNumber() != item.RoomNumber) - ItemNewRoom(itemNumber, pointColl.GetRoomNumber()); + ItemNewRoom(itemNumber, FindRoomNumber(item.Pose.Position, item.RoomNumber)); for (int linkItemNumber = g_Level.Rooms[item.RoomNumber].itemNumber; linkItemNumber != NO_VALUE; linkItemNumber = g_Level.Items[linkItemNumber].NextItem) { From 3a7d375dd99f023727fda5f2d10f91eee543e7ee Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Wed, 2 Apr 2025 06:12:06 +0200 Subject: [PATCH 127/160] Update tr5_teleporter.cpp --- TombEngine/Objects/TR5/Object/tr5_teleporter.cpp | 1 + 1 file changed, 1 insertion(+) diff --git a/TombEngine/Objects/TR5/Object/tr5_teleporter.cpp b/TombEngine/Objects/TR5/Object/tr5_teleporter.cpp index a3166f832..0620d6397 100644 --- a/TombEngine/Objects/TR5/Object/tr5_teleporter.cpp +++ b/TombEngine/Objects/TR5/Object/tr5_teleporter.cpp @@ -38,6 +38,7 @@ void ControlTeleporter(short itemNumber) else { Camera.fixedCamera = true; + LaraItem->DisableInterpolation = true; LaraItem->Pose.Position.x = item->Pose.Position.x; LaraItem->Pose.Position.z = item->Pose.Position.z; LaraItem->Pose.Orientation.y = item->Pose.Orientation.y - ANGLE(180.0f); From 5b9836dea06533d129373d7399b7ea620476e121 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Wed, 2 Apr 2025 06:15:57 +0200 Subject: [PATCH 128/160] Update tr5_teleporter.cpp --- TombEngine/Objects/TR5/Object/tr5_teleporter.cpp | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/TombEngine/Objects/TR5/Object/tr5_teleporter.cpp b/TombEngine/Objects/TR5/Object/tr5_teleporter.cpp index 0620d6397..a71934996 100644 --- a/TombEngine/Objects/TR5/Object/tr5_teleporter.cpp +++ b/TombEngine/Objects/TR5/Object/tr5_teleporter.cpp @@ -1,13 +1,14 @@ #include "framework.h" -#include "tr5_teleporter.h" -#include "Game/items.h" -#include "Specific/level.h" -#include "Game/collision/collide_room.h" -#include "Sound/sound.h" -#include "Game/effects/weather.h" -#include "Game/Lara/lara.h" +#include "Objects/TR5/Object/tr5_teleporter.h" + #include "Game/camera.h" +#include "Game/collision/collide_room.h" #include "Game/collision/Point.h" +#include "Game/effects/weather.h" +#include "Game/items.h" +#include "Game/Lara/lara.h" +#include "Sound/sound.h" +#include "Specific/level.h" using namespace TEN::Collision::Point; using namespace TEN::Effects::Environment; From fc4cef38dfb006ec2749e44c220fc6a83402c3d8 Mon Sep 17 00:00:00 2001 From: MontyTRC89 Date: Thu, 3 Apr 2025 09:38:20 +0200 Subject: [PATCH 129/160] Fixed caustics when DDS compression is used --- .../Renderer/ConstantBuffers/RoomBuffer.h | 2 +- TombEngine/Renderer/Graphics/Texture2D.h | 42 ------------------- TombEngine/Renderer/Renderer.h | 2 +- TombEngine/Renderer/RendererCompatibility.cpp | 19 --------- TombEngine/Renderer/RendererDraw.cpp | 13 ++++-- TombEngine/Shaders/Rooms.fx | 42 ++++++++++--------- 6 files changed, 35 insertions(+), 85 deletions(-) diff --git a/TombEngine/Renderer/ConstantBuffers/RoomBuffer.h b/TombEngine/Renderer/ConstantBuffers/RoomBuffer.h index d78a77965..c73f4f9ca 100644 --- a/TombEngine/Renderer/ConstantBuffers/RoomBuffer.h +++ b/TombEngine/Renderer/ConstantBuffers/RoomBuffer.h @@ -15,7 +15,7 @@ namespace TEN::Renderer::ConstantBuffers int Padding; //-- Vector2 CausticsStartUV; - Vector2 CausticsScale; + Vector2 CausticsSize; //-- Vector4 AmbientColor; //-- diff --git a/TombEngine/Renderer/Graphics/Texture2D.h b/TombEngine/Renderer/Graphics/Texture2D.h index 1608b7ea2..2a398def9 100644 --- a/TombEngine/Renderer/Graphics/Texture2D.h +++ b/TombEngine/Renderer/Graphics/Texture2D.h @@ -144,48 +144,6 @@ namespace TEN::Renderer::Graphics Height = desc.Height; } - Texture2D(ID3D11Device* device, ID3D11DeviceContext* context, ID3D11Texture2D* texture, int x, int y, int width, int height) - { - Width = width; - Height = height; - - D3D11_TEXTURE2D_DESC fromDesc = {}; - texture->GetDesc(&fromDesc); - - auto desc = D3D11_TEXTURE2D_DESC{}; - desc.Width = width; - desc.Height = height; - desc.Format = fromDesc.Format; - desc.CPUAccessFlags = 0; - desc.MiscFlags = 0; - desc.MipLevels = 1; - desc.ArraySize = 1; - desc.BindFlags = D3D11_BIND_SHADER_RESOURCE; - desc.SampleDesc.Count = 1; - desc.SampleDesc.Quality = 0; - desc.Usage = D3D11_USAGE_DEFAULT; - - throwIfFailed(device->CreateTexture2D(&desc, nullptr, &Texture)); - - D3D11_BOX sourceRegion; - sourceRegion.left = x; - sourceRegion.right = x + width; - sourceRegion.top = y; - sourceRegion.bottom = y + height; - sourceRegion.front = 0; - sourceRegion.back = 1; - - context->CopySubresourceRegion(Texture.Get(), 0, 0, 0, 0, texture, 0, &sourceRegion); - - auto shaderDesc = D3D11_SHADER_RESOURCE_VIEW_DESC{}; - shaderDesc.Format = desc.Format; - shaderDesc.ViewDimension = D3D11_SRV_DIMENSION_TEXTURE2D; - shaderDesc.Texture2D.MostDetailedMip = 0; - shaderDesc.Texture2D.MipLevels = 1; - - throwIfFailed(device->CreateShaderResourceView(Texture.Get(), &shaderDesc, ShaderResourceView.GetAddressOf())); - } - ~Texture2D() = default; }; } diff --git a/TombEngine/Renderer/Renderer.h b/TombEngine/Renderer/Renderer.h index 4e643388d..16c6325c2 100644 --- a/TombEngine/Renderer/Renderer.h +++ b/TombEngine/Renderer/Renderer.h @@ -340,7 +340,7 @@ namespace TEN::Renderer // Special effects - std::vector _causticTextures; + //std::vector _causticTextures; RendererMirror* _currentMirror = nullptr; // Transparency diff --git a/TombEngine/Renderer/RendererCompatibility.cpp b/TombEngine/Renderer/RendererCompatibility.cpp index 7ae2ef7d5..2239f8450 100644 --- a/TombEngine/Renderer/RendererCompatibility.cpp +++ b/TombEngine/Renderer/RendererCompatibility.cpp @@ -882,25 +882,6 @@ namespace TEN::Renderer } _spriteSequences[SpriteSequencesIds[i]] = sequence; - - if (SpriteSequencesIds[i] == ID_CAUSTIC_TEXTURES) - { - _causticTextures.clear(); - for (int j = 0; j < sequence.SpritesList.size(); j++) - { - _causticTextures.push_back( - Texture2D( - _device.Get(), - _context.Get(), - sequence.SpritesList[j]->Texture->Texture.Get(), - sequence.SpritesList[j]->X, - sequence.SpritesList[j]->Y, - sequence.SpritesList[j]->Width, - sequence.SpritesList[j]->Height - ) - ); - } - } } } diff --git a/TombEngine/Renderer/RendererDraw.cpp b/TombEngine/Renderer/RendererDraw.cpp index 391f07fc6..dddca503e 100644 --- a/TombEngine/Renderer/RendererDraw.cpp +++ b/TombEngine/Renderer/RendererDraw.cpp @@ -2709,12 +2709,19 @@ namespace TEN::Renderer if (rendererPass != RendererPass::GBuffer) { // Bind caustics texture. - if (_causticTextures.size() > 0) + if (std::find(SpriteSequencesIds.begin(), SpriteSequencesIds.end(), ID_CAUSTIC_TEXTURES) != SpriteSequencesIds.end()) { int nmeshes = -Objects[ID_CAUSTIC_TEXTURES].nmeshes; int meshIndex = Objects[ID_CAUSTIC_TEXTURES].meshIndex; - int causticsFrame = GlobalCounter % _causticTextures.size(); - BindTexture(TextureRegister::CausticsMap, &_causticTextures[causticsFrame], SamplerStateRegister::AnisotropicClamp); + int causticsFrame = GlobalCounter % nmeshes; + auto causticsSprite = _spriteSequences[ID_CAUSTIC_TEXTURES].SpritesList[causticsFrame]; + + BindTexture(TextureRegister::CausticsMap, causticsSprite->Texture, SamplerStateRegister::AnisotropicClamp); + + _stRoom.CausticsSize = Vector2( + (float)causticsSprite->Width / (float)causticsSprite->Texture->Width, + (float)causticsSprite->Height / (float)causticsSprite->Texture->Height); + _stRoom.CausticsStartUV = causticsSprite->UV[0]; } // Set shadow map data and bind shadow map texture. diff --git a/TombEngine/Shaders/Rooms.fx b/TombEngine/Shaders/Rooms.fx index 1ed9a57ba..b1da5c9ec 100644 --- a/TombEngine/Shaders/Rooms.fx +++ b/TombEngine/Shaders/Rooms.fx @@ -16,7 +16,7 @@ cbuffer RoomBuffer : register(b5) int NumRoomLights; int Padding; float2 CausticsStartUV; - float2 CausticsScale; + float2 CausticsSize; float4 AmbientColor; ShaderLight RoomLights[MAX_LIGHTS_PER_ROOM]; }; @@ -170,29 +170,33 @@ PixelShaderOutput PS(PixelShaderInput input) } } - if (Caustics) - { - float attenuation = saturate(dot(float3(0.0f, -1.0f, 0.0f), normal)); + if (Caustics) + { + float attenuation = saturate(dot(float3(0.0f, -1.0f, 0.0f), normal)); - float3 blending = abs(normal); - blending = normalize(max(blending, 0.00001f)); - float b = (blending.x + blending.y + blending.z); - blending /= float3(b, b, b); + float3 blending = abs(normal); + blending = normalize(max(blending, 0.00001f)); + float b = (blending.x + blending.y + blending.z); + blending /= float3(b, b, b); - float3 p = frac(input.WorldPosition.xyz / 2048.0f); - - float3 xaxis = CausticsTexture.SampleLevel(CausticsTextureSampler, float2(p.z, p.y), 0).xyz; - float3 yaxis = CausticsTexture.SampleLevel(CausticsTextureSampler, float2(p.z, p.x), 0).xyz; - float3 zaxis = CausticsTexture.SampleLevel(CausticsTextureSampler, float2(p.y, p.x), 0).xyz; + float3 p = frac(input.WorldPosition.xyz / 2048.0f); + + float2 uv_x = CausticsStartUV + float2(p.z, p.y) * CausticsSize; + float2 uv_y = CausticsStartUV + float2(p.z, p.x) * CausticsSize; + float2 uv_z = CausticsStartUV + float2(p.y, p.x) * CausticsSize; - float3 xc = xaxis * blending.x; - float3 yc = yaxis * blending.y; - float3 zc = zaxis * blending.z; + float3 xaxis = CausticsTexture.SampleLevel(CausticsTextureSampler, uv_x, 0).xyz; + float3 yaxis = CausticsTexture.SampleLevel(CausticsTextureSampler, uv_y, 0).xyz; + float3 zaxis = CausticsTexture.SampleLevel(CausticsTextureSampler, uv_z, 0).xyz; - float3 caustics = xc + yc + zc; + float3 xc = xaxis * blending.x; + float3 yc = yaxis * blending.y; + float3 zc = zaxis * blending.z; - lighting += (caustics * attenuation * 2.0f); - } + float3 caustics = xc + yc + zc; + + lighting += (caustics * attenuation * 2.0f); + } lighting -= float3(input.FogBulbs.w, input.FogBulbs.w, input.FogBulbs.w); output.Color.xyz = output.Color.xyz * lighting * occlusion; From 3745cdadbdcc2c644d445281975e9c2bdda86df8 Mon Sep 17 00:00:00 2001 From: MontyTRC89 Date: Thu, 3 Apr 2025 10:50:02 +0200 Subject: [PATCH 130/160] Possible fix for GetJointPosition problem when objects are off-screen --- TombEngine/Renderer/RendererFrame.cpp | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/TombEngine/Renderer/RendererFrame.cpp b/TombEngine/Renderer/RendererFrame.cpp index 6fddadff9..3e5f2ac53 100644 --- a/TombEngine/Renderer/RendererFrame.cpp +++ b/TombEngine/Renderer/RendererFrame.cpp @@ -422,12 +422,15 @@ namespace TEN::Renderer // Clip object by frustum only if it doesn't cast shadows and is not in mirror room, // otherwise disappearing shadows or reflections may be seen if object gets out of frustum. + bool inFrustum = true; + if (!isRoomReflected && obj.ShadowType == ShadowMode::None) { + inFrustum = false; + // Get all spheres and check if frustum intersects any of them. auto spheres = GetSpheres(itemNumber); - bool inFrustum = false; for (int i = 0; !inFrustum, i < spheres.size(); i++) { // Blow up sphere radius by half for cases of too small calculated spheres. @@ -435,8 +438,8 @@ namespace TEN::Renderer inFrustum = true; } - if (!inFrustum) - continue; + // NOTE: removed continue loop here if not in frustum, + // for updating first positions and animations data } auto& newItem = _items[itemNumber]; @@ -487,6 +490,12 @@ namespace TEN::Renderer for (int j = 0; j < MAX_BONES; j++) newItem.InterpolatedAnimTransforms[j] = Matrix::Lerp(newItem.PrevAnimTransforms[j], newItem.AnimTransforms[j], GetInterpolationFactor(forceValue)); + // NOTE: now at least positions and animations are updated, + // because even off-screen the correct position is required + // by GetJointPosition functions and similars + if (!inFrustum) + continue; + CalculateLightFades(&newItem); CollectLightsForItem(&newItem); From d2d6645fe86522ce073d615cb899b692a2d5b623 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Fri, 4 Apr 2025 08:57:06 +0200 Subject: [PATCH 131/160] Fallback for GetJointPosition --- CHANGELOG.md | 4 ++++ TombEngine/Game/animation.cpp | 12 ++++++++++++ .../Internal/TEN/Objects/Moveable/MoveableObject.cpp | 6 +++--- 3 files changed, 19 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 234608089..eb51790f1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,10 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed crashes when shooting, if gunflash or gunshell objects are not present in a level. * Fixed Teleporter object. * Fixed Wraith objects not working correctly in flipped rooms. +* Fixed caustics not rendered correctly if texture compression was enabled. + +### Lua API changes +* Fixed `Moveable.GetJointPosition` not returning correct results if moveable is invisible or not rendered. ## [Version 1.8.1](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.8.1) - 2025-03-29 diff --git a/TombEngine/Game/animation.cpp b/TombEngine/Game/animation.cpp index 04eb59905..3588ef746 100644 --- a/TombEngine/Game/animation.cpp +++ b/TombEngine/Game/animation.cpp @@ -689,6 +689,18 @@ void ClampRotation(Pose& outPose, short angle, short rotation) Vector3i GetJointPosition(const ItemInfo& item, int jointIndex, const Vector3i& relOffset) { + bool incorrectJoint = false; + if (jointIndex < 0 || jointIndex >= Objects[item.ObjectNumber].nmeshes) + { + TENLog("Unknown joint ID specified for object " + GetObjectName(item.ObjectNumber), LogLevel::Warning, LogConfig::All); + incorrectJoint = true; + } + + // Always return object's root position if it's invisible, because we can't predict its + // joint position otherwise, since it's not animated. + if (incorrectJoint || Objects[item.ObjectNumber].drawRoutine == nullptr || item.Status == ITEM_INVISIBLE) + return Geometry::TranslatePoint(item.Pose.Position, item.Pose.Orientation, relOffset); + // Use matrices done in renderer to transform relative offset. return Vector3i(g_Renderer.GetMoveableBonePosition(item.Index, jointIndex, relOffset.ToVector3())); } diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp index eb1ef5760..36028332a 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp +++ b/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp @@ -430,13 +430,13 @@ void Moveable::SetPosition(const Vec3& pos, sol::optional updateRoom) /// Get the moveable's joint position with an optional relative offset. // @function Moveable:GetJointPosition -// @tparam int jointID Joint ID. +// @tparam int jointIndex Index of a joint to get position. // @tparam[opt] Vec3 offset Offset relative to the joint. // @treturn Vec3 World position. -Vec3 Moveable::GetJointPos(int jointID, sol::optional offset) const +Vec3 Moveable::GetJointPos(int jointIndex, sol::optional offset) const { auto convertedOffset = offset.has_value() ? offset->ToVector3i() : Vector3i::Zero; - return Vec3(GetJointPosition(_moveable, jointID, convertedOffset)); + return Vec3(GetJointPosition(_moveable, jointIndex, convertedOffset)); } /// Get the object's joint rotation From ab55a7cf14bfa6c5389e8b86cdbe1bef5c471e8b Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Fri, 4 Apr 2025 09:08:55 +0200 Subject: [PATCH 132/160] Use Contains method where applicable --- Documentation/doc/2 classes/Objects.Moveable.html | 8 ++++---- TombEngine/Game/Lara/lara_one_gun.cpp | 3 ++- TombEngine/Game/camera.cpp | 3 ++- TombEngine/Renderer/RendererDraw.cpp | 3 ++- TombEngine/Renderer/RendererFrame.cpp | 2 +- 5 files changed, 11 insertions(+), 8 deletions(-) diff --git a/Documentation/doc/2 classes/Objects.Moveable.html b/Documentation/doc/2 classes/Objects.Moveable.html index cddc5ebb0..45f4fa252 100644 --- a/Documentation/doc/2 classes/Objects.Moveable.html +++ b/Documentation/doc/2 classes/Objects.Moveable.html @@ -172,7 +172,7 @@ (e.g.

    - + @@ -771,7 +771,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    - Moveable:GetJointPosition(jointID[, offset]) + Moveable:GetJointPosition(jointIndex[, offset])
    Get the moveable's joint position with an optional relative offset. @@ -780,9 +780,9 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)

    Parameters:

      -
    • jointID +
    • jointIndex int - Joint ID. + Index of a joint to get position.
    • offset Vec3 diff --git a/TombEngine/Game/Lara/lara_one_gun.cpp b/TombEngine/Game/Lara/lara_one_gun.cpp index 592b9d99c..32b7d60bf 100644 --- a/TombEngine/Game/Lara/lara_one_gun.cpp +++ b/TombEngine/Game/Lara/lara_one_gun.cpp @@ -32,6 +32,7 @@ #include "Specific/clock.h" #include "Specific/Input/Input.h" #include "Specific/level.h" +#include "Specific/trutils.h" using namespace TEN::Collision::Point; using namespace TEN::Effects::Bubble; @@ -1594,7 +1595,7 @@ void HandleProjectile(ItemInfo& projectile, ItemInfo& emitter, const Vector3i& p for (auto* itemPtr : collObjects.Items) { // Object was already affected by collision, skip it. - if (std::find(affectedObjects.begin(), affectedObjects.end(), itemPtr->Index) != affectedObjects.end()) + if (TEN::Utils::Contains(affectedObjects, itemPtr->Index)) continue; const auto& currentObject = Objects[itemPtr->ObjectNumber]; diff --git a/TombEngine/Game/camera.cpp b/TombEngine/Game/camera.cpp index fa5f62f02..b6095f8f1 100644 --- a/TombEngine/Game/camera.cpp +++ b/TombEngine/Game/camera.cpp @@ -22,6 +22,7 @@ #include "Sound/sound.h" #include "Specific/Input/Input.h" #include "Specific/level.h" +#include "Specific/trutils.h" #include "Specific/winmain.h" using namespace TEN::Collision::Point; @@ -1392,7 +1393,7 @@ static std::vector FillCollideableItemList() { const auto& item = g_Level.Items[i]; - if (std::find(roomList.begin(), roomList.end(), item.RoomNumber) == roomList.end()) + if (!TEN::Utils::Contains(roomList, (int)item.RoomNumber)) continue; if (!g_Level.Rooms[item.RoomNumber].Active()) diff --git a/TombEngine/Renderer/RendererDraw.cpp b/TombEngine/Renderer/RendererDraw.cpp index 491f38b0b..341a7f986 100644 --- a/TombEngine/Renderer/RendererDraw.cpp +++ b/TombEngine/Renderer/RendererDraw.cpp @@ -31,6 +31,7 @@ #include "Renderer/Structures/RendererSortableObject.h" #include "Specific/configuration.h" #include "Specific/level.h" +#include "Specific/trutils.h" #include "Specific/winmain.h" using namespace TEN::Effects::Hair; @@ -2712,7 +2713,7 @@ namespace TEN::Renderer if (rendererPass != RendererPass::GBuffer) { // Bind caustics texture. - if (std::find(SpriteSequencesIds.begin(), SpriteSequencesIds.end(), ID_CAUSTIC_TEXTURES) != SpriteSequencesIds.end()) + if (TEN::Utils::Contains(SpriteSequencesIds, (int)ID_CAUSTIC_TEXTURES)) { int nmeshes = -Objects[ID_CAUSTIC_TEXTURES].nmeshes; int meshIndex = Objects[ID_CAUSTIC_TEXTURES].meshIndex; diff --git a/TombEngine/Renderer/RendererFrame.cpp b/TombEngine/Renderer/RendererFrame.cpp index 3e5f2ac53..d8d0fcdb0 100644 --- a/TombEngine/Renderer/RendererFrame.cpp +++ b/TombEngine/Renderer/RendererFrame.cpp @@ -835,7 +835,7 @@ namespace TEN::Renderer } // Light already on a list - if (std::find(renderView.LightsToDraw.begin(), renderView.LightsToDraw.end(), light) != renderView.LightsToDraw.end()) + if (TEN::Utils::Contains(renderView.LightsToDraw, light)) { continue; } From 783d7f5fa35fe41979f1e3de04510e37b2a3d129 Mon Sep 17 00:00:00 2001 From: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Sat, 5 Apr 2025 11:24:06 -0400 Subject: [PATCH 133/160] Remove active requirement from ObjectCamera --- .../Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp | 1 - 1 file changed, 1 deletion(-) diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp index 36028332a..b11d4ab72 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp +++ b/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp @@ -1240,7 +1240,6 @@ bool Moveable::MeshExists(int index) const // @tparam int mesh Mesh of a target moveable to use as a camera target. void Moveable::AttachObjCamera(short camMeshId, Moveable& mov, short targetMeshId) { - if ((_moveable->Active || _moveable->IsLara()) && (mov._moveable->Active || mov._moveable->IsLara())) ObjCamera(_moveable, camMeshId, mov._moveable, targetMeshId, true); } From 88b1971848604b81791781708aacc30986a9ae4f Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 6 Apr 2025 01:39:37 +0200 Subject: [PATCH 134/160] Correct exclude blend mode --- CHANGELOG.md | 1 + TombEngine/Renderer/RendererInit.cpp | 10 +++++----- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index eb51790f1..fecd0365f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -10,6 +10,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed Teleporter object. * Fixed Wraith objects not working correctly in flipped rooms. * Fixed caustics not rendered correctly if texture compression was enabled. +* Fixed exclusion blend mode not working correctly. ### Lua API changes * Fixed `Moveable.GetJointPosition` not returning correct results if moveable is invisible or not rendered. diff --git a/TombEngine/Renderer/RendererInit.cpp b/TombEngine/Renderer/RendererInit.cpp index 46fac3c2f..81ee2c115 100644 --- a/TombEngine/Renderer/RendererInit.cpp +++ b/TombEngine/Renderer/RendererInit.cpp @@ -133,11 +133,11 @@ namespace TEN::Renderer blendStateDesc.AlphaToCoverageEnable = false; blendStateDesc.IndependentBlendEnable = false; blendStateDesc.RenderTarget[0].BlendEnable = true; - blendStateDesc.RenderTarget[0].SrcBlend = D3D11_BLEND_SRC_ALPHA; - blendStateDesc.RenderTarget[0].DestBlend = D3D11_BLEND_INV_SRC_ALPHA; - blendStateDesc.RenderTarget[0].BlendOp = D3D11_BLEND_OP_REV_SUBTRACT; - blendStateDesc.RenderTarget[0].SrcBlendAlpha = D3D11_BLEND_SRC_ALPHA; - blendStateDesc.RenderTarget[0].DestBlendAlpha = D3D11_BLEND_DEST_ALPHA; + blendStateDesc.RenderTarget[0].SrcBlend = D3D11_BLEND_INV_DEST_COLOR; + blendStateDesc.RenderTarget[0].DestBlend = D3D11_BLEND_INV_SRC_COLOR; + blendStateDesc.RenderTarget[0].BlendOp = D3D11_BLEND_OP_ADD; + blendStateDesc.RenderTarget[0].SrcBlendAlpha = D3D11_BLEND_ONE; + blendStateDesc.RenderTarget[0].DestBlendAlpha = D3D11_BLEND_ZERO; blendStateDesc.RenderTarget[0].BlendOpAlpha = D3D11_BLEND_OP_ADD; blendStateDesc.RenderTarget[0].RenderTargetWriteMask = D3D11_COLOR_WRITE_ENABLE_ALL; Utils::throwIfFailed(_device->CreateBlendState(&blendStateDesc, _excludeBlendState.GetAddressOf())); From 517f5b30694bf194c1a80fc138170ee8b21377bd Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Mon, 7 Apr 2025 08:23:04 +0200 Subject: [PATCH 135/160] Use single version for TE and TEN --- TombEngine/Resources.rc | 4 ++-- .../Internal/TEN/Objects/Moveable/MoveableObject.cpp | 2 +- TombEngine/version.h | 9 +-------- 3 files changed, 4 insertions(+), 11 deletions(-) diff --git a/TombEngine/Resources.rc b/TombEngine/Resources.rc index 0fa0b9c9e..46163b7a4 100644 --- a/TombEngine/Resources.rc +++ b/TombEngine/Resources.rc @@ -28,7 +28,7 @@ LANGUAGE LANG_ENGLISH, SUBLANG_NEUTRAL VS_VERSION_INFO VERSIONINFO FILEVERSION TEN_MAJOR_VERSION,TEN_MINOR_VERSION,TEN_BUILD_NUMBER,TEN_REVISION_NUMBER - PRODUCTVERSION TE_MAJOR_VERSION,TE_MINOR_VERSION,TE_BUILD_NUMBER,TE_REVISION_NUMBER + PRODUCTVERSION TEN_MAJOR_VERSION, TEN_MINOR_VERSION, TEN_BUILD_NUMBER, TEN_REVISION_NUMBER FILEFLAGSMASK 0x3fL #ifdef _DEBUG FILEFLAGS 0x1L @@ -49,7 +49,7 @@ BEGIN VALUE "OriginalFilename", "TombEngine.exe" VALUE "ProductName", "Tomb Engine" VALUE "FileVersion", TEN_VERSION_STRING - VALUE "ProductVersion", TE_VERSION_STRING + VALUE "ProductVersion", TEN_VERSION_STRING END END BLOCK "VarFileInfo" diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp index b11d4ab72..04e4e000b 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp +++ b/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp @@ -1240,7 +1240,7 @@ bool Moveable::MeshExists(int index) const // @tparam int mesh Mesh of a target moveable to use as a camera target. void Moveable::AttachObjCamera(short camMeshId, Moveable& mov, short targetMeshId) { - ObjCamera(_moveable, camMeshId, mov._moveable, targetMeshId, true); + ObjCamera(_moveable, camMeshId, mov._moveable, targetMeshId, true); } /// Borrow animation from an object diff --git a/TombEngine/version.h b/TombEngine/version.h index 654ddf744..a7bbed0aa 100644 --- a/TombEngine/version.h +++ b/TombEngine/version.h @@ -1,19 +1,12 @@ #pragma once -#define TE_MAJOR_VERSION 1 -#define TE_MINOR_VERSION 8 -#define TE_BUILD_NUMBER 1 -#define TE_REVISION_NUMBER 0 - #define TEN_MAJOR_VERSION 1 #define TEN_MINOR_VERSION 8 -#define TEN_BUILD_NUMBER 1 +#define TEN_BUILD_NUMBER 2 #define TEN_REVISION_NUMBER 0 #define TEST_BUILD 1 #define TOSTR(x) #x #define MAKE_VERSION_STRING(major, minor, build, revision) TOSTR(major) "." TOSTR(minor) "." TOSTR(build) "." TOSTR(revision) - -#define TE_VERSION_STRING MAKE_VERSION_STRING(TE_MAJOR_VERSION, TE_MINOR_VERSION, TE_BUILD_NUMBER, TE_REVISION_NUMBER) #define TEN_VERSION_STRING MAKE_VERSION_STRING(TEN_MAJOR_VERSION, TEN_MINOR_VERSION, TEN_BUILD_NUMBER, TEN_REVISION_NUMBER) From b643eec16582a5b1738d1c6db51be5c862d4a1b2 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Wed, 9 Apr 2025 09:29:39 +0200 Subject: [PATCH 136/160] Added muzzle glow effect for firearms --- CHANGELOG.md | 4 ++ .../doc/2 classes/Flow.Settings.html | 50 +++++++++++++++++++ TombEngine/Game/control/control.cpp | 1 + TombEngine/Game/effects/tomb4fx.cpp | 46 +++++++++++++++++ TombEngine/Game/effects/tomb4fx.h | 1 + TombEngine/Renderer/RendererDraw.cpp | 8 +-- TombEngine/Renderer/RendererDrawEffect.cpp | 41 +-------------- .../Internal/TEN/Flow/Settings/Settings.cpp | 28 +++++++---- .../Internal/TEN/Flow/Settings/Settings.h | 2 + 9 files changed, 126 insertions(+), 55 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index fecd0365f..b5f5d1329 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,7 +12,11 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed caustics not rendered correctly if texture compression was enabled. * Fixed exclusion blend mode not working correctly. +### New features +* Added muzzle glow effect for firearms. + ### Lua API changes +* Added `muzzleGlow` and `muzzleOffset` parameters to weapon settings. * Fixed `Moveable.GetJointPosition` not returning correct results if moveable is invisible or not rendered. ## [Version 1.8.1](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.8.1) - 2025-03-29 diff --git a/Documentation/doc/2 classes/Flow.Settings.html b/Documentation/doc/2 classes/Flow.Settings.html index 6003f5cdc..c59098a2a 100644 --- a/Documentation/doc/2 classes/Flow.Settings.html +++ b/Documentation/doc/2 classes/Flow.Settings.html @@ -300,9 +300,17 @@
    + + + + + + + +
    Probe(pos, roomNumber)Probe(pos[, roomNumber]) Create a Probe at a specified world position in a room.
    Play a flyby sequence.
    GetFlybyPosition(seqID, progress)GetFlybyPosition(seqID, progress[, loop]) Get a flyby sequence's position at a specified progress point in percent.
    GetFlybyRotation(seqID, progress)GetFlybyRotation(seqID, progress[, loop]) Get a flyby sequence's rotation at a specified progress point in percent.
    Moveable:GetJointPosition(jointID[, offset])Moveable:GetJointPosition(jointIndex[, offset]) Get the moveable's joint position with an optional relative offset.
    Display muzzle flash.
    muzzleGlowDisplay muzzle glow.
    colorizeMuzzleFlash Colorize muzzle flash.
    muzzleOffsetMuzzle offset.

    System

    @@ -1214,6 +1222,27 @@ + +
    + + muzzleGlow +
    +
    + Display muzzle glow. + + + +
      +
    • muzzleGlow + bool + specifies whether muzzle glow should be displayed or not. Applicable only for firearms. +
      • +
    + + + + +
    @@ -1235,6 +1264,27 @@ + +
    + + muzzleOffset +
    +
    + Muzzle offset. + + + +
      +
    • muzzleOffset + Vec3 + specifies offset for spawning muzzle gunflash effects. Applicable only for firearms. +
      • +
    + + + + +

    System

    diff --git a/TombEngine/Game/control/control.cpp b/TombEngine/Game/control/control.cpp index d5171cbae..b543b9ee5 100644 --- a/TombEngine/Game/control/control.cpp +++ b/TombEngine/Game/control/control.cpp @@ -194,6 +194,7 @@ GameStatus GamePhase(bool insideMenu) UpdateBlood(); UpdateBubbles(); UpdateDebris(); + UpdateGunFlashes(); UpdateGunShells(); UpdateFootprints(); UpdateSplashes(); diff --git a/TombEngine/Game/effects/tomb4fx.cpp b/TombEngine/Game/effects/tomb4fx.cpp index c97fd5a8b..12bd28a61 100644 --- a/TombEngine/Game/effects/tomb4fx.cpp +++ b/TombEngine/Game/effects/tomb4fx.cpp @@ -941,6 +941,52 @@ void TriggerGunShell(short hand, short objNum, LaraWeaponType weaponType) } } +void UpdateGunFlashes() +{ + if (Lara.Control.Weapon.GunType == LaraWeaponType::None) + return; + + const auto& settings = g_GameFlow->GetSettings()->Weapons[(int)Lara.Control.Weapon.GunType - 1]; + + if (!settings.MuzzleGlow) + return; + + for (int hand = 0; hand < 2; hand++) + { + if ((hand ? Lara.RightArm.GunFlash : Lara.LeftArm.GunFlash) == 0) + continue; + + auto& part = *GetFreeParticle(); + + part.on = true; + part.SpriteSeqID = ID_DEFAULT_SPRITES; + part.SpriteID = 11; + part.blendMode = BlendMode::Additive; + + auto pos = GetJointPosition(LaraItem, hand ? LM_RHAND : LM_LHAND, settings.MuzzleOffset.ToVector3i()); + part.x = pos.x; + part.y = pos.y; + part.z = pos.z; + part.roomNumber = LaraItem->RoomNumber; + + part.sSize = part.size = part.dSize = 192; + part.scalar = 2; + + part.xVel = part.yVel = part.zVel = 0; + part.gravity = part.friction = part.maxYvel = 0; + + part.sR = part.dR = settings.FlashColor.GetR() / 2; + part.sG = part.dG = settings.FlashColor.GetG() / 2; + part.sB = part.dB = settings.FlashColor.GetB() / 2; + + part.life = part.sLife = 2; + part.colFadeSpeed = 1; + part.fadeToBlack = 1; + + part.flags = SP_SCALE | SP_DEF | SP_EXPDEF; + } +} + void UpdateGunShells() { for (int i = 0; i < MAX_GUNSHELL; i++) diff --git a/TombEngine/Game/effects/tomb4fx.h b/TombEngine/Game/effects/tomb4fx.h index b65f8b41e..629d4e4bc 100644 --- a/TombEngine/Game/effects/tomb4fx.h +++ b/TombEngine/Game/effects/tomb4fx.h @@ -323,6 +323,7 @@ void TriggerBlood(int x, int y, int z, int unk, int num); void UpdateBlood(); int GetFreeGunshell(); void TriggerGunShell(short hand, short objNum, LaraWeaponType weaponType); +void UpdateGunFlashes(); void UpdateGunShells(); void AddWaterSparks(int x, int y, int z, int num); void ExplodingDeath(short itemNumber, short flags); // BODY_ flags diff --git a/TombEngine/Renderer/RendererDraw.cpp b/TombEngine/Renderer/RendererDraw.cpp index 341a7f986..f068a8fd1 100644 --- a/TombEngine/Renderer/RendererDraw.cpp +++ b/TombEngine/Renderer/RendererDraw.cpp @@ -2824,12 +2824,8 @@ namespace TEN::Renderer } else { - BindTexture( - TextureRegister::ColorMap, &std::get<0>(_roomTextures[bucket.Texture]), - SamplerStateRegister::AnisotropicClamp); - BindTexture( - TextureRegister::NormalMap, &std::get<1>(_roomTextures[bucket.Texture]), - SamplerStateRegister::AnisotropicClamp); + BindTexture(TextureRegister::ColorMap, &std::get<0>(_roomTextures[bucket.Texture]), SamplerStateRegister::AnisotropicClamp); + BindTexture(TextureRegister::NormalMap, &std::get<1>(_roomTextures[bucket.Texture]), SamplerStateRegister::AnisotropicClamp); } DrawIndexedTriangles(bucket.NumIndices, bucket.StartIndex, 0); diff --git a/TombEngine/Renderer/RendererDrawEffect.cpp b/TombEngine/Renderer/RendererDrawEffect.cpp index cb903c2f6..04104ca09 100644 --- a/TombEngine/Renderer/RendererDrawEffect.cpp +++ b/TombEngine/Renderer/RendererDrawEffect.cpp @@ -1085,50 +1085,13 @@ namespace TEN::Renderer if (!settings.MuzzleFlash) return false; - short length = 0; - short zOffset = 0; - short rotationX = 0; - if (Lara.Control.Weapon.GunType != LaraWeaponType::Flare && Lara.Control.Weapon.GunType != LaraWeaponType::Crossbow) { - switch (Lara.Control.Weapon.GunType) - { - case LaraWeaponType::Revolver: - length = 192; - zOffset = 68; - rotationX = -14560; - break; - - case LaraWeaponType::Uzi: - length = 190; - zOffset = 50; - rotationX = -14560; - break; - - case LaraWeaponType::HK: - case LaraWeaponType::Shotgun: - length = 300; - zOffset = 92; - rotationX = -14560; - break; - - default: - case LaraWeaponType::Pistol: - length = 180; - zOffset = 40; - rotationX = -16830; - break; - } - // Use MP5 flash if available. auto gunflash = GAME_OBJECT_ID::ID_GUN_FLASH; if (Lara.Control.Weapon.GunType == LaraWeaponType::HK && Objects[GAME_OBJECT_ID::ID_GUN_FLASH2].loaded) - { gunflash = GAME_OBJECT_ID::ID_GUN_FLASH2; - length += 20; - zOffset += 10; - } if (!_moveableObjects[gunflash].has_value()) return false; @@ -1167,8 +1130,8 @@ namespace TEN::Renderer BindTexture(TextureRegister::ColorMap, &std::get<0>(_moveablesTextures[flashBucket.Texture]), SamplerStateRegister::AnisotropicClamp); - auto tMatrix = Matrix::CreateTranslation(0, length, zOffset); - auto rotMatrix = Matrix::CreateRotationX(TO_RAD(rotationX)); + auto tMatrix = Matrix::CreateTranslation(settings.MuzzleOffset); + auto rotMatrix = Matrix::CreateRotationX(TO_RAD(Lara.Control.Weapon.GunType == LaraWeaponType::Pistol ? -16830 : -14560)); // HACK auto worldMatrix = Matrix::Identity; if (Lara.LeftArm.GunFlash) diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp index 51cda08ee..88637ce35 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp @@ -25,15 +25,15 @@ namespace TEN::Scripting // NOTE: Since Weapons array is bound to Lua directly and Lua accesses this array by native enum, where 0 is NONE, and 1 is PISTOLS, // 0 index is omitted due to Lua indexing arrays starting from 1. 1 must be subtracted from initializer index. - Weapons[(int)LaraWeaponType::Pistol - 1] = { 8.0f, BLOCK(8), 9, (int)BLOCK(0.65f), 1, 1, 30, ScriptColor(192, 128, 0), 9, 3, true, true, true, false }; - Weapons[(int)LaraWeaponType::Revolver - 1] = { 4.0f, BLOCK(8), 16, (int)BLOCK(0.65f), 21, 21, 6, ScriptColor(192, 128, 0), 9, 3, true, false, true, false }; - Weapons[(int)LaraWeaponType::Uzi - 1] = { 8.0f, BLOCK(8), 3, (int)BLOCK(0.65f), 1, 1, 30, ScriptColor(192, 128, 0), 9, 2, true, true, true, false }; - Weapons[(int)LaraWeaponType::Shotgun - 1] = { 10.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 3, 3, 6, ScriptColor(192, 128, 0), 12, 3, true, true, false, false }; - Weapons[(int)LaraWeaponType::HK - 1] = { 4.0f, BLOCK(12), 0, (int)BLOCK(0.50f), 4, 4, 30, ScriptColor(192, 128, 0), 12, 2, true, true, true, false }; - Weapons[(int)LaraWeaponType::Crossbow - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 5, 20, 10, ScriptColor(192, 128, 0), 0, 0, false, false, false, false }; - Weapons[(int)LaraWeaponType::GrenadeLauncher - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 30, 30, 10, ScriptColor(192, 128, 0), 0, 0, true, false, false, false }; - Weapons[(int)LaraWeaponType::RocketLauncher - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 30, 30, 1, ScriptColor(192, 128, 0), 0, 0, true, false, false, false }; - Weapons[(int)LaraWeaponType::HarpoonGun - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 6, 6, 10, ScriptColor(192, 128, 0), 0, 0, false, false, false, false }; + Weapons[(int)LaraWeaponType::Pistol - 1] = { 8.0f, BLOCK(8), 9, (int)BLOCK(0.65f), 1, 1, 30, ScriptColor(192, 128, 0), 9, 3, true, true, true, true, false, Vec3(0, 180, 40) }; + Weapons[(int)LaraWeaponType::Revolver - 1] = { 4.0f, BLOCK(8), 16, (int)BLOCK(0.65f), 21, 21, 6, ScriptColor(192, 128, 0), 9, 3, true, false, true, true, false, Vec3(0, 192, 68) }; + Weapons[(int)LaraWeaponType::Uzi - 1] = { 8.0f, BLOCK(8), 3, (int)BLOCK(0.65f), 1, 1, 30, ScriptColor(192, 128, 0), 9, 2, true, true, true, true, false, Vec3(0, 190, 50) }; + Weapons[(int)LaraWeaponType::Shotgun - 1] = { 10.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 3, 3, 6, ScriptColor(192, 128, 0), 12, 3, true, true, false, false, false, Vec3(0, 300, 92) }; + Weapons[(int)LaraWeaponType::HK - 1] = { 4.0f, BLOCK(12), 0, (int)BLOCK(0.50f), 4, 4, 30, ScriptColor(192, 128, 0), 12, 2, true, true, true, true, false, Vec3(0, 320, 102) }; + Weapons[(int)LaraWeaponType::Crossbow - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 5, 20, 10, ScriptColor(192, 128, 0), 0, 0, false, false, false, false, false, Vec3() }; + Weapons[(int)LaraWeaponType::GrenadeLauncher - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 30, 30, 10, ScriptColor(192, 128, 0), 0, 0, true, false, false, false, false, Vec3() }; + Weapons[(int)LaraWeaponType::RocketLauncher - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 30, 30, 1, ScriptColor(192, 128, 0), 0, 0, true, false, false, false, false, Vec3() }; + Weapons[(int)LaraWeaponType::HarpoonGun - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 6, 6, 10, ScriptColor(192, 128, 0), 0, 0, false, false, false, false, false, Vec3() }; } void Settings::Register(sol::table& parent) @@ -309,9 +309,17 @@ namespace TEN::Scripting // @tfield bool muzzleFlash specifies whether muzzle flash should be displayed or not. Applicable only for firearms. "muzzleFlash", &WeaponSettings::MuzzleFlash, + /// Display muzzle glow. + // @tfield bool muzzleGlow specifies whether muzzle glow should be displayed or not. Applicable only for firearms. + "muzzleGlow", &WeaponSettings::MuzzleGlow, + /// Colorize muzzle flash. // @tfield bool colorizeMuzzleFlash specifies whether muzzle flash should be tinted with the same color as gunflash color. Applicable only for firearms. - "colorizeMuzzleFlash", &WeaponSettings::ColorizeMuzzleFlash); + "colorizeMuzzleFlash", &WeaponSettings::ColorizeMuzzleFlash, + + /// Muzzle offset. + // @tfield Vec3 muzzleOffset specifies offset for spawning muzzle gunflash effects. Applicable only for firearms. + "muzzleOffset", &WeaponSettings::MuzzleOffset); } /// System diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.h b/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.h index 7b2d962ad..f4f110141 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.h +++ b/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.h @@ -103,7 +103,9 @@ namespace TEN::Scripting bool Smoke = false; bool Shell = false; bool MuzzleFlash = true; + bool MuzzleGlow = true; bool ColorizeMuzzleFlash = false; + Vec3 MuzzleOffset = {}; static void Register(sol::table& parent); }; From ba166aa6fa72943e19e23b9cc7e6ae719ce9e2b7 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Wed, 9 Apr 2025 09:48:40 +0200 Subject: [PATCH 137/160] Randomize glow angle --- TombEngine/Game/effects/tomb4fx.cpp | 3 +++ 1 file changed, 3 insertions(+) diff --git a/TombEngine/Game/effects/tomb4fx.cpp b/TombEngine/Game/effects/tomb4fx.cpp index 12bd28a61..b100e8ed3 100644 --- a/TombEngine/Game/effects/tomb4fx.cpp +++ b/TombEngine/Game/effects/tomb4fx.cpp @@ -969,6 +969,9 @@ void UpdateGunFlashes() part.z = pos.z; part.roomNumber = LaraItem->RoomNumber; + part.rotAng = ANGLE(TO_DEGREES(Random::GenerateAngle())) >> 4; + part.rotAdd = 0; + part.sSize = part.size = part.dSize = 192; part.scalar = 2; From c81feb7da14d430786622f59207d732b587bdc76 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Wed, 9 Apr 2025 23:47:12 +0200 Subject: [PATCH 138/160] Dehardcode gun smoke positions, calculate gunflash offset --- TombEngine/Game/Lara/lara_one_gun.cpp | 29 ++++--------------- TombEngine/Game/Lara/lara_two_guns.cpp | 21 ++------------ TombEngine/Renderer/RendererDrawEffect.cpp | 6 +++- .../Internal/TEN/Flow/Settings/Settings.cpp | 10 +++---- 4 files changed, 17 insertions(+), 49 deletions(-) diff --git a/TombEngine/Game/Lara/lara_one_gun.cpp b/TombEngine/Game/Lara/lara_one_gun.cpp index 32b7d60bf..d651388ea 100644 --- a/TombEngine/Game/Lara/lara_one_gun.cpp +++ b/TombEngine/Game/Lara/lara_one_gun.cpp @@ -68,27 +68,6 @@ constexpr auto HK_RAPID_MODE_SHOT_INTERVAL = 3.0f; constexpr auto SHOTGUN_PELLET_COUNT = 6; -static Vector3i GetWeaponSmokeRelOffset(LaraWeaponType weaponType) -{ - switch (weaponType) - { - case LaraWeaponType::HK: - return Vector3i(0, 228, 96); - - case LaraWeaponType::Shotgun: - return Vector3i(0, 228, 0); - - case LaraWeaponType::GrenadeLauncher: - return Vector3i(0, 180, 80); - - case LaraWeaponType::RocketLauncher: - return Vector3i(0, 84, 72);; - - default: - return Vector3i::Zero; - } -} - void AnimateShotgun(ItemInfo& laraItem, LaraWeaponType weaponType) { auto& player = *GetLaraInfo(&laraItem); @@ -96,7 +75,7 @@ void AnimateShotgun(ItemInfo& laraItem, LaraWeaponType weaponType) if (player.LeftArm.GunSmoke > 0) { - auto relOffset = GetWeaponSmokeRelOffset(weaponType); + auto relOffset = g_GameFlow->GetSettings()->Weapons[(int)weaponType - 1].MuzzleOffset.ToVector3(); auto pos = GetJointPosition(&laraItem, LM_RHAND, relOffset); if (laraItem.MeshBits.TestAny()) @@ -411,8 +390,10 @@ void FireShotgun(ItemInfo& laraItem) if (!ammo.HasInfinite()) ammo--; - auto pos = GetJointPosition(&laraItem, LM_RHAND, Vector3i(0, 1508, 32)); - auto pos2 = GetJointPosition(&laraItem, LM_RHAND, Vector3i(0, 228, 32)); + auto offset = g_GameFlow->GetSettings()->Weapons[(int)LaraWeaponType::Shotgun].MuzzleOffset.ToVector3i(); + + auto pos = GetJointPosition(&laraItem, LM_RHAND, offset + Vector3::UnitY * CLICK(2)); + auto pos2 = GetJointPosition(&laraItem, LM_RHAND, offset); player.LeftArm.GunSmoke = 32; diff --git a/TombEngine/Game/Lara/lara_two_guns.cpp b/TombEngine/Game/Lara/lara_two_guns.cpp index a044c4282..48a26e200 100644 --- a/TombEngine/Game/Lara/lara_two_guns.cpp +++ b/TombEngine/Game/Lara/lara_two_guns.cpp @@ -45,24 +45,6 @@ static WeaponAnimData GetWeaponAnimData(LaraWeaponType weaponType) return ((it != ANIM_DATA_MAP.end()) ? it->second : ANIM_DATA_MAP.at(LaraWeaponType::None)); } -static Vector3i GetWeaponSmokeRelOffset(LaraWeaponType weaponType, bool isRightWeapon) -{ - switch (weaponType) - { - case LaraWeaponType::Pistol: - return Vector3i(isRightWeapon ? -16 : 4, 128, 40); - - case LaraWeaponType::Revolver: - return Vector3i(isRightWeapon ? -32 : 16, 160, 56); - - case LaraWeaponType::Uzi: - return Vector3i(isRightWeapon ? -16 : 8, 140, 48); - - default: - return Vector3i::Zero; - } -} - static void SetArmInfo(const ItemInfo& laraItem, ArmInfo& arm, int frame) { const auto& player = GetLaraInfo(laraItem); @@ -118,8 +100,9 @@ static void AnimateWeapon(ItemInfo& laraItem, LaraWeaponType weaponType, bool& h // Spawn weapon smoke. if (laraItem.MeshBits.TestAny() && arm.GunSmoke) { - auto relOffset = GetWeaponSmokeRelOffset(weaponType, isRightWeapon); + auto relOffset = g_GameFlow->GetSettings()->Weapons[(int)weaponType - 1].MuzzleOffset.ToVector3(); auto pos = GetJointPosition(&laraItem, isRightWeapon ? LM_RHAND : LM_LHAND, relOffset); + TriggerGunSmoke(pos.x, pos.y, pos.z, 0, 0, 0, 0, weaponType, arm.GunSmoke); } diff --git a/TombEngine/Renderer/RendererDrawEffect.cpp b/TombEngine/Renderer/RendererDrawEffect.cpp index 04104ca09..ce6ed8034 100644 --- a/TombEngine/Renderer/RendererDrawEffect.cpp +++ b/TombEngine/Renderer/RendererDrawEffect.cpp @@ -1130,7 +1130,11 @@ namespace TEN::Renderer BindTexture(TextureRegister::ColorMap, &std::get<0>(_moveablesTextures[flashBucket.Texture]), SamplerStateRegister::AnisotropicClamp); - auto tMatrix = Matrix::CreateTranslation(settings.MuzzleOffset); + + auto meshOffset = g_Level.Frames[GetAnimData(gunflash, 0).FramePtr].Offset; + auto offset = settings.MuzzleOffset + Vector3(meshOffset.x, meshOffset.z, meshOffset.y); // Offsets are inverted because of bone orientation. + + auto tMatrix = Matrix::CreateTranslation(offset); auto rotMatrix = Matrix::CreateRotationX(TO_RAD(Lara.Control.Weapon.GunType == LaraWeaponType::Pistol ? -16830 : -14560)); // HACK auto worldMatrix = Matrix::Identity; diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp index 88637ce35..cb65ca8d7 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp @@ -25,11 +25,11 @@ namespace TEN::Scripting // NOTE: Since Weapons array is bound to Lua directly and Lua accesses this array by native enum, where 0 is NONE, and 1 is PISTOLS, // 0 index is omitted due to Lua indexing arrays starting from 1. 1 must be subtracted from initializer index. - Weapons[(int)LaraWeaponType::Pistol - 1] = { 8.0f, BLOCK(8), 9, (int)BLOCK(0.65f), 1, 1, 30, ScriptColor(192, 128, 0), 9, 3, true, true, true, true, false, Vec3(0, 180, 40) }; - Weapons[(int)LaraWeaponType::Revolver - 1] = { 4.0f, BLOCK(8), 16, (int)BLOCK(0.65f), 21, 21, 6, ScriptColor(192, 128, 0), 9, 3, true, false, true, true, false, Vec3(0, 192, 68) }; - Weapons[(int)LaraWeaponType::Uzi - 1] = { 8.0f, BLOCK(8), 3, (int)BLOCK(0.65f), 1, 1, 30, ScriptColor(192, 128, 0), 9, 2, true, true, true, true, false, Vec3(0, 190, 50) }; - Weapons[(int)LaraWeaponType::Shotgun - 1] = { 10.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 3, 3, 6, ScriptColor(192, 128, 0), 12, 3, true, true, false, false, false, Vec3(0, 300, 92) }; - Weapons[(int)LaraWeaponType::HK - 1] = { 4.0f, BLOCK(12), 0, (int)BLOCK(0.50f), 4, 4, 30, ScriptColor(192, 128, 0), 12, 2, true, true, true, true, false, Vec3(0, 320, 102) }; + Weapons[(int)LaraWeaponType::Pistol - 1] = { 8.0f, BLOCK(8), 9, (int)BLOCK(0.65f), 1, 1, 30, ScriptColor(192, 128, 0), 9, 3, true, true, true, true, false, Vec3( 0, 120, 30) }; + Weapons[(int)LaraWeaponType::Revolver - 1] = { 4.0f, BLOCK(8), 16, (int)BLOCK(0.65f), 21, 21, 6, ScriptColor(192, 128, 0), 9, 3, true, false, true, true, false, Vec3(-10, 130, 45) }; + Weapons[(int)LaraWeaponType::Uzi - 1] = { 8.0f, BLOCK(8), 3, (int)BLOCK(0.65f), 1, 1, 30, ScriptColor(192, 128, 0), 9, 2, true, true, true, true, false, Vec3( 0, 110, 40) }; + Weapons[(int)LaraWeaponType::Shotgun - 1] = { 10.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 3, 3, 6, ScriptColor(192, 128, 0), 12, 3, true, true, false, false, false, Vec3( 0, 210, 42) }; + Weapons[(int)LaraWeaponType::HK - 1] = { 4.0f, BLOCK(12), 0, (int)BLOCK(0.50f), 4, 4, 30, ScriptColor(192, 128, 0), 12, 2, true, true, true, true, false, Vec3( 0, 220, 102) }; Weapons[(int)LaraWeaponType::Crossbow - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 5, 20, 10, ScriptColor(192, 128, 0), 0, 0, false, false, false, false, false, Vec3() }; Weapons[(int)LaraWeaponType::GrenadeLauncher - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 30, 30, 10, ScriptColor(192, 128, 0), 0, 0, true, false, false, false, false, Vec3() }; Weapons[(int)LaraWeaponType::RocketLauncher - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 30, 30, 1, ScriptColor(192, 128, 0), 0, 0, true, false, false, false, false, Vec3() }; From ee5147eb4f0d18d83c42f14334dfc25abeb3de4b Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Thu, 10 Apr 2025 21:23:34 +0200 Subject: [PATCH 139/160] Fixed spamming of HK sound effects --- CHANGELOG.md | 1 + TombEngine/Game/Lara/lara_one_gun.cpp | 7 ++----- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index b5f5d1329..2fd24b052 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed Wraith objects not working correctly in flipped rooms. * Fixed caustics not rendered correctly if texture compression was enabled. * Fixed exclusion blend mode not working correctly. +* Fixed HK sound effects. ### New features * Added muzzle glow effect for firearms. diff --git a/TombEngine/Game/Lara/lara_one_gun.cpp b/TombEngine/Game/Lara/lara_one_gun.cpp index d651388ea..3dcefb301 100644 --- a/TombEngine/Game/Lara/lara_one_gun.cpp +++ b/TombEngine/Game/Lara/lara_one_gun.cpp @@ -231,9 +231,8 @@ void AnimateShotgun(ItemInfo& laraItem, LaraWeaponType weaponType) player.Control.Weapon.Timer = 0.0f; } } - else if (player.Control.Weapon.Timer != 0.0f) + else if (weaponType == LaraWeaponType::HK && player.Control.Weapon.Timer != 0.0f) { - SoundEffect(SFX_TR4_EXPLOSION1, &laraItem.Pose, SoundEnvironment::Land, 1.0f, 0.4f); SoundEffect(SFX_TR4_HK_FIRE, &laraItem.Pose); } else if (weaponType == LaraWeaponType::Shotgun && !IsHeld(In::Action) && !player.LeftArm.Locked) @@ -312,9 +311,8 @@ void AnimateShotgun(ItemInfo& laraItem, LaraWeaponType weaponType) player.Control.Weapon.Timer = 0.0f; } } - else if (player.Control.Weapon.Timer != 0.0f) + else if (weaponType == LaraWeaponType::HK && player.Control.Weapon.Timer != 0.0f) { - SoundEffect(SFX_TR4_EXPLOSION1, &laraItem.Pose, SoundEnvironment::Land, 1.0f, 0.4f); SoundEffect(SFX_TR4_HK_FIRE, &laraItem.Pose); } @@ -1233,7 +1231,6 @@ void LasersightWeaponHandler(ItemInfo& item, LaraWeaponType weaponType) if (playSound) { - SoundEffect(SFX_TR4_EXPLOSION1, nullptr, SoundEnvironment::Land, 1.0f, 0.4f); SoundEffect(SFX_TR4_HK_FIRE, nullptr); Camera.bounce = -16 - (GetRandomControl() & 0x1F); } From 218299193fc9b1b01aa5ccb9e60e93410396e442 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Fri, 11 Apr 2025 03:11:05 +0200 Subject: [PATCH 140/160] Another method for SSAO fix --- CHANGELOG.md | 1 + TombEngine/Renderer/RendererDraw.cpp | 6 +----- TombEngine/Shaders/InstancedStatics.fx | 3 +++ TombEngine/Shaders/Items.fx | 3 +++ TombEngine/Shaders/Rooms.fx | 3 +++ 5 files changed, 11 insertions(+), 5 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 2fd24b052..47356f0a8 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed Wraith objects not working correctly in flipped rooms. * Fixed caustics not rendered correctly if texture compression was enabled. * Fixed exclusion blend mode not working correctly. +* Fixed SSAO incorrectly applied through alpha blended textures. * Fixed HK sound effects. ### New features diff --git a/TombEngine/Renderer/RendererDraw.cpp b/TombEngine/Renderer/RendererDraw.cpp index f068a8fd1..1949fc062 100644 --- a/TombEngine/Renderer/RendererDraw.cpp +++ b/TombEngine/Renderer/RendererDraw.cpp @@ -3236,11 +3236,7 @@ namespace TEN::Renderer case RendererPass::GBuffer: if (blendMode != BlendMode::Opaque && blendMode != BlendMode::AlphaTest && - blendMode != BlendMode::FastAlphaBlend && - // WARNING: For G-Buffer step we consider alpha blend like alpha test - // assuming that most of the geometry used in rooms, items and statics - // are fences, foliages, trees... But it could fail with translucent surfaces! - blendMode != BlendMode::AlphaBlend) + blendMode != BlendMode::FastAlphaBlend) { return false; } diff --git a/TombEngine/Shaders/InstancedStatics.fx b/TombEngine/Shaders/InstancedStatics.fx index 26ed08921..e284579e9 100644 --- a/TombEngine/Shaders/InstancedStatics.fx +++ b/TombEngine/Shaders/InstancedStatics.fx @@ -110,6 +110,9 @@ PixelShaderOutput PS(PixelShaderInput input) samplePosition = samplePosition * 0.5f + 0.5f; samplePosition.y = 1.0f - samplePosition.y; occlusion = pow(SSAOTexture.Sample(SSAOSampler, samplePosition).x, AmbientOcclusionExponent); + + if (BlendMode == BLENDMODE_ALPHABLEND) + occlusion = lerp(occlusion, 1.0f, tex.w); } float3 color = (mode == 0) ? diff --git a/TombEngine/Shaders/Items.fx b/TombEngine/Shaders/Items.fx index c789da24c..d8a13d5dc 100644 --- a/TombEngine/Shaders/Items.fx +++ b/TombEngine/Shaders/Items.fx @@ -140,6 +140,9 @@ PixelShaderOutput PS(PixelShaderInput input) samplePosition = samplePosition * 0.5f + 0.5f; // transform to range 0.0 - 1.0 samplePosition.y = 1.0f - samplePosition.y; occlusion = pow(SSAOTexture.Sample(SSAOSampler, samplePosition).x, AmbientOcclusionExponent); + + if (BlendMode == BLENDMODE_ALPHABLEND) + occlusion = lerp(occlusion, 1.0f, tex.w); } float3 color = (BoneLightModes[input.Bone / 4][input.Bone % 4] == 0) ? diff --git a/TombEngine/Shaders/Rooms.fx b/TombEngine/Shaders/Rooms.fx index b1da5c9ec..619e18972 100644 --- a/TombEngine/Shaders/Rooms.fx +++ b/TombEngine/Shaders/Rooms.fx @@ -141,6 +141,9 @@ PixelShaderOutput PS(PixelShaderInput input) samplePosition = samplePosition * 0.5f + 0.5f; // transform to range 0.0 - 1.0 samplePosition.y = 1.0f - samplePosition.y; occlusion = pow(SSAOTexture.Sample(SSAOSampler, samplePosition).x, AmbientOcclusionExponent); + + if (BlendMode == BLENDMODE_ALPHABLEND) + occlusion = lerp(occlusion, 1.0f, output.Color.w); } lighting = DoShadow(input.WorldPosition, normal, lighting, -2.5f); From 0128660f0747d8f15046fef5ca59784e5277388f Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sat, 12 Apr 2025 17:27:06 +0200 Subject: [PATCH 141/160] Change LDoc to properly format optional arguments and defaults --- Documentation/compiler/ldoc/ldoc/doc.lua | 15 +++++++-------- .../compiler/ldoc/ldoc/html/ldoc_ltp.lua | 6 +++--- Documentation/ldoc.ltp | 6 +++--- 3 files changed, 13 insertions(+), 14 deletions(-) diff --git a/Documentation/compiler/ldoc/ldoc/doc.lua b/Documentation/compiler/ldoc/ldoc/doc.lua index 30f8eafc5..52860ccba 100644 --- a/Documentation/compiler/ldoc/ldoc/doc.lua +++ b/Documentation/compiler/ldoc/ldoc/doc.lua @@ -868,20 +868,19 @@ function build_arg_list (names,pmods) local opt if m then if not m.optchain then - acc ((']'):rep(npending)) npending=0 end opt = m.optchain or m.opt - if opt then - acc('[') - npending=npending+1 - end end if i>1 then acc (', ') end - acc(names[i]) - if opt and opt ~= true then acc('='..opt) end + if opt then + acc('[' .. names[i]) + if opt ~= true then acc('='..opt) end + acc(']') + else + acc(names[i]) + end end - acc ((']'):rep(npending)) return '('..table.concat(buffer)..')' end diff --git a/Documentation/compiler/ldoc/ldoc/html/ldoc_ltp.lua b/Documentation/compiler/ldoc/ldoc/html/ldoc_ltp.lua index 31b09d72c..2efb79a43 100644 --- a/Documentation/compiler/ldoc/ldoc/html/ldoc_ltp.lua +++ b/Documentation/compiler/ldoc/ldoc/html/ldoc_ltp.lua @@ -215,12 +215,12 @@ return [==[ # end $(M(item.params.map[p],item)) # if def == true then - (optional) + (Optional.) # elseif def then - (default $(def)) + (Default. $(def)) # end # if item:readonly(p) then - readonly + Read-only. # end # end diff --git a/Documentation/ldoc.ltp b/Documentation/ldoc.ltp index 77472d077..5034016d4 100644 --- a/Documentation/ldoc.ltp +++ b/Documentation/ldoc.ltp @@ -216,12 +216,12 @@ # end $(M(item.params.map[p],item)) # if def == true then - (optional) + Optional. # elseif def then - (default $(def)) + Default: $(def). # end # if item:readonly(p) then - readonly + Read-only. # end # end From 73af37dbe15f194f50e828c8a5b6971da04a3cfb Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 13 Apr 2025 16:19:58 +0200 Subject: [PATCH 142/160] Fixed lensflare enabled status not saved in a savegame --- TombEngine/Game/savegame.cpp | 2 ++ .../flatbuffers/ten_savegame_generated.h | 30 ++++++++++++++----- .../Specific/savegame/schema/ten_savegame.fbs | 1 + 3 files changed, 25 insertions(+), 8 deletions(-) diff --git a/TombEngine/Game/savegame.cpp b/TombEngine/Game/savegame.cpp index 8f3f1394c..26b41d8ad 100644 --- a/TombEngine/Game/savegame.cpp +++ b/TombEngine/Game/savegame.cpp @@ -1143,6 +1143,7 @@ const std::vector SaveGame::Build() levelData.add_sky_layer_2_color(level->GetSkyLayerColor(1)); levelData.add_sky_layer_2_speed(level->GetSkyLayerSpeed(1)); + levelData.add_lensflare_enabled(level->LensFlare.GetEnabled()); levelData.add_lensflare_color(level->LensFlare.GetColor()); levelData.add_lensflare_pitch(level->LensFlare.GetPitch()); levelData.add_lensflare_yaw(level->LensFlare.GetYaw()); @@ -1844,6 +1845,7 @@ static void ParseLua(const Save::SaveGame* s, bool hubMode) level->Layer2.CloudSpeed = s->level_data()->sky_layer_2_speed(); level->Layer2.SetColor(s->level_data()->sky_layer_2_color()); + level->LensFlare.SetEnabled(s->level_data()->lensflare_enabled()); level->LensFlare.SetSunSpriteID(s->level_data()->lensflare_sprite_id()); level->LensFlare.SetPitch(s->level_data()->lensflare_pitch()); level->LensFlare.SetYaw(s->level_data()->lensflare_yaw()); diff --git a/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h b/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h index a99d79882..3c85b7494 100644 --- a/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h +++ b/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h @@ -571,6 +571,7 @@ struct LevelDataT : public flatbuffers::NativeTable { std::unique_ptr horizon2_position{}; std::unique_ptr horizon2_orientation{}; float horizon2_transparency = 0.0f; + bool lensflare_enabled = false; int32_t lensflare_sprite_id = 0; float lensflare_pitch = 0.0f; float lensflare_yaw = 0.0f; @@ -610,14 +611,15 @@ struct LevelData FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { VT_HORIZON2_POSITION = 46, VT_HORIZON2_ORIENTATION = 48, VT_HORIZON2_TRANSPARENCY = 50, - VT_LENSFLARE_SPRITE_ID = 52, - VT_LENSFLARE_PITCH = 54, - VT_LENSFLARE_YAW = 56, - VT_LENSFLARE_COLOR = 58, - VT_STARFIELD_STAR_COUNT = 60, - VT_STARFIELD_METEOR_COUNT = 62, - VT_STARFIELD_METEOR_SPAWN_DENSITY = 64, - VT_STARFIELD_METEOR_VELOCITY = 66 + VT_LENSFLARE_ENABLED = 52, + VT_LENSFLARE_SPRITE_ID = 54, + VT_LENSFLARE_PITCH = 56, + VT_LENSFLARE_YAW = 58, + VT_LENSFLARE_COLOR = 60, + VT_STARFIELD_STAR_COUNT = 62, + VT_STARFIELD_METEOR_COUNT = 64, + VT_STARFIELD_METEOR_SPAWN_DENSITY = 66, + VT_STARFIELD_METEOR_VELOCITY = 68 }; int32_t level_far_view() const { return GetField(VT_LEVEL_FAR_VIEW, 0); @@ -691,6 +693,9 @@ struct LevelData FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { float horizon2_transparency() const { return GetField(VT_HORIZON2_TRANSPARENCY, 0.0f); } + bool lensflare_enabled() const { + return GetField(VT_LENSFLARE_ENABLED, 0) != 0; + } int32_t lensflare_sprite_id() const { return GetField(VT_LENSFLARE_SPRITE_ID, 0); } @@ -741,6 +746,7 @@ struct LevelData FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { VerifyField(verifier, VT_HORIZON2_POSITION) && VerifyField(verifier, VT_HORIZON2_ORIENTATION) && VerifyField(verifier, VT_HORIZON2_TRANSPARENCY) && + VerifyField(verifier, VT_LENSFLARE_ENABLED) && VerifyField(verifier, VT_LENSFLARE_SPRITE_ID) && VerifyField(verifier, VT_LENSFLARE_PITCH) && VerifyField(verifier, VT_LENSFLARE_YAW) && @@ -832,6 +838,9 @@ struct LevelDataBuilder { void add_horizon2_transparency(float horizon2_transparency) { fbb_.AddElement(LevelData::VT_HORIZON2_TRANSPARENCY, horizon2_transparency, 0.0f); } + void add_lensflare_enabled(bool lensflare_enabled) { + fbb_.AddElement(LevelData::VT_LENSFLARE_ENABLED, static_cast(lensflare_enabled), 0); + } void add_lensflare_sprite_id(int32_t lensflare_sprite_id) { fbb_.AddElement(LevelData::VT_LENSFLARE_SPRITE_ID, lensflare_sprite_id, 0); } @@ -893,6 +902,7 @@ inline flatbuffers::Offset CreateLevelData( const TEN::Save::Vector3 *horizon2_position = 0, const TEN::Save::EulerAngles *horizon2_orientation = 0, float horizon2_transparency = 0.0f, + bool lensflare_enabled = false, int32_t lensflare_sprite_id = 0, float lensflare_pitch = 0.0f, float lensflare_yaw = 0.0f, @@ -928,6 +938,7 @@ inline flatbuffers::Offset CreateLevelData( builder_.add_weather_strength(weather_strength); builder_.add_weather_type(weather_type); builder_.add_level_far_view(level_far_view); + builder_.add_lensflare_enabled(lensflare_enabled); builder_.add_horizon2_enabled(horizon2_enabled); builder_.add_horizon1_enabled(horizon1_enabled); builder_.add_sky_layer_2_enabled(sky_layer_2_enabled); @@ -9260,6 +9271,7 @@ inline void LevelData::UnPackTo(LevelDataT *_o, const flatbuffers::resolver_func { auto _e = horizon2_position(); if (_e) _o->horizon2_position = std::unique_ptr(new TEN::Save::Vector3(*_e)); } { auto _e = horizon2_orientation(); if (_e) _o->horizon2_orientation = std::unique_ptr(new TEN::Save::EulerAngles(*_e)); } { auto _e = horizon2_transparency(); _o->horizon2_transparency = _e; } + { auto _e = lensflare_enabled(); _o->lensflare_enabled = _e; } { auto _e = lensflare_sprite_id(); _o->lensflare_sprite_id = _e; } { auto _e = lensflare_pitch(); _o->lensflare_pitch = _e; } { auto _e = lensflare_yaw(); _o->lensflare_yaw = _e; } @@ -9302,6 +9314,7 @@ inline flatbuffers::Offset CreateLevelData(flatbuffers::FlatBufferBui auto _horizon2_position = _o->horizon2_position ? _o->horizon2_position.get() : 0; auto _horizon2_orientation = _o->horizon2_orientation ? _o->horizon2_orientation.get() : 0; auto _horizon2_transparency = _o->horizon2_transparency; + auto _lensflare_enabled = _o->lensflare_enabled; auto _lensflare_sprite_id = _o->lensflare_sprite_id; auto _lensflare_pitch = _o->lensflare_pitch; auto _lensflare_yaw = _o->lensflare_yaw; @@ -9336,6 +9349,7 @@ inline flatbuffers::Offset CreateLevelData(flatbuffers::FlatBufferBui _horizon2_position, _horizon2_orientation, _horizon2_transparency, + _lensflare_enabled, _lensflare_sprite_id, _lensflare_pitch, _lensflare_yaw, diff --git a/TombEngine/Specific/savegame/schema/ten_savegame.fbs b/TombEngine/Specific/savegame/schema/ten_savegame.fbs index bc41d27be..11d988d99 100644 --- a/TombEngine/Specific/savegame/schema/ten_savegame.fbs +++ b/TombEngine/Specific/savegame/schema/ten_savegame.fbs @@ -38,6 +38,7 @@ table LevelData { horizon2_orientation: EulerAngles; horizon2_transparency: float; + lensflare_enabled: bool; lensflare_sprite_id: int32; lensflare_pitch: float; lensflare_yaw: float; From 0d604678339363e1a806ef0baeac9d131e6a1c7e Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 13 Apr 2025 16:22:41 +0200 Subject: [PATCH 143/160] Fixed script API documentation mistakes --- Documentation/doc/3 primitive classes/Flow.LensFlare.html | 4 ++-- Documentation/doc/3 primitive classes/Vec2.html | 2 +- .../Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp | 2 +- TombEngine/Scripting/Internal/TEN/Types/Vec2/Vec2.cpp | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/Documentation/doc/3 primitive classes/Flow.LensFlare.html b/Documentation/doc/3 primitive classes/Flow.LensFlare.html index 493f9432b..172afbfdf 100644 --- a/Documentation/doc/3 primitive classes/Flow.LensFlare.html +++ b/Documentation/doc/3 primitive classes/Flow.LensFlare.html @@ -127,7 +127,7 @@ - + @@ -178,7 +178,7 @@ spriteID
    - (Objects.ObjID.SpriteConstants) Lens flare's sun sprite object ID. + (int) Lens flare's sun sprite ID in DEFAULT_SPRITES sequence. diff --git a/Documentation/doc/3 primitive classes/Vec2.html b/Documentation/doc/3 primitive classes/Vec2.html index eb65b2271..4bedd88bf 100644 --- a/Documentation/doc/3 primitive classes/Vec2.html +++ b/Documentation/doc/3 primitive classes/Vec2.html @@ -354,7 +354,7 @@

    Parameters:

    • rot - Rotation + float Rotation in degrees defining the direction.
    • dist diff --git a/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp b/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp index 564b278ef..c46eb7429 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/LensFlare/LensFlare.cpp @@ -30,7 +30,7 @@ namespace TEN::Scripting // @mem enabled "enabled", sol::property(&LensFlare::GetEnabled, &LensFlare::SetEnabled), - /// (@{Objects.ObjID.SpriteConstants}) Lens flare's sun sprite object ID. + /// (int) Lens flare's sun sprite ID in DEFAULT_SPRITES sequence. // @mem spriteID "spriteID", sol::property(&LensFlare::GetSunSpriteID, &LensFlare::SetSunSpriteID), diff --git a/TombEngine/Scripting/Internal/TEN/Types/Vec2/Vec2.cpp b/TombEngine/Scripting/Internal/TEN/Types/Vec2/Vec2.cpp index 33b8caac9..1f728dcb0 100644 --- a/TombEngine/Scripting/Internal/TEN/Types/Vec2/Vec2.cpp +++ b/TombEngine/Scripting/Internal/TEN/Types/Vec2/Vec2.cpp @@ -107,7 +107,7 @@ Vec2 Vec2::Translate(const Vec2& dir, float dist) /// Get a copy of this Vec2 translated in the direction of the input rotation in degrees by the input distance. // @function Vec2:Translate -// @tparam Rotation rot Rotation in degrees defining the direction. +// @tparam float rot Rotation in degrees defining the direction. // @tparam float dist Distance. // @treturn Vec2 Translated vector. Vec2 Vec2::Translate(float rot, float dist) From 394e71cb2b9c8d732881cba5bafd512f993154d8 Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 13 Apr 2025 16:22:46 +0200 Subject: [PATCH 144/160] Update CHANGELOG.md --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 47356f0a8..5898fb6fe 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed crashes when shooting, if gunflash or gunshell objects are not present in a level. * Fixed Teleporter object. * Fixed Wraith objects not working correctly in flipped rooms. +* Fixed lensflare enabled status not saved in a savegame. * Fixed caustics not rendered correctly if texture compression was enabled. * Fixed exclusion blend mode not working correctly. * Fixed SSAO incorrectly applied through alpha blended textures. From 821a4e844eab648588e67eab9894ef261ec1339b Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 13 Apr 2025 16:26:51 +0200 Subject: [PATCH 145/160] Fixed ldoc incorrectly displaying optional parameters --- Documentation/compiler/ldoc/ldoc/doc.lua | 6 +- Documentation/doc/1 modules/Effects.html | 112 +++++++++--------- Documentation/doc/1 modules/Flow.html | 10 +- Documentation/doc/1 modules/Input.html | 7 +- Documentation/doc/1 modules/Inventory.html | 14 +-- Documentation/doc/1 modules/Sound.html | 6 +- Documentation/doc/1 modules/Util.html | 6 +- Documentation/doc/1 modules/View.html | 12 +- .../doc/2 classes/Collision.Probe.html | 6 +- .../doc/2 classes/Objects.Camera.html | 2 +- .../doc/2 classes/Objects.LaraObject.html | 2 +- .../doc/2 classes/Objects.Moveable.html | 36 +++--- .../doc/2 classes/Strings.DisplayString.html | 10 +- .../doc/2 classes/View.DisplaySprite.html | 18 +-- .../5 lua utility modules/EventSequence.html | 6 +- .../doc/5 lua utility modules/Timer.html | 12 +- .../Internal/TEN/Input/InputHandler.cpp | 4 +- 17 files changed, 134 insertions(+), 135 deletions(-) diff --git a/Documentation/compiler/ldoc/ldoc/doc.lua b/Documentation/compiler/ldoc/ldoc/doc.lua index 52860ccba..e0325f4dc 100644 --- a/Documentation/compiler/ldoc/ldoc/doc.lua +++ b/Documentation/compiler/ldoc/ldoc/doc.lua @@ -846,7 +846,7 @@ end function build_arg_list (names,pmods) -- build up the string representation of the argument list, -- using any opt and optchain modifiers if present. - -- For instance, '(a [, b])' if b is marked as optional + -- For instance, '(a, [b])' if b is marked as optional -- with @param[opt] b local buffer, npending = { }, 0 local function acc(x) table.insert(buffer, x) end @@ -874,9 +874,7 @@ function build_arg_list (names,pmods) end if i>1 then acc (', ') end if opt then - acc('[' .. names[i]) - if opt ~= true then acc('='..opt) end - acc(']') + acc('[' .. names[i] .. ']') else acc(names[i]) end diff --git a/Documentation/doc/1 modules/Effects.html b/Documentation/doc/1 modules/Effects.html index d8d58667e..b8726289c 100644 --- a/Documentation/doc/1 modules/Effects.html +++ b/Documentation/doc/1 modules/Effects.html @@ -140,11 +140,11 @@
    - + - + @@ -152,7 +152,7 @@ - + @@ -172,7 +172,7 @@ - +
    spriteID(Objects.ObjID.SpriteConstants) Lens flare's sun sprite object ID.(int) Lens flare's sun sprite ID in DEFAULT_SPRITES sequence.
    pitch Emit a shockwave, similar to that seen when a harpy projectile hits something.
    EmitLight(pos[, color][, radius][, shadows][, name])EmitLight(pos, [color], [radius], [shadows], [name]) Emit dynamic light that lasts for a single frame.
    EmitSpotLight(pos, dir[, color][, radius][, falloff][, distance][, shadows][, name])EmitSpotLight(pos, dir, [color], [radius], [falloff], [distance], [shadows], [name]) Emit dynamic directional spotlight that lasts for a single frame.
    Emit blood.
    EmitAirBubble(pos[, size][, amp])EmitAirBubble(pos, [size], [amp]) Emit an air bubble in a water room.
    Get the wind vector for the current game frame.
    EmitStreamer(mov, tag, pos, dir[, rot][, startColor][, endColor][, width][, life][, vel][, expRate][, rotRate][, edgeFeatherMode][, lengthFeatherMode][, blendID])EmitStreamer(mov, tag, pos, dir, [rot], [startColor], [endColor], [width], [life], [vel], [expRate], [rotRate], [edgeFeatherMode], [lengthFeatherMode], [blendID]) Emit an extending streamer effect.
    @@ -454,7 +454,7 @@ EmitAdvancedParticle(particle)
    - EmitLight(pos[, color][, radius][, shadows][, name]) + EmitLight(pos, [color], [radius], [shadows], [name])
    Emit dynamic light that lasts for a single frame. @@ -471,22 +471,22 @@ EmitAdvancedParticle(particle)
  • color Color light color (default Color(255, 255, 255)) - (optional) + Optional.
  • radius int measured in "clicks" or 256 world units (default 20) - (optional) + Optional.
  • shadows bool determines whether light should generate dynamic shadows for applicable moveables (default is false) - (optional) + Optional.
  • name string if provided, engine will interpolate this light for high framerate mode (be careful not to use same name for different lights) - (optional) + Optional.
    • @@ -497,7 +497,7 @@ EmitAdvancedParticle(particle)
    - EmitSpotLight(pos, dir[, color][, radius][, falloff][, distance][, shadows][, name]) + EmitSpotLight(pos, dir, [color], [radius], [falloff], [distance], [shadows], [name])
    Emit dynamic directional spotlight that lasts for a single frame. @@ -518,32 +518,32 @@ EmitAdvancedParticle(particle)
  • color Color (default Color(255, 255, 255)) - (optional) + Optional.
  • radius int overall radius at the endpoint of a light cone, measured in "clicks" or 256 world units (default 10) - (optional) + Optional.
  • falloff int radius, at which light starts to fade out, measured in "clicks" (default 5) - (optional) + Optional.
  • distance int distance, at which light cone fades out, measured in "clicks" (default 20) - (optional) + Optional.
  • shadows bool determines whether light should generate dynamic shadows for applicable moveables (default is false) - (optional) + Optional.
  • name string if provided, engine will interpolate this light for high framerate mode (be careful not to use same name for different lights) - (optional) + Optional.
    • @@ -582,7 +582,7 @@ EmitAdvancedParticle(particle)
    - EmitAirBubble(pos[, size][, amp]) + EmitAirBubble(pos, [size], [amp])
    Emit an air bubble in a water room. @@ -598,12 +598,12 @@ EmitAdvancedParticle(particle)
  • size float Sprite size. Default: 32 - (optional) + Optional.
  • amp float Oscillation amplitude. Default: 32 - (optional) + Optional.
    • @@ -718,7 +718,7 @@ EmitAdvancedParticle(particle)
    - EmitStreamer(mov, tag, pos, dir[, rot][, startColor][, endColor][, width][, life][, vel][, expRate][, rotRate][, edgeFeatherMode][, lengthFeatherMode][, blendID]) + EmitStreamer(mov, tag, pos, dir, [rot], [startColor], [endColor], [width], [life], [vel], [expRate], [rotRate], [edgeFeatherMode], [lengthFeatherMode], [blendID])
    Emit an extending streamer effect. @@ -746,57 +746,57 @@ EmitAdvancedParticle(particle)
  • rot float Start rotation in degrees. Default: 0 - (optional) + Optional.
  • startColor Color Color at the start of life. Default: Color(255, 255, 255, 255)) - (optional) + Optional.
  • endColor Color Color at the end of life. Default: Color(0, 0, 0, 0)) - (optional) + Optional.
  • width float Width in world units. Default: 0 - (optional) + Optional.
  • life float Lifetime in seconds. Default: 1 - (optional) + Optional.
  • vel float Movement velocity in world units per second. Default: 0 - (optional) + Optional.
  • expRate float Width expansion rate in world units per second. Default: 0 - (optional) + Optional.
  • rotRate float Rotation rate in degrees per second. Default: 0 - (optional) + Optional.
  • edgeFeatherMode StreamerFeatherMode Edge feather mode. Default: Effects.StreamerFeatherMode.NONE - (optional) + Optional.
  • lengthFeatherMode StreamerFeatherMode Length feather mode. UNIMPLEMENTED, currently will always leave a fading tail - (optional) + Optional.
  • blendID BlendID Renderer blend ID. Default: Effects.BlendID.ALPHA_BLEND - (optional) + Optional.
    • @@ -831,127 +831,127 @@ EmitAdvancedParticle(particle)
  • spriteSeqID SpriteConstants Sprite sequence slot ID. default: Objects.ObjID.DEFAULT_SPRITES - (optional) + Optional.
  • spriteID int Sprite ID in the sprite sequence slot. default: 0 - (optional) + Optional.
  • life float Lifespan in seconds. default: 2 - (optional) + Optional.
  • maxYVel float Maximum vertical velocity in world units per second. default: 0 - (optional) + Optional.
  • gravity float Effect of gravity in world units per second. Positive value ascend, negative value descend. default: 0 - (optional) + Optional.
  • friction float Friction affecting velocity over time in world units per second. default: 0 - (optional) + Optional.
  • startRot float Rotation at start of life. default: random - (optional) + Optional.
  • rotVel float Rotational velocity in degrees per second. default: 0 - (optional) + Optional.
  • startSize float Size at start of life. default: 10 - (optional) + Optional.
  • endSize float Size at end of life. default: 0 - (optional) + Optional.
  • startColor Color Color at start of life. default: Color(255, 255, 255) - (optional) + Optional.
  • endColor Color Color at end of life. Note that this will finish long before the end of life due to internal math. default: Color(255, 255, 255) - (optional) + Optional.
  • blendMode BlendID Render blend mode. default: TEN.Effects.BlendID.ALPHA_BLEND - (optional) + Optional.
  • damage bool Harm the player on collision. default: false - (optional) + Optional.
  • poison bool Poison the player on collision. default: false - (optional) + Optional.
  • burn bool Burn the player on collision. default: false - (optional) + Optional.
  • wind bool Affect position by wind in outside rooms. default: false - (optional) + Optional.
  • damageHit int Player damage amount on collision. default: 2 - (optional) + Optional.
  • light bool Emit a colored light. CAUTION: Recommended only for a single particle. Too many particles with lights can overwhelm the lighting system. default: false - (optional) + Optional.
  • lightRadius int Light radius in 1/4 blocks. default: 0 - (optional) + Optional.
  • lightFlicker int Interval at which the light should flicker. default: 0 - (optional) + Optional.
  • soundID int Sound ID to play. CAUTION: Recommended only for a single particle. Too many particles with sounds can overwhelm the sound system. default: none - (optional) + Optional.
  • animated bool Play animates sprite sequence. default: false - (optional) + Optional.
  • animType ParticleAnimationType Animation type of the sprite sequence. default: TEN.Effects.ParticleAnimationType.LOOP - (optional) + Optional.
  • frameRate float Sprite sequence animation framerate. default: 1 - (optional) + Optional.
    • diff --git a/Documentation/doc/1 modules/Flow.html b/Documentation/doc/1 modules/Flow.html index a8ae0a9b0..4a680cba5 100644 --- a/Documentation/doc/1 modules/Flow.html +++ b/Documentation/doc/1 modules/Flow.html @@ -175,7 +175,7 @@ scripts too.

    Returns the level that the game control is running in that moment. - EndLevel([index][, startPos]) + EndLevel([index], [startPos]) Finishes the current level, with optional level index and start position index provided. @@ -570,7 +570,7 @@ have an ID of 0, the second an ID of 1, and so on.
    - EndLevel([index][, startPos]) + EndLevel([index], [startPos])
    Finishes the current level, with optional level index and start position index provided. @@ -585,12 +585,12 @@ teleported to such object with OCB similar to provided second argument.
  • index int level index (default 0) - (optional) + Optional.
  • startPos int player start position (default 0) - (optional) + Optional.
    • @@ -959,7 +959,7 @@ Must be an integer value (0 means no secrets).
  • index int Flipmap group ID to check. If no group specified or group is -1, function returns overall flipmap status (on or off). - (optional) + Optional.
    • diff --git a/Documentation/doc/1 modules/Input.html b/Documentation/doc/1 modules/Input.html index c3439c75c..7cf9f7de0 100644 --- a/Documentation/doc/1 modules/Input.html +++ b/Documentation/doc/1 modules/Input.html @@ -124,7 +124,7 @@

    Functions

    - + @@ -162,7 +162,7 @@
    - Vibrate(strength, time) + Vibrate(strength, [time])
    Vibrate the game controller if the function is available and the setting is on. @@ -177,7 +177,8 @@
  • time float - (default 0.3) Vibration time in seconds. + Vibration time in seconds. + Default: 0.3.
    • diff --git a/Documentation/doc/1 modules/Inventory.html b/Documentation/doc/1 modules/Inventory.html index 45a377928..1c069126b 100644 --- a/Documentation/doc/1 modules/Inventory.html +++ b/Documentation/doc/1 modules/Inventory.html @@ -124,11 +124,11 @@

    Functions

    Vibrate(strength, time)Vibrate(strength, [time]) Vibrate the game controller if the function is available and the setting is on.
    - + - + @@ -162,7 +162,7 @@
    - GiveItem(objectID[, count][, addToPickupSummary]) + GiveItem(objectID, [count], [addToPickupSummary])
    Add an item to the player's inventory. @@ -178,12 +178,12 @@
  • count int The amount of items to add. Default is the yield from a single pickup, e.g. 1 from a medipack, 12 from a flare pack. - (optional) + Optional.
  • addToPickupSummary bool If true, display the item in the pickup summary. Default is false. - (optional) + Optional.
    • @@ -194,7 +194,7 @@
    - TakeItem(Object[, count]) + TakeItem(Object, [count])
    Remove an item from the player's inventory. @@ -210,7 +210,7 @@
  • count int The amount of items to remove. Default is the yield from a single pickup, e.g. 1 from a medipack, 12 from a flare pack. - (optional) + Optional.
    • diff --git a/Documentation/doc/1 modules/Sound.html b/Documentation/doc/1 modules/Sound.html index 6f1305b02..be07997d5 100644 --- a/Documentation/doc/1 modules/Sound.html +++ b/Documentation/doc/1 modules/Sound.html @@ -144,7 +144,7 @@
    - + @@ -291,7 +291,7 @@
    - PlaySound(soundID[, position]) + PlaySound(soundID, [position])
    Play sound effect. @@ -307,7 +307,7 @@
  • position Vec3 The 3D position of the sound, i.e. where the sound "comes from". If not given, the sound will not be positional. - (optional) + Optional.
    • diff --git a/Documentation/doc/1 modules/Util.html b/Documentation/doc/1 modules/Util.html index a9b7c3972..4981e18db 100644 --- a/Documentation/doc/1 modules/Util.html +++ b/Documentation/doc/1 modules/Util.html @@ -152,7 +152,7 @@
    - +
    GiveItem(objectID[, count][, addToPickupSummary])GiveItem(objectID, [count], [addToPickupSummary]) Add an item to the player's inventory.
    TakeItem(Object[, count])TakeItem(Object, [count]) Remove an item from the player's inventory.
    Get current loudness level for specified track type.
    PlaySound(soundID[, position])PlaySound(soundID, [position]) Play sound effect.
    Pick a static mesh by the given display position.
    PrintLog(message, logLevel[, allowSpam])PrintLog(message, logLevel, [allowSpam]) Write messages within the Log file
    @@ -414,7 +414,7 @@ To be used with - PrintLog(message, logLevel[, allowSpam]) + PrintLog(message, logLevel, [allowSpam])
    Write messages within the Log file @@ -439,7 +439,7 @@ To be used with allowSpam bool true allows spamming of the message - (optional) + Optional. diff --git a/Documentation/doc/1 modules/View.html b/Documentation/doc/1 modules/View.html index 557e35756..51c5b824e 100644 --- a/Documentation/doc/1 modules/View.html +++ b/Documentation/doc/1 modules/View.html @@ -176,11 +176,11 @@ Play a flyby sequence. - GetFlybyPosition(seqID, progress[, loop]) + GetFlybyPosition(seqID, progress, [loop]) Get a flyby sequence's position at a specified progress point in percent. - GetFlybyRotation(seqID, progress[, loop]) + GetFlybyRotation(seqID, progress, [loop]) Get a flyby sequence's rotation at a specified progress point in percent. @@ -499,7 +499,7 @@
    - GetFlybyPosition(seqID, progress[, loop]) + GetFlybyPosition(seqID, progress, [loop])
    Get a flyby sequence's position at a specified progress point in percent. @@ -519,7 +519,7 @@
  • loop bool Smooth the position near start and end points, as if the sequence is looped. - (optional) + Optional.
    • @@ -536,7 +536,7 @@
    - GetFlybyRotation(seqID, progress[, loop]) + GetFlybyRotation(seqID, progress, [loop])
    Get a flyby sequence's rotation at a specified progress point in percent. @@ -556,7 +556,7 @@
  • loop bool Smooth the position near start and end points, as if the sequence is looped. - (optional) + Optional.
    • diff --git a/Documentation/doc/2 classes/Collision.Probe.html b/Documentation/doc/2 classes/Collision.Probe.html index 19c7f4ec2..f10d87d34 100644 --- a/Documentation/doc/2 classes/Collision.Probe.html +++ b/Documentation/doc/2 classes/Collision.Probe.html @@ -122,7 +122,7 @@

    Functions

    - + @@ -220,7 +220,7 @@
    - Probe(pos[, roomNumber]) + Probe(pos, [roomNumber])
    Create a Probe at a specified world position in a room. @@ -236,7 +236,7 @@
  • roomNumber int Room number. Must be used if probing a position in an overlapping room. - (optional) + Optional.
    • diff --git a/Documentation/doc/2 classes/Objects.Camera.html b/Documentation/doc/2 classes/Objects.Camera.html index 630d1a44f..3ca2f2939 100644 --- a/Documentation/doc/2 classes/Objects.Camera.html +++ b/Documentation/doc/2 classes/Objects.Camera.html @@ -330,7 +330,7 @@
  • Target Moveable If you put a moveable, the camera will look at it. Otherwise, it will look at Lara. - (optional) + Optional.
    • diff --git a/Documentation/doc/2 classes/Objects.LaraObject.html b/Documentation/doc/2 classes/Objects.LaraObject.html index 41fefa5bc..7192dc620 100644 --- a/Documentation/doc/2 classes/Objects.LaraObject.html +++ b/Documentation/doc/2 classes/Objects.LaraObject.html @@ -229,7 +229,7 @@
  • poison int Poison strength. Maximum value is 128 (default 0) - (optional) + Optional.
    • diff --git a/Documentation/doc/2 classes/Objects.Moveable.html b/Documentation/doc/2 classes/Objects.Moveable.html index 45f4fa252..5810dedcc 100644 --- a/Documentation/doc/2 classes/Objects.Moveable.html +++ b/Documentation/doc/2 classes/Objects.Moveable.html @@ -166,13 +166,13 @@
    - + - + @@ -217,11 +217,11 @@ - + - + @@ -285,7 +285,7 @@ - + @@ -364,7 +364,7 @@ if it is not swapped. - + @@ -741,7 +741,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    - Moveable:SetPosition(position[, updateRoom]) + Moveable:SetPosition(position, [updateRoom])
    Set the moveable's position @@ -760,7 +760,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
  • updateRoom bool Will room changes be automatically detected? Set to false if you are using overlapping rooms (default: true) - (optional) + Optional.
    • @@ -771,7 +771,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    - Moveable:GetJointPosition(jointIndex[, offset]) + Moveable:GetJointPosition(jointIndex, [offset])
    Get the moveable's joint position with an optional relative offset. @@ -787,7 +787,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
  • offset Vec3 Offset relative to the joint. - (optional) + Optional.
    • @@ -1026,7 +1026,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    - Moveable:SetEffect(effect[, timeout]) + Moveable:SetEffect(effect, [timeout])
    Set the effect for this moveable. @@ -1042,7 +1042,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
  • timeout float time (in seconds) after which effect turns off. - (optional) + Optional.
    • @@ -1053,7 +1053,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    - Moveable:SetCustomEffect(color1, color2[, timeout]) + Moveable:SetCustomEffect(color1, color2, [timeout])
    Set custom colored burn effect to moveable @@ -1073,7 +1073,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
  • timeout float Time (in seconds) after which effect turns off. - (optional) + Optional.
    • @@ -1423,7 +1423,7 @@ sas:SetAIBits({1, 0,
    - Moveable:SetAnim(index[, slot]) + Moveable:SetAnim(index, [slot])
    Set the object's animation to the one specified by the given index. @@ -1441,7 +1441,7 @@ sas:SetAIBits({1, 0, slot int slot ID of the desired anim (if omitted, moveable's own slot ID is used) - (optional) + Optional. @@ -1857,7 +1857,7 @@ sas:SetPosition(newPos, false)
    - Moveable:SwapMesh(index, slotIndex[, swapIndex]) + Moveable:SwapMesh(index, slotIndex, [swapIndex])
    Set state of specified mesh swap of object @@ -1878,7 +1878,7 @@ sas:SetPosition(newPos, false)
  • swapIndex int index of a mesh from meshswap slot to use - (optional) + Optional.
    • diff --git a/Documentation/doc/2 classes/Strings.DisplayString.html b/Documentation/doc/2 classes/Strings.DisplayString.html index d4b209327..4f1088fad 100644 --- a/Documentation/doc/2 classes/Strings.DisplayString.html +++ b/Documentation/doc/2 classes/Strings.DisplayString.html @@ -129,7 +129,7 @@ when you need to use screen-space coordinates.

    Functions

    Probe(pos[, roomNumber])Probe(pos, [roomNumber]) Create a Probe at a specified world position in a room.
    Get the moveable's position
    Moveable:SetPosition(position[, updateRoom])Moveable:SetPosition(position, [updateRoom]) Set the moveable's position If you are moving a moveable whose behaviour involves knowledge of room geometry, (e.g.
    Moveable:GetJointPosition(jointIndex[, offset])Moveable:GetJointPosition(jointIndex, [offset]) Get the moveable's joint position with an optional relative offset.
    Set OCB (object code bit) of the moveable
    Moveable:SetEffect(effect[, timeout])Moveable:SetEffect(effect, [timeout]) Set the effect for this moveable.
    Moveable:SetCustomEffect(color1, color2[, timeout])Moveable:SetCustomEffect(color1, color2, [timeout]) Set custom colored burn effect to moveable
    Retrieve the index of the current animation.
    Moveable:SetAnim(index[, slot])Moveable:SetAnim(index, [slot]) Set the object's animation to the one specified by the given index.
    Moveable:SwapMesh(index, slotIndex[, swapIndex])Moveable:SwapMesh(index, slotIndex, [swapIndex]) Set state of specified mesh swap of object Use this to swap specified mesh of an object.
    - + @@ -183,7 +183,7 @@ when you need to use screen-space coordinates.

    - DisplayString(string, Position[, scale][, color][, translated], table) + DisplayString(string, Position, [scale], [color], [translated], table)
    Create a DisplayString. @@ -204,18 +204,18 @@ For use in ShowString and scale float size of the string, relative to the default size. Default: 1.0 - (optional) + Optional.
  • color Color the color of the text. Default: white - (optional) + Optional.
  • translated bool If false or omitted, the input string argument will be displayed. If true, the string argument will be the key of a translated string specified in strings.lua. Default: false. - (optional) + Optional.
  • table DisplayStringOption diff --git a/Documentation/doc/2 classes/View.DisplaySprite.html b/Documentation/doc/2 classes/View.DisplaySprite.html index f6f4917b7..2b097a9bb 100644 --- a/Documentation/doc/2 classes/View.DisplaySprite.html +++ b/Documentation/doc/2 classes/View.DisplaySprite.html @@ -124,7 +124,7 @@

    Functions

    • DisplayString(string, Position[, scale][, color][, translated], table)DisplayString(string, Position, [scale], [color], [translated], table) Create a DisplayString.
    - + @@ -176,7 +176,7 @@ - +
    DisplaySprite(ID, int, pos, rot, scale[, color])DisplaySprite(ID, int, pos, rot, scale, [color]) Create a DisplaySprite object.
    Set the color of the display sprite.
    DisplaySprite:Draw([priority][, alignMode][, scaleMode][, blendMode])DisplaySprite:Draw([priority], [alignMode], [scaleMode], [blendMode]) Draw the display sprite in display space for the current frame.
    @@ -190,7 +190,7 @@
    - DisplaySprite(ID, int, pos, rot, scale[, color]) + DisplaySprite(ID, int, pos, rot, scale, [color])
    Create a DisplaySprite object. () @@ -222,7 +222,7 @@
  • color Color Color. Default: Color(255, 255, 255, 255) - (optional) + Optional.
    • @@ -497,7 +497,7 @@
    - DisplaySprite:Draw([priority][, alignMode][, scaleMode][, blendMode]) + DisplaySprite:Draw([priority], [alignMode], [scaleMode], [blendMode])
    Draw the display sprite in display space for the current frame. @@ -509,22 +509,22 @@
  • priority int Draw priority. Can be thought of as a layer, with higher values having precedence. Default: 0 - (optional) + Optional.
  • alignMode AlignMode Align mode interpreting an offset from the sprite's position. Default: View.AlignMode.CENTER - (optional) + Optional.
  • scaleMode ScaleMode Scale mode interpreting the display sprite's horizontal and vertical scale. Default: View.ScaleMode.FIT - (optional) + Optional.
  • blendMode BlendID Blend mode. Default: Effects.BlendID.ALPHABLEND - (optional) + Optional.
    • diff --git a/Documentation/doc/5 lua utility modules/EventSequence.html b/Documentation/doc/5 lua utility modules/EventSequence.html index cea188d4f..e0557249c 100644 --- a/Documentation/doc/5 lua utility modules/EventSequence.html +++ b/Documentation/doc/5 lua utility modules/EventSequence.html @@ -168,7 +168,7 @@ LevelFuncs.SpawnBaddy = function(baddy, name, pos)

    Functions

    - + @@ -206,7 +206,7 @@ LevelFuncs.SpawnBaddy = function(baddy, name, pos)
    - Create(name, loop, timerFormat[, ...]) + Create(name, loop, timerFormat, [...])
    Create (but do not start) a new event sequence. @@ -229,7 +229,7 @@ LevelFuncs.SpawnBaddy = function(baddy, name, pos)
  • ... a variable number of pairs of arguments - a time in seconds, followed by the function (must be defined in the LevelFuncs table) to call once the time has elapsed, followed by another duration in seconds, another function name, etc. You can specify a function either by its name as a string, or by a table with the function name as the first member, followed by its arguments (see above example). - (optional) + Optional.
    • diff --git a/Documentation/doc/5 lua utility modules/Timer.html b/Documentation/doc/5 lua utility modules/Timer.html index 5cff92477..2bdecfa5e 100644 --- a/Documentation/doc/5 lua utility modules/Timer.html +++ b/Documentation/doc/5 lua utility modules/Timer.html @@ -152,7 +152,7 @@ LevelFuncs.TriggerTimer = function(obj)

    Functions

    Create(name, loop, timerFormat[, ...])Create(name, loop, timerFormat, [...]) Create (but do not start) a new event sequence.
    - + @@ -160,7 +160,7 @@ LevelFuncs.TriggerTimer = function(obj) - + @@ -214,7 +214,7 @@ LevelFuncs.TriggerTimer = function(obj)
    - Create(name, totalTime, loop, timerFormat, func[, ...]) + Create(name, totalTime, loop, timerFormat, func, [...])
    Create (but do not start) a new timer.

    @@ -267,7 +267,7 @@ LevelFuncs.TriggerTimer = function(obj)
  • ... a variable number of arguments with which the above function will be called - (optional) + Optional.
    • @@ -312,7 +312,7 @@ LevelFuncs.TriggerTimer = function(obj)
    - myTimer:SetFunction(func[, ...]) + myTimer:SetFunction(func, [...])
    Give the timer a new function and args @@ -327,7 +327,7 @@ LevelFuncs.TriggerTimer = function(obj)
  • ... a variable number of arguments with which the above function will be called - (optional) + Optional.
    • diff --git a/TombEngine/Scripting/Internal/TEN/Input/InputHandler.cpp b/TombEngine/Scripting/Internal/TEN/Input/InputHandler.cpp index 2352d3c35..f68607d88 100644 --- a/TombEngine/Scripting/Internal/TEN/Input/InputHandler.cpp +++ b/TombEngine/Scripting/Internal/TEN/Input/InputHandler.cpp @@ -19,8 +19,8 @@ namespace TEN::Scripting::Input { /// Vibrate the game controller if the function is available and the setting is on. // @function Vibrate - // @tparam float strength Vibration strength. - // @tparam float time __(default 0.3)__ Vibration time in seconds. + // @tparam float strength Vibration strength. + // @tparam[opt=0.3] float time Vibration time in seconds. static void Vibrate(float strength, sol::optional time) { Rumble(strength, time.value_or(0.3f), RumbleMode::Both); From ef9ba4a40dc2dd3395726eee32f2ca1e8997e46b Mon Sep 17 00:00:00 2001 From: Stranger1992 <84292688+Stranger1992@users.noreply.github.com> Date: Sun, 13 Apr 2025 21:02:49 +0100 Subject: [PATCH 146/160] Updated Diary docs --- Scripts/Engine/CustomDiary.lua | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Scripts/Engine/CustomDiary.lua b/Scripts/Engine/CustomDiary.lua index e62e2424d..20b029c37 100644 --- a/Scripts/Engine/CustomDiary.lua +++ b/Scripts/Engine/CustomDiary.lua @@ -531,9 +531,9 @@ end -- @tparam Objects.ObjID objectIdBg Object ID for the diary's sprite. -- @tparam int spriteIdBg SpriteID from the specified object for the diary's sprite. -- @tparam Color colorBg Color of diary's sprite. --- @tparam Vec2 pos X,Y position of the bar's background in screen percent (0-100). +-- @tparam Vec2 pos X,Y position of the diary background sprite in screen percent (0-100). -- @tparam float rot rotation of the diary's sprite (0-360). --- @tparam Vec2 scale X,Y Scaling factor for the bar's background sprite. +-- @tparam Vec2 scale X,Y Scaling factor for the diary background sprite. -- @tparam View.AlignMode alignMode Alignment for the diary's sprite. -- @tparam View.ScaleMode scaleMode Scaling for the diary's sprite. -- @tparam Effects.BlendID blendMode Blending modes for the diary's sprite. From ae7e38a9da26a181d9ce90fb8edc48dba85cce6d Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Fri, 18 Apr 2025 12:16:46 +0200 Subject: [PATCH 147/160] Update license --- LICENSE | 23 +++++++++++++++-------- README.md | 2 +- 2 files changed, 16 insertions(+), 9 deletions(-) diff --git a/LICENSE b/LICENSE index 350616db7..1010c5693 100644 --- a/LICENSE +++ b/LICENSE @@ -1,16 +1,23 @@ -MIT License +Modified MIT License (for non-commercial use only) Copyright (c) 2025 TombEngine Team Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: +of this software and associated documentation files (the “Software”), to use, +copy, modify, merge, publish, and distribute copies of the Software, and to +permit persons to whom the Software is furnished to do so, for non-commercial +purposes only, subject to the following conditions: -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. +1. Commercial use of the Software — including, but not limited to, selling, +renting, leasing, or using it in a product or service for which you receive +compensation (monetary or otherwise) — is strictly prohibited. + +2. The Software may be combined with proprietary or closed-source third-party +components, provided those components are available for non-commercial use, +and the resulting product is not used for commercial purposes. + +3. The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, diff --git a/README.md b/README.md index c5e824255..cbc224c3e 100644 --- a/README.md +++ b/README.md @@ -38,5 +38,5 @@ Once done, you should be able to build a level with *Tomb Editor* and run it in Contributions are welcome. If you would like to participate in development to any degree, whether that be through suggestions, bug reports, or code, join our [Discord server](https://discord.gg/h5tUYFmres). # Disclaimer -This community project is unaffiliated with Core Design, Eidos Interactive, or Embracer Group AB. *Tomb Raider* is a registered trademark of Embracer Group AB. *Tomb Engine* is not for sale. The code is open-source to encourage contributions and for study purposes. We are not responsible for illegal uses of this source code. This source code is released as-is and continues to be maintained by non-paid contributors in their free time. +Tomb Engine uses modified MIT license for non-commercial use only. For more information, see [license](LICENSE). Tomb Engine is unaffiliated with Core Design, Eidos Interactive, or Embracer Group AB. *Tomb Raider* is a registered trademark of Embracer Group AB. Tomb Engine source code is open to encourage contributions and for study purposes. Tomb Engine team is not responsible for illegal use of this source code alone or in combination with third-party assets or components. This source code is released as-is and continues to be maintained by non-paid contributors in their free time. From 4e9a3b62b998b53d2f5f160ea252ecaed188671f Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Fri, 18 Apr 2025 12:20:25 +0200 Subject: [PATCH 148/160] Fix merge conflicts, additional legal cleanup --- AUTHORS.md | 4 ++-- TombEngine/Objects/game_object_ids.h | 2 +- TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h | 6 +++--- TombEngine/version.h | 2 +- 4 files changed, 7 insertions(+), 7 deletions(-) diff --git a/AUTHORS.md b/AUTHORS.md index d74b91990..d25ba84fa 100644 --- a/AUTHORS.md +++ b/AUTHORS.md @@ -6,7 +6,7 @@ This is the credit list of **all** the people who contributed to TombEngine in a - MontyTRC (Project Leader) -- Gancian (general coding +- Gancian (general coding) - Krystian (general coding) - Kubsy (Some cleanups and fixes) - l.m. (general coding, Lua enhancements, bug fixing) @@ -17,7 +17,7 @@ This is the credit list of **all** the people who contributed to TombEngine in a - Sezz (player state refactoring, general coding, code cleanups, bug fixing, assets) - Squidshire (Hispidence) (Lua implementation, bug fixing) - Stranger1992 (sound asset refactoring and organisation, assets) -- TrainWreck (asset coding and Lua enhancements +- TrainWreck (asset coding and Lua enhancements) - TokyoSU (entity and vehicle decompilation) - Tomo (general coding, special FX coding, bug fixing) - Troye (general coding, refactoring) diff --git a/TombEngine/Objects/game_object_ids.h b/TombEngine/Objects/game_object_ids.h index 18c64a25b..a70404f76 100644 --- a/TombEngine/Objects/game_object_ids.h +++ b/TombEngine/Objects/game_object_ids.h @@ -746,7 +746,7 @@ enum GAME_OBJECT_ID : short ID_INVENTORY_SUNGLASSES, ID_INVENTORY_KEYS, ID_INVENTORY_HEADPHONES, - ID_INVENTORY_POLAROID, + ID_INVENTORY_PHOTO, ID_SMOKE_EMITTER_WHITE = 1020, ID_SMOKE_EMITTER_BLACK, diff --git a/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h b/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h index 04e5732a8..f7dbb1a31 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h +++ b/TombEngine/Scripting/Internal/TEN/Objects/ObjectIDs.h @@ -1,7 +1,7 @@ #pragma once // This file is generated automatically, do not edit it. -// Last generated on 17/03/2025. +// Last generated on 18/04/2025. #include #include @@ -746,7 +746,7 @@ The following constants are inside ObjID. INVENTORY_SUNGLASSES INVENTORY_KEYS INVENTORY_HEADPHONES - INVENTORY_POLAROID + INVENTORY_PHOTO SMOKE_EMITTER_WHITE SMOKE_EMITTER_BLACK SMOKE_EMITTER @@ -1986,7 +1986,7 @@ static const std::unordered_map GAME_OBJECT_IDS { { "INVENTORY_SUNGLASSES", ID_INVENTORY_SUNGLASSES }, { "INVENTORY_KEYS", ID_INVENTORY_KEYS }, { "INVENTORY_HEADPHONES", ID_INVENTORY_HEADPHONES }, - { "INVENTORY_POLAROID", ID_INVENTORY_POLAROID }, + { "INVENTORY_PHOTO", ID_INVENTORY_PHOTO }, { "SMOKE_EMITTER_WHITE", ID_SMOKE_EMITTER_WHITE }, { "SMOKE_EMITTER_BLACK", ID_SMOKE_EMITTER_BLACK }, { "SMOKE_EMITTER", ID_SMOKE_EMITTER }, diff --git a/TombEngine/version.h b/TombEngine/version.h index fd0d8bd9b..a7bbed0aa 100644 --- a/TombEngine/version.h +++ b/TombEngine/version.h @@ -5,7 +5,7 @@ #define TEN_BUILD_NUMBER 2 #define TEN_REVISION_NUMBER 0 -#define TEST_BUILD 0 +#define TEST_BUILD 1 #define TOSTR(x) #x #define MAKE_VERSION_STRING(major, minor, build, revision) TOSTR(major) "." TOSTR(minor) "." TOSTR(build) "." TOSTR(revision) From 299509dd47f25bf140695fd02bafbaf453ad87dd Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 20 Apr 2025 07:21:07 +0200 Subject: [PATCH 149/160] Correct default revolver muzzle offset --- TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp index cb65ca8d7..9db67dc64 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp @@ -26,7 +26,7 @@ namespace TEN::Scripting // NOTE: Since Weapons array is bound to Lua directly and Lua accesses this array by native enum, where 0 is NONE, and 1 is PISTOLS, // 0 index is omitted due to Lua indexing arrays starting from 1. 1 must be subtracted from initializer index. Weapons[(int)LaraWeaponType::Pistol - 1] = { 8.0f, BLOCK(8), 9, (int)BLOCK(0.65f), 1, 1, 30, ScriptColor(192, 128, 0), 9, 3, true, true, true, true, false, Vec3( 0, 120, 30) }; - Weapons[(int)LaraWeaponType::Revolver - 1] = { 4.0f, BLOCK(8), 16, (int)BLOCK(0.65f), 21, 21, 6, ScriptColor(192, 128, 0), 9, 3, true, false, true, true, false, Vec3(-10, 130, 45) }; + Weapons[(int)LaraWeaponType::Revolver - 1] = { 4.0f, BLOCK(8), 16, (int)BLOCK(0.65f), 21, 21, 6, ScriptColor(192, 128, 0), 9, 3, true, false, true, true, false, Vec3(-10, 130, 65) }; Weapons[(int)LaraWeaponType::Uzi - 1] = { 8.0f, BLOCK(8), 3, (int)BLOCK(0.65f), 1, 1, 30, ScriptColor(192, 128, 0), 9, 2, true, true, true, true, false, Vec3( 0, 110, 40) }; Weapons[(int)LaraWeaponType::Shotgun - 1] = { 10.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 3, 3, 6, ScriptColor(192, 128, 0), 12, 3, true, true, false, false, false, Vec3( 0, 210, 42) }; Weapons[(int)LaraWeaponType::HK - 1] = { 4.0f, BLOCK(12), 0, (int)BLOCK(0.50f), 4, 4, 30, ScriptColor(192, 128, 0), 12, 2, true, true, true, true, false, Vec3( 0, 220, 102) }; From 387f8a9ae1b2fdbe96d492dcac61d0b9ee3336c2 Mon Sep 17 00:00:00 2001 From: TrainWrack <120750885+TrainWrack@users.noreply.github.com> Date: Sun, 20 Apr 2025 14:55:35 -0400 Subject: [PATCH 150/160] Expose player object interaction (#1617) * First * WIP * WIP * Move function to Lara. Add optional key input. * Cleanup references * Finished * Update CHANGELOG.md * Cleanup * ExposeTestPosition * Update LaraObject.cpp * Update Lua moveable interaction functions * Fix offset and constraint box * Update interaction function names; tidy up doc comments * Restore newline * Two things * Use const references * Damagic * Floats * Move action to end * Docs update * Update CHANGELOG.md --------- Co-authored-by: Sezz --- CHANGELOG.md | 3 + .../Scripting/Internal/ReservedScriptNames.h | 6 +- .../Internal/TEN/Objects/Lara/LaraObject.cpp | 250 +++++++++++++----- .../Internal/TEN/Objects/Lara/LaraObject.h | 15 +- 4 files changed, 204 insertions(+), 70 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 5898fb6fe..2ea93e749 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -22,6 +22,9 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added `muzzleGlow` and `muzzleOffset` parameters to weapon settings. * Fixed `Moveable.GetJointPosition` not returning correct results if moveable is invisible or not rendered. +### Lua API changes +* Added Interact function to `Lara` to allow alignment with moveables. + ## [Version 1.8.1](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.8.1) - 2025-03-29 ### Bug fixes diff --git a/TombEngine/Scripting/Internal/ReservedScriptNames.h b/TombEngine/Scripting/Internal/ReservedScriptNames.h index c21c3f3e3..3789116fa 100644 --- a/TombEngine/Scripting/Internal/ReservedScriptNames.h +++ b/TombEngine/Scripting/Internal/ReservedScriptNames.h @@ -361,15 +361,17 @@ static constexpr char ScriptReserved_ResetObjCamera[] = "ResetObjCamera"; static constexpr char ScriptReserved_UndrawWeapon[] = "UndrawWeapon"; static constexpr char ScriptReserved_GetHandStatus[] = "GetHandStatus"; static constexpr char ScriptReserved_GetWeaponType[] = "GetWeaponType"; -static constexpr char ScriptReserved_ThrowAwayTorch[] = "ThrowAwayTorch"; +static constexpr char ScriptReserved_PlayerDiscardTorch[] = "DiscardTorch"; static constexpr char ScriptReserved_SetWeaponType[] = "SetWeaponType"; -static constexpr char ScriptReserved_TorchIsLit[] = "TorchIsLit"; +static constexpr char ScriptReserved_PlayerIsTorchLit[] = "IsTorchLit"; static constexpr char ScriptReserved_PrintLog[] = "PrintLog"; static constexpr char ScriptReserved_PickMoveable[] = "PickMoveableByDisplayPosition"; static constexpr char ScriptReserved_PickStatic[] = "PickStaticByDisplayPosition"; static constexpr char ScriptReserved_GetDisplayPosition[] = "GetDisplayPosition"; static constexpr char ScriptReserved_GetCursorDisplayPosition[] = "GetCursorDisplayPosition"; // Deprecated static constexpr char ScriptReserved_GetMouseDisplayPosition[] = "GetMouseDisplayPosition"; +static constexpr char ScriptReserved_PlayerInteract[] = "Interact"; +static constexpr char ScriptReserved_PlayerTestInteraction[] = "TestInteraction"; // Tables static constexpr char ScriptReserved_ObjID[] = "ObjID"; diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp index 01516a829..087e6f10c 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp +++ b/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp @@ -2,6 +2,7 @@ #include "LaraObject.h" #include "Game/camera.h" +#include "Game/collision/collide_item.h" #include "Game/effects/item_fx.h" #include "Game/Lara/lara.h" #include "Game/Lara/lara_fire.h" @@ -9,10 +10,18 @@ #include "Game/Lara/lara_struct.h" #include "Objects/Generic/Object/burning_torch.h" #include "Scripting/Internal/ReservedScriptNames.h" +#include "Scripting/Internal/TEN/Input/ActionIDs.h" #include "Scripting/Internal/TEN/Objects/Lara/AmmoTypes.h" +#include "Scripting/Internal/TEN/Types/Color/Color.h" +#include "Scripting/Internal/TEN/Types/Rotation/Rotation.h" +#include "Scripting/Internal/TEN/Types/Vec3/Vec3.h" +#include "Specific/Input/Input.h" +#include "Specific/Input/InputAction.h" #include "Specific/level.h" -/// Class for extra player-only functions. +using namespace TEN::Input; + +/// Class for player-only functions. // Do not try to create an object of this type. Use the built-in *Lara* variable instead. // LaraObject inherits all the functions of @{Objects.Moveable|Moveable}. // @@ -22,9 +31,9 @@ constexpr auto LUA_CLASS_NAME{ ScriptReserved_LaraObject }; using namespace TEN::Entities::Generic; -/// Set player poison. +/// Set the player's poison value. // @function LaraObject:SetPoison -// @tparam[opt] int poison Poison strength. Maximum value is 128 (default 0) +// @tparam[opt] int poison New poison value. __default: 0, max: 128__ // @usage // Lara:SetPoison(10) void LaraObject::SetPoison(sol::optional potency) @@ -41,9 +50,9 @@ void LaraObject::SetPoison(sol::optional potency) } } -/// Get poison potency of Lara. +/// Get the player's poison value. // @function LaraObject:GetPoison -// @treturn int Current poison potency. +// @treturn int Poison value. // @usage // local poisonPotency = Lara:GetPoison() int LaraObject::GetPoison() const @@ -52,9 +61,9 @@ int LaraObject::GetPoison() const return lara->Status.Poison; } -/// Set air value of Lara. +/// Set the player's air value. // @function LaraObject:SetAir -// @tparam int air Air value to give Lara. Maximum value is 1800. +// @tparam int air New air value. __max: 1800__ // @usage // Lara:SetAir(100) void LaraObject::SetAir(sol::optional air) @@ -67,9 +76,9 @@ void LaraObject::SetAir(sol::optional air) lara->Status.Air = LARA_AIR_MAX; } -/// Get air value of Lara. +/// Get the player's air value. // @function LaraObject:GetAir -// @treturn int Current air value. +// @treturn int Air value. // @usage // local currentAir = Lara:GetAir() int LaraObject::GetAir() const @@ -78,9 +87,9 @@ int LaraObject::GetAir() const return lara->Status.Air; } -/// Set wetness value of Lara (causes dripping). +/// Set the player's wetness value, causing drips. // @function LaraObject:SetWet -// @tparam int wetness Wetness value. Maximum value is 255. +// @tparam int wetness New wetness value. __max: 255__ // @usage // Lara:SetWet(100) void LaraObject::SetWet(sol::optional wetness) @@ -92,9 +101,9 @@ void LaraObject::SetWet(sol::optional wetness) i = value; } -/// Get wetness value of Lara. +/// Get the player's wetness value. // @function LaraObject:GetWet -// @treturn int Current wetness value. +// @treturn int Wetness value. // @usage // local dripAmount = Lara:GetWet() int LaraObject::GetWet() const @@ -103,9 +112,9 @@ int LaraObject::GetWet() const return lara->Effect.DripNodes[0]; } -/// Set sprint energy value of Lara. +/// Set the player's stamina value. // @function LaraObject:SetStamina -// @tparam int stamina Stamina to give to Lara. Maximum value is 120. +// @tparam int New stamina value. __max: 120__ // @usage // Lara:SetStamina(120) void LaraObject::SetStamina(sol::optional value) @@ -113,14 +122,18 @@ void LaraObject::SetStamina(sol::optional value) auto* lara = GetLaraInfo(_moveable); if (value.has_value()) + { lara->Status.Stamina = std::clamp(value.value(), 0, (int)LARA_STAMINA_MAX); + } else + { lara->Status.Stamina = LARA_STAMINA_MAX; + } } -/// Get stamina value of Lara. +/// Get the player's stamina value. // @function LaraObject:GetStamina -// @treturn int Current sprint value. +// @treturn int Stamina value. // @usage // local sprintEnergy = Lara:GetStamina() int LaraObject::GetStamina() const @@ -129,23 +142,23 @@ int LaraObject::GetStamina() const return lara->Status.Stamina; } -/// Get the moveable's airborne status. +/// Get the player's airborne status (set when jumping and falling). // @function Moveable:GetAirborne -// @treturn bool True if Lara state must react to aerial forces. +// @treturn bool True if airborne, otherwise false. bool LaraObject::GetAirborne() const { return _moveable->Animation.IsAirborne; } -/// Set the moveable's airborne status. +/// Set the player's airborne status. // @function Moveable:SetAirborne -// @tparam bool airborne New airborne status for Lara. +// @tparam bool airborne New airborne status. void LaraObject::SetAirborne(bool newAirborne) { _moveable->Animation.IsAirborne = newAirborne; } -/// Lara will undraw her weapon if it is drawn and throw away a flare if she is currently holding one. +/// Undraw a weapon if it is drawn and throw away a flare if currently holding one. // @function LaraObject:UndrawWeapon // @usage // Lara:UndrawWeapon() @@ -160,32 +173,30 @@ void LaraObject::UndrawWeapon() } } -/// Lara will throw away the torch if she currently holds one in her hand. -// @function LaraObject:ThrowAwayTorch +/// Discard a held torch. +// @function LaraObject:DiscardTorch // @usage -// Lara:ThrowAwayTorch() -void LaraObject::ThrowAwayTorch() +// Lara:DiscardTorch() +void LaraObject::DiscardTorch() { - auto* lara = GetLaraInfo(_moveable); + auto& player = GetLaraInfo(*_moveable); - if (lara->Control.Weapon.GunType == LaraWeaponType::Torch) - { - Lara.Torch.State = TorchState::Dropping; - } + if (player.Control.Weapon.GunType == LaraWeaponType::Torch) + player.Torch.State = TorchState::Dropping; } -/// Get actual hand status of Lara. +/// Get the player's hand status. // @function LaraObject:GetHandStatus // @usage // local handStatus = Lara:GetHandStatus() -// @treturn Objects.HandStatus Current hand status. +// @treturn Objects.HandStatus Hand status. HandStatus LaraObject::GetHandStatus() const { auto* lara = GetLaraInfo(_moveable); return HandStatus{ lara->Control.HandStatus }; } -/// Get actual weapon type of Lara. +/// Get the player's weapon type. // @function LaraObject:GetWeaponType // @usage // local weaponType = Lara:GetWeaponType() @@ -196,7 +207,7 @@ LaraWeaponType LaraObject::GetWeaponType() const return LaraWeaponType{ lara->Control.Weapon.GunType }; } -/// Set Lara weapon type. +/// Set the player's weapon type. // @function LaraObject:SetWeaponType // @usage // Lara:SetWeaponType(WeaponType.PISTOLS, false) @@ -377,41 +388,148 @@ std::unique_ptr LaraObject::GetPlayerInteractedMoveable() const return std::make_unique(player.Context.InteractedItem); } -/// Get current light state of the torch, if it exists -// @function LaraObject:TorchIsLit -// @treturn bool is torch currently lit or not? (false if no torch exists) +/// Check if a held torch is lit. +// @function LaraObject:IsTorchLit +// @treturn bool True if lit, otherwise false. // @usage -// local torchIsLit = Lara:TorchIsLit() -bool LaraObject::TorchIsLit() const +// local isTorchLit = Lara:IsTorchLit() +bool LaraObject::IsTorchLit() const { - auto* lara = GetLaraInfo(_moveable); - return lara->Torch.IsLit; + const auto& player = GetLaraInfo(*_moveable); + return player.Torch.IsLit; +} + +/// Align the player with a moveable object for interaction. +// @function LaraObject:Interact +// @tparam Moveable mov Moveable object to align the player with. +// @tparam[opt=197 (BUTTON_PUSH)] int animNumber The animation to play after alignment is complete. +// @tparam[opt=Vec3(0, 0, 312)] Vec3 offset Relative position offset from the moveable. +// @tparam[opt=Vec3(-256, -512, 0)] Vec3 minOffsetConstraint Minimum relative offset constraint. +// @tparam[opt=Vec3(256, 0, 512)] Vec3 maxOffsetConstraint Maximum relative offset constraint. +// @tparam[opt=Rotation(-10, -40, -10)] Rotation minRotConstraint Minimum relative rotation constraint. +// @tparam[opt=Rotation(10, 40, 10)] Rotation maxRotConstraint Maximum relative rotation constraint. +// @tparam[opt=Input.ActionID.ACTION] Input.ActionID actionID Input action ID to trigger the alignment. +// @usage +// local Lara:Interact( +// moveable, 197, +// Vec3(0, 0, 312), Vec3(-256, -512, -256), Vec3(256, 0, 512), +// Rotation(-10, -30, -10), Rotation(10, 30, 10), TEN.Input.ActionID.ACTION) +void LaraObject::Interact(const Moveable& mov, TypeOrNil animNumber, + const TypeOrNil& offset, const TypeOrNil& offsetConstraintMin, const TypeOrNil& offsetConstraintMax, + const TypeOrNil& rotConstraintMin, const TypeOrNil& rotConstraintMax, TypeOrNil actionID) const +{ + auto convertedOffset = ValueOr(offset, Vec3(0.0f, 0.0f, BLOCK(0.305f))).ToVector3i(); + auto convertedOffsetConstraintMin = ValueOr(offsetConstraintMin, Vec3(-BLOCK(0.25f), -BLOCK(0.5f), 0.0f)); + auto convertedOffsetConstraintMax = ValueOr(offsetConstraintMax, Vec3(BLOCK(0.25f), 0.0f, BLOCK(0.5f))); + auto convertedRotConstraintMin = ValueOr(rotConstraintMin, Rotation(-10.0f, -40.0f, -10.0f)).ToEulerAngles(); + auto convertedRotConstraintMax = ValueOr(rotConstraintMax, Rotation(10.0f, 40.0f, 10.0f)).ToEulerAngles(); + int convertedAnimNumber = ValueOr(animNumber, LA_BUTTON_SMALL_PUSH); + auto convertedActionID = ValueOr(actionID, In::Action); + + auto interactionBasis = ObjectCollisionBounds + { + GameBoundingBox( + convertedOffsetConstraintMin.x, convertedOffsetConstraintMax.x, + convertedOffsetConstraintMin.y, convertedOffsetConstraintMax.y, + convertedOffsetConstraintMin.z, convertedOffsetConstraintMax.z), + std::pair( + convertedRotConstraintMin, + convertedRotConstraintMax) + }; + + auto& player = GetLaraInfo(*_moveable); + auto& interactedItem = g_Level.Items[mov.GetIndex()]; + + bool isUnderwater = (player.Control.WaterStatus == WaterStatus::Underwater); + bool isPlayerIdle = ((!isUnderwater && _moveable->Animation.ActiveState == LS_IDLE && _moveable->Animation.AnimNumber == LA_STAND_IDLE) || + (isUnderwater && _moveable->Animation.ActiveState == LS_UNDERWATER_IDLE && _moveable->Animation.AnimNumber == LA_UNDERWATER_IDLE)); + + if ((player.Control.IsMoving && player.Context.InteractedItem == interactedItem.Index) || + (IsHeld(convertedActionID) && player.Control.HandStatus == HandStatus::Free && isPlayerIdle)) + { + if (TestLaraPosition(interactionBasis, &interactedItem, _moveable)) + { + if (MoveLaraPosition(convertedOffset, &interactedItem, _moveable)) + { + ResetPlayerFlex(_moveable); + SetAnimation(_moveable, convertedAnimNumber); + + _moveable->Animation.FrameNumber = GetAnimData(_moveable).frameBase; + player.Control.IsMoving = false; + player.Control.HandStatus = HandStatus::Busy; + } + else + { + player.Context.InteractedItem = interactedItem.Index; + } + } + } +} + +/// Test the player against a moveable object for interaction. +// @function LaraObject:TestInteraction +// @tparam Moveable mov Moveable object to align the player with. +// @tparam[opt=Vec3(-256, -512, 0)] Vec3 minOffsetConstraint Minimum relative offset constraint. +// @tparam[opt=Vec3(256, 0, 512)] Vec3 maxOffsetConstraint Maximum relative offset constraint. +// @tparam[opt=Rotation(-10, -40, -10)] Rotation minRotConstraint Minimum relative rotation constraint. +// @tparam[opt=Rotation(10, 40, 10)] Rotation maxRotConstraint Maximum relative rotation constraint. +bool LaraObject::TestInteraction(const Moveable& mov, + const TypeOrNil& offsetConstraintMin, const TypeOrNil& offsetConstraintMax, + const TypeOrNil& rotConstraintMin, const TypeOrNil& rotConstraintMax) const +{ + auto convertedOffsetConstraintMin = ValueOr(offsetConstraintMin, Vec3(-BLOCK(0.25f), -BLOCK(0.5f), 0)); + auto convertedOffsetConstraintMax = ValueOr(offsetConstraintMax, Vec3(BLOCK(0.25f), 0, BLOCK(0.5f))); + auto convertedRotConstraintMin = ValueOr(rotConstraintMin, Rotation(-10.0f, -40.0f, -10.0f)).ToEulerAngles(); + auto convertedRotConstraintMax = ValueOr(rotConstraintMax, Rotation(10.0f, 40.0f, 10.0f)).ToEulerAngles(); + + auto interactionBasis = ObjectCollisionBounds + { + GameBoundingBox( + convertedOffsetConstraintMin.x, convertedOffsetConstraintMax.x, + convertedOffsetConstraintMin.y, convertedOffsetConstraintMax.y, + convertedOffsetConstraintMin.z, convertedOffsetConstraintMax.z), + std::pair( + convertedRotConstraintMin, + convertedRotConstraintMax) + }; + + auto& item = g_Level.Items[mov.GetIndex()]; + return (TestLaraPosition(interactionBasis, &item, _moveable)); } void LaraObject::Register(sol::table& parent) { - parent.new_usertype(LUA_CLASS_NAME, - ScriptReserved_SetPoison, &LaraObject::SetPoison, - ScriptReserved_GetPoison, &LaraObject::GetPoison, - ScriptReserved_SetAir, &LaraObject::SetAir, - ScriptReserved_GetAir, &LaraObject::GetAir, - ScriptReserved_SetWet, &LaraObject::SetWet, - ScriptReserved_GetWet, &LaraObject::GetWet, - ScriptReserved_SetStamina, &LaraObject::SetStamina, - ScriptReserved_GetStamina, &LaraObject::GetStamina, - ScriptReserved_GetAirborne, &LaraObject::GetAirborne, - ScriptReserved_SetAirborne, &LaraObject::SetAirborne, - ScriptReserved_UndrawWeapon, &LaraObject::UndrawWeapon, - ScriptReserved_ThrowAwayTorch, &LaraObject::ThrowAwayTorch, - ScriptReserved_GetHandStatus, &LaraObject::GetHandStatus, - ScriptReserved_GetWeaponType, &LaraObject::GetWeaponType, - ScriptReserved_SetWeaponType, &LaraObject::SetWeaponType, - ScriptReserved_GetAmmoType, &LaraObject::GetAmmoType, - ScriptReserved_GetAmmoCount, &LaraObject::GetAmmoCount, - ScriptReserved_GetVehicle, &LaraObject::GetVehicle, - ScriptReserved_GetTarget, &LaraObject::GetTarget, - ScriptReserved_GetPlayerInteractedMoveable, &LaraObject::GetPlayerInteractedMoveable, - ScriptReserved_TorchIsLit, &LaraObject::TorchIsLit, - sol::base_classes, sol::bases() - ); + parent.new_usertype( + LUA_CLASS_NAME, + + ScriptReserved_SetPoison, &LaraObject::SetPoison, + ScriptReserved_GetPoison, &LaraObject::GetPoison, + ScriptReserved_SetAir, &LaraObject::SetAir, + ScriptReserved_GetAir, &LaraObject::GetAir, + ScriptReserved_SetWet, &LaraObject::SetWet, + ScriptReserved_GetWet, &LaraObject::GetWet, + ScriptReserved_SetStamina, &LaraObject::SetStamina, + ScriptReserved_GetStamina, &LaraObject::GetStamina, + ScriptReserved_GetAirborne, &LaraObject::GetAirborne, + ScriptReserved_SetAirborne, &LaraObject::SetAirborne, + ScriptReserved_UndrawWeapon, &LaraObject::UndrawWeapon, + ScriptReserved_PlayerDiscardTorch, &LaraObject::DiscardTorch, + ScriptReserved_GetHandStatus, &LaraObject::GetHandStatus, + ScriptReserved_GetWeaponType, &LaraObject::GetWeaponType, + ScriptReserved_SetWeaponType, &LaraObject::SetWeaponType, + ScriptReserved_GetAmmoType, &LaraObject::GetAmmoType, + ScriptReserved_GetAmmoCount, &LaraObject::GetAmmoCount, + ScriptReserved_GetVehicle, &LaraObject::GetVehicle, + ScriptReserved_GetTarget, &LaraObject::GetTarget, + ScriptReserved_GetPlayerInteractedMoveable, &LaraObject::GetPlayerInteractedMoveable, + ScriptReserved_PlayerIsTorchLit, &LaraObject::IsTorchLit, + + ScriptReserved_PlayerInteract, &LaraObject::Interact, + ScriptReserved_PlayerTestInteraction, &LaraObject::TestInteraction, + + // COMPATIBILITY + "TorchIsLit", &LaraObject::IsTorchLit, + "ThrowAwayTorch", &LaraObject::DiscardTorch, + + sol::base_classes, sol::bases()); } diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.h b/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.h index 4b519bece..4ab00914e 100644 --- a/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.h +++ b/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.h @@ -1,6 +1,7 @@ #pragma once #include "Game/Lara/lara_struct.h" +#include "Scripting/Internal/TEN/Input/ActionIDs.h" #include "Scripting/Internal/TEN/Objects/Moveable/MoveableObject.h" // TODO: Organise. @@ -19,6 +20,7 @@ public: int GetWet() const; bool GetAirborne() const; void SetAirborne(bool newAirborne); + std::unique_ptr GetVehicle() const; std::unique_ptr GetTarget() const; std::unique_ptr GetPlayerInteractedMoveable() const; @@ -27,8 +29,17 @@ public: void SetWeaponType(LaraWeaponType weaponType, bool activate); int GetAmmoType() const; int GetAmmoCount() const; + void UndrawWeapon(); - void ThrowAwayTorch(); - bool TorchIsLit() const; + void DiscardTorch(); + bool IsTorchLit() const; + + void Interact(const Moveable& mov, TypeOrNil animNumber, + const TypeOrNil& offset, const TypeOrNil& offsetConstraintMin, const TypeOrNil& offsetConstraintMax, + const TypeOrNil& rotConstraintMin, const TypeOrNil& rotConstraintMax, TypeOrNil actionID) const; + bool TestInteraction(const Moveable& mov, + const TypeOrNil& offsetConstraintMin, const TypeOrNil& offsetConstraintMax, + const TypeOrNil& rotConstraintMin, const TypeOrNil& rotConstraintMax) const; + using Moveable::Moveable; }; From 9b6bf198bbbb9168c580dd76a56b335669ba17cc Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 20 Apr 2025 21:59:23 +0300 Subject: [PATCH 151/160] Gunflashes for all weapons (#1631) * Initial commit * Update CHANGELOG.md * Remove duplicate field --- CHANGELOG.md | 4 +- .../doc/2 classes/Flow.Settings.html | 16 +-- TombEngine/Game/Lara/lara_fire.cpp | 1 - TombEngine/Game/Lara/lara_one_gun.cpp | 112 +++++++-------- TombEngine/Game/Lara/lara_one_gun.h | 11 +- TombEngine/Game/Lara/lara_struct.h | 1 - TombEngine/Game/control/los.cpp | 1 - TombEngine/Game/savegame.cpp | 2 - TombEngine/Renderer/RendererDrawEffect.cpp | 134 +++++++++--------- .../Internal/TEN/Flow/Settings/Settings.cpp | 34 ++--- .../flatbuffers/ten_savegame_generated.h | 32 ++--- .../Specific/savegame/schema/ten_savegame.fbs | 1 - 12 files changed, 163 insertions(+), 186 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 2ea93e749..273123e04 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,14 +12,16 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Fixed lensflare enabled status not saved in a savegame. * Fixed caustics not rendered correctly if texture compression was enabled. * Fixed exclusion blend mode not working correctly. -* Fixed SSAO incorrectly applied through alpha blended textures. +* Fixed HK shots not being registered in statistics. * Fixed HK sound effects. +* Fixed SSAO incorrectly applied through alpha blended textures. ### New features * Added muzzle glow effect for firearms. ### Lua API changes * Added `muzzleGlow` and `muzzleOffset` parameters to weapon settings. +* Added ability to use gunflash parameters for all weapons in weapon settings. * Fixed `Moveable.GetJointPosition` not returning correct results if moveable is invisible or not rendered. ### Lua API changes diff --git a/Documentation/doc/2 classes/Flow.Settings.html b/Documentation/doc/2 classes/Flow.Settings.html index c59098a2a..1c4f98914 100644 --- a/Documentation/doc/2 classes/Flow.Settings.html +++ b/Documentation/doc/2 classes/Flow.Settings.html @@ -1109,7 +1109,7 @@
    • flashColor Color - specifies the color of the gunflash. Applicable only for firearms. + specifies the color of the gunflash.
    @@ -1130,7 +1130,7 @@
    • flashRange Color - specifies the range of the gunflash. Applicable only for firearms. + specifies the range of the gunflash.
    @@ -1151,7 +1151,7 @@
    • flashDuration int - specifies the duration of a gunflash effect. Applicable only for firearms. + specifies the duration of a gunflash effect.
    @@ -1172,7 +1172,7 @@
    • smoke bool - if set to true, indicates that weapon emits gun smoke. Not applicable for crossbow and harpoon gun. + if set to true, indicates that weapon emits gun smoke.
    @@ -1214,7 +1214,7 @@
    • muzzleFlash bool - specifies whether muzzle flash should be displayed or not. Applicable only for firearms. + specifies whether muzzle flash should be displayed or not.
    @@ -1235,7 +1235,7 @@
    • muzzleGlow bool - specifies whether muzzle glow should be displayed or not. Applicable only for firearms. + specifies whether muzzle glow should be displayed or not.
    @@ -1256,7 +1256,7 @@
    • colorizeMuzzleFlash bool - specifies whether muzzle flash should be tinted with the same color as gunflash color. Applicable only for firearms. + specifies whether muzzle flash should be tinted with the same color as gunflash color.
    @@ -1277,7 +1277,7 @@
    • muzzleOffset Vec3 - specifies offset for spawning muzzle gunflash effects. Applicable only for firearms. + specifies offset for spawning muzzle gunflash effects.
    diff --git a/TombEngine/Game/Lara/lara_fire.cpp b/TombEngine/Game/Lara/lara_fire.cpp index 2e4597bb1..2ab074e1e 100644 --- a/TombEngine/Game/Lara/lara_fire.cpp +++ b/TombEngine/Game/Lara/lara_fire.cpp @@ -871,7 +871,6 @@ FireWeaponType FireWeapon(LaraWeaponType weaponType, ItemInfo* targetEntity, Ite auto ray = Ray(origin, directionNorm); player.Control.Weapon.HasFired = true; - player.Control.Weapon.Fired = true; auto vOrigin = GameVector(pos); short roomNumber = laraItem.RoomNumber; diff --git a/TombEngine/Game/Lara/lara_one_gun.cpp b/TombEngine/Game/Lara/lara_one_gun.cpp index 3dcefb301..ede45b080 100644 --- a/TombEngine/Game/Lara/lara_one_gun.cpp +++ b/TombEngine/Game/Lara/lara_one_gun.cpp @@ -94,6 +94,8 @@ void AnimateShotgun(ItemInfo& laraItem, LaraWeaponType weaponType) player.Control.Weapon.Timer = 0.0f; } + bool hasFired = false; + switch (item.Animation.ActiveState) { case WEAPON_STATE_AIM: @@ -168,11 +170,11 @@ void AnimateShotgun(ItemInfo& laraItem, LaraWeaponType weaponType) switch (weaponType) { default: - FireShotgun(laraItem); + hasFired = FireShotgun(laraItem); break; case LaraWeaponType::HarpoonGun: - FireHarpoon(laraItem); + hasFired = FireHarpoon(laraItem); if (!(player.Weapons[(int)LaraWeaponType::HarpoonGun].Ammo->GetCount() % 4) && !player.Weapons[(int)weaponType].Ammo->HasInfinite()) @@ -183,15 +185,15 @@ void AnimateShotgun(ItemInfo& laraItem, LaraWeaponType weaponType) break; case LaraWeaponType::RocketLauncher: - FireRocket(laraItem); + hasFired = FireRocket(laraItem); break; case LaraWeaponType::GrenadeLauncher: - FireGrenade(laraItem); + hasFired = FireGrenade(laraItem); break; case LaraWeaponType::Crossbow: - FireCrossbow(laraItem); + hasFired = FireCrossbow(laraItem); break; case LaraWeaponType::HK: @@ -203,7 +205,7 @@ void AnimateShotgun(ItemInfo& laraItem, LaraWeaponType weaponType) } else { - FireHK(laraItem, false); + hasFired = FireHK(laraItem, false); player.Control.Weapon.Timer = 1.0f; item.Animation.TargetState = WEAPON_STATE_RECOIL; @@ -264,7 +266,7 @@ void AnimateShotgun(ItemInfo& laraItem, LaraWeaponType weaponType) break; case LaraWeaponType::HarpoonGun: - FireHarpoon(laraItem); + hasFired = FireHarpoon(laraItem); if (!(player.Weapons[(int)LaraWeaponType::HarpoonGun].Ammo->GetCount() % 4) && !player.Weapons[(int)weaponType].Ammo->HasInfinite()) @@ -276,14 +278,14 @@ void AnimateShotgun(ItemInfo& laraItem, LaraWeaponType weaponType) case LaraWeaponType::HK: if ((weapon.WeaponMode == LaraWeaponTypeCarried::WTYPE_AMMO_2 || - weapon.WeaponMode == LaraWeaponTypeCarried::WTYPE_AMMO_3) && + weapon.WeaponMode == LaraWeaponTypeCarried::WTYPE_AMMO_3) && player.Control.Weapon.Interval != 0.0f) { item.Animation.TargetState = WEAPON_STATE_UNDERWATER_AIM; } else { - FireHK(laraItem, true); + hasFired = FireHK(laraItem, true); player.Control.Weapon.Timer = 1.0f; item.Animation.TargetState = WEAPON_STATE_UNDERWATER_RECOIL; @@ -322,6 +324,18 @@ void AnimateShotgun(ItemInfo& laraItem, LaraWeaponType weaponType) break; } + if (hasFired) + { + player.Control.Weapon.HasFired = true; + + player.RightArm.GunFlash = Weapons[(int)weaponType].FlashTime; + if (weaponType != LaraWeaponType::GrenadeLauncher && weaponType != LaraWeaponType::RocketLauncher) + player.LeftArm.GunSmoke = 20; + + SaveGame::Statistics.Level.AmmoUsed++; + SaveGame::Statistics.Game.AmmoUsed++; + } + item.Pose.Position = laraItem.Pose.Position; item.RoomNumber = laraItem.RoomNumber; @@ -348,13 +362,13 @@ void ReadyShotgun(ItemInfo& laraItem, LaraWeaponType weaponType) player.RightArm.FrameBase = Objects[GetWeaponObjectID(weaponType)].frameBase; } -void FireShotgun(ItemInfo& laraItem) +bool FireShotgun(ItemInfo& laraItem) { auto& player = *GetLaraInfo(&laraItem); auto& ammo = GetAmmo(player, LaraWeaponType::Shotgun); if (!ammo.HasInfinite() && !ammo.GetCount()) - return; + return false; auto armOrient = EulerAngles( player.LeftArm.Orientation.x, @@ -393,8 +407,6 @@ void FireShotgun(ItemInfo& laraItem) auto pos = GetJointPosition(&laraItem, LM_RHAND, offset + Vector3::UnitY * CLICK(2)); auto pos2 = GetJointPosition(&laraItem, LM_RHAND, offset); - player.LeftArm.GunSmoke = 32; - if (laraItem.MeshBits != 0) { for (int i = 0; i < 7; i++) @@ -406,16 +418,13 @@ void FireShotgun(ItemInfo& laraItem) } } - player.RightArm.GunFlash = Weapons[(int)LaraWeaponType::Shotgun].FlashTime; - SoundEffect(SFX_TR4_EXPLOSION1, &laraItem.Pose, TestEnvironment(ENV_FLAG_WATER, &laraItem) ? SoundEnvironment::Underwater : SoundEnvironment::Land); SoundEffect(Weapons[(int)LaraWeaponType::Shotgun].SampleNum, &laraItem.Pose); Rumble(0.5f, 0.2f); - - SaveGame::Statistics.Level.AmmoUsed++; - SaveGame::Statistics.Game.AmmoUsed++; } + + return hasFired; } void DrawShotgun(ItemInfo& laraItem, LaraWeaponType weaponType) @@ -552,8 +561,6 @@ bool FireHarpoon(ItemInfo& laraItem, const std::optional& pose) if (!ammo) return false; - player.Control.Weapon.HasFired = true; - int itemNumber = CreateItem(); if (itemNumber == NO_VALUE) return false; @@ -608,14 +615,10 @@ bool FireHarpoon(ItemInfo& laraItem, const std::optional& pose) harpoonItem.HitPoints = HARPOON_TIME; AddActiveItem(itemNumber); - harpoonItem.ItemFlags[0] = (int)ProjectileType::Harpoon; Rumble(0.2f, 0.1f); - SaveGame::Statistics.Level.AmmoUsed++; - SaveGame::Statistics.Game.AmmoUsed++; - return true; } @@ -652,19 +655,17 @@ void HarpoonBoltControl(short itemNumber) HandleProjectile(harpoonItem, *LaraItem, prevPos, (ProjectileType)harpoonItem.ItemFlags[0], damage); } -void FireGrenade(ItemInfo& laraItem) +bool FireGrenade(ItemInfo& laraItem) { auto& player = *GetLaraInfo(&laraItem); auto& ammo = GetAmmo(player, LaraWeaponType::GrenadeLauncher); if (!ammo) - return; - - player.Control.Weapon.HasFired = true; + return false; short itemNumber = CreateItem(); if (itemNumber == NO_VALUE) - return; + return false; auto& grenadeItem = g_Level.Items[itemNumber]; @@ -743,8 +744,7 @@ void FireGrenade(ItemInfo& laraItem) break; } - SaveGame::Statistics.Level.AmmoUsed++; - SaveGame::Statistics.Game.AmmoUsed++; + return true; } void GrenadeControl(short itemNumber) @@ -835,19 +835,17 @@ void GrenadeControl(short itemNumber) HandleProjectile(grenadeItem, *LaraItem, prevPos, (ProjectileType)grenadeItem.ItemFlags[0], Weapons[(int)LaraWeaponType::GrenadeLauncher].Damage); } -void FireRocket(ItemInfo& laraItem) +bool FireRocket(ItemInfo& laraItem) { auto& player = *GetLaraInfo(&laraItem); auto& ammo = GetAmmo(player, LaraWeaponType::RocketLauncher); if (!ammo) - return; - - player.Control.Weapon.HasFired = true; + return false; short itemNumber = CreateItem(); if (itemNumber == NO_VALUE) - return; + return false; auto& rocketItem = g_Level.Items[itemNumber]; rocketItem.ObjectNumber = ID_ROCKET; @@ -905,8 +903,7 @@ void FireRocket(ItemInfo& laraItem) Rumble(0.4f, 0.3f); SoundEffect(SFX_TR4_EXPLOSION1, &laraItem.Pose); - SaveGame::Statistics.Level.AmmoUsed++; - SaveGame::Statistics.Game.AmmoUsed++; + return true; } void RocketControl(short itemNumber) @@ -974,19 +971,17 @@ void RocketControl(short itemNumber) HandleProjectile(rocketItem, *LaraItem, prevPos, ProjectileType::Explosive, Weapons[(int)LaraWeaponType::RocketLauncher].Damage); } -void FireCrossbow(ItemInfo& laraItem, const std::optional& pose) +bool FireCrossbow(ItemInfo& laraItem, const std::optional& pose) { auto& player = *GetLaraInfo(&laraItem); auto& ammo = GetAmmo(player, LaraWeaponType::Crossbow); if (!ammo) - return; - - player.Control.Weapon.HasFired = true; + return false; short itemNumber = CreateItem(); if (itemNumber == NO_VALUE) - return; + return false; auto& boltItem = g_Level.Items[itemNumber]; boltItem.ObjectNumber = ID_CROSSBOW_BOLT; @@ -1059,8 +1054,7 @@ void FireCrossbow(ItemInfo& laraItem, const std::optional& pose) Rumble(0.2f, 0.1f); SoundEffect(SFX_TR4_CROSSBOW_FIRE, &laraItem.Pose); - SaveGame::Statistics.Level.AmmoUsed++; - SaveGame::Statistics.Game.AmmoUsed++; + return true; } void FireCrossBowFromLaserSight(ItemInfo& laraItem, GameVector* origin, GameVector* target) @@ -1092,7 +1086,7 @@ void CrossbowBoltControl(short itemNumber) HandleProjectile(boltItem, *LaraItem, prevPos, (ProjectileType)boltItem.ItemFlags[0], damage); } -void FireHK(ItemInfo& laraItem, bool inaccurateMode) +bool FireHK(ItemInfo& laraItem, bool inaccurateMode) { auto& player = *GetLaraInfo(&laraItem); const auto& weapon = player.Weapons[(int)LaraWeaponType::HK]; @@ -1134,19 +1128,19 @@ void FireHK(ItemInfo& laraItem, bool inaccurateMode) Weapons[(int)LaraWeaponType::HK].Damage = damage / 3; } - if (FireWeapon(LaraWeaponType::HK, player.TargetEntity, laraItem, angles) != FireWeaponType::NoAmmo) + bool hasFired = FireWeapon(LaraWeaponType::HK, player.TargetEntity, laraItem, angles) != FireWeaponType::NoAmmo; + + if (hasFired) { - player.LeftArm.GunSmoke = 12; - TriggerGunShell(1, ID_GUNSHELL, LaraWeaponType::HK); - player.RightArm.GunFlash = Weapons[(int)LaraWeaponType::HK].FlashTime; - Rumble(0.2f, 0.1f); } // HACK: Restore accuracy/damage values. Weapons[(int)LaraWeaponType::HK].ShotAccuracy = accuracy; Weapons[(int)LaraWeaponType::HK].Damage = damage; + + return hasFired; } void LasersightWeaponHandler(ItemInfo& item, LaraWeaponType weaponType) @@ -1195,6 +1189,9 @@ void LasersightWeaponHandler(ItemInfo& item, LaraWeaponType weaponType) } else if (player.Control.Weapon.GunType == LaraWeaponType::HK) { + SaveGame::Statistics.Level.AmmoUsed++; + SaveGame::Statistics.Game.AmmoUsed++; + bool playSound = false; if (weapon.WeaponMode == LaraWeaponTypeCarried::WTYPE_AMMO_3) @@ -1283,16 +1280,17 @@ void RifleHandler(ItemInfo& laraItem, LaraWeaponType weaponType) auto color = Color(settings.FlashColor); color += Color(Random::GenerateFloat(-0.2f, 0.2f)); - if (weaponType == LaraWeaponType::Shotgun || weaponType == LaraWeaponType::HK) - { - auto pos = GetJointPosition(&laraItem, LM_RHAND, Vector3i(0, -64, 0)); - SpawnDynamicPointLight(pos.ToVector3(), color, CLICK(settings.FlashRange)); - } - else if (weaponType == LaraWeaponType::Revolver) + if (weaponType == LaraWeaponType::Revolver) { auto pos = GetJointPosition(&laraItem, LM_RHAND, Vector3i(0, -32, 0)); SpawnDynamicPointLight(pos.ToVector3(), color, CLICK(settings.FlashRange)); } + else + { + auto pos = GetJointPosition(&laraItem, LM_RHAND, Vector3i(0, -64, 0)); + SpawnDynamicPointLight(pos.ToVector3(), color, CLICK(settings.FlashRange)); + } + } } diff --git a/TombEngine/Game/Lara/lara_one_gun.h b/TombEngine/Game/Lara/lara_one_gun.h index 17495531e..24cf906b8 100644 --- a/TombEngine/Game/Lara/lara_one_gun.h +++ b/TombEngine/Game/Lara/lara_one_gun.h @@ -28,7 +28,7 @@ enum class ProjectileType void AnimateShotgun(ItemInfo& laraItem, LaraWeaponType weaponType); void ReadyShotgun(ItemInfo& laraItem, LaraWeaponType weaponType); -void FireShotgun(ItemInfo& laraItem); +bool FireShotgun(ItemInfo& laraItem); void DrawShotgun(ItemInfo& laraItem, LaraWeaponType weaponType); void UndrawShotgun(ItemInfo& laraItem, LaraWeaponType weaponType); void DrawShotgunMeshes(ItemInfo& laraItem, LaraWeaponType weaponType); @@ -36,16 +36,15 @@ void UndrawShotgunMeshes(ItemInfo& laraItem, LaraWeaponType weaponType); bool FireHarpoon(ItemInfo& laraItem, const std::optional& pose = std::nullopt); void HarpoonBoltControl(short itemNumber); -void FireGrenade(ItemInfo& laraItem); +bool FireGrenade(ItemInfo& laraItem); void GrenadeControl(short itemNumber); -void FireRocket(ItemInfo& laraItem); -void FireRocket(ItemInfo& laraItem); +bool FireRocket(ItemInfo& laraItem); void RocketControl(short itemNumber); -void FireCrossbow(ItemInfo& laraItem, const std::optional& pose = std::nullopt); +bool FireCrossbow(ItemInfo& laraItem, const std::optional& pose = std::nullopt); void FireCrossBowFromLaserSight(ItemInfo& laraItem, GameVector* origin, GameVector* target); void CrossbowBoltControl(short itemNumber); -void FireHK(ItemInfo& laraItem, bool inaccurateMode); +bool FireHK(ItemInfo& laraItem, bool inaccurateMode); void RifleHandler(ItemInfo& laraItem, LaraWeaponType weaponType); void LasersightWeaponHandler(ItemInfo& item, LaraWeaponType weaponType); diff --git a/TombEngine/Game/Lara/lara_struct.h b/TombEngine/Game/Lara/lara_struct.h index 075b2f78e..b0d6bb61d 100644 --- a/TombEngine/Game/Lara/lara_struct.h +++ b/TombEngine/Game/Lara/lara_struct.h @@ -1218,7 +1218,6 @@ struct WeaponControlData short WeaponItem = -1; bool HasFired = false; - bool Fired = false; bool UziLeft = false; bool UziRight = false; diff --git a/TombEngine/Game/control/los.cpp b/TombEngine/Game/control/los.cpp index 3f1c0b2ab..37d371827 100644 --- a/TombEngine/Game/control/los.cpp +++ b/TombEngine/Game/control/los.cpp @@ -261,7 +261,6 @@ bool GetTargetOnLOS(GameVector* origin, GameVector* target, bool drawTarget, boo if (isFiring && Lara.Control.Look.IsUsingLasersight) { Lara.Control.Weapon.HasFired = true; - Lara.Control.Weapon.Fired = true; Lara.RightArm.GunFlash = Weapons[(int)Lara.Control.Weapon.GunType].FlashTime; if (Lara.Control.Weapon.GunType == LaraWeaponType::Revolver) diff --git a/TombEngine/Game/savegame.cpp b/TombEngine/Game/savegame.cpp index 26b41d8ad..493d262da 100644 --- a/TombEngine/Game/savegame.cpp +++ b/TombEngine/Game/savegame.cpp @@ -472,7 +472,6 @@ const std::vector SaveGame::Build() Save::WeaponControlDataBuilder weaponControl{ fbb }; weaponControl.add_weapon_item(Lara.Control.Weapon.WeaponItem); weaponControl.add_has_fired(Lara.Control.Weapon.HasFired); - weaponControl.add_fired(Lara.Control.Weapon.Fired); weaponControl.add_uzi_left(Lara.Control.Weapon.UziLeft); weaponControl.add_uzi_right(Lara.Control.Weapon.UziRight); weaponControl.add_gun_type((int)Lara.Control.Weapon.GunType); @@ -2122,7 +2121,6 @@ static void ParsePlayer(const Save::SaveGame* s) Lara.Control.Weapon.GunType = (LaraWeaponType)s->lara()->control()->weapon()->gun_type(); Lara.Control.Weapon.HasFired = s->lara()->control()->weapon()->has_fired(); Lara.Control.Weapon.Interval = s->lara()->control()->weapon()->interval(); - Lara.Control.Weapon.Fired = s->lara()->control()->weapon()->fired(); Lara.Control.Weapon.LastGunType = (LaraWeaponType)s->lara()->control()->weapon()->last_gun_type(); Lara.Control.Weapon.RequestGunType = (LaraWeaponType)s->lara()->control()->weapon()->request_gun_type(); Lara.Control.Weapon.HolsterInfo.BackHolster = (HolsterSlot)s->lara()->control()->weapon()->holster_info()->back_holster(); diff --git a/TombEngine/Renderer/RendererDrawEffect.cpp b/TombEngine/Renderer/RendererDrawEffect.cpp index ce6ed8034..275cb92b0 100644 --- a/TombEngine/Renderer/RendererDrawEffect.cpp +++ b/TombEngine/Renderer/RendererDrawEffect.cpp @@ -1081,92 +1081,90 @@ namespace TEN::Renderer if (Lara.Control.Look.OpticRange > 0 && _currentMirror == nullptr) return false; + if (Lara.Control.Weapon.GunType == LaraWeaponType::Flare) + return false; + const auto& settings = g_GameFlow->GetSettings()->Weapons[(int)Lara.Control.Weapon.GunType - 1]; if (!settings.MuzzleFlash) return false; - if (Lara.Control.Weapon.GunType != LaraWeaponType::Flare && - Lara.Control.Weapon.GunType != LaraWeaponType::Crossbow) + // Use MP5 flash if available. + auto gunflash = GAME_OBJECT_ID::ID_GUN_FLASH; + if (Lara.Control.Weapon.GunType == LaraWeaponType::HK && Objects[GAME_OBJECT_ID::ID_GUN_FLASH2].loaded) + gunflash = GAME_OBJECT_ID::ID_GUN_FLASH2; + + if (!_moveableObjects[gunflash].has_value()) + return false; + + const auto& flashMoveable = *_moveableObjects[gunflash]; + const auto& flashMesh = *flashMoveable.ObjectMeshes[0]; + + _shaders.Bind(Shader::Statics); + + unsigned int stride = sizeof(Vertex); + unsigned int offset = 0; + + _context->IASetVertexBuffers(0, 1, _moveablesVertexBuffer.Buffer.GetAddressOf(), &stride, &offset); + _context->IASetPrimitiveTopology(D3D11_PRIMITIVE_TOPOLOGY_TRIANGLELIST); + _context->IASetIndexBuffer(_moveablesIndexBuffer.Buffer.Get(), DXGI_FORMAT_R32_UINT, 0); + + const auto& room = _rooms[LaraItem->RoomNumber]; + auto* itemPtr = &_items[LaraItem->Index]; + + // Divide gunflash tint by 2 because tinting uses multiplication and additive color which doesn't look good with overbright color values. + _stStatic.Color = settings.ColorizeMuzzleFlash ? ((Vector4)settings.FlashColor / 2) : Vector4::One; + _stStatic.AmbientLight = room.AmbientLight; + _stStatic.LightMode = (int)LightMode::Static; + BindStaticLights(itemPtr->LightsToDraw); + + SetAlphaTest(AlphaTestMode::GreatherThan, ALPHA_TEST_THRESHOLD); + SetBlendMode(BlendMode::Additive); + + for (const auto& flashBucket : flashMesh.Buckets) { - // Use MP5 flash if available. - auto gunflash = GAME_OBJECT_ID::ID_GUN_FLASH; - if (Lara.Control.Weapon.GunType == LaraWeaponType::HK && Objects[GAME_OBJECT_ID::ID_GUN_FLASH2].loaded) - gunflash = GAME_OBJECT_ID::ID_GUN_FLASH2; + if (flashBucket.BlendMode == BlendMode::Opaque) + continue; - if (!_moveableObjects[gunflash].has_value()) - return false; + if (flashBucket.Polygons.size() == 0) + continue; - const auto& flashMoveable = *_moveableObjects[gunflash]; - const auto& flashMesh = *flashMoveable.ObjectMeshes[0]; + BindTexture(TextureRegister::ColorMap, &std::get<0>(_moveablesTextures[flashBucket.Texture]), SamplerStateRegister::AnisotropicClamp); - _shaders.Bind(Shader::Statics); + auto meshOffset = g_Level.Frames[GetAnimData(gunflash, 0).FramePtr].Offset; + auto offset = settings.MuzzleOffset + Vector3(meshOffset.x, meshOffset.z, meshOffset.y); // Offsets are inverted because of bone orientation. - unsigned int stride = sizeof(Vertex); - unsigned int offset = 0; + auto tMatrix = Matrix::CreateTranslation(offset); + auto rotMatrix = Matrix::CreateRotationX(TO_RAD(Lara.Control.Weapon.GunType == LaraWeaponType::Pistol ? -16830 : -14560)); // HACK - _context->IASetVertexBuffers(0, 1, _moveablesVertexBuffer.Buffer.GetAddressOf(), &stride, &offset); - _context->IASetPrimitiveTopology(D3D11_PRIMITIVE_TOPOLOGY_TRIANGLELIST); - _context->IASetIndexBuffer(_moveablesIndexBuffer.Buffer.Get(), DXGI_FORMAT_R32_UINT, 0); - - const auto& room = _rooms[LaraItem->RoomNumber]; - auto* itemPtr = &_items[LaraItem->Index]; - - // Divide gunflash tint by 2 because tinting uses multiplication and additive color which doesn't look good with overbright color values. - _stStatic.Color = settings.ColorizeMuzzleFlash ? ((Vector4)settings.FlashColor / 2) : Vector4::One; - _stStatic.AmbientLight = room.AmbientLight; - _stStatic.LightMode = (int)LightMode::Static; - BindStaticLights(itemPtr->LightsToDraw); - - SetAlphaTest(AlphaTestMode::GreatherThan, ALPHA_TEST_THRESHOLD); - SetBlendMode(BlendMode::Additive); - - for (const auto& flashBucket : flashMesh.Buckets) + auto worldMatrix = Matrix::Identity; + if (Lara.LeftArm.GunFlash) { - if (flashBucket.BlendMode == BlendMode::Opaque) - continue; + worldMatrix = itemPtr->AnimTransforms[LM_LHAND] * itemPtr->World; + worldMatrix = tMatrix * worldMatrix; + worldMatrix = rotMatrix * worldMatrix; + ReflectMatrixOptionally(worldMatrix); - if (flashBucket.Polygons.size() == 0) - continue; + _stStatic.World = worldMatrix; + _cbStatic.UpdateData(_stStatic, _context.Get()); - BindTexture(TextureRegister::ColorMap, &std::get<0>(_moveablesTextures[flashBucket.Texture]), SamplerStateRegister::AnisotropicClamp); + DrawIndexedTriangles(flashBucket.NumIndices, flashBucket.StartIndex, 0); + _numMoveablesDrawCalls++; + } - auto meshOffset = g_Level.Frames[GetAnimData(gunflash, 0).FramePtr].Offset; - auto offset = settings.MuzzleOffset + Vector3(meshOffset.x, meshOffset.z, meshOffset.y); // Offsets are inverted because of bone orientation. + if (Lara.RightArm.GunFlash) + { + worldMatrix = itemPtr->AnimTransforms[LM_RHAND] * itemPtr->World; + worldMatrix = tMatrix * worldMatrix; + worldMatrix = rotMatrix * worldMatrix; + ReflectMatrixOptionally(worldMatrix); - auto tMatrix = Matrix::CreateTranslation(offset); - auto rotMatrix = Matrix::CreateRotationX(TO_RAD(Lara.Control.Weapon.GunType == LaraWeaponType::Pistol ? -16830 : -14560)); // HACK + _stStatic.World = worldMatrix; + _cbStatic.UpdateData(_stStatic, _context.Get()); - auto worldMatrix = Matrix::Identity; - if (Lara.LeftArm.GunFlash) - { - worldMatrix = itemPtr->AnimTransforms[LM_LHAND] * itemPtr->World; - worldMatrix = tMatrix * worldMatrix; - worldMatrix = rotMatrix * worldMatrix; - ReflectMatrixOptionally(worldMatrix); + DrawIndexedTriangles(flashBucket.NumIndices, flashBucket.StartIndex, 0); - _stStatic.World = worldMatrix; - _cbStatic.UpdateData(_stStatic, _context.Get()); - - DrawIndexedTriangles(flashBucket.NumIndices, flashBucket.StartIndex, 0); - - _numMoveablesDrawCalls++; - } - - if (Lara.RightArm.GunFlash) - { - worldMatrix = itemPtr->AnimTransforms[LM_RHAND] * itemPtr->World; - worldMatrix = tMatrix * worldMatrix; - worldMatrix = rotMatrix * worldMatrix; - ReflectMatrixOptionally(worldMatrix); - - _stStatic.World = worldMatrix; - _cbStatic.UpdateData(_stStatic, _context.Get()); - - DrawIndexedTriangles(flashBucket.NumIndices, flashBucket.StartIndex, 0); - - _numMoveablesDrawCalls++; - } + _numMoveablesDrawCalls++; } } diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp index 9db67dc64..263c938fb 100644 --- a/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp +++ b/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp @@ -25,15 +25,15 @@ namespace TEN::Scripting // NOTE: Since Weapons array is bound to Lua directly and Lua accesses this array by native enum, where 0 is NONE, and 1 is PISTOLS, // 0 index is omitted due to Lua indexing arrays starting from 1. 1 must be subtracted from initializer index. - Weapons[(int)LaraWeaponType::Pistol - 1] = { 8.0f, BLOCK(8), 9, (int)BLOCK(0.65f), 1, 1, 30, ScriptColor(192, 128, 0), 9, 3, true, true, true, true, false, Vec3( 0, 120, 30) }; - Weapons[(int)LaraWeaponType::Revolver - 1] = { 4.0f, BLOCK(8), 16, (int)BLOCK(0.65f), 21, 21, 6, ScriptColor(192, 128, 0), 9, 3, true, false, true, true, false, Vec3(-10, 130, 65) }; - Weapons[(int)LaraWeaponType::Uzi - 1] = { 8.0f, BLOCK(8), 3, (int)BLOCK(0.65f), 1, 1, 30, ScriptColor(192, 128, 0), 9, 2, true, true, true, true, false, Vec3( 0, 110, 40) }; - Weapons[(int)LaraWeaponType::Shotgun - 1] = { 10.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 3, 3, 6, ScriptColor(192, 128, 0), 12, 3, true, true, false, false, false, Vec3( 0, 210, 42) }; - Weapons[(int)LaraWeaponType::HK - 1] = { 4.0f, BLOCK(12), 0, (int)BLOCK(0.50f), 4, 4, 30, ScriptColor(192, 128, 0), 12, 2, true, true, true, true, false, Vec3( 0, 220, 102) }; - Weapons[(int)LaraWeaponType::Crossbow - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 5, 20, 10, ScriptColor(192, 128, 0), 0, 0, false, false, false, false, false, Vec3() }; - Weapons[(int)LaraWeaponType::GrenadeLauncher - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 30, 30, 10, ScriptColor(192, 128, 0), 0, 0, true, false, false, false, false, Vec3() }; - Weapons[(int)LaraWeaponType::RocketLauncher - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 30, 30, 1, ScriptColor(192, 128, 0), 0, 0, true, false, false, false, false, Vec3() }; - Weapons[(int)LaraWeaponType::HarpoonGun - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 6, 6, 10, ScriptColor(192, 128, 0), 0, 0, false, false, false, false, false, Vec3() }; + Weapons[(int)LaraWeaponType::Pistol - 1] = { 8.0f, BLOCK(8), 9, (int)BLOCK(0.65f), 1, 1, 30, ScriptColor(192, 128, 0), 9, 3, true, true, true, false, false, Vec3( 0, 120, 30) }; + Weapons[(int)LaraWeaponType::Revolver - 1] = { 4.0f, BLOCK(8), 16, (int)BLOCK(0.65f), 21, 21, 6, ScriptColor(192, 128, 0), 9, 3, true, false, true, false, false, Vec3(-10, 130, 65) }; + Weapons[(int)LaraWeaponType::Uzi - 1] = { 8.0f, BLOCK(8), 3, (int)BLOCK(0.65f), 1, 1, 30, ScriptColor(192, 128, 0), 9, 2, true, true, true, false, false, Vec3( 0, 110, 40) }; + Weapons[(int)LaraWeaponType::Shotgun - 1] = { 10.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 3, 3, 6, ScriptColor(192, 128, 0), 12, 3, true, true, false, false, false, Vec3( 0, 210, 40) }; + Weapons[(int)LaraWeaponType::HK - 1] = { 4.0f, BLOCK(12), 0, (int)BLOCK(0.50f), 4, 4, 30, ScriptColor(192, 128, 0), 12, 2, true, true, true, false, false, Vec3( 0, 220, 102) }; + Weapons[(int)LaraWeaponType::Crossbow - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 5, 20, 10, ScriptColor(192, 128, 0), 0, 0, false, false, false, false, false, Vec3( 0, 240, 50) }; + Weapons[(int)LaraWeaponType::GrenadeLauncher - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 30, 30, 10, ScriptColor(192, 128, 0), 0, 0, true, false, false, false, false, Vec3( 0, 190, 50) }; + Weapons[(int)LaraWeaponType::RocketLauncher - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 30, 30, 1, ScriptColor(192, 128, 0), 0, 0, true, false, false, false, false, Vec3( 0, 90, 90) }; + Weapons[(int)LaraWeaponType::HarpoonGun - 1] = { 8.0f, BLOCK(8), 0, (int)BLOCK(0.50f), 6, 6, 10, ScriptColor(192, 128, 0), 0, 0, false, false, false, false, false, Vec3(-15, 240, 50) }; } void Settings::Register(sol::table& parent) @@ -286,19 +286,19 @@ namespace TEN::Scripting "pickupCount", &WeaponSettings::PickupCount, /// Gunflash color. - // @tfield Color flashColor specifies the color of the gunflash. Applicable only for firearms. + // @tfield Color flashColor specifies the color of the gunflash. "flashColor", &WeaponSettings::FlashColor, /// Gunflash range. - // @tfield Color flashRange specifies the range of the gunflash. Applicable only for firearms. + // @tfield Color flashRange specifies the range of the gunflash. "flashRange", &WeaponSettings::FlashRange, /// Gunflash duration. - // @tfield int flashDuration specifies the duration of a gunflash effect. Applicable only for firearms. + // @tfield int flashDuration specifies the duration of a gunflash effect. "flashDuration", &WeaponSettings::FlashDuration, /// Gun smoke. - // @tfield bool smoke if set to true, indicates that weapon emits gun smoke. Not applicable for crossbow and harpoon gun. + // @tfield bool smoke if set to true, indicates that weapon emits gun smoke. "smoke", &WeaponSettings::Smoke, /// Gun shell. @@ -306,19 +306,19 @@ namespace TEN::Scripting "shell", &WeaponSettings::Shell, /// Display muzzle flash. - // @tfield bool muzzleFlash specifies whether muzzle flash should be displayed or not. Applicable only for firearms. + // @tfield bool muzzleFlash specifies whether muzzle flash should be displayed or not. "muzzleFlash", &WeaponSettings::MuzzleFlash, /// Display muzzle glow. - // @tfield bool muzzleGlow specifies whether muzzle glow should be displayed or not. Applicable only for firearms. + // @tfield bool muzzleGlow specifies whether muzzle glow should be displayed or not. "muzzleGlow", &WeaponSettings::MuzzleGlow, /// Colorize muzzle flash. - // @tfield bool colorizeMuzzleFlash specifies whether muzzle flash should be tinted with the same color as gunflash color. Applicable only for firearms. + // @tfield bool colorizeMuzzleFlash specifies whether muzzle flash should be tinted with the same color as gunflash color. "colorizeMuzzleFlash", &WeaponSettings::ColorizeMuzzleFlash, /// Muzzle offset. - // @tfield Vec3 muzzleOffset specifies offset for spawning muzzle gunflash effects. Applicable only for firearms. + // @tfield Vec3 muzzleOffset specifies offset for spawning muzzle gunflash effects. "muzzleOffset", &WeaponSettings::MuzzleOffset); } diff --git a/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h b/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h index 3c85b7494..e9aa45a96 100644 --- a/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h +++ b/TombEngine/Specific/savegame/flatbuffers/ten_savegame_generated.h @@ -3798,7 +3798,6 @@ struct WeaponControlDataT : public flatbuffers::NativeTable { typedef WeaponControlData TableType; int32_t weapon_item = 0; bool has_fired = false; - bool fired = false; bool uzi_left = false; bool uzi_right = false; int32_t gun_type = 0; @@ -3817,16 +3816,15 @@ struct WeaponControlData FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { enum FlatBuffersVTableOffset FLATBUFFERS_VTABLE_UNDERLYING_TYPE { VT_WEAPON_ITEM = 4, VT_HAS_FIRED = 6, - VT_FIRED = 8, - VT_UZI_LEFT = 10, - VT_UZI_RIGHT = 12, - VT_GUN_TYPE = 14, - VT_REQUEST_GUN_TYPE = 16, - VT_LAST_GUN_TYPE = 18, - VT_HOLSTER_INFO = 20, - VT_NUM_SHOTS_FIRED = 22, - VT_INTERVAL = 24, - VT_TIMER = 26 + VT_UZI_LEFT = 8, + VT_UZI_RIGHT = 10, + VT_GUN_TYPE = 12, + VT_REQUEST_GUN_TYPE = 14, + VT_LAST_GUN_TYPE = 16, + VT_HOLSTER_INFO = 18, + VT_NUM_SHOTS_FIRED = 20, + VT_INTERVAL = 22, + VT_TIMER = 24 }; int32_t weapon_item() const { return GetField(VT_WEAPON_ITEM, 0); @@ -3834,9 +3832,6 @@ struct WeaponControlData FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { bool has_fired() const { return GetField(VT_HAS_FIRED, 0) != 0; } - bool fired() const { - return GetField(VT_FIRED, 0) != 0; - } bool uzi_left() const { return GetField(VT_UZI_LEFT, 0) != 0; } @@ -3868,7 +3863,6 @@ struct WeaponControlData FLATBUFFERS_FINAL_CLASS : private flatbuffers::Table { return VerifyTableStart(verifier) && VerifyField(verifier, VT_WEAPON_ITEM) && VerifyField(verifier, VT_HAS_FIRED) && - VerifyField(verifier, VT_FIRED) && VerifyField(verifier, VT_UZI_LEFT) && VerifyField(verifier, VT_UZI_RIGHT) && VerifyField(verifier, VT_GUN_TYPE) && @@ -3896,9 +3890,6 @@ struct WeaponControlDataBuilder { void add_has_fired(bool has_fired) { fbb_.AddElement(WeaponControlData::VT_HAS_FIRED, static_cast(has_fired), 0); } - void add_fired(bool fired) { - fbb_.AddElement(WeaponControlData::VT_FIRED, static_cast(fired), 0); - } void add_uzi_left(bool uzi_left) { fbb_.AddElement(WeaponControlData::VT_UZI_LEFT, static_cast(uzi_left), 0); } @@ -3941,7 +3932,6 @@ inline flatbuffers::Offset CreateWeaponControlData( flatbuffers::FlatBufferBuilder &_fbb, int32_t weapon_item = 0, bool has_fired = false, - bool fired = false, bool uzi_left = false, bool uzi_right = false, int32_t gun_type = 0, @@ -3962,7 +3952,6 @@ inline flatbuffers::Offset CreateWeaponControlData( builder_.add_weapon_item(weapon_item); builder_.add_uzi_right(uzi_right); builder_.add_uzi_left(uzi_left); - builder_.add_fired(fired); builder_.add_has_fired(has_fired); return builder_.Finish(); } @@ -10201,7 +10190,6 @@ inline void WeaponControlData::UnPackTo(WeaponControlDataT *_o, const flatbuffer (void)_resolver; { auto _e = weapon_item(); _o->weapon_item = _e; } { auto _e = has_fired(); _o->has_fired = _e; } - { auto _e = fired(); _o->fired = _e; } { auto _e = uzi_left(); _o->uzi_left = _e; } { auto _e = uzi_right(); _o->uzi_right = _e; } { auto _e = gun_type(); _o->gun_type = _e; } @@ -10223,7 +10211,6 @@ inline flatbuffers::Offset CreateWeaponControlData(flatbuffer struct _VectorArgs { flatbuffers::FlatBufferBuilder *__fbb; const WeaponControlDataT* __o; const flatbuffers::rehasher_function_t *__rehasher; } _va = { &_fbb, _o, _rehasher}; (void)_va; auto _weapon_item = _o->weapon_item; auto _has_fired = _o->has_fired; - auto _fired = _o->fired; auto _uzi_left = _o->uzi_left; auto _uzi_right = _o->uzi_right; auto _gun_type = _o->gun_type; @@ -10237,7 +10224,6 @@ inline flatbuffers::Offset CreateWeaponControlData(flatbuffer _fbb, _weapon_item, _has_fired, - _fired, _uzi_left, _uzi_right, _gun_type, diff --git a/TombEngine/Specific/savegame/schema/ten_savegame.fbs b/TombEngine/Specific/savegame/schema/ten_savegame.fbs index 11d988d99..335dd93bb 100644 --- a/TombEngine/Specific/savegame/schema/ten_savegame.fbs +++ b/TombEngine/Specific/savegame/schema/ten_savegame.fbs @@ -265,7 +265,6 @@ table TightropeControlData { table WeaponControlData { weapon_item: int32; has_fired: bool; - fired: bool; uzi_left: bool; uzi_right: bool; gun_type: int32; From cb23823e64f6b6f000a35c2847374f8c6ed3e98c Mon Sep 17 00:00:00 2001 From: Lwmte <3331699+Lwmte@users.noreply.github.com> Date: Sun, 20 Apr 2025 22:06:07 +0300 Subject: [PATCH 152/160] Video playback (#1625) * Work * Work * Update Video.cpp * Update Video.cpp * Update Video.cpp * Update Video.cpp * Update Video.cpp * Working playback * Update Video.cpp * Cleanups * Additions * Update Video.cpp * Formatting * Correct pausing/resuming * Remove .mov extension, as it's not supported * Use vector instead of array * Implement SetIntroVideoPath * Swap intro image and intro video to better reflect original legal sequence * Update Gameflow.lua * Simplify synchronization with VLC thread * Use Vector2i for sizes, only fetch video dimensions once * Rename callbacks, move logging callback to a class * Update Video.cpp * Update CHANGELOG.md * Removed empty OnDisplayFrame event * Rename * Stop video player if user pressed Alt+F4 * Allow background video playback * Update Video.cpp * Update Video.cpp * Fixed init errors * Restore .mov default extension for video playback * Update RendererDraw2D.cpp * Add video streaming for rectangular faces of room geometry * Remove magic and use normalized UVs instead * Use VIDEO_SPRITE_ID instead of NO_VALUE * Added more scripting API functions for video playback * Correct variable names * Shorten notification * Add GetVideoDominantColor * Do proper cleanup when alt+F4ing during video playback * Change game loop deinit to avoid several issues with cleaning up * Organise `VideoHandler` class * Randomize glow angle * Update comment * Update Video.cpp * Update Video.cpp * Fix issues with frame drops in exclusive mode * Optimize CPU usage in exclusive mode --------- Co-authored-by: Sezz --- CHANGELOG.md | 5 + Documentation/doc/1 modules/Flow.html | 27 + Documentation/doc/1 modules/Sound.html | 2 +- Documentation/doc/1 modules/View.html | 174 +- .../doc/2 classes/View.DisplaySprite.html | 50 +- Libs/vlc/libvlc.h | 546 +++ Libs/vlc/libvlc_dialog.h | 260 ++ Libs/vlc/libvlc_events.h | 457 +++ Libs/vlc/libvlc_media.h | 917 +++++ Libs/vlc/libvlc_media_discoverer.h | 188 + Libs/vlc/libvlc_media_list.h | 200 + Libs/vlc/libvlc_media_list_player.h | 249 ++ Libs/vlc/libvlc_media_player.h | 3304 +++++++++++++++++ Libs/vlc/libvlc_media_track.h | 212 ++ Libs/vlc/libvlc_picture.h | 151 + Libs/vlc/libvlc_renderer_discoverer.h | 255 ++ Libs/vlc/libvlc_version.h | 79 + Libs/vlc/libvlc_video.h | 67 + Libs/vlc/vlc.h | 55 + Libs/vlc/x64/libvlc.dll | Bin 0 -> 170496 bytes Libs/vlc/x64/libvlc.lib | Bin 0 -> 59026 bytes Libs/vlc/x64/libvlccore.dll | Bin 0 -> 4082688 bytes Libs/vlc/x64/libvlccore.lib | Bin 0 -> 181442 bytes Libs/vlc/x86/libvlc.dll | Bin 0 -> 153088 bytes Libs/vlc/x86/libvlc.lib | Bin 0 -> 59898 bytes Libs/vlc/x86/libvlccore.dll | Bin 0 -> 3806720 bytes Libs/vlc/x86/libvlccore.lib | Bin 0 -> 184644 bytes Scripts/Gameflow.lua | 5 + TombEngine/Game/control/control.cpp | 55 +- TombEngine/Game/control/control.h | 1 + TombEngine/Game/debug/debug.cpp | 4 + TombEngine/Game/gui.cpp | 12 +- TombEngine/Game/savegame.cpp | 25 +- .../Renderer/ConstantBuffers/AnimatedBuffer.h | 2 +- TombEngine/Renderer/Renderer.cpp | 14 +- TombEngine/Renderer/Renderer.h | 7 +- TombEngine/Renderer/RendererCompatibility.cpp | 27 +- TombEngine/Renderer/RendererDraw.cpp | 85 +- TombEngine/Renderer/RendererDraw2D.cpp | 10 +- TombEngine/Renderer/RendererDrawEffect.cpp | 8 +- TombEngine/Renderer/RendererDrawMenu.cpp | 2 +- TombEngine/Renderer/RendererInit.cpp | 8 +- .../Structures/RendererAnimatedTexture.h | 1 + .../Structures/RendererAnimatedTextureSet.h | 12 +- .../Renderer/Structures/RendererSprite.h | 2 + .../Include/Flow/ScriptInterfaceFlowHandler.h | 1 + .../Scripting/Internal/ReservedScriptNames.h | 7 + .../Internal/TEN/Flow/FlowHandler.cpp | 13 + .../Scripting/Internal/TEN/Flow/FlowHandler.h | 1 + .../Internal/TEN/Sound/SoundHandler.cpp | 2 +- .../DisplaySprite/ScriptDisplaySprite.cpp | 37 +- .../View/DisplaySprite/ScriptDisplaySprite.h | 2 + .../Internal/TEN/View/ViewHandler.cpp | 96 +- TombEngine/Sound/sound.cpp | 3 + TombEngine/Specific/Input/Input.cpp | 6 +- TombEngine/Specific/Input/Input.h | 2 +- TombEngine/Specific/Video/Video.cpp | 622 ++++ TombEngine/Specific/Video/Video.h | 107 + TombEngine/Specific/level.cpp | 12 +- TombEngine/Specific/level.h | 7 +- .../flatbuffers/ten_savegame_generated.h | 229 +- .../Specific/savegame/schema/ten_savegame.fbs | 10 +- TombEngine/Specific/winmain.cpp | 33 +- TombEngine/TombEngine.vcxproj | 30 +- TombEngine/framework.h | 1 + 65 files changed, 8551 insertions(+), 148 deletions(-) create mode 100644 Libs/vlc/libvlc.h create mode 100644 Libs/vlc/libvlc_dialog.h create mode 100644 Libs/vlc/libvlc_events.h create mode 100644 Libs/vlc/libvlc_media.h create mode 100644 Libs/vlc/libvlc_media_discoverer.h create mode 100644 Libs/vlc/libvlc_media_list.h create mode 100644 Libs/vlc/libvlc_media_list_player.h create mode 100644 Libs/vlc/libvlc_media_player.h create mode 100644 Libs/vlc/libvlc_media_track.h create mode 100644 Libs/vlc/libvlc_picture.h create mode 100644 Libs/vlc/libvlc_renderer_discoverer.h create mode 100644 Libs/vlc/libvlc_version.h create mode 100644 Libs/vlc/libvlc_video.h create mode 100644 Libs/vlc/vlc.h create mode 100644 Libs/vlc/x64/libvlc.dll create mode 100644 Libs/vlc/x64/libvlc.lib create mode 100644 Libs/vlc/x64/libvlccore.dll create mode 100644 Libs/vlc/x64/libvlccore.lib create mode 100644 Libs/vlc/x86/libvlc.dll create mode 100644 Libs/vlc/x86/libvlc.lib create mode 100644 Libs/vlc/x86/libvlccore.dll create mode 100644 Libs/vlc/x86/libvlccore.lib create mode 100644 TombEngine/Specific/Video/Video.cpp create mode 100644 TombEngine/Specific/Video/Video.h diff --git a/CHANGELOG.md b/CHANGELOG.md index 273123e04..4973d3ee7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,9 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): ## [Version 1.8.2] +## New features +* Added video playback support. + ### Bug fixes * Fixed crashes when shooting, if gunflash or gunshell objects are not present in a level. * Fixed Teleporter object. @@ -20,6 +23,8 @@ TombEngine releases are located in this repository (alongside with Tomb Editor): * Added muzzle glow effect for firearms. ### Lua API changes +* Added `View.PlayVideoFile` function to play videos. +* Added `Flow.SetIntroVideoPath` function to specify intro video. * Added `muzzleGlow` and `muzzleOffset` parameters to weapon settings. * Added ability to use gunflash parameters for all weapons in weapon settings. * Fixed `Moveable.GetJointPosition` not returning correct results if moveable is invisible or not rendered. diff --git a/Documentation/doc/1 modules/Flow.html b/Documentation/doc/1 modules/Flow.html index 4a680cba5..998af2ca6 100644 --- a/Documentation/doc/1 modules/Flow.html +++ b/Documentation/doc/1 modules/Flow.html @@ -132,6 +132,10 @@ scripts too.

    + + + + @@ -330,6 +334,29 @@ Must be a .jpg or .png image. + +
    + + SetIntroVideoPath(path) +
    +
    + Video to show when loading the game. +Must be a common video format, such as .mp4, .mkv or .avi. + + + +

    Parameters:

    +
      +
    • path + string + the path to the video, relative to the TombEngine exe +
      • +
    + + + + +
    diff --git a/Documentation/doc/1 modules/Sound.html b/Documentation/doc/1 modules/Sound.html index be07997d5..d15b22848 100644 --- a/Documentation/doc/1 modules/Sound.html +++ b/Documentation/doc/1 modules/Sound.html @@ -177,7 +177,7 @@ PlayAudioTrack(filename, type)
    - Play an audio track. Supported formats are wav, mp3 and ogg. + Play an audio track. Should be placed in the Audio folder. Supported formats are wav, mp3 and ogg. diff --git a/Documentation/doc/1 modules/View.html b/Documentation/doc/1 modules/View.html index 51c5b824e..3e55ab4e5 100644 --- a/Documentation/doc/1 modules/View.html +++ b/Documentation/doc/1 modules/View.html @@ -172,6 +172,30 @@
    + + + + + + + + + + + + + + + + + + + + + + + + @@ -261,11 +285,11 @@
    • height float - (default 30) Percentage of the screen to be covered + (default 30). Percentage of the screen to be covered
    • speed float - (default 30) Coverage percent per second + (default 30). Coverage percent per second
    @@ -474,6 +498,152 @@ + +
    + + PlayVideo(fileName[, background][, silent][, loop]) +
    +
    + Play a video file. File should be placed in the FMV folder. + + + +

    Parameters:

    +
      +
    • fileName + string + Video file name. Can be provided without extension, if type is mp4, mkv or avi. +
      • +
    • background + bool + (default: false). Play video in the background mode. + In such case, video won't play in fullscreen, but must be shown using special animated texture type in Tomb Editor, or using View.DisplaySprite. + (optional) +
      • +
    • silent + bool + (default: false). Play video without sound. + (optional) +
      • +
    • loop + bool + (default: false). Play video in a loop. + (optional) +
      • +
    + + + + + +
    +
    + + StopVideo() +
    +
    + Stop the currently playing video. Only possible if video is playing in the background mode. + + + + + + + + +
    +
    + + GetVideoPosition() +
    +
    + Gets the currently playing video position. + + + + +

    Returns:

    +
      + + Time + Current video position. +
    + + + + +
    +
    + + SetVideoPosition(position) +
    +
    + Sets the currently playing video position. + + + +

    Parameters:

    +
      +
    • position + Time + New video position. +
      • +
    + + + + + +
    +
    + + GetVideoDominantColor() +
    +
    + Gets the dominant color for the current video frame. If no video is playing, returns black. + + + + +

    Returns:

    +
      + + Color + Dominant video color. +
    + + + + +
    +
    + + IsVideoPlaying([name]) +
    +
    + Checks if video is currently playing. + + + +

    Parameters:

    +
      +
    • name + string + Video file name. If provided, checks if the currently playing video file name is the same as the provided one. + (optional) +
      • +
    + +

    Returns:

    +
      + + bool + True if video is currently playing. +
    + + + +
    diff --git a/Documentation/doc/2 classes/View.DisplaySprite.html b/Documentation/doc/2 classes/View.DisplaySprite.html index 2b097a9bb..e46055254 100644 --- a/Documentation/doc/2 classes/View.DisplaySprite.html +++ b/Documentation/doc/2 classes/View.DisplaySprite.html @@ -128,6 +128,10 @@
    + + + + @@ -193,7 +197,7 @@ DisplaySprite(ID, int, pos, rot, scale, [color])
    - Create a DisplaySprite object. () + Create a DisplaySprite object. @@ -236,6 +240,48 @@ +
    +
    + + DisplaySprite(pos, rot, scale[, color]) +
    +
    + Create a DisplaySprite object with a video image. + Video should be played using View.PlayVideo function in a background mode. If no video is played, sprite will not show. + + + +

    Parameters:

    +
      +
    • pos + Vec2 + Display position in percent. +
      • +
    • rot + float + Rotation in degrees. +
      • +
    • scale + Vec2 + Horizontal and vertical scale in percent. Scaling is interpreted by the DisplaySpriteEnum.ScaleMode passed to the Draw() function call. +
      • +
    • color + Color + Color. Default: Color(255, 255, 255, 255) + (optional) +
      • +
    + +

    Returns:

    +
      + + DisplaySprite + A new DisplaySprite object with attached video image. +
    + + + +
    @@ -272,7 +318,7 @@
      int - Sprite ID in the sprite sequence object. + Sprite ID in the sprite sequence object. Value -1 means that it is a background video, played using View.PlayVideo.
    diff --git a/Libs/vlc/libvlc.h b/Libs/vlc/libvlc.h new file mode 100644 index 000000000..0970dc294 --- /dev/null +++ b/Libs/vlc/libvlc.h @@ -0,0 +1,546 @@ +/***************************************************************************** + * libvlc.h: libvlc external API + ***************************************************************************** + * Copyright (C) 1998-2009 VLC authors and VideoLAN + * + * Authors: Clément Stenac + * Jean-Paul Saman + * Pierre d'Herbemont + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation; either version 2.1 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA. + *****************************************************************************/ + +/** + * \defgroup libvlc LibVLC + * LibVLC is the external programming interface of the VLC media player. + * It is used to embed VLC into other applications or frameworks. + * @{ + * \file + * LibVLC core external API + */ + +#ifndef VLC_LIBVLC_H +#define VLC_LIBVLC_H 1 + +#if defined (_WIN32) && defined (LIBVLC_DLL_EXPORT) +# define LIBVLC_API __declspec(dllexport) +#elif defined (__GNUC__) && (__GNUC__ >= 4) +# define LIBVLC_API __attribute__((visibility("default"))) +#else +# define LIBVLC_API +#endif + +#ifdef LIBVLC_INTERNAL_ +/* Avoid unhelpful warnings from libvlc with our deprecated APIs */ +# define LIBVLC_DEPRECATED +#elif defined(__GNUC__) && \ + (__GNUC__ > 3 || __GNUC__ == 3 && __GNUC_MINOR__ > 0) +# define LIBVLC_DEPRECATED __attribute__((deprecated)) +#else +# define LIBVLC_DEPRECATED +#endif + +#include +#include +#include + +# ifdef __cplusplus +extern "C" { +# endif + +/** \defgroup libvlc_core LibVLC core + * \ingroup libvlc + * Before it can do anything useful, LibVLC must be initialized. + * You can create one (or more) instance(s) of LibVLC in a given process, + * with libvlc_new() and destroy them with libvlc_release(). + * + * \version Unless otherwise stated, these functions are available + * from LibVLC versions numbered 1.1.0 or more. + * Earlier versions (0.9.x and 1.0.x) are not compatible. + * @{ + */ + +/** This structure is opaque. It represents a libvlc instance */ +typedef struct libvlc_instance_t libvlc_instance_t; + +typedef int64_t libvlc_time_t; + +/** \defgroup libvlc_error LibVLC error handling + * @{ + */ + +/** + * A human-readable error message for the last LibVLC error in the calling + * thread. The resulting string is valid until another error occurs (at least + * until the next LibVLC call). + * + * @warning + * This will be NULL if there was no error. + */ +LIBVLC_API const char *libvlc_errmsg (void); + +/** + * Clears the LibVLC error status for the current thread. This is optional. + * By default, the error status is automatically overridden when a new error + * occurs, and destroyed when the thread exits. + */ +LIBVLC_API void libvlc_clearerr (void); + +/** + * Sets the LibVLC error status and message for the current thread. + * Any previous error is overridden. + * \param fmt the format string + * \param ... the arguments for the format string + * \return a nul terminated string in any case + */ +const char *libvlc_printerr (const char *fmt, ...); + +/**@} */ + +/** + * Create and initialize a libvlc instance. + * This functions accept a list of "command line" arguments similar to the + * main(). These arguments affect the LibVLC instance default configuration. + * + * \note + * LibVLC may create threads. Therefore, any thread-unsafe process + * initialization must be performed before calling libvlc_new(). In particular + * and where applicable: + * - setlocale() and textdomain(), + * - setenv(), unsetenv() and putenv(), + * - with the X11 display system, XInitThreads() + * (see also libvlc_media_player_set_xwindow()) and + * - on Microsoft Windows, SetErrorMode(). + * - sigprocmask() shall never be invoked; pthread_sigmask() can be used. + * + * On POSIX systems, the SIGCHLD signal must not be ignored, i.e. the + * signal handler must set to SIG_DFL or a function pointer, not SIG_IGN. + * Also while LibVLC is active, the wait() function shall not be called, and + * any call to waitpid() shall use a strictly positive value for the first + * parameter (i.e. the PID). Failure to follow those rules may lead to a + * deadlock or a busy loop. + * Also on POSIX systems, it is recommended that the SIGPIPE signal be blocked, + * even if it is not, in principles, necessary, e.g.: + * @code + sigset_t set; + + signal(SIGCHLD, SIG_DFL); + sigemptyset(&set); + sigaddset(&set, SIGPIPE); + pthread_sigmask(SIG_BLOCK, &set, NULL); + * @endcode + * + * On Microsoft Windows, setting the default DLL directories to SYSTEM32 + * exclusively is strongly recommended for security reasons: + * @code + SetDefaultDllDirectories(LOAD_LIBRARY_SEARCH_SYSTEM32); + * @endcode + * + * \version + * Arguments are meant to be passed from the command line to LibVLC, just like + * VLC media player does. The list of valid arguments depends on the LibVLC + * version, the operating system and platform, and set of available LibVLC + * plugins. Invalid or unsupported arguments will cause the function to fail + * (i.e. return NULL). Also, some arguments may alter the behaviour or + * otherwise interfere with other LibVLC functions. + * + * \warning + * There is absolutely no warranty or promise of forward, backward and + * cross-platform compatibility with regards to libvlc_new() arguments. + * We recommend that you do not use them, other than when debugging. + * + * \param argc the number of arguments (should be 0) + * \param argv list of arguments (should be NULL) + * \return the libvlc instance or NULL in case of error + */ +LIBVLC_API libvlc_instance_t * +libvlc_new( int argc , const char *const *argv ); + +/** + * Decrement the reference count of a libvlc instance, and destroy it + * if it reaches zero. + * + * \param p_instance the instance to destroy + */ +LIBVLC_API void libvlc_release( libvlc_instance_t *p_instance ); + +/** + * Increments the reference count of a libvlc instance. + * The initial reference count is 1 after libvlc_new() returns. + * + * \param p_instance the instance to reference + * \return the same object + */ +LIBVLC_API libvlc_instance_t *libvlc_retain( libvlc_instance_t *p_instance ); + +/** + * Get the ABI version of the libvlc library. + * + * This is different than the VLC version, which is the version of the whole + * VLC package. The value is the same as LIBVLC_ABI_VERSION_INT used when + * compiling. + * + * \return a value with the following mask in hexadecimal + * 0xFF000000: major VLC version, similar to VLC major version, + * 0x00FF0000: major ABI version, incremented incompatible changes are added, + * 0x0000FF00: minor ABI version, incremented when new functions are added + * 0x000000FF: micro ABI version, incremented with new release/builds + * + * \note This the same value as the .so version but cross platform. + */ +LIBVLC_API int libvlc_abi_version(void); + +/** + * Sets the application name. LibVLC passes this as the user agent string + * when a protocol requires it. + * + * \param p_instance LibVLC instance + * \param name human-readable application name, e.g. "FooBar player 1.2.3" + * \param http HTTP User Agent, e.g. "FooBar/1.2.3 Python/2.6.0" + * \version LibVLC 1.1.1 or later + */ +LIBVLC_API +void libvlc_set_user_agent( libvlc_instance_t *p_instance, + const char *name, const char *http ); + +/** + * Sets some meta-information about the application. + * See also libvlc_set_user_agent(). + * + * \param p_instance LibVLC instance + * \param id Java-style application identifier, e.g. "com.acme.foobar" + * \param version application version numbers, e.g. "1.2.3" + * \param icon application icon name, e.g. "foobar" + * \version LibVLC 2.1.0 or later. + */ +LIBVLC_API +void libvlc_set_app_id( libvlc_instance_t *p_instance, const char *id, + const char *version, const char *icon ); + +/** + * Retrieve libvlc version. + * + * Example: "1.1.0-git The Luggage" + * + * \return a string containing the libvlc version + */ +LIBVLC_API const char * libvlc_get_version(void); + +/** + * Retrieve libvlc compiler version. + * + * Example: "gcc version 4.2.3 (Ubuntu 4.2.3-2ubuntu6)" + * + * \return a string containing the libvlc compiler version + */ +LIBVLC_API const char * libvlc_get_compiler(void); + +/** + * Retrieve libvlc changeset. + * + * Example: "aa9bce0bc4" + * + * \return a string containing the libvlc changeset + */ +LIBVLC_API const char * libvlc_get_changeset(void); + +/** + * Frees an heap allocation returned by a LibVLC function. + * If you know you're using the same underlying C run-time as the LibVLC + * implementation, then you can call ANSI C free() directly instead. + * + * \param ptr the pointer + */ +LIBVLC_API void libvlc_free( void *ptr ); + +/** \defgroup libvlc_event LibVLC asynchronous events + * LibVLC emits asynchronous events. + * + * Several LibVLC objects (such @ref libvlc_instance_t as + * @ref libvlc_media_player_t) generate events asynchronously. Each of them + * provides @ref libvlc_event_manager_t event manager. You can subscribe to + * events with libvlc_event_attach() and unsubscribe with + * libvlc_event_detach(). + * @{ + */ + +/** + * Event manager that belongs to a libvlc object, and from whom events can + * be received. + */ +typedef struct libvlc_event_manager_t libvlc_event_manager_t; + +struct libvlc_event_t; + +/** + * Type of a LibVLC event. + */ +typedef int libvlc_event_type_t; + +/** + * Callback function notification + * \param p_event the event triggering the callback + */ +typedef void ( *libvlc_callback_t )( const struct libvlc_event_t *p_event, void *p_data ); + +/** + * Register for an event notification. + * + * \param p_event_manager the event manager to which you want to attach to. + * Generally it is obtained by vlc_my_object_event_manager() where + * my_object is the object you want to listen to. + * \param i_event_type the desired event to which we want to listen + * \param f_callback the function to call when i_event_type occurs + * \param user_data user provided data to carry with the event + * \return 0 on success, ENOMEM on error + */ +LIBVLC_API int libvlc_event_attach( libvlc_event_manager_t *p_event_manager, + libvlc_event_type_t i_event_type, + libvlc_callback_t f_callback, + void *user_data ); + +/** + * Unregister an event notification. + * + * \param p_event_manager the event manager + * \param i_event_type the desired event to which we want to unregister + * \param f_callback the function to call when i_event_type occurs + * \param p_user_data user provided data to carry with the event + */ +LIBVLC_API void libvlc_event_detach( libvlc_event_manager_t *p_event_manager, + libvlc_event_type_t i_event_type, + libvlc_callback_t f_callback, + void *p_user_data ); + +/** @} */ + +/** \defgroup libvlc_log LibVLC logging + * libvlc_log_* functions provide access to the LibVLC messages log. + * This is used for logging and debugging. + * @{ + */ + +/** + * Logging messages level. + * \note Future LibVLC versions may define new levels. + */ +enum libvlc_log_level +{ + LIBVLC_DEBUG=0, /**< Debug message */ + LIBVLC_NOTICE=2, /**< Important informational message */ + LIBVLC_WARNING=3, /**< Warning (potential error) message */ + LIBVLC_ERROR=4 /**< Error message */ +}; + +typedef struct vlc_log_t libvlc_log_t; + +/** + * Gets log message debug infos. + * + * This function retrieves self-debug information about a log message: + * - the name of the VLC module emitting the message, + * - the name of the source code module (i.e. file) and + * - the line number within the source code module. + * + * The returned module name and file name will be NULL if unknown. + * The returned line number will similarly be zero if unknown. + * + * \param ctx message context (as passed to the @ref libvlc_log_cb callback) + * \param module module name storage (or NULL) [OUT] + * \param file source code file name storage (or NULL) [OUT] + * \param line source code file line number storage (or NULL) [OUT] + * \warning The returned module name and source code file name, if non-NULL, + * are only valid until the logging callback returns. + * + * \version LibVLC 2.1.0 or later + */ +LIBVLC_API void libvlc_log_get_context(const libvlc_log_t *ctx, + const char **module, const char **file, unsigned *line); + +/** + * Gets log message info. + * + * This function retrieves meta-information about a log message: + * - the type name of the VLC object emitting the message, + * - the object header if any, and + * - a temporaly-unique object identifier. + * + * This information is mainly meant for manual troubleshooting. + * + * The returned type name may be "generic" if unknown, but it cannot be NULL. + * The returned header will be NULL if unset; in current versions, the header + * is used to distinguish for VLM inputs. + * The returned object ID will be zero if the message is not associated with + * any VLC object. + * + * \param ctx message context (as passed to the @ref libvlc_log_cb callback) + * \param name object name storage (or NULL) [OUT] + * \param header object header (or NULL) [OUT] + * \param id temporarily-unique object identifier (or 0) [OUT] + * \warning The returned module name and source code file name, if non-NULL, + * are only valid until the logging callback returns. + * + * \version LibVLC 2.1.0 or later + */ +LIBVLC_API void libvlc_log_get_object(const libvlc_log_t *ctx, + const char **name, const char **header, uintptr_t *id); + +/** + * Callback prototype for LibVLC log message handler. + * + * \param data data pointer as given to libvlc_log_set() + * \param level message level (@ref libvlc_log_level) + * \param ctx message context (meta-information about the message) + * \param fmt printf() format string (as defined by ISO C11) + * \param args variable argument list for the format + * \note Log message handlers must be thread-safe. + * \warning The message context pointer, the format string parameters and the + * variable arguments are only valid until the callback returns. + */ +typedef void (*libvlc_log_cb)(void *data, int level, const libvlc_log_t *ctx, + const char *fmt, va_list args); + +/** + * Unsets the logging callback. + * + * This function deregisters the logging callback for a LibVLC instance. + * This is rarely needed as the callback is implicitly unset when the instance + * is destroyed. + * + * \note This function will wait for any pending callbacks invocation to + * complete (causing a deadlock if called from within the callback). + * + * \param p_instance libvlc instance + * \version LibVLC 2.1.0 or later + */ +LIBVLC_API void libvlc_log_unset( libvlc_instance_t *p_instance ); + +/** + * Sets the logging callback for a LibVLC instance. + * + * This function is thread-safe: it will wait for any pending callbacks + * invocation to complete. + * + * \param cb callback function pointer + * \param data opaque data pointer for the callback function + * + * \note Some log messages (especially debug) are emitted by LibVLC while + * is being initialized. These messages cannot be captured with this interface. + * + * \warning A deadlock may occur if this function is called from the callback. + * + * \param p_instance libvlc instance + * \version LibVLC 2.1.0 or later + */ +LIBVLC_API void libvlc_log_set( libvlc_instance_t *p_instance, + libvlc_log_cb cb, void *data ); + + +/** + * Sets up logging to a file. + * \param p_instance libvlc instance + * \param stream FILE pointer opened for writing + * (the FILE pointer must remain valid until libvlc_log_unset()) + * \version LibVLC 2.1.0 or later + */ +LIBVLC_API void libvlc_log_set_file( libvlc_instance_t *p_instance, FILE *stream ); + +/** @} */ + +/** + * Description of a module. + */ +typedef struct libvlc_module_description_t +{ + char *psz_name; + char *psz_shortname; + char *psz_longname; + char *psz_help; + char *psz_help_html; + struct libvlc_module_description_t *p_next; +} libvlc_module_description_t; + +/** + * Release a list of module descriptions. + * + * \param p_list the list to be released + */ +LIBVLC_API +void libvlc_module_description_list_release( libvlc_module_description_t *p_list ); + +/** + * Returns a list of audio filters that are available. + * + * \param p_instance libvlc instance + * + * \return a list of module descriptions. It should be freed with libvlc_module_description_list_release(). + * In case of an error, NULL is returned. + * + * \see libvlc_module_description_t + * \see libvlc_module_description_list_release + */ +LIBVLC_API +libvlc_module_description_t *libvlc_audio_filter_list_get( libvlc_instance_t *p_instance ); + +/** + * Returns a list of video filters that are available. + * + * \param p_instance libvlc instance + * + * \return a list of module descriptions. It should be freed with libvlc_module_description_list_release(). + * In case of an error, NULL is returned. + * + * \see libvlc_module_description_t + * \see libvlc_module_description_list_release + */ +LIBVLC_API +libvlc_module_description_t *libvlc_video_filter_list_get( libvlc_instance_t *p_instance ); + +/** @} */ + +/** \defgroup libvlc_clock LibVLC time + * These functions provide access to the LibVLC time/clock. + * @{ + */ + +/** + * Return the current time as defined by LibVLC. The unit is the microsecond. + * Time increases monotonically (regardless of time zone changes and RTC + * adjustments). + * The origin is arbitrary but consistent across the whole system + * (e.g. the system uptime, the time since the system was booted). + * \note On systems that support it, the POSIX monotonic clock is used. + */ +LIBVLC_API +int64_t libvlc_clock(void); + +/** + * Return the delay (in microseconds) until a certain timestamp. + * \param pts timestamp + * \return negative if timestamp is in the past, + * positive if it is in the future + */ +static inline int64_t libvlc_delay(int64_t pts) +{ + return pts - libvlc_clock(); +} + +/** @} */ + +# ifdef __cplusplus +} +# endif + +#endif /** @} */ diff --git a/Libs/vlc/libvlc_dialog.h b/Libs/vlc/libvlc_dialog.h new file mode 100644 index 000000000..e87d8464c --- /dev/null +++ b/Libs/vlc/libvlc_dialog.h @@ -0,0 +1,260 @@ +/***************************************************************************** + * libvlc_dialog.h: libvlc dialog API + ***************************************************************************** + * Copyright © 2016 VLC authors and VideoLAN + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation; either version 2.1 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA. + *****************************************************************************/ + +#ifndef LIBVLC_DIALOG_H +#define LIBVLC_DIALOG_H 1 + +#include + +# ifdef __cplusplus +extern "C" { +# endif + +typedef struct libvlc_dialog_id libvlc_dialog_id; + +/** + * @defgroup libvlc_dialog LibVLC dialog + * @ingroup libvlc + * @{ + * @file + * LibVLC dialog external API + */ + +typedef enum libvlc_dialog_question_type +{ + LIBVLC_DIALOG_QUESTION_NORMAL, + LIBVLC_DIALOG_QUESTION_WARNING, + LIBVLC_DIALOG_QUESTION_CRITICAL, +} libvlc_dialog_question_type; + +/** + * Dialog callbacks to be implemented + * + * @attention starting with vlc 4.0.0 the error callback (pf_display_error) is + * no longer part of this struct and need to be registered separately + * using @a libvlc_dialog_set_error_callback + * + * @see libvlc_dialog_set_error_callback + */ +typedef struct libvlc_dialog_cbs +{ + /** + * Called when a login dialog needs to be displayed + * + * You can interact with this dialog by calling libvlc_dialog_post_login() + * to post an answer or libvlc_dialog_dismiss() to cancel this dialog. + * + * @note to receive this callback, libvlc_dialog_cbs.pf_cancel should not be + * NULL. + * + * @param p_data opaque pointer for the callback + * @param p_id id used to interact with the dialog + * @param psz_title title of the dialog + * @param psz_text text of the dialog + * @param psz_default_username user name that should be set on the user form + * @param b_ask_store if true, ask the user if he wants to save the + * credentials + */ + void (*pf_display_login)(void *p_data, libvlc_dialog_id *p_id, + const char *psz_title, const char *psz_text, + const char *psz_default_username, + bool b_ask_store); + + /** + * Called when a question dialog needs to be displayed + * + * You can interact with this dialog by calling libvlc_dialog_post_action() + * to post an answer or libvlc_dialog_dismiss() to cancel this dialog. + * + * @note to receive this callback, libvlc_dialog_cbs.pf_cancel should not be + * NULL. + * + * @param p_data opaque pointer for the callback + * @param p_id id used to interact with the dialog + * @param psz_title title of the dialog + * @param psz_text text of the dialog + * @param i_type question type (or severity) of the dialog + * @param psz_cancel text of the cancel button + * @param psz_action1 text of the first button, if NULL, don't display this + * button + * @param psz_action2 text of the second button, if NULL, don't display + * this button + */ + void (*pf_display_question)(void *p_data, libvlc_dialog_id *p_id, + const char *psz_title, const char *psz_text, + libvlc_dialog_question_type i_type, + const char *psz_cancel, const char *psz_action1, + const char *psz_action2); + + /** + * Called when a progress dialog needs to be displayed + * + * If cancellable (psz_cancel != NULL), you can cancel this dialog by + * calling libvlc_dialog_dismiss() + * + * @note to receive this callback, libvlc_dialog_cbs.pf_cancel and + * libvlc_dialog_cbs.pf_update_progress should not be NULL. + * + * @param p_data opaque pointer for the callback + * @param p_id id used to interact with the dialog + * @param psz_title title of the dialog + * @param psz_text text of the dialog + * @param b_indeterminate true if the progress dialog is indeterminate + * @param f_position initial position of the progress bar (between 0.0 and + * 1.0) + * @param psz_cancel text of the cancel button, if NULL the dialog is not + * cancellable + */ + void (*pf_display_progress)(void *p_data, libvlc_dialog_id *p_id, + const char *psz_title, const char *psz_text, + bool b_indeterminate, float f_position, + const char *psz_cancel); + + /** + * Called when a displayed dialog needs to be cancelled + * + * The implementation must call libvlc_dialog_dismiss() to really release + * the dialog. + * + * @param p_data opaque pointer for the callback + * @param p_id id of the dialog + */ + void (*pf_cancel)(void *p_data, libvlc_dialog_id *p_id); + + /** + * Called when a progress dialog needs to be updated + * + * @param p_data opaque pointer for the callback + * @param p_id id of the dialog + * @param f_position osition of the progress bar (between 0.0 and 1.0) + * @param psz_text new text of the progress dialog + */ + void (*pf_update_progress)(void *p_data, libvlc_dialog_id *p_id, + float f_position, const char *psz_text); +} libvlc_dialog_cbs; + + +/** + * Called when an error message needs to be displayed + * + * @param p_data opaque pointer for the callback + * @param psz_title title of the dialog + * @param psz_text text of the dialog + */ +typedef void (*libvlc_dialog_error_cbs)(void *p_data, const char *psz_title, const char *psz_text); + +/** + * Register callbacks in order to handle VLC dialogs + * + * @version LibVLC 3.0.0 and later. + * + * @param p_instance the libvlc instance to attach the dialog callbacks to + * @param p_cbs a pointer to callbacks, or NULL to unregister callbacks. + * @param p_data opaque pointer for the callback + */ +LIBVLC_API void +libvlc_dialog_set_callbacks(libvlc_instance_t *p_instance, + const libvlc_dialog_cbs *p_cbs, void *p_data); + +/* +* Register callback in order to handle VLC error messages +* +* @version LibVLC 4.0.0 and later. +* +* @param p_cbs a pointer to callback, or NULL to unregister callback. +* @param p_data opaque pointer for the callback +*/ +LIBVLC_API void +libvlc_dialog_set_error_callback(libvlc_instance_t *p_instance, + libvlc_dialog_error_cbs p_cbs, void *p_data); + +/** + * Associate an opaque pointer with the dialog id + * + * @version LibVLC 3.0.0 and later. + */ +LIBVLC_API void +libvlc_dialog_set_context(libvlc_dialog_id *p_id, void *p_context); + +/** + * Return the opaque pointer associated with the dialog id + * \see libvlc_dialog_set_context + * @version LibVLC 3.0.0 and later. + */ +LIBVLC_API void * +libvlc_dialog_get_context(libvlc_dialog_id *p_id); + +/** + * Post a login answer + * + * After this call, p_id won't be valid anymore + * + * @see libvlc_dialog_cbs.pf_display_login + * + * @version LibVLC 3.0.0 and later. + * + * @param p_id id of the dialog + * @param psz_username valid and non empty string + * @param psz_password valid string (can be empty) + * @param b_store if true, store the credentials + * @return 0 on success, or -1 on error + */ +LIBVLC_API int +libvlc_dialog_post_login(libvlc_dialog_id *p_id, const char *psz_username, + const char *psz_password, bool b_store); + +/** + * Post a question answer + * + * After this call, p_id won't be valid anymore + * + * @see libvlc_dialog_cbs.pf_display_question + * + * @version LibVLC 3.0.0 and later. + * + * @param p_id id of the dialog + * @param i_action 1 for action1, 2 for action2 + * @return 0 on success, or -1 on error + */ +LIBVLC_API int +libvlc_dialog_post_action(libvlc_dialog_id *p_id, int i_action); + +/** + * Dismiss a dialog + * + * After this call, p_id won't be valid anymore + * + * @see libvlc_dialog_cbs.pf_cancel + * + * @version LibVLC 3.0.0 and later. + * + * @param p_id id of the dialog + * @return 0 on success, or -1 on error + */ +LIBVLC_API int +libvlc_dialog_dismiss(libvlc_dialog_id *p_id); + +/** @} */ + +# ifdef __cplusplus +} +# endif + +#endif /* LIBVLC_DIALOG_H */ diff --git a/Libs/vlc/libvlc_events.h b/Libs/vlc/libvlc_events.h new file mode 100644 index 000000000..3e4de7e46 --- /dev/null +++ b/Libs/vlc/libvlc_events.h @@ -0,0 +1,457 @@ +/***************************************************************************** + * libvlc_events.h: libvlc_events external API structure + ***************************************************************************** + * Copyright (C) 1998-2010 VLC authors and VideoLAN + * + * Authors: Filippo Carone + * Pierre d'Herbemont + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation; either version 2.1 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA. + *****************************************************************************/ + +#ifndef LIBVLC_EVENTS_H +#define LIBVLC_EVENTS_H 1 + +# include +# include +# include +# include + +/** + * \file + * This file defines libvlc_event external API + */ + +# ifdef __cplusplus +extern "C" { +# else +# include +# endif + +typedef struct libvlc_renderer_item_t libvlc_renderer_item_t; +typedef struct libvlc_title_description_t libvlc_title_description_t; +typedef struct libvlc_picture_t libvlc_picture_t; +typedef struct libvlc_picture_list_t libvlc_picture_list_t; +typedef struct libvlc_media_t libvlc_media_t; +typedef struct libvlc_media_list_t libvlc_media_list_t; + +/** + * \ingroup libvlc_event + * @{ + */ + +/** + * Event types + */ +enum libvlc_event_e { + /* Append new event types at the end of a category. + * Do not remove, insert or re-order any entry. + */ + + /** + * 1 or several Metadata of a \link #libvlc_media_t media item\endlink changed + */ + libvlc_MediaMetaChanged=0, + /** + * Subitem was added to a \link #libvlc_media_t media item\endlink + * \see libvlc_media_subitems() + */ + libvlc_MediaSubItemAdded, + /** + * Deprecated, use libvlc_MediaParsedChanged or libvlc_MediaPlayerLengthChanged. + */ + libvlc_MediaDurationChanged, + /** + * Parsing state of a \link #libvlc_media_t media item\endlink changed + * \see libvlc_media_parse_request(), + * libvlc_media_get_parsed_status(), + * libvlc_media_parse_stop() + */ + libvlc_MediaParsedChanged, + + /* Removed: libvlc_MediaFreed, */ + /* Removed: libvlc_MediaStateChanged */ + + /** + * Subitem tree was added to a \link #libvlc_media_t media item\endlink + */ + libvlc_MediaSubItemTreeAdded = libvlc_MediaParsedChanged + 3, + /** + * A thumbnail generation for this \link #libvlc_media_t media \endlink completed. + * \see libvlc_media_thumbnail_request_by_time() + * \see libvlc_media_thumbnail_request_by_pos() + */ + libvlc_MediaThumbnailGenerated, + /** + * One or more embedded thumbnails were found during the media preparsing + * The user can hold these picture(s) using libvlc_picture_retain if they + * wish to use them + */ + libvlc_MediaAttachedThumbnailsFound, + + libvlc_MediaPlayerMediaChanged=0x100, + libvlc_MediaPlayerNothingSpecial, + libvlc_MediaPlayerOpening, + libvlc_MediaPlayerBuffering, + libvlc_MediaPlayerPlaying, + libvlc_MediaPlayerPaused, + libvlc_MediaPlayerStopped, + libvlc_MediaPlayerForward, + libvlc_MediaPlayerBackward, + libvlc_MediaPlayerStopping, + libvlc_MediaPlayerEncounteredError, + libvlc_MediaPlayerTimeChanged, + libvlc_MediaPlayerPositionChanged, + libvlc_MediaPlayerSeekableChanged, + libvlc_MediaPlayerPausableChanged, + /* libvlc_MediaPlayerTitleChanged, */ + libvlc_MediaPlayerSnapshotTaken = libvlc_MediaPlayerPausableChanged + 2, + libvlc_MediaPlayerLengthChanged, + libvlc_MediaPlayerVout, + + /* libvlc_MediaPlayerScrambledChanged, use libvlc_MediaPlayerProgramUpdated */ + + /** A track was added, cf. media_player_es_changed in \ref libvlc_event_t.u + * to get the id of the new track. */ + libvlc_MediaPlayerESAdded = libvlc_MediaPlayerVout + 2, + /** A track was removed, cf. media_player_es_changed in \ref + * libvlc_event_t.u to get the id of the removed track. */ + libvlc_MediaPlayerESDeleted, + /** Tracks were selected or unselected, cf. + * media_player_es_selection_changed in \ref libvlc_event_t.u to get the + * unselected and/or the selected track ids. */ + libvlc_MediaPlayerESSelected, + libvlc_MediaPlayerCorked, + libvlc_MediaPlayerUncorked, + libvlc_MediaPlayerMuted, + libvlc_MediaPlayerUnmuted, + libvlc_MediaPlayerAudioVolume, + libvlc_MediaPlayerAudioDevice, + /** A track was updated, cf. media_player_es_changed in \ref + * libvlc_event_t.u to get the id of the updated track. */ + libvlc_MediaPlayerESUpdated, + libvlc_MediaPlayerProgramAdded, + libvlc_MediaPlayerProgramDeleted, + libvlc_MediaPlayerProgramSelected, + libvlc_MediaPlayerProgramUpdated, + /** + * The title list changed, call + * libvlc_media_player_get_full_title_descriptions() to get the new list. + */ + libvlc_MediaPlayerTitleListChanged, + /** + * The title selection changed, cf media_player_title_selection_changed in + * \ref libvlc_event_t.u + */ + libvlc_MediaPlayerTitleSelectionChanged, + libvlc_MediaPlayerChapterChanged, + libvlc_MediaPlayerRecordChanged, + + /** + * A \link #libvlc_media_t media item\endlink was added to a + * \link #libvlc_media_list_t media list\endlink. + */ + libvlc_MediaListItemAdded=0x200, + /** + * A \link #libvlc_media_t media item\endlink is about to get + * added to a \link #libvlc_media_list_t media list\endlink. + */ + libvlc_MediaListWillAddItem, + /** + * A \link #libvlc_media_t media item\endlink was deleted from + * a \link #libvlc_media_list_t media list\endlink. + */ + libvlc_MediaListItemDeleted, + /** + * A \link #libvlc_media_t media item\endlink is about to get + * deleted from a \link #libvlc_media_list_t media list\endlink. + */ + libvlc_MediaListWillDeleteItem, + /** + * A \link #libvlc_media_list_t media list\endlink has reached the + * end. + * All \link #libvlc_media_t items\endlink were either added (in + * case of a \ref libvlc_media_discoverer_t) or parsed (preparser). + */ + libvlc_MediaListEndReached, + + /** + * \deprecated No longer used. + * This belonged to the removed libvlc_media_list_view_t + */ + libvlc_MediaListViewItemAdded LIBVLC_DEPRECATED =0x300, + /** + * \deprecated No longer used. + * This belonged to the removed libvlc_media_list_view_t + */ + libvlc_MediaListViewWillAddItem LIBVLC_DEPRECATED, + /** + * \deprecated No longer used. + * This belonged to the removed libvlc_media_list_view_t + */ + libvlc_MediaListViewItemDeleted LIBVLC_DEPRECATED, + /** + * \deprecated No longer used. + * This belonged to the removed libvlc_media_list_view_t + */ + libvlc_MediaListViewWillDeleteItem LIBVLC_DEPRECATED, + + /** + * Playback of a \link #libvlc_media_list_player_t media list + * player\endlink has started. + */ + libvlc_MediaListPlayerPlayed=0x400, + + /** + * The current \link #libvlc_media_t item\endlink of a + * \link #libvlc_media_list_player_t media list player\endlink + * has changed to a different item. + */ + libvlc_MediaListPlayerNextItemSet, + + /** + * Playback of a \link #libvlc_media_list_player_t media list + * player\endlink has stopped. + */ + libvlc_MediaListPlayerStopped, + + /** + * A new \link #libvlc_renderer_item_t renderer item\endlink was found by a + * \link #libvlc_renderer_discoverer_t renderer discoverer\endlink. + * The renderer item is valid until deleted. + */ + libvlc_RendererDiscovererItemAdded=0x502, + + /** + * A previously discovered \link #libvlc_renderer_item_t renderer item\endlink + * was deleted by a \link #libvlc_renderer_discoverer_t renderer discoverer\endlink. + * The renderer item is no longer valid. + */ + libvlc_RendererDiscovererItemDeleted, + + /** + * The current media set into the \ref libvlc_media_player_t is stopping. + * + * This event can be used to notify when the media callbacks, initialized + * from \ref libvlc_media_new_callbacks, should be interrupted, and in + * particular the \ref libvlc_media_read_cb. It can also be used to signal + * the application state that any input resource (webserver, file mounting, + * etc) can be discarded. Output resources still need to be active until + * the player switches to the \ref libvlc_Stopped state. + */ + libvlc_MediaPlayerMediaStopping, +}; + +/** + * A LibVLC event + */ +typedef struct libvlc_event_t +{ + int type; /**< Event type (see @ref libvlc_event_e) */ + void *p_obj; /**< Object emitting the event */ + union + { + /* media descriptor */ + struct + { + libvlc_meta_t meta_type; /**< Deprecated, any meta_type can change */ + } media_meta_changed; + struct + { + libvlc_media_t * new_child; + } media_subitem_added; + struct + { + int64_t new_duration; + } media_duration_changed; + struct + { + int new_status; /**< see @ref libvlc_media_parsed_status_t */ + } media_parsed_changed; + struct + { + int new_state; /**< see @ref libvlc_state_t */ + } media_state_changed; + struct + { + libvlc_picture_t* p_thumbnail; + } media_thumbnail_generated; + struct + { + libvlc_media_t * item; + } media_subitemtree_added; + struct + { + libvlc_picture_list_t* thumbnails; + } media_attached_thumbnails_found; + + /* media instance */ + struct + { + float new_cache; + } media_player_buffering; + struct + { + int new_chapter; + } media_player_chapter_changed; + struct + { + double new_position; + } media_player_position_changed; + struct + { + libvlc_time_t new_time; + } media_player_time_changed; + struct + { + const libvlc_title_description_t *title; + int index; + } media_player_title_selection_changed; + struct + { + int new_seekable; + } media_player_seekable_changed; + struct + { + int new_pausable; + } media_player_pausable_changed; + struct + { + int new_scrambled; + } media_player_scrambled_changed; + struct + { + int new_count; + } media_player_vout; + + /* media list */ + struct + { + libvlc_media_t * item; + int index; + } media_list_item_added; + struct + { + libvlc_media_t * item; + int index; + } media_list_will_add_item; + struct + { + libvlc_media_t * item; + int index; + } media_list_item_deleted; + struct + { + libvlc_media_t * item; + int index; + } media_list_will_delete_item; + + /* media list player */ + struct + { + libvlc_media_t * item; + } media_list_player_next_item_set; + + /* snapshot taken */ + struct + { + char* psz_filename ; + } media_player_snapshot_taken ; + + /* Length changed */ + struct + { + libvlc_time_t new_length; + } media_player_length_changed; + + /* Extra MediaPlayer */ + struct + { + libvlc_media_t * new_media; + } media_player_media_changed; + + struct + { + libvlc_media_t * media; + } media_player_media_stopping; + + + /* ESAdded, ESDeleted, ESUpdated */ + struct + { + libvlc_track_type_t i_type; + int i_id; /**< Deprecated, use psz_id */ + /** Call libvlc_media_player_get_track_from_id() to get the track + * description. */ + const char *psz_id; + } media_player_es_changed; + + /* ESSelected */ + struct + { + libvlc_track_type_t i_type; + const char *psz_unselected_id; + const char *psz_selected_id; + } media_player_es_selection_changed; + + /* ProgramAdded, ProgramDeleted, ProgramUpdated */ + struct + { + int i_id; + } media_player_program_changed; + + /* ProgramSelected */ + struct + { + int i_unselected_id; + int i_selected_id; + } media_player_program_selection_changed; + + struct + { + float volume; + } media_player_audio_volume; + + struct + { + const char *device; + } media_player_audio_device; + + struct + { + bool recording; + /** Only valid when recording ends (recording == false) */ + const char *recorded_file_path; + } media_player_record_changed; + + struct + { + libvlc_renderer_item_t *item; + } renderer_discoverer_item_added; + struct + { + libvlc_renderer_item_t *item; + } renderer_discoverer_item_deleted; + } u; /**< Type-dependent event description */ +} libvlc_event_t; + + +/**@} */ + +# ifdef __cplusplus +} +# endif + +#endif /* _LIBVLC_EVENTS_H */ diff --git a/Libs/vlc/libvlc_media.h b/Libs/vlc/libvlc_media.h new file mode 100644 index 000000000..05ae45639 --- /dev/null +++ b/Libs/vlc/libvlc_media.h @@ -0,0 +1,917 @@ +/***************************************************************************** + * libvlc_media.h: libvlc external API + ***************************************************************************** + * Copyright (C) 1998-2009 VLC authors and VideoLAN + * + * Authors: Clément Stenac + * Jean-Paul Saman + * Pierre d'Herbemont + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation; either version 2.1 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA. + *****************************************************************************/ + +#ifndef VLC_LIBVLC_MEDIA_H +#define VLC_LIBVLC_MEDIA_H 1 + +#include +#include + +# ifdef __cplusplus +extern "C" { +# else +# include +# endif +#include + +/** \defgroup libvlc_media LibVLC media + * \ingroup libvlc + * @ref libvlc_media_t is an abstract representation of a playable media. + * It consists of a media location and various optional meta data. + * @{ + * \file + * LibVLC media item/descriptor external API + */ + +typedef struct libvlc_media_t libvlc_media_t; + +/** Meta data types */ +typedef enum libvlc_meta_t { + libvlc_meta_Title, + libvlc_meta_Artist, + libvlc_meta_Genre, + libvlc_meta_Copyright, + libvlc_meta_Album, + libvlc_meta_TrackNumber, + libvlc_meta_Description, + libvlc_meta_Rating, + libvlc_meta_Date, + libvlc_meta_Setting, + libvlc_meta_URL, + libvlc_meta_Language, + libvlc_meta_NowPlaying, + libvlc_meta_Publisher, + libvlc_meta_EncodedBy, + libvlc_meta_ArtworkURL, + libvlc_meta_TrackID, + libvlc_meta_TrackTotal, + libvlc_meta_Director, + libvlc_meta_Season, + libvlc_meta_Episode, + libvlc_meta_ShowName, + libvlc_meta_Actors, + libvlc_meta_AlbumArtist, + libvlc_meta_DiscNumber, + libvlc_meta_DiscTotal + /* Add new meta types HERE */ +} libvlc_meta_t; + +/** + * libvlc media or media_player state + */ +typedef enum libvlc_state_t +{ + libvlc_NothingSpecial=0, + libvlc_Opening, + libvlc_Buffering, /* XXX: Deprecated value. Check the + * libvlc_MediaPlayerBuffering event to know the + * buffering state of a libvlc_media_player */ + libvlc_Playing, + libvlc_Paused, + libvlc_Stopped, + libvlc_Stopping, + libvlc_Error +} libvlc_state_t; + +enum +{ + libvlc_media_option_trusted = 0x2, + libvlc_media_option_unique = 0x100 +}; + +typedef struct libvlc_media_stats_t +{ + /* Input */ + uint64_t i_read_bytes; + float f_input_bitrate; + + /* Demux */ + uint64_t i_demux_read_bytes; + float f_demux_bitrate; + uint64_t i_demux_corrupted; + uint64_t i_demux_discontinuity; + + /* Decoders */ + uint64_t i_decoded_video; + uint64_t i_decoded_audio; + + /* Video Output */ + uint64_t i_displayed_pictures; + uint64_t i_late_pictures; + uint64_t i_lost_pictures; + + /* Audio output */ + uint64_t i_played_abuffers; + uint64_t i_lost_abuffers; +} libvlc_media_stats_t; + +/** + * Media type + * + * \see libvlc_media_get_type + */ +typedef enum libvlc_media_type_t { + libvlc_media_type_unknown, + libvlc_media_type_file, + libvlc_media_type_directory, + libvlc_media_type_disc, + libvlc_media_type_stream, + libvlc_media_type_playlist, +} libvlc_media_type_t; + +/** + * Parse flags used by libvlc_media_parse_request() + */ +typedef enum libvlc_media_parse_flag_t +{ + /** + * Parse media if it's a local file + */ + libvlc_media_parse_local = 0x01, + /** + * Parse media even if it's a network file + */ + libvlc_media_parse_network = 0x02, + /** + * Force parsing the media even if it would be skipped. + */ + libvlc_media_parse_forced = 0x04, + /** + * Fetch meta and cover art using local resources + */ + libvlc_media_fetch_local = 0x08, + /** + * Fetch meta and cover art using network resources + */ + libvlc_media_fetch_network = 0x10, + /** + * Interact with the user (via libvlc_dialog_cbs) when preparsing this item + * (and not its sub items). Set this flag in order to receive a callback + * when the input is asking for credentials. + */ + libvlc_media_do_interact = 0x20, +} libvlc_media_parse_flag_t; + +/** + * Parse status used sent by libvlc_media_parse_request() or returned by + * libvlc_media_get_parsed_status() + */ +typedef enum libvlc_media_parsed_status_t +{ + libvlc_media_parsed_status_none, + libvlc_media_parsed_status_pending, + libvlc_media_parsed_status_skipped, + libvlc_media_parsed_status_failed, + libvlc_media_parsed_status_timeout, + libvlc_media_parsed_status_cancelled, + libvlc_media_parsed_status_done, +} libvlc_media_parsed_status_t; + +/** + * Type of a media slave: subtitle or audio. + */ +typedef enum libvlc_media_slave_type_t +{ + libvlc_media_slave_type_subtitle, + libvlc_media_slave_type_generic, + libvlc_media_slave_type_audio = libvlc_media_slave_type_generic, +} libvlc_media_slave_type_t; + +/** + * A slave of a libvlc_media_t + * \see libvlc_media_slaves_get + */ +typedef struct libvlc_media_slave_t +{ + char * psz_uri; + libvlc_media_slave_type_t i_type; + unsigned int i_priority; +} libvlc_media_slave_t; + +/** + * Type of stat that can be requested from libvlc_media_get_filestat() + */ +#define libvlc_media_filestat_mtime 0 +#define libvlc_media_filestat_size 1 + +/** + * Callback prototype to open a custom bitstream input media. + * + * The same media item can be opened multiple times. Each time, this callback + * is invoked. It should allocate and initialize any instance-specific + * resources, then store them in *datap. The instance resources can be freed + * in the @ref libvlc_media_close_cb callback. + * + * \param opaque private pointer as passed to libvlc_media_new_callbacks() + * \param datap storage space for a private data pointer [OUT] + * \param sizep byte length of the bitstream or UINT64_MAX if unknown [OUT] + * + * \note For convenience, *datap is initially NULL and *sizep is initially 0. + * + * \return 0 on success, non-zero on error. In case of failure, the other + * callbacks will not be invoked and any value stored in *datap and *sizep is + * discarded. + */ +typedef int (*libvlc_media_open_cb)(void *opaque, void **datap, + uint64_t *sizep); + +/** + * Callback prototype to read data from a custom bitstream input media. + * + * \param opaque private pointer as set by the @ref libvlc_media_open_cb + * callback + * \param buf start address of the buffer to read data into + * \param len bytes length of the buffer + * + * \return strictly positive number of bytes read, 0 on end-of-stream, + * or -1 on non-recoverable error + * + * \note If no data is immediately available, then the callback should sleep. + * \warning The application is responsible for avoiding deadlock situations. + */ +typedef ptrdiff_t (*libvlc_media_read_cb)(void *opaque, unsigned char *buf, + size_t len); + +/** + * Callback prototype to seek a custom bitstream input media. + * + * \param opaque private pointer as set by the @ref libvlc_media_open_cb + * callback + * \param offset absolute byte offset to seek to + * \return 0 on success, -1 on error. + */ +typedef int (*libvlc_media_seek_cb)(void *opaque, uint64_t offset); + +/** + * Callback prototype to close a custom bitstream input media. + * + * \param opaque private pointer as set by the @ref libvlc_media_open_cb + * callback + */ +typedef void (*libvlc_media_close_cb)(void *opaque); + +/** + * Create a media with a certain given media resource location, + * for instance a valid URL. + * + * \note To refer to a local file with this function, + * the file://... URI syntax must be used (see IETF RFC3986). + * We recommend using libvlc_media_new_path() instead when dealing with + * local files. + * + * \see libvlc_media_release + * + * \param psz_mrl the media location + * \return the newly created media or NULL on error + */ +LIBVLC_API libvlc_media_t *libvlc_media_new_location(const char * psz_mrl); + +/** + * Create a media for a certain file path. + * + * \see libvlc_media_release + * + * \param path local filesystem path + * \return the newly created media or NULL on error + */ +LIBVLC_API libvlc_media_t *libvlc_media_new_path(const char *path); + +/** + * Create a media for an already open file descriptor. + * The file descriptor shall be open for reading (or reading and writing). + * + * Regular file descriptors, pipe read descriptors and character device + * descriptors (including TTYs) are supported on all platforms. + * Block device descriptors are supported where available. + * Directory descriptors are supported on systems that provide fdopendir(). + * Sockets are supported on all platforms where they are file descriptors, + * i.e. all except Windows. + * + * \note This library will not automatically close the file descriptor + * under any circumstance. Nevertheless, a file descriptor can usually only be + * rendered once in a media player. To render it a second time, the file + * descriptor should probably be rewound to the beginning with lseek(). + * + * \see libvlc_media_release + * + * \version LibVLC 1.1.5 and later. + * + * \param fd open file descriptor + * \return the newly created media or NULL on error + */ +LIBVLC_API libvlc_media_t *libvlc_media_new_fd(int fd); + +/** + * Create a media with custom callbacks to read the data from. + * + * \param open_cb callback to open the custom bitstream input media + * \param read_cb callback to read data (must not be NULL) + * \param seek_cb callback to seek, or NULL if seeking is not supported + * \param close_cb callback to close the media, or NULL if unnecessary + * \param opaque data pointer for the open callback + * + * \return the newly created media or NULL on error + * + * \note If open_cb is NULL, the opaque pointer will be passed to read_cb, + * seek_cb and close_cb, and the stream size will be treated as unknown. + * + * \note The callbacks may be called asynchronously (from another thread). + * A single stream instance need not be reentrant. However the open_cb needs to + * be reentrant if the media is used by multiple player instances. + * + * \warning The callbacks may be used until all or any player instances + * that were supplied the media item are stopped. + * + * \see libvlc_media_release + * + * \version LibVLC 3.0.0 and later. + */ +LIBVLC_API libvlc_media_t *libvlc_media_new_callbacks( + libvlc_media_open_cb open_cb, + libvlc_media_read_cb read_cb, + libvlc_media_seek_cb seek_cb, + libvlc_media_close_cb close_cb, + void *opaque ); + +/** + * Create a media as an empty node with a given name. + * + * \see libvlc_media_release + * + * \param psz_name the name of the node + * \return the new empty media or NULL on error + */ +LIBVLC_API libvlc_media_t *libvlc_media_new_as_node(const char * psz_name); + +/** + * Add an option to the media. + * + * This option will be used to determine how the media_player will + * read the media. This allows to use VLC's advanced + * reading/streaming options on a per-media basis. + * + * \note The options are listed in 'vlc --longhelp' from the command line, + * e.g. "--sout-all". Keep in mind that available options and their semantics + * vary across LibVLC versions and builds. + * \warning Not all options affects libvlc_media_t objects: + * Specifically, due to architectural issues most audio and video options, + * such as text renderer options, have no effects on an individual media. + * These options must be set through libvlc_new() instead. + * + * \param p_md the media descriptor + * \param psz_options the options (as a string) + */ +LIBVLC_API void libvlc_media_add_option( + libvlc_media_t *p_md, + const char * psz_options ); + +/** + * Add an option to the media with configurable flags. + * + * This option will be used to determine how the media_player will + * read the media. This allows to use VLC's advanced + * reading/streaming options on a per-media basis. + * + * The options are detailed in vlc --longhelp, for instance + * "--sout-all". Note that all options are not usable on medias: + * specifically, due to architectural issues, video-related options + * such as text renderer options cannot be set on a single media. They + * must be set on the whole libvlc instance instead. + * + * \param p_md the media descriptor + * \param psz_options the options (as a string) + * \param i_flags the flags for this option + */ +LIBVLC_API void libvlc_media_add_option_flag( + libvlc_media_t *p_md, + const char * psz_options, + unsigned i_flags ); + + +/** + * Retain a reference to a media descriptor object (libvlc_media_t). Use + * libvlc_media_release() to decrement the reference count of a + * media descriptor object. + * + * \param p_md the media descriptor + * \return the same object + */ +LIBVLC_API libvlc_media_t *libvlc_media_retain( libvlc_media_t *p_md ); + +/** + * Decrement the reference count of a media descriptor object. If the + * reference count is 0, then libvlc_media_release() will release the + * media descriptor object. If the media descriptor object has been released it + * should not be used again. + * + * \param p_md the media descriptor + */ +LIBVLC_API void libvlc_media_release( libvlc_media_t *p_md ); + + +/** + * Get the media resource locator (mrl) from a media descriptor object + * + * \param p_md a media descriptor object + * \return string with mrl of media descriptor object + */ +LIBVLC_API char *libvlc_media_get_mrl( libvlc_media_t *p_md ); + +/** + * Duplicate a media descriptor object. + * + * \warning the duplicated media won't share forthcoming updates from the + * original one. + * + * \param p_md a media descriptor object. + */ +LIBVLC_API libvlc_media_t *libvlc_media_duplicate( libvlc_media_t *p_md ); + +/** + * Read the meta of the media. + * + * Note, you need to call libvlc_media_parse_request() or play the media + * at least once before calling this function. + * If the media has not yet been parsed this will return NULL. + * + * \see libvlc_MediaMetaChanged + * + * \param p_md the media descriptor + * \param e_meta the meta to read + * \return the media's meta + */ +LIBVLC_API char *libvlc_media_get_meta( libvlc_media_t *p_md, + libvlc_meta_t e_meta ); + +/** + * Set the meta of the media (this function will not save the meta, call + * libvlc_media_save_meta in order to save the meta) + * + * \param p_md the media descriptor + * \param e_meta the meta to write + * \param psz_value the media's meta + */ +LIBVLC_API void libvlc_media_set_meta( libvlc_media_t *p_md, + libvlc_meta_t e_meta, + const char *psz_value ); + +/** + * Read the meta extra of the media. + * + * If the media has not yet been parsed this will return NULL. + * + * \see libvlc_media_parse + * \see libvlc_media_parse_with_options + * + * \param p_md the media descriptor + * \param psz_name the meta extra to read (nonnullable) + * \return the media's meta extra or NULL + */ +LIBVLC_API char *libvlc_media_get_meta_extra( libvlc_media_t *p_md, + const char *psz_name ); + +/** + * Set the meta of the media (this function will not save the meta, call + * libvlc_media_save_meta in order to save the meta) + * + * \param p_md the media descriptor + * \param psz_name the meta extra to write (nonnullable) + * \param psz_value the media's meta extra (nullable) + * Removed from meta extra if set to NULL + */ +LIBVLC_API void libvlc_media_set_meta_extra( libvlc_media_t *p_md, + const char *psz_name, + const char *psz_value ); + +/** + * Read the meta extra names of the media. + * + * \param p_md the media descriptor + * \param pppsz_names the media's meta extra name array + * you can access the elements using the return value (count) + * must be released with libvlc_media_meta_extra_names_release() + * \return the meta extra count + */ +LIBVLC_API unsigned libvlc_media_get_meta_extra_names( libvlc_media_t *p_md, + char ***pppsz_names ); + +/** + * Release a media meta extra names + * + * \param ppsz_names meta extra names array to release + * \param i_count number of elements in the array + */ +LIBVLC_API void libvlc_media_meta_extra_names_release( char **ppsz_names, + unsigned i_count ); + +/** + * Save the meta previously set + * + * \param inst LibVLC instance + * \param p_md the media descriptor + * \return true if the write operation was successful + */ +LIBVLC_API int libvlc_media_save_meta( libvlc_instance_t *inst, + libvlc_media_t *p_md ); + +/** + * Get the current statistics about the media + * \param p_md media descriptor object + * \param p_stats structure that contain the statistics about the media + * (this structure must be allocated by the caller) + * \retval true statistics are available + * \retval false otherwise + */ +LIBVLC_API bool libvlc_media_get_stats(libvlc_media_t *p_md, + libvlc_media_stats_t *p_stats); + +/* The following method uses libvlc_media_list_t, however, media_list usage is optional + * and this is here for convenience */ +#define VLC_FORWARD_DECLARE_OBJECT(a) struct a + +/** + * Get subitems of media descriptor object. This will increment + * the reference count of supplied media descriptor object. Use + * libvlc_media_list_release() to decrement the reference counting. + * + * \param p_md media descriptor object + * \return list of media descriptor subitems or NULL + */ +LIBVLC_API VLC_FORWARD_DECLARE_OBJECT(libvlc_media_list_t *) +libvlc_media_subitems( libvlc_media_t *p_md ); + +/** + * Get event manager from media descriptor object. + * NOTE: this function doesn't increment reference counting. + * + * \param p_md a media descriptor object + * \return event manager object + */ +LIBVLC_API libvlc_event_manager_t * + libvlc_media_event_manager( libvlc_media_t *p_md ); + +/** + * Get duration (in ms) of media descriptor object item. + * + * Note, you need to call libvlc_media_parse_request() or play the media + * at least once before calling this function. + * Not doing this will result in an undefined result. + * + * \param p_md media descriptor object + * \return duration of media item or -1 on error + */ +LIBVLC_API libvlc_time_t + libvlc_media_get_duration( libvlc_media_t *p_md ); + +/** + * Get a 'stat' value of media descriptor object item. + * + * \note 'stat' values are currently only parsed by directory accesses. This + * mean that only sub medias of a directory media, parsed with + * libvlc_media_parse_request() can have valid 'stat' properties. + * \version LibVLC 4.0.0 and later. + * + * \param p_md media descriptor object + * \param type a valid libvlc_media_stat_ define + * \param out field in which the value will be stored + * \return 1 on success, 0 if not found, -1 on error. + */ +LIBVLC_API int + libvlc_media_get_filestat( libvlc_media_t *p_md, unsigned type, uint64_t *out ); + +/** + * Parse the media asynchronously with options. + * + * This fetches (local or network) art, meta data and/or tracks information. + * + * To track when this is over you can listen to libvlc_MediaParsedChanged + * event. However if this functions returns an error, you will not receive any + * events. + * + * It uses a flag to specify parse options (see libvlc_media_parse_flag_t). All + * these flags can be combined. By default, media is parsed if it's a local + * file. + * + * \note Parsing can be aborted with libvlc_media_parse_stop(). + * + * \see libvlc_MediaParsedChanged + * \see libvlc_media_get_meta + * \see libvlc_media_get_tracklist + * \see libvlc_media_get_parsed_status + * \see libvlc_media_parse_flag_t + * + * \param inst LibVLC instance that is to parse the media + * \param p_md media descriptor object + * \param parse_flag parse options: + * \param timeout maximum time allowed to preparse the media. If -1, the + * default "preparse-timeout" option will be used as a timeout. If 0, it will + * wait indefinitely. If > 0, the timeout will be used (in milliseconds). + * \return -1 in case of error, 0 otherwise + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API int +libvlc_media_parse_request( libvlc_instance_t *inst, libvlc_media_t *p_md, + libvlc_media_parse_flag_t parse_flag, + int timeout ); + +/** + * Stop the parsing of the media + * + * When the media parsing is stopped, the libvlc_MediaParsedChanged event will + * be sent with the libvlc_media_parsed_status_timeout status. + * + * \see libvlc_media_parse_request() + * + * \param inst LibVLC instance that is to cease or give up parsing the media + * \param p_md media descriptor object + * \version LibVLC 3.0.0 or later + */ +LIBVLC_API void +libvlc_media_parse_stop( libvlc_instance_t *inst, libvlc_media_t *p_md ); + +/** + * Get Parsed status for media descriptor object. + * + * \see libvlc_MediaParsedChanged + * \see libvlc_media_parsed_status_t + * \see libvlc_media_parse_request() + * + * \param p_md media descriptor object + * \return a value of the libvlc_media_parsed_status_t enum + * \version LibVLC 3.0.0 or later + */ +LIBVLC_API libvlc_media_parsed_status_t + libvlc_media_get_parsed_status( libvlc_media_t *p_md ); + +/** + * Sets media descriptor's user_data. user_data is specialized data + * accessed by the host application, VLC.framework uses it as a pointer to + * an native object that references a libvlc_media_t pointer + * + * \param p_md media descriptor object + * \param p_new_user_data pointer to user data + */ +LIBVLC_API void + libvlc_media_set_user_data( libvlc_media_t *p_md, void *p_new_user_data ); + +/** + * Get media descriptor's user_data. user_data is specialized data + * accessed by the host application, VLC.framework uses it as a pointer to + * an native object that references a libvlc_media_t pointer + * + * \see libvlc_media_set_user_data + * + * \param p_md media descriptor object + */ +LIBVLC_API void *libvlc_media_get_user_data( libvlc_media_t *p_md ); + +/** + * Get the track list for one type + * + * \version LibVLC 4.0.0 and later. + * + * \note You need to call libvlc_media_parse_request() or play the media + * at least once before calling this function. Not doing this will result in + * an empty list. + * + * \see libvlc_media_tracklist_count + * \see libvlc_media_tracklist_at + * + * \param p_md media descriptor object + * \param type type of the track list to request + * + * \return a valid libvlc_media_tracklist_t or NULL in case of error, if there + * is no track for a category, the returned list will have a size of 0, delete + * with libvlc_media_tracklist_delete() + */ +LIBVLC_API libvlc_media_tracklist_t * +libvlc_media_get_tracklist( libvlc_media_t *p_md, libvlc_track_type_t type ); + +/** + * Get codec description from media elementary stream + * + * Note, you need to call libvlc_media_parse_request() or play the media + * at least once before calling this function. + * + * \version LibVLC 3.0.0 and later. + * + * \see libvlc_media_track_t + * + * \param i_type i_type from libvlc_media_track_t + * \param i_codec i_codec or i_original_fourcc from libvlc_media_track_t + * + * \return codec description + */ +LIBVLC_API +const char *libvlc_media_get_codec_description( libvlc_track_type_t i_type, + uint32_t i_codec ); + +/** + * Get the media type of the media descriptor object + * + * \version LibVLC 3.0.0 and later. + * + * \see libvlc_media_type_t + * + * \param p_md media descriptor object + * + * \return media type + */ +LIBVLC_API +libvlc_media_type_t libvlc_media_get_type( libvlc_media_t *p_md ); + +/** + * \brief libvlc_media_thumbnail_request_t An opaque thumbnail request object + */ +typedef struct libvlc_media_thumbnail_request_t libvlc_media_thumbnail_request_t; + +typedef enum libvlc_thumbnailer_seek_speed_t +{ + libvlc_media_thumbnail_seek_precise, + libvlc_media_thumbnail_seek_fast, +} libvlc_thumbnailer_seek_speed_t; + +/** + * \brief libvlc_media_request_thumbnail_by_time Start an asynchronous thumbnail generation + * + * If the request is successfully queued, the libvlc_MediaThumbnailGenerated is + * guaranteed to be emitted (except if the request is destroyed early by the + * user). + * The resulting thumbnail size can either be: + * - Hardcoded by providing both width & height. In which case, the image will + * be stretched to match the provided aspect ratio, or cropped if crop is true. + * - Derived from the media aspect ratio if only width or height is provided and + * the other one is set to 0. + * + * \param inst LibVLC instance to generate the thumbnail with + * \param md media descriptor object + * \param time The time at which the thumbnail should be generated + * \param speed The seeking speed \sa{libvlc_thumbnailer_seek_speed_t} + * \param width The thumbnail width + * \param height the thumbnail height + * \param crop Should the picture be cropped to preserve source aspect ratio + * \param picture_type The thumbnail picture type \sa{libvlc_picture_type_t} + * \param timeout A timeout value in ms, or 0 to disable timeout + * + * \return A valid opaque request object, or NULL in case of failure. + * It must be released by libvlc_media_thumbnail_request_destroy() and + * can be cancelled by calling it early. + * + * \version libvlc 4.0 or later + * + * \see libvlc_picture_t + * \see libvlc_picture_type_t + */ +LIBVLC_API libvlc_media_thumbnail_request_t* +libvlc_media_thumbnail_request_by_time( libvlc_instance_t *inst, + libvlc_media_t *md, libvlc_time_t time, + libvlc_thumbnailer_seek_speed_t speed, + unsigned int width, unsigned int height, + bool crop, libvlc_picture_type_t picture_type, + libvlc_time_t timeout ); + +/** + * \brief libvlc_media_request_thumbnail_by_pos Start an asynchronous thumbnail generation + * + * If the request is successfully queued, the libvlc_MediaThumbnailGenerated is + * guaranteed to be emitted (except if the request is destroyed early by the + * user). + * The resulting thumbnail size can either be: + * - Hardcoded by providing both width & height. In which case, the image will + * be stretched to match the provided aspect ratio, or cropped if crop is true. + * - Derived from the media aspect ratio if only width or height is provided and + * the other one is set to 0. + * + * \param inst LibVLC instance to generate the thumbnail with + * \param md media descriptor object + * \param pos The position at which the thumbnail should be generated + * \param speed The seeking speed \sa{libvlc_thumbnailer_seek_speed_t} + * \param width The thumbnail width + * \param height the thumbnail height + * \param crop Should the picture be cropped to preserve source aspect ratio + * \param picture_type The thumbnail picture type \sa{libvlc_picture_type_t} + * \param timeout A timeout value in ms, or 0 to disable timeout + * + * \return A valid opaque request object, or NULL in case of failure. + * It must be released by libvlc_media_thumbnail_request_destroy(). + * + * \version libvlc 4.0 or later + * + * \see libvlc_picture_t + * \see libvlc_picture_type_t + */ +LIBVLC_API libvlc_media_thumbnail_request_t* +libvlc_media_thumbnail_request_by_pos( libvlc_instance_t *inst, + libvlc_media_t *md, double pos, + libvlc_thumbnailer_seek_speed_t speed, + unsigned int width, unsigned int height, + bool crop, libvlc_picture_type_t picture_type, + libvlc_time_t timeout ); + +/** + * @brief libvlc_media_thumbnail_destroy destroys a thumbnail request + * @param p_req An opaque thumbnail request object. + * + * This will also cancel the thumbnail request, no events will be emitted after + * this call. + */ +LIBVLC_API void +libvlc_media_thumbnail_request_destroy( libvlc_media_thumbnail_request_t *p_req ); + +/** + * Add a slave to the current media. + * + * A slave is an external input source that may contains an additional subtitle + * track (like a .srt) or an additional audio track (like a .ac3). + * + * \note This function must be called before the media is parsed (via + * libvlc_media_parse_request()) or before the media is played (via + * libvlc_media_player_play()) + * + * \version LibVLC 3.0.0 and later. + * + * \param p_md media descriptor object + * \param i_type subtitle or audio + * \param i_priority from 0 (low priority) to 4 (high priority) + * \param psz_uri Uri of the slave (should contain a valid scheme). + * + * \return 0 on success, -1 on error. + */ +LIBVLC_API +int libvlc_media_slaves_add( libvlc_media_t *p_md, + libvlc_media_slave_type_t i_type, + unsigned int i_priority, + const char *psz_uri ); + +/** + * Clear all slaves previously added by libvlc_media_slaves_add() or + * internally. + * + * \version LibVLC 3.0.0 and later. + * + * \param p_md media descriptor object + */ +LIBVLC_API +void libvlc_media_slaves_clear( libvlc_media_t *p_md ); + +/** + * Get a media descriptor's slave list + * + * The list will contain slaves parsed by VLC or previously added by + * libvlc_media_slaves_add(). The typical use case of this function is to save + * a list of slave in a database for a later use. + * + * \version LibVLC 3.0.0 and later. + * + * \see libvlc_media_slaves_add + * + * \param p_md media descriptor object + * \param ppp_slaves address to store an allocated array of slaves (must be + * freed with libvlc_media_slaves_release()) [OUT] + * + * \return the number of slaves (zero on error) + */ +LIBVLC_API +unsigned int libvlc_media_slaves_get( libvlc_media_t *p_md, + libvlc_media_slave_t ***ppp_slaves ); + +/** + * Release a media descriptor's slave list + * + * \version LibVLC 3.0.0 and later. + * + * \param pp_slaves slave array to release + * \param i_count number of elements in the array + */ +LIBVLC_API +void libvlc_media_slaves_release( libvlc_media_slave_t **pp_slaves, + unsigned int i_count ); + +/** @}*/ + +# ifdef __cplusplus +} +# endif + +#endif /* VLC_LIBVLC_MEDIA_H */ diff --git a/Libs/vlc/libvlc_media_discoverer.h b/Libs/vlc/libvlc_media_discoverer.h new file mode 100644 index 000000000..9054c837b --- /dev/null +++ b/Libs/vlc/libvlc_media_discoverer.h @@ -0,0 +1,188 @@ +/***************************************************************************** + * libvlc_media_discoverer.h: libvlc external API + ***************************************************************************** + * Copyright (C) 1998-2009 VLC authors and VideoLAN + * + * Authors: Clément Stenac + * Jean-Paul Saman + * Pierre d'Herbemont + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation; either version 2.1 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA. + *****************************************************************************/ + +#ifndef VLC_LIBVLC_MEDIA_DISCOVERER_H +#define VLC_LIBVLC_MEDIA_DISCOVERER_H 1 + +# ifdef __cplusplus +extern "C" { +# endif + +typedef struct libvlc_media_list_t libvlc_media_list_t; + +/** + * Category of a media discoverer + * \see libvlc_media_discoverer_list_get() + */ +typedef enum libvlc_media_discoverer_category_t { + /** devices, like portable music player */ + libvlc_media_discoverer_devices, + /** LAN/WAN services, like Upnp, SMB, or SAP */ + libvlc_media_discoverer_lan, + /** Podcasts */ + libvlc_media_discoverer_podcasts, + /** Local directories, like Video, Music or Pictures directories */ + libvlc_media_discoverer_localdirs, +} libvlc_media_discoverer_category_t; + +/** + * Media discoverer description + * \see libvlc_media_discoverer_list_get() + */ +typedef struct libvlc_media_discoverer_description_t { + char *psz_name; + char *psz_longname; + libvlc_media_discoverer_category_t i_cat; +} libvlc_media_discoverer_description_t; + +/** \defgroup libvlc_media_discoverer LibVLC media discovery + * \ingroup libvlc + * LibVLC media discovery finds available media via various means. + * This corresponds to the service discovery functionality in VLC media player. + * Different plugins find potential medias locally (e.g. user media directory), + * from peripherals (e.g. video capture device), on the local network + * (e.g. SAP) or on the Internet (e.g. Internet radios). + * @{ + * \file + * LibVLC media discovery external API + */ + +typedef struct libvlc_media_discoverer_t libvlc_media_discoverer_t; + +/** + * Create a media discoverer object by name. + * + * After this object is created, you should attach to media_list events in + * order to be notified of new items discovered. + * + * You need to call libvlc_media_discoverer_start() in order to start the + * discovery. + * + * \see libvlc_media_discoverer_media_list + * \see libvlc_media_discoverer_start + * + * \param p_inst libvlc instance + * \param psz_name service name; use libvlc_media_discoverer_list_get() to get + * a list of the discoverer names available in this libVLC instance + * \return media discover object or NULL in case of error + * \version LibVLC 3.0.0 or later + */ +LIBVLC_API libvlc_media_discoverer_t * +libvlc_media_discoverer_new( libvlc_instance_t * p_inst, + const char * psz_name ); + +/** + * Start media discovery. + * + * To stop it, call libvlc_media_discoverer_stop() or + * libvlc_media_discoverer_list_release() directly. + * + * \see libvlc_media_discoverer_stop + * + * \param p_mdis media discover object + * \return -1 in case of error, 0 otherwise + * \version LibVLC 3.0.0 or later + */ +LIBVLC_API int +libvlc_media_discoverer_start( libvlc_media_discoverer_t * p_mdis ); + +/** + * Stop media discovery. + * + * \see libvlc_media_discoverer_start + * + * \param p_mdis media discover object + * \version LibVLC 3.0.0 or later + */ +LIBVLC_API void +libvlc_media_discoverer_stop( libvlc_media_discoverer_t * p_mdis ); + +/** + * Release media discover object. If the reference count reaches 0, then + * the object will be released. + * + * \param p_mdis media service discover object + */ +LIBVLC_API void +libvlc_media_discoverer_release( libvlc_media_discoverer_t * p_mdis ); + +/** + * Get media service discover media list. + * + * \param p_mdis media service discover object + * \return list of media items + */ +LIBVLC_API libvlc_media_list_t * +libvlc_media_discoverer_media_list( libvlc_media_discoverer_t * p_mdis ); + +/** + * Query if media service discover object is running. + * + * \param p_mdis media service discover object + * + * \retval true running + * \retval false not running + */ +LIBVLC_API bool +libvlc_media_discoverer_is_running(libvlc_media_discoverer_t *p_mdis); + +/** + * Get media discoverer services by category + * + * \version LibVLC 3.0.0 and later. + * + * \param p_inst libvlc instance + * \param i_cat category of services to fetch + * \param ppp_services address to store an allocated array of media discoverer + * services (must be freed with libvlc_media_discoverer_list_release() by + * the caller) [OUT] + * + * \return the number of media discoverer services (0 on error) + */ +LIBVLC_API size_t +libvlc_media_discoverer_list_get( libvlc_instance_t *p_inst, + libvlc_media_discoverer_category_t i_cat, + libvlc_media_discoverer_description_t ***ppp_services ); + +/** + * Release an array of media discoverer services + * + * \version LibVLC 3.0.0 and later. + * + * \see libvlc_media_discoverer_list_get() + * + * \param pp_services array to release + * \param i_count number of elements in the array + */ +LIBVLC_API void +libvlc_media_discoverer_list_release( libvlc_media_discoverer_description_t **pp_services, + size_t i_count ); + +/**@} */ + +# ifdef __cplusplus +} +# endif + +#endif /* */ diff --git a/Libs/vlc/libvlc_media_list.h b/Libs/vlc/libvlc_media_list.h new file mode 100644 index 000000000..ba2a340de --- /dev/null +++ b/Libs/vlc/libvlc_media_list.h @@ -0,0 +1,200 @@ +/***************************************************************************** + * libvlc_media_list.h: libvlc_media_list API + ***************************************************************************** + * Copyright (C) 1998-2008 VLC authors and VideoLAN + * + * Authors: Pierre d'Herbemont + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation; either version 2.1 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA. + *****************************************************************************/ + +#ifndef LIBVLC_MEDIA_LIST_H +#define LIBVLC_MEDIA_LIST_H 1 + +typedef struct libvlc_media_t libvlc_media_t; + +# ifdef __cplusplus +extern "C" { +# endif + +/** \defgroup libvlc_media_list LibVLC media list + * \ingroup libvlc + * A LibVLC media list holds multiple @ref libvlc_media_t media descriptors. + * @{ + * \file + * LibVLC media list (playlist) external API + */ + +typedef struct libvlc_media_list_t libvlc_media_list_t; + +/** + * Create an empty media list. + * + * \return empty media list, or NULL on error + */ +LIBVLC_API libvlc_media_list_t *libvlc_media_list_new(void); + +/** + * Release media list created with libvlc_media_list_new(). + * + * \param p_ml a media list created with libvlc_media_list_new() + */ +LIBVLC_API void + libvlc_media_list_release( libvlc_media_list_t *p_ml ); + +/** + * Retain reference to a media list + * + * \param p_ml a media list created with libvlc_media_list_new() + * \return the same object + */ +LIBVLC_API libvlc_media_list_t * + libvlc_media_list_retain( libvlc_media_list_t *p_ml ); + +/** + * Associate media instance with this media list instance. + * If another media instance was present it will be released. + * The libvlc_media_list_lock should NOT be held upon entering this function. + * + * \param p_ml a media list instance + * \param p_md media instance to add + */ +LIBVLC_API void +libvlc_media_list_set_media( libvlc_media_list_t *p_ml, libvlc_media_t *p_md ); + +/** + * Get media instance from this media list instance. This action will increase + * the refcount on the media instance. + * The libvlc_media_list_lock should NOT be held upon entering this function. + * + * \param p_ml a media list instance + * \return media instance + */ +LIBVLC_API libvlc_media_t * + libvlc_media_list_media( libvlc_media_list_t *p_ml ); + +/** + * Add media instance to media list + * The libvlc_media_list_lock should be held upon entering this function. + * + * \param p_ml a media list instance + * \param p_md a media instance + * \return 0 on success, -1 if the media list is read-only + */ +LIBVLC_API int +libvlc_media_list_add_media( libvlc_media_list_t *p_ml, libvlc_media_t *p_md ); + +/** + * Insert media instance in media list on a position + * The libvlc_media_list_lock should be held upon entering this function. + * + * \param p_ml a media list instance + * \param p_md a media instance + * \param i_pos position in array where to insert + * \return 0 on success, -1 if the media list is read-only + */ +LIBVLC_API int +libvlc_media_list_insert_media( libvlc_media_list_t *p_ml, + libvlc_media_t *p_md, int i_pos ); + +/** + * Remove media instance from media list on a position + * The libvlc_media_list_lock should be held upon entering this function. + * + * \param p_ml a media list instance + * \param i_pos position in array where to insert + * \return 0 on success, -1 if the list is read-only or the item was not found + */ +LIBVLC_API int +libvlc_media_list_remove_index( libvlc_media_list_t *p_ml, int i_pos ); + +/** + * Get count on media list items + * The libvlc_media_list_lock should be held upon entering this function. + * + * \param p_ml a media list instance + * \return number of items in media list + */ +LIBVLC_API int + libvlc_media_list_count( libvlc_media_list_t *p_ml ); + +/** + * List media instance in media list at a position + * The libvlc_media_list_lock should be held upon entering this function. + * + * \param p_ml a media list instance + * \param i_pos position in array where to insert + * \return media instance at position i_pos, or NULL if not found. + * In case of success, libvlc_media_retain() is called to increase the refcount + * on the media. + */ +LIBVLC_API libvlc_media_t * + libvlc_media_list_item_at_index( libvlc_media_list_t *p_ml, int i_pos ); +/** + * Find index position of List media instance in media list. + * Warning: the function will return the first matched position. + * The libvlc_media_list_lock should be held upon entering this function. + * + * \param p_ml a media list instance + * \param p_md media instance + * \return position of media instance or -1 if media not found + */ +LIBVLC_API int + libvlc_media_list_index_of_item( libvlc_media_list_t *p_ml, + libvlc_media_t *p_md ); + +/** + * This indicates if this media list is read-only from a user point of view + * + * \param p_ml media list instance + * \retval true read-only + * \retval false read/write + */ +LIBVLC_API bool libvlc_media_list_is_readonly(libvlc_media_list_t *p_ml); + +/** + * Get lock on media list items + * + * \param p_ml a media list instance + */ +LIBVLC_API void + libvlc_media_list_lock( libvlc_media_list_t *p_ml ); + +/** + * Release lock on media list items + * The libvlc_media_list_lock should be held upon entering this function. + * + * \param p_ml a media list instance + */ +LIBVLC_API void + libvlc_media_list_unlock( libvlc_media_list_t *p_ml ); + +/** + * Get libvlc_event_manager from this media list instance. + * The p_event_manager is immutable, so you don't have to hold the lock + * + * \param p_ml a media list instance + * \return libvlc_event_manager + */ +LIBVLC_API libvlc_event_manager_t * + libvlc_media_list_event_manager( libvlc_media_list_t *p_ml ); + +/** @} media_list */ + +# ifdef __cplusplus +} +# endif + +#endif /* _LIBVLC_MEDIA_LIST_H */ diff --git a/Libs/vlc/libvlc_media_list_player.h b/Libs/vlc/libvlc_media_list_player.h new file mode 100644 index 000000000..aa287b460 --- /dev/null +++ b/Libs/vlc/libvlc_media_list_player.h @@ -0,0 +1,249 @@ +/***************************************************************************** + * libvlc_media_list_player.h: libvlc_media_list API + ***************************************************************************** + * Copyright (C) 1998-2008 VLC authors and VideoLAN + * + * Authors: Pierre d'Herbemont + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation; either version 2.1 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA. + *****************************************************************************/ + +#ifndef LIBVLC_MEDIA_LIST_PLAYER_H +#define LIBVLC_MEDIA_LIST_PLAYER_H 1 + +#include +#include + +# ifdef __cplusplus +extern "C" { +# endif + +typedef struct libvlc_instance_t libvlc_instance_t; +typedef struct libvlc_media_player_t libvlc_media_player_t; +typedef struct libvlc_media_list_t libvlc_media_list_t; +typedef struct libvlc_media_t libvlc_media_t; + +/** \defgroup libvlc_media_list_player LibVLC media list player + * \ingroup libvlc + * The LibVLC media list player plays a @ref libvlc_media_list_t list of media, + * in a certain order. + * This is required to especially support playlist files. + * The normal @ref libvlc_media_player_t LibVLC media player can only play a + * single media, and does not handle playlist files properly. + * @{ + * \file + * LibVLC media list player external API + */ + +typedef struct libvlc_media_list_player_t libvlc_media_list_player_t; + +/** + * Defines playback modes for playlist. + */ +typedef enum libvlc_playback_mode_t +{ + libvlc_playback_mode_default, + libvlc_playback_mode_loop, + libvlc_playback_mode_repeat +} libvlc_playback_mode_t; + +/** + * Create new media_list_player. + * + * \param p_instance libvlc instance + * \return media list player instance or NULL on error + * (it must be released by libvlc_media_list_player_release()) + */ +LIBVLC_API libvlc_media_list_player_t * + libvlc_media_list_player_new( libvlc_instance_t * p_instance ); + +/** + * Release a media_list_player after use + * Decrement the reference count of a media player object. If the + * reference count is 0, then libvlc_media_list_player_release() will + * release the media player object. If the media player object + * has been released, then it should not be used again. + * + * \param p_mlp media list player instance + */ +LIBVLC_API void + libvlc_media_list_player_release( libvlc_media_list_player_t * p_mlp ); + +/** + * Retain a reference to a media player list object. Use + * libvlc_media_list_player_release() to decrement reference count. + * + * \param p_mlp media player list object + * \return the same object + */ +LIBVLC_API libvlc_media_list_player_t * + libvlc_media_list_player_retain( libvlc_media_list_player_t *p_mlp ); + +/** + * Return the event manager of this media_list_player. + * + * \param p_mlp media list player instance + * \return the event manager + */ +LIBVLC_API libvlc_event_manager_t * + libvlc_media_list_player_event_manager(libvlc_media_list_player_t * p_mlp); + +/** + * Replace media player in media_list_player with this instance. + * + * \param p_mlp media list player instance + * \param p_mi media player instance + */ +LIBVLC_API void + libvlc_media_list_player_set_media_player( + libvlc_media_list_player_t * p_mlp, + libvlc_media_player_t * p_mi ); + +/** + * Get media player of the media_list_player instance. + * + * \param p_mlp media list player instance + * \return media player instance + * \note the caller is responsible for releasing the returned instance + with libvlc_media_list_player_set_media_player(). + */ +LIBVLC_API libvlc_media_player_t * + libvlc_media_list_player_get_media_player(libvlc_media_list_player_t * p_mlp); + +/** + * Set the media list associated with the player + * + * \param p_mlp media list player instance + * \param p_mlist list of media + */ +LIBVLC_API void + libvlc_media_list_player_set_media_list( + libvlc_media_list_player_t * p_mlp, + libvlc_media_list_t * p_mlist ); + +/** + * Play media list + * + * \param p_mlp media list player instance + */ +LIBVLC_API +void libvlc_media_list_player_play(libvlc_media_list_player_t * p_mlp); + +/** + * Toggle pause (or resume) media list + * + * \param p_mlp media list player instance + */ +LIBVLC_API +void libvlc_media_list_player_pause(libvlc_media_list_player_t * p_mlp); + +/** + * Pause or resume media list + * + * \param p_mlp media list player instance + * \param do_pause play/resume if zero, pause if non-zero + * \version LibVLC 3.0.0 or later + */ +LIBVLC_API +void libvlc_media_list_player_set_pause(libvlc_media_list_player_t * p_mlp, + int do_pause); + +/** + * Is media list playing? + * + * \param p_mlp media list player instance + * + * \retval true playing + * \retval false not playing + */ +LIBVLC_API bool +libvlc_media_list_player_is_playing(libvlc_media_list_player_t * p_mlp); + +/** + * Get current libvlc_state of media list player + * + * \param p_mlp media list player instance + * \return libvlc_state_t for media list player + */ +LIBVLC_API libvlc_state_t + libvlc_media_list_player_get_state( libvlc_media_list_player_t * p_mlp ); + +/** + * Play media list item at position index + * + * \param p_mlp media list player instance + * \param i_index index in media list to play + * \return 0 upon success -1 if the item wasn't found + */ +LIBVLC_API +int libvlc_media_list_player_play_item_at_index(libvlc_media_list_player_t * p_mlp, + int i_index); + +/** + * Play the given media item + * + * \param p_mlp media list player instance + * \param p_md the media instance + * \return 0 upon success, -1 if the media is not part of the media list + */ +LIBVLC_API +int libvlc_media_list_player_play_item(libvlc_media_list_player_t * p_mlp, + libvlc_media_t * p_md); + +/** + * Stop playing media list + * + * \param p_mlp media list player instance + */ +LIBVLC_API void + libvlc_media_list_player_stop_async( libvlc_media_list_player_t * p_mlp); + +/** + * Play next item from media list + * + * \param p_mlp media list player instance + * \return 0 upon success -1 if there is no next item + */ +LIBVLC_API +int libvlc_media_list_player_next(libvlc_media_list_player_t * p_mlp); + +/** + * Play previous item from media list + * + * \param p_mlp media list player instance + * \return 0 upon success -1 if there is no previous item + */ +LIBVLC_API +int libvlc_media_list_player_previous(libvlc_media_list_player_t * p_mlp); + + + +/** + * Sets the playback mode for the playlist + * + * \param p_mlp media list player instance + * \param e_mode playback mode specification + */ +LIBVLC_API +void libvlc_media_list_player_set_playback_mode(libvlc_media_list_player_t * p_mlp, + libvlc_playback_mode_t e_mode ); + +/** @} media_list_player */ + +# ifdef __cplusplus +} +# endif + +#endif /* LIBVLC_MEDIA_LIST_PLAYER_H */ diff --git a/Libs/vlc/libvlc_media_player.h b/Libs/vlc/libvlc_media_player.h new file mode 100644 index 000000000..982e70ad3 --- /dev/null +++ b/Libs/vlc/libvlc_media_player.h @@ -0,0 +1,3304 @@ +/***************************************************************************** + * libvlc_media_player.h: libvlc_media_player external API + ***************************************************************************** + * Copyright (C) 1998-2024 VLC authors and VideoLAN + * + * Authors: Clément Stenac + * Jean-Paul Saman + * Pierre d'Herbemont + * Maxime Chapelet + * Alexandre Janniaux + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation; either version 2.1 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA. + *****************************************************************************/ + +#ifndef VLC_LIBVLC_MEDIA_PLAYER_H +#define VLC_LIBVLC_MEDIA_PLAYER_H 1 + +/* Definitions of enum properties for video */ +#include "libvlc_video.h" + +# ifdef __cplusplus +extern "C" { +# else +# include +# endif + +typedef struct libvlc_video_viewpoint_t libvlc_video_viewpoint_t; +typedef enum libvlc_media_slave_type_t libvlc_media_slave_type_t; +typedef struct libvlc_media_t libvlc_media_t; +typedef struct libvlc_media_track_t libvlc_media_track_t; +typedef struct libvlc_media_tracklist_t libvlc_media_tracklist_t; +typedef enum libvlc_track_type_t libvlc_track_type_t; +typedef struct libvlc_renderer_item_t libvlc_renderer_item_t; +typedef enum libvlc_state_t libvlc_state_t; + +/** \defgroup libvlc_media_player LibVLC media player + * \ingroup libvlc + * A LibVLC media player plays one media (usually in a custom drawable). + * @{ + * \file + * LibVLC simple media player external API + */ + +typedef struct libvlc_media_player_t libvlc_media_player_t; + +/** + * Description for titles + */ +enum +{ + libvlc_title_menu = 0x01, + libvlc_title_interactive = 0x02 +}; + +typedef struct libvlc_title_description_t +{ + int64_t i_duration; /**< duration in milliseconds */ + char *psz_name; /**< title name */ + unsigned i_flags; /**< info if item was recognized as a menu, interactive or plain content by the demuxer */ +} libvlc_title_description_t; + +/** + * Description for chapters + */ +typedef struct libvlc_chapter_description_t +{ + int64_t i_time_offset; /**< time-offset of the chapter in milliseconds */ + int64_t i_duration; /**< duration of the chapter in milliseconds */ + char *psz_name; /**< chapter name */ +} libvlc_chapter_description_t; + +/** + * Description for audio output. It contains + * name, description and pointer to next record. + */ +typedef struct libvlc_audio_output_t +{ + char *psz_name; + char *psz_description; + struct libvlc_audio_output_t *p_next; + +} libvlc_audio_output_t; + +/** + * Description for audio output device. + */ +typedef struct libvlc_audio_output_device_t +{ + struct libvlc_audio_output_device_t *p_next; /**< Next entry in list */ + char *psz_device; /**< Device identifier string */ + char *psz_description; /**< User-friendly device description */ + /* More fields may be added here in later versions */ +} libvlc_audio_output_device_t; + +/** + * Marq options definition + */ +typedef enum libvlc_video_marquee_option_t { + libvlc_marquee_Enable = 0, + libvlc_marquee_Text, /** string argument */ + libvlc_marquee_Color, + libvlc_marquee_Opacity, + libvlc_marquee_Position, + libvlc_marquee_Refresh, + libvlc_marquee_Size, + libvlc_marquee_Timeout, + libvlc_marquee_X, + libvlc_marquee_Y +} libvlc_video_marquee_option_t; + +/** + * Navigation mode + */ +typedef enum libvlc_navigate_mode_t +{ + libvlc_navigate_activate = 0, + libvlc_navigate_up, + libvlc_navigate_down, + libvlc_navigate_left, + libvlc_navigate_right, + libvlc_navigate_popup +} libvlc_navigate_mode_t; + +/** + * Enumeration of values used to set position (e.g. of video title). + */ +typedef enum libvlc_position_t { + libvlc_position_disable=-1, + libvlc_position_center, + libvlc_position_left, + libvlc_position_right, + libvlc_position_top, + libvlc_position_top_left, + libvlc_position_top_right, + libvlc_position_bottom, + libvlc_position_bottom_left, + libvlc_position_bottom_right +} libvlc_position_t; + +/** + * Enumeration of values used to set the video fitting inside the display area. + */ +typedef enum libvlc_video_fit_mode_t { + libvlc_video_fit_none = 0, /**< Explicit zoom set by \ref libvlc_video_set_scale */ + libvlc_video_fit_smaller, /**< Fit inside / to smallest display dimension */ + libvlc_video_fit_larger, /**< Fit outside / to largest display dimension */ + libvlc_video_fit_width, /**< Fit to display width */ + libvlc_video_fit_height, /**< Fit to display height */ +} libvlc_video_fit_mode_t; + +/** + * Enumeration of teletext keys than can be passed via + * libvlc_video_set_teletext() + */ +typedef enum libvlc_teletext_key_t { + libvlc_teletext_key_red = 'r' << 16, + libvlc_teletext_key_green = 'g' << 16, + libvlc_teletext_key_yellow = 'y' << 16, + libvlc_teletext_key_blue = 'b' << 16, + libvlc_teletext_key_index = 'i' << 16, +} libvlc_teletext_key_t; + +/** + * A to B loop state + */ +typedef enum libvlc_abloop_t { + libvlc_abloop_none, + libvlc_abloop_a, + libvlc_abloop_b, +} libvlc_abloop_t; + +/** + * Opaque equalizer handle. + * + * Equalizer settings can be applied to a media player. + */ +typedef struct libvlc_equalizer_t libvlc_equalizer_t; + +/** + * Create an empty Media Player object + * + * \param p_libvlc_instance the libvlc instance in which the Media Player + * should be created. + * \return a new media player object, or NULL on error. + * It must be released by libvlc_media_player_release(). + */ +LIBVLC_API libvlc_media_player_t * libvlc_media_player_new( libvlc_instance_t *p_libvlc_instance ); + +/** + * Create a Media Player object from a Media + * + * \param inst LibVLC instance to create a media player with + * \param p_md the media. Afterwards the p_md can be safely + * destroyed. + * \return a new media player object, or NULL on error. + * It must be released by libvlc_media_player_release(). + */ +LIBVLC_API libvlc_media_player_t * libvlc_media_player_new_from_media( libvlc_instance_t *inst, libvlc_media_t *p_md ); + +/** + * Release a media_player after use + * Decrement the reference count of a media player object. If the + * reference count is 0, then libvlc_media_player_release() will + * release the media player object. If the media player object + * has been released, then it should not be used again. + * + * \param p_mi the Media Player to free + */ +LIBVLC_API void libvlc_media_player_release( libvlc_media_player_t *p_mi ); + +/** + * Retain a reference to a media player object. Use + * libvlc_media_player_release() to decrement reference count. + * + * \param p_mi media player object + * \return the same object + */ +LIBVLC_API libvlc_media_player_t *libvlc_media_player_retain( libvlc_media_player_t *p_mi ); + +/** + * Set the media that will be used by the media_player. If any, + * previous md will be released. + * + * \note The user should listen to the libvlc_MediaPlayerMediaChanged event, to + * know when the new media is actually used by the player (or to known that the + * older media is no longer used). + * + * \param p_mi the Media Player + * \param p_md the Media. Afterwards the p_md can be safely + * destroyed. + */ +LIBVLC_API void libvlc_media_player_set_media( libvlc_media_player_t *p_mi, + libvlc_media_t *p_md ); + +/** + * Get the media used by the media_player. + * + * \warning Calling this function just after libvlc_media_player_set_media() + * will return the media that was just set, but this media might not be + * currently used internally by the player. To detect such case, the user + * should listen to the libvlc_MediaPlayerMediaChanged event. + * + * \param p_mi the Media Player + * \return the media associated with p_mi, or NULL if no + * media is associated + */ +LIBVLC_API libvlc_media_t * libvlc_media_player_get_media( libvlc_media_player_t *p_mi ); + +/** + * Get the Event Manager from which the media player send event. + * + * \param p_mi the Media Player + * \return the event manager associated with p_mi + */ +LIBVLC_API libvlc_event_manager_t * libvlc_media_player_event_manager ( libvlc_media_player_t *p_mi ); + +/** + * is_playing + * + * \param p_mi the Media Player + * \retval true media player is playing + * \retval false media player is not playing + */ +LIBVLC_API bool libvlc_media_player_is_playing(libvlc_media_player_t *p_mi); + +/** + * Play + * + * \param p_mi the Media Player + * \return 0 if playback started (and was already started), or -1 on error. + */ +LIBVLC_API int libvlc_media_player_play ( libvlc_media_player_t *p_mi ); + +/** + * Pause or resume (no effect if there is no media) + * + * \param mp the Media Player + * \param do_pause play/resume if zero, pause if non-zero + * \version LibVLC 1.1.1 or later + */ +LIBVLC_API void libvlc_media_player_set_pause ( libvlc_media_player_t *mp, + int do_pause ); + +/** + * Toggle pause (no effect if there is no media) + * + * \param p_mi the Media Player + */ +LIBVLC_API void libvlc_media_player_pause ( libvlc_media_player_t *p_mi ); + +/** + * Stop asynchronously + * + * \note This function is asynchronous. In case of success, the user should + * wait for the libvlc_MediaPlayerStopped event to know when the stop is + * finished. + * + * \param p_mi the Media Player + * \return 0 if the player is being stopped, -1 otherwise (no-op) + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API int libvlc_media_player_stop_async ( libvlc_media_player_t *p_mi ); + +/** + * Set a renderer to the media player + * + * \note must be called before the first call of libvlc_media_player_play() to + * take effect. + * + * \see libvlc_renderer_discoverer_new + * + * \param p_mi the Media Player + * \param p_item an item discovered by libvlc_renderer_discoverer_start() + * \return 0 on success, -1 on error. + * \version LibVLC 3.0.0 or later + */ +LIBVLC_API int libvlc_media_player_set_renderer( libvlc_media_player_t *p_mi, + libvlc_renderer_item_t *p_item ); + +/** + * Enumeration of the Video color primaries. + */ +typedef enum libvlc_video_color_primaries_t { + libvlc_video_primaries_BT601_525 = 1, + libvlc_video_primaries_BT601_625 = 2, + libvlc_video_primaries_BT709 = 3, + libvlc_video_primaries_BT2020 = 4, + libvlc_video_primaries_DCI_P3 = 5, + libvlc_video_primaries_BT470_M = 6, +} libvlc_video_color_primaries_t; + +/** + * Enumeration of the Video color spaces. + */ +typedef enum libvlc_video_color_space_t { + libvlc_video_colorspace_BT601 = 1, + libvlc_video_colorspace_BT709 = 2, + libvlc_video_colorspace_BT2020 = 3, +} libvlc_video_color_space_t; + +/** + * Enumeration of the Video transfer functions. + */ +typedef enum libvlc_video_transfer_func_t { + libvlc_video_transfer_func_LINEAR = 1, + libvlc_video_transfer_func_SRGB = 2, + libvlc_video_transfer_func_BT470_BG = 3, + libvlc_video_transfer_func_BT470_M = 4, + libvlc_video_transfer_func_BT709 = 5, + libvlc_video_transfer_func_PQ = 6, + libvlc_video_transfer_func_SMPTE_240 = 7, + libvlc_video_transfer_func_HLG = 8, +} libvlc_video_transfer_func_t; + + +/** + * Callback prototype to allocate and lock a picture buffer. + * + * Whenever a new video frame needs to be decoded, the lock callback is + * invoked. Depending on the video chroma, one or three pixel planes of + * adequate dimensions must be returned via the second parameter. Those + * planes must be aligned on 32-bytes boundaries. + * + * \param[in] opaque private pointer as passed to libvlc_video_set_callbacks() + * \param[out] planes start address of the pixel planes (LibVLC allocates the array + * of void pointers, this callback must initialize the array) + * \return a private pointer for the display and unlock callbacks to identify + * the picture buffers + */ +typedef void *(*libvlc_video_lock_cb)(void *opaque, void **planes); + +/** + * Callback prototype to unlock a picture buffer. + * + * When the video frame decoding is complete, the unlock callback is invoked. + * This callback might not be needed at all. It is only an indication that the + * application can now read the pixel values if it needs to. + * + * \note A picture buffer is unlocked after the picture is decoded, + * but before the picture is displayed. + * + * \param[in] opaque private pointer as passed to libvlc_video_set_callbacks() + * \param[in] picture private pointer returned from the @ref libvlc_video_lock_cb + * callback + * \param[in] planes pixel planes as defined by the @ref libvlc_video_lock_cb + * callback (this parameter is only for convenience) + */ +typedef void (*libvlc_video_unlock_cb)(void *opaque, void *picture, + void *const *planes); + +/** + * Callback prototype to display a picture. + * + * When the video frame needs to be shown, as determined by the media playback + * clock, the display callback is invoked. + * + * \param[in] opaque private pointer as passed to libvlc_video_set_callbacks() + * \param[in] picture private pointer returned from the @ref libvlc_video_lock_cb + * callback + */ +typedef void (*libvlc_video_display_cb)(void *opaque, void *picture); + +/** + * Callback prototype to configure picture buffers format. + * This callback gets the format of the video as output by the video decoder + * and the chain of video filters (if any). It can opt to change any parameter + * as it needs. In that case, LibVLC will attempt to convert the video format + * (rescaling and chroma conversion) but these operations can be CPU intensive. + * + * \param[in,out] opaque pointer to the private pointer passed to + * libvlc_video_set_callbacks() + * \param[in,out] chroma pointer to the 4 bytes video format identifier + * \param[in,out] width pointer to the buffer width in pixels + * \param[in,out] height pointer to the buffer height in pixels + * \param[out] pitches table of scanline pitches in bytes for each pixel plane + * (the table is allocated by LibVLC) + * \param[out] lines table of scanlines count for each plane + * \return the number of picture buffers allocated, 0 indicates failure + * + * \version LibVLC 4.0.0 and later. + * \param[in] width pointer to display width - 1 in pixels + * \param[in] height pointer to display height - 1 in pixels + * + * \note + * For each pixels plane, the scanline pitch must be bigger than or equal to + * the number of bytes per pixel multiplied by the pixel width. + * Similarly, the number of scanlines must be bigger than of equal to + * the pixel height. + * Furthermore, we recommend that pitches and lines be multiple of 32 + * to not break assumptions that might be held by optimized code + * in the video decoders, video filters and/or video converters. + */ +typedef unsigned (*libvlc_video_format_cb)(void **opaque, char *chroma, + unsigned *width, unsigned *height, + unsigned *pitches, + unsigned *lines); + +/** + * Callback prototype to configure picture buffers format. + * + * \param[in] opaque private pointer as passed to libvlc_video_set_format_callbacks() + * (and possibly modified by @ref libvlc_video_format_cb) + */ +typedef void (*libvlc_video_cleanup_cb)(void *opaque); + + +/** + * Set callbacks and private data to render decoded video to a custom area + * in memory. + * Use libvlc_video_set_format() or libvlc_video_set_format_callbacks() + * to configure the decoded format. + * + * \warning Rendering video into custom memory buffers is considerably less + * efficient than rendering in a custom window as normal. + * + * For optimal performances, VLC media player renders into a custom window, and + * does not use this function and associated callbacks. It is highly + * recommended that other LibVLC-based application do likewise. + * To embed video in a window, use libvlc_media_player_set_xwindow() or + * equivalent depending on the operating system. + * + * If window embedding does not fit the application use case, then a custom + * LibVLC video output display plugin is required to maintain optimal video + * rendering performances. + * + * The following limitations affect performance: + * - Hardware video decoding acceleration will either be disabled completely, + * or require (relatively slow) copy from video/DSP memory to main memory. + * - Sub-pictures (subtitles, on-screen display, etc.) must be blent into the + * main picture by the CPU instead of the GPU. + * - Depending on the video format, pixel format conversion, picture scaling, + * cropping and/or picture re-orientation, must be performed by the CPU + * instead of the GPU. + * - Memory copying is required between LibVLC reference picture buffers and + * application buffers (between lock and unlock callbacks). + * + * \param mp the media player + * \param lock callback to lock video memory (must not be NULL) + * \param unlock callback to unlock video memory (or NULL if not needed) + * \param display callback to display video (or NULL if not needed) + * \param opaque private pointer for the three callbacks (as first parameter) + * \version LibVLC 1.1.1 or later + */ +LIBVLC_API +void libvlc_video_set_callbacks( libvlc_media_player_t *mp, + libvlc_video_lock_cb lock, + libvlc_video_unlock_cb unlock, + libvlc_video_display_cb display, + void *opaque ); + +/** + * Set decoded video chroma and dimensions. + * This only works in combination with libvlc_video_set_callbacks(), + * and is mutually exclusive with libvlc_video_set_format_callbacks(). + * + * \param mp the media player + * \param chroma a four-characters string identifying the chroma + * (e.g. "RV32" or "YUYV") + * \param width pixel width + * \param height pixel height + * \param pitch line pitch (in bytes) + * \version LibVLC 1.1.1 or later + * \bug All pixel planes are expected to have the same pitch. + * To use the YCbCr color space with chrominance subsampling, + * consider using libvlc_video_set_format_callbacks() instead. + */ +LIBVLC_API +void libvlc_video_set_format( libvlc_media_player_t *mp, const char *chroma, + unsigned width, unsigned height, + unsigned pitch ); + +/** + * Set decoded video chroma and dimensions. This only works in combination with + * libvlc_video_set_callbacks(). + * + * \param mp the media player + * \param setup callback to select the video format (cannot be NULL) + * \param cleanup callback to release any allocated resources (or NULL) + * \version LibVLC 2.0.0 or later + */ +LIBVLC_API +void libvlc_video_set_format_callbacks( libvlc_media_player_t *mp, + libvlc_video_format_cb setup, + libvlc_video_cleanup_cb cleanup ); + + +typedef struct libvlc_video_setup_device_cfg_t +{ + bool hardware_decoding; /** set if D3D11_CREATE_DEVICE_VIDEO_SUPPORT is needed for D3D11 */ +} libvlc_video_setup_device_cfg_t; + +typedef struct libvlc_video_setup_device_info_t +{ + union { + struct { + void *device_context; /** ID3D11DeviceContext* */ + void *context_mutex; /** Windows Mutex HANDLE to protect ID3D11DeviceContext usage */ + } d3d11; + struct { + void *device; /** IDirect3D9* */ + int adapter; /** Adapter to use with the IDirect3D9* */ + } d3d9; + }; +} libvlc_video_setup_device_info_t; + +/** + * Callback prototype called to initialize user data. + * Setup the rendering environment. + * + * \param[in,out] opaque private pointer passed to the @a libvlc_video_set_output_callbacks() + * on input. The callback can change this value on output to be + * passed to all the other callbacks set on @a libvlc_video_set_output_callbacks(). + * \param[in] cfg requested configuration of the video device + * \param[out] out libvlc_video_setup_device_info_t* to fill + * \return true on success + * \version LibVLC 4.0.0 or later + * + * For \ref libvlc_video_engine_d3d9 the output must be a IDirect3D9*. + * A reference to this object is held until the \ref libvlc_video_output_cleanup_cb is called. + * the device must be created with D3DPRESENT_PARAMETERS.hDeviceWindow set to 0. + * + * For \ref libvlc_video_engine_d3d11 the output must be a ID3D11DeviceContext*. + * A reference to this object is held until the \ref libvlc_video_output_cleanup_cb is called. + * The ID3D11Device used to create ID3D11DeviceContext must have multithreading enabled. + * + * If the ID3D11DeviceContext is used outside of the callbacks called by libvlc, the host + * MUST use a mutex to protect the access to the ID3D11DeviceContext of libvlc. This mutex + * value is set on d3d11.context_mutex. If the ID3D11DeviceContext is not used outside of + * the callbacks, the mutex d3d11.context_mutex may be NULL. + */ +typedef bool (*libvlc_video_output_setup_cb)(void **opaque, + const libvlc_video_setup_device_cfg_t *cfg, + libvlc_video_setup_device_info_t *out); + + +/** + * Callback prototype called to release user data + * + * \param[in] opaque private pointer set on the opaque parameter of @a libvlc_video_output_setup_cb() + * \version LibVLC 4.0.0 or later + */ +typedef void (*libvlc_video_output_cleanup_cb)(void* opaque); + +typedef struct libvlc_video_render_cfg_t +{ + /** rendering video width in pixel */ + unsigned width; + /** rendering video height in pixel */ + unsigned height; + /** rendering video bit depth in bits per channel */ + unsigned bitdepth; + /** video is full range or studio/limited range */ + bool full_range; + /** video color space */ + libvlc_video_color_space_t colorspace; + /** video color primaries */ + libvlc_video_color_primaries_t primaries; + /** video transfer function */ + libvlc_video_transfer_func_t transfer; + /** device used for rendering, IDirect3DDevice9* for D3D9 */ + void *device; +} libvlc_video_render_cfg_t; + +typedef struct libvlc_video_output_cfg_t +{ + union { + /** The rendering DXGI_FORMAT for \ref libvlc_video_engine_d3d11. */ + int dxgi_format; + /** The rendering D3DFORMAT for \ref libvlc_video_engine_d3d9. */ + uint32_t d3d9_format; + /** The rendering GLint GL_RGBA or GL_RGB for + * \ref libvlc_video_engine_opengl and for + * \ref libvlc_video_engine_gles2. */ + int opengl_format; + /** currently unused */ + void *p_surface; + struct { + /** Pointer to an ANativeWindow, used for video rendering */ + void *video; + /** Pointer to an ANativeWindow, used for subtitles rendering, if + * blending subtitles into the video surface is not possible (when + * using MediaCodec with direct hw rendering) */ + void *subtitle; + } anw; + }; + /** Video is full range or studio/limited range. */ + bool full_range; + /** video color space */ + libvlc_video_color_space_t colorspace; + /** video color primaries */ + libvlc_video_color_primaries_t primaries; + /** video transfer function */ + libvlc_video_transfer_func_t transfer; + /** video surface orientation */ + libvlc_video_orient_t orientation; +} libvlc_video_output_cfg_t; + +/** + * Callback prototype called on video size changes. + * Update the rendering output setup. + * + * \param[in] opaque private pointer set on the opaque parameter of @a libvlc_video_output_setup_cb() + * \param[in] cfg configuration of the video that will be rendered + * \param[out] output configuration describing with how the rendering is setup + * \version LibVLC 4.0.0 or later + * + * \note the configuration device for Direct3D9 is the IDirect3DDevice9 that VLC + * uses to render. The host must set a Render target and call Present() + * when it needs the drawing from VLC to be done. This object is not valid + * anymore after Cleanup is called. + * Tone mapping, range and color conversion will be done depending on the + * values set in the output structure. It can be ignored in the \ref + * libvlc_video_engine_anw case. + */ +typedef bool (*libvlc_video_update_output_cb)(void* opaque, const libvlc_video_render_cfg_t *cfg, + libvlc_video_output_cfg_t *output ); + + +/** + * Callback prototype called after performing drawing calls. + * + * This callback is called outside of libvlc_video_makeCurrent_cb current/not-current + * calls. + * + * \param[in] opaque private pointer set on the opaque parameter of @a libvlc_video_output_setup_cb() + * \version LibVLC 4.0.0 or later + */ +typedef void (*libvlc_video_swap_cb)(void* opaque); + +/** + * Callback prototype to set up the OpenGL context for rendering. + * Tell the host the rendering is about to start/has finished. + * + * \param[in] opaque private pointer set on the opaque parameter of @a libvlc_video_output_setup_cb() + * \param[in] enter true to set the context as current, false to unset it + * \return true on success + * \version LibVLC 4.0.0 or later + * + * On Direct3D11 the following may change on the provided ID3D11DeviceContext* + * between \p enter being true and \p enter being false: + * - IASetPrimitiveTopology() + * - IASetInputLayout() + * - IASetVertexBuffers() + * - IASetIndexBuffer() + * - VSSetConstantBuffers() + * - VSSetShader() + * - PSSetSamplers() + * - PSSetConstantBuffers() + * - PSSetShaderResources() + * - PSSetShader() + * - RSSetViewports() + * - DrawIndexed() + */ +typedef bool (*libvlc_video_makeCurrent_cb)(void* opaque, bool enter); + +/** + * Callback prototype to load opengl functions + * + * \param[in] opaque private pointer set on the opaque parameter of @a libvlc_video_output_setup_cb() + * \param fct_name name of the opengl function to load + * \return a pointer to the named OpenGL function the NULL otherwise + * \version LibVLC 4.0.0 or later + */ +typedef void* (*libvlc_video_getProcAddress_cb)(void* opaque, const char* fct_name); + +typedef struct libvlc_video_frame_hdr10_metadata_t +{ + /* similar to SMPTE ST 2086 mastering display color volume */ + uint16_t RedPrimary[2]; + uint16_t GreenPrimary[2]; + uint16_t BluePrimary[2]; + uint16_t WhitePoint[2]; + unsigned int MaxMasteringLuminance; + unsigned int MinMasteringLuminance; + uint16_t MaxContentLightLevel; + uint16_t MaxFrameAverageLightLevel; +} libvlc_video_frame_hdr10_metadata_t; + +typedef enum libvlc_video_metadata_type_t { + libvlc_video_metadata_frame_hdr10, /**< libvlc_video_frame_hdr10_metadata_t */ +} libvlc_video_metadata_type_t; + +/** + * Callback prototype to receive metadata before rendering. + * + * \param[in] opaque private pointer passed to the @a libvlc_video_set_output_callbacks() + * \param[in] type type of data passed in metadata + * \param[in] metadata the type of metadata + * \version LibVLC 4.0.0 or later + */ +typedef void (*libvlc_video_frameMetadata_cb)(void* opaque, libvlc_video_metadata_type_t type, const void *metadata); + +/** + * Enumeration of the Video engine to be used on output. + * can be passed to @a libvlc_video_set_output_callbacks + */ +typedef enum libvlc_video_engine_t { + /** Disable rendering engine */ + libvlc_video_engine_disable, + libvlc_video_engine_opengl, + libvlc_video_engine_gles2, + /** Direct3D11 rendering engine */ + libvlc_video_engine_d3d11, + /** Direct3D9 rendering engine */ + libvlc_video_engine_d3d9, + + /** + * Android ANativeWindow. It can be set in \ref libvlc_video_output_cfg_t + * from the \ref libvlc_video_update_output_cb callback. The ANativeWindow + * can be created via: + * - 'ANativeWindow_fromSurface': from a JAVA SurfaceView + * - 'AImageReader_getWindow()': from an 'AImageReader' created with the + * following arguments: \verbatim + AImageReader_newWithUsage(1, 1 AIMAGE_FORMAT_PRIVATE, + AHARDWAREBUFFER_USAGE_GPU_SAMPLED_IMAGE, + maxImages, &reader); + \endverbatim + * The width and height from \ref libvlc_video_render_cfg_t should be + * ignored as the video size is overridden by the producer (MediaCodec or + * EGL vout). + */ + libvlc_video_engine_anw, +} libvlc_video_engine_t; + + +/** Callback type that can be called to request a render size changes. + * + * libvlc will provide a callback of this type when calling \ref libvlc_video_output_set_window_cb. + * + * \param report_opaque parameter passed to \ref libvlc_video_output_set_window_cb. [IN] + * \param width new rendering width requested. [IN] + * \param height new rendering height requested. [IN] + */ +typedef void( *libvlc_video_output_resize_cb )( void *report_opaque, unsigned width, unsigned height ); + + +/** + * Enumeration of the different mouse buttons that can be reported for user interaction + * can be passed to \ref libvlc_video_output_mouse_press_cb and \ref libvlc_video_output_mouse_release_cb. + */ +typedef enum libvlc_video_output_mouse_button_t { + libvlc_video_output_mouse_button_left = 0, + libvlc_video_output_mouse_button_middle = 1, + libvlc_video_output_mouse_button_right = 2 +} libvlc_video_output_mouse_button_t; + + +/** Callback type that can be called to notify the mouse position when hovering the render surface. + * + * libvlc will provide a callback of this type when calling \ref libvlc_video_output_set_window_cb. + * + * The position (0,0) denotes the top left corner, bottom right corner position + * is (width,height) as reported by \ref libvlc_video_output_resize_cb. + * + * \param opaque parameter passed to \ref libvlc_video_output_set_window_cb. [IN] + * \param x horizontal mouse position in \ref libvlc_video_output_resize_cb coordinates. [IN] + * \param y vertical mouse position in \ref libvlc_video_output_resize_cb coordinates. [IN] + */ +typedef void (*libvlc_video_output_mouse_move_cb)(void *opaque, int x, int y); + +/** Callback type that can be called to notify when a mouse button is pressed in the rendering surface. + * + * libvlc will provide a callback of this type when calling \ref libvlc_video_output_set_window_cb. + * + * The button event will be reported at the last position provided by \ref libvlc_video_output_mouse_move_cb + * + * \param opaque parameter passed to \ref libvlc_video_output_set_window_cb. [IN] + * \param button represent the button pressed, see \ref libvlc_video_output_mouse_button_t for available buttons. [IN] + */ +typedef void (*libvlc_video_output_mouse_press_cb)(void *opaque, libvlc_video_output_mouse_button_t button); + +/** Callback type that can be called to notify when a mouse button is released in the rendering surface. + * + * libvlc will provide a callback of this type when calling \ref libvlc_video_output_set_window_cb. + * + * The button event will be reported at the last position provided by \ref libvlc_video_output_mouse_move_cb. + * + * \param opaque parameter passed to \ref libvlc_video_output_set_window_cb. [IN] + * \param button represent the button released, see \ref libvlc_video_output_mouse_button_t for available buttons. [IN] + */ +typedef void (*libvlc_video_output_mouse_release_cb)(void *opaque, libvlc_video_output_mouse_button_t button); + +/** Set the callback to call when the host app resizes the rendering area. + * + * This allows text rendering and aspect ratio to be handled properly when the host + * rendering size changes and to provide mouse. + * + * It may be called before the \ref libvlc_video_output_setup_cb callback. + * + * \warning These callbacks cannot be called concurrently, the caller is responsible for serialization + * + * \param[in] opaque private pointer set on the opaque parameter of @a libvlc_video_output_setup_cb() + * \param[in] report_size_change callback which must be called when the host size changes. + * The callback is valid until another call to \ref libvlc_video_output_set_window_cb + * is done. This may be called from any thread. + * \param[in] report_mouse_move callback which must be called when the mouse position change on the video surface. + * The coordinates are relative to the size reported through the \p report_size_change. + * This may be called from any thread. + * \param[in] report_mouse_pressed callback which must be called when a mouse button is pressed on the video surface, + * The position of the event is the last position reported by the report_mouse_move callback. This may be + * called from any thread. + * \param[in] report_mouse_released callback which must be called when a mouse button is released on the video surface, + * The position of the event is the last position reported by the report_mouse_move callback. This may be + * called from any thread. + * \param[in] report_opaque private pointer to pass to the \p report_size_change callback. + */ +typedef void( *libvlc_video_output_set_window_cb )( void *opaque, + libvlc_video_output_resize_cb report_size_change, + libvlc_video_output_mouse_move_cb report_mouse_move, + libvlc_video_output_mouse_press_cb report_mouse_pressed, + libvlc_video_output_mouse_release_cb report_mouse_released, + void *report_opaque ); + +/** Tell the host the rendering for the given plane is about to start + * + * \param[in] opaque private pointer set on the opaque parameter of @a libvlc_video_output_setup_cb() + * \param plane number of the rendering plane to select + * \param output handle of the rendering output for the given plane + * \return true on success + * \version LibVLC 4.0.0 or later + * + * \note This is only used with \ref libvlc_video_engine_d3d11. + * + * The output parameter receives the ID3D11RenderTargetView* to use for rendering + * the plane. + * + * If this callback is not used (set to NULL in @a libvlc_video_set_output_callbacks()) + * OMSetRenderTargets has to be set during the @a libvlc_video_makeCurrent_cb() + * entering call. + * + * The number of planes depend on the DXGI_FORMAT returned during the + * @a libvlc_video_update_output_cb() call. It's usually one plane except for + * semi-planar formats like DXGI_FORMAT_NV12 or DXGI_FORMAT_P010. + * + * This callback is called between libvlc_video_makeCurrent_cb current/not-current + * calls. + */ +typedef bool( *libvlc_video_output_select_plane_cb )( void *opaque, size_t plane, void *output ); + +/** + * Set callbacks and data to render decoded video to a custom texture + * + * \warning VLC will perform video rendering in its own thread and at its own rate, + * You need to provide your own synchronisation mechanism. + * + * \param mp the media player + * \param engine the GPU engine to use + * \param setup_cb callback called to initialize user data + * \param cleanup_cb callback called to clean up user data + * \param window_cb callback called to setup the window + * \param update_output_cb callback to get the rendering format of the host (cannot be NULL) + * \param swap_cb callback called after rendering a video frame (can only be + * NULL when using \ref libvlc_video_engine_anw) + * \param makeCurrent_cb callback called to enter/leave the rendering context + * (can only be NULL when using \ref libvlc_video_engine_anw) + * \param getProcAddress_cb opengl function loading callback (cannot be NULL + * for \ref libvlc_video_engine_opengl and for \ref libvlc_video_engine_gles2) + * \param metadata_cb callback to provide frame metadata (D3D11 only) + * \param select_plane_cb callback to select different D3D11 rendering targets + * \param opaque private pointer passed to callbacks + * + * \note the \p setup_cb and \p cleanup_cb may be called more than once per + * playback. + * + * \retval true engine selected and callbacks set + * \retval false engine type unknown, callbacks not set + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API +bool libvlc_video_set_output_callbacks( libvlc_media_player_t *mp, + libvlc_video_engine_t engine, + libvlc_video_output_setup_cb setup_cb, + libvlc_video_output_cleanup_cb cleanup_cb, + libvlc_video_output_set_window_cb window_cb, + libvlc_video_update_output_cb update_output_cb, + libvlc_video_swap_cb swap_cb, + libvlc_video_makeCurrent_cb makeCurrent_cb, + libvlc_video_getProcAddress_cb getProcAddress_cb, + libvlc_video_frameMetadata_cb metadata_cb, + libvlc_video_output_select_plane_cb select_plane_cb, + void* opaque ); + +/** + * Helper to setup output_callbacks for \ref libvlc_video_engine_anw + */ +static inline bool +libvlc_video_set_anw_callbacks( libvlc_media_player_t *mp, + libvlc_video_output_setup_cb setup_cb, + libvlc_video_output_cleanup_cb cleanup_cb, + libvlc_video_update_output_cb update_output_cb, + void *opaque ) +{ + return libvlc_video_set_output_callbacks( mp, libvlc_video_engine_anw, + setup_cb, cleanup_cb, NULL, + update_output_cb, NULL, NULL, + NULL, NULL, NULL, opaque ); +} + +/** + * Set the handler where the media player should display its video output. + * + * The drawable is an `NSObject` that require responding to two selectors + * like in this protocol: + * + * @code{.m} + * @protocol VLCDrawable + * - (void)addSubview:(VLCView *)view; + * - (CGRect)bounds; + * @end + * @endcode + * + * In this protocol `VLCView` type can either be a `UIView` or a `NSView` type + * class. + * VLCDrawable protocol conformance isn't mandatory but a drawable must respond + * to both `addSubview:` and `bounds` selectors. + * + * Additionally, a drawable can also conform to the `VLCPictureInPictureDrawable` + * protocol to allow picture in picture support : + * + * @code{.m} + * @protocol VLCPictureInPictureMediaControlling + * - (void)play; + * - (void)pause; + * - (void)seekBy:(int64_t)offset completion:(dispatch_block_t)completion;; + * - (int64_t)mediaLength; + * - (int64_t)mediaTime; + * - (BOOL)isMediaSeekable; + * - (BOOL)isMediaPlaying; + * @end + * + * @protocol VLCPictureInPictureWindowControlling + * - (void)startPictureInPicture; + * - (void)stopPictureInPicture; + * - (void)invalidatePlaybackState; + * @end + * + * @protocol VLCPictureInPictureDrawable + * - (id) mediaController; + * - (void (^)(id)) pictureInPictureReady; + * @end + * @endcode + * + * Be aware that full `VLCPictureInPictureDrawable` conformance is mandatory to + * enable picture in picture support and that time values in + * `VLCPictureInPictureMediaControlling` methods are expressed in milliseconds. + * + * If you want to use it along with Qt see the QMacCocoaViewContainer. Then + * the following code should work: + * @code{.mm} + * { + * NSView *video = [[NSView alloc] init]; + * QMacCocoaViewContainer *container = new QMacCocoaViewContainer(video, parent); + * libvlc_media_player_set_nsobject(mp, video); + * [video release]; + * } + * @endcode + * + * You can find a live example in VLCVideoView in VLCKit.framework. + * + * \param p_mi the Media Player + * \param drawable the drawable that is either an NSView, a UIView or any + * NSObject responding to `addSubview:` and `bounds` selectors + */ +LIBVLC_API void libvlc_media_player_set_nsobject ( libvlc_media_player_t *p_mi, void * drawable ); + +/** + * Get the NSView handler previously set with libvlc_media_player_set_nsobject(). + * + * \param p_mi the Media Player + * \return the NSView handler or 0 if none where set + */ +LIBVLC_API void * libvlc_media_player_get_nsobject ( libvlc_media_player_t *p_mi ); + +/** + * Set an X Window System drawable where the media player should render its + * video output. The call takes effect when the playback starts. If it is + * already started, it might need to be stopped before changes apply. + * If LibVLC was built without X11 output support, then this function has no + * effects. + * + * By default, LibVLC will capture input events on the video rendering area. + * Use libvlc_video_set_mouse_input() and libvlc_video_set_key_input() to + * disable that and deliver events to the parent window / to the application + * instead. By design, the X11 protocol delivers input events to only one + * recipient. + * + * \warning + * The application must call the XInitThreads() function from Xlib before + * libvlc_new(), and before any call to XOpenDisplay() directly or via any + * other library. Failure to call XInitThreads() will seriously impede LibVLC + * performance. Calling XOpenDisplay() before XInitThreads() will eventually + * crash the process. That is a limitation of Xlib. + * + * \param p_mi media player + * \param drawable X11 window ID + * + * \note + * The specified identifier must correspond to an existing Input/Output class + * X11 window. Pixmaps are not currently supported. The default X11 + * server is assumed, i.e. that specified in the DISPLAY environment variable. + * + * \warning + * LibVLC can deal with invalid X11 handle errors, however some display drivers + * (EGL, GLX, VA and/or VDPAU) can unfortunately not. Thus the window handle + * must remain valid until playback is stopped, otherwise the process may + * abort or crash. + * + * \bug + * No more than one window handle per media player instance can be specified. + * If the media has multiple simultaneously active video tracks, extra tracks + * will be rendered into external windows beyond the control of the + * application. + */ +LIBVLC_API void libvlc_media_player_set_xwindow(libvlc_media_player_t *p_mi, + uint32_t drawable); + +/** + * Get the X Window System window identifier previously set with + * libvlc_media_player_set_xwindow(). Note that this will return the identifier + * even if VLC is not currently using it (for instance if it is playing an + * audio-only input). + * + * \param p_mi the Media Player + * \return an X window ID, or 0 if none where set. + */ +LIBVLC_API uint32_t libvlc_media_player_get_xwindow ( libvlc_media_player_t *p_mi ); + +/** + * Set a Win32/Win64 API window handle (HWND) where the media player should + * render its video output. If LibVLC was built without Win32/Win64 API output + * support, then this has no effects. + * + * \warning the HWND must have the WS_CLIPCHILDREN set in its style. + * + * \param p_mi the Media Player + * \param drawable windows handle of the drawable + */ +LIBVLC_API void libvlc_media_player_set_hwnd ( libvlc_media_player_t *p_mi, void *drawable ); + +/** + * Get the Windows API window handle (HWND) previously set with + * libvlc_media_player_set_hwnd(). The handle will be returned even if LibVLC + * is not currently outputting any video to it. + * + * \param p_mi the Media Player + * \return a window handle or NULL if there are none. + */ +LIBVLC_API void *libvlc_media_player_get_hwnd ( libvlc_media_player_t *p_mi ); + +/** + * Set the android context. + * + * \version LibVLC 3.0.0 and later. + * + * \param p_mi the media player + * \param p_awindow_handler org.videolan.libvlc.AWindow jobject owned by the + * org.videolan.libvlc.MediaPlayer class from the libvlc-android project. + */ +LIBVLC_API void libvlc_media_player_set_android_context( libvlc_media_player_t *p_mi, + void *p_awindow_handler ); + +/** + * Callback prototype for audio playback. + * + * The LibVLC media player decodes and post-processes the audio signal + * asynchronously (in an internal thread). Whenever audio samples are ready + * to be queued to the output, this callback is invoked. + * + * The number of samples provided per invocation may depend on the file format, + * the audio coding algorithm, the decoder plug-in, the post-processing + * filters and timing. Application must not assume a certain number of samples. + * + * The exact format of audio samples is determined by libvlc_audio_set_format() + * or libvlc_audio_set_format_callbacks() as is the channels layout. + * + * Note that the number of samples is per channel. For instance, if the audio + * track sampling rate is 48000 Hz, then 1200 samples represent 25 milliseconds + * of audio signal - regardless of the number of audio channels. + * + * \param[in] data data pointer as passed to libvlc_audio_set_callbacks() + * \param[in] samples pointer to a table of audio samples to play back + * \param count number of audio samples to play back + * \param pts expected play time stamp (see libvlc_delay()) + */ +typedef void (*libvlc_audio_play_cb)(void *data, const void *samples, + unsigned count, int64_t pts); + +/** + * Callback prototype for audio pause. + * + * LibVLC invokes this callback to pause audio playback. + * + * \note The pause callback is never called if the audio is already paused. + * \param[in] data data pointer as passed to libvlc_audio_set_callbacks() + * \param pts time stamp of the pause request (should be elapsed already) + */ +typedef void (*libvlc_audio_pause_cb)(void *data, int64_t pts); + +/** + * Callback prototype for audio resumption. + * + * LibVLC invokes this callback to resume audio playback after it was + * previously paused. + * + * \note The resume callback is never called if the audio is not paused. + * \param[in] data data pointer as passed to libvlc_audio_set_callbacks() + * \param pts time stamp of the resumption request (should be elapsed already) + */ +typedef void (*libvlc_audio_resume_cb)(void *data, int64_t pts); + +/** + * Callback prototype for audio buffer flush. + * + * LibVLC invokes this callback if it needs to discard all pending buffers and + * stop playback as soon as possible. This typically occurs when the media is + * stopped. + * + * \param[in] data data pointer as passed to libvlc_audio_set_callbacks() + */ +typedef void (*libvlc_audio_flush_cb)(void *data, int64_t pts); + +/** + * Callback prototype for audio buffer drain. + * + * LibVLC may invoke this callback when the decoded audio track is ending. + * There will be no further decoded samples for the track, but playback should + * nevertheless continue until all already pending buffers are rendered. + * + * \param[in] data data pointer as passed to libvlc_audio_set_callbacks() + */ +typedef void (*libvlc_audio_drain_cb)(void *data); + +/** + * Callback prototype for audio volume change. + * \param[in] data data pointer as passed to libvlc_audio_set_callbacks() + * \param volume software volume (1. = nominal, 0. = mute) + * \param mute muted flag + */ +typedef void (*libvlc_audio_set_volume_cb)(void *data, + float volume, bool mute); + +/** + * Sets callbacks and private data for decoded audio. + * + * Use libvlc_audio_set_format() or libvlc_audio_set_format_callbacks() + * to configure the decoded audio format. + * + * \note The audio callbacks override any other audio output mechanism. + * If the callbacks are set, LibVLC will not output audio in any way. + * + * \param mp the media player + * \param play callback to play audio samples (must not be NULL) + * \param pause callback to pause playback (or NULL to ignore) + * \param resume callback to resume playback (or NULL to ignore) + * \param flush callback to flush audio buffers (or NULL to ignore) + * \param drain callback to drain audio buffers (or NULL to ignore) + * \param opaque private pointer for the audio callbacks (as first parameter) + * \version LibVLC 2.0.0 or later + */ +LIBVLC_API +void libvlc_audio_set_callbacks( libvlc_media_player_t *mp, + libvlc_audio_play_cb play, + libvlc_audio_pause_cb pause, + libvlc_audio_resume_cb resume, + libvlc_audio_flush_cb flush, + libvlc_audio_drain_cb drain, + void *opaque ); + +/** + * Set callbacks and private data for decoded audio. This only works in + * combination with libvlc_audio_set_callbacks(). + * Use libvlc_audio_set_format() or libvlc_audio_set_format_callbacks() + * to configure the decoded audio format. + * + * \param mp the media player + * \param set_volume callback to apply audio volume, + * or NULL to apply volume in software + * \version LibVLC 2.0.0 or later + */ +LIBVLC_API +void libvlc_audio_set_volume_callback( libvlc_media_player_t *mp, + libvlc_audio_set_volume_cb set_volume ); + +/** + * Callback prototype to setup the audio playback. + * + * This is called when the media player needs to create a new audio output. + * \param[in,out] opaque pointer to the data pointer passed to + * libvlc_audio_set_callbacks() + * \param[in,out] format 4 bytes sample format + * \param[in,out] rate sample rate + * \param[in,out] channels channels count + * \return 0 on success, anything else to skip audio playback + */ +typedef int (*libvlc_audio_setup_cb)(void **opaque, char *format, unsigned *rate, + unsigned *channels); + +/** + * Callback prototype for audio playback cleanup. + * + * This is called when the media player no longer needs an audio output. + * \param[in] opaque data pointer as passed to libvlc_audio_set_callbacks() + */ +typedef void (*libvlc_audio_cleanup_cb)(void *opaque); + +/** + * Sets decoded audio format via callbacks. + * + * This only works in combination with libvlc_audio_set_callbacks(). + * + * \param mp the media player + * \param setup callback to select the audio format (cannot be NULL) + * \param cleanup callback to release any allocated resources (or NULL) + * \version LibVLC 2.0.0 or later + */ +LIBVLC_API +void libvlc_audio_set_format_callbacks( libvlc_media_player_t *mp, + libvlc_audio_setup_cb setup, + libvlc_audio_cleanup_cb cleanup ); + +/** + * Sets a fixed decoded audio format. + * + * This only works in combination with libvlc_audio_set_callbacks(), + * and is mutually exclusive with libvlc_audio_set_format_callbacks(). + * + * The supported formats are: + * - "S16N" for signed 16-bit PCM + * - "S32N" for signed 32-bit PCM + * - "FL32" for single precision IEEE 754 + * + * All supported formats use the native endianness. + * If there are more than one channel, samples are interleaved. + * + * \param mp the media player + * \param format a four-characters string identifying the sample format + * \param rate sample rate (expressed in Hz) + * \param channels channels count + * \version LibVLC 2.0.0 or later + */ +LIBVLC_API +void libvlc_audio_set_format( libvlc_media_player_t *mp, const char *format, + unsigned rate, unsigned channels ); + +/** \bug This might go away ... to be replaced by a broader system */ + +/** + * Get the current movie length (in ms). + * + * \param p_mi the Media Player + * \return the movie length (in ms), or -1 if there is no media. + */ +LIBVLC_API libvlc_time_t libvlc_media_player_get_length( libvlc_media_player_t *p_mi ); + +/** + * Get the current movie time (in ms). + * + * \param p_mi the Media Player + * \return the movie time (in ms), or -1 if there is no media. + */ +LIBVLC_API libvlc_time_t libvlc_media_player_get_time( libvlc_media_player_t *p_mi ); + +/** + * Set the movie time (in ms). + * + * This has no effect if no media is being played. + * Not all formats and protocols support this. + * + * \param p_mi the Media Player + * \param i_time the movie time (in ms). + * \param b_fast prefer fast seeking or precise seeking + * \return 0 on success, -1 on error + */ +LIBVLC_API int libvlc_media_player_set_time( libvlc_media_player_t *p_mi, + libvlc_time_t i_time, bool b_fast ); + +/** + * Jump the movie time (in ms). + * + * This will trigger a precise and relative seek (from the current time). + * This has no effect if no media is being played. + * Not all formats and protocols support this. + * + * \param p_mi the Media Player + * \param i_time the movie time (in ms). + * \return 0 on success, -1 on error + * \version LibVLC 4.0.0 and later. + */ +LIBVLC_API int libvlc_media_player_jump_time( libvlc_media_player_t *p_mi, + libvlc_time_t i_time ); + +/** + * Get movie position as percentage between 0.0 and 1.0. + * + * \param p_mi the Media Player + * \return movie position, or -1. in case of error + */ +LIBVLC_API double libvlc_media_player_get_position( libvlc_media_player_t *p_mi ); + +/** + * Set movie position as percentage between 0.0 and 1.0. + * This has no effect if playback is not enabled. + * This might not work depending on the underlying input format and protocol. + * + * \param p_mi the Media Player + * \param b_fast prefer fast seeking or precise seeking + * \param f_pos the position + * \return 0 on success, -1 on error + */ +LIBVLC_API int libvlc_media_player_set_position( libvlc_media_player_t *p_mi, + double f_pos, bool b_fast ); + +/** + * Enable A to B loop for the current media by setting the start time and end + * time + * + * The B time must be higher than the A time. + * + * \param p_mi the Media Player + * \param a_time start time for the loop (in ms) + * \param b_time end time for the loop (in ms) + * \return 0 on success, -1 on error + * \version LibVLC 4.0.0 and later. + */ +LIBVLC_API int +libvlc_media_player_set_abloop_time( libvlc_media_player_t *p_mi, + libvlc_time_t a_time, libvlc_time_t b_time ); + +/** + * Enable A to B loop for the current media by setting the start position and + * end position + * + * The B position must be higher than the A position. + * + * \param p_mi the Media Player + * \param a_pos start position for the loop + * \param b_pos end position for the loop + * \return 0 on success, -1 on error + * \version LibVLC 4.0.0 and later. + */ +LIBVLC_API int +libvlc_media_player_set_abloop_position( libvlc_media_player_t *p_mi, + double a_pos, double b_pos ); + +/** + * Reset/remove the A to B loop for the current media + * + * \param p_mi the Media Player + * \return 0 on success, -1 on error + * \version LibVLC 4.0.0 and later. + */ +LIBVLC_API int +libvlc_media_player_reset_abloop( libvlc_media_player_t *p_mi ); + +/** + * Get the A to B loop status + * + * @note If the returned status is VLC_PLAYER_ABLOOP_A, then a_time and a_pos + * will be valid. If the returned status is VLC_PLAYER_ABLOOP_B, then all + * output parameters are valid. If the returned status is + * VLC_PLAYER_ABLOOP_NONE, then all output parameters are invalid. + * + * @see vlc_player_cbs.on_atobloop_changed + * + * \param p_mi the Media Player + * \param a_time A time (in ms) or -1 (if the media doesn't have valid times) + * \param a_pos A position + * \param b_time B time (in ms) or -1 (if the media doesn't have valid times) + * \param b_pos B position + * \return A to B loop status + * \version LibVLC 4.0.0 and later. + */ +LIBVLC_API libvlc_abloop_t +libvlc_media_player_get_abloop( libvlc_media_player_t *p_mi, + libvlc_time_t *a_time, double *a_pos, + libvlc_time_t *b_time, double *b_pos ); +/** + * Set movie chapter (if applicable). + * + * \param p_mi the Media Player + * \param i_chapter chapter number to play + */ +LIBVLC_API void libvlc_media_player_set_chapter( libvlc_media_player_t *p_mi, int i_chapter ); + +/** + * Get movie chapter. + * + * \param p_mi the Media Player + * \return chapter number currently playing, or -1 if there is no media. + */ +LIBVLC_API int libvlc_media_player_get_chapter( libvlc_media_player_t *p_mi ); + +/** + * Get movie chapter count + * + * \param p_mi the Media Player + * \return number of chapters in movie, or -1. + */ +LIBVLC_API int libvlc_media_player_get_chapter_count( libvlc_media_player_t *p_mi ); + +/** + * Get title chapter count + * + * \param p_mi the Media Player + * \param i_title title + * \return number of chapters in title, or -1 + */ +LIBVLC_API int libvlc_media_player_get_chapter_count_for_title( + libvlc_media_player_t *p_mi, int i_title ); + +/** + * Set movie title + * + * \param p_mi the Media Player + * \param i_title title number to play + */ +LIBVLC_API void libvlc_media_player_set_title( libvlc_media_player_t *p_mi, int i_title ); + +/** + * Get movie title + * + * \param p_mi the Media Player + * \return title number currently playing, or -1 + */ +LIBVLC_API int libvlc_media_player_get_title( libvlc_media_player_t *p_mi ); + +/** + * Get movie title count + * + * \param p_mi the Media Player + * \return title number count, or -1 + */ +LIBVLC_API int libvlc_media_player_get_title_count( libvlc_media_player_t *p_mi ); + +/** + * Set previous chapter (if applicable) + * + * \param p_mi the Media Player + */ +LIBVLC_API void libvlc_media_player_previous_chapter( libvlc_media_player_t *p_mi ); + +/** + * Set next chapter (if applicable) + * + * \param p_mi the Media Player + */ +LIBVLC_API void libvlc_media_player_next_chapter( libvlc_media_player_t *p_mi ); + +/** + * Get the requested movie play rate. + * @warning Depending on the underlying media, the requested rate may be + * different from the real playback rate. + * + * \param p_mi the Media Player + * \return movie play rate + */ +LIBVLC_API float libvlc_media_player_get_rate( libvlc_media_player_t *p_mi ); + +/** + * Set movie play rate + * + * \param p_mi the Media Player + * \param rate movie play rate to set + * \return -1 if an error was detected, 0 otherwise (but even then, it might + * not actually work depending on the underlying media protocol) + */ +LIBVLC_API int libvlc_media_player_set_rate( libvlc_media_player_t *p_mi, float rate ); + +/** + * Get current movie state + * + * \param p_mi the Media Player + * \return the current state of the media player (playing, paused, ...) \see libvlc_state_t + */ +LIBVLC_API libvlc_state_t libvlc_media_player_get_state( libvlc_media_player_t *p_mi ); + +/** + * How many video outputs does this media player have? + * + * \param p_mi the media player + * \return the number of video outputs + */ +LIBVLC_API unsigned libvlc_media_player_has_vout( libvlc_media_player_t *p_mi ); + +/** + * Is this media player seekable? + * + * \param p_mi the media player + * \retval true media player can seek + * \retval false media player cannot seek + */ +LIBVLC_API bool libvlc_media_player_is_seekable(libvlc_media_player_t *p_mi); + +/** + * Can this media player be paused? + * + * \param p_mi the media player + * \retval true media player can be paused + * \retval false media player cannot be paused + */ +LIBVLC_API bool libvlc_media_player_can_pause(libvlc_media_player_t *p_mi); + +/** + * Check if the current program is scrambled + * + * \param p_mi the media player + * \retval true current program is scrambled + * \retval false current program is not scrambled + * + * \version LibVLC 2.2.0 or later + */ +LIBVLC_API bool libvlc_media_player_program_scrambled( libvlc_media_player_t *p_mi ); + +/** + * Display the next frame (if supported) + * + * \param p_mi the media player + */ +LIBVLC_API void libvlc_media_player_next_frame( libvlc_media_player_t *p_mi ); + +/** + * Navigate through DVD Menu + * + * \param p_mi the Media Player + * \param navigate the Navigation mode + * \version libVLC 2.0.0 or later + */ +LIBVLC_API void libvlc_media_player_navigate( libvlc_media_player_t* p_mi, + unsigned navigate ); + +/** + * Set if, and how, the video title will be shown when media is played. + * + * \param p_mi the media player + * \param position position at which to display the title, or libvlc_position_disable to prevent the title from being displayed + * \param timeout title display timeout in milliseconds (ignored if libvlc_position_disable) + * \version libVLC 2.1.0 or later + */ +LIBVLC_API void libvlc_media_player_set_video_title_display( libvlc_media_player_t *p_mi, libvlc_position_t position, unsigned int timeout ); + +/** + * Get the track list for one type + * + * \version LibVLC 4.0.0 and later. + * + * \note You need to call libvlc_media_parse_request() or play the media + * at least once before calling this function. Not doing this will result in + * an empty list. + * + * \note This track list is a snapshot of the current tracks when this function + * is called. If a track is updated after this call, the user will need to call + * this function again to get the updated track. + * + * + * The track list can be used to get track information and to select specific + * tracks. + * + * \param p_mi the media player + * \param type type of the track list to request + * \param selected filter only selected tracks if true (return all tracks, even + * selected ones if false) + * + * \return a valid libvlc_media_tracklist_t or NULL in case of error, if there + * is no track for a category, the returned list will have a size of 0, delete + * with libvlc_media_tracklist_delete() + */ +LIBVLC_API libvlc_media_tracklist_t * +libvlc_media_player_get_tracklist( libvlc_media_player_t *p_mi, + libvlc_track_type_t type, bool selected ); + +/** + * Get the selected track for one type + * + * \version LibVLC 4.0.0 and later. + * + * \warning More than one tracks can be selected for one type. In that case, + * libvlc_media_player_get_tracklist() should be used. + * + * \param p_mi the media player + * \param type type of the selected track + * + * \return a valid track or NULL if there is no selected tracks for this type, + * release it with libvlc_media_track_release(). + */ +LIBVLC_API libvlc_media_track_t * +libvlc_media_player_get_selected_track( libvlc_media_player_t *p_mi, + libvlc_track_type_t type ); + +/* + * Get a track from a track id + * + * \version LibVLC 4.0.0 and later. + * + * This function can be used to get the last updated information of a track. + * + * \param p_mi the media player + * \param psz_id valid string representing a track id (cf. psz_id from \ref + * libvlc_media_track_t) + * + * \return a valid track or NULL if there is currently no tracks identified by + * the string id, release it with libvlc_media_track_release(). + */ +LIBVLC_API libvlc_media_track_t * +libvlc_media_player_get_track_from_id( libvlc_media_player_t *p_mi, + const char *psz_id ); + + +/** + * Select a track + * + * This will unselected the current track. + * + * \version LibVLC 4.0.0 and later. + * + * \note Use libvlc_media_player_select_tracks() for multiple selection + * + * \warning Only use a \ref libvlc_media_track_t retrieved with \ref libvlc_media_player_get_tracklist + * + * \param p_mi the media player + * \param track track to select, can't be NULL + */ +LIBVLC_API void +libvlc_media_player_select_track( libvlc_media_player_t *p_mi, + const libvlc_media_track_t *track ); + +/** + * Unselect all tracks for a given type + * + * \version LibVLC 4.0.0 and later. + * + * \param p_mi the media player + * \param type type to unselect + */ +LIBVLC_API void +libvlc_media_player_unselect_track_type( libvlc_media_player_t *p_mi, + libvlc_track_type_t type ); + +/** + * Select multiple tracks for one type + * + * \version LibVLC 4.0.0 and later. + * + * \note The internal track list can change between the calls of + * libvlc_media_player_get_tracklist() and + * libvlc_media_player_set_tracks(). If a track selection change but the + * track is not present anymore, the player will just ignore it. + * + * \note selecting multiple audio tracks is currently not supported. + * + * \warning Only use a \ref libvlc_media_track_t retrieved with \ref libvlc_media_player_get_tracklist + * + * \param p_mi the media player + * \param type type of the selected track + * \param tracks pointer to the track array, or NULL if track_count is 0 + * \param track_count number of tracks in the track array + */ +LIBVLC_API void +libvlc_media_player_select_tracks( libvlc_media_player_t *p_mi, + libvlc_track_type_t type, + const libvlc_media_track_t **tracks, + size_t track_count ); + +/** + * Select tracks by their string identifier + * + * \version LibVLC 4.0.0 and later. + * + * This function can be used pre-select a list of tracks before starting the + * player. It has only effect for the current media. It can also be used when + * the player is already started. + * + * 'str_ids' can contain more than one track id, delimited with ','. "" or any + * invalid track id will cause the player to unselect all tracks of that + * category. NULL will disable the preference for newer tracks without + * unselecting any current tracks. + * + * Example: + * - (libvlc_track_video, "video/1,video/2") will select these 2 video tracks. + * If there is only one video track with the id "video/0", no tracks will be + * selected. + * - (libvlc_track_type_t, "${slave_url_md5sum}/spu/0) will select one spu + * added by an input slave with the corresponding url. + * + * \note The string identifier of a track can be found via psz_id from \ref + * libvlc_media_track_t + * + * \note selecting multiple audio tracks is currently not supported. + * + * \warning Only use a \ref libvlc_media_track_t id retrieved with \ref libvlc_media_player_get_tracklist + * + * \param p_mi the media player + * \param type type to select + * \param psz_ids list of string identifier or NULL + */ +LIBVLC_API void +libvlc_media_player_select_tracks_by_ids( libvlc_media_player_t *p_mi, + libvlc_track_type_t type, + const char *psz_ids ); + +/** + * Add a slave to the current media player. + * + * \note If the player is playing, the slave will be added directly. This call + * will also update the slave list of the attached libvlc_media_t. + * + * \version LibVLC 3.0.0 and later. + * + * \see libvlc_media_slaves_add + * + * \param p_mi the media player + * \param i_type subtitle or audio + * \param psz_uri Uri of the slave (should contain a valid scheme). + * \param b_select True if this slave should be selected when it's loaded + * + * \return 0 on success, -1 on error. + */ +LIBVLC_API +int libvlc_media_player_add_slave( libvlc_media_player_t *p_mi, + libvlc_media_slave_type_t i_type, + const char *psz_uri, bool b_select ); + +typedef struct libvlc_player_program_t +{ + /** Id used for libvlc_media_player_select_program() */ + int i_group_id; + /** Program name, always valid */ + char *psz_name; + /** True if the program is selected */ + bool b_selected; + /** True if the program is scrambled */ + bool b_scrambled; +} libvlc_player_program_t; + +/** + * Opaque struct containing a list of program + */ +typedef struct libvlc_player_programlist_t libvlc_player_programlist_t; + +/** + * Delete a program struct + * + * \version LibVLC 4.0.0 and later. + * + * \param program returned by libvlc_media_player_get_selected_program() or + * libvlc_media_player_get_program_from_id() + * + */ +LIBVLC_API void +libvlc_player_program_delete( libvlc_player_program_t *program ); + +/** + * Get the number of programs in a programlist + * + * \version LibVLC 4.0.0 and later. + * + * \param list valid programlist + * + * \return number of programs, or 0 if the list is empty + */ +LIBVLC_API size_t +libvlc_player_programlist_count( const libvlc_player_programlist_t *list ); + +/** + * Get a program at a specific index + * + * \warning The behaviour is undefined if the index is not valid. + * + * \version LibVLC 4.0.0 and later. + * + * \param list valid programlist + * \param index valid index in the range [0; count[ + * + * \return a valid program (can't be NULL if libvlc_player_programlist_count() + * returned a valid count) + */ +LIBVLC_API libvlc_player_program_t * +libvlc_player_programlist_at( libvlc_player_programlist_t *list, size_t index ); + +/** + * Release a programlist + * + * \note program structs from the list are also deleted. + * + * \version LibVLC 4.0.0 and later. + * + * \see libvlc_media_player_get_programlist + * + * \param list valid programlist + */ +LIBVLC_API void +libvlc_player_programlist_delete( libvlc_player_programlist_t *list ); + +/** + * Select program with a given program id. + * + * \note program ids are sent via the libvlc_MediaPlayerProgramAdded event or + * can be fetch via libvlc_media_player_get_programlist() + * + * \version LibVLC 4.0.0 or later + * + * \param p_mi opaque media player handle + * \param i_group_id program id + */ +LIBVLC_API void libvlc_media_player_select_program_id( libvlc_media_player_t *p_mi, int i_group_id); + +/** + * Get the selected program + * + * \version LibVLC 4.0.0 or later + * + * \param p_mi opaque media player handle + * + * \return a valid program struct or NULL if no programs are selected. The + * program need to be freed with libvlc_player_program_delete(). + */ +LIBVLC_API libvlc_player_program_t * +libvlc_media_player_get_selected_program( libvlc_media_player_t *p_mi); + +/** + * Get a program struct from a program id + * + * \version LibVLC 4.0.0 or later + * + * \param p_mi opaque media player handle + * \param i_group_id program id + * + * \return a valid program struct or NULL if the i_group_id is not found. The + * program need to be freed with libvlc_player_program_delete(). + */ +LIBVLC_API libvlc_player_program_t * +libvlc_media_player_get_program_from_id( libvlc_media_player_t *p_mi, int i_group_id ); + +/** + * Get the program list + * + * \version LibVLC 4.0.0 and later. + * \note This program list is a snapshot of the current programs when this + * function is called. If a program is updated after this call, the user will + * need to call this function again to get the updated program. + * + * The program list can be used to get program information and to select + * specific programs. + * + * \param p_mi the media player + * + * \return a valid libvlc_media_programlist_t or NULL in case of error or empty + * list, delete with libvlc_media_programlist_delete() + */ +LIBVLC_API libvlc_player_programlist_t * +libvlc_media_player_get_programlist( libvlc_media_player_t *p_mi ); + + +/** \defgroup libvlc_video LibVLC video controls + * @{ + */ + +/** + * Toggle fullscreen status on non-embedded video outputs. + * + * @warning The same limitations applies to this function + * as to libvlc_set_fullscreen(). + * + * \param p_mi the media player + */ +LIBVLC_API void libvlc_toggle_fullscreen( libvlc_media_player_t *p_mi ); + +/** + * Enable or disable fullscreen. + * + * @warning With most window managers, only a top-level windows can be in + * full-screen mode. Hence, this function will not operate properly if + * libvlc_media_player_set_xwindow() was used to embed the video in a + * non-top-level window. In that case, the embedding window must be reparented + * to the root window before fullscreen mode is enabled. You will want + * to reparent it back to its normal parent when disabling fullscreen. + * + * \note This setting applies to any and all current or future active video + * tracks and windows for the given media player. The choice of fullscreen + * output for each window is left to the operating system. + * + * \param p_mi the media player + * \param b_fullscreen boolean for fullscreen status + */ +LIBVLC_API void libvlc_set_fullscreen(libvlc_media_player_t *p_mi, bool b_fullscreen); + +/** + * Get current fullscreen status. + * + * \param p_mi the media player + * \return the fullscreen status (boolean) + * + * \retval false media player is windowed + * \retval true media player is in fullscreen mode + */ +LIBVLC_API bool libvlc_get_fullscreen( libvlc_media_player_t *p_mi ); + +/** + * Enable or disable key press events handling, according to the LibVLC hotkeys + * configuration. By default and for historical reasons, keyboard events are + * handled by the LibVLC video widget. + * + * \note On X11, there can be only one subscriber for key press and mouse + * click events per window. If your application has subscribed to those events + * for the X window ID of the video widget, then LibVLC will not be able to + * handle key presses and mouse clicks in any case. + * + * \warning This function is only implemented for X11 and Win32 at the moment. + * + * \param p_mi the media player + * \param on true to handle key press events, false to ignore them. + */ +LIBVLC_API +void libvlc_video_set_key_input( libvlc_media_player_t *p_mi, unsigned on ); + +/** + * Enable or disable mouse click events handling. By default, those events are + * handled. This is needed for DVD menus to work, as well as a few video + * filters such as "puzzle". + * + * \see libvlc_video_set_key_input(). + * + * \warning This function is only implemented for X11 and Win32 at the moment. + * + * \param p_mi the media player + * \param on true to handle mouse click events, false to ignore them. + */ +LIBVLC_API +void libvlc_video_set_mouse_input( libvlc_media_player_t *p_mi, unsigned on ); + +/** + * Get the pixel dimensions of a video. + * + * \param p_mi media player + * \param num number of the video (starting from, and most commonly 0) + * \param[out] px pointer to get the pixel width + * \param[out] py pointer to get the pixel height + * \return 0 on success, -1 if the specified video does not exist + */ +LIBVLC_API +int libvlc_video_get_size( libvlc_media_player_t *p_mi, unsigned num, + unsigned *px, unsigned *py ); + +/** + * Get the mouse pointer coordinates over a video. + * Coordinates are expressed in terms of the decoded video resolution, + * not in terms of pixels on the screen/viewport (to get the latter, + * you can query your windowing system directly). + * + * Either of the coordinates may be negative or larger than the corresponding + * dimension of the video, if the cursor is outside the rendering area. + * + * @warning The coordinates may be out-of-date if the pointer is not located + * on the video rendering area. LibVLC does not track the pointer if it is + * outside of the video widget. + * + * @note LibVLC does not support multiple pointers (it does of course support + * multiple input devices sharing the same pointer) at the moment. + * + * \param p_mi media player + * \param num number of the video (starting from, and most commonly 0) + * \param[out] px pointer to get the abscissa + * \param[out] py pointer to get the ordinate + * \return 0 on success, -1 if the specified video does not exist + */ +LIBVLC_API +int libvlc_video_get_cursor( libvlc_media_player_t *p_mi, unsigned num, + int *px, int *py ); + +/** + * Get the current video scaling factor. + * See also libvlc_video_set_scale(). + * + * \param p_mi the media player + * \return the currently configured zoom factor, or 0. if the video is set + * to fit to the output window/drawable automatically. + */ +LIBVLC_API float libvlc_video_get_scale( libvlc_media_player_t *p_mi ); + +/** + * Set the video scaling factor. That is the ratio of the number of pixels on + * screen to the number of pixels in the original decoded video in each + * dimension. Zero is a special value; it will adjust the video to the output + * window/drawable (in windowed mode) or the entire screen. + * + * Note that not all video outputs support scaling. + * + * \param p_mi the media player + * \param f_factor the scaling factor, or zero + */ +LIBVLC_API void libvlc_video_set_scale( libvlc_media_player_t *p_mi, float f_factor ); + +/** + * Get current video aspect ratio. + * + * \param p_mi the media player + * \return the video aspect ratio or NULL if unspecified + * (the result must be released with free() or libvlc_free()). + */ +LIBVLC_API char *libvlc_video_get_aspect_ratio( libvlc_media_player_t *p_mi ); + +/** + * Set new video aspect ratio. + * + * \param p_mi the media player + * \param psz_aspect new video aspect-ratio or NULL to reset to source aspect ratio + * \note Invalid aspect ratios are ignored. + */ +LIBVLC_API void libvlc_video_set_aspect_ratio( libvlc_media_player_t *p_mi, const char *psz_aspect ); + +/** + * Get current video display fit mode. + * + * \version LibVLC 4.0.0 or later + * + * \param p_mi the media player + * \return the video display fit mode. + */ +LIBVLC_API libvlc_video_fit_mode_t libvlc_video_get_display_fit( libvlc_media_player_t *p_mi ); + +/** + * Set new video display fit. + * + * \version LibVLC 4.0.0 or later + * + * \param p_mi the media player + * \param fit new display fit mode + * \note Invalid fit mode are ignored. + */ +LIBVLC_API void libvlc_video_set_display_fit( libvlc_media_player_t *p_mi, libvlc_video_fit_mode_t fit ); + +/** + * Create a video viewpoint structure. + * + * \version LibVLC 3.0.0 and later + * + * \return video viewpoint or NULL + * (the result must be released with free()). + */ +LIBVLC_API libvlc_video_viewpoint_t *libvlc_video_new_viewpoint(void); + +/** + * Update the video viewpoint information. + * + * \note It is safe to call this function before the media player is started. + * + * \version LibVLC 3.0.0 and later + * + * \param p_mi the media player + * \param p_viewpoint video viewpoint allocated via libvlc_video_new_viewpoint() + * \param b_absolute if true replace the old viewpoint with the new one. If + * false, increase/decrease it. + * \return -1 in case of error, 0 otherwise + * + * \note the values are set asynchronously, it will be used by the next frame displayed. + */ +LIBVLC_API int libvlc_video_update_viewpoint( libvlc_media_player_t *p_mi, + const libvlc_video_viewpoint_t *p_viewpoint, + bool b_absolute); + +/** + * Video stereo modes + */ +typedef enum libvlc_video_stereo_mode_t { + libvlc_VideoStereoAuto = 0, + libvlc_VideoStereoStereo, + libvlc_VideoStereoLeftEye, + libvlc_VideoStereoRightEye, + libvlc_VideoStereoSideBySide, +} libvlc_video_stereo_mode_t; + +/** + * Get current video stereo mode. + * + * \param p_mi the media player + * \return the video stereo mode. + */ +LIBVLC_API libvlc_video_stereo_mode_t libvlc_video_get_video_stereo_mode( + libvlc_media_player_t *p_mi ); + +/** + * Set new video stereo mode. + * + * \param p_mi the media player + * \param i_mode new video stereo mode + */ +LIBVLC_API void libvlc_video_set_video_stereo_mode( libvlc_media_player_t *p_mi, + const libvlc_video_stereo_mode_t i_mode ); + +/** + * Get the current subtitle delay. Positive values means subtitles are being + * displayed later, negative values earlier. + * + * \param p_mi media player + * \return time (in microseconds) the display of subtitles is being delayed + * \version LibVLC 2.0.0 or later + */ +LIBVLC_API int64_t libvlc_video_get_spu_delay( libvlc_media_player_t *p_mi ); + +/** + * Get the current subtitle text scale + * + * The scale factor is expressed as a percentage of the default size, where + * 1.0 represents 100 percent. + * + * \param p_mi media player + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API float libvlc_video_get_spu_text_scale( libvlc_media_player_t *p_mi ); + +/** + * Set the subtitle text scale. + * + * The scale factor is expressed as a percentage of the default size, where + * 1.0 represents 100 percent. + * + * A value of 0.5 would result in text half the normal size, and a value of 2.0 + * would result in text twice the normal size. + * + * The minimum acceptable value for the scale factor is 0.1. + * + * The maximum is 5.0 (five times normal size). + * + * \param p_mi media player + * \param f_scale scale factor in the range [0.1;5.0] (default: 1.0) + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API void libvlc_video_set_spu_text_scale( libvlc_media_player_t *p_mi, float f_scale ); + +/** + * Set the subtitle delay. This affects the timing of when the subtitle will + * be displayed. Positive values result in subtitles being displayed later, + * while negative values will result in subtitles being displayed earlier. + * + * The subtitle delay will be reset to zero each time the media changes. + * + * \param p_mi media player + * \param i_delay time (in microseconds) the display of subtitles should be delayed + * \return 0 on success, -1 on error + * \version LibVLC 2.0.0 or later + */ +LIBVLC_API int libvlc_video_set_spu_delay( libvlc_media_player_t *p_mi, int64_t i_delay ); + +/** + * Get the full description of available titles + * + * \version LibVLC 3.0.0 and later. + * + * \param p_mi the media player + * \param[out] titles address to store an allocated array of title descriptions + * descriptions (must be freed with libvlc_title_descriptions_release() + * by the caller) + * + * \return the number of titles (-1 on error) + */ +LIBVLC_API int libvlc_media_player_get_full_title_descriptions( libvlc_media_player_t *p_mi, + libvlc_title_description_t ***titles ); + +/** + * Release a title description + * + * \version LibVLC 3.0.0 and later + * + * \param p_titles title description array to release + * \param i_count number of title descriptions to release + */ +LIBVLC_API + void libvlc_title_descriptions_release( libvlc_title_description_t **p_titles, + unsigned i_count ); + +/** + * Get the full description of available chapters + * + * \version LibVLC 3.0.0 and later. + * + * \param p_mi the media player + * \param i_chapters_of_title index of the title to query for chapters (uses current title if set to -1) + * \param[out] pp_chapters address to store an allocated array of chapter descriptions + * descriptions (must be freed with libvlc_chapter_descriptions_release() + * by the caller) + * + * \return the number of chapters (-1 on error) + */ +LIBVLC_API int libvlc_media_player_get_full_chapter_descriptions( libvlc_media_player_t *p_mi, + int i_chapters_of_title, + libvlc_chapter_description_t *** pp_chapters ); + +/** + * Release a chapter description + * + * \version LibVLC 3.0.0 and later + * + * \param p_chapters chapter description array to release + * \param i_count number of chapter descriptions to release + */ +LIBVLC_API +void libvlc_chapter_descriptions_release( libvlc_chapter_description_t **p_chapters, + unsigned i_count ); + +/** + * Set/unset the video crop ratio. + * + * This function forces a crop ratio on any and all video tracks rendered by + * the media player. If the display aspect ratio of a video does not match the + * crop ratio, either the top and bottom, or the left and right of the video + * will be cut out to fit the crop ratio. + * + * For instance, a ratio of 1:1 will force the video to a square shape. + * + * To disable video crop, set a crop ratio with zero as denominator. + * + * A call to this function overrides any previous call to any of + * libvlc_video_set_crop_ratio(), libvlc_video_set_crop_border() and/or + * libvlc_video_set_crop_window(). + * + * \see libvlc_video_set_aspect_ratio() + * + * \param mp the media player + * \param num crop ratio numerator (ignored if denominator is 0) + * \param den crop ratio denominator (or 0 to unset the crop ratio) + * + * \version LibVLC 4.0.0 and later + */ +LIBVLC_API +void libvlc_video_set_crop_ratio(libvlc_media_player_t *mp, + unsigned num, unsigned den); + +/** + * Set the video crop window. + * + * This function selects a sub-rectangle of video to show. Any pixels outside + * the rectangle will not be shown. + * + * To unset the video crop window, use libvlc_video_set_crop_ratio() or + * libvlc_video_set_crop_border(). + * + * A call to this function overrides any previous call to any of + * libvlc_video_set_crop_ratio(), libvlc_video_set_crop_border() and/or + * libvlc_video_set_crop_window(). + * + * \param mp the media player + * \param x abscissa (i.e. leftmost sample column offset) of the crop window + * \param y ordinate (i.e. topmost sample row offset) of the crop window + * \param width sample width of the crop window (cannot be zero) + * \param height sample height of the crop window (cannot be zero) + * + * \version LibVLC 4.0.0 and later + */ +LIBVLC_API +void libvlc_video_set_crop_window(libvlc_media_player_t *mp, + unsigned x, unsigned y, + unsigned width, unsigned height); + +/** + * Set the video crop borders. + * + * This function selects the size of video edges to be cropped out. + * + * To unset the video crop borders, set all borders to zero. + * + * A call to this function overrides any previous call to any of + * libvlc_video_set_crop_ratio(), libvlc_video_set_crop_border() and/or + * libvlc_video_set_crop_window(). + * + * \param mp the media player + * \param left number of sample columns to crop on the left + * \param right number of sample columns to crop on the right + * \param top number of sample rows to crop on the top + * \param bottom number of sample rows to corp on the bottom + * + * \version LibVLC 4.0.0 and later + */ +LIBVLC_API +void libvlc_video_set_crop_border(libvlc_media_player_t *mp, + unsigned left, unsigned right, + unsigned top, unsigned bottom); + +/** + * Get current teletext page requested or 0 if it's disabled. + * + * Teletext is disabled by default, call libvlc_video_set_teletext() to enable + * it. + * + * \param p_mi the media player + * \return the current teletext page requested. + */ +LIBVLC_API int libvlc_video_get_teletext( libvlc_media_player_t *p_mi ); + +/** + * Set new teletext page to retrieve. + * + * This function can also be used to send a teletext key. + * + * \param p_mi the media player + * \param i_page teletex page number requested. This value can be 0 to disable + * teletext, a number in the range ]0;1000[ to show the requested page, or a + * \ref libvlc_teletext_key_t. 100 is the default teletext page. + */ +LIBVLC_API void libvlc_video_set_teletext( libvlc_media_player_t *p_mi, int i_page ); + +/** + * Set teletext background transparency. + * + * \param p_mi the media player + * \param transparent whether background should be transparent. + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API void libvlc_video_set_teletext_transparency( libvlc_media_player_t *p_mi, bool transparent ); + +/** + * Get teletext background transparency. + * + * \param p_mi the media player + * \retval true teletext has transparent background + * \retval false teletext has opaque background + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API bool libvlc_video_get_teletext_transparency( libvlc_media_player_t *p_mi ); + +/** + * Take a snapshot of the current video window. + * + * If i_width AND i_height is 0, original size is used. + * If i_width XOR i_height is 0, original aspect-ratio is preserved. + * + * \param p_mi media player instance + * \param num number of video output (typically 0 for the first/only one) + * \param psz_filepath the path of a file or a folder to save the screenshot into + * \param i_width the snapshot's width + * \param i_height the snapshot's height + * \return 0 on success, -1 if the video was not found + */ +LIBVLC_API +int libvlc_video_take_snapshot( libvlc_media_player_t *p_mi, unsigned num, + const char *psz_filepath, unsigned int i_width, + unsigned int i_height ); + +/** + * Enable or disable deinterlace filter + * + * \param p_mi libvlc media player + * \param deinterlace state -1: auto (default), 0: disabled, 1: enabled + * \param psz_mode type of deinterlace filter, NULL for current/default filter + * \version LibVLC 4.0.0 and later + */ +LIBVLC_API void libvlc_video_set_deinterlace( libvlc_media_player_t *p_mi, + int deinterlace, + const char *psz_mode ); + +/** + * Get an integer marquee option value + * + * \param p_mi libvlc media player + * \param option marq option to get \see libvlc_video_marquee_option_t + */ +LIBVLC_API int libvlc_video_get_marquee_int( libvlc_media_player_t *p_mi, + unsigned option ); + +/** + * Enable, disable or set an integer marquee option + * + * Setting libvlc_marquee_Enable has the side effect of enabling (arg !0) + * or disabling (arg 0) the marq filter. + * + * \param p_mi libvlc media player + * \param option marq option to set \see libvlc_video_marquee_option_t + * \param i_val marq option value + */ +LIBVLC_API void libvlc_video_set_marquee_int( libvlc_media_player_t *p_mi, + unsigned option, int i_val ); + +/** + * Set a marquee string option + * + * \param p_mi libvlc media player + * \param option marq option to set \see libvlc_video_marquee_option_t + * \param psz_text marq option value + */ +LIBVLC_API void libvlc_video_set_marquee_string( libvlc_media_player_t *p_mi, + unsigned option, const char *psz_text ); + +/** option values for libvlc_video_{get,set}_logo_{int,string} */ +enum libvlc_video_logo_option_t { + libvlc_logo_enable, + libvlc_logo_file, /**< string argument, "file,d,t;file,d,t;..." */ + libvlc_logo_x, + libvlc_logo_y, + libvlc_logo_delay, + libvlc_logo_repeat, + libvlc_logo_opacity, + libvlc_logo_position +}; + +/** + * Get integer logo option. + * + * \param p_mi libvlc media player instance + * \param option logo option to get, values of libvlc_video_logo_option_t + */ +LIBVLC_API int libvlc_video_get_logo_int( libvlc_media_player_t *p_mi, + unsigned option ); + +/** + * Set logo option as integer. Options that take a different type value + * are ignored. + * Passing libvlc_logo_enable as option value has the side effect of + * starting (arg !0) or stopping (arg 0) the logo filter. + * + * \param p_mi libvlc media player instance + * \param option logo option to set, values of libvlc_video_logo_option_t + * \param value logo option value + */ +LIBVLC_API void libvlc_video_set_logo_int( libvlc_media_player_t *p_mi, + unsigned option, int value ); + +/** + * Set logo option as string. Options that take a different type value + * are ignored. + * + * \param p_mi libvlc media player instance + * \param option logo option to set, values of libvlc_video_logo_option_t + * \param psz_value logo option value + */ +LIBVLC_API void libvlc_video_set_logo_string( libvlc_media_player_t *p_mi, + unsigned option, const char *psz_value ); + + +/** option values for libvlc_video_{get,set}_adjust_{int,float,bool} */ +enum libvlc_video_adjust_option_t { + libvlc_adjust_Enable = 0, + libvlc_adjust_Contrast, + libvlc_adjust_Brightness, + libvlc_adjust_Hue, + libvlc_adjust_Saturation, + libvlc_adjust_Gamma +}; + +/** + * Get integer adjust option. + * + * \param p_mi libvlc media player instance + * \param option adjust option to get, values of libvlc_video_adjust_option_t + * \version LibVLC 1.1.1 and later. + */ +LIBVLC_API int libvlc_video_get_adjust_int( libvlc_media_player_t *p_mi, + unsigned option ); + +/** + * Set adjust option as integer. Options that take a different type value + * are ignored. + * Passing libvlc_adjust_enable as option value has the side effect of + * starting (arg !0) or stopping (arg 0) the adjust filter. + * + * \param p_mi libvlc media player instance + * \param option adjust option to set, values of libvlc_video_adjust_option_t + * \param value adjust option value + * \version LibVLC 1.1.1 and later. + */ +LIBVLC_API void libvlc_video_set_adjust_int( libvlc_media_player_t *p_mi, + unsigned option, int value ); + +/** + * Get float adjust option. + * + * \param p_mi libvlc media player instance + * \param option adjust option to get, values of libvlc_video_adjust_option_t + * \version LibVLC 1.1.1 and later. + */ +LIBVLC_API float libvlc_video_get_adjust_float( libvlc_media_player_t *p_mi, + unsigned option ); + +/** + * Set adjust option as float. Options that take a different type value + * are ignored. + * + * \param p_mi libvlc media player instance + * \param option adjust option to set, values of libvlc_video_adjust_option_t + * \param value adjust option value + * \version LibVLC 1.1.1 and later. + */ +LIBVLC_API void libvlc_video_set_adjust_float( libvlc_media_player_t *p_mi, + unsigned option, float value ); +/** + * Change the projection mode used for rendering the source. + * + * This changes how the source is mapped to the output w.r.t. 360 playback. + * + * \param p_mi libvlc media player instance + * \param projection_mode the considered projection mode for the source + * \version LibVLC 4.0.0 and later. + */ +LIBVLC_API void +libvlc_video_set_projection_mode(libvlc_media_player_t *player, + libvlc_video_projection_t projection_mode); + +/** + * Remove previously set projection mode. + * + * Remove the effects from previous call to libvlc_video_set_projection_mode. + * + * \param p_mi libvlc media player instance + * \version LibVLC 4.0.0 and later. + */ +LIBVLC_API void +libvlc_video_unset_projection_mode(libvlc_media_player_t *player); + +/** @} video */ + +/** \defgroup libvlc_audio LibVLC audio controls + * @{ + */ + +/** + * Audio stereo modes + */ +typedef enum libvlc_audio_output_stereomode_t { + libvlc_AudioStereoMode_Unset = 0, + libvlc_AudioStereoMode_Stereo = 1, + libvlc_AudioStereoMode_RStereo = 2, + libvlc_AudioStereoMode_Left = 3, + libvlc_AudioStereoMode_Right = 4, + libvlc_AudioStereoMode_Dolbys = 5, + libvlc_AudioStereoMode_Mono = 7, +} libvlc_audio_output_stereomode_t; + +/** + * Audio mix modes + */ +typedef enum libvlc_audio_output_mixmode_t { + libvlc_AudioMixMode_Unset = 0, + libvlc_AudioMixMode_Stereo = 1, + libvlc_AudioMixMode_Binaural = 2, + libvlc_AudioMixMode_4_0 = 3, + libvlc_AudioMixMode_5_1 = 4, + libvlc_AudioMixMode_7_1 = 5, +} libvlc_audio_output_mixmode_t; + +/** + * Gets the list of available audio output modules. + * + * \param p_instance libvlc instance + * \return list of available audio outputs. It must be freed with +* \see libvlc_audio_output_list_release \see libvlc_audio_output_t . + * In case of error, NULL is returned. + */ +LIBVLC_API libvlc_audio_output_t * +libvlc_audio_output_list_get( libvlc_instance_t *p_instance ); + +/** + * Frees the list of available audio output modules. + * + * \param p_list list with audio outputs for release + */ +LIBVLC_API +void libvlc_audio_output_list_release( libvlc_audio_output_t *p_list ); + +/** + * Selects an audio output module. + * \note Any change will take be effect only after playback is stopped and + * restarted. Audio output cannot be changed while playing. + * + * \param p_mi media player + * \param psz_name name of audio output, + * use psz_name of \see libvlc_audio_output_t + * \return 0 if function succeeded, -1 on error + */ +LIBVLC_API int libvlc_audio_output_set( libvlc_media_player_t *p_mi, + const char *psz_name ); + +/** + * Gets a list of potential audio output devices. + * + * See also libvlc_audio_output_device_set(). + * + * \note Not all audio outputs support enumerating devices. + * The audio output may be functional even if the list is empty (NULL). + * + * \note The list may not be exhaustive. + * + * \warning Some audio output devices in the list might not actually work in + * some circumstances. By default, it is recommended to not specify any + * explicit audio device. + * + * \param mp media player + * \return A NULL-terminated linked list of potential audio output devices. + * It must be freed with libvlc_audio_output_device_list_release() + * \version LibVLC 2.2.0 or later. + */ +LIBVLC_API libvlc_audio_output_device_t * +libvlc_audio_output_device_enum( libvlc_media_player_t *mp ); + +#if defined (__GNUC__) && !defined (__clang__) +__attribute__((unused)) +__attribute__((noinline)) +__attribute__((error("Use libvlc_audio_output_device_enum() instead"))) +static libvlc_audio_output_device_t * +libvlc_audio_output_device_list_get( libvlc_instance_t *p_instance, + const char *aout ) +{ + (void) p_instance; (void) aout; + return NULL; +} +#endif + +/** + * Frees a list of available audio output devices. + * + * \param p_list list with audio outputs for release + * \version LibVLC 2.1.0 or later. + */ +LIBVLC_API void libvlc_audio_output_device_list_release( + libvlc_audio_output_device_t *p_list ); + +/** + * Configures an explicit audio output device. + * + * A list of adequate potential device strings can be obtained with + * libvlc_audio_output_device_enum(). + * + * \note This function does not select the specified audio output plugin. + * libvlc_audio_output_set() is used for that purpose. + * + * \warning The syntax for the device parameter depends on the audio output. + * + * Some audio output modules require further parameters (e.g. a channels map + * in the case of ALSA). + * + * \version This function originally expected three parameters. + * The middle parameter was removed from LibVLC 4.0 onward. + * + * \param mp media player + * \param device_id device identifier string + * (see \ref libvlc_audio_output_device_t::psz_device) + * + * \return If the change of device was requested successfully, zero is returned + * (the actual change is asynchronous and not guaranteed to succeed). + * On error, a non-zero value is returned. + */ +LIBVLC_API int libvlc_audio_output_device_set( libvlc_media_player_t *mp, + const char *device_id ); + +/** + * Get the current audio output device identifier. + * + * This complements libvlc_audio_output_device_set(). + * + * \warning The initial value for the current audio output device identifier + * may not be set or may be some unknown value. A LibVLC application should + * compare this value against the known device identifiers (e.g. those that + * were previously retrieved by a call to libvlc_audio_output_device_enum) to + * find the current audio output device. + * + * It is possible that the selected audio output device changes (an external + * change) without a call to libvlc_audio_output_device_set. That may make this + * method unsuitable to use if a LibVLC application is attempting to track + * dynamic audio device changes as they happen. + * + * \param mp media player + * \return the current audio output device identifier + * NULL if no device is selected or in case of error + * (the result must be released with free()). + * \version LibVLC 3.0.0 or later. + */ +LIBVLC_API char *libvlc_audio_output_device_get( libvlc_media_player_t *mp ); + +/** + * Toggle mute status. + * + * \param p_mi media player + * \warning Toggling mute atomically is not always possible: On some platforms, + * other processes can mute the VLC audio playback stream asynchronously. Thus, + * there is a small race condition where toggling will not work. + * See also the limitations of libvlc_audio_set_mute(). + */ +LIBVLC_API void libvlc_audio_toggle_mute( libvlc_media_player_t *p_mi ); + +/** + * Get current mute status. + * + * \param p_mi media player + * \return the mute status (boolean) if defined, -1 if undefined/unapplicable + */ +LIBVLC_API int libvlc_audio_get_mute( libvlc_media_player_t *p_mi ); + +/** + * Set mute status. + * + * \param p_mi media player + * \param status If status is true then mute, otherwise unmute + * \warning This function does not always work. If there are no active audio + * playback stream, the mute status might not be available. If digital + * pass-through (S/PDIF, HDMI...) is in use, muting may be unapplicable. Also + * some audio output plugins do not support muting at all. + * \note To force silent playback, disable all audio tracks. This is more + * efficient and reliable than mute. + */ +LIBVLC_API void libvlc_audio_set_mute( libvlc_media_player_t *p_mi, int status ); + +/** + * Get current software audio volume. + * + * \param p_mi media player + * \return the software volume in percents + * (0 = mute, 100 = nominal / 0dB) + */ +LIBVLC_API int libvlc_audio_get_volume( libvlc_media_player_t *p_mi ); + +/** + * Set current software audio volume. + * + * \param p_mi media player + * \param i_volume the volume in percents (0 = mute, 100 = 0dB) + * \return 0 if the volume was set, -1 if it was out of range + */ +LIBVLC_API int libvlc_audio_set_volume( libvlc_media_player_t *p_mi, int i_volume ); + +/** + * Get current audio stereo-mode. + * + * \param p_mi media player + * \return the audio stereo-mode, \see libvlc_audio_output_stereomode_t + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API libvlc_audio_output_stereomode_t libvlc_audio_get_stereomode( libvlc_media_player_t *p_mi ); + +/** + * Set current audio stereo-mode. + * + * \param p_mi media player + * \param mode the audio stereo-mode, \see libvlc_audio_output_stereomode_t + * \return 0 on success, -1 on error + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API int libvlc_audio_set_stereomode( libvlc_media_player_t *p_mi, + libvlc_audio_output_stereomode_t mode ); + +/** + * Get current audio mix-mode. + * + * \param p_mi media player + * \return the audio mix-mode, \see libvlc_audio_output_mixmode_t + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API libvlc_audio_output_mixmode_t libvlc_audio_get_mixmode( libvlc_media_player_t *p_mi ); + +/** + * Set current audio mix-mode. + * + * By default (::libvlc_AudioMixMode_Unset), the audio output will keep its + * original channel configuration (play stereo as stereo, or 5.1 as 5.1). Yet, + * the OS and Audio API might refuse a channel configuration and asks VLC to + * adapt (Stereo played as 5.1 or vice-versa). + * + * This function allows to force a channel configuration, it will only work if + * the OS and Audio API accept this configuration (otherwise, it won't have any + * effects). Here are some examples: + * - Play multi-channels (5.1, 7.1...) as stereo (::libvlc_AudioMixMode_Stereo) + * - Play Stereo or 5.1 as 7.1 (::libvlc_AudioMixMode_7_1) + * - Play multi-channels as stereo with a binaural effect + * (::libvlc_AudioMixMode_Binaural). It might be selected automatically if the + * OS and Audio API can detect if a headphone is plugged. + * + * \param p_mi media player + * \param mode the audio mix-mode, \see libvlc_audio_output_mixmode_t + * \return 0 on success, -1 on error + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API int libvlc_audio_set_mixmode( libvlc_media_player_t *p_mi, + libvlc_audio_output_mixmode_t mode ); + + +/** + * Get current audio delay. + * + * \param p_mi media player + * \return the audio delay (microseconds) + * \version LibVLC 1.1.1 or later + */ +LIBVLC_API int64_t libvlc_audio_get_delay( libvlc_media_player_t *p_mi ); + +/** + * Set current audio delay. The audio delay will be reset to zero each time the media changes. + * + * \param p_mi media player + * \param i_delay the audio delay (microseconds) + * \return 0 on success, -1 on error + * \version LibVLC 1.1.1 or later + */ +LIBVLC_API int libvlc_audio_set_delay( libvlc_media_player_t *p_mi, int64_t i_delay ); + +/** + * Get the number of equalizer presets. + * + * \return number of presets + * \version LibVLC 2.2.0 or later + */ +LIBVLC_API unsigned libvlc_audio_equalizer_get_preset_count( void ); + +/** + * Get the name of a particular equalizer preset. + * + * This name can be used, for example, to prepare a preset label or menu in a user + * interface. + * + * \param u_index index of the preset, counting from zero + * \return preset name, or NULL if there is no such preset + * \version LibVLC 2.2.0 or later + */ +LIBVLC_API const char *libvlc_audio_equalizer_get_preset_name( unsigned u_index ); + +/** + * Get the number of distinct frequency bands for an equalizer. + * + * \return number of frequency bands + * \version LibVLC 2.2.0 or later + */ +LIBVLC_API unsigned libvlc_audio_equalizer_get_band_count( void ); + +/** + * Get a particular equalizer band frequency. + * + * This value can be used, for example, to create a label for an equalizer band control + * in a user interface. + * + * \param u_index index of the band, counting from zero + * \return equalizer band frequency (Hz), or -1 if there is no such band + * \version LibVLC 2.2.0 or later + */ +LIBVLC_API float libvlc_audio_equalizer_get_band_frequency( unsigned u_index ); + +/** + * Create a new default equalizer, with all frequency values zeroed. + * + * The new equalizer can subsequently be applied to a media player by invoking + * libvlc_media_player_set_equalizer(). + * + * The returned handle should be freed via libvlc_audio_equalizer_release() when + * it is no longer needed. + * + * \return opaque equalizer handle, or NULL on error + * \version LibVLC 2.2.0 or later + */ +LIBVLC_API libvlc_equalizer_t *libvlc_audio_equalizer_new( void ); + +/** + * Create a new equalizer, with initial frequency values copied from an existing + * preset. + * + * The new equalizer can subsequently be applied to a media player by invoking + * libvlc_media_player_set_equalizer(). + * + * The returned handle should be freed via libvlc_audio_equalizer_release() when + * it is no longer needed. + * + * \param u_index index of the preset, counting from zero + * \return opaque equalizer handle, or NULL on error + * (it must be released with libvlc_audio_equalizer_release()) + * \version LibVLC 2.2.0 or later + */ +LIBVLC_API libvlc_equalizer_t *libvlc_audio_equalizer_new_from_preset( unsigned u_index ); + +/** + * Release a previously created equalizer instance. + * + * The equalizer was previously created by using libvlc_audio_equalizer_new() or + * libvlc_audio_equalizer_new_from_preset(). + * + * It is safe to invoke this method with a NULL p_equalizer parameter for no effect. + * + * \param p_equalizer opaque equalizer handle, or NULL + * \version LibVLC 2.2.0 or later + */ +LIBVLC_API void libvlc_audio_equalizer_release( libvlc_equalizer_t *p_equalizer ); + +/** + * Set a new pre-amplification value for an equalizer. + * + * The new equalizer settings are subsequently applied to a media player by invoking + * libvlc_media_player_set_equalizer(). + * + * The supplied amplification value will be clamped to the -20.0 to +20.0 range. + * + * \param p_equalizer valid equalizer handle, must not be NULL + * \param f_preamp preamp value (-20.0 to 20.0 Hz) + * \return zero on success, -1 on error + * \version LibVLC 2.2.0 or later + */ +LIBVLC_API int libvlc_audio_equalizer_set_preamp( libvlc_equalizer_t *p_equalizer, float f_preamp ); + +/** + * Get the current pre-amplification value from an equalizer. + * + * \param p_equalizer valid equalizer handle, must not be NULL + * \return preamp value (Hz) + * \version LibVLC 2.2.0 or later + */ +LIBVLC_API float libvlc_audio_equalizer_get_preamp( libvlc_equalizer_t *p_equalizer ); + +/** + * Set a new amplification value for a particular equalizer frequency band. + * + * The new equalizer settings are subsequently applied to a media player by invoking + * libvlc_media_player_set_equalizer(). + * + * The supplied amplification value will be clamped to the -20.0 to +20.0 range. + * + * \param p_equalizer valid equalizer handle, must not be NULL + * \param f_amp amplification value (-20.0 to 20.0 Hz) + * \param u_band index, counting from zero, of the frequency band to set + * \return zero on success, -1 on error + * \version LibVLC 2.2.0 or later + */ +LIBVLC_API int libvlc_audio_equalizer_set_amp_at_index( libvlc_equalizer_t *p_equalizer, float f_amp, unsigned u_band ); + +/** + * Get the amplification value for a particular equalizer frequency band. + * + * \param p_equalizer valid equalizer handle, must not be NULL + * \param u_band index, counting from zero, of the frequency band to get + * \return amplification value (Hz); NaN if there is no such frequency band + * \version LibVLC 2.2.0 or later + */ +LIBVLC_API float libvlc_audio_equalizer_get_amp_at_index( libvlc_equalizer_t *p_equalizer, unsigned u_band ); + +/** + * Apply new equalizer settings to a media player. + * + * The equalizer is first created by invoking libvlc_audio_equalizer_new() or + * libvlc_audio_equalizer_new_from_preset(). + * + * It is possible to apply new equalizer settings to a media player whether the media + * player is currently playing media or not. + * + * Invoking this method will immediately apply the new equalizer settings to the audio + * output of the currently playing media if there is any. + * + * If there is no currently playing media, the new equalizer settings will be applied + * later if and when new media is played. + * + * Equalizer settings will automatically be applied to subsequently played media. + * + * To disable the equalizer for a media player invoke this method passing NULL for the + * p_equalizer parameter. + * + * The media player does not keep a reference to the supplied equalizer so it is safe + * for an application to release the equalizer reference any time after this method + * returns. + * + * \param p_mi opaque media player handle + * \param p_equalizer opaque equalizer handle, or NULL to disable the equalizer for this media player + * \return zero on success, -1 on error + * \version LibVLC 2.2.0 or later + */ +LIBVLC_API int libvlc_media_player_set_equalizer( libvlc_media_player_t *p_mi, libvlc_equalizer_t *p_equalizer ); + +/** + * Media player roles. + * + * \version LibVLC 3.0.0 and later. + * + * See \ref libvlc_media_player_set_role() + */ +typedef enum libvlc_media_player_role { + libvlc_role_None = 0, /**< Don't use a media player role */ + libvlc_role_Music, /**< Music (or radio) playback */ + libvlc_role_Video, /**< Video playback */ + libvlc_role_Communication, /**< Speech, real-time communication */ + libvlc_role_Game, /**< Video game */ + libvlc_role_Notification, /**< User interaction feedback */ + libvlc_role_Animation, /**< Embedded animation (e.g. in web page) */ + libvlc_role_Production, /**< Audio editing/production */ + libvlc_role_Accessibility, /**< Accessibility */ + libvlc_role_Test /** Testing */ +#define libvlc_role_Last libvlc_role_Test +} libvlc_media_player_role_t; + +/** + * Gets the media role. + * + * \version LibVLC 3.0.0 and later. + * + * \param p_mi media player + * \return the media player role (\ref libvlc_media_player_role_t) + */ +LIBVLC_API int libvlc_media_player_get_role(libvlc_media_player_t *p_mi); + +/** + * Sets the media role. + * + * \param p_mi media player + * \param role the media player role (\ref libvlc_media_player_role_t) + * \return 0 on success, -1 on error + */ +LIBVLC_API int libvlc_media_player_set_role(libvlc_media_player_t *p_mi, + unsigned role); + +/** + * Start/stop recording + * + * \note The user should listen to the libvlc_MediaPlayerRecordChanged event, + * to monitor the recording state. + * + * \version LibVLC 4.0.0 and later. + * + * \param p_mi media player + * \param enable true to start recording, false to stop + * \param dir_path path of the recording directory or NULL (use default path), + * has only an effect when first enabling recording. + */ +LIBVLC_API void libvlc_media_player_record(libvlc_media_player_t *p_mi, + bool enable, const char *dir_path); + +/** @} audio */ + +/** \defgroup libvlc_media_player_watch_time LibVLC media player time watch API + * @{ + */ + +/** + * Media Player timer point + * + * \note ts and system_date values should not be used directly by the user. + * libvlc_media_player_time_point_interpolate() will read these values and + * return an interpolated ts. + * + * @see libvlc_media_player_watch_time_on_update + */ +typedef struct libvlc_media_player_time_point_t +{ + /** Position in the range [0.0f;1.0] */ + double position; + /** Rate of the player */ + double rate; + /** Valid time, in us >= 0 or -1 */ + int64_t ts_us; + /** Valid length, in us >= 1 or 0 */ + int64_t length_us; + /** + * System date, in us, of this record (always valid). + * Based on libvlc_clock(). This date can be in the future or in the past. + * The special value of INT64_MAX mean that the clock was paused when this + * point was updated. In that case, + * libvlc_media_player_time_point_interpolate() will return the current + * ts/pos of this point (there is nothing to interpolate). + * */ + int64_t system_date_us; +} libvlc_media_player_time_point_t; + +/** + * Callback prototype that notify when the player state or time changed. + * + * Get notified when the time is updated by the input or output source. The + * input source is the 'demux' or the 'access_demux'. The output source are + * audio and video outputs: an update is received each time a video frame is + * displayed or an audio sample is written. The delay between each updates may + * depend on the input and source type (it can be every 5ms, 30ms, 1s or + * 10s...). Users of this timer may need to update the position at a higher + * frequency from their own mainloop via + * libvlc_media_player_time_point_interpolate(). + * + * \warning It is forbidden to call any Media Player functions from here. + * + * \param value always valid, the time corresponding to the state + * \param data opaque pointer set by libvlc_media_player_watch_time() + */ +typedef void (*libvlc_media_player_watch_time_on_update)( + const libvlc_media_player_time_point_t *value, void *data); + +/** + * Callback prototype that notify when the timer is paused. + * + * This event is sent when the player is paused or stopping. The player + * user should stop its "interpolate" timer. + * + * \note libvlc_media_player_watch_time_on_update() can be called when paused + * for those 2 reasons: + * - playback is resumed (libvlc_media_player_time_point_t.system_date is valid) + * - a track, likely video (next-frame) is outputted when paused + * (libvlc_media_player_time_point_t.system_date = INT64_MAX) + * + * \warning It is forbidden to call any Media Player functions from here. + * + * \param system_date_us system date, in us, of this event, only valid (> 0) + * when paused. It can be used to interpolate the last updated point to this + * date in order to get the last paused ts/position. + * \param data opaque pointer set by libvlc_media_player_watch_time() + */ +typedef void (*libvlc_media_player_watch_time_on_paused)( + int64_t system_date_us, void *data); + +/** + * Callback prototype that notify when the player is seeking or finished + * seeking + * + * \warning It is forbidden to call any Media Player functions from here. + * + * \note It is not possible to receive points via on_update() while seeking. + * + * \param value point of the seek request or NULL when seeking is finished + * \param data opaque pointer set by libvlc_media_player_watch_time() + */ +typedef void (*libvlc_media_player_watch_time_on_seek)( + const libvlc_media_player_time_point_t *value, void *data); + +/** + * Watch for times updates + * + * \warning Only one watcher can be registered at a time. Calling this function + * a second time (if libvlc_media_player_unwatch_time() was not called + * in-between) will fail. + * + * \param p_mi the media player + * \param min_period_us corresponds to the minimum period, in us, between each + * updates, use it to avoid flood from too many source updates, set it to 0 to + * receive all updates. + * \param on_update callback to listen to update events (must not be NULL) + * \param on_paused callback to listen to paused events (can be NULL) + * \param on_seek callback to listen to seek events (can be NULL) + * \param cbs_data opaque pointer used by the callbacks + * \return 0 on success, -1 on error (allocation error, or if already watching) + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API int +libvlc_media_player_watch_time(libvlc_media_player_t *p_mi, + int64_t min_period_us, + libvlc_media_player_watch_time_on_update on_update, + libvlc_media_player_watch_time_on_paused on_paused, + libvlc_media_player_watch_time_on_seek on_seek, + void *cbs_data); + +/** + * Unwatch time updates + * + * \param p_mi the media player + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API void +libvlc_media_player_unwatch_time(libvlc_media_player_t *p_mi); + +/** + * Interpolate a timer value to now + + * \param point time update obtained via the + * libvlc_media_player_watch_time_on_update() callback + * \param system_now_us current system date, in us, returned by libvlc_clock() + * \param out_ts_us pointer where to set the interpolated ts, in us + * \param out_pos pointer where to set the interpolated position + * \return 0 in case of success, -1 if the interpolated ts is negative (could + * happen during the buffering step) + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API int +libvlc_media_player_time_point_interpolate(const libvlc_media_player_time_point_t *point, + int64_t system_now_us, + int64_t *out_ts_us, double *out_pos); + +/** + * Get the date of the next interval + * + * Can be used to setup an UI timer in order to update some widgets at specific + * interval. A next_interval of VLC_TICK_FROM_SEC(1) can be used to update a + * time widget when the media reaches a new second. + * + * \note The media time doesn't necessarily correspond to the system time, that + * is why this function is needed and uses the rate of the current point. + * + * \param point time update obtained via the + * libvlc_media_player_watch_time_on_update() + * \param system_now_us same system date used by + * libvlc_media_player_time_point_interpolate() + * \param interpolated_ts_us ts returned by + * libvlc_media_player_time_point_interpolate() + * \param next_interval_us next interval, in us + * \return the absolute system date, in us, of the next interval, + * use libvlc_delay() to get a relative delay. + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API int64_t +libvlc_media_player_time_point_get_next_date(const libvlc_media_player_time_point_t *point, + int64_t system_now_us, + int64_t interpolated_ts_us, + int64_t next_interval_us); + +/** @} libvlc_media_player_watch_time */ + +/** \defgroup libvlc_media_player_concurrency LibVLC media player concurrency API + * @{ + */ + +/** + * Lock the media_player internal lock + + * The lock is recursive, so it's safe to use it multiple times from the same + * thread. You must call libvlc_media_player_unlock() the same number of times + * you called libvlc_media_player_lock(). + * + * Locking is not mandatory before calling a libvlc_media_player_t function + * since they will automatically hold the lock internally. + * + * This lock can be used to synchronise user variables that interact with the + * libvlc_media_player_t or can be used to call several functions together. + * + * \param mp media player object + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API void libvlc_media_player_lock( libvlc_media_player_t *mp ); + +/** + * Unlock the media_player internal lock + * + * \see libvlc_media_player_lock + * + * \param mp media player object locked using /ref libvlc_media_player_lock + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API void libvlc_media_player_unlock( libvlc_media_player_t *mp ); + +/** + * Wait for an event to be signalled + * + * \note this is equivalent to pthread_cond_wait() with the + * libvlc_media_player_t internal mutex and condition variable. This function + * may spuriously wake up even without libvlc_media_player_signal() being + * called. + * + * \warning this function must not be called from any libvlc callbacks and + * events. The lock should be held only one time before waiting. + * + * \param mp media player object locked using /ref libvlc_media_player_lock + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API void libvlc_media_player_wait( libvlc_media_player_t *mp ); + +/** + * Signal all threads waiting for a signalling event + * + * \note this is equivalent to pthread_cond_broadcast() with the + * libvlc_media_player_t internal condition variable. + * + * \param mp media player object locked using /ref libvlc_media_player_lock + * \version LibVLC 4.0.0 or later + */ +LIBVLC_API void libvlc_media_player_signal( libvlc_media_player_t *mp ); + +/** @} libvlc_media_player_concurrency */ + +/** @} media_player */ + +# ifdef __cplusplus +} +# endif + +#endif /* VLC_LIBVLC_MEDIA_PLAYER_H */ diff --git a/Libs/vlc/libvlc_media_track.h b/Libs/vlc/libvlc_media_track.h new file mode 100644 index 000000000..d44c12e5e --- /dev/null +++ b/Libs/vlc/libvlc_media_track.h @@ -0,0 +1,212 @@ +/***************************************************************************** + * libvlc_media_track.h: libvlc external API + ***************************************************************************** + * Copyright (C) 1998-2020 VLC authors and VideoLAN + * + * Authors: Clément Stenac + * Jean-Paul Saman + * Pierre d'Herbemont + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation; either version 2.1 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA. + *****************************************************************************/ + +#ifndef VLC_LIBVLC_MEDIA_TRACK_H +#define VLC_LIBVLC_MEDIA_TRACK_H 1 + +# include "libvlc_video.h" + +# ifdef __cplusplus +extern "C" { +# else +# include +# endif + +/** \defgroup libvlc_media_track LibVLC media track + * \ingroup libvlc + * @ref libvlc_media_track_t is an abstract representation of a media track. + * @{ + * \file + * LibVLC media track + */ + +typedef enum libvlc_track_type_t +{ + libvlc_track_unknown = -1, + libvlc_track_audio = 0, + libvlc_track_video = 1, + libvlc_track_text = 2 +} libvlc_track_type_t; + +typedef struct libvlc_audio_track_t +{ + unsigned i_channels; + unsigned i_rate; +} libvlc_audio_track_t; + +/** + * Viewpoint + * + * \warning allocate using libvlc_video_new_viewpoint() + */ +typedef struct libvlc_video_viewpoint_t +{ + float f_yaw; /**< view point yaw in degrees ]-180;180] */ + float f_pitch; /**< view point pitch in degrees ]-90;90] */ + float f_roll; /**< view point roll in degrees ]-180;180] */ + float f_field_of_view; /**< field of view in degrees ]0;180[ (default 80.)*/ +} libvlc_video_viewpoint_t; + +typedef struct libvlc_video_track_t +{ + unsigned i_height; + unsigned i_width; + unsigned i_sar_num; + unsigned i_sar_den; + unsigned i_frame_rate_num; + unsigned i_frame_rate_den; + + libvlc_video_orient_t i_orientation; + libvlc_video_projection_t i_projection; + libvlc_video_viewpoint_t pose; /**< Initial view point */ + libvlc_video_multiview_t i_multiview; +} libvlc_video_track_t; + +typedef struct libvlc_subtitle_track_t +{ + char *psz_encoding; +} libvlc_subtitle_track_t; + +typedef struct libvlc_media_track_t +{ + /* Codec fourcc */ + uint32_t i_codec; + uint32_t i_original_fourcc; + int i_id; /* DEPRECATED: use psz_id */ + libvlc_track_type_t i_type; + + /* Codec specific */ + int i_profile; + int i_level; + + union { + libvlc_audio_track_t *audio; + libvlc_video_track_t *video; + libvlc_subtitle_track_t *subtitle; + }; + + unsigned int i_bitrate; + char *psz_language; + char *psz_description; + + /** String identifier of track, can be used to save the track preference + * from an other LibVLC run */ + const char *psz_id; + /** A string identifier is stable when it is certified to be the same + * across different playback instances for the same track. */ + bool id_stable; + /** Name of the track, only valid when the track is fetch from a + * media_player */ + char *psz_name; + /** true if the track is selected, only valid when the track is fetch from + * a media_player */ + bool selected; + +} libvlc_media_track_t; + +/** + * Opaque struct containing a list of tracks + */ +typedef struct libvlc_media_tracklist_t libvlc_media_tracklist_t; + +/** + * Get the number of tracks in a tracklist + * + * \version LibVLC 4.0.0 and later. + * + * \param list valid tracklist + * + * \return number of tracks, or 0 if the list is empty + */ +LIBVLC_API size_t +libvlc_media_tracklist_count( const libvlc_media_tracklist_t *list ); + +/** + * Get a track at a specific index + * + * \warning The behaviour is undefined if the index is not valid. + * + * \version LibVLC 4.0.0 and later. + * + * \param list valid tracklist + * \param index valid index in the range [0; count[ + * + * \return a valid track (can't be NULL if libvlc_media_tracklist_count() + * returned a valid count) + */ +LIBVLC_API libvlc_media_track_t * +libvlc_media_tracklist_at( libvlc_media_tracklist_t *list, size_t index ); + +/** + * Release a tracklist + * + * \version LibVLC 4.0.0 and later. + * + * \see libvlc_media_get_tracklist + * \see libvlc_media_player_get_tracklist + * + * \param list valid tracklist + */ +LIBVLC_API void +libvlc_media_tracklist_delete( libvlc_media_tracklist_t *list ); + + +/** + * Hold a single track reference + * + * \version LibVLC 4.0.0 and later. + * + * This function can be used to hold a track from a tracklist. In that case, + * the track can outlive its tracklist. + * + * \param track valid track + * \return the same track, need to be released with libvlc_media_track_release() + */ +LIBVLC_API libvlc_media_track_t * +libvlc_media_track_hold( libvlc_media_track_t *track ); + +/** + * Release a single track + * + * \version LibVLC 4.0.0 and later. + * + * \warning Tracks from a tracklist are released alongside the list with + * libvlc_media_tracklist_delete(). + * + * \note You only need to release tracks previously held with + * libvlc_media_track_hold() or returned by + * libvlc_media_player_get_selected_track() and + * libvlc_media_player_get_track_from_id() + * + * \param track valid track + */ +LIBVLC_API void +libvlc_media_track_release( libvlc_media_track_t *track ); +/** @}*/ + +# ifdef __cplusplus +} +# endif + +#endif /* VLC_LIBVLC_MEDIA_TRACK_H */ diff --git a/Libs/vlc/libvlc_picture.h b/Libs/vlc/libvlc_picture.h new file mode 100644 index 000000000..24e1d565d --- /dev/null +++ b/Libs/vlc/libvlc_picture.h @@ -0,0 +1,151 @@ +/***************************************************************************** + * libvlc_picture.h: libvlc external API + ***************************************************************************** + * Copyright (C) 2018 VLC authors and VideoLAN + * + * Authors: Hugo Beauzée-Luyssen + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation; either version 2.1 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA. + *****************************************************************************/ + +#ifndef VLC_LIBVLC_PICTURE_H +#define VLC_LIBVLC_PICTURE_H 1 + +# ifdef __cplusplus +extern "C" { +# endif + +typedef struct libvlc_picture_t libvlc_picture_t; +typedef struct libvlc_picture_list_t libvlc_picture_list_t; + +typedef enum libvlc_picture_type_t +{ + libvlc_picture_Argb, + libvlc_picture_Png, + libvlc_picture_Jpg, + libvlc_picture_WebP, +} libvlc_picture_type_t; + +/** + * Increment the reference count of this picture. + * + * \see libvlc_picture_release() + * \param pic A picture object + * \return the same object + */ +LIBVLC_API libvlc_picture_t * +libvlc_picture_retain( libvlc_picture_t* pic ); + +/** + * Decrement the reference count of this picture. + * When the reference count reaches 0, the picture will be released. + * The picture must not be accessed after calling this function. + * + * \see libvlc_picture_retain + * \param pic A picture object + */ +LIBVLC_API void +libvlc_picture_release( libvlc_picture_t* pic ); + +/** + * Saves this picture to a file. The image format is the same as the one + * returned by \link libvlc_picture_type \endlink + * + * \param pic A picture object + * \param path The path to the generated file + * \return 0 in case of success, -1 otherwise + */ +LIBVLC_API int +libvlc_picture_save( const libvlc_picture_t* pic, const char* path ); + +/** + * Returns the image internal buffer, including potential padding. + * The libvlc_picture_t owns the returned buffer, which must not be modified nor + * freed. + * + * \param pic A picture object + * \param size A pointer to a size_t that will hold the size of the buffer [required] + * \return A pointer to the internal buffer. + */ +LIBVLC_API const unsigned char* +libvlc_picture_get_buffer( const libvlc_picture_t* pic, size_t *size ); + +/** + * Returns the picture type + * + * \param pic A picture object + * \see libvlc_picture_type_t + */ +LIBVLC_API libvlc_picture_type_t +libvlc_picture_type( const libvlc_picture_t* pic ); + +/** + * Returns the image stride, ie. the number of bytes per line. + * This can only be called on images of type libvlc_picture_Argb + * + * \param pic A picture object + */ +LIBVLC_API unsigned int +libvlc_picture_get_stride( const libvlc_picture_t* pic ); + +/** + * Returns the width of the image in pixels + * + * \param pic A picture object + */ +LIBVLC_API unsigned int +libvlc_picture_get_width( const libvlc_picture_t* pic ); + +/** + * Returns the height of the image in pixels + * + * \param pic A picture object + */ +LIBVLC_API unsigned int +libvlc_picture_get_height( const libvlc_picture_t* pic ); + +/** + * Returns the time at which this picture was generated, in milliseconds + * \param pic A picture object + */ +LIBVLC_API libvlc_time_t +libvlc_picture_get_time( const libvlc_picture_t* pic ); + +/** + * Returns the number of pictures in the list + */ +LIBVLC_API size_t libvlc_picture_list_count( const libvlc_picture_list_t* list ); + +/** + * Returns the picture at the provided index. + * + * If the index is out of bound, the result is undefined. + */ +LIBVLC_API libvlc_picture_t* libvlc_picture_list_at( const libvlc_picture_list_t* list, + size_t index ); + +/** + * Destroys a picture list and releases the pictures it contains + * \param list The list to destroy + * + * Calling this function with a NULL list is safe and will return immediately + */ +LIBVLC_API void libvlc_picture_list_destroy( libvlc_picture_list_t* list ); + +# ifdef __cplusplus +} +# endif + +#endif // VLC_LIBVLC_PICTURE_H diff --git a/Libs/vlc/libvlc_renderer_discoverer.h b/Libs/vlc/libvlc_renderer_discoverer.h new file mode 100644 index 000000000..e63a8c9c2 --- /dev/null +++ b/Libs/vlc/libvlc_renderer_discoverer.h @@ -0,0 +1,255 @@ +/***************************************************************************** + * libvlc_renderer_discoverer.h: libvlc external API + ***************************************************************************** + * Copyright © 2016 VLC authors and VideoLAN + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation; either version 2.1 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA. + *****************************************************************************/ + +#ifndef VLC_LIBVLC_RENDERER_DISCOVERER_H +#define VLC_LIBVLC_RENDERER_DISCOVERER_H 1 + +# ifdef __cplusplus +extern "C" { +# endif + +/** + * @defgroup libvlc_renderer_discoverer LibVLC renderer discoverer + * @ingroup libvlc + * LibVLC renderer discoverer finds available renderers available on the local + * network + * @{ + * @file + * LibVLC renderer discoverer external API + */ + +typedef struct libvlc_renderer_discoverer_t libvlc_renderer_discoverer_t; + +/** + * Renderer discoverer description + * + * \see libvlc_renderer_discoverer_list_get() + */ +typedef struct libvlc_rd_description_t +{ + char *psz_name; + char *psz_longname; +} libvlc_rd_description_t; + +/** The renderer can render audio */ +#define LIBVLC_RENDERER_CAN_AUDIO 0x0001 +/** The renderer can render video */ +#define LIBVLC_RENDERER_CAN_VIDEO 0x0002 + +/** + * Renderer item + * + * This struct is passed by a @ref libvlc_event_t when a new renderer is added + * or deleted. + * + * An item is valid until the @ref libvlc_RendererDiscovererItemDeleted event + * is called with the same pointer. + * + * \see libvlc_renderer_discoverer_event_manager() + */ +typedef struct libvlc_renderer_item_t libvlc_renderer_item_t; + + +/** + * Hold a renderer item, i.e. creates a new reference + * + * This functions need to called from the libvlc_RendererDiscovererItemAdded + * callback if the libvlc user wants to use this item after. (for display or + * for passing it to the mediaplayer for example). + * + * \version LibVLC 3.0.0 or later + * + * \return the current item + */ +LIBVLC_API libvlc_renderer_item_t * +libvlc_renderer_item_hold(libvlc_renderer_item_t *p_item); + +/** + * Releases a renderer item, i.e. decrements its reference counter + * + * \version LibVLC 3.0.0 or later + */ +LIBVLC_API void +libvlc_renderer_item_release(libvlc_renderer_item_t *p_item); + +/** + * Get the human readable name of a renderer item + * + * \version LibVLC 3.0.0 or later + * + * \return the name of the item (can't be NULL, must *not* be freed) + */ +LIBVLC_API const char * +libvlc_renderer_item_name(const libvlc_renderer_item_t *p_item); + +/** + * Get the type (not translated) of a renderer item. For now, the type can only + * be "chromecast" ("upnp", "airplay" may come later). + * + * \version LibVLC 3.0.0 or later + * + * \return the type of the item (can't be NULL, must *not* be freed) + */ +LIBVLC_API const char * +libvlc_renderer_item_type(const libvlc_renderer_item_t *p_item); + +/** + * Get the icon uri of a renderer item + * + * \version LibVLC 3.0.0 or later + * + * \return the uri of the item's icon (can be NULL, must *not* be freed) + */ +LIBVLC_API const char * +libvlc_renderer_item_icon_uri(const libvlc_renderer_item_t *p_item); + +/** + * Get the flags of a renderer item + * + * \see LIBVLC_RENDERER_CAN_AUDIO + * \see LIBVLC_RENDERER_CAN_VIDEO + * + * \version LibVLC 3.0.0 or later + * + * \return bitwise flag: capabilities of the renderer, see + */ +LIBVLC_API int +libvlc_renderer_item_flags(const libvlc_renderer_item_t *p_item); + +/** + * Create a renderer discoverer object by name + * + * After this object is created, you should attach to events in order to be + * notified of the discoverer events. + * + * You need to call libvlc_renderer_discoverer_start() in order to start the + * discovery. + * + * \see libvlc_renderer_discoverer_event_manager() + * \see libvlc_renderer_discoverer_start() + * + * \version LibVLC 3.0.0 or later + * + * \param p_inst libvlc instance + * \param psz_name service name; use libvlc_renderer_discoverer_list_get() to + * get a list of the discoverer names available in this libVLC instance + * \return media discover object or NULL in case of error + */ +LIBVLC_API libvlc_renderer_discoverer_t * +libvlc_renderer_discoverer_new( libvlc_instance_t *p_inst, + const char *psz_name ); + +/** + * Release a renderer discoverer object + * + * \version LibVLC 3.0.0 or later + * + * \param p_rd renderer discoverer object + */ +LIBVLC_API void +libvlc_renderer_discoverer_release( libvlc_renderer_discoverer_t *p_rd ); + +/** + * Start renderer discovery + * + * To stop it, call libvlc_renderer_discoverer_stop() or + * libvlc_renderer_discoverer_release() directly. + * + * \see libvlc_renderer_discoverer_stop() + * + * \version LibVLC 3.0.0 or later + * + * \param p_rd renderer discoverer object + * \return -1 in case of error, 0 otherwise + */ +LIBVLC_API int +libvlc_renderer_discoverer_start( libvlc_renderer_discoverer_t *p_rd ); + +/** + * Stop renderer discovery. + * + * \see libvlc_renderer_discoverer_start() + * + * \version LibVLC 3.0.0 or later + * + * \param p_rd renderer discoverer object + */ +LIBVLC_API void +libvlc_renderer_discoverer_stop( libvlc_renderer_discoverer_t *p_rd ); + +/** + * Get the event manager of the renderer discoverer + * + * The possible events to attach are @ref libvlc_RendererDiscovererItemAdded + * and @ref libvlc_RendererDiscovererItemDeleted. + * + * The @ref libvlc_renderer_item_t struct passed to event callbacks is owned by + * VLC, users should take care of holding/releasing this struct for their + * internal usage. + * + * \see libvlc_event_t.u.renderer_discoverer_item_added.item + * \see libvlc_event_t.u.renderer_discoverer_item_removed.item + * + * \version LibVLC 3.0.0 or later + * + * \return a valid event manager (can't fail) + */ +LIBVLC_API libvlc_event_manager_t * +libvlc_renderer_discoverer_event_manager( libvlc_renderer_discoverer_t *p_rd ); + +/** + * Get media discoverer services + * + * \see libvlc_renderer_list_release() + * + * \version LibVLC 3.0.0 and later + * + * \param p_inst libvlc instance + * \param ppp_services address to store an allocated array of renderer + * discoverer services (must be freed with libvlc_renderer_list_release() by + * the caller) [OUT] + * + * \return the number of media discoverer services (0 on error) + */ +LIBVLC_API size_t +libvlc_renderer_discoverer_list_get( libvlc_instance_t *p_inst, + libvlc_rd_description_t ***ppp_services ); + +/** + * Release an array of media discoverer services + * + * \see libvlc_renderer_discoverer_list_get() + * + * \version LibVLC 3.0.0 and later + * + * \param pp_services array to release + * \param i_count number of elements in the array + */ +LIBVLC_API void +libvlc_renderer_discoverer_list_release( libvlc_rd_description_t **pp_services, + size_t i_count ); + +/** @} */ + +# ifdef __cplusplus +} +# endif + +#endif diff --git a/Libs/vlc/libvlc_version.h b/Libs/vlc/libvlc_version.h new file mode 100644 index 000000000..a7fd2cddf --- /dev/null +++ b/Libs/vlc/libvlc_version.h @@ -0,0 +1,79 @@ +/***************************************************************************** + * libvlc_version.h + ***************************************************************************** + * Copyright (C) 2010 Rémi Denis-Courmont + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation; either version 2.1 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA. + *****************************************************************************/ + +/** + * \file + * This file defines version macros for LibVLC. + * Those macros are primilarly intended for conditional (pre)compilation. + * To get the run-time LibVLC version, use libvlc_get_version() instead + * (the run-time version may be more recent than build-time one, thanks to + * backward binary compatibility). + * + * \version This header file is available in LibVLC 1.1.4 and higher. + */ + +#ifndef LIBVLC_VERSION_H +# define LIBVLC_VERSION_H 1 + +/** LibVLC major version number */ +# define LIBVLC_VERSION_MAJOR (4) + +/** LibVLC minor version number */ +# define LIBVLC_VERSION_MINOR (0) + +/** LibVLC revision */ +# define LIBVLC_VERSION_REVISION (0) + +# define LIBVLC_VERSION_EXTRA (0) + +/** Makes a single integer from a LibVLC version numbers */ +# define LIBVLC_VERSION(maj,min,rev,extra) \ + ((maj << 24) | (min << 16) | (rev << 8) | (extra)) + +/** LibVLC full version as a single integer (for comparison) */ +# define LIBVLC_VERSION_INT \ + LIBVLC_VERSION(LIBVLC_VERSION_MAJOR, LIBVLC_VERSION_MINOR, \ + LIBVLC_VERSION_REVISION, LIBVLC_VERSION_EXTRA) + + +/** LibVLC ABI major version number, updated when incompatible changes are added */ +# define LIBVLC_ABI_VERSION_MAJOR (12) + +/** LibVLC ABI minor version number, updated when compatible changes are added */ +# define LIBVLC_ABI_VERSION_MINOR (0) + +/** LibVLC ABI micro version number, updated with new releases */ +# define LIBVLC_ABI_VERSION_MICRO (0) + +/** LibVLC full ABI version combining the major VLC version and the .so version: + * - A 0xFF000000 mask gives the VLC major version, + * - A 0x00FF0000 mask gives the LibVLC major ABI version, + * - A 0x0000FF00 mask gives the LibVLC minor ABI version, + * - A 0x000000FF mask gives the LibVLC ABI revision. + * + * LibVLC is considered compatible with your code if the VLC major and LibVLC + * major values are equal and the minor ABI version is equal or higher than the + * value you compiled with. + */ +# define LIBVLC_ABI_VERSION_INT \ + LIBVLC_VERSION(LIBVLC_VERSION_MAJOR, LIBVLC_ABI_VERSION_MAJOR, \ + LIBVLC_ABI_VERSION_MINOR, LIBVLC_ABI_VERSION_MICRO ) + +#endif diff --git a/Libs/vlc/libvlc_video.h b/Libs/vlc/libvlc_video.h new file mode 100644 index 000000000..afe2b45a7 --- /dev/null +++ b/Libs/vlc/libvlc_video.h @@ -0,0 +1,67 @@ +/***************************************************************************** + * libvlc_video.h: libvlc video-related enumerations + ***************************************************************************** + * Copyright (C) 1998-2010 VLC authors and VideoLAN + * Copyright (C) 2023 Videolabs + * + * Authors: Filippo Carone + * Pierre d'Herbemont + * Alexandre Janniaux + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation; either version 2.1 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA. + *****************************************************************************/ +#ifndef VLC_LIBVLC_VIDEO_H +#define VLC_LIBVLC_VIDEO_H 1 + +# ifdef __cplusplus +extern "C"{ +# endif + +typedef enum libvlc_video_orient_t +{ + libvlc_video_orient_top_left, /**< Normal. Top line represents top, left column left. */ + libvlc_video_orient_top_right, /**< Flipped horizontally */ + libvlc_video_orient_bottom_left, /**< Flipped vertically */ + libvlc_video_orient_bottom_right, /**< Rotated 180 degrees */ + libvlc_video_orient_left_top, /**< Transposed */ + libvlc_video_orient_left_bottom, /**< Rotated 90 degrees clockwise (or 270 anti-clockwise) */ + libvlc_video_orient_right_top, /**< Rotated 90 degrees anti-clockwise */ + libvlc_video_orient_right_bottom /**< Anti-transposed */ +} libvlc_video_orient_t; + +typedef enum libvlc_video_projection_t +{ + libvlc_video_projection_rectangular, + libvlc_video_projection_equirectangular, /**< 360 spherical */ + + libvlc_video_projection_cubemap_layout_standard = 0x100, +} libvlc_video_projection_t; + +typedef enum libvlc_video_multiview_t +{ + libvlc_video_multiview_2d, /**< No stereoscopy: 2D picture. */ + libvlc_video_multiview_stereo_sbs, /**< Side-by-side */ + libvlc_video_multiview_stereo_tb, /**< Top-bottom */ + libvlc_video_multiview_stereo_row, /**< Row sequential */ + libvlc_video_multiview_stereo_col, /**< Column sequential */ + libvlc_video_multiview_stereo_frame, /**< Frame sequential */ + libvlc_video_multiview_stereo_checkerboard, /**< Checkerboard pattern */ +} libvlc_video_multiview_t; + +# ifdef __cplusplus +} // extern "C" +# endif + +#endif diff --git a/Libs/vlc/vlc.h b/Libs/vlc/vlc.h new file mode 100644 index 000000000..1413d9b1b --- /dev/null +++ b/Libs/vlc/vlc.h @@ -0,0 +1,55 @@ +/***************************************************************************** + * vlc.h: global header for libvlc + ***************************************************************************** + * Copyright (C) 1998-2008 VLC authors and VideoLAN + * + * Authors: Vincent Seguin + * Samuel Hocevar + * Gildas Bazin + * Derk-Jan Hartman + * Pierre d'Herbemont + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation; either version 2.1 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA. + *****************************************************************************/ + +#ifndef VLC_VLC_H +#define VLC_VLC_H 1 + +/** + * \file + * This file defines libvlc new external API + */ + +# ifdef __cplusplus +extern "C" { +# endif + +#include "libvlc.h" +#include "libvlc_renderer_discoverer.h" +#include "libvlc_picture.h" +#include "libvlc_media.h" +#include "libvlc_media_player.h" +#include "libvlc_media_list.h" +#include "libvlc_media_list_player.h" +#include "libvlc_media_discoverer.h" +#include "libvlc_events.h" +#include "libvlc_dialog.h" +#include "libvlc_version.h" + +# ifdef __cplusplus +} +# endif + +#endif /* _VLC_VLC_H */ diff --git a/Libs/vlc/x64/libvlc.dll b/Libs/vlc/x64/libvlc.dll new file mode 100644 index 0000000000000000000000000000000000000000..f66e2b5a4fdd589d410b1aae3a6a65116fd70da1 GIT binary patch literal 170496 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

    R!PAqGVGBsylaayGi;-aui0#G5Annb_ za0C=S-i!>T-i!=qKz4aEGMw{fWVixyzc(YpS8qm!JD{-gVPuf-VPtp$Qt!jau)&9s z;SI=qA4Z0r07ix{rA!PH0vH(>0~s0qlrk|01Tr!(1u-(Plrb>~1Tiwq3T9;BDPv+- z5X{K1DVUK#q>PE-Krkc2?O;X*nKCAZ2f>UCe}fqrRLYnb7(y5sVnP@hbjp|*5<(am zo`oBRT*{ajCWJCFsD&{y_>?g*7=$r0bcZoAgn-1u z7#Ze;F*3w}>3`feC7#w048KPns8P0(G z6~o9-6~oAIrHqN8A%>CRb_^rK9gyA_Mh4GVMusP4Obh|Bj0{<^j0|r;Zir=Mm>bK; z@C9U7EF;6CSVo3FAV0=3G6cpkGO(00F(kw>GCYi9WDqE4V)zip$PgXR$RJbB#842= z$j}qd$e>Zq#4sVAkzr2~BZEOX6T^WdMuw0SMg|X%-V{cLqbZCGF(5Umj0{&(85vT_ znHV0VGBVhvF*4+oGch=%F)}o!F*1~Z)TA*oJWFF_XaL!j#>kMA&dAUM5>IDjFwJ0O zSO8L=!N{;YgOOoPITOQ%3`T~^Oh$$snT!ngGZ`7qfXvTiWU$U+WVixSpT)=! zpT)><2jm`*SQaD06OfuLMuxO(MusmSzhpBqsN^y-FjO!xEXZYK(8^lqoYHZU^yR4_3- zXkcXEZDM3d0h!ap$l%n<$WQ`O)5^$D(ZR^jQNhH}(80)1+{wtW0L1QOWH{2r$gl=v zR~I8gaStQI4v=^cBSTX!Bf|-hUA>G9Tl*LpZd5Qa9Oz?Yh@Q;I@T7u?Az?Bj!-FY| z3_n2jPGMwVo5je$Q^~|2FpH7l@+?LMg-Rxd53?8h9GD+Dg#J-0s{lX zf(uLx9?S?^UR-8kkYqvdJ(xk0yI~B$4Dk$M46Y1848aVZ4E_v$4Dk$}41Nr54E|un zds*K9V*tC32h3++Kr(~@!UMSxDhZ}mfcCXA1T&N{6ftBnNav2I35*hLsDjED35*czCQo&}2 zF=R5NFr+f%Gx#t#GWdbToEQWd7#RW>iWu@4QW#1Zk{L?S^!PA1Gbn(~NMXoiNMul8 zC}7B8NMxvFNM!)+CuU$UVc@_pBMdBC%#g{D&j8w_ZNi|#U;xJq40;Ug42*EUp{r(K zFk~=7Qq92N1$HMaEL<2;8HyQ_!C_RuPy)Awfgy~6uzQ;r^cff#d>B$0(isvNa=;;0 zz)%S`EuA5Q0kp>&6pE-~3Jfb56c`K{EEy~r%oubTj2H|Uj2KKA6d2IMRRJ9KDPS3h zYaAI$8A=#381fm47(gd9Ffbfo@Ii4y2tyG=A~<$(84?+a7_y=22>C|`Yzu0N`;EtoV;RNrP882tK#I0)ZD~k z-Q3LNqWt3gv=ZIq{9LQV;#|ElLnVdW#JtS3)Z&t`)S}|d{5*(dc3cVy3JP%3JX2Eh zN-|3-!J;4;WS8j~=ou)%WeOmt0pu4s7A0q7mZXBO$+A__LZ|>8Q(>zFIXw`x-yI@K0 zM< zG%_(UFfuYtvoubuRe}Z!$UPuzgV#-1-C{w6TTBv-(u^!pjde|plPq;jOiT=QlM*eH zbyLhNQ%n*~63tSLEvVuaJwqZ~W0+=UZkB9rrfXr4YN%^sWNfKxX_}OzYhj#XkY<)* zkdkPQ-8BkiMwg+1LSkMDJoXHUaim46L7I7@p^P`Wn!(80#f|h=p!W?Nb0cBM@gA>TsHc!Ty4h%u9-%O5gP&z7#Tooz8My9ED%^A zu|Q#g#sY%{77H8}G%V^^B(bz$wZR&TH4bY$)HSd*|OV@<)DiZu;uI@U~BGh@wy zH7nL^ShHgd0|UbcMsVBl#F7h3ZY)`_jDdlPA%KB_!DB(df`|nP3knugENEEJv0%c2 z1q)Uz*sx&7f&&W}7Ah<>Sm?0OV`0R?goPOk3l@4T4OkknRAIHo>VkC#)}2^)Vcm^& z57vEH_hTJ{022eKO$st$#sY^$3l{HKd|>g7#S9ae7-Se27&uVe9e?LHN literal 0 HcmV?d00001 diff --git a/Libs/vlc/x64/libvlc.lib b/Libs/vlc/x64/libvlc.lib new file mode 100644 index 0000000000000000000000000000000000000000..82b19b1a3d7e7d0560a41320fab84de64090090c GIT binary patch literal 59026 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 VNDp5e^$gnWtcgjP@mOwW1puZ2DMbJP literal 0 HcmV?d00001 diff --git a/Libs/vlc/x64/libvlccore.dll b/Libs/vlc/x64/libvlccore.dll new file mode 100644 index 0000000000000000000000000000000000000000..908e7993a88b990cdc68ee64cb086c84a3decd4c GIT binary patch literal 4082688 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

    aAeyIzVm_XBfogpd(pq54ssESMg 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�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
    p-wu@1!OgwqJt`or4B!@QM~e!m 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    7p98}XcM9fNERF!;KAv=pg}#1 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

    - + @@ -362,7 +362,7 @@
    - IsAudioTrackPlaying(Track) + IsAudioTrackPlaying(track)
    Check if the audio track is playing. @@ -371,7 +371,7 @@

    Parameters:

      -
    • Track +
    • track string Filename to check. Should be without extension and without full directory path.
      • diff --git a/Documentation/doc/1 modules/Strings.html b/Documentation/doc/1 modules/Strings.html index 16b10bee4..8ff839806 100644 --- a/Documentation/doc/1 modules/Strings.html +++ b/Documentation/doc/1 modules/Strings.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -124,15 +124,15 @@

      Functions

    Create(name, totalTime, loop, timerFormat, func[, ...])Create(name, totalTime, loop, timerFormat, func, [...]) Create (but do not start) a new timer.
    Get a timer by its name.
    myTimer:SetFunction(func[, ...])myTimer:SetFunction(func, [...]) Give the timer a new function and args
    Image to show when loading the game.
    SetIntroVideoPath(path)Video to show when loading the game.
    SetTitleScreenImagePath(path) Image to show in the background of the title screen.
    Sets the post-process tint.
    PlayVideo(fileName[, background][, silent][, loop])Play a video file.
    StopVideo()Stop the currently playing video.
    GetVideoPosition()Gets the currently playing video position.
    SetVideoPosition(position)Sets the currently playing video position.
    GetVideoDominantColor()Gets the dominant color for the current video frame.
    IsVideoPlaying([name])Checks if video is currently playing.
    PlayFlyby(seqID) Play a flyby sequence.
    Create a DisplaySprite object.
    DisplaySprite(pos, rot, scale[, color])Create a DisplaySprite object with a video image.
    DisplaySprite:GetObjectID() Get the object ID of the sprite sequence object used by the display sprite.
    =t;tmt|!cy@MsqF==S39>^$Mwe1OrX(}@EX+uc4Y72ugRXk!FC#s*oB@6qWY z0KUA;9kg)`HO-rEfuvc~H2=^W)K4Om-hXd~=p{G3gYV=41szg)2j8U#5(C8+B)!8n zJA#7_6oH@(AOzAoBY!L8pak%67d*LxHl9Hb-~&m(Q#WXc23$oDow`9u8Z&i6a|
    FrWBx-sV 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

    JSD^0J&%lXaNGm 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≥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

    J?P>?PNGL%No++ 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%0D2#_<*LVKs`?e1_l?<8u&e_ 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𝔭t0D!N-XtLp{|eAdCaIM`31x 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

    F2i-U7Bx6*QFC3F*7S#16jT>TFRF0i9F< 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

    Mu16cj?>a0U|~S&#@gOx5{Y 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

    Z`8(lUXz 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

    4WbIfY=E>KM=VkkpL<; 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

     @@ -372,7 +373,7 @@ MENU Lara
    - A Objects.Moveable representing Lara herself. + An Objects.Moveable entry representing Lara herself. diff --git a/Documentation/doc/1 modules/Objects.html b/Documentation/doc/1 modules/Objects.html index 06d84e7c1..eee82fbf8 100644 --- a/Documentation/doc/1 modules/Objects.html +++ b/Documentation/doc/1 modules/Objects.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -189,14 +189,14 @@
    • name string - the unique name of the Moveable as set in, or generated by, Tomb Editor + The unique name of the moveable as set in, or generated by, Tomb Editor.

    Returns:

      - Moveable + Moveable a non-owning Moveable referencing the item.
    @@ -217,15 +217,15 @@
    • name string - the unique name of the mesh as set in, or generated by, Tomb Editor + The unique name of the static mesh as set in, or generated by, Tomb Editor.

    Returns:

      - Static - a non-owning Static referencing the mesh. + Static + a non-owning Static referencing the static mesh.
    @@ -245,7 +245,7 @@
    • slot ObjID - the unique slot of the Moveable, e.g. Objects.ObjID.ANIMATING1 + The unique slot of the moveable, e.g. Objects.ObjID.ANIMATING1.
    @@ -253,7 +253,7 @@
      table - table of Moveables referencing the given slot. + Table of moveables referencing the given slot.
    @@ -273,7 +273,7 @@
    • slot int - the unique slot of the mesh like 10 + The unique numerical slot of the static mesh.
    @@ -281,7 +281,7 @@
      table - table of Statics referencing the given slot ID. + Table of static meshes referencing the given slot.
    @@ -301,7 +301,7 @@
    • tag string - to select rooms by + Tag to select rooms by.
    @@ -309,7 +309,7 @@
      table - table of Rooms containing the given tag. + Table of rooms containing the given tag.
    @@ -329,15 +329,15 @@
    • name string - the unique name of the camera as set in, or generated by, Tomb Editor + The unique name of the camera as set in, or generated by, Tomb Editor.

    Returns:

      - Camera - a non-owning Camera referencing the camera. + Camera + A non-owning Camera referencing the camera.
    @@ -357,15 +357,15 @@
    • name string - the unique name of the sink as set in, or generated by, Tomb Editor + The unique name of the sink as set in, or generated by, Tomb Editor.

    Returns:

      - Sink - a non-owning Sink referencing the sink. + Sink + A non-owning Sink referencing the sink.
    @@ -385,15 +385,15 @@
    • name string - the unique name of the sound source as set in, or generated by, Tomb Editor + The unique name of the sound source as set in, or generated by, Tomb Editor.

    Returns:

      - SoundSource - a non-owning SoundSource referencing the sound source. + SoundSource + A non-owning SoundSource referencing the sound source.
    @@ -413,15 +413,15 @@
    • name string - the unique name of the AIObject as set in, or generated by, Tomb Editor + The unique name of the AIObject as set in, or generated by, Tomb Editor.

    Returns:

      - AIObject - a non-owning SoundSource referencing the AI moveable. + AIObject + A non-owning AIObject referencing the AI object.
    @@ -441,15 +441,15 @@
    • name string - the unique name of the volume as set in, or generated by, Tomb Editor + The unique name of the volume as set in, or generated by, Tomb Editor.

    Returns:

      - Volume - a non-owning Volume referencing the room. + Volume + A non-owning Volume referencing the volume.
    @@ -469,15 +469,15 @@
    • name string - the unique name of the room as set in Tomb Editor + The unique name of the room as set in Tomb Editor.

    Returns:

      - Room - a non-owning Room referencing the room. + Room + A non-owning Room referencing the room.
    diff --git a/Documentation/doc/1 modules/Sound.html b/Documentation/doc/1 modules/Sound.html index d15b22848..74b9aa3da 100644 --- a/Documentation/doc/1 modules/Sound.html +++ b/Documentation/doc/1 modules/Sound.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -156,7 +156,7 @@
    		Check if the sound effect is playing.
    IsAudioTrackPlaying(Track)IsAudioTrackPlaying(track) Check if the audio track is playing.
    - + - + - +
    ShowString(str, time, autoDelete)ShowString(string, [time], [autoDelete]) Show some text on-screen.
    HideString(str)HideString(string) Hide some on-screen text.
    IsStringDisplaying(str)IsStringDisplaying(string) Checks if the string is shown
    @@ -146,7 +146,7 @@
    - ShowString(str, time, autoDelete) + ShowString(string, [time], [autoDelete])
    Show some text on-screen. @@ -155,23 +155,21 @@

    Parameters:

      -
    • str +
    • string DisplayString - the string object to draw + The string object to draw.
    • time float - the time in seconds for which to show the string. -If not given, the string will have an "infinite" life, and will show + The time in seconds for which to show the string. If not given, the string will have an "infinite" life, and will show until HideString is called or until the level is finished. -Default: nil (i.e. infinite) + Optional.
    • autoDelete bool - should be string automatically deleted after timeout is reached. -If not given, the string will remain allocated even after timeout is reached, and can be -shown again without re-initialization. -Default: true + Should be string automatically deleted after timeout is reached. If not given, the string will remain +allocated even after timeout is reached, and can be shown again without re-initialization. + Default: true.
    @@ -182,7 +180,7 @@ Default: true
    - HideString(str) + HideString(string)
    Hide some on-screen text. @@ -191,10 +189,9 @@ Default: true

    Parameters:

      -
    • str +
    • string DisplayString - the string object to hide. Must previously have been shown -with a call to ShowString, or this function will have no effect. + The string object to hide. Must previously have been shown with a call to ShowString, or this function will have no effect.
    @@ -205,7 +202,7 @@ with a call to ShowString, or
    - IsStringDisplaying(str) + IsStringDisplaying(string)
    Checks if the string is shown @@ -214,9 +211,9 @@ with a call to ShowString, or

    Parameters:

      -
    • str +
    • string DisplayString - the string object to be checked + The string object to be checked.
    diff --git a/Documentation/doc/1 modules/Util.html b/Documentation/doc/1 modules/Util.html index 4981e18db..1955d8d41 100644 --- a/Documentation/doc/1 modules/Util.html +++ b/Documentation/doc/1 modules/Util.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -144,15 +144,15 @@ Translate a pair of pixel coordinates to display position coordinates. - PickMoveableByDisplayPosition(Display) + PickMoveableByDisplayPosition(position) Pick a moveable by the given display position. - PickStaticByDisplayPosition(Display) + PickStaticByDisplayPosition(position) Pick a static mesh by the given display position. - PrintLog(message, logLevel, [allowSpam]) + PrintLog(Message, logLevel, [allowSpam]) Write messages within the Log file @@ -169,8 +169,7 @@ HasLineOfSight(roomID, posA, posB)
    - Determine if there is a clear line of sight between two positions. - NOTE: Limited to room geometry. Objects are ignored.() + Determine if there is a clear line of sight between two positions. Limited to room geometry. Objects are ignored. @@ -194,7 +193,7 @@
      bool - true if there is a line of sight, false if not. + true if there is a line of sight, false if not.
    @@ -358,7 +357,7 @@ To be used with - PickMoveableByDisplayPosition(Display) + PickMoveableByDisplayPosition(position)
    Pick a moveable by the given display position. @@ -367,9 +366,9 @@ To be used with Display +
  • position Vec2 - space position in percent. + Display space position in percent.
    • @@ -386,7 +385,7 @@ To be used with - PickStaticByDisplayPosition(Display) + PickStaticByDisplayPosition(position)
    Pick a static mesh by the given display position. @@ -395,9 +394,9 @@ To be used with Display +
  • position Vec2 - space position in percent. + Display space position in percent.
    • @@ -414,7 +413,7 @@ To be used with - PrintLog(message, logLevel, [allowSpam]) + PrintLog(Message, logLevel, [allowSpam])
    Write messages within the Log file @@ -428,17 +427,17 @@ To be used with message +
  • Message string - to be displayed within the Log + to be displayed within the log.
  • logLevel LogLevel - log level to be displayed + Log level to be displayed.
  • allowSpam bool - true allows spamming of the message + If true, allows continuous spamming of the message. Optional.
    • diff --git a/Documentation/doc/1 modules/View.html b/Documentation/doc/1 modules/View.html index 3e55ab4e5..f30980297 100644 --- a/Documentation/doc/1 modules/View.html +++ b/Documentation/doc/1 modules/View.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -124,15 +124,15 @@

    Functions

    - + - + - + @@ -164,7 +164,7 @@ - + @@ -172,7 +172,7 @@ - + @@ -212,7 +212,7 @@ - + @@ -230,7 +230,7 @@
    - FadeIn(speed) + FadeIn([speed])
    Do a full-screen fade-in from black. @@ -241,7 +241,8 @@
    • speed float - (default 1.0). Speed in units per second. A value of 1 will make the fade take one second. + Speed in units per second. A value of 1 will make the fade take one second. + Default: 1.
    @@ -252,7 +253,7 @@
    - FadeOut(speed) + FadeOut([speed])
    Do a full-screen fade-to-black. The screen will remain black until a call to FadeIn. @@ -263,7 +264,8 @@
    • speed float - (default 1.0). Speed in units per second. A value of 1 will make the fade take one second. + Speed in units per second. A value of 1 will make the fade take one second. + Default: 1.
    @@ -274,7 +276,7 @@
    - SetCineBars(height, speed) + SetCineBars([height], [speed])
    Move black cinematic bars in from the top and bottom of the game window. @@ -285,11 +287,13 @@
    • height float - (default 30). Percentage of the screen to be covered + Percentage of the screen to be covered. + Default: 30.
    • speed float - (default 30). Coverage percent per second + Coverage percent per second. + Default: 30.
    @@ -311,7 +315,7 @@
    • angle float - in degrees (clamped to [10, 170]) + Angle in degrees (clamped to [10, 170]).
    @@ -334,7 +338,7 @@
      float - current FOV angle in degrees + Current FOV angle in degrees.
    @@ -355,7 +359,7 @@
      CameraType - value used by the Main Camera. + Value used by the game camera.
    @@ -384,7 +388,7 @@
      Vec3 - current camera position + Current camera position.
    @@ -405,7 +409,7 @@
      Vec3 - current camera target + Current camera target.
    @@ -426,7 +430,7 @@
      Room - current room of the camera + Current room of the camera.
    @@ -446,7 +450,7 @@ @@ -457,7 +461,7 @@
    - SetPostProcessStrength(strength) + SetPostProcessStrength([strength])
    Sets the post-process effect strength. @@ -468,7 +472,8 @@
    • strength float - (default 1.0). How strong the effect is. + How strong the effect is. + Default: 1.
    @@ -501,7 +506,7 @@
    - PlayVideo(fileName[, background][, silent][, loop]) + PlayVideo(fileName, [background], [silent], [loop])
    Play a video file. File should be placed in the FMV folder. @@ -512,23 +517,23 @@
    • fileName string - Video file name. Can be provided without extension, if type is mp4, mkv or avi. + Video file name. Can be provided without extension, if type is mp4, mkv, mov or avi.
    • background bool - (default: false). Play video in the background mode. + Play video in the background mode. In such case, video won't play in fullscreen, but must be shown using special animated texture type in Tomb Editor, or using View.DisplaySprite. - (optional) + Default: false.
    • silent bool - (default: false). Play video without sound. - (optional) + Play video without sound. + Default: false.
    • loop bool - (default: false). Play video in a loop. - (optional) + Play video in a loop. + Default: false.
    @@ -630,7 +635,7 @@
  • name string Video file name. If provided, checks if the currently playing video file name is the same as the provided one. - (optional) + Optional.
    • @@ -758,7 +763,7 @@
    - FlashScreen(color, speed) + FlashScreen([color], [speed])
    Flash screen. @@ -769,11 +774,13 @@
    • color Color - (default Color(255, 255, 255)) + Color. + Default: Color(255, 255, 255).
    • speed float - (default 1.0). Speed in units per second. Value of 1 will make flash take one second. Clamped to [0.005, 1.0]. + Speed in units per second. Value of 1 will make flash take one second. Clamped to [0.005, 1.0]. + Default: 1.
    diff --git a/Documentation/doc/2 classes/Collision.Probe.html b/Documentation/doc/2 classes/Collision.Probe.html index f10d87d34..662726038 100644 --- a/Documentation/doc/2 classes/Collision.Probe.html +++ b/Documentation/doc/2 classes/Collision.Probe.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API diff --git a/Documentation/doc/2 classes/Flow.Level.html b/Documentation/doc/2 classes/Flow.Level.html index c7c23ab6b..f37dc3fb6 100644 --- a/Documentation/doc/2 classes/Flow.Level.html +++ b/Documentation/doc/2 classes/Flow.Level.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -123,7 +123,7 @@
    FadeIn(speed)FadeIn([speed]) Do a full-screen fade-in from black.
    FadeOut(speed)FadeOut([speed]) Do a full-screen fade-to-black.
    SetCineBars(height, speed)SetCineBars([height], [speed]) Move black cinematic bars in from the top and bottom of the game window.
    Sets the post-process effect mode, like negative or monochrome.
    SetPostProcessStrength(strength)SetPostProcessStrength([strength]) Sets the post-process effect strength.
    Sets the post-process tint.
    PlayVideo(fileName[, background][, silent][, loop])PlayVideo(fileName, [background], [silent], [loop]) Play a video file.
    Reset object camera back to Lara and deactivate object camera.
    FlashScreen(color, speed)FlashScreen([color], [speed]) Flash screen.
    - + @@ -139,7 +139,7 @@ - + @@ -151,11 +151,11 @@ - + - + @@ -183,7 +183,7 @@ - + @@ -226,8 +226,7 @@ nameKey
    - (string) string key for the level's (localised) name. - Corresponds to an entry in strings.lua. + (string) String key for the level's name. Corresponds to an entry in strings.lua. @@ -243,7 +242,7 @@
    (string) Level-specific Lua script file. - Path of the Lua file holding the level's logic script, relative to the location of the tombengine executable + Path of the Lua file holding the level's logic script, relative to the location of the Tomb Engine executable. @@ -275,7 +274,7 @@
    (string) Load screen image. - Path of the level's load screen file (.png or .jpg), relative to the location of the tombengine executable + Path of the level's load screen file (.png or .jpg), relative to the location of the Tomb Engine executable. @@ -290,7 +289,7 @@ ambientTrack
    - (string) initial ambient sound track to play. + (string) Initial ambient sound track to play. This is the filename of the track without the .wav extension. @@ -336,7 +335,7 @@ horizon1
    - (Flow.Horizon) First horizon layer. + (Flow.Horizon) Primary horizon object. @@ -351,7 +350,7 @@ horizon2
    - (Flow.Horizon) Second horizon layer. + (Flow.Horizon) Secondary horizon object. @@ -413,7 +412,7 @@
    (bool) Enable flickering lightning in the sky. - Equivalent to classic TRLE's LIGHTNING setting. As in the TRC Ireland levels. + Equivalent to classic TRLE's lightning setting, as in the TRC Ireland levels or TR4 Cairo levels. @@ -460,20 +459,9 @@ laraType
    - (LaraType) Must be one of the LaraType values. -These are:

    - -
    Normal
-Young
-Bunhead
-Catsuit
-Divesuit
-Invisible
-
    - -

    e.g. myLevel.laraType = LaraType.Divesuit

    - -

    Not yet fully implemented. Only types Normal and Young are guaranteed to work. + (LaraType) Appearance of Lara. Must be either LaraType.Normal or LaraType.Young. +E.g. myLevel.laraType = LaraType.Young will make Lara appear as young (with two ponytails rendered). +This setting does not affect ability to use weapons or flares. diff --git a/Documentation/doc/2 classes/Flow.Settings.html b/Documentation/doc/2 classes/Flow.Settings.html index 1c4f98914..58217bcd9 100644 --- a/Documentation/doc/2 classes/Flow.Settings.html +++ b/Documentation/doc/2 classes/Flow.Settings.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -350,7 +350,7 @@

    • crawlExtended bool - when enabled, player will be able to traverse across one-click steps in crawlspaces. + When enabled, player will be able to traverse across one-click steps in crawlspaces.
    @@ -371,7 +371,7 @@
    • crouchRoll bool - when enabled, player can perform crawlspace roll by pressing sprint key. + When enabled, player can perform crawlspace roll by pressing sprint key.
    @@ -392,7 +392,7 @@
    • crawlspaceSwandive bool - when enabled, player will be able to swandive into crawlspaces. + When enabled, player will be able to swandive into crawlspaces.
    @@ -413,7 +413,7 @@
    • sprintJump bool - if enabled, player will be able to perform extremely long jump when sprinting. + If enabled, player will be able to perform extremely long jump when sprinting.
    @@ -434,7 +434,7 @@
    • ledgeJumps bool - if this setting is enabled, player will be able to jump upwards while hanging on the ledge. + If this setting is enabled, player will be able to jump upwards while hanging on the ledge.
    @@ -455,7 +455,7 @@
    • poseTimeout int - if this setting is larger than 0, idle standing pose animation will be performed after given timeout (in seconds). + If this setting is larger than 0, idle standing pose animation will be performed after given timeout (in seconds).
    @@ -483,7 +483,7 @@
    • binocularLightColor Color - color of highlight, when player presses action. Zero color means there will be no highlight. + Color of highlight, when player presses action. Zero color means there will be no highlight.
    @@ -504,7 +504,7 @@
    • lasersightLightColor Color - lasersight highlight color. Zero color means there will be no highlight. + Lasersight highlight color. Zero color means there will be no highlight.
    @@ -525,7 +525,7 @@
    • objectCollision bool - when enabled, camera will collide with moveables and statics. Disable for TR4-like camera behaviour. + When enabled, camera will collide with moveables and statics. Disable for TR4-like camera behaviour.
    @@ -553,7 +553,7 @@
    • color Color - flare color. Used for sparks and lensflare coloring as well. + Flare color. Used for sparks and lensflare coloring as well.
    @@ -574,7 +574,7 @@
    • offset Vec3 - a relative muzzle offset where light and particle effects originate from. + A relative muzzle offset where light and particle effects originate from.
    @@ -595,7 +595,7 @@
    • range int - flare light radius or range. Represented in "clicks" equal to 256 world units. + Flare light radius or range. Represented in "clicks" equal to 256 world units.
    @@ -616,7 +616,7 @@
    • timeout int - flare burn timeout. Flare will stop working after given timeout (specified in seconds). + Flare burn timeout. Flare will stop working after given timeout (specified in seconds).
    @@ -637,7 +637,7 @@
    • pickupCount int - specifies amount of flares that you get when you pick up a box of flares. + Specifies amount of flares that you get when you pick up a box of flares.
    @@ -658,7 +658,7 @@
    • lensflareBrightness float - brightness multiplier. Specifies how bright lens flare is in relation to light (on a range from 0 to 1). + Brightness multiplier. Specifies how bright lens flare is in relation to light (on a range from 0 to 1).
    @@ -679,7 +679,7 @@
    • sparks bool - spark effect. Determines whether flare generates sparks when burning. + Spark effect. Determines whether flare generates sparks when burning.
    @@ -700,7 +700,7 @@
    • smoke bool - smoke effect. Determines whether flare generates smoke when burning. + Smoke effect. Determines whether flare generates smoke when burning.
    @@ -721,7 +721,7 @@
    • flicker bool - light and lensflare flickering. When turned off, flare light will be constant. + Light and lensflare flickering. When turned off, flare light will be constant.
    @@ -751,7 +751,7 @@
    • mesh int - index of a root mesh to which hair will attach. Root mesh may be different for each hair object. + Index of a root mesh to which hair will attach. Root mesh may be different for each hair object.
    @@ -772,7 +772,7 @@
    • offset Vec3 - specifies how braid is positioned in relation to a headmesh. + Specifies how braid is positioned in relation to a headmesh.
    @@ -793,7 +793,7 @@
    • indices table - a list of headmesh's vertex connection indices. Each index corresponds to nearest braid rootmesh vertex. Amount of indices is unlimited. + A list of headmesh's vertex connection indices. Each index corresponds to nearest braid rootmesh vertex. Amount of indices is unlimited.
    @@ -821,7 +821,7 @@
    • statusBars bool - if disabled, all status bars (health, air, stamina) will be hidden. + If disabled, all status bars (health, air, stamina) will be hidden.
    @@ -842,7 +842,7 @@
    • loadingBar bool - if disabled, loading bar will be invisible in game. + If disabled, loading bar will be invisible in game.
    @@ -863,7 +863,7 @@
    • speedometer bool - if disabled, speedometer will be invisible in game. + If disabled, speedometer will be invisible in game.
    @@ -884,7 +884,7 @@
    • pickupNotifier bool - if disabled, pickup notifier will be invisible in game. + If disabled, pickup notifier will be invisible in game.
    @@ -912,7 +912,7 @@
    • gravity float - specifies global gravity. Mostly affects Lara and several other objects. + Specifies global gravity. Mostly affects Lara and several other objects.
    @@ -933,7 +933,7 @@
    • swimVelocity float - specifies swim velocity for Lara. Affects both surface and underwater. + Specifies swim velocity for Lara. Affects both surface and underwater.
    @@ -962,7 +962,7 @@
    • accuracy float - determines accuracy range in angles (smaller angles mean higher accuracy). Applicable only for firearms. + Determines accuracy range in angles (smaller angles mean higher accuracy). Applicable only for firearms.
    @@ -983,7 +983,7 @@
    • targetingDistance float - specifies maximum targeting distance in world units (1 block = 1024 world units) for a given weapon. + Specifies maximum targeting distance in world units (1 block = 1024 world units) for a given weapon.
    @@ -1004,7 +1004,7 @@
    • interval float - specifies an interval (in frames), after which Lara is able to shoot again. Not applicable for backholster weapons. + Specifies an interval (in frames), after which Lara is able to shoot again. Not applicable for backholster weapons.
    @@ -1025,7 +1025,7 @@
    • damage int - amount of hit points taken for every hit. + Amount of hit points taken for every hit.
    @@ -1046,7 +1046,7 @@
    • alternateDamage int - for Revolver and HK, specifies damage in lasersight mode. For crossbow, specifies damage for explosive ammo. + For Revolver and HK, specifies damage in lasersight mode. For crossbow, specifies damage for explosive ammo.
    @@ -1067,7 +1067,7 @@
    • waterLevel int - specifies water depth, at which Lara will put weapons back into holsters, indicating it's not possible to use it in water. + Specifies water depth, at which Lara will put weapons back into holsters, indicating it's not possible to use it in water.
    @@ -1088,7 +1088,7 @@
    • pickupCount int - amount of ammo which is given with every ammo pickup for this weapon. + Amount of ammo which is given with every ammo pickup for this weapon.
    @@ -1193,7 +1193,7 @@
    • shell bool - if set to true, indicates that weapon emits gun shell. Applicable only for firearms. + If set to true, indicates that weapon emits gun shell. Applicable only for firearms.
    @@ -1305,7 +1305,7 @@
    • errorMode ErrorMode - error mode to use. + Error mode to use.
    @@ -1328,7 +1328,7 @@
    • multithreaded bool - determines whether to use multithreading or not. + Determines whether to use multithreading or not.
    @@ -1352,7 +1352,7 @@
    • fastReload bool - toggle fast reload on or off. + Toggles fast reload on or off.
    diff --git a/Documentation/doc/2 classes/Flow.Statistics.html b/Documentation/doc/2 classes/Flow.Statistics.html index 9cc173115..1af7cd652 100644 --- a/Documentation/doc/2 classes/Flow.Statistics.html +++ b/Documentation/doc/2 classes/Flow.Statistics.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -178,7 +178,7 @@
    • ammoHits int - amount of successful enemy hits. + Amount of successful enemy hits.
    @@ -199,7 +199,7 @@
    • ammoUsed int - amount of used ammo. + Amount of used ammo.
    @@ -220,7 +220,7 @@
    • distanceTraveled int - amount of traveled distance in world units. One meter is 420 world units. + Amount of traveled distance in world units. One meter is 420 world units.
    @@ -241,7 +241,7 @@
    • healthPacksUsed int - amount of used medipacks. + Amount of used medipacks.
    @@ -262,7 +262,7 @@
    • damageTaken int - overall amount of taken damage. + overall Amount of taken damage.
    @@ -283,7 +283,7 @@
    • kills int - amount of killed enemies. + Amount of killed enemies.
    @@ -304,7 +304,7 @@
    • pickups int - amount of picked up items. + Amount of picked up items.
    @@ -325,7 +325,7 @@
    • secrets int - amount of found secrets. + Amount of found secrets.
    @@ -346,7 +346,7 @@
    • timeTaken Time - amount of time passed. + Amount of time passed.
    diff --git a/Documentation/doc/2 classes/Objects.AIObject.html b/Documentation/doc/2 classes/Objects.AIObject.html index 0122971a9..bc58896f4 100644 --- a/Documentation/doc/2 classes/Objects.AIObject.html +++ b/Documentation/doc/2 classes/Objects.AIObject.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -125,11 +125,11 @@
    nameKey(string) string key for the level's (localised) name.(string) String key for the level's name.
    scriptFile
    ambientTrack(string) initial ambient sound track to play.(string) Initial ambient sound track to play.
    layer1
    horizon1(Flow.Horizon) First horizon layer.(Flow.Horizon) Primary horizon object.
    horizon2(Flow.Horizon) Second horizon layer.(Flow.Horizon) Secondary horizon object.
    starfield
    laraType(LaraType) Must be one of the LaraType values.(LaraType) Appearance of Lara.
    rumble
    - + - + @@ -141,32 +141,31 @@ - + - + - + - + - + - + - +
    AIObject:GetPosition()Get the object's positionGet the object's position.
    AIObject:SetPosition(position)Set the object's positionSet the object's position.
    AIObject:GetRotationY()
    AIObject:GetName()Get the object's unique string identifierGet the object's unique string identifier.
    AIObject:SetName(name)Set the object's name (its unique string identifier)Set the object's unique string identifier.
    AIObject:GetRoom()Get the current room of the objectGet the current room of the object.
    AIObject:GetRoomNumber()Get the current room number of the objectGet the current room number of the object.
    AIObject:SetRoomNumber(ID)Set room number of the object - This is used in conjunction with SetPosition to teleport the object to a new room.Set room number of the object.
    AIObject:GetObjectID()Retrieve the object IDRetrieve the object ID.
    AIObject:SetObjectID(ID)Change the object's ID.Change the object ID.
    @@ -182,7 +181,7 @@ AIObject:GetPosition()
    - Get the object's position + Get the object's position. @@ -191,7 +190,7 @@
      Vec3 - a copy of the object's position + A copy of the object's position.
    @@ -203,7 +202,7 @@ AIObject:SetPosition(position)
    - Set the object's position + Set the object's position. @@ -211,7 +210,7 @@
    • position Vec3 - the new position of the object + The new position of the object.
    @@ -226,7 +225,6 @@
    Get the object's Y-axis rotation. - To the best of my knowledge, the rotation of an AIObject has no effect. @@ -234,8 +232,8 @@

    Returns:

      - number - the object's Y-axis rotation + int + The object's Y-axis rotation.
    @@ -248,15 +246,14 @@
    Set the object's Y-axis rotation. - To the best of my knowledge, the rotation of an AIObject has no effect.

    Parameters:

    • rotation - number - The object's new Y-axis rotation + int + The object's new Y-axis rotation.
    @@ -270,7 +267,7 @@ AIObject:GetName()
    - Get the object's unique string identifier + Get the object's unique string identifier. @@ -279,7 +276,7 @@
      string - the object's name + The object's name.
    @@ -291,7 +288,7 @@ AIObject:SetName(name)
    - Set the object's name (its unique string identifier) + Set the object's unique string identifier. @@ -299,7 +296,7 @@
    • name string - The object's new name + The object's new name.
    @@ -313,7 +310,7 @@ AIObject:GetRoom()
    - Get the current room of the object + Get the current room of the object. @@ -321,8 +318,8 @@

    Returns:

      - Room - current room of the object + Room + current room of the object.
    @@ -334,7 +331,7 @@ AIObject:GetRoomNumber()
    - Get the current room number of the object + Get the current room number of the object. @@ -343,7 +340,7 @@
      int - number representing the current room of the object + Number representing the current room of the object.
    @@ -355,7 +352,7 @@ AIObject:SetRoomNumber(ID)
    - Set room number of the object + Set room number of the object. This is used in conjunction with SetPosition to teleport the object to a new room. @@ -364,7 +361,7 @@
    • ID int - the ID of the new room + The ID of the new room.
    @@ -378,7 +375,7 @@ AIObject:GetObjectID()
    - Retrieve the object ID + Retrieve the object ID. @@ -387,7 +384,7 @@
      int - a number representing the ID of the object + A number representing the ID of the object.
    @@ -399,7 +396,7 @@ AIObject:SetObjectID(ID)
    - Change the object's ID. This will change the type of AI object it is. + Change the object ID. This will change the type of AI object it is. Note that a baddy will gain the behaviour of the tile it's on before said baddy is triggered. This means that changing the type of an AI object beneath a moveable will have no effect. Instead, this function can be used to change an object that the baddy isn't standing on. @@ -412,7 +409,7 @@
    • ID ObjID - the new ID + the new ID.
    diff --git a/Documentation/doc/2 classes/Objects.Camera.html b/Documentation/doc/2 classes/Objects.Camera.html index 3ca2f2939..117c69637 100644 --- a/Documentation/doc/2 classes/Objects.Camera.html +++ b/Documentation/doc/2 classes/Objects.Camera.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -125,11 +125,11 @@ - + - + @@ -137,24 +137,23 @@ - + - + - + - + - - + +
    Camera:GetPosition()Get the camera's positionGet the camera's position.
    Camera:SetPosition(position)Set the camera's positionSet the camera's position.
    Camera:GetName()
    Camera:SetName(name)Set the camera's name (its unique string identifier)Set the camera's name (its unique string identifier).
    Camera:GetRoom()Get the current room of the cameraGet the current room of the camera.
    Camera:GetRoomNumber()Get the current room number of the cameraGet the current room number of the camera.
    Camera:SetRoomNumber(ID)Set room of camera - This is used in conjunction with SetPosition to teleport the camera to a new room.Set room of camera.
    Camera:PlayCamera([Target])Active the camera during that frame.Camera:PlayCamera([target])Activate the camera for the current game frame.
    @@ -170,7 +169,7 @@ Camera:GetPosition()
    - Get the camera's position + Get the camera's position. @@ -179,7 +178,7 @@
      Vec3 - a copy of the camera's position + Camera's position.
    @@ -191,7 +190,7 @@ Camera:SetPosition(position)
    - Set the camera's position + Set the camera's position. @@ -199,7 +198,7 @@
    • position Vec3 - the new position of the camera + The new position of the camera.
    @@ -222,7 +221,7 @@
      string - the camera's name + the camera's name.
    @@ -234,7 +233,7 @@ Camera:SetName(name)
    - Set the camera's name (its unique string identifier) + Set the camera's name (its unique string identifier). @@ -242,7 +241,7 @@
    • name string - The camera's new name + The camera's new name.
    @@ -256,7 +255,7 @@ Camera:GetRoom()
    - Get the current room of the camera + Get the current room of the camera. @@ -264,8 +263,8 @@

    Returns:

      - Room - current room of the camera + Room + Current room of the camera.
    @@ -277,7 +276,7 @@ Camera:GetRoomNumber()
    - Get the current room number of the camera + Get the current room number of the camera. @@ -286,7 +285,7 @@
      int - number representing the current room of the camera + Number representing the current room of the camera.
    @@ -298,7 +297,7 @@ Camera:SetRoomNumber(ID)
    - Set room of camera + Set room of camera. This is used in conjunction with SetPosition to teleport the camera to a new room. @@ -307,7 +306,7 @@
    • ID int - the ID of the new room + The ID of the new room.
    @@ -318,17 +317,17 @@
    - Camera:PlayCamera([Target]) + Camera:PlayCamera([target])
    - Active the camera during that frame. + Activate the camera for the current game frame.

    Parameters:

      -
    • Target - Moveable +
    • target + Moveable If you put a moveable, the camera will look at it. Otherwise, it will look at Lara. Optional.
      • diff --git a/Documentation/doc/2 classes/Objects.LaraObject.html b/Documentation/doc/2 classes/Objects.LaraObject.html index 7192dc620..64ecafdad 100644 --- a/Documentation/doc/2 classes/Objects.LaraObject.html +++ b/Documentation/doc/2 classes/Objects.LaraObject.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -115,7 +115,7 @@

      Class Objects.LaraObject

      -

      Class for extra player-only functions.

      +

      Class for player-only functions.

      Do not try to create an object of this type. Use the built-in Lara variable instead. LaraObject inherits all the functions of Moveable.

      @@ -124,63 +124,63 @@ - + - + - + - + - + - + - - + + - + - + - + - + - - + + - + - + - + @@ -203,8 +203,16 @@ - - + + + + + + + + + +
      LaraObject:SetPoison([poison])Set player poison.Set the player's poison value.
      LaraObject:GetPoison()Get poison potency of Lara.Get the player's poison value.
      LaraObject:SetAir(air)Set air value of Lara.Set the player's air value.
      LaraObject:GetAir()Get air value of Lara.Get the player's air value.
      LaraObject:SetWet(wetness)Set wetness value of Lara (causes dripping).Set the player's wetness value, causing drips.
      LaraObject:GetWet()Get wetness value of Lara.Get the player's wetness value.
      LaraObject:SetStamina(stamina)Set sprint energy value of Lara.LaraObject:SetStamina(New)Set the player's stamina value.
      LaraObject:GetStamina()Get stamina value of Lara.Get the player's stamina value.
      Moveable:GetAirborne()Get the moveable's airborne status.Get the player's airborne status (set when jumping and falling).
      Moveable:SetAirborne(airborne)Set the moveable's airborne status.Set the player's airborne status.
      LaraObject:UndrawWeapon()Lara will undraw her weapon if it is drawn and throw away a flare if she is currently holding one.Undraw a weapon if it is drawn and throw away a flare if currently holding one.
      LaraObject:ThrowAwayTorch()Lara will throw away the torch if she currently holds one in her hand.LaraObject:DiscardTorch()Discard a held torch.
      LaraObject:GetHandStatus()Get actual hand status of Lara.Get the player's hand status.
      LaraObject:GetWeaponType()Get actual weapon type of Lara.Get the player's weapon type.
      LaraObject:SetWeaponType(weaponType, activate)Set Lara weapon type.Set the player's weapon type.
      LaraObject:GetAmmoType()Get the player's current interacted moveable (if it exists).
      LaraObject:TorchIsLit()Get current light state of the torch, if it existsLaraObject:IsTorchLit()Check if a held torch is lit.
      LaraObject:Interact(mov, [animNumber], [offset], [minOffsetConstraint], [maxOffsetConstraint], [minRotConstraint], [maxRotConstraint], [actionID])Align the player with a moveable object for interaction.
      LaraObject:TestInteraction(mov, [minOffsetConstraint], [maxOffsetConstraint], [minRotConstraint], [maxRotConstraint])Test the player against a moveable object for interaction.
      @@ -220,7 +228,7 @@ LaraObject:SetPoison([poison])
      - Set player poison. + Set the player's poison value. @@ -228,7 +236,7 @@
      • poison int - Poison strength. Maximum value is 128 (default 0) + New poison value. default: 0, max: 128 Optional.
      @@ -247,7 +255,7 @@ LaraObject:GetPoison()
      - Get poison potency of Lara. + Get the player's poison value. @@ -256,7 +264,7 @@
        int - Current poison potency. + Poison value.
      @@ -272,7 +280,7 @@ LaraObject:SetAir(air)
      - Set air value of Lara. + Set the player's air value. @@ -280,7 +288,7 @@
      • air int - Air value to give Lara. Maximum value is 1800. + New air value. max: 1800
      @@ -298,7 +306,7 @@ LaraObject:GetAir()
      - Get air value of Lara. + Get the player's air value. @@ -307,7 +315,7 @@
        int - Current air value. + Air value.
      @@ -323,7 +331,7 @@ LaraObject:SetWet(wetness)
      - Set wetness value of Lara (causes dripping). + Set the player's wetness value, causing drips. @@ -331,7 +339,7 @@
      • wetness int - Wetness value. Maximum value is 255. + New wetness value. max: 255
      @@ -349,7 +357,7 @@ LaraObject:GetWet()
      - Get wetness value of Lara. + Get the player's wetness value. @@ -358,7 +366,7 @@
        int - Current wetness value. + Wetness value.
      @@ -371,18 +379,18 @@
      - LaraObject:SetStamina(stamina) + LaraObject:SetStamina(New)
      - Set sprint energy value of Lara. + Set the player's stamina value.

      Parameters:

        -
      • stamina +
      • New int - Stamina to give to Lara. Maximum value is 120. + stamina value. max: 120
      @@ -400,7 +408,7 @@ LaraObject:GetStamina()
      - Get stamina value of Lara. + Get the player's stamina value. @@ -409,7 +417,7 @@
        int - Current sprint value. + Stamina value.
      @@ -425,7 +433,7 @@ Moveable:GetAirborne()
      - Get the moveable's airborne status. + Get the player's airborne status (set when jumping and falling). @@ -434,7 +442,7 @@
        bool - True if Lara state must react to aerial forces. + True if airborne, otherwise false.
      @@ -446,7 +454,7 @@ Moveable:SetAirborne(airborne)
      - Set the moveable's airborne status. + Set the player's airborne status. @@ -454,7 +462,7 @@
      • airborne bool - New airborne status for Lara. + New airborne status.
      @@ -468,7 +476,7 @@ LaraObject:UndrawWeapon()
      - Lara will undraw her weapon if it is drawn and throw away a flare if she is currently holding one. + Undraw a weapon if it is drawn and throw away a flare if currently holding one. @@ -483,11 +491,11 @@
      - - LaraObject:ThrowAwayTorch() + + LaraObject:DiscardTorch()
      - Lara will throw away the torch if she currently holds one in her hand. + Discard a held torch. @@ -497,7 +505,7 @@

      Usage:

        - 
        Lara:ThrowAwayTorch()
        + 
        Lara:DiscardTorch()
      @@ -506,7 +514,7 @@ LaraObject:GetHandStatus()
      - Get actual hand status of Lara. + Get the player's hand status. @@ -515,7 +523,7 @@
        HandStatus - Current hand status. + Hand status.
      @@ -531,7 +539,7 @@ LaraObject:GetWeaponType()
      - Get actual weapon type of Lara. + Get the player's weapon type. @@ -556,7 +564,7 @@ LaraObject:SetWeaponType(weaponType, activate)
      - Set Lara weapon type. + Set the player's weapon type. @@ -645,7 +653,7 @@
        Moveable - current vehicle (nil if no vehicle present). + Current vehicle (nil if no vehicle present).
      @@ -707,11 +715,11 @@
      - - LaraObject:TorchIsLit() + + LaraObject:IsTorchLit()
      - Get current light state of the torch, if it exists + Check if a held torch is lit. @@ -720,16 +728,122 @@
        bool - is torch currently lit or not? (false if no torch exists) + True if lit, otherwise false (also false if there is no torch in hand).

      Usage:

        - 
        local torchIsLit = Lara:TorchIsLit()
        + 
        local isTorchLit = Lara:IsTorchLit()
      +
      +
      + + LaraObject:Interact(mov, [animNumber], [offset], [minOffsetConstraint], [maxOffsetConstraint], [minRotConstraint], [maxRotConstraint], [actionID]) +
      +
      + Align the player with a moveable object for interaction. + + + +

      Parameters:

      +
        +
      • mov + Moveable + Moveable object to align the player with. +
        • +
      • animNumber + int + The animation to play after alignment is complete. + Default: 197 (BUTTON_PUSH). +
        • +
      • offset + Vec3 + Relative position offset from the moveable. + Default: Vec3(0, 0, 312). +
        • +
      • minOffsetConstraint + Vec3 + Minimum relative offset constraint. + Default: Vec3(-256, -512, 0). +
        • +
      • maxOffsetConstraint + Vec3 + Maximum relative offset constraint. + Default: Vec3(256, 0, 512). +
        • +
      • minRotConstraint + Rotation + Minimum relative rotation constraint. + Default: Rotation(-10, -40, -10). +
        • +
      • maxRotConstraint + Rotation + Maximum relative rotation constraint. + Default: Rotation(10, 40, 10). +
        • +
      • actionID + ActionID + Input action ID to trigger the alignment. + Default: Input.ActionID.ACTION. +
        • +
      + + + + +

      Usage:

      +
        + 
        local Lara:Interact(
+    moveable, 197,
+    Vec3(0, 0, 312), Vec3(-256, -512, -256), Vec3(256, 0, 512),
+   Rotation(-10, -30, -10), Rotation(10, 30, 10), TEN.Input.ActionID.ACTION)
        +
      + +
      +
      + + LaraObject:TestInteraction(mov, [minOffsetConstraint], [maxOffsetConstraint], [minRotConstraint], [maxRotConstraint]) +
      +
      + Test the player against a moveable object for interaction. + + + +

      Parameters:

      +
        +
      • mov + Moveable + Moveable object to align the player with. +
        • +
      • minOffsetConstraint + Vec3 + Minimum relative offset constraint. + Default: Vec3(-256, -512, 0). +
        • +
      • maxOffsetConstraint + Vec3 + Maximum relative offset constraint. + Default: Vec3(256, 0, 512). +
        • +
      • minRotConstraint + Rotation + Minimum relative rotation constraint. + Default: Rotation(-10, -40, -10). +
        • +
      • maxRotConstraint + Rotation + Maximum relative rotation constraint. + Default: Rotation(10, 40, 10). +
        • +
      + + + + +
    diff --git a/Documentation/doc/2 classes/Objects.Moveable.html b/Documentation/doc/2 classes/Objects.Moveable.html index 5810dedcc..afe85e213 100644 --- a/Documentation/doc/2 classes/Objects.Moveable.html +++ b/Documentation/doc/2 classes/Objects.Moveable.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -122,54 +122,48 @@

    Functions

    - + - + - + - - + + - - + + - + - + - + - + - + @@ -177,7 +171,7 @@ - + @@ -197,24 +191,23 @@ - + - + - + - + - + @@ -222,23 +215,23 @@ - + - + - + - + - + @@ -246,23 +239,19 @@ - + - + - + - + @@ -310,7 +299,7 @@ - + @@ -318,11 +307,11 @@ - + - + @@ -338,48 +327,39 @@ - + - + - + - + - + - + - + - + - + @@ -398,16 +378,12 @@ - - - - - + @@ -419,7 +395,7 @@ - +
    Moveable(object, name, position, rotation, roomNumber, animNumber, frameNumber, hp, OCB, AIBits)Moveable(objectID, name, position, [rotation], [roomNumber], [animNumber], [frameNumber], [hp], [OCB], [AIBits]) Used to generate a new moveable dynamically at runtime.
    Moveable:GetObjectID()Retrieve the object IDRetrieve the object ID.
    Moveable:SetObjectID(objectID) Change the object's ID.
    Moveable:SetOnHit(callback)Moveable:SetOnHit(function) Set the name of the function to be called when the moveable is shot by Lara.
    Moveable:SetOnKilled(callback)Set the name of the function to be called when the moveable is destroyed/killed - Note that enemy death often occurs at the end of an animation, and not at the exact moment - the enemy's HP becomes zero.Moveable:SetOnKilled(function)Set the name of the function to be called when the moveable is destroyed/killed.
    Moveable:SetOnCollidedWithObject(func)Set the function to be called when this moveable collides with another moveableMoveable:SetOnCollidedWithObject(function)Set the function to be called when this moveable collides with another moveable.
    Moveable:SetOnCollidedWithRoom(func)Moveable:SetOnCollidedWithRoom(function) Set the function called when this moveable collides with room geometry (e.g.
    Moveable:GetName()Get the moveable's name (its unique string identifier) - e.g.Get the moveable's name (its unique string identifier).
    Moveable:SetName(name)Set the moveable's name (its unique string identifier) - e.g.Set the moveable's name (its unique string identifier).
    Moveable:GetPosition()Get the moveable's positionGet the moveable's position.
    Moveable:SetPosition(position, [updateRoom])Set the moveable's position - If you are moving a moveable whose behaviour involves knowledge of room geometry, - (e.g.Set the moveable's position.
    Moveable:GetJointPosition(jointIndex, [offset])
    Moveable:GetJointRotation(index)Get the object's joint rotationGet the object's joint rotation.
    Moveable:GetRotation()
    Moveable:GetHP()Get current HP (hit points/health points)Get current HP (hit points / health points).
    Moveable:SetHP(HP)Set current HP (hit points/health points) - Clamped to [0, 32767] for "intelligent" entities (i.e.Set current HP (hit points / health points).
    Moveable:GetSlotHP()Get HP definded for that object type (hit points/health points) (Read Only).Get HP definded for that object type (hit points / health points).
    Moveable:GetOCB()Get OCB (object code bit) of the moveableGet OCB (object code bit) of the moveable.
    Moveable:SetOCB(OCB)Set OCB (object code bit) of the moveableSet OCB (object code bit) of the moveable.
    Moveable:SetEffect(effect, [timeout])
    Moveable:SetCustomEffect(color1, color2, [timeout])Set custom colored burn effect to moveableSet custom colored burn effect to moveable.
    Moveable:GetEffect()Get current moveable effectGet current moveable effect.
    Moveable:GetItemFlags(index)Get the value stored in ItemFlags[index]Get the value stored in ItemFlags[index].
    Moveable:SetItemFlags(value, index)Stores a value in ItemFlags[index]Stores a value in ItemFlags[index].
    Moveable:GetLocationAI()Get the location value stored in the Enemy AIGet the location value stored in the Enemy AI.
    Moveable:SetLocationAI(value)
    Moveable:GetColor()Get the moveable's colorGet the moveable's color.
    Moveable:SetColor(color)Set the moveable's colorSet the moveable's color.
    Moveable:GetAIBits()Get AIBits of object - This will return a table with six values, each corresponding to - an active behaviour.Get AIBits of object.
    Moveable:SetAIBits(bits)Set AIBits of object - Use this to force a moveable into a certain AI mode or modes, as if a certain nullmesh - (or more than one) had suddenly spawned beneath their feet.Set AIBits of object.
    Moveable:GetState()
    Moveable:GetActive()Determine whether the moveable is active or notDetermine whether the moveable is active or not.
    Moveable:GetHitStatus()
    Moveable:GetRoom()Get the current room of the objectGet the current room of the moveable.
    Moveable:GetRoomNumber()Get the current room number of the objectGet the current room number of the moveable.
    Moveable:SetRoomNumber(roomID)
    Moveable:GetMeshCount()Get number of meshes for a particular object - Returns number of meshes in an objectGet number of meshes for a particular object.
    Moveable:GetMeshVisible(index)Get state of specified mesh visibility of object - Returns true if specified mesh is visible on an object, and false - if it is not visible.Get state of specified mesh visibility of object.
    Moveable:SetMeshVisible(index, isVisible)Makes specified mesh visible or invisible - Use this to show or hide a specified mesh of an object.Makes specified mesh visible or invisible.
    Moveable:ShatterMesh(index)Shatters specified mesh and makes it invisible - Note that you can re-enable mesh later by using SetMeshVisible().Shatters specified mesh and makes it invisible.
    Moveable:GetMeshSwapped(index)Get state of specified mesh swap of object - Returns true if specified mesh is swapped on an object, and false - if it is not swapped.Get state of specified mesh swap of object.
    Moveable:SwapMesh(index, slotIndex, [swapIndex])Set state of specified mesh swap of object - Use this to swap specified mesh of an object.Set state of specified mesh swap of object.
    Moveable:UnswapMesh(index)Set state of specified mesh swap of object - Use this to bring back original unswapped meshSet state of specified mesh swap of object.
    Moveable:Enable(timeout)Moveable:Enable([timeout]) Enable the item, as if a trigger for it had been stepped on.
    Moveable:Disable()Disable the item, as if an antitrigger for it had been stepped on (i.e.Disable the item, as if an antitrigger for it had been stepped on.
    Moveable:Explode()Set the item's collision.
    Moveable:MakeInvisible()Make the item invisible.
    Moveable:SetVisible(visible) Set the item's visibility.
    Moveable:GetValid()Test if the object is in a valid state (i.e.Test if the object is in a valid state.
    Moveable:Destroy()
    Moveable:AnimFromObject(objectID, animNumber, stateID)Borrow animation from an objectBorrow animation from an object.
    @@ -432,7 +408,7 @@
    - Moveable(object, name, position, rotation, roomNumber, animNumber, frameNumber, hp, OCB, AIBits) + Moveable(objectID, name, position, [rotation], [roomNumber], [animNumber], [frameNumber], [hp], [OCB], [AIBits])
    Used to generate a new moveable dynamically at runtime. @@ -444,9 +420,9 @@ most can just be ignored (see usage).

    Parameters:

      -
    • object +
    • objectID ObjID - ID + Object ID.
    • name string @@ -454,43 +430,50 @@ most can just be ignored (see usage).
    • position Vec3 - position in level + Position in level.
    • rotation Rotation - rotation rotation about x, y, and z axes (default Rotation(0, 0, 0)) + Rotation about x, y, and z axes. + Optional.
    • roomNumber int - the room number the moveable is in (default: calculated automatically). + The room number the moveable is in. Needed if you are dealing with overlapping rooms and need to force certain room number. + Optional.
    • animNumber int - animation number + Animation number. + Optional.
    • frameNumber int - frame number + Frame number. + Optional.
    • hp int Hit points. + Optional.
    • OCB int Object code bits. + Optional.
    • AIBits table - table with AI bits (default { 0, 0, 0, 0, 0, 0 }) + Table with six AI bits. + Optional.

    Returns:

      - Moveable - A new Moveable object (a wrapper around the new object) + Moveable + A new Moveable object.
    @@ -509,7 +492,7 @@ most can just be ignored (see usage). Moveable:GetObjectID()
    - Retrieve the object ID + Retrieve the object ID. @@ -518,7 +501,7 @@ most can just be ignored (see usage).
      ObjID - a number representing the ID of the object. + A number representing the ID of the object.
    @@ -538,7 +521,7 @@ most can just be ignored (see usage).
    • objectID ObjID - the new ID + The new ID.
    @@ -554,7 +537,7 @@ shiva:SetObjectID(TEN.Objects.ObjID.BIGMEDI_ITEM)
    - Moveable:SetOnHit(callback) + Moveable:SetOnHit(function)
    Set the name of the function to be called when the moveable is shot by Lara. @@ -564,9 +547,9 @@ shiva:SetObjectID(TEN.Objects.ObjID.BIGMEDI_ITEM)

    Parameters:

      -
    • callback +
    • function function - function in LevelFuncs hierarchy to call when moveable is shot + Callback function in LevelFuncs hierarchy to call when moveable is shot.
    @@ -577,10 +560,10 @@ shiva:SetObjectID(TEN.Objects.ObjID.BIGMEDI_ITEM)
    - Moveable:SetOnKilled(callback) + Moveable:SetOnKilled(function)
    - Set the name of the function to be called when the moveable is destroyed/killed + Set the name of the function to be called when the moveable is destroyed/killed. Note that enemy death often occurs at the end of an animation, and not at the exact moment the enemy's HP becomes zero. @@ -588,9 +571,9 @@ shiva:SetObjectID(TEN.Objects.ObjID.BIGMEDI_ITEM)

    Parameters:

      -
    • callback +
    • function function - function in LevelFuncs hierarchy to call when enemy is killed + Callback function in LevelFuncs hierarchy to call when moveable is killed.
    @@ -606,18 +589,18 @@ baddy:SetOnKilled(LevelFuncs.baddyKilled)
    - Moveable:SetOnCollidedWithObject(func) + Moveable:SetOnCollidedWithObject(function)
    - Set the function to be called when this moveable collides with another moveable + Set the function to be called when this moveable collides with another moveable.

    Parameters:

      -
    • func +
    • function function - callback function to be called (must be in LevelFuncs hierarchy). This function can take two arguments; these will store the two Moveables taking part in the collision. + Callback function to be called (must be in LevelFuncs hierarchy). This function can take two arguments; these will store the two Moveables taking part in the collision.
    @@ -638,7 +621,7 @@ baddy:SetOnCollidedWithObject(LevelFuncs.objCollided)
    - Moveable:SetOnCollidedWithRoom(func) + Moveable:SetOnCollidedWithRoom(function)
    Set the function called when this moveable collides with room geometry (e.g. a wall or floor). This function can take an argument that holds the Moveable that collided with geometry. @@ -647,9 +630,9 @@ baddy:SetOnCollidedWithObject(LevelFuncs.objCollided)

    Parameters:

      -
    • func +
    • function function - callback function to be called (must be in LevelFuncs hierarchy) + Callback function to be called (must be in LevelFuncs hierarchy).
    @@ -670,9 +653,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:GetName()
    - Get the moveable's name (its unique string identifier) - e.g. "door_back_room" or "cracked_greek_statue" - This corresponds with the "Lua Name" field in an object's properties in Tomb Editor. + Get the moveable's name (its unique string identifier). This corresponds with the "Lua Name" field in an object's properties in Tomb Editor. @@ -681,7 +662,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
      string - the moveable's name + The moveable's name.
    @@ -693,9 +674,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:SetName(name)
    - Set the moveable's name (its unique string identifier) - e.g. "door_back_room" or "cracked_greek_statue" - It cannot be blank and cannot share a name with any existing object. + Set the moveable's name (its unique string identifier). It cannot be blank and cannot share a name with any existing object. @@ -703,7 +682,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    • name string - the new moveable's name + The new moveable's name.
    @@ -711,7 +690,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
      bool - true if we successfully set the name, false otherwise (e.g. if another object has the name already) + true if name was successfully set, false otherwise (e.g. if another moveable has the name already).
    @@ -723,7 +702,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:GetPosition()
    - Get the moveable's position + Get the moveable's position. @@ -732,7 +711,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
      Vec3 - a copy of the moveable's position + Moveable's position.
    @@ -744,10 +723,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:SetPosition(position, [updateRoom])
    - Set the moveable's position - If you are moving a moveable whose behaviour involves knowledge of room geometry, - (e.g. a BADDY1, which uses it for pathfinding), then the second argument should - be true (or omitted, as true is the default). Otherwise, said moveable will not behave correctly. + Set the moveable's position. @@ -755,12 +731,12 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    • position Vec3 - the new position of the moveable + The new position of the moveable.
    • updateRoom bool - Will room changes be automatically detected? Set to false if you are using overlapping rooms (default: true) - Optional. + Will room changes be automatically detected? Set to false if you are using overlapping rooms. + Default: true.
    @@ -807,7 +783,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:GetJointRotation(index)
    - Get the object's joint rotation + Get the object's joint rotation. @@ -823,7 +799,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
      Rotation - a calculated copy of the moveable's joint rotation + Moveable's joint rotation.
    @@ -844,7 +820,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
      Rotation - A copy of the moveable's rotation. + Moveable's rotation.
    @@ -865,7 +841,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
      Vec3 - A copy of the moveable's visual scale. + Moveable's visual scale.
    @@ -885,7 +861,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    • rotation Rotation - The moveable's new rotation + The moveable's new rotation.
    @@ -921,7 +897,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:GetHP()
    - Get current HP (hit points/health points) + Get current HP (hit points / health points). @@ -930,7 +906,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
      int - the amount of HP the moveable currently has + The amount of HP the moveable currently has.
    @@ -942,8 +918,8 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:SetHP(HP)
    - Set current HP (hit points/health points) - Clamped to [0, 32767] for "intelligent" entities (i.e. anything with AI); clamped to [-32767, 32767] otherwise. + Set current HP (hit points / health points). + Clamped to [0, 32767] for "intelligent" entities (i.e. anything with AI); clamped to [-32767, 32767] otherwise. @@ -951,7 +927,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    • HP int - the amount of HP to give the moveable + The amount of HP to give the moveable.
    @@ -965,7 +941,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:GetSlotHP()
    - Get HP definded for that object type (hit points/health points) (Read Only). + Get HP definded for that object type (hit points / health points). @@ -974,7 +950,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
      int - the moveable's slot default hit points + The moveable's slot default hit points.
    @@ -986,7 +962,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:GetOCB()
    - Get OCB (object code bit) of the moveable + Get OCB (object code bit) of the moveable. @@ -995,7 +971,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
      int - the moveable's current OCB value + The moveable's current OCB value.
    @@ -1007,7 +983,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:SetOCB(OCB)
    - Set OCB (object code bit) of the moveable + Set OCB (object code bit) of the moveable. @@ -1015,7 +991,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    • OCB int - the new value for the moveable's OCB + The new value for the moveable's OCB.
    @@ -1041,7 +1017,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
  • timeout float - time (in seconds) after which effect turns off. + Time (in seconds) after which effect turns off. Optional.
    • @@ -1056,7 +1032,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:SetCustomEffect(color1, color2, [timeout])
    - Set custom colored burn effect to moveable + Set custom colored burn effect to moveable. @@ -1087,7 +1063,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:GetEffect()
    - Get current moveable effect + Get current moveable effect. @@ -1108,7 +1084,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:GetItemFlags(index)
    - Get the value stored in ItemFlags[index] + Get the value stored in ItemFlags[index]. @@ -1124,7 +1100,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
      int - the value contained in the ItemFlags[index] + The value contained in the ItemFlags[index].
    @@ -1136,7 +1112,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:SetItemFlags(value, index)
    - Stores a value in ItemFlags[index] + Stores a value in ItemFlags[index]. @@ -1162,7 +1138,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:GetLocationAI()
    - Get the location value stored in the Enemy AI + Get the location value stored in the Enemy AI. @@ -1171,7 +1147,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
      short - the value contained in the LocationAI of the creature. + The value contained in the LocationAI of the creature.
    @@ -1205,7 +1181,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:GetColor()
    - Get the moveable's color + Get the moveable's color. @@ -1214,7 +1190,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
      Color - a copy of the moveable's color + Moveable's color.
    @@ -1226,7 +1202,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:SetColor(color)
    - Set the moveable's color + Set the moveable's color. @@ -1234,7 +1210,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    • color Color - the new color of the moveable + The new color of the moveable.
    @@ -1249,9 +1225,9 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    -

    Get AIBits of object +

    Get AIBits of object. This will return a table with six values, each corresponding to - an active behaviour. If the object is in a certain AI mode, the table will + an active behaviour. If the object is in a certain AI mode, the table will have a 1 in the corresponding cell. Otherwise, the cell will hold a 0.

    @@ -1272,7 +1248,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
      table - a table of AI bits + A table of AI bits.
    @@ -1284,7 +1260,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided) Moveable:SetAIBits(bits)
    - Set AIBits of object + Set AIBits of object. Use this to force a moveable into a certain AI mode or modes, as if a certain nullmesh (or more than one) had suddenly spawned beneath their feet. @@ -1294,7 +1270,7 @@ baddy:SetOnCollidedWithRoom(LevelFuncs.roomCollided)
    • bits table - the table of AI bits + A table of AI bits.
    @@ -1323,7 +1299,7 @@ sas:SetAIBits({1, 0, int - the index of the active state + The index of the active state. @@ -1345,7 +1321,7 @@ sas:SetAIBits({1, 0, int - the index of the target state + The index of the target state. @@ -1367,7 +1343,7 @@ sas:SetAIBits({1, 0,
  • index int - the index of the desired state + The index of the desired state.
    • @@ -1392,7 +1368,7 @@ sas:SetAIBits({1, 0, int - animation slot ID + Animation slot ID. @@ -1414,7 +1390,7 @@ sas:SetAIBits({1, 0, int - the index of the active animation + The index of the active animation. @@ -1436,11 +1412,11 @@ sas:SetAIBits({1, 0,
  • index int - the index of the desired anim + The index of the desired animation.
  • slot int - slot ID of the desired anim (if omitted, moveable's own slot ID is used) + Slot ID of the desired anim (if omitted, moveable's own slot ID is used). Optional.
    • @@ -1465,7 +1441,7 @@ sas:SetAIBits({1, 0, int - the current frame of the active animation + The current frame of the active animation. @@ -1488,7 +1464,7 @@ sas:SetAIBits({1, 0, Vec3 - current object velocity + Current object velocity. @@ -1510,7 +1486,7 @@ sas:SetAIBits({1, 0,
  • velocity Vec3 - velocity represented as vector + Velocity represented as vector.
    • @@ -1536,7 +1512,7 @@ sas:SetAIBits({1, 0,
  • frame int - the new frame number + The new frame number.
    • @@ -1572,7 +1548,7 @@ sas:SetAIBits({1, 0, Moveable:GetActive()
    - Determine whether the moveable is active or not + Determine whether the moveable is active or not. @@ -1581,7 +1557,7 @@ sas:SetAIBits({1, 0, bool - true if the moveable is active + True if the moveable is active. @@ -1602,7 +1578,7 @@ sas:SetAIBits({1, 0, bool - true if the moveable was hit by something in the last gameplay frame, false otherwise + true if the moveable was hit by something in the last gameplay frame, false otherwise. @@ -1614,7 +1590,7 @@ sas:SetAIBits({1, 0, Moveable:GetRoom()
    - Get the current room of the object + Get the current room of the moveable. @@ -1623,7 +1599,7 @@ sas:SetAIBits({1, 0, Room - current room of the object + Current room of the moveable. @@ -1635,7 +1611,7 @@ sas:SetAIBits({1, 0, Moveable:GetRoomNumber()
    - Get the current room number of the object + Get the current room number of the moveable. @@ -1644,7 +1620,7 @@ sas:SetAIBits({1, 0, int - number representing the current room of the object + Number representing the current room of the moveable. @@ -1728,7 +1704,7 @@ sas:SetPosition(newPos, false) Moveable:GetMeshCount()
    - Get number of meshes for a particular object + Get number of meshes for a particular object. Returns number of meshes in an object @@ -1738,7 +1714,7 @@ sas:SetPosition(newPos, false)
      int - number of meshes + Number of meshes.
    @@ -1750,7 +1726,7 @@ sas:SetPosition(newPos, false) Moveable:GetMeshVisible(index)
    - Get state of specified mesh visibility of object + Get state of specified mesh visibility of object. Returns true if specified mesh is visible on an object, and false if it is not visible. @@ -1760,7 +1736,7 @@ sas:SetPosition(newPos, false)
    • index int - index of a mesh + Index of a mesh.
    @@ -1768,7 +1744,7 @@ sas:SetPosition(newPos, false)
      bool - visibility status + Visibility status.
    @@ -1780,7 +1756,7 @@ sas:SetPosition(newPos, false) Moveable:SetMeshVisible(index, isVisible)
    - Makes specified mesh visible or invisible + Makes specified mesh visible or invisible. Use this to show or hide a specified mesh of an object. @@ -1789,11 +1765,11 @@ sas:SetPosition(newPos, false)
    • index int - index of a mesh + Index of a mesh.
    • isVisible bool - true if you want the mesh to be visible, false otherwise + true if you want the mesh to be visible, false otherwise.
    @@ -1807,7 +1783,7 @@ sas:SetPosition(newPos, false) Moveable:ShatterMesh(index)
    - Shatters specified mesh and makes it invisible + Shatters specified mesh and makes it invisible. Note that you can re-enable mesh later by using SetMeshVisible(). @@ -1816,7 +1792,7 @@ sas:SetPosition(newPos, false)
    • index int - index of a mesh + Index of a mesh to shatter.
    @@ -1830,9 +1806,8 @@ sas:SetPosition(newPos, false) Moveable:GetMeshSwapped(index)
    - Get state of specified mesh swap of object - Returns true if specified mesh is swapped on an object, and false - if it is not swapped. + Get state of specified mesh swap of object. + Returns true if specified mesh is swapped on an object, and false if it is not swapped. @@ -1840,7 +1815,7 @@ sas:SetPosition(newPos, false)
    • index int - index of a mesh + Index of a mesh.
    @@ -1848,7 +1823,7 @@ sas:SetPosition(newPos, false)
      bool - mesh swap status + Mesh swap status.
    @@ -1860,7 +1835,7 @@ sas:SetPosition(newPos, false) Moveable:SwapMesh(index, slotIndex, [swapIndex])
    - Set state of specified mesh swap of object + Set state of specified mesh swap of object. Use this to swap specified mesh of an object. @@ -1869,15 +1844,15 @@ sas:SetPosition(newPos, false)
    • index int - index of a mesh + Index of a mesh.
    • slotIndex int - index of a slot to get meshswap from + Index of a slot to get meshswap from.
    • swapIndex int - index of a mesh from meshswap slot to use + Index of a mesh from meshswap slot to use. Optional.
    @@ -1892,7 +1867,7 @@ sas:SetPosition(newPos, false) Moveable:UnswapMesh(index)
    - Set state of specified mesh swap of object + Set state of specified mesh swap of object. Use this to bring back original unswapped mesh @@ -1901,7 +1876,7 @@ sas:SetPosition(newPos, false)
    • index int - index of a mesh to unswap + Index of a mesh to unswap.
    @@ -1912,7 +1887,7 @@ sas:SetPosition(newPos, false)
    - Moveable:Enable(timeout) + Moveable:Enable([timeout])
    Enable the item, as if a trigger for it had been stepped on. @@ -1923,7 +1898,8 @@ sas:SetPosition(newPos, false)
    • timeout float - time (in seconds) after which moveable automatically disables (optional). + Time (in seconds) after which moveable automatically disables. + Optional.
    @@ -1937,8 +1913,8 @@ sas:SetPosition(newPos, false) Moveable:Disable()
    - Disable the item, as if an antitrigger for it had been stepped on (i.e. it will close an open door or extinguish a flame emitter). - Note that this will not trigger an OnKilled callback. + Disable the item, as if an antitrigger for it had been stepped on. + For example, it will close an open door or extinguish a flame emitter. Note that this will not trigger an OnKilled callback. @@ -1992,7 +1968,7 @@ sas:SetPosition(newPos, false)
      bool - item's collision state + Item's collision state.
    @@ -2020,28 +1996,13 @@ sas:SetPosition(newPos, false) -
    -
    - - Moveable:MakeInvisible() -
    -
    - Make the item invisible. Alias for Moveable:SetVisible(false). - - - - - - - -
    Moveable:SetVisible(visible)
    - Set the item's visibility. An invisible item will have collision turned off, as if it no longer exists in the game world. + Set the item's visibility. An invisible item will have collision turned off, as if it no longer exists in the game world. @@ -2049,7 +2010,7 @@ sas:SetPosition(newPos, false)
    • visible bool - true if the caller should become visible, false if it should become invisible + true if the caller should become visible, false if it should become invisible.
    @@ -2063,7 +2024,7 @@ sas:SetPosition(newPos, false) Moveable:GetValid()
    - Test if the object is in a valid state (i.e. has not been destroyed through Lua or killed by Lara). + Test if the object is in a valid state. Indicates that it has not been destroyed through Lua or killed by Lara. @@ -2072,7 +2033,7 @@ sas:SetPosition(newPos, false)
      bool - valid true if the object is still not destroyed + true if the object is still not destroyed.
    @@ -2110,7 +2071,7 @@ sas:SetPosition(newPos, false) Mesh of a target moveable to use as a camera target.
  • target - Moveable + Moveable Target moveable to attach camera to.
  • mesh @@ -2129,7 +2090,7 @@ sas:SetPosition(newPos, false) Moveable:AnimFromObject(objectID, animNumber, stateID)
    - Borrow animation from an object + Borrow animation from an object. @@ -2137,7 +2098,7 @@ sas:SetPosition(newPos, false)
    • objectID ObjID - Object ID to take animation and stateID from. + Object ID to take animation and state ID from.
    • animNumber int @@ -2145,7 +2106,7 @@ sas:SetPosition(newPos, false)
    • stateID int - state State from object. + State from object.
    diff --git a/Documentation/doc/2 classes/Objects.Room.html b/Documentation/doc/2 classes/Objects.Room.html index acc0de38b..d99e4cbf6 100644 --- a/Documentation/doc/2 classes/Objects.Room.html +++ b/Documentation/doc/2 classes/Objects.Room.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API diff --git a/Documentation/doc/2 classes/Objects.Sink.html b/Documentation/doc/2 classes/Objects.Sink.html index 54ee6f9de..67e467d19 100644 --- a/Documentation/doc/2 classes/Objects.Sink.html +++ b/Documentation/doc/2 classes/Objects.Sink.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API diff --git a/Documentation/doc/2 classes/Objects.SoundSource.html b/Documentation/doc/2 classes/Objects.SoundSource.html index 6daf287f2..1ff54349a 100644 --- a/Documentation/doc/2 classes/Objects.SoundSource.html +++ b/Documentation/doc/2 classes/Objects.SoundSource.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -125,27 +125,27 @@ - + - + - + - + - + - +
    SoundSource:GetPosition()Get the sound source's positionGet the sound source's position.
    SoundSource:SetPosition(position)Set the sound source's positionSet the sound source's position.
    SoundSource:GetName()Get the sound source's unique string identifierGet the sound source's unique string identifier.
    SoundSource:SetName(name)Set the sound source's name (its unique string identifier)Set the sound source's unique string identifier.
    SoundSource:GetSoundID()Get the sound source's unique int identifierGet the sound source's sound ID.
    SoundSource:SetSoundID(name)Set the sound source's IDSet the sound source's ID.
    @@ -161,7 +161,7 @@ SoundSource:GetPosition()
    - Get the sound source's position + Get the sound source's position. @@ -170,7 +170,7 @@
      Vec3 - a copy of the sound source's position + Sound source's position.
    @@ -182,7 +182,7 @@ SoundSource:SetPosition(position)
    - Set the sound source's position + Set the sound source's position. @@ -190,7 +190,7 @@
    • position Vec3 - the new position of the sound source + The new position of the sound source.
    @@ -204,7 +204,7 @@ SoundSource:GetName()
    - Get the sound source's unique string identifier + Get the sound source's unique string identifier. @@ -213,7 +213,7 @@
      string - the sound source's name + The sound source's name.
    @@ -225,7 +225,7 @@ SoundSource:SetName(name)
    - Set the sound source's name (its unique string identifier) + Set the sound source's unique string identifier. @@ -233,7 +233,7 @@
    • name string - The sound source's new name + The sound source's new name.
    @@ -247,7 +247,7 @@ SoundSource:GetSoundID()
    - Get the sound source's unique int identifier + Get the sound source's sound ID. @@ -256,7 +256,7 @@
      int - the ID of the sound + The ID of the sound.
    @@ -268,7 +268,7 @@ SoundSource:SetSoundID(name)
    - Set the sound source's ID + Set the sound source's ID. @@ -276,7 +276,7 @@
    • name int - The sound source's new name + The sound source's new sound ID.
    diff --git a/Documentation/doc/2 classes/Objects.Static.html b/Documentation/doc/2 classes/Objects.Static.html index faa84c20f..0ad8251f4 100644 --- a/Documentation/doc/2 classes/Objects.Static.html +++ b/Documentation/doc/2 classes/Objects.Static.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -381,7 +381,7 @@
      bool - Status. true: visible, false: invisible + Status. true means visible, false otherwise.
    @@ -402,7 +402,7 @@
      bool - Collision status. true: can be collided with, false: no collision + Collision status. true if can be collided with, false otherwise.
    @@ -423,7 +423,7 @@
      bool - Solid Status. true: solid, false: soft + Solid Status. true if solid, false if soft.
    @@ -597,7 +597,7 @@
    • status bool - New status. true: solid, false: soft + New status, true is solid, false is soft.
    @@ -619,7 +619,7 @@
    • collidable bool - New collision status. true: can be collided with, false: no collision + New collision status. true if can be collided with, false: no collision.
    diff --git a/Documentation/doc/2 classes/Objects.Volume.html b/Documentation/doc/2 classes/Objects.Volume.html index 77e6b626a..0a3c41b06 100644 --- a/Documentation/doc/2 classes/Objects.Volume.html +++ b/Documentation/doc/2 classes/Objects.Volume.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -160,7 +160,7 @@ Determine if this volume is active. - Volume:IsMoveableInside(Moveable) + Volume:IsMoveableInside(moveable) Determine if a moveable is inside this volume. @@ -189,7 +189,7 @@ Volume:GetName()
    - Get the unique string identifier of this volume. () + Get the unique string identifier of this volume. @@ -210,7 +210,7 @@ Volume:GetPosition()
    - Get the position of this volume. () + Get the position of this volume. @@ -231,7 +231,7 @@ Volume:GetRotation()
    - Get the rotation of this volume. () + Get the rotation of this volume. @@ -252,7 +252,7 @@ Volume:GetScale()
    - Get this scale of this volume. () + Get this scale of this volume. @@ -273,7 +273,7 @@ Volume:SetName(name)
    - Set the unique string identifier of this volume. () + Set the unique string identifier of this volume. @@ -295,7 +295,7 @@ Volume:SetPosition(pos)
    - Set the position of this volume. () + Set the position of this volume. @@ -317,7 +317,7 @@ Volume:SetRotation(rot)
    - Set the rotation of this volume. () + Set the rotation of this volume. @@ -339,7 +339,7 @@ Volume:SetScale(scale)
    - Set the scale of the volume. () + Set the scale of the volume. @@ -361,7 +361,7 @@ Volume:GetActive()
    - Determine if this volume is active. () + Determine if this volume is active. @@ -379,18 +379,18 @@
    - Volume:IsMoveableInside(Moveable) + Volume:IsMoveableInside(moveable)
    - Determine if a moveable is inside this volume. () + Determine if a moveable is inside this volume.

    Parameters:

      -
    • Moveable +
    • moveable Moveable - to be checked for containment. + Moveable to be checked for containment.
    @@ -410,7 +410,7 @@ Volume:Enable()
    - Enable this volume. () + Enable this volume. @@ -425,7 +425,7 @@ Volume:Disable()
    - Disable this volume. () + Disable this volume. @@ -440,7 +440,7 @@ Volume:ClearActivators()
    - Clear the activators for this volume, allowing it to trigger again. () + Clear the activators for this volume, allowing it to trigger again. diff --git a/Documentation/doc/2 classes/Strings.DisplayString.html b/Documentation/doc/2 classes/Strings.DisplayString.html index 4f1088fad..958d506a8 100644 --- a/Documentation/doc/2 classes/Strings.DisplayString.html +++ b/Documentation/doc/2 classes/Strings.DisplayString.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -129,23 +129,23 @@ when you need to use screen-space coordinates.

    Functions

    - + - + - + - + - + @@ -166,11 +166,7 @@ when you need to use screen-space coordinates.

    - - - - - +
    DisplayString(string, Position, [scale], [color], [translated], table)DisplayString(string, position, [scale], [color], [translated], [flags]) Create a DisplayString.
    DisplayString:GetColor()Get the display string's colorGet the display string's color.
    DisplayString:SetColor(color)Set the display string's colorSet the display string's color.
    DisplayString:GetKey()Get the string key to use.Get the string key.
    DisplayString:SetKey(string)DisplayString:SetKey(key) Set the string key to use.
    DisplayString:SetFlags(table)Set the display string's flags
    DisplayString:SetTranslated(shouldTranslate)Set translated parameter of the stringSet the display string's flags.
    @@ -183,7 +179,7 @@ when you need to use screen-space coordinates.

    - DisplayString(string, Position, [scale], [color], [translated], table) + DisplayString(string, position, [scale], [color], [translated], [flags])
    Create a DisplayString. @@ -197,29 +193,30 @@ For use in ShowString and string The string to display or key of the translated string.
    • -
  • Position +
  • position Vec2 - of the string in pixel coordinates. + Position of the string in pixel coordinates.
  • scale float - size of the string, relative to the default size. Default: 1.0 - Optional. + Size of the string, relative to the default size. + Default: 1.
  • color Color - the color of the text. Default: white - Optional. + The color of the text. + Default: Color(255, 255, 255).
  • translated bool If false or omitted, the input string argument will be displayed. -If true, the string argument will be the key of a translated string specified in strings.lua. Default: false. - Optional. +If true, the string argument will be the key of a translated string specified in strings.lua. + Default: false.
    • -
  • table +
  • flags DisplayStringOption - Default: None. Please note that Strings are automatically aligned to the LEFT + Flags which affect visual representation of a string, such as shadow or alignment. + Optional.
    • @@ -239,7 +236,7 @@ If true, the string argument will be the key of a translated string specified in DisplayString:GetColor()
    - Get the display string's color + Get the display string's color. @@ -248,7 +245,7 @@ If true, the string argument will be the key of a translated string specified in
      Color - a copy of the display string's color + Display string's color.
    @@ -260,7 +257,7 @@ If true, the string argument will be the key of a translated string specified in DisplayString:SetColor(color)
    - Set the display string's color + Set the display string's color. @@ -268,7 +265,7 @@ If true, the string argument will be the key of a translated string specified in
    • color Color - the new color of the display string + The new color of the display string.
    @@ -282,9 +279,7 @@ If true, the string argument will be the key of a translated string specified in DisplayString:GetKey()
    - Get the string key to use. If isTranslated is true when DisplayString - is called, this will be the string key for the translation that will be displayed. - If false or omitted, this will be the string that's displayed.() + Get the string key. @@ -293,7 +288,7 @@ If true, the string argument will be the key of a translated string specified in
      string - the string to use + The string key.
    @@ -302,20 +297,18 @@ If true, the string argument will be the key of a translated string specified in
    - DisplayString:SetKey(string) + DisplayString:SetKey(key)
    - Set the string key to use. If isTranslated is true when DisplayString - is called, this will be the string key for the translation that will be displayed. - If false or omitted, this will be the string that's displayed.() + Set the string key to use.

    Parameters:

      -
    • string +
    • key string - the new key for the display string + The new key for the display string.
    @@ -329,7 +322,7 @@ If true, the string argument will be the key of a translated string specified in DisplayString:SetScale(scale)
    - Set the scale of the string. () + Set the scale of the string. @@ -351,7 +344,7 @@ If true, the string argument will be the key of a translated string specified in DisplayString:GetScale()
    - Get the scale of the string. () + Get the scale of the string. @@ -373,7 +366,7 @@ If true, the string argument will be the key of a translated string specified in
    Set the position of the string. - Screen-space coordinates are expected.() + Screen-space coordinates are expected. @@ -396,7 +389,7 @@ If true, the string argument will be the key of a translated string specified in
    Get the position of the string. - Screen-space coordinates are returned.() + Screen-space coordinates are returned. @@ -417,7 +410,7 @@ If true, the string argument will be the key of a translated string specified in DisplayString:SetFlags(table)
    - Set the display string's flags () + Set the display string's flags. @@ -425,7 +418,7 @@ If true, the string argument will be the key of a translated string specified in
    • table table - the new table with display flags options + The new table with display flags options.
    @@ -444,29 +437,6 @@ varDisplayString:SetFlags({ TEN.Strings.DisplayStringOption.SHADOW, TEN.Strings. varDisplayString:SetFlags{ TEN.Strings.DisplayStringOption.CENTER } -
    -
    - - DisplayString:SetTranslated(shouldTranslate) -
    -
    - Set translated parameter of the string - - - -

    Parameters:

    -
      -
    • shouldTranslate - bool - if true, the string's key will be used as the key for the translation that will be displayed. - If false, the key itself will be displayed -
      • -
    - - - - -
    diff --git a/Documentation/doc/2 classes/View.DisplaySprite.html b/Documentation/doc/2 classes/View.DisplaySprite.html index e46055254..9347dded9 100644 --- a/Documentation/doc/2 classes/View.DisplaySprite.html +++ b/Documentation/doc/2 classes/View.DisplaySprite.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -124,11 +124,11 @@

    Functions

    - + - + @@ -156,27 +156,27 @@ - + - + - + - + - + - + @@ -194,7 +194,7 @@
    - DisplaySprite(ID, int, pos, rot, scale, [color]) + DisplaySprite(objectID, index, pos, rot, scale, [color])
    Create a DisplaySprite object. @@ -203,13 +203,13 @@

    Parameters:

      -
    • ID +
    • objectID SpriteConstants - of the sprite sequence object. + ID of the sprite sequence object.
      • -
    • int +
    • index int - spriteID ID of the sprite in the sequence. + Index of the sprite in the sequence.
    • pos Vec2 @@ -225,8 +225,8 @@
    • color Color - Color. Default: Color(255, 255, 255, 255) - Optional. + Color. + Default: Color(255, 255, 255).
    @@ -243,7 +243,7 @@
    - DisplaySprite(pos, rot, scale[, color]) + DisplaySprite(pos, rot, scale, [color])
    Create a DisplaySprite object with a video image. @@ -268,7 +268,7 @@
  • color Color Color. Default: Color(255, 255, 255, 255) - (optional) + Optional.
    • @@ -288,7 +288,7 @@ DisplaySprite:GetObjectID()
    - Get the object ID of the sprite sequence object used by the display sprite. () + Get the object ID of the sprite sequence object used by the display sprite. @@ -309,7 +309,7 @@ DisplaySprite:GetSpriteID()
    - Get the sprite ID in the sprite sequence object used by the display sprite. () + Get the sprite ID in the sprite sequence object used by the display sprite. @@ -330,7 +330,7 @@ DisplaySprite:GetPosition()
    - Get the display position of the display sprite in percent. () + Get the display position of the display sprite in percent. @@ -351,7 +351,7 @@ DisplaySprite:GetRotation()
    - Get the rotation of the display sprite in degrees. () + Get the rotation of the display sprite in degrees. @@ -372,7 +372,7 @@ DisplaySprite:GetScale()
    - Get the horizontal and vertical scale of the display sprite in percent. () + Get the horizontal and vertical scale of the display sprite in percent. @@ -393,7 +393,7 @@ DisplaySprite:GetColor()
    - Get the color of the display sprite. () + Get the color of the display sprite. @@ -411,18 +411,18 @@
    - DisplaySprite:SetObjectID(New) + DisplaySprite:SetObjectID(objectID)
    - Set the sprite sequence object ID used by the display sprite. (Objects.ObjID.SpriteConstants) + Set the sprite sequence object ID used by the display sprite.

    Parameters:

      -
    • New +
    • objectID SpriteConstants - sprite sequence object ID. + New sprite sequence object ID.
    @@ -433,18 +433,18 @@
    - DisplaySprite:SetSpriteID(New) + DisplaySprite:SetSpriteID(spriteID)
    - Set the sprite ID in the sprite sequence object used by the display sprite. (int) + Set the sprite ID in the sprite sequence object used by the display sprite.

    Parameters:

      -
    • New +
    • spriteID int - sprite ID in the sprite sequence object. + New sprite ID in the sprite sequence object.
    @@ -455,18 +455,18 @@
    - DisplaySprite:SetPosition(New) + DisplaySprite:SetPosition(position)
    - Set the display position of the display sprite in percent. (Vec2) + Set the display position of the display sprite in percent.

    Parameters:

      -
    • New +
    • position Vec2 - display position in percent. + New display position in percent.
    @@ -477,18 +477,18 @@
    - DisplaySprite:SetRotation(New) + DisplaySprite:SetRotation(rotation)
    - Set the rotation of the display sprite in degrees. (float) + Set the rotation of the display sprite in degrees.

    Parameters:

      -
    • New +
    • rotation float - rotation in degrees. + New rotation in degrees.
    @@ -499,18 +499,18 @@
    - DisplaySprite:SetScale(New) + DisplaySprite:SetScale(scale)
    - Set the horizontal and vertical scale of the display sprite in percent. (Vec2) + Set the horizontal and vertical scale of the display sprite in percent.

    Parameters:

      -
    • New +
    • scale float - horizontal and vertical scale in percent. + New horizontal and vertical scale in percent.
    @@ -521,18 +521,18 @@
    - DisplaySprite:SetColor(New) + DisplaySprite:SetColor(color)
    - Set the color of the display sprite. (Color) + Set the color of the display sprite.

    Parameters:

      -
    • New - float - color. +
    • color + Color + New color.
    @@ -554,23 +554,23 @@
    • priority int - Draw priority. Can be thought of as a layer, with higher values having precedence. Default: 0 - Optional. + Draw priority. Can be thought of as a layer, with higher values having precedence. + Default: 0.
    • alignMode AlignMode - Align mode interpreting an offset from the sprite's position. Default: View.AlignMode.CENTER - Optional. + Align mode interpreting an offset from the sprite's position. + Default: View.AlignMode.CENTER.
    • scaleMode ScaleMode - Scale mode interpreting the display sprite's horizontal and vertical scale. Default: View.ScaleMode.FIT - Optional. + Scale mode interpreting the display sprite's horizontal and vertical scale. + Default: View.ScaleMode.FIT.
    • blendMode BlendID - Blend mode. Default: Effects.BlendID.ALPHABLEND - Optional. + Blend mode. + Default: Effects.BlendID.ALPHABLEND.
    diff --git a/Documentation/doc/3 primitive classes/Color.html b/Documentation/doc/3 primitive classes/Color.html index e10a2c8ec..83926a141 100644 --- a/Documentation/doc/3 primitive classes/Color.html +++ b/Documentation/doc/3 primitive classes/Color.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -240,15 +240,15 @@
    • R int - red component + Red component.
    • G int - green component + Green component.
    • B int - blue component + Blue component.
    diff --git a/Documentation/doc/3 primitive classes/Flow.Fog.html b/Documentation/doc/3 primitive classes/Flow.Fog.html index dbf35a6b5..ca503ee87 100644 --- a/Documentation/doc/3 primitive classes/Flow.Fog.html +++ b/Documentation/doc/3 primitive classes/Flow.Fog.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -221,11 +221,11 @@
  • min int - Distance at which fog starts (in sectors) + Distance at which fog starts (in sectors).
  • max int - Distance at which fog reaches the maximum strength (in sectors) + Distance at which fog reaches the maximum strength (in sectors).
    • diff --git a/Documentation/doc/3 primitive classes/Flow.Horizon.html b/Documentation/doc/3 primitive classes/Flow.Horizon.html index 891539543..f0eebb4e5 100644 --- a/Documentation/doc/3 primitive classes/Flow.Horizon.html +++ b/Documentation/doc/3 primitive classes/Flow.Horizon.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API diff --git a/Documentation/doc/3 primitive classes/Flow.InventoryItem.html b/Documentation/doc/3 primitive classes/Flow.InventoryItem.html index ac66af1ac..ba857b892 100644 --- a/Documentation/doc/3 primitive classes/Flow.InventoryItem.html +++ b/Documentation/doc/3 primitive classes/Flow.InventoryItem.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -147,8 +147,7 @@
    • nameKey string - key for the item's (localised) name.
      -Corresponds to an entry in strings.lua. + key for the item's (localised) name. Corresponds to an entry in strings.lua.
    • objectID ObjID @@ -167,7 +166,7 @@ and a value of 2 will cause the item to render at twice the size.
    • rot Rotation - rotation around x, y, and z axes + rotation around x, y, and z axes.
    • axis RotationAxis @@ -182,7 +181,7 @@ Z
    • meshBits int - Not currently implemented (will have no effect regardless of what you set it to) + Not currently implemented (will have no effect regardless of what you set it to).
    • action ItemAction @@ -201,7 +200,7 @@ EXAMINE
        InventoryItem - an InventoryItem + an InventoryItem.
      diff --git a/Documentation/doc/3 primitive classes/Flow.LensFlare.html b/Documentation/doc/3 primitive classes/Flow.LensFlare.html index 172afbfdf..9c8eb9e47 100644 --- a/Documentation/doc/3 primitive classes/Flow.LensFlare.html +++ b/Documentation/doc/3 primitive classes/Flow.LensFlare.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API diff --git a/Documentation/doc/3 primitive classes/Flow.SkyLayer.html b/Documentation/doc/3 primitive classes/Flow.SkyLayer.html index dc92bbb1d..0207a8300 100644 --- a/Documentation/doc/3 primitive classes/Flow.SkyLayer.html +++ b/Documentation/doc/3 primitive classes/Flow.SkyLayer.html @@ -3,7 +3,7 @@ - TombEngine 1.8.1 Lua API + TombEngine 1.8.2 Lua API @@ -123,11 +123,11 @@
    DisplaySprite(ID, int, pos, rot, scale, [color])DisplaySprite(objectID, index, pos, rot, scale, [color]) Create a DisplaySprite object.
    DisplaySprite(pos, rot, scale[, color])DisplaySprite(pos, rot, scale, [color]) Create a DisplaySprite object with a video image.
    Get the color of the display sprite.
    DisplaySprite:SetObjectID(New)DisplaySprite:SetObjectID(objectID) Set the sprite sequence object ID used by the display sprite.
    DisplaySprite:SetSpriteID(New)DisplaySprite:SetSpriteID(spriteID) Set the sprite ID in the sprite sequence object used by the display sprite.
    DisplaySprite:SetPosition(New)DisplaySprite:SetPosition(position) Set the display position of the display sprite in percent.
    DisplaySprite:SetRotation(New)DisplaySprite:SetRotation(rotation) Set the rotation of the display sprite in degrees.
    DisplaySprite:SetScale(New)DisplaySprite:SetScale(scale) Set the horizontal and vertical scale of the display sprite in percent.
    DisplaySprite:SetColor(New)DisplaySprite:SetColor(color) Set the color of the display sprite.
    - + - +
    color(Color) RGB sky color(Color) RGB sky color.
    speed(int) cloud speed.(int) Cloud speed.

    Functions

    @@ -152,7 +152,7 @@ color
    - (Color) RGB sky color + (Color) RGB sky color. @@ -167,7 +167,7 @@ speed
    - (int) cloud speed.

    + (int) Cloud speed. 

        Values can be between [-32768, 32767], with positive numbers resulting in a sky that scrolls from
     west to east, and negative numbers resulting in one that travels east to west.
@@ -205,11 +205,11 @@
     
      
         
    • color
             Color
-         RGB color
+         RGB color.
         
      • 
         
    • speed
             int
-         cloud speed
+         Cloud speed.
         
      • 
     
    
 
diff --git a/Documentation/doc/3 primitive classes/Flow.Starfield.html b/Documentation/doc/3 primitive classes/Flow.Starfield.html
index 9182b0b89..feab0e343 100644
--- a/Documentation/doc/3 primitive classes/Flow.Starfield.html	
+++ b/Documentation/doc/3 primitive classes/Flow.Starfield.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
@@ -281,7 +281,7 @@
     
    Returns:
    
     
      
 
-           StarField
+           Starfield
         A new Starfield object.
     
    
 
diff --git a/Documentation/doc/3 primitive classes/Rotation.html b/Documentation/doc/3 primitive classes/Rotation.html
index 08d1dedf6..1c39be191 100644
--- a/Documentation/doc/3 primitive classes/Rotation.html	
+++ b/Documentation/doc/3 primitive classes/Rotation.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/3 primitive classes/Time.html b/Documentation/doc/3 primitive classes/Time.html
index 1edf989a5..9a671f125 100644
--- a/Documentation/doc/3 primitive classes/Time.html	
+++ b/Documentation/doc/3 primitive classes/Time.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/3 primitive classes/Vec2.html b/Documentation/doc/3 primitive classes/Vec2.html
index 4bedd88bf..7a9e44453 100644
--- a/Documentation/doc/3 primitive classes/Vec2.html	
+++ b/Documentation/doc/3 primitive classes/Vec2.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/3 primitive classes/Vec3.html b/Documentation/doc/3 primitive classes/Vec3.html
index 5ff74ce81..f8e233fbc 100644
--- a/Documentation/doc/3 primitive classes/Vec3.html	
+++ b/Documentation/doc/3 primitive classes/Vec3.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/4 enums/Collision.MaterialType.html b/Documentation/doc/4 enums/Collision.MaterialType.html
index 564b8ca1f..8ed328b63 100644
--- a/Documentation/doc/4 enums/Collision.MaterialType.html	
+++ b/Documentation/doc/4 enums/Collision.MaterialType.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
@@ -142,7 +142,10 @@
     
     
    
 
-
    Table of MaterialType constants.  To be used with Collision.Probe.GetFloorMaterialType and Collision.Probe.GetCeilingMaterialType.
    
+
    Table of MaterialType constants.
+ 
    
+ Corresponds to Tomb Editor texture sound material types.
+ To be used with Collision.Probe.GetFloorMaterialType and Collision.Probe.GetCeilingMaterialType.
    
 
 
      
     
    • MUD
      • 
diff --git a/Documentation/doc/4 enums/Effects.BlendID.html b/Documentation/doc/4 enums/Effects.BlendID.html
index bd2f1aca9..5c3fc42f4 100644
--- a/Documentation/doc/4 enums/Effects.BlendID.html	
+++ b/Documentation/doc/4 enums/Effects.BlendID.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
@@ -142,18 +142,20 @@
     
     
      
 
-
      Table of Effects.BlendID constants. 
      
+
      Table of Effects.BlendID constants.
+ 
      
+ All blending modes except OPAQUE, ADDITIVE and ALPHA_BLEND will use depth sorting for applicable polygons.
+ This may reduce engine performance, so it is preferable to minimize usage of other blending modes.
      
 
 
        
-    
      • OPAQUE
        • 
-    
      • ALPHA_TEST
        • 
-    
      • ADDITIVE
        • 
-    
      • NO_DEPTH_TEST
        • 
-    
      • SUBTRACTIVE
        • 
-    
      • EXCLUDE
        • 
-    
      • SCREEN
        • 
-    
      • LIGHTEN
        • 
-    
      • ALPHA_BLEND
        • 
+    
      • OPAQUE - No transparency.
        • 
+    
      • ALPHA_TEST - So called "magenta transparency", every pixel can be either fully transparent or opaque.
        • 
+    
      • ADDITIVE - Standard additive blending.
        • 
+    
      • SUBTRACTIVE - Subtractive blending, with brighter texture areas making everything darker behind them.
        • 
+    
      • EXCLUDE - Produces "inversion" effect.
        • 
+    
      • SCREEN - Similar to ADDITIVE, but without excessive overbright.
        • 
+    
      • LIGHTEN - Similar to SCREEN, but with a little different blending formula.
        • 
+    
      • ALPHA_BLEND - True alpha blending. Should be used for textures with gradually changing alpha values.
        • 
 
      
 
 
diff --git a/Documentation/doc/4 enums/Effects.EffectID.html b/Documentation/doc/4 enums/Effects.EffectID.html
index 32b783f43..504db707c 100644
--- a/Documentation/doc/4 enums/Effects.EffectID.html	
+++ b/Documentation/doc/4 enums/Effects.EffectID.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html
index f1351b9af..d9acddbe4 100644
--- a/Documentation/doc/4 enums/Effects.ParticleAnimationType.html	
+++ b/Documentation/doc/4 enums/Effects.ParticleAnimationType.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/4 enums/Effects.StreamerFeatherMode.html b/Documentation/doc/4 enums/Effects.StreamerFeatherMode.html
index 47692e9c5..c345a047e 100644
--- a/Documentation/doc/4 enums/Effects.StreamerFeatherMode.html	
+++ b/Documentation/doc/4 enums/Effects.StreamerFeatherMode.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/4 enums/Flow.ErrorMode.html b/Documentation/doc/4 enums/Flow.ErrorMode.html
index 4bf7d6fab..de10d20bd 100644
--- a/Documentation/doc/4 enums/Flow.ErrorMode.html	
+++ b/Documentation/doc/4 enums/Flow.ErrorMode.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
@@ -146,12 +146,12 @@
 
       The following constants are inside Flow.ErrorMode: 
      
 
 
        
-    
      • TERMINATE - print to the log file and return to the title level when any script error is hit.
-    This is the one you will want to go for if you want to know IMMEDIATELY if something has gone wrong.
        • 
-    
      • WARN - print to the log file and continue running the application when a recoverable script error is hit.
+    
      • TERMINATE - Print to the log file and return to the title level when any script error is hit.
+    This is the one you will want to go for if you want to know immediately if something has gone wrong.
        • 
+    
      • WARN - Print to the log file and continue running the application when a recoverable script error is hit.
     Choose this one if booting to the title level is too much for you.
        • 
-    
      • SILENT - do nothing when a recoverable script error is hit.
-    Think very carefully before using this setting. These error modes are here to help you to keep your scripts
+    
      • SILENT - Do nothing when a recoverable script error is hit.
+    Think very carefully before using this setting. These error modes are here to help you to keep your scripts
     working properly, but if you opt to ignore errors, you won't be alerted if you've misused a function or passed
     an invalid argument.
        • 
 
      
diff --git a/Documentation/doc/4 enums/Flow.FreezeMode.html b/Documentation/doc/4 enums/Flow.FreezeMode.html
index d01a30a1a..9b9032383 100644
--- a/Documentation/doc/4 enums/Flow.FreezeMode.html	
+++ b/Documentation/doc/4 enums/Flow.FreezeMode.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/4 enums/Flow.GameStatus.html b/Documentation/doc/4 enums/Flow.GameStatus.html
index 0e9262274..1c85193ae 100644
--- a/Documentation/doc/4 enums/Flow.GameStatus.html	
+++ b/Documentation/doc/4 enums/Flow.GameStatus.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/4 enums/Input.ActionID.html b/Documentation/doc/4 enums/Input.ActionID.html
index b0c16ee50..6e112df91 100644
--- a/Documentation/doc/4 enums/Input.ActionID.html	
+++ b/Documentation/doc/4 enums/Input.ActionID.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/4 enums/Objects.AmmoType.html b/Documentation/doc/4 enums/Objects.AmmoType.html
index cf02b25c1..114163de2 100644
--- a/Documentation/doc/4 enums/Objects.AmmoType.html	
+++ b/Documentation/doc/4 enums/Objects.AmmoType.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/4 enums/Objects.HandStatus.html b/Documentation/doc/4 enums/Objects.HandStatus.html
index 5e6f31be9..b0582d69f 100644
--- a/Documentation/doc/4 enums/Objects.HandStatus.html	
+++ b/Documentation/doc/4 enums/Objects.HandStatus.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/4 enums/Objects.MoveableStatus.html b/Documentation/doc/4 enums/Objects.MoveableStatus.html
index 21ceb56ef..87325f180 100644
--- a/Documentation/doc/4 enums/Objects.MoveableStatus.html	
+++ b/Documentation/doc/4 enums/Objects.MoveableStatus.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
@@ -147,10 +147,10 @@
 
       To be used with Objects.Moveable.GetStatus and Objects.Moveable.SetStatus functions.
      
 
 
        
-    
      • INACTIVE - moveable is inactive (was never activated).
        • 
-    
      • ACTIVE - moveable is active.
        • 
-    
      • DEACTIVATED - moveable is deactivated (was previously active and later deactivated).
        • 
-    
      • INVISIBLE - moveable is invisible.
        • 
+    
      • INACTIVE - Moveable is inactive (was never activated).
        • 
+    
      • ACTIVE - Moveable is active.
        • 
+    
      • DEACTIVATED - Moveable is deactivated (was previously active and later deactivated).
        • 
+    
      • INVISIBLE - Moveable is invisible.
        • 
 
      
 
 
diff --git a/Documentation/doc/4 enums/Objects.ObjID.html b/Documentation/doc/4 enums/Objects.ObjID.html
index 87fb56147..889c4b9a3 100644
--- a/Documentation/doc/4 enums/Objects.ObjID.html	
+++ b/Documentation/doc/4 enums/Objects.ObjID.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
@@ -883,7 +883,7 @@ INVENTORY_PASSPORT
 INVENTORY_SUNGLASSES
 INVENTORY_KEYS
 INVENTORY_HEADPHONES
-INVENTORY_POLAROID
+INVENTORY_PHOTO
 SMOKE_EMITTER_WHITE
 SMOKE_EMITTER_BLACK
 SMOKE_EMITTER
diff --git a/Documentation/doc/4 enums/Objects.RoomFlagID.html b/Documentation/doc/4 enums/Objects.RoomFlagID.html
index 3edc7b5ce..cdd7e43ea 100644
--- a/Documentation/doc/4 enums/Objects.RoomFlagID.html	
+++ b/Documentation/doc/4 enums/Objects.RoomFlagID.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
@@ -143,7 +143,8 @@
     
      
 
 
      Table of Objects.RoomFlagID constants.
-To be used with Objects.Room.SetFlag and Objects.Room.GetFlag functions.
      
+
      
+Corresponds to room flags in Tomb Editor. To be used with Objects.Room.SetFlag and Objects.Room.GetFlag functions.
      
 
 
      The following constants are inside RoomFlagID.
      
 
diff --git a/Documentation/doc/4 enums/Objects.RoomReverb.html b/Documentation/doc/4 enums/Objects.RoomReverb.html
index 420e1731c..555358c9c 100644
--- a/Documentation/doc/4 enums/Objects.RoomReverb.html	
+++ b/Documentation/doc/4 enums/Objects.RoomReverb.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
@@ -143,16 +143,16 @@
     
      
 
 
      Table of Objects.RoomReverb constants.
-To be used with Objects.Room.GetReverbType and Objects.Room.SetReverbType functions.
      
-
-
      The following constants are inside RoomReverb.
      
+
      
+Corresponds to room reverb setting set in Tomb Editor. To be used with Objects.Room.GetReverbType and Objects.Room.SetReverbType functions.
+The following constants are inside RoomReverb.
      
 
 
        
-    
      • OUTSIDE
        • 
-    
      • SMALL
        • 
-    
      • MEDIUM
        • 
-    
      • LARGE
        • 
-    
      • PIPE
        • 
+    
      • OUTSIDE
        • 
+    
      • SMALL
        • 
+    
      • MEDIUM
        • 
+    
      • LARGE
        • 
+    
      • PIPE
        • 
 
      
 
 
diff --git a/Documentation/doc/4 enums/Objects.WeaponType.html b/Documentation/doc/4 enums/Objects.WeaponType.html
index c45efc459..6b6a87ea2 100644
--- a/Documentation/doc/4 enums/Objects.WeaponType.html	
+++ b/Documentation/doc/4 enums/Objects.WeaponType.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/4 enums/Sound.SoundTrackType.html b/Documentation/doc/4 enums/Sound.SoundTrackType.html
index ad9eb5e39..1b80f2b82 100644
--- a/Documentation/doc/4 enums/Sound.SoundTrackType.html	
+++ b/Documentation/doc/4 enums/Sound.SoundTrackType.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
@@ -147,9 +147,9 @@
 
      To be used with sound track functions, such as Sound.PlayAudioTrack and Sound.StopAudioTrack.
      
 
 
        
-    
      • ONESHOT - used for one-time music tracks.
        • 
-    
      • LOOPED - used for looped ambience or music.
        • 
-    
      • VOICE - used for dialogs. Also supports subtitles, set by Sound.GetCurrentSubtitle function.
        • 
+    
      • ONESHOT - Used for one-time music tracks.
        • 
+    
      • LOOPED - Used for looped ambience or music.
        • 
+    
      • VOICE - Used for dialogs. Also supports subtitles, set by Sound.GetCurrentSubtitle function.
        • 
 
      
 
 
diff --git a/Documentation/doc/4 enums/Strings.DisplayStringOption.html b/Documentation/doc/4 enums/Strings.DisplayStringOption.html
index e43f3200b..32a0f566d 100644
--- a/Documentation/doc/4 enums/Strings.DisplayStringOption.html	
+++ b/Documentation/doc/4 enums/Strings.DisplayStringOption.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
@@ -145,10 +145,10 @@
 
      Strings.DisplayStringOption constants.  To be used with Strings.DisplayString class.
      
 
 
        
-    
      • CENTER - set the horizontal origin point to the center of the string.
        • 
-    
      • RIGHT - set the horizontal origin point to right of the string.
        • 
-    
      • SHADOW - gives the string a small drop shadow.
        • 
-    
      • BLINK - blinks the string
        • 
+    
      • CENTER - Set the horizontal origin point to the center of the string.
        • 
+    
      • RIGHT - Set the horizontal origin point to right of the string.
        • 
+    
      • SHADOW - Gives the string a small drop shadow.
        • 
+    
      • BLINK - Blinks the string.
        • 
 
      
 
 
diff --git a/Documentation/doc/4 enums/Util.LogLevel.html b/Documentation/doc/4 enums/Util.LogLevel.html
index 3e463cf45..db5b3d0c1 100644
--- a/Documentation/doc/4 enums/Util.LogLevel.html	
+++ b/Documentation/doc/4 enums/Util.LogLevel.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/4 enums/View.AlignMode.html b/Documentation/doc/4 enums/View.AlignMode.html
index 479a64e04..90ce2b553 100644
--- a/Documentation/doc/4 enums/View.AlignMode.html	
+++ b/Documentation/doc/4 enums/View.AlignMode.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/4 enums/View.CameraType.html b/Documentation/doc/4 enums/View.CameraType.html
index 8059b3c65..cd0848ceb 100644
--- a/Documentation/doc/4 enums/View.CameraType.html	
+++ b/Documentation/doc/4 enums/View.CameraType.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
@@ -145,13 +145,13 @@
 
      Table of View.CameraType constants.  To be used with View.GetCameraType function.
      
 
 
        
-    
      • NORMAL - standard in-game camera when weapons are holstered.
        • 
-    
      • COMBAT - in-game camera when weapons are unholstered.
        • 
-    
      • FIXED - classic fixed camera.
        • 
-    
      • LOOK - look camera.
        • 
-    
      • FLYBY - flyby or tracking camera.
        • 
-    
      • BINOCULARS - binoculars is active.
        • 
-    
      • LASERSIGHT - lasersight is active.
        • 
+    
      • NORMAL - Standard in-game camera when weapons are holstered.
        • 
+    
      • COMBAT - In-game camera when weapons are unholstered.
        • 
+    
      • FIXED - Classic fixed camera.
        • 
+    
      • LOOK - Look camera.
        • 
+    
      • FLYBY - Flyby or tracking camera.
        • 
+    
      • BINOCULARS - Binocular camera.
        • 
+    
      • LASERSIGHT - Lasersight camera.
        • 
 
      
 
 
diff --git a/Documentation/doc/4 enums/View.PostProcessMode.html b/Documentation/doc/4 enums/View.PostProcessMode.html
index 03b0419d6..0036ba5c3 100644
--- a/Documentation/doc/4 enums/View.PostProcessMode.html	
+++ b/Documentation/doc/4 enums/View.PostProcessMode.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/4 enums/View.ScaleMode.html b/Documentation/doc/4 enums/View.ScaleMode.html
index d00970ef0..445c35879 100644
--- a/Documentation/doc/4 enums/View.ScaleMode.html	
+++ b/Documentation/doc/4 enums/View.ScaleMode.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
@@ -145,9 +145,9 @@
 
      Table of View.ScaleMode constants.  To be used with View.DisplaySprite class.
      
 
 
        
-    
      • FIT
        • 
-    
      • FILL
        • 
-    
      • STRETCH
+    
      • FIT - Image will proportionally fit the whole image into the sprite surface.
        • 
+    
      • FILL - Image will scale up proportionally and crop to fill all sprite surface.
        • 
+    
      • STRETCH - Image will stretch according to sprite dimensions, not taking aspect ratio into consideration.
     
        • 
 
      
 
diff --git a/Documentation/doc/5 lua utility modules/CustomBar.html b/Documentation/doc/5 lua utility modules/CustomBar.html
index 2940474c8..b0f3fe3be 100644
--- a/Documentation/doc/5 lua utility modules/CustomBar.html	
+++ b/Documentation/doc/5 lua utility modules/CustomBar.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/5 lua utility modules/Diary.html b/Documentation/doc/5 lua utility modules/Diary.html
index 58d81a722..ee01685e7 100644
--- a/Documentation/doc/5 lua utility modules/Diary.html	
+++ b/Documentation/doc/5 lua utility modules/Diary.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
@@ -294,7 +294,7 @@
         
         
    • pos
             Vec2
-         X,Y position of the bar's background in screen percent (0-100).
+         X,Y position of the diary background sprite in screen percent (0-100).
         
      • 
         
    • rot
             float
@@ -302,7 +302,7 @@
         
      • 
         
    • scale
             Vec2
-         X,Y Scaling factor for the bar's background sprite.
+         X,Y Scaling factor for the diary background sprite.
         
      • 
         
    • alignMode
             AlignMode
diff --git a/Documentation/doc/5 lua utility modules/EventSequence.html b/Documentation/doc/5 lua utility modules/EventSequence.html
index e0557249c..906d9ee53 100644
--- a/Documentation/doc/5 lua utility modules/EventSequence.html	
+++ b/Documentation/doc/5 lua utility modules/EventSequence.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/5 lua utility modules/Timer.html b/Documentation/doc/5 lua utility modules/Timer.html
index 2bdecfa5e..557367fd8 100644
--- a/Documentation/doc/5 lua utility modules/Timer.html	
+++ b/Documentation/doc/5 lua utility modules/Timer.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/5 lua utility modules/Type.html b/Documentation/doc/5 lua utility modules/Type.html
index dad15e9ec..8c8ce46a0 100644
--- a/Documentation/doc/5 lua utility modules/Type.html	
+++ b/Documentation/doc/5 lua utility modules/Type.html	
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
diff --git a/Documentation/doc/index.html b/Documentation/doc/index.html
index 780a8b9e5..0d8c40599 100644
--- a/Documentation/doc/index.html
+++ b/Documentation/doc/index.html
@@ -3,7 +3,7 @@
 
 
 
-    TombEngine 1.8.1 Lua API
+    TombEngine 1.8.2 Lua API
     
 
 
@@ -115,7 +115,7 @@
 
      
 
 
-  
      TombEngine 1.8.1 scripting interface
      
+  
      TombEngine 1.8.2 scripting interface
      
   
      Welcome to the TombEngine scripting API.
      
 
 
      Note that this is primarily a reference document, not a tutorial, so expect descriptions to be fairly sparse.
@@ -208,7 +208,7 @@ local door = GetMoveableByName("door_type4_14")
 	
 	
 		Objects.LaraObject
-		Class for extra player-only functions.
+		Class for player-only functions.
 	
 	
 		Objects.Moveable
diff --git a/TombEngine/Scripting/Internal/TEN/Collision/MaterialTypes.h b/TombEngine/Scripting/Internal/TEN/Collision/MaterialTypes.h
index 5d9f078f9..a23f2d348 100644
--- a/TombEngine/Scripting/Internal/TEN/Collision/MaterialTypes.h
+++ b/TombEngine/Scripting/Internal/TEN/Collision/MaterialTypes.h
@@ -6,7 +6,10 @@
 // @enum Collision.MaterialType
 // @pragma nostrip
 
-/// Table of MaterialType constants. To be used with @{Collision.Probe.GetFloorMaterialType} and @{Collision.Probe.GetCeilingMaterialType}.
+/// Table of MaterialType constants.
+// 
      
+// Corresponds to Tomb Editor texture sound material types.
+// To be used with @{Collision.Probe.GetFloorMaterialType} and @{Collision.Probe.GetCeilingMaterialType}.
 //
 // - `MUD`
 // - `SNOW`
diff --git a/TombEngine/Scripting/Internal/TEN/Effects/BlendIDs.h b/TombEngine/Scripting/Internal/TEN/Effects/BlendIDs.h
index a68d656b9..744efb496 100644
--- a/TombEngine/Scripting/Internal/TEN/Effects/BlendIDs.h
+++ b/TombEngine/Scripting/Internal/TEN/Effects/BlendIDs.h
@@ -9,16 +9,18 @@ namespace TEN::Scripting::Effects
 	// @pragma nostrip
 
 	/// Table of Effects.BlendID constants.
+	// 
      
+	// All blending modes except `OPAQUE`, `ADDITIVE` and `ALPHA_BLEND` will use depth sorting for applicable polygons.
+	// This may reduce engine performance, so it is preferable to minimize usage of other blending modes.
 	//
-	// - `OPAQUE`
-	// - `ALPHA_TEST`
-	// - `ADDITIVE`
-	// - `NO_DEPTH_TEST`
-	// - `SUBTRACTIVE`
-	// - `EXCLUDE`
-	// - `SCREEN`
-	// - `LIGHTEN`
-	// - `ALPHA_BLEND`
+	// - `OPAQUE` - No transparency.
+	// - `ALPHA_TEST` - So called "magenta transparency", every pixel can be either fully transparent or opaque.
+	// - `ADDITIVE` - Standard additive blending.
+	// - `SUBTRACTIVE` - Subtractive blending, with brighter texture areas making everything darker behind them.
+	// - `EXCLUDE` - Produces "inversion" effect.
+	// - `SCREEN` - Similar to `ADDITIVE`, but without excessive overbright.
+	// - `LIGHTEN` - Similar to `SCREEN`, but with a little different blending formula.
+	// - `ALPHA_BLEND` - True alpha blending. Should be used for textures with gradually changing alpha values.
 	//
 	// @table Effects.BlendID
 
diff --git a/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp b/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp
index ba5dc17e9..6463e6e3f 100644
--- a/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Effects/EffectsFunctions.cpp
@@ -46,19 +46,19 @@ using namespace TEN::Effects::Streamer;
 using namespace TEN::Math;
 using namespace TEN::Scripting::Types;
 
-namespace TEN::Scripting::Effects
+namespace TEN::Scripting::Effects 
 {
-	/// Emit a lightning arc.
+	/// Emit a lightning arc.  
 	// @function EmitLightningArc
 	// @tparam Vec3 origin
 	// @tparam Vec3 target
-	// @tparam Color color (default Color(255, 255, 255))
-	// @tparam float life Lifetime in seconds. Clamped to [0, 4.233] for now because of strange internal maths. __default: 1__
-	// @tparam int amplitude "strength" of the lightning - the higher the value, the "taller" the arcs. Clamped to [1, 255]. __default: 20__
-	// @tparam int beamWidth Clamped to [1, 127]. __default 2__
-	// @tparam int detail Higher numbers equal more segments, but it's not a 1:1 correlation. Clamped to [1, 127]. __default: 10__
-	// @tparam bool smooth If true, the arc will have large, smooth curves; if false, it will have small, jagged spikes. __default: false__
-	// @tparam bool endDrift If true, the end of the arc will be able to gradually drift away from its destination in a random direction __default: false__
+	// @tparam[opt=Color(255, 255, 255)] Color color.
+	// @tparam[opt=1] float life Lifetime in seconds. Clamped to [0, 4.233] for now because of strange internal maths.
+	// @tparam[opt=20] int amplitude Strength of the lightning - the higher the value, the "taller" the arcs. Clamped to [1, 255].
+	// @tparam[opt=2] int beamWidth Beam width. Clamped to [1, 127].
+	// @tparam[opt=10] int detail Higher numbers equal more segments, but it's not a 1:1 correlation. Clamped to [1, 127].
+	// @tparam[opt=false] bool smooth If true, the arc will have large, smooth curves; if false, it will have small, jagged spikes.
+	// @tparam[opt=false] bool endDrift If true, the end of the arc will be able to gradually drift away from its destination in a random direction.
 	static void EmitLightningArc(const Vec3& origin, const Vec3& target, TypeOrNil color, TypeOrNil life, TypeOrNil amplitude,
 								 TypeOrNil beamWidth, TypeOrNil segments, TypeOrNil smooth, TypeOrNil endDrift)
 	{
@@ -113,18 +113,18 @@ namespace TEN::Scripting::Effects
 	// @tparam Vec3 pos World position.
 	// @tparam Vec3 vel Directional velocity.
 	// @tparam int spriteID Sprite ID in the sprite sequence slot.
-	// @tparam float gravity Effect of gravity. Positive value ascends, negative value descends. __default: 0__
-	// @tparam float rotVel Rotational velocity in degrees. __default: 0__
-	// @tparam Color startColor Color at start of life. __default: Color(255, 255, 255)__
-	// @tparam Color endColor Color at end of life. This will finish long before the end of the particle's life due to internal math. __default: Color(255, 255, 255)__
-	// @tparam Effects.BlendID blendMode Render blend mode. __TEN.Effects.BlendID.ALPHA_BLEND__
-	// @tparam float startSize Size at start of life. __default: 10__
-	// @tparam float endSize Size at end of life. __default: 0__
-	// @tparam float life Lifespan in seconds. __default: 2__
-	// @tparam bool damage Harm the player on collision. __default: false__
-	// @tparam bool poison Poison the player on collision. __default: false__
-	// @tparam Objects.ObjID.SpriteConstants spriteSeqID Sprite sequence slot ID. __default: Objects.ObjID.DEFAULT_SPRITES__
-	// @tparam float startRot Rotation at start of life. __default: random__
+	// @tparam[opt=0] float gravity Effect of gravity. Positive value ascends, negative value descends.
+	// @tparam[opt=0] float rotVel Rotational velocity in degrees.
+	// @tparam[opt=Color(255, 255, 255)] Color startColor Color at start of life.
+	// @tparam[opt=Color(255, 255, 255)] Color endColor Color at end of life. This will finish long before the end of the particle's life due to internal math.
+	// @tparam[opt=TEN.Effects.BlendID.ALPHA_BLEND] Effects.BlendID blendMode Render blend mode.
+	// @tparam[opt=10] float startSize Size at start of life. 
+	// @tparam[opt=0] float endSize Size at end of life.
+	// @tparam[opt=2] float life Lifespan in seconds.
+	// @tparam[opt=false] bool damage Harm the player on collision.
+	// @tparam[opt=false] bool poison Poison the player on collision.
+	// @tparam[opt=Objects.ObjID.DEFAULT_SPRITES] Objects.ObjID.SpriteConstants spriteSeqID Sprite sequence slot ID.
+	// @tparam[opt=random] float startRot Rotation at start of life.
 	// @usage
 	// EmitParticle(
 	//     pos,
@@ -223,7 +223,7 @@ namespace TEN::Scripting::Effects
 
 	/// Emit a particle with extensive configuration options, including sprite sequence animation, lights, sounds, and damage effects.
 	// @function EmitAdvancedParticle
-	// @tparam ParticleData ParticleData Table containing particle data.
+	// @tparam ParticleData particleData Table containing particle data.
 	// @usage
 	// local particle =
 	// {
@@ -261,31 +261,31 @@ namespace TEN::Scripting::Effects
 	// @table ParticleData
 	// @tfield Vec3 pos World position.
 	// @tfield Vec3 vel Directional velocity in world units per second.
-	// @tfield[opt] Objects.ObjID.SpriteConstants spriteSeqID Sprite sequence slot ID. __default: Objects.ObjID.DEFAULT_SPRITES__
-	// @tfield[opt] int spriteID Sprite ID in the sprite sequence slot. __default: 0__
-	// @tfield[opt] float life Lifespan in seconds. __default: 2__
-	// @tfield[opt] float maxYVel Maximum vertical velocity in world units per second. __default: 0__
-	// @tfield[opt] float gravity Effect of gravity in world units per second. Positive value ascend, negative value descend. __default: 0__
-	// @tfield[opt] float friction Friction affecting velocity over time in world units per second. __default: 0__
-	// @tfield[opt] float startRot Rotation at start of life. __default: random__
-	// @tfield[opt] float rotVel Rotational velocity in degrees per second. __default: 0__
-	// @tfield[opt] float startSize Size at start of life. __default: 10__
-	// @tfield[opt] float endSize Size at end of life. __default: 0__
-	// @tfield[opt] Color startColor Color at start of life. __default: Color(255, 255, 255)__
-	// @tfield[opt] Color endColor Color at end of life. Note that this will finish long before the end of life due to internal math. __default: Color(255, 255, 255)__
-	// @tfield[opt] Effects.BlendID blendMode Render blend mode. __default: TEN.Effects.BlendID.ALPHA_BLEND__
-	// @tfield[opt] bool damage Harm the player on collision. __default: false__
-	// @tfield[opt] bool poison Poison the player on collision. __default: false__
-	// @tfield[opt] bool burn Burn the player on collision. __default: false__
-	// @tfield[opt] bool wind Affect position by wind in outside rooms. __default: false__
-	// @tfield[opt] int damageHit Player damage amount on collision. __default: 2__
-	// @tfield[opt] bool light Emit a colored light. CAUTION: Recommended only for a single particle. Too many particles with lights can overwhelm the lighting system. __default: false__
-	// @tfield[opt] int lightRadius Light radius in 1/4 blocks. __default: 0__
-	// @tfield[opt] int lightFlicker Interval at which the light should flicker. __default: 0__
-	// @tfield[opt] int soundID Sound ID to play. CAUTION: Recommended only for a single particle. Too many particles with sounds can overwhelm the sound system. __default: none__
-	// @tfield[opt] bool animated Play animates sprite sequence. __default: false__
-	// @tfield[opt] Effects.ParticleAnimationType animType Animation type of the sprite sequence. __default: TEN.Effects.ParticleAnimationType.LOOP__
-	// @tfield[opt] float frameRate Sprite sequence animation framerate. __default: 1__
+	// @tfield[opt=Objects.ObjID.DEFAULT_SPRITES] Objects.ObjID.SpriteConstants spriteSeqID Sprite sequence slot ID.
+	// @tfield[opt=0] int spriteID Sprite ID in the sprite sequence slot.
+	// @tfield[opt=2] float life Lifespan in seconds.
+	// @tfield[opt=0] float maxYVel Maximum vertical velocity in world units per second.
+	// @tfield[opt=0] float gravity Effect of gravity in world units per second. Positive value ascend, negative value descend.
+	// @tfield[opt=0] float friction Friction affecting velocity over time in world units per second.
+	// @tfield[opt=random] float startRot Rotation at start of life.
+	// @tfield[opt=0] float rotVel Rotational velocity in degrees per second.
+	// @tfield[opt=10] float startSize Size at start of life.
+	// @tfield[opt=0] float endSize Size at end of life.
+	// @tfield[opt=Color(255, 255, 255)] Color startColor Color at start of life.
+	// @tfield[opt=Color(255, 255, 255)] Color endColor Color at end of life. Note that this will finish long before the end of life due to internal math.
+	// @tfield[opt=TEN.Effects.BlendID.ALPHA_BLEND] Effects.BlendID blendMode Render blend mode.
+	// @tfield[opt=false] bool damage Harm the player on collision.
+	// @tfield[opt=false] bool poison Poison the player on collision.
+	// @tfield[opt=false] bool burn Burn the player on collision.
+	// @tfield[opt=false] bool wind Affect position by wind in outside rooms.
+	// @tfield[opt=2] int damageHit Player damage amount on collision.
+	// @tfield[opt=false] bool light Emit a colored light. __Caution__: Recommended only for a single particle. Too many particles with lights can overwhelm the lighting system.
+	// @tfield[opt=0] int lightRadius Light radius in 1/4 blocks.
+	// @tfield[opt=0] int lightFlicker Interval at which the light should flicker.
+	// @tfield[opt] int soundID Sound ID to play. __Caution__: Recommended only for a single particle. Too many particles with sounds can overwhelm the sound system.
+	// @tfield[opt=false] bool animated Play animates sprite sequence.
+	// @tfield[opt=TEN.Effects.ParticleAnimationType.LOOP] Effects.ParticleAnimationType animType Animation type of the sprite sequence.
+	// @tfield[opt=1] float frameRate Sprite sequence animation framerate.
 	static void EmitAdvancedParticle(const sol::table& table)
 	{
 		constexpr auto DEFAULT_START_SIZE = 10.0f;
@@ -402,14 +402,14 @@ namespace TEN::Scripting::Effects
 	
 	/// Emit a shockwave, similar to that seen when a harpy projectile hits something.
 	// @function EmitShockwave
-	// @tparam Vec3 pos Origin position
-	// @tparam int innerRadius (default 0) Initial inner radius of the shockwave circle - 128 will be approx a click, 512 approx a block
-	// @tparam int outerRadius (default 128) Initial outer radius of the shockwave circle
-	// @tparam Color color (default Color(255, 255, 255))
-	// @tparam float lifetime (default 1.0) Lifetime in seconds (max 8.5 because of inner maths weirdness)
-	// @tparam int speed (default 50) Initial speed of the shockwave's expansion (the shockwave will always slow as it goes)
-	// @tparam int angle (default 0) Angle about the X axis - a value of 90 will cause the shockwave to be entirely vertical
-	// @tparam bool hurtsLara (default false) If true, the shockwave will hurt Lara, with the damage being relative to the shockwave's current speed
+	// @tparam Vec3 pos Origin Position.
+	// @tparam[opt=0] int innerRadius Initial inner radius of the shockwave circle - 128 will be approx a click, 512 approx a block.
+	// @tparam[opt=128] int outerRadius Initial outer radius of the shockwave circle.
+	// @tparam[opt=Color(255, 255, 255)] Color color Color.
+	// @tparam[opt=1.0] float lifetime Lifetime in seconds (max 8.5 because of inner maths weirdness).
+	// @tparam[opt=50] int speed Initial speed of the shockwave's expansion (the shockwave will always slow as it goes).
+	// @tparam[opt=0] int angle Angle about the X axis - a value of 90 will cause the shockwave to be entirely vertical.
+	// @tparam[opt=false] bool hurtsLara If true, the shockwave will hurt Lara, with the damage being relative to the shockwave's current speed.
 	static void EmitShockwave(Vec3 pos, TypeOrNil innerRadius, TypeOrNil outerRadius, TypeOrNil col,
 							  TypeOrNil lifetime, TypeOrNil speed, TypeOrNil angle, TypeOrNil hurtPlayer)
 	{
@@ -444,10 +444,10 @@ namespace TEN::Scripting::Effects
 	// If you want a light that sticks around, you must call this each frame.
 	// @function EmitLight
 	// @tparam Vec3 pos position of the light
-	// @tparam[opt] Color color light color (default Color(255, 255, 255))
-	// @tparam[opt] int radius measured in "clicks" or 256 world units (default 20)
-	// @tparam[opt] bool shadows determines whether light should generate dynamic shadows for applicable moveables (default is false)
-	// @tparam[opt] string name if provided, engine will interpolate this light for high framerate mode (be careful not to use same name for different lights)
+	// @tparam[opt=Color(255, 255, 255)] Color color light color.
+	// @tparam[opt=20] int radius Measured in "clicks" or 256 world units.
+	// @tparam[opt=false] bool shadows Determines whether light should generate dynamic shadows for applicable moveables.
+	// @tparam[opt] string name If provided, engine will interpolate this light for high framerate mode (be careful not to use same name for different lights).
 	static void EmitLight(Vec3 pos, TypeOrNil col, TypeOrNil radius, TypeOrNil castShadows, TypeOrNil name)
 	{
 		auto color = ValueOr(col, ScriptColor(255, 255, 255));
@@ -460,12 +460,12 @@ namespace TEN::Scripting::Effects
 	// @function EmitSpotLight
 	// @tparam Vec3 pos position of the light
 	// @tparam Vec3 dir normal which indicates light direction
-	// @tparam[opt] Color color (default Color(255, 255, 255))
-	// @tparam[opt] int radius overall radius at the endpoint of a light cone, measured in "clicks" or 256 world units (default 10)
-	// @tparam[opt] int falloff radius, at which light starts to fade out, measured in "clicks" (default 5)
-	// @tparam[opt] int distance distance, at which light cone fades out, measured in "clicks" (default 20)
-	// @tparam[opt] bool shadows determines whether light should generate dynamic shadows for applicable moveables (default is false)
-	// @tparam[opt] string name if provided, engine will interpolate this light for high framerate mode (be careful not to use same name for different lights)
+	// @tparam[opt=Color(255, 255, 255)] Color color Color.
+	// @tparam[opt=10] int radius Overall radius at the endpoint of a light cone, measured in "clicks" or 256 world units.
+	// @tparam[opt=5] int falloff Radius, at which light starts to fade out, measured in "clicks".
+	// @tparam[opt=20] int distance Distance, at which light cone fades out, measured in "clicks".
+	// @tparam[opt=false] bool shadows Determines whether light should generate dynamic shadows for applicable moveables.
+	// @tparam[opt] string name If provided, engine will interpolate this light for high framerate mode (be careful not to use same name for different lights).
 	static void EmitSpotLight(Vec3 pos, Vec3 dir, TypeOrNil col, TypeOrNil radius, TypeOrNil falloff, TypeOrNil distance, TypeOrNil castShadows, TypeOrNil name)
 	{
 		auto color = ValueOr(col, ScriptColor(255, 255, 255));
@@ -478,7 +478,7 @@ namespace TEN::Scripting::Effects
 	/// Emit blood.
 	// @function EmitBlood
 	// @tparam Vec3 pos
-	// @tparam int count Sprite count. __default: 1__
+	// @tparam[opt=1] int count Sprite count.
 	static void EmitBlood(const Vec3& pos, TypeOrNil count)
 	{
 		TriggerBlood(pos.x, pos.y, pos.z, -1, ValueOr(count, 1));
@@ -487,8 +487,8 @@ namespace TEN::Scripting::Effects
 	/// Emit an air bubble in a water room.
 	// @function EmitAirBubble
 	// @tparam Vec3 pos World position where the effect will be spawned. Must be in a water room.
-	// @tparam[opt] float size Sprite size. __Default: 32__
-	// @tparam[opt] float amp Oscillation amplitude. __Default: 32__
+	// @tparam[opt=32] float size Sprite size.
+	// @tparam[opt=32] float amp Oscillation amplitude.
 	static void EmitAirBubble(const Vec3& pos, TypeOrNil size, TypeOrNil amp)
 	{
 		constexpr auto DEFAULT_SIZE = 128.0f;
@@ -502,8 +502,8 @@ namespace TEN::Scripting::Effects
 
 	/// Emit fire for one frame. Will not hurt player. Call this each frame if you want a continuous fire.
 	// @function EmitFire
-	// @tparam Vec3 pos
-	// @tparam float size Fire size. __default: 1__
+	// @tparam Vec3 pos Position.
+	// @tparam[opt=1] float size Fire size.
 	static void EmitFire(const Vec3& pos, TypeOrNil size)
 	{
 		AddFire(pos.x, pos.y, pos.z, FindRoomNumber(pos.ToVector3i()), ValueOr(size, 1));
@@ -512,8 +512,8 @@ namespace TEN::Scripting::Effects
 	/// Make an explosion. Does not hurt Lara
 	// @function MakeExplosion 
 	// @tparam Vec3 pos
-	// @tparam float size (default 512.0) this will not be the size of the sprites, but rather the distance between the origin and any additional sprites
-	// @tparam bool shockwave (default false) if true, create a very faint white shockwave which will not hurt Lara
+	// @tparam[opt=512] float size This will not be the size of the sprites, but rather the distance between the origin and any additional sprites.
+	// @tparam[opt=false] bool shockwave If true, create a very faint white shockwave which will not hurt Lara.
 	static void MakeExplosion(Vec3 pos, TypeOrNil size, TypeOrNil shockwave)
 	{
 		TriggerExplosion(Vector3(pos.x, pos.y, pos.z), ValueOr(size, 512.0f), true, false, ValueOr(shockwave, false), FindRoomNumber(Vector3i(pos.x, pos.y, pos.z)));
@@ -521,7 +521,7 @@ namespace TEN::Scripting::Effects
 
 	/// Make an earthquake
 	// @function MakeEarthquake 
-	// @tparam int strength (default 100) How strong should the earthquake be? Increasing this value also increases the lifespan of the earthquake.
+	// @tparam[opt=100] int strength How strong should the earthquake be? Increasing this value also increases the lifespan of the earthquake.
 	static void Earthquake(TypeOrNil strength)
 	{
 		int str = ValueOr(strength, 100);
@@ -540,20 +540,20 @@ namespace TEN::Scripting::Effects
 	/// Emit an extending streamer effect.
 	// @function EmitStreamer
 	// @tparam Moveable mov Moveable object with which to associate the effect.
-	// @tparam int[opt] tag Numeric tag with which to associate the effect on the moveable. __Default: 0__
+	// @tparam int tag Numeric tag with which to associate the effect on the moveable.
 	// @tparam Vec3 pos World position.
 	// @tparam Vec3 dir Direction vector of movement velocity.
-	// @tparam[opt] float rot Start rotation in degrees. __Default: 0__
-	// @tparam[opt] Color startColor Color at the start of life. __Default: Color(255, 255, 255, 255))__
-	// @tparam[opt] Color endColor Color at the end of life. __Default: Color(0, 0, 0, 0))__
-	// @tparam[opt] float width Width in world units. __Default: 0__
-	// @tparam[opt] float life Lifetime in seconds. __Default: 1__
-	// @tparam[opt] float vel Movement velocity in world units per second. __Default: 0__
-	// @tparam[opt] float expRate Width expansion rate in world units per second. __Default: 0__
-	// @tparam[opt] float rotRate Rotation rate in degrees per second. __Default: 0__
-	// @tparam[opt] Effects.StreamerFeatherMode edgeFeatherMode Edge feather mode. __Default: Effects.StreamerFeatherMode.NONE__
-	// @tparam[opt] Effects.StreamerFeatherMode lengthFeatherMode Length feather mode. __UNIMPLEMENTED, currently will always leave a fading tail__
-	// @tparam[opt] Effects.BlendID blendID Renderer blend ID. __Default: Effects.BlendID.ALPHA_BLEND__
+	// @tparam[opt=0] float rot Start rotation in degrees.
+	// @tparam[opt=Color(255, 255, 255)] Color startColor Color at the start of life.
+	// @tparam[opt=Color(0, 0, 0)] Color endColor Color at the end of life.
+	// @tparam[opt=0] float width Width in world units.
+	// @tparam[opt=1] float life Lifetime in seconds.
+	// @tparam[opt=0] float vel Movement velocity in world units per second.
+	// @tparam[opt=0] float expRate Width expansion rate in world units per second.
+	// @tparam[opt=0] float rotRate Rotation rate in degrees per second.
+	// @tparam[opt=Effects.StreamerFeatherMode.NONE] Effects.StreamerFeatherMode edgeFeatherMode Edge feather mode.
+	// @tparam[opt=Effects.StreamerFeatherMode.LEFT] Effects.StreamerFeatherMode lengthFeatherMode Length feather mode. _Not yet implemented._
+	// @tparam[opt=Effects.BlendID.ALPHA_BLEND] Effects.BlendID blendID Renderer blend ID.
 	static void EmitStreamer(const Moveable& mov, TypeOrNil tag, const Vec3& pos, const Vec3& dir, TypeOrNil rot, TypeOrNil startColor, TypeOrNil endColor,
 							 TypeOrNil width, TypeOrNil life, TypeOrNil vel, TypeOrNil expRate, TypeOrNil rotRate,
 							 TypeOrNil edgeFeatherMode, TypeOrNil lengthFeatherMode, TypeOrNil blendID)
diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Enums/ErrorModes.h b/TombEngine/Scripting/Internal/TEN/Flow/Enums/ErrorModes.h
index e30361d5a..afb16ba0a 100644
--- a/TombEngine/Scripting/Internal/TEN/Flow/Enums/ErrorModes.h
+++ b/TombEngine/Scripting/Internal/TEN/Flow/Enums/ErrorModes.h
@@ -14,14 +14,14 @@ namespace TEN::Scripting
 	//
 	// The following constants are inside Flow.ErrorMode: 
      
 	// 
-	// - `TERMINATE` - print to the log file and return to the title level when any script error is hit.
-	// This is the one you will want to go for if you want to know IMMEDIATELY if something has gone wrong.
+	// - `TERMINATE` - Print to the log file and return to the title level when any script error is hit.
+	// This is the one you will want to go for if you want to know _immediately_ if something has gone wrong.
 	// 
-	// - `WARN` - print to the log file and continue running the application when a recoverable script error is hit.
+	// - `WARN` - Print to the log file and continue running the application when a recoverable script error is hit.
 	// Choose this one if booting to the title level is too much for you.
 	// 
-	// - `SILENT` - do nothing when a recoverable script error is hit.
-	// Think __very__ carefully before using this setting. These error modes are here to help you to keep your scripts
+	// - `SILENT` - Do nothing when a recoverable script error is hit.
+	// Think _very_ carefully before using this setting. These error modes are here to help you to keep your scripts
 	// working properly, but if you opt to ignore errors, you won't be alerted if you've misused a function or passed
 	// an invalid argument.
 	// 
diff --git a/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.cpp b/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.cpp
index d1afb5737..bbdc1a579 100644
--- a/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Flow/FlowHandler.cpp
@@ -56,54 +56,50 @@ ambient tracks.
 /***
 Add a level to the Flow.
 @function AddLevel
-@tparam Flow.Level level a level object
+@tparam Flow.Level level A level object.
 */
 	tableFlow.set_function(ScriptReserved_AddLevel, &FlowHandler::AddLevel, this);
 
-/*** Image to show when loading the game.
-Must be a .jpg or .png image.
+/*** Image to show when loading the game. Must be a .jpg or .png image.
 @function SetIntroImagePath
-@tparam string path the path to the image, relative to the TombEngine exe
+@tparam string path The path to the image, relative to the TombEngine executable.
 */
 	tableFlow.set_function(ScriptReserved_SetIntroImagePath, &FlowHandler::SetIntroImagePath, this);
 
-/*** Video to show when loading the game.
-Must be a common video format, such as .mp4, .mkv or .avi.
+/*** Video to show when loading the game. Must be a common video format, such as mp4, mkv, mov or avi.
 @function SetIntroVideoPath
 @tparam string path the path to the video, relative to the TombEngine exe
 */
 	tableFlow.set_function(ScriptReserved_SetIntroVideoPath, &FlowHandler::SetIntroVideoPath, this);
 
-/*** Image to show in the background of the title screen.
-Must be a .jpg or .png image.
-__(not yet implemented)__
+/*** Image to show in the background of the title screen. Must be a .jpg or .png image. _Not yet implemented._
 @function SetTitleScreenImagePath
-@tparam string path the path to the image, relative to the TombEngine exe
+@tparam string path The path to the image, relative to the TombEngine executable.
 */
 	tableFlow.set_function(ScriptReserved_SetTitleScreenImagePath, &FlowHandler::SetTitleScreenImagePath, this);
 
 /*** Enable or disable Lara drawing in title flyby.
 Must be true or false
 @function EnableLaraInTitle
-@tparam bool enabled true or false
+@tparam bool enabled True or false.
 */
 	tableFlow.set_function(ScriptReserved_EnableLaraInTitle, &FlowHandler::EnableLaraInTitle, this);
 
 /*** Enable or disable level selection in title flyby.
 Must be true or false
 @function EnableLevelSelect
-@tparam bool enabled true or false
+@tparam bool enabled True or false.
 */
 	tableFlow.set_function(ScriptReserved_EnableLevelSelect, &FlowHandler::EnableLevelSelect, this);
 
 /*** Enable or disable Home Level entry in the main menu.
-@function EnableHomeLevel()
+@function EnableHomeLevel
 @tparam bool enabled True or false.
 */
 	tableFlow.set_function(ScriptReserved_EnableHomeLevel, &FlowHandler::EnableHomeLevel, this);
 
 /*** Enable or disable saving and loading of savegames.
-@function EnableLoadSave()
+@function EnableLoadSave
 @tparam bool enabled True or false.
 */
 	tableFlow.set_function(ScriptReserved_EnableLoadSave, &FlowHandler::EnableLoadSave, this);
@@ -113,7 +109,7 @@ Must be true or false
 */
 
 /*** Enable or disable the fly cheat.
-@function EnableFlyCheat()
+@function EnableFlyCheat
 @tparam bool enabled True or false.
 */
 	tableFlow.set_function(ScriptReserved_EnableFlyCheat, &FlowHandler::EnableFlyCheat, this);
@@ -121,29 +117,29 @@ Must be true or false
 /*** Enable or disable point texture filter.
 Must be true or false
 @function EnablePointFilter
-@tparam bool enabled true or false
+@tparam bool enabled True or false.
 */
 	tableFlow.set_function(ScriptReserved_EnablePointFilter, &FlowHandler::EnablePointFilter, this);
 
 /*** Enable or disable mass pickup.
 Must be true or false
 @function EnableMassPickup
-@tparam bool enabled true or false
+@tparam bool enabled True or false.
 */
 	tableFlow.set_function(ScriptReserved_EnableMassPickup, &FlowHandler::EnableMassPickup, this);
 
 /*** Returns the level by index.
 Indices depend on the order in which AddLevel was called; the first added will
-have an ID of 0, the second an ID of 1, and so on.
+have an index of 0, the second an index of 1, and so on.
 @function GetLevel
-@tparam int index of the level
-@treturn Flow.Level the level indicated by the id
+@tparam int index Index of the level.
+@treturn Flow.Level The level indicated by the index.
 */
 	tableFlow.set_function(ScriptReserved_GetLevel, &FlowHandler::GetLevel, this);
 
 /*** Returns the level that the game control is running in that moment.
 @function GetCurrentLevel
-@treturn Flow.Level the current level
+@treturn Flow.Level The current level.
 */
 	tableFlow.set_function(ScriptReserved_GetCurrentLevel, &FlowHandler::GetCurrentLevel, this);
 
@@ -152,38 +148,38 @@ If level index is not provided or is zero, jumps to next level. If level index i
 level count, jumps to title. If LARA\_START\_POS objects are present in level, player will be
 teleported to such object with OCB similar to provided second argument.
 @function EndLevel
-@int[opt] index level index (default 0)
-@int[opt] startPos player start position (default 0)
+@int[opt=0] index Level index.
+@int[opt=0] startPos Player start position in the next level. Should correspond to OCB of `Objects.ObjID.LARA_START_POS` object in the next level.
 */
 	tableFlow.set_function(ScriptReserved_EndLevel, &FlowHandler::EndLevel, this);
 
 /***
 Get game or level statistics. For reference about statistics class, see @{Flow.Statistics}.
 @function GetStatistics
-@tparam bool game if true, returns overall game statistics, otherwise returns current level statistics (default: false)
-@treturn Flow.Statistics statistics structure representing game or level statistics
+@tparam[opt=false] bool game If true, returns overall game statistics, otherwise returns current level statistics.
+@treturn Flow.Statistics Statistics structure representing game or level statistics.
 */
 	tableFlow.set_function(ScriptReserved_GetStatistics, &FlowHandler::GetStatistics, this);
 
 /***
 Set game or level statistics. For reference about statistics class, see @{Flow.Statistics}.
 @function SetStatistics
-@tparam Flow.Statistics statistics statistic object to set
-@tparam bool game if true, sets overall game statistics, otherwise sets current level statistics (default: false)
+@tparam Flow.Statistics statistics Statistic object to set.
+@tparam[opt=false] bool game If true, sets overall game statistics, otherwise sets current level statistics.
 */
 	tableFlow.set_function(ScriptReserved_SetStatistics, &FlowHandler::SetStatistics, this);
 
 /***
 Get current game status, such as normal game loop, exiting to title, etc.
 @function GetGameStatus
-@treturn Flow.GameStatus the current game status
+@treturn Flow.GameStatus The current game status.
 */
 	tableFlow.set_function(ScriptReserved_GetGameStatus, &FlowHandler::GetGameStatus, this);
 
 /***
 Get current freeze mode, such as none, full, spectator or player.
 @function GetFreezeMode
-@treturn Flow.FreezeMode the current freeze mode
+@treturn Flow.FreezeMode The current freeze mode.
 */
 	tableFlow.set_function(ScriptReserved_GetFreezeMode, &FlowHandler::GetFreezeMode, this);
 
@@ -192,7 +188,7 @@ Set current freeze mode, such as none, full, spectator or player.
 Freeze mode specifies whether game is in normal mode or paused in a particular way to allow
 custom menu creation, photo mode or time freeze.
 @function SetFreezeMode
-@tparam Flow.FreezeMode freezeMode new freeze mode to set.
+@tparam Flow.FreezeMode freezeMode New freeze mode to set.
 */
 	tableFlow.set_function(ScriptReserved_SetFreezeMode, &FlowHandler::SetFreezeMode, this);
 
@@ -235,7 +231,7 @@ Returns the player's current per-game secret count.
 /*** 
 Sets the player's current per-game secret count.
 @function SetSecretCount
-@tparam int count new secret count.
+@tparam int count New secret count.
 */
 	tableFlow.set_function(ScriptReserved_SetSecretCount, &FlowHandler::SetSecretCount, this);
 
@@ -243,7 +239,7 @@ Sets the player's current per-game secret count.
 Adds one secret to current level secret count and also plays secret music track.
 The index argument corresponds to the secret's unique ID, the same that would go in a secret trigger's Param.
 @function AddSecret
-@tparam int index an index of current level's secret (must be from 0 to 31).
+@tparam int index An index of current level's secret (must be from 0 to 31).
 */
 	tableFlow.set_function(ScriptReserved_AddSecret, &FlowHandler::AddSecret, this);
 
@@ -277,45 +273,46 @@ Must be an integer value (0 means no secrets).
 These functions are called in settings.lua, a file which holds global settings, such as system settings, flare color or animation movesets.
 @section settingslua
 */
+
 /*** Set provided settings table to an engine.
 @function SetSettings
-@tparam Flow.Settings settings a settings table 
+@tparam Flow.Settings settings A settings table.
 */
 	tableFlow.set_function(ScriptReserved_SetSettings, &FlowHandler::SetSettings, this);
+
 /*** Get settings table from an engine.
 @function GetSettings
-@treturn Flow.Settings current settings table 
+@treturn Flow.Settings Current settings table.
 */
 	tableFlow.set_function(ScriptReserved_GetSettings, &FlowHandler::GetSettings, this);
 
 /*** strings.lua. 
-These functions used in strings.lua, which is generated by TombIDE.
-You will not need to call them manually.
+These functions used in strings.lua, which is generated by TombIDE. You will not need to call them manually.
 @section stringslua
 */
 
 /*** Set string variable keys and their translations.
 @function SetStrings
-@tparam tab table array-style table with strings
+@tparam table table Array-style table with strings.
 */
 	tableFlow.set_function(ScriptReserved_SetStrings, &FlowHandler::SetStrings, this);
 
 /*** Get translated string.
 @function GetString
-@tparam key string key for translated string 
+@tparam string key Key for translated string.
 */
 	tableFlow.set_function(ScriptReserved_GetString, &FlowHandler::GetString, this);
 
 /*** Check if translated string is present.
 @function IsStringPresent
-@tparam key string key for translated string
+@tparam string key Key for translated string.
 */
 	tableFlow.set_function(ScriptReserved_IsStringPresent, &FlowHandler::IsStringPresent, this);
 
 /*** Set language names for translations.
 Specify which translations in the strings table correspond to which languages.
 @function SetLanguageNames
-@tparam tab table array-style table with language names
+@tparam table table Array-style table with language names.
 */
 	tableFlow.set_function(ScriptReserved_SetLanguageNames, &FlowHandler::SetLanguageNames, this);
 	
diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp
index b269ff2cb..932db5bd2 100644
--- a/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Flow/Fog/Fog.cpp
@@ -37,8 +37,8 @@ void Fog::Register(sol::table& parent)
 
 /***
 @tparam Color color RGB color
-@tparam int min Distance at which fog starts (in sectors)
-@tparam int max Distance at which fog reaches the maximum strength (in sectors)
+@tparam int min Distance at which fog starts (in sectors).
+@tparam int max Distance at which fog reaches the maximum strength (in sectors).
 @treturn Fog A fog object.
 @function Fog
 */
diff --git a/TombEngine/Scripting/Internal/TEN/Flow/InventoryItem/InventoryItem.cpp b/TombEngine/Scripting/Internal/TEN/Flow/InventoryItem/InventoryItem.cpp
index 9d229fb41..91b4dcd09 100644
--- a/TombEngine/Scripting/Internal/TEN/Flow/InventoryItem/InventoryItem.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Flow/InventoryItem/InventoryItem.cpp
@@ -11,15 +11,14 @@
 
 /*** Create an InventoryItem.
 	@function InventoryItem
-	@tparam string nameKey key for the item's (localised) name.
      
-Corresponds to an entry in strings.lua.
+	@tparam string nameKey key for the item's (localised) name. Corresponds to an entry in strings.lua.
 	@tparam Objects.ObjID objectID object ID of the inventory object to change
 	@tparam float yOffset y-axis offset (positive values move the item down).
      
 A value of about 100 will cause the item to display directly below its usual position.
 	@tparam float scale item size (1 being standard size).
      
 A value of 0.5 will cause the item to render at half the size,
 and a value of 2 will cause the item to render at twice the size.
-	@tparam Rotation rot rotation around x, y, and z axes
+	@tparam Rotation rot rotation around x, y, and z axes.
 	@tparam RotationAxis axis Axis to rotate around when the item is observed at in the inventory.
      
 Note that this is entirely separate from the `rot` field described above.
 Must one of the following:
@@ -27,7 +26,7 @@ Must one of the following:
 	Y
 	Z
 e.g. `myItem.rotAxisWhenCurrent = RotationAxis.X`
-	@tparam int meshBits __Not currently implemented__ (will have no effect regardless of what you set it to)
+	@tparam int meshBits _Not currently implemented_ (will have no effect regardless of what you set it to).
 	@tparam ItemAction action is this usable, equippable, combineable or examinable?
      
 Must be one of:
 	EQUIP
@@ -35,7 +34,7 @@ Must be one of:
 	COMBINE
 	EXAMINE
 e.g. `myItem.action = ItemAction.EXAMINE`
-	@treturn InventoryItem an InventoryItem
+	@treturn InventoryItem an InventoryItem.
 */
 InventoryItem::InventoryItem(const std::string& name, GAME_OBJECT_ID objectID, float yOffset, float scale, const Rotation& rot, RotationFlags rotFlags, int meshBits, ItemOptions action) :
 	Name(name),
diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp
index 2b5c0aea8..a9a7bb7cf 100644
--- a/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Flow/Level/FlowLevel.cpp
@@ -24,13 +24,12 @@ void Level::Register(sol::table& parent)
 		sol::constructors(),
 		sol::call_constructor, sol::constructors(),
 
-/// (string) string key for the level's (localised) name.
-// Corresponds to an entry in strings.lua.
+/// (string) String key for the level's name. Corresponds to an entry in strings.lua.
 //@mem nameKey
 		"nameKey", &Level::NameStringKey,
 
 /// (string) Level-specific Lua script file.
-// Path of the Lua file holding the level's logic script, relative to the location of the tombengine executable
+// Path of the Lua file holding the level's logic script, relative to the location of the Tomb Engine executable.
 //@mem scriptFile
 		"scriptFile", &Level::ScriptFileName,
 
@@ -40,11 +39,11 @@ void Level::Register(sol::table& parent)
 		"levelFile", &Level::FileName,
 
 /// (string) Load screen image.
-// Path of the level's load screen file (.png or .jpg), relative to the location of the tombengine executable
+// Path of the level's load screen file (.png or .jpg), relative to the location of the Tomb Engine executable.
 //@mem loadScreenFile
 		"loadScreenFile", &Level::LoadScreenFileName,
 		
-/// (string) initial ambient sound track to play.
+/// (string) Initial ambient sound track to play.
 // This is the filename of the track __without__ the .wav extension.
 //@mem ambientTrack
 		"ambientTrack", &Level::AmbientTrack,
@@ -57,12 +56,12 @@ void Level::Register(sol::table& parent)
 //@mem layer2
 		"layer2", &Level::Layer2,
 
-///  (@{Flow.Horizon}) First horizon layer.
+///  (@{Flow.Horizon}) Primary horizon object.
 //@mem horizon1
 		"horizon1", &Level::Horizon1,
 		"horizon", sol::property(&Level::GetHorizon1Enabled, &Level::SetHorizon1Enabled), // Compatibility.
 
-///  (@{Flow.Horizon}) Second horizon layer.
+///  (@{Flow.Horizon}) Secondary horizon object.
 //@mem horizon2
 		"horizon2", &Level::Horizon2,
 
@@ -80,7 +79,7 @@ void Level::Register(sol::table& parent)
 		"fog", &Level::Fog,
 
 /// (bool) Enable flickering lightning in the sky.
-// Equivalent to classic TRLE's LIGHTNING setting. As in the TRC Ireland levels.
+// Equivalent to classic TRLE's lightning setting, as in the TRC Ireland levels or TR4 Cairo levels.
 //@mem storm
 		"storm", &Level::Storm,
 
@@ -94,19 +93,10 @@ void Level::Register(sol::table& parent)
 //@mem weatherStrength
 		"weatherStrength", &Level::WeatherStrength,
 
-/*** (LaraType) Must be one of the LaraType values.
-These are:
+/*** (LaraType) Appearance of Lara. Must be either `LaraType.Normal` or `LaraType.Young`.
+E.g. `myLevel.laraType = LaraType.Young` will make Lara appear as young (with two ponytails rendered).
+This setting does not affect ability to use weapons or flares.
 
-	Normal  
-	Young
-	Bunhead
-	Catsuit
-	Divesuit
-	Invisible
-
-e.g. `myLevel.laraType = LaraType.Divesuit`
-
- __Not yet fully implemented.__ Only types `Normal` and `Young` are guaranteed to work.
  @mem laraType*/
 		"laraType", &Level::Type,
 
diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp
index 263c938fb..a3bfc7afb 100644
--- a/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Flow/Settings/Settings.cpp
@@ -73,35 +73,35 @@ namespace TEN::Scripting
 			sol::meta_function::new_index, NewIndexErrorMaker(AnimSettings, ScriptReserved_AnimSettings),
 
 		/// Extended crawl moveset.
-		// @tfield bool crawlExtended when enabled, player will be able to traverse across one-click steps in crawlspaces.
+		// @tfield bool crawlExtended When enabled, player will be able to traverse across one-click steps in crawlspaces.
 		"crawlExtended", &AnimSettings::CrawlExtended,
 
 		/// Crouch roll.
-		// @tfield bool crouchRoll when enabled, player can perform crawlspace roll by pressing sprint key.
+		// @tfield bool crouchRoll When enabled, player can perform crawlspace roll by pressing sprint key.
 		"crouchRoll", &AnimSettings::CrouchRoll,
 
 		/// Crawlspace dive.
-		// @tfield bool crawlspaceSwandive when enabled, player will be able to swandive into crawlspaces.
+		// @tfield bool crawlspaceSwandive When enabled, player will be able to swandive into crawlspaces.
 		"crawlspaceSwandive", &AnimSettings::CrawlspaceDive,
 
 		// Overhang climbing.
-		// @tfield bool overhangClimb enables overhang climbing feature. Currently does not work.
+		// @tfield bool overhangClimb Enables overhang climbing feature. Currently does not work.
 		"overhangClimb", &AnimSettings::OverhangClimb,
 
 		// Extended slide mechanics.
-		// @tfield bool slideExtended if enabled, player will be able to change slide direction with controls. Currently does not work.
+		// @tfield bool slideExtended If enabled, player will be able to change slide direction with controls. Currently does not work.
 		"slideExtended", &AnimSettings::SlideExtended,
 
 		/// Sprint jump.
-		// @tfield bool sprintJump if enabled, player will be able to perform extremely long jump when sprinting.
+		// @tfield bool sprintJump If enabled, player will be able to perform extremely long jump when sprinting.
 		"sprintJump", &AnimSettings::SprintJump,
 
 		/// Ledge jumps.
-		// @tfield bool ledgeJumps if this setting is enabled, player will be able to jump upwards while hanging on the ledge.
+		// @tfield bool ledgeJumps If this setting is enabled, player will be able to jump upwards while hanging on the ledge.
 		"ledgeJumps", &AnimSettings::LedgeJumps,
 
 		/// Pose timeout.
-		// @tfield int poseTimeout if this setting is larger than 0, idle standing pose animation will be performed after given timeout (in seconds).
+		// @tfield int poseTimeout If this setting is larger than 0, idle standing pose animation will be performed after given timeout (in seconds).
 		"poseTimeout", &AnimSettings::PoseTimeout);
 	}
 
@@ -116,15 +116,15 @@ namespace TEN::Scripting
 			sol::meta_function::new_index, NewIndexErrorMaker(CameraSettings, ScriptReserved_CameraSettings),
 
 		/// Determines highlight color in binocular mode.
-		// @tfield Color binocularLightColor color of highlight, when player presses action. Zero color means there will be no highlight.
+		// @tfield Color binocularLightColor Color of highlight, when player presses action. Zero color means there will be no highlight.
 		"binocularLightColor", &CameraSettings::BinocularLightColor,
 	
 		/// Determines highlight color in lasersight mode.
-		// @tfield Color lasersightLightColor lasersight highlight color. Zero color means there will be no highlight.
+		// @tfield Color lasersightLightColor Lasersight highlight color. Zero color means there will be no highlight.
 		"lasersightLightColor", &CameraSettings::LasersightLightColor,
 	
 		/// Specify whether camera can collide with objects.
-		// @tfield bool objectCollision when enabled, camera will collide with moveables and statics. Disable for TR4-like camera behaviour.
+		// @tfield bool objectCollision When enabled, camera will collide with moveables and statics. Disable for TR4-like camera behaviour.
 		"objectCollision", &CameraSettings::ObjectCollision);
 	}
 
@@ -139,39 +139,39 @@ namespace TEN::Scripting
 			sol::meta_function::new_index, NewIndexErrorMaker(FlareSettings, ScriptReserved_FlareSettings),
 
 		/// Flare color.
-		// @tfield Color color flare color. Used for sparks and lensflare coloring as well.
+		// @tfield Color color Flare color. Used for sparks and lensflare coloring as well.
 		"color", &FlareSettings::Color,
 
 		/// Muzzle offset.
-		// @tfield Vec3 offset a relative muzzle offset where light and particle effects originate from.
+		// @tfield Vec3 offset A relative muzzle offset where light and particle effects originate from.
 		"offset", &FlareSettings::Offset,
 
 		/// Light range.
-		// @tfield int range flare light radius or range. Represented in "clicks" equal to 256 world units.
+		// @tfield int range Flare light radius or range. Represented in "clicks" equal to 256 world units.
 		"range", &FlareSettings::Range,
 
 		/// Burn timeout.
-		// @tfield int timeout flare burn timeout. Flare will stop working after given timeout (specified in seconds).
+		// @tfield int timeout Flare burn timeout. Flare will stop working after given timeout (specified in seconds).
 		"timeout", &FlareSettings::Timeout,
 
 		/// Default flare pickup count.
-		// @tfield int pickupCount specifies amount of flares that you get when you pick up a box of flares.
+		// @tfield int pickupCount Specifies amount of flares that you get when you pick up a box of flares.
 		"pickupCount", &FlareSettings::PickupCount,
 
 		/// Lens flare brightness.
-		// @tfield float lensflareBrightness brightness multiplier. Specifies how bright lens flare is in relation to light (on a range from 0 to 1).
+		// @tfield float lensflareBrightness Brightness multiplier. Specifies how bright lens flare is in relation to light (on a range from 0 to 1).
 		"lensflareBrightness", &FlareSettings::LensflareBrightness,
 
 		/// Toggle spark effect.
-		// @tfield bool sparks spark effect. Determines whether flare generates sparks when burning.
+		// @tfield bool sparks Spark effect. Determines whether flare generates sparks when burning.
 		"sparks", &FlareSettings::Sparks,
 
 		/// Toggle smoke effect.
-		// @tfield bool smoke smoke effect. Determines whether flare generates smoke when burning.
+		// @tfield bool smoke Smoke effect. Determines whether flare generates smoke when burning.
 		"smoke", &FlareSettings::Smoke,
 
 		/// Toggle flicker effect.
-		// @tfield bool flicker light and lensflare flickering. When turned off, flare light will be constant.
+		// @tfield bool flicker Light and lensflare flickering. When turned off, flare light will be constant.
 		"flicker", &FlareSettings::Flicker);
 	}
 
@@ -188,15 +188,15 @@ namespace TEN::Scripting
 			sol::meta_function::new_index, NewIndexErrorMaker(HairSettings, ScriptReserved_HairSettings),
 
 		/// Root mesh to which hair object will attach to.
-		// @tfield int mesh index of a root mesh to which hair will attach. Root mesh may be different for each hair object.
+		// @tfield int mesh Index of a root mesh to which hair will attach. Root mesh may be different for each hair object.
 		"rootMesh", &HairSettings::RootMesh,
 
 		/// Relative braid offset to a headmesh.
-		// @tfield Vec3 offset specifies how braid is positioned in relation to a headmesh.
+		// @tfield Vec3 offset Specifies how braid is positioned in relation to a headmesh.
 		"offset", &HairSettings::Offset,
 	
 		/// Braid connection indices.
-		// @tfield table indices a list of headmesh's vertex connection indices. Each index corresponds to nearest braid rootmesh vertex. Amount of indices is unlimited.
+		// @tfield table indices A list of headmesh's vertex connection indices. Each index corresponds to nearest braid rootmesh vertex. Amount of indices is unlimited.
 		"indices", &HairSettings::Indices);
 	}
 
@@ -211,19 +211,19 @@ namespace TEN::Scripting
 			sol::meta_function::new_index, NewIndexErrorMaker(HudSettings, ScriptReserved_HudSettings),
 
 		/// Toggle in-game status bars visibility.
-		// @tfield bool statusBars if disabled, all status bars (health, air, stamina) will be hidden.
+		// @tfield bool statusBars If disabled, all status bars (health, air, stamina) will be hidden.
 		"statusBars", &HudSettings::StatusBars,
 
 		/// Toggle loading bar visibility.
-		// @tfield bool loadingBar if disabled, loading bar will be invisible in game.
+		// @tfield bool loadingBar If disabled, loading bar will be invisible in game.
 		"loadingBar", &HudSettings::LoadingBar,
 
 		/// Toggle speedometer visibility.
-		// @tfield bool speedometer if disabled, speedometer will be invisible in game.
+		// @tfield bool speedometer If disabled, speedometer will be invisible in game.
 		"speedometer", &HudSettings::Speedometer,
 
 		/// Toggle pickup notifier visibility.
-		// @tfield bool pickupNotifier if disabled, pickup notifier will be invisible in game.
+		// @tfield bool pickupNotifier If disabled, pickup notifier will be invisible in game.
 		"pickupNotifier", &HudSettings::PickupNotifier);
 	}
 
@@ -238,11 +238,11 @@ namespace TEN::Scripting
 			sol::meta_function::new_index, NewIndexErrorMaker(PhysicsSettings, ScriptReserved_PhysicsSettings),
 
 		/// Global world gravity.
-		// @tfield float gravity specifies global gravity. Mostly affects Lara and several other objects.
+		// @tfield float gravity Specifies global gravity. Mostly affects Lara and several other objects.
 		"gravity", &PhysicsSettings::Gravity,
 
 		/// Swim velocity.
-		// @tfield float swimVelocity specifies swim velocity for Lara. Affects both surface and underwater.
+		// @tfield float swimVelocity Specifies swim velocity for Lara. Affects both surface and underwater.
 		"swimVelocity", &PhysicsSettings::SwimVelocity);
 	}
 
@@ -258,31 +258,31 @@ namespace TEN::Scripting
 			sol::meta_function::new_index, NewIndexErrorMaker(WeaponSettings, ScriptReserved_WeaponSettings),
 
 		/// Shooting accuracy.
-		// @tfield float accuracy determines accuracy range in angles (smaller angles mean higher accuracy). Applicable only for firearms.
+		// @tfield float accuracy Determines accuracy range in angles (smaller angles mean higher accuracy). Applicable only for firearms.
 		"accuracy", &WeaponSettings::Accuracy,
 
 		/// Targeting distance.
-		// @tfield float targetingDistance specifies maximum targeting distance in world units (1 block = 1024 world units) for a given weapon.
+		// @tfield float targetingDistance Specifies maximum targeting distance in world units (1 block = 1024 world units) for a given weapon.
 		"targetingDistance", &WeaponSettings::Distance,
 
 		/// Shooting interval.
-		// @tfield float interval specifies an interval (in frames), after which Lara is able to shoot again. Not applicable for backholster weapons.
+		// @tfield float interval Specifies an interval (in frames), after which Lara is able to shoot again. Not applicable for backholster weapons.
 		"interval", &WeaponSettings::Interval,
 
 		/// Damage.
-		// @tfield int damage amount of hit points taken for every hit.
+		// @tfield int damage Amount of hit points taken for every hit.
 		"damage", &WeaponSettings::Damage,
 
 		/// Alternate damage.
-		// @tfield int alternateDamage for Revolver and HK, specifies damage in lasersight mode. For crossbow, specifies damage for explosive ammo.
+		// @tfield int alternateDamage For Revolver and HK, specifies damage in lasersight mode. For crossbow, specifies damage for explosive ammo.
 		"alternateDamage", &WeaponSettings::AlternateDamage,
 
 		/// Water level.
-		// @tfield int waterLevel specifies water depth, at which Lara will put weapons back into holsters, indicating it's not possible to use it in water.
+		// @tfield int waterLevel Specifies water depth, at which Lara will put weapons back into holsters, indicating it's not possible to use it in water.
 		"waterLevel", &WeaponSettings::WaterLevel,
 
 		/// Default ammo pickup count.
-		// @tfield int pickupCount amount of ammo which is given with every ammo pickup for this weapon.
+		// @tfield int pickupCount Amount of ammo which is given with every ammo pickup for this weapon.
 		"pickupCount", &WeaponSettings::PickupCount,
 
 		/// Gunflash color.
@@ -302,7 +302,7 @@ namespace TEN::Scripting
 		"smoke", &WeaponSettings::Smoke,
 
 		/// Gun shell.
-		// @tfield bool shell if set to true, indicates that weapon emits gun shell. Applicable only for firearms.
+		// @tfield bool shell If set to true, indicates that weapon emits gun shell. Applicable only for firearms.
 		"shell", &WeaponSettings::Shell,
 
 		/// Display muzzle flash.
@@ -333,20 +333,20 @@ namespace TEN::Scripting
 			sol::meta_function::new_index, NewIndexErrorMaker(SystemSettings, ScriptReserved_SystemSettings),
 
 		/// How should the application respond to script errors?
-		// @tfield Flow.ErrorMode errorMode error mode to use.
+		// @tfield Flow.ErrorMode errorMode Error mode to use.
 		"errorMode", &SystemSettings::ErrorMode,
 
 		/// Use multithreading in certain calculations. 
      
 		// When set to `true`, some performance-critical calculations will be performed in parallel, which can give
 		// a significant performance boost. Don't disable unless you have problems with launching or using TombEngine.
-		// @tfield bool multithreaded determines whether to use multithreading or not.
+		// @tfield bool multithreaded Determines whether to use multithreading or not.
 		"multithreaded", &SystemSettings::Multithreaded,
 
 		/// Can the game utilize the fast reload feature? 
      
 		// When set to `true`, the game will attempt to perform fast savegame reloading if current level is the same as
 		// the level loaded from the savegame. It will not work if the level timestamp or checksum has changed
 		// (i.e. level was updated). If set to `false`, this functionality is turned off.
-		// @tfield bool fastReload toggle fast reload on or off.
+		// @tfield bool fastReload Toggles fast reload on or off.
 		"fastReload", &SystemSettings::FastReload);
 	}
 }
diff --git a/TombEngine/Scripting/Internal/TEN/Flow/SkyLayer/SkyLayer.cpp b/TombEngine/Scripting/Internal/TEN/Flow/SkyLayer/SkyLayer.cpp
index 33bf45fa1..7f9ca11f3 100644
--- a/TombEngine/Scripting/Internal/TEN/Flow/SkyLayer/SkyLayer.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Flow/SkyLayer/SkyLayer.cpp
@@ -19,11 +19,11 @@ void SkyLayer::Register(sol::table & parent)
 		ctors(),
 		sol::call_constructor, ctors(),	
 
-		/// (@{Color}) RGB sky color
+		/// (@{Color}) RGB sky color.
 		//@mem color
 				"color", sol::property(&SkyLayer::GetColor, &SkyLayer::SetColor),
 
-		/*** (int) cloud speed.
+		/*** (int) Cloud speed.
 
 		Values can be between [-32768, 32767], with positive numbers resulting in a sky that scrolls from
 		west to east, and negative numbers resulting in one that travels east to west.
@@ -38,8 +38,8 @@ void SkyLayer::Register(sol::table & parent)
 }
 
 /*** 
-@tparam Color color RGB color
-@tparam int speed cloud speed
+@tparam Color color RGB color.
+@tparam int speed Cloud speed.
 @treturn SkyLayer A SkyLayer object.
 @function SkyLayer
 */
diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp
index 09176ce75..dcb1eaca5 100644
--- a/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Flow/Starfield/Starfield.cpp
@@ -66,7 +66,7 @@ namespace TEN::Scripting
 	// @tparam int meteorCount Meteor count. __Max: 100__
 	// @tparam int meteorSpawnDensity Meteor spawn density.
 	// @tparam int meteorVel Meteor velocity.
-	// @treturn StarField A new Starfield object.
+	// @treturn Starfield A new Starfield object.
 	Starfield::Starfield(int starCount, int meteorCount, int meteorSpawnDensity, float meteorVel)
 	{
 		if (starCount < 0 || starCount > STAR_COUNT_MAX)
diff --git a/TombEngine/Scripting/Internal/TEN/Flow/Statistics/Statistics.cpp b/TombEngine/Scripting/Internal/TEN/Flow/Statistics/Statistics.cpp
index 1dc5cbf69..cc9bef77d 100644
--- a/TombEngine/Scripting/Internal/TEN/Flow/Statistics/Statistics.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Flow/Statistics/Statistics.cpp
@@ -21,47 +21,47 @@ namespace TEN::Scripting
 			sol::meta_function::new_index, NewIndexErrorMaker(Statistics, ScriptReserved_Statistics),
 
 			/*** Ammo hits.
-			@tfield int ammoHits amount of successful enemy hits.
+			@tfield int ammoHits Amount of successful enemy hits.
 			*/
 			"ammoHits", &Statistics::AmmoHits,
 
 			/*** Ammo used.
-			@tfield int ammoUsed amount of used ammo.
+			@tfield int ammoUsed Amount of used ammo.
 			*/
 			"ammoUsed", &Statistics::AmmoUsed,
 
 			/*** Distance traveled.
-			@tfield int distanceTraveled amount of traveled distance in world units. One meter is 420 world units.
+			@tfield int distanceTraveled Amount of traveled distance in world units. One meter is 420 world units.
 			*/
 			"distanceTraveled", &Statistics::Distance,
 
 			/*** Health packs used.
-			@tfield int healthPacksUsed amount of used medipacks.
+			@tfield int healthPacksUsed Amount of used medipacks.
 			*/
 			"healthPacksUsed", &Statistics::HealthUsed,
 
 			/*** Damage taken.
-			@tfield int damageTaken overall amount of taken damage.
+			@tfield int damageTaken overall Amount of taken damage.
 			*/
 			"damageTaken", &Statistics::DamageTaken,
 
 			/*** Kills.
-			@tfield int kills amount of killed enemies.
+			@tfield int kills Amount of killed enemies.
 			*/
 			"kills", &Statistics::Kills,
 
 			/*** Pickups.
-			@tfield int pickups amount of picked up items.
+			@tfield int pickups Amount of picked up items.
 			*/
 			"pickups", &Statistics::Pickups,
 
 			/*** Secrets.
-			@tfield int secrets amount of found secrets.
+			@tfield int secrets Amount of found secrets.
 			*/
 			"secrets", &Statistics::Secrets,
 
 			/*** Time taken.
-			@tfield Time timeTaken amount of time passed.
+			@tfield Time timeTaken Amount of time passed.
 			*/
 			"timeTaken", &Statistics::TimeTaken);
 	}
diff --git a/TombEngine/Scripting/Internal/TEN/Input/InputHandler.cpp b/TombEngine/Scripting/Internal/TEN/Input/InputHandler.cpp
index f68607d88..7f604d502 100644
--- a/TombEngine/Scripting/Internal/TEN/Input/InputHandler.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Input/InputHandler.cpp
@@ -96,7 +96,7 @@ namespace TEN::Scripting::Input
 	}
 
 	/// Get the display position of the cursor in percent.
-	// @function GetMouseDisplayPosition()
+	// @function GetMouseDisplayPosition
 	// @treturn Vec2 Cursor display position in percent.
 	static Vec2 GetMouseDisplayPosition()
 	{
diff --git a/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp b/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp
index e1cf4ed6b..1ec40f0f5 100644
--- a/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Logic/LogicHandler.cpp
@@ -342,7 +342,7 @@ Possible event type values:
 @function HandleEvent
 @tparam string name Name of the event set to find.
 @tparam EventType type Event to execute.
-@tparam Objects.Moveable activator Optional activator. Default is the player object.
+@tparam[opt=Lara] Objects.Moveable activator Optional activator.
 */
 void LogicHandler::HandleEvent(const std::string& name, EventType type, sol::optional activator)
 {
@@ -951,7 +951,7 @@ std::unique_ptr GetByName(const std::string& type, const std::string& name, c
 @section specialobjects
 */
 
-/*** A @{Objects.Moveable} representing Lara herself.
+/*** An @{Objects.Moveable} entry representing Lara herself.
 @table Lara
 */
 void LogicHandler::ResetVariables()
diff --git a/TombEngine/Scripting/Internal/TEN/Objects/AIObject/AIObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/AIObject/AIObject.cpp
index cbcb5548b..a76cffdb0 100644
--- a/TombEngine/Scripting/Internal/TEN/Objects/AIObject/AIObject.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Objects/AIObject/AIObject.cpp
@@ -27,67 +27,65 @@ void AIObject::Register(sol::table& parent)
 		sol::meta_function::index, IndexError,
 		sol::meta_function::new_index, NewIndexError,
 
-		/// Get the object's position
+		/// Get the object's position.
 		// @function AIObject:GetPosition
-		// @treturn Vec3 a copy of the object's position
+		// @treturn Vec3 A copy of the object's position.
 		ScriptReserved_GetPosition, &AIObject::GetPos,
 
-		/// Set the object's position
+		/// Set the object's position.
 		// @function AIObject:SetPosition
-		// @tparam Vec3 position the new position of the object 
+		// @tparam Vec3 position The new position of the object.
 		ScriptReserved_SetPosition, &AIObject::SetPos,
 
 		/// Get the object's Y-axis rotation.
-		// To the best of my knowledge, the rotation of an AIObject has no effect.
 		// @function AIObject:GetRotationY
-		// @treturn number the object's Y-axis rotation 
+		// @treturn int The object's Y-axis rotation.
 		ScriptReserved_GetRotationY, &AIObject::GetYRot,
 
 		/// Set the object's Y-axis rotation.
-		// To the best of my knowledge, the rotation of an AIObject has no effect.
 		// @function AIObject:SetRotationY
-		// @tparam number rotation The object's new Y-axis rotation
+		// @tparam int rotation The object's new Y-axis rotation.
 		ScriptReserved_SetRotationY, &AIObject::SetYRot,
 
-		/// Get the object's unique string identifier
+		/// Get the object's unique string identifier.
 		// @function AIObject:GetName
-		// @treturn string the object's name
+		// @treturn string The object's name.
 		ScriptReserved_GetName, &AIObject::GetName,
 
-		/// Set the object's name (its unique string identifier)
+		/// Set the object's unique string identifier.
 		// @function AIObject:SetName
-		// @tparam string name The object's new name
+		// @tparam string name The object's new name.
 		ScriptReserved_SetName, &AIObject::SetName,
 
-		/// Get the current room of the object
+		/// Get the current room of the object.
 		// @function AIObject:GetRoom
-		// @treturn Room current room of the object
+		// @treturn Objects.Room current room of the object.
 		ScriptReserved_GetRoom, &AIObject::GetRoom,
 
-		/// Get the current room number of the object
+		/// Get the current room number of the object.
 		// @function AIObject:GetRoomNumber
-		// @treturn int number representing the current room of the object
+		// @treturn int Number representing the current room of the object.
 		ScriptReserved_GetRoomNumber, &AIObject::GetRoomNumber,
 
-		/// Set room number of the object 
+		/// Set room number of the object.
 		// This is used in conjunction with SetPosition to teleport the object to a new room.
 		// @function AIObject:SetRoomNumber
-		// @tparam int ID the ID of the new room 
+		// @tparam int ID The ID of the new room.
 		ScriptReserved_SetRoomNumber, &AIObject::SetRoomNumber,
 
-		/// Retrieve the object ID
+		/// Retrieve the object ID.
 		// @function AIObject:GetObjectID
-		// @treturn int a number representing the ID of the object
+		// @treturn int A number representing the ID of the object.
 		ScriptReserved_GetObjectID, &AIObject::GetObjectID,
 
-		/// Change the object's ID. This will change the type of AI object it is.
+		/// Change the object ID. This will change the type of AI object it is.
 		// Note that a baddy will gain the behaviour of the tile it's on _before_ said baddy is triggered.
 		// This means that changing the type of an AI object beneath a moveable will have no effect.
 		// Instead, this function can be used to change an object that the baddy isn't standing on.
 		// For example, you could have a pair of AI_GUARD objects, and change one or the other two
 		// AI_PATROL_1 based on whether the player has a certain item or not.
 		// @function AIObject:SetObjectID
-		// @tparam Objects.ObjID ID the new ID 
+		// @tparam Objects.ObjID ID the new ID.
 		// @usage
 		// aiObj = TEN.Objects.GetMoveableByName("ai_guard_sphinx_room")
 		// aiObj:SetObjectID(TEN.Objects.ObjID.AI_PATROL1)
diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Camera/CameraObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Camera/CameraObject.cpp
index 1420b3058..e82b9faa3 100644
--- a/TombEngine/Scripting/Internal/TEN/Objects/Camera/CameraObject.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Objects/Camera/CameraObject.cpp
@@ -29,45 +29,45 @@ void CameraObject::Register(sol::table& parent)
 		sol::meta_function::index, IndexError,
 		sol::meta_function::new_index, NewIndexError,
 
-		/// Get the camera's position
+		/// Get the camera's position.
 		// @function Camera:GetPosition
-		// @treturn Vec3 a copy of the camera's position
+		// @treturn Vec3 Camera's position.
 		ScriptReserved_GetPosition, &CameraObject::GetPos,
 
-		/// Set the camera's position
+		/// Set the camera's position.
 		// @function Camera:SetPosition
-		// @tparam Vec3 position the new position of the camera 
+		// @tparam Vec3 position The new position of the camera.
 		ScriptReserved_SetPosition, &CameraObject::SetPos,
 
 		/// Get the camera's unique string identifier
 		// @function Camera:GetName
-		// @treturn string the camera's name
+		// @treturn string the camera's name.
 		ScriptReserved_GetName, &CameraObject::GetName,
 
-		/// Set the camera's name (its unique string identifier)
+		/// Set the camera's name (its unique string identifier).
 		// @function Camera:SetName
-		// @tparam string name The camera's new name
+		// @tparam string name The camera's new name.
 		ScriptReserved_SetName, &CameraObject::SetName,
 
-		/// Get the current room of the camera
+		/// Get the current room of the camera.
 		// @function Camera:GetRoom
-		// @treturn Room current room of the camera
+		// @treturn Objects.Room Current room of the camera.
 		ScriptReserved_GetRoom, &CameraObject::GetRoom,
 
-		/// Get the current room number of the camera
+		/// Get the current room number of the camera.
 		// @function Camera:GetRoomNumber
-		// @treturn int number representing the current room of the camera
+		// @treturn int Number representing the current room of the camera.
 		ScriptReserved_GetRoomNumber, &CameraObject::GetRoomNumber,
 
-		/// Set room of camera 
+		/// Set room of camera.
 		// This is used in conjunction with SetPosition to teleport the camera to a new room.
 		// @function Camera:SetRoomNumber
-		// @tparam int ID the ID of the new room 
+		// @tparam int ID The ID of the new room.
 		ScriptReserved_SetRoomNumber, &CameraObject::SetRoomNumber,
 
-		/// Active the camera during that frame.
+		/// Activate the camera for the current game frame.
 		// @function Camera:PlayCamera
-		// @tparam[opt] Moveable Target If you put a moveable, the camera will look at it. Otherwise, it will look at Lara.
+		// @tparam[opt] Objects.Moveable target If you put a moveable, the camera will look at it. Otherwise, it will look at Lara.
 		ScriptReserved_PlayCamera, &CameraObject::PlayCamera);
 }
 
diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp
index 087e6f10c..6bc77854d 100644
--- a/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp
@@ -345,7 +345,7 @@ int LaraObject::GetAmmoCount() const
 
 /// Get current vehicle, if it exists.
 // @function LaraObject:GetVehicle
-// @treturn Objects.Moveable current vehicle (nil if no vehicle present).
+// @treturn Objects.Moveable Current vehicle (nil if no vehicle present).
 // @usage
 // local vehicle = Lara:GetVehicle()
 std::unique_ptr LaraObject::GetVehicle() const
@@ -390,7 +390,7 @@ std::unique_ptr LaraObject::GetPlayerInteractedMoveable() const
 
 /// Check if a held torch is lit.
 // @function LaraObject:IsTorchLit
-// @treturn bool True if lit, otherwise false.
+// @treturn bool True if lit, otherwise false (also false if there is no torch in hand).
 // @usage
 // local isTorchLit = Lara:IsTorchLit()
 bool LaraObject::IsTorchLit() const
diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp
index 04e4e000b..6bd11a4e0 100644
--- a/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableObject.cpp
@@ -41,17 +41,17 @@ associated getters and setters. If you do not know what to set for these,
 most can just be ignored (see usage).
 
 	@function Moveable
-	@tparam Objects.ObjID object ID
+	@tparam Objects.ObjID objectID Object ID.
 	@tparam string name Lua name.
-	@tparam Vec3 position position in level
-	@tparam Rotation rotation rotation rotation about x, y, and z axes (default Rotation(0, 0, 0))
-	@tparam int roomNumber the room number the moveable is in (default: calculated automatically).
-	@tparam int animNumber animation number
-	@tparam int frameNumber frame number
-	@tparam int hp Hit points.
-	@tparam int OCB Object code bits.
-	@tparam table AIBits table with AI bits (default { 0, 0, 0, 0, 0, 0 })
-	@treturn Moveable A new Moveable object (a wrapper around the new object)
+	@tparam Vec3 position Position in level.
+	@tparam[opt] Rotation rotation Rotation about x, y, and z axes.
+	@tparam[opt] int roomNumber The room number the moveable is in. Needed if you are dealing with overlapping rooms and need to force certain room number.
+	@tparam[opt] int animNumber Animation number.
+	@tparam[opt] int frameNumber Frame number.
+	@tparam[opt] int hp Hit points.
+	@tparam[opt] int OCB Object code bits.
+	@tparam[opt] table AIBits Table with six AI bits.
+	@treturn Objects.Moveable A new Moveable object.
 
 	@usage
 	local item = Moveable(
@@ -94,6 +94,10 @@ static std::unique_ptr Create(GAME_OBJECT_ID objID, const std::string&
 		{
 			scriptMov->SetHP(std::get(hp));
 		}
+		else
+		{
+			scriptMov->SetHP(Objects[objID].HitPoints);
+		}
 
 		scriptMov->SetOcb(ValueOr(ocb, 0));
 		scriptMov->SetAIBits(ValueOr(aiBits, aiBitsType{}));
@@ -242,9 +246,9 @@ void Moveable::Initialize()
 	_initialized = true;
 }
 
-/// Retrieve the object ID
+/// Retrieve the object ID.
 // @function Moveable:GetObjectID
-// @treturn Objects.ObjID a number representing the ID of the object.
+// @treturn Objects.ObjID A number representing the ID of the object.
 GAME_OBJECT_ID Moveable::GetObjectID() const
 {
 	return _moveable->ObjectNumber;
@@ -252,7 +256,7 @@ GAME_OBJECT_ID Moveable::GetObjectID() const
 
 /// Change the object's ID. This will literally change the object.
 // @function Moveable:SetObjectID
-// @tparam Objects.ObjID objectID the new ID 
+// @tparam Objects.ObjID objectID The new ID.
 // @usage
 // shiva = TEN.Objects.GetMoveableByName("shiva_60")
 // shiva:SetObjectID(TEN.Objects.ObjID.BIGMEDI_ITEM)
@@ -291,17 +295,17 @@ int Moveable::GetIndex() const
 /// Set the name of the function to be called when the moveable is shot by Lara.
 // Note that this will be triggered twice when shot with both pistols at once. 
 // @function Moveable:SetOnHit
-// @tparam function callback function in LevelFuncs hierarchy to call when moveable is shot
+// @tparam function function Callback function in LevelFuncs hierarchy to call when moveable is shot.
 void Moveable::SetOnHit(const TypeOrNil& cb)
 {
 	SetLevelFuncCallback(cb, ScriptReserved_SetOnHit, *this, _moveable->Callbacks.OnHit);
 }
 
-/// Set the name of the function to be called when the moveable is destroyed/killed
+/// Set the name of the function to be called when the moveable is destroyed/killed.
 // Note that enemy death often occurs at the end of an animation, and not at the exact moment
 // the enemy's HP becomes zero.
 // @function Moveable:SetOnKilled
-// @tparam function callback function in LevelFuncs hierarchy to call when enemy is killed
+// @tparam function function Callback function in LevelFuncs hierarchy to call when moveable is killed.
 // @usage
 // LevelFuncs.baddyKilled = function(theBaddy) print("You killed a baddy!") end
 // baddy:SetOnKilled(LevelFuncs.baddyKilled)
@@ -310,9 +314,9 @@ void Moveable::SetOnKilled(const TypeOrNil& cb)
 	SetLevelFuncCallback(cb, ScriptReserved_SetOnKilled, *this, _moveable->Callbacks.OnKilled);
 }
 
-/// Set the function to be called when this moveable collides with another moveable
+/// Set the function to be called when this moveable collides with another moveable.
 // @function Moveable:SetOnCollidedWithObject
-// @tparam function func callback function to be called (must be in LevelFuncs hierarchy). This function can take two arguments; these will store the two @{Moveable}s taking part in the collision.
+// @tparam function function Callback function to be called (must be in LevelFuncs hierarchy). This function can take two arguments; these will store the two @{Moveable}s taking part in the collision.
 // @usage
 // -- obj1 is the collision moveable
 // -- obj2 is the collider moveable
@@ -328,7 +332,7 @@ void Moveable::SetOnCollidedWithObject(const TypeOrNil& cb)
 
 /// Set the function called when this moveable collides with room geometry (e.g. a wall or floor). This function can take an argument that holds the @{Moveable} that collided with geometry.
 // @function Moveable:SetOnCollidedWithRoom
-// @tparam function func callback function to be called (must be in LevelFuncs hierarchy)
+// @tparam function function Callback function to be called (must be in LevelFuncs hierarchy).
 // @usage
 // LevelFuncs.roomCollided = function(obj)
 //     print(obj:GetName() .. " collided with room geometry")
@@ -339,22 +343,18 @@ void Moveable::SetOnCollidedWithRoom(const TypeOrNil& cb)
 	SetLevelFuncCallback(cb, ScriptReserved_SetOnCollidedWithRoom, *this, _moveable->Callbacks.OnRoomCollided);
 }
 
-/// Get the moveable's name (its unique string identifier)
-// e.g. "door\_back\_room" or "cracked\_greek\_statue"
-// This corresponds with the "Lua Name" field in an object's properties in Tomb Editor.
+/// Get the moveable's name (its unique string identifier). This corresponds with the "Lua Name" field in an object's properties in Tomb Editor.
 // @function Moveable:GetName
-// @treturn string the moveable's name
+// @treturn string The moveable's name.
 std::string Moveable::GetName() const
 {
 	return _moveable->Name;
 }
 
-/// Set the moveable's name (its unique string identifier)
-// e.g. "door\_back\_room" or "cracked\_greek\_statue"
-// It cannot be blank and cannot share a name with any existing object.
+/// Set the moveable's name (its unique string identifier). It cannot be blank and cannot share a name with any existing object.
 // @function Moveable:SetName
-// @tparam string name the new moveable's name
-// @treturn bool true if we successfully set the name, false otherwise (e.g. if another object has the name already)
+// @tparam string name The new moveable's name.
+// @treturn bool true if name was successfully set, false otherwise (e.g. if another moveable has the name already).
 bool Moveable::SetName(const std::string& id) 
 {
 	if (!ScriptAssert(!id.empty(), "Name cannot be blank. Not setting name."))
@@ -382,21 +382,18 @@ bool Moveable::SetName(const std::string& id)
 	return true;
 }
 
-/// Get the moveable's position
+/// Get the moveable's position.
 // @function Moveable:GetPosition
-// @treturn Vec3 a copy of the moveable's position
+// @treturn Vec3 Moveable's position.
 Vec3 Moveable::GetPosition() const
 {
 	return Vec3(_moveable->Pose.Position);
 }
 
-/// Set the moveable's position
-// If you are moving a moveable whose behaviour involves knowledge of room geometry,
-// (e.g. a BADDY1, which uses it for pathfinding), then the second argument should
-// be true (or omitted, as true is the default). Otherwise, said moveable will not behave correctly.
+/// Set the moveable's position.
 // @function Moveable:SetPosition
-// @tparam Vec3 position the new position of the moveable 
-// @bool[opt] updateRoom Will room changes be automatically detected? Set to false if you are using overlapping rooms (default: true)
+// @tparam Vec3 position The new position of the moveable.
+// @bool[opt=true] updateRoom Will room changes be automatically detected? Set to false if you are using overlapping rooms.
 void Moveable::SetPosition(const Vec3& pos, sol::optional updateRoom)
 {
 	constexpr auto BIG_DISTANCE_THRESHOLD = BLOCK(1);
@@ -439,10 +436,10 @@ Vec3 Moveable::GetJointPos(int jointIndex, sol::optional offset) const
 	return Vec3(GetJointPosition(_moveable, jointIndex, convertedOffset));
 }
 
-/// Get the object's joint rotation
+/// Get the object's joint rotation.
 // @function Moveable:GetJointRotation
 // @tparam int index Index of a joint to get rotation.
-// @treturn Rotation a calculated copy of the moveable's joint rotation
+// @treturn Rotation Moveable's joint rotation.
 Rotation Moveable::GetJointRot(int jointIndex) const
 {
 	auto point1 = GetJointPosition(_moveable, jointIndex);
@@ -468,7 +465,7 @@ Rotation Moveable::GetJointRot(int jointIndex) const
 
 /// Get the moveable's rotation.
 // @function Moveable:GetRotation
-// @treturn Rotation A copy of the moveable's rotation.
+// @treturn Rotation Moveable's rotation.
 Rotation Moveable::GetRotation() const
 {
 	return 
@@ -481,7 +478,7 @@ Rotation Moveable::GetRotation() const
 
 /// Get the moveable's visual scale.
 // @function Moveable:GetScale
-// @treturn Vec3 A copy of the moveable's visual scale.
+// @treturn Vec3 Moveable's visual scale.
 Vec3 Moveable::GetScale() const
 {
 	return Vec3(_moveable->Pose.Scale);
@@ -489,7 +486,7 @@ Vec3 Moveable::GetScale() const
 
 /// Set the moveable's rotation.
 // @function Moveable:SetRotation
-// @tparam Rotation rotation The moveable's new rotation
+// @tparam Rotation rotation The moveable's new rotation.
 void Moveable::SetRotation(const Rotation& rot)
 {
 	constexpr auto BIG_ANGLE_THRESHOLD = ANGLE(30.0f);
@@ -514,18 +511,18 @@ void Moveable::SetScale(const Vec3& scale)
 	_moveable->Pose.Scale = scale.ToVector3();
 }
 
-/// Get current HP (hit points/health points)
+/// Get current HP (hit points / health points).
 // @function Moveable:GetHP
-// @treturn int the amount of HP the moveable currently has
+// @treturn int The amount of HP the moveable currently has.
 short Moveable::GetHP() const
 {
 	return _moveable->HitPoints;
 }
 
-/// Set current HP (hit points/health points)
+/// Set current HP (hit points / health points).
 // Clamped to [0, 32767] for "intelligent" entities (i.e. anything with AI); clamped to [-32767, 32767] otherwise.
 // @function Moveable:SetHP
-// @tparam int HP the amount of HP to give the moveable
+// @tparam int HP The amount of HP to give the moveable.
 void Moveable::SetHP(short hp)
 {
 	if (Objects[_moveable->ObjectNumber].intelligent && hp < 0)
@@ -541,25 +538,25 @@ void Moveable::SetHP(short hp)
 	_moveable->HitPoints = hp;
 }
 
-/// Get HP definded for that object type (hit points/health points) (Read Only).
+/// Get HP definded for that object type (hit points / health points).
 // @function Moveable:GetSlotHP
-// @treturn int the moveable's slot default hit points
+// @treturn int The moveable's slot default hit points.
 short Moveable::GetSlotHP() const
 {
 	return Objects[_moveable->ObjectNumber].HitPoints;
 }
 
-/// Get OCB (object code bit) of the moveable
+/// Get OCB (object code bit) of the moveable.
 // @function Moveable:GetOCB
-// @treturn int the moveable's current OCB value
+// @treturn int The moveable's current OCB value.
 short Moveable::GetOcb() const
 {
 	return _moveable->TriggerFlags;
 }
 
-/// Set OCB (object code bit) of the moveable
+/// Set OCB (object code bit) of the moveable.
 // @function Moveable:SetOCB
-// @tparam int OCB the new value for the moveable's OCB
+// @tparam int OCB The new value for the moveable's OCB.
 void Moveable::SetOcb(short ocb)
 {
 	_moveable->TriggerFlags = ocb;
@@ -568,7 +565,7 @@ void Moveable::SetOcb(short ocb)
 /// Set the effect for this moveable.
 // @function Moveable:SetEffect
 // @tparam Effects.EffectID effect Type of effect to assign.
-// @tparam[opt] float timeout time (in seconds) after which effect turns off.
+// @tparam[opt] float timeout Time (in seconds) after which effect turns off.
 void Moveable::SetEffect(EffectType effectType, sol::optional timeout)
 {
 	int realTimeout = timeout.has_value() ? int(timeout.value() * FPS) : -1;
@@ -604,7 +601,7 @@ void Moveable::SetEffect(EffectType effectType, sol::optional timeout)
 	}
 }
 
-/// Set custom colored burn effect to moveable
+/// Set custom colored burn effect to moveable.
 // @function Moveable:SetCustomEffect
 // @tparam Color color1 The primary color of the effect (also used for lighting).
 // @tparam Color color2 The secondary color of the effect.
@@ -617,7 +614,7 @@ void Moveable::SetCustomEffect(const ScriptColor& col1, const ScriptColor& col2,
 	ItemCustomBurn(_moveable, color1, color2, realTimeout);
 }
 
-/// Get current moveable effect
+/// Get current moveable effect.
 // @function Moveable:GetEffect
 // @treturn Effects.EffectID Effect type currently assigned.
 EffectType Moveable::GetEffect() const
@@ -625,16 +622,16 @@ EffectType Moveable::GetEffect() const
 	return _moveable->Effect.Type;
 }
 
-/// Get the value stored in ItemFlags[index]
+/// Get the value stored in ItemFlags[index].
 // @function Moveable:GetItemFlags
 // @tparam int index Index of the ItemFlag, can be between 0 and 7.
-// @treturn int the value contained in the ItemFlags[index]
+// @treturn int The value contained in the ItemFlags[index].
 short Moveable::GetItemFlags(int index) const
 {
 	return _moveable->ItemFlags[index];
 }
 
-/// Stores a value in ItemFlags[index]
+/// Stores a value in ItemFlags[index].
 // @function Moveable:SetItemFlags
 // @tparam short value Value to store in the moveable's ItemFlags[index].
 // @tparam int index Index of the ItemFlag where to store the value.
@@ -643,9 +640,9 @@ void Moveable::SetItemFlags(short value, int index)
 	_moveable->ItemFlags[index] = value;
 }
 
-/// Get the location value stored in the Enemy AI
+/// Get the location value stored in the Enemy AI.
 // @function Moveable:GetLocationAI
-// @treturn short the value contained in the LocationAI of the creature.
+// @treturn short The value contained in the LocationAI of the creature.
 short Moveable::GetLocationAI() const
 {
 	if (_moveable->IsCreature())
@@ -674,23 +671,23 @@ void Moveable::SetLocationAI(short value)
 	}
 }
 
-/// Get the moveable's color
+/// Get the moveable's color.
 // @function Moveable:GetColor
-// @treturn Color a copy of the moveable's color
+// @treturn Color Moveable's color.
 ScriptColor Moveable::GetColor() const
 {
 	return ScriptColor{ _moveable->Model.Color };
 }
 
-/// Set the moveable's color
+/// Set the moveable's color.
 // @function Moveable:SetColor
-// @tparam Color color the new color of the moveable 
+// @tparam Color color The new color of the moveable.
 void Moveable::SetColor(const ScriptColor& color)
 {
 	_moveable->Model.Color = color;
 }
 
-/// Get AIBits of object
+/// Get AIBits of object.
 // This will return a table with six values, each corresponding to
 // an active behaviour. If the object is in a certain AI mode, the table will
 // have a *1* in the corresponding cell. Otherwise, the cell will hold
@@ -704,7 +701,7 @@ void Moveable::SetColor(const ScriptColor& color)
 //	6 - Patrol 2
 //
 // @function Moveable:GetAIBits
-// @treturn table a table of AI bits
+// @treturn table A table of AI bits.
 aiBitsType Moveable::GetAIBits() const
 {
 	static_assert(63 == ALL_AIOBJ);
@@ -719,11 +716,11 @@ aiBitsType Moveable::GetAIBits() const
 	return ret;
 }
 
-/// Set AIBits of object
+/// Set AIBits of object.
 // Use this to force a moveable into a certain AI mode or modes, as if a certain nullmesh
 // (or more than one) had suddenly spawned beneath their feet.
 // @function Moveable:SetAIBits
-// @tparam table bits the table of AI bits
+// @tparam table bits A table of AI bits.
 // @usage 
 // local sas = TEN.Objects.GetMoveableByName("sas_enemy")
 // sas:SetAIBits({1, 0, 0, 0, 0, 0})
@@ -740,7 +737,7 @@ void Moveable::SetAIBits(aiBitsType const & bits)
 /// Retrieve the index of the current state.
 // This corresponds to the number shown in the item's state ID field in WadTool.
 // @function Moveable:GetState
-// @treturn int the index of the active state
+// @treturn int The index of the active state.
 int Moveable::GetStateNumber() const
 {
 	return _moveable->Animation.ActiveState;
@@ -749,7 +746,7 @@ int Moveable::GetStateNumber() const
 /// Retrieve the index of the target state.
 // This corresponds to the state the object is trying to get into, which is sometimes different from the active state.
 // @function Moveable:GetTargetState
-// @treturn int the index of the target state
+// @treturn int The index of the target state.
 int Moveable::GetTargetStateNumber() const
 {
 	return _moveable->Animation.TargetState;
@@ -759,7 +756,7 @@ int Moveable::GetTargetStateNumber() const
 // Performs no bounds checking. *Ensure the number given is correct, else
 // object may end up in corrupted animation state.*
 // @function Moveable:SetState
-// @tparam int index the index of the desired state 
+// @tparam int index The index of the desired state.
 void Moveable::SetStateNumber(int stateNumber)
 {
 	_moveable->Animation.TargetState = stateNumber;
@@ -769,7 +766,7 @@ void Moveable::SetStateNumber(int stateNumber)
 // In certain cases, moveable may play animations from another object slot. Use this
 // function when you need to identify such cases.
 // @function Moveable:GetAnimSlot
-// @treturn int animation slot ID
+// @treturn int Animation slot ID.
 int Moveable::GetAnimSlot() const
 {
 	return _moveable->Animation.AnimObjectID;
@@ -778,7 +775,7 @@ int Moveable::GetAnimSlot() const
 /// Retrieve the index of the current animation.
 // This corresponds to the number shown in the item's animation list in WadTool.
 // @function Moveable:GetAnim
-// @treturn int the index of the active animation
+// @treturn int The index of the active animation.
 int Moveable::GetAnimNumber() const
 {
 	return _moveable->Animation.AnimNumber - Objects[_moveable->Animation.AnimObjectID].animIndex;
@@ -788,8 +785,8 @@ int Moveable::GetAnimNumber() const
 // Performs no bounds checking. *Ensure the number given is correct, else
 // object may end up in corrupted animation state.*
 // @function Moveable:SetAnim
-// @tparam int index the index of the desired anim 
-// @tparam[opt] int slot slot ID of the desired anim (if omitted, moveable's own slot ID is used)
+// @tparam int index The index of the desired animation.
+// @tparam[opt] int slot Slot ID of the desired anim (if omitted, moveable's own slot ID is used).
 void Moveable::SetAnimNumber(int animNumber, sol::optional slotIndex)
 {
 	SetAnimation(*_moveable, (GAME_OBJECT_ID)slotIndex.value_or(_moveable->ObjectNumber), animNumber);
@@ -798,7 +795,7 @@ void Moveable::SetAnimNumber(int animNumber, sol::optional slotIndex)
 /// Retrieve frame number.
 // This is the current frame of the object's active animation.
 // @function Moveable:GetFrame
-// @treturn int the current frame of the active animation
+// @treturn int The current frame of the active animation.
 int Moveable::GetFrameNumber() const
 {
 	return (_moveable->Animation.FrameNumber - GetAnimData(*_moveable).frameBase);
@@ -808,7 +805,7 @@ int Moveable::GetFrameNumber() const
 // In most cases, only Z and Y components are used as forward and vertical velocity.
 // In some cases, primarily NPCs, X component is used as side velocity.
 // @function Moveable:GetVelocity
-// @treturn Vec3 current object velocity
+// @treturn Vec3 Current object velocity.
 Vec3 Moveable::GetVelocity() const
 {
 	return Vec3(
@@ -821,7 +818,7 @@ Vec3 Moveable::GetVelocity() const
 // In most cases, only Z and Y components are used as forward and vertical velocity.
 // In some cases, primarily NPCs, X component is used as side velocity.
 // @function Moveable:SetVelocity
-// @tparam Vec3 velocity velocity represented as vector 
+// @tparam Vec3 velocity Velocity represented as vector.
 void Moveable::SetVelocity(Vec3 velocity)
 {
 	if (_moveable->IsCreature())
@@ -836,7 +833,7 @@ void Moveable::SetVelocity(Vec3 velocity)
 // the WadTool animation editor. If the animation has no frames, the only valid argument
 // is -1.
 // @function Moveable:SetFrame
-// @tparam int frame the new frame number
+// @tparam int frame The new frame number.
 void Moveable::SetFrameNumber(int frameNumber)
 {
 	const auto& anim = GetAnimData(*_moveable);
@@ -865,9 +862,9 @@ int Moveable::GetEndFrame() const
 	return (anim.frameEnd - anim.frameBase);
 }
 
-/// Determine whether the moveable is active or not 
+/// Determine whether the moveable is active or not.
 // @function Moveable:GetActive
-// @treturn bool true if the moveable is active
+// @treturn bool True if the moveable is active.
 bool Moveable::GetActive() const
 {
 	return _moveable->Active;
@@ -880,23 +877,23 @@ void Moveable::SetActive(bool isActive)
 
 /// Get the hit status of the moveable.
 // @function Moveable:GetHitStatus
-// @treturn bool true if the moveable was hit by something in the last gameplay frame, false otherwise 
+// @treturn bool true if the moveable was hit by something in the last gameplay frame, false otherwise.
 bool Moveable::GetHitStatus() const
 {
 	return _moveable->HitStatus;
 }
 
-/// Get the current room of the object
+/// Get the current room of the moveable.
 // @function Moveable:GetRoom
-// @treturn Objects.Room current room of the object
+// @treturn Objects.Room Current room of the moveable.
 std::unique_ptr Moveable::GetRoom() const
 {
 	return std::make_unique(g_Level.Rooms[_moveable->RoomNumber]);
 }
 
-/// Get the current room number of the object
+/// Get the current room number of the moveable.
 // @function Moveable:GetRoomNumber
-// @treturn int number representing the current room of the object
+// @treturn int Number representing the current room of the moveable.
 int Moveable::GetRoomNumber() const
 {
 	return _moveable->RoomNumber;
@@ -950,21 +947,21 @@ void Moveable::SetStatus(ItemStatus status)
 	_moveable->Status = status;
 }
 
-/// Get number of meshes for a particular object
+/// Get number of meshes for a particular object.
 // Returns number of meshes in an object
 // @function Moveable:GetMeshCount
-// @treturn int number of meshes
+// @treturn int Number of meshes.
 short Moveable::GetMeshCount() const
 {
 	return Objects[_moveable->ObjectNumber].nmeshes;
 }
 
-/// Get state of specified mesh visibility of object
+/// Get state of specified mesh visibility of object.
 // Returns true if specified mesh is visible on an object, and false
 // if it is not visible.
 // @function Moveable:GetMeshVisible
-// @int index index of a mesh
-// @treturn bool visibility status
+// @tparam int index Index of a mesh.
+// @treturn bool Visibility status.
 bool Moveable::GetMeshVisible(int meshId) const
 {
 	if (!MeshExists(meshId))
@@ -973,11 +970,11 @@ bool Moveable::GetMeshVisible(int meshId) const
 	return _moveable->MeshBits.Test(meshId);
 }
 
-/// Makes specified mesh visible or invisible
+/// Makes specified mesh visible or invisible.
 // Use this to show or hide a specified mesh of an object.
 // @function Moveable:SetMeshVisible
-// @int index index of a mesh
-// @bool isVisible true if you want the mesh to be visible, false otherwise
+// @tparam int index Index of a mesh.
+// @tparam bool isVisible true if you want the mesh to be visible, false otherwise.
 void Moveable::SetMeshVisible(int meshId, bool isVisible)
 {
 	if (!MeshExists(meshId))
@@ -993,10 +990,10 @@ void Moveable::SetMeshVisible(int meshId, bool isVisible)
 	}
 }
 
-/// Shatters specified mesh and makes it invisible
+/// Shatters specified mesh and makes it invisible.
 // Note that you can re-enable mesh later by using SetMeshVisible().
 // @function Moveable:ShatterMesh
-// @int index index of a mesh
+// @tparam int index Index of a mesh to shatter.
 void Moveable::ShatterMesh(int meshId)
 {
 	if (!MeshExists(meshId))
@@ -1005,12 +1002,11 @@ void Moveable::ShatterMesh(int meshId)
 	ExplodeItemNode(_moveable, meshId, 0, 128);
 }
 
-/// Get state of specified mesh swap of object
-// Returns true if specified mesh is swapped on an object, and false
-// if it is not swapped.
+/// Get state of specified mesh swap of object.
+// Returns true if specified mesh is swapped on an object, and false if it is not swapped.
 // @function Moveable:GetMeshSwapped
-// @int index index of a mesh
-// @treturn bool mesh swap status
+// @tparam int index Index of a mesh.
+// @treturn bool Mesh swap status.
 bool Moveable::GetMeshSwapped(int meshId) const
 {
 	if (!MeshExists(meshId))
@@ -1019,12 +1015,12 @@ bool Moveable::GetMeshSwapped(int meshId) const
 	return _moveable->Model.MeshIndex[meshId] == _moveable->Model.BaseMesh + meshId;
 }
 
-/// Set state of specified mesh swap of object
+/// Set state of specified mesh swap of object.
 // Use this to swap specified mesh of an object.
 // @function Moveable:SwapMesh
-// @int index index of a mesh
-// @int slotIndex index of a slot to get meshswap from
-// @int[opt] swapIndex index of a mesh from meshswap slot to use
+// @tparam int index Index of a mesh.
+// @tparam int slotIndex Index of a slot to get meshswap from.
+// @tparam[opt] int swapIndex Index of a mesh from meshswap slot to use.
 void Moveable::SwapMesh(int meshId, int swapSlotId, sol::optional swapMeshIndex)
 {
 	if (!MeshExists(meshId))
@@ -1054,10 +1050,10 @@ void Moveable::SwapMesh(int meshId, int swapSlotId, sol::optional swapMeshI
 	_moveable->Model.MeshIndex[meshId] = Objects[swapSlotId].meshIndex + swapMeshIndex.value();
 }
 
-/// Set state of specified mesh swap of object
+/// Set state of specified mesh swap of object.
 // Use this to bring back original unswapped mesh
 // @function Moveable:UnswapMesh
-// @int index index of a mesh to unswap
+// @tparam int index Index of a mesh to unswap.
 void Moveable::UnswapMesh(int meshId)
 {
 	if (!MeshExists(meshId))
@@ -1068,7 +1064,7 @@ void Moveable::UnswapMesh(int meshId)
 
 /// Enable the item, as if a trigger for it had been stepped on.
 // @function Moveable:Enable
-// @tparam float timeout time (in seconds) after which moveable automatically disables (optional).
+// @tparam[opt] float timeout Time (in seconds) after which moveable automatically disables.
 void Moveable::EnableItem(sol::optional timer)
 {
 	if (_moveableID == NO_VALUE)
@@ -1087,8 +1083,8 @@ void Moveable::EnableItem(sol::optional timer)
 		dynamic_cast(g_GameScriptEntities)->TryAddColliding(_moveableID);
 }
 
-/// Disable the item, as if an antitrigger for it had been stepped on (i.e. it will close an open door or extinguish a flame emitter).
-// Note that this will not trigger an OnKilled callback.
+/// Disable the item, as if an antitrigger for it had been stepped on.
+// For example, it will close an open door or extinguish a flame emitter. Note that this will not trigger an OnKilled callback.
 // @function Moveable:Disable
 void Moveable::DisableItem()
 {
@@ -1127,29 +1123,29 @@ void Moveable::Shatter()
 }
 
 /// Get the item's collision state.
-// @treturn bool item's collision state
 // @function Moveable:GetCollidable
+// @treturn bool Item's collision state.
 bool Moveable::GetCollidable()
 {
 	return _moveable->Collidable;
 }
 
 /// Set the item's collision.
-// @bool collidable true if the caller should be collidable, false if no collision should occur.
 // @function Moveable:SetCollidable
+// @bool collidable true if the caller should be collidable, false if no collision should occur.
 void Moveable::SetCollidable(bool isCollidable)
 {
 	_moveable->Collidable = isCollidable;
 }
 
-/// Make the item invisible. Alias for `Moveable:SetVisible(false)`.
+// Make the item invisible. Alias for `Moveable:SetVisible(false)`.
 // @function Moveable:MakeInvisible
 void Moveable::MakeInvisible()
 {
 	SetVisible(false);
 }
-/// Set the item's visibility. __An invisible item will have collision turned off, as if it no longer exists in the game world__.
-// @bool visible true if the caller should become visible, false if it should become invisible
+/// Set the item's visibility. An invisible item will have collision turned off, as if it no longer exists in the game world.
+// @bool visible true if the caller should become visible, false if it should become invisible.
 // @function Moveable:SetVisible
 void Moveable::SetVisible(bool isVisible)
 {
@@ -1200,9 +1196,9 @@ void Moveable::Invalidate()
 	_initialized = false;
 }
 
-/// Test if the object is in a valid state (i.e. has not been destroyed through Lua or killed by Lara).
+/// Test if the object is in a valid state. Indicates that it has not been destroyed through Lua or killed by Lara.
 // @function Moveable:GetValid
-// @treturn bool valid true if the object is still not destroyed
+// @treturn bool true if the object is still not destroyed.
 bool Moveable::GetValid() const
 {
 	return _moveableID > NO_VALUE;
@@ -1236,18 +1232,18 @@ bool Moveable::MeshExists(int index) const
 /// Attach camera to an object.
 // @function Moveable:AttachObjCamera
 // @tparam int mesh Mesh of a moveable to use as a camera position.
-// @tparam Moveable target Target moveable to attach camera to.
+// @tparam Objects.Moveable target Target moveable to attach camera to.
 // @tparam int mesh Mesh of a target moveable to use as a camera target.
 void Moveable::AttachObjCamera(short camMeshId, Moveable& mov, short targetMeshId)
 {
 	ObjCamera(_moveable, camMeshId, mov._moveable, targetMeshId, true);
 }
 
-/// Borrow animation from an object
+/// Borrow animation from an object.
 // @function Moveable:AnimFromObject
-// @tparam Objects.ObjID objectID Object ID to take animation and stateID from.
+// @tparam Objects.ObjID objectID Object ID to take animation and state ID from.
 // @tparam int animNumber Animation from object.
-// @tparam int stateID state State from object.
+// @tparam int stateID State from object.
 void Moveable::AnimFromObject(GAME_OBJECT_ID objectID, int animNumber, int stateID)
 {
 	_moveable->Animation.AnimObjectID = objectID;
diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableStatuses.h b/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableStatuses.h
index e038d00bf..05b2e17e8 100644
--- a/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableStatuses.h
+++ b/TombEngine/Scripting/Internal/TEN/Objects/Moveable/MoveableStatuses.h
@@ -10,10 +10,10 @@
 //
 // To be used with @{Objects.Moveable.GetStatus} and @{Objects.Moveable.SetStatus} functions.
 //
-// - `INACTIVE` - moveable is inactive (was never activated).
-// - `ACTIVE` - moveable is active.
-// - `DEACTIVATED` - moveable is deactivated (was previously active and later deactivated).
-// - `INVISIBLE` - moveable is invisible.
+// - `INACTIVE` - Moveable is inactive (was never activated).
+// - `ACTIVE` - Moveable is active.
+// - `DEACTIVATED` - Moveable is deactivated (was previously active and later deactivated).
+// - `INVISIBLE` - Moveable is invisible.
 //
 // @table Objects.MoveableStatus
 
diff --git a/TombEngine/Scripting/Internal/TEN/Objects/ObjectsHandler.cpp b/TombEngine/Scripting/Internal/TEN/Objects/ObjectsHandler.cpp
index 89eb52ee2..af24a0c2a 100644
--- a/TombEngine/Scripting/Internal/TEN/Objects/ObjectsHandler.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Objects/ObjectsHandler.cpp
@@ -35,88 +35,88 @@ ObjectsHandler::ObjectsHandler(sol::state* lua, sol::table& parent) :
 	/***
 	Get a moveable by its name.
 	@function GetMoveableByName
-	@tparam string name the unique name of the Moveable as set in, or generated by, Tomb Editor
-	@treturn Moveable a non-owning Moveable referencing the item.
+	@tparam string name The unique name of the moveable as set in, or generated by, Tomb Editor.
+	@treturn Objects.Moveable a non-owning Moveable referencing the item.
 	*/
 	_table_objects.set_function(ScriptReserved_GetMoveableByName, &ObjectsHandler::GetByName, this);
 
 	/***
 	Get a Static by its name.
 	@function GetStaticByName
-	@tparam string name the unique name of the mesh as set in, or generated by, Tomb Editor
-	@treturn Static a non-owning Static referencing the mesh.
+	@tparam string name The unique name of the static mesh as set in, or generated by, Tomb Editor.
+	@treturn Objects.Static a non-owning Static referencing the static mesh.
 	*/
 	_table_objects.set_function(ScriptReserved_GetStaticByName, &ObjectsHandler::GetByName, this);
 
 	/***
 	Get moveables by its slot.
 	@function GetMoveablesBySlot
-	@tparam Objects.ObjID slot the unique slot of the Moveable, e.g. `Objects.ObjID.ANIMATING1`
-	@treturn table table of Moveables referencing the given slot.
+	@tparam Objects.ObjID slot The unique slot of the moveable, e.g. `Objects.ObjID.ANIMATING1`.
+	@treturn table Table of moveables referencing the given slot.
 	*/
 	_table_objects.set_function(ScriptReserved_GetMoveablesBySlot, &ObjectsHandler::GetMoveablesBySlot, this);
 
 	/***
 	Get statics by its slot.
 	@function GetStaticsBySlot
-	@tparam int slot the unique slot of the mesh like 10
-	@treturn table table of Statics referencing the given slot ID.
+	@tparam int slot The unique numerical slot of the static mesh.
+	@treturn table Table of static meshes referencing the given slot.
 	*/
 	_table_objects.set_function(ScriptReserved_GetStaticsBySlot, &ObjectsHandler::GetStaticsBySlot, this);
 
 	/***
 	Get rooms by tag.
 	@function GetRoomsByTag
-	@tparam string tag to select rooms by
-	@treturn table table of Rooms containing the given tag.
+	@tparam string tag Tag to select rooms by.
+	@treturn table Table of rooms containing the given tag.
 	*/
 	_table_objects.set_function(ScriptReserved_GetRoomsByTag, &ObjectsHandler::GetRoomsByTag, this);
 
 	/***
 	Get a Camera by its name.
 	@function GetCameraByName
-	@tparam string name the unique name of the camera as set in, or generated by, Tomb Editor
-	@treturn Camera a non-owning Camera referencing the camera.
+	@tparam string name The unique name of the camera as set in, or generated by, Tomb Editor.
+	@treturn Objects.Camera A non-owning Camera referencing the camera.
 	*/
 	_table_objects.set_function(ScriptReserved_GetCameraByName, &ObjectsHandler::GetByName, this);
 
 	/***
 	Get a Sink by its name.
 	@function GetSinkByName
-	@tparam string name the unique name of the sink as set in, or generated by, Tomb Editor
-	@treturn Sink a non-owning Sink referencing the sink.
+	@tparam string name The unique name of the sink as set in, or generated by, Tomb Editor.
+	@treturn Objects.Sink A non-owning Sink referencing the sink.
 	*/
 	_table_objects.set_function(ScriptReserved_GetSinkByName, &ObjectsHandler::GetByName, this);
 
 	/***
 	Get a SoundSource by its name.
 	@function GetSoundSourceByName
-	@tparam string name the unique name of the sound source as set in, or generated by, Tomb Editor
-	@treturn SoundSource a non-owning SoundSource referencing the sound source.
+	@tparam string name The unique name of the sound source as set in, or generated by, Tomb Editor.
+	@treturn Objects.SoundSource A non-owning SoundSource referencing the sound source.
 	*/
 	_table_objects.set_function(ScriptReserved_GetSoundSourceByName, &ObjectsHandler::GetByName, this);
 
 	/***
 	Get an AIObject by its name.
 	@function GetAIObjectByName
-	@tparam string name the unique name of the AIObject as set in, or generated by, Tomb Editor
-	@treturn AIObject a non-owning SoundSource referencing the AI moveable.
+	@tparam string name The unique name of the AIObject as set in, or generated by, Tomb Editor.
+	@treturn Objects.AIObject A non-owning AIObject referencing the AI object.
 	*/
 	_table_objects.set_function(ScriptReserved_GetAIObjectByName, &ObjectsHandler::GetByName, this);
 
 	/***
 	Get a Volume by its name.
 	@function GetVolumeByName
-	@tparam string name the unique name of the volume as set in, or generated by, Tomb Editor
-	@treturn Volume a non-owning Volume referencing the room.
+	@tparam string name The unique name of the volume as set in, or generated by, Tomb Editor.
+	@treturn Objects.Volume A non-owning Volume referencing the volume.
 	*/
 	_table_objects.set_function(ScriptReserved_GetVolumeByName, &ObjectsHandler::GetByName, this);
 
 	/***
 	Get a Room by its name.
 	@function GetRoomByName
-	@tparam string name the unique name of the room as set in Tomb Editor
-	@treturn Room a non-owning Room referencing the room.
+	@tparam string name The unique name of the room as set in Tomb Editor.
+	@treturn Objects.Room A non-owning Room referencing the room.
 	*/
 	_table_objects.set_function(ScriptReserved_GetRoomByName, &ObjectsHandler::GetByName, this);
 
diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Room/RoomFlags.h b/TombEngine/Scripting/Internal/TEN/Objects/Room/RoomFlags.h
index 71da196e3..9e3caed40 100644
--- a/TombEngine/Scripting/Internal/TEN/Objects/Room/RoomFlags.h
+++ b/TombEngine/Scripting/Internal/TEN/Objects/Room/RoomFlags.h
@@ -11,7 +11,8 @@ Constants for room flag IDs.
 */
 
 /*** Table of Objects.RoomFlagID constants.
-To be used with @{Objects.Room.SetFlag} and @{Objects.Room.GetFlag} functions.
+
      
+Corresponds to room flags in Tomb Editor. To be used with @{Objects.Room.SetFlag} and @{Objects.Room.GetFlag} functions.
 
 The following constants are inside RoomFlagID.
 
diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Room/RoomReverbTypes.h b/TombEngine/Scripting/Internal/TEN/Objects/Room/RoomReverbTypes.h
index 6f27ccff5..d776a520e 100644
--- a/TombEngine/Scripting/Internal/TEN/Objects/Room/RoomReverbTypes.h
+++ b/TombEngine/Scripting/Internal/TEN/Objects/Room/RoomReverbTypes.h
@@ -11,15 +11,15 @@ Constants for room reverb types.
 */
 
 /*** Table of Objects.RoomReverb constants.
-To be used with @{Objects.Room.GetReverbType} and @{Objects.Room.SetReverbType} functions.
-
+
      
+Corresponds to room reverb setting set in Tomb Editor. To be used with @{Objects.Room.GetReverbType} and @{Objects.Room.SetReverbType} functions.
 The following constants are inside RoomReverb.
 
- - OUTSIDE
- - SMALL
- - MEDIUM
- - LARGE
- - PIPE
+ - `OUTSIDE`
+ - `SMALL`
+ - `MEDIUM`
+ - `LARGE`
+ - `PIPE`
 
 @table Objects.RoomReverb
 */
diff --git a/TombEngine/Scripting/Internal/TEN/Objects/SoundSource/SoundSourceObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/SoundSource/SoundSourceObject.cpp
index 54e1b0b27..7b83b8b07 100644
--- a/TombEngine/Scripting/Internal/TEN/Objects/SoundSource/SoundSourceObject.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Objects/SoundSource/SoundSourceObject.cpp
@@ -27,34 +27,34 @@ void SoundSource::Register(sol::table& parent)
 		sol::meta_function::index, IndexError,
 		sol::meta_function::new_index, NewIndexError,
 		
-		/// Get the sound source's position
+		/// Get the sound source's position.
 		// @function SoundSource:GetPosition
-		// @treturn Vec3 a copy of the sound source's position
+		// @treturn Vec3 Sound source's position.
 		ScriptReserved_GetPosition, &SoundSource::GetPos,
 
-		/// Set the sound source's position
+		/// Set the sound source's position.
 		// @function SoundSource:SetPosition
-		// @tparam Vec3 position the new position of the sound source 
+		// @tparam Vec3 position The new position of the sound source.
 		ScriptReserved_SetPosition, &SoundSource::SetPos,
 
-		/// Get the sound source's unique string identifier
+		/// Get the sound source's unique string identifier.
 		// @function SoundSource:GetName
-		// @treturn string the sound source's name
+		// @treturn string The sound source's name.
 		ScriptReserved_GetName, &SoundSource::GetName,
 
-		/// Set the sound source's name (its unique string identifier)
+		/// Set the sound source's unique string identifier.
 		// @function SoundSource:SetName
-		// @tparam string name The sound source's new name
+		// @tparam string name The sound source's new name.
 		ScriptReserved_SetName, &SoundSource::SetName,
 
-		/// Get the sound source's unique int identifier
+		/// Get the sound source's sound ID.
 		// @function SoundSource:GetSoundID
-		// @treturn int the ID of the sound
+		// @treturn int The ID of the sound.
 		ScriptReserved_GetSoundID, &SoundSource::GetSoundID,
 
-		/// Set the sound source's ID 
+		/// Set the sound source's ID.
 		// @function SoundSource:SetSoundID
-		// @tparam int name The sound source's new name
+		// @tparam int name The sound source's new sound ID.
 		ScriptReserved_SetSoundID, &SoundSource::SetSoundID
 	);
 }
diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Static/StaticObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Static/StaticObject.cpp
index c2fd4ddbb..90a1f47de 100644
--- a/TombEngine/Scripting/Internal/TEN/Objects/Static/StaticObject.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Objects/Static/StaticObject.cpp
@@ -119,7 +119,7 @@ namespace TEN::Scripting
 
 	/// Get this static's visibility status.
 	// @function Static:GetActive
-	// @treturn bool Status.  __true: visible__, __false: invisible__
+	// @treturn bool Status. true means visible, false otherwise.
 	bool Static::GetActiveStatus() const
 	{
 		return ((_static.flags & StaticMeshFlags::SM_VISIBLE) != 0);
@@ -127,7 +127,7 @@ namespace TEN::Scripting
 
 	/// Get this static's collision status.
 	// @function Static:GetCollidable
-	// @treturn bool Collision status.  __true: can be collided with__, __false: no collision__
+	// @treturn bool Collision status. true if can be collided with, false otherwise.
 	bool Static::GetCollidable() const
 	{
 		return ((_static.flags & StaticMeshFlags::SM_COLLISION) != 0);
@@ -135,7 +135,7 @@ namespace TEN::Scripting
 
 	/// Get this static's solid collision status.
 	// @function Static:GetSolid
-	// @treturn bool Solid Status. __true: solid__, __false: soft__
+	// @treturn bool Solid Status. true if solid, false if soft.
 	bool Static::GetSolidStatus() const
 	{
 		return ((_static.flags & StaticMeshFlags::SM_SOLID) != 0);
@@ -216,7 +216,7 @@ namespace TEN::Scripting
 
 	/// Set this static's solid collision status.
 	// @function Static:SetSolid
-	// @tparam bool status New status. __true: solid__, __false: soft__
+	// @tparam bool status New status, true is solid, false is soft.
 	void Static::SetSolidStatus(bool status)
 	{
 		if (status)
@@ -231,7 +231,7 @@ namespace TEN::Scripting
 
 	/// Set this static's collision status.
 	// @function Static:SetCollidable
-	// @tparam bool collidable New collision status. __true: can be collided with__, __false: no collision__
+	// @tparam bool collidable New collision status. true if can be collided with, false: no collision.
 	void Static::SetCollidable(bool collidable)
 	{
 		if (collidable)
diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Volume/VolumeObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Volume/VolumeObject.cpp
index 08d4a87cf..4e3f765d4 100644
--- a/TombEngine/Scripting/Internal/TEN/Objects/Volume/VolumeObject.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Objects/Volume/VolumeObject.cpp
@@ -49,7 +49,7 @@ void Volume::Register(sol::table& parent)
 }
 
 /// Get the unique string identifier of this volume.
-// @function Volume:GetName()
+// @function Volume:GetName
 // @treturn string Name.
 std::string Volume::GetName() const
 {
@@ -57,7 +57,7 @@ std::string Volume::GetName() const
 }
 
 /// Get the position of this volume.
-// @function Volume:GetPosition()
+// @function Volume:GetPosition
 // @treturn Vec3 Position.
 Vec3 Volume::GetPos() const
 {
@@ -65,7 +65,7 @@ Vec3 Volume::GetPos() const
 }
 
 /// Get the rotation of this volume.
-// @function Volume:GetRotation()
+// @function Volume:GetRotation
 // @treturn Rotation Rotation.
 Rotation Volume::GetRot() const
 {
@@ -74,7 +74,7 @@ Rotation Volume::GetRot() const
 }
 
 /// Get this scale of this volume.
-// @function Volume:GetScale()
+// @function Volume:GetScale
 // @treturn Vec3 Scale.
 Vec3 Volume::GetScale() const
 {
@@ -82,7 +82,7 @@ Vec3 Volume::GetScale() const
 }
 
 /// Set the unique string identifier of this volume.
-// @function Volume:SetName()
+// @function Volume:SetName
 // @tparam string name New name.
 void Volume::SetName(const std::string& name)
 {
@@ -103,7 +103,7 @@ void Volume::SetName(const std::string& name)
 }
 
 /// Set the position of this volume.
-// @function Volume:SetPosition()
+// @function Volume:SetPosition
 // @tparam Vec3 pos New position.
 void Volume::SetPos(const Vec3& pos)
 {
@@ -112,7 +112,7 @@ void Volume::SetPos(const Vec3& pos)
 }
 
 /// Set the rotation of this volume.
-// @function Volume:SetRotation()
+// @function Volume:SetRotation
 // @tparam Rotation rot New rotation.
 void Volume::SetRot(const Rotation& rot)
 {
@@ -121,7 +121,7 @@ void Volume::SetRot(const Rotation& rot)
 }
 
 /// Set the scale of the volume.
-// @function Volume:SetScale()
+// @function Volume:SetScale
 // @tparam Vec3 scale New scale.
 void Volume::SetScale(const Vec3& scale)
 {
@@ -130,7 +130,7 @@ void Volume::SetScale(const Vec3& scale)
 }
 
 /// Determine if this volume is active.
-// @function Volume:GetActive()
+// @function Volume:GetActive
 // @treturn bool Boolean representing active status.
 bool Volume::GetActive() const
 {
@@ -138,8 +138,8 @@ bool Volume::GetActive() const
 }
 
 /// Determine if a moveable is inside this volume.
-// @function Volume:IsMoveableInside()
-// @tparam Objects.Moveable Moveable to be checked for containment.
+// @function Volume:IsMoveableInside
+// @tparam Objects.Moveable moveable Moveable to be checked for containment.
 // @treturn bool Boolean representing containment status.
 bool Volume::IsMoveableInside(const Moveable& mov)
 {
@@ -159,14 +159,14 @@ bool Volume::IsMoveableInside(const Moveable& mov)
 }
 
 /// Enable this volume.
-// @function Volume:Enable()
+// @function Volume:Enable
 void Volume::Enable()
 {
 	_volume.Enabled = true;
 }
 
 /// Disable this volume.
-// @function Volume:Disable()
+// @function Volume:Disable
 void Volume::Disable()
 {
 	ClearActivators();
@@ -174,7 +174,7 @@ void Volume::Disable()
 }
 
 /// Clear the activators for this volume, allowing it to trigger again.
-// @function Volume:ClearActivators()
+// @function Volume:ClearActivators
 void Volume::ClearActivators()
 {
 	_volume.StateQueue.clear();
diff --git a/TombEngine/Scripting/Internal/TEN/Sound/SoundHandler.cpp b/TombEngine/Scripting/Internal/TEN/Sound/SoundHandler.cpp
index 7f52d9c55..8d55ba0aa 100644
--- a/TombEngine/Scripting/Internal/TEN/Sound/SoundHandler.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Sound/SoundHandler.cpp
@@ -87,7 +87,7 @@ namespace TEN::Scripting::Sound
 
 	/// Check if the audio track is playing.
 	// @function IsAudioTrackPlaying
-	// @tparam string Track Filename to check. Should be without extension and without full directory path.
+	// @tparam string track Filename to check. Should be without extension and without full directory path.
 	static bool IsAudioTrackPlaying(const std::string& trackName)
 	{
 		return Sound_TrackIsPlaying(trackName);
diff --git a/TombEngine/Scripting/Internal/TEN/Sound/SoundTrackTypes.h b/TombEngine/Scripting/Internal/TEN/Sound/SoundTrackTypes.h
index 4ae631d98..0b8c79d8a 100644
--- a/TombEngine/Scripting/Internal/TEN/Sound/SoundTrackTypes.h
+++ b/TombEngine/Scripting/Internal/TEN/Sound/SoundTrackTypes.h
@@ -11,9 +11,9 @@ Constants for the type of the audio tracks.
 * 
 To be used with sound track functions, such as @{Sound.PlayAudioTrack} and @{Sound.StopAudioTrack}.
 
- - `ONESHOT` - used for one-time music tracks.
- - `LOOPED` - used for looped ambience or music.
- - `VOICE` - used for dialogs. Also supports subtitles, set by @{Sound.GetCurrentSubtitle} function.
+ - `ONESHOT` - Used for one-time music tracks.
+ - `LOOPED` - Used for looped ambience or music.
+ - `VOICE` - Used for dialogs. Also supports subtitles, set by @{Sound.GetCurrentSubtitle} function.
 
 @table Sound.SoundTrackType
 */
diff --git a/TombEngine/Scripting/Internal/TEN/Strings/DisplayString/DisplayString.cpp b/TombEngine/Scripting/Internal/TEN/Strings/DisplayString/DisplayString.cpp
index fa883f704..4b2fb412c 100644
--- a/TombEngine/Scripting/Internal/TEN/Strings/DisplayString/DisplayString.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Strings/DisplayString/DisplayString.cpp
@@ -47,13 +47,12 @@ DisplayString::DisplayString()
 For use in @{Strings.ShowString|ShowString} and @{Strings.HideString|HideString}.
 @function DisplayString
 @tparam string string The string to display or key of the translated string.
-@tparam Vec2 Position of the string in pixel coordinates.
-@tparam[opt] float scale size of the string, relative to the default size. __Default: 1.0__
-@tparam[opt] Color color the color of the text. __Default: white__
-@tparam[opt] bool translated If false or omitted, the input string argument will be displayed.
-If true, the string argument will be the key of a translated string specified in strings.lua. __Default: false__.
-@tparam Strings.DisplayStringOption table
-__Default: None.__ _Please note that Strings are automatically aligned to the LEFT_
+@tparam Vec2 position Position of the string in pixel coordinates.
+@tparam[opt=1] float scale Size of the string, relative to the default size.
+@tparam[opt=Color(255, 255, 255)] Color color The color of the text.
+@tparam[opt=false] bool translated If false or omitted, the input string argument will be displayed.
+If true, the string argument will be the key of a translated string specified in strings.lua.
+@tparam[opt] Strings.DisplayStringOption flags Flags which affect visual representation of a string, such as shadow or alignment.
 @treturn DisplayString A new DisplayString object.
 */
 static std::unique_ptr CreateString(const std::string& key, const Vec2& pos, TypeOrNil scale, TypeOrNil color,
@@ -140,55 +139,51 @@ void DisplayString::Register(sol::table& parent)
 		ScriptReserved_DisplayString,
 		sol::call_constructor, &DisplayStringWrapper,
 
-		/// Get the display string's color
+		/// Get the display string's color.
 		// @function DisplayString:GetColor
-		// @treturn Color a copy of the display string's color
+		// @treturn Color Display string's color.
 		ScriptReserved_GetColor, &DisplayString::GetColor,
 
-		/// Set the display string's color 
+		/// Set the display string's color.
 		// @function DisplayString:SetColor
-		// @tparam Color color the new color of the display string 
+		// @tparam Color color The new color of the display string.
 		ScriptReserved_SetColor, &DisplayString::SetColor,
 
-		/// Get the string key to use. If `isTranslated` is true when @{DisplayString}
-		// is called, this will be the string key for the translation that will be displayed.
-		// If false or omitted, this will be the string that's displayed.
-		// @function DisplayString:GetKey()
-		// @treturn string the string to use
+		/// Get the string key.
+		// @function DisplayString:GetKey
+		// @treturn string The string key.
 		ScriptReserved_GetKey, &DisplayString::GetKey, 
 
-		/// Set the string key to use. If `isTranslated` is true when @{DisplayString}
-		// is called, this will be the string key for the translation that will be displayed.
-		// If false or omitted, this will be the string that's displayed.
-		// @function DisplayString:SetKey()
-		// @tparam string string the new key for the display string 
+		/// Set the string key to use.
+		// @function DisplayString:SetKey
+		// @tparam string key The new key for the display string.
 		ScriptReserved_SetKey, &DisplayString::SetKey, 
 
 		/// Set the scale of the string.
-		// @function DisplayString:SetScale()
+		// @function DisplayString:SetScale
 		// @tparam float scale New scale of the string relative to the default size.
 		ScriptReserved_SetScale, &DisplayString::SetScale,
 
 		/// Get the scale of the string.
-		// @function DisplayString:GetScale()
+		// @function DisplayString:GetScale
 		// @treturn float Scale.
 		ScriptReserved_GetScale, &DisplayString::GetScale,
 
 		/// Set the position of the string.
 		// Screen-space coordinates are expected.
-		// @function DisplayString:SetPosition()
+		// @function DisplayString:SetPosition
 		// @tparam Vec2 pos New position in pixel coordinates.
 		ScriptReserved_SetPosition, &DisplayString::SetPosition,
 
 		/// Get the position of the string.
 		// Screen-space coordinates are returned.
-		// @function DisplayString:GetPosition()
+		// @function DisplayString:GetPosition
 		// @treturn Vec2 pos Position in pixel coordinates.
 		ScriptReserved_GetPosition, &DisplayString::GetPosition,
 
-		/// Set the display string's flags 
-		// @function DisplayString:SetFlags()
-		// @tparam table table the new table with display flags options
+		/// Set the display string's flags.
+		// @function DisplayString:SetFlags
+		// @tparam table table The new table with display flags options.
 		// @usage
 		// local varDisplayString = DisplayString('example string', 0, 0, Color(255, 255, 255), false)
 		// possible values:
@@ -200,10 +195,7 @@ void DisplayString::Register(sol::table& parent)
 		// varDisplayString:SetFlags{ TEN.Strings.DisplayStringOption.CENTER }
 		ScriptReserved_SetFlags, &DisplayString::SetFlags,
 
-		/// Set translated parameter of the string
-		// @function DisplayString:SetTranslated
-		// @tparam bool shouldTranslate if true, the string's key will be used as the key for the translation that will be displayed.
-		// If false, the key itself will be displayed
+		// DEPRECATED
 		ScriptReserved_SetTranslated, &DisplayString::SetTranslated);
 }
 
diff --git a/TombEngine/Scripting/Internal/TEN/Strings/DisplayString/DisplayString.h b/TombEngine/Scripting/Internal/TEN/Strings/DisplayString/DisplayString.h
index 7d2497850..871de86ec 100644
--- a/TombEngine/Scripting/Internal/TEN/Strings/DisplayString/DisplayString.h
+++ b/TombEngine/Scripting/Internal/TEN/Strings/DisplayString/DisplayString.h
@@ -17,10 +17,10 @@ Constants for Display String Options.
 /*** Strings.DisplayStringOption constants. To be used with @{Strings.DisplayString} class.
 @table Strings.DisplayStringOption
 
- - `CENTER` - set the horizontal origin point to the center of the string.
- - `RIGHT` - set the horizontal origin point to right of the string.
- - `SHADOW` - gives the string a small drop shadow.
- - `BLINK` - blinks the string
+ - `CENTER` - Set the horizontal origin point to the center of the string.
+ - `RIGHT` - Set the horizontal origin point to right of the string.
+ - `SHADOW` - Gives the string a small drop shadow.
+ - `BLINK` - Blinks the string.
 */
 
 enum class DisplayStringOptions
diff --git a/TombEngine/Scripting/Internal/TEN/Strings/StringsHandler.cpp b/TombEngine/Scripting/Internal/TEN/Strings/StringsHandler.cpp
index e2db6fd0a..55174cb68 100644
--- a/TombEngine/Scripting/Internal/TEN/Strings/StringsHandler.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Strings/StringsHandler.cpp
@@ -21,31 +21,26 @@ StringsHandler::StringsHandler(sol::state* lua, sol::table& parent) :
 
 /***
 Show some text on-screen.
-@tparam DisplayString str the string object to draw
 @function ShowString
-@tparam float time the time in seconds for which to show the string.
-If not given, the string will have an "infinite" life, and will show
+@tparam DisplayString string The string object to draw.
+@tparam[opt] float time The time in seconds for which to show the string. If not given, the string will have an "infinite" life, and will show
 until @{HideString} is called or until the level is finished.
-Default: nil (i.e. infinite)
-@tparam bool autoDelete should be string automatically deleted after timeout is reached.
-If not given, the string will remain allocated even after timeout is reached, and can be
-shown again without re-initialization.
-Default: true
+@tparam[opt=true] bool autoDelete Should be string automatically deleted after timeout is reached. If not given, the string will remain
+allocated even after timeout is reached, and can be shown again without re-initialization.
 */
 	table.set_function(ScriptReserved_ShowString, &StringsHandler::ShowString, this);
 
 /***
 Hide some on-screen text.
 @function HideString
-@tparam DisplayString str the string object to hide. Must previously have been shown
-with a call to @{ShowString}, or this function will have no effect.
+@tparam DisplayString string The string object to hide. Must previously have been shown with a call to @{ShowString}, or this function will have no effect.
 */
 	table.set_function(ScriptReserved_HideString, [this](const DisplayString& string) { ShowString(string, 0.0f, false); });
 
 /***
 Checks if the string is shown
 @function IsStringDisplaying
-@tparam DisplayString str the string object to be checked
+@tparam DisplayString string The string object to be checked.
 @treturn bool true if it is shown, false if it is hidden
 */
 	table.set_function(ScriptReserved_IsStringDisplaying, &StringsHandler::IsStringDisplaying, this);
diff --git a/TombEngine/Scripting/Internal/TEN/Types/Color/Color.cpp b/TombEngine/Scripting/Internal/TEN/Types/Color/Color.cpp
index 6e6037236..64e38caa6 100644
--- a/TombEngine/Scripting/Internal/TEN/Types/Color/Color.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Types/Color/Color.cpp
@@ -37,9 +37,9 @@ namespace TEN::Scripting::Types
 			"a", sol::property(&ScriptColor::GetA, &ScriptColor::SetA));
 	}
 
-	/// @int R red component
-	// @int G green component
-	// @int B blue component
+	/// @int R Red component.
+	// @int G Green component.
+	// @int B Blue component.
 	// @treturn Color A new Color object.
 	// @function Color
 	ScriptColor::ScriptColor(byte r, byte g, byte b) :
diff --git a/TombEngine/Scripting/Internal/TEN/Util/Util.cpp b/TombEngine/Scripting/Internal/TEN/Util/Util.cpp
index 851252605..9999ddd0d 100644
--- a/TombEngine/Scripting/Internal/TEN/Util/Util.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Util/Util.cpp
@@ -26,13 +26,12 @@ namespace TEN::Scripting::Util
 	// @tentable Util
 	// @pragma nostrip
 
-	/// Determine if there is a clear line of sight between two positions.
-	// NOTE: Limited to room geometry. Objects are ignored.
-	// @function HasLineOfSight()
+	/// Determine if there is a clear line of sight between two positions. Limited to room geometry. Objects are ignored.
+	// @function HasLineOfSight
 	// @tparam float roomID Room ID of the first position's room.
 	// @tparam Vec3 posA First position.
 	// @tparam Vec3 posB Second position.
-	// @treturn bool __true__ if there is a line of sight, __false__ if not.
+	// @treturn bool true if there is a line of sight, false if not.
 	// @usage
 	// local flamePlinthPos = flamePlinth:GetPosition() + Vec3(0, flamePlinthHeight, 0);
 	// print(Misc.HasLineOfSight(enemyHead:GetRoomNumber(), enemyHead:GetPosition(), flamePlinthPos))
@@ -122,7 +121,7 @@ namespace TEN::Scripting::Util
 
 	/// Pick a moveable by the given display position.
 	// @function PickMoveableByDisplayPosition
-	// @tparam Vec2 Display space position in percent.
+	// @tparam Vec2 position Display space position in percent.
 	// @treturn Objects.Moveable Picked moveable (nil if no moveable was found under the cursor).
 	static sol::optional > PickMoveable(const Vec2& screenPos)
 	{
@@ -140,7 +139,7 @@ namespace TEN::Scripting::Util
 
 	/// Pick a static mesh by the given display position.
 	// @function PickStaticByDisplayPosition
-	// @tparam Vec2 Display space position in percent.
+	// @tparam Vec2 position Display space position in percent.
 	// @treturn Objects.Static Picked static mesh (nil if no static mesh was found under the cursor).
 	static sol::optional > PickStatic(const Vec2& screenPos)
 	{
@@ -165,9 +164,9 @@ namespace TEN::Scripting::Util
 	//
 	//debug.traceback
 	//@function PrintLog
-	//@tparam string message to be displayed within the Log
-	//@tparam Util.LogLevel logLevel log level to be displayed
-	//@tparam[opt] bool allowSpam true allows spamming of the message
+	//@tparam string Message to be displayed within the log.
+	//@tparam Util.LogLevel logLevel Log level to be displayed.
+	//@tparam[opt] bool allowSpam If true, allows continuous spamming of the message.
 	// 
 	//@usage
 	//PrintLog('test info log', LogLevel.INFO)
diff --git a/TombEngine/Scripting/Internal/TEN/View/CameraTypes.h b/TombEngine/Scripting/Internal/TEN/View/CameraTypes.h
index abeb58748..e288ab9f8 100644
--- a/TombEngine/Scripting/Internal/TEN/View/CameraTypes.h
+++ b/TombEngine/Scripting/Internal/TEN/View/CameraTypes.h
@@ -21,13 +21,13 @@ enum class ScriptCameraType
 /*** Table of View.CameraType constants. To be used with @{View.GetCameraType} function.
 @table CameraType
 
- - `NORMAL` - standard in-game camera when weapons are holstered.
- - `COMBAT` - in-game camera when weapons are unholstered.
- - `FIXED` - classic fixed camera.
- - `LOOK` - look camera.
- - `FLYBY` - flyby or tracking camera.
- - `BINOCULARS` - binoculars is active.
- - `LASERSIGHT` - lasersight is active.
+ - `NORMAL` - Standard in-game camera when weapons are holstered.
+ - `COMBAT` - In-game camera when weapons are unholstered.
+ - `FIXED` - Classic fixed camera.
+ - `LOOK` - Look camera.
+ - `FLYBY` - Flyby or tracking camera.
+ - `BINOCULARS` - Binocular camera.
+ - `LASERSIGHT` - Lasersight camera.
 */
 
 static const std::unordered_map CAMERA_TYPE
diff --git a/TombEngine/Scripting/Internal/TEN/View/DisplaySprite/ScriptDisplaySprite.cpp b/TombEngine/Scripting/Internal/TEN/View/DisplaySprite/ScriptDisplaySprite.cpp
index b87db6387..986ab94c9 100644
--- a/TombEngine/Scripting/Internal/TEN/View/DisplaySprite/ScriptDisplaySprite.cpp
+++ b/TombEngine/Scripting/Internal/TEN/View/DisplaySprite/ScriptDisplaySprite.cpp
@@ -52,12 +52,12 @@ namespace TEN::Scripting::DisplaySprite
 
 	/// Create a DisplaySprite object.
 	// @function DisplaySprite
-	// @tparam Objects.ObjID.SpriteConstants ID of the sprite sequence object.
-	// @tparam int int spriteID ID of the sprite in the sequence.
+	// @tparam Objects.ObjID.SpriteConstants objectID ID of the sprite sequence object.
+	// @tparam int index Index of the sprite in the sequence.
 	// @tparam Vec2 pos Display position in percent.
 	// @tparam float rot Rotation in degrees.
 	// @tparam Vec2 scale Horizontal and vertical scale in percent. Scaling is interpreted by the DisplaySpriteEnum.ScaleMode passed to the Draw() function call.
-	// @tparam[opt] Color color Color. __Default: Color(255, 255, 255, 255)__
+	// @tparam[opt=Color(255, 255, 255)] Color color Color.
 	// @treturn DisplaySprite A new DisplaySprite object.
 	ScriptDisplaySprite::ScriptDisplaySprite(GAME_OBJECT_ID objectID, int spriteID, const Vec2& pos, float rot, const Vec2& scale, const ScriptColor& color)
 	{
@@ -98,7 +98,7 @@ namespace TEN::Scripting::DisplaySprite
 	}
 
 	/// Get the object ID of the sprite sequence object used by the display sprite.
-	// @function DisplaySprite:GetObjectID()
+	// @function DisplaySprite:GetObjectID
 	// @treturn Objects.ObjID.SpriteConstants Sprite sequence object ID.
 	GAME_OBJECT_ID ScriptDisplaySprite::GetObjectID() const
 	{
@@ -106,7 +106,7 @@ namespace TEN::Scripting::DisplaySprite
 	}
 
 	/// Get the sprite ID in the sprite sequence object used by the display sprite.
-	// @function DisplaySprite:GetSpriteID()
+	// @function DisplaySprite:GetSpriteID
 	// @treturn int Sprite ID in the sprite sequence object. Value __-1__ means that it is a background video, played using @{View.PlayVideo}.
 	int ScriptDisplaySprite::GetSpriteID() const
 	{
@@ -114,7 +114,7 @@ namespace TEN::Scripting::DisplaySprite
 	}
 
 	/// Get the display position of the display sprite in percent.
-	// @function DisplaySprite:GetPosition()
+	// @function DisplaySprite:GetPosition
 	// @treturn Vec2 Display position in percent.
 	Vec2 ScriptDisplaySprite::GetPosition() const
 	{
@@ -122,7 +122,7 @@ namespace TEN::Scripting::DisplaySprite
 	}
 
 	/// Get the rotation of the display sprite in degrees.
-	// @function DisplaySprite:GetRotation()
+	// @function DisplaySprite:GetRotation
 	// @treturn float Rotation in degrees.
 	float ScriptDisplaySprite::GetRotation() const
 	{
@@ -130,7 +130,7 @@ namespace TEN::Scripting::DisplaySprite
 	}
 
 	/// Get the horizontal and vertical scale of the display sprite in percent.
-	// @function DisplaySprite:GetScale()
+	// @function DisplaySprite:GetScale
 	// @treturn Vec2 Horizontal and vertical scale in percent.
 	Vec2 ScriptDisplaySprite::GetScale() const
 	{
@@ -138,7 +138,7 @@ namespace TEN::Scripting::DisplaySprite
 	}
 
 	/// Get the color of the display sprite.
-	// @function DisplaySprite:GetColor()
+	// @function DisplaySprite:GetColor
 	// @treturn Color Color.
 	ScriptColor ScriptDisplaySprite::GetColor() const
 	{
@@ -146,48 +146,48 @@ namespace TEN::Scripting::DisplaySprite
 	}
 
 	/// Set the sprite sequence object ID used by the display sprite.
-	// @function DisplaySprite:SetObjectID(Objects.ObjID.SpriteConstants)
-	// @tparam Objects.ObjID.SpriteConstants New sprite sequence object ID.
+	// @function DisplaySprite:SetObjectID
+	// @tparam Objects.ObjID.SpriteConstants objectID New sprite sequence object ID.
 	void ScriptDisplaySprite::SetObjectID(GAME_OBJECT_ID objectID)
 	{
 		_objectID = objectID;
 	}
 
 	/// Set the sprite ID in the sprite sequence object used by the display sprite.
-	// @function DisplaySprite:SetSpriteID(int)
-	// @tparam int New sprite ID in the sprite sequence object.
+	// @function DisplaySprite:SetSpriteID
+	// @tparam int spriteID New sprite ID in the sprite sequence object.
 	void ScriptDisplaySprite::SetSpriteID(int spriteID)
 	{
 		_spriteID = spriteID;
 	}
 
 	/// Set the display position of the display sprite in percent.
-	// @function DisplaySprite:SetPosition(Vec2)
-	// @tparam Vec2 New display position in percent.
+	// @function DisplaySprite:SetPosition
+	// @tparam Vec2 position New display position in percent.
 	void ScriptDisplaySprite::SetPosition(const Vec2& pos)
 	{
 		_position = pos;
 	}
 
 	/// Set the rotation of the display sprite in degrees.
-	// @function DisplaySprite:SetRotation(float)
-	// @tparam float New rotation in degrees.
+	// @function DisplaySprite:SetRotation
+	// @tparam float rotation New rotation in degrees.
 	void ScriptDisplaySprite::SetRotation(float rot)
 	{
 		_rotation = rot;
 	}
 
 	/// Set the horizontal and vertical scale of the display sprite in percent.
-	// @function DisplaySprite:SetScale(Vec2)
-	// @tparam float New horizontal and vertical scale in percent.
+	// @function DisplaySprite:SetScale
+	// @tparam float scale New horizontal and vertical scale in percent.
 	void ScriptDisplaySprite::SetScale(const Vec2& scale)
 	{
 		_scale = scale;
 	}
 
 	/// Set the color of the display sprite.
-	// @function DisplaySprite:SetColor(Color)
-	// @tparam float New color.
+	// @function DisplaySprite:SetColor
+	// @tparam Color color New color.
 	void ScriptDisplaySprite::SetColor(const ScriptColor& color)
 	{
 		_color = color;
@@ -195,10 +195,10 @@ namespace TEN::Scripting::DisplaySprite
 
 	/// Draw the display sprite in display space for the current frame.
 	// @function DisplaySprite:Draw
-	// @tparam[opt] int priority Draw priority. Can be thought of as a layer, with higher values having precedence. __Default: 0__
-	// @tparam[opt] View.AlignMode alignMode Align mode interpreting an offset from the sprite's position. __Default: View.AlignMode.CENTER__
-	// @tparam[opt] View.ScaleMode scaleMode Scale mode interpreting the display sprite's horizontal and vertical scale. __Default: View.ScaleMode.FIT__
-	// @tparam[opt] Effects.BlendID blendMode Blend mode. __Default: Effects.BlendID.ALPHABLEND__
+	// @tparam[opt=0] int priority Draw priority. Can be thought of as a layer, with higher values having precedence.
+	// @tparam[opt=View.AlignMode.CENTER] View.AlignMode alignMode Align mode interpreting an offset from the sprite's position.
+	// @tparam[opt=View.ScaleMode.FIT] View.ScaleMode scaleMode Scale mode interpreting the display sprite's horizontal and vertical scale.
+	// @tparam[opt=Effects.BlendID.ALPHABLEND] Effects.BlendID blendMode Blend mode.
 	void ScriptDisplaySprite::Draw(sol::optional priority, sol::optional alignMode,
 								   sol::optional scaleMode, sol::optional blendMode)
 	{
diff --git a/TombEngine/Scripting/Internal/TEN/View/ScaleModes.h b/TombEngine/Scripting/Internal/TEN/View/ScaleModes.h
index 605002855..d722f67b4 100644
--- a/TombEngine/Scripting/Internal/TEN/View/ScaleModes.h
+++ b/TombEngine/Scripting/Internal/TEN/View/ScaleModes.h
@@ -15,9 +15,9 @@ namespace TEN::Scripting::View
 
 	/// Table of View.ScaleMode constants. To be used with @{View.DisplaySprite} class.
 	// 
-	// - `FIT`
-	// - `FILL`
-	// - `STRETCH`
+	// - `FIT` - Image will proportionally fit the whole image into the sprite surface.
+	// - `FILL` - Image will scale up proportionally and crop to fill all sprite surface.
+	// - `STRETCH` - Image will stretch according to sprite dimensions, not taking aspect ratio into consideration.
 	// 
 	// @table View.ScaleMode
 
diff --git a/TombEngine/Scripting/Internal/TEN/View/ViewHandler.cpp b/TombEngine/Scripting/Internal/TEN/View/ViewHandler.cpp
index 2f59dab1f..b889a8274 100644
--- a/TombEngine/Scripting/Internal/TEN/View/ViewHandler.cpp
+++ b/TombEngine/Scripting/Internal/TEN/View/ViewHandler.cpp
@@ -224,37 +224,37 @@ namespace TEN::Scripting::View
 
 		///Do a full-screen fade-in from black.
 		//@function FadeIn
-		//@tparam float speed (default 1.0). Speed in units per second. A value of 1 will make the fade take one second.
+		//@tparam[opt=1] float speed Speed in units per second. A value of 1 will make the fade take one second.
 		tableView.set_function(ScriptReserved_FadeIn, &FadeIn);
 
 		///Do a full-screen fade-to-black. The screen will remain black until a call to FadeIn.
 		//@function FadeOut
-		//@tparam float speed (default 1.0). Speed in units per second. A value of 1 will make the fade take one second.
+		//@tparam[opt=1] float speed Speed in units per second. A value of 1 will make the fade take one second.
 		tableView.set_function(ScriptReserved_FadeOut, &FadeOut);
 
 		///Check if fade out is complete and screen is completely black.
-		//@treturn bool state of the fade out
+		//@treturn bool State of the fade out.
 		tableView.set_function(ScriptReserved_FadeOutComplete, &FadeOutComplete);
 
 		///Move black cinematic bars in from the top and bottom of the game window.
 		//@function SetCineBars
-		//@tparam float height (default 30). Percentage of the screen to be covered
-		//@tparam float speed (default 30). Coverage percent per second
+		//@tparam[opt=30] float height Percentage of the screen to be covered.
+		//@tparam[opt=30] float speed Coverage percent per second.
 		tableView.set_function(ScriptReserved_SetCineBars, &SetCineBars);
 
 		///Set field of view.
 		//@function SetFOV
-		//@tparam float angle in degrees (clamped to [10, 170])
+		//@tparam float angle Angle in degrees (clamped to [10, 170]).
 		tableView.set_function(ScriptReserved_SetFOV, &SetFOV);
 
 		///Get field of view.
 		//@function GetFOV
-		//@treturn float current FOV angle in degrees
+		//@treturn float Current FOV angle in degrees.
 		tableView.set_function(ScriptReserved_GetFOV, &GetFOV);
 
 		///Shows the mode of the game camera.
 		//@function GetCameraType
-		//@treturn View.CameraType value used by the Main Camera.
+		//@treturn View.CameraType Value used by the game camera.
 		//@usage
 		//LevelFuncs.OnLoop = function() 
 		//	if (View.GetCameraType() == CameraType.COMBAT) then
@@ -265,27 +265,27 @@ namespace TEN::Scripting::View
 
 		///Gets current camera position.
 		//@function GetCameraPosition
-		//@treturn Vec3 current camera position
+		//@treturn Vec3 Current camera position.
 		tableView.set_function(ScriptReserved_GetCameraPosition, &GetCameraPosition);
 
 		///Gets current camera target.
 		//@function GetCameraTarget
-		//@treturn Vec3 current camera target
+		//@treturn Vec3 Current camera target.
 		tableView.set_function(ScriptReserved_GetCameraTarget, &GetCameraTarget);
 
 		///Gets current room where camera is positioned.
 		//@function GetCameraRoom
-		//@treturn Objects.Room current room of the camera
+		//@treturn Objects.Room Current room of the camera.
 		tableView.set_function(ScriptReserved_GetCameraRoom, &GetCameraRoom);
 
 		///Sets the post-process effect mode, like negative or monochrome.
 		//@function SetPostProcessMode
-		//@tparam View.PostProcessMode effect type to set.
+		//@tparam View.PostProcessMode effect Effect type to set.
 		tableView.set_function(ScriptReserved_SetPostProcessMode, &SetPostProcessMode);
 
 		///Sets the post-process effect strength.
 		//@function SetPostProcessStrength
-		//@tparam float strength (default 1.0). How strong the effect is.
+		//@tparam[opt=1] float strength How strong the effect is.
 		tableView.set_function(ScriptReserved_SetPostProcessStrength, &SetPostProcessStrength);
 
 		///Sets the post-process tint.
@@ -295,11 +295,11 @@ namespace TEN::Scripting::View
 
 		/// Play a video file. File should be placed in the `FMV` folder.
 		// @function PlayVideo
-		// @tparam string fileName Video file name.  Can be provided without extension, if type is mp4, mkv or avi.
-		// @tparam[opt] bool background (default: false). Play video in the background mode.
+		// @tparam string fileName Video file name.  Can be provided without extension, if type is mp4, mkv, mov or avi.
+		// @tparam[opt=false] bool background Play video in the background mode.
 		// In such case, video won't play in fullscreen, but must be shown using special animated texture type in Tomb Editor, or using @{View.DisplaySprite}.
-		// @tparam[opt] bool silent (default: false). Play video without sound.
-		// @tparam[opt] bool loop (default: false). Play video in a loop.
+		// @tparam[opt=false] bool silent Play video without sound.
+		// @tparam[opt=false] bool loop Play video in a loop.
 		tableView.set_function(ScriptReserved_PlayVideo, &PlayVideo);
 
 		/// Stop the currently playing video. Only possible if video is playing in the background mode.
@@ -354,8 +354,8 @@ namespace TEN::Scripting::View
 
 		/// Flash screen.
 		//@function FlashScreen
-		//@tparam Color color (default Color(255, 255, 255))
-		//@tparam float speed (default 1.0). Speed in units per second. Value of 1 will make flash take one second. Clamped to [0.005, 1.0].
+		//@tparam[opt=Color(255, 255, 255)] Color color Color.
+		//@tparam[opt=1] float speed Speed in units per second. Value of 1 will make flash take one second. Clamped to [0.005, 1.0].
 		tableView.set_function(ScriptReserved_FlashScreen, &FlashScreen);
 
 		/// Get the display resolution's aspect ratio.

From 469d45fb78b4e633fb5a15810741a9241711e9c0 Mon Sep 17 00:00:00 2001
From: Lwmte <3331699+Lwmte@users.noreply.github.com>
Date: Sun, 20 Apr 2025 21:46:13 +0200
Subject: [PATCH 154/160] Update CHANGELOG.md

---
 CHANGELOG.md | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4973d3ee7..2fa1b78d9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor):
 
 ## New features
 * Added video playback support.
+* Added muzzle glow effect for firearms.
 
 ### Bug fixes
 * Fixed crashes when shooting, if gunflash or gunshell objects are not present in a level.
@@ -19,9 +20,6 @@ TombEngine releases are located in this repository (alongside with Tomb Editor):
 * Fixed HK sound effects.
 * Fixed SSAO incorrectly applied through alpha blended textures.
 
-### New features
-* Added muzzle glow effect for firearms.
-
 ### Lua API changes
 * Added `View.PlayVideoFile` function to play videos.
 * Added `Flow.SetIntroVideoPath` function to specify intro video.

From 6167fb9661c649cd1fe3302facd458c2a07fcb15 Mon Sep 17 00:00:00 2001
From: Lwmte <3331699+Lwmte@users.noreply.github.com>
Date: Sun, 20 Apr 2025 23:56:22 +0300
Subject: [PATCH 155/160] Bone weights and joint fixes (#1632)

* Initial commit

* Update CHANGELOG.md

* Debranch quaternion conversions

* Use slerp for blending, do not blend unless specified explicitly

* Update ItemBuffer.h

* Don't use slerp, as it's causing more artifacts

* Use MAX_BONE_WEIGHTS in C++ code too

* Remove unnecessary bone index assignment
---
 CHANGELOG.md                                  |   5 +-
 .../Renderer/ConstantBuffers/ItemBuffer.h     |   1 +
 .../Renderer/Graphics/Vertices/Vertex.h       |  13 ++-
 TombEngine/Renderer/RendererCompatibility.cpp |  21 +++-
 TombEngine/Renderer/RendererDraw.cpp          |   3 +
 TombEngine/Renderer/RendererEnums.h           |   1 +
 TombEngine/Renderer/RendererInit.cpp          |  33 +++---
 TombEngine/Renderer/RendererLara.cpp          |   2 +
 .../Renderer/Structures/RendererHudBar.h      |   4 -
 TombEngine/Shaders/CBItem.hlsli               |  18 +++
 TombEngine/Shaders/GBuffer.fx                 |  14 +--
 TombEngine/Shaders/Items.fx                   |  27 ++---
 TombEngine/Shaders/Math.hlsli                 | 106 ++++++++++++++++++
 TombEngine/Shaders/PostProcess.fx             |   4 +-
 TombEngine/Shaders/ShadowMap.fx               |  17 +--
 TombEngine/Shaders/VertexInput.hlsli          |   9 +-
 TombEngine/TombEngine.vcxproj                 |  13 +--
 17 files changed, 207 insertions(+), 84 deletions(-)
 create mode 100644 TombEngine/Shaders/CBItem.hlsli

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2fa1b78d9..7132942b6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,10 +14,11 @@ TombEngine releases are located in this repository (alongside with Tomb Editor):
 * Fixed Teleporter object.
 * Fixed Wraith objects not working correctly in flipped rooms.
 * Fixed lensflare enabled status not saved in a savegame.
+* Fixed HK sound effects.
+* Fixed HK shots not being registered in statistics.
+* Fixed distorted knee and elbow joint vertices.
 * Fixed caustics not rendered correctly if texture compression was enabled.
 * Fixed exclusion blend mode not working correctly.
-* Fixed HK shots not being registered in statistics.
-* Fixed HK sound effects.
 * Fixed SSAO incorrectly applied through alpha blended textures.
 
 ### Lua API changes
diff --git a/TombEngine/Renderer/ConstantBuffers/ItemBuffer.h b/TombEngine/Renderer/ConstantBuffers/ItemBuffer.h
index f3b9c88c6..7715e183d 100644
--- a/TombEngine/Renderer/ConstantBuffers/ItemBuffer.h
+++ b/TombEngine/Renderer/ConstantBuffers/ItemBuffer.h
@@ -22,5 +22,6 @@ namespace TEN::Renderer::ConstantBuffers
 		ShaderLight Lights[MAX_LIGHTS_PER_ITEM];
 		//--
 		int NumLights;
+		int Skinned;
 	};
 }
\ No newline at end of file
diff --git a/TombEngine/Renderer/Graphics/Vertices/Vertex.h b/TombEngine/Renderer/Graphics/Vertices/Vertex.h
index 0ee57b10b..0094fb5b2 100644
--- a/TombEngine/Renderer/Graphics/Vertices/Vertex.h
+++ b/TombEngine/Renderer/Graphics/Vertices/Vertex.h
@@ -12,11 +12,12 @@ namespace TEN::Renderer::Graphics::Vertices
 		Vector3 Tangent	 = Vector3::Zero;
 		Vector3 Binormal = Vector3::Zero;
 
-		unsigned int AnimationFrameOffset = 0;
-		Vector4		 Effects			  = Vector4::Zero;
-		float		 Bone				  = 0.0f;
-		unsigned int IndexInPoly		  = 0;
-		unsigned int OriginalIndex		  = 0;
-		unsigned int Hash				  = 0;
+		unsigned int AnimationFrameOffset			= 0;
+		Vector4		 Effects						= Vector4::Zero;
+		unsigned int BoneIndex[MAX_BONE_WEIGHTS]	= { 0, 0, 0, 0 };
+		float		 BoneWeight[MAX_BONE_WEIGHTS]	= { 1, 0, 0, 0 };
+		unsigned int IndexInPoly					= 0;
+		unsigned int OriginalIndex					= 0;
+		unsigned int Hash							= 0;
 	};
 }
diff --git a/TombEngine/Renderer/RendererCompatibility.cpp b/TombEngine/Renderer/RendererCompatibility.cpp
index 6ce6a71bb..25c44ac36 100644
--- a/TombEngine/Renderer/RendererCompatibility.cpp
+++ b/TombEngine/Renderer/RendererCompatibility.cpp
@@ -364,7 +364,6 @@ namespace TEN::Renderer
 						((vertex->Position.x)* primes[0]) ^
 							((unsigned int)std::hash{}(vertex->Position.y) * primes[1]) ^
 							(unsigned int)std::hash{}(vertex->Position.z) * primes[2];
-						vertex->Bone = 0;
 
 						lastVertex++;
 					}
@@ -697,9 +696,10 @@ namespace TEN::Renderer
 												int y2 = _moveablesVertices[skinBucket->StartVertex + v2].Position.y + skinBone->GlobalTranslation.y;
 												int z2 = _moveablesVertices[skinBucket->StartVertex + v2].Position.z + skinBone->GlobalTranslation.z;
 
+												// Joint vertex and skin mesh vertex are aligned, connect them.
 												if (abs(x1 - x2) < 2 && abs(y1 - y2) < 2 && abs(z1 - z2) < 2)
 												{
-													jointVertex->Bone = bonesToCheck[k];
+													jointVertex->BoneIndex[0] = bonesToCheck[k];
 													jointVertex->Position = skinVertex->Position;
 													jointVertex->Normal = skinVertex->Normal;
 
@@ -715,6 +715,15 @@ namespace TEN::Renderer
 										if (isDone)
 											break;
 									}
+
+									// Joint vertex and skin mesh vertex are not connected, specify both bone weights for blending.
+									if (!isDone)
+									{
+										jointVertex->BoneIndex[0] = j;
+										jointVertex->BoneWeight[0] = 0.5f;
+										jointVertex->BoneIndex[1] = jointBone->Parent->Index;
+										jointVertex->BoneWeight[1] = 0.5f;
+									}
 								}
 							}
 						}
@@ -736,7 +745,7 @@ namespace TEN::Renderer
 								for (int v1 = 0; v1 < currentBucket.NumVertices; v1++)
 								{
 									auto* currentVertex = &_moveablesVertices[currentBucket.StartVertex + v1];
-									currentVertex->Bone = j + 1;
+									currentVertex->BoneIndex[0] = j + 1;
 
 									// Link mesh 0 to root mesh.
 									if (j == 0)
@@ -768,7 +777,7 @@ namespace TEN::Renderer
 												if ((parentVertex->OriginalIndex == vertices1[currentVertex->OriginalIndex] &&  isSecond) ||
 													(parentVertex->OriginalIndex == vertices0[currentVertex->OriginalIndex] && !isSecond))
 												{
-													currentVertex->Bone = 0;
+													currentVertex->BoneIndex[0] = 0;
 													currentVertex->Position = parentVertex->Position;
 													currentVertex->Normal = parentVertex->Normal;
 												}
@@ -800,7 +809,7 @@ namespace TEN::Renderer
 
 												if (abs(x1 - x2) == 0 && abs(y1 - y2) == 0 && abs(z1 - z2) == 0)
 												{
-													currentVertex->Bone = j;
+													currentVertex->BoneIndex[0] = j;
 													currentVertex->Position = parentVertex->Position;
 													currentVertex->Normal = parentVertex->Normal;
 													break;
@@ -972,7 +981,7 @@ namespace TEN::Renderer
 					vertex.Color.z = meshPtr->colors[v].z;
 					vertex.Color.w = 1.0f;
 
-					vertex.Bone = meshPtr->bones[v];
+					vertex.BoneIndex[0] = meshPtr->bones[v];
 					vertex.OriginalIndex = v;
 
 					vertex.Effects = Vector4(meshPtr->effects[v].x, meshPtr->effects[v].y, meshPtr->effects[v].z, poly->shineStrength);
diff --git a/TombEngine/Renderer/RendererDraw.cpp b/TombEngine/Renderer/RendererDraw.cpp
index b658d9722..34a34f41f 100644
--- a/TombEngine/Renderer/RendererDraw.cpp
+++ b/TombEngine/Renderer/RendererDraw.cpp
@@ -200,6 +200,7 @@ namespace TEN::Renderer
 			_stItem.World = item->InterpolatedWorld;
 			_stItem.Color = item->Color;
 			_stItem.AmbientLight = item->AmbientLight;
+			_stItem.Skinned = item->ObjectID == GAME_OBJECT_ID::ID_LARA; // TODO: Implement for all skinned objects!
 			memcpy(_stItem.BonesMatrices, item->InterpolatedAnimTransforms, sizeof(Matrix) * MAX_BONES);
 			for (int k = 0; k < MAX_BONES; k++)
 				_stItem.BoneLightModes[k] = (int)LightMode::Static;
@@ -2416,6 +2417,7 @@ namespace TEN::Renderer
 
 		_stItem.Color = item->Color;
 		_stItem.AmbientLight = item->AmbientLight;
+		_stItem.Skinned = item->ObjectID == GAME_OBJECT_ID::ID_LARA; // TODO: Implement for all skinned objects!
 		memcpy(_stItem.BonesMatrices, item->InterpolatedAnimTransforms, sizeof(Matrix) * MAX_BONES);
 
 		for (int k = 0; k < moveableObj.ObjectMeshes.size(); k++)
@@ -3651,6 +3653,7 @@ namespace TEN::Renderer
 		_stItem.World = world;
 		_stItem.Color = objectInfo->Item->Color;
 		_stItem.AmbientLight = objectInfo->Item->AmbientLight;
+		_stItem.Skinned = objectInfo->Item->ObjectID == GAME_OBJECT_ID::ID_LARA; // TODO: Implement for all skinned objects!
 		memcpy(_stItem.BonesMatrices, objectInfo->Item->InterpolatedAnimTransforms, sizeof(Matrix) * MAX_BONES);
 
 		const auto& moveableObj = *_moveableObjects[objectInfo->Item->ObjectID];
diff --git a/TombEngine/Renderer/RendererEnums.h b/TombEngine/Renderer/RendererEnums.h
index b0320eba8..1d005ccfd 100644
--- a/TombEngine/Renderer/RendererEnums.h
+++ b/TombEngine/Renderer/RendererEnums.h
@@ -38,6 +38,7 @@ constexpr auto ALPHA_BLEND_THRESHOLD		  = 1.0f - EPSILON;
 constexpr auto FAST_ALPHA_BLEND_THRESHOLD	  = 0.5f;
 
 constexpr auto MAX_BONES = 32;
+constexpr auto MAX_BONE_WEIGHTS = 4;
 
 constexpr auto DISPLAY_SPACE_RES = Vector2(800.0f, 600.0f);
 constexpr auto REFERENCE_FONT_SIZE = 35.0f;
diff --git a/TombEngine/Renderer/RendererInit.cpp b/TombEngine/Renderer/RendererInit.cpp
index 3e1b3f6b7..27136fabd 100644
--- a/TombEngine/Renderer/RendererInit.cpp
+++ b/TombEngine/Renderer/RendererInit.cpp
@@ -42,22 +42,29 @@ namespace TEN::Renderer
 		// Initialize input layout using first vertex shader.
 		D3D11_INPUT_ELEMENT_DESC inputLayoutItems[] =
 		{
-			{ "POSITION", 0, DXGI_FORMAT_R32G32B32_FLOAT, 0, 0, D3D11_INPUT_PER_VERTEX_DATA, 0 },
-			{ "NORMAL", 0, DXGI_FORMAT_R32G32B32_FLOAT, 0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
-			{ "TEXCOORD", 0, DXGI_FORMAT_R32G32_FLOAT, 0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
-			{ "COLOR", 0, DXGI_FORMAT_R32G32B32A32_FLOAT, 0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
-			{ "TANGENT", 0, DXGI_FORMAT_R32G32B32_FLOAT, 0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
-			{ "BINORMAL", 0, DXGI_FORMAT_R32G32B32_FLOAT, 0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
-			{ "ANIMATIONFRAMEOFFSET", 0, DXGI_FORMAT_R32_UINT, 0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
-			{ "EFFECTS", 0, DXGI_FORMAT_R32G32B32A32_FLOAT, 0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
-			{ "BLENDINDICES", 0, DXGI_FORMAT_R32_FLOAT, 0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
-			{ "POLYINDEX", 0, DXGI_FORMAT_R32_UINT, 0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
-			{ "DRAWINDEX", 0, DXGI_FORMAT_R32_UINT, 0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
-			{ "HASH", 0, DXGI_FORMAT_R32_SINT, 0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 }
+			{ "POSITION",             0, DXGI_FORMAT_R32G32B32_FLOAT,    0, 0,                            D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "NORMAL",               0, DXGI_FORMAT_R32G32B32_FLOAT,    0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "TEXCOORD",             0, DXGI_FORMAT_R32G32_FLOAT,       0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "COLOR",                0, DXGI_FORMAT_R32G32B32A32_FLOAT, 0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "TANGENT",              0, DXGI_FORMAT_R32G32B32_FLOAT,    0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "BINORMAL",             0, DXGI_FORMAT_R32G32B32_FLOAT,    0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "ANIMATIONFRAMEOFFSET", 0, DXGI_FORMAT_R32_UINT,           0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "EFFECTS",              0, DXGI_FORMAT_R32G32B32A32_FLOAT, 0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "BONEINDICES",          0, DXGI_FORMAT_R32_SINT,           0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "BONEINDICES",          1, DXGI_FORMAT_R32_SINT,           0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "BONEINDICES",          2, DXGI_FORMAT_R32_SINT,           0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "BONEINDICES",          3, DXGI_FORMAT_R32_SINT,           0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "BONEWEIGHTS",          0, DXGI_FORMAT_R32_FLOAT,          0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "BONEWEIGHTS",          1, DXGI_FORMAT_R32_FLOAT,          0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "BONEWEIGHTS",          2, DXGI_FORMAT_R32_FLOAT,          0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "BONEWEIGHTS",          3, DXGI_FORMAT_R32_FLOAT,          0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "POLYINDEX",            0, DXGI_FORMAT_R32_UINT,           0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "DRAWINDEX",            0, DXGI_FORMAT_R32_UINT,           0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 },
+			{ "HASH",                 0, DXGI_FORMAT_R32_SINT,           0, D3D11_APPEND_ALIGNED_ELEMENT, D3D11_INPUT_PER_VERTEX_DATA, 0 }
 		};
 
 		const auto& roomShader = _shaders.Get(Shader::Rooms);
-		Utils::throwIfFailed(_device->CreateInputLayout(inputLayoutItems, 12, roomShader.Vertex.Blob->GetBufferPointer(), roomShader.Vertex.Blob->GetBufferSize(), &_inputLayout));
+		Utils::throwIfFailed(_device->CreateInputLayout(inputLayoutItems, 19, roomShader.Vertex.Blob->GetBufferPointer(), roomShader.Vertex.Blob->GetBufferSize(), &_inputLayout));
 
 		// Initialize constant buffers.
 		_cbCameraMatrices = CreateConstantBuffer();
diff --git a/TombEngine/Renderer/RendererLara.cpp b/TombEngine/Renderer/RendererLara.cpp
index 6ed781f8b..f73b4f5d7 100644
--- a/TombEngine/Renderer/RendererLara.cpp
+++ b/TombEngine/Renderer/RendererLara.cpp
@@ -312,6 +312,7 @@ void Renderer::DrawLara(RenderView& view, RendererPass rendererPass)
 
 	_stItem.Color = item->Color;
 	_stItem.AmbientLight = item->AmbientLight;
+	_stItem.Skinned = true;
 	memcpy(_stItem.BonesMatrices, item->InterpolatedAnimTransforms, laraObj.AnimationTransforms.size() * sizeof(Matrix));
 	for (int k = 0; k < laraSkin.ObjectMeshes.size(); k++)
 	{
@@ -353,6 +354,7 @@ void Renderer::DrawLaraHair(RendererItem* itemToDraw, RendererRoom* room, Render
 
 		_stItem.World = Matrix::Identity;
 		_stItem.BonesMatrices[0] = itemToDraw->InterpolatedAnimTransforms[HairUnit::GetRootMeshID(i)] * itemToDraw->InterpolatedWorld;
+		_stItem.Skinned = false;
 		ReflectMatrixOptionally(_stItem.BonesMatrices[0]);
 
 		for (int i = 0; i < unit.Segments.size(); i++)
diff --git a/TombEngine/Renderer/Structures/RendererHudBar.h b/TombEngine/Renderer/Structures/RendererHudBar.h
index 74bfc9651..0e81c70a5 100644
--- a/TombEngine/Renderer/Structures/RendererHudBar.h
+++ b/TombEngine/Renderer/Structures/RendererHudBar.h
@@ -155,8 +155,6 @@ namespace TEN::Renderer::Structures
 				vertices[i].Position = barVertices[i];
 				vertices[i].Color = colors[i];
 				vertices[i].UV = barUVs[i];
-				vertices[i].Normal = Vector3::Zero;
-				vertices[i].Bone = 0.0f;
 			}
 
 			InnerVertexBuffer = VertexBuffer(devicePtr, (int)vertices.size(), &vertices[0]);
@@ -168,8 +166,6 @@ namespace TEN::Renderer::Structures
 				borderVertices[i].Position = barBorderVertices[i];
 				borderVertices[i].Color = Vector4::One;
 				borderVertices[i].UV = barBorderUVs[i];
-				borderVertices[i].Normal = Vector3::Zero;
-				borderVertices[i].Bone = 0.0f;
 			}
 
 			VertexBufferBorder = VertexBuffer(devicePtr, (int)borderVertices.size(), &borderVertices[0]);
diff --git a/TombEngine/Shaders/CBItem.hlsli b/TombEngine/Shaders/CBItem.hlsli
new file mode 100644
index 000000000..e6bbd7c3c
--- /dev/null
+++ b/TombEngine/Shaders/CBItem.hlsli
@@ -0,0 +1,18 @@
+#ifndef CBITEMSHADER
+#define CBITEMSHADER
+
+#include "./ShaderLight.hlsli"
+
+cbuffer ItemBuffer : register(b1) 
+{
+	float4x4 World;
+	float4x4 Bones[MAX_BONES];
+	float4 Color;
+	float4 AmbientLight;
+	int4 BoneLightModes[MAX_BONES / 4];
+	ShaderLight ItemLights[MAX_LIGHTS_PER_ITEM];
+	int NumItemLights;
+	int Skinned;
+};
+
+#endif // CBITEMSHADER
\ No newline at end of file
diff --git a/TombEngine/Shaders/GBuffer.fx b/TombEngine/Shaders/GBuffer.fx
index 566ca6518..afec7c13d 100644
--- a/TombEngine/Shaders/GBuffer.fx
+++ b/TombEngine/Shaders/GBuffer.fx
@@ -1,11 +1,11 @@
 #include "./CBCamera.hlsli"
+#include "./CBItem.hlsli"
 #include "./VertexInput.hlsli"
 #include "./VertexEffects.hlsli"
 #include "./AnimatedTextures.hlsli"
 #include "./Blending.hlsli"
 #include "./Math.hlsli"
 
-#define MAX_BONES 32
 #define INSTANCED_STATIC_MESH_BUCKET_SIZE 100
 
 cbuffer RoomBuffer : register(b5)
@@ -27,12 +27,6 @@ cbuffer InstancedStaticMeshBuffer : register(b3)
 	InstancedStaticMesh StaticMeshes[INSTANCED_STATIC_MESH_BUCKET_SIZE];
 };
 
-cbuffer ItemBuffer : register(b1)
-{
-	float4x4 ItemWorld;
-	float4x4 Bones[MAX_BONES];
-};
-
 cbuffer StaticMatrixBuffer : register(b8)
 {
 	float4x4 StaticWorld;
@@ -120,8 +114,10 @@ PixelShaderInput VSRooms(VertexShaderInput input)
 PixelShaderInput VSItems(VertexShaderInput input)
 {
 	PixelShaderInput output;
-
-	float4x4 world = mul(Bones[input.Bone], ItemWorld);
+	
+	// Blend and apply world matrix
+	float4x4 blended = Skinned ? BlendBoneMatrices(input, Bones, true) : Bones[input.BoneIndex[0]];
+	float4x4 world = mul(blended, World);
 
 	// Calculate vertex effects
 	float wibble = Wibble(input.Effects.xyz, input.Hash);
diff --git a/TombEngine/Shaders/Items.fx b/TombEngine/Shaders/Items.fx
index d8a13d5dc..d9d29ebd0 100644
--- a/TombEngine/Shaders/Items.fx
+++ b/TombEngine/Shaders/Items.fx
@@ -1,5 +1,6 @@
 #include "./Math.hlsli"
 #include "./CBCamera.hlsli"
+#include "./CBItem.hlsli"
 #include "./ShaderLight.hlsli"
 #include "./VertexEffects.hlsli"
 #include "./VertexInput.hlsli"
@@ -7,19 +8,6 @@
 #include "./AnimatedTextures.hlsli"
 #include "./Shadows.hlsli"
 
-#define MAX_BONES 32
-
-cbuffer ItemBuffer : register(b1) 
-{
-	float4x4 World;
-	float4x4 Bones[MAX_BONES];
-	float4 Color;
-	float4 AmbientLight;
-	int4 BoneLightModes[MAX_BONES / 4];
-	ShaderLight ItemLights[MAX_LIGHTS_PER_ITEM];
-	int NumItemLights;
-};
-
 struct PixelShaderInput
 {
 	float4 Position: SV_POSITION;
@@ -60,22 +48,23 @@ PixelShaderInput VS(VertexShaderInput input)
 {
 	PixelShaderInput output;
 
-	float4x4 world = mul(Bones[input.Bone], World);
-	
+	// Blend and apply world matrix
+	float4x4 blended = Skinned ? BlendBoneMatrices(input, Bones, true) : Bones[input.BoneIndex[0]];
+	float4x4 world = mul(blended, World);
+
 	// Calculate vertex effects
 	float wibble = Wibble(input.Effects.xyz, input.Hash);
 	float3 pos = Move(input.Position, input.Effects.xyz, wibble);
 	float3 col = Glow(input.Color.xyz, input.Effects.xyz, wibble);
-	
-	float3 worldPosition = (mul(float4(pos, 1.0f), world).xyz);
+	float3 worldPosition = mul(float4(pos, 1.0f), world).xyz;
 
 	output.Position = mul(float4(worldPosition, 1.0f), ViewProjection);
 	output.UV = input.UV;
 	output.Color = float4(col, input.Color.w);
 	output.Color *= Color;
 	output.PositionCopy = output.Position;
-    output.Sheen = input.Effects.w;
-	output.Bone = input.Bone;
+	output.Sheen = input.Effects.w;
+	output.Bone = input.BoneIndex[0];
 	output.WorldPosition = worldPosition;
 
 	output.Normal = normalize(mul(input.Normal, (float3x3)world).xyz);
diff --git a/TombEngine/Shaders/Math.hlsli b/TombEngine/Shaders/Math.hlsli
index 39a86bb0f..dd064d4eb 100644
--- a/TombEngine/Shaders/Math.hlsli
+++ b/TombEngine/Shaders/Math.hlsli
@@ -1,6 +1,8 @@
 #ifndef MATH
 #define MATH
 
+#include "./VertexInput.hlsli"
+
 #define PI		3.1415926535897932384626433832795028841971693993751058209749445923
 #define PI2		6.2831853071795864769252867665590057683943387987502116419498891846
 #define EPSILON 1e-38
@@ -24,6 +26,8 @@
 #define MAX_FOG_BULBS	32
 #define SPEC_FACTOR 64
 
+#define MAX_BONES 32
+
 struct ShaderLight
 {
 	float3 Position;
@@ -390,4 +394,106 @@ float3 NormalNoise(float3 v, float3 i, float3 n)
 	// Return perturbed pixel based on reference pixel and resulting vector with threshold c attenuated by 2/5 times.
 	return lerp(v, r, c * 0.3f);
 }
+
+// Matrix (3x3) to Quaternion
+float4 RotationMatrixToQuaternion(float3x3 m)
+{
+	float4 q;
+	float trace = m[0].x + m[1].y + m[2].z;
+
+	bool tracePositive = trace > 0.0f;
+	float s0 = sqrt(trace + 1.0f) * 2.0f;
+	float4 q0 = float4(
+		(m[2].y - m[1].z) / s0,
+		(m[0].z - m[2].x) / s0,
+		(m[1].x - m[0].y) / s0,
+		0.25f * s0
+	);
+
+	bool cond1 = (m[0].x > m[1].y) && (m[0].x > m[2].z);
+	float s1 = sqrt(1.0f + m[0].x - m[1].y - m[2].z) * 2.0f;
+	float4 q1 = float4(
+		0.25f * s1,
+		(m[0].y + m[1].x) / s1,
+		(m[0].z + m[2].x) / s1,
+		(m[2].y - m[1].z) / s1
+	);
+
+	bool cond2 = m[1].y > m[2].z;
+	float s2 = sqrt(1.0f + m[1].y - m[0].x - m[2].z) * 2.0f;
+	float4 q2 = float4(
+		(m[0].y + m[1].x) / s2,
+		0.25f * s2,
+		(m[1].z + m[2].y) / s2,
+		(m[0].z - m[2].x) / s2
+	);
+
+	float s3 = sqrt(1.0f + m[2].z - m[0].x - m[1].y) * 2.0f;
+	float4 q3 = float4(
+		(m[0].z + m[2].x) / s3,
+		(m[1].z + m[2].y) / s3,
+		0.25f * s3,
+		(m[1].x - m[0].y) / s3
+	);
+
+	q = tracePositive ? q0 : (cond1 ? q1 : (cond2 ? q2 : q3));
+	return q;
+}
+
+// Quaternion to Matrix (3x3)
+float3x3 QuaternionToRotationMatrix(float4 q)
+{
+	float x2 = q.x + q.x,  y2 = q.y + q.y,	z2 = q.z + q.z;
+	float xx = q.x * x2,   yy = q.y * y2,	zz = q.z * z2;
+	float xy = q.x * y2,   xz = q.x * z2,	yz = q.y * z2;
+	float wx = q.w * x2,   wy = q.w * y2,	wz = q.w * z2;
+
+	float3x3 m;
+	m[0] = float3(1.0f - (yy + zz), xy - wz, xz + wy);
+	m[1] = float3(xy + wz, 1.0f - (xx + zz), yz - wx);
+	m[2] = float3(xz - wy, yz + wx, 1.0f - (xx + yy));
+	return m;
+}
+
+// Blend bone matrices using quaternion-based rotation and linear translation
+float4x4 BlendBoneMatrices(VertexShaderInput input, float4x4 bones[MAX_BONES], bool onlyRotation)
+{
+	float4 blendedQuat = float4(0, 0, 0, 0);
+	float3 blendedTranslation = float3(0, 0, 0);
+
+	[unroll]
+	for (int i = 0; i < MAX_BONE_WEIGHTS; ++i)
+	{
+		float w = input.BoneWeight[i];
+		int index = input.BoneIndex[i];
+		float4x4 bone = bones[index];
+
+		float3x3 rot = (float3x3)bone;
+		float4 q = RotationMatrixToQuaternion(rot);
+
+		// Ensure shortest path for interpolation (flip if dot < 0)
+		float dotPrev = dot(blendedQuat, q);
+		q *= sign(dotPrev + 1e-5f); // Avoid zero dot product flip
+
+		blendedQuat += q * w;
+
+		if (!onlyRotation)
+		{
+			blendedTranslation += bone[3].xyz * w;
+		}
+	}
+
+	blendedQuat = normalize(blendedQuat);
+	float3x3 finalRot = QuaternionToRotationMatrix(blendedQuat);
+
+	float4x4 result = float4x4(
+		float4(finalRot[0], 0.0f),
+		float4(finalRot[1], 0.0f),
+		float4(finalRot[2], 0.0f),
+		float4(onlyRotation ? bones[input.BoneIndex[0]][3].xyz : blendedTranslation, 1.0f)
+	);
+
+	return result;
+}
+
 #endif // MATH
diff --git a/TombEngine/Shaders/PostProcess.fx b/TombEngine/Shaders/PostProcess.fx
index 10d717245..5d1d6ebeb 100644
--- a/TombEngine/Shaders/PostProcess.fx
+++ b/TombEngine/Shaders/PostProcess.fx
@@ -2,7 +2,7 @@
 #include "./CBCamera.hlsli"
 #include "./Math.hlsli"
 
-struct VertexShaderInput
+struct PostProcessVertexShaderInput
 {
     float3 Position: POSITION0;
     float2 UV: TEXCOORD0;
@@ -20,7 +20,7 @@ struct PixelShaderInput
 Texture2D ColorTexture : register(t0);
 SamplerState ColorSampler : register(s0);
 
-PixelShaderInput VS(VertexShaderInput input)
+PixelShaderInput VS(PostProcessVertexShaderInput input)
 {
     PixelShaderInput output;
 
diff --git a/TombEngine/Shaders/ShadowMap.fx b/TombEngine/Shaders/ShadowMap.fx
index 6c6b8b0b1..027cdb01a 100644
--- a/TombEngine/Shaders/ShadowMap.fx
+++ b/TombEngine/Shaders/ShadowMap.fx
@@ -1,16 +1,9 @@
 #include "./CBCamera.hlsli"
+#include "./CBItem.hlsli"
 #include "./Blending.hlsli"
+#include "./Math.hlsli"
 #include "./VertexInput.hlsli"
 
-cbuffer ItemBuffer : register(b1)
-{
-	float4x4 World;
-	float4x4 Bones[32];
-	float4 ItemPosition;
-	float4 AmbientLight;
-};
-
-
 struct PixelShaderInput
 {
 	float4 Position: SV_POSITION;
@@ -24,8 +17,10 @@ SamplerState Sampler : register(s0);
 PixelShaderInput VS(VertexShaderInput input)
 {
 	PixelShaderInput output;
-
-	float4x4 world = mul(Bones[input.Bone], World);
+	
+	// Blend and apply world matrix
+	float4x4 blended = Skinned ? BlendBoneMatrices(input, Bones, true) : Bones[input.BoneIndex[0]];
+	float4x4 world = mul(blended, World);
 
 	output.Position = mul(mul(float4(input.Position, 1.0f), world), ViewProjection);
 	output.Depth = output.Position.z / output.Position.w;
diff --git a/TombEngine/Shaders/VertexInput.hlsli b/TombEngine/Shaders/VertexInput.hlsli
index 197c17d80..2feecf067 100644
--- a/TombEngine/Shaders/VertexInput.hlsli
+++ b/TombEngine/Shaders/VertexInput.hlsli
@@ -1,3 +1,7 @@
+#ifndef VERTEXINPUT
+#define VERTEXINPUT
+
+#define MAX_BONE_WEIGHTS 4
 
 struct VertexShaderInput 
 {
@@ -9,8 +13,11 @@ struct VertexShaderInput
 	float3 Binormal: BINORMAL0;
 	unsigned int AnimationFrameOffset: ANIMATIONFRAMEOFFSET;
 	float4 Effects: EFFECTS;
-	float Bone: BLENDINDICES;
+	unsigned int BoneIndex[MAX_BONE_WEIGHTS]: BONEINDICES;
+	float BoneWeight[MAX_BONE_WEIGHTS]: BONEWEIGHTS;
 	unsigned int PolyIndex : POLYINDEX;
 	unsigned int Index: DRAWINDEX;
 	int Hash : HASH;
 };
+
+#endif // VERTEXINPUT
\ No newline at end of file
diff --git a/TombEngine/TombEngine.vcxproj b/TombEngine/TombEngine.vcxproj
index 2e1887b44..ed3268b48 100644
--- a/TombEngine/TombEngine.vcxproj
+++ b/TombEngine/TombEngine.vcxproj
@@ -1368,21 +1368,12 @@ if not exist "%ScriptsDir%\Strings.lua" xcopy /Y "$(SolutionDir)Scripts\Strings.
     
     
     
-    
-      false
-      false
-      false
-      false
-      true
-      true
-      true
-      true
-      Text
-    
     
       false
       Document
     
+    
+    
     
       true
     

From 4859838766bf2a0f38864749ba0fa2624f0ff232 Mon Sep 17 00:00:00 2001
From: Lwmte <3331699+Lwmte@users.noreply.github.com>
Date: Sun, 20 Apr 2025 23:04:42 +0200
Subject: [PATCH 156/160] Update CHANGELOG.md

---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7132942b6..d134ec3d5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -24,12 +24,12 @@ TombEngine releases are located in this repository (alongside with Tomb Editor):
 ### Lua API changes
 * Added `View.PlayVideoFile` function to play videos.
 * Added `Flow.SetIntroVideoPath` function to specify intro video.
+* Added `Lara:Interact` function to allow alignment with moveables.
 * Added `muzzleGlow` and `muzzleOffset` parameters to weapon settings.
 * Added ability to use gunflash parameters for all weapons in weapon settings.
 * Fixed `Moveable.GetJointPosition` not returning correct results if moveable is invisible or not rendered.
 
 ### Lua API changes
-* Added Interact function to `Lara` to allow alignment with moveables.
 
 ## [Version 1.8.1](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.8.1) - 2025-03-29
 

From 3af1b15cdaea9cc4a1d1b4f4aea6509943e78f9c Mon Sep 17 00:00:00 2001
From: Lwmte <3331699+Lwmte@users.noreply.github.com>
Date: Sun, 20 Apr 2025 23:06:29 +0200
Subject: [PATCH 157/160] Update docs

---
 Documentation/doc/2 classes/Objects.LaraObject.html           | 4 ++--
 TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/Documentation/doc/2 classes/Objects.LaraObject.html b/Documentation/doc/2 classes/Objects.LaraObject.html
index 64ecafdad..0a0012f8f 100644
--- a/Documentation/doc/2 classes/Objects.LaraObject.html	
+++ b/Documentation/doc/2 classes/Objects.LaraObject.html	
@@ -751,7 +751,7 @@
     
      Parameters:
      
     
        
         
      • mov
-            Moveable
+            Moveable
          Moveable object to align the player with.
         
        • 
         
      • animNumber
@@ -815,7 +815,7 @@
     
        Parameters:
        
     
          
         
        • mov
-            Moveable
+            Moveable
          Moveable object to align the player with.
         
          • 
         
        • minOffsetConstraint
diff --git a/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp b/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp
index 6bc77854d..04e7dd90b 100644
--- a/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp
+++ b/TombEngine/Scripting/Internal/TEN/Objects/Lara/LaraObject.cpp
@@ -401,7 +401,7 @@ bool LaraObject::IsTorchLit() const
 
 /// Align the player with a moveable object for interaction.
 // @function LaraObject:Interact
-// @tparam Moveable mov Moveable object to align the player with.
+// @tparam Objects.Moveable mov Moveable object to align the player with.
 // @tparam[opt=197 (BUTTON_PUSH)] int animNumber The animation to play after alignment is complete.
 // @tparam[opt=Vec3(0, 0, 312)] Vec3 offset Relative position offset from the moveable.
 // @tparam[opt=Vec3(-256, -512, 0)] Vec3 minOffsetConstraint Minimum relative offset constraint.
@@ -468,7 +468,7 @@ void LaraObject::Interact(const Moveable& mov, TypeOrNil animNumber,
 
 /// Test the player against a moveable object for interaction.
 // @function LaraObject:TestInteraction
-// @tparam Moveable mov Moveable object to align the player with.
+// @tparam Objects.Moveable mov Moveable object to align the player with.
 // @tparam[opt=Vec3(-256, -512, 0)] Vec3 minOffsetConstraint Minimum relative offset constraint.
 // @tparam[opt=Vec3(256, 0, 512)] Vec3 maxOffsetConstraint Maximum relative offset constraint.
 // @tparam[opt=Rotation(-10, -40, -10)] Rotation minRotConstraint Minimum relative rotation constraint.

From 5a61a14000c66ce17877d2eb34b5b5519bfe230e Mon Sep 17 00:00:00 2001
From: Lwmte <3331699+Lwmte@users.noreply.github.com>
Date: Sun, 20 Apr 2025 23:14:44 +0200
Subject: [PATCH 158/160] Update CHANGELOG.md

---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d134ec3d5..b817d5339 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -22,7 +22,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor):
 * Fixed SSAO incorrectly applied through alpha blended textures.
 
 ### Lua API changes
-* Added `View.PlayVideoFile` function to play videos.
+* Added `View.PlayVideo`, `View.StopVideo`, and other helper functions for the video playback.
 * Added `Flow.SetIntroVideoPath` function to specify intro video.
 * Added `Lara:Interact` function to allow alignment with moveables.
 * Added `muzzleGlow` and `muzzleOffset` parameters to weapon settings.

From be338dcbfacd4e9098c260f5951723ca30304f92 Mon Sep 17 00:00:00 2001
From: Lwmte <3331699+Lwmte@users.noreply.github.com>
Date: Mon, 21 Apr 2025 09:47:21 +0200
Subject: [PATCH 159/160] Update CHANGELOG.md

---
 CHANGELOG.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b817d5339..449802407 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -29,8 +29,6 @@ TombEngine releases are located in this repository (alongside with Tomb Editor):
 * Added ability to use gunflash parameters for all weapons in weapon settings.
 * Fixed `Moveable.GetJointPosition` not returning correct results if moveable is invisible or not rendered.
 
-### Lua API changes
-
 ## [Version 1.8.1](https://github.com/TombEngine/TombEditorReleases/releases/tag/v1.8.1) - 2025-03-29
 
 ### Bug fixes

From f6845961caa154f666a9cabfe5d7109ee22ad18f Mon Sep 17 00:00:00 2001
From: Lwmte <3331699+Lwmte@users.noreply.github.com>
Date: Tue, 22 Apr 2025 09:44:35 +0200
Subject: [PATCH 160/160] Removed legacy TR5 search object code which caused
 issues with meshswaps

---
 CHANGELOG.md                      |  1 +
 TombEngine/Game/pickup/pickup.cpp | 24 ------------------------
 2 files changed, 1 insertion(+), 24 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 449802407..70d6aa069 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -20,6 +20,7 @@ TombEngine releases are located in this repository (alongside with Tomb Editor):
 * Fixed caustics not rendered correctly if texture compression was enabled.
 * Fixed exclusion blend mode not working correctly.
 * Fixed SSAO incorrectly applied through alpha blended textures.
+* Removed legacy TR5 search object code which caused issues with meshswaps.
 
 ### Lua API changes
 * Added `View.PlayVideo`, `View.StopVideo`, and other helper functions for the video playback.
diff --git a/TombEngine/Game/pickup/pickup.cpp b/TombEngine/Game/pickup/pickup.cpp
index 3059baac0..260cca2a2 100644
--- a/TombEngine/Game/pickup/pickup.cpp
+++ b/TombEngine/Game/pickup/pickup.cpp
@@ -1239,30 +1239,6 @@ void SearchObjectControl(short itemNumber)
 		AnimateItem(item);
 
 	int frameNumber = item->Animation.FrameNumber - GetAnimData(item).frameBase;
-	if (item->ObjectNumber == ID_SEARCH_OBJECT1)
-	{
-		if (frameNumber > 0)
-		{
-			item->SetMeshSwapFlags(NO_JOINT_BITS);
-			item->MeshBits = ALL_JOINT_BITS;
-		}
-		else
-		{
-			item->SetMeshSwapFlags(ALL_JOINT_BITS);
-			item->MeshBits = 7;
-		}
-	}
-	else if (item->ObjectNumber == ID_SEARCH_OBJECT2)
-	{
-		if (frameNumber == 18)
-		{
-			item->MeshBits = 1;
-		}
-		else if (frameNumber == 172)
-		{
-			item->MeshBits = 2;
-		}
-	}
 
 	if (frameNumber == SearchCollectFrames[objectNumber])
 	{

    Functions