patch of appview/repo/ogcard: package to help draw image cards · round #0 · pull #647 · tangled.org/core

+500

appview/repo/ogcard/card.go

···

       1
       +
       // Copyright 2024 The Forgejo Authors. All rights reserved.

     

       2
       +
       // Copyright 2025 The Tangled Authors -- repurposed for Tangled use.

     

       3
       +
       // SPDX-License-Identifier: MIT

     

       4
       +
       

     

       5
       +
       package ogcard

     

       6
       +
       

     

       7
       +
       import (

     

       8
       +
       	"bytes"

     

       9
       +
       	"fmt"

     

       10
       +
       	"image"

     

       11
       +
       	"image/color"

     

       12
       +
       	"io"

     

       13
       +
       	"log"

     

       14
       +
       	"math"

     

       15
       +
       	"net/http"

     

       16
       +
       	"strings"

     

       17
       +
       	"sync"

     

       18
       +
       	"time"

     

       19
       +
       

     

       20
       +
       	"github.com/goki/freetype"

     

       21
       +
       	"github.com/goki/freetype/truetype"

     

       22
       +
       	"github.com/srwiley/oksvg"

     

       23
       +
       	"github.com/srwiley/rasterx"

     

       24
       +
       	"golang.org/x/image/draw"

     

       25
       +
       	"golang.org/x/image/font"

     

       26
       +
       	"tangled.org/core/appview/pages"

     

       27
       +
       

     

       28
       +
       	_ "golang.org/x/image/webp" // for processing webp images

     

       29
       +
       )

     

       30
       +
       

     

       31
       +
       type Card struct {

     

       32
       +
       	Img    *image.RGBA

     

       33
       +
       	Font   *truetype.Font

     

       34
       +
       	Margin int

     

       35
       +
       	Width  int

     

       36
       +
       	Height int

     

       37
       +
       }

     

       38
       +
       

     

       39
       +
       var fontCache = sync.OnceValues(func() (*truetype.Font, error) {

     

       40
       +
       	interVar, err := pages.Files.ReadFile("static/fonts/InterVariable.ttf")

     

       41
       +
       	if err != nil {

     

       42
       +
       		return nil, err

     

       43
       +
       	}

     

       44
       +
       	return truetype.Parse(interVar)

     

       45
       +
       })

     

       46
       +
       

     

       47
       +
       // DefaultSize returns the default size for a card

     

       48
       +
       func DefaultSize() (int, int) {

     

       49
       +
       	return 1200, 600

     

       50
       +
       }

     

       51
       +
       

     

       52
       +
       // NewCard creates a new card with the given dimensions in pixels

     

       53
       +
       func NewCard(width, height int) (*Card, error) {

     

       54
       +
       	img := image.NewRGBA(image.Rect(0, 0, width, height))

     

       55
       +
       	draw.Draw(img, img.Bounds(), image.NewUniform(color.White), image.Point{}, draw.Src)

     

       56
       +
       

     

       57
       +
       	font, err := fontCache()

     

       58
       +
       	if err != nil {

     

       59
       +
       		return nil, err

     

       60
       +
       	}

     

       61
       +
       

     

       62
       +
       	return &Card{

     

       63
       +
       		Img:    img,

     

       64
       +
       		Font:   font,

     

       65
       +
       		Margin: 0,

     

       66
       +
       		Width:  width,

     

       67
       +
       		Height: height,

     

       68
       +
       	}, nil

     

       69
       +
       }

     

       70
       +
       

     

       71
       +
       // Split splits the card horizontally or vertically by a given percentage; the first card returned has the percentage

     

       72
       +
       // size, and the second card has the remainder.  Both cards draw to a subsection of the same image buffer.

     

       73
       +
       func (c *Card) Split(vertical bool, percentage int) (*Card, *Card) {

     

       74
       +
       	bounds := c.Img.Bounds()

     

       75
       +
       	bounds = image.Rect(bounds.Min.X+c.Margin, bounds.Min.Y+c.Margin, bounds.Max.X-c.Margin, bounds.Max.Y-c.Margin)

     

       76
       +
       	if vertical {

     

       77
       +
       		mid := (bounds.Dx() * percentage / 100) + bounds.Min.X

     

       78
       +
       		subleft := c.Img.SubImage(image.Rect(bounds.Min.X, bounds.Min.Y, mid, bounds.Max.Y)).(*image.RGBA)

     

       79
       +
       		subright := c.Img.SubImage(image.Rect(mid, bounds.Min.Y, bounds.Max.X, bounds.Max.Y)).(*image.RGBA)

     

       80
       +
       		return &Card{Img: subleft, Font: c.Font, Width: subleft.Bounds().Dx(), Height: subleft.Bounds().Dy()},

     

       81
       +
       			&Card{Img: subright, Font: c.Font, Width: subright.Bounds().Dx(), Height: subright.Bounds().Dy()}

     

       82
       +
       	}

     

       83
       +
       	mid := (bounds.Dy() * percentage / 100) + bounds.Min.Y

     

       84
       +
       	subtop := c.Img.SubImage(image.Rect(bounds.Min.X, bounds.Min.Y, bounds.Max.X, mid)).(*image.RGBA)

     

       85
       +
       	subbottom := c.Img.SubImage(image.Rect(bounds.Min.X, mid, bounds.Max.X, bounds.Max.Y)).(*image.RGBA)

     

       86
       +
       	return &Card{Img: subtop, Font: c.Font, Width: subtop.Bounds().Dx(), Height: subtop.Bounds().Dy()},

     

       87
       +
       		&Card{Img: subbottom, Font: c.Font, Width: subbottom.Bounds().Dx(), Height: subbottom.Bounds().Dy()}

     

       88
       +
       }

     

       89
       +
       

     

       90
       +
       // SetMargin sets the margins for the card

     

       91
       +
       func (c *Card) SetMargin(margin int) {

     

       92
       +
       	c.Margin = margin

     

       93
       +
       }

     

       94
       +
       

     

       95
       +
       type (

     

       96
       +
       	VAlign int64

     

       97
       +
       	HAlign int64

     

       98
       +
       )

     

       99
       +
       

     

       100
       +
       const (

     

       101
       +
       	Top VAlign = iota

     

       102
       +
       	Middle

     

       103
       +
       	Bottom

     

       104
       +
       )

     

       105
       +
       

     

       106
       +
       const (

     

       107
       +
       	Left HAlign = iota

     

       108
       +
       	Center

     

       109
       +
       	Right

     

       110
       +
       )

     

       111
       +
       

     

       112
       +
       // DrawText draws text within the card, respecting margins and alignment

     

       113
       +
       func (c *Card) DrawText(text string, textColor color.Color, sizePt float64, valign VAlign, halign HAlign) ([]string, error) {

     

       114
       +
       	ft := freetype.NewContext()

     

       115
       +
       	ft.SetDPI(72)

     

       116
       +
       	ft.SetFont(c.Font)

     

       117
       +
       	ft.SetFontSize(sizePt)

     

       118
       +
       	ft.SetClip(c.Img.Bounds())

     

       119
       +
       	ft.SetDst(c.Img)

     

       120
       +
       	ft.SetSrc(image.NewUniform(textColor))

     

       121
       +
       

     

       122
       +
       	face := truetype.NewFace(c.Font, &truetype.Options{Size: sizePt, DPI: 72})

     

       123
       +
       	fontHeight := ft.PointToFixed(sizePt).Ceil()

     

       124
       +
       

     

       125
       +
       	bounds := c.Img.Bounds()

     

       126
       +
       	bounds = image.Rect(bounds.Min.X+c.Margin, bounds.Min.Y+c.Margin, bounds.Max.X-c.Margin, bounds.Max.Y-c.Margin)

     

       127
       +
       	boxWidth, boxHeight := bounds.Size().X, bounds.Size().Y

     

       128
       +
       	// draw.Draw(c.Img, bounds, image.NewUniform(color.Gray{128}), image.Point{}, draw.Src) // Debug draw box

     

       129
       +
       

     

       130
       +
       	// Try to apply wrapping to this text; we'll find the most text that will fit into one line, record that line, move

     

       131
       +
       	// on.  We precalculate each line before drawing so that we can support valign="middle" correctly which requires

     

       132
       +
       	// knowing the total height, which is related to how many lines we'll have.

     

       133
       +
       	lines := make([]string, 0)

     

       134
       +
       	textWords := strings.Split(text, " ")

     

       135
       +
       	currentLine := ""

     

       136
       +
       	heightTotal := 0

     

       137
       +
       

     

       138
       +
       	for {

     

       139
       +
       		if len(textWords) == 0 {

     

       140
       +
       			// Ran out of words.

     

       141
       +
       			if currentLine != "" {

     

       142
       +
       				heightTotal += fontHeight

     

       143
       +
       				lines = append(lines, currentLine)

     

       144
       +
       			}

     

       145
       +
       			break

     

       146
       +
       		}

     

       147
       +
       

     

       148
       +
       		nextWord := textWords[0]

     

       149
       +
       		proposedLine := currentLine

     

       150
       +
       		if proposedLine != "" {

     

       151
       +
       			proposedLine += " "

     

       152
       +
       		}

     

       153
       +
       		proposedLine += nextWord

     

       154
       +
       

     

       155
       +
       		proposedLineWidth := font.MeasureString(face, proposedLine)

     

       156
       +
       		if proposedLineWidth.Ceil() > boxWidth {

     

       157
       +
       			// no, proposed line is too big; we'll use the last "currentLine"

     

       158
       +
       			heightTotal += fontHeight

     

       159
       +
       			if currentLine != "" {

     

       160
       +
       				lines = append(lines, currentLine)

     

       161
       +
       				currentLine = ""

     

       162
       +
       				// leave nextWord in textWords and keep going

     

       163
       +
       			} else {

     

       164
       +
       				// just nextWord by itself doesn't fit on a line; well, we can't skip it, but we'll consume it

     

       165
       +
       				// regardless as a line by itself.  It will be clipped by the drawing routine.

     

       166
       +
       				lines = append(lines, nextWord)

     

       167
       +
       				textWords = textWords[1:]

     

       168
       +
       			}

     

       169
       +
       		} else {

     

       170
       +
       			// yes, it will fit

     

       171
       +
       			currentLine = proposedLine

     

       172
       +
       			textWords = textWords[1:]

     

       173
       +
       		}

     

       174
       +
       	}

     

       175
       +
       

     

       176
       +
       	textY := 0

     

       177
       +
       	switch valign {

     

       178
       +
       	case Top:

     

       179
       +
       		textY = fontHeight

     

       180
       +
       	case Bottom:

     

       181
       +
       		textY = boxHeight - heightTotal + fontHeight

     

       182
       +
       	case Middle:

     

       183
       +
       		textY = ((boxHeight - heightTotal) / 2) + fontHeight

     

       184
       +
       	}

     

       185
       +
       

     

       186
       +
       	for _, line := range lines {

     

       187
       +
       		lineWidth := font.MeasureString(face, line)

     

       188
       +
       

     

       189
       +
       		textX := 0

     

       190
       +
       		switch halign {

     

       191
       +
       		case Left:

     

       192
       +
       			textX = 0

     

       193
       +
       		case Right:

     

       194
       +
       			textX = boxWidth - lineWidth.Ceil()

     

       195
       +
       		case Center:

     

       196
       +
       			textX = (boxWidth - lineWidth.Ceil()) / 2

     

       197
       +
       		}

     

       198
       +
       

     

       199
       +
       		pt := freetype.Pt(bounds.Min.X+textX, bounds.Min.Y+textY)

     

       200
       +
       		_, err := ft.DrawString(line, pt)

     

       201
       +
       		if err != nil {

     

       202
       +
       			return nil, err

     

       203
       +
       		}

     

       204
       +
       

     

       205
       +
       		textY += fontHeight

     

       206
       +
       	}

     

       207
       +
       

     

       208
       +
       	return lines, nil

     

       209
       +
       }

     

       210
       +
       

     

       211
       +
       // DrawTextAt draws text at a specific position with the given alignment

     

       212
       +
       func (c *Card) DrawTextAt(text string, x, y int, textColor color.Color, sizePt float64, valign VAlign, halign HAlign) error {

     

       213
       +
       	_, err := c.DrawTextAtWithWidth(text, x, y, textColor, sizePt, valign, halign)

     

       214
       +
       	return err

     

       215
       +
       }

     

       216
       +
       

     

       217
       +
       // DrawTextAtWithWidth draws text at a specific position and returns the text width

     

       218
       +
       func (c *Card) DrawTextAtWithWidth(text string, x, y int, textColor color.Color, sizePt float64, valign VAlign, halign HAlign) (int, error) {

     

       219
       +
       	ft := freetype.NewContext()

     

       220
       +
       	ft.SetDPI(72)

     

       221
       +
       	ft.SetFont(c.Font)

     

       222
       +
       	ft.SetFontSize(sizePt)

     

       223
       +
       	ft.SetClip(c.Img.Bounds())

     

       224
       +
       	ft.SetDst(c.Img)

     

       225
       +
       	ft.SetSrc(image.NewUniform(textColor))

     

       226
       +
       

     

       227
       +
       	face := truetype.NewFace(c.Font, &truetype.Options{Size: sizePt, DPI: 72})

     

       228
       +
       	fontHeight := ft.PointToFixed(sizePt).Ceil()

     

       229
       +
       	lineWidth := font.MeasureString(face, text)

     

       230
       +
       	textWidth := lineWidth.Ceil()

     

       231
       +
       

     

       232
       +
       	// Adjust position based on alignment

     

       233
       +
       	adjustedX := x

     

       234
       +
       	adjustedY := y

     

       235
       +
       

     

       236
       +
       	switch halign {

     

       237
       +
       	case Left:

     

       238
       +
       		// x is already at the left position

     

       239
       +
       	case Right:

     

       240
       +
       		adjustedX = x - textWidth

     

       241
       +
       	case Center:

     

       242
       +
       		adjustedX = x - textWidth/2

     

       243
       +
       	}

     

       244
       +
       

     

       245
       +
       	switch valign {

     

       246
       +
       	case Top:

     

       247
       +
       		adjustedY = y + fontHeight

     

       248
       +
       	case Bottom:

     

       249
       +
       		adjustedY = y

     

       250
       +
       	case Middle:

     

       251
       +
       		adjustedY = y + fontHeight/2

     

       252
       +
       	}

     

       253
       +
       

     

       254
       +
       	pt := freetype.Pt(adjustedX, adjustedY)

     

       255
       +
       	_, err := ft.DrawString(text, pt)

     

       256
       +
       	return textWidth, err

     

       257
       +
       }

     

       258
       +
       

     

       259
       +
       // DrawBoldText draws bold text by rendering multiple times with slight offsets

     

       260
       +
       func (c *Card) DrawBoldText(text string, x, y int, textColor color.Color, sizePt float64, valign VAlign, halign HAlign) (int, error) {

     

       261
       +
       	// Draw the text multiple times with slight offsets to create bold effect

     

       262
       +
       	offsets := []struct{ dx, dy int }{

     

       263
       +
       		{0, 0}, // original

     

       264
       +
       		{1, 0}, // right

     

       265
       +
       		{0, 1}, // down

     

       266
       +
       		{1, 1}, // diagonal

     

       267
       +
       	}

     

       268
       +
       

     

       269
       +
       	var width int

     

       270
       +
       	for _, offset := range offsets {

     

       271
       +
       		w, err := c.DrawTextAtWithWidth(text, x+offset.dx, y+offset.dy, textColor, sizePt, valign, halign)

     

       272
       +
       		if err != nil {

     

       273
       +
       			return 0, err

     

       274
       +
       		}

     

       275
       +
       		if width == 0 {

     

       276
       +
       			width = w

     

       277
       +
       		}

     

       278
       +
       	}

     

       279
       +
       	return width, nil

     

       280
       +
       }

     

       281
       +
       

     

       282
       +
       // DrawSVGIcon draws an SVG icon from the embedded files at the specified position

     

       283
       +
       func (c *Card) DrawSVGIcon(svgPath string, x, y, size int, iconColor color.Color) error {

     

       284
       +
       	svgData, err := pages.Files.ReadFile(svgPath)

     

       285
       +
       	if err != nil {

     

       286
       +
       		return fmt.Errorf("failed to read SVG file %s: %w", svgPath, err)

     

       287
       +
       	}

     

       288
       +
       

     

       289
       +
       	// Convert color to hex string for SVG

     

       290
       +
       	rgba, isRGBA := iconColor.(color.RGBA)

     

       291
       +
       	if !isRGBA {

     

       292
       +
       		r, g, b, a := iconColor.RGBA()

     

       293
       +
       		rgba = color.RGBA{uint8(r >> 8), uint8(g >> 8), uint8(b >> 8), uint8(a >> 8)}

     

       294
       +
       	}

     

       295
       +
       	colorHex := fmt.Sprintf("#%02x%02x%02x", rgba.R, rgba.G, rgba.B)

     

       296
       +
       

     

       297
       +
       	// Replace currentColor with our desired color in the SVG

     

       298
       +
       	svgString := string(svgData)

     

       299
       +
       	svgString = strings.ReplaceAll(svgString, "currentColor", colorHex)

     

       300
       +
       

     

       301
       +
       	// Make the stroke thicker

     

       302
       +
       	svgString = strings.ReplaceAll(svgString, `stroke-width="2"`, `stroke-width="3"`)

     

       303
       +
       

     

       304
       +
       	// Parse SVG

     

       305
       +
       	icon, err := oksvg.ReadIconStream(strings.NewReader(svgString))

     

       306
       +
       	if err != nil {

     

       307
       +
       		return fmt.Errorf("failed to parse SVG %s: %w", svgPath, err)

     

       308
       +
       	}

     

       309
       +
       

     

       310
       +
       	// Set the icon size

     

       311
       +
       	w, h := float64(size), float64(size)

     

       312
       +
       	icon.SetTarget(0, 0, w, h)

     

       313
       +
       

     

       314
       +
       	// Create a temporary RGBA image for the icon

     

       315
       +
       	iconImg := image.NewRGBA(image.Rect(0, 0, size, size))

     

       316
       +
       

     

       317
       +
       	// Create scanner and rasterizer

     

       318
       +
       	scanner := rasterx.NewScannerGV(size, size, iconImg, iconImg.Bounds())

     

       319
       +
       	raster := rasterx.NewDasher(size, size, scanner)

     

       320
       +
       

     

       321
       +
       	// Draw the icon

     

       322
       +
       	icon.Draw(raster, 1.0)

     

       323
       +
       

     

       324
       +
       	// Draw the icon onto the card at the specified position

     

       325
       +
       	bounds := c.Img.Bounds()

     

       326
       +
       	destRect := image.Rect(x, y, x+size, y+size)

     

       327
       +
       

     

       328
       +
       	// Make sure we don't draw outside the card bounds

     

       329
       +
       	if destRect.Max.X > bounds.Max.X {

     

       330
       +
       		destRect.Max.X = bounds.Max.X

     

       331
       +
       	}

     

       332
       +
       	if destRect.Max.Y > bounds.Max.Y {

     

       333
       +
       		destRect.Max.Y = bounds.Max.Y

     

       334
       +
       	}

     

       335
       +
       

     

       336
       +
       	draw.Draw(c.Img, destRect, iconImg, image.Point{}, draw.Over)

     

       337
       +
       

     

       338
       +
       	return nil

     

       339
       +
       }

     

       340
       +
       

     

       341
       +
       // DrawImage fills the card with an image, scaled to maintain the original aspect ratio and centered with respect to the non-filled dimension

     

       342
       +
       func (c *Card) DrawImage(img image.Image) {

     

       343
       +
       	bounds := c.Img.Bounds()

     

       344
       +
       	targetRect := image.Rect(bounds.Min.X+c.Margin, bounds.Min.Y+c.Margin, bounds.Max.X-c.Margin, bounds.Max.Y-c.Margin)

     

       345
       +
       	srcBounds := img.Bounds()

     

       346
       +
       	srcAspect := float64(srcBounds.Dx()) / float64(srcBounds.Dy())

     

       347
       +
       	targetAspect := float64(targetRect.Dx()) / float64(targetRect.Dy())

     

       348
       +
       

     

       349
       +
       	var scale float64

     

       350
       +
       	if srcAspect > targetAspect {

     

       351
       +
       		// Image is wider than target, scale by width

     

       352
       +
       		scale = float64(targetRect.Dx()) / float64(srcBounds.Dx())

     

       353
       +
       	} else {

     

       354
       +
       		// Image is taller or equal, scale by height

     

       355
       +
       		scale = float64(targetRect.Dy()) / float64(srcBounds.Dy())

     

       356
       +
       	}

     

       357
       +
       

     

       358
       +
       	newWidth := int(math.Round(float64(srcBounds.Dx()) * scale))

     

       359
       +
       	newHeight := int(math.Round(float64(srcBounds.Dy()) * scale))

     

       360
       +
       

     

       361
       +
       	// Center the image within the target rectangle

     

       362
       +
       	offsetX := (targetRect.Dx() - newWidth) / 2

     

       363
       +
       	offsetY := (targetRect.Dy() - newHeight) / 2

     

       364
       +
       

     

       365
       +
       	scaledRect := image.Rect(targetRect.Min.X+offsetX, targetRect.Min.Y+offsetY, targetRect.Min.X+offsetX+newWidth, targetRect.Min.Y+offsetY+newHeight)

     

       366
       +
       	draw.CatmullRom.Scale(c.Img, scaledRect, img, srcBounds, draw.Over, nil)

     

       367
       +
       }

     

       368
       +
       

     

       369
       +
       func fallbackImage() image.Image {

     

       370
       +
       	// can't usage image.Uniform(color.White) because it's infinitely sized causing a panic in the scaler in DrawImage

     

       371
       +
       	img := image.NewRGBA(image.Rect(0, 0, 1, 1))

     

       372
       +
       	img.Set(0, 0, color.White)

     

       373
       +
       	return img

     

       374
       +
       }

     

       375
       +
       

     

       376
       +
       // As defensively as possible, attempt to load an image from a presumed external and untrusted URL

     

       377
       +
       func (c *Card) fetchExternalImage(url string) (image.Image, bool) {

     

       378
       +
       	// Use a short timeout; in the event of any failure we'll be logging and returning a placeholder, but we don't want

     

       379
       +
       	// this rendering process to be slowed down

     

       380
       +
       	client := &http.Client{

     

       381
       +
       		Timeout: 1 * time.Second, // 1 second timeout

     

       382
       +
       	}

     

       383
       +
       

     

       384
       +
       	resp, err := client.Get(url)

     

       385
       +
       	if err != nil {

     

       386
       +
       		log.Printf("error when fetching external image from %s: %v", url, err)

     

       387
       +
       		return nil, false

     

       388
       +
       	}

     

       389
       +
       	defer resp.Body.Close()

     

       390
       +
       

     

       391
       +
       	if resp.StatusCode != http.StatusOK {

     

       392
       +
       		log.Printf("non-OK error code when fetching external image from %s: %s", url, resp.Status)

     

       393
       +
       		return nil, false

     

       394
       +
       	}

     

       395
       +
       

     

       396
       +
       	contentType := resp.Header.Get("Content-Type")

     

       397
       +
       	// Support content types are in-sync with the allowed custom avatar file types

     

       398
       +
       	if contentType != "image/png" && contentType != "image/jpeg" && contentType != "image/gif" && contentType != "image/webp" {

     

       399
       +
       		log.Printf("fetching external image returned unsupported Content-Type which was ignored: %s", contentType)

     

       400
       +
       		return nil, false

     

       401
       +
       	}

     

       402
       +
       

     

       403
       +
       	body := resp.Body

     

       404
       +
       	bodyBytes, err := io.ReadAll(body)

     

       405
       +
       	if err != nil {

     

       406
       +
       		log.Printf("error when fetching external image from %s: %v", url, err)

     

       407
       +
       		return nil, false

     

       408
       +
       	}

     

       409
       +
       

     

       410
       +
       	bodyBuffer := bytes.NewReader(bodyBytes)

     

       411
       +
       	_, imgType, err := image.DecodeConfig(bodyBuffer)

     

       412
       +
       	if err != nil {

     

       413
       +
       		log.Printf("error when decoding external image from %s: %v", url, err)

     

       414
       +
       		return nil, false

     

       415
       +
       	}

     

       416
       +
       

     

       417
       +
       	// Verify that we have a match between actual data understood in the image body and the reported Content-Type

     

       418
       +
       	if (contentType == "image/png" && imgType != "png") ||

     

       419
       +
       		(contentType == "image/jpeg" && imgType != "jpeg") ||

     

       420
       +
       		(contentType == "image/gif" && imgType != "gif") ||

     

       421
       +
       		(contentType == "image/webp" && imgType != "webp") {

     

       422
       +
       		log.Printf("while fetching external image, mismatched image body (%s) and Content-Type (%s)", imgType, contentType)

     

       423
       +
       		return nil, false

     

       424
       +
       	}

     

       425
       +
       

     

       426
       +
       	_, err = bodyBuffer.Seek(0, io.SeekStart) // reset for actual decode

     

       427
       +
       	if err != nil {

     

       428
       +
       		log.Printf("error w/ bodyBuffer.Seek")

     

       429
       +
       		return nil, false

     

       430
       +
       	}

     

       431
       +
       	img, _, err := image.Decode(bodyBuffer)

     

       432
       +
       	if err != nil {

     

       433
       +
       		log.Printf("error when decoding external image from %s: %v", url, err)

     

       434
       +
       		return nil, false

     

       435
       +
       	}

     

       436
       +
       

     

       437
       +
       	return img, true

     

       438
       +
       }

     

       439
       +
       

     

       440
       +
       func (c *Card) DrawExternalImage(url string) {

     

       441
       +
       	image, ok := c.fetchExternalImage(url)

     

       442
       +
       	if !ok {

     

       443
       +
       		image = fallbackImage()

     

       444
       +
       	}

     

       445
       +
       	c.DrawImage(image)

     

       446
       +
       }

     

       447
       +
       

     

       448
       +
       // DrawCircularExternalImage draws an external image as a circle at the specified position

     

       449
       +
       func (c *Card) DrawCircularExternalImage(url string, x, y, size int) error {

     

       450
       +
       	img, ok := c.fetchExternalImage(url)

     

       451
       +
       	if !ok {

     

       452
       +
       		img = fallbackImage()

     

       453
       +
       	}

     

       454
       +
       

     

       455
       +
       	// Create a circular mask

     

       456
       +
       	circle := image.NewRGBA(image.Rect(0, 0, size, size))

     

       457
       +
       	center := size / 2

     

       458
       +
       	radius := float64(size / 2)

     

       459
       +
       

     

       460
       +
       	// Scale the source image to fit the circle

     

       461
       +
       	srcBounds := img.Bounds()

     

       462
       +
       	scaledImg := image.NewRGBA(image.Rect(0, 0, size, size))

     

       463
       +
       	draw.CatmullRom.Scale(scaledImg, scaledImg.Bounds(), img, srcBounds, draw.Src, nil)

     

       464
       +
       

     

       465
       +
       	// Draw the image with circular clipping

     

       466
       +
       	for cy := 0; cy < size; cy++ {

     

       467
       +
       		for cx := 0; cx < size; cx++ {

     

       468
       +
       			// Calculate distance from center

     

       469
       +
       			dx := float64(cx - center)

     

       470
       +
       			dy := float64(cy - center)

     

       471
       +
       			distance := math.Sqrt(dx*dx + dy*dy)

     

       472
       +
       

     

       473
       +
       			// Only draw pixels within the circle

     

       474
       +
       			if distance <= radius {

     

       475
       +
       				circle.Set(cx, cy, scaledImg.At(cx, cy))

     

       476
       +
       			}

     

       477
       +
       		}

     

       478
       +
       	}

     

       479
       +
       

     

       480
       +
       	// Draw the circle onto the card

     

       481
       +
       	bounds := c.Img.Bounds()

     

       482
       +
       	destRect := image.Rect(x, y, x+size, y+size)

     

       483
       +
       

     

       484
       +
       	// Make sure we don't draw outside the card bounds

     

       485
       +
       	if destRect.Max.X > bounds.Max.X {

     

       486
       +
       		destRect.Max.X = bounds.Max.X

     

       487
       +
       	}

     

       488
       +
       	if destRect.Max.Y > bounds.Max.Y {

     

       489
       +
       		destRect.Max.Y = bounds.Max.Y

     

       490
       +
       	}

     

       491
       +
       

     

       492
       +
       	draw.Draw(c.Img, destRect, circle, image.Point{}, draw.Over)

     

       493
       +
       

     

       494
       +
       	return nil

     

       495
       +
       }

     

       496
       +
       

     

       497
       +
       // DrawRect draws a rect with the given color

     

       498
       +
       func (c *Card) DrawRect(startX, startY, endX, endY int, color color.Color) {

     

       499
       +
       	draw.Draw(c.Img, image.Rect(startX, startY, endX, endY), &image.Uniform{color}, image.Point{}, draw.Src)

     

       500
       +
       }

