fast_thumbhash 0.7.0 → 0.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ca1251a50f86a6d61d03d4aca11a98b30336a72c12f5d5e8a15992c8d694638
-  data.tar.gz: e77931c369a56aec1f619b4da9ef822623d5e0f4e839aab43e88ebc80ad5b748
+  metadata.gz: e30e34927a692280eac28e7a1237d9964ad6899a29ab7268a321df8ea2b9d979
+  data.tar.gz: 39cd14b05a0d0a598ea3f48646c169935cbe17e17a4a2000450833347e4465b6
 SHA512:
-  metadata.gz: 66332f36f6e8d43256725abeb3c6a0e1f59a0cf8601516a3d5d8f6c0820259e7a7c2fa00afa5ece7b7eb834d78fd156407726d135d61e31d16b06a1e33547d52
-  data.tar.gz: cb3673f55f78c9a64b00d5ebe442ff44fa966df878f2bcc1f511a0d7a4ca672412510d55c891afeddf53e65c864f678ea87ffcdbd679f1bcc385d63acc8e78e0
+  metadata.gz: ee54e878ad7002544e568618281784baf2a565aa3f3ea44b0f0918c81b13ea56b849e12ea5c3a7baa7d36b5e94229b015bf256c0c4c23492789e0182bfc6457a
+  data.tar.gz: 9bd9096c25bf0a64999f6a484becae2e075018f3e9bc4a215dd94c4156e4c0319b7ad61ae7ff4d99d9c54cf5551c5e68b08d1d3f7000a1d1977f56816c043cac

data/.ruby-version

@@ -0,0 +1 @@
+2.7.8

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    fast_thumbhash (0.7.0)
+    fast_thumbhash (0.7.2)
       ffi
 
 GEM
@@ -52,6 +52,8 @@ GEM
 
 PLATFORMS
   arm64-darwin-21
+  arm64-darwin-22
+  ruby
   x86_64-darwin-18
   x86_64-darwin-20
   x86_64-darwin-21

data/README.md

