Golang标准库——image

DevilRoshan · · 2453 次点击 · · 开始浏览    
这是一个创建于 的文章,其中的信息可能已经有所发展或是发生改变。

image

image实现了基本的2D图片库。

基本接口叫作Image。图片的色彩定义在image/color包。

Image接口可以通过调用如NewRGBA和NewPaletted函数等获得;也可以通过调用Decode函数解码包含GIF、JPEG或PNG格式图像数据的输入流获得。解码任何具体图像类型之前都必须注册对应类型的解码函数。注册过程一般是作为包初始化的副作用,放在包的init函数里。因此,要解码PNG图像,只需在程序的main包里嵌入如下代码:

import _ "image/png"

_表示导入包但不使用包中的变量/函数/类型,只是为了包初始化函数的副作用。

参见http://golang.org/doc/articles/image_package.html

Variables

var (
    // Black是一个完全不透明的面积无限大的黑色图像
    Black = NewUniform(color.Black)
    // White是一个完全不透明的面积无限大的白色图像
    White = NewUniform(color.White)
    // Transparent是一个完全透明的面积无限大的图像
    Transparent = NewUniform(color.Transparent)
    // Opaque是一个完全不透明的面积无限大的图像
    Opaque = NewUniform(color.Opaque)
)
var ErrFormat = errors.New("image: unknown format")

ErrFormat说明解码时遇到了未知的格式。

type Image

type Image interface {
    // ColorModel方法返回图像的色彩模型
    ColorModel() color.Model
    // Bounds方法返回图像的范围,范围不一定包括点(0, 0)
    Bounds() Rectangle
    // At方法返回(x, y)位置的色彩
    // At(Bounds().Min.X, Bounds().Min.Y)返回网格左上角像素的色彩
    // At(Bounds().Max.X-1, Bounds().Max.Y-1) 返回网格右下角像素的色彩
    At(x, y int) color.Color
}

Image接口表示一个采用某色彩模型的颜色构成的有限矩形网格(即一幅图像)。

func Decode

func Decode(r io.Reader) (Image, string, error)

DecodeConfig函数解码并返回一个采用某种已注册格式编码的图像。字符串返回值是该格式注册时的名字。格式一般是在该编码格式的包的init函数中注册的。

type PalettedImage

type PalettedImage interface {
    // ColorIndexAt方法返回(x, y)位置的像素的(调色板)索引
    ColorIndexAt(x, y int) uint8
    Image
}

PalettedImage接口代表一幅图像,它的像素可能来自一个有限的调色板。

如果有对象m满足PalettedImage接口,且m.ColorModel()返回的color.Model接口底层为一个Palette类型值(记为p),则m.At(x, y)返回值应等于p[m.ColorIndexAt(x, y)]。如果m的色彩模型不是Palette,则ColorIndexAt的行为是不确定的。

type Config

type Config struct {
    ColorModel    color.Model
    Width, Height int
}

Config保管图像的色彩模型和尺寸信息。

func DecodeConfig

func DecodeConfig(r io.Reader) (Config, string, error)

DecodeConfig函数解码并返回一个采用某种已注册格式编码的图像的色彩模型和尺寸。字符串返回值是该格式注册时的名字。格式一般是在该编码格式的包的init函数中注册的。

func RegisterFormat

func RegisterFormat(name, magic string, decode func(io.Reader) (Image, error), decodeConfig func(io.Reader) (Config, error))

RegisterFormat注册一个供Decode函数使用的图片格式。name是格式的名字,如"jpeg"或"png";magic是该格式编码的魔术前缀,该字符串可以包含"?"通配符,每个通配符匹配一个字节;decode函数用于解码图片;decodeConfig函数只解码图片的配置。

type Point

type Point struct {
    X, Y int
}

Point是X, Y坐标对。坐标轴是向右(X)向下(Y)的。既可以表示点,也可以表示向量。

var ZP Point

ZP是原点。

func Pt

func Pt(X, Y int) Point

返回Point{X , Y}

func (Point) Eq

func (p Point) Eq(q Point) bool

报告p和q是否相同。

func (Point) Add

func (p Point) Add(q Point) Point

返回点Point{p.X+q.X, p.Y+q.Y}

func (Point) Sub

func (p Point) Sub(q Point) Point

返回点Point{p.X-q.X, p.Y-q.Y}

func (Point) Mul

func (p Point) Mul(k int) Point

返回点Point{p.Xk, p.Yk}

func (Point) Div

func (p Point) Div(k int) Point

返回点Point{p.X/k, p.Y/k }

func (Point) In

func (p Point) In(r Rectangle) bool

报告p是否在r范围内。

func (Point) Mod

func (p Point) Mod(r Rectangle) Point

返回r范围内的某点q,满足p.X-q.X是r宽度的倍数,p.Y-q.Y是r高度的倍数。

func (Point) String

func (p Point) String() string

返回p的字符串表示。格式为"(3,4)"

type Rectangle

type Rectangle struct {
    Min, Max Point
}

