Skip to content

A nodejs wrapper that generating bpg image files by using pre-compiled libbpg (http://bellard.org/bpg/).

License

Notifications You must be signed in to change notification settings

thammin/node-bpg

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

node-bpg

A nodejs wrapper that generating bpg image files by using pre-compiled libbpg binary.

For more information about libbpg, please visit (http://bellard.org/bpg/).

Install

Require: node >=6

npm install --save node-bpg

Example

encode .jpg or .png to .bpg

const { encode } = require('node-bpg');
const option = {
  qp: 10, // set quantizer parameter
  level: 9 // select the compression level
};

encode('input.jpg', 'output.bpg', option)
  .then(() => {
    // done
  });

decode .bpg to .png or .ppm

const { decode } = require('node-bpg');
const option = {
  bit_depth: 16 // set bit_depth per component (PNG output only)
};

decode('input.bpg', 'output.png', option)
  .then(() => {
    // done
  });

Options

encode options

qp                set quantizer parameter (smaller gives better quality, range: 0-51, default = 28)
cfmt              set the preferred chroma format (420, 422, 444, default = 420)
color_space       set the preferred color space (ycbcr, rgb, ycgco, ycbcr_bt709, ycbcr_bt2020, default = ycbcr)
bit_depth         set the bit depth (8 to 12, default = 8)
lossless          enable lossless mode
encoder           select the HEVC encoder (jctvc, default = jctvc)
level             select the compression level (1 = fast, 9 = slow, default = 8)

Advanced options:
alphaq            set quantizer parameter for the alpha channel (default = same as qp value)
premul            store the color with premultiplied alpha
limitedrange      encode the color data with the limited range of video
hash              include MD5 hash in HEVC bitstream
keepmetadata      keep the metadata (from JPEG: EXIF, ICC profile, XMP, from PNG: ICC profile)
verbose           show debug messages

or refer to default option.

decode options

bit_depth         PNG output only: use bit_depth per component (8 or 16, default = 8)
information       display information about the image

Test

npm test

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code.

License

MIT

About

A nodejs wrapper that generating bpg image files by using pre-compiled libbpg (http://bellard.org/bpg/).

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published