📄️ Installation
There are 2 ways to download the module into your game
📄️ Generating sprite sheets
Roblox doesn't allow users to upload GIF files, so to work around that, you need to convert your GIFs into sprite sheets. You can use https://gabys.xyz/giftosprite to do that.
📄️ Basic usage
The most basic way to use the player is to call the .new() method with a table of parameters:
📄️ Playing the same GIF on multiple screens
You can replace the Screen property with Screens, which is a table of UI elements / textures, to show the same GIF on multiple screens.
📄️ Using multiple sprite sheets
Sometimes your GIF has a lot of frames and you need to split it into multiple sprite sheets to keep good quality. You can replace all of the properties (except Screen) with a SpriteSheets property which is a table containing multiple sprite sheets.
📄️ Stopping all GIFs in an Instance
You can use the .DestroyAllGifsIn() function to destroy all gifs in the specified instance.
📄️ IDs
You can optionally add an ID to each GIF to be able to get it later in another script.
📄️ Effects
You can use the Effect property to tell the module how to show / hide GIFs. Currently only a Fade effect is available.
📄️ Example
The example game below is my testing place for the module. You can edit it by pressing the 3 dots and clicking Edit.