NsGifLib

NsGifLib is a library for working with GIF files in Android.

Installation

for gradle.kts:

add this inside repositories block:
- maven("https://jitpack.io")
implementation("com.github.Onix-Systems:NSGIF-Android:0.0.2")

Core module

Load, process, utilize gifs
Work with native code using JNI
Without *any Android dependencies

Usage

Initialization

val gifLib = NsGifLib.getInstance()

Loading Gifs

Load GIF from file: val gifId = gifLib.setGif("path/to/your/file.gif")
Load GIF from byte array val gifId = gifLib.setGif(byteArray)
Load GIF from input stream val gifId = gifLib.setGif(inputStream)

Retrieve Gif info

val gifInfo = gifLib.getGifInfo(gifId)

Copy Gif Data(frame)

val dest = IntArray(gifInfo.width * gifInfo.height) //create pixel array of gif size
val isSuccess = gifLib.copyPixels(dest, gifId) or
gifLib.setGifFrame(frame, gifId) // when using, please be aware that non-zero frame might be dependent on previous one
- For example: frame 2 is dependent on frames 0 and 1, so to get frame 2 of the gif animation, you need to call:
  - gifLib.setGifFrame(0, gifId) // not needed, frame 0 is set by default
  - gifLib.setGifFrame(1, gifId)
  - gifLib.setGifFrame(2, gifId)
  - And then copy pixels as of your need
val isSuccess = gifLib.copyPixels(dest, gifId)

Cleaning up

gifLib.destroyGif(gifId) // free allocated memory. please don't skip this step, it will cause memory leaks

License

MIT License. For more information see LICENSE