Mirrors/Stirling-PDF
Mirrors/Stirling-PDF
1
0
Fork 0
mirror of https://github.com/Frooodle/Stirling-PDF.git synced 2025-09-26 17:52:59 +02:00
Code Issues Packages Projects Releases Wiki Activity

Replace abstract tooltip explanations with practical troubleshooting guide

Browse Source 
- 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 <noreply@anthropic.com>
This commit is contained in:
Anthony Stirling 2025-09-25 23:44:20 +01:00
parent d6a3774e9b
commit 5d828040a7
2 changed files with 28 additions and 53 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
frontend/public/locales/en-GB/translation.json
View File

@ -1685,23 +1685,18 @@
"useCase2": "Splitting collages or composite images into individual photos", "useCase2": "Splitting collages or composite images into individual photos",
"useCase3": "Digitising photo albums by scanning entire pages then extracting individual photos", "useCase3": "Digitising photo albums by scanning entire pages then extracting individual photos",
"useCase4": "Processing documents with embedded photos or images", "useCase4": "Processing documents with embedded photos or images",
"settingsExplained": "Settings Explained:", "problemSolving": "Common Problems & Solutions",
"angleThresholdTerm": "Angle Threshold (10°)", "problem1": "Photos not detected → Try increasing \"Tolerance\" to 30-50",
"angleThresholdDef": "How much an image needs to be tilted before the tool tries to straighten it. Lower values detect smaller tilts.", "problem2": "Too many false detections → Increase \"Minimum Area\" to 15000-20000",
"toleranceTerm": "Tolerance (20)", "problem3": "Photos cropped too tight → Increase \"Border Size\" to 5-10",
"toleranceDef": "How similar background colours need to be to be considered the same. Higher values group more varied colours together.", "problem4": "Tilted photos not straightened → Lower \"Angle Threshold\" to 5",
"minAreaTerm": "Minimum Area (8000)", "problem5": "Detecting dust/noise → Increase \"Minimum Contour Area\" to 1000",
"minAreaDef": "Smallest size (in pixels) for something to be considered a photo. Helps ignore small spots or artefacts.", "tips": "Setup Tips for Best Results",
"minContourAreaTerm": "Minimum Contour Area (500)", "tip1": "Use white or light background behind photos",
"minContourAreaDef": "Minimum edge detection size. Helps distinguish actual photo edges from noise or texture.", "tip2": "Leave at least 1cm gap between photos",
"borderSizeTerm": "Border Size (1)", "tip3": "Scan at 300+ DPI for better detection",
"borderSizeDef": "Adds padding around detected photos to avoid cutting off edges. Increase if photos are getting cropped too tightly.", "tip4": "Clean scanner glass to avoid dust being detected as photos",
"tips": "Tips for Best Results:", "tip5": "If it fails, try the default settings first before adjusting"
"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"
} }
}, },
"sign": { "sign": {

52
frontend/src/components/tooltips/useScannerImageSplitTips.ts
View File

@ -25,43 +25,23 @@ export const useScannerImageSplitTips = (): TooltipContent => {
] ]
}, },
{ {
title: t('scannerImageSplit.tooltip.angleThresholdTerm', 'Angle Threshold (10°)'), title: t('scannerImageSplit.tooltip.problemSolving', 'Common Problems & Solutions'),
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'),
bullets: [ bullets: [
t('scannerImageSplit.tooltip.tip1', 'Ensure good contrast between photos and background'), t('scannerImageSplit.tooltip.problem1', 'Photos not detected → Try increasing "Tolerance" to 30-50'),
t('scannerImageSplit.tooltip.tip2', 'Place photos with some space between them on the scanner'), t('scannerImageSplit.tooltip.problem2', 'Too many false detections → Increase "Minimum Area" to 15000-20000'),
t('scannerImageSplit.tooltip.tip3', 'Use higher resolution scans for better edge detection'), t('scannerImageSplit.tooltip.problem3', 'Photos cropped too tight → Increase "Border Size" to 5-10'),
t('scannerImageSplit.tooltip.tip4', 'Clean scanner glass to avoid dust spots being detected as photos'), t('scannerImageSplit.tooltip.problem4', 'Tilted photos not straightened → Lower "Angle Threshold" to 5'),
t('scannerImageSplit.tooltip.tip5', 'For difficult images, try adjusting the tolerance and minimum area settings') 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')
] ]
} }
] ]