Rewrite tooltip with concise, actionable content focused on real-world usage

Transform verbose tooltip into practical guidance:

New structure:
• "What this does" - Clear one-liner about functionality
• "When to use" - 4 concrete use cases (album pages, batches, collages, documents)
• "Quick fixes" - Problem → solution pairs with specific values
• "Setup tips" - Practical scanning advice (DPI, gaps, backgrounds)
• "Heads-up" - Important limitations and workarounds

Benefits:
- Shorter, scannable content
- Action-oriented language ("increase Tolerance to 30-50")
- Real-world scenarios users actually face
- Specific numeric guidance instead of vague descriptions
- Proactive troubleshooting before problems occur

Content matches professional but accessible tone throughout.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Anthony Stirling 2025-09-25 23:55:57 +01:00
parent 5d828040a7
commit 9973c6b1d3
2 changed files with 52 additions and 48 deletions

View File

@ -1656,15 +1656,15 @@
"tags": "separate,auto-detect,scans,multi-photo,organize", "tags": "separate,auto-detect,scans,multi-photo,organize",
"selectText": { "selectText": {
"1": "Angle Threshold:", "1": "Angle Threshold:",
"2": "Sets the minimum absolute angle required for the image to be rotated (default: 10).", "2": "Tilt (in degrees) needed before we auto-straighten a photo.",
"3": "Tolerance:", "3": "Tolerance:",
"4": "Determines the range of colour variation around the estimated background colour (default: 30).", "4": "How closely a colour must match the page background to count as background. Higher = looser, lower = stricter.",
"5": "Minimum Area:", "5": "Minimum Area:",
"6": "Sets the minimum area threshold for a photo (default: 10000).", "6": "Smallest photo size (in pixels²) we'll keep to avoid tiny fragments.",
"7": "Minimum Contour Area:", "7": "Minimum Contour Area:",
"8": "Sets the minimum contour area threshold for a photo", "8": "Smallest edge/shape we consider when finding photos (filters dust and specks).",
"9": "Border Size:", "9": "Border Size:",
"10": "Sets the size of the border added and removed to prevent white borders in the output (default: 1)." "10": "Extra padding (in pixels) around each saved photo so edges aren't cut."
}, },
"info": "Python is not installed. It is required to run." "info": "Python is not installed. It is required to run."
}, },
@ -1675,28 +1675,27 @@
"failed": "An error occurred while extracting image scans." "failed": "An error occurred while extracting image scans."
}, },
"tooltip": { "tooltip": {
"title": "Extract Individual Photos from Scans", "title": "Photo Splitter",
"overview": { "whatThisDoes": "What this does",
"title": "What This Tool Does", "whatThisDoesDesc": "Automatically finds and extracts each photo from a scanned page or composite image—no manual cropping.",
"description": "This tool automatically detects and extracts individual photos from scanned documents or images. Perfect for digitising old photo albums, extracting multiple photos from scanner flatbed scans, or splitting composite images." "whenToUse": "When to use",
}, "useCase1": "Scan whole album pages in one go",
"commonUseCases": "Common Use Cases:", "useCase2": "Split flatbed batches into separate files",
"useCase1": "Extracting multiple photos from a single flatbed scanner session", "useCase3": "Break collages into individual photos",
"useCase2": "Splitting collages or composite images into individual photos", "useCase4": "Pull photos from documents",
"useCase3": "Digitising photo albums by scanning entire pages then extracting individual photos", "quickFixes": "Quick fixes",
"useCase4": "Processing documents with embedded photos or images", "problem1": "Photos not detected → increase Tolerance to 3050",
"problemSolving": "Common Problems & Solutions", "problem2": "Too many false detections → increase Minimum Area to 15,00020,000",
"problem1": "Photos not detected → Try increasing \"Tolerance\" to 30-50", "problem3": "Crops are too tight → increase Border Size to 510",
"problem2": "Too many false detections → Increase \"Minimum Area\" to 15000-20000", "problem4": "Tilted photos not straightened → lower Angle Threshold to ~5°",
"problem3": "Photos cropped too tight → Increase \"Border Size\" to 5-10", "problem5": "Dust/noise boxes → increase Minimum Contour Area to 10002000",
"problem4": "Tilted photos not straightened → Lower \"Angle Threshold\" to 5", "setupTips": "Setup tips",
"problem5": "Detecting dust/noise → Increase \"Minimum Contour Area\" to 1000", "tip1": "Use a plain, light background",
"tips": "Setup Tips for Best Results", "tip2": "Leave a small gap (≈1 cm) between photos",
"tip1": "Use white or light background behind photos", "tip3": "Scan at 300600 DPI",
"tip2": "Leave at least 1cm gap between photos", "tip4": "Clean the scanner glass",
"tip3": "Scan at 300+ DPI for better detection", "headsUp": "Heads-up",
"tip4": "Clean scanner glass to avoid dust being detected as photos", "headsUpDesc": "Overlapping photos or backgrounds very close in colour to the photos can reduce accuracy—try a lighter or darker background and leave more space."
"tip5": "If it fails, try the default settings first before adjusting"
} }
}, },
"sign": { "sign": {

View File

@ -6,43 +6,48 @@ export const useScannerImageSplitTips = (): TooltipContent => {
return { return {
header: { header: {
title: t('scannerImageSplit.tooltip.title', 'Extract Individual Photos from Scans') title: t('scannerImageSplit.tooltip.title', 'Photo Splitter')
}, },
tips: [ tips: [
{ {
title: t('scannerImageSplit.tooltip.overview.title', 'What This Tool Does'), title: t('scannerImageSplit.tooltip.whatThisDoes', 'What this does'),
description: t('scannerImageSplit.tooltip.overview.description', description: t('scannerImageSplit.tooltip.whatThisDoesDesc',
'This tool automatically detects and extracts individual photos from scanned documents or images. Perfect for digitising old photo albums, extracting multiple photos from scanner flatbed scans, or splitting composite images.' 'Automatically finds and extracts each photo from a scanned page or composite image—no manual cropping.'
) )
}, },
{ {
title: t('scannerImageSplit.tooltip.commonUseCases', 'Common Use Cases'), title: t('scannerImageSplit.tooltip.whenToUse', 'When to use'),
bullets: [ bullets: [
t('scannerImageSplit.tooltip.useCase1', 'Extracting multiple photos from a single flatbed scanner session'), t('scannerImageSplit.tooltip.useCase1', 'Scan whole album pages in one go'),
t('scannerImageSplit.tooltip.useCase2', 'Splitting collages or composite images into individual photos'), t('scannerImageSplit.tooltip.useCase2', 'Split flatbed batches into separate files'),
t('scannerImageSplit.tooltip.useCase3', 'Digitising photo albums by scanning entire pages then extracting individual photos'), t('scannerImageSplit.tooltip.useCase3', 'Break collages into individual photos'),
t('scannerImageSplit.tooltip.useCase4', 'Processing documents with embedded photos or images') t('scannerImageSplit.tooltip.useCase4', 'Pull photos from documents')
] ]
}, },
{ {
title: t('scannerImageSplit.tooltip.problemSolving', 'Common Problems & Solutions'), title: t('scannerImageSplit.tooltip.quickFixes', 'Quick fixes'),
bullets: [ bullets: [
t('scannerImageSplit.tooltip.problem1', 'Photos not detected → Try increasing "Tolerance" to 30-50'), t('scannerImageSplit.tooltip.problem1', 'Photos not detected → increase Tolerance to 3050'),
t('scannerImageSplit.tooltip.problem2', 'Too many false detections → Increase "Minimum Area" to 15000-20000'), t('scannerImageSplit.tooltip.problem2', 'Too many false detections → increase Minimum Area to 15,00020,000'),
t('scannerImageSplit.tooltip.problem3', 'Photos cropped too tight → Increase "Border Size" to 5-10'), t('scannerImageSplit.tooltip.problem3', 'Crops are too tight → increase Border Size to 510'),
t('scannerImageSplit.tooltip.problem4', 'Tilted photos not straightened → Lower "Angle Threshold" to 5'), t('scannerImageSplit.tooltip.problem4', 'Tilted photos not straightened → lower Angle Threshold to ~5°'),
t('scannerImageSplit.tooltip.problem5', 'Detecting dust/noise → Increase "Minimum Contour Area" to 1000') t('scannerImageSplit.tooltip.problem5', 'Dust/noise boxes → increase Minimum Contour Area to 10002000')
] ]
}, },
{ {
title: t('scannerImageSplit.tooltip.tips', 'Setup Tips for Best Results'), title: t('scannerImageSplit.tooltip.setupTips', 'Setup tips'),
bullets: [ bullets: [
t('scannerImageSplit.tooltip.tip1', 'Use white or light background behind photos'), t('scannerImageSplit.tooltip.tip1', 'Use a plain, light background'),
t('scannerImageSplit.tooltip.tip2', 'Leave at least 1cm gap between photos'), t('scannerImageSplit.tooltip.tip2', 'Leave a small gap (≈1 cm) between photos'),
t('scannerImageSplit.tooltip.tip3', 'Scan at 300+ DPI for better detection'), t('scannerImageSplit.tooltip.tip3', 'Scan at 300600 DPI'),
t('scannerImageSplit.tooltip.tip4', 'Clean scanner glass to avoid dust being detected as photos'), t('scannerImageSplit.tooltip.tip4', 'Clean the scanner glass')
t('scannerImageSplit.tooltip.tip5', 'If it fails, try the default settings first before adjusting')
] ]
},
{
title: t('scannerImageSplit.tooltip.headsUp', 'Heads-up'),
description: t('scannerImageSplit.tooltip.headsUpDesc',
'Overlapping photos or backgrounds very close in colour to the photos can reduce accuracy—try a lighter or darker background and leave more space.'
)
} }
] ]
}; };