iOS 裡有個好用的類別叫 CIFilter,透過它可以建立各種圖像過濾器。本文用它內建的 QR Code 產生器做出一張二維碼,中間還能嵌圖,最後再加上長按辨識的功能。
//建立二維碼過濾器 let qrCIFilter = CIFilter(name: "CIQRCodeGenerator")
這個初始化方法只接受幾個固定的字串,不同字串會產生不同用途的過濾器。正因為如此,官方文件特別提醒建立後要檢查結果是否為 nil,以免字串拼錯卻安靜地失敗。想知道有哪些合法值,在 Xcode 中 command + 點擊 CIQRCodeGenerator 跳到宣告處,就能看到相關常數的說明。
過濾器的屬性是一組 key-value,key 同樣是固定字串。二維碼過濾器有兩個屬性:inputMessage 與 inputCorrectionLevel。若不特別設定,系統會套用預設值,因此不必逐一補齊。
inputMessage 是要編碼的內容,注意 value 必須是 NSData 型別;inputCorrectionLevel 是容錯等級,共有 L(7%)、M(15%)、Q(25%)、H(30%)四種,預設為 M。
//二維碼包含的資訊
qrCIFilter!.setValue(messageData, forKey: "inputMessage")
// L 7% / M 15% / Q 25% / H 30% 容錯等級,預設 M
qrCIFilter!.setValue("H", forKey: "inputCorrectionLevel")
到這裡其實已經有一張最陽春的二維碼了:
let qrImage = qrCIFilter?.outputImage
這裡的 qrImage 是 CIImage。你可以用它轉出 UIImage 放進 UIImageView 顯示,但會發現畫面糊得不成樣子——因為 QR Code 本身是點陣矩陣,直接放大就會失真。要解決這個問題,得再加工一層。
再串一個 CIFalseColor 過濾器。查官方文件對它的描述是「偽造顏色,常用於處理天文與其他科學影像,例如紫外線與 X 射線圖像」,實務上最常被拿來做二維碼的純色化處理。它有三個屬性:inputImage、inputColor0、inputColor1,分別代表輸入圖、前景色與背景色。
let colorFilter = CIFilter(name: "CIFalseColor") //輸入圖片 colorFilter!.setValue(qrImage, forKey: "inputImage") //前景(條碼本身)設為黑 colorFilter!.setValue(CIColor(red: 0, green: 0, blue: 0), forKey: "inputColor0") //背景設為白 colorFilter!.setValue(CIColor(red: 1, green: 1, blue: 1), forKey: "inputColor1")
接著做整數倍縮放(放大後邊緣依然銳利),並轉成 UIImage:
var image = UIImage(CIImage: colorFilter!.outputImage!
.imageByApplyingTransform(CGAffineTransformMakeScale(5, 5)))
很多產品會在二維碼中央放 logo,做法是「在一張圖裡再畫一張圖」,流程只有四步:開啟上下文 → 重繪(二維碼一張、logo 一張)→ 從上下文取出結果 → 關閉上下文。
這裡有個容易踩的坑:二維碼本身也必須一起重繪,否則最後取出的圖會缺少它,也就無法再轉回 CIImage 使用。
//開啟上下文
UIGraphicsBeginImageContext(frame.size)
//重繪二維碼
image.drawInRect(frame)
if let myImage = UIImage(named: andImageName) {
//logo 尺寸取二維碼的四分之一
let mySize = CGSizeMake(frame.size.width / 4, frame.size.height / 4)
//置中重繪
myImage.drawInRect(CGRectMake(frame.size.width / 2 - mySize.width / 2,
frame.size.height / 2 - mySize.height / 2,
mySize.width, mySize.height))
}
//從上下文取出結果
image = UIGraphicsGetImageFromCurrentImageContext()
//關閉上下文
UIGraphicsEndImageContext()
提醒:中央嵌圖會遮蓋部分資料區,容錯等級建議設到 Q 或 H,實機掃描前最好多測幾個角度。
先掛一個長按手勢:
let longTap = UILongPressGestureRecognizer(target: self, action: #selector(longPress)) self.view.addGestureRecognizer(longTap)
辨識時要建立一個探測器,指定探測器類型、CIContext 與各項 options:
/*
建立探測器
options 為字典,常見 key:
CIDetectorAccuracy 精準度
CIDetectorTracking 追蹤
CIDetectorMinFeatureSize 最小特徵尺寸
CIDetectorNumberOfAngles 角度數
*/
let detector = CIDetector(ofType: CIDetectorTypeQRCode,
context: CIContext(),
options: [CIDetectorAccuracy: CIDetectorAccuracyHigh])
然後把 CIImage 丟給它,探測器會回傳圖中所有二維碼:
let qrFeatures = detector.featuresInImage(decodeImage!) as! [CIQRCodeFeature]
qrFeatures 是一個陣列,元素型別為 CIQRCodeFeature,其中的 messageString 屬性就是二維碼裡的文字內容。
import UIKit
class ViewController: UIViewController {
let imageView = UIImageView(frame: CGRect(x: 30, y: 50, width: 200, height: 200))
let pictureView = UIImageView(frame: CGRect(x: 50, y: 270, width: 200, height: 200))
override func viewDidLoad() {
super.viewDidLoad()
imageView.image = createQRCodeByCIFilterWithString("句芒二維碼發生器", andImageName: "")
self.view.addSubview(imageView)
pictureView.image = createQRCodeByCIFilterWithString("https://www.jubaobar.com", andImageName: "jubaobar.jpg")
self.view.addSubview(pictureView)
let longTap = UILongPressGestureRecognizer(target: self, action: #selector(longPress))
self.view.addGestureRecognizer(longTap)
// 順手示範把圖寫存檔
let data = UIImagePNGRepresentation(pictureView.image!)
let path = NSHomeDirectory().stringByAppendingString("/Documents/s.png")
data!.writeToFile(path, atomically: true)
print(path)
}
func longPress(recoginzer: UILongPressGestureRecognizer) {
let point = recoginzer.locationInView(self.view)
if imageView.frame.contains(point) {
return show(decodeQRCode(imageView.image!))
}
if pictureView.frame.contains(point) {
return show(decodeQRCode(pictureView.image!))
}
}
func decodeQRCode(image: UIImage) -> String {
let decodeImage = CIImage(image: image)
let detector = CIDetector(ofType: CIDetectorTypeQRCode,
context: CIContext(),
options: [CIDetectorAccuracy: CIDetectorAccuracyHigh])
let qrFeatures = detector.featuresInImage(decodeImage!) as! [CIQRCodeFeature]
return qrFeatures.last!.messageString
}
func show(message: String) {
let alert = UIAlertController(title: "二維碼", message: message, preferredStyle: .Alert)
alert.addAction(UIAlertAction(title: "知道了", style: .Cancel, handler: nil))
self.presentViewController(alert, animated: true, completion: nil)
}
func createQRCodeByCIFilterWithString(message: String, andImageName: String) -> UIImage? {
if let messageData = message.dataUsingEncoding(NSUTF8StringEncoding, allowLossyConversion: false) {
// 建立二維碼過濾器
let qrCIFilter = CIFilter(name: "CIQRCodeGenerator")
qrCIFilter!.setValue(messageData, forKey: "inputMessage")
qrCIFilter!.setValue("H", forKey: "inputCorrectionLevel")
let qrImage = qrCIFilter?.outputImage
// 用 CIFalseColor 做純色化,解決模糊問題
let colorFilter = CIFilter(name: "CIFalseColor")
colorFilter!.setValue(qrImage, forKey: "inputImage")
colorFilter!.setValue(CIColor(red: 0, green: 0, blue: 0), forKey: "inputColor0")
colorFilter!.setValue(CIColor(red: 1, green: 1, blue: 1), forKey: "inputColor1")
var image = UIImage(CIImage: colorFilter!.outputImage!
.imageByApplyingTransform(CGAffineTransformMakeScale(5, 5)))
let frame = CGRectMake(0, 0, image.size.width, image.size.height)
UIGraphicsBeginImageContext(frame.size)
image.drawInRect(frame)
if let myImage = UIImage(named: andImageName) {
let mySize = CGSizeMake(frame.size.width / 4, frame.size.height / 4)
myImage.drawInRect(CGRectMake(frame.size.width / 2 - mySize.width / 2,
frame.size.height / 2 - mySize.height / 2,
mySize.width, mySize.height))
}
image = UIGraphicsGetImageFromCurrentImageContext()
UIGraphicsEndImageContext()
return image
}
return nil
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
}
關於放大倍數。範例用 5 倍是為了視覺效果,實際尺寸應該依使用情境決定:名片印刷需要更高解析度,而列表中的小圖示則可以低一些,避免佔用過多記憶體。
關於容錯等級與 logo 大小的關係。H 級可容忍約 30% 的遮損,所以中央 logo 建議不超過整體面積的 1/4 到 1/5。若 logo 太大,實機辨識率會明顯下降。
關於辨識失敗。featuresInImage 回傳空陣列時,範例中的 last! 會直接 crash。正式環境務必改成先判斷 count,並對 nil 情況給使用者明確回饋。