EasyQRCodeJS-NodeJS

EasyQRCodeJS-NodeJS is a NodeJS server side javascript QRCode image(PNG/JPEG/SVG/Base64 data url) generator. Support setting Dot style, Logo, Background image, Colorful, Title and more. Support binary(hex) data mode.

EasyQRCodeJS-NodeJS 是一个 NodeJS 环境下的服务端 JavaScript QRCode 图片(PNG/JPEG/SVG/Base64 data url)生成模块。支持点状风格，Logo，背景图片，规则色彩控制，标题等设置。支持二进制数据模式。

Table of contents

• Table of contents
• Choose what you need
• Feature
• Try It!
• Demo preview
• QR Code Structure
• Installation
• Basic Usages
• QRCode API
  • Object
  • Options
  • Methods
• TypeScript Support
• License
• EasyQRCodeJS-NodeJS-Premium
• End

Choose what you need

Project	Support
EasyQRCodeJS	Running with DOM on CLIENT-SIDE . Browser(IE6+, Chrome, Firefox, Safari, Opera, Mobile Safari, Android, Windows Mobile, ETC.), Electron, NW.js, ETC.
EasyQRCodeJS-NodeJS	Running without DOM on SERVER-SIDE. Save image to file(PNG/JPEG/SVG) or get data url text. NodeJS, Electron, NW.js, ETC.
EasyQRCode-React-Native	A QRCode generator for React Native. Generate QRCode image or get base64 data url text.

Feature

• English

  • Save QRCode image file without DOM on server side

  • Support unicode character set: 😊❤️👍👨‍💻 Hello, こんにちは, こんにちは, Γεια, Привет, नमस्ते, สวัสดี, Привіт, سلام, Здравей, ສະບາຍດີ, Përshëndetje, Բարեւ, 你好

  • Support save PNG/JPEG/SVG image file

  • Support get standard base64 image data url text: data:image/png;base64, ...

  • Support get SVG data text: <svg xmlns:xlink="http://www.w3.org/1999/xlink" ...

  • Support get a stream from Canvas

  • Required Patterns that support dot style

  • Support for Quiet Zone settings

  • Support custom Position Pattern inner fill and outer border color

  • Support custom Alignment Pattern inner fill and outer border color

  • Support custom Timing Patterns vertical, horizontal color

  • Support Logo images (including transparent PNG images)

  • Support Background Image

  • Support for title, subtitle settings

  • Support binary(hex) data mode

  • Support TypeScript

• 中文

  • 无需 DOM 的服务端 QRCode 图片保存

  • 支持 Unicode 字符集: 😊❤️👍👨‍💻 Hello, こんにちは, こんにちは, Γεια, Привет, नमस्ते, สวัสดี, Привіт, سلام, Здравей, ສະບາຍດີ, Përshëndetje, Բարեւ, 你好

  • 支持存储为 PNG 图片

  • 支持获得 Base64 编码的标准图形 URL 字符串：data:image/png;base64, ...

  • 支持获得 SVG 图形文本: <svg xmlns:xlink="http://www.w3.org/1999/xlink" ...

  • 支持从 Canvas 获得图片 Stream

  • 支持点形风格的 Required Patterns

  • 支持 Quiet Zone 设置

  • 支持自定义 Position Pattern 内填充和外边框颜色

  • 支持自定义 Alignment Pattern 内填充和外边框颜色

  • 支持自定义 Timing Patterns 垂直，水平颜色

  • 支持 Logo 图片（包括背景透明的 PNG 图片）

  • 支持 Background Image 背景图片

  • 支持标题，副标题设置

  • 二进制数据模式支持

  • TypeScript 支持

Try It!

Try It!

Demo preview

QR Code Structure

Installation

1npm install easyqrcodejs-nodejs

Basic Usages

1const QRCode = require('easyqrcodejs-nodejs');
2
3// Options
4var options = {
5	text: "www.easyproject.cn/donation"
6};
7
8// New instance with options
9var qrcode = new QRCode(options);
10
11// Save QRCode image
12qrcode.saveImage({
13	path: 'q.png' // save path
14});

QRCode API

Object

1var qrcode = new QRCode(options);

Options

