Skip to content

Latest commit

 

History

History
65 lines (41 loc) · 2.3 KB

README.md

File metadata and controls

65 lines (41 loc) · 2.3 KB
Raw

JBarcode_1D (WIP)

A Java Reimplementation and Extension of iyyun/Barcode_1D

This project is a Java reimplementation and extension of @iyyun's Barcode_1D. It aims to replicate the original functionality as closely as possible while also providing additional features and a more user-friendly interface. The project can be used as a standalone CLI tool or integrated as a Maven library in other projects.

This repo is a work-in-progress and so is this readme file

Supported file formats

Any filetype that is supported by Imgcodecs.imread(String filepath) is supported.

According to the docs of OpenCV 4.9's maven package these are:

  • Windows bitmaps - *.bmp, *.dib (always supported)
  • JPEG files - *.jpeg, *.jpg, *.jpe
  • JPEG 2000 files - *.jp2
  • Portable Network Graphics - *.png
  • WebP - *.webp
  • AVIF - *.avif
  • Portable image format - *.pbm, *.pgm, *.ppm *.pxm, *.pnm (always supported)
  • PFM files - *.pfm
  • Sun rasters - *.sr, *.ras (always supported)
  • TIFF files - *.tiff, *.tif
  • OpenEXR Image files - *.exr
  • Radiance HDR - *.hdr, *.pic (always supported)
  • Raster and Vector geospatial data supported by GDAL

Requirements

  • Java 22 (Java 8 probably just works fine)
  • OpenCV 4.x or higher

Installation

WIP

Command Line Interface (CLI)

You can also use JBarcode_1D directly from the command line by running the JAR file.

Usage

CLI Usage

After building the project, you can run it via the command line using the following command:

java -jar target/JBarcode_1D-1.0-SNAPSHOT-jar-with-dependencies.jar --file <image_path> [--preview]

Command Line Options

  • --file <image_path> (or -f <image_path>): Specifies the path to the image file to be processed. This option is required.
  • --preview (or -p): Displays the image with detected rectangles drawn on it. This option is optional.
  • --help (or -h): Displays the help message, listing all available options.

Contribution

Contributions are welcome! If you find any issues or have suggestions for improvements, feel free to open an issue or submit a pull request.

License

This project is licensed under the Apache 2.0 License. See the LICENSE file for more details.