tannerhelland / pd2d Goto Github PK

pd2D is a zero-dependency, class-based wrapper for GDI+ (with some GDI and custom functionality mixed in). It allows you to use advanced 2D graphics features without worrying about memory management, leaks, or GDI+'s many annoying quirks.

pd2D is currently in beta.

The bulk of the library's API should be stable, but small changes are possible between now and a 1.0 release. The library's rendering code is stable and leak-free.

Feedback is welcome, particularly regarding the library's design. Its API was originally designed to solve problems specific to my own projects, and I am happy to generalize it for more widespread use.

pd2D is derived from the open-source PhotoDemon photo editor (https://github.com/tannerhelland/PhotoDemon). Like its parent project, pd2D is available under a liberal BSD license. This license allows you to use the library in any project, commercial or otherwise. (Please see the LICENSE.MD file for specific details, including disclaimer of warranty.)

You are also free to fork this library and/or make your own modifications. Pull requests are also welcome.

The library's default backend leans on standard libraries available all the way back to Windows XP. Windows XP through the latest Windows 11 builds are considered "fully supported."

Unlike a bare type library, pd2D manages things like memory allocations and handle disposal for you. If you know how to use VB6 classes, you know everything you need to use pd2D.

Wherever possible, pd2D leans on hardware-accelerated rendering. Performance is best under Windows 10, but some measure of hardware acceleration is available all the way back to Windows XP.

pd2D is maintained by a single individual with a family to support. The software is provided free-of-charge under a permissive open-source license, and no fees will ever be charged for its use.

That said, donations go a long way toward supporting its development. If you would like to donate and support development, you can donate through pd2D's parent project website:

http://photodemon.org/donate/

If you can't contribute monetarily, here are some other ways to help:

• Let me know if you find any bugs. Issues can be submitted via pd2D's official bug tracker: https://github.com/tannerhelland/pd2D/issues
• Pull requests (for bug-fixes, new features, new backends, documentation - anything!) are always welcome.
• Do you wish pd2D behaved differently? Do you want it to offer a particular feature? Let me know! Suggestions and feedback are always welcome, and they can be submitted through the same bug tracker: https://github.com/tannerhelland/pd2D/issues

This repository is divided into two parts: the bare pd2D source (available in the /pd2D folder), and various sample projects (available in the /samples folder). Start with the sample project that interests you most. They are all thoroughly commented.