Rectangle代表一个矩形。该矩形包含所有满足Min.X <= X < Max.X且Min.Y <= Y < Max.Y的点。如果两个字段满足Min.X <= Max.X且Min.Y <= Max.Y,就称该实例为规范格式的。矩形的方法,当输入是规范格式时,总是返回规范格式的输出。

var ZR Rectangle

ZR是矩形的零值。

func Rect

func Rect(x0, y0, x1, y1 int) Rectangle

返回一个矩形Rectangle{Pt(x0, y0), Pt(x1, y1)}。

func (Rectangle) Canon

func (r Rectangle) Canon() Rectangle

返回矩形的规范版本(左上&右下),方法必要时会交换坐标的最大值和最小值。

func (Rectangle) Dx

func (r Rectangle) Dx() int

返回r的宽度。

func (Rectangle) Dy

func (r Rectangle) Dy() int

返回r的高度。

func (Rectangle) Size

func (r Rectangle) Size() Point

返回r的宽度w和高度h构成的点Point{w, h}。

func (Rectangle) Empty

func (r Rectangle) Empty() bool

报告矩形是否为空矩形。(即内部不包含点的矩形)

func (Rectangle) Eq

func (r Rectangle) Eq(s Rectangle) bool

报告两个矩形是否相同。

func (Rectangle) In

func (r Rectangle) In(s Rectangle) bool

如果r包含的所有点都在s内,则返回真;否则返回假。

func (Rectangle) Overlaps

func (r Rectangle) Overlaps(s Rectangle) bool

如果r和s有非空的交集,则返回真;否则返回假。

func (Rectangle) Add

func (r Rectangle) Add(p Point) Rectangle

返回矩形按p(作为向量)平移后的新矩形。

func (Rectangle) Sub

func (r Rectangle) Sub(p Point) Rectangle

返回矩形按p(作为向量)反向平移后的新矩形。

func (Rectangle) Intersect

func (r Rectangle) Intersect(s Rectangle) Rectangle

返回两个矩形的交集矩形(同时被r和s包含的最大矩形);如果r和s没有重叠会返回Rectangle零值。

func (Rectangle) Union

func (r Rectangle) Union(s Rectangle) Rectangle

返回同时包含r和s的最小矩形。

func (Rectangle) Inset

func (r Rectangle) Inset(n int) Rectangle

返回去掉矩形四周宽度n的框的矩形,n可为负数。如果n过大将返回靠近r中心位置的空矩形。

func (Rectangle) String

func (r Rectangle) String() string

返回矩形的字符串表示,格式为"(3,4)-(6,5)"。

type Uniform

type Uniform struct {
    C color.Color
}

Uniform类型代表一块面积无限大的具有同一色彩的图像。它实现了color.Color、color.Model和Image等接口。

func NewUniform

func NewUniform(c color.Color) *Uniform

func (*Uniform) At

func (c *Uniform) At(x, y int) color.Color

func (*Uniform) Bounds

func (c *Uniform) Bounds() Rectangle

func (*Uniform) ColorModel

func (c *Uniform) ColorModel() color.Model

func (*Uniform) Convert

func (c *Uniform) Convert(color.Color) color.Color

func (*Uniform) Opaque

func (c *Uniform) Opaque() bool

Opaque方法扫描整个图像并报告该图像是否是完全不透明的。

func (*Uniform) RGBA

func (c *Uniform) RGBA() (r, g, b, a uint32)

type Alpha

type Alpha struct {
    // Pix保管图像的像素,内容为alpha通道值(即透明度)。
    // 像素(x, y)起始位置是Pix[(y-Rect.Min.Y)*Stride + (x-Rect.Min.X)*1]
    Pix []uint8
    // Stride是Pix中每行像素占用的字节数
    Stride int
    // Rect是图像的范围
    Rect Rectangle
}

Alpha类型代表一幅内存中的图像,其At方法返回color.Alpha类型的值。

func NewAlpha

func NewAlpha(r Rectangle) *Alpha

NewAlpha函数创建并返回一个具有指定宽度和高度的Alpha。

func (*Alpha) At

func (p *Alpha) At(x, y int) color.Color

func (*Alpha) Bounds

func (p *Alpha) Bounds() Rectangle

func (*Alpha) ColorModel

func (p *Alpha) ColorModel() color.Model

func (*Alpha) Opaque

func (p *Alpha) Opaque() bool

Opaque方法扫描整个图像并报告图像是否是完全不透明的。

func (*Alpha) PixOffset

func (p *Alpha) PixOffset(x, y int) int

PixOffset方法返回像素(x, y)的数据起始位置在Pix字段的偏移量/索引。

func (*Alpha) Set

func (p *Alpha) Set(x, y int, c color.Color)

func (*Alpha) SetAlpha

func (p *Alpha) SetAlpha(x, y int, c color.Alpha)

func (*Alpha) SubImage

func (p *Alpha) SubImage(r Rectangle) Image

