Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
impro
Advanced tools
Changelog
v0.14.2 (2023-12-18)
Readme
An image processing engine integrating multiple conversion libraries.
Impro allows specifying the operations to apply to images and will select the correct conversion library to perform the job itself.
This library supports and is tested against node version 14 and above and includes support for the following image conversion tools:
- gifsicle (npm install gifsicle@^5.3.0)
- gm (npm install gm-papandreou@^1.23.0-patch1)
- inkscape (npm install inkscape@^3.0.0)
- jpegtran (npm install jpegtran@^2.0.0)
- optipng (npm install optipng@^4.0.0)
- pngcrush (npm install pngcrush@^3.0.0)
- pngquant (npm install pngquant@^4.0.0)
- sharp (npm install sharp@~0.32.0)
- svgfilter (npm install svgfilter@^4.1.0)
callers must install the libraries and if present they will be enabled
Impro is desgined so that users can express what they want to do to an image of a given type rather than how to do it. Given a series of tranformations, the library will select one or more libraries to use to turn the input image into the desired output and processing is done while fully streaming data.
Image processing has typically involved command line tools which are often supplied a set of command line arguments that act as a series of instructions for the properties of the image being output and any series of transformations to apply. Each of these options is modelled as an "operation".
An operation is a named constraint (property or transformation) that an output image must conform to after it is applied.
An engine is a representation a particular image library that supports a certain set of operations on images of certain types.
A pipeline is a programmed series operations that will be executed by one or more engines to turn an image from the input to the desired output.
The impro
library can be installed simply from npm:
npm install impro
The standard configuration of impro is an instance that is configured with support for all supported engines - but the presence of the image libraries is detected which means they must be installed alongside. Each library has a node module of the same name (with the exception of gm as noted above):
npm install sharp
npm install gifsicle
some of the libraries may have requirements on native packages that must be installed via an operating system package manager
By default an import of impro returns an object with all registered engines that is ready to start handling conversion operations. To do this, we create a pipeline which we instruct about what it will do to an image.
The prepared pipeline is a Duplex stream that is ready to have the input image data piped to it and will stream the output image data out of itself:
const impro = require('impro');
const pipeline = impro.createPipeline({ type: 'png' }).jpeg();
For example, the pipeline above expect to recieve a PNG input image and will convert it to a JPEG using the chaining API.
The pipeline exposes methods for each operation that can be supported on a
method. Above, the .jpeg()
is a conversion operation to the JPEG type.
Let's look at another example:
const impro = require('impro');
impro
.createPipeline({ type: 'png' })
.grayscale()
.resize(100, 100)
.jpeg()
.progressive();
This will accept a PNG, convert it to a grayscale image, resize it and finally output it as a JPEG that is interlaced. The chaining API is intended as the standard end-user interface that exposes the full power of the library in a simple and transparent fashion.
For cases where impro is used as a library another API is exposed which is also used internally and underlies chaining methods: an operations list.
Each named operation is itself a small object containing a name and array of the arguments (zero or more) that are provided to it. These operations are placed in an array and can be passed directly when creating a pipeline:
const impro = require('impro');
const pipeline = impro.createPipeline({ type: 'png' }, [
{ name: 'grayscale', args: [] },
{ name: 'resize', args: [100, 100] },
{ name: 'jpeg', args: [] },
{ name: 'progressive', args: [] },
]);
The pipeline above is equivalent to the chaining API example.
Impro is licensed under a standard 3-clause BSD license.
FAQs
Image processing engine
The npm package impro receives a total of 7,067 weekly downloads. As such, impro popularity was classified as popular.
We found that impro demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.