GIF Sprites

Adds support for .gif files in CCSprite::create() for Geometry Dash using giflib 5.0.0!

Usage

If the filename ends with .gif, a CCGIFAnimatedSprite is returned instead of a CCSprite. The animation plays automatically and uses embedded frame delays.

auto gif = CCSprite::create("animated.gif"); //returns CCGIFAnimatedSprite*
gif->setPosition(this->getContentSize() / 2);
this->addChild(gif, 10);

Or if you included <user95401.gif-sprites/include/CCGIFAnimatedSprite.hpp>:

#include <user95401.gif-sprites/include/CCGIFAnimatedSprite.hpp>

auto gif = CCGIFAnimatedSprite::create("animated.gif");
gif->setPosition(this->getContentSize() / 2);
this->addChild(gif, 10);

//and you able to getElapsed and stuff
float gifTimeElapsed = gif->getElapsed();

Features

• Hooks CCSprite::create(const char*) to support .gif
• Frame decoding with correct delays
• Automatic animation loop
• Shared caching on repeated loads
• Lightweight and early-load safe

Integration

Add to your mod.json dependencies:

"dependencies": {
    "user95401.gif-sprites": ">=v1.0.0"
}

And include headers (optional):

#include <user95401.gif-sprites/include/CCGIFAnimatedSprite.hpp>