@@ -1,3 +1,13 @@
+<!--datocms-autoinclude-header start-->
+
+<a href="https://www.datocms.com/"><img src="https://www.datocms.com/images/full_logo.svg" height="60"></a>
+
+👉 [Visit the DatoCMS homepage](https://www.datocms.com) or see [What is DatoCMS?](#what-is-datocms)
+
+---
+
+<!--datocms-autoinclude-header end-->
+
 # FastThumbhash
 
 [![Ruby](https://github.com/datocms/fast_thumbhash/actions/workflows/main.yml/badge.svg)](https://github.com/datocms/fast_thumbhash/actions/workflows/main.yml)
@@ -124,3 +134,51 @@ The gem is available as open source under the terms of the [MIT License](https:/
 ## Code of Conduct
 
 Everyone interacting in the FastThumbhash project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/datocms/fast_thumbhash/blob/master/CODE_OF_CONDUCT.md).
+
+<!--datocms-autoinclude-footer start-->
+
+---
+
+# What is DatoCMS?
+
+<a href="https://www.datocms.com/"><img src="https://www.datocms.com/images/full_logo.svg" height="60" alt="DatoCMS - The Headless CMS for the Modern Web"></a>
+
+[DatoCMS](https://www.datocms.com/) is the REST & GraphQL Headless CMS for the modern web.
+
+Trusted by over 25,000 enterprise businesses, agencies, and individuals across the world, DatoCMS users create online content at scale from a central hub and distribute it via API. We ❤️ our [developers](https://www.datocms.com/team/best-cms-for-developers), [content editors](https://www.datocms.com/team/content-creators) and [marketers](https://www.datocms.com/team/cms-digital-marketing)!
+
+**Why DatoCMS?**
+
+- **API-First Architecture**: Built for both REST and GraphQL, enabling flexible content delivery
+- **Just Enough Features**: We believe in keeping things simple, and giving you [the right feature-set tools](https://www.datocms.com/features) to get the job done
+- **Developer Experience**: First-class TypeScript support with powerful developer tools
+
+**Getting Started:**
+
+- ⚡️ [Create Free Account](https://dashboard.datocms.com/signup) - Get started with DatoCMS in minutes
+- 🔖 [Documentation](https://www.datocms.com/docs) - Comprehensive guides and API references
+- ⚙️ [Community Support](https://community.datocms.com/) - Get help from our team and community
+- 🆕 [Changelog](https://www.datocms.com/product-updates) - Latest features and improvements
+
+**Official Libraries:**
+
+- [**Content Delivery Client**](https://github.com/datocms/cda-client) - TypeScript GraphQL client for content fetching
+- [**REST API Clients**](https://github.com/datocms/js-rest-api-clients) - Node.js/Browser clients for content management
+- [**CLI Tools**](https://github.com/datocms/cli) - Command-line utilities for schema migrations (includes [Contentful](https://github.com/datocms/cli/tree/main/packages/cli-plugin-contentful) and [WordPress](https://github.com/datocms/cli/tree/main/packages/cli-plugin-wordpress) importers)
+
+**Official Framework Integrations**
+
+Helpers to manage SEO, images, video and Structured Text coming from your DatoCMS projects:
+
+- [**React Components**](https://github.com/datocms/react-datocms)
+- [**Vue Components**](https://github.com/datocms/vue-datocms)
+- [**Svelte Components**](https://github.com/datocms/datocms-svelte)
+- [**Astro Components**](https://github.com/datocms/astro-datocms)
+
+**Additional Resources:**
+
+- [**Plugin Examples**](https://github.com/datocms/plugins) - Example plugins we've made that extend the editor/admin dashboard
+- [**Starter Projects**](https://www.datocms.com/marketplace/starters) - Example website implementations for popular frameworks
+- [**All Public Repositories**](https://github.com/orgs/datocms/repositories?q=&type=public&language=&sort=stargazers)
+
+<!--datocms-autoinclude-footer end-->

data/ext/fast_thumbhash/fast_thumbhash.c

@@ -67,14 +67,20 @@ encoded_channel encode_channel(double *channel, uint8_t nx, uint8_t ny, uint8_t
   return (encoded_channel){dc, ac, ac_length, scale};
 }
 
-void write_varying_factors(double *ac, int ac_size, uint8_t *thumbhash, uint8_t *ac_index) {
-  for (int i = 0; i < ac_size; i++) {
-    uint8_t index = (*ac_index) >> 1;
-    thumbhash[index] |= (uint8_t) roundf(15.0 * ac[i]) << (((*ac_index)++ & 1) << 2);
+uint8_t write_varying_factors(double *ac, int ac_size, uint8_t *thumbhash, uint8_t *ac_index)
+{
+  uint8_t index;
+
+  for (int i = 0; i < ac_size; i++)
+  {
+    index = (*ac_index) >> 1;
+    thumbhash[index] |= (uint8_t)roundf(15.0 * ac[i]) << (((*ac_index)++ & 1) << 2);
   }
+
+  return index;
 }
 
-void rgba_to_thumbhash(uint8_t w, uint8_t h, uint8_t *rgba, uint8_t *thumbhash)
+uint8_t rgba_to_thumbhash(uint8_t w, uint8_t h, uint8_t *rgba, uint8_t *thumbhash)
 {
   assert(w <= 100);
   assert(h <= 100);
@@ -134,8 +140,8 @@ void rgba_to_thumbhash(uint8_t w, uint8_t h, uint8_t *rgba, uint8_t *thumbhash)
 
   // Write the constants
   bool is_landscape = w > h;
-  u_int32_t header24 = (u_int32_t)roundf(63.0 * el.dc) | ((u_int32_t)roundf(31.5 + 31.5 * ep.dc) << 6) | ((u_int32_t)roundf(31.5 + 31.5 * eq.dc) << 12) | ((u_int32_t)roundf(31.0 * el.scale) << 18) | (has_alpha << 23);
-  u_int32_t header16 = (is_landscape ? ly : lx) | ((u_int16_t)roundf(63.0 * ep.scale) << 3) | ((u_int16_t)roundf(63.0 * eq.scale) << 9) | (is_landscape << 15);
+  uint32_t header24 = (uint32_t)roundf(63.0 * el.dc) | ((uint32_t)roundf(31.5 + 31.5 * ep.dc) << 6) | ((uint32_t)roundf(31.5 + 31.5 * eq.dc) << 12) | ((uint32_t)roundf(31.0 * el.scale) << 18) | (has_alpha << 23);
+  uint32_t header16 = (is_landscape ? ly : lx) | ((uint16_t)roundf(63.0 * ep.scale) << 3) | ((uint16_t)roundf(63.0 * eq.scale) << 9) | (is_landscape << 15);
 
   thumbhash[0] = (uint8_t)(header24 & 0xff);
   thumbhash[1] = (uint8_t)((header24 >> 8) & 0xff);
@@ -143,28 +149,44 @@ void rgba_to_thumbhash(uint8_t w, uint8_t h, uint8_t *rgba, uint8_t *thumbhash)
   thumbhash[3] = (uint8_t)(header16 & 0xff);
   thumbhash[4] = (uint8_t)(header16 >> 8);
 
-  if (has_alpha) {
-    thumbhash[5] = (uint8_t) roundf(15.0 * ea.dc) | ((uint8_t) roundf(15.0 * ea.scale) << 4);
+  if (has_alpha)
+  {
+    thumbhash[5] = (uint8_t)roundf(15.0 * ea.dc) | ((uint8_t)roundf(15.0 * ea.scale) << 4);
   }
 
   uint8_t ac_start = has_alpha ? 6 : 5;
   uint8_t ac_index = 0;
 
-  write_varying_factors(el.ac, el.ac_size, thumbhash + ac_start, &ac_index);
-  write_varying_factors(ep.ac, ep.ac_size, thumbhash + ac_start, &ac_index);
-  write_varying_factors(eq.ac, eq.ac_size, thumbhash + ac_start, &ac_index);
+  uint8_t max_written_indexes[] = {0, 0, 0, 0};
+
+  max_written_indexes[0] = write_varying_factors(el.ac, el.ac_size, thumbhash + ac_start, &ac_index);
+  max_written_indexes[1] = write_varying_factors(ep.ac, ep.ac_size, thumbhash + ac_start, &ac_index);
+  max_written_indexes[2] = write_varying_factors(eq.ac, eq.ac_size, thumbhash + ac_start, &ac_index);
 
-  if (has_alpha) {
-    write_varying_factors(ea.ac, ea.ac_size, thumbhash + ac_start, &ac_index);
+  if (has_alpha)
+  {
+    max_written_indexes[3] = write_varying_factors(ea.ac, ea.ac_size, thumbhash + ac_start, &ac_index);
   }
 
   free(el.ac);
   free(ep.ac);
   free(eq.ac);
 
-  if (has_alpha) {
+  if (has_alpha)
+  {
     free(ea.ac);
   }
+
+  // store the largest number at max_written_indexes[0]
+  for (int i = 1; i < 4; ++i)
+  {
+    if (max_written_indexes[0] < max_written_indexes[i])
+    {
+      max_written_indexes[0] = max_written_indexes[i];
+    }
+  }
+
+  return max_written_indexes[0] + ac_start + 1;
 }
 
 double *decode_channel(uint8_t nx, uint8_t ny, double scale, uint8_t *hash, uint8_t ac_start, uint8_t *ac_index)
@@ -321,19 +343,18 @@ void hsv2rgb(float *hsv, uint8_t *rgb)
  * Decodes a ThumbHash to an RGBA image. RGB is not be premultiplied by A.
  */
 void thumbhash_to_rgba(
-  uint8_t *hash,
-  uint8_t w,
-  uint8_t h,
-  enum FillMode fill_mode,
-  uint8_t *fill_color,
-  double *homogeneous_transform,
-  int saturation,
-  uint8_t *rgba
-)
+    uint8_t *hash,
+    uint8_t w,
+    uint8_t h,
+    enum FillMode fill_mode,
+    uint8_t *fill_color,
+    double *homogeneous_transform,
+    int saturation,
+    uint8_t *rgba)
 {
   // Read the constants
-  u_int32_t header24 = hash[0] | (hash[1] << 8) | (hash[2] << 16);
-  u_int32_t header16 = hash[3] | (hash[4] << 8);
+  uint32_t header24 = hash[0] | (hash[1] << 8) | (hash[2] << 16);
+  uint32_t header16 = hash[3] | (hash[4] << 8);
   double l_dc = (double)(header24 & 63) / 63;
   double p_dc = (double)((header24 >> 6) & 63) / 31.5 - 1;
   double q_dc = (double)((header24 >> 12) & 63) / 31.5 - 1;
@@ -343,7 +364,8 @@ void thumbhash_to_rgba(
   double q_scale = (double)((header16 >> 9) & 63) / 63;
   bool is_landscape = (header16 >> 15) != 0;
   uint8_t lx = fmax(3, is_landscape ? has_alpha ? 5 : 7 : header16 & 7);
-  uint8_t ly = fmax(3, is_landscape ? header16 & 7 : has_alpha ? 5 : 7);
+  uint8_t ly = fmax(3, is_landscape ? header16 & 7 : has_alpha ? 5
+                                                               : 7);
   double a_dc = (double)has_alpha ? (hash[5] & 15) / 15 : 1;
   double a_scale = (double)(hash[5] >> 4) / 15;
 
@@ -359,7 +381,7 @@ void thumbhash_to_rgba(
   // Decode using the DCT into RGB
   double fx[7];
   double fy[7];
-  u_int32_t i = 0;
+  uint32_t i = 0;
 
   for (uint8_t ry = 0; ry < h; ry++)
   {
@@ -380,7 +402,8 @@ void thumbhash_to_rgba(
 
       double r, g, b, a;
 
-      if (fill_mode == CLAMP || fill_mode == BLUR) {
+      if (fill_mode == CLAMP || fill_mode == BLUR)
+      {
         if (x < 0)
         {
           x = 0;
@@ -401,7 +424,8 @@ void thumbhash_to_rgba(
 
       bool inside_image = x >= 0 && x <= 1.0 && y >= 0 && y <= 1.0;
 
-      if (inside_image) {
+      if (inside_image)
+      {
         double l = l_dc, p = p_dc, q = q_dc;
         a = a_dc;
 
@@ -455,7 +479,9 @@ void thumbhash_to_rgba(
         b = l - 2.0 / 3.0 * p;
         r = (3.0 * l - b + q) / 2.0;
         g = r - q;
-      } else {
+      }
+      else
+      {
         r = 255;
         g = 255;
         b = 255;
@@ -463,35 +489,37 @@ void thumbhash_to_rgba(
       }
 
       uint_fast8_t top[4] = {
-        fmax(0, 255 * fmin(1, r)),
-        fmax(0, 255 * fmin(1, g)),
-        fmax(0, 255 * fmin(1, b)),
-        fmax(0, 255 * fmin(1, a))
-      };
-
-      if (fill_color && fill_color[3] > 0) {
-        double top_a = (double) top[3] / 255.0;
-        double fill_color_a = (double) fill_color[3] / 255.0;
+          fmax(0, 255 * fmin(1, r)),
+          fmax(0, 255 * fmin(1, g)),
+          fmax(0, 255 * fmin(1, b)),
+          fmax(0, 255 * fmin(1, a))};
+
+      if (fill_color && fill_color[3] > 0)
+      {
+        double top_a = (double)top[3] / 255.0;
+        double fill_color_a = (double)fill_color[3] / 255.0;
         double inverse_top_a = 1.0 - top_a;
         double sum_a = top_a + fill_color_a * inverse_top_a;
 
         // Alpha compositing (top over fill_color)
-        rgba[i]   = roundf(((double) top[0] * top_a + (double) fill_color[0] * fill_color_a * inverse_top_a) / sum_a);
-        rgba[i+1] = roundf(((double) top[1] * top_a + (double) fill_color[1] * fill_color_a * inverse_top_a) / sum_a);
-        rgba[i+2] = roundf(((double) top[2] * top_a + (double) fill_color[2] * fill_color_a * inverse_top_a) / sum_a);
-        rgba[i+3] = roundf(sum_a * 255.0);
-      } else {
-        rgba[i]   = top[0];
-        rgba[i+1] = top[1];
-        rgba[i+2] = top[2];
-        rgba[i+3] = top[3];
+        rgba[i] = roundf(((double)top[0] * top_a + (double)fill_color[0] * fill_color_a * inverse_top_a) / sum_a);
+        rgba[i + 1] = roundf(((double)top[1] * top_a + (double)fill_color[1] * fill_color_a * inverse_top_a) / sum_a);
+        rgba[i + 2] = roundf(((double)top[2] * top_a + (double)fill_color[2] * fill_color_a * inverse_top_a) / sum_a);
+        rgba[i + 3] = roundf(sum_a * 255.0);
+      }
+      else
+      {
+        rgba[i] = top[0];
+        rgba[i + 1] = top[1];
+        rgba[i + 2] = top[2];
+        rgba[i + 3] = top[3];
       }
 
       if (saturation)
       {
         float hsv[3] = {0};
         rgb2hsv(rgba + i, hsv);
-        float mult = ((float) saturation + 100.0f) / 200.0f * 1.4f;
+        float mult = ((float)saturation + 100.0f) / 200.0f * 1.4f;
         hsv[1] = fminf(fmaxf(hsv[1] * mult, 0), 1.0f);
         hsv2rgb(hsv, rgba + i);
       }

data/ext/fast_thumbhash/fast_thumbhash.h

@@ -3,34 +3,32 @@
 
 #include <stdint.h>
 
-enum FillMode {
+enum FillMode
+{
   SOLID = 0,
   BLUR = 1,
   CLAMP = 2,
 };
 
-void rgba_to_thumbhash(
-  uint8_t w,
-  uint8_t h,
-  uint8_t *rgba,
-  uint8_t *thumbhash
-);
+uint8_t rgba_to_thumbhash(
+    uint8_t w,
+    uint8_t h,
+    uint8_t *rgba,
+    uint8_t *thumbhash);
 
 void thumb_size(
-  uint8_t *hash,
-  uint8_t max_size,
-  uint8_t *size
-);
+    uint8_t *hash,
+    uint8_t max_size,
+    uint8_t *size);
 
 void thumbhash_to_rgba(
-  uint8_t *hash,
-  uint8_t w,
-  uint8_t h,
-  enum FillMode fill_mode,
-  uint8_t *fill_color,
-  double *homogeneous_transform,
-  int saturation,
-  uint8_t *rgba
-);
+    uint8_t *hash,
+    uint8_t w,
+    uint8_t h,
+    enum FillMode fill_mode,
+    uint8_t *fill_color,
+    double *homogeneous_transform,
+    int saturation,
+    uint8_t *rgba);
 
 #endif

data/lib/fast_thumbhash/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FastThumbhash
-  VERSION = "0.7.0"
+  VERSION = "0.7.2"
 end

data/lib/fast_thumbhash.rb

@@ -155,10 +155,9 @@ module FastThumbhash
 
     thumbhash_pointer = FFI::MemoryPointer.new(:uint8, 25)
 
-    Library.rgba_to_thumbhash(width, height, rgba_pointer, thumbhash_pointer)
+    length = Library.rgba_to_thumbhash(width, height, rgba_pointer, thumbhash_pointer)
 
-    result = thumbhash_pointer.read_array_of_uint8(25)
-    result.pop while result.last.zero?
+    result = thumbhash_pointer.read_array_of_uint8(length)
 
     result.pack("C*")
   ensure
@@ -178,6 +177,6 @@ module FastThumbhash
 
     attach_function :thumb_size, %i[pointer uint8 pointer], :size_t
     attach_function :thumbhash_to_rgba, %i[pointer uint8 uint8 fill_mode pointer pointer int pointer], :void
-    attach_function :rgba_to_thumbhash, %i[uint8 uint8 pointer pointer], :void
+    attach_function :rgba_to_thumbhash, %i[uint8 uint8 pointer pointer], :uint8
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fast_thumbhash
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.7.2
 platform: ruby
 authors:
 - Stefano Verna
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-04-11 00:00:00.000000000 Z
+date: 2025-04-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -35,6 +35,7 @@ extra_rdoc_files: []
 files:
 - ".rspec"
 - ".rubocop.yml"
+- ".ruby-version"
 - CODE_OF_CONDUCT.md
 - Gemfile
 - Gemfile.lock