mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub ec98dfde9a feat(landing,docs): SEO fixes and query-matched tool pages (#383 )

Landing:
- Preload the Bricolage display font (LCP heading) to cut first paint
- Cap tool-page meta descriptions at ~160 chars via whole-sentence
  truncation, so SERP snippets no longer overflow or cut mid-phrase
- Drop dead HowTo + FAQPage JSON-LD from tool pages (Google removed
  HowTo rich results in 2023 and FAQ rich results in 2026); the visible
  content stays. Breadcrumb + WebApplication schema retained
- Shorten 22 tool titles that exceeded the ~60-char SERP limit
- Add an optional h1 override to tool SEO data
- Rewrite adjust-colors, smart-crop, and ringtone-maker to match real
  Search Console query intent (saturation; object-aware cropping;
  convert audio to ringtone), with query-matched H1s and FAQs

Docs:
- Add meta descriptions to 20 pages missing frontmatter

Repo:
- Ignore local credential JSON files (.secrets/, *client_secret*, *service_account*)

2026-07-01 16:20:05 +08:00

2.5 KiB

Raw Blame History

description

description
Seam-carving resize that adds or removes pixels along low-importance paths to preserve key content and faces.

Content-Aware Resize

Seam carving resize that intelligently removes or adds pixels along paths of least visual importance, preserving important content and optionally protecting faces.

API Endpoint

POST /api/v1/tools/image/content-aware-resize

Processing: Synchronous (returns result directly)

Model bundle: None required for basic operation. Face protection uses the face-detection bundle (200-300 MB) if enabled.

Parameters

Parameter	Type	Required	Default	Description
file	file	Yes	-	Image file (multipart)
width	number	No	-	Target width in pixels
height	number	No	-	Target height in pixels
protectFaces	boolean	No	`false`	Detect and protect faces from seam removal
blurRadius	number	No	`4`	Pre-processing blur radius for energy calculation (0-20)
sobelThreshold	number	No	`2`	Sobel edge detection threshold (1-20). Higher values make the algorithm more aggressive
square	boolean	No	`false`	Resize to a square (uses the smaller dimension)

At least one of width, height, or square must be specified.

Example Request

curl -X POST http://localhost:1349/api/v1/tools/image/content-aware-resize \
  -F "file=@landscape.jpg" \
  -F 'settings={"width":800,"protectFaces":true}'

Response (200 OK)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/{jobId}/landscape_seam.png",
  "originalSize": 450000,
  "processedSize": 380000,
  "width": 800,
  "height": 600
}

Notes

This tool returns a synchronous response (not 202 async). Processing happens inline.
Uses the caire seam carving library for content-aware resizing.
Only reduces dimensions (removes seams). Cannot expand an image beyond its original size.
The protectFaces option uses AI face detection to mark face regions as high-energy, preventing seams from passing through faces.
blurRadius controls smoothing before energy map calculation. Higher values make the energy map more uniform, which can help with noisy images.
sobelThreshold affects how aggressively edges are detected. Lower values preserve more subtle edges.
Output is always PNG format.
Supports HEIC/HEIF, RAW, TGA, PSD, EXR, and HDR input formats via automatic decoding.

2.5 KiB Raw Blame History