himg 0.0.7-x86_64-linux → 0.0.9-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bed823fd9d5ba8791ae12bdacace4bb92da56f1c122fc2aba437cc437f684bce
-  data.tar.gz: a91740d9afabdee17a0f72f9b02d0eb82b4947196fbaedc9bbe02468ce84bebb
+  metadata.gz: 84e5a750a119fc3c6d273978acf294962bdb6e08ef871c2eab40355416f8c1ca
+  data.tar.gz: bb16a11c4c39b69a8d6f8ebd29fbe2d58e261751220244f8a7e0831ea91e7035
 SHA512:
-  metadata.gz: 83a3eae4446d2eaa8581400b70f407b766809aae750915a8aa5378dbbfef6bfd6a94f4620dc77705eb02a5de213a69faddbfd08d003cf745e9b22697d4ff32cf
-  data.tar.gz: 28a44bf950037cfaf2db016d97ff07918edff3877e0f6fc789769ea51de47b903309b0e0e06770f6b50338f4ddfb4b5319b5698a2ac63ba887c29cbd9568810b
+  metadata.gz: 14350b0e1fca9acc21a180e7d15771af7cf08f48258738b8fe8598f5747d3d0ddee1bfc1b5b565d387be847f89a5825cd21b0f6aadb54eae2d7607a06c04afc9
+  data.tar.gz: bbe2fb632e9c7c0b9d31c0966f28690931d129bca69b2bc96e0ed373838128557f346ba1ff01e6d8f38c4b6d2608f33fe9836f5a7d02be2e6e0b72310d31d245

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 ## [Unreleased]
 
+
+## [0.0.9] - 2025-07-31
+
+- Returned to CPU-only rendering by default
+- Added `gpu` option to enable GPU rendering 
+- Updated to latest blitz to fix blue/green colour swap on images
+
+## [0.0.8] - 2025-07-31
+
+- Return to GPU rendering by default: quality is low with CPU rendering.
+- Compile native Apple darwin/macos gems for intel and arm.
+- Remove debug symbols saving 315MB on the binary size.
+
 ## [0.0.7] - 2025-07-29
 
 - Added `fetch_timeout` option to control restrict how long can be spent fetching resources.
@@ -7,6 +20,8 @@
 
 ## [0.0.6] - 2025-07-23
 
+- Updates to latest blitz
+- Renders on CPU instead of GPU (experimental)
 - Added bin/himg CLI screenshot tool
 - Added `base_url` option for configuring relative paths
 - Added `disable_fetch` option for security hardening

data/README.md

@@ -2,7 +2,7 @@
 
 You give it HTML and it gives back an image!
 
-Parses a minimal subset of HTML/CSS, fetches nested resources, renders an image. No browser, no fuss.
+Parses HTML/CSS, fetches nested resources, renders an image. No browser, no fuss.
 
 Perfect for OpenGraph images - stop losing clicks to boring links by adding a rich image preview that showcases your content.
 
@@ -13,6 +13,7 @@ Perfect for OpenGraph images - stop losing clicks to boring links by adding a ri
 ### Command Line
 
 ```bash
+gem install himg
 himg screenshot path/to/your.html screenshot.png
 himg screenshot https://github.com/Jamedjo/himg himg.png --width=1024 --verbose --no-truncate
 ```
@@ -66,6 +67,7 @@ bundle add himg
 |base_url | Where relative paths are relative to for linked resources (stylesheets, images, fonts, etc) | string | nil |
 |disable_fetch | Disables fetching linked resources from disk and network| bool | false |
 |fetch_timeout | Timeout in seconds for fetching resources | float | 10.0 |
+|gpu | Use GPU renderer instead of CPU renderer | bool | false |
 
 
 ### Passing options to a Rails view template