1 var options = {
2    // ====== Basic
3    text: "https://github.com/ushelp/EasyQRCodeJS",
4    width: 256,
5    height: 256,
6    colorDark : "#000000",
7    colorLight : "#ffffff",
8    correctLevel : QRCode.CorrectLevel.H, // L, M, Q, H
9
10    // ====== dotScale
11    /*
12    dotScale: 1, // For body block, must be greater than 0, less than or equal to 1. default is 1
13
14    dotScaleTiming: 1, // Dafault for timing block , must be greater than 0, less than or equal to 1. default is 1
15    dotScaleTiming_H: undefined, // For horizontal timing block, must be greater than 0, less than or equal to 1. default is 1
16    dotScaleTiming_V: undefined, // For vertical timing block, must be greater than 0, less than or equal to 1. default is 1
17
18    dotScaleA: 1, // Dafault for alignment block, must be greater than 0, less than or equal to 1. default is 1
19    dotScaleAO: undefined, // For alignment outer block, must be greater than 0, less than or equal to 1. default is 1
20    dotScaleAI: undefined, // For alignment inner block, must be greater than 0, less than or equal to 1. default is 1
21    */
22
23    // ====== Quiet Zone
24    /*
25    quietZone: 0,
26    quietZoneColor: "rgba(0,0,0,0)",
27    */
28
29    // ====== Logo
30    /*
31    logo: "../demo/logo.png", // Relative address, relative to `easy.qrcode.min.js`
32    logo: "http://127.0.0.1:8020/easy-qrcodejs/demo/logo.png", 
33    logoWidth: 80, // fixed logo width. default is `width/3.5`
34    logoHeight: 80, // fixed logo height. default is `heigth/3.5`
35    logoMaxWidth: undefined, // Maximum logo width. if set will ignore `logoWidth` value
36    logoMaxHeight: undefined, // Maximum logo height. if set will ignore `logoHeight` value
37    logoBackgroundColor: '#fffff', // Logo backgroud color, Invalid when `logBgTransparent` is true; default is '#ffffff'
38    logoBackgroundTransparent: false, // Whether use transparent image, default is false
39    */
40
41    // ====== Backgroud Image
42    /*
43    backgroundImage: '', // Background Image
44    backgroundImageAlpha: 1, // Background image transparency, value between 0 and 1. default is 1. 
45    autoColor: false, // Automatic color adjustment(for data block)
46    autoColorDark: "rgba(0, 0, 0, .6)", // Automatic color: dark CSS color
47    autoColorLight: "rgba(255, 255, 255, .7)", // Automatic color: light CSS color
48    */
49
50    // ====== Colorful
51    // === Posotion Pattern(Eye) Color
52    /*
53    PO: '#e1622f', // Global Posotion Outer color. if not set, the defaut is `colorDark`
54    PI: '#aa5b71', // Global Posotion Inner color. if not set, the defaut is `colorDark`
55    PO_TL:'', // Posotion Outer color - Top Left 
56    PI_TL:'', // Posotion Inner color - Top Left 
57    PO_TR:'', // Posotion Outer color - Top Right 
58    PI_TR:'', // Posotion Inner color - Top Right 
59    PO_BL:'', // Posotion Outer color - Bottom Left 
60    PI_BL:'', // Posotion Inner color - Bottom Left 
61    */
62    // === Alignment Color
63    /*
64    AO: '', // Alignment Outer. if not set, the defaut is `colorDark`
65    AI: '', // Alignment Inner. if not set, the defaut is `colorDark`
66    */
67    // === Timing Pattern Color
68    /*
69    timing: '#e1622f', // Global Timing color. if not set, the defaut is `colorDark`
70    timing_H: '', // Horizontal timing color
71    timing_V: '', // Vertical timing color
72    */
73
74    // ====== Title
75    /*
76    title: 'QR Title', // content 
77    titleFont: "normal normal bold 18px Arial", //font. default is "bold 16px Arial"
78    titleColor: "#004284", // color. default is "#000"
79    titleBackgroundColor: "#fff", // background color. default is "#fff"
80    titleHeight: 70, // height, including subTitle. default is 0
81    titleTop: 25, // draws y coordinates. default is 30
82    */
83
84    // ====== SubTitle
85    /*
86    subTitle: 'QR subTitle', // content
87    subTitleFont: "normal normal normal 14px Arial", // font. default is "14px Arial"
88    subTitleColor: "#004284", // color. default is "4F4F4F"
89    subTitleTop: 40, // draws y coordinates. default is 0
90    */
91
92    // ===== Event Handler
93    /*
94    onRenderingStart: undefined,
95    */
96
97    // ==== Images format
98    /*
99    format: 'PNG', // 'PNG', 'JPG'
100    compressionLevel: 6, // ZLIB compression level (0-9). default is 6
101    quality: 0.75, // An object specifying the quality (0 to 1). default is 0.75. (JPGs only) 
102    */
103
104    // ==== Versions
105    /*
106    version: 0, // The symbol versions of QR Code range from Version 1 to Version 40. default 0 means automatically choose the closest version based on the text length.
107    */     
108
109    // ===== Binary(hex) data mode
110    /*
111    binary: false, // Whether it is binary mode, default is text mode. 
112    */ 
113
114    // =====  UTF-8 without BOM
115    /*
116    utf8WithoutBOM: true
117    */        
118}

