DgsGIFGetSize

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

Returns the dimensions (width and height) of a GIF element created using dgsCreateGIF. The values correspond to the original size extracted from the GIF file during loading.

Syntax

int int dgsGIFGetSize( element gif )

Required Arguments

  • gif: The dgs-dxgif type element you want to get the size of.

Returns

Returns two integers corresponding to width and height

Example

-- This script should be executed on the client-side

-- Import the DGS functions to use them from another resource
local DGS = exports.dgs

-- 1. Load the GIF from a file within your resource
local myAnimatedGif = DGS.dgsCreateGIF("files/loading.gif")

-- 2. Check if the GIF was loaded successfully before proceeding
if myAnimatedGif then
    -- 3. Use dgsGIFGetSize to get the width and height of the loaded GIF
    local width, height = DGS.dgsGIFGetSize(myAnimatedGif)

    -- 4. Display the dimensions in the chat to confirm the result
    outputChatBox(string.format("The loaded GIF has the dimensions: %d width by %d height.", width, height))

    -- 5. Practical example: Create a DGS image in the center of the screen
    --    using the 'width' and 'height' we just obtained so the size is perfect.
    local screenW, screenH = guiGetScreenSize()
    local posX = screenW / 2 - width / 2
    local posY = screenH / 2 - height / 2

    local gifImage = DGS.dgsCreateImage(posX, posY, width, height, myAnimatedGif, false)

    -- Start the GIF's animation
    DGS.dgsGIFPlay(myAnimatedGif)
else
    -- Inform the user if the GIF was not found or if an error occurred during loading
    outputChatBox("Error: Could not load the GIF file.", 255, 0, 0)
end

See Also