Struct QrCodeGenerator 

pub struct QrCodeGenerator { /* private fields */ }

二维码生成器 — 对齐 PHP Endroid\QrCode\QrCode

持有 QrCodeConfig 配置，提供 PNG/SVG/矩阵三种输出方式。

PHP 对齐

// PHP endroid/qr-code
$qr = new QrCode('Hello');
$qr->setSize(200);
$qr->setMargin(10);
$qr->setErrorCorrectionLevel(new ErrorCorrectionLevel(ErrorCorrectionLevel::MEDIUM));
$png = $qr->writeString(); // 默认 PNG

Rust 用法

use sz_rust_core::qr_code::{QrCodeGenerator, QrCodeConfig, ErrorCorrectionLevel};

let config = QrCodeConfig::new()
    .with_size(200)
    .with_margin(10)
    .with_error_correction_level(ErrorCorrectionLevel::Medium);
let generator = QrCodeGenerator::with_config(config);
let png = generator.generate_png("Hello").unwrap();

Implementations

impl QrCodeGenerator

pub fn new() -> Self

创建默认配置的生成器

pub fn with_config(config: QrCodeConfig) -> Self

使用指定配置创建生成器

pub fn config(&self) -> &QrCodeConfig

获取配置引用

pub fn generate_matrix(&self, data: &str) -> Result<Vec<Vec<bool>>, QrCodeError>

生成原始矩阵 — 返回 bool 二维数组（true = 深色模块）

矩阵尺寸为 N × N（正方形），不包含边距。

参数

• data: 待编码的数据（不能为空）

返回

成功返回 Vec<Vec<bool>>，失败返回 QrCodeError。

pub fn generate_png(&self, data: &str) -> Result<Vec<u8>, QrCodeError>

生成 PNG 二进制

先生成原始矩阵，再用 image crate 渲染为 PNG。 像素级边距控制：size 为总尺寸（含边距），margin 为四周白边宽度。

参数

• data: 待编码的数据（不能为空）

返回

成功返回 PNG 字节流 Vec<u8>，失败返回 QrCodeError。

pub fn generate_svg(&self, data: &str) -> Result<String, QrCodeError>

生成 SVG 字符串

使用 qrcode crate 内置的 SVG 渲染器（qrcode::render::svg::Color）。 边距通过 quiet zone 控制（margin > 0 时启用）。

参数

• data: 待编码的数据（不能为空）

返回

成功返回 SVG 字符串，失败返回 QrCodeError。

Trait Implementations

impl Clone for QrCodeGenerator

fn clone(&self) -> QrCodeGenerator

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for QrCodeGenerator

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for QrCodeGenerator

fn default() -> Self

Returns the “default value” for a type.