Option	Required	Type	Defaults	Description
Basic options	---	---	---	---
text	Y	String	''	Text
width	N	Number	256	Width
height	N	Number	256	Height
colorDark	N	String	#000000	Dark CSS color
colorLight	N	String	#ffffff	Light CSS color
correctLevel	N	Enum	QRCode.CorrectLevel.H	QRCode.CorrectLevel.H QRCode.CorrectLevel.Q QRCode.CorrectLevel.M QRCode.CorrectLevel.L
Dot style	---	---	---	---
dotScale	N	Number	1.0	Dot style scale. Ranges: 0-1.0
dotScaleTiming	N	Number	1.0	Dot style scale for timing. Ranges: 0-1.0
dotScaleTiming_V	N	Number	undefined	Dot style scale for horizontal timing. Ranges: 0-1.0
dotScaleTiming_H	N	Number	undefined	Dot style scale for vertical timing. Ranges: 0-1.0
dotScaleA	N	Number	1.0	Dot style scale for alignment. Ranges: 0-1.0
dotScaleAO	N	Number	undefined	Dot style scale for alignment outer. Ranges: 0-1.0
dotScaleAI	N	Number	undefined	Dot style scale for alignment inner. Ranges: 0-1.0
Quiet Zone	---	---	---	---
quietZone	N	Number	0	Quiet Zone size
quietZoneColor	N	String	rgba(0,0,0,0)	Background CSS color to Quiet Zone
Logo options	---	---	---	---
logo	N	String	undefined	Logo Image Path or Base64 encoded image. If use relative address, relative to easy.qrcode.min.js
logoWidth	N	Number	width/3.5	Fixed logo width.
logoHeight	N	Number	height/3.5	fixed logo height.
logoMaxWidth	N	Number	undefined	Maximum logo width. if set will ignore logoWidth value.
logoMaxHeight	N	Number	undefined	Maximum logo height. if set will ignore logoHeight value.
logoBackgroundTransparent	N	Boolean	false	Whether the background transparent image(PNG) shows transparency. When true, logoBackgroundColor is invalid
logoBackgroundColor	N	String	#ffffff	Set Background CSS Color when image background transparent. Valid when logoBackgroundTransparent is false
Backgroud Image options	---	---	---	---
backgroundImage	N	String	undefined	Background Image Path or Base64 encoded image. If use relative address, relative to easy.qrcode.min.js
backgroundImageAlpha	N	Number	1.0	Background image transparency. Ranges: 0-1.0
autoColor	N	Boolean	false	Automatic color adjustment(for data block)
autoColorDark	N	String	rgba(0, 0, 0, .6)	Automatic color: dark CSS color
autoColorLight	N	String	rgba(255, 255, 255, .7)	Automatic color: light CSS color
Posotion Pattern Color options	---	---	---	---
PO	N	String	undefined	Global Posotion Outer CSS color. if not set, the defaut is colorDark
PI	N	String	undefined	Global Posotion Inner CSS color. if not set, the defaut is colorDark
PO_TL	N	String	undefined	Posotion Outer CSS color - Top Left
PI_TL	N	String	undefined	Posotion Inner CSS color - Top Left
PO_TR	N	String	undefined	Posotion Outer CSS color - Top Right
PI_TR	N	String	undefined	Posotion Inner CSS color - Top Right
PO_BL	N	String	undefined	Posotion Outer CSS color - Bottom Left
PI_BL	N	String	undefined	Posotion Inner CSS color - Bottom Left
Alignment Color options	---	---	---	---
AO	N	String	undefined	Alignment Outer CSS color. if not set, the defaut is colorDark
AI	N	String	undefined	Alignment Inner CSS color. if not set, the defaut is colorDark
Timing Pattern Color options	---	---	---	---
timing	N	String	undefined	Global Timing CSS color. if not set, the defaut is colorDark
timing_H	N	String	undefined	Horizontal timing CSS color
timing_V	N	String	undefined	Vertical timing CSS color
Title options	---	---	---	---
title	N	String	''
titleFont	N	String	normal normal bold 16px Arial	CSS Font
titleColor	N	String	#000000	CSS color
titleBackgroundColor	N	String	#ffffff	CSS color
titleHeight	N	Number	0	Title Height, Include subTitle
titleTop	N	Number	30	draws y coordinates.
SubTitle options	---	---	---	---
subTitle	N	String	''
subTitleFont	N	String	normal normal normal 14px Arial	CSS Font
subTitleColor	N	String	#4F4F4F	CSS color
subTitleTop	N	Number	0	draws y coordinates. default is 0
Event Handler options	---	---	---	---
onRenderingStart(qrCodeOptions)	N	Function	undefined	Callback function when rendering start work. can use to hide loading state or handling.
Images format options	---	---	---	---
format	N	String	PNG	'PNG' or 'JPG'
compressionLevel	N	Number	6	ZLIB compression level between 0 and 9. (PNGs only)
quality	N	Number	0.75	An object specifying the quality (0 to 1). (JPGs only)
Version options	---	---	---	---
version	N	Number	0	The symbol versions of QR Code range from Version 1 to Version 40. default 0 means automatically choose the closest version based on the text length. Information capacity and versions of QR Codes NOTE: If you set a value less than the minimum version available for text, the minimum version is automatically used.
UTF-8 options	---	---	---	---
utf8WithoutBOM	N	Boolean	true	Use UTF-8 without BOM. set to false value will use BOM in UFT-8.
Binary(hex) data model options	---	---	---	---
binary	N	Boolean	false	Whether it is binary mode, default is text mode.

