feat: enhance background rendering by using WindowBackground color for terminal areas and adding cursor rendering option

Author: MrMarble

pkg/raster/draw.go

@@ -92,12 +92,14 @@ func (r *Rasterizer) drawTextRunWithFace(
 
 	colors := r.computeTextRunColors(run, rowY, catalog)
 
-	// Draw background rectangle for the run
-	draw.Draw(img,
-		image.Rect(colors.x, colors.y, colors.x+colors.textWidth, colors.y+r.config.RowHeight),
-		&image.Uniform{colors.bg},
-		image.Point{},
-		draw.Src)
+	// Draw background rectangle only if it's not the default color
+	if !catalog.IsDefault(run.Attrs.BG) {
+		draw.Draw(img,
+			image.Rect(colors.x, colors.y, colors.x+colors.textWidth, colors.y+r.config.RowHeight),
+			&image.Uniform{colors.bg},
+			image.Point{},
+			draw.Src)
+	}
 
 	// Draw text
 	drawer := &font.Drawer{
@@ -160,12 +162,13 @@ func (r *Rasterizer) drawBackground(img *image.RGBA) {
 }
 
 // drawTerminalBackground draws the terminal content area background.
-// Uses the theme's Background color for the terminal content.
+// Uses the theme's WindowBackground color to match the window chrome,
+// creating a seamless appearance while maintaining full opacity for GIF performance.
 func (r *Rasterizer) drawTerminalBackground(img *image.RGBA, width, height int) {
 	contentX := r.config.Padding
 	contentY := r.contentOffsetY()
-	// Use theme Background for terminal content area
-	termBg := r.config.Theme.Background
+	// Use WindowBackground to match the window chrome color
+	termBg := r.config.Theme.WindowBackground
 
 	draw.Draw(img,
 		image.Rect(contentX, contentY, contentX+width, contentY+height),
@@ -251,12 +254,14 @@ func (r *Rasterizer) drawTextRunToPaletted(
 
 	colors := r.computeTextRunColors(run, rowY, catalog)
 
-	// Draw background rectangle for the run
-	draw.Draw(img,
-		image.Rect(colors.x, colors.y, colors.x+colors.textWidth, colors.y+r.config.RowHeight),
-		&image.Uniform{colors.bg},
-		image.Point{},
-		draw.Src)
+	// Draw background rectangle only if it's not the default color
+	if !catalog.IsDefault(run.Attrs.BG) {
+		draw.Draw(img,
+			image.Rect(colors.x, colors.y, colors.x+colors.textWidth, colors.y+r.config.RowHeight),
+			&image.Uniform{colors.bg},
+			image.Point{},
+			draw.Src)
+	}
 
 	// Draw text directly to paletted image
 	drawer := &font.Drawer{

pkg/raster/paletted.go

@@ -64,11 +64,10 @@ func (fr *palettedFrameRenderer) renderSingleFrame(
 	}
 }
 
-// createPalettedBaseImage creates the static base image with window chrome
-// and terminal background.
-func (fr *palettedFrameRenderer) createPalettedBaseImage(
-	width, height, contentWidth, contentHeight int,
-) *image.Paletted {
+// createPalettedBaseImage creates the static base image with window chrome and terminal background.
+// Uses WindowBackground color for the terminal area to match window chrome,
+// ensuring full opacity for optimal GIF delta encoding performance.
+func (fr *palettedFrameRenderer) createPalettedBaseImage(width, height, contentWidth, contentHeight int) *image.Paletted {
 	// First create RGBA base image
 	rgbaImg := image.NewRGBA(image.Rect(0, 0, width, height))
 
@@ -79,7 +78,9 @@ func (fr *palettedFrameRenderer) createPalettedBaseImage(
 		fr.rasterizer.drawBackground(rgbaImg)
 	}
 
-	// Draw terminal content background
+	// Draw terminal content background using WindowBackground color
+	// This ensures full opacity for GIF delta encoding while maintaining
+	// visual consistency with the window chrome
 	fr.rasterizer.drawTerminalBackground(rgbaImg, contentWidth, contentHeight)
 
 	// Convert to paletted once (this is done only once per recording, not per frame)
@@ -106,8 +107,8 @@ func (fr *palettedFrameRenderer) drawFrameContentToPaletted(img *image.Paletted,
 		}
 	}
 
-	// Draw cursor if visible
-	if frame.Cursor.Visible {
+	// Draw cursor if visible and cursor rendering is enabled
+	if fr.rasterizer.config.ShowCursor && frame.Cursor.Visible {
 		fr.rasterizer.drawCursorToPaletted(img, frame.Cursor, fr.rec.Colors)
 	}
 }

pkg/raster/raster.go

@@ -38,6 +38,9 @@ type Config struct {
 	// ShowWindow enables window chrome rendering (macOS-style buttons)
 	ShowWindow bool
 
+	// ShowCursor enables cursor rendering
+	ShowCursor bool
+
 	// FontSize is the font size in points
 	FontSize int
 
@@ -79,6 +82,7 @@ func DefaultConfig() Config {
 	return Config{
 		Theme:      theme.Default(),
 		ShowWindow: true,
+		ShowCursor: true,
 		FontSize:   20,
 		RowHeight:  RowHeight,
 		ColWidth:   ColWidth,

pkg/raster/renderer.go

@@ -60,6 +60,8 @@ func (fr *frameRenderer) renderSingleFrame(
 }
 
 // createBaseImage creates the static base image with window chrome and terminal background.
+// Uses WindowBackground color for the terminal area to match window chrome,
+// ensuring full opacity for optimal GIF delta encoding performance.
 func (fr *frameRenderer) createBaseImage(width, height, contentWidth, contentHeight int) *image.RGBA {
 	img := image.NewRGBA(image.Rect(0, 0, width, height))
 
@@ -70,7 +72,9 @@ func (fr *frameRenderer) createBaseImage(width, height, contentWidth, contentHei
 		fr.rasterizer.drawBackground(img)
 	}
 
-	// Draw terminal content background
+	// Draw terminal content background using WindowBackground color
+	// This ensures full opacity for GIF delta encoding while maintaining
+	// visual consistency with the window chrome
 	fr.rasterizer.drawTerminalBackground(img, contentWidth, contentHeight)
 
 	return img