himg 0.0.4 → 0.0.6

data/LICENSE-APACHE.txt

@@ -0,0 +1,203 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+

data/README.md

@@ -2,46 +2,29 @@
 
 You give it HTML and it gives back an image!
 
-Parses a minimal subset of HTML/CSS, fetches nested resources, renders an image on the GPU.
+Parses a minimal subset of HTML/CSS, fetches nested resources, renders an image on the GPU. No browser, no fuss.
 
-Uses rust libraries to do this in a fast, hopefully safe way.
+![Mockup showing HTML being transformed into a WhatsApp preview](/readme_hero.svg)
 
-In Rails this will mean you can process user.himg.erb to display an image including data from a user's profile.
+## Quickstart
 
-## CAVEATS
-
-1. This is **pre-alpha** software, don't expect it to work yet.
-2. Rendering requires a GPU. Awaiting CPU support in vello, which Canva may be working on.
-3. Performance needs tuning. Both in the underlying blitz library and how data is passed between Rust and Ruby
-4. Network requests can be made: don't use this library with untrusted inputs.
-5. file:// URLs are resolved: this could expose files on your computer.
-6. Native extensions are not yet being published for different os/arch
-7. Verbose logging is hardcoded
-
-## Installation
-
-Install the gem and add to the application's Gemfile by executing:
-
-```bash
-bundle add himg
-```
-
-If bundler is not being used to manage dependencies, install the gem by executing:
+### Command Line
 
 ```bash
-gem install himg
+bin/himg screenshot path/to/your.html screenshot.png
+bin/himg screenshot https://github.com/Jamedjo/himg himg.png --width=1024 --verbose --no-truncate
 ```
 
-## Usage
-
 ### Ruby
 
 ```ruby
-png = Himg.render("<html bgcolor='blue'></html>") 
+png = Himg.render("<!DOCTYPE html><body style='background:blue;'></body>")
+File.open("blue.png", "wb"){|f| f.write(png) }
 ```
 
 ```ruby
-png = Himg.render("<h1>Hi</h1>", width: 24, height: 24, truncate: false) 
+png = Himg.render("<!DOCTYPE html><h1>Snapshot</h1>", width: 89, height: 5, truncate: false)
+File.open("dynamic_height.png", "wb"){|f| f.write(png) }
 ```
 
 ### Rails
@@ -52,9 +35,9 @@ Simply add a `show.himg.erb`!
 <div><%= @username %></div>
 ```
 
-### Adding OpenGraph Meta Tags
+### OpenGraph Meta Tags
 
-Once you've added a view template for your resource, you can use it to generate image cards that will be shown when the page is shared on messenger apps or social media.
+OpenGraph tags let messenger apps and social media sites know to use your generated image as a thumbnail card for your website.
 
 ```html
 <meta property="og:title" content="<%= @user.username %>" />
@@ -62,13 +45,62 @@ Once you've added a view template for your resource, you can use it to generate
 <meta property="og:image" content="<%= user_url(@user.username, format: :png) %>" />
 ```
 
-### Advanced Rails Usage
+# Usage
+
+Install the gem and add to the application's Gemfile by executing:
+
+```bash
+bundle add himg
+```
+
+## Configuration
+
+|Option | Description | Type | Default |
+|-|-|-|-|
+|width | Sets the width of the rendered content. | integer | 720 |
+|height | Sets the desired height of the rendered output. | integer | 405 |
+|truncate | Keeps the image height fixed instead of expanding to include the full page | bool | true |
+|verbose | Enables detailed logging for debugging and profiling. | bool | false |
+|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 |
+
 
-A :himg template handler is registered and will be called by rails' `default_render` method automatically when the corresponding view is found. This can be `show.himg` for a static image, or `show.himg.erb` to use variables from the controller.
+### Passing options to a Rails view template
+
+Options can be set at a controller level using the `himg_config` helper method:
+```ruby
+class UsersController < ActionController::Base
+  himg_config(verbose: true)
+end
+```
+
+These can be overridden at a view level:
+```ruby
+class UsersController < ActionController::Base
+  def show
+    himg_config(width: params[:w]) if params[:w]
+
+    @user = User.new
+  end
+```
+
+### Rails manual render
 
 If you prefer you could also use `render himg: "<div>My Data</div>"` instead, but should be careful with untrusted input if constructing HTML manually.
 
-To be explicit in the controler you can also use `respond_to` style:
+Options can then be passed directly to the manual render:
+```ruby
+render himg: '<!DOCTYPE html>', truncate: false
+```
+
+Alternatively you can pass in options which have been set with `himg_config`:
+```ruby
+render himg: '<!DOCTYPE html>', config: himg_config
+```
+
+### Rails `respond_to`
+
+To be explicit in the controller you can also use `respond_to` style:
 
 ```ruby
 respond_to do |format|
