From cfb3e4c7d96c1b59d7f8240119f8f77b1da45a03 Mon Sep 17 00:00:00 2001
From: TheFarFantomas <120812953+TheFarFantomas@users.noreply.github.com>
Date: Mon, 19 Dec 2022 22:11:18 +0100
Subject: [PATCH] feat(imports): requestScaleformMovie (#180)

---
 imports/requestScaleformMovie/client.lua | 31 ++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 imports/requestScaleformMovie/client.lua

diff --git a/imports/requestScaleformMovie/client.lua b/imports/requestScaleformMovie/client.lua
new file mode 100644
index 0000000..4cfda14
--- /dev/null
+++ b/imports/requestScaleformMovie/client.lua
@@ -0,0 +1,31 @@
+---Load a scaleform movie. When called from a thread, it will yield until it has loaded.
+---@param scaleformName string
+---@param timeout number? Number of ticks to wait for the scaleform movie to load. Default is 500.
+---@return string? scaleformName
+function lib.requestScaleformMovie(scaleformName, timeout)
+    if HasScaleformMovieLoaded(scaleformName) then return scaleformName end
+
+    if type(scaleformName) ~= 'string' then
+        error(("expected scaleformName to have type 'string' (received %s)"):format(type(scaleformName)))
+    end
+
+    RequestScaleformMovie(scaleformName)
+
+    if coroutine.running() then
+        timeout = tonumber(timeout) or 500
+
+        for _ = 1, timeout do
+            if HasScaleformMovieLoaded(scaleformName) then
+                return scaleformName
+            end
+
+            Wait(0)
+        end
+
+        print(("failed to load scaleformName '%s' after %s ticks"):format(scaleformName, timeout))
+    end
+
+    return scaleformName
+end
+
+return lib.requestScaleformMovie
\ No newline at end of file