scry/TestImages/README.md
Chris Kruining 0801ceee6a
.
2026-02-05 09:41:07 +01:00

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:

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 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.