@@ -77,6 +109,7 @@ respond_to do |format|
 end
 ```
 
+You can also use this combined with a manual render:
 ```ruby
 respond_to do |format|
   format.html
@@ -85,14 +118,25 @@ respond_to do |format|
 end
 ```
 
-### Run directly from the command line to output an image
+# How it works
 
-```bash
-bundle exec cargo run --example file
-bundle exec cargo run --example file -- path/to/file.html
-```
+No browser, just basics!
+
+Himg calls through to the amazing blitz library, which uses Stylo to parse the CSS, servo/html5ever to parse the HTML, fetches network resources, builds a scene graph and hands over to vello to render an image.
 
-## Development
+Interaction between Ruby & Rust is done with the help of `magnus`, `rb_sys` and lots of glue code from the `oxidize-rb` team.
+
+To play nicely with Rails a template handler is registered, which Rails' `default_render` method automatically calls when the corresponding view is found. This can be `show.himg` for a static image, or `show.himg.erb` to use variables from the controller. Additionally a Renderer is available with `render himg: 'content'` in case a view template is not needed.
+
+## CAVEATS
+
+1. This is **pre-alpha** software, don't expect it to work yet.
+2. Performance needs tuning. Both in the underlying blitz library and how data is passed between Rust and Ruby
+3. Network requests can be made: don't use this library with untrusted inputs. Use `disable_fetch` if you don't need to fetch any resources.
+4. file:// URLs are resolved: this could expose files on your computer. Use `disable_fetch` if you don't need to fetch any resources.
+5. Native extensions are not yet being published for different os/arch
+
+# Development
 
 1. Run `bin/setup` to install dependencies.
 2. Run `rake spec` to run the tests with the default development setup
@@ -104,6 +148,12 @@ bundle exec cargo run --example file -- path/to/file.html
   - 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`.
 
+### Run cargo example directly generate image in Rust
+
+```bash
+bundle exec cargo run --example file
+bundle exec cargo run --example file -- path/to/file.html
+```
 ## Releases
 
 To release a new version:
