5.3 KiB
5.3 KiB
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
- tmikonen/magic_card_detector
- fortierq/mtgscan
- LauriHursti/visions
- KLuml/CardScanner
- dills122/MTG-Card-Analyzer
- 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
[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 recognitioncard10-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.