DataJuggler.PlayingCards 10.1.3

.NET 10.0

dotnet add package DataJuggler.PlayingCards --version 10.1.3

NuGet\Install-Package DataJuggler.PlayingCards -Version 10.1.3

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="DataJuggler.PlayingCards" Version="10.1.3" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="DataJuggler.PlayingCards" Version="10.1.3" />
                    

                            Directory.Packages.props

<PackageReference Include="DataJuggler.PlayingCards" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add DataJuggler.PlayingCards --version 10.1.3

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: DataJuggler.PlayingCards, 10.1.3"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package DataJuggler.PlayingCards@10.1.3

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=DataJuggler.PlayingCards&version=10.1.3
                    

                            Install as a Cake Addin

#tool nuget:?package=DataJuggler.PlayingCards&version=10.1.3
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

DataJuggler.PlayingCards

A .NET playing card library that includes The Gilded Deck — a complete 52-card deck plus 4 card back images with a luxurious gilded aesthetic. Cards are 400 x 560 with a 2px transparent margin on each border.

Installation

Install via the .NET CLI:

dotnet add package DataJuggler.PlayingCards

Or search for DataJuggler.PlayingCards in Visual Studio's NuGet Package Manager.

Five Card Draw WinForms Example

// create a shuffler - 1 deck, shuffle 10 times
RandomShuffler shuffler = new RandomShuffler(1, 10);

// create a dealer
Dealer dealer = new Dealer(PlatformEnum.Windows, DeckEnum.TheGildedDeck, CardBackEnum.EmeraldLabyrinth);

// Shuffle the cards (already shuffled above, just showing an example)
dealer.Shuffle();

// iterate the cards
for (int x = 0; x < 5; x++)
{
    // get the next card
    Card card = shuffler.PullNextCard();

    // If the card object exists
    if (NullHelper.Exists(card))
    {
        // get the pictureBox
        PictureBox pictureBox = GetPictureBox(x);

        // If the pictureBox object exists
        if (NullHelper.Exists(pictureBox))
        {
            // stretch to fit
            pictureBox.SizeMode = PictureBoxSizeMode.StretchImage;

            // Set the image
            pictureBox.Image = card.Bitmap;
        }
    }
}

// Note The Constructor Now Loads a CardBack. If you do not need the CardBack, do not pass in a card back value
// in the constructor.
// You can check if a card back is set with
if (dealer.HasCardBack)
{
    // Get the CardBack Card
    Card cardBack = dealer.CardBack;

    // This card will contain
    string path = cardBack.Path             // Blazor Projeocts
    Bitmap bitmap = cardBack.Bitmap  // WinForms projects
}

// GetPictureBox just returns PictureBox1 - PictureBox5 for a Video Poker Sample I am working on.
// Card.Bitmap is set in Dealer.PullNextCard() method for WinForms

In a future release I will update the Card object to contain a CardBack Image and Path, but for now, just use the Dealer.CardBack.Bitmap or Dealer.CardBack.Path.

Blazor Example Coming Soon

Card.Path is set for Blazor projects. This will return something like:

// Set the imageUrl
this.Card1.ImageUrl = card.Path;

In the above example, Card1 is a DataJuggler.Blazor.Components.ImageComponent.

When you call Dealer.PullNextCard and the Platform equals PlatformEnum.Blazor, Card.Path is set by calling this method.

#region GetCardPath(Card card)
/// <summary>
/// returns the Card Path
/// </summary>
public string GetCardPath(Card card)
{
    // initial value
    string path = "";
    
    // If the card object exists
    if (NullHelper.Exists(card))
    {
        // set the path for Blazor using the _content/ convention
        path = $"_content/DataJuggler.PlayingCards/Decks/TheGildedDeck/{card.CardFullName}";
    }
    
    // return value
    return path;
}
#endregion

Card Full Name

Card Full Name is a read only property that return Card Name + Suit Name + ".png";

Example Card Full Names

TwoHearts.png JackSpades.png KingClubs.png AceDiamonds.png

Updates

6.17.2026: DataJuggler.Blazor.Components was updated, and a new CardObject was added to this library. DataJuggler.PlayingCards.Objects namespace. A CardInfo links a DataJuggler.RandomShuffler.Objects.Card with a DataJuggler.Blazor.Components.ImageButton.

6.15.2026: I fixed the CardBackPath for Blazor was missing a closing /

Major Update of all face cards, card backs and a new Joker was added.

