card-io / card.io-dmz

The core image-processing and machine-learning code for card.io, which is shared between iOS and Android.
Other
141 stars 116 forks source link

card.io logo

card.io-dmz is intended to be used as a submodule of the main card.io SDK, card.io-iOS-source or card.io-Android-source.

The card.io-dmz submodule includes the core, client-side image processing code which is shared between iOS and Android.

As with the main card.io source repos, this repo does not yet contain is much in the way of documentation. :crying_cat_face: So please feel free to ask any questions by creating github issues -- we'll gradually build our documentation based on the discussions there.

Note that this is actual production code, which has been iterated upon by multiple developers over several years. If you see something that could benefit from being tidied up, rewritten, or otherwise improved, your Pull Requests will be welcome! See CONTRIBUTING.md for details.

Brought to you by
PayPal logo

Why "dmz?"

dmz stands for "demilitarized zone" -- code that is not platform-specific to iOS, Android, nor any other OS.

Some platform specific code did sneak in, but you'll note that it is in files called mz. :smile_cat: A dmz_context structure allows each platform to associate its specific data as needed.

Documentation

The dmz code contains many helpful comments, and variable and function names are usually meaningful, but otherwise we have not prepared much in the way of documentation.

A very informative resource is this talk that Josh Bleecher Snyder gave in 2015. He provides a fairly detailed overview of the steps followed by the card.io pipeline, and the thinking behind them.

There are also some useful documents in the docs folder.

Some notes on writing dmz code

If you're a client of the dmz, you should only ever compile dmz_all.cpp. You should run fab concat before every build.

Contributors

card.io was created by Josh Bleecher Snyder.

Subsequent help has come from Brent Fitzgerald, Tom Whipple, Dave Goldman, and Roman Punskyy.

And from you! Pull requests and new issues are welcome. See CONTRIBUTING.md for details.