image-blob-reduce - downscale blobs with images inside
Wrapper for pica to work with blobs, with
some sugar.
This is a pica wrapper for convenient work with images from file input fields.
While pica works with raw bitmaps, this package operates with "image files".
Additional features are:
[jpeg] Apply orientation to the downscaled result.
[jpeg] Keep metadata, but with patched orientation and the original color
profile removed.
pica - a pica instance, if you want different defaults or a shared
web worker pool.
.toBlob(in_blob, options) => Promise(out_blob)
Downscale an image so its width and height fit within max*max pixels. For
example, { max: 1000 } limits the longest side to 1000 px; it does not limit
the output blob size in bytes. If the blob contains a JPEG, orientation is
applied and metadata from the original image is reused (with minimal changes).
Inject your custom handler before the specified method. See the .setup()
source code for an example.
.after(method_name, hook_fn)
The same as .before(), but the handler is injected after the specified
method.
.use(plugin_init, ...params) => this
Sugar to simplify the assignment of external plugins. Just calls
plugin_init(this, ...params).
.setup()
Configure the instance before first use. By default, installs the built-in JPEG
hooks. Override this method if you need to install custom plugins, add hooks or
replace pipeline methods before processing starts.
Reexports
import imageBlobReduce, { ImageBlobReduce, image_traverse, pica, Pica } from 'image-blob-reduce'
imageBlobReduce - default factory.
ImageBlobReduce - reducer constructor.
image_traverse - JPEG traversal helpers.
pica - pica factory.
Pica - pica constructor.
Legacy static fields are available only in UMD build:
window.imageBlobReduce.ImageBlobReduce
window.imageBlobReduce.image_traverse
window.imageBlobReduce.pica
window.imageBlobReduce.Pica
Customization
Since it's difficult to implement all possible options, this package is
specially designed for easy customization. See the source code first.
You can inherit from the class & replace existing methods.
You can add extra actions before/after existing methods.
You can override existing methods of an instance.
For example, if you wish to force output to always be JPEG with a certain
quality: