https://github.com/joshdk/preview

🖼 Simple cross platform image viewing for developers
https://github.com/joshdk/preview

cross-platform golang image-viewer

Last synced: about 4 hours ago
JSON representation

🖼 Simple cross platform image viewing for developers

• Host: GitHub
• URL: https://github.com/joshdk/preview
• Owner: joshdk
• License: mit
• Created: 2017-10-18T01:06:09.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2017-11-01T18:41:00.000Z (about 7 years ago)
• Last Synced: 2023-08-12T06:29:43.977Z (over 1 year ago)
• Topics: cross-platform, golang, image-viewer
• Language: Shell
• Homepage:
• Size: 4.43 MB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
[![License](https://img.shields.io/github/license/joshdk/preview.svg)](https://opensource.org/licenses/MIT)

[![GoDoc](https://godoc.org/github.com/joshdk/preview?status.svg)](https://godoc.org/github.com/joshdk/preview)

[![Go Report Card](https://goreportcard.com/badge/github.com/joshdk/preview)](https://goreportcard.com/report/github.com/joshdk/preview)

[![CircleCI](https://circleci.com/gh/joshdk/preview.svg?&style=shield)](https://circleci.com/gh/joshdk/preview/tree/master)

# Preview

🎨 Simple cross platform image viewing for developers

## Installing

You can fetch this library by running the following

    go get -u github.com/joshdk/preview

## Usage

```go

import (

	"image/jpeg"

	"net/http"

	"github.com/joshdk/preview"

)

resp, err := http.Get("https://i.imgur.com/X9GB4Pu.jpg")

if err != nil {

	panic(err.Error())

}

img, err := jpeg.Decode(resp.Body)

if err != nil {

	panic(err.Error())

}

preview.Image(img)

```

If run on a Mac, this code will open up the [Preview utility](https://en.wikipedia.org/wiki/Preview_(macOS)), displaying the downloaded image. On Linux, the [display](https://linux.die.net/man/1/display) or [xv](https://en.wikipedia.org/wiki/Xv_(software)) utility is used.

Previewing of the following types are supported:

- [`color.Color`](https://golang.org/pkg/image/color/#Color) (or a slice of `[]color.Color`)

- [`image.Image`](https://golang.org/pkg/image/#Image)

- [`glot.Plot`](https://godoc.org/github.com/Arafatk/glot#Plot) from [Glot](https://github.com/Arafatk/glot)

- [`plot.Plot`](https://godoc.org/gonum.org/v1/plot#Plot) from [Gonum Plot](https://github.com/gonum/plot)

- Local filesystem paths

## License

This library is distributed under the [MIT License](https://opensource.org/licenses/MIT), see LICENSE.txt for more information.