+4 -3

go.mod

···

       21
        
       	github.com/go-chi/chi/v5 v5.2.0

     

       22
        
       	github.com/go-enry/go-enry/v2 v2.9.2

     

       23
        
       	github.com/go-git/go-git/v5 v5.14.0

     

       0
        
       
     

       24
        
       	github.com/google/uuid v1.6.0

     

       25
        
       	github.com/gorilla/feeds v1.2.0

     

       26
        
       	github.com/gorilla/sessions v1.4.0

     
···

       44
        
       	github.com/yuin/goldmark-highlighting/v2 v2.0.0-20230729083705-37449abec8cc

     

       45
        
       	golang.org/x/crypto v0.40.0

     

       46
        
       	golang.org/x/exp v0.0.0-20250620022241-b7579e27df2b

     

       0
        
       
     

       47
        
       	golang.org/x/net v0.42.0

     

       48
       -
       	golang.org/x/sync v0.16.0

     

       49
        
       	golang.org/x/xerrors v0.0.0-20240903120638-7835f813f4da

     

       50
        
       	gopkg.in/yaml.v3 v3.0.1

     

       51
       -
       	tangled.org/anirudh.fi/atproto-oauth v0.0.0-20251004062652-69f4561572b5

     

       52
        
       )

     

       53
        
       

     

       54
        
       require (

     
···

       170
        
       	go.uber.org/multierr v1.11.0 // indirect

     

       171
        
       	go.uber.org/zap v1.27.0 // indirect

     

       172
        
       	golang.org/x/sys v0.34.0 // indirect

     

       173
       -
       	golang.org/x/text v0.27.0 // indirect

     

       174
        
       	golang.org/x/time v0.12.0 // indirect

     

       175
        
       	google.golang.org/genproto/googleapis/api v0.0.0-20250603155806-513f23925822 // indirect

     

       176
        
       	google.golang.org/genproto/googleapis/rpc v0.0.0-20250603155806-513f23925822 // indirect

···

       21
        
       	github.com/go-chi/chi/v5 v5.2.0

     

       22
        
       	github.com/go-enry/go-enry/v2 v2.9.2

     

       23
        
       	github.com/go-git/go-git/v5 v5.14.0

     

       24
       +
       	github.com/goki/freetype v1.0.5

     

       25
        
       	github.com/google/uuid v1.6.0

     

       26
        
       	github.com/gorilla/feeds v1.2.0

     

       27
        
       	github.com/gorilla/sessions v1.4.0

     
···

       45
        
       	github.com/yuin/goldmark-highlighting/v2 v2.0.0-20230729083705-37449abec8cc

     

       46
        
       	golang.org/x/crypto v0.40.0

     

       47
        
       	golang.org/x/exp v0.0.0-20250620022241-b7579e27df2b

     

       48
       +
       	golang.org/x/image v0.31.0

     

       49
        
       	golang.org/x/net v0.42.0

     

       50
       +
       	golang.org/x/sync v0.17.0

     

       51
        
       	golang.org/x/xerrors v0.0.0-20240903120638-7835f813f4da

     

       52
        
       	gopkg.in/yaml.v3 v3.0.1

     

       0
        
       
     

       53
        
       )

     

       54
        
       

     

       55
        
       require (

     
···

       171
        
       	go.uber.org/multierr v1.11.0 // indirect

     

       172
        
       	go.uber.org/zap v1.27.0 // indirect

     

       173
        
       	golang.org/x/sys v0.34.0 // indirect

     

       174
       +
       	golang.org/x/text v0.29.0 // indirect

     

       175
        
       	golang.org/x/time v0.12.0 // indirect

     

       176
        
       	google.golang.org/genproto/googleapis/api v0.0.0-20250603155806-513f23925822 // indirect

     

       177
        
       	google.golang.org/genproto/googleapis/rpc v0.0.0-20250603155806-513f23925822 // indirect

+6 -10

go.sum

···

       23
        
       github.com/aymerick/douceur v0.2.0/go.mod h1:wlT5vV2O3h55X9m7iVYN0TBM0NH/MmbLnd30/FjWUq4=

     

       24
        
       github.com/beorn7/perks v1.0.1 h1:VlbKKnNfV8bJzeqoa4cOKqO6bYr3WgKZxO8Z16+hsOM=

     

       25
        
       github.com/beorn7/perks v1.0.1/go.mod h1:G2ZrVWU2WbWT9wwq4/hrbKbnv/1ERSJQ0ibhJ6rlkpw=

     

       26
       -
       github.com/bluesky-social/indigo v0.0.0-20250724221105-5827c8fb61bb h1:BqMNDZMfXwiRTJ6NvQotJ0qInn37JH5U8E+TF01CFHQ=

     

       27
       -
       github.com/bluesky-social/indigo v0.0.0-20250724221105-5827c8fb61bb/go.mod h1:0XUyOCRtL4/OiyeqMTmr6RlVHQMDgw3LS7CfibuZR5Q=

     

       28
        
       github.com/bluesky-social/indigo v0.0.0-20251003000214-3259b215110e h1:IutKPwmbU0LrYqw03EuwJtMdAe67rDTrL1U8S8dicRU=

     

       29
        
       github.com/bluesky-social/indigo v0.0.0-20251003000214-3259b215110e/go.mod h1:n6QE1NDPFoi7PRbMUZmc2y7FibCqiVU4ePpsvhHUBR8=

     

       30
        
       github.com/bluesky-social/jetstream v0.0.0-20241210005130-ea96859b93d1 h1:CFvRtYNSnWRAi/98M3O466t9dYuwtesNbu6FVPymRrA=

     
···

       245
        
       github.com/ipfs/go-log/v2 v2.6.0/go.mod h1:p+Efr3qaY5YXpx9TX7MoLCSEZX5boSWj9wh86P5HJa8=

     

       246
        
       github.com/ipfs/go-metrics-interface v0.3.0 h1:YwG7/Cy4R94mYDUuwsBfeziJCVm9pBMJ6q/JR9V40TU=

     

       247
        
       github.com/ipfs/go-metrics-interface v0.3.0/go.mod h1:OxxQjZDGocXVdyTPocns6cOLwHieqej/jos7H4POwoY=

     

       248
       -
       github.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0=

     

       249
       -
       github.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4=

     

       250
        
       github.com/jtolds/gls v4.20.0+incompatible h1:xdiiI2gbIgH/gLH7ADydsJ1uDOEzR8yvV7C0MuV77Wo=

     

       251
        
       github.com/jtolds/gls v4.20.0+incompatible/go.mod h1:QJZ7F/aHp+rZTRtaJ1ow/lLfFfVYBRgL+9YlvaHOwJU=

     

       252
        
       github.com/kevinburke/ssh_config v1.2.0 h1:x584FjTGwHzMwvHx18PXxbBVzfnxogHaAReU4gf13a4=

     
···

       491
        
       golang.org/x/crypto v0.40.0/go.mod h1:Qr1vMER5WyS2dfPHAlsOj01wgLbsyWtFn/aY+5+ZdxY=

     

       492
        
       golang.org/x/exp v0.0.0-20250620022241-b7579e27df2b h1:M2rDM6z3Fhozi9O7NWsxAkg/yqS/lQJ6PmkyIV3YP+o=

     

       493
        
       golang.org/x/exp v0.0.0-20250620022241-b7579e27df2b/go.mod h1:3//PLf8L/X+8b4vuAfHzxeRUl04Adcb341+IGKfnqS8=

     

       0
        
       
     

       0
        
       
     

       494
        
       golang.org/x/lint v0.0.0-20190930215403-16217165b5de/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc=

     

       495
        
       golang.org/x/mod v0.0.0-20190513183733-4bf6d317e70e/go.mod h1:mXi4GBBbnImb6dmsKGUJ2LatrhH/nqhxcFungHvyanc=

     

       496
        
       golang.org/x/mod v0.2.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=

     
···

       530
        
       golang.org/x/sync v0.0.0-20210220032951-036812b2e83c/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=

     

       531
        
       golang.org/x/sync v0.0.0-20220722155255-886fb9371eb4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=

     

       532
        
       golang.org/x/sync v0.1.0/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=

     

       533
       -
       golang.org/x/sync v0.16.0 h1:ycBJEhp9p4vXvUZNszeOq0kGTPghopOL8q0fq3vstxw=

     

       534
       -
       golang.org/x/sync v0.16.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA=

     

       535
        
       golang.org/x/sys v0.0.0-20180909124046-d0be0721c37e/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=

     

       536
        
       golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=

     

       537
        
       golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=

     
···

       585
        
       golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8=

     

       586
        
       golang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8=

     

       587
        
       golang.org/x/text v0.14.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU=

     

       588
       -
       golang.org/x/text v0.27.0 h1:4fGWRpyh641NLlecmyl4LOe6yDdfaYNrGb2zdfo4JV4=

     

       589
       -
       golang.org/x/text v0.27.0/go.mod h1:1D28KMCvyooCX9hBiosv5Tz/+YLxj0j7XhWjpSUF7CU=

     

       590
        
       golang.org/x/time v0.12.0 h1:ScB/8o8olJvc+CQPWrK3fPZNfh7qgwCrY0zJmoEQLSE=

     

       591
        
       golang.org/x/time v0.12.0/go.mod h1:CDIdPxbZBQxdj6cxyCIdrNogrJKMJ7pr37NYpMcMDSg=

     

       592
        
       golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=

     
···

       654
        
       honnef.co/go/tools v0.0.1-2019.2.3/go.mod h1:a3bituU0lyd329TUQxRnasdCoJDkEUEAqEt0JzvZhAg=

     

       655
        
       lukechampine.com/blake3 v1.4.1 h1:I3Smz7gso8w4/TunLKec6K2fn+kyKtDxr/xcQEN84Wg=

     

       656
        
       lukechampine.com/blake3 v1.4.1/go.mod h1:QFosUxmjB8mnrWFSNwKmvxHpfY72bmD2tQ0kBMM3kwo=

     

       657
       -
       tangled.org/anirudh.fi/atproto-oauth v0.0.0-20251004062652-69f4561572b5 h1:EpQ9MT09jSf4Zjs1+yFvB4CD/fBkFdx8UaDJDwO1Jk8=

     

       658
       -
       tangled.org/anirudh.fi/atproto-oauth v0.0.0-20251004062652-69f4561572b5/go.mod h1:BQFGoN2V+h5KtgKsQgWU73R55ILdDy/R5RZTrZi6wog=

     

       659
        
       tangled.sh/oppi.li/go-gitdiff v0.8.2 h1:pASJJNWaFn6EmEIUNNjHZQ3stRu6BqTO2YyjKvTcxIc=

     

       660
        
       tangled.sh/oppi.li/go-gitdiff v0.8.2/go.mod h1:WWAk1Mc6EgWarCrPFO+xeYlujPu98VuLW3Tu+B/85AE=

···

       23
        
       github.com/aymerick/douceur v0.2.0/go.mod h1:wlT5vV2O3h55X9m7iVYN0TBM0NH/MmbLnd30/FjWUq4=

     

       24
        
       github.com/beorn7/perks v1.0.1 h1:VlbKKnNfV8bJzeqoa4cOKqO6bYr3WgKZxO8Z16+hsOM=

     

       25
        
       github.com/beorn7/perks v1.0.1/go.mod h1:G2ZrVWU2WbWT9wwq4/hrbKbnv/1ERSJQ0ibhJ6rlkpw=

     

       0
        
       
     

       0
        
       
     

       26
        
       github.com/bluesky-social/indigo v0.0.0-20251003000214-3259b215110e h1:IutKPwmbU0LrYqw03EuwJtMdAe67rDTrL1U8S8dicRU=

     

       27
        
       github.com/bluesky-social/indigo v0.0.0-20251003000214-3259b215110e/go.mod h1:n6QE1NDPFoi7PRbMUZmc2y7FibCqiVU4ePpsvhHUBR8=

     

       28
        
       github.com/bluesky-social/jetstream v0.0.0-20241210005130-ea96859b93d1 h1:CFvRtYNSnWRAi/98M3O466t9dYuwtesNbu6FVPymRrA=

     
···

       243
        
       github.com/ipfs/go-log/v2 v2.6.0/go.mod h1:p+Efr3qaY5YXpx9TX7MoLCSEZX5boSWj9wh86P5HJa8=

     

       244
        
       github.com/ipfs/go-metrics-interface v0.3.0 h1:YwG7/Cy4R94mYDUuwsBfeziJCVm9pBMJ6q/JR9V40TU=

     

       245
        
       github.com/ipfs/go-metrics-interface v0.3.0/go.mod h1:OxxQjZDGocXVdyTPocns6cOLwHieqej/jos7H4POwoY=

     

       0
        
       
     

       0
        
       
     

       246
        
       github.com/jtolds/gls v4.20.0+incompatible h1:xdiiI2gbIgH/gLH7ADydsJ1uDOEzR8yvV7C0MuV77Wo=

     

       247
        
       github.com/jtolds/gls v4.20.0+incompatible/go.mod h1:QJZ7F/aHp+rZTRtaJ1ow/lLfFfVYBRgL+9YlvaHOwJU=

     

       248
        
       github.com/kevinburke/ssh_config v1.2.0 h1:x584FjTGwHzMwvHx18PXxbBVzfnxogHaAReU4gf13a4=

     
···

       487
        
       golang.org/x/crypto v0.40.0/go.mod h1:Qr1vMER5WyS2dfPHAlsOj01wgLbsyWtFn/aY+5+ZdxY=

     

       488
        
       golang.org/x/exp v0.0.0-20250620022241-b7579e27df2b h1:M2rDM6z3Fhozi9O7NWsxAkg/yqS/lQJ6PmkyIV3YP+o=

     

       489
        
       golang.org/x/exp v0.0.0-20250620022241-b7579e27df2b/go.mod h1:3//PLf8L/X+8b4vuAfHzxeRUl04Adcb341+IGKfnqS8=

     

       490
       +
       golang.org/x/image v0.31.0 h1:mLChjE2MV6g1S7oqbXC0/UcKijjm5fnJLUYKIYrLESA=

     

       491
       +
       golang.org/x/image v0.31.0/go.mod h1:R9ec5Lcp96v9FTF+ajwaH3uGxPH4fKfHHAVbUILxghA=

     

       492
        
       golang.org/x/lint v0.0.0-20190930215403-16217165b5de/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc=

     

       493
        
       golang.org/x/mod v0.0.0-20190513183733-4bf6d317e70e/go.mod h1:mXi4GBBbnImb6dmsKGUJ2LatrhH/nqhxcFungHvyanc=

     

       494
        
       golang.org/x/mod v0.2.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=

     
···

       528
        
       golang.org/x/sync v0.0.0-20210220032951-036812b2e83c/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=

     

       529
        
       golang.org/x/sync v0.0.0-20220722155255-886fb9371eb4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=

     

       530
        
       golang.org/x/sync v0.1.0/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=

     

       531
       +
       golang.org/x/sync v0.17.0 h1:l60nONMj9l5drqw6jlhIELNv9I0A4OFgRsG9k2oT9Ug=

     

       532
       +
       golang.org/x/sync v0.17.0/go.mod h1:9KTHXmSnoGruLpwFjVSX0lNNA75CykiMECbovNTZqGI=

     

       533
        
       golang.org/x/sys v0.0.0-20180909124046-d0be0721c37e/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=

     

       534
        
       golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=

     

       535
        
       golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=

     
···

       583
        
       golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8=

     

       584
        
       golang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8=

     

       585
        
       golang.org/x/text v0.14.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU=

     

       586
       +
       golang.org/x/text v0.29.0 h1:1neNs90w9YzJ9BocxfsQNHKuAT4pkghyXc4nhZ6sJvk=

     

       587
       +
       golang.org/x/text v0.29.0/go.mod h1:7MhJOA9CD2qZyOKYazxdYMF85OwPdEr9jTtBpO7ydH4=

     

       588
        
       golang.org/x/time v0.12.0 h1:ScB/8o8olJvc+CQPWrK3fPZNfh7qgwCrY0zJmoEQLSE=

     

       589
        
       golang.org/x/time v0.12.0/go.mod h1:CDIdPxbZBQxdj6cxyCIdrNogrJKMJ7pr37NYpMcMDSg=

     

       590
        
       golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=

     
···

       652
        
       honnef.co/go/tools v0.0.1-2019.2.3/go.mod h1:a3bituU0lyd329TUQxRnasdCoJDkEUEAqEt0JzvZhAg=

     

       653
        
       lukechampine.com/blake3 v1.4.1 h1:I3Smz7gso8w4/TunLKec6K2fn+kyKtDxr/xcQEN84Wg=

     

       654
        
       lukechampine.com/blake3 v1.4.1/go.mod h1:QFosUxmjB8mnrWFSNwKmvxHpfY72bmD2tQ0kBMM3kwo=

     

       0
        
       
     

       0
        
       
     

       655
        
       tangled.sh/oppi.li/go-gitdiff v0.8.2 h1:pASJJNWaFn6EmEIUNNjHZQ3stRu6BqTO2YyjKvTcxIc=

     

       656
        
       tangled.sh/oppi.li/go-gitdiff v0.8.2/go.mod h1:WWAk1Mc6EgWarCrPFO+xeYlujPu98VuLW3Tu+B/85AE=