Images API

Loading and Saving Images

Loading Images

// Load from file (auto-detect format)
img := advancegg.LoadImage("input.jpg")

// Load specific formats
pngImg := advancegg.LoadPNG("image.png")
jpegImg := advancegg.LoadJPEG("photo.jpg")
gifImg := advancegg.LoadGIF("animation.gif")
webpImg := advancegg.LoadWebP("modern.webp")
tiffImg := advancegg.LoadTIFF("document.tiff")
bmpImg := advancegg.LoadBMP("legacy.bmp")

// Load from bytes
data, _ := ioutil.ReadFile("image.png")
img := advancegg.LoadImageFromBytes(data)

// Load from URL
img := advancegg.LoadImageFromURL("https://example.com/image.jpg")

// Load from base64
base64Data := "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
img := advancegg.LoadImageFromBase64(base64Data)

Saving Images

// Save canvas as different formats
dc.SavePNG("output.png")
dc.SaveJPEG("output.jpg", 95)  // 95% quality
dc.SaveGIF("output.gif")
dc.SaveWebP("output.webp", 90) // 90% quality
dc.SaveTIFF("output.tiff")
dc.SaveBMP("output.bmp")

// Save with custom options
pngOptions := advancegg.PNGOptions{
    CompressionLevel: 9,  // Maximum compression
    Interlaced: true,
}
dc.SavePNGWithOptions("output.png", pngOptions)

jpegOptions := advancegg.JPEGOptions{
    Quality: 85,
    Progressive: true,
    OptimizeHuffman: true,
}
dc.SaveJPEGWithOptions("output.jpg", jpegOptions)

// Save to bytes
pngBytes := dc.ToPNG()
jpegBytes := dc.ToJPEG(90)

// Save to base64
base64String := dc.ToBase64PNG()
base64JPEG := dc.ToBase64JPEG(85)

Drawing Images

Basic Image Drawing

// Draw image at position
dc.DrawImage(img, 100, 100)

// Draw with anchor positioning
dc.DrawImageAnchored(img, 400, 300, 0.5, 0.5) // Center

// Draw scaled image
dc.DrawImageScaled(img, 100, 100, 200, 150) // Fit to 200x150

// Draw with rotation
dc.Push()
dc.Translate(200, 200)
dc.Rotate(math.Pi / 4) // 45 degrees
dc.DrawImage(img, -img.Bounds().Dx()/2, -img.Bounds().Dy()/2)
dc.Pop()

Advanced Image Drawing

// Draw with transformation matrix
matrix := advancegg.Identity()
matrix = matrix.Scale(2, 2)
matrix = matrix.Rotate(math.Pi / 6)
matrix = matrix.Translate(100, 100)

dc.SetMatrix(matrix)
dc.DrawImage(img, 0, 0)
dc.Identity() // Reset transformation

// Draw with opacity
dc.SetGlobalAlpha(0.5)
dc.DrawImage(img, 100, 100)
dc.SetGlobalAlpha(1.0) // Reset

// Draw with blend mode
dc.SetCompositeOperation(advancegg.CompositeOperationMultiply)
dc.DrawImage(img, 100, 100)
dc.SetCompositeOperation(advancegg.CompositeOperationSourceOver) // Reset

// Draw image region (cropping)
srcRect := image.Rect(50, 50, 200, 200)  // Source rectangle
dstRect := image.Rect(100, 100, 300, 300) // Destination rectangle
dc.DrawImageRegion(img, srcRect, dstRect)

Image Transformations

Scaling and Resizing

// Resize image
resized := advancegg.ResizeImage(img, 800, 600)

// Scale by factor
scaled := advancegg.ScaleImage(img, 2.0) // 2x larger

// Resize with different algorithms
resized = advancegg.ResizeImageWithAlgorithm(img, 800, 600, advancegg.ResizeNearestNeighbor)
resized = advancegg.ResizeImageWithAlgorithm(img, 800, 600, advancegg.ResizeBilinear)
resized = advancegg.ResizeImageWithAlgorithm(img, 800, 600, advancegg.ResizeBicubic)
resized = advancegg.ResizeImageWithAlgorithm(img, 800, 600, advancegg.ResizeLanczos)

// Resize maintaining aspect ratio
resized = advancegg.ResizeImageFit(img, 800, 600) // Fit within bounds
resized = advancegg.ResizeImageFill(img, 800, 600) // Fill bounds (may crop)

