.

TestImages/README.md

@@ -0,0 +1,151 @@
+# Test Images
+
+This directory contains **225 reference images** for testing card recognition algorithms without requiring actual hardware.
+
+## Directory Structure
+
+| Category | Count | Description |
+|----------|-------|-------------|
+| `reference_alpha/` | 47 | Alpha edition reference cards (old frame) |
+| `varying_quality/` | 38 | Different lighting, blur, exposure, angles |
+| `single_cards/` | 19 | Individual card photos |
+| `real_photos/` | 18 | Phone camera photos from Visions project |
+| `foreign/` | 16 | Non-English cards (Japanese, German, French, etc.) |
+| `worn/` | 15 | Heavily played, damaged, worn cards |
+| `foil/` | 14 | Foil cards with holographic glare/reflections |
+| `low_light/` | 14 | Poor lighting, glare, shadows, amateur photos |
+| `tokens/` | 13 | Tokens and planeswalker emblems |
+| `hands/` | 11 | Cards held in hand (partial visibility) |
+| `ocr_test/` | 10 | Images optimized for OCR testing |
+| `reference/` | 9 | High-quality reference scans |
+| `multiple_cards/` | 6 | Multiple cards in frame |
+| `augmented/` | 4 | Augmented training examples |
+| `training_examples/` | 3 | ML training set samples |
+| `angled/` | 2 | Perspective distortion |
+
+## Image Sources
+
+Images from open-source MIT-licensed projects:
+
+- [hj3yoo/mtg_card_detector](https://github.com/hj3yoo/mtg_card_detector)
+- [tmikonen/magic_card_detector](https://github.com/tmikonen/magic_card_detector)
+- [fortierq/mtgscan](https://github.com/fortierq/mtgscan)
+- [LauriHursti/visions](https://github.com/LauriHursti/visions)
+- [KLuml/CardScanner](https://github.com/KLuml/CardScanner)
+- [dills122/MTG-Card-Analyzer](https://github.com/dills122/MTG-Card-Analyzer)
+- [ryanlin/Turtle](https://github.com/ryanlin/Turtle)
+
+Additional images from:
+- Reddit r/magicTCG (user-submitted photos)
+- Flickr (Creative Commons)
+- Card Kingdom / Face to Face Games grading guides
+- Scryfall (foreign language card scans)
+
+## Usage
+
+```csharp
+[Theory]
+[InlineData("varying_quality/test1.jpg")]
+[InlineData("angled/tilted_card_1.jpg")]
+[InlineData("hands/hand_of_card_1.png")]
+[InlineData("foil/rainbow_foil_secret_lair.jpg")]
+[InlineData("worn/hp_shuffle_crease.webp")]
+[InlineData("foreign/japanese_aang.jpg")]
+public async Task RecognizeCard_VaryingConditions(string imagePath)
+{
+    using var stream = File.OpenRead(Path.Combine("TestImages", imagePath));
+    var result = await _recognitionService.RecognizeCardAsync(stream);
+    
+    Assert.True(result.Success);
+    Assert.NotNull(result.Card);
+    Assert.True(result.Confidence >= 0.7f);
+}
+```
+
+## Category Details
+
+### foil/
+Foil cards showing holographic effects that challenge recognition:
+- Rainbow foils with color-shifting (`rainbow_foil_secret_lair.jpg`)
+- Surge foils with holo stickers (`surge_foils_holo.jpeg`)
+- Old-style foils (`old_foil_yawgmoth.jpg`)
+- Textured/dragonscale foils (`dragonscale_foil.jpg`)
+- Foil curling examples showing warping
+
+### worn/
+Heavily played and damaged cards:
+- Edge whitening (`edge_white.png`, `very_good_*.jpg`)
+- Scratches and scuffs (`scratch.png`, `hp_scratches.png`)
+- Creases and bends (`hp_shuffle_crease.webp`, `bent_creased.jpg`)
+- Binder damage (`hp_binder_bite_*.webp`)
+- Water damage (`hp_water_warping.png`)
+- Corner damage (`hp_compromised_corner.webp`)
+
+### low_light/
+Poor lighting and amateur photography conditions:
+- Glare from toploaders/sleeves (`glare_toploader.png`)
+- Direct light causing hotspots (`glare_straight_down.jpg`)
+- Depth of field blur (`dof_blur_amateur.jpg`)
+- Amateur condition photos with shadows
+- Flickr collection shots with mixed lighting
+
+### foreign/
+Non-English cards (8 languages):
+- Japanese (日本語)
+- German (Deutsch)
+- French (Français)
+- Italian (Italiano)
+- Spanish (Español)
+- Russian (Русский)
+- Simplified Chinese (简体中文)
+- Korean (한국어)
+
+### tokens/
+Tokens and planeswalker emblems:
+- Official WotC tokens
+- Custom/altered tokens
+- Planeswalker emblems (Elspeth, Gideon, Narset)
+- Token collections and gameplay shots
+
+### varying_quality/
+Images with various real-world challenges:
+- Different camera exposures
+- BGS graded cases (`counterspell_bgs.jpg`)
+- Cards in plastic sleeves (`card_in_plastic_case.jpg`)
+- Various lighting conditions
+- 28 numbered test images (`test1.jpg` - `test27.jpg`)
+
+### reference_alpha/
+47 Limited Edition Alpha cards for old-frame recognition:
+- Power Nine (Black Lotus, Ancestral Recall, Moxen, etc.)
+- Dual lands (Underground Sea, Volcanic Island, etc.)
+- Classic staples (Lightning Bolt, Counterspell, Sol Ring)
+
+### hands/
+Cards held in hand - partial visibility, stacked:
+- Various deck archetypes (Tron, Green, Red)
+- New and old frame cards
+- Different lighting conditions
+
+### real_photos/
+Phone camera photos from Visions project:
+- Real-world scanning conditions
+- Various resolutions and crops
+- Includes processed result images
+
+### ocr_test/
+From CardScanner project, graded by difficulty:
+- `card0-4.jpg`: Easier recognition
+- `card10-13.jpg`: Harder recognition (noted ~less accuracy)
+
+## TODO: Additional Categories Needed
+
+- [ ] **double_faced/** - Transform/MDFC cards (both sides)
+- [ ] **art_cards/** - Art series cards without text boxes
+- [ ] **promos/** - Extended art, borderless, showcase frames
+- [ ] **very_low_light/** - Near-dark conditions
+- [ ] **motion_blur/** - Cards in motion during scanning
+
+## License
+
+Card artwork is property of Wizards of the Coast. Images used for testing/research purposes only.