README

简介 | 关于 | CFC | LIBCIMBAR
 详细内容 | 演示 | 下一步

 libcimbar: 彩色图形矩阵条形码

一种用于小型数据传输的实验性条形码。

解码速度在 850Kbit/s 左右（约106 KB/s），只需一个电脑显示器和手机摄像头！





 为什么？

编码器可以将条形码输出到计算机或手机屏幕：
 网页端：https://cimbar.org

也可以是一个使用手机摄像头读取条形码的手机APP：
 安卓APP：https://github.com/sz3/cfc

APP并未使用互联网/蓝牙/NFC等，所有数据都是通过摄像头传输的。

 原理

cimbar是一种高密度的二维条形码格式。数据存储在彩色图块网格中——根据选择哪个图块和选择哪种颜色来绘制图块，对信息进行编码。对数据应用Reed-Solomon纠错，预计错误率在1%左右。

libcimbar，这是个优化版本，包括一个基于喷泉代码（wirehair）和zstd压缩的简单文件编码协议。最高33MB（压缩后）的文件以一系列 cimbar 代码编码，输出为图像或视频等。一旦成功解码了足够多帧，该文件将被重建和解压缩。即使图像接收出错，或者有些图像已损坏或丢失，也不会有太大问题。

 平台

该代码是用C++编写的，并在 amd64+linux、arm64+android（仅限解码器）和 emscripten+WASM（仅限编码器）上开发/测试。在其他平台上应该也可以工作。

至关重要的是，由于编码器编译为 asmjs 和 wasm ，它可以在任何具有现代网络浏览器的设备上运行。对于离线使用，您可以将 cimbar.org 安装为渐进式web应用程序，或下载最新版本。至于 cimbar_js.html ，将其保存在本地，然后在浏览器中打开。

 依赖库

OpenCV 和 GLFW (+ OpenGL ES headers) 必须在构建前安装，所有其他依赖项都包含在源代码树中。

 opencv - https://opencv.org/ (libopencv-dev)
 GLFW - https://github.com/glfw/glfw (libglfw3-dev)
 GLES3/gl3.h - libgles2-mesa-dev
 base - https://github.com/r-lyeh-archived/base
 catch2 - https://github.com/catchorg/Catch2
 concurrentqueue - https://github.com/cameron314/concurrentqueue
 cxxopts - https://github.com/jarro2783/cxxopts （用于命令行工具）
 fmt - https://github.com/fmtlib/fmt
 intx - https://github.com/chfast/intx
 libcorrect - https://github.com/quiet/libcorrect
 libpopcnt - https://github.com/kimwalisch/libpopcnt
 PicoSHA2 - https://github.com/okdshin/PicoSHA2 （用于测试）
 stb_image - https://github.com/nothings/stb （用于加载嵌入图像）
 wirehair - https://github.com/catid/wirehair
 zstd - https://github.com/facebook/zstd

 构建

1. 在 Ubuntu/Debian 上安装 opencv 和 GLFW 。如下：

sudo apt install libopencv-dev libglfw3-dev libgles2-mesa-dev


2. 运行 cmake + make

cmake .
make -j7
make install


默认情况下，libcimbar 将尝试在 ./dist/bin/ 下安装构建产品。

要构建 cimbar.js（供cimbar.org使用)，请参阅 WASM。

 使用

编码：
 输入文件太大可能导致硬盘中生成过多图片！


./cimbar --encode -i inputfile.txt -o outputprefix


解码（释放文件到输出目录）：

./cimbar outputprefix.png -o /tmp


从stdin解码一系列编码图像：

echo outputprefix.png | ./cimbar -o /tmp


对窗口进行编码并设置动画：

./cimbar_send inputfile.pdf


您还可以使用 cimbar.org 对文件进行编码，或最新的 release.

 演示

PERFORMANCE

 详细信息

DETAILS

 下一步

TODO

 灵感来源

 https://github.com/JohannesBuchner/imagehash/
 https://github.com/divan/txqr
 https://en.wikipedia.org/wiki/High_Capacity_Color_Barcode

 想了解更多？

 cimbar | 关于