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",
"selectText": {
"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:",
"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:",
"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:",
"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:",
"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."
},
@ -1675,28 +1675,27 @@
"failed": "An error occurred while extracting image scans."
},
"tooltip": {
"title": "Extract Individual Photos from Scans",
"overview": {
"title": "What This Tool Does",
"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."
},
"commonUseCases": "Common Use Cases:",
"useCase1": "Extracting multiple photos from a single flatbed scanner session",
"useCase2": "Splitting collages or composite images into individual photos",
"useCase3": "Digitising photo albums by scanning entire pages then extracting individual photos",
"useCase4": "Processing documents with embedded photos or images",
"problemSolving": "Common Problems & Solutions",
"problem1": "Photos not detected → Try increasing \"Tolerance\" to 30-50",
"problem2": "Too many false detections → Increase \"Minimum Area\" to 15000-20000",
"problem3": "Photos cropped too tight → Increase \"Border Size\" to 5-10",
"problem4": "Tilted photos not straightened → Lower \"Angle Threshold\" to 5",
"problem5": "Detecting dust/noise → Increase \"Minimum Contour Area\" to 1000",
"tips": "Setup Tips for Best Results",
"tip1": "Use white or light background behind photos",
"tip2": "Leave at least 1cm gap between photos",
"tip3": "Scan at 300+ DPI for better detection",
"tip4": "Clean scanner glass to avoid dust being detected as photos",
"tip5": "If it fails, try the default settings first before adjusting"
"title": "Photo Splitter",
"whatThisDoes": "What this does",
"whatThisDoesDesc": "Automatically finds and extracts each photo from a scanned page or composite image—no manual cropping.",
"whenToUse": "When to use",
"useCase1": "Scan whole album pages in one go",
"useCase2": "Split flatbed batches into separate files",
"useCase3": "Break collages into individual photos",
"useCase4": "Pull photos from documents",
"quickFixes": "Quick fixes",
"problem1": "Photos not detected → increase Tolerance to 3050",
"problem2": "Too many false detections → increase Minimum Area to 15,00020,000",
"problem3": "Crops are too tight → increase Border Size to 510",
"problem4": "Tilted photos not straightened → lower Angle Threshold to ~5°",
"problem5": "Dust/noise boxes → increase Minimum Contour Area to 10002000",
"setupTips": "Setup tips",
"tip1": "Use a plain, light background",
"tip2": "Leave a small gap (≈1 cm) between photos",
"tip3": "Scan at 300600 DPI",
"tip4": "Clean the scanner glass",
"headsUp": "Heads-up",
"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."
}
},
"sign": {

View File

@ -6,43 +6,48 @@ export const useScannerImageSplitTips = (): TooltipContent => {
return {
header: {
title: t('scannerImageSplit.tooltip.title', 'Extract Individual Photos from Scans')
title: t('scannerImageSplit.tooltip.title', 'Photo Splitter')
},
tips: [
{
title: t('scannerImageSplit.tooltip.overview.title', 'What This Tool Does'),
description: t('scannerImageSplit.tooltip.overview.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.'
title: t('scannerImageSplit.tooltip.whatThisDoes', 'What this does'),
description: t('scannerImageSplit.tooltip.whatThisDoesDesc',
'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: [
t('scannerImageSplit.tooltip.useCase1', 'Extracting multiple photos from a single flatbed scanner session'),
t('scannerImageSplit.tooltip.useCase2', 'Splitting collages or composite images into individual photos'),
t('scannerImageSplit.tooltip.useCase3', 'Digitising photo albums by scanning entire pages then extracting individual photos'),
t('scannerImageSplit.tooltip.useCase4', 'Processing documents with embedded photos or images')
t('scannerImageSplit.tooltip.useCase1', 'Scan whole album pages in one go'),
t('scannerImageSplit.tooltip.useCase2', 'Split flatbed batches into separate files'),
t('scannerImageSplit.tooltip.useCase3', 'Break collages into individual photos'),
t('scannerImageSplit.tooltip.useCase4', 'Pull photos from documents')
]
},
{
title: t('scannerImageSplit.tooltip.problemSolving', 'Common Problems & Solutions'),
title: t('scannerImageSplit.tooltip.quickFixes', 'Quick fixes'),
bullets: [
t('scannerImageSplit.tooltip.problem1', 'Photos not detected → Try increasing "Tolerance" to 30-50'),
t('scannerImageSplit.tooltip.problem2', 'Too many false detections → Increase "Minimum Area" to 15000-20000'),
t('scannerImageSplit.tooltip.problem3', 'Photos cropped too tight → Increase "Border Size" to 5-10'),
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.problem1', 'Photos not detected → increase Tolerance to 3050'),
t('scannerImageSplit.tooltip.problem2', 'Too many false detections → increase Minimum Area to 15,00020,000'),
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.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: [
t('scannerImageSplit.tooltip.tip1', 'Use white or light background behind photos'),
t('scannerImageSplit.tooltip.tip2', 'Leave at least 1cm gap between photos'),
t('scannerImageSplit.tooltip.tip3', 'Scan at 300+ DPI for better detection'),
t('scannerImageSplit.tooltip.tip4', 'Clean scanner glass to avoid dust being detected as photos'),
t('scannerImageSplit.tooltip.tip5', 'If it fails, try the default settings first before adjusting')
t('scannerImageSplit.tooltip.tip1', 'Use a plain, light background'),
t('scannerImageSplit.tooltip.tip2', 'Leave a small gap (≈1 cm) between photos'),
t('scannerImageSplit.tooltip.tip3', 'Scan at 300600 DPI'),
t('scannerImageSplit.tooltip.tip4', 'Clean the scanner glass')
]
},
{
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.'
)
}
]
};