• About this project
• How to use
• Bad Performance (Workaround)
• Contribute
• License

This library is a Kotlin wrapper around the native JAB Code library implementation (to be found at jabcode/jabcode).
It utilizes the JNI (Java Native Interface) and some lines of custom C code to communicate with the native implementation.

But what's a JAB Code?

JAB Code (Just Another Bar Code) is a high-capacity 2D color bar code, which can encode more data than traditional black/white codes. This repository contains a library for reading and writing JAB codes, along with sample applications. A demo webinterface is available at https://jabcode.org.

If you think it's worth to support this project, feel free to give a small donation ❤️.

• 🔗 easy to integrate
• 🏋️‍♂️ lightweight library
• 📦 wrapper around orignal native code (no modifications) -> easy to update native library

Create a JabCodeLib object (which initializes the native library behind the scenes).

val jabCodeLib: JabCodeLib = JabCodeLib()

Call the detect(imagePath: String) function with a valid absolute file path of the image you want to scan.

val result: ByteArray? = jabCodeLib.detect(file.absolutePath)

(Short form for single call):

val result: ByteArray? = JabCodeLib().detect(file.absolutePath)

There you have the content of the code, or null if nothing was found.
If you for example saved a string in your JAB Code, you can now read it with

val string = result.decodeToString()

Unfortunately the current implementation has a very bad performance due to a workaround.
I couldn't figure out yet how to pass the image bytes directly to the native library.
Currently the logic looks like this:

Ideally the implementation could rather look like this for best performance:

Icon Credits

Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com
License - https://fontawesome.com/license/free
Copyright 2024 Fonticons, Inc.

Of course, I'm happy about any kind of contribution.

For creating issues there's no real guideline you should follow. If you create pull requests please try to use the syntax I use. Using a unified code format makes it much easier for me and for everyone else.

Copyright (C) 2024 Cyb3rKo

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option) any
later version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU General Lesser Public License for more
details.

A copy of the GNU Lesser General Public License can be found alongside this
library's source code. Alternatively, see at <http:https://www.gnu.org/licenses/>.