KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #dsh-plugin #deepseek-harness #windows #open-source #agent-skills #ai

godot-gif

★ 95 Open GitHub ↗

GDExtension for Godot 4+ to load GIF files as AnimatedTexture and/or SpriteFrames.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Godot GIF

## Description
GDExtension for Godot 4+ to load GIF files as [AnimatedTexture](https://docs.godotengine.org/en/stable/classes/class_animatedtexture.html) and/or [SpriteFrames](https://docs.godotengine.org/en/stable/classes/class_spriteframes.html).

NOTE: ~~**AnimatedTexture**~~ has been marked as deprecated according to development docs and could be removed in a future version of Godot.

## Usage

### Pre-Editor (New Feature)

Added a binary version for windows and linux to convert gifs via command line into **standalone resource files** which can then be added to any Godot project (4.4+) without requiring this addon (unless new gifs need to be converted at runtime)

## Godot Gif Converter:

Example Usage: godot_gif_convert --verbose -- --in=/temp/some-gif.gif --out=/temp/out --ext=res --fps=60

--in                                    [REQUIRED]                              Gif file path or path to directory containing gifs
        --out                                   [REQUIRED]                              Path to directory to create output result
        
        --type                                  (Optional)                              Defaults to SpriteFrames. Can also be set to AnimatedTexture, or Both
        --ext                                   (Optional)                              Defaults to tres. The file extension to use when saving the resource (tres/res)
        --max_frames                            (Optional)                              Defaults to 0. When 0, no limit, otherwise only frames inclusively up to the limit will be used
        --fps                                   (Optional)                              Defaults to 30. Frames per second for SpriteFrames. Not applicable to AnimatedTexure

### Editor

Gif files can be imported at edit time as one of the supported types via Import options.

<details open>
 <summary>Editor Imports Options</summary>
 
![Editor Imports Options](https://raw.githubusercontent.com/BOTLANNER/godot-gif/main/docs-images/EditorImportSettings.gif)
</details>

See the [Editor Imports](./demo/editor_imports_example.tscn) example scene.
<details open>
 <summary>Editor Imports Example</summary>
 
![Editor Imports](https://raw.githubusercontent.com/BOTLANNER/godot-gif/main/docs-images/EditorImports.gif)
</details>

<hr/>

### Runtime

Gif files can be loaded at runtime as one of the supported types via the `GifManager` singleton.

`GifManager` exposes the following methods for loading gifs either from file or from bytes directly:
![GifManager Methods](https://raw.githubusercontent.com/BOTLANNER/godot-gif/main/docs-images/methods.png)

e.g. to load from file
```py
get_node("AnimFromRuntimeFile").texture = GifManager.animated_texture_from_file("res://examples/file/optic.gif")

get_node("AnimatedSprite2RuntimeFile").sprite_frames = GifManager.sprite_frames_from_file("res://examples/file/optic.gif")
```

See the [Runtime Imports](./demo/main.tscn) example scene.
<details open>
 <summary>Runtime Imports Example</summary>
 
![Runtime Imports](https://raw.githubusercontent.com/BOTLANNER/godot-gif/main/docs-images/RuntimeImports.gif)
</details>

## Installation

Download the `gdextension` artifact from the [latest successful build](https://github.com/BOTLANNER/godot-gif/actions/workflows/build_releases.yml). (It should be right at the bottom of the **Summary**)
![image](https://github.com/BOTLANNER/godot-gif/assets/16349308/f28867c6-f669-45f2-9309-dbb17cec2031)

Extract the contents to your Godot project directory.

You should have an `addons` directory at the root with the following structure:
```bash
└───addons
    └───godotgif
        │   godotgif.gdextension
        │   LICENSE.txt
        │   README.md
        │
        └───bin
            │   godotgif.windows.template_debug.x86_32.dll
            │   godotgif.windows.template_debug.x86_64.dll
            │   godotgif.windows.template_release.x86_32.dll
            │   godotgif.windows.template_release.x86_64.dll
            │   libgodotgif.android.template_debug.arm64.so
            │   libgodotgif.android.template_release.arm64.so
            │   libgodotgif.linux.template_debug.x86_32.so
            │   libgodotgif.linux.template_debug.x86_64.so
            │   libgodotgif.linux.template_release.x86_32.so
            │   libgodotgif.linux.template_release.x86_64.so
            │
            ├───godotgif.macos.template_debug.framework
            │       libgodotgif.macos.template_debug
            │
            └───godotgif.macos.template_release.framework
                    libgodotgif.macos.template_release
```

Open your project. Any exisitng gifs should auto-import. New gifs in the project directory will automatically import as `SpriteFrames`. To convert them into `AnimatedTexture`, update the [import settings](#editor).

The `GifManager` class should also now be available for access within GDScript.

## Contributing

### Setup

Ensure **SCons** is setup. Refer to [Introduction to the buildsystem](https://docs.godotengine.org/en/stable/contributing/development/compiling/introduction_to_the_buildsystem.html)

* If using a different version of Godot, be sure to dump the bindings e.g. 
 ```sh
 godot --dump-extension-api extension_api.json
 ```
* Compile with 
 ```sh
 scons platform=<platform> custom_api_file=extension_api.json
 ```

### Debugging

This repository is configured for use with [VSCode](https://code.visualstudio.com/)

[Launch configurations](./.vscode/launch.json) have been setup for both debugging in editor and in runtime provided certain **VSCode** extensions are present and environment variables are defined.

The following environment variables are required:

1. `GODOT_PATH` - The directory in which Godot is installed
1. `GODOT_EXECUTABLE` - The executable name of the Godot installation

### More Details
Refer to [GDExtension C++ example](https://docs.godotengine.org/en/stable/tutorials/scripting/gdextension/gdextension_cpp_example.html)

## License

Unless otherwise specified, the extension is released under the
[MIT license](LICENSE.txt).

See the full list of third-party libraries with their licenses used by this
extension at [src/thirdparty/README.md](src/thirdparty/README.md).

This implementation heavily borrowed inspiration from the [gif module](https://github.com/goostengine/goost/tree/gd3/modules/gif) for [Goost](https://github.com/goostengine/goost) that is currently only based on Godot 3

godot-gif

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README