## 使用指南
### 1. 二维码识别
```swift
EFQRCode.recognize(image: UIImage)
```
或
```swift
EFQRCodeRecognizer(image: image).contents
```
以上两种写法是完全相等的，因为传入的图片中可能包好多个二维码，所以返回值为 `[String]?`，若返回 nil 则表示传入数据有误或为空，若返回数组为空则表示图片上未识别到二维码。
### 2. 二维码生成
```swift
EFQRCode.generate(
content: String,
inputCorrectionLevel: EFInputCorrectionLevel,
size: CGFloat,
magnification: UInt?,
backgroundColor: UIColor,
foregroundColor: UIColor,
icon: UIImage?,
iconSize: CGFloat?,
isIconColorful: Bool,
watermark: UIImage?,
watermarkMode: EFWatermarkMode,
isWatermarkColorful: Bool
)
```
或
```swift
EFQRCodeGenerator(
content: content,
inputCorrectionLevel: inputCorrectionLevel,
size: size,
magnification: magnification,
backgroundColor: backgroundColor,
foregroundColor: foregroundColor,
icon: icon,
iconSize: iconSize,
isIconColorful: isIconColorful,
watermark: watermark,
watermarkMode: watermarkMode,
isWatermarkColorful: isWatermarkColorful
).image
```
以上两种写法是完全相等的，返回值为 `UIImage?`，若返回 nil 则表示生成失败。
若需要使用额外参数，则必须使用创建 EFQRCodeGenerator 对象的方式：
```swift
let generator = EFQRCodeGenerator(
content: content,
inputCorrectionLevel: inputCorrectionLevel,
size: size,
magnification: magnification,
backgroundColor: backColor,
foregroundColor: frontColor,
icon: icon,
iconSize: iconSize,
isIconColorful: iconColorful,
watermark: watermark,
watermarkMode: watermarkMode,
isWatermarkColorful: watermarkColorful
)
generator.foregroundPointOffset = self.foregroundPointOffset
generator.allowTransparent = self.allowTransparent
// 最终生成的二维码
generator.image
```
参数比较：
* **content: String?**
二维码内容，必填，有容量限制，最大为 424 个汉字（或 1273 个英文字母），二维码点阵越密集程度随内容增加而提高。不同容量对比如下：
10 个字母 | 250 个字母
:-------------------------:|:-------------------------:
|
* **inputCorrectionLevel: EFInputCorrectionLevel**
容错率，可选值，有四个等级，L：7%／M 15%／Q 25%／H 30%，默认值为最高容错等级 H，枚举类型 EFInputCorrectionLevel 定义如下：
```swift
// EFInputCorrectionLevel
public enum EFInputCorrectionLevel: Int {
case l = 0; // L 7%
case m = 1; // M 15%
case q = 2; // Q 25%
case h = 3; // H 30%
}
```
同一内容不同容错率对比如下：
L | M | Q | H
:-------------------------:|:-------------------------:|:-------------------------:|:-------------------------:
|||
* **size: CGFloat**
生成的二维码边长，可选值，默认为 256（PS：如果 magnification 不为空，将会忽略 size 参数）。
* **magnification: UInt?**
放大倍数，可选值，默认为 nil。
因为按照 size 缩放二维码存在清晰度不高的问题，如果希望得到比较清晰的二维码，可以使用 magnification 来设定最终生成的二维码大小。这里的倍数是相对于最小的二维码点阵而言的，如果已有一个想要的 size 但是希望通过使用 magnification 获得一个清晰且大小和自己所要 size 近似的二维码，可以通过 `maxMagnificationLessThanOrEqualTo(size: CGFloat)` 和 `minMagnificationGreaterThanOrEqualTo(size: CGFloat)` 这两个函数来获得想要的 magnification 具体值，具体使用方法如下：
```swift
let generator = EFQRCodeGenerator(
content: content,
inputCorrectionLevel: inputCorrectionLevel,
size: size,
magnification: magnification,
backgroundColor: backColor,
foregroundColor: frontColor,
icon: icon,
iconSize: iconSize,
isIconColorful: iconColorful,
watermark: watermark,
watermarkMode: watermarkMode,
isWatermarkColorful: watermarkColorful
)
// 希望获得最终 size 小于等于 600 的最大倍率
generator.magnification = generator.maxMagnificationLessThanOrEqualTo(size: 600)
// 或
// 希望获得最终 size 大于等于 600 的最小倍率
// generator.magnification = generator.minMagnificationGreaterThanOrEqualTo(size: 600)
// 最终生成的二维码
generator.image
```
size 300 | magnification 9
:-------------------------:|:-------------------------:
|
* **backgroundColor: UIColor**
背景色，可选值，默认为白色。
* **foregroundColor: UIColor**
前景色，可选值，二维码码点的颜色，默认为黑色。
前景设为红色 | 背景设为灰色
:-------------------------:|:-------------------------:
|
* **icon: UIImage?**
二维码中心图标，可选值，默认为空。
* **iconSize: CGFloat?**
二维码中心图标变长，可选值，默认为最终二维码边长的 20%，这里设为 64，可以和上一个二维码对比：
外边长的 20% | 设为固定值
:-------------------------:|:-------------------------:
|
* **isIconColorful: Bool**
二维码中心图标是否为彩色，可选值，默认为彩色。
* **watermark: UIImage?**
水印图，可选值，默认为 nil，示例如下：
1 | 2
:-------------------------:|:-------------------------:
|
* **watermarkMode: EFWatermarkMode**
水印图放置于最终生成二维码的位置，可选值，默认为 scaleAspectFill，可参考 UIViewContentMode，将生成的二维码当作 UIImageView 理解即可，枚举类型 EFWatermarkMode 定义如下：
```swift
// Like UIViewContentMode
public enum EFWatermarkMode: Int {
case scaleToFill = 0;
case scaleAspectFit = 1;
case scaleAspectFill = 2;
case center = 3;
case top = 4;
case bottom = 5;
case left = 6;
case right = 7;
case topLeft = 8;
case topRight = 9;
case bottomLeft = 10;
case bottomRight = 11;
}
```
* **isWatermarkColorful: Bool**
水印图是否为彩色，可选值，默认为彩色。
* **foregroundPointOffset: CGFloat**
二维码码点偏移量，可选值，默认为 0，不建议使用，易造成二维码无法识别，对比如下：
0 | 0.5
:-------------------------:|:-------------------------:
|
* **allowTransparent: Bool**
水印图穿透允许，可选值，默认为 true，对比如下：
true | false
:-------------------------:|:-------------------------:
|
## 待办
- 支持 .gif 动图
- 添加更多样式
## 备注
1. 请选用对比度较高的前景色和背景色组合；
2. 想要提高生成二维码的清晰度可以选择使用 `magnificatio` 替代 `size`，或适当提高它们的数值；
3. 放大倍数过高／边长过大／二维码内容过多可能会导致生成失败；
4. 建议对生成的二维码进行测试后投入使用，例如微信能够扫描成功并不代表支付宝也能成功扫描，请务必根据您的具体业务需要做有针对性的测试；
5. 若有任何问题，期待得到您的反馈，`Issue` 和 `Pull request` 都是受欢迎的。
备注的备注：好用的话可以给个`星星`，蟹蟹，QAQ...
## 作者
EyreFree, eyrefree@eyrefree.org
## 协议
EFQRCode 基于 MIT 协议进行分发和使用，更多信息参见协议文件。