image

Documentation

Index

• Constants
• Variables
• func DataURI(img Image) string
• func DetectMIME(data []byte) string
• func EncodeBase64(img Image) string
• func IsImageFile(path string) bool
• func Placeholder(filename string, img Image) string
• type Image
  • func Decode(data []byte) (Image, error)
  • func ReadClipboard() (Image, error)
  • func ReadFile(path string) (Image, error)
  • func ReadFromReader(r io.Reader) (Image, error)

Constants

const MaxSize = 20 * 1024 * 1024

MaxSize is the maximum allowed image size (20MB).

Variables

var (
	MIMEJPEG = "image/jpeg"
	MIMEPNG  = "image/png"
	MIMEGIF  = "image/gif"
	MIMEWEBP = "image/webp"
)

Supported MIME types.

var ErrClipboardImageUnavailable = errors.New("clipboard does not contain an image")

Functions

func DataURI

func DataURI(img Image) string

DataURI returns a data URI for the image.

func DetectMIME

func DetectMIME(data []byte) string

DetectMIME detects image MIME type from magic bytes.

func EncodeBase64

func EncodeBase64(img Image) string

EncodeBase64 returns the base64-encoded representation of image data.

func IsImageFile

func IsImageFile(path string) bool

IsImageFile checks if a file path looks like an image based on extension.

func Placeholder

func Placeholder(filename string, img Image) string

Placeholder returns a TUI-friendly placeholder string for an image.

Types

type Image

type Image struct {
	Data   []byte
	MIME   string // "image/png", "image/jpeg", etc.
	Width  int
	Height int
}

Image represents a decoded image ready for sending to providers.

func Decode

func Decode(data []byte) (Image, error)

Decode decodes raw image data, detecting MIME type and dimensions. Returns an error if data exceeds MaxSize or format is unsupported.

func ReadClipboard

func ReadClipboard() (Image, error)

func ReadFile

func ReadFile(path string) (Image, error)

ReadFile reads an image from a file path.

func ReadFromReader

func ReadFromReader(r io.Reader) (Image, error)

ReadFromReader reads an image from an io.Reader.