SubImage方法返回代表原图像一部分(r的范围)的新图像。返回值和原图像的像素数据是共用的。

type Alpha16

type Alpha16 struct {
    // Pix保管图像的像素,内容为alpha通道值(即透明度,大端在前的格式)。
    // 像素(x, y)起始位置是Pix[(y-Rect.Min.Y)*Stride + (x-Rect.Min.X)*2]
    Pix []uint8
    // Stride是Pix中每行像素占用的字节数
    Stride int
    // Rect是图像的范围
    Rect Rectangle
}

Alpha16类型代表一幅内存中的图像,其At方法返回color.Alpha16类型的值。

func NewAlpha16

func NewAlpha16(r Rectangle) *Alpha16

NewAlpha16函数创建并返回一个具有指定范围的Alpha16。

func (*Alpha16) At

func (p *Alpha16) At(x, y int) color.Color

func (*Alpha16) Bounds

func (p *Alpha16) Bounds() Rectangle

func (*Alpha16) ColorModel

func (p *Alpha16) ColorModel() color.Model

func (*Alpha16) Opaque

func (p *Alpha16) Opaque() bool

Opaque方法扫描整个图像并报告图像是否是完全不透明的。

func (*Alpha16) PixOffset

func (p *Alpha16) PixOffset(x, y int) int

PixOffset方法返回像素(x, y)的数据起始位置在Pix字段的偏移量/索引。

func (*Alpha16) Set

func (p *Alpha16) Set(x, y int, c color.Color)

func (*Alpha16) SetAlpha16

func (p *Alpha16) SetAlpha16(x, y int, c color.Alpha16)

func (*Alpha16) SubImage

func (p *Alpha16) SubImage(r Rectangle) Image

SubImage方法返回代表原图像一部分(r的范围)的新图像。返回值和原图像的像素数据是共用的。

type Gray

type Gray struct {
    // Pix保管图像的像素,内容为灰度。
    // 像素(x, y)起始位置是Pix[(y-Rect.Min.Y)*Stride + (x-Rect.Min.X)*1]
    Pix []uint8
    // Stride是Pix中每行像素占用的字节数
    Stride int
    // Rect是图像的范围
    Rect Rectangle
}

Gray类型代表一幅内存中的图像,其At方法返回color.Gray类型的值。

func NewGray

func NewGray(r Rectangle) *Gray

NewGray函数创建并返回一个具有指定范围的Gray。

func (*Gray) At

func (p *Gray) At(x, y int) color.Color

func (*Gray) Bounds

func (p *Gray) Bounds() Rectangle

func (*Gray) ColorModel

func (p *Gray) ColorModel() color.Model

func (*Gray) Opaque

func (p *Gray) Opaque() bool

Opaque方法扫描整个图像并报告图像是否是完全不透明的。

func (*Gray) PixOffset

func (p *Gray) PixOffset(x, y int) int

PixOffset方法返回像素(x, y)的数据起始位置在Pix字段的偏移量/索引。

func (*Gray) Set

func (p *Gray) Set(x, y int, c color.Color)

func (*Gray) SetGray

func (p *Gray) SetGray(x, y int, c color.Gray)

func (*Gray) SubImage

func (p *Gray) SubImage(r Rectangle) Image

SubImage方法返回代表原图像一部分(r的范围)的新图像。返回值和原图像的像素数据是共用的。

type Gray16

type Gray16 struct {
    // Pix保管图像的像素,内容为灰度(大端在前的格式)。
    // 像素(x, y)起始位置是Pix[(y-Rect.Min.Y)*Stride + (x-Rect.Min.X)*2]
    Pix []uint8
    // Stride是Pix中每行像素占用的字节数
    Stride int
    // Rect是图像的范围
    Rect Rectangle
}

Gray16类型代表一幅内存中的图像,其At方法返回color.Gray16类型的值。

func NewGray16

func NewGray16(r Rectangle) *Gray16

NewGray16函数创建并返回一个具有指定范围的Gray16。

func (*Gray16) At

func (p *Gray16) At(x, y int) color.Color

func (*Gray16) Bounds

func (p *Gray16) Bounds() Rectangle

func (*Gray16) ColorModel

func (p *Gray16) ColorModel() color.Model

func (*Gray16) Opaque

func (p *Gray16) Opaque() bool

Opaque方法扫描整个图像并报告图像是否是完全不透明的。

func (*Gray16) PixOffset

func (p *Gray16) PixOffset(x, y int) int

PixOffset方法返回像素(x, y)的数据起始位置在Pix字段的偏移量/索引。

func (*Gray16) Set

func (p *Gray16) Set(x, y int, c color.Color)

func (*Gray16) SetGray16

func (p *Gray16) SetGray16(x, y int, c color.Gray16)

func (*Gray16) SubImage

func (p *Gray16) SubImage(r Rectangle) Image

SubImage方法返回代表原图像一部分(r的范围)的新图像。返回值和原图像的像素数据是共用的。

type RGBA

