img

package
v1.2.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 23, 2026 License: MIT Imports: 17 Imported by: 1

Documentation

Index

Constants

View Source
const (
	JPG  = "jpg"
	JPEG = "jpeg"
	PNG  = "png"
	GIF  = "gif"
	BMP  = "bmp"
	TIF  = "tif"
	WEBP = "webp"
)

Variables

This section is empty.

Functions

func Bounds added in v1.2.0

func Bounds(m image.Image) (int, int)

Bounds 获取图片范围

func Clip

func Clip(target image.Image, x0, y0, width, height int) image.Image

Clip 剪切

func ClipImage

func ClipImage(target image.Image, x0, y0, width, height int) image.Image

ClipImage 剪切

func ClipPNG

func ClipPNG(target image.Image, x0, y0, width, height int) image.Image

ClipPNG 裁剪 这里用image.NRGBA

func ClipQuad added in v1.2.0

func ClipQuad(target image.Image) (image.Image, image.Image, image.Image, image.Image)

ClipQuad 四分切分 这里暂时用 RGBA

func ConvertJPEGToTransparentPNG added in v1.2.0

func ConvertJPEGToTransparentPNG(inputPath, outputPath string, bgColor color.RGBA, tolerance uint8) error

ConvertJPEGToTransparentPNG 将指定背景色的JPEG转换为透明PNG 参考 img.SetColorTransparent 参数:

inputPath: 输入JPEG文件路径
outputPath: 输出PNG文件路径
bgColor: 目标背景色(RGBA格式)
tolerance: 颜色容差值(0-255)

返回值:

error: 操作过程中发生的错误

func Copy added in v1.2.0

func Copy(src image.Image) draw.Image

Copy

func EachColor added in v1.2.0

func EachColor(m image.Image, callback func(color.Color, int, int))

EachColor

func Edge added in v1.2.0

func Edge(img image.Image) *image.RGBA

func MaskImage

func MaskImage(src, mask image.Image, copyPoint image.Point) (draw.Image, error)

MaskImage 获取蒙版遮罩镂空的背景图(裁剪后的区域)

func MergeTileImage added in v1.2.0

func MergeTileImage(source image.Image, source2 image.Image) image.Image

MergeTileImage 用于合并有黑色背景的mbtiles的图片

func PieceImage

func PieceImage(src, mask image.Image, copyPoint image.Point) (draw.Image, error)

PieceImage 获取蒙版遮罩本身的空白区域(裁剪下来的区域)

func Resize

func Resize(target image.Image, width, height int) image.Image

Resize 当宽度或者高度为0时,保持比例

func Rotate added in v1.2.0

func Rotate(target image.Image, angle float64) image.Image

Rotate

func Rotate90 added in v1.2.0

func Rotate90(target image.Image) image.Image

Rotate

func Rotate270 added in v1.2.0

func Rotate270(target image.Image) image.Image

Rotate

func SaveAsGIF

func SaveAsGIF(target image.Image, path string) error

SaveAsGIF

func SaveAsJPEG

func SaveAsJPEG(target image.Image, path string) error

SaveAsJPEG

func SaveAsPNG

func SaveAsPNG(target image.Image, path string) error

SaveAsPNG

func SaveBase64

func SaveBase64(source string, path string) (err error)

SaveBase64 将base64字串保存为图片

func SetColorTransparent added in v1.2.0

func SetColorTransparent(source image.Image, c color.RGBA) image.Image

SetColorTransparent c 一般为黑色背景的RGB值

func SetColorTransparentWithBlack added in v1.2.0

func SetColorTransparentWithBlack(source image.Image) image.Image

SetColorTransparentWithBlack

func Thumbnail

func Thumbnail(target image.Image, maxWidth, maxHeight int) image.Image

Thumbnail

func ToBase64

func ToBase64(target image.Image, imageType string) (data string, err error)

ToJPEGBase64 将image转成各种图片编码的base64字符串

func ToBytes

func ToBytes(target image.Image, imageType string) (bs []byte, err error)

ToBytes 将图片对象转成bytes字节流

func ToDataURI

func ToDataURI(target image.Image, imageType string) (data string, err error)

ToDataURI 支持 data uri

func ToJpegBytes added in v1.2.0

func ToJpegBytes(target image.Image, options *jpeg.Options) (bs []byte, err error)

Types

type Img

type Img struct {
	Image image.Image
}

func FromBytes

func FromBytes(bs []byte) (*Img, string, error)

FromBytes 从bytes数据中实例化Picture对象

func FromFile

func FromFile(path string) (*Img, string, error)

FromFile 从文件中读取数据实例化Picture对象

func FromImage

func FromImage(ig image.Image) *Img

FromImage

func FromReader

func FromReader(r io.Reader) (*Img, string, error)

FromReader

func (*Img) Clip

func (m *Img) Clip(x0, y0, width, height int) *Img

Clip 剪切

func (*Img) ClipPNG

func (m *Img) ClipPNG(x0, y0, width, height int) *Img

Clip 剪切

func (*Img) EachColor added in v1.2.0

func (m *Img) EachColor(callback func(color.Color, int, int))

func (*Img) MustToBase64

func (p *Img) MustToBase64() (data string)

func (*Img) MustToBytes added in v1.2.0

func (m *Img) MustToBytes(format string) []byte

MustToBytes

func (*Img) MustToDataURI

func (p *Img) MustToDataURI() (data string)

func (*Img) Resize

func (p *Img) Resize(width, height int) *Img

Resize 重置大小

func (*Img) Rotate added in v1.2.0

func (p *Img) Rotate(angle float64) *Img

Rotate

func (*Img) Rotate90 added in v1.2.0

func (p *Img) Rotate90() *Img

Rotate

func (*Img) Rotate270 added in v1.2.0

func (p *Img) Rotate270() *Img

Rotate

func (*Img) Save

func (p *Img) Save(path string, format string) error

Save 保存为文件

func (*Img) Thumbnail

func (p *Img) Thumbnail(width, height int) *Img

Thumbnail 缩略图 不同于Resize,当图片比缩略图小,不会缩放

func (*Img) ToBase64

func (p *Img) ToBase64() (data string, err error)

func (*Img) ToBytes

func (m *Img) ToBytes() (bs []byte, err error)

ToBytes 将图片对象转成bytes字节流

func (*Img) ToDataURI

func (p *Img) ToDataURI() (data string, err error)

func (*Img) ToPngBytes added in v1.2.0

func (m *Img) ToPngBytes() (bs []byte, err error)

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
⌂ 换网址