# 条码特效参数参考
本文档详细说明所有预留的特效参数及其兼容性要求。
## 已实现特效
### 1. 边距特效 ✅
- `margin`: 统一边距
- `margin_top`, `margin_bottom`, `margin_left`, `margin_right`: 分别设置各边距
### 2. 颜色特效 ✅
- `foreground_color`: 前景色（支持 `#RRGGBB` 和 `#RRGGBBAA` 格式）
- `background_color`: 背景色（支持 `#RRGGBB`、`#RRGGBBAA` 或 `"transparent"`）
- `transparent`: 透明背景标志
- `opacity`: 整体透明度（0.0-1.0）
## 预留特效参数
### 3. 颜色/渐变特效
**参数**:
```json
{
"gradient_type": "linear", // "none", "linear", "radial", "rainbow"
"gradient_colors": ["#FF0000", "#00FF00", "#0000FF"],
"gradient_direction": "horizontal", // "horizontal", "vertical", "diagonal"
"gradient_angle": 45.0
}
```
**视觉效果**: 颜色从中心向外或沿对角线平滑过渡
**兼容性要点**:
- 保持足够对比度（≥30%）
- 建议使用高纠错等级（H）
- 渐变不应影响条码的可读性
### 4. Logo/图标特效
**参数**:
```json
{
"logo_path": "C:\\\\logo.png",
"logo_size": 0.15, // 0.0-1.0，建议 ≤0.15
"logo_position": "center",
"logo_margin": 10 // 像素
}
```
**视觉效果**: 在二维码中心留出空白区，放置品牌标识
**兼容性要点**:
- Logo 区域不超过二维码面积的 15%
- 周围保持足够的白边（建议 ≥2 个模块宽度）
- Logo 不应遮挡关键定位点
### 5. 圆角/圆形模块特效
**参数**:
```json
{
"module_shape": "circle", // "square", "circle", "ellipse", "star"
"module_radius": 2.0, // 仅当 module_shape="square" 时有效
"module_spacing": 1 // 像素，建议 1-2px
}
```
**视觉效果**: 软化硬边，使二维码更具设计感
**兼容性要点**:
- 模块间距需保留 1-2px，防止相邻圆形融合导致识别错误
- 圆角半径不应超过模块尺寸的 30%
### 6. 波纹/液体特效
**参数**:
```json
{
"wave_enabled": true,
"wave_amplitude": 0.15, // ≤0.2（相对于模块尺寸）
"wave_frequency": 1.0,
"wave_type": "sine" // "sine", "noise", "liquid"
}
```
**视觉效果**: 产生水波、液体流动的动态感
**兼容性要点**:
- 采用高纠错（H）
- 控制位移幅度 ≤ 模块尺寸的 20%
- 波纹不应破坏模块的连续性
### 7. 渐变阴影/投影特效
**参数**:
```json
{
"shadow_enabled": true,
"shadow_offset_x": 2,
"shadow_offset_y": 2,
"shadow_blur": 3,
"shadow_color": "#000000",
"shadow_opacity": 0.5
}
```
**视觉效果**: 产生浮雕或悬浮感
**兼容性要点**:
- 阴影不遮挡模块核心
- 保持对比度
- 阴影偏移不应过大（建议 ≤3px）
### 8. 背景图案特效
**参数**:
```json
{
"background_pattern": "image", // "none", "texture", "image", "gradient"
"background_image": "C:\\\\bg.png",
"background_opacity": 0.25 // ≤0.3
}
```
**视觉效果**: 背景与前景融合，提升美感
**兼容性要点**:
- 背景透明度 ≤ 30%
- 前景仍为深色（保持高对比度）
- 背景图案不应干扰条码识别
### 9. 动画/帧序列特效
**参数**:
```json
{
"animation_enabled": true,
"animation_frames": 10, // ≤30
"animation_type": "color_change" // "color_change", "blink", "fade"
}
```
**视觉效果**: 动态展示品牌故事或促销信息
**兼容性要点**:
- 每帧均需保持可识别的二维码结构
- 建议帧数 ≤ 30
- 单帧纠错等级不低于 Q
- 动画变化不应破坏条码结构
### 10. 3D/立体特效
**参数**:
```json
{
"perspective_enabled": true,
"perspective_angle": 15.0, // 度
"perspective_depth": 0.1
}
```
**视觉效果**: 让二维码呈现立体感
**兼容性要点**:
- 仍需在正视角保持标准矩阵
- 避免过度扭曲（角度 ≤20°）
- 保持模块的可识别性
### 11. 形状裁剪特效
**参数**:
```json
{
"shape_clip": "circle", // "none", "circle", "heart", "star"
"shape_margin": 20 // 像素
}
```
**视觉效果**: 与品牌形象匹配
**兼容性要点**:
- 裁剪区域外保留足够白边（建议 ≥20px）
- 内部模块不被裁剪掉
- 保持定位点的完整性
### 12. 纹理填充特效
**参数**:
```json
{
"texture_enabled": true,
"texture_type": "wood", // "wood", "metal", "fabric", "custom"
"texture_path": "C:\\\\texture.png"
}
```
**视觉效果**: 赋予质感
**兼容性要点**:
- 纹理对比度要高
- 避免细节干扰模块识别
- 建议使用高纠错等级（H）
### 13. 光栅/点阵特效
**参数**:
```json
{
"raster_enabled": true,
"raster_type": "dot", // "dot", "pixel", "star"
"raster_spacing": 2 // 像素
}
```
**视觉效果**: 复古或科技感
**兼容性要点**:
- 点间距要均匀
- 整体密度保持在标准二维码密度范围内
- 点的大小不应过小（建议 ≥2px）
## 特效组合建议
### 安全组合
- 边距 + 颜色 + Logo（推荐）
- 边距 + 颜色 + 圆角模块
- 边距 + 颜色 + 阴影
### 谨慎组合
- 渐变 + 波纹（需要高纠错）
- Logo + 圆角模块（需要足够的边距）
- 背景图案 + 渐变（需要保持对比度）
### 不推荐组合
- 波纹 + 3D（过度扭曲）
- 动画 + 3D（复杂度太高）
- 形状裁剪 + 波纹（可能破坏结构）
## 错误纠正等级建议
| 特效类型 | 推荐纠错等级 | 说明 |
|---------|------------|------|
| 基础（边距/颜色） | M | 标准纠错 |
| Logo | H | 需要高纠错 |
| 渐变 | H | 保持对比度 |
| 波纹 | H | 位移可能影响识别 |
| 圆角模块 | Q | 中等纠错 |
| 阴影 | M | 标准纠错 |
| 背景图案 | H | 需要高对比度 |
| 动画 | Q-H | 根据帧数调整 |
| 3D | H | 扭曲需要纠错 |
| 形状裁剪 | H | 裁剪需要纠错 |
| 纹理 | H | 细节需要纠错 |
| 光栅 | M-Q | 根据密度调整 |
Copyright © 2025- vba.vip All Rights Reserved.