133 Releases 304 Tags

RSS Feed

• v0.5.7 40bb58d603

  Compare

  pict-rs 0.5.7 Stable

  asonix released this 2024-03-03 17:35:32 +00:00 | 58 commits to main since this release

  pict-rs 0.5.7

  Overview

  pict-rs 0.5.7 adds support for generating blurhashes from images and includes a couple unrelated
  fixes and tweaks.

  Features

  • Blurhash Endpoint

  Changes

  • File Path Changes
  • Performance Improvements

  Fixes

  • More Consistent Errors
  • APNG Detection

  Upgrade Notes

  There is a small repo format migration between 0.5.6 and 0.5.7. For sled it's simply opening a new
  tree, for postgres it involves adding a new column to the hashes table. These changes will
  automatically apply when launching pict-rs 0.5.7. Upgrading should be as simple as pulling a new
  version of pict-rs.

  Descriptions

  Blurhash Endpoint

  A new endpoint at /image/blurhash has been added for generating blurhashes from uploaded media. A
  blurhash is a short string that encodes a few notable color values from an image that can be
  reconstructed into a blurred approximation of the original image. Notably, blurhashes are used by
  Mastodon to act as placeholders for sensitive media. For more information about blurhashes, see
  blurha.sh.

  This endpoint is powered by my new blurhash encoding library,
  blurhash-update.

  On success, the blurhash endpoint returns the following JSON.

  {
      "msg": "ok",
      "blurhash": "LGF5]+Yk^6#M@-5c,1J5@[or[Q6."
  }
  

  pict-rs does not provide a blurhash decoding mechanism (it would defeat the purpose of blurhashes to
  do so).

  File Path Changes

  pict-rs has dropped its dependency on my storage-path-generator library in favor of using UUIDs to
  create unique file paths for uploaded media. This means that newly uploaded media will be stored in
  a different directory structure, and with different filenames. The purpose of this is to reduce
  database use by removing the need to synchronize the current path state.

  pict-rs 0.5.7 also adds file extensions back to file paths, since they are now somewhat-publicly
  visible (when using the public_endpoint configuration with object storage).

  Neither of these changes affect previously uploaded media.

  Performance Improvements

  pict-rs 0.5.7 now buffers media in memory less frequently, opting to stream bytes directly from
  sources to sinks. This should improve general memory use, as well as decrease time pict-rs would
  spend waiting to aggregate bytes.

  pict-rs also no longer requires bytes be present in contiguous buffers, avoiding large allocations
  and reducing memcpys.

  More Consistent Errors

  pict-rs 0.5 introduced machine-readable error codes that returned alongside error messages, but
  there were a couple locations in pict-rs that failed to include them. pict-rs 0.5.7 resolves this,
  ensuring all error paths properly return codes.

  APNG Detection

  pict-rs 0.5.7 fixes the imagemagick delegate policy for ffmpeg, which allows for properly detecting
  certain media, notably APNG files. pict-rs should once again be able to properly handle uploaded
  APNGs.

  Downloads

  • Source code (ZIP)
  • Source code (TAR.GZ)

  ---

  • pict-rs-linux-amd64
    12 downloads · 31 MiB
  • pict-rs-linux-arm32v7
    6 downloads · 26 MiB
  • pict-rs-linux-arm64v8
    5 downloads · 27 MiB