fastqr 1.0.1 → 1.0.4

data/bindings/ruby/prebuilt/macos-x86_64/include/fastqr.h

@@ -0,0 +1,97 @@
+/*
+ * FastQR - Fast QR Code Generator Library
+ * Copyright (C) 2025 FastQR Project
+ *
+ * This library 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 2.1 of the License, or (at your option) any later version.
+ *
+ * This library 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
+ * Lesser General Public License for more details.
+ */
+
+#ifndef FASTQR_H
+#define FASTQR_H
+
+#include <string>
+#include <cstdint>
+
+namespace fastqr {
+
+/**
+ * QR Code error correction level
+ */
+enum class ErrorCorrectionLevel {
+    LOW,        // Level L - ~7% correction
+    MEDIUM,     // Level M - ~15% correction
+    QUARTILE,   // Level Q - ~25% correction
+    HIGH        // Level H - ~30% correction
+};
+
+/**
+ * Options for QR code generation
+ */
+struct QROptions {
+    // Output image size (QR codes are square)
+    int size = 300;
+
+    // Optimize size - round up to nearest integer multiple for best performance
+    bool optimize_size = false;
+
+    // QR code colors (RGB)
+    struct Color {
+        uint8_t r = 0;
+        uint8_t g = 0;
+        uint8_t b = 0;
+    };
+
+    Color foreground = {0, 0, 0};      // QR code color (default: black)
+    Color background = {255, 255, 255}; // Background color (default: white)
+
+    // Error correction level
+    ErrorCorrectionLevel ec_level = ErrorCorrectionLevel::MEDIUM;
+
+    // Logo options
+    std::string logo_path = "";         // Path to logo image
+    int logo_size_percent = 20;         // Logo size as percentage of QR code (default: 20%)
+
+    // Output format
+    std::string format = "png";         // png, jpg, webp, etc.
+    int quality = 95;                   // For lossy formats (1-100)
+};
+
+/**
+ * Generate QR code and save to file
+ *
+ * @param data The data to encode (supports UTF-8)
+ * @param output_path Path to save the generated QR code image
+ * @param options QR code generation options
+ * @return true if successful, false otherwise
+ */
+bool generate(const std::string& data, const std::string& output_path, const QROptions& options = QROptions());
+
+/**
+ * Generate QR code and return image data as buffer
+ *
+ * @param data The data to encode (supports UTF-8)
+ * @param buffer Output buffer for image data
+ * @param buffer_size Size of the output buffer
+ * @param options QR code generation options
+ * @return Size of image data written to buffer, or -1 on error
+ */
+int generate_to_buffer(const std::string& data, void* buffer, size_t buffer_size, const QROptions& options = QROptions());
+
+/**
+ * Get library version
+ *
+ * @return Version string (e.g., "1.0.0")
+ */
+const char* version();
+
+} // namespace fastqr
+
+#endif // FASTQR_H
+