Skip to main content

Crate glycin

Crate glycin 

Source
Expand description

Glycin allows to decode images into gdk::Textures and to extract image metadata. The decoding happens in sandboxed modular image loaders that have to be provided as binaries. The glycin-utils for more details.

§Example

You need to enable the gdk4 feature for this example to work.

let file = gio::File::for_path("image.jpg");
let image = Loader::new(file).load().await?;

let height = image.details().height();
let texture = image.next_frame().await?.texture();

You can pass the texture of a Frame to gtk4::Image::from_paintable() to display the image.

§External Dependencies

Glycin requires the libraries libglib2.0, liblcms2, libfontconfig, and libseccomp packages to be installed. For the gdk4 feature, libgtk-4 is required as well. To actually work with images, loaders for the respective formats have to be installed. Glycin provides loaders for many formats that are packaged with many distributions. When working in the default sandbox mode, the bwrap binary of bubblewrap is required as well. The required dependencies can usually be installed through commands like

$ apt install libgtk-4-dev liblcms2-dev libfontconfig-dev libseccomp-dev glycin-loaders bubblewrap

on Debian/Ubuntu or

$ dnf install gtk4-devel lcms2-devel fontconfig-devel libseccomp-devel glycin-loaders bubblewrap

on Fedora.

§Features

  • gdk4 — Enables interoperability with gdk4 by enabling to get a gdk::Texture directly.
  • tokio — Makes glycin compatible with zbus using [tokio].

Structs§

BinaryData
Cicp
Coding-independent code points
Creator
Edit
EditableImage
Editor
Image edit builder
EncodedImage
ErrorContext
ErrorCtx
FeatureNotSupported
Frame
A frame of an image often being the complete image
FrameDetails
FrameRequest
Request information to get a specific frame
Image
Image handle containing metadata and allowing frame requests
ImageDetails
Loader
Image request builder
MemoryFormatSelection
Selection of memory formats the API user accepts
NewFrame
Operations
Pool
PoolConfig

Enums§

ColorState
EditOutcome
Whether an image could be changed via the chosen method.
Error
MemoryFormat
Describes the formats the image data can have.
MimeType
Mime type
Operation
OperationId
SandboxMechanism
Sandboxing mechanism for image loading and editing
SandboxSelector
Method by which the SandboxMechanism is selected
SparseEdit
An image change that is potentially sparse.

Constants§

COMPAT_VERSION

Traits§

GetConfig

Functions§

gdk_memory_format