https://github.com/jdeng/goheif

go gettable decoder/converter for HEIF/HEIC based on libde265
https://github.com/jdeng/goheif

golang heic heif hevc libde265

Last synced: 5 days ago
JSON representation

go gettable decoder/converter for HEIF/HEIC based on libde265

• Host: GitHub
• URL: https://github.com/jdeng/goheif
• Owner: jdeng
• Created: 2019-03-01T23:51:57.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2024-11-15T16:38:57.000Z (2 months ago)
• Last Synced: 2025-01-03T13:52:57.275Z (12 days ago)
• Topics: golang, heic, heif, hevc, libde265
• Language: Go
• Size: 603 KB
• Stars: 188
• Watchers: 4
• Forks: 69
• Open Issues: 6
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# GoHeif - A go gettable decoder/converter for HEIC based on libde265

## Install

- `heic2jpg` to convert HEIC files to JPG preserving exif 

``` go get github.com/jdeng/goheif/...```

- Tested

  - Mac OS X (High Sierra) 

  - Linux (Ubuntu 16.04 / GCC 5.4)

  - Windows 7 64bit with TDM-GCC 32 (GCC 5.1) and golang 1.12 windows/386

- Code Sample

```

func main() {

	flag.Parse()

	...

  

	fin, fout := flag.Arg(0), flag.Arg(1)

	fi, err := os.Open(fin)

	if err != nil {

		log.Fatal(err)

	}

	defer fi.Close()

	exif, err := goheif.ExtractExif(fi)

	if err != nil {

		log.Printf("Warning: no EXIF from %s: %v\n", fin, err)

	}

	img, err := goheif.Decode(fi)

	if err != nil {

		log.Fatalf("Failed to parse %s: %v\n", fin, err)

	}

	fo, err := os.OpenFile(fout, os.O_RDWR|os.O_CREATE, 0644)

	if err != nil {

		log.Fatalf("Failed to create output file %s: %v\n", fout, err)

	}

	defer fo.Close()

	w, _ := newWriterExif(fo, exif)

	err = jpeg.Encode(w, img, nil)

	if err != nil {

		log.Fatalf("Failed to encode %s: %v\n", fout, err)

	}

	log.Printf("Convert %s to %s successfully\n", fin, fout)

}

```

## What is done

- Changes make to @bradfitz's (https://github.com/bradfitz) golang heif parser

  - Some minor bugfixes

  - A few new box parsers, noteably 'iref' and 'hvcC'

- Include libde265's source code (SSE by default enabled) and a simple golang binding

- A Utility `heic2jpg` to illustrate the usage.

## License

- heif and libde265 are in their own licenses

- goheif.go, libde265 golang binding and the `heic2jpg` utility are in MIT license

## Credits

- heif parser by @bradfitz (https://github.com/go4org/go4/tree/master/media/heif)

- libde265 (https://github.com/strukturag/libde265)

- implementation learnt from libheif (https://github.com/strukturag/libheif)

## TODO

- Upstream the changes to heif?