--- Vector class description.
    ---
    ---@class Vector
    ---
    ---@field X number
    local Vector = {}

    --- Returns the dot product of two vectors.
    ---
    ---@param v1 Vector
    ---@param v2 Vector
    ---
    ---@return number
    function Vector.Dot(v1, v2) end

cd Content/Documentation/scripting_api
python3 generate_stubs.py

your_project/
  .luarc.json
  library/
    wicked_engine_bindings.lua
  your_scripts.lua

{
  "$schema": "https://raw.githubusercontent.com/LuaLS/vscode-lua/master/setting/schema.json",
  "workspace": {
    "library": ["library/wicked_engine_bindings.lua"],
    "checkThirdParty": false
  },
  "runtime": {
    "version": "Lua 5.4"
  }
}

  "diagnostics": {
    "globals": [ "my_custom_global", "MY_CONSTANT" ]
  }

    --- Send a signal globally. This can wake up processes if there are any
    --- waiting on the same signal name.
    ---
    ---@param name string
    function signal(name) end

    --- Wait until a specified signal arrives.
    ---
    ---@param name string
    function waitSignal(name) end

    --- Start a new process.
    ---
    ---@param func fun()
    ---
    ---@return boolean success
    ---@return thread co
    function runProcess(func) end

    --- Stop and remove all processes.
    function killProcesses() end

    --- Stop and remove a single process, identified by its coroutine.
    ---
    ---@param co thread
    function killProcess(co) end

    --- Stop and remove all processes started from the given script PID.
    ---
    ---@param pid integer
    function killProcessPID(pid) end

    --- Stop and remove all processes started from the given script file.
    ---
    ---@param file string
    function killProcessFile(file) end

    --- Wait until some time has passed (to be used from inside a process).
    ---
    ---@param seconds number
    function waitSeconds(seconds) end

    --- Get reflection data from object.
    ---
    ---@param object table
    function getprops(object) end

    --- Get the length of a table.
    ---
    ---@param object table
    ---
    ---@return integer
    function len(object) end

    --- Post table contents to the backlog.
    ---
    ---@param list table
    function backlog_post_list(list) end

    --- Modifies the logging level.
    ---
    ---@param level LogLevel
    function backlog_setlevel(level) end

    --- Severity levels for backlog/console log messages.
    ---
    ---@enum LogLevel
    LogLevel = {
        None = 0,
        Default = 1,
        Warning = 2,
        Error = 3,
        Success = 4,
    }

    --- Wait for a fixed update step to be called (to be used from inside a
    --- process).
    function fixedupdate() end

    --- Wait for variable update step to be called (to be used from inside a
    --- process).
    function update() end

    --- Wait for a render step to be called (to be used from inside a process).
    function render() end

    --- Returns the delta time in seconds (time passed since previous update()).
    ---
    ---@return number
    function getDeltaTime() end

    --- Linear interpolation.
    ---
    ---@param a number
    ---@param b number
    ---@param t number
    ---
    ---@return number
    function math.lerp(a, b, t) end

    --- Inverse linear interpolation.
    ---
    ---@param a number
    ---@param b number
    ---@param t number
    ---
    ---@return number
    function math.inverse_lerp(a, b, t) end

    --- Inverse linear interpolation.
    ---
    ---@param a number
    ---@param b number
    ---@param t number
    ---
    ---@return number
    function math.inverselerp(a, b, t) end

    --- Clamp x between min and max.
    ---
    ---@param x number
    ---@param min number
    ---@param max number
    ---
    ---@return number
    function math.clamp(x, min, max) end

    --- Clamp x between 0 and 1.
    ---
    ---@param x number
    ---
    ---@return number
    function math.saturate(x) end

    --- Round x to nearest integer.
    ---
    ---@param x number
    ---
    ---@return number
    function math.round(x) end

    --- Executes a binary LUA file.
    ---
    ---@param filename string
    function dobinaryfile(filename) end

    --- Compiles a text LUA file (filename_src) into a binary LUA file
    --- (filename_dst).
    ---
    ---@param filename_src string
    ---@param dilename_dst string
    function compilebinaryfile(filename_src, dilename_dst) end

    --- Returns true if current application is the editor, false otherwise.
    ---
    ---@return boolean
    function IsThisEditor() end

    --- Returns control to the editor and kills running scripts.
    function ReturnToEditor() end

    --- Returns true if this is a debug build, false otherwise.
    ---
    ---@return boolean
    function IsThisDebugBuild() end

    --- Returns whether platform windows.
    ---
    ---@return boolean
    function IsPlatformWindows() end

    --- Returns whether platform linux.
    ---
    ---@return boolean
    function IsPlatformLinux() end

    --- Returns whether platform macos.
    ---
    ---@return boolean
    function IsPlatformMACOS() end

    --- Returns whether platform ios.
    ---
    ---@return boolean
    function IsPlatformIOS() end

    --- Returns whether platform ps5.
    ---
    ---@return boolean
    function IsPlatformPS5() end

    --- Returns whether platform xbox.
    ---
    ---@return boolean
    function IsPlatformXBOX() end

    --- Returns whether a file exists at the given path.
    ---
    ---@param name string
    ---
    ---@return boolean
    function FileExists(name) end

    --- Returns whether a directory exists at the given path.
    ---
    ---@param name string
    ---
    ---@return boolean
    function DirectoryExists(name) end

    --- Creates a directory at the given path (including parent directories).
    ---
    ---@param name string
    function DirectoryCreate(name) end

    --- Returns a path that files can be safely saved to on every platform. This
    --- is the base directory for such a path; files should be saved into an
    --- application-specific named folder within it.
    ---
    ---@return string
    function GetSaveDataPath() end

    --- Returns the engine major version number.
    ---
    ---@return integer
    function GetVersionMajor() end

    --- Returns the engine minor version number.
    ---
    ---@return integer
    function GetVersionMinor() end

    --- Returns the engine revision version number.
    ---
    ---@return integer
    function GetVersionRevision() end

    --- Returns the full engine version string.
    ---
    ---@return string
    function GetVersionString() end

    --- Returns the engine credits text.
    ---
    ---@return string
    function GetCreditsString() end

    --- Returns the engine supporters text.
    ---
    ---@return string
    function GetSupportersString() end

    --- Returns the file path of the currently running script
    --- (empty string if not available).
    ---
    ---@return string
    function script_file() end

    --- Returns the directory of the currently running script
    --- (empty string if not available).
    ---
    ---@return string
    function script_dir() end

    --- Returns the process id (PID) of the currently running script
    --- (0 if not available).
    ---
    ---@return integer
    function script_pid() end

    --- Removes all entries from the backlog.
    function backlog_clear() end

    --- Posts a string to the backlog.
    ---
    ---@param params string
    function backlog_post(params) end

    --- Sets the font size of the backlog.
    ---
    ---@param size integer
    function backlog_fontsize(size) end

    --- Returns whether the backlog is currently active (visible).
    ---
    ---@return boolean
    function backlog_isactive() end

    --- Sets the row spacing of the backlog text.
    ---
    ---@param spacing integer
    function backlog_fontrowspacing(spacing) end

    --- Opens (shows) the backlog console.
    function backlog_open() end

    --- Disables and locks the backlog so the HOME key won't bring it up.
    function backlog_lock() end

    --- Unlocks the backlog so it can be toggled with the HOME key.
    function backlog_unlock() end

    --- Disables Lua code execution from the backlog.
    function backlog_blocklua() end

    --- Re-enables Lua code execution from the backlog.
    function backlog_unblocklua() end

    --- Flushes pending backlog messages immediately.
    function backlog_flush() end

    --- Sets the interval (in milliseconds) at which the backlog auto-flushes
    --- pending messages.
    ---
    ---@param milliseconds integer
    function backlog_setautoflushinterval(milliseconds) end

    --- Returns the current game speed multiplier.
    ---
    ---@return number
    function GetGameSpeed() end

    --- Sets the game speed multiplier (1 = normal speed).
    ---
    ---@param speed number
    function SetGameSpeed(speed) end

    --- Deprecated: gamma is no longer supported.
    ---
    ---@deprecated
    ---
    ---@param value number
    function SetGamma(value) end

    --- Deprecated: resolution is now handled by window events.
    ---
    ---@deprecated
    function SetResolution() end

    --- Enables or disables vertical synchronization.
    ---
    ---@param enabled boolean
    function SetVSyncEnabled(enabled) end

    --- Returns whether the graphics device supports hardware ray tracing.
    ---
    ---@return boolean
    function IsRaytracingSupported() end

    --- Reloads all shaders.
    function ReloadShaders() end

    --- Clears the scene and the associated renderer resources. Clears the
    --- global scene if no scene is given.
    ---
    ---@param scene? Scene
    function ClearWorld(scene) end

    --- Deprecated: use application.GetCanvas().GetLogicalWidth() instead.
    ---
    ---@deprecated
    ---
    ---@return number
    function GetScreenWidth() end

    --- Deprecated: use application.GetCanvas().GetLogicalHeight() instead.
    ---
    ---@deprecated
    ---
    ---@return number
    function GetScreenHeight() end

    --- Sets the resolution of the 2D (spot and point light) shadow maps.
    ---
    ---@param resolution integer
    function SetShadowProps2D(resolution) end

    --- Sets the resolution of the cubemap (point light) shadow maps.
    ---
    ---@param resolution integer
    function SetShadowPropsCube(resolution) end

    --- Enables or disables the per-object shadow level-of-detail override.
    ---
    ---@param value boolean
    function SetShadowLODOverrideEnabled(value) end

    --- Enables or disables occlusion culling.
    ---
    ---@param enabled boolean
    function SetOcclusionCullingEnabled(enabled) end

    --- Enables or disables meshlet occlusion culling.
    ---
    ---@param value boolean
    function SetMeshletOcclusionCullingEnabled(value) end

    --- Allows or disallows the use of mesh shaders (if supported).
    ---
    ---@param enabled boolean
    function SetMeshShaderAllowed(enabled) end

    --- Enables or disables temporal anti-aliasing (TAA).
    ---
    ---@param value boolean
    function SetTemporalAAEnabled(value) end

    --- Enables or disables ray-traced shadows (requires hardware ray tracing).
    ---
    ---@param value boolean
    function SetRaytracedShadowsEnabled(value) end

    --- Enables or disables DDGI (dynamic diffuse global illumination).
    ---
    ---@param value boolean
    function SetDDGIEnabled(value) end

    --- Enables or disables capsule shadows.
    ---
    ---@param enabled boolean
    function SetCapsuleShadowEnabled(enabled) end

    --- Sets the capsule shadow fade-out distance.
    ---
    ---@param value number
    function SetCapsuleShadowFade(value) end

    --- Sets the capsule shadow cone angle, in radians.
    ---
    ---@param value number
    function SetCapsuleShadowAngle(value) end

    --- Enables or disables all debug drawing by the renderer.
    ---
    ---@param value boolean
    function SetDebugDrawEnabled(value) end

    --- Enables or disables drawing of object bounding boxes.
    ---
    ---@param enabled boolean
    function SetDebugBoxesEnabled(enabled) end

    --- Enables or disables drawing of the spatial partition tree.
    ---
    ---@param enabled boolean
    function SetDebugPartitionTreeEnabled(enabled) end

    --- Enables or disables drawing of armature bones.
    ---
    ---@param enabled boolean
    function SetDebugBonesEnabled(enabled) end

    --- Enables or disables drawing of particle emitters.
    ---
    ---@param enabled boolean
    function SetDebugEmittersEnabled(enabled) end

    --- Enables or disables drawing of environment probes.
    ---
    ---@param enabled boolean
    function SetDebugEnvProbesEnabled(enabled) end

    --- Enables or disables drawing of force fields.
    ---
    ---@param enabled boolean
    function SetDebugForceFieldsEnabled(enabled) end

    --- Enables or disables drawing of cameras.
    ---
    ---@param value boolean
    function SetDebugCamerasEnabled(value) end

    --- Enables or disables drawing of colliders.
    ---
    ---@param value boolean
    function SetDebugCollidersEnabled(value) end

    --- Enables or disables the light-culling debug visualization.
    ---
    ---@param enabled boolean
    function SetDebugLightCulling(enabled) end

    --- Enables or disables the grid helper overlay.
    ---
    ---@param value boolean
    function SetGridHelperEnabled(value) end

    --- Enables or disables the DDGI debug visualization.
    ---
    ---@param value boolean
    function SetDDGIDebugEnabled(value) end

    --- Queues a debug line from origin to end_, drawn for the current frame.
    ---
    ---@param origin Vector
    ---@param end_ Vector
    ---@param color? Vector
    ---@param depth? boolean
    function DrawLine(origin, end_, color, depth) end

    --- Queues a debug point, drawn for the current frame.
    ---
    ---@param origin Vector
    ---@param size? number
    ---@param color? Vector
    ---@param depth? boolean
    function DrawPoint(origin, size, color, depth) end

    --- Queues a debug wireframe box transformed by boxMatrix, drawn for the
    --- current frame.
    ---
    ---@param boxMatrix Matrix
    ---@param color? Vector
    ---@param depth? boolean
    function DrawBox(boxMatrix, color, depth) end

    --- Queues a debug wireframe sphere, drawn for the current frame.
    ---
    ---@param sphere Sphere
    ---@param color? Vector
    ---@param depth? boolean
    function DrawSphere(sphere, color, depth) end

    --- Queues a debug wireframe capsule, drawn for the current frame.
    ---
    ---@param capsule Capsule
    ---@param color? Vector
    ---@param depth? boolean
    function DrawCapsule(capsule, color, depth) end

    --- Queues debug text at a world position, drawn for the current frame.
    --- flags is a combination of DEBUG_TEXT_* values.
    ---
    ---@param text string
    ---@param position? Vector
    ---@param color? Vector
    ---@param scaling? number
    ---@param flags? integer
    function DrawDebugText(text, position, color, scaling, flags) end

    --- Debug text can be occluded by scene geometry (depth tested).
    ---
    ---@type integer
    DEBUG_TEXT_DEPTH_TEST = 1

    --- Debug text is rotated to always face the camera.
    ---
    ---@type integer
    DEBUG_TEXT_CAMERA_FACING = 2

    --- Debug text keeps a constant screen size regardless of distance.
    ---
    ---@type integer
    DEBUG_TEXT_CAMERA_SCALING = 4

    --- Draws the voxel grid in the debug rendering phase. The VoxelGrid object
    --- must not be destroyed until then.
    ---
    ---@param voxelgrid VoxelGrid
    function DrawVoxelGrid(voxelgrid) end

    --- Draws the path query in the debug rendering phase. The PathQuery object
    --- must not be destroyed until then.
    ---
    ---@param pathquery PathQuery
    function DrawPathQuery(pathquery) end

    --- Draws the trail in the debug rendering phase. The TrailRenderer object
    --- must not be destroyed until then.
    ---
    ---@param trail TrailRenderer
    function DrawTrail(trail) end

    --- Paints a brush stroke into a texture using the given PaintTextureParams.
    ---
    ---@param params PaintTextureParams
    function PaintIntoTexture(params) end

    --- Creates a texture that can be used as the destination of
    --- PaintIntoTexture.
    ---
    ---@param width integer
    ---@param height integer
    ---@param mips? integer
    ---@param initialColor? Vector
    ---
    ---@return Texture
    function CreatePaintableTexture(width, height, mips, initialColor) end

    --- Paints into a texture using an object's UV mapping, projecting a texture
    --- by a decal matrix (a way to bake skinned decals at runtime).
    ---
    ---@param params PaintDecalParams
    function PaintDecalIntoObjectSpaceTexture(params) end

    --- Puts down a water ripple using the default embedded asset.
    ---
    ---@param position Vector
    ---
    ---@overload fun(imagename: string, position: Vector)
    function PutWaterRipple(position) end

    --- Creates a PaintTextureParams object.
    ---
    ---@return PaintTextureParams
    function PaintTextureParams() end

    --- Parameters describing a brush stroke for PaintIntoTexture.
    ---
    ---@class PaintTextureParams
    local PaintTextureParams = {}

    --- Sets the texture that is edited (painted into).
    ---
    ---@param tex Texture
    function PaintTextureParams.SetEditTexture(tex) end

    --- Sets the brush texture (the stamp shape/pattern).
    ---
    ---@param tex Texture
    function PaintTextureParams.SetBrushTexture(tex) end

    --- Sets the reveal texture (used for reveal-style painting).
    ---
    ---@param tex Texture
    function PaintTextureParams.SetRevealTexture(tex) end

    --- Sets the brush color.
    ---
    ---@param value Vector
    function PaintTextureParams.SetBrushColor(value) end

    --- Sets the brush center, in pixels.
    ---
    ---@param value Vector
    function PaintTextureParams.SetCenterPixel(value) end

    --- Sets the brush radius, in pixels.
    ---
    ---@param value integer
    function PaintTextureParams.SetBrushRadius(value) end

    --- Sets the brush strength (how much each stroke applies).
    ---
    ---@param value number
    function PaintTextureParams.SetBrushAmount(value) end

    --- Sets the brush edge smoothness.
    ---
    ---@param value number
    function PaintTextureParams.SetBrushSmoothness(value) end

    --- Sets the brush rotation, in radians.
    ---
    ---@param value number
    function PaintTextureParams.SetBrushRotation(value) end

    --- Sets the brush shape.
    ---
    ---@param value integer
    function PaintTextureParams.SetBrushShape(value) end

    --- Creates a PaintDecalParams object.
    ---
    ---@return PaintDecalParams
    function PaintDecalParams() end

    --- Parameters describing a decal to bake into an object's texture with
    --- PaintDecalIntoObjectSpaceTexture.
    ---
    ---@class PaintDecalParams
    local PaintDecalParams = {}

    --- Sets the source texture (the decal image).
    ---
    ---@param tex Texture
    function PaintDecalParams.SetInTexture(tex) end

    --- Sets the destination texture (the object's texture).
    ---
    ---@param tex Texture
    function PaintDecalParams.SetOutTexture(tex) end

    --- Sets the decal matrix in world space.
    ---
    ---@param mat Matrix
    function PaintDecalParams.SetMatrix(mat) end

    --- Sets the target object entity; positions and UVs are taken from it.
    ---
    ---@param entity Entity
    function PaintDecalParams.SetObject(entity) end

    --- Adjusts decal fading based on surface slope relative to the decal
    --- projection (default 0: no slope blend).
    ---
    ---@param power number
    function PaintDecalParams.SetSlopeBlendPower(power) end

    --- Constructs a sprite, optionally from a texture and a mask texture file.
    ---
    ---@param texture? string
    ---@param maskTexture? string
    ---
    ---@return Sprite
    function Sprite(texture, maskTexture) end

    --- Render images on the screen.
    ---
    ---@class Sprite
    ---
    ---@field Params ImageParams
    ---@field Anim SpriteAnim
    local Sprite = {}

    --- Sets the rendering parameters (position, size, color, …) for the sprite.
    ---
    ---@param effects ImageParams
    function Sprite.SetParams(effects) end

    --- Returns the sprite's rendering parameters.
    ---
    ---@return ImageParams
    function Sprite.GetParams() end

    --- Sets the animation helper that drives this sprite.
    ---
    ---@param anim SpriteAnim
    function Sprite.SetAnim(anim) end

    --- Returns the sprite's animation helper.
    ---
    ---@return SpriteAnim
    function Sprite.GetAnim() end

    --- Sets the base color texture.
    ---
    ---@param texture Texture
    function Sprite.SetTexture(texture) end

    --- Returns the base color texture.
    ---
    ---@return Texture
    function Sprite.GetTexture() end

    --- Sets the mask texture (multiplied with the base color).
    ---
    ---@param texture Texture
    function Sprite.SetMaskTexture(texture) end

    --- Returns the mask texture.
    ---
    ---@return Texture
    function Sprite.GetMaskTexture() end

    --- Sets the background texture (used by the background effect).
    ---
    ---@param texture Texture
    function Sprite.SetBackgroundTexture(texture) end

    --- Returns the background texture.
    ---
    ---@return Texture
    function Sprite.GetBackgroundTexture() end

    --- Shows or hides the sprite.
    ---
    ---@param value boolean
    function Sprite.SetHidden(value) end

    --- Returns whether the sprite is hidden.
    ---
    ---@return boolean
    function Sprite.IsHidden() end

    --- Constructs image parameters. Called with two numbers they are the width
    --- and height (at position 0, 0); called with three or four they are posX,
    --- posY, width and height. Defaults: pos (0, 0), size (100, 100).
    ---
    ---@param posX number
    ---@param posY number
    ---@param width number
    ---@param height? number
    ---
    ---@return ImageParams
    ---
    ---@overload fun(width: number, height?: number): ImageParams
    function ImageParams(posX, posY, width, height) end

    ---@class ImageParams
    ---@field Pos Vector
    ---@field Size Vector
    ---@field Pivot Vector
    ---@field Color Vector
    ---@field Opacity number
    ---@field Fade number
    ---@field Rotation number
    ---@field TexOffset Vector
    ---@field TexOffset2 Vector
    local ImageParams = {}

    --- Returns the position.
    ---
    ---@return Vector
    function ImageParams.GetPos() end

    --- Returns the size.
    ---
    ---@return Vector
    function ImageParams.GetSize() end

    --- Returns the pivot point (rotation/scaling origin, in [0, 1] of the
    --- size).
    ---
    ---@return Vector
    function ImageParams.GetPivot() end

    --- Returns the color/tint (RGBA).
    ---
    ---@return Vector
    function ImageParams.GetColor() end

    --- Returns the opacity (alpha multiplier).
    ---
    ---@return number
    function ImageParams.GetOpacity() end

    --- Returns the saturation.
    ---
    ---@return number
    function ImageParams.GetSaturation() end

    --- Returns the fade amount (0: visible, 1: faded out).
    ---
    ---@return number
    function ImageParams.GetFade() end

    --- Returns the rotation in radians.
    ---
    ---@return number
    function ImageParams.GetRotation() end

    --- Returns the texture UV offset.
    ---
    ---@return Vector
    function ImageParams.GetTexOffset() end

    --- Returns the secondary texture UV offset.
    ---
    ---@return Vector
    function ImageParams.GetTexOffset2() end

    --- Returns the border soften amount.
    ---
    ---@return number
    function ImageParams.GetBorderSoften() end

    --- Returns the draw rectangle (x, y, width, height) in texture pixels.
    ---
    ---@return Vector
    function ImageParams.GetDrawRect() end

    --- Returns the secondary draw rectangle (x, y, width, height).
    ---
    ---@return Vector
    function ImageParams.GetDrawRect2() end

    --- Returns whether the draw rectangle is enabled.
    ---
    ---@return boolean
    function ImageParams.IsDrawRectEnabled() end

    --- Returns whether the secondary draw rectangle is enabled.
    ---
    ---@return boolean
    function ImageParams.IsDrawRect2Enabled() end

    --- Returns whether horizontal mirroring is enabled.
    ---
    ---@return boolean
    function ImageParams.IsMirrorEnabled() end

    --- Returns whether the background blur is enabled.
    ---
    ---@return boolean
    function ImageParams.IsBackgroundBlurEnabled() end

    --- Returns whether the background is enabled.
    ---
    ---@return boolean
    function ImageParams.IsBackgroundEnabled() end

    --- Returns whether the distortion mask is enabled.
    ---
    ---@return boolean
    function ImageParams.IsDistortionMaskEnabled() end

    --- Sets the position.
    ---
    ---@param pos Vector
    function ImageParams.SetPos(pos) end

    --- Sets the size.
    ---
    ---@param size Vector
    function ImageParams.SetSize(size) end

    --- Sets the pivot point (rotation/scaling origin, in [0, 1] of the size).
    ---
    ---@param value Vector
    function ImageParams.SetPivot(value) end

    --- Sets the color/tint (RGBA).
    ---
    ---@param value Vector
    function ImageParams.SetColor(value) end

    --- Sets the opacity (alpha multiplier).
    ---
    ---@param opacity number
    function ImageParams.SetOpacity(opacity) end

    --- Sets the saturation.
    ---
    ---@param saturation number
    function ImageParams.SetSaturation(saturation) end

    --- Sets the fade amount (0: visible, 1: faded out).
    ---
    ---@param fade number
    function ImageParams.SetFade(fade) end

    --- Sets the stencil test mode and reference value.
    ---
    ---@param stencilMode integer one of the STENCILMODE_* constants
    ---@param stencilRef integer
    function ImageParams.SetStencil(stencilMode, stencilRef) end

    --- Sets how the stencil reference value is interpreted.
    ---
    ---@param stencilRefMode integer one of the STENCILREFMODE_* constants
    function ImageParams.SetStencilRefMode(stencilRefMode) end

    --- Sets the blend mode (one of the BLENDMODE_* constants).
    ---
    ---@param blendMode integer
    function ImageParams.SetBlendMode(blendMode) end

    --- Sets the sampling quality (one of the QUALITY_* constants).
    ---
    ---@param quality integer
    function ImageParams.SetQuality(quality) end

    --- Sets the texture addressing mode (one of the SAMPLEMODE_* constants).
    ---
    ---@param sampleMode integer
    function ImageParams.SetSampleMode(sampleMode) end

    --- Sets the rotation in radians.
    ---
    ---@param rotation number
    function ImageParams.SetRotation(rotation) end

    --- Sets the texture UV offset.
    ---
    ---@param value Vector
    function ImageParams.SetTexOffset(value) end

    --- Sets the secondary texture UV offset.
    ---
    ---@param value Vector
    function ImageParams.SetTexOffset2(value) end

    --- Sets the border soften amount.
    ---
    ---@param alpha number
    function ImageParams.SetBorderSoften(alpha) end

    --- Enables the draw rectangle (x, y, width, height) in texture pixels.
    ---
    ---@param value Vector
    function ImageParams.EnableDrawRect(value) end

    --- Enables the secondary draw rectangle (x, y, width, height).
    ---
    ---@param value Vector
    function ImageParams.EnableDrawRect2(value) end

    --- Disables the draw rectangle.
    function ImageParams.DisableDrawRect() end

    --- Disables the secondary draw rectangle.
    function ImageParams.DisableDrawRect2() end

    --- Enables horizontal mirroring.
    function ImageParams.EnableMirror() end

    --- Disables horizontal mirroring.
    function ImageParams.DisableMirror() end

    --- Enables the background blur effect.
    function ImageParams.EnableBackgroundBlur() end

    --- Disables the background blur effect.
    function ImageParams.DisableBackgroundBlur() end

    --- Enables drawing the background.
    function ImageParams.EnableBackground() end

    --- Disables drawing the background.
    function ImageParams.DisableBackground() end

    --- Enables using the mask texture as a distortion mask.
    function ImageParams.EnableDistortionMask() end

    --- Disables the distortion mask.
    function ImageParams.DisableDistortionMask() end

    --- Sets the alpha range used when masking (start and end thresholds).
    ---
    ---@param start number
    ---@param end_ number
    function ImageParams.SetMaskAlphaRange(start, end_) end

    --- Returns the mask alpha range as start, end.
    ---
    ---@return number range_start
    ---@return number range_end
    function ImageParams.GetMaskAlphaRange() end

    --- Sets the direction of the angular softness effect.
    ---
    ---@param value Vector
    function ImageParams.SetAngularSoftnessDirection(value) end

    --- Sets the inner angle of the angular softness effect.
    ---
    ---@param value number
    function ImageParams.SetAngularSoftnessInnerAngle(value) end

    --- Sets the outer angle of the angular softness effect.
    ---
    ---@param value number
    function ImageParams.SetAngularSoftnessOuterAngle(value) end

    --- Enables double-sided angular softness.
    function ImageParams.EnableAngularSoftnessDoubleSided() end

    --- Inverts the angular softness effect.
    function ImageParams.EnableAngularSoftnessInverse() end

    --- Disables double-sided angular softness.
    function ImageParams.DisableAngularSoftnessDoubleSided() end

    --- Disables inverted angular softness.
    function ImageParams.DisableAngularSoftnessInverse() end

    --- Enables rounded corners.
    function ImageParams.EnableCornerRounding() end

    --- Disables rounded corners.
    function ImageParams.DisableCornerRounding() end

    --- Sets the rounding of one corner (0-3) with a radius and segment count.
    ---
    ---@param corner integer corner index in [0, 3]
    ---@param rounding number corner radius
    ---@param segments? integer subdivision count (default 18)
    function ImageParams.SetCornerRounding(corner, rounding, segments) end

    --- Fills the image with a gradient between two UV coordinates.
    ---
    ---@param type ImageGradientType
    ---@param uv_start Vector
    ---@param uv_end Vector
    ---@param color Vector
    function ImageParams.SetGradient(type, uv_start, uv_end, color) end

    -- Stencil comparison modes (use with SetStencil).
    STENCILMODE_DISABLED = 0
    STENCILMODE_EQUAL = 1
    STENCILMODE_LESS = 2
    STENCILMODE_LESSEQUAL = 3
    STENCILMODE_GREATER = 4
    STENCILMODE_GREATEREQUAL = 5
    STENCILMODE_NOT = 6
    STENCILMODE_ALWAYS = 7

    -- How the stencil reference value is interpreted (use with
    -- SetStencilRefMode).
    STENCILREFMODE_ENGINE = 0
    STENCILREFMODE_USER = 1
    STENCILREFMODE_ALL = 2

    -- Texture addressing modes (use with SetSampleMode).
    SAMPLEMODE_CLAMP = 0
    SAMPLEMODE_WRAP = 1
    SAMPLEMODE_MIRROR = 2

    -- Sampling quality (use with SetQuality).
    QUALITY_NEAREST = 0
    QUALITY_LINEAR = 1
    QUALITY_ANISOTROPIC = 2
    QUALITY_BICUBIC = 3

    -- Blend modes (use with SetBlendMode).
    BLENDMODE_OPAQUE = 0
    BLENDMODE_ALPHA = 1
    BLENDMODE_PREMULTIPLIED = 2
    BLENDMODE_ADDITIVE = 3

    ---@enum ImageGradientType
    ImageGradientType = {
        None = 0,
        Linear = 1,
        LinearReflected = 2,
        Circular = 3,
    }

    --- Constructs a sprite animation helper.
    ---
    ---@return SpriteAnim
    function SpriteAnim() end

    --- Animate Sprites easily with this helper.
    ---
    ---@class SpriteAnim
    ---
    ---@field Rot number
    ---@field Rotation number
    ---@field Opacity number
    ---@field Fade number
    ---@field Repeatable boolean
    ---@field Velocity Vector
    ---@field ScaleX number
    ---@field ScaleY number
    ---@field MovingTexAnim MovingTexAnim
    ---@field DrawRecAnim DrawRectAnim
    local SpriteAnim = {}

    --- Sets the per-second rotation offset used by the wobble effect.
    ---
    ---@param val number
    function SpriteAnim.SetRot(val) end

    --- Sets the per-second rotation speed.
    ---
    ---@param val number
    function SpriteAnim.SetRotation(val) end

    --- Sets the per-second opacity change.
    ---
    ---@param val number
    function SpriteAnim.SetOpacity(val) end

    --- Sets the per-second fade change.
    ---
    ---@param val number
    function SpriteAnim.SetFade(val) end

    --- Sets the wobble animation amount.
    ---
    ---@param val number
    function SpriteAnim.SetWobbleAnimAmount(val) end

    --- Sets the wobble animation speed.
    ---
    ---@param val number
    function SpriteAnim.SetWobbleAnimSpeed(val) end

    --- Sets whether the animation repeats.
    ---
    ---@param val boolean
    function SpriteAnim.SetRepeatable(val) end

    --- Sets the per-second position velocity.
    ---
    ---@param val Vector
    function SpriteAnim.SetVelocity(val) end

    --- Sets the per-second horizontal scale change.
    ---
    ---@param val number
    function SpriteAnim.SetScaleX(val) end

    --- Sets the per-second vertical scale change.
    ---
    ---@param val number
    function SpriteAnim.SetScaleY(val) end

    --- Sets the moving-texture sub-animation.
    ---
    ---@param val MovingTexAnim
    function SpriteAnim.SetMovingTexAnim(val) end

    --- Sets the frame-by-frame draw-rectangle sub-animation.
    ---
    ---@param val DrawRectAnim
    function SpriteAnim.SetDrawRecAnim(val) end

    --- Returns the per-second rotation offset.
    ---
    ---@return number
    function SpriteAnim.GetRot() end

    --- Returns the per-second rotation speed.
    ---
    ---@return number
    function SpriteAnim.GetRotation() end

    --- Returns the per-second opacity change.
    ---
    ---@return number
    function SpriteAnim.GetOpacity() end

    --- Returns the per-second fade change.
    ---
    ---@return number
    function SpriteAnim.GetFade() end

    --- Returns whether the animation repeats.
    ---
    ---@return boolean
    function SpriteAnim.GetRepeatable() end

    --- Returns the per-second position velocity.
    ---
    ---@return Vector
    function SpriteAnim.GetVelocity() end

    --- Returns the per-second horizontal scale change.
    ---
    ---@return number
    function SpriteAnim.GetScaleX() end

    --- Returns the per-second vertical scale change.
    ---
    ---@return number
    function SpriteAnim.GetScaleY() end

    --- Returns the moving-texture sub-animation.
    ---
    ---@return MovingTexAnim
    function SpriteAnim.GetMovingTexAnim() end

    --- Returns the frame-by-frame draw-rectangle sub-animation.
    ---
    ---@return DrawRectAnim
    function SpriteAnim.GetDrawRecAnim() end

    --- Constructs a moving-texture animation, optionally with X and Y speeds.
    ---
    ---@param speedX? number
    ---@param speedY? number
    ---
    ---@return MovingTexAnim
    function MovingTexAnim(speedX, speedY) end

    --- Scroll a sprite's texture continuously.
    ---
    ---@class MovingTexAnim
    ---
    ---@field SpeedX number
    ---@field SpeedY number
    local MovingTexAnim = {}

    --- Sets the horizontal scroll speed.
    ---
    ---@param val number
    function MovingTexAnim.SetSpeedX(val) end

    --- Sets the vertical scroll speed.
    ---
    ---@param val number
    function MovingTexAnim.SetSpeedY(val) end

    --- Returns the horizontal scroll speed.
    ---
    ---@return number
    function MovingTexAnim.GetSpeedX() end

    --- Returns the vertical scroll speed.
    ---
    ---@return number
    function MovingTexAnim.GetSpeedY() end

    --- Constructs a frame-by-frame draw-rectangle animation.
    ---
    ---@return DrawRectAnim
    function DrawRectAnim() end

    --- Animate a sprite frame by frame from a sprite sheet.
    ---
    ---@class DrawRectAnim
    ---
    ---@field FrameRate number
    ---@field FrameCount integer
    ---@field HorizontalFrameCount integer
    local DrawRectAnim = {}

    --- Sets the playback frame rate (frames per second).
    ---
    ---@param val number
    function DrawRectAnim.SetFrameRate(val) end

    --- Sets the total number of frames.
    ---
    ---@param val integer
    function DrawRectAnim.SetFrameCount(val) end

    --- Sets the number of frames per row in the sprite sheet.
    ---
    ---@param val integer
    function DrawRectAnim.SetHorizontalFrameCount(val) end

    --- Returns the playback frame rate.
    ---
    ---@return number
    function DrawRectAnim.GetFrameRate() end

    --- Returns the total number of frames.
    ---
    ---@return integer
    function DrawRectAnim.GetFrameCount() end

    --- Returns the number of frames per row.
    ---
    ---@return integer
    function DrawRectAnim.GetHorizontalFrameCount() end

    --- Constructs a sprite font, optionally with initial text.
    ---
    ---@param text? string
    ---
    ---@return SpriteFont
    function SpriteFont(text) end

    --- Render text with a custom font.
    ---
    ---@class SpriteFont
    ---
    ---@field Text string
    ---@field Size integer
    ---@field Pos Vector
    ---@field Spacing Vector
    ---@field Align integer
    ---@field Color Vector
    ---@field ShadowColor Vector
    ---@field Bolden number
    ---@field Softness number
    ---@field ShadowBolden number
    ---@field ShadowSoftness number
    ---@field ShadowOffset Vector
    local SpriteFont = {}

    --- Sets the font style (typeface) by name, with an optional pixel size.
    ---
    ---@param fontstyle string
    ---@param size? integer font size in pixels (default 16)
    function SpriteFont.SetStyle(fontstyle, size) end

    --- Sets the displayed text (empty string if omitted).
    ---
    ---@param text? string
    function SpriteFont.SetText(text) end

    --- Sets the font size in pixels.
    ---
    ---@param size integer
    function SpriteFont.SetSize(size) end

    --- Sets an additional uniform scale applied on top of the size.
    ---
    ---@param scale number
    function SpriteFont.SetScale(scale) end

    --- Sets the screen position.
    ---
    ---@param pos Vector
    function SpriteFont.SetPos(pos) end

    --- Sets the horizontal and vertical spacing between characters and lines.
    ---
    ---@param spacing Vector
    function SpriteFont.SetSpacing(spacing) end

    --- Sets the horizontal and (optional) vertical alignment.
    ---
    ---@param halign integer one of the WIFALIGN_* constants
    ---@param valign? integer one of the WIFALIGN_* constants
    function SpriteFont.SetAlign(halign, valign) end

    --- Sets the text color, as a Vector (RGBA) or a packed hex color code.
    ---
    ---@param color Vector
    ---
    ---@overload fun(colorHexCode: integer)
    function SpriteFont.SetColor(color) end

    --- Sets the shadow color, as a Vector (RGBA) or a packed hex color code.
    ---
    ---@param shadowcolor Vector
    ---
    ---@overload fun(colorHexCode: integer)
    function SpriteFont.SetShadowColor(shadowcolor) end

    --- Sets how much the glyphs are bold.
    ---
    ---@param value number
    function SpriteFont.SetBolden(value) end

    --- Sets the glyph edge softness.
    ---
    ---@param value number
    function SpriteFont.SetSoftness(value) end

    --- Sets how much the shadow glyphs are bold.
    ---
    ---@param value number
    function SpriteFont.SetShadowBolden(value) end

    --- Sets the shadow edge softness.
    ---
    ---@param value number
    function SpriteFont.SetShadowSoftness(value) end

    --- Sets the shadow offset.
    ---
    ---@param value Vector
    function SpriteFont.SetShadowOffset(value) end

    --- Sets the width at which text wraps (<= 0 disables wrapping).
    ---
    ---@param value number
    function SpriteFont.SetHorizontalWrapping(value) end

    --- Shows or hides the text.
    ---
    ---@param value boolean
    function SpriteFont.SetHidden(value) end

    --- Enables flipping the letters horizontally.
    ---
    ---@param value boolean
    function SpriteFont.SetFlippedHorizontally(value) end

    --- Enables flipping the letters vertically.
    ---
    ---@param value boolean
    function SpriteFont.SetFlippedVertically(value) end

    --- Returns the displayed text.
    ---
    ---@return string
    function SpriteFont.GetText() end

    --- Returns the font size in pixels.
    ---
    ---@return integer
    function SpriteFont.GetSize() end

    --- Returns the additional uniform scale.
    ---
    ---@return number
    function SpriteFont.GetScale() end

    --- Returns the screen position.
    ---
    ---@return Vector
    function SpriteFont.GetPos() end

    --- Returns the character and line spacing.
    ---
    ---@return Vector
    function SpriteFont.GetSpacing() end

    --- Returns the horizontal and vertical alignment.
    ---
    ---@return integer halign
    ---@return integer valign
    function SpriteFont.GetAlign() end

    --- Returns the text color.
    ---
    ---@return Vector
    function SpriteFont.GetColor() end

    --- Returns the shadow color.
    ---
    ---@return Vector
    function SpriteFont.GetShadowColor() end

    --- Returns how much the glyphs are bold.
    ---
    ---@return number
    function SpriteFont.GetBolden() end

    --- Returns the glyph edge softness.
    ---
    ---@return number
    function SpriteFont.GetSoftness() end

    --- Returns how much the shadow glyphs are bold.
    ---
    ---@return number
    function SpriteFont.GetShadowBolden() end

    --- Returns the shadow edge softness.
    ---
    ---@return number
    function SpriteFont.GetShadowSoftness() end

    --- Returns the shadow offset.
    ---
    ---@return Vector
    function SpriteFont.GetShadowOffset() end

    --- Returns the wrapping width.
    ---
    ---@return number
    function SpriteFont.GetHorizontalWrapping() end

    --- Returns whether the text is hidden.
    ---
    ---@return boolean
    function SpriteFont.IsHidden() end

    --- Returns whether the letters are flipped horizontally.
    ---
    ---@return boolean
    function SpriteFont.IsFlippedHorizontally() end

    --- Returns whether the letters are flipped vertically.
    ---
    ---@return boolean
    function SpriteFont.IsFlippedVertically() end

    --- Returns the rendered text width and height in a Vector's X and Y.
    ---
    ---@return Vector
    function SpriteFont.TextSize() end

    --- Sets the time to fully type the text, in seconds (0 disables
    --- typewriting).
    ---
    ---@param value number
    function SpriteFont.SetTypewriterTime(value) end

    --- Sets whether the typewriter animation restarts when finished.
    ---
    ---@param value boolean
    function SpriteFont.SetTypewriterLooped(value) end

    --- Sets the character index the typewriter animation starts from.
    ---
    ---@param value integer
    function SpriteFont.SetTypewriterCharacterStart(value) end

    --- Sets a sound effect played as each new letter appears.
    ---
    ---@param sound Sound
    ---@param soundinstance SoundInstance
    function SpriteFont.SetTypewriterSound(sound, soundinstance) end

    --- Resets the typewriter animation to the first character.
    ---
    function SpriteFont.ResetTypewriter() end

    --- Finishes the typewriter animation immediately.
    ---
    function SpriteFont.TypewriterFinish() end

    --- Returns whether the typewriter animation has finished.
    ---
    ---@return boolean
    function SpriteFont.IsTypewriterFinished() end

    WIFALIGN_LEFT = 0
    WIFALIGN_CENTER = 1
    WIFALIGN_RIGHT = 2
    WIFALIGN_TOP = 3
    WIFALIGN_BOTTOM = 4

    --- Creates a texture. With a filename, loads the image from file; with no
    --- argument, returns an empty (invalid) texture handle.
    ---
    ---@param filename? string
    ---
    ---@return Texture
    function Texture(filename) end

    --- A 2D texture image, loaded from file or created procedurally.
    ---
    ---@class Texture
    local Texture = {}

    --- Returns whether the texture contains valid data (was created or loaded
    --- successfully).
    ---
    ---@return boolean
    function Texture.IsValid() end

    --- Returns the width of the texture in pixels.
    ---
    ---@return integer
    function Texture.GetWidth() end

    --- Returns the height of the texture in pixels.
    ---
    ---@return integer
    function Texture.GetHeight() end

    --- Returns the depth of the texture (for 3D/volume textures).
    ---
    ---@return integer
    function Texture.GetDepth() end

    --- Returns the number of slices in the texture array.
    ---
    ---@return integer
    function Texture.GetArraySize() end

    --- Saves the texture to a file. The extension in the filename selects the
    --- format and must be one of: .JPG, .PNG, .TGA, .BMP, .DDS.
    ---
    ---@param filename string
    function Texture.Save(filename) end

    --- Sets the highest allowed texture asset resolution (only affects DDS
    --- textures that contain mipmaps).
    ---
    ---@param resolution integer
    function SetTextureResolutionLimit(resolution) end

    --- Returns the current texture resolution limit.
    ---
    ---@return integer
    function GetTextureResolutionLimit() end

    --- A global utility object for creating textures programmatically. It
    --- shares the `Texture` type, so the handles it returns expose the query
    --- methods above.
    ---
    ---@class TextureHelper
    local TextureHelper = {}

    --- Global helper for creating textures programmatically.
    ---
    ---@type TextureHelper
    texturehelper = nil

    --- Returns the built-in Wicked Engine logo texture.
    ---
    ---@return Texture
    function TextureHelper.GetLogo() end

    --- Creates a gradient texture from the given parameters.
    ---
    ---@param type GradientType kind of gradient to generate
    ---@param width? integer texture width in pixels (default 256)
    ---@param height? integer texture height in pixels (default 256)
    ---@param uv_start? Vector gradient start UV (default Vector(0, 0))
    ---@param uv_end? Vector gradient end UV (default Vector(0, 0))
    ---@param flags? GradientFlags modifier flags (default GradientFlags.None)
    ---@param swizzle? string per-channel swizzle (default "rgba")
    ---@param perlin_scale? number perlin noise scale (default 1)
    ---@param perlin_seed? integer perlin noise seed (default 1234)
    ---@param perlin_octaves? integer perlin noise octaves (default 8)
    ---@param perlin_persistence? number perlin noise persistence (default 0.5)
    ---
    ---@return Texture
    function TextureHelper.CreateGradientTexture(
        type,
        width,
        height,
        uv_start,
        uv_end,
        flags,
        swizzle,
        perlin_scale,
        perlin_seed,
        perlin_octaves,
        perlin_persistence
    ) end

    --- Creates a lens distortion normal map (16-bit precision).
    ---
    ---@param width? integer texture width in pixels (default 256)
    ---@param height? integer texture height in pixels (default 256)
    ---@param uv_start? Vector distortion center UV (default Vector(0.5, 0.5))
    ---@param radius? number distortion radius (default 0.5)
    ---@param squish? number vertical squish factor (default 1)
    ---@param blend? number blend amount (default 1)
    ---@param edge_smoothness? number edge smoothness (default 0.04)
    ---
    ---@return Texture
    function TextureHelper.CreateLensDistortionNormalMap(
        width,
        height,
        uv_start,
        radius,
        squish,
        blend,
        edge_smoothness
    ) end

    --- Gradient shapes for texturehelper.CreateGradientTexture.
    ---
    ---@enum GradientType
    GradientType = {
        Linear = 0,
        Circular = 1,
        Angular = 2,
    }

    --- Modifier flags for texturehelper.CreateGradientTexture (combine with
    --- bitwise or).
    ---
    ---@enum GradientFlags
    GradientFlags = {
        None = 0,
        Inverse = 1 << 0,
        Smoothstep = 1 << 1,
        PerlinNoise = 1 << 2,
        R16Unorm = 1 << 3,
    }

    -- Example usage (sprite/material are placeholders for your own objects).
    ---@diagnostic disable: undefined-global, param-type-mismatch
    texture = texturehelper.CreateGradientTexture(
        GradientType.Circular, -- gradient type
        256, 256, -- resolution of the texture
        -- start and end UV coordinates set the gradient direction and extent:
        Vector(0.5, 0.5), Vector(0.5, 0),
        -- modifier flags (bitwise combination):
        GradientFlags.Inverse | GradientFlags.Smoothstep
            | GradientFlags.PerlinNoise,
        -- per channel, one of: 0, 1, r, g, b, a, x, y, z, w (lower or upper
        -- case):
        "rrr1",
        2, -- perlin noise scale
        123, -- perlin noise seed
        6, -- perlin noise octaves
        0.8 -- perlin noise persistence
    )
    texture.Save("gradient.png") -- save it to a file
    sprite.SetTexture(texture) -- assign it to a sprite
    material.SetTexture(TextureSlot.BASECOLORMAP, texture) -- to a material

    --- Creates an Audio object. Use the global `audio` instead of constructing
    --- one.
    ---
    ---@return Audio
    function Audio() end

    --- Loads and plays an audio files.
    ---
    ---@class Audio
    local Audio = {}

    --- The audio device.
    ---
    ---@type Audio
    audio = nil

    --- Creates a sound file, returns true if successful, false otherwise.
    ---
    ---@param filename string
    ---@param sound Sound
    ---
    ---@return boolean
    function Audio.CreateSound(filename, sound) end

    --- Creates a sound instance that can be replayed, returns true if
    --- successful, false otherwise.
    ---
    ---@param sound Sound
    ---@param soundinstance SoundInstance
    ---
    ---@return boolean
    function Audio.CreateSoundInstance(sound, soundinstance) end

    --- Plays the audio.
    ---
    ---@param soundinstance SoundInstance
    function Audio.Play(soundinstance) end

    --- Pauses the audio.
    ---
    ---@param soundinstance SoundInstance
    function Audio.Pause(soundinstance) end

    --- Stops the audio.
    ---
    ---@param soundinstance SoundInstance
    function Audio.Stop(soundinstance) end

    --- Returns the volume of a `soundinstance`. If `soundinstance` is not
    --- provided, returns the master volume.
    ---
    ---@param soundinstance? SoundInstance
    ---
    ---@return number
    function Audio.GetVolume(soundinstance) end

    --- Sets the volume of a `soundinstance`. If `soundinstance` is not
    --- provided, sets the master volume.
    ---
    ---@param volume number
    ---@param soundinstance? SoundInstance
    function Audio.SetVolume(volume, soundinstance) end

    --- Disable looping. By default, sound instances are looped when created.
    ---
    ---@param soundinstance SoundInstance
    function Audio.ExitLoop(soundinstance) end

    --- Returns the volume of the submix group.
    ---
    ---@param submixtype integer
    ---
    ---@return number
    function Audio.GetSubmixVolume(submixtype) end

    --- Sets the volume for a submix group.
    ---
    ---@param submixtype integer
    ---@param volume number
    function Audio.SetSubmixVolume(submixtype, volume) end

    --- Adds 3D effect to the sound instance.
    ---
    ---@param soundinstance SoundInstance
    ---@param instance3D SoundInstance3D
    function Audio.Update3D(soundinstance, instance3D) end

    --- Sets an environment effect for reverb globally. Refer to Reverb Types
    --- section for acceptable input values.
    ---
    ---@param reverbtype integer
    function Audio.SetReverb(reverbtype) end

    --- Creates a sound. With a filename it loads the sound from file; with no
    --- argument it creates an empty sound.
    ---
    ---@param name? string
    ---
    ---@return Sound
    function Sound(name) end

    --- An audio file. Can be instanced several times via SoundInstance.
    ---
    ---@class Sound
    local Sound = {}

    --- Returns whether the sound was created successfully.
    ---
    ---@return boolean
    function Sound.IsValid() end

    --- Creates a sound instance. With a sound it is created from that sound
    --- (with optional begin offset and length in seconds); with no argument it
    --- creates an empty instance.
    ---
    ---@param sound? Sound
    ---@param begin? number
    ---@param length? number
    ---
    ---@return SoundInstance
    function SoundInstance(sound, begin, length) end

    --- An audio file instance that can be played. Note: after modifying
    --- parameters of the SoundInstance, the SoundInstance will need to be
    --- recreated from a specified sound.
    ---
    ---@class SoundInstance
    local SoundInstance = {}

    --- Set a submix type group (default is SUBMIX_TYPE_SOUNDEFFECT).
    ---
    ---@param submixtype integer
    function SoundInstance.SetSubmixType(submixtype) end

    --- Beginning of the playback in seconds, relative to the Sound it will be
    --- created from (0 = from beginning).
    ---
    ---@param seconds number
    function SoundInstance.SetBegin(seconds) end

    --- Length in seconds (0 = until end).
    ---
    ---@param seconds number
    function SoundInstance.SetLength(seconds) end

    --- Loop region begin in seconds, relative to the instance begin time (0 =
    --- from beginning).
    ---
    ---@param seconds number
    function SoundInstance.SetLoopBegin(seconds) end

    --- Loop region length in seconds (0 = until the end).
    ---
    ---@param seconds number
    function SoundInstance.SetLoopLength(seconds) end

    --- Enable/disable reverb for the sound instance.
    ---
    ---@param value boolean
    function SoundInstance.SetEnableReverb(value) end

    --- Enable/disable looping for the sound instance.
    ---
    ---@param value boolean
    function SoundInstance.SetLooped(value) end

    --- Returns the submix type.
    ---
    ---@return integer
    function SoundInstance.GetSubmixType() end

    --- Returns the begin.
    ---
    ---@return number
    function SoundInstance.GetBegin() end

    --- Returns the length.
    ---
    ---@return number
    function SoundInstance.GetLength() end

    --- Returns the loop begin.
    ---
    ---@return number
    function SoundInstance.GetLoopBegin() end

    --- Returns the loop length.
    ---
    ---@return number
    function SoundInstance.GetLoopLength() end

    --- Returns whether reverb is enabled.
    ---
    ---@return boolean
    function SoundInstance.IsEnableReverb() end

    --- Returns whether looped is enabled.
    ---
    ---@return boolean
    function SoundInstance.IsLooped() end

    --- Returns whether the sound instance was created successfully.
    ---
    ---@return boolean
    function SoundInstance.IsValid() end

    --- Creates the 3D relation object. By default, the listener and emitter are
    --- on the same position, and that disables the 3D effect.
    ---
    ---@return SoundInstance3D
    function SoundInstance3D() end

    --- Describes the relation between a sound instance and a listener in a 3D
    --- world.
    ---
    ---@class SoundInstance3D
    local SoundInstance3D = {}

    --- Sets the listener position.
    ---
    ---@param value Vector
    function SoundInstance3D.SetListenerPos(value) end

    --- Sets the listener up.
    ---
    ---@param value Vector
    function SoundInstance3D.SetListenerUp(value) end

    --- Sets the listener front.
    ---
    ---@param value Vector
    function SoundInstance3D.SetListenerFront(value) end

    --- Sets the listener velocity.
    ---
    ---@param value Vector
    function SoundInstance3D.SetListenerVelocity(value) end

    --- Sets the emitter position.
    ---
    ---@param value Vector
    function SoundInstance3D.SetEmitterPos(value) end

    --- Sets the emitter up.
    ---
    ---@param value Vector
    function SoundInstance3D.SetEmitterUp(value) end

    --- Sets the emitter front.
    ---
    ---@param value Vector
    function SoundInstance3D.SetEmitterFront(value) end

    --- Sets the emitter velocity.
    ---
    ---@param value Vector
    function SoundInstance3D.SetEmitterVelocity(value) end

    --- Sets the emitter radius.
    ---
    ---@param radius number
    function SoundInstance3D.SetEmitterRadius(radius) end

    --- Sound effect group.
    ---
    ---@type integer
    SUBMIX_TYPE_SOUNDEFFECT = 0

    --- Music group.
    ---
    ---@type integer
    SUBMIX_TYPE_MUSIC = 1

    --- User submix group.
    ---
    ---@type integer
    SUBMIX_TYPE_USER0 = 2

    --- uUer submix group.
    ---
    ---@type integer
    SUBMIX_TYPE_USER1 = 3

    --- REVERB PRESET DEFAULT.
    ---
    ---@type integer
    REVERB_PRESET_DEFAULT = 0

    --- REVERB PRESET GENERIC.
    ---
    ---@type integer
    REVERB_PRESET_GENERIC = 1

    --- REVERB PRESET FOREST.
    ---
    ---@type integer
    REVERB_PRESET_FOREST = 2

    --- REVERB PRESET PADDEDCELL.
    ---
    ---@type integer
    REVERB_PRESET_PADDEDCELL = 3

    --- REVERB PRESET ROOM.
    ---
    ---@type integer
    REVERB_PRESET_ROOM = 4

    --- REVERB PRESET BATHROOM.
    ---
    ---@type integer
    REVERB_PRESET_BATHROOM = 5

    --- REVERB PRESET LIVINGROOM.
    ---
    ---@type integer
    REVERB_PRESET_LIVINGROOM = 6

    --- REVERB PRESET STONEROOM.
    ---
    ---@type integer
    REVERB_PRESET_STONEROOM = 7

    --- REVERB PRESET AUDITORIUM.
    ---
    ---@type integer
    REVERB_PRESET_AUDITORIUM = 8

    --- REVERB PRESET CONCERTHALL.
    ---
    ---@type integer
    REVERB_PRESET_CONCERTHALL = 9

    --- REVERB PRESET CAVE.
    ---
    ---@type integer
    REVERB_PRESET_CAVE = 10

    --- REVERB PRESET ARENA.
    ---
    ---@type integer
    REVERB_PRESET_ARENA = 11

    --- REVERB PRESET HANGAR.
    ---
    ---@type integer
    REVERB_PRESET_HANGAR = 12

    --- REVERB PRESET CARPETEDHALLWAY.
    ---
    ---@type integer
    REVERB_PRESET_CARPETEDHALLWAY = 13

    --- REVERB PRESET HALLWAY.
    ---
    ---@type integer
    REVERB_PRESET_HALLWAY = 14

    --- REVERB PRESET STONECORRIDOR.
    ---
    ---@type integer
    REVERB_PRESET_STONECORRIDOR = 15

    --- REVERB PRESET ALLEY.
    ---
    ---@type integer
    REVERB_PRESET_ALLEY = 16

    --- REVERB PRESET CITY.
    ---
    ---@type integer
    REVERB_PRESET_CITY = 17

    --- REVERB PRESET MOUNTAINS.
    ---
    ---@type integer
    REVERB_PRESET_MOUNTAINS = 18

    --- REVERB PRESET QUARRY.
    ---
    ---@type integer
    REVERB_PRESET_QUARRY = 19

    --- REVERB PRESET PLAIN.
    ---
    ---@type integer
    REVERB_PRESET_PLAIN = 20

    --- REVERB PRESET PARKINGLOT.
    ---
    ---@type integer
    REVERB_PRESET_PARKINGLOT = 21

    --- REVERB PRESET SEWERPIPE.
    ---
    ---@type integer
    REVERB_PRESET_SEWERPIPE = 22

    --- REVERB PRESET UNDERWATER.
    ---
    ---@type integer
    REVERB_PRESET_UNDERWATER = 23

    --- REVERB PRESET SMALLROOM.
    ---
    ---@type integer
    REVERB_PRESET_SMALLROOM = 24

    --- REVERB PRESET MEDIUMROOM.
    ---
    ---@type integer
    REVERB_PRESET_MEDIUMROOM = 25

    --- REVERB PRESET LARGEROOM.
    ---
    ---@type integer
    REVERB_PRESET_LARGEROOM = 26

    --- REVERB PRESET MEDIUMHALL.
    ---
    ---@type integer
    REVERB_PRESET_MEDIUMHALL = 27

    --- REVERB PRESET LARGEHALL.
    ---
    ---@type integer
    REVERB_PRESET_LARGEHALL = 28

    --- REVERB PRESET PLATE.
    ---
    ---@type integer
    REVERB_PRESET_PLATE = 29

    --- Loads an MP4 video file (currently only the H264 internal compression
    --- format is supported).
    ---
    ---@param filename string
    ---
    ---@return Video
    function Video(filename) end

    --- A video resource loaded from file.
    ---
    ---@class Video
    local Video = {}

    --- Returns true if the video was successfully created.
    ---
    ---@return boolean
    function Video.IsValid() end

    --- Returns the duration seconds.
    ---
    ---@return number
    function Video.GetDurationSeconds() end

    --- Creates a decoder instance for the video data.
    ---
    ---@param video Video
    ---
    ---@return VideoInstance
    function VideoInstance(video) end

    --- A playing instance of a Video, with playback controls.
    ---
    ---@class VideoInstance
    local VideoInstance = {}


    --- Returns true if the video instance was successfully created.
    ---
    ---@return boolean
    function VideoInstance.IsValid() end

    --- Play.
    function VideoInstance.Play() end

    --- Pause.
    function VideoInstance.Pause() end

    --- Stop.
    function VideoInstance.Stop() end

    --- Sets whether playback loops when the video reaches the end.
    ---
    ---@param looped boolean
    function VideoInstance.SetLooped(looped) end

    --- Seek.
    ---
    ---@param timerSeconds number
    function VideoInstance.Seek(timerSeconds) end

    --- Returns current video playback timer for this decoder instance in
    --- seconds.
    ---
    ---@return number
    function VideoInstance.GetCurrentTimer() end

    --- Returns true if the video playback has ended.
    ---
    ---@return boolean
    function VideoInstance.IsEnded() end

    --- Constructs a 4-component vector. Any missing component defaults to 0.
    ---
    ---@param x? number
    ---@param y? number
    ---@param z? number
    ---@param w? number
    ---
    ---@return Vector
    function Vector(x, y, z, w) end

    --- A four component floating point vector. Provides efficient calculations
    --- with SIMD support.
    ---
    --- The global `vector` object exposes the same functions, so they can be
    --- called in a static style, e.g. `vector.Dot(a, b)`.
    ---
    ---@class Vector
    ---
    ---@field X number
    ---@field Y number
    ---@field Z number
    ---@field W number
    local Vector = {}

    --- Global helper exposing every Vector function for static-style calls,
    --- e.g. vector.Lerp(a, b, t).
    ---
    ---@type Vector
    vector = nil

    --- Returns the X component of the vector.
    ---
    ---@return number
    function Vector.GetX() end

    --- Returns the Y component of the vector.
    ---
    ---@return number
    function Vector.GetY() end

    --- Returns the Z component of the vector.
    ---
    ---@return number
    function Vector.GetZ() end

    --- Returns the W component of the vector.
    ---
    ---@return number
    function Vector.GetW() end

    --- Sets the X component of the vector.
    ---
    ---@param value number
    function Vector.SetX(value) end

    --- Sets the Y component of the vector.
    ---
    ---@param value number
    function Vector.SetY(value) end

    --- Sets the Z component of the vector.
    ---
    ---@param value number
    function Vector.SetZ(value) end

    --- Sets the W component of the vector.
    ---
    ---@param value number
    function Vector.SetW(value) end

    --- Returns the 3D length (magnitude) of a vector. Called with no argument
    --- it operates on the vector itself.
    ---
    ---@param v Vector
    ---
    ---@return number
    ---
    ---@overload fun(): number
    function Vector.Length(v) end

    --- Returns the squared 3D length of a vector (cheaper than Length). Called
    --- with no argument it operates on the vector itself.
    ---
    ---@param v Vector
    ---
    ---@return number
    ---
    ---@overload fun(): number
    function Vector.LengthSquared(v) end

    --- Returns the distance between two points.
    ---
    ---@param v1 Vector
    ---@param v2 Vector
    ---
    ---@return number
    function Vector.Distance(v1, v2) end

    --- Returns the squared distance between two points (cheaper than Distance).
    ---
    ---@param v1 Vector
    ---@param v2 Vector
    ---
    ---@return number
    function Vector.DistanceSquared(v1, v2) end

    --- Returns a normalized (unit-length) copy of a vector. Called with no
    --- argument it operates on the vector itself.
    ---
    ---@param v Vector
    ---
    ---@return Vector
    ---
    ---@overload fun(): Vector
    function Vector.Normalize(v) end

    --- Returns a normalized copy of a quaternion. Called with no argument it
    --- operates on the vector itself.
    ---
    ---@param v Vector
    ---
    ---@return Vector
    ---
    ---@overload fun(): Vector
    function Vector.QuaternionNormalize(v) end

    --- Clamps every component of a vector between min and max. Called with two
    --- arguments it operates on the vector itself.
    ---
    ---@param v Vector
    ---@param min number
    ---@param max number
    ---
    ---@return Vector
    ---
    ---@overload fun(min: number, max: number): Vector
    function Vector.Clamp(v, min, max) end

    --- Transforms a vector by a matrix (4D, uses the w component).
    ---
    ---@param vec Vector
    ---@param matrix Matrix
    ---
    ---@return Vector
    function Vector.Transform(vec, matrix) end

    --- Transforms a 3D normal by a matrix (ignores translation).
    ---
    ---@param vec Vector
    ---@param matrix Matrix
    ---
    ---@return Vector
    function Vector.TransformNormal(vec, matrix) end

    --- Transforms a 3D coordinate by a matrix (applies the perspective divide).
    ---
    ---@param vec Vector
    ---@param matrix Matrix
    ---
    ---@return Vector
    function Vector.TransformCoord(vec, matrix) end

    --- Returns the component-wise sum of two vectors.
    ---
    ---@param v1 Vector
    ---@param v2 Vector
    ---
    ---@return Vector
    function Vector.Add(v1, v2) end

    --- Returns the component-wise difference of two vectors.
    ---
    ---@param v1 Vector
    ---@param v2 Vector
    ---
    ---@return Vector
    function Vector.Subtract(v1, v2) end

    --- Multiplies two vectors component-wise, or scales a vector by a scalar.
    ---
    ---@param v1 Vector
    ---@param v2 Vector
    ---
    ---@return Vector
    ---
    ---@overload fun(v: Vector, f: number): Vector
    ---@overload fun(f: number, v: Vector): Vector
    function Vector.Multiply(v1, v2) end

    --- Returns the dot product of two vectors.
    ---
    ---@param v1 Vector
    ---@param v2 Vector
    ---
    ---@return number
    function Vector.Dot(v1, v2) end

    --- Returns the cross product of two 3D vectors.
    ---
    ---@param v1 Vector
    ---@param v2 Vector
    ---
    ---@return Vector
    function Vector.Cross(v1, v2) end

    --- Linearly interpolates between two vectors by factor t in [0, 1].
    ---
    ---@param v1 Vector
    ---@param v2 Vector
    ---@param t number
    ---
    ---@return Vector
    function Vector.Lerp(v1, v2, t) end

    --- Rotates a 3D vector by a quaternion.
    ---
    ---@param v Vector          the vector to rotate
    ---@param quaternion Vector the rotation quaternion
    ---
    ---@return Vector
    function Vector.Rotate(v, quaternion) end

    --- Returns a quaternion representing the identity (no) rotation.
    ---
    ---@return Vector
    function Vector.QuaternionIdentity() end

    --- Returns the inverse of a quaternion.
    ---
    ---@param quaternion Vector
    ---
    ---@return Vector
    function Vector.QuaternionInverse(quaternion) end

    --- Multiplies (concatenates) two quaternions.
    ---
    ---@param quaternion1 Vector
    ---@param quaternion2 Vector
    ---
    ---@return Vector
    function Vector.QuaternionMultiply(quaternion1, quaternion2) end

    --- Builds a quaternion from Euler angles packed as (roll, pitch, yaw).
    ---
    ---@param rotXYZ Vector
    ---
    ---@return Vector
    function Vector.QuaternionFromRollPitchYaw(rotXYZ) end

    --- Extracts Euler angles (roll, pitch, yaw) from a quaternion.
    ---
    ---@param quaternion Vector
    ---
    ---@return Vector
    function Vector.QuaternionToRollPitchYaw(quaternion) end

    --- Spherically interpolates between two quaternions by factor t.
    ---
    ---@param quaternion1 Vector
    ---@param quaternion2 Vector
    ---@param t number
    ---
    ---@return Vector
    function Vector.QuaternionSlerp(quaternion1, quaternion2, t) end

    --- Spherically interpolates between two quaternions by factor t. Same as
    --- QuaternionSlerp.
    ---
    ---@param quaternion1 Vector
    ---@param quaternion2 Vector
    ---@param t number
    ---
    ---@return Vector
    function Vector.Slerp(quaternion1, quaternion2, t) end

    --- Constructs a plane (as a Vector of coefficients) from a point and a
    --- normal.
    ---
    ---@param point Vector
    ---@param normal Vector
    ---
    ---@return Vector
    function Vector.PlaneFromPointNormal(point, normal) end

    --- Constructs a plane (as a Vector of coefficients) from three points.
    ---
    ---@param a Vector
    ---@param b Vector
    ---@param c Vector
    ---
    ---@return Vector
    function Vector.PlaneFromPoints(a, b, c) end

    --- Computes the angle between two 3D vectors around the given axis, in the
    --- range [0, max_angle] (default 2*pi).
    ---
    ---@param a Vector
    ---@param b Vector
    ---@param axis Vector
    ---@param max_angle? number
    ---
    ---@return number
    function Vector.GetAngle(a, b, axis, max_angle) end

    --- Computes the signed angle between two 3D vectors around the given axis.
    ---
    ---@param a Vector
    ---@param b Vector
    ---@param axis Vector
    ---
    ---@return number
    function Vector.GetAngleSigned(a, b, axis) end

    --- Constructs a 4x4 matrix from 16 row-major components. Any missing
    --- component defaults to 0; with no arguments the identity matrix is
    --- returned.
    ---
    ---@param m00? number
    ---@param m01? number
    ---@param m02? number
    ---@param m03? number
    ---@param m10? number
    ---@param m11? number
    ---@param m12? number
    ---@param m13? number
    ---@param m20? number
    ---@param m21? number
    ---@param m22? number
    ---@param m23? number
    ---@param m30? number
    ---@param m31? number
    ---@param m32? number
    ---@param m33? number
    ---
    ---@return Matrix
    function Matrix(
        m00, m01, m02, m03,
        m10, m11, m12, m13,
        m20, m21, m22, m23,
        m30, m31, m32, m33
    ) end

    --- A four by four matrix. Provides efficient calculations with SIMD
    --- support.
    ---
    --- The global `matrix` object exposes the same functions, so they can be
    --- called in a static style, e.g. `matrix.Multiply(a, b)`.
    ---
    ---@class Matrix
    local Matrix = {}

    --- Global helper exposing every Matrix function for static-style calls,
    --- e.g. matrix.Multiply(a, b).
    ---
    ---@type Matrix
    matrix = nil

    --- Returns the given row (0-3) of the matrix as a Vector.
    ---
    ---@param row? integer row index in [0, 3] (default 0)
    ---
    ---@return Vector
    function Matrix.GetRow(row) end

    --- Builds a translation matrix from a position vector (identity if
    --- omitted).
    ---
    ---@param vector? Vector
    ---
    ---@return Matrix
    function Matrix.Translation(vector) end

    --- Builds a rotation matrix from Euler angles packed as (roll, pitch, yaw).
    ---
    ---@param rollPitchYaw? Vector
    ---
    ---@return Matrix
    function Matrix.Rotation(rollPitchYaw) end

    --- Builds a rotation matrix around the X axis.
    ---
    ---@param angleInRadians? number
    ---
    ---@return Matrix
    function Matrix.RotationX(angleInRadians) end

    --- Builds a rotation matrix around the Y axis.
    ---
    ---@param angleInRadians? number
    ---
    ---@return Matrix
    function Matrix.RotationY(angleInRadians) end

    --- Builds a rotation matrix around the Z axis.
    ---
    ---@param angleInRadians? number
    ---
    ---@return Matrix
    function Matrix.RotationZ(angleInRadians) end

    --- Builds a rotation matrix from a quaternion.
    ---
    ---@param quaternion? Vector
    ---
    ---@return Matrix
    function Matrix.RotationQuaternion(quaternion) end

    --- Builds a scaling matrix from a per-axis Vector or a uniform scalar
    --- (identity if omitted).
    ---
    ---@param scaleXYZ? Vector
    ---
    ---@return Matrix
    ---
    ---@overload fun(scale: number): Matrix
    function Matrix.Scale(scaleXYZ) end

    --- Builds a left-handed view matrix looking from eye toward a direction.
    ---
    ---@param eye Vector
    ---@param direction Vector
    ---@param up? Vector up direction (default (0, 1, 0))
    ---
    ---@return Matrix
    function Matrix.LookTo(eye, direction, up) end

    --- Builds a left-handed view matrix looking from eye at a focus point.
    ---
    ---@param eye Vector
    ---@param focusPos Vector
    ---@param up? Vector up direction (default (0, 1, 0))
    ---
    ---@return Matrix
    function Matrix.LookAt(eye, focusPos, up) end

    --- Returns the product of two matrices.
    ---
    ---@param m1 Matrix
    ---@param m2 Matrix
    ---
    ---@return Matrix
    function Matrix.Multiply(m1, m2) end

    --- Returns the component-wise sum of two matrices.
    ---
    ---@param m1 Matrix
    ---@param m2 Matrix
    ---
    ---@return Matrix
    function Matrix.Add(m1, m2) end

    --- Returns the transpose of a matrix.
    ---
    ---@param m Matrix
    ---
    ---@return Matrix
    function Matrix.Transpose(m) end

    --- Returns the inverse of a matrix together with its determinant.
    ---
    ---@param m Matrix
    ---
    ---@return Matrix inverse
    ---@return number determinant
    function Matrix.Inverse(m) end

    --- Returns the forward direction of a matrix. Called with no argument it
    --- operates on the matrix itself.
    ---
    ---@param mat Matrix
    ---
    ---@return Vector
    ---
    ---@overload fun(): Vector
    function Matrix.GetForward(mat) end

    --- Returns the up direction of a matrix. Called with no argument it
    --- operates on the matrix itself.
    ---
    ---@param mat Matrix
    ---
    ---@return Vector
    ---
    ---@overload fun(): Vector
    function Matrix.GetUp(mat) end

    --- Returns the right direction of a matrix. Called with no argument it
    --- operates on the matrix itself.
    ---
    ---@param mat Matrix
    ---
    ---@return Vector
    ---
    ---@overload fun(): Vector
    function Matrix.GetRight(mat) end

    --- Constructs a new Async tracker object.
    ---
    ---@return Async
    function Async() end

    --- The Async object can be used for tracking or waiting for completion of
    --- functions running on background threads.
    ---
    ---@class Async
    local Async = {}

    --- Wait for completion of async tasks on this tracker.
    function Async.Wait() end

    --- Checks if all async tasks on this tracker have been completed.
    ---
    ---@return boolean
    function Async.IsCompleted() end

    --- An entity is an integer handle. `Entity` is an alias for `integer`,
    --- used in signatures for readability.
    ---
    ---@alias Entity integer

    --- The invalid/no-entity sentinel value (0).
    ---
    ---@type integer
    INVALID_ENTITY = 0

    --- Creates a custom scene.
    ---
    ---@return Scene
    function Scene() end

    --- The scene holds components. Entity handles can be used to retrieve
    --- associated components through the scene.
    ---
    ---@class Scene
    ---
    ---@field Weather WeatherComponent
    local Scene = {}

    --- Returns the global scene.
    ---
    ---@return Scene
    function GetScene() end

    --- Returns the global camera.
    ---
    ---@return CameraComponent
    function GetCamera() end

    --- Load Model from file. returns a root entity that everything in this
    --- model is attached to.
    ---
    ---@param fileName string
    ---@param transform? Matrix
    ---
    ---@return Entity
    function LoadModel(fileName, transform) end

    --- Load Model from file into specified scene. returns a root entity that
    --- everything in this model is attached to.
    ---
    ---@param scene Scene
    ---@param fileName string
    ---@param transform? Matrix
    ---
    ---@return Entity
    function LoadModel(scene, fileName, transform) end

    --- Deprecated, you can use `FILTER_` enums instead.
    ---
    ---@deprecated
    ---
    ---@type integer
    PICK_OPAQUE = 1

    --- Deprecated, you can use `FILTER_` enums instead.
    ---
    ---@deprecated
    ---
    ---@type integer
    PICK_TRANSPARENT = 2

    --- Deprecated, you can use `FILTER_` enums instead.
    ---
    ---@deprecated
    ---
    ---@type integer
    PICK_WATER = 4

    --- Deprecated, you can use `FILTER_` enums instead.
    ---
    ---@deprecated
    ---
    ---@type integer
    PICK_VOID = 0

    --- Perform ray-picking in the scene. pickType is a bitmask specifying
    --- object types to check against. layerMask is a bitmask specifying which
    --- layers to check against. Scene parameter is optional and will use the
    --- global scene if not specified. (deprecated, you can use the scene's
    --- Intersects() function instead).
    ---
    ---@deprecated
    ---
    ---@param ray Ray
    ---@param filterMask? integer
    ---@param layerMask? integer
    ---@param scene? Scene
    ---@param lod? integer
    ---
    ---@return Entity entity
    ---@return Vector position
    ---@return Vector normal
    ---@return number distance
    function Pick(ray, filterMask, layerMask, scene, lod) end

    --- Perform ray-picking in the scene. pickType is a bitmask specifying
    --- object types to check against. layerMask is a bitmask specifying which
    --- layers to check against. Scene parameter is optional and will use the
    --- global scene if not specified. (deprecated, you can use the scene's
    --- Intersects() function instead)
    ---
    ---@deprecated
    ---
    ---@param sphere Sphere
    ---@param filterMask? integer
    ---@param layerMask? integer
    ---@param scene? Scene
    ---@param lod? integer
    ---
    ---@return Entity entity
    ---@return Vector position
    ---@return Vector normal
    ---@return number distance
    function SceneIntersectSphere(sphere, filterMask, layerMask, scene, lod) end

    --- Perform ray-picking in the scene. pickType is a bitmask specifying
    --- object types to check against. layerMask is a bitmask specifying which
    --- layers to check against. Scene parameter is optional and will use the
    --- global scene if not specified. (deprecated, you can use the scene's
    --- Intersects() function instead)
    ---
    ---@deprecated
    ---
    ---@param capsule Capsule
    ---@param filterMask? integer
    ---@param layerMask? integer
    ---@param scene? Scene
    ---@param lod? integer
    ---
    ---@return Entity entity
    ---@return Vector position
    ---@return Vector normal
    ---@return number distance
    function SceneIntersectCapsule(
        capsule,
        filterMask,
        layerMask,
        scene,
        lod
    ) end

    --- Include nothing.
    ---
    ---@type integer
    FILTER_NONE = 0

    --- Include opaque meshes.
    ---
    ---@type integer
    FILTER_OPAQUE = 1

    --- Include transparent meshes.
    ---
    ---@type integer
    FILTER_TRANSPARENT = 2

    --- Include water meshes.
    ---
    ---@type integer
    FILTER_WATER = 4

    --- include navigation meshes.
    ---
    ---@type integer
    FILTER_NAVIGATION_MESH = 8

    --- Include terrain.
    ---@type integer
    FILTER_TERRAIN = 16

    --- Include all objects, meshes.
    ---
    ---@type integer
    FILTER_OBJECT_ALL = 31

    --- Include colliders.
    ---
    ---@type integer
    FILTER_COLLIDER = 32

    --- Include ragdoll body parts.
    ---
    ---@type integer
    FILTER_RAGDOLL = 64

    --- Include everything.
    ---
    ---@type integer
    FILTER_ALL = -1

    --- Intersects a primitive with the scene and returns collision parameters.
    --- If humanoid_bone is not `HumanoidBone.Count` then the intersection is a
    --- ragdoll, and entity refers to the humanoid entity.
    ---
    ---@param primitive Ray|Sphere|Capsule
    ---@param filterMask? integer
    ---@param layerMask? integer
    ---@param lod? integer
    ---
    ---@return Entity entity
    ---@return Vector position
    ---@return Vector normal
    ---@return number distance
    ---@return Vector velocity
    ---@return integer subsetIndex
    ---@return Matrix orientation
    ---@return Vector uv
    ---@return HumanoidBone humanoid_bone
    function Scene.Intersects(primitive, filterMask, layerMask, lod) end

    --- Intersects a primitive with the scene and returns true immediately on
    --- intersection, false if there was no intersection. This can be faster for
    --- occlusion check than regular `Intersects` that searches for closest
    --- intersection.
    ---
    ---@param primitive Ray
    ---@param filterMask? integer
    ---@param layerMask? integer
    ---@param lod? integer
    ---
    ---@return boolean
    function Scene.IntersectsFirst(primitive, filterMask, layerMask, lod) end

    --- Intersects the scene with a primitive and returns array of results. In
    --- case of Ray, RayIntersectionResult will be returned, for Sphere and
    --- Capsule SphereIntersectionResult will be returned.
    ---
    ---@param primitive Ray|Sphere|Capsule
    ---@param filterMask? integer
    ---@param layerMask? integer
    ---@param lod? integer
    ---
    ---@return RayIntersectionResult[]|SphereIntersectionResult[]
    function Scene.IntersectsAll(primitive, filterMask, layerMask, lod) end

    --- Updates the scene and every entity and component inside the scene.
    function Scene.Update() end

    --- Deletes every entity and component inside the scene.
    function Scene.Clear() end

    --- Moves contents from an other scene into this one. The other scene will
    --- be empty after this operation (contents are moved, not copied).
    ---
    ---@param other Scene
    function Scene.Merge(other) end

    --- Updates the full scene hierarchy system. Useful if you modified for
    --- example a parent transform and children immediately need up to date
    --- result in the script.
    function Scene.UpdateHierarchy() end

    --- Duplicates everything in the prefab scene into the current scene. If
    --- attached parameter is set to `true` then everything in prefab scene will
    --- be attached to a common root entity (with TransformComponent and
    --- LayerComponent) and the function will return that root entity.
    ---
    ---@param prefab Scene
    ---@param attached? boolean
    ---
    ---@return Entity
    function Scene.Instantiate(prefab, attached) end

    --- Creates an empty entity and returns it.
    ---
    ---@return Entity
    function CreateEntity() end

    --- Returns a table with all the entities present in the given scene.
    ---
    ---@return any
    function Scene.FindAllEntities() end

    --- Returns an entity ID if it exists, and INVALID_ENTITY otherwise. You can
    --- specify an ancestor entity if you only want to find entities that are
    --- descendants of ancestor entity.
    ---
    ---@param value string
    ---@param ancestor? integer
    ---
    ---@return Entity
    function Scene.Entity_FindByName(value, ancestor) end

    --- Removes an entity and deletes all its components if it exists. If
    --- recursive is specified, then all children will be removed as well
    --- (enabled by default). If keep_sorted is specified, then component order
    --- will be kept (disabled by default, slower).
    ---
    ---@param entity Entity
    ---@param recursive? boolean
    ---@param keep_sorted? boolean
    function Scene.Entity_Remove(entity, recursive, keep_sorted) end

    --- Same as Entity_Remove, but it runs on a background thread, status can be
    --- tracked by the [Async](#async) object that you provide.
    ---
    ---@param async Async
    ---@param entity Entity
    ---@param recursive? boolean
    ---@param keep_sorted? boolean
    function Scene.Entity_Remove_Async(
        async,
        entity,
        recursive,
        keep_sorted
    ) end

    --- Duplicates all of an entity's components and creates a new entity with
    --- them. Returns the clone entity handle.
    ---
    ---@param entity Entity
    ---
    ---@return Entity
    function Scene.Entity_Duplicate(entity) end

    --- Check whether entity is a descendant of ancestor. Returns `true` if
    --- entity is in the hierarchy tree of ancestor, `false` otherwise.
    ---
    ---@param entity Entity
    ---@param ancestor Entity
    ---
    ---@return boolean
    function Scene.Entity_IsDescendant(entity, ancestor) end

    --- Attach a name component to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return NameComponent
    function Scene.Component_CreateName(entity) end

    --- Attach a layer component to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return LayerComponent
    function Scene.Component_CreateLayer(entity) end

    --- Attach a transform component to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return TransformComponent
    function Scene.Component_CreateTransform(entity) end

    --- Attach a camera component to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return CameraComponent
    function Scene.Component_CreateCamera(entity) end

    --- Attach a light component to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return LightComponent
    function Scene.Component_CreateLight(entity) end

    --- Attach an object component to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return ObjectComponent
    function Scene.Component_CreateObject(entity) end

    --- Attach an IK component to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return InverseKinematicsComponent
    function Scene.Component_CreateInverseKinematics(entity) end

    --- Attach a spring component to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return SpringComponent
    function Scene.Component_CreateSpring(entity) end

    --- Attach a script component to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return ScriptComponent
    function Scene.Component_CreateScript(entity) end

    --- Attach a RigidBodyPhysicsComponent to an entity. The returned component
    --- is associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return RigidBodyPhysicsComponent
    function Scene.Component_CreateRigidBodyPhysics(entity) end

    --- Attach a SoftBodyPhysicsComponent to an entity. The returned component
    --- is associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return SoftBodyPhysicsComponent
    function Scene.Component_CreateSoftBodyPhysics(entity) end

    --- Attach a ForceFieldComponent to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return ForceFieldComponent
    function Scene.Component_CreateForceField(entity) end

    --- Attach a WeatherComponent to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return WeatherComponent
    function Scene.Component_CreateWeather(entity) end

    --- Attach a SoundComponent to an entity. The returned component is
    --- associated ith the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return SoundComponent
    function Scene.Component_CreateSound(entity) end

    --- Attach a VideoComponent to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return VideoComponent
    function Scene.Component_CreateVideo(entity) end

    --- Attach a ColliderComponent to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return ColliderComponent
    function Scene.Component_CreateCollider(entity) end

    --- Attach a ExpressionComponent to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return ExpressionComponent
    function Scene.Component_CreateExpression(entity) end

    --- Attach a HumanoidComponent to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return HumanoidComponent
    function Scene.Component_CreateHumanoid(entity) end

    --- Attach a DecalComponent to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return DecalComponent
    function Scene.Component_CreateDecal(entity) end

    --- Attach a Sprite to an entity. The returned component is associated with
    --- the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return Sprite
    function Scene.Component_CreateSprite(entity) end

    --- Attach a SpriteFont to an entity. The returned component is associated
    --- with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return SpriteFont
    function Scene.Component_CreateFont(entity) end

    --- Attach a VoxelGrid to an entity. The returned component is associated
    --- with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return VoxelGrid
    function Scene.Component_CreateVoxelGrid(entity) end

    --- Attach a MetadataComponent to an entity. The returned component is
    --- associated with the entity and can be manipulated.
    ---
    ---@param entity Entity
    ---
    ---@return MetadataComponent
    function Scene.Component_CreateMetadata(entity) end

    --- Query the name component of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return NameComponent?
    function Scene.Component_GetName(entity) end

    --- query the layer component of the entity (if exists).
    ---
    ---@param entity Entity
    ---
    ---@return LayerComponent?
    function Scene.Component_GetLayer(entity) end

    --- Query the transform component of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return TransformComponent?
    function Scene.Component_GetTransform(entity) end

    --- Query the camera component of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return CameraComponent?
    function Scene.Component_GetCamera(entity) end

    --- Query the animation component of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return AnimationComponent?
    function Scene.Component_GetAnimation(entity) end

    --- Query the material component of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return MaterialComponent?
    function Scene.Component_GetMaterial(entity) end

    --- Query the emitter component of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return EmitterComponent?
    function Scene.Component_GetEmitter(entity) end

    --- Query the light component of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return LightComponent?
    function Scene.Component_GetLight(entity) end

    --- Query the object component of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return ObjectComponent?
    function Scene.Component_GetObject(entity) end

    --- Query the IK component of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return InverseKinematicsComponent?
    function Scene.Component_GetInverseKinematics(entity) end

    --- Query the spring component of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return SpringComponent?
    function Scene.Component_GetSpring(entity) end

    --- Query the script component of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return ScriptComponent?
    function Scene.Component_GetScript(entity) end

    --- Query the RigidBodyPhysicsComponent of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return RigidBodyPhysicsComponent?
    function Scene.Component_GetRigidBodyPhysics(entity) end

    --- Query the SoftBodyPhysicsComponent of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return SoftBodyPhysicsComponent?
    function Scene.Component_GetSoftBodyPhysics(entity) end

    --- Query the ForceFieldComponent of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return ForceFieldComponent?
    function Scene.Component_GetForceField(entity) end

    --- Query the WeatherComponent of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return WeatherComponent?
    function Scene.Component_GetWeather(entity) end

    --- Query the SoundComponent of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return SoundComponent?
    function Scene.Component_GetSound(entity) end

    --- Query the VideoComponent of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return VideoComponent?
    function Scene.Component_GetVideo(entity) end

    --- Query the ColliderComponent of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return ColliderComponent?
    function Scene.Component_GetCollider(entity) end

    --- Query the ExpressionComponent of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return ExpressionComponent?
    function Scene.Component_GetExpression(entity) end

    --- Query the HumanoidComponent of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return HumanoidComponent?
    function Scene.Component_GetHumanoid(entity) end

    --- Query the DecalComponent of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return DecalComponent?
    function Scene.Component_GetDecal(entity) end

    --- Query the Sprite of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return Sprite?
    function Scene.Component_GetSprite(entity) end

    --- Query the VoxelGrid of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return VoxelGrid?
    function Scene.Component_GetVoxelGrid(entity) end

    --- Query the MetadataComponent of the entity (if exists)..
    ---
    ---@param entity Entity
    ---
    ---@return MetadataComponent?
    function Scene.Component_GetMetadata(entity) end

    --- Returns an array of every Name component in the scene.
    ---
    ---@return NameComponent[]
    function Scene.Component_GetNameArray() end

    --- Returns an array of every Layer component in the scene.
    ---
    ---@return LayerComponent[]
    function Scene.Component_GetLayerArray() end

    --- Returns an array of every Transform component in the scene.
    ---
    ---@return TransformComponent[]
    function Scene.Component_GetTransformArray() end

    --- Returns an array of every Camera component in the scene.
    ---
    ---@return CameraComponent[]
    function Scene.Component_GetCameraArray() end

    --- Returns an array of every Animation component in the scene.
    ---
    ---@return AnimationComponent[]
    function Scene.Component_GetAnimationArray() end

    --- Returns an array of every Material component in the scene.
    ---
    ---@return MaterialComponent[]
    function Scene.Component_GetMaterialArray() end

    --- Returns an array of every Emitter component in the scene.
    ---
    ---@return EmitterComponent[]
    function Scene.Component_GetEmitterArray() end

    --- Returns an array of every Light component in the scene.
    ---
    ---@return LightComponent[]
    function Scene.Component_GetLightArray() end

    --- Returns an array of every Object component in the scene.
    ---
    ---@return ObjectComponent[]
    function Scene.Component_GetObjectArray() end

    --- Returns an array of every Mesh component in the scene.
    ---
    ---@return MeshComponent[]
    function Scene.Component_GetMeshArray() end

    --- Returns an array of every InverseKinematics component in the scene.
    ---
    ---@return InverseKinematicsComponent[]
    function Scene.Component_GetInverseKinematicsArray() end

    --- Returns an array of every Spring component in the scene.
    ---
    ---@return SpringComponent[]
    function Scene.Component_GetSpringArray() end

    --- Returns an array of every Script component in the scene.
    ---
    ---@return ScriptComponent[]
    function Scene.Component_GetScriptArray() end

    --- Returns an array of every RigidBodyPhysics component in the scene.
    ---
    ---@return RigidBodyPhysicsComponent[]
    function Scene.Component_GetRigidBodyPhysicsArray() end

    --- Returns an array of every SoftBodyPhysics component in the scene.
    ---
    ---@return SoftBodyPhysicsComponent[]
    function Scene.Component_GetSoftBodyPhysicsArray() end

    --- Returns an array of every ForceField component in the scene.
    ---
    ---@return ForceFieldComponent[]
    function Scene.Component_GetForceFieldArray() end

    --- Returns an array of every Weather component in the scene.
    ---
    ---@return WeatherComponent[]
    function Scene.Component_GetWeatherArray() end

    --- Returns an array of every Sound component in the scene.
    ---
    ---@return SoundComponent[]
    function Scene.Component_GetSoundArray() end

    --- Returns an array of every Video component in the scene.
    ---
    ---@return VideoComponent[]
    function Scene.Component_GetVideoArray() end

    --- Returns an array of every Collider component in the scene.
    ---
    ---@return ColliderComponent[]
    function Scene.Component_GetColliderArray() end

    --- Returns an array of every Expression component in the scene.
    ---
    ---@return ExpressionComponent[]
    function Scene.Component_GetExpressionArray() end

    --- Returns an array of every Humanoid component in the scene.
    ---
    ---@return HumanoidComponent[]
    function Scene.Component_GetHumanoidArray() end

    --- Returns an array of every Decal component in the scene.
    ---
    ---@return DecalComponent[]
    function Scene.Component_GetDecalArray() end

    --- Returns an array of every Sprite component in the scene.
    ---
    ---@return Sprite[]
    function Scene.Component_GetSpriteArray() end

    --- Returns an array of every Font component in the scene.
    ---
    ---@return SpriteFont[]
    function Scene.Component_GetFontArray() end

    --- Returns an array of every VoxelGrid component in the scene.
    ---
    ---@return VoxelGrid[]
    function Scene.Component_GetVoxelGridArray() end

    --- Returns an array of every Metadata component in the scene.
    ---
    ---@return MetadataComponent[]
    function Scene.Component_GetMetadataArray() end

    --- Returns an array of every entity that has a Name component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetNameArray() end

    --- Returns an array of every entity that has a Layer component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetLayerArray() end

    --- Returns an array of every entity that has a Transform component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetTransformArray() end

    --- Returns an array of every entity that has a Camera component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetCameraArray() end

    --- Returns an array of every entity that has an Animation component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetAnimationArray() end

    --- Returns an array of every entity that has an AnimationData component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetAnimationDataArray() end

    --- Returns an array of every entity that has a Material component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetMaterialArray() end

    --- Returns an array of every entity that has an Emitter component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetEmitterArray() end

    --- Returns an array of every entity that has a Light component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetLightArray() end

    --- Returns an array of every entity that has an Object component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetObjectArray() end

    --- Returns an array of every entity that has a Mesh component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetMeshArray() end

    --- Returns an array of every entity that has an InverseKinematics
    --- component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetInverseKinematicsArray() end

    --- Returns an array of every entity that has a Spring component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetSpringArray() end

    --- Returns an array of every entity that has a Script component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetScriptArray() end

    --- Returns an array of every entity that has a RigidBodyPhysics component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetRigidBodyPhysicsArray() end

    --- Returns an array of every entity that has a SoftBodyPhysics component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetSoftBodyPhysicsArray() end

    --- Returns an array of every entity that has a ForceField component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetForceFieldArray() end

    --- Returns an array of every entity that has a Weather component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetWeatherArray() end

    --- Returns an array of every entity that has a Sound component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetSoundArray() end

    --- Returns an array of every entity that has a Video component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetVideoArray() end

    --- Returns an array of every entity that has a Collider component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetColliderArray() end

    --- Returns an array of every entity that has an Expression component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetExpressionArray() end

    --- Returns an array of every entity that has a Humanoid component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetHumanoidArray() end

    --- Returns an array of every entity that has a Decal component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetDecalArray() end

    --- Returns an array of every entity that has a Sprite component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetSpriteArray() end

    --- Returns an array of every entity that has a VoxelGrid component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetVoxelGridArray() end

    --- Returns an array of every entity that has a Metadata component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetMetadataArray() end

    --- Remove the name component of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveName(entity) end

    --- Remove the layer component of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveLayer(entity) end

    --- Remove the transform component of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveTransform(entity) end

    --- Remove the camera component of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveCamera(entity) end

    --- Remove the animation component of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveAnimation(entity) end

    --- Remove component Animation Data.
    ---
    ---@param entity Entity
    function Scene.Component_RemoveAnimationData(entity) end

    --- Remove the material component of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveMaterial(entity) end

    --- Remove the emitter component of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveEmitter(entity) end

    --- Remove the light component of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveLight(entity) end

    --- Remove the object component of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveObject(entity) end

    --- Remove the IK component of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveInverseKinematics(entity) end

    --- Remove the spring component of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveSpring(entity) end

    --- Remove the script component of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveScript(entity) end

    --- Remove the RigidBodyPhysicsComponent of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveRigidBodyPhysics(entity) end

    --- Remove the SoftBodyPhysicsComponent of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveSoftBodyPhysics(entity) end

    --- Remove the ForceFieldComponent of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveForceField(entity) end

    --- Remove the WeatherComponent of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveWeather(entity) end

    --- Remove the SoundComponent of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveSound(entity) end

    --- Remove the VideoComponent of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveVideo(entity) end

    --- Remove the ColliderComponent of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveCollider(entity) end

    --- Remove the ExpressionComponent of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveExpression(entity) end

    --- Remove the HumanoidComponent of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveHumanoid(entity) end

    --- Remove the DecalComponent of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveDecal(entity) end

    --- Remove the Sprite of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveSprite(entity) end

    --- Remove the SpriteFont of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveFont(entity) end

    --- Remove the VoxelGrid of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveVoxelGrid(entity) end

    --- Remove the MetadataComponent of the entity (if exists).
    ---
    ---@param entity Entity
    function Scene.Component_RemoveMetadata(entity) end

    --- Attaches entity to parent (adds a hierarchy component to entity). From
    --- now on, entity will inherit certain properties from parent, such as
    --- transform (entity will move with parent) or layer (entity's layer will
    --- be a sublayer of parent's layer). If child_already_in_local_space is
    --- false, then child will be transformed into parent's local space, if
    --- true, it will be used as-is.
    ---
    ---@param entity Entity
    ---@param parent Entity
    ---@param child_already_in_local_space? boolean
    function Scene.Component_Attach(
        entity,
        parent,
        child_already_in_local_space
    ) end

    --- Detaches entity from parent (if hierarchycomponent exists for it).
    --- Restores entity's original layer, and applies current transformation to
    --- entity.
    ---
    ---@param entity Entity
    function Scene.Component_Detach(entity) end

    --- Detaches all children from parent, as if calling Component_Detach for
    --- all of its children.
    ---
    ---@param parent Entity
    function Scene.Component_DetachChildren(parent) end

    --- Returns an AABB fully containing objects in the scene. Only valid after
    --- scene has been updated.
    ---
    ---@return AABB
    function Scene.GetBounds() end

    --- Returns the weather.
    ---
    ---@return WeatherComponent
    function Scene.GetWeather() end

    --- Sets the weather.
    ---
    ---@param weather WeatherComponent
    function Scene.SetWeather(weather) end

    --- Retargets an animation from a Humanoid to an other Humanoid such that
    --- the new animation will play back on the destination humanoid. dst :
    --- destination humanoid that the animation will be fit onto src : the
    --- animation to copy, it should already target humanoid bones. bake_data :
    --- if true, the retargeted data will be baked into a new animation data. If
    --- false, it will reuse the source animation data without creating a new
    --- one and retargeting will be applied at runtime on every Update. Returns
    --- entity ID of the new animation or INVALID_ENTITY if retargeting was not
    --- successful
    ---
    ---@param dst Entity
    ---@param src Entity
    ---@param bake_data boolean
    ---@param src_scene? Scene  Scene containing src (defaults to this scene).
    ---
    ---@return Entity
    function Scene.RetargetAnimation(dst, src, bake_data, src_scene) end

    --- Resets the pose of the specified entity to bind pose. The bind pose is
    --- taken from the bind matrices of bones of an ArmatureComponent. If the
    --- entity does not have an armature, then it will find the child armatures
    --- of the entity.
    ---
    ---@param entity Entity
    function Scene.ResetPose(entity) end

    --- Returns the approximate position on the ocean surface seen from a
    --- position in world space. If current weather doesn't have ocean enabled,
    --- Returns the world position itself. The result position is approximate
    --- because it involves reading back from GPU to the CPU, so the result can
    --- be delayed compared to the current GPU simulation. Note that the input
    --- position to this function will be taken on the XZ plane and modified by
    --- the displacement map's XZ value, and the Y (vertical) position will be
    --- taken from the ocean water height and displacement map only.
    ---
    ---@param worldPosition Vector
    function Scene.GetOceanPosAt(worldPosition) end

    --- Voxelizes a single object into the voxel grid. Subtract parameter
    --- controls whether the voxels are added (true) or removed (false). Lod
    --- argument selects object's level of detail.
    ---
    ---@param objectIndex integer
    ---@param voxelgrid VoxelGrid
    ---@param subtract? boolean
    ---@param lod? integer
    function Scene.VoxelizeObject(objectIndex, voxelgrid, subtract, lod) end

    --- Voxelizes all entities in the scene which intersect the voxel grid
    --- volume and match the filterMask and layerMask. Subtract parameter
    --- controls whether the voxels are added (true) or removed (false). Lod
    --- argument selects object's level of detail.
    ---
    ---@param voxelgrid VoxelGrid
    ---@param subtract? boolean
    ---@param filterMask? integer
    ---@param layerMask? integer
    ---@param lod? integer
    function Scene.VoxelizeScene(
        voxelgrid,
        subtract,
        filterMask,
        layerMask,
        lod
    ) end

    --- Maintenance utility to help fix Nan issues in TransformComponents.
    --- Transforms containing nans will be cleared and renamed with `_nanfix`
    --- postfix.
    function Scene.FixupNans() end

    --- Attaches a EmitterComponent to the entity.
    ---
    ---@param entity Entity
    ---
    ---@return EmitterComponent
    function Scene.Component_CreateEmitter(entity) end

    --- Attaches a HairParticleSystem to the entity.
    ---
    ---@param entity Entity
    ---
    ---@return HairParticleSystem
    function Scene.Component_CreateHairParticleSystem(entity) end

    --- Attaches a MaterialComponent to the entity.
    ---
    ---@param entity Entity
    ---
    ---@return MaterialComponent
    function Scene.Component_CreateMaterial(entity) end

    --- Attaches a CharacterComponent to the entity.
    ---
    ---@param entity Entity
    ---
    ---@return CharacterComponent
    function Scene.Component_CreateCharacter(entity) end

    --- Returns the MeshComponent of the entity, if it exists.
    ---
    ---@param entity Entity
    ---
    ---@return MeshComponent?
    function Scene.Component_GetMesh(entity) end

    --- Returns the HairParticleSystem of the entity, if it exists.
    ---
    ---@param entity Entity
    ---
    ---@return HairParticleSystem?
    function Scene.Component_GetHairParticleSystem(entity) end

    --- Returns the SpriteFont of the entity, if it exists.
    ---
    ---@param entity Entity
    ---
    ---@return SpriteFont?
    function Scene.Component_GetFont(entity) end

    --- Returns the CharacterComponent of the entity, if it exists.
    ---
    ---@param entity Entity
    ---
    ---@return CharacterComponent?
    function Scene.Component_GetCharacter(entity) end

    --- Returns an array of every HairParticleSystem component in the scene.
    ---
    ---@return HairParticleSystem[]
    function Scene.Component_GetHairParticleSystemArray() end

    --- Returns an array of every Character component in the scene.
    ---
    ---@return CharacterComponent[]
    function Scene.Component_GetCharacterArray() end

    --- Returns an array of every entity that has a HairParticleSystem
    --- component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetHairParticleSystemArray() end

    --- Returns an array of every entity that has a Character component.
    ---
    ---@return Entity[]
    function Scene.Entity_GetCharacterArray() end

    --- Removes the MeshComponent of the entity, if it exists.
    ---
    ---@param entity Entity
    function Scene.Component_RemoveMesh(entity) end

    --- Removes the HairParticleSystem of the entity, if it exists.
    ---
    ---@param entity Entity
    function Scene.Component_RemoveHairParticleSystem(entity) end

    --- Removes the CharacterComponent of the entity, if it exists.
    ---
    ---@param entity Entity
    function Scene.Component_RemoveCharacter(entity) end

    --- Creates an empty RayIntersectionResult. Normally these are returned by
    --- `scene.IntersectsAll`, not constructed directly.
    ---
    ---@return RayIntersectionResult
    function RayIntersectionResult() end

    --- Result of one hit in scene.IntersectsAll.
    ---
    ---@class RayIntersectionResult
    local RayIntersectionResult = {}

    --- Returns the entity.
    ---
    ---@return Entity
    function RayIntersectionResult.GetEntity() end

    --- Returns the position.
    ---
    ---@return Vector
    function RayIntersectionResult.GetPosition() end

    --- Returns the normal.
    ---
    ---@return Vector
    function RayIntersectionResult.GetNormal() end

    --- Returns the uv.
    ---
    ---@return Vector
    function RayIntersectionResult.GetUV() end

    --- Returns the velocity.
    ---
    ---@return Vector
    function RayIntersectionResult.GetVelocity() end

    --- Returns the distance.
    ---
    ---@return number
    function RayIntersectionResult.GetDistance() end

    --- Returns the subset index.
    ---
    ---@return integer
    function RayIntersectionResult.GetSubsetIndex() end

    --- Returns the vertex id0.
    ---
    ---@return integer
    function RayIntersectionResult.GetVertexID0() end

    --- Returns the vertex id1.
    ---
    ---@return integer
    function RayIntersectionResult.GetVertexID1() end

    --- Returns the vertex id2.
    ---
    ---@return integer
    function RayIntersectionResult.GetVertexID2() end

    --- Returns the barycentrics.
    ---
    ---@return Vector
    function RayIntersectionResult.GetBarycentrics() end

    --- Returns the orientation.
    ---
    ---@return Vector
    function RayIntersectionResult.GetOrientation() end

    --- Returns the humanoid bone.
    ---
    ---@return integer
    function RayIntersectionResult.GetHumanoidBone() end

    --- Creates an empty SphereIntersectionResult. Normally these are returned
    --- by `scene.IntersectsAll`, not constructed directly.
    ---
    ---@return SphereIntersectionResult
    function SphereIntersectionResult() end

    --- Result of one hit in scene.IntersectsAll.
    ---
    ---@class SphereIntersectionResult
    local SphereIntersectionResult = {}

    --- Returns the entity.
    ---
    ---@return Entity
    function SphereIntersectionResult.GetEntity() end

    --- Returns the position.
    ---
    ---@return Vector
    function SphereIntersectionResult.GetPosition() end

    --- Returns the normal.
    ---
    ---@return Vector
    function SphereIntersectionResult.GetNormal() end

    --- Returns the velocity.
    ---
    ---@return Vector
    function SphereIntersectionResult.GetVelocity() end

    --- Returns the depth.
    ---
    ---@return number
    function SphereIntersectionResult.GetDepth() end

    --- Returns the subset index.
    ---
    ---@return integer
    function SphereIntersectionResult.GetSubsetIndex() end

    --- Returns the orientation.
    ---
    ---@return Vector
    function SphereIntersectionResult.GetOrientation() end

    --- Returns the humanoid bone.
    ---
    ---@return integer
    function SphereIntersectionResult.GetHumanoidBone() end

    --- Creates a new, standalone NameComponent that owns its own data.
    ---
    ---@return NameComponent
    function NameComponent() end

    --- Holds a string that can more easily identify an entity to humans than an
    --- entity ID.
    ---
    ---@class NameComponent
    ---
    ---@field Name string
    local NameComponent = {}

    --- Sets the name.
    ---
    ---@param value string
    function NameComponent.SetName(value) end

    --- Query the name string.
    ---
    ---@return any
    function NameComponent.GetName() end

    --- Creates a new, standalone LayerComponent that owns its own data.
    ---
    ---@return LayerComponent
    function LayerComponent() end

    --- An integer mask that can be used to group entities together for certain
    --- operations such as: picking, rendering, etc.
    ---
    ---@class LayerComponent
    ---
    ---@field LayerMask number
    local LayerComponent = {}

    --- Sets layer mask.
    ---
    ---@param value integer
    function LayerComponent.SetLayerMask(value) end

    --- Query layer mask.
    ---
    ---@return integer
    function LayerComponent.GetLayerMask() end

    --- Creates a new, standalone TransformComponent that owns its own data.
    ---
    ---@return TransformComponent
    function TransformComponent() end

    --- Describes an orientation in 3D space.
    ---
    ---@class TransformComponent
    ---
    ---@field Translation_local Vector query the position in world space
    ---@field Rotation_local Vector
    ---@field Scale_local Vector query the scaling in world space
    local TransformComponent = {}

    --- Applies scaling.
    ---
    ---@param vectorXYZ Vector
    function TransformComponent.Scale(vectorXYZ) end

    --- Applies uniform scaling.
    ---
    ---@param value number
    function TransformComponent.Scale(value) end

    --- Applies rotation as roll,pitch,yaw.
    ---
    ---@param vectorRollPitchYaw Vector
    function TransformComponent.Rotate(vectorRollPitchYaw) end

    --- Applies rotation as quaternion.
    ---
    ---@param quaternion Vector
    function TransformComponent.RotateQuaternion(quaternion) end

    --- Applies translation (position offset).
    ---
    ---@param vectorXYZ Vector
    function TransformComponent.Translate(vectorXYZ) end

    --- Interpolates linearly between two transform components.
    ---
    ---@param a TransformComponent
    ---@param b TransformComponent
    ---@param t number
    function TransformComponent.Lerp(a, b, t) end

    --- Interpolates between four transform components on a spline.
    ---
    ---@param a TransformComponent
    ---@param b TransformComponent
    ---@param c TransformComponent
    ---@param d TransformComponent
    ---@param t number
    function TransformComponent.CatmullRom(a, b, c, d, t) end

    --- Applies a transformation matrix.
    ---
    ---@param matrix Matrix
    function TransformComponent.MatrixTransform(matrix) end

    --- Retrieve a 4x4 transformation matrix representing the transform
    --- component's current orientation.
    ---
    ---@return Matrix
    function TransformComponent.GetMatrix() end

    --- Reset to the world origin, as in position becomes Vector(0,0,0),
    --- rotation quaternion becomes Vector(0,0,0,1), scaling becomes
    --- Vector(1,1,1).
    function TransformComponent.ClearTransform() end

    --- Updates the underlying transformation matrix.
    function TransformComponent.UpdateTransform() end

    --- Query the position in world space.
    ---
    ---@return Vector
    function TransformComponent.GetPosition() end

    --- Query the rotation as a quaternion in world space.
    ---
    ---@return Vector
    function TransformComponent.GetRotation() end

    --- Query the scaling in world space.
    ---
    ---@return Vector
    function TransformComponent.GetScale() end

    --- Set scale in local space.
    ---
    ---@param value Vector
    function TransformComponent.SetScale(value) end

    --- Set rotation quaternion in local space.
    ---
    ---@param quaternnion Vector
    function TransformComponent.SetRotation(quaternnion) end

    --- Set position in local space.
    ---
    ---@param value Vector
    function TransformComponent.SetPosition(value) end

    --- Invalidate, this will cause transformer to be updated in next scene
    --- update.
    ---
    ---@param value boolean
    function TransformComponent.SetDirty(value) end

    --- Check if transform was invalidated since last update.
    ---
    ---@return boolean
    function TransformComponent.IsDirty() end

    --- rRturns forward direction.
    ---
    ---@return Vector
    function TransformComponent.GetForward() end

    --- Returns upwards direction.
    ---
    ---@return Vector
    function TransformComponent.GetUp() end

    --- Returns right direction.
    ---
    ---@return Vector
    function TransformComponent.GetRight() end

    --- Creates a new, standalone CameraComponent that owns its own data.
    ---
    ---@return CameraComponent
    function CameraComponent() end

    --- Represents a camera: its position, orientation and projection, used to
    --- render the scene from a viewpoint.
    ---
    ---@class CameraComponent
    ---
    ---@field FOV number
    ---@field NearPlane number
    ---@field FarPlane number
    ---@field FocalLength number
    ---@field ApertureSize number
    ---@field ApertureShape number
    local CameraComponent = {}

    --- Update the camera matrices.
    function CameraComponent.UpdateCamera() end

    --- Copies the transform's orientation to the camera, and sets the camera
    --- position, look direction and up direction. Camera matrices are not
    --- updated immediately. They will be updated by the Scene::Update() (if the
    --- camera is part of the scene), or by manually calling UpdateCamera().
    ---
    ---@param transform TransformComponent
    function CameraComponent.TransformCamera(transform) end

    --- Transform Camera.
    ---
    ---@param matrix Matrix
    function CameraComponent.TransformCamera(matrix) end

    --- Returns the fov.
    ---
    ---@return number
    function CameraComponent.GetFOV() end

    --- Sets the vertical field of view for the camera (value is an angle in
    --- radians).
    ---
    ---@param value number
    function CameraComponent.SetFOV(value) end

    --- Returns the near plane.
    ---
    ---@return number
    function CameraComponent.GetNearPlane() end

    --- Sets the near plane of the camera, which specifies the rendering cut off
    --- near the viewer. Must be a value greater than zero.
    ---
    ---@param value number
    function CameraComponent.SetNearPlane(value) end

    --- Returns the far plane.
    ---
    ---@return number
    function CameraComponent.GetFarPlane() end

    --- Sets the far plane (view distance) of the camera.
    ---
    ---@param value number
    function CameraComponent.SetFarPlane(value) end

    --- Returns the focal length.
    ---
    ---@return number
    function CameraComponent.GetFocalLength() end

    --- Sets the focal distance (focus distance) of the camera. This is used by
    --- depth of field.
    ---
    ---@param value number
    function CameraComponent.SetFocalLength(value) end

    --- Returns the aperture size.
    ---
    ---@return number
    function CameraComponent.GetApertureSize() end

    --- Sets the aperture size of the camera. Larger values will make the depth
    --- of field effect stronger.
    ---
    ---@param value number
    function CameraComponent.SetApertureSize(value) end

    --- Returns the aperture shape.
    ---
    ---@return number
    function CameraComponent.GetApertureShape() end

    --- Sets the aperture shape of camera, used for depth of field effect. The
    --- value's `.X` element specifies the horizontal, the `.Y` element
    --- specifies the vertical shape.
    ---
    ---@param value Vector
    function CameraComponent.SetApertureShape(value) end

    --- Returns the view.
    ---
    ---@return Matrix
    function CameraComponent.GetView() end

    --- Returns the projection.
    ---
    ---@return Matrix
    function CameraComponent.GetProjection() end

    --- Returns the view projection.
    ---
    ---@return Matrix
    function CameraComponent.GetViewProjection() end

    --- Returns the inv view.
    ---
    ---@return Matrix
    function CameraComponent.GetInvView() end

    --- Returns the inv projection.
    ---
    ---@return Matrix
    function CameraComponent.GetInvProjection() end

    --- Returns the inv view projection.
    ---
    ---@return Matrix
    function CameraComponent.GetInvViewProjection() end

    --- Returns the position.
    ---
    ---@return Vector
    function CameraComponent.GetPosition() end

    --- Returns the look direction.
    ---
    ---@return Vector
    function CameraComponent.GetLookDirection() end

    --- Returns the up direction.
    ---
    ---@return Vector
    function CameraComponent.GetUpDirection() end

    --- Returns the right direction.
    ---
    ---@return Vector
    function CameraComponent.GetRightDirection() end

    --- Sets the position of the camera. `UpdateCamera()` should be used after
    --- this to apply the value.
    ---
    ---@param value Vector
    function CameraComponent.SetPosition(value) end

    --- Sets the look direction of the camera. The value must be a normalized
    --- direction `Vector`, relative to the camera position, and also
    --- perpendicular to the up direction. `UpdateCamera()` should be used after
    --- this to apply the value. This value will also be set if using the
    --- `TransformCamera()` function, from the transform's rotation.
    ---
    ---@param value Vector
    function CameraComponent.SetLookDirection(value) end

    --- Sets the up direction of the camera. This must be a normalized direction
    --- `Vector`, relative to the camera position, and also perpendicular to the
    --- look direction. `UpdateCamera()` should be used after this to apply the
    --- value. This value will also be set if using the `TransformCamera()`
    --- function, from the transform's rotation.
    ---
    ---@param value Vector
    function CameraComponent.SetUpDirection(value) end

    --- Enable orthographic projection for the camera.
    ---
    ---@param value boolean
    function CameraComponent.SetOrtho(value) end

    --- Returns true if the camera is using orthographic projection, false
    --- otherwise.
    ---
    ---@return boolean
    function CameraComponent.IsOrtho() end

    --- Returns the ortho vertical size.
    ---
    ---@return number
    function CameraComponent.GetOrthoVerticalSize() end

    --- Sets the vertical size of the camera in world space, used only in
    --- orthographic projection mode.
    ---
    ---@param value number
    function CameraComponent.SetOrthoVerticalSize(value) end

    --- Projects the world-space point to screen space within the canvas logical
    --- width and height units (sceen width and height). If the Z coordinate is
    --- positive that means that it is in front of the camera, otherwise it is
    --- behind (can be considered to be clipped).
    ---
    ---@param point Vector
    ---@param canvas Canvas
    function CameraComponent.ProjectToScreen(point, canvas) end

    --- Creates a new, standalone AnimationComponent that owns its own data.
    ---
    ---@return AnimationComponent
    function AnimationComponent() end

    --- Plays back and controls an animation (skeletal or property animation) on
    --- an entity.
    ---
    ---@class AnimationComponent
    ---
    ---@field Timer number
    ---@field Amount number
    local AnimationComponent = {}

    --- Play.
    function AnimationComponent.Play() end

    --- Stop.
    function AnimationComponent.Stop() end

    --- Pause.
    function AnimationComponent.Pause() end

    --- Sets the animation to repeat continuously.
    ---
    ---@param value boolean
    function AnimationComponent.SetLooped(value) end

    --- Returns true if the animation is set to repeat continuously.
    ---
    ---@return boolean
    function AnimationComponent.IsLooped() end

    --- Returns whether playing.
    ---
    ---@return boolean
    function AnimationComponent.IsPlaying() end

    --- Sets the timer.
    ---
    ---@param value number
    function AnimationComponent.SetTimer(value) end

    --- Returns the timer.
    ---
    ---@return number
    function AnimationComponent.GetTimer() end

    --- Sets the amount.
    ---
    ---@param value number
    function AnimationComponent.SetAmount(value) end

    --- Returns the amount.
    ---
    ---@return number
    function AnimationComponent.GetAmount() end

    --- Returns the start.
    ---
    ---@return number
    function AnimationComponent.GetStart() end

    --- Sets the start.
    ---
    ---@param value number
    function AnimationComponent.SetStart(value) end

    --- Returns the end.
    ---
    ---@return number
    function AnimationComponent.GetEnd() end

    --- Sets the end.
    ---
    ---@param value number
    function AnimationComponent.SetEnd(value) end

    --- Sets the animation to play forward and then backwards repeatedly.
    ---
    ---@param value boolean
    function AnimationComponent.SetPingPong(value) end

    --- Returns true if the animation is set to play forward and then backwards
    --- repeatedly.
    ---
    ---@return boolean
    function AnimationComponent.IsPingPong() end

    --- Sets the animation to play once.
    function AnimationComponent.SetPlayOnce() end

    --- Returns true if the animation is set to play once.
    ---
    ---@return boolean
    function AnimationComponent.IsPlayingOnce() end

    --- Returns whether the animation has reached its end.
    ---
    ---@return boolean
    function AnimationComponent.IsEnded() end

    --- Returns whether root motion is enabled.
    ---
    ---@return boolean
    function AnimationComponent.IsRootMotion() end

    --- Enables root motion for this animation.
    function AnimationComponent.RootMotionOn() end

    --- Disables root motion for this animation.
    function AnimationComponent.RootMotionOff() end

    --- Returns the root-motion translation.
    ---
    ---@return Vector
    function AnimationComponent.GetRootTranslation() end

    --- Returns the root-motion rotation as a quaternion.
    ---
    ---@return Vector
    function AnimationComponent.GetRootRotation() end

    --- Creates a new, standalone MaterialComponent that owns its own data.
    ---
    ---@return MaterialComponent
    function MaterialComponent() end

    --- Surface material of an object: colors, textures and PBR shading
    --- parameters.
    ---
    ---@class MaterialComponent
    ---
    ---@field Saturation number
    ---@field _flags integer
    ---@field BaseColor Vector
    ---@field EmissiveColor Vector
    ---@field EngineStencilRef integer
    ---@field UserStencilRef integer
    ---@field ShaderType integer
    ---@field UserBlendMode integer
    ---@field SpecularColor Vector
    ---@field SubsurfaceScattering Vector
    ---@field TexMulAdd Vector
    ---@field Roughness number
    ---@field Reflectance number
    ---@field Metalness number
    ---@field NormalMapStrength number
    ---@field ParallaxOcclusionMapping number
    ---@field DisplacementMapping number
    ---@field Refraction number
    ---@field Transmission number
    ---@field Cloak number
    ---@field ChromaticAberration number
    ---@field AlphaRef number
    ---@field SheenColor Vector
    ---@field SheenRoughness number
    ---@field Clearcoat number
    ---@field ClearcoatRoughness number
    ---@field ShadingRate integer
    ---@field TexAnimDirection Vector
    ---@field TexAnimFrameRate number
    ---@field texAnimElapsedTime number
    ---@field customShaderID integer
    local MaterialComponent = {}

    --- Sets the base color.
    ---
    ---@param value Vector
    function MaterialComponent.SetBaseColor(value) end

    --- Sets the emissive color.
    ---
    ---@param value Vector
    function MaterialComponent.SetEmissiveColor(value) end

    --- Sets the engine stencil ref.
    ---
    ---@param value integer
    function MaterialComponent.SetEngineStencilRef(value) end

    --- Sets the user stencil ref.
    ---
    ---@param value integer
    function MaterialComponent.SetUserStencilRef(value) end

    --- Returns the stencil ref.
    ---
    ---@return integer
    function MaterialComponent.GetStencilRef() end

    --- Sets the tex mul add.
    ---
    ---@param vector Vector
    function MaterialComponent.SetTexMulAdd(vector) end

    --- Returns the tex mul add.
    ---
    ---@return Vector
    function MaterialComponent.GetTexMulAdd() end

    --- Sets the texture.
    ---
    ---@param slot TextureSlot
    ---@param texturefile string
    function MaterialComponent.SetTexture(slot, texturefile) end

    --- Sets the texture.
    ---
    ---@param slot TextureSlot
    ---@param texture Texture
    function MaterialComponent.SetTexture(slot, texture) end

    --- Sets the texture uvset.
    ---
    ---@param slot TextureSlot
    ---@param uvset integer
    function MaterialComponent.SetTextureUVSet(slot, uvset) end

    --- Returns the texture.
    ---
    ---@param slot TextureSlot
    ---
    ---@return Texture
    function MaterialComponent.GetTexture(slot) end

    --- Returns the texture name.
    ---
    ---@param slot TextureSlot
    ---
    ---@return any
    function MaterialComponent.GetTextureName(slot) end

    --- Returns the texture uvset.
    ---
    ---@param slot TextureSlot
    ---
    ---@return integer
    function MaterialComponent.GetTextureUVSet(slot) end

    --- Sets the cast shadow.
    ---
    ---@param value boolean
    function MaterialComponent.SetCastShadow(value) end

    --- Returns whether casting shadow.
    ---
    ---@return boolean
    function MaterialComponent.IsCastingShadow() end

    --- force transparent material draw in opaque pass (useful for coplanar
    --- polygons)
    ---
    ---@param value boolean
    function MaterialComponent.SetCoplanarBlending(value) end

    --- Returns whether coplanar blending.
    ---
    ---@return boolean
    function MaterialComponent.IsCoplanarBlending() end

    --- Identifies a texture slot on a MaterialComponent (base color, normal
    --- map, surface map, etc.).
    ---
    ---@enum TextureSlot
    TextureSlot = {
        BASECOLORMAP = 0,
        NORMALMAP = 1,
        SURFACEMAP = 2,
        EMISSIVEMAP = 3,
        DISPLACEMENTMAP = 4,
        OCCLUSIONMAP = 5,
        TRANSMISSIONMAP = 6,
        SHEENCOLORMAP = 7,
        SHEENROUGHNESSMAP = 8,
        CLEARCOATMAP = 9,
        CLEARCOATROUGHNESSMAP = 10,
        CLEARCOATNORMALMAP = 11,
        SPECULARMAP = 12,
        ANISOTROPYMAP = 13,
        TRANSPARENCYMAP = 14,
    }

    -- Shader types, for use with `MaterialComponent.SetShaderType`.

    --- Standard physically based rendering shader.
    ---
    ---@type integer
    SHADERTYPE_PBR = 0

    --- PBR with planar reflections.
    ---
    ---@type integer
    SHADERTYPE_PBR_PLANARREFLECTION = 1

    --- PBR with parallax occlusion mapping.
    ---
    ---@type integer
    SHADERTYPE_PBR_PARALLAXOCCLUSIONMAPPING = 2

    --- PBR with anisotropic specular.
    ---
    ---@type integer
    SHADERTYPE_PBR_ANISOTROPIC = 3

    --- Water surface shader.
    ---
    ---@type integer
    SHADERTYPE_WATER = 4

    --- Cartoon (toon) shader.
    ---
    ---@type integer
    SHADERTYPE_CARTOON = 5

    --- Unlit shader (no lighting).
    ---
    ---@type integer
    SHADERTYPE_UNLIT = 6

    --- PBR cloth shader.
    ---
    ---@type integer
    SHADERTYPE_PBR_CLOTH = 7

    --- PBR with clearcoat.
    ---
    ---@type integer
    SHADERTYPE_PBR_CLEARCOAT = 8

    --- PBR cloth with clearcoat.
    ---
    ---@type integer
    SHADERTYPE_PBR_CLOTH_CLEARCOAT = 9

    --- Engine stencil reference: empty.
    ---
    ---@type integer
    STENCILREF_EMPTY = 0

    --- Engine stencil reference: default.
    ---
    ---@type integer
    STENCILREF_DEFAULT = 1

    --- Engine stencil reference: custom shader.
    ---
    ---@type integer
    STENCILREF_CUSTOMSHADER = 2

    --- Engine stencil reference: outline.
    ---
    ---@type integer
    STENCILREF_OUTLINE = 3

    --- Engine stencil reference: custom shader and outline.
    ---
    ---@type integer
    STENCILREF_CUSTOMSHADER_OUTLINE = 4

    --- Engine stencil reference: skin.
    ---
    ---@type integer
    STENCILREF_SKIN = 3

    --- Engine stencil reference: snow.
    ---
    ---@type integer
    STENCILREF_SNOW = 4

    --- Creates a new, standalone MeshComponent that owns its own data.
    ---
    ---@return MeshComponent
    function MeshComponent() end

    --- Geometry data (vertices, indices and subsets) that objects reference and
    --- render.
    ---
    ---@class MeshComponent
    ---
    ---@field _flags integer
    ---@field TessellationFactor number
    ---@field ArmatureID integer
    ---@field SubsetsPerLOD integer
    local MeshComponent = {}

    --- Sets the mesh subset material id.
    ---
    ---@param subsetindex integer
    ---@param materialID Entity
    function MeshComponent.SetMeshSubsetMaterialID(subsetindex, materialID) end

    --- Returns the mesh subset material id.
    ---
    ---@param subsetindex integer
    ---
    ---@return Entity
    function MeshComponent.GetMeshSubsetMaterialID(subsetindex) end

    --- creates subset containing all faces, returns subset index
    ---
    ---@return integer
    function MeshComponent.CreateSubset() end

    --- Creates a new, standalone EmitterComponent that owns its own data.
    ---
    ---@return EmitterComponent
    function EmitterComponent() end

    --- A GPU particle emitter attached to an entity.
    ---
    ---@class EmitterComponent
    ---
    ---@field _flags integer
    ---@field ShaderType integer
    ---@field Mass number
    ---@field Velocity Vector
    ---@field Gravity Vector
    ---@field Drag number
    ---@field Restitution number
    ---@field EmitCount number emitted particle count per second
    ---@field Size number particle starting size
    ---@field Life number particle lifetime
    ---@field NormalFactor number normal factor that modulates emit velocities
    ---@field Randomness number general randomness factor
    ---@field LifeRandomness number lifetime randomness factor
    ---@field ScaleX number scaling along lifetime in X axis
    ---@field ScaleY number scaling along lifetime in Y axis
    ---@field Rotation number rotation speed
    ---@field MotionBlurAmount number set the motion elongation factor
    ---@field SPH_h number
    ---@field SPH_K number
    ---@field SPH_p0 number
    ---@field SPH_e number
    ---@field SpriteSheet_Frames_X integer
    ---@field SpriteSheet_Frames_Y integer
    ---@field SpriteSheet_Frame_Count integer
    ---@field SpriteSheet_Frame_Start integer
    ---@field SpriteSheet_Framerate number
    local EmitterComponent = {}

    --- Spawns a specific amount of particles immediately.
    ---
    ---@param value integer
    function EmitterComponent.Burst(value) end

    --- Spawns a specific amount of particles immediately at specified location
    --- and color multiplier.
    ---
    ---@param value integer
    ---@param position Vector
    ---@param color? Vector
    function EmitterComponent.Burst(value, position, color) end

    --- Spawns a specific amount of particles immediately at specified location
    --- and color multiplier.
    ---
    ---@param value integer
    ---@param transform Matrix
    ---@param color? Vector
    function EmitterComponent.Burst(value, transform, color) end

    --- Set the emitted particle count per second.
    ---
    ---@param value number
    function EmitterComponent.SetEmitCount(value) end

    --- Set particle starting size.
    ---
    ---@param value number
    function EmitterComponent.SetSize(value) end

    --- Set particle lifetime.
    ---
    ---@param value number
    function EmitterComponent.SetLife(value) end

    --- Set normal factor that modulates emit velocities.
    ---
    ---@param value number
    function EmitterComponent.SetNormalFactor(value) end

    --- Set general randomness factor.
    ---
    ---@param value number
    function EmitterComponent.SetRandomness(value) end

    --- Set lifetime randomness factor.
    ---
    ---@param value number
    function EmitterComponent.SetLifeRandomness(value) end

    --- Set scaling along lifetime in X axis.
    ---
    ---@param value number
    function EmitterComponent.SetScaleX(value) end

    --- Set scaling along lifetime in Y axis.
    ---
    ---@param value number
    function EmitterComponent.SetScaleY(value) end

    --- Set rotation speed.
    ---
    ---@param value number
    function EmitterComponent.SetRotation(value) end

    --- Set the motion elongation factor.
    ---
    ---@param value number
    function EmitterComponent.SetMotionBlurAmount(value) end

    --- Disable GPU colliders.
    ---
    ---@param value boolean
    function EmitterComponent.SetCollidersDisabled(value) end

    --- Returns whether colliders disabled.
    function EmitterComponent.IsCollidersDisabled() end

    --- Returns last known alive particle count (not that particles are tracked
    --- on GPU so this value might be out of date).
    ---
    ---@return integer
    function EmitterComponent.GetCurrentParticleCount() end

    --- Creates a new, standalone HairParticleSystem that owns its own data.
    ---
    ---@return HairParticleSystem
    function HairParticleSystem() end

    --- A GPU hair or grass particle system attached to an entity.
    ---
    ---@class HairParticleSystem
    ---
    ---@field _flags integer
    ---@field StrandCount integer
    ---@field SegmentCount integer
    ---@field RandomSeed integer
    ---@field Length number
    ---@field Stiffness number
    ---@field Randomness number
    ---@field ViewDistance number
    ---@field SpriteSheet_Frames_X integer
    ---@field SpriteSheet_Frames_Y integer
    ---@field SpriteSheet_Frame_Count integer
    ---@field SpriteSheet_Frame_Start integer
    local HairParticleSystem = {}

    --- Creates a new, standalone LightComponent that owns its own data.
    ---
    ---@return LightComponent
    function LightComponent() end

    --- A light source in the scene (directional, point or spot).
    ---
    ---@class LightComponent
    ---
    ---@field Type integer
    ---@field Range number
    ---@field Intensity number
    ---@field Color Vector
    ---@field CastShadow boolean
    ---@field VolumetricsEnabled boolean
    ---@field OuterConeAngle number outer cone angle for spotlight in radians
    ---@field InnerConeAngle number inner cone angle for spotlight in radians
    local LightComponent = {}

    --- DIRECTIONAL.
    ---
    ---@type integer
    DIRECTIONAL = 0

    --- POINT.
    ---
    ---@type integer
    POINT = 1

    --- SPOT.
    ---
    ---@type integer
    SPOT = 2

    --- Sphere area light type.
    ---
    ---@type integer
    SPHERE = 3

    --- Disc area light type.
    ---
    ---@type integer
    DISC = 4

    --- Rectangle area light type.
    ---
    ---@type integer
    RECTANGLE = 5

    --- Tube area light type.
    ---
    ---@type integer
    TUBE = 6

    --- Set light type, see accepted values below (by default it is a point
    --- light).
    ---
    ---@param type integer
    function LightComponent.SetType(type) end

    --- Sets the range.
    ---
    ---@param value number
    function LightComponent.SetRange(value) end

    --- Brightness of the light. The unit depends on the light type: point and
    --- spot lights use luminous intensity in candela (lm/sr), while directional
    --- lights use illuminance in lux (lm/m2). See the glTF KHR_lights_punctual
    --- spec:
    --- https://github.com/KhronosGroup/glTF/tree/main/extensions/2.0/Khronos/KHR_lights_punctual
    ---
    ---@param value number
    function LightComponent.SetIntensity(value) end

    --- Sets the color.
    ---
    ---@param value Vector
    function LightComponent.SetColor(value) end

    --- Sets the cast shadow.
    ---
    ---@param value boolean
    function LightComponent.SetCastShadow(value) end

    --- Enables or disables volumetrics.
    ---
    ---@param value boolean
    function LightComponent.SetVolumetricsEnabled(value) end

    --- Outer cone angle for spotlight in radians.
    ---
    ---@param value number
    function LightComponent.SetOuterConeAngle(value) end

    --- Inner cone angle for spotlight in radians (0 <= innerConeAngle <=
    --- outerConeAngle). Value of 0 disables inner cone angle.
    ---
    ---@param value number
    function LightComponent.SetInnerConeAngle(value) end

    --- Returns the type.
    ---
    ---@return integer
    function LightComponent.GetType() end

    --- Kept for backwards compatibility with non physical light units (before
    --- v0.70.0).
    ---
    ---@param value number
    function LightComponent.SetEnergy(value) end

    --- Kept for backwards compatibility with FOV angle (before v0.70.0).
    ---
    ---@param value number
    function LightComponent.SetFOV(value) end

    --- Returns whether the light casts shadows.
    ---
    ---@return boolean
    function LightComponent.IsCastShadow() end

    --- Returns whether volumetric light is enabled.
    ---
    ---@return boolean
    function LightComponent.IsVolumetricsEnabled() end