caire: github.com/esimov/caire Index | Files

package caire

import "github.com/esimov/caire"

Package caire is a content aware image resize library, which can rescale the source image seamlessly both vertically and horizontally by eliminating the less important parts of the image.

The package provides a command line interface, supporting various flags for different types of rescaling operations. To check the supported commands type: 

$ caire --help

In case you wish to integrate the API in a self constructed environment here is a simple example: 

package main

import (
	"fmt"
	"github.com/esimov/caire"
)

func main() {
	p := &caire.Processor{
		// Initialize struct variables
	}

	if err := p.Process(in, out); err != nil {
		fmt.Printf("Error rescaling image: %s", err.Error())
	}
}

Index

Package Files

carver.go doc.go grayscale.go process.go sobel.go stackblur.go

Variables

❖
var TempImage = fmt.Sprintf("%d.jpg", time.Now().Unix())

TempImage temporary image file.

func Grayscale Uses

❖
func Grayscale(src *image.NRGBA) *image.NRGBA

Grayscale converts the image to grayscale mode.

func RemoveTempImage Uses

❖
func RemoveTempImage(tmpImage string)

RemoveTempImage removes the temporary image generated during face detection process.

func Resize Uses

❖
func Resize(s SeamCarver, img *image.NRGBA) (image.Image, error)

Resize implements the Resize method of the Carver interface. It returns the concrete resize operation method.

func SobelFilter Uses

❖
func SobelFilter(img *image.NRGBA, threshold float64) *image.NRGBA

SobelFilter detects image edges. See https://en.wikipedia.org/wiki/Sobel_operator

func StackBlur Uses

❖
func StackBlur(img *image.NRGBA, radius uint32) *image.NRGBA

StackBlur applies a blur filter to the provided image. The radius defines the bluring average.

type ActiveSeam Uses

❖
type ActiveSeam struct {
    Seam
    Pix color.Color
}

ActiveSeam contains the current seam position and color.

type Carver Uses

❖
type Carver struct {
    Width  int
    Height int
    Points []float64
}

Carver is the main entry struct having as parameters the newly generated image width, height and seam points.

func NewCarver Uses

❖
func NewCarver(width, height int) *Carver

NewCarver returns an initialized Carver structure.

func (*Carver) AddSeam Uses

❖
func (c *Carver) AddSeam(img *image.NRGBA, seams []Seam, debug bool) *image.NRGBA

AddSeam add new seam.

func (*Carver) ComputeSeams Uses

❖
func (c *Carver) ComputeSeams(img *image.NRGBA, p *Processor)

ComputeSeams compute the minimum energy level based on the following logic: 

- traverse the image from the second row to the last row
  and compute the cumulative minimum energy M for all possible
  connected seams for each entry (i, j).

- the minimum energy level is calculated by summing up the current pixel value
  with the minimum pixel value of the neighboring pixels from the previous row.

func (*Carver) FindLowestEnergySeams Uses

❖
func (c *Carver) FindLowestEnergySeams() []Seam

FindLowestEnergySeams find the lowest vertical energy seam.

func (*Carver) RemoveSeam Uses

❖
func (c *Carver) RemoveSeam(img *image.NRGBA, seams []Seam, debug bool) *image.NRGBA

RemoveSeam remove the least important columns based on the stored energy (seams) level.

func (*Carver) RotateImage270 Uses

❖
func (c *Carver) RotateImage270(src *image.NRGBA) *image.NRGBA

RotateImage270 rotate the image by 270 degree counter clockwise.

func (*Carver) RotateImage90 Uses

❖
func (c *Carver) RotateImage90(src *image.NRGBA) *image.NRGBA

RotateImage90 rotate the image by 90 degree counter clockwise.

type Processor Uses

❖
type Processor struct {
    SobelThreshold int
    BlurRadius     int
    NewWidth       int
    NewHeight      int
    Percentage     bool
    Square         bool
    Debug          bool
    Scale          bool
    FaceDetect     bool
    FaceAngle      float64
    Classifier     string
}

Processor options

func (*Processor) Process Uses

❖
func (p *Processor) Process(r io.Reader, w io.Writer) error

Process is the main function having as parameters an input reader and an output writer. We are using the io package, because this way we can provide different types of input and output source, as long as they implement the io.Reader and io.Writer interface.

func (*Processor) Resize Uses

❖
func (p *Processor) Resize(img *image.NRGBA) (image.Image, error)

Resize method takes the source image and rescales it using the parameters provided. The new image can be rescaled either horizontally or vertically (or both). Depending on the provided parameters the image can be either reduced or enlarged.

type Seam Uses

❖
type Seam struct {
    X   int
    Y   int
}

Seam struct contains the seam pixel coordinates.

type SeamCarver Uses

❖
type SeamCarver interface {
    Resize(*image.NRGBA) (image.Image, error)
}

SeamCarver interface defines the Resize method. This has to be implemented by every struct which declares a Resize method.

type UsedSeams Uses

❖
type UsedSeams struct {
    ActiveSeam []ActiveSeam
}

UsedSeams contains the already generated seams.

Package caire imports 21 packages (graph) and is imported by 1 packages. Updated 2020-12-23. Refresh now. Tools for package owners.