tyler2350 / BurstLinker-1

🚀 A simple GIF encoder for Android.

BurstLinker

Idea from: square/gifencoder

BurstLinker is a simple C++ GIF encode library.

Download

Android

Gradle:

implementation 'com.bilibili:burst-linker:latest-version'

Build Environment

Android Studio 3.2.1

NDK r18

Basic usage

int delayMs = 1000;
String filePath = getCacheDir() + File.separator + "out.gif";
BurstLinker burstLinker = new BurstLinker();

try {
    burstLinker.init(width, height, filePath);
    Bitmap colorBitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
    Canvas canvas = new Canvas(colorBitmap);
    Paint p = new Paint();
    int[] colors = new int[]{0xFFF00000, 0xFFFFFF00, 0xFFFFFFFF};
    for (int color : colors) {
        p.setColor(color);
        canvas.drawRect(0, 0, width, height, p);
        burstLinker.connect(colorBitmap, BurstLinker.OCTREE_QUANTIZER, 
                BurstLinker.NO_DITHER, 0, 0, delayMs);
    }
} catch (GifEncodeException e) {
    e.printStackTrace();
} finally {
    burstLinker.release();
}

Enable RenderScript Support

This is an untested experimental feature

1. Git branch /feature/render-script
2. Gradle sync, It will generate the required ScriptC_*.cpp
3. Uncomment the line 64 of the /lib/CMakeLists.txt
4. Run

Linux & Mac

1. Install CMake

   • Mac brew install cmake
   • ArchLinux sudo pacman -S cmake

2. Build

   • cd /BurstLinker
   • mkdir cmake-build-debug; cd cmake-build-debug
   • cmake ..
   • make BurstLinker

3. Run

   • ./BurstLinker 1000 1.jpg 2.jpg 3.jpg
   • See out.gif

Windows

1. Install Microsoft Visual Studio & CMake

2. Build

   • cd /BurstLinker
   • mkdir cmake-build-debug; cd cmake-build-debug
   • cmake ..
   • Open BurstLinker.sln
   • Solution Explorer -> BurstLinker -> Build

3. Run

   • cd Debug
   • BurstLinker.exe 1000 1.jpg 2.jpg 3.jpg
   • See out.gif

Samples

Different quantizers & ditherers

• Original

• Uniform + No

• MedianCut + No

• KMeans + No

• Random + No

• Octree + No

• NeuQuant - 10 + No

• NeuQuant - 1 + No

• Octree + M2

• Octree + Bayer

• Octree + FloydSteinberg

Encoding with transparent image

• Original

• Octree + No + Default (ARGB.a != 0)

• Octree + No + Ignore translucency (ARGB.a == 255)

Thanks

square/gifencoder

waynejo/android-ndk-gif

lucent1090/MCCQ

luxiaoxun/KMeans-GMM-HMM

SimonBoorer/Quantize

dali-neuquant

FFmpeg/FFmpeg

progschj/ThreadPool

License

Copyright 2018 Bilibili

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.