Methods

• saveImage(ImagesFormatOptions)

  1//  Save PNG Images to file
  2qrcode.saveImage({
  3	path: 'q.png' // file path
  4}).then(data=>{
  5   console.log("`q-premium1.png` has been Created!");
  6});

• saveSVG(ImagesFormatOptions)

  1//  Save SVG to file
  2qrcode.saveSVG({
  3	path: 'qrcode.svg' // file path
  4}).then(data=>{
  5   console.log("`qrcode.svg` has been Created!");
  6});

• toDataURL()

  1// Get standard base64 image data url text: 'data:image/png;base64, ...'
  2qrcode.toDataURL().then(data=>{
  3	console.info('======QRCode PNG Base64 DataURL======')
  4	console.info(data);
  5});

• toSVGText()

  1// Get SVG data text: '<svg xmlns:xlink="http://www.w3.org/1999/xlink" ...'
  2qrcode.toSVGText().then(data=>{
  3	console.info('======QRCode SVG Data Text======')
  4	console.info(data)
  5});

• toStream()

  1const out = fs.createWriteStream(`qrcode-stream.png`);
  2// const stream = await qrcode.toStream();
  3// stream.pipe(out);
  4// out.on('finish', () => console.log('Finsihed'));
  5
  6qrcode.toStream().then(res=>{
  7    res.pipe(out).on('finish', () => console.log('Finsihed'));
  8})

TypeScript Support

Update to version 3.7.1+.

1import QRCode = require("easyqrcodejs-nodejs")

License

MIT License

EasyQRCodeJS-NodeJS-Premium

Let you draw freely!

EasyQRCodeJS-Premium is a more powerful and comprehensive enterprise version. You can use Canvas to customize any element, such as eye frame shape, eyeball shape, QR code block shape, and more. Also supports excavation (to prevent the QRcode overlap with the logo), random block mode.

If you need more functions, we can provide you with customized development of API libraries or products. please contact me to buy the business enterprise edition.

EasyQRCodeJS-Premium 是功能更加强大和全面的商业/企业版本。让您可以在 QRCode 中通过 Canvas 自定义任何喜欢的元素，例如 Eye frame 形状, Eye ball 形状, QR Body block 形状等等。 还支持 Logo 挖取（excavation，防止二维码与 Logo 重叠）和 Random bolock mode.

如果您需要更多功能，我们可以为您提供 API 库或产品的定制开发。请联系我购买商业/企业版本。

End

Email：inthinkcolor@gmail.com

http://www.easyproject.cn

Donation/捐助:

我们相信，每个人的点滴贡献，都将是推动产生更多、更好免费开源产品的一大步。

感谢慷慨捐助，以支持服务器运行和鼓励更多社区成员。

We believe that the contribution of each bit by bit, will be driven to produce more and better free and open source products a big step.

Thank you donation to support the server running and encourage more community members.