type RGBA struct {
    // Pix保管图像的像素色彩信息,顺序为R, G, B, A
    // 像素(x, y)起始位置是Pix[(y-Rect.Min.Y)*Stride + (x-Rect.Min.X)*4]
    Pix []uint8
    // Stride是Pix中每行像素占用的字节数
    Stride int
    // Rect是图像的范围
    Rect Rectangle
}

RGBA类型代表一幅内存中的图像,其At方法返回color.RGBA类型的值。

func NewRGBA

func NewRGBA(r Rectangle) *RGBA

NewRGBA函数创建并返回一个具有指定范围的RGBA。

func (*RGBA) At

func (p *RGBA) At(x, y int) color.Color

func (*RGBA) Bounds

func (p *RGBA) Bounds() Rectangle

func (*RGBA) ColorModel

func (p *RGBA) ColorModel() color.Model

func (*RGBA) Opaque

func (p *RGBA) Opaque() bool

Opaque方法扫描整个图像并报告图像是否是完全不透明的。

func (*RGBA) PixOffset

func (p *RGBA) PixOffset(x, y int) int

PixOffset方法返回像素(x, y)的数据起始位置在Pix字段的偏移量/索引。

func (*RGBA) Set

func (p *RGBA) Set(x, y int, c color.Color)

func (*RGBA) SetRGBA

func (p *RGBA) SetRGBA(x, y int, c color.RGBA)

func (*RGBA) SubImage

func (p *RGBA) SubImage(r Rectangle) Image

SubImage方法返回代表原图像一部分(r的范围)的新图像。返回值和原图像的像素数据是共用的。

type RGBA64

type RGBA64 struct {
    // Pix保管图像的像素色彩信息,顺序为R, G, B, A(每个值都是大端在前的格式)
    // 像素(x, y)起始位置是Pix[(y-Rect.Min.Y)*Stride + (x-Rect.Min.X)*8]
    Pix []uint8
    // Stride是Pix中每行像素占用的字节数
    Stride int
    // Rect是图像的范围
    Rect Rectangle
}

RGBA64类型代表一幅内存中的图像,其At方法返回color.RGBA64类型的值

func NewRGBA64

func NewRGBA64(r Rectangle) *RGBA64

NewRGBA64函数创建并返回一个具有指定范围的RGBA64

func (*RGBA64) At

func (p *RGBA64) At(x, y int) color.Color

func (*RGBA64) Bounds

func (p *RGBA64) Bounds() Rectangle

func (*RGBA64) ColorModel

func (p *RGBA64) ColorModel() color.Model

func (*RGBA64) Opaque

func (p *RGBA64) Opaque() bool

Opaque方法扫描整个图像并报告图像是否是完全不透明的。

func (*RGBA64) PixOffset

func (p *RGBA64) PixOffset(x, y int) int

PixOffset方法返回像素(x, y)的数据起始位置在Pix字段的偏移量/索引。

func (*RGBA64) Set

func (p *RGBA64) Set(x, y int, c color.Color)

func (*RGBA64) SetRGBA64

func (p *RGBA64) SetRGBA64(x, y int, c color.RGBA64)

func (*RGBA64) SubImage

func (p *RGBA64) SubImage(r Rectangle) Image

SubImage方法返回代表原图像一部分(r的范围)的新图像。返回值和原图像的像素数据是共用的。

type NRGBA

type NRGBA struct {
    // Pix保管图像的像素色彩信息,顺序为R, G, B, A
    // 像素(x, y)起始位置是Pix[(y-Rect.Min.Y)*Stride + (x-Rect.Min.X)*4]
    Pix []uint8
    // Stride是Pix中每行像素占用的字节数
    Stride int
    // Rect是图像的范围
    Rect Rectangle
}

NRGBA类型代表一幅内存中的图像,其At方法返回color.NRGBA类型的值。

func NewNRGBA

func NewNRGBA(r Rectangle) *NRGBA

NewNRGBA函数创建并返回一个具有指定范围的NRGBA。

func (*NRGBA) At

func (p *NRGBA) At(x, y int) color.Color

func (*NRGBA) Bounds

func (p *NRGBA) Bounds() Rectangle

func (*NRGBA) ColorModel

func (p *NRGBA) ColorModel() color.Model

func (*NRGBA) Opaque

func (p *NRGBA) Opaque() bool

Opaque方法扫描整个图像并报告图像是否是完全不透明的。

func (*NRGBA) PixOffset

func (p *NRGBA) PixOffset(x, y int) int

PixOffset方法返回像素(x, y)的数据起始位置在Pix字段的偏移量/索引。

func (*NRGBA) Set

func (p *NRGBA) Set(x, y int, c color.Color)

func (*NRGBA) SetNRGBA

func (p *NRGBA) SetNRGBA(x, y int, c color.NRGBA)

func (*NRGBA) SubImage

func (p *NRGBA) SubImage(r Rectangle) Image

SubImage方法返回代表原图像一部分(r的范围)的新图像。返回值和原图像的像素数据是共用的。

type NRGBA64

