jpeg

Documentation

Overview

Package jpeg decodes JPEG image to image.YCbCr using libjpeg (or libjpeg-turbo).

Index

• Constants
• func Decode(r io.Reader, options *DecoderOptions) (dest image.Image, err error)
• func DecodeConfig(r io.Reader) (config image.Config, err error)
• func DecodeIntoRGB(r io.Reader, options *DecoderOptions) (dest *rgb.Image, err error)
• func DecodeIntoRGBA(r io.Reader, options *DecoderOptions) (dest *image.RGBA, err error)
• func DecodeIntoRGBA2(dest **image.RGBA, r io.Reader, options *DecoderOptions) (err error)
• func DestinationManagerMapLen() int
• func Encode(w io.Writer, src image.Image, opt *EncoderOptions) (err error)
• func NewGrayAligned(r image.Rectangle) *image.Gray
• func NewYCbCrAligned(r image.Rectangle, subsampleRatio image.YCbCrSubsampleRatio) *image.YCbCr
• func SourceManagerMapLen() int
• func SupportRGBA() bool
• type DCTMethod
• type DecoderOptions
• type EncoderOptions

Constants

const (
	Y  = 0
	Cb = 1
	Cr = 2
)

Y/Cb/Cr Planes

Functions

func Decode

func Decode(r io.Reader, options *DecoderOptions) (dest image.Image, err error)

Decode reads a JPEG data stream from r and returns decoded image as an image.Image. Output image has YCbCr colors or 8bit Grayscale.

func DecodeConfig

func DecodeConfig(r io.Reader) (config image.Config, err error)

DecodeConfig returns the color model and dimensions of a JPEG image without decoding the entire image.

func DecodeIntoRGB

func DecodeIntoRGB(r io.Reader, options *DecoderOptions) (dest *rgb.Image, err error)

DecodeIntoRGB reads a JPEG data stream from r and returns decoded image as an rgb.Image with RGB colors.

func DecodeIntoRGBA

func DecodeIntoRGBA(r io.Reader, options *DecoderOptions) (dest *image.RGBA, err error)

DecodeIntoRGBA reads a JPEG data stream from r and returns decoded image as an image.RGBA with RGBA colors. This function only works with libjpeg-turbo, not libjpeg.

func DecodeIntoRGBA2

func DecodeIntoRGBA2(dest **image.RGBA, r io.Reader, options *DecoderOptions) (err error)

DecodeIntoRGBA2 does the same as the original DecodeIntoRGBA2 method, but reuses the provided image.RGBA (if the dimensions stay the same) instead of always creating a new instance.

func DestinationManagerMapLen

func DestinationManagerMapLen() int

DestinationManagerMapLen returns the number of globally working destinationManagers for debug.

func Encode

func Encode(w io.Writer, src image.Image, opt *EncoderOptions) (err error)

Encode encodes src image and writes into w as JPEG format data.

func NewGrayAligned

func NewGrayAligned(r image.Rectangle) *image.Gray

NewGrayAligned Allocates Grey image with padding. This func add an extra padding to cover overflow from decoding image.

func NewYCbCrAligned

func NewYCbCrAligned(r image.Rectangle, subsampleRatio image.YCbCrSubsampleRatio) *image.YCbCr

NewYCbCrAligned Allocates YCbCr image with padding. Because LibJPEG needs extra padding to decoding buffer, This func add an extra alignSize (16) padding to cover overflow from any such modes.

func SourceManagerMapLen

func SourceManagerMapLen() int

SourceManagerMapLen returns the number of globally working sourceManagers for debug.

func SupportRGBA

func SupportRGBA() bool

SupportRGBA returns whether RGBA decoding is supported.

Types

type DCTMethod

type DCTMethod C.J_DCT_METHOD

DCTMethod is the DCT/IDCT method type.

const (
	// DCTISlow is slow but accurate integer algorithm
	DCTISlow DCTMethod = C.JDCT_ISLOW
	// DCTIFast is faster, less accurate integer method
	DCTIFast DCTMethod = C.JDCT_IFAST
	// DCTFloat is floating-point: accurate, fast on fast HW
	DCTFloat DCTMethod = C.JDCT_FLOAT
)

type DecoderOptions

type DecoderOptions struct {
	ScaleTarget            image.Rectangle // ScaleTarget is the target size to scale image.
	DCTMethod              DCTMethod       // DCTMethod is DCT Algorithm method.
	DisableFancyUpsampling bool            // If true, disable fancy upsampling
	DisableBlockSmoothing  bool            // If true, disable block smoothing
}

DecoderOptions specifies JPEG decoding parameters.

type EncoderOptions

type EncoderOptions struct {
	Quality         int
	OptimizeCoding  bool
	ProgressiveMode bool
	DCTMethod       DCTMethod
}

EncoderOptions specifies which settings to use during Compression.