6.14.2026: The first face cards were too gold. Gold background, gold uniform etc. I changed the face cards to have a light blue background and added a little more color to the wardrobes of the face cards. The Card Baks were also updated and all the CardEnums that worked before are now broken. The new card backs are better to me. Let me know what you think. Also by request a Joker was created.

The Dealer has a new method, LoadJoker

// Load the Joker card image
card joker = Dealer.LoadJoker();

The Joker image will be loaded if jokersCount is greater than zero in the constructor (jokersCount is an optional parameter).

The Card object has a new property 'IsJoker'.

Breaking Change

Now is the time to break stuff since this project is new. The constructor for the Card object is now Card first, Suit next. The reason is the cards are called AceClubs.png (example) and this aligns wiht that.

The constructor for a Dealer now accepts an optional jokersCount parameter to create jokers as part of your deck. Use card.IsJoker to determine if this is a joker.

6.9.2026: I added an image called GreenFelt.png. This can be used for a game table for various games.

path = $"_content/DataJuggler.PlayingCards/GreenFelt.png";

6.5.2026: Card now has sa property caled Exposted, and PullNextCard accepts an optional parameter for exposed which defaults to true. Also Dealer.Shuffle has two optional parameters: shuffles - number of times to shuffle. Default value is 5 exposed - default value is false. this sets all the cards pulled to card.Exposted = false;

6.1.2026: PixelDatabase was updated and this udpates RandomShuffler. This fixes a bug where Card Full Name was not including the extension .png.

5.31.2026: I fixed the Dealer class. It now works for WinFroms. I will finish the WInForms sample and build a Blazor sample as soon as I get some time.

I also added an enum called CardBackEnum and a method to the Dealer class called LoadCardBack. This method returns a Card that has Card.Bitmap set for WinForms or Card.Path set for Blazor projects.

The Gilded Deck

This NuGet package uses a deck of cards I created called The Gilded Deck. I am copying the read me from here so you can see the card previews.

Please enjoy these cards — I worked really hard to create them.

This is a complete 52-card deck plus 4 card back images with a luxurious gilded aesthetic. Each card is 400 x 560 and has a 2 px transparent margin on each border.

Download Instructions

To download all cards:

Click the green Code button at the top of this page, then select Download ZIP.

Please Leave A Star!

If you find these images worth the price.

Card Previews

Aces

Twos

Threes

Fours

Fives

Sixes

Sevens

Eights

Nines

Tens

Jacks

Queens

Kings

Card Backs

By Request - A Joker Was Created

How These Card Images Were Made

Most of the images were generated with ChatGPT Images 2 in Comfy UI. While the AI produced beautiful base artwork, it created inconsistencies across the deck — varying fonts, symbol sizes, and positions.

To bring everything together into a cohesive style, I used my own tools:

DataJuggler.PixelDatabase — my NuGet package for pixel-level image manipulation. For this project I added new features including drawing text upside down and rotating images. I also wrote FindFirstVisiblePixel() and FindFirstNonWhitePixel() specifically to handle the deck's needs.
Isolator — another new open-source project of mine that makes it easy to isolate objects from transparent backgrounds.

Grok (from xAI) helped me build a Marching Ants selector tool that simplified isolating and refining the images. ** Claude ** also helped with some graphics programming help. Most of the credit goes to ** CHatGPT Images 2 ** in ** Comfy UI **

I spent about $10 on Comfy UI credits to generate high-quality face cards and card backs.

These images are completely free to use in any project — commercial or personal. No attribution required, though it's always appreciated.

If you like the deck, please leave a star on this repo and drop a link if you use the cards in your own work. It helps more people discover the project!

Thanks for stopping by — I hope The Gilded Deck brings some elegance to your games, projects, or collections.

Corby / Data Juggler

Product	Compatible and additional computed target framework versions.
.NET	net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- DataJuggler.Blazor.Components (>= 10.1.3)
- DataJuggler.PixelDatabase (>= 10.2.16)
- Microsoft.AspNetCore.Components.Web (>= 10.0.9)

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
10.1.3	0	6/17/2026
1.1.1	54	6/15/2026
1.1.0	50	6/15/2026
1.0.10	101	6/9/2026
1.0.9	100	6/9/2026
1.0.8	95	6/5/2026
1.0.7	109	6/1/2026
1.0.6	92	5/31/2026
1.0.5	103	5/31/2026
1.0.4	100	5/31/2026