fwcd / swift-gif

Cross-platform GIF encoder and decoder for Swift

GIF Coder for Swift

A lightweight LZW encoder and decoder for animated GIFs written in pure Swift, thus running on any platform, including Linux.

Example

// Create a new GIF
var gif = GIF(width: 300, height: 300)

// Add some frames for the animation
for i in 0..<20 {
    let image = try CairoImage(pngFilePath: "frame\(i).png")
    gif.frames.append(.init(image: image, delayTime: 100))
}

// Encode the GIF to a byte buffer
let data = try gif.encoded()

System Dependencies

• Swift 5.7+
• Cairo, see swift-graphics

swift-gif's Issues

Remove FFI include workaround

swift-gif/.github/workflows/build.yml

Lines 25 to 30 in f16b0de

	# Workaround for FFI modulemap redefinition error, see
	# - https://github.com/orgs/Homebrew/discussions/4025
	# - https://github.com/tauri-apps/tauri/issues/1150#issuecomment-768310979
	- name: Remove duplicate FFI headers (macOS)
	if: runner.os == 'macOS'
	run: find "/Library/Developer/CommandLineTools/SDKs" -name "MacOSX*.sdk" -type d -depth 1 -exec bash -c '[ -d {}/usr/include/ffi ] && sudo mv {}/usr/include/ffi{,.backup}' \;

We should either remove this now and build with a snapshot toolchain or wait for Swift 5.10 and then remove it.

See fwcd/d2#138 for details.

Implement GIF decoder

Multicore encoding

This repository could be much faster by encoding each frame in parallel. This is necessary to achieve acceptable latency in a production renderer, where videos are currently encoded in the GIF (640x640, 20 FPS). I am forking swift-gif and will update this thread when it has been optimized.

Remove `swift-graphics` dependency

We could make Image a protocol and add optional conformances for different platforms.