// Smart resize (content-aware)
resized = advancegg.SmartResize(img, 800, 600)

Rotation and Flipping

// Rotate image
rotated := advancegg.RotateImage(img, math.Pi/4) // 45 degrees
rotated90 := advancegg.RotateImage90(img)
rotated180 := advancegg.RotateImage180(img)
rotated270 := advancegg.RotateImage270(img)

// Flip image
flippedH := advancegg.FlipImageHorizontal(img)
flippedV := advancegg.FlipImageVertical(img)

// Rotate with custom center
rotated := advancegg.RotateImageAroundPoint(img, math.Pi/6, 200, 150)

// Rotate with background color
rotated := advancegg.RotateImageWithBackground(img, math.Pi/4, color.RGBA{255, 255, 255, 255})

Cropping and Padding

// Crop image
cropped := advancegg.CropImage(img, image.Rect(100, 100, 400, 300))

// Crop to aspect ratio
cropped := advancegg.CropToAspectRatio(img, 16.0/9.0) // 16:9 aspect ratio

// Auto crop (remove borders)
cropped := advancegg.AutoCrop(img, color.RGBA{255, 255, 255, 255}) // Remove white borders

// Add padding
padded := advancegg.PadImage(img, 50, 50, 50, 50, color.RGBA{0, 0, 0, 255}) // Black padding

// Pad to square
squared := advancegg.PadToSquare(img, color.RGBA{255, 255, 255, 255}) // White padding

Image Analysis

Image Properties

// Get image dimensions
width, height := advancegg.GetImageDimensions(img)
fmt.Printf("Image size: %dx%d\n", width, height)

// Get image format
format := advancegg.GetImageFormat("image.jpg") // Returns "JPEG"

// Get color depth
depth := advancegg.GetColorDepth(img)
fmt.Printf("Color depth: %d bits\n", depth)

// Check if image has transparency
hasAlpha := advancegg.HasTransparency(img)
fmt.Printf("Has transparency: %v\n", hasAlpha)

// Get file size
fileSize := advancegg.GetImageFileSize("image.jpg")
fmt.Printf("File size: %d bytes\n", fileSize)

Color Analysis

// Get dominant colors
dominantColors := advancegg.GetDominantColors(img, 5) // Top 5 colors
for i, color := range dominantColors {
    fmt.Printf("Color %d: %v\n", i+1, color)
}

// Get average color
avgColor := advancegg.GetAverageColor(img)
fmt.Printf("Average color: %v\n", avgColor)

// Get color histogram
histogram := advancegg.GetColorHistogram(img)
fmt.Printf("Red histogram: %v\n", histogram.Red)

// Analyze brightness
brightness := advancegg.GetAverageBrightness(img)
fmt.Printf("Average brightness: %f\n", brightness)

// Detect if image is grayscale
isGrayscale := advancegg.IsGrayscale(img)
fmt.Printf("Is grayscale: %v\n", isGrayscale)

Content Analysis

// Detect edges
edges := advancegg.DetectEdges(img)

// Find contours
contours := advancegg.FindContours(img)

// Detect corners
corners := advancegg.DetectCorners(img)

// Calculate image complexity
complexity := advancegg.CalculateComplexity(img)
fmt.Printf("Image complexity: %f\n", complexity)

// Get image entropy
entropy := advancegg.CalculateEntropy(img)
fmt.Printf("Image entropy: %f\n", entropy)

Image Comparison

Similarity Metrics

// Calculate similarity between images
similarity := advancegg.CalculateSimilarity(img1, img2)
fmt.Printf("Similarity: %f\n", similarity) // 0.0 to 1.0

// Mean Squared Error
mse := advancegg.CalculateMSE(img1, img2)
fmt.Printf("MSE: %f\n", mse)

// Peak Signal-to-Noise Ratio
psnr := advancegg.CalculatePSNR(img1, img2)
fmt.Printf("PSNR: %f dB\n", psnr)

// Structural Similarity Index
ssim := advancegg.CalculateSSIM(img1, img2)
fmt.Printf("SSIM: %f\n", ssim)

// Perceptual hash
hash1 := advancegg.PerceptualHash(img1)
hash2 := advancegg.PerceptualHash(img2)
distance := advancegg.HammingDistance(hash1, hash2)
fmt.Printf("Perceptual distance: %d\n", distance)

Difference Detection

// Create difference image
diff := advancegg.CreateDifferenceImage(img1, img2)