type NRGBA64 struct {
    // Pix保管图像的像素色彩信息,顺序为R, G, B, A(每个值都是大端在前的格式)
    // 像素(x, y)起始位置是Pix[(y-Rect.Min.Y)*Stride + (x-Rect.Min.X)*8]
    Pix []uint8
    // Stride是Pix中每行像素占用的字节数
    Stride int
    // Rect是图像的范围
    Rect Rectangle
}

NRGBA64类型代表一幅内存中的图像,其At方法返回color.NRGBA64类型的值。

func NewNRGBA64

func NewNRGBA64(r Rectangle) *NRGBA64

NewNRGBA64函数创建并返回一个具有指定范围的NRGBA64。

func (*NRGBA64) At

func (p *NRGBA64) At(x, y int) color.Color

func (*NRGBA64) Bounds

func (p *NRGBA64) Bounds() Rectangle

func (*NRGBA64) ColorModel

func (p *NRGBA64) ColorModel() color.Model

func (*NRGBA64) Opaque

func (p *NRGBA64) Opaque() bool

Opaque方法扫描整个图像并报告图像是否是完全不透明的。

func (*NRGBA64) PixOffset

func (p *NRGBA64) PixOffset(x, y int) int

PixOffset方法返回像素(x, y)的数据起始位置在Pix字段的偏移量/索引。

func (*NRGBA64) Set

func (p *NRGBA64) Set(x, y int, c color.Color)

func (*NRGBA64) SetNRGBA64

func (p *NRGBA64) SetNRGBA64(x, y int, c color.NRGBA64)

func (*NRGBA64) SubImage

func (p *NRGBA64) SubImage(r Rectangle) Image

SubImage方法返回代表原图像一部分(r的范围)的新图像。返回值和原图像的像素数据是共用的。

type Paletted

type Paletted struct {
    // Pix保存图像的象素,内容为调色板的索引。
    // 像素(x, y)的位置是Pix[(y-Rect.Min.Y)*Stride + (x-Rect.Min.X)*1]
    Pix []uint8
    // Stride是Pix中每行像素占用的字节数
    Stride int
    // Rect是图像的范围
    Rect Rectangle
    // Palette是图像的调色板
    Palette color.Palette
}

Paletted类型是一幅采用uint8类型索引调色板的内存中的图像。

func NewPaletted

func NewPaletted(r Rectangle, p color.Palette) *Paletted

NewPaletted函数创建并返回一个具有指定范围、调色板的Paletted。

func (*Paletted) At

func (p *Paletted) At(x, y int) color.Color

func (*Paletted) Bounds

func (p *Paletted) Bounds() Rectangle

func (*Paletted) ColorIndexAt

func (p *Paletted) ColorIndexAt(x, y int) uint8

func (*Paletted) ColorModel

func (p *Paletted) ColorModel() color.Model

func (*Paletted) Opaque

func (p *Paletted) Opaque() bool

Opaque方法扫描整个图像并报告图像是否是完全不透明的。

func (*Paletted) PixOffset

func (p *Paletted) PixOffset(x, y int) int

PixOffset方法返回像素(x, y)的数据起始位置在Pix字段的偏移量/索引。

func (*Paletted) Set

func (p *Paletted) Set(x, y int, c color.Color)

func (*Paletted) SetColorIndex

func (p *Paletted) SetColorIndex(x, y int, index uint8)

func (*Paletted) SubImage

func (p *Paletted) SubImage(r Rectangle) Image

SubImage方法返回代表原图像一部分(r的范围)的新图像。返回值和原图像的像素数据是共用的。

type YCbCrSubsampleRatio

type YCbCrSubsampleRatio int

YcbCrSubsampleRatio是YCbCr图像的色度二次采样比率。

const (
    YCbCrSubsampleRatio444 YCbCrSubsampleRatio = iota
    YCbCrSubsampleRatio422
    YCbCrSubsampleRatio420
    YCbCrSubsampleRatio440
)

func (YCbCrSubsampleRatio) String

func (s YCbCrSubsampleRatio) String() string

type YCbCr

type YCbCr struct {
    Y, Cb, Cr      []uint8
    YStride        int
    CStride        int
    SubsampleRatio YCbCrSubsampleRatio
    Rect           Rectangle
}

YcbCr代表采用Y'CbCr色彩模型的一幅内存中的图像。每个像素都对应一个Y采样,但每个Cb/Cr采样对应多个像素。Ystride是两个垂直相邻的像素之间的Y组分的索引增量。CStride是两个映射到单独的色度采样的垂直相邻的像素之间的Cb/Cr组分的索引增量。虽然不作绝对要求,但Ystride字段和len(Y)一般应为8的倍数,并且:

For 4:4:4, CStride == YStride/1 && len(Cb) == len(Cr) == len(Y)/1.
For 4:2:2, CStride == YStride/2 && len(Cb) == len(Cr) == len(Y)/2.
For 4:2:0, CStride == YStride/2 && len(Cb) == len(Cr) == len(Y)/4.
For 4:4:0, CStride == YStride/1 && len(Cb) == len(Cr) == len(Y)/2.

