fastqr 1.0.1

data/examples/CMakeLists.txt

@@ -0,0 +1,7 @@
+add_executable(example_basic basic.cpp)
+target_link_libraries(example_basic PRIVATE fastqr)
+
+install(TARGETS example_basic
+    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}/examples
+)
+

data/examples/basic.cpp

@@ -0,0 +1,58 @@
+/*
+ * FastQR - Fast QR Code Generator Library
+ * Copyright (C) 2025 FastQR Project
+ */
+
+#include "fastqr.h"
+#include <iostream>
+
+int main() {
+    std::cout << "FastQR Basic Example\n\n";
+
+    // Basic usage
+    fastqr::QROptions options;
+    options.size = 400;
+
+    if (fastqr::generate("Hello, FastQR!", "basic_qr.png", options)) {
+        std::cout << "✓ Generated basic_qr.png\n";
+    }
+
+    // Colored QR code
+    options.foreground = {255, 0, 0};  // Red
+    options.background = {255, 255, 200};  // Light yellow
+
+    if (fastqr::generate("Colored QR Code", "colored_qr.png", options)) {
+        std::cout << "✓ Generated colored_qr.png\n";
+    }
+
+    // UTF-8 support - Vietnamese
+    if (fastqr::generate("Xin chào Việt Nam! 🇻🇳", "vietnamese_qr.png", options)) {
+        std::cout << "✓ Generated vietnamese_qr.png (Vietnamese text)\n";
+    }
+
+    // UTF-8 support - Japanese
+    options.foreground = {0, 0, 255};  // Blue
+    if (fastqr::generate("こんにちは日本", "japanese_qr.png", options)) {
+        std::cout << "✓ Generated japanese_qr.png (Japanese text)\n";
+    }
+
+    // High error correction
+    options.foreground = {0, 0, 0};
+    options.ec_level = fastqr::ErrorCorrectionLevel::HIGH;
+
+    if (fastqr::generate("High Error Correction", "high_ec_qr.png", options)) {
+        std::cout << "✓ Generated high_ec_qr.png (with HIGH error correction)\n";
+    }
+
+    // Large QR code
+    options.size = 2000;
+    options.ec_level = fastqr::ErrorCorrectionLevel::MEDIUM;
+
+    if (fastqr::generate("Large QR Code - 2000x2000px", "large_qr.png", options)) {
+        std::cout << "✓ Generated large_qr.png (2000x2000)\n";
+    }
+
+    std::cout << "\nAll examples completed successfully!\n";
+    return 0;
+}
+

data/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
+