// Highlight differences
highlighted := advancegg.HighlightDifferences(img1, img2, color.RGBA{255, 0, 0, 255})

// Get difference statistics
stats := advancegg.GetDifferenceStats(img1, img2)
fmt.Printf("Different pixels: %d (%.2f%%)\n", stats.DifferentPixels, stats.DifferencePercentage)

Image Metadata

EXIF Data

// Read EXIF data
exif := advancegg.ReadEXIF("photo.jpg")
if exif != nil {
    fmt.Printf("Camera: %s %s\n", exif.Make, exif.Model)
    fmt.Printf("Date taken: %s\n", exif.DateTime)
    fmt.Printf("ISO: %d\n", exif.ISO)
    fmt.Printf("Aperture: f/%.1f\n", exif.Aperture)
    fmt.Printf("Shutter speed: %s\n", exif.ShutterSpeed)
    fmt.Printf("GPS: %f, %f\n", exif.GPS.Latitude, exif.GPS.Longitude)
}

// Write EXIF data
newExif := &advancegg.EXIFData{
    Make:    "AdvanceGG",
    Model:   "Virtual Camera",
    DateTime: time.Now().Format("2006:01:02 15:04:05"),
}
advancegg.WriteEXIF("output.jpg", newExif)

// Remove EXIF data
advancegg.RemoveEXIF("photo.jpg", "clean_photo.jpg")

Color Profiles

// Read ICC color profile
profile := advancegg.ReadColorProfile("image.jpg")
if profile != nil {
    fmt.Printf("Color space: %s\n", profile.ColorSpace)
    fmt.Printf("Description: %s\n", profile.Description)
}

// Embed color profile
srgbProfile := advancegg.GetSRGBProfile()
advancegg.EmbedColorProfile("image.jpg", "output.jpg", srgbProfile)

// Convert color space
converted := advancegg.ConvertColorSpace(img, advancegg.ColorSpaceSRGB, advancegg.ColorSpaceAdobeRGB)

Complete Examples

Image Processing Pipeline

package main

import (
    "fmt"
    "image/color"
    "github.com/GrandpaEJ/advancegg"
)

func main() {
    // Load image
    img := advancegg.LoadImage("input.jpg")
    if img == nil {
        fmt.Println("Failed to load image")
        return
    }
    
    fmt.Printf("Original size: %dx%d\n", img.Bounds().Dx(), img.Bounds().Dy())
    
    // Resize image
    resized := advancegg.ResizeImageFit(img, 1920, 1080)
    fmt.Printf("Resized to: %dx%d\n", resized.Bounds().Dx(), resized.Bounds().Dy())
    
    // Apply filters
    enhanced := advancegg.ApplyBrightness(resized, 1.1)
    enhanced = advancegg.ApplyContrast(enhanced, 1.2)
    enhanced = advancegg.ApplySaturation(enhanced, 1.15)
    
    // Add watermark
    watermarked := addWatermark(enhanced, "© AdvanceGG 2024")
    
    // Save with different qualities
    advancegg.SaveJPEG(watermarked, "output_high.jpg", 95)
    advancegg.SaveJPEG(watermarked, "output_medium.jpg", 85)
    advancegg.SaveJPEG(watermarked, "output_low.jpg", 70)
    
    // Create thumbnail
    thumbnail := advancegg.ResizeImageFit(watermarked, 300, 200)
    advancegg.SaveJPEG(thumbnail, "thumbnail.jpg", 90)
    
    fmt.Println("Image processing completed!")
}

func addWatermark(img image.Image, text string) image.Image {
    dc := advancegg.NewContextForImage(img)
    
    // Semi-transparent watermark
    dc.SetRGBA(1, 1, 1, 0.7)
    dc.LoadFontFace("fonts/arial.ttf", 24)
    
    // Position in bottom right
    width := float64(img.Bounds().Dx())
    height := float64(img.Bounds().Dy())
    dc.DrawStringAnchored(text, width-20, height-20, 1, 1)
    
    return dc.Image()
}

API Reference

Loading and Saving Images

Loading Images

Saving Images

Drawing Images

Basic Image Drawing

Advanced Image Drawing

Image Transformations

Scaling and Resizing

Rotation and Flipping

Cropping and Padding

Image Analysis

Image Properties

Color Analysis

Content Analysis

Image Comparison

Similarity Metrics

Difference Detection

Image Metadata

EXIF Data

Color Profiles

Complete Examples

Image Processing Pipeline