npmpackage.info

Gathering detailed insights and metrics for image-q

Other packages similar to image-q

q-view

0.0.22

[Preview](https://q-hub-q-view.vercel.app/)

@qneyraud/q-image

1.2.3

Vue component for images using picture tag, srcset and lazyload

qimage

1.3.0

Simple Promise Image Loader based on Q

@trycourier/courier-js

1.4.2

[![Courier: Your Complete Communication Stack](https://www.courier.com/_next/image/?url=https%3A%2F%2Fimages.ctfassets.net%2Fz7iqk1q8njt4%2F1PZo9WNTdmoDoYH3yulXa0%2Fb10830f7bfb09af5e644a39ac3d20c41%2FCourierJS_header_alt2.png&w=1920&q=75)](https://courier

Gathering detailed insights and metrics for image-q

image-q - 4.0.0 | npmpackage.info

image-q

Image Quantization Library with alpha support (based on https://github.com/leeoniya/RgbQuant.js, https://github.com/timoxley/neuquant and http://www.ece.mcmaster.ca/~xwu/cq.c)

4.0.0

155

TypeScript

12.41 kB

204,784,546 2.9

Installations

npm install image-q

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS, ESM

Node Version

14.18.2

NPM Version

6.14.15 Score

99.8

Supply Chain

100

Quality

Maintenance

100

Vulnerability

99.6

License

Pull Requests

Open

5

Total

77

Closed

24

Merged

48

Issues

Open

5

Total

25

Closed

20

Releases

image-q@3.0.4

Updated on Sep 12, 2021

image-q@3.0.3

Updated on Sep 12, 2021

image-q@3.0.2

Updated on Sep 11, 2021

View All 3 releases

Languages

TypeScript

JavaScript

TypeScript (98.62%)

JavaScript (1.38%)

Developer

ibezkrovnyi

Download Statistics

Total Downloads

204,784,546

Last Day

236,156

Last Week

1,175,295

Last Month

5,096,484

Last Year

52,464,597

GitHub Statistics

155 Stars

167 Commits

11 Forks

4 Watchers

885 Branches

2 Contributors

Updated on Apr 19, 2025

Bundle Size

45.51 kB

Minified

12.41 kB

Minified + Gzipped

Bundlephobia

Maintainers

View All 2 Contributors

Package Meta Information

Latest Version

4.0.0

Package Id

image-q@4.0.0

Unpacked Size

825.63 kB

Size

164.04 kB

File Count

140

NPM Version

6.14.15

Node Version

14.18.2

Total Downloads

Cumulative downloads

Total Downloads

204,784,546

Last Day

10.6%

236,156

Compared to previous day

Last Week

-1.9%

1,175,295

Compared to previous week

Last Month

3.8%

5,096,484

Compared to previous month

Last Year

22.3%

52,464,597

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

@types/node

Dev Dependencies

@types/pngjs gh-pages pngjs typedoc

image-q

Complete Image Quantization Library in TypeScript (MIT License)

quantization

API Documentation and Usage
Introduction
Features
Todo
Breaking changes
Changelog
Credits
References
License

Introduction

Image Color Number Reduction with alpha support using RGBQuant/NeuQuant/Xiaolin Wu's algorithms and Euclidean/Manhattan/CIEDE2000 color distance formulas in TypeScript

Features

Platforms supported
- Browser (Chrome 7.0+, FireFox 4.0+, IE 10+, Opera 11.6+, Safari 5.1+)
- Node.js 6.0+
API
- Basic API: sync and promise-based async
- Advanced API: sync and generator-based
Builds
- dist/cjs/image-q.js - CommonJS
- dist/esm/image-q.js - ESM (ESNext)
- dist/cjs/image-q.js - UMD
Import
- HTMLImageElement
- HTMLCanvasElement
- NodeCanvas
- ImageData
- Array
- CanvasPixelArray
- Uint8Array
- Uint32Array
Color Distance
- Euclidean - 1/1/1/1 coefficients (originally used in Xiaolin Wu's Quantizer WuQuant)
- EuclideanBT709NoAlpha - BT.709 sRGB coefficients (originally used in RGBQuant)
- EuclideanBT709 BT.709 sRGB coefficients + alpha support
- Manhattan - 1/1/1/1 coefficients (originally used in NeuQuant)
- ManhattanBT709 - BT.709 sRGB coefficients
- ManhattanNommyde - see https://github.com/igor-bezkrovny/image-quantization/issues/4#issuecomment-234527620
- CIEDE2000 - CIEDE2000 (very slow)
- CIE94Textiles - CIE94 implementation for textiles
- CIE94GraphicArts - CIE94 implementation for graphic arts
- CMetric - see http://www.compuphase.com/cmetric.htm
- PNGQuant - used in pngQuant tool
Palette Quantizers
- NeuQuant (original code ported, integer calculations)
- NeuQuantFloat (floating-point calculations)
- RGBQuant
- WuQuant
Image Quantizers
- NearestColor
- ErrorDiffusionArray - two modes of error propagation are supported: xnview and gimp
  1. FloydSteinberg
  2. FalseFloydSteinberg
  3. Stucki
  4. Atkinson
  5. Jarvis
  6. Burkes
  7. Sierra
  8. TwoSierra
  9. SierraLite
- ErrorDiffusionRiemersma - Hilbert space-filling curve is used
Output
- Uint32Array
- Uint8Array

Include `image-q` library into your project

ES6 module

1// will import ESM (ESNext) or UMD version depending on your bundler/node
2import * as iq from 'image-q';

CommonJS

1var iq = require('image-q');

As a global variable (Browser)

1<script
2  src="<path-to image-q/dist/umd/image-q.js>"
3  type="text/javascript"
4  charset="utf-8"
5></script>

How to use

Please refer to API Documentation and Usage

Breaking changes

2.1.1

+ PaletteQuantizer#quantize => PaletteQuantizer#quantizeSync
+ ImageQuantizer#quantize => ImageQuantizer#quantizeSync

2.0.1 - 2.0.4 (2018-02-22)

+ EuclideanRgbQuantWOAlpha => EuclideanBT709NoAlpha
+ EuclideanRgbQuantWithAlpha => EuclideanBT709
	+ ManhattanSRGB => ManhattanBT709
	+ IImageDitherer => AbstractImageQuantizer
	+ IPaletteQuantizer => AbstractPaletteQuantizer
	+ PointContainer.fromNodeCanvas => PointContainer.fromHTMLCanvasElement
	+ PointContainer.fromArray => PointContainer.fromUint8Array
+ PointContainer.fromBuffer (Node.js, new)
	+ CMETRIC => CMetric
	+ PNGQUANT => PNGQuant
	+ SSIM Class => ssim function

TODO

~~notification about progress~~
~~riemersma dithering~~
ordered dithering <-- is there anyone who needs it?
readme update, more examples
demo update (latest image-q npm version should be used in demo)

Changelog

4.0.0

+ Test cases for different types of imports and requres added

4.0.0-alpha

+ Try to solve exported bundle types problem. 'umd' bundle removed.

3.0.8

+ Test case for issue #95 added

3.0.7

+ Fixes #96: Fix minimumColorDistanceToDither (PR #97 by @pixelplanetdev)

3.0.6

+ Fixes #95: "Always empty result in certain webpack / babel configs" (PR #98)

3.0.4

+ Fixes issue "Module not found: Can't resolve 'core-js/fn/set-immediate' in ..."

3.0.0

+ pnpm monorepo, esbuild for faster builds, typescript upgraded

2.1.1

+ Basic (Simple) API implemented
+ see breaking changes

2.0.5 (2018-02-23)

+ @types/node moved to 'dependencies'

2.0.4 (2018-02-23)

+ documentation added
+ some refactorings/renames, see breaking changes

2.0.3 (2018-02-22)

+ circular dependency removed

2.0.2 (2018-02-22)

+ readme updated

2.0.1 (2018-02-22)

+ progress tracking api (using es6 generators) added
+ strinct lint rules (+code cleanup/renames)
+ rollup (3 different versions - umd, cjs, esm + source maps + d.ts)
+ latest TypeScript
+ jest
+ snapshot tests
+ coverage (+coveralls)
+ greenkeeper

1.1.1 (2016-08-28)

+ CIEDE2000 - incorrect calculation fixed
+ CIEDE2000 - alpha channel now has only 25% impact on color distance instead of 66%
+ CIE94 - added 2 types (textiles and graphics art) according to spec
+ CIE94 - alpha support added
+ rgb2xyz, lab2xyz, xyz2rgb, xyz2lab - gamma correction
+ lab2xyz, xyz2lab - refY should be 100 (1.00000) instead of 10 (0.10000)
+ manhattan with new (Nommyde) coefficients added
+ mocha tests added
+ webpack integration
+ image-q is now UMD module
+ travis-ci integration
+ typescript 2.0
+ indentation with 4 spaces

0.1.4 (2015-06-24)

+ Refactoring
+ Riemersma dithering added (Hilbert Curve)
+ Readme.md updated
+ build.cmd updated

0.1.3 (2015-06-16)

+ NeuQuant is fixed (again) according to original Anthony Dekker source code (all values should be integer)
+ Error Diffusion Dithering is now calculates error like XNVIEW
+ Refactoring

0.1.2 (2015-06-16)

+ Documentation generation fixed
+ File name case problem fixed

0.1.1 (2015-06-16)

+ Auto-generated documentation added
+ Refactoring

0.1.0 (2015-06-16)

+ Code cleanup, removed unnecessary files

0.0.5 (2015-06-16)

+ PNGQuant color distance added, need to check its quality
+ CIEDE2000 and CIE94 fixed for use in NeuQuant
+ NeuQuant is fixed according to original Anthony Dekker source code (all values should be integer)
+ Code refactoring and cleanup
* We have some slowdown because of red/green/blue/alpha normalization according to white point per each calculateRaw/calculateNormalized call

0.0.4 (2015-06-15)

+ CIEDE2000 color distance equation optimized (original CIEDE2000 equation is available as class `CIEDE2000_Original`)

0.0.3b (2015-06-11)

+ CMetric color distance fixed

0.0.3a (2015-06-11)

+ Cleanup
+ Draft of CMetric color distance added

0.0.2 (2015-06-10)

+ rgb2xyz & xyz2lab fixed. CIEDE2000 works much better now.
+ CIE94 distance formula added. More investigation is needed.

0.0.1

+ Initial

Credits

Thanks to Leon Sorokin for information share and his original RGBQuant!

References

Palette Quantization Algorithms
1. RGBQuant (Leon Sorokin) JavaScript
2. NeuQuant (Johan Nordberg) TypeScript
3. NeuQuant (Tim Oxley) JavaScript
4. NeuQuant (Devon Govett) JavaScript
5. NeuQuant32 (Stuart Coyle) C
6. Xiaolin Wu (Xiaolin Wu) C
7. Xiaolin Wu (Smart-K8) C#
8. Xiaolin Wu w/ Alpha (Matt Wrock) How to add Alpha, Source Code C#
9. MedianCut (mwcz) GPLv3
Image Quantization Algorithms
1. All (ImageMagik doc)
2. Error Diffusion dithering (Tanner Helland)
3. Riemersma dithering TODO: Check License
4. Ordered dithering (Joel Yliluoma)
Color Distance Formulas

Calculator + Info
1. Euclidean Distance
2. Manhattan Distance
3. CIE94 Distance
  - Source Code (Iulius Curt)
4. CIEDE2000
5. Euclidean Distance w/o Alpha (RGBQuant)
6. Euclidean Distance w/o sRGB coefficients (Xiaolin Wu Quant)
7. Manhattan Distance w/o sRGB coefficients (NeuQuant)
8. CMetric DRAFT!
Color conversion formulas
1. Pseudo-code

Be sure to fix rgb2xyz/xyz2lab. Issue is with strange part of code: r = r > 0.04045 ? .... Check http://en.wikipedia.org/wiki/Lab_color_space

Image Quality Assessment
1. SSIM info
2. SSIM (Rhys-e) Java License: MIT
3. PSNR ? TBD
4. MSE ? TBD
Other

License

MIT

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

7

SAST

Determines if the project uses static code analysis.

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

License

Determines if the project has defined a license.

0

Fuzzing

Determines if the project uses fuzzing.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 0

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/ibezkrovnyi/image-quantization/codeql-analysis.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:46: update your workflow using https://app.stepsecurity.io/secureworkflow/ibezkrovnyi/image-quantization/codeql-analysis.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:57: update your workflow using https://app.stepsecurity.io/secureworkflow/ibezkrovnyi/image-quantization/codeql-analysis.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:71: update your workflow using https://app.stepsecurity.io/secureworkflow/ibezkrovnyi/image-quantization/codeql-analysis.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/commit.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/ibezkrovnyi/image-quantization/commit.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/commit.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/ibezkrovnyi/image-quantization/commit.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/commit.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/ibezkrovnyi/image-quantization/commit.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/ibezkrovnyi/image-quantization/release.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/ibezkrovnyi/image-quantization/release.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/ibezkrovnyi/image-quantization/release.yml/main?enable=pin
Warn: downloadThenRun not pinned by hash: .github/workflows/commit.yml:33
Warn: downloadThenRun not pinned by hash: .github/workflows/release.yml:31
Info: 0 out of 10 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 2 downloadThenRun dependencies pinned

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Reason

41 existing vulnerabilities detected

Details

Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8
Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92
Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw
Warn: Project is vulnerable to: GHSA-fwr7-v2mv-hh25
Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
Warn: Project is vulnerable to: GHSA-x9w5-v3q2-3rhw
Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq
Warn: Project is vulnerable to: GHSA-434g-2637-qmqr
Warn: Project is vulnerable to: GHSA-49q7-c7j4-3p7m
Warn: Project is vulnerable to: GHSA-977x-g7h5-7qgw
Warn: Project is vulnerable to: GHSA-f7q4-pwc6-w24p
Warn: Project is vulnerable to: GHSA-fc9h-whq2-v747
Warn: Project is vulnerable to: GHSA-vjh7-7g9h-fjfh
Warn: Project is vulnerable to: GHSA-67mh-4wv8-2f99
Warn: Project is vulnerable to: GHSA-74fj-2j2h-c42q
Warn: Project is vulnerable to: GHSA-pw2r-vq6v-hr8c
Warn: Project is vulnerable to: GHSA-jchw-25xp-jwwc
Warn: Project is vulnerable to: GHSA-cxjh-pqwp-8mfp
Warn: Project is vulnerable to: GHSA-8mmm-9v2q-x3f9
Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h
Warn: Project is vulnerable to: GHSA-76p3-8jx3-jpfq
Warn: Project is vulnerable to: GHSA-3rfm-jhwj-7488
Warn: Project is vulnerable to: GHSA-hhq3-ff78-jv3g
Warn: Project is vulnerable to: GHSA-5v2h-r2cx-5xgj
Warn: Project is vulnerable to: GHSA-rrrm-qjm4-v8hf
Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3
Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h
Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp
Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6
Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
Warn: Project is vulnerable to: GHSA-76p7-773f-r4q5
Warn: Project is vulnerable to: GHSA-4rq4-32rv-6wp6
Warn: Project is vulnerable to: GHSA-64g7-mvw6-v9qj
Warn: Project is vulnerable to: GHSA-4wf5-vphf-c2xc
Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3
Warn: Project is vulnerable to: GHSA-hc6q-2mpp-qw7j
Warn: Project is vulnerable to: GHSA-4vvj-4cpr-p986
Warn: Project is vulnerable to: GHSA-j8xg-fqg3-53r7
Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q

Score

2.9

/10

Last Scanned on 2025-04-21

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to image-q

Other packages similar to image-q

image-q

Installations

Developer Guide

Yes

CommonJS, ESM

14.18.2

6.14.15

Score

Pull Requests

5

77

24

48

Issues

5

25

20

Releases

Languages

Developer

ibezkrovnyi

Download Statistics

GitHub Statistics

Bundle Size

45.51 kB

12.41 kB

Maintainers

Package Meta Information

Total Downloads

204,784,546

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Dev Dependencies

image-q

Table of Contents

Introduction

Features

Include image-q library into your project

ES6 module

CommonJS

As a global variable (Browser)

How to use

Breaking changes

2.1.1

2.0.1 - 2.0.4 (2018-02-22)

TODO

Changelog

4.0.0

4.0.0-alpha

3.0.8

3.0.7

3.0.6

3.0.4

3.0.0

2.1.1

2.0.5 (2018-02-23)

2.0.4 (2018-02-23)

2.0.3 (2018-02-22)

2.0.2 (2018-02-22)

2.0.1 (2018-02-22)

1.1.1 (2016-08-28)

0.1.4 (2015-06-24)

0.1.3 (2015-06-16)

0.1.2 (2015-06-16)

0.1.1 (2015-06-16)

0.1.0 (2015-06-16)

0.0.5 (2015-06-16)

0.0.4 (2015-06-15)

0.0.3b (2015-06-11)

0.0.3a (2015-06-11)

0.0.2 (2015-06-10)

0.0.1

Credits

References

License

10

Include `image-q` library into your project