@@ -116,4 +166,8 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/jamedj
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+Copyright (c) 2025 James Edwards-Jones
+
+This project is dual licenced under both the MIT and Apache 2.0 terms.
+
+See: [MIT License](https://opensource.org/licenses/MIT) and [APACHE 2.0 License](http://www.apache.org/licenses/LICENSE-2.0)

data/ext/himg/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "himg"
 description = "ruby bindings to expose a blitz html->png pipeline"
-version = "0.0.4"
+version = "0.0.6"
 edition = "2024"
 authors = ["James Edwards-Jones <git@jamedjo.co.uk>"]
 license = "MIT"
@@ -14,13 +14,16 @@ crate-type = ["cdylib", "rlib"]
 [dependencies]
 magnus = { version = "0.7.1" }
 rb-sys = { version = "0.9", features = ["stable-api-compiled-fallback"] }
-blitz-traits = { version = "0.1.0-alpha.1" }
-blitz-dom = { version = "0.1.0-alpha.1" }
-blitz-net = { version = "0.1.0-alpha.1" }
-blitz-renderer-vello = { version = "0.1.0-alpha.1" }
-blitz-html = { version = "0.1.0-alpha.1" }
-tokio = { version = "1.42", features =  ["rt-multi-thread", "macros"] }
+blitz-traits = { version = "0.1.0-rc.1" }
+blitz-dom = { version = "0.1.0-rc.1" }
+blitz-net = { version = "0.1.0-rc.1" }
+blitz-paint = { version = "0.1.0-rc.1" }
+anyrender = { version = "0.5.0" }
+anyrender_vello_cpu = { version = "0.5.0" }
+blitz-html = { version = "0.1.0-rc.1" }
+tokio = { version = "1.46", features =  ["rt-multi-thread", "macros"] }
 png = "0.17"
+openssl = { version = "0.10", features = ["vendored"] }
 
 #euclid = { workspace = true }
 #image = { workspace = true }

data/ext/himg/examples/assets/github_profile_offline.html

@@ -0,0 +1,86 @@
+<!DOCTYPE html>
+<html>
+  <head><style type="text/css">.turbo-progress-bar {
+  position: fixed;
+  display: block;
+  top: 0;
+  left: 0;
+  height: 3px;
+  background: #0076ff;
+  z-index: 2147483647;
+  transition:
+    width 300ms ease-out,
+    opacity 150ms 150ms ease-in;
+  transform: translate3d(0, 0, 0);
+}
+  </style>
+    <meta charset="utf-8">
+    <title>nicoburns (Nico Burns)</title>
+
+    <meta name="viewport" content="width=device-width">
+    <meta name="description" content="nicoburns has 79 repositories available. Follow their code on GitHub.">
+    <meta name="hostname" content="github.com">
+    <meta name="expected-hostname" content="github.com">
+    <meta name="theme-color" content="#1e2327">
+    <meta name="color-scheme" content="light dark">
+  </head>
+  <body>
+    <div class="Box d-flex p-3 width-full public source">
+    <div class="pinned-item-list-item-content">
+      <div class="d-flex width-full position-relative">
+        <div class="flex-1">
+            <svg aria-hidden="true" height="16" viewBox="0 0 16 16" version="1.1" width="16" data-view-component="true" class="octicon octicon-repo mr-1 color-fg-muted">
+    <path d="M2 2.5A2.5 2.5 0 0 1 4.5 0h8.75a.75.75 0 0 1 .75.75v12.5a.75.75 0 0 1-.75.75h-2.5a.75.75 0 0 1 0-1.5h1.75v-2h-8a1 1 0 0 0-.714 1.7.75.75 0 1 1-1.072 1.05A2.495 2.495 0 0 1 2 11.5Zm10.5-1h-8a1 1 0 0 0-1 1v6.708A2.486 2.486 0 0 1 4.5 9h8ZM5 12.25a.25.25 0 0 1 .25-.25h3.5a.25.25 0 0 1 .25.25v3.25a.25.25 0 0 1-.4.2l-1.45-1.087a.249.249 0 0 0-.3 0L5.4 15.7a.25.25 0 0 1-.4-.2Z"></path>
+</svg>
+          <span data-view-component="true" class="position-relative"><a data-hydro-click="{&quot;event_type&quot;:&quot;user_profile.click&quot;,&quot;payload&quot;:{&quot;profile_user_id&quot;:1007307,&quot;target&quot;:&quot;PINNED_REPO&quot;,&quot;user_id&quot;:1007307,&quot;originating_url&quot;:&quot;https://github.com/nicoburns&quot;}}" data-hydro-click-hmac="95bab3b0debdfa7d41ff86f71264a58e15a16e2c317afd1444c387724a44f62d" id="464340188" href="/DioxusLabs/blitz" data-view-component="true" class="Link mr-1 text-bold wb-break-word" aria-labelledby="tooltip-7d61525f-6eaa-4bf0-a1c6-b8ec7d17b15b"><span class="owner text-normal">DioxusLabs/</span><span class="repo">blitz</span></a>  <tool-tip id="tooltip-7d61525f-6eaa-4bf0-a1c6-b8ec7d17b15b" for="464340188" popover="manual" data-direction="s" data-type="label" data-view-component="true" class="position-absolute sr-only" aria-hidden="true" role="tooltip" style="--tool-tip-position-top: 1239.265625px; --tool-tip-position-left: 500.75390625px;">DioxusLabs/blitz</tool-tip></span>          <span></span><span class="Label Label--secondary v-align-middle mt-1 no-wrap v-align-baseline Label--inline">Public</span>
+        </div>
+          <div>
+            <input type="hidden" name="pinned_items_id_and_type[]" id="pinned-item-reorder-464340188" value="464340188-Repository" autocomplete="off" class="form-control">
+            <span role="button" class="pinned-item-handle js-pinned-item-reorder" aria-label="Drag to reorder">
+              <svg aria-hidden="true" height="16" viewBox="0 0 16 16" version="1.1" width="16" data-view-component="true" class="octicon octicon-grabber">
+    <path d="M10 13a1 1 0 1 1 0-2 1 1 0 0 1 0 2Zm0-4a1 1 0 1 1 0-2 1 1 0 0 1 0 2Zm-4 4a1 1 0 1 1 0-2 1 1 0 0 1 0 2Zm5-9a1 1 0 1 1-2 0 1 1 0 0 1 2 0ZM7 8a1 1 0 1 1-2 0 1 1 0 0 1 2 0ZM6 5a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z"></path>
+</svg>
+            </span>
+            <button data-direction="up" type="button" data-view-component="true" class="show-on-focus sortable-button js-sortable-button Button--secondary Button--small Button right-0">  <span class="Button-content">
+    <span class="Button-label"><svg aria-label="Move blitz up" role="img" height="16" viewBox="0 0 16 16" version="1.1" width="16" data-view-component="true" class="octicon octicon-chevron-up">
+    <path d="M3.22 10.53a.749.749 0 0 1 0-1.06l4.25-4.25a.749.749 0 0 1 1.06 0l4.25 4.25a.749.749 0 1 1-1.06 1.06L8 6.811 4.28 10.53a.749.749 0 0 1-1.06 0Z"></path>
+</svg></span>
+  </span>
+</button>
+            <button data-direction="down" type="button" data-view-component="true" class="show-on-focus sortable-button js-sortable-button Button--secondary Button--small Button right-0">  <span class="Button-content">
+    <span class="Button-label"><svg aria-label="Move blitz down" role="img" height="16" viewBox="0 0 16 16" version="1.1" width="16" data-view-component="true" class="octicon octicon-chevron-down">
+    <path d="M12.78 5.22a.749.749 0 0 1 0 1.06l-4.25 4.25a.749.749 0 0 1-1.06 0L3.22 6.28a.749.749 0 1 1 1.06-1.06L8 8.939l3.72-3.719a.749.749 0 0 1 1.06 0Z"></path>
+</svg></span>
+  </span>
+</button>
+          </div>
+      </div>
+
+
+      <p class="pinned-item-desc color-fg-muted text-small mt-2 mb-0">
+        A radically modular HTML/CSS rendering engine
+      </p>
+
+      <p class="mb-0 mt-2 f6 color-fg-muted">
+          <span class="d-inline-block mr-3">
+  <span class="repo-language-color" style="background-color: #dea584"></span>
+  <span itemprop="programmingLanguage">Rust</span>
+</span>
+
+          <a href="/DioxusLabs/blitz/stargazers" class="pinned-item-meta Link--muted">
+            <svg aria-label="stars" role="img" height="16" viewBox="0 0 16 16" version="1.1" width="16" data-view-component="true" class="octicon octicon-star">
+    <path d="M8 .25a.75.75 0 0 1 .673.418l1.882 3.815 4.21.612a.75.75 0 0 1 .416 1.279l-3.046 2.97.719 4.192a.751.751 0 0 1-1.088.791L8 12.347l-3.766 1.98a.75.75 0 0 1-1.088-.79l.72-4.194L.818 6.374a.75.75 0 0 1 .416-1.28l4.21-.611L7.327.668A.75.75 0 0 1 8 .25Zm0 2.445L6.615 5.5a.75.75 0 0 1-.564.41l-3.097.45 2.24 2.184a.75.75 0 0 1 .216.664l-.528 3.084 2.769-1.456a.75.75 0 0 1 .698 0l2.77 1.456-.53-3.084a.75.75 0 0 1 .216-.664l2.24-2.183-3.096-.45a.75.75 0 0 1-.564-.41L8 2.694Z"></path>
+</svg>
+            2.2k
+          </a>
+          <a href="/DioxusLabs/blitz/forks" class="pinned-item-meta Link--muted">
+            <svg aria-label="forks" role="img" height="16" viewBox="0 0 16 16" version="1.1" width="16" data-view-component="true" class="octicon octicon-repo-forked">
+    <path d="M5 5.372v.878c0 .414.336.75.75.75h4.5a.75.75 0 0 0 .75-.75v-.878a2.25 2.25 0 1 1 1.5 0v.878a2.25 2.25 0 0 1-2.25 2.25h-1.5v2.128a2.251 2.251 0 1 1-1.5 0V8.5h-1.5A2.25 2.25 0 0 1 3.5 6.25v-.878a2.25 2.25 0 1 1 1.5 0ZM5 3.25a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Zm6.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5Zm-3 8.75a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Z"></path>
+</svg>
+            50
+          </a>
+      </p>
+    </div>
+  </div>
+  </body>
+</html>

data/ext/himg/examples/file.rs

@@ -3,7 +3,7 @@
 use himg::{html_to_image, Options, ImageSize, write_png};
 use himg::logger::{Logger, TimedLogger};
 
-use blitz_traits::{ColorScheme};
+use blitz_traits::shell::{ColorScheme};
 use std::{
     fs::File,
     path::{Path, PathBuf},
@@ -14,14 +14,14 @@ async fn main() {
     let mut logger = TimedLogger::init();
 
     let path_string = std::env::args()
-        .skip(1)
-        .next()
+        .nth(1)
         .unwrap_or_else(|| "./ext/himg/examples/assets/github_profile.html".into());
     println!("Loading {}", path_string);
+    let base_url = format!("file://{}", path_string.clone());
 
     // Fetch HTML from path
     let html = std::fs::read_to_string(&path_string).unwrap();
-    logger.log("Fetched HTML");
+    logger.log("Read HTML");
 
     // Configure viewport dimensions
     let options = Options {
@@ -31,20 +31,21 @@ async fn main() {
             hidpi_scale: 1.0,
         },
         truncate: false,
+        verbose: true,
         color_scheme: ColorScheme::Light,
-        allow_net_requests: true, //TODO: Implement using this
+        disable_fetch: false,
+        base_url: Some(base_url),
     };
 
     // Render to Image
-    let base_url = format!("file://{}", path_string.clone());
-    let buffer = html_to_image(&html, Some(base_url), options, &mut logger).await;
+    let render_output = html_to_image(&html, options, &mut logger).await;
 
     // Determine output path, and open a file at that path.
     let out_path = compute_filename(&path_string);
     let mut file = File::create(&out_path).unwrap();
 
     // Encode buffer as PNG and write it to a file
-    write_png(&mut file, &buffer, options.image_size.scaled_width(), options.image_size.scaled_height()).unwrap();
+    write_png(&mut file, &render_output.buffer, render_output.image_size.scaled_width(), render_output.image_size.scaled_height()).unwrap();
     logger.log("Wrote out png");
 
     logger.log_total_time("\nDone");