func NewYCbCr

func NewYCbCr(r Rectangle, subsampleRatio YCbCrSubsampleRatio) *YCbCr

NewYCbCr函数创建并返回一个具有指定宽度、高度和二次采样率的YcbCr。

func (*YCbCr) At

func (p *YCbCr) At(x, y int) color.Color

func (*YCbCr) Bounds

func (p *YCbCr) Bounds() Rectangle

func (*YCbCr) ColorModel

func (p *YCbCr) ColorModel() color.Model

func (*YCbCr) Opaque

func (p *YCbCr) Opaque() bool

func (*YCbCr) COffset

func (p *YCbCr) COffset(x, y int) int

像素(X, Y)的Cb或Cr(色度)组分的数据起始位置在Cb/Cr字段的偏移量/索引。

func (*YCbCr) YOffset

func (p *YCbCr) YOffset(x, y int) int

像素(X, Y)的Y(亮度)组分的数据起始位置在Y字段的偏移量/索引。

func (*YCbCr) SubImage

func (p *YCbCr) SubImage(r Rectangle) Image

SubImage方法返回代表原图像一部分(r的范围)的新图像。返回值和原图像的像素数据是共用的。

  • color
  • color/palette
  • draw
  • gif
  • jpeg
  • png

color

color包实现了基本色彩库。

Variables

var (
    Black       = Gray16{0}       // 黑色
    White       = Gray16{0xffff}  // 白色
    Transparent = Alpha16{0}      // 完全透明
    Opaque      = Alpha16{0xffff} // 完全不透明
)

标准色彩。

type Color

type Color interface {
    // 方法返回预乘了alpha的红、绿、蓝色彩值和alpha通道值,范围都在[0, 0xFFFF]。
    // 返回值类型为uint32,这样当乘以接近0xFFFF的混合参数时,不会溢出。
    RGBA() (r, g, b, a uint32)
}

实现了Color接口的类型可以将自身转化为预乘了alpha的16位通道的RGBA,转换可能会丢失色彩信息。

type Model

type Model interface {
    Convert(c Color) Color
}

Model接口可以将任意Color接口转换为采用自身色彩模型的Color接口。转换可能会丢失色彩信息。

var (
    RGBAModel    Model = ModelFunc(rgbaModel)
    RGBA64Model  Model = ModelFunc(rgba64Model)
    NRGBAModel   Model = ModelFunc(nrgbaModel)
    NRGBA64Model Model = ModelFunc(nrgba64Model)
    AlphaModel   Model = ModelFunc(alphaModel)
    Alpha16Model Model = ModelFunc(alpha16Model)
    GrayModel    Model = ModelFunc(grayModel)
    Gray16Model  Model = ModelFunc(gray16Model)
)

Models接口返回标准的Color接口类型。

var YCbCrModel Model = ModelFunc(yCbCrModel)

包变量YcbCrModel是Y'cbCr色彩模型的Model接口。

func ModelFunc

func ModelFunc(f func(Color) Color) Model

函数ModelFunc返回一个调用函数f实现色彩转换的Model接口。

type Alpha

type Alpha struct {
    A uint8
}

Alpha类型代表一个8位的alpha通道(alpha通道表示透明度)。

func (Alpha) RGBA

func (c Alpha) RGBA() (r, g, b, a uint32)

type Alpha16

type Alpha16 struct {
    A uint16
}

Alpha16类型代表一个16位的alpha通道。

func (Alpha16) RGBA

func (c Alpha16) RGBA() (r, g, b, a uint32)

type Gray

type Gray struct {
    Y uint8
}

Gray类型代表一个8位的灰度色彩。

func (Gray) RGBA

func (c Gray) RGBA() (r, g, b, a uint32)

type Gray16

type Gray16 struct {
    Y uint16
}

Gray16类型代表一个16位的灰度色彩。

func (Gray16) RGBA

func (c Gray16) RGBA() (r, g, b, a uint32)

type RGBA

type RGBA struct {
    R, G, B, A uint8
}

RGBA类型代表传统的预乘了alpha通道的32位RGB色彩,Red、Green、Blue、Alpha各8位。

func (RGBA) RGBA

func (c RGBA) RGBA() (r, g, b, a uint32)

type RGBA64

type RGBA64 struct {
    R, G, B, A uint16
}

RGBA64类型代表预乘了alpha通道的64位RGB色彩,Red、Green、Blue、Alpha各16位。

func (RGBA64) RGBA

func (c RGBA64) RGBA() (r, g, b, a uint32)

type NRGBA

type NRGBA struct {
    R, G, B, A uint8
}

NRGBA类型代表没有预乘alpha通道的32位RGB色彩,Red、Green、Blue、Alpha各8位。

func (NRGBA) RGBA

func (c NRGBA) RGBA() (r, g, b, a uint32)

type NRGBA64

type NRGBA64 struct {
    R, G, B, A uint16
}

