Grayness

A package providing simple image editing capabilities via a WASM plugin.

Available functionality includes converting images to grayscale, cropping and flipping the images.
Furthermore, this package supports adding transparency and bluring (very slow) as well as handling additional raster image formats.

The package name is inspired by the blurry, gray images of Nessie, the Loch Ness Monster

Usage

Due to the way Typst interprets given paths, you cannot specify the path to a file as string directly. Instead, you have to either read the images yourself in the calling Typst file or provide the direction to the file with the path-type. This imagedata can then be passed to the grayness-package functions, like image-grayscale(). These functions also optionally accept all additional parameters of the original Typst image function like width or height:

#import "@preview/grayness:0.7.0": image-grayscale

#let data = path("Arturo_Nieto-Dorantes.webp")
#image-grayscale(data, width: 50%)

A detailed descriptions of all available functions is provided in the manual.

You can also use the built-in help functions provided by tidy:

#import "@preview/grayness:0.7.0": *
#help("image-flip-vertical")

All functions except image-mask() and image-infos() also work with SVG images. To do so you must specify the format as "svg":

#let data = read("gallardo.svg", encoding: none)
#image-grayscale(data, format: "svg")

Examples

Here are several functions applied to a WEBP image of Arturo Nieto Dorantes (CC-By-SA 4.0):

Limitations

The functions provided in this package are quite slow and only serve as a prove of concept. You really should use dedicated image processing software to edit and potentially convert your source images into a format Typst understands natively.