From 5d828040a7c65b8fc3e8df9b3df0e2cd38a5178e Mon Sep 17 00:00:00 2001 From: Anthony Stirling <77850077+Frooodle@users.noreply.github.com> Date: Thu, 25 Sep 2025 23:44:20 +0100 Subject: [PATCH] Replace abstract tooltip explanations with practical troubleshooting guide MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Remove unhelpful technical descriptions with meaningless numbers - Add problem-solution pairs with specific value recommendations: • Photos not detected → increase Tolerance to 30-50 • Too many false detections → increase Minimum Area to 15000-20000 • Photos cropped tight → increase Border Size to 5-10 • Tilted photos → lower Angle Threshold to 5 • Dust detection → increase Minimum Contour Area to 1000 - Improve setup tips with concrete measurements: • Use white/light backgrounds • Leave 1cm gaps between photos • Scan at 300+ DPI • Try defaults before adjusting Now users get actionable solutions instead of abstract technical jargon. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- .../public/locales/en-GB/translation.json | 29 +++++------ .../tooltips/useScannerImageSplitTips.ts | 52 ++++++------------- 2 files changed, 28 insertions(+), 53 deletions(-) diff --git a/frontend/public/locales/en-GB/translation.json b/frontend/public/locales/en-GB/translation.json index 3bd2d03a4..49cff61aa 100644 --- a/frontend/public/locales/en-GB/translation.json +++ b/frontend/public/locales/en-GB/translation.json @@ -1685,23 +1685,18 @@ "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", - "settingsExplained": "Settings Explained:", - "angleThresholdTerm": "Angle Threshold (10°)", - "angleThresholdDef": "How much an image needs to be tilted before the tool tries to straighten it. Lower values detect smaller tilts.", - "toleranceTerm": "Tolerance (20)", - "toleranceDef": "How similar background colours need to be to be considered the same. Higher values group more varied colours together.", - "minAreaTerm": "Minimum Area (8000)", - "minAreaDef": "Smallest size (in pixels) for something to be considered a photo. Helps ignore small spots or artefacts.", - "minContourAreaTerm": "Minimum Contour Area (500)", - "minContourAreaDef": "Minimum edge detection size. Helps distinguish actual photo edges from noise or texture.", - "borderSizeTerm": "Border Size (1)", - "borderSizeDef": "Adds padding around detected photos to avoid cutting off edges. Increase if photos are getting cropped too tightly.", - "tips": "Tips for Best Results:", - "tip1": "Ensure good contrast between photos and background", - "tip2": "Place photos with some space between them on the scanner", - "tip3": "Use higher resolution scans for better edge detection", - "tip4": "Clean scanner glass to avoid dust spots being detected as photos", - "tip5": "For difficult images, try adjusting the tolerance and minimum area settings" + "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" } }, "sign": { diff --git a/frontend/src/components/tooltips/useScannerImageSplitTips.ts b/frontend/src/components/tooltips/useScannerImageSplitTips.ts index 9ccdf5b96..db11c2991 100644 --- a/frontend/src/components/tooltips/useScannerImageSplitTips.ts +++ b/frontend/src/components/tooltips/useScannerImageSplitTips.ts @@ -25,43 +25,23 @@ export const useScannerImageSplitTips = (): TooltipContent => { ] }, { - title: t('scannerImageSplit.tooltip.angleThresholdTerm', 'Angle Threshold (10°)'), - description: t('scannerImageSplit.tooltip.angleThresholdDef', - 'How much an image needs to be tilted before the tool tries to straighten it. Lower values detect smaller tilts.' - ) - }, - { - title: t('scannerImageSplit.tooltip.toleranceTerm', 'Tolerance (20)'), - description: t('scannerImageSplit.tooltip.toleranceDef', - 'How similar background colours need to be to be considered the same. Higher values group more varied colours together.' - ) - }, - { - title: t('scannerImageSplit.tooltip.minAreaTerm', 'Minimum Area (8000)'), - description: t('scannerImageSplit.tooltip.minAreaDef', - 'Smallest size (in pixels) for something to be considered a photo. Helps ignore small spots or artefacts.' - ) - }, - { - title: t('scannerImageSplit.tooltip.minContourAreaTerm', 'Minimum Contour Area (500)'), - description: t('scannerImageSplit.tooltip.minContourAreaDef', - 'Minimum edge detection size. Helps distinguish actual photo edges from noise or texture.' - ) - }, - { - title: t('scannerImageSplit.tooltip.borderSizeTerm', 'Border Size (1)'), - description: t('scannerImageSplit.tooltip.borderSizeDef', - 'Adds padding around detected photos to avoid cutting off edges. Increase if photos are getting cropped too tightly.' - ) - }, - { - title: t('scannerImageSplit.tooltip.tips', 'Tips for Best Results'), + title: t('scannerImageSplit.tooltip.problemSolving', 'Common Problems & Solutions'), bullets: [ - t('scannerImageSplit.tooltip.tip1', 'Ensure good contrast between photos and background'), - t('scannerImageSplit.tooltip.tip2', 'Place photos with some space between them on the scanner'), - t('scannerImageSplit.tooltip.tip3', 'Use higher resolution scans for better edge detection'), - t('scannerImageSplit.tooltip.tip4', 'Clean scanner glass to avoid dust spots being detected as photos'), - t('scannerImageSplit.tooltip.tip5', 'For difficult images, try adjusting the tolerance and minimum area settings') + 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') + ] + }, + { + title: t('scannerImageSplit.tooltip.tips', 'Setup Tips for Best Results'), + 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') ] } ]