NRGBA64类型代表没有预乘alpha通道的64位RGB色彩,Red、Green、Blue、Alpha各16位。

func (NRGBA64) RGBA

func (c NRGBA64) RGBA() (r, g, b, a uint32)

type YCbCr

type YCbCr struct {
    Y, Cb, Cr uint8
}

YcbCr代表完全不透明的24位Y'CbCr色彩;每个色彩都有1个亮度成分和2个色度成分,分别用8位字节表示。

JPEG、VP8、MPEG家族和其他编码方式使用本色彩模型。这些编码通常将Y'CbCr 和YUV两个色彩模型等同使用(Y=Y'=黄、U=Cb=青、V=Cr=品红)。但严格来说,YUV模只用于模拟视频信号,Y'是经过伽玛校正的Y。RGB和Y'CbCr色彩模型之间的转换会丢失色彩信息。两个色彩模型之间的转换有多个存在细微区别的算法。本包采用JFIF算法,参见http://www.w3.org/Graphics/JPEG/jfif3.pdf

func (YCbCr) RGBA

func (c YCbCr) RGBA() (uint32, uint32, uint32, uint32)

type Palette

type Palette []Color

Palette类型代表一个色彩的调色板。

func (Palette) Convert

func (p Palette) Convert(c Color) Color

返回调色板中与色彩c在欧几里德RGB色彩空间最接近的色彩。(实现了Model接口)

func (Palette) Index

func (p Palette) Index(c Color) int

返回调色板中与色彩c在欧几里德RGB色彩空间最接近的色彩的索引。

func RGBToYCbCr

func RGBToYCbCr(r, g, b uint8) (uint8, uint8, uint8)

函数将RGB三原色转换为Y'CbCr三原色。

func YCbCrToRGB

func YCbCrToRGB(y, cb, cr uint8) (uint8, uint8, uint8)

函数将Y'CbCr三原色转换为RGB三原色。

color/palette

palette包提供了标准的调色板。

Variables

var Plan9 = []color.Color{
    color.RGBA{0x00, 0x00, 0x00, 0xff},
    color.RGBA{0x00, 0x00, 0x44, 0xff},
    color.RGBA{0x00, 0x00, 0x88, 0xff},
    color.RGBA{0x00, 0x00, 0xcc, 0xff},
    // ……
    color.RGBA{0xff, 0xff, 0xff, 0xff},
}

Plan9是一个256色的调色板,将24位的RGB色彩立方划分为4x4x4的子立方,每个子立方体都有4个色调。比起WebSafe,本方案通过将颜色立方划分成更少的方格减少了颜色的分辨率,以便用额外的空间换取增加强度的分辨率。结果是灰色有16个色调(4个灰色子立方每个有4个采样),初级和次级颜色各有13个色调(3个子立方每个有4个采样,再加上黑色),加上对色彩立方其余部分的合理色彩选择,实现了更好的连续色调的表现。

本调色板用于Plan9操作系统,参见http://plan9.bell-labs.com/magic/man2html/6/color

var WebSafe = []color.Color{
    color.RGBA{0x00, 0x00, 0x00, 0xff},
    color.RGBA{0x00, 0x00, 0x33, 0xff},
    color.RGBA{0x00, 0x00, 0x66, 0xff},
    color.RGBA{0x00, 0x00, 0x99, 0xff},
    //……
    color.RGBA{0xff, 0xff, 0xff, 0xff},
}

WebSafe是一个216色的调色板,被早期版本的Netscape Navigator(一种浏览器)广泛使用,它也被称为Netcape色彩立方。细节参见http://en.wikipedia.org/wiki/Web_colors#Web-safe_colors

draw

draw包提供了图像合成函数。参见:http://golang.org/doc/articles/image_draw.html

type Quantizer

type Quantizer interface {
    // Quantize方法向p中最多增加cap(p)-len(p)个色彩并返回修正后的调色板
    // 返回值更适合(可以更少失真的)将m转换为一个调色板类型的图像
    Quantize(p color.Palette, m image.Image) color.Palette
}

Quantizer接口为一个图像生成调色板。

type Image

type Image interface {
    image.Image
    Set(x, y int, c color.Color)
}

Image接口比image.Image接口多了Set方法,该方法用于修改单个像素的色彩。

type Drawer

type Drawer interface {
    // 对齐图像dst的r.Min和src的sp点,然后将src绘制到dst上的结果来替换矩形范围内的图像
    Draw(dst Image, r image.Rectangle, src image.Image, sp image.Point)
}

Drawer包含Draw方法。

var FloydSteinberg Drawer = floydSteinberg{}

FloydSteinberg是采用Src操作并实现了Floyd-Steinberg误差扩散算法的Drawer。

type Op

type Op int

Op是Porter-Duff合成的操作符。

const (
    // 源图像透过遮罩后,覆盖在目标图像上(类似图层)
    Over Op  = iota
    // 源图像透过遮罩后,替换掉目标图像
    Src
)