@@ -121,6 +123,72 @@ respond_to do |format|
 end
 ```
 
+# Supported HTML and CSS
+
+Himg supports a large subset of the HTML and CSS you'd need to get by, but not all elements or properties are supported.
+
+For a full list, see our [snapshot of the blitz.is status page](https://github.com/Jamedjo/himg/issues/2).
+
+If something you'd like supported is missing and is available [upstream on blitz](https://blitz.is/status), please [open an issue](https://github.com/Jamedjo/himg/issues/new).
+
+|HTML|Status|
+|-|-|
+|`Generic HTML5 elements`|✅ Supported|
+|`<style>`|✅ Supported|
+|`<link rel="stylesheet">`|✅ Supported|
+|`<link rel="icon">`|❌ Not supported|
+|`<img src="">`|✅ Supported|
+|`<img srcset="">`|❌ Not supported|
+|`<picture>`|❌ Not supported|
+|`<svg>`|⚠️ [Partial support](https://github.com/Jamedjo/himg/issues/2)|
+|`<h1>-<h6>`|✅ Supported|
+|`<ul>/<ol>`|✅ Supported|
+|`<i>/<em>`|✅ Supported|
+|`<b>/<strong>`|✅ Supported|
+|`<u>`|✅ Supported|
+|`<center>`|✅ Supported|
+|`<pre>/<blockquote>`|✅ Supported|
+|`<a>`|✅ Supported|
+|`<br>`|✅ Supported|
+|`<hr>`|❌ Not supported|
+|`<details>/<summary>`|❌ Not supported|
+|`<table>`|⚠️ [Partial support](https://github.com/Jamedjo/himg/issues/2)|
+|`Form Controls`|⚠️ [Partial support](https://github.com/Jamedjo/himg/issues/2)|
+
+|CSS|Status|
+|-|-|
+|`display:inline, display:block, display:inline-block`|✅ Supported|
+|`display:none`|✅ Supported|
+|`display:flex`|✅ Supported|
+|`display:grid`|⚠️ [Partial support](https://github.com/Jamedjo/himg/issues/2)|
+|`display:table`|⚠️ [Partial support](https://github.com/Jamedjo/himg/issues/2)|
+|`display:contents`|❌ Not supported|
+|`position:relative, position:absolute`|✅ Supported|
+|`position:static, position:fixed, position:sticky`|❌ Not supported|
+|`overflow`|⚠️ [Partial support](https://github.com/Jamedjo/himg/issues/2)|
+|`z-index`|⚠️ [Partial support](https://github.com/Jamedjo/himg/issues/2)|
+|`box-sizing`|✅ Supported|
+|`float`|❌ Not supported|
+|`content (::before / ::after)`|⚠️ [Partial support](https://github.com/Jamedjo/himg/issues/2)|
+|`opacity,  visibility`|✅ Supported|
+|`width, height`|✅ Supported|
+|`min-width, max-width, min-height, max-height`|✅ Supported|
+|`padding, margin, gap`|✅ Supported|
+|`border`|⚠️ [Partial support](https://github.com/Jamedjo/himg/issues/2)|
+|`@font-face, font-size, font-family`|✅ Supported|
+|`font-weight, font-style, font-stretch`|✅ Supported|
+|`font-display, font-variant, font-feature-settings`|❌ Not supported|
+|`color, text-align, line-height, text-decoration`|✅ Supported|
+|`letter-spacing, overlap-wrap, word-wrap, word-break`|✅ Supported|
+|`vertical-align, text-transform, text-overflow`|❌ Not supported|
+|`border`|⚠️ [Partial support](https://github.com/Jamedjo/himg/issues/2)|
+|`background-color, background-image`|✅ Supported|
+|`background-size, background-position`|✅ Supported|
+|`background-repeat, background-clip, background-origin`|✅ Supported|
+|`background-attachment`|❌ Not supported|
+|`box-shadow`|✅ Supported|
+|`filter`|❌ Not supported|
+
 # How it works
 
 No browser, just basics!
@@ -150,6 +218,7 @@ To play nicely with Rails a template handler is registered, which Rails' `defaul
   - http://localhost:3000/users/jamedjo.himg will also render the same png
   - http://localhost:3000/users/jamedjo will render an HTML page with opengraph meta tags
 6. To install this gem onto your local machine, run `bundle exec rake install`.
+7. To simulate a headless server environment without a GPU, use `WGPU_BACKEND=empty bundle exec rspec`
 
 ### Run cargo example directly generate image in Rust
 

data/lib/himg/cli.rb

@@ -12,6 +12,7 @@ module Himg
     option :verbose, type: :boolean, desc: "Enables detailed logging for debugging and profiling.", default: false
     option :disable_fetch, type: :boolean, desc: "Skip fetching file/http resources (stylesheets, images, fonts, etc)", default: false
     option :fetch_timeout, type: :numeric, desc: "Timeout in seconds for fetching resources", default: 10
+    option :gpu, type: :boolean, desc: "Use GPU renderer instead of CPU renderer", default: false
     option :http_headers, desc: "HTTP Headers to use when fetching remote resource"
     option :base_url, desc: "Base URL used to resolve relative URLs"
 

data/lib/himg/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Himg
-  VERSION = "0.0.7"
+  VERSION = "0.0.9"
 end

data/lib/himg.rb

@@ -17,10 +17,10 @@ end
 #
 # Converts HTML to an Image for a minimal subset of HTML and CSS
 module Himg
-  RENDER_OPTIONS = %i[width height truncate verbose].freeze
+  RENDER_OPTIONS = %i[width height truncate verbose base_url disable_fetch fetch_timeout gpu].freeze
   class Error < StandardError; end
 
-  def self.render(html, width: 720, height: 405, truncate: true, verbose: false, base_url: nil, disable_fetch: false, fetch_timeout: 10)
-    render_to_string(html, "width" => width.to_i, "height" => height.to_i, "truncate" => truncate, "verbose" => verbose, "base_url" => BaseUrl.new(base_url).to_s, "disable_fetch" => disable_fetch, "fetch_timeout" => fetch_timeout.to_f)
+  def self.render(html, width: 720, height: 405, truncate: true, verbose: false, base_url: nil, disable_fetch: false, fetch_timeout: 10, gpu: false)
+    render_to_string(html, "width" => width.to_i, "height" => height.to_i, "truncate" => truncate, "verbose" => verbose, "base_url" => BaseUrl.new(base_url).to_s, "disable_fetch" => disable_fetch, "fetch_timeout" => fetch_timeout.to_f, "gpu" => gpu)
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: himg
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.9
 platform: x86_64-linux
 authors:
 - James Edwards-Jones
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-07-29 00:00:00.000000000 Z
+date: 2025-07-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: appraisal
@@ -173,6 +173,7 @@ files:
 - gemfiles/rails_8.gemfile.lock
 - lib/himg.rb
 - lib/himg/3.2/himg.so
+- lib/himg/3.3/himg.so
 - lib/himg/3.4/himg.so
 - lib/himg/base_url.rb
 - lib/himg/cli.rb