func (Op) Draw

func (op Op) Draw(dst Image, r image.Rectangle, src image.Image, sp image.Point)

Draw方法通过使用Op参数调用包的Draw函数实现了Drawer接口。

func Draw

func Draw(dst Image, r image.Rectangle, src image.Image, sp image.Point, op Op)

Draw函数使用nil的mask参数调用DrawMask函数。

func DrawMask

func DrawMask(dst Image, r image.Rectangle, src image.Image, sp image.Point, mask image.Image, mp image.Point, op Op)

对齐目标图像dst的矩形r左上角、源图像src的sp点、遮罩mask的mp点,根据op修改dst的r矩形区域内的内容,mask如果为nil则视为完全透明。

gif

gif包实现了gif文件的编码器和解码器。gif格式参见:http://www.w3.org/Graphics/GIF/spec-gif89a.txt

type Options

type Options struct {
    // NumColors是图像中的最多颜色数,范围[1, 256]
    NumColors int
    // Quantizer用于生成NumColors大小的调色板,为nil时默认使用palette.Plan9
    Quantizer draw.Quantizer
    // Drawer用于将图像写入期望的调色板格式的图像,为nil时会使用draw.FloydSteinberg
    Drawer draw.Drawer
}

Options是编码参数。

func Decode

func Decode(r io.Reader) (image.Image, error)

从文件流解码并返回GIF文件中的第一幅图像。

func DecodeConfig

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

返回GIF图像的色彩模型和尺寸;函数不会解码整个图像文件。

func Encode

func Encode(w io.Writer, m image.Image, o *Options) error

函数将图像以GIF格式写入w中。

type GIF

type GIF struct {
    Image     []*image.Paletted // 连续的图像
    Delay     []int             // 每一帧延迟时间,单位是0.01s
    LoopCount int               // 总的循环时间
}

GIF类型代表可能保存在GIF文件里的多幅图像。

func DecodeAll

func DecodeAll(r io.Reader) (*GIF, error)

函数从r中读取一个GIF格式文件;返回值中包含了连续的图帧和时间信息。

func EncodeAll

func EncodeAll(w io.Writer, g *GIF) error

函数将g中所有的图像按指定的每帧延迟和累计循环时间写入w中。

jpeg

jpeg包实现了jpeg格式图像的编解码。JPEG格式参见http://www.w3.org/Graphics/JPEG/itu-t81.pdf

Constants

const DefaultQuality = 75

DefaultQuality是默认的编码质量参数。

type Reader

type Reader interface {
    io.Reader
    ReadByte() (c byte, err error)
}

如果提供的io.Reader接口没有ReadByte方法,Decode函数会为该接口附加一个缓冲。

type FormatError

type FormatError string

当输入流不是合法的jpeg格式图像时,就会返回FormatError类型的错误。

func (FormatError) Error

func (e FormatError) Error() string

type UnsupportedError

type UnsupportedError string

当输入流使用了合法但尚不支持的jpeg特性的时候,就会返回UnsupportedError类型的错误。

func (UnsupportedError) Error

func (e UnsupportedError) Error() string

type Options

type Options struct {
    Quality int
}

Options是编码质量参数。取值范围[1,100],越大图像编码质量越高。

func Decode

func Decode(r io.Reader) (image.Image, error)

从r读取一幅jpeg格式的图像并解码返回该图像。

func DecodeConfig

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

返回JPEG图像的色彩模型和尺寸;函数不会解码整个图像。

func Encode

func Encode(w io.Writer, m image.Image, o *Options) error

Encode函数将采用JPEG 4:2:0基线格式和指定的编码质量将图像写入w。如果o为nil将使用DefaultQuality。

png

png包实现了PNG图像的编解码。PNG格式参见:http://www.w3.org/TR/PNG/

type FormatError

type FormatError string

当输入流不是合法的png格式图像时,就会返回FormatError类型的错误。

func (FormatError) Error

func (e FormatError) Error() string

type UnsupportedError

type UnsupportedError string

当输入流使用了合法但尚不支持的png特性的时候,就会返回UnsupportedError类型的错误。

func (UnsupportedError) Error

func (e UnsupportedError) Error() string

func Decode

func Decode(r io.Reader) (image.Image, error)

从r读取一幅png格式的图像并解码返回该图像。图像的具体类型要看png文件的内容而定。

func DecodeConfig

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

返回PNG图像的色彩模型和尺寸;函数不会解码整个图像。

func Encode

func Encode(w io.Writer, m image.Image) error

将图像m以PNG格式写入w。任意图像类型都可以被编码,但image.NRGBA以外格式的图像可能会在编码时丢失一些图像信息。


有疑问加站长微信联系(非本文作者)

本文来自:简书

感谢作者:DevilRoshan

查看原文:Golang标准库——image

入群交流(和以上内容无关):加入Go大咖交流群,或添加微信:liuxiaoyan-s 备注:入群;或加QQ群:692541889

2453 次点击  
加入收藏 微博
暂无回复
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传