Compare commits

...

80 Commits

Author SHA1 Message Date
Stephen Sykes
a992939223 Include all the new files in the gem 2025-01-03 16:28:50 +00:00
Stephen Sykes
cce874f025
Merge pull request #155 from sdsykes/feature-refactoring
Split and refactor code + fixes
2025-01-03 12:30:20 +02:00
Stephen Sykes
4c06b15fa8 Update changelog and version 2025-01-03 10:26:28 +00:00
Stephen Sykes
7f6a50c6a4 Use more backward compatible unpack 2025-01-03 10:05:02 +00:00
Stephen Sykes
ba61a28d14 Remove entirely base64 dependency 2025-01-03 10:00:17 +00:00
Stephen Sykes
729438e55b Remove the base64 version altogether for compat 2025-01-02 21:21:18 +00:00
Stephen Sykes
d69288b504 Reduce base64 version requirement to support earlier rubies 2025-01-02 21:03:19 +00:00
Stephen Sykes
b6720dfdf7
Merge pull request #157 from mataku/base64-gem-warning
Add base64 as a dependency explicitly for Ruby 3.4.0 support
2025-01-02 22:58:09 +02:00
Stephen Sykes
499865e47a Test on ruby 3.4 2025-01-02 20:45:43 +00:00
Stephen Sykes
cad7175e06 Handle tiff format with long dimension values, fixes #158 2025-01-02 20:25:48 +00:00
Stephen Sykes
a891d8f43a Raise error correctly on bad url scheme, fixes #156 2025-01-02 19:44:19 +00:00
Takuma Homma
2c8539d503
Add base64 as a dependency explicitly for Ruby 3.4.0 support
ref. https://www.ruby-lang.org/en/news/2023/12/25/ruby-3-3-0-released/
2024-11-07 15:07:17 +09:00
Stephen Sykes
e7d8111784 Update checkout step 2024-04-06 16:41:04 +03:00
Stephen Sykes
ae60942b73 Upgrade actions steps, add v3.3 2024-04-06 16:37:56 +03:00
Stephen Sykes
a5e4052dd5 Incorporate lazy property fetching 2024-04-06 15:52:46 +03:00
Stephen Sykes
b50c834fad Split and refactor 2024-04-01 21:20:53 +03:00
Stephen Sykes
054f563321 Update supported file list 2024-04-01 19:45:21 +03:00
Stephen Sykes
df84ad4c8d
Merge pull request #154 from sdsykes/feature-add-jxl-support
Add initial jxl support
2024-04-01 19:30:21 +03:00
Stephen Sykes
8d02ae8257 Update version and changelog 2024-04-01 19:23:55 +03:00
Stephen Sykes
d1b1936b1d Add initial jxl support 2024-04-01 16:12:27 +03:00
Stephen Sykes
8495352ffe
Merge pull request #153 from sdsykes/fix-net-reader-error
Ensure nil is returned from dead fibers, fixes #152
2024-03-28 20:25:54 +02:00
Stephen Sykes
36ac12790d Rails Unknown if we run out of chars in an xml 2024-03-28 20:16:38 +02:00
Stephen Sykes
7de7faf8a3 Ensure nil is returned from dead fibers 2024-03-28 19:53:58 +02:00
Stephen Sykes
7d86b403b0 Fix maintainer 2024-03-24 17:16:34 +02:00
Stephen Sykes
99ac7d6df1 Minor fix to readme 2024-03-24 17:11:20 +02:00
Stephen Sykes
c5f76d0de2 Updat docuementation. Fixes #151 2024-03-24 17:08:06 +02:00
Stephen Sykes
f832581881 Fix file names 2023-12-24 12:02:45 +02:00
Stephen Sykes
c763b215cf Release 2.3.0 2023-12-24 12:01:26 +02:00
Stephen Sykes
8994844702 Fix readme badges 2023-09-29 10:11:58 +03:00
Stephen Sykes
b730e6b470 Update URLs 2023-09-29 10:05:26 +03:00
Stephen Sykes
413bd34c00
Merge pull request #147 from sandstrom/master-1
Update README
2023-09-29 09:46:15 +03:00
Stephen Sykes
6266b26b87 Add test for meta after mdat for heic 2023-09-28 17:28:33 +03:00
Stephen Sykes
02d70df8c1
Merge pull request #145 from ClearlyClaire/fixes/HEIC-meta-after-mdat
Handle large-size ISO_BMFF boxes and meta-after-mdat
2023-09-28 17:25:31 +03:00
Stephen Sykes
1fcc6c89ea
Merge pull request #144 from c960657/animated-gif
Add animated? support for png images
2023-09-28 16:47:31 +03:00
Stephen Sykes
71469cb64f Fix missing stringio require 2023-09-28 16:19:19 +03:00
Stephen Sykes
edf9558114 Update test paths for working ones 2023-09-28 16:18:59 +03:00
Stephen Sykes
c69d230098 Fix workflow for older rubies 2023-09-28 15:21:10 +03:00
Stephen Sykes
d515546a1d
Merge pull request #142 from dokioco/large-svg-header
Handle SVG files that have extra cruft at the start
2023-09-28 15:13:00 +03:00
Stephen Sykes
23989af8f9
Merge pull request #146 from nishidayuya/fix_cve_2012_2027_test_data
Fix CVE-2012-2027 vulnerability on test data
2023-09-28 15:04:21 +03:00
sandstrom
1a249b9e6d
Rename to README.md 2023-08-24 14:43:39 +02:00
sandstrom
22bdc7ba06
Update README.textile 2023-08-24 14:41:56 +02:00
Yuya.Nishida
2d546f4520 run: git cococo docker run -it --rm -v ./test/fixtures:/data alpine:3.18.3 sh -eux -c 'apk add --no-cache imagemagick && convert /data/test2.tiff /tmp/fixed-test2.tiff && mv /tmp/fixed-test2.tiff /data/test2.tiff' 2023-08-10 11:58:42 +09:00
Claire
7c49d67439 Handle large-size ISO_BMFF boxes and meta-after-mdat
Fixes #140
2023-08-07 14:12:59 +02:00
Christian Schmidt
fb319cda6e unpack1 is not supported on Ruby < 2.4 2023-08-06 21:55:00 +02:00
Christian Schmidt
3fdd1767f5 Add parse_animated_for_png 2023-08-03 23:36:50 +02:00
Alan Harper
7056a4b6c9 Handle SVG files that have extra cruft at the start 2023-05-29 12:31:35 +10:00
Sam
81b5b7d3df
Merge pull request #141 from xfalcox/animated_for_webp_and_avif
FEATURE: Adds animated? support for webp and avif images
2023-05-24 08:47:57 +10:00
Rafael dos Santos Silva
419bafca36
Smaller animated webp fixture file 2023-05-23 11:08:53 -03:00
Rafael dos Santos Silva
cb336762af
Version bump 2023-05-22 17:30:49 -03:00
Rafael dos Santos Silva
5528ef98d4
FEATURE: Adds animated? support for webp and avif images 2023-05-22 17:26:20 -03:00
Sam
b65d75c8a3
Merge pull request #139 from sdsykes/fix/NoMethodError
Handle nil being passed as uri
2023-04-11 11:26:30 +10:00
Stephen Sykes
e5266ff249 Handle nil being passed as uri
Fixes #138
2023-04-07 09:52:23 +03:00
Stephen Sykes
f8d0b37e95
Merge pull request #137 from orien/github-actions
Use GitHub Actions for CI
2023-01-17 08:01:16 +01:00
Orien Madgwick
c295d5da98 Use GitHub Actions for CI 2023-01-16 22:36:55 +11:00
Sam Saffron
6478cd33ac
bump version to 2.2.6 2021-12-16 11:21:35 +11:00
Sam
abd8059bd9
Merge pull request #135 from stefanoverna/avif-format
Add support for AVIF format
2021-12-16 11:17:38 +11:00
Stefano Verna
1a3e525c1d Add support for AVIF format 2021-12-15 14:52:24 +01:00
Sam Saffron
a1131d15bb
Bump version and introduce version file 2021-08-10 12:57:31 +10:00
Sam
f6559105f1
Merge pull request #131 from stefanoverna/fix-heic-rotation-angle
Use irot box to get HEIC/HEIF rotation angle
2021-08-09 15:31:46 +10:00
Stefano Verna
6025bd8819 Use irot box to get HEIC/HEIF rotation angle 2021-08-06 15:56:06 +02:00
Sam Saffron
4bdc514249
Changelog and version bump
Add a CHANGELOG to track changed to the library (only covering changes from
2.2.3 for now)

Add bundle/gem_tasks to make publishing the gem easier

Bump version to 2.2.4
2021-06-02 16:39:46 +10:00
Stephen Sykes
f0ea7da025
Merge pull request #126 from jbrw/master
Identify SVG files that start with a BOM character
2021-04-19 08:54:01 +03:00
Jamie Wilson
5dd8301141
Identify SVG files that start with a BOM character 2021-04-13 18:07:59 -04:00
Stephen Sykes
31ea417d8e
Merge pull request #125 from stefanoverna/heic-format
Add support for HEIC format
2021-04-05 14:59:30 +01:00
Stefano Verna
50b1631ae9 Prefer if modifier to postfix or condition 2021-03-15 08:48:47 +01:00
Stefano Verna
cd3ee0a624 Compat: %i[] is not available on Ruby 1.9 2021-03-03 12:37:13 +01:00
Stefano Verna
f2efc8c6c9 Compat: #unpack1 is not available on older Ruby versions 2021-03-03 09:25:34 +01:00
Stefano Verna
9baee6d1b3 Add FastImage::SUPPORTED_IMAGE_TYPES
Returns all the image formats FastImage is capable to recognize
2021-03-02 16:41:11 +01:00
Stefano Verna
58dcc3072f HEIC/HEIF format detection 2021-03-02 15:07:12 +01:00
Stephen Sykes
9a1400ebcc Bump version 2021-02-28 17:08:39 +02:00
Stephen Sykes
e72139ae17
Merge pull request #124 from stefanoverna/pr_svg
Identify svg files that start with white spaces
2021-02-28 16:52:42 +02:00
Fabrizio Monti
fcf871e637 Identify svg files that start with white spaces 2021-02-16 10:26:31 +01:00
Stephen Sykes
a440798854 Bump patch version 2021-01-30 19:23:34 +02:00
Stephen Sykes
e8ad2254e8 Test with Ruby 3 2021-01-30 15:42:00 +02:00
Stephen Sykes
98dcf9e491 Ignore pesky ds store files 2021-01-30 15:40:35 +02:00
Stephen Sykes
fd3b5f2c4c
Merge pull request #123 from Nakilon/master
force_encoding was called on Net::ReadAdapter when url is webmocked
fixes #121
2021-01-30 13:02:48 +02:00
Stephen Sykes
ddf9f25cef
Merge pull request #122 from nbianca/fix_gif
Fix GIF global color table flag check
2021-01-30 13:01:45 +02:00
Victor Maslov
437318220b force_encoding was called on Net::ReadAdapter when url is webmocked 2021-01-30 12:41:27 +03:00
Bianca Nenciu
e4c35d951e
Add an animated GIF without a global color table 2021-01-27 22:03:06 +02:00
Bianca Nenciu
c78578c097
Fix GIF global color table flag check
Zero is a truthy value, which is a problem when checking flags.
2021-01-21 17:20:51 +02:00
55 changed files with 1760 additions and 1037 deletions

45
.github/workflows/test.yml vendored Normal file
View File

@ -0,0 +1,45 @@
---
name: Tests
on: [ push, pull_request ]
jobs:
test:
name: Test (Ruby ${{ matrix.ruby }})
runs-on: ubuntu-latest
strategy:
fail-fast: false
matrix:
ruby:
- '2.3'
- '2.4'
- '2.5'
- '2.6'
- '2.7'
- '3.0'
- '3.1'
- '3.2'
- '3.3'
- '3.4'
steps:
- uses: actions/checkout@v4
- uses: ruby/setup-ruby@v1
with:
ruby-version: ${{ matrix.ruby }}
bundler-cache: true
- run: bundle exec rake
test_old_ruby:
name: Test (Ruby ${{ matrix.ruby }})
runs-on: ubuntu-20.04
strategy:
fail-fast: false
matrix:
ruby:
- '2.0'
- '2.1'
- '2.2'
steps:
- uses: actions/checkout@v4
- uses: ruby/setup-ruby@v1
with:
ruby-version: ${{ matrix.ruby }}
bundler-cache: true
- run: bundle exec rake

1
.gitignore vendored
View File

@ -1,2 +1,3 @@
pkg/
Gemfile.lock
.DS_Store

View File

@ -1,12 +0,0 @@
language: ruby
cache: bundler
rvm:
- 1.9
- 2.0
- 2.1
- 2.2
- 2.3
- 2.4
- 2.5
- 2.6
- 2.7

48
CHANGELOG Normal file
View File

@ -0,0 +1,48 @@
Version 2.4.0
03-Jan-2025
- IMPROVED: Refactor code into multiple files
- FIX: error rising from redirects to unknown url scheme
- FIX: Handle tiff format with long dimensions values
- FIX: Remove problematic dependency on base64 gem
- IMPROVED: properties including content_length are fetched more lazily improving performance
Version 2.3.1
01-Apr-2024
- FIX: avoid bug where a NoMethodError exception is raised on faulty images
Version 2.3.0
24-Dec-2023
- FIX: replace test tiff that triggers Clam-AV
- FIX: certain heif files could not be parsed
- FEATURE: Adds animated support for png
Version 2.2.7
23-May-2023
- FEATURE: Adds animated? support for webp and avif images
Version 2.2.6
16-December-2021
- FEATURE: Add support for AVIF support
Version 2.2.5
10-August-2021
- FIX: handle HEIC/HEIF rotation angle
Version 2.2.4
02-June-2021
- FEATURE: Added support for HEIC format
- FIX: Support SVG files that start with a BOM character

205
README.md Normal file
View File

@ -0,0 +1,205 @@
[![https://rubygems.org/gems/fastimage](https://img.shields.io/gem/dt/fastimage.svg)](https://rubygems.org/gems/fastimage)
[![https://github.com/sdsykes/fastimage/actions/workflows/test.yml](https://github.com/sdsykes/fastimage/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/sdsykes/fastimage/actions/workflows/test.yml)
# FastImage
**FastImage finds the size or type of an image given its uri by fetching as little as needed**
## The problem
Your app needs to find the size or type of an image. This could be for adding width and height attributes to an image tag, for adjusting layouts or overlays to fit an image or any other of dozens of reasons.
But the image is not locally stored - it's on another asset server, or in the cloud - at Amazon S3 for example.
You don't want to download the entire image to your app server - it could be many tens of kilobytes, or even megabytes just to get this information. For most common image types (GIF, PNG, BMP etc.), the size of the image is simply stored at the start of the file. For JPEG files it's a little bit more complex, but even so you do not need to fetch much of the image to find the size.
FastImage does this minimal fetch for image types GIF, JPEG, PNG, TIFF, BMP, ICO, CUR, PSD, SVG, WEBP and JXL. And it doesn't rely on installing external libraries such as RMagick (which relies on ImageMagick or GraphicsMagick) or ImageScience (which relies on FreeImage).
You only need supply the uri, and FastImage will do the rest.
## Features
- Reads local (and other) files - anything that is not parseable as a URI will be interpreted as a filename, and - will attempt to open it with `File#open`.
- Automatically reads from any object that responds to `:read` - for instance an IO object if that is passed instead of a URI.
- Follows up to 4 HTTP redirects to get the image.
- Obey the `http_proxy` setting in your environment to route requests via a proxy. You can also pass a `:proxy` argument if you want to specify the proxy address in the call.
- Add a timeout to the request which will limit the request time by passing `:timeout => number_of_seconds`.
- Returns `nil` if it encounters an error, but you can pass `:raise_on_failure => true` to get an exception.
- Provides a reader for the content length header provided in HTTP. This may be useful to assess the file size of an image, but do not rely on it exclusively - it will not be present in chunked responses for instance.
- Accepts additional HTTP headers. This can be used to set a user agent or referrer which some servers require. Pass an `:http_header` argument to specify headers, e.g., `:http_header => {'User-Agent' => 'Fake Browser'}`.
- Gives you information about the parsed display orientation of an image with Exif data (jpeg or tiff).
- Handles [Data URIs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs) correctly.
## Security
Take care to sanitise the strings passed to FastImage; it will try to read from whatever is passed.
## Examples
```ruby
require 'fastimage'
FastImage.size("https://switchstep.com/images/ios.gif")
=> [196, 283] # width, height
FastImage.type("http://switchstep.com/images/ss_logo.png")
=> :png
FastImage.type("/some/local/file.gif")
=> :gif
File.open("/some/local/file.gif", "r") {|io| FastImage.type(io)}
=> :gif
FastImage.size("http://switchstep.com/images/favicon.ico", :raise_on_failure=>true, :timeout=>0.01)
=> raises FastImage::ImageFetchFailure
FastImage.size("http://switchstep.com/images/favicon.ico", :raise_on_failure=>true, :timeout=>2)
=> [16, 16]
FastImage.size("http://switchstep.com/images/faulty.jpg", :raise_on_failure=>true)
=> raises FastImage::SizeNotFound
FastImage.new("http://switchstep.com/images/ss_logo.png").content_length
=> 4679
FastImage.size("http://switchstep.com/images/ss_logo.png", :http_header => {'User-Agent' => 'Fake Browser'})
=> [300, 300]
FastImage.new("http://switchstep.com/images/ExifOrientation3.jpg").orientation
=> 3
FastImage.size("data:image/gif;base64,R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==")
=> [1, 1]
```
## Installation
### Gem
```sh
gem install fastimage
```
### Bundler
Add fastimage to your Gemfile.
```ruby
gem 'fastimage'
```
Then you're off - just use `FastImage.size()` and `FastImage.type()` in your code as in the examples.
## Documentation
http://sdsykes.github.io/fastimage/rdoc/FastImage.html
## Maintainer
FastImage is maintained by Stephen Sykes (sdsykes). SamSaffron also helps out from time to time (thanks!).
## Benchmark
It's way faster than conventional methods for most types of file when fetching over the wire. Compared here by using OpenURI which will fetch the whole file.
```ruby
require 'benchmark'
require 'fastimage'
require 'open-uri'
uri = "http://upload.wikimedia.org/wikipedia/commons/b/b4/Mardin_1350660_1350692_33_images.jpg"
puts Benchmark.measure {URI.open(uri, 'rb') {|fh| p FastImage.size(fh)}}
[9545, 6623]
0.059088 0.067694 0.126782 ( 0.808131)
puts Benchmark.measure {p FastImage.size(uri)}
[9545, 6623]
0.006198 0.001563 0.007761 ( 0.162021)
```
The file is fetched in about 0.8 seconds in this test (the number in brackets is the total time taken), but as FastImage doesn't need to fetch the whole thing, it completes in 0.16s.
You'll see similar excellent results for the other file types.
```ruby
require 'benchmark'
require 'fastimage'
require 'open-uri'
uri = "https://upload.wikimedia.org/wikipedia/commons/a/a9/Augustine_Herrman_1670_Map_Virginia_Maryland.tiff"
puts Benchmark.measure {URI.open(uri, 'rb') {|fh| p FastImage.size(fh)}}
[12805, 10204]
1.332587 2.049915 3.382502 ( 19.925270)
puts Benchmark.measure {p FastImage.size(uri)}
[12805, 10204]
0.004593 0.000924 0.005517 ( 0.100592)
```
Some tiff files however do not have their metadata near the start of the file.
```ruby
require 'benchmark'
require 'fastimage'
require 'open-uri'
uri = "https://upload.wikimedia.org/wikipedia/commons/1/14/Center-Filled_LIMA.tif"
puts Benchmark.measure {URI.open(uri, 'rb') {|fh| p FastImage.size(fh)}}
[22841, 19404]
0.350304 0.321104 0.671408 ( 3.053605)
puts Benchmark.measure {p FastImage.size(uri)}
[22841, 19404]
0.163443 0.214301 0.377744 ( 2.880414)
```
Note that if you want a really fast result for this file type, [image_size](https://github.com/toy/image_size?tab=readme-ov-file#experimental-fetch-image-meta-from-http-server) might be useful as it has an optimisation for this (fetching only the needed data range).
```ruby
require 'benchmark'
require 'image_size/uri'
require 'fastimage'
uri = "https://upload.wikimedia.org/wikipedia/commons/1/14/Center-Filled_LIMA.tif"
puts Benchmark.measure {p ImageSize.url(uri).size }
[22841, 19404]
0.008983 0.001311 0.010294 ( 0.128986)
puts Benchmark.measure {p FastImage.size(uri)}
[22841, 19404]
0.163443 0.214301 0.377744 ( 2.880414)
```
## Tests
You'll need to bundle, or `gem install fakeweb` and possibly also `gem install test-unit` to be able to run the tests.
```sh
ruby test/test.rb
```
## References
- [Pennysmalls - Find jpeg dimensions fast in pure Ruby, no image library needed](http://pennysmalls.wordpress.com/2008/08/19/find-jpeg-dimensions-fast-in-pure-ruby-no-ima/)
- [Antti Kupila - Getting JPG dimensions with AS3 without loading the entire file](https://www.anttikupila.com/archive/getting-jpg-dimensions/)
- [imagesize gem](https://rubygems.org/gems/imagesize)
- [EXIF Reader](https://github.com/remvee/exifr)
## FastImage in other languages
- [Python by bmuller](https://github.com/bmuller/fastimage)
- [Swift by kaishin](https://github.com/kaishin/ImageScout)
- [Go by rubenfonseca](https://github.com/rubenfonseca/fastimage)
- [PHP by tommoor](https://github.com/tommoor/fastimage)
- [Node.js by ShogunPanda](https://github.com/ShogunPanda/fastimage)
- [Objective C by kylehickinson](https://github.com/kylehickinson/FastImage)
- [Android by qstumn](https://github.com/qstumn/FastImageSize)
- [Flutter by ky1vstar](https://github.com/ky1vstar/fastimage.dart)
### Also of interest
- [C++ by xiaozhuai](https://github.com/xiaozhuai/imageinfo)
- [Rust by xiaozhuai](https://github.com/xiaozhuai/imageinfo-rs)
## Licence
MIT, see file "MIT-LICENSE"

View File

@ -1,163 +0,0 @@
!https://img.shields.io/gem/dt/fastimage.svg!:https://rubygems.org/gems/fastimage
!https://travis-ci.org/sdsykes/fastimage.svg?branch=master!:https://travis-ci.org/sdsykes/fastimage
h1. FastImage
h4. FastImage finds the size or type of an image given its uri by fetching as little as needed
h2. The problem
Your app needs to find the size or type of an image. This could be for adding width and height attributes to an image tag, for adjusting layouts or overlays to fit an image or any other of dozens of reasons.
But the image is not locally stored - it's on another asset server, or in the cloud - at Amazon S3 for example.
You don't want to download the entire image to your app server - it could be many tens of kilobytes, or even megabytes just to get this information. For most common image types (GIF, PNG, BMP etc.), the size of the image is simply stored at the start of the file. For JPEG files it's a little bit more complex, but even so you do not need to fetch much of the image to find the size.
FastImage does this minimal fetch for image types GIF, JPEG, PNG, TIFF, BMP, ICO, CUR, PSD, SVG and WEBP. And it doesn't rely on installing external libraries such as RMagick (which relies on ImageMagick or GraphicsMagick) or ImageScience (which relies on FreeImage).
You only need supply the uri, and FastImage will do the rest.
h2. Features
FastImage can also read local (and other) files - anything that is not parseable as a URI will be interpreted as a filename, and FastImage will attempt to open it with @File#open@.
FastImage will also automatically read from any object that responds to @:read@ - for instance an IO object if that is passed instead of a URI.
FastImage will follow up to 4 HTTP redirects to get the image.
FastImage will obey the @http_proxy@ setting in your environment to route requests via a proxy. You can also pass a @:proxy@ argument if you want to specify the proxy address in the call.
You can add a timeout to the request which will limit the request time by passing @:timeout => number_of_seconds@.
FastImage normally replies with @nil@ if it encounters an error, but you can pass @:raise_on_failure => true@ to get an exception.
FastImage also provides a reader for the content length header provided in HTTP. This may be useful to assess the file size of an image, but do not rely on it exclusively - it will not be present in chunked responses for instance.
FastImage accepts additional HTTP headers. This can be used to set a user agent or referrer which some servers require. Pass an @:http_header@ argument to specify headers, e.g., @:http_header => {'User-Agent' => 'Fake Browser'}@.
FastImage can give you information about the parsed display orientation of an image with Exif data (jpeg or tiff).
FastImage also handles "Data URIs":https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs correctly.
h2. Security
As of v1.6.7 FastImage no longer uses @openuri@ to open files, but directly calls @File.open@. Take care to sanitise the strings passed to FastImage; it will try to read from whatever is passed.
h2. Examples
<pre lang="ruby"><code>
require 'fastimage'
FastImage.size("http://stephensykes.com/images/ss.com_x.gif")
=> [266, 56] # width, height
FastImage.type("http://stephensykes.com/images/pngimage")
=> :png
FastImage.type("/some/local/file.gif")
=> :gif
FastImage.size("http://upload.wikimedia.org/wikipedia/commons/b/b4/Mardin_1350660_1350692_33_images.jpg", :raise_on_failure=>true, :timeout=>0.1)
=> FastImage::ImageFetchFailure: FastImage::ImageFetchFailure
FastImage.size("http://upload.wikimedia.org/wikipedia/commons/b/b4/Mardin_1350660_1350692_33_images.jpg", :raise_on_failure=>true, :timeout=>2.0)
=> [9545, 6623]
FastImage.new("http://stephensykes.com/images/pngimage").content_length
=> 432
FastImage.size("http://stephensykes.com/images/ss.com_x.gif", :http_header => {'User-Agent' => 'Fake Browser'})
=> [266, 56]
FastImage.new("http://stephensykes.com/images/ExifOrientation3.jpg").orientation
=> 3
FastImage.size("data:image/gif;base64,R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==")
=> [1, 1]
</code></pre>
h2. Installation
h4. Required Ruby version
FastImage version 2.0.0 and above work with Ruby 1.9.2 and above.
FastImage version 1.9.0 was the last version that supported Ruby 1.8.7.
h4. Gem
bc. gem install fastimage
h4. Rails
Add fastimage to your Gemfile, and bundle.
bc. gem 'fastimage'
Then you're off - just use @FastImage.size()@ and @FastImage.type()@ in your code as in the examples.
h2. Documentation
"http://sdsykes.github.io/fastimage/rdoc/FastImage.html":http://sdsykes.github.io/fastimage/rdoc/FastImage.html
h2. Maintainer
FastImage is maintained by Stephen Sykes (@sdsykes). Support this project by using "LibPixel":https://libpixel.com cloud based image resizing and processing service.
h2. Benchmark
It's way faster than conventional methods (for example the image_size gem) for most types of file when fetching over the wire.
<pre lang="ruby"><code>
irb> uri = "http://upload.wikimedia.org/wikipedia/commons/b/b4/Mardin_1350660_1350692_33_images.jpg"
irb> puts Benchmark.measure {open(uri, 'rb') {|fh| p ImageSize.new(fh).size}}
[9545, 6623]
0.680000 0.250000 0.930000 ( 7.571887)
irb> puts Benchmark.measure {p FastImage.size(uri)}
[9545, 6623]
0.010000 0.000000 0.010000 ( 0.090640)
</code></pre>
The file is fetched in about 7.5 seconds in this test (the number in brackets is the total time taken), but as FastImage doesn't need to fetch the whole thing, it completes in less than 0.1s.
You'll see similar excellent results for the other file types, except for TIFF. Unfortunately TIFFs tend to have their
metadata towards the end of the file, so it makes little difference to do a minimal fetch. The result shown below is
mostly dependent on the exact internet conditions during the test, and little to do with the library used.
<pre lang="ruby"><code>
irb> uri = "http://upload.wikimedia.org/wikipedia/commons/1/11/Shinbutsureijoushuincho.tiff"
irb> puts Benchmark.measure {open(uri, 'rb') {|fh| p ImageSize.new(fh).size}}
[1120, 1559]
1.080000 0.370000 1.450000 ( 13.766962)
irb> puts Benchmark.measure {p FastImage.size(uri)}
[1120, 1559]
3.490000 3.810000 7.300000 ( 11.754315)
</code></pre>
h2. Tests
You'll need to @gem install fakeweb@ and possibly also @gem install test-unit@ to be able to run the tests.
bc.. $ ruby test.rb
Run options:
# Running tests:
Finished tests in 1.033640s, 23.2189 tests/s, 82.2337 assertions/s.
24 tests, 85 assertions, 0 failures, 0 errors, 0 skips
h2. References
* "Pennysmalls - Find jpeg dimensions fast in pure Ruby, no image library needed":http://pennysmalls.wordpress.com/2008/08/19/find-jpeg-dimensions-fast-in-pure-ruby-no-ima/
* "Antti Kupila - Getting JPG dimensions with AS3 without loading the entire file":http://www.anttikupila.com/flash/getting-jpg-dimensions-with-as3-without-loading-the-entire-file/
* "imagesize gem":https://rubygems.org/gems/imagesize
* "EXIF Reader":https://github.com/remvee/exifr
h2. FastImage in other languages
* "Python by bmuller":https://github.com/bmuller/fastimage
* "Swift by kaishin":https://github.com/kaishin/ImageScout
* "Go by rubenfonseca":https://github.com/rubenfonseca/fastimage
* "PHP by tommoor":https://github.com/tommoor/fastimage
* "Node.js by ShogunPanda":https://github.com/ShogunPanda/fastimage
* "Objective C by kylehickinson":https://github.com/kylehickinson/FastImage
* "Android by qstumn":https://github.com/qstumn/FastImageSize
* "Flutter by ky1vstar":https://github.com/ky1vstar/fastimage.dart
h2. Licence
MIT, see file "MIT-LICENSE":MIT-LICENSE

View File

@ -1,5 +1,8 @@
# frozen_string_literal: true
require "rdoc/task"
require 'rake/testtask'
require "rake/testtask"
require "bundler/gem_tasks"
# Generate documentation
Rake::RDocTask.new do |rd|

View File

@ -1,20 +1,20 @@
require_relative "lib/fastimage/version"
Gem::Specification.new do |s|
s.name = %q{fastimage}
s.version = "2.2.1"
s.version = FastImage::VERSION
s.required_ruby_version = '>= 1.9.2'
s.authors = ["Stephen Sykes"]
s.date = %q{2020-07-23}
s.description = %q{FastImage finds the size or type of an image given its uri by fetching as little as needed.}
s.email = %q{sdsykes@gmail.com}
s.extra_rdoc_files = [
"README.textile"
"README.md"
]
s.files = [
"MIT-LICENSE",
"README.textile",
"lib/fastimage.rb",
]
"README.md"
] + Dir.glob("lib/**/*")
s.homepage = %q{http://github.com/sdsykes/fastimage}
s.rdoc_options = ["--charset=UTF-8"]
s.require_paths = ["lib"]

View File

@ -9,7 +9,7 @@
# No external libraries such as ImageMagick are used here, this is a very lightweight solution to
# finding image information.
#
# FastImage knows about GIF, JPEG, BMP, TIFF, ICO, CUR, PNG, PSD, SVG and WEBP files.
# FastImage knows about GIF, JPEG, BMP, TIFF, ICO, CUR, PNG, HEIC/HEIF, AVIF, PSD, SVG, WEBP and JXL files.
#
# FastImage can also read files from the local filesystem by supplying the path instead of a uri.
# In this case FastImage reads the file in chunks of 256 bytes until
@ -35,17 +35,17 @@
# === Examples
# require 'fastimage'
#
# FastImage.size("http://stephensykes.com/images/ss.com_x.gif")
# => [266, 56]
# FastImage.type("http://stephensykes.com/images/pngimage")
# FastImage.size("https://switchstep.com/images/ios.gif")
# => [196, 283]
# FastImage.type("http://switchstep.com/images/ss_logo.png")
# => :png
# FastImage.type("/some/local/file.gif")
# => :gif
# File.open("/some/local/file.gif", "r") {|io| FastImage.type(io)}
# => :gif
# FastImage.new("http://stephensykes.com/images/pngimage").content_length
# => 432
# FastImage.new("http://stephensykes.com/images/ExifOrientation3.jpg").orientation
# FastImage.new("http://switchstep.com/images/ss_logo.png").content_length
# => 4679
# FastImage.new("http://switchstep.com/images/ExifOrientation3.jpg").orientation
# => 3
#
# === References
@ -59,8 +59,11 @@ require 'net/https'
require 'delegate'
require 'pathname'
require 'zlib'
require 'base64'
require 'uri'
require 'stringio'
require_relative 'fastimage/fastimage'
require_relative 'fastimage/version'
# see http://stackoverflow.com/questions/5208851/i/41048816#41048816
if RUBY_VERSION < "2.2"
@ -68,836 +71,3 @@ if RUBY_VERSION < "2.2"
DEFAULT_PARSER = Parser.new(:HOSTNAME => "(?:(?:[a-zA-Z\\d](?:[-\\_a-zA-Z\\d]*[a-zA-Z\\d])?)\\.)*(?:[a-zA-Z](?:[-\\_a-zA-Z\\d]*[a-zA-Z\\d])?)\\.?")
end
end
class FastImage
attr_reader :size, :type, :content_length, :orientation, :animated
attr_reader :bytes_read
class FastImageException < StandardError # :nodoc:
end
class UnknownImageType < FastImageException # :nodoc:
end
class ImageFetchFailure < FastImageException # :nodoc:
end
class SizeNotFound < FastImageException # :nodoc:
end
class CannotParseImage < FastImageException # :nodoc:
end
DefaultTimeout = 2 unless const_defined?(:DefaultTimeout)
LocalFileChunkSize = 256 unless const_defined?(:LocalFileChunkSize)
# Returns an array containing the width and height of the image.
# It will return nil if the image could not be fetched, or if the image type was not recognised.
#
# By default there is a timeout of 2 seconds for opening and reading from a remote server.
# This can be changed by passing a :timeout => number_of_seconds in the options.
#
# If you wish FastImage to raise if it cannot size the image for any reason, then pass
# :raise_on_failure => true in the options.
#
# FastImage knows about GIF, JPEG, BMP, TIFF, ICO, CUR, PNG, PSD, SVG and WEBP files.
#
# === Example
#
# require 'fastimage'
#
# FastImage.size("http://stephensykes.com/images/ss.com_x.gif")
# => [266, 56]
# FastImage.size("http://stephensykes.com/images/pngimage")
# => [16, 16]
# FastImage.size("http://farm4.static.flickr.com/3023/3047236863_9dce98b836.jpg")
# => [500, 375]
# FastImage.size("http://www-ece.rice.edu/~wakin/images/lena512.bmp")
# => [512, 512]
# FastImage.size("test/fixtures/test.jpg")
# => [882, 470]
# FastImage.size("http://pennysmalls.com/does_not_exist")
# => nil
# FastImage.size("http://pennysmalls.com/does_not_exist", :raise_on_failure=>true)
# => raises FastImage::ImageFetchFailure
# FastImage.size("http://stephensykes.com/favicon.ico", :raise_on_failure=>true)
# => [16, 16]
# FastImage.size("http://stephensykes.com/images/squareBlue.icns", :raise_on_failure=>true)
# => raises FastImage::UnknownImageType
# FastImage.size("http://stephensykes.com/favicon.ico", :raise_on_failure=>true, :timeout=>0.01)
# => raises FastImage::ImageFetchFailure
# FastImage.size("http://stephensykes.com/images/faulty.jpg", :raise_on_failure=>true)
# => raises FastImage::SizeNotFound
#
# === Supported options
# [:timeout]
# Overrides the default timeout of 2 seconds. Applies both to reading from and opening the http connection.
# [:raise_on_failure]
# If set to true causes an exception to be raised if the image size cannot be found for any reason.
#
def self.size(uri, options={})
new(uri, options).size
end
# Returns an symbol indicating the image type fetched from a uri.
# It will return nil if the image could not be fetched, or if the image type was not recognised.
#
# By default there is a timeout of 2 seconds for opening and reading from a remote server.
# This can be changed by passing a :timeout => number_of_seconds in the options.
#
# If you wish FastImage to raise if it cannot find the type of the image for any reason, then pass
# :raise_on_failure => true in the options.
#
# === Example
#
# require 'fastimage'
#
# FastImage.type("http://stephensykes.com/images/ss.com_x.gif")
# => :gif
# FastImage.type("http://stephensykes.com/images/pngimage")
# => :png
# FastImage.type("http://farm4.static.flickr.com/3023/3047236863_9dce98b836.jpg")
# => :jpeg
# FastImage.type("http://www-ece.rice.edu/~wakin/images/lena512.bmp")
# => :bmp
# FastImage.type("test/fixtures/test.jpg")
# => :jpeg
# FastImage.type("http://stephensykes.com/does_not_exist")
# => nil
# File.open("/some/local/file.gif", "r") {|io| FastImage.type(io)}
# => :gif
# FastImage.type("test/fixtures/test.tiff")
# => :tiff
# FastImage.type("test/fixtures/test.psd")
# => :psd
#
# === Supported options
# [:timeout]
# Overrides the default timeout of 2 seconds. Applies both to reading from and opening the http connection.
# [:raise_on_failure]
# If set to true causes an exception to be raised if the image type cannot be found for any reason.
#
def self.type(uri, options={})
new(uri, options.merge(:type_only=>true)).type
end
# Returns a boolean value indicating the image is animated.
# It will return nil if the image could not be fetched, or if the image type was not recognised.
#
# By default there is a timeout of 2 seconds for opening and reading from a remote server.
# This can be changed by passing a :timeout => number_of_seconds in the options.
#
# If you wish FastImage to raise if it cannot find the type of the image for any reason, then pass
# :raise_on_failure => true in the options.
#
# === Example
#
# require 'fastimage'
#
# FastImage.animated?("test/fixtures/test.gif")
# => false
# FastImage.animated?("test/fixtures/animated.gif")
# => true
#
# === Supported options
# [:timeout]
# Overrides the default timeout of 2 seconds. Applies both to reading from and opening the http connection.
# [:raise_on_failure]
# If set to true causes an exception to be raised if the image type cannot be found for any reason.
#
def self.animated?(uri, options={})
new(uri, options.merge(:animated_only=>true)).animated
end
def initialize(uri, options={})
@uri = uri
@options = {
:type_only => false,
:timeout => DefaultTimeout,
:raise_on_failure => false,
:proxy => nil,
:http_header => {}
}.merge(options)
@property = if @options[:animated_only]
:animated
elsif @options[:type_only]
:type
else
:size
end
@type, @state = nil
if uri.respond_to?(:read)
fetch_using_read(uri)
elsif uri.start_with?('data:')
fetch_using_base64(uri)
else
begin
@parsed_uri = URI.parse(uri)
rescue URI::InvalidURIError
fetch_using_file_open
else
if @parsed_uri.scheme == "http" || @parsed_uri.scheme == "https"
fetch_using_http
else
fetch_using_file_open
end
end
end
raise SizeNotFound if @options[:raise_on_failure] && @property == :size && !@size
rescue Timeout::Error, SocketError, Errno::ECONNREFUSED, Errno::EHOSTUNREACH, Errno::ECONNRESET,
Errno::ENETUNREACH, ImageFetchFailure, Net::HTTPBadResponse, EOFError, Errno::ENOENT,
OpenSSL::SSL::SSLError
raise ImageFetchFailure if @options[:raise_on_failure]
rescue NoMethodError # 1.8.7p248 can raise this due to a net/http bug
raise ImageFetchFailure if @options[:raise_on_failure]
rescue UnknownImageType
raise UnknownImageType if @options[:raise_on_failure]
rescue CannotParseImage
if @options[:raise_on_failure]
if @property == :size
raise SizeNotFound
else
raise ImageFetchFailure
end
end
ensure
uri.rewind if uri.respond_to?(:rewind)
end
private
def fetch_using_http
@redirect_count = 0
fetch_using_http_from_parsed_uri
end
# Some invalid locations need escaping
def escaped_location(location)
begin
URI(location)
rescue URI::InvalidURIError
::URI::DEFAULT_PARSER.escape(location)
else
location
end
end
def fetch_using_http_from_parsed_uri
http_header = {'Accept-Encoding' => 'identity'}.merge(@options[:http_header])
setup_http
@http.request_get(@parsed_uri.request_uri, http_header) do |res|
if res.is_a?(Net::HTTPRedirection) && @redirect_count < 4
@redirect_count += 1
begin
location = res['Location']
raise ImageFetchFailure if location.nil? || location.empty?
@parsed_uri = URI.join(@parsed_uri, escaped_location(location))
rescue URI::InvalidURIError
else
fetch_using_http_from_parsed_uri
break
end
end
raise ImageFetchFailure unless res.is_a?(Net::HTTPSuccess)
@content_length = res.content_length
read_fiber = Fiber.new do
res.read_body do |str|
Fiber.yield str
end
end
case res['content-encoding']
when 'deflate', 'gzip', 'x-gzip'
begin
gzip = Zlib::GzipReader.new(FiberStream.new(read_fiber))
rescue FiberError, Zlib::GzipFile::Error
raise CannotParseImage
end
read_fiber = Fiber.new do
while data = gzip.readline
Fiber.yield data
end
end
end
parse_packets FiberStream.new(read_fiber)
break # needed to actively quit out of the fetch
end
end
def protocol_relative_url?(url)
url.start_with?("//")
end
def proxy_uri
begin
if @options[:proxy]
proxy = URI.parse(@options[:proxy])
else
proxy = ENV['http_proxy'] && ENV['http_proxy'] != "" ? URI.parse(ENV['http_proxy']) : nil
end
rescue URI::InvalidURIError
proxy = nil
end
proxy
end
def setup_http
proxy = proxy_uri
if proxy
@http = Net::HTTP::Proxy(proxy.host, proxy.port, proxy.user, proxy.password).new(@parsed_uri.host, @parsed_uri.port)
else
@http = Net::HTTP.new(@parsed_uri.host, @parsed_uri.port)
end
@http.use_ssl = (@parsed_uri.scheme == "https")
@http.verify_mode = OpenSSL::SSL::VERIFY_NONE
@http.open_timeout = @options[:timeout]
@http.read_timeout = @options[:timeout]
end
def fetch_using_read(readable)
readable.rewind if readable.respond_to?(:rewind)
# Pathnames respond to read, but always return the first
# chunk of the file unlike an IO (even though the
# docuementation for it refers to IO). Need to supply
# an offset in this case.
if readable.is_a?(Pathname)
read_fiber = Fiber.new do
offset = 0
while str = readable.read(LocalFileChunkSize, offset)
Fiber.yield str
offset += LocalFileChunkSize
end
end
else
read_fiber = Fiber.new do
while str = readable.read(LocalFileChunkSize)
Fiber.yield str
end
end
end
parse_packets FiberStream.new(read_fiber)
end
def fetch_using_file_open
@content_length = File.size?(@uri)
File.open(@uri) do |s|
fetch_using_read(s)
end
end
def parse_packets(stream)
@stream = stream
begin
result = send("parse_#{@property}")
if result != nil
# extract exif orientation if it was found
if @property == :size && result.size == 3
@orientation = result.pop
else
@orientation = 1
end
instance_variable_set("@#{@property}", result)
else
raise CannotParseImage
end
rescue FiberError
raise CannotParseImage
end
end
def parse_size
@type = parse_type unless @type
send("parse_size_for_#{@type}")
end
def parse_animated
@type = parse_type unless @type
@type == :gif ? send("parse_animated_for_#{@type}") : nil
end
def fetch_using_base64(uri)
data = uri.split(',')[1]
decoded = Base64.decode64(data)
@content_length = decoded.size
fetch_using_read StringIO.new(decoded)
end
module StreamUtil # :nodoc:
def read_byte
read(1)[0].ord
end
def read_int
read(2).unpack('n')[0]
end
def read_string_int
value = []
while read(1) =~ /(\d)/
value << $1
end
value.join.to_i
end
end
class FiberStream # :nodoc:
include StreamUtil
attr_reader :pos
def initialize(read_fiber)
@read_fiber = read_fiber
@pos = 0
@strpos = 0
@str = ''
end
# Peeking beyond the end of the input will raise
def peek(n)
while @strpos + n - 1 >= @str.size
unused_str = @str[@strpos..-1]
new_string = @read_fiber.resume
raise CannotParseImage if !new_string
# we are dealing with bytes here, so force the encoding
new_string.force_encoding("ASCII-8BIT") if String.method_defined? :force_encoding
@str = unused_str + new_string
@strpos = 0
end
@str[@strpos..(@strpos + n - 1)]
end
def read(n)
result = peek(n)
@strpos += n
@pos += n
result
end
def skip(n)
discarded = 0
fetched = @str[@strpos..-1].size
while n > fetched
discarded += @str[@strpos..-1].size
new_string = @read_fiber.resume
raise CannotParseImage if !new_string
new_string.force_encoding("ASCII-8BIT") if String.method_defined? :force_encoding
fetched += new_string.size
@str = new_string
@strpos = 0
end
@strpos = @strpos + n - discarded
@pos += n
end
end
class IOStream < SimpleDelegator # :nodoc:
include StreamUtil
end
def parse_type
parsed_type = case @stream.peek(2)
when "BM"
:bmp
when "GI"
:gif
when 0xff.chr + 0xd8.chr
:jpeg
when 0x89.chr + "P"
:png
when "II", "MM"
case @stream.peek(11)[8..10]
when "APC", "CR\002"
nil # do not recognise CRW or CR2 as tiff
else
:tiff
end
when '8B'
:psd
when "\0\0"
# ico has either a 1 (for ico format) or 2 (for cursor) at offset 3
case @stream.peek(3).bytes.to_a.last
when 1 then :ico
when 2 then :cur
end
when "RI"
:webp if @stream.peek(12)[8..11] == "WEBP"
when "<s"
:svg if @stream.peek(4) == "<svg"
when /<[?!]/
# Peek 10 more chars each time, and if end of file is reached just raise
# unknown. We assume the <svg tag cannot be within 10 chars of the end of
# the file, and is within the first 250 chars.
begin
:svg if (1..25).detect {|n| @stream.peek(10 * n).include?("<svg")}
rescue FiberError
nil
end
end
parsed_type or raise UnknownImageType
end
def parse_size_for_ico
icons = @stream.read(6)[4..5].unpack('v').first
sizes = icons.times.map { @stream.read(16).unpack('C2').map { |x| x == 0 ? 256 : x } }.sort_by { |w,h| w * h }
sizes.last
end
alias_method :parse_size_for_cur, :parse_size_for_ico
class Gif # :nodoc:
def initialize(stream)
@stream = stream
end
def width_and_height
@stream.read(11)[6..10].unpack('SS')
end
# Checks if a delay between frames exists and if it does, then the GIFs is
# animated
def animated?
frames = 0
# "GIF" + version (3) + width (2) + height (2)
@stream.skip(10)
# fields (1) + bg color (1) + pixel ratio (1)
fields = @stream.read(3).unpack("CCC")[0]
if fields & 0x80 # Global Color Table
# 2 * (depth + 1) colors, each occupying 3 bytes (RGB)
@stream.skip(3 * 2 ** ((fields & 0x7) + 1))
end
loop do
block_type = @stream.read(1).unpack("C")[0]
if block_type == 0x21 # Graphic Control Extension
# extension type (1) + size (1)
size = @stream.read(2).unpack("CC")[1]
@stream.skip(size)
skip_sub_blocks
elsif block_type == 0x2C # Image Descriptor
frames += 1
return true if frames > 1
# left position (2) + top position (2) + width (2) + height (2) + fields (1)
fields = @stream.read(9).unpack("SSSSC")[4]
if fields & 0x80 != 0 # Local Color Table
# 2 * (depth + 1) colors, each occupying 3 bytes (RGB)
@stream.skip(3 * 2 ** ((fields & 0x7) + 1))
end
@stream.skip(1) # LZW min code size (1)
skip_sub_blocks
else
break # unrecognized block
end
end
false
end
private
def skip_sub_blocks
loop do
size = @stream.read(1).unpack("C")[0]
if size == 0
break
else
@stream.skip(size)
end
end
end
end
def parse_size_for_gif
gif = Gif.new(@stream)
gif.width_and_height
end
def parse_size_for_png
@stream.read(25)[16..24].unpack('NN')
end
def parse_size_for_jpeg
exif = nil
loop do
@state = case @state
when nil
@stream.skip(2)
:started
when :started
@stream.read_byte == 0xFF ? :sof : :started
when :sof
case @stream.read_byte
when 0xe1 # APP1
skip_chars = @stream.read_int - 2
data = @stream.read(skip_chars)
io = StringIO.new(data)
if io.read(4) == "Exif"
io.read(2)
new_exif = Exif.new(IOStream.new(io)) rescue nil
exif ||= new_exif # only use the first APP1 segment
end
:started
when 0xe0..0xef
:skipframe
when 0xC0..0xC3, 0xC5..0xC7, 0xC9..0xCB, 0xCD..0xCF
:readsize
when 0xFF
:sof
else
:skipframe
end
when :skipframe
skip_chars = @stream.read_int - 2
@stream.skip(skip_chars)
:started
when :readsize
@stream.skip(3)
height = @stream.read_int
width = @stream.read_int
width, height = height, width if exif && exif.rotated?
return [width, height, exif ? exif.orientation : 1]
end
end
end
def parse_size_for_bmp
d = @stream.read(32)[14..28]
header = d.unpack("C")[0]
result = if header == 12
d[4..8].unpack('SS')
else
d[4..-1].unpack('l<l<')
end
# ImageHeight is expressed in pixels. The absolute value is necessary because ImageHeight can be negative
[result.first, result.last.abs]
end
def parse_size_for_webp
vp8 = @stream.read(16)[12..15]
_len = @stream.read(4).unpack("V")
case vp8
when "VP8 "
parse_size_vp8
when "VP8L"
parse_size_vp8l
when "VP8X"
parse_size_vp8x
else
nil
end
end
def parse_size_vp8
w, h = @stream.read(10).unpack("@6vv")
[w & 0x3fff, h & 0x3fff]
end
def parse_size_vp8l
@stream.skip(1) # 0x2f
b1, b2, b3, b4 = @stream.read(4).bytes.to_a
[1 + (((b2 & 0x3f) << 8) | b1), 1 + (((b4 & 0xF) << 10) | (b3 << 2) | ((b2 & 0xC0) >> 6))]
end
def parse_size_vp8x
flags = @stream.read(4).unpack("C")[0]
b1, b2, b3, b4, b5, b6 = @stream.read(6).unpack("CCCCCC")
width, height = 1 + b1 + (b2 << 8) + (b3 << 16), 1 + b4 + (b5 << 8) + (b6 << 16)
if flags & 8 > 0 # exif
# parse exif for orientation
# TODO: find or create test images for this
end
return [width, height]
end
class Exif # :nodoc:
attr_reader :width, :height, :orientation
def initialize(stream)
@stream = stream
@width, @height, @orientation = nil
parse_exif
end
def rotated?
@orientation >= 5
end
private
def get_exif_byte_order
byte_order = @stream.read(2)
case byte_order
when 'II'
@short, @long = 'v', 'V'
when 'MM'
@short, @long = 'n', 'N'
else
raise CannotParseImage
end
end
def parse_exif_ifd
tag_count = @stream.read(2).unpack(@short)[0]
tag_count.downto(1) do
type = @stream.read(2).unpack(@short)[0]
@stream.read(6)
data = @stream.read(2).unpack(@short)[0]
case type
when 0x0100 # image width
@width = data
when 0x0101 # image height
@height = data
when 0x0112 # orientation
@orientation = data
end
if @width && @height && @orientation
return # no need to parse more
end
@stream.read(2)
end
end
def parse_exif
@start_byte = @stream.pos
get_exif_byte_order
@stream.read(2) # 42
offset = @stream.read(4).unpack(@long)[0]
if @stream.respond_to?(:skip)
@stream.skip(offset - 8)
else
@stream.read(offset - 8)
end
parse_exif_ifd
@orientation ||= 1
end
end
def parse_size_for_tiff
exif = Exif.new(@stream)
if exif.rotated?
[exif.height, exif.width, exif.orientation]
else
[exif.width, exif.height, exif.orientation]
end
end
def parse_size_for_psd
@stream.read(26).unpack("x14NN").reverse
end
class Svg # :nodoc:
def initialize(stream)
@stream = stream
@width, @height, @ratio, @viewbox_width, @viewbox_height = nil
parse_svg
end
def width_and_height
if @width && @height
[@width, @height]
elsif @width && @ratio
[@width, @width / @ratio]
elsif @height && @ratio
[@height * @ratio, @height]
elsif @viewbox_width && @viewbox_height
[@viewbox_width, @viewbox_height]
else
nil
end
end
private
def parse_svg
attr_name = []
state = nil
while (char = @stream.read(1)) && state != :stop do
case char
when "="
if attr_name.join =~ /width/i
@stream.read(1)
@width = @stream.read_string_int
return if @height
elsif attr_name.join =~ /height/i
@stream.read(1)
@height = @stream.read_string_int
return if @width
elsif attr_name.join =~ /viewbox/i
values = attr_value.split(/\s/)
if values[2].to_f > 0 && values[3].to_f > 0
@ratio = values[2].to_f / values[3].to_f
@viewbox_width = values[2].to_i
@viewbox_height = values[3].to_i
end
end
when /\w/
attr_name << char
when "<"
attr_name = [char]
when ">"
state = :stop if state == :started
else
state = :started if attr_name.join == "<svg"
attr_name.clear
end
end
end
def attr_value
@stream.read(1)
value = []
while @stream.read(1) =~ /([^"])/
value << $1
end
value.join
end
end
def parse_size_for_svg
svg = Svg.new(@stream)
svg.width_and_height
end
def parse_animated_for_gif
gif = Gif.new(@stream)
gif.animated?
end
end

471
lib/fastimage/fastimage.rb Normal file
View File

@ -0,0 +1,471 @@
require_relative 'fastimage_parsing/image_base'
require_relative 'fastimage_parsing/stream_util'
require_relative 'fastimage_parsing/avif'
require_relative 'fastimage_parsing/bmp'
require_relative 'fastimage_parsing/exif'
require_relative 'fastimage_parsing/fiber_stream'
require_relative 'fastimage_parsing/gif'
require_relative 'fastimage_parsing/heic'
require_relative 'fastimage_parsing/ico'
require_relative 'fastimage_parsing/iso_bmff'
require_relative 'fastimage_parsing/jpeg'
require_relative 'fastimage_parsing/jxl'
require_relative 'fastimage_parsing/jxlc'
require_relative 'fastimage_parsing/png'
require_relative 'fastimage_parsing/psd'
require_relative 'fastimage_parsing/svg'
require_relative 'fastimage_parsing/tiff'
require_relative 'fastimage_parsing/type_parser'
require_relative 'fastimage_parsing/webp'
class FastImage
include FastImageParsing
attr_reader :bytes_read
class FastImageException < StandardError # :nodoc:
end
class UnknownImageType < FastImageException # :nodoc:
end
class ImageFetchFailure < FastImageException # :nodoc:
end
class SizeNotFound < FastImageException # :nodoc:
end
class CannotParseImage < FastImageException # :nodoc:
end
class BadImageURI < FastImageException # :nodoc:
end
DefaultTimeout = 2 unless const_defined?(:DefaultTimeout)
LocalFileChunkSize = 256 unless const_defined?(:LocalFileChunkSize)
private
Parsers = {
:bmp => Bmp,
:gif => Gif,
:jpeg => Jpeg,
:png => Png,
:tiff => Tiff,
:psd => Psd,
:heic => Heic,
:heif => Heic,
:webp => Webp,
:svg => Svg,
:ico => Ico,
:cur => Ico,
:jxl => Jxl,
:avif => Avif
}.freeze
public
SUPPORTED_IMAGE_TYPES = Parsers.keys.freeze
# Returns an array containing the width and height of the image.
# It will return nil if the image could not be fetched, or if the image type was not recognised.
#
# By default there is a timeout of 2 seconds for opening and reading from a remote server.
# This can be changed by passing a :timeout => number_of_seconds in the options.
#
# If you wish FastImage to raise if it cannot size the image for any reason, then pass
# :raise_on_failure => true in the options.
#
# FastImage knows about GIF, JPEG, BMP, TIFF, ICO, CUR, PNG, HEIC/HEIF, AVIF, PSD, SVG, WEBP and JXL files.
#
# === Example
#
# require 'fastimage'
#
# FastImage.size("https://switchstep.com/images/ios.gif")
# => [196, 283]
# FastImage.size("http://switchstep.com/images/ss_logo.png")
# => [300, 300]
# FastImage.size("https://upload.wikimedia.org/wikipedia/commons/0/09/Jpeg_thumb_artifacts_test.jpg")
# => [1280, 800]
# FastImage.size("https://eeweb.engineering.nyu.edu/~yao/EL5123/image/lena_gray.bmp")
# => [512, 512]
# FastImage.size("test/fixtures/test.jpg")
# => [882, 470]
# FastImage.size("http://switchstep.com/does_not_exist")
# => nil
# FastImage.size("http://switchstep.com/does_not_exist", :raise_on_failure=>true)
# => raises FastImage::ImageFetchFailure
# FastImage.size("http://switchstep.com/images/favicon.ico", :raise_on_failure=>true)
# => [16, 16]
# FastImage.size("http://switchstep.com/foo.ics", :raise_on_failure=>true)
# => raises FastImage::UnknownImageType
# FastImage.size("http://switchstep.com/images/favicon.ico", :raise_on_failure=>true, :timeout=>0.01)
# => raises FastImage::ImageFetchFailure
# FastImage.size("http://switchstep.com/images/faulty.jpg", :raise_on_failure=>true)
# => raises FastImage::SizeNotFound
#
# === Supported options
# [:timeout]
# Overrides the default timeout of 2 seconds. Applies both to reading from and opening the http connection.
# [:raise_on_failure]
# If set to true causes an exception to be raised if the image size cannot be found for any reason.
#
def self.size(uri, options={})
new(uri, options).size
end
# Returns an symbol indicating the image type fetched from a uri.
# It will return nil if the image could not be fetched, or if the image type was not recognised.
#
# By default there is a timeout of 2 seconds for opening and reading from a remote server.
# This can be changed by passing a :timeout => number_of_seconds in the options.
#
# If you wish FastImage to raise if it cannot find the type of the image for any reason, then pass
# :raise_on_failure => true in the options.
#
# === Example
#
# require 'fastimage'
#
# FastImage.type("https://switchstep.com/images/ios.gif")
# => :gif
# FastImage.type("http://switchstep.com/images/ss_logo.png")
# => :png
# FastImage.type("https://upload.wikimedia.org/wikipedia/commons/0/09/Jpeg_thumb_artifacts_test.jpg")
# => :jpeg
# FastImage.type("https://eeweb.engineering.nyu.edu/~yao/EL5123/image/lena_gray.bmp")
# => :bmp
# FastImage.type("test/fixtures/test.jpg")
# => :jpeg
# FastImage.type("http://switchstep.com/does_not_exist")
# => nil
# File.open("/some/local/file.gif", "r") {|io| FastImage.type(io)}
# => :gif
# FastImage.type("test/fixtures/test.tiff")
# => :tiff
# FastImage.type("test/fixtures/test.psd")
# => :psd
#
# === Supported options
# [:timeout]
# Overrides the default timeout of 2 seconds. Applies both to reading from and opening the http connection.
# [:raise_on_failure]
# If set to true causes an exception to be raised if the image type cannot be found for any reason.
#
def self.type(uri, options={})
new(uri, options).type
end
# Returns a boolean value indicating the image is animated.
# It will return nil if the image could not be fetched, or if the image type was not recognised.
#
# By default there is a timeout of 2 seconds for opening and reading from a remote server.
# This can be changed by passing a :timeout => number_of_seconds in the options.
#
# If you wish FastImage to raise if it cannot find the type of the image for any reason, then pass
# :raise_on_failure => true in the options.
#
# === Example
#
# require 'fastimage'
#
# FastImage.animated?("test/fixtures/test.gif")
# => false
# FastImage.animated?("test/fixtures/animated.gif")
# => true
#
# === Supported options
# [:timeout]
# Overrides the default timeout of 2 seconds. Applies both to reading from and opening the http connection.
# [:raise_on_failure]
# If set to true causes an exception to be raised if the image type cannot be found for any reason.
#
def self.animated?(uri, options={})
new(uri, options).animated
end
def initialize(uri, options={})
@uri = uri
@options = {
:timeout => DefaultTimeout,
:raise_on_failure => false,
:proxy => nil,
:http_header => {}
}.merge(options)
end
def type
@property = :type
fetch unless defined?(@type)
@type
end
def size
@property = :size
begin
fetch unless defined?(@size)
rescue CannotParseImage
end
raise SizeNotFound if @options[:raise_on_failure] && !@size
@size
end
def orientation
size unless defined?(@size)
@orientation ||= 1 if @size
end
def width
size && @size[0]
end
def height
size && @size[1]
end
def animated
@property = :animated
fetch unless defined?(@animated)
@animated
end
def content_length
@property = :content_length
fetch unless defined?(@content_length)
@content_length
end
# find an appropriate method to fetch the image according to the passed parameter
def fetch
raise BadImageURI if @uri.nil?
if @uri.respond_to?(:read)
fetch_using_read(@uri)
elsif @uri.start_with?('data:')
fetch_using_base64(@uri)
else
begin
@parsed_uri = URI.parse(@uri)
rescue URI::InvalidURIError
fetch_using_file_open
else
if @parsed_uri.scheme == "http" || @parsed_uri.scheme == "https"
fetch_using_http
else
fetch_using_file_open
end
end
end
raise SizeNotFound if @options[:raise_on_failure] && @property == :size && !@size
rescue Timeout::Error, SocketError, Errno::ECONNREFUSED, Errno::EHOSTUNREACH, Errno::ECONNRESET,
Errno::ENETUNREACH, ImageFetchFailure, Net::HTTPBadResponse, EOFError, Errno::ENOENT,
OpenSSL::SSL::SSLError
raise ImageFetchFailure if @options[:raise_on_failure]
rescue UnknownImageType, BadImageURI, CannotParseImage
raise if @options[:raise_on_failure]
ensure
@uri.rewind if @uri.respond_to?(:rewind)
end
private
def fetch_using_http
@redirect_count = 0
fetch_using_http_from_parsed_uri
end
# Some invalid locations need escaping
def escaped_location(location)
begin
URI(location)
rescue URI::InvalidURIError
::URI::DEFAULT_PARSER.escape(location)
else
location
end
end
def fetch_using_http_from_parsed_uri
raise ImageFetchFailure unless @parsed_uri.is_a?(URI::HTTP)
http_header = {'Accept-Encoding' => 'identity'}.merge(@options[:http_header])
setup_http
@http.request_get(@parsed_uri.request_uri, http_header) do |res|
if res.is_a?(Net::HTTPRedirection) && @redirect_count < 4
@redirect_count += 1
begin
location = res['Location']
raise ImageFetchFailure if location.nil? || location.empty?
@parsed_uri = URI.join(@parsed_uri, escaped_location(location))
rescue URI::InvalidURIError
else
fetch_using_http_from_parsed_uri
break
end
end
raise ImageFetchFailure unless res.is_a?(Net::HTTPSuccess)
@content_length = res.content_length
break if @property == :content_length
read_fiber = Fiber.new do
res.read_body do |str|
Fiber.yield str
end
nil
end
case res['content-encoding']
when 'deflate', 'gzip', 'x-gzip'
begin
gzip = Zlib::GzipReader.new(FiberStream.new(read_fiber))
rescue FiberError, Zlib::GzipFile::Error
raise CannotParseImage
end
read_fiber = Fiber.new do
while data = gzip.readline
Fiber.yield data
end
nil
end
end
parse_packets FiberStream.new(read_fiber)
break # needed to actively quit out of the fetch
end
end
def protocol_relative_url?(url)
url.start_with?("//")
end
def proxy_uri
begin
if @options[:proxy]
proxy = URI.parse(@options[:proxy])
else
proxy = ENV['http_proxy'] && ENV['http_proxy'] != "" ? URI.parse(ENV['http_proxy']) : nil
end
rescue URI::InvalidURIError
proxy = nil
end
proxy
end
def setup_http
proxy = proxy_uri
if proxy
@http = Net::HTTP::Proxy(proxy.host, proxy.port, proxy.user, proxy.password).new(@parsed_uri.host, @parsed_uri.port)
else
@http = Net::HTTP.new(@parsed_uri.host, @parsed_uri.port)
end
@http.use_ssl = (@parsed_uri.scheme == "https")
@http.verify_mode = OpenSSL::SSL::VERIFY_NONE
@http.open_timeout = @options[:timeout]
@http.read_timeout = @options[:timeout]
end
def fetch_using_read(readable)
return @content_length = readable.size if @property == :content_length && readable.respond_to?(:size)
readable.rewind if readable.respond_to?(:rewind)
# Pathnames respond to read, but always return the first
# chunk of the file unlike an IO (even though the
# docuementation for it refers to IO). Need to supply
# an offset in this case.
if readable.is_a?(Pathname)
read_fiber = Fiber.new do
offset = 0
while str = readable.read(LocalFileChunkSize, offset)
Fiber.yield str
offset += LocalFileChunkSize
end
nil
end
else
read_fiber = Fiber.new do
while str = readable.read(LocalFileChunkSize)
Fiber.yield str
end
nil
end
end
parse_packets FiberStream.new(read_fiber)
end
def fetch_using_file_open
return @content_length = File.size?(@uri) if @property == :content_length
File.open(@uri) do |s|
fetch_using_read(s)
end
end
def fetch_using_base64(uri)
decoded = begin
uri.split(',')[1].unpack("m").first
rescue
raise CannotParseImage
end
fetch_using_read StringIO.new(decoded)
end
def parse_packets(stream)
@stream = stream
begin
@type = TypeParser.new(@stream).type unless defined?(@type)
result = case @property
when :type
@type
when :size
parse_size
when :animated
parse_animated
end
if result != nil
# extract exif orientation if it was found
if @property == :size && result.size == 3
@orientation = result.pop
else
@orientation = 1
end
instance_variable_set("@#{@property}", result)
else
raise CannotParseImage
end
rescue FiberError
raise CannotParseImage
end
end
def parser_class
klass = Parsers[@type]
raise UnknownImageType unless klass
klass
end
def parse_size
parser_class.new(@stream).dimensions
end
def parse_animated
parser_class.new(@stream).animated?
end
end

View File

@ -0,0 +1,12 @@
module FastImageParsing
class Avif < ImageBase # :nodoc:
def dimensions
bmff = IsoBmff.new(@stream)
[bmff.width, bmff.height]
end
def animated?
@stream.peek(12)[4..-1] == "ftypavis"
end
end
end

View File

@ -0,0 +1,17 @@
module FastImageParsing
class Bmp < ImageBase # :nodoc:
def dimensions
d = @stream.read(32)[14..28]
header = d.unpack("C")[0]
result = if header == 12
d[4..8].unpack('SS')
else
d[4..-1].unpack('l<l<')
end
# ImageHeight is expressed in pixels. The absolute value is necessary because ImageHeight can be negative
[result.first, result.last.abs]
end
end
end

View File

@ -0,0 +1,76 @@
module FastImageParsing
class Exif # :nodoc:
attr_reader :width, :height, :orientation
def initialize(stream)
@stream = stream
@width, @height, @orientation = nil
parse_exif
end
def rotated?
@orientation >= 5
end
private
def get_exif_byte_order
byte_order = @stream.read(2)
case byte_order
when 'II'
@short, @long = 'v', 'V'
when 'MM'
@short, @long = 'n', 'N'
else
raise FastImage::CannotParseImage
end
end
def parse_exif_ifd
tag_count = @stream.read(2).unpack(@short)[0]
tag_count.downto(1) do
type = @stream.read(2).unpack(@short)[0]
data_type = @stream.read(2).unpack(@short)[0]
@stream.read(4)
if data_type == 4
data = @stream.read(4).unpack(@long)[0]
else
data = @stream.read(2).unpack(@short)[0]
@stream.read(2)
end
case type
when 0x0100 # image width
@width = data
when 0x0101 # image height
@height = data
when 0x0112 # orientation
@orientation = data
end
if @width && @height && @orientation
return # no need to parse more
end
end
end
def parse_exif
@start_byte = @stream.pos
get_exif_byte_order
@stream.read(2) # 42
offset = @stream.read(4).unpack(@long)[0]
if @stream.respond_to?(:skip)
@stream.skip(offset - 8)
else
@stream.read(offset - 8)
end
parse_exif_ifd
@orientation ||= 1
end
end
end

View File

@ -0,0 +1,58 @@
module FastImageParsing
class FiberStream # :nodoc:
include StreamUtil
attr_reader :pos
# read_fiber should return nil if it no longer has anything to return when resumed
# so the result of the whole Fiber block should be set to be nil in case yield is no
# longer called
def initialize(read_fiber)
@read_fiber = read_fiber
@pos = 0
@strpos = 0
@str = ''
end
# Peeking beyond the end of the input will raise
def peek(n)
while @strpos + n > @str.size
unused_str = @str[@strpos..-1]
new_string = @read_fiber.resume
raise FastImage::CannotParseImage if !new_string
# we are dealing with bytes here, so force the encoding
new_string.force_encoding("ASCII-8BIT") if new_string.respond_to? :force_encoding
@str = unused_str + new_string
@strpos = 0
end
@str[@strpos, n]
end
def read(n)
result = peek(n)
@strpos += n
@pos += n
result
end
def skip(n)
discarded = 0
fetched = @str[@strpos..-1].size
while n > fetched
discarded += @str[@strpos..-1].size
new_string = @read_fiber.resume
raise FastImage::CannotParseImage if !new_string
new_string.force_encoding("ASCII-8BIT") if new_string.respond_to? :force_encoding
fetched += new_string.size
@str = new_string
@strpos = 0
end
@strpos = @strpos + n - discarded
@pos += n
end
end
end

View File

@ -0,0 +1,63 @@
module FastImageParsing
class Gif < ImageBase # :nodoc:
def dimensions
@stream.read(11)[6..10].unpack('SS')
end
# Checks for multiple frames
def animated?
frames = 0
# "GIF" + version (3) + width (2) + height (2)
@stream.skip(10)
# fields (1) + bg color (1) + pixel ratio (1)
fields = @stream.read(3).unpack("CCC")[0]
if fields & 0x80 != 0 # Global Color Table
# 2 * (depth + 1) colors, each occupying 3 bytes (RGB)
@stream.skip(3 * 2 ** ((fields & 0x7) + 1))
end
loop do
block_type = @stream.read(1).unpack("C")[0]
if block_type == 0x21 # Graphic Control Extension
# extension type (1) + size (1)
size = @stream.read(2).unpack("CC")[1]
@stream.skip(size)
skip_sub_blocks
elsif block_type == 0x2C # Image Descriptor
frames += 1
return true if frames > 1
# left position (2) + top position (2) + width (2) + height (2) + fields (1)
fields = @stream.read(9).unpack("SSSSC")[4]
if fields & 0x80 != 0 # Local Color Table
# 2 * (depth + 1) colors, each occupying 3 bytes (RGB)
@stream.skip(3 * 2 ** ((fields & 0x7) + 1))
end
@stream.skip(1) # LZW min code size (1)
skip_sub_blocks
else
break # unrecognized block
end
end
false
end
private
def skip_sub_blocks
loop do
size = @stream.read(1).unpack("C")[0]
if size == 0
break
else
@stream.skip(size)
end
end
end
end
end

View File

@ -0,0 +1,8 @@
module FastImageParsing
class Heic < ImageBase # :nodoc:
def dimensions
bmff = IsoBmff.new(@stream)
[bmff.width, bmff.height]
end
end
end

View File

@ -0,0 +1,9 @@
module FastImageParsing
class Ico < ImageBase
def dimensions
icons = @stream.read(6)[4..5].unpack('v').first
sizes = icons.times.map { @stream.read(16).unpack('C2').map { |x| x == 0 ? 256 : x } }.sort_by { |w,h| w * h }
sizes.last
end
end
end

View File

@ -0,0 +1,17 @@
module FastImageParsing
class ImageBase # :nodoc:
def initialize(stream)
@stream = stream
end
# Implement in subclasses
def dimensions
raise NotImplementedError
end
# Implement in subclasses if appropriate
def animated?
nil
end
end
end

View File

@ -0,0 +1,176 @@
module FastImageParsing
# HEIC/AVIF are a special case of the general ISO_BMFF format, in which all data is encapsulated in typed boxes,
# with a mandatory ftyp box that is used to indicate particular file types. Is composed of nested "boxes". Each
# box has a header composed of
# - Size (32 bit integer)
# - Box type (4 chars)
# - Extended size: only if size === 1, the type field is followed by 64 bit integer of extended size
# - Payload: Type-dependent
class IsoBmff # :nodoc:
attr_reader :width, :height
def initialize(stream)
@stream = stream
@width, @height = nil
parse_isobmff
end
def parse_isobmff
@rotation = 0
@max_size = nil
@primary_box = nil
@ipma_boxes = []
@ispe_boxes = []
@final_size = nil
catch :finish do
read_boxes!
end
if [90, 270].include?(@rotation)
@final_size.reverse!
end
@width, @height = @final_size
end
private
# Format specs: https://www.loc.gov/preservation/digital/formats/fdd/fdd000525.shtml
# If you need to inspect a heic/heif file, use
# https://gpac.github.io/mp4box.js/test/filereader.html
def read_boxes!(max_read_bytes = nil)
end_pos = max_read_bytes.nil? ? nil : @stream.pos + max_read_bytes
index = 0
loop do
return if end_pos && @stream.pos >= end_pos
box_type, box_size = read_box_header!
case box_type
when "meta"
handle_meta_box(box_size)
when "pitm"
handle_pitm_box(box_size)
when "ipma"
handle_ipma_box(box_size)
when "hdlr"
handle_hdlr_box(box_size)
when "iprp", "ipco"
read_boxes!(box_size)
when "irot"
handle_irot_box
when "ispe"
handle_ispe_box(box_size, index)
when "mdat"
@stream.skip(box_size)
when "jxlc"
handle_jxlc_box(box_size)
else
@stream.skip(box_size)
end
index += 1
end
end
def handle_irot_box
@rotation = (read_uint8! & 0x3) * 90
end
def handle_ispe_box(box_size, index)
throw :finish if box_size < 12
data = @stream.read(box_size)
width, height = data[4...12].unpack("N2")
@ispe_boxes << { index: index, size: [width, height] }
end
def handle_hdlr_box(box_size)
throw :finish if box_size < 12
data = @stream.read(box_size)
throw :finish if data[8...12] != "pict"
end
def handle_ipma_box(box_size)
@stream.read(3)
flags3 = read_uint8!
entries_count = read_uint32!
entries_count.times do
id = read_uint16!
essen_count = read_uint8!
essen_count.times do
property_index = read_uint8! & 0x7F
if flags3 & 1 == 1
property_index = (property_index << 7) + read_uint8!
end
@ipma_boxes << { id: id, property_index: property_index - 1 }
end
end
end
def handle_pitm_box(box_size)
data = @stream.read(box_size)
@primary_box = data[4...6].unpack("S>")[0]
end
def handle_meta_box(box_size)
throw :finish if box_size < 4
@stream.read(4)
read_boxes!(box_size - 4)
throw :finish if !@primary_box
primary_indices = @ipma_boxes
.select { |box| box[:id] == @primary_box }
.map { |box| box[:property_index] }
ispe_box = @ispe_boxes.find do |box|
primary_indices.include?(box[:index])
end
if ispe_box
@final_size = ispe_box[:size]
end
throw :finish
end
def handle_jxlc_box(box_size)
jxlc = Jxlc.new(@stream)
@final_size = [jxlc.width, jxlc.height]
throw :finish
end
def read_box_header!
size = read_uint32!
type = @stream.read(4)
size = read_uint64! - 8 if size == 1
[type, size - 8]
end
def read_uint8!
@stream.read(1).unpack("C")[0]
end
def read_uint16!
@stream.read(2).unpack("S>")[0]
end
def read_uint32!
@stream.read(4).unpack("N")[0]
end
def read_uint64!
@stream.read(8).unpack("Q>")[0]
end
end
end

View File

@ -0,0 +1,52 @@
module FastImageParsing
class IOStream < SimpleDelegator # :nodoc:
include StreamUtil
end
class Jpeg < ImageBase # :nodoc:
def dimensions
exif = nil
state = nil
loop do
state = case state
when nil
@stream.skip(2)
:started
when :started
@stream.read_byte == 0xFF ? :sof : :started
when :sof
case @stream.read_byte
when 0xe1 # APP1
skip_chars = @stream.read_int - 2
data = @stream.read(skip_chars)
io = StringIO.new(data)
if io.read(4) == "Exif"
io.read(2)
new_exif = Exif.new(IOStream.new(io)) rescue nil
exif ||= new_exif # only use the first APP1 segment
end
:started
when 0xe0..0xef
:skipframe
when 0xC0..0xC3, 0xC5..0xC7, 0xC9..0xCB, 0xCD..0xCF
:readsize
when 0xFF
:sof
else
:skipframe
end
when :skipframe
skip_chars = @stream.read_int - 2
@stream.skip(skip_chars)
:started
when :readsize
@stream.skip(3)
height = @stream.read_int
width = @stream.read_int
width, height = height, width if exif && exif.rotated?
return [width, height, exif ? exif.orientation : 1]
end
end
end
end
end

View File

@ -0,0 +1,13 @@
module FastImageParsing
class Jxl < ImageBase # :nodoc:
def dimensions
if @stream.peek(2) == "\xFF\x0A".b
jxlc = Jxlc.new(@stream)
[jxlc.width, jxlc.height]
else
bmff = IsoBmff.new(@stream)
[bmff.width, bmff.height]
end
end
end
end

View File

@ -0,0 +1,75 @@
module FastImageParsing
class Jxlc # :nodoc:
attr_reader :width, :height
LENGTHS = [9, 13, 18, 30]
MULTIPLIERS = [1, 1.2, Rational(4, 3), 1.5, Rational(16, 9), 1.25, 2]
def initialize(stream)
@stream = stream
@width, @height´ = nil
@bit_counter = 0
parse_jxlc
end
def parse_jxlc
@words = @stream.read(6)[2..5].unpack('vv')
# small mode allows for values <= 256 that are divisible by 8
small = get_bits(1)
if small == 1
y = (get_bits(5) + 1) * 8
x = x_from_ratio(y)
if !x
x = (get_bits(5) + 1) * 8
end
@width, @height = x, y
return
end
len = LENGTHS[get_bits(2)]
y = get_bits(len) + 1
x = x_from_ratio(y)
if !x
len = LENGTHS[get_bits(2)]
x = get_bits(len) + 1
end
@width, @height = x, y
end
def get_bits(size)
if @words.size < (@bit_counter + size) / 16 + 1
@words += @stream.read(4).unpack('vv')
end
dest_pos = 0
dest = 0
size.times do
word = @bit_counter / 16
source_pos = @bit_counter % 16
dest |= ((@words[word] & (1 << source_pos)) > 0 ? 1 : 0) << dest_pos
dest_pos += 1
@bit_counter += 1
end
dest
end
def x_from_ratio(y)
ratio = get_bits(3)
if ratio == 0
return nil
else
return (y * MULTIPLIERS[ratio - 1]).to_i
end
end
end
def parse_size_for_jxl
if @stream.peek(2) == "\xFF\x0A".b
JXL.new(@stream).read_size_header
else
bmff = IsoBmff.new(@stream)
bmff.width_and_height
end
end
end

View File

@ -0,0 +1,26 @@
module FastImageParsing
class Png < ImageBase # :nodoc:
def dimensions
@stream.read(25)[16..24].unpack('NN')
end
def animated?
# Signature (8) + IHDR chunk (4 + 4 + 13 + 4)
@stream.read(33)
loop do
length = @stream.read(4).unpack("L>")[0]
type = @stream.read(4)
case type
when "acTL"
return true
when "IDAT"
return false
end
@stream.skip(length + 4)
end
end
end
end

View File

@ -0,0 +1,7 @@
module FastImageParsing
class Psd < ImageBase # :nodoc:
def dimensions
@stream.read(26).unpack("x14NN").reverse
end
end
end

View File

@ -0,0 +1,19 @@
module FastImageParsing
module StreamUtil # :nodoc:
def read_byte
read(1)[0].ord
end
def read_int
read(2).unpack('n')[0]
end
def read_string_int
value = []
while read(1) =~ /(\d)/
value << $1
end
value.join.to_i
end
end
end

View File

@ -0,0 +1,69 @@
module FastImageParsing
class Svg < ImageBase # :nodoc:
def dimensions
@width, @height, @ratio, @viewbox_width, @viewbox_height = nil
parse_svg
if @width && @height
[@width, @height]
elsif @width && @ratio
[@width, @width / @ratio]
elsif @height && @ratio
[@height * @ratio, @height]
elsif @viewbox_width && @viewbox_height
[@viewbox_width, @viewbox_height]
else
nil
end
end
private
def parse_svg
attr_name = []
state = nil
while (char = @stream.read(1)) && state != :stop do
case char
when "="
if attr_name.join =~ /width/i
@stream.read(1)
@width = @stream.read_string_int
return if @height
elsif attr_name.join =~ /height/i
@stream.read(1)
@height = @stream.read_string_int
return if @width
elsif attr_name.join =~ /viewbox/i
values = attr_value.split(/\s/)
if values[2].to_f > 0 && values[3].to_f > 0
@ratio = values[2].to_f / values[3].to_f
@viewbox_width = values[2].to_i
@viewbox_height = values[3].to_i
end
end
when /\w/
attr_name << char
when "<"
attr_name = [char]
when ">"
state = :stop if state == :started
else
state = :started if attr_name.join == "<svg"
attr_name.clear
end
end
end
def attr_value
@stream.read(1)
value = []
while @stream.read(1) =~ /([^"])/
value << $1
end
value.join
end
end
end

View File

@ -0,0 +1,16 @@
module FastImageParsing
class Tiff < ImageBase # :nodoc:
def initialize(stream)
@stream = stream
end
def dimensions
exif = Exif.new(@stream)
if exif.rotated?
[exif.height, exif.width, exif.orientation]
else
[exif.width, exif.height, exif.orientation]
end
end
end
end

View File

@ -0,0 +1,69 @@
module FastImageParsing
class TypeParser
def initialize(stream)
@stream = stream
end
# type will use peek to get enough bytes to determing the type of the image
def type
parsed_type = case @stream.peek(2)
when "BM"
:bmp
when "GI"
:gif
when 0xff.chr + 0xd8.chr
:jpeg
when 0x89.chr + "P"
:png
when "II", "MM"
case @stream.peek(11)[8..10]
when "APC", "CR\002"
nil # do not recognise CRW or CR2 as tiff
else
:tiff
end
when '8B'
:psd
when "\xFF\x0A".b
:jxl
when "\0\0"
case @stream.peek(3).bytes.to_a.last
when 0
# http://www.ftyps.com/what.html
case @stream.peek(12)[4..-1]
when "ftypavif"
:avif
when "ftypavis"
:avif
when "ftypheic"
:heic
when "ftypmif1"
:heif
else
if @stream.peek(7)[4..-1] == 'JXL'
:jxl
end
end
# ico has either a 1 (for ico format) or 2 (for cursor) at offset 3
when 1 then :ico
when 2 then :cur
end
when "RI"
:webp if @stream.peek(12)[8..11] == "WEBP"
when "<s"
:svg if @stream.peek(4) == "<svg"
when /\s\s|\s<|<[?!]/, 0xef.chr + 0xbb.chr
# Peek 10 more chars each time, and if end of file is reached just raise
# unknown. We assume the <svg tag cannot be within 10 chars of the end of
# the file, and is within the first 1000 chars.
begin
:svg if (1..100).detect {|n| @stream.peek(10 * n).include?("<svg")}
rescue FiberError, FastImage::CannotParseImage
nil
end
end
parsed_type or raise FastImage::UnknownImageType
end
end
end

View File

@ -0,0 +1,60 @@
module FastImageParsing
class Webp < ImageBase # :nodoc:
def dimensions
vp8 = @stream.read(16)[12..15]
_len = @stream.read(4).unpack("V")
case vp8
when "VP8 "
parse_size_vp8
when "VP8L"
parse_size_vp8l
when "VP8X"
parse_size_vp8x
else
nil
end
end
def animated?
vp8 = @stream.read(16)[12..15]
_len = @stream.read(4).unpack("V")
case vp8
when "VP8 "
false
when "VP8L"
false
when "VP8X"
flags = @stream.read(4).unpack("C")[0]
flags & 2 > 0
else
nil
end
end
private
def parse_size_vp8
w, h = @stream.read(10).unpack("@6vv")
[w & 0x3fff, h & 0x3fff]
end
def parse_size_vp8l
@stream.skip(1) # 0x2f
b1, b2, b3, b4 = @stream.read(4).bytes.to_a
[1 + (((b2 & 0x3f) << 8) | b1), 1 + (((b4 & 0xF) << 10) | (b3 << 2) | ((b2 & 0xC0) >> 6))]
end
def parse_size_vp8x
flags = @stream.read(4).unpack("C")[0]
b1, b2, b3, b4, b5, b6 = @stream.read(6).unpack("CCCCCC")
width, height = 1 + b1 + (b2 << 8) + (b3 << 16), 1 + b4 + (b5 << 8) + (b6 << 16)
if flags & 8 > 0 # exif
# parse exif for orientation
# TODO: find or create test images for this
end
[width, height]
end
end
end

5
lib/fastimage/version.rb Normal file
View File

@ -0,0 +1,5 @@
# frozen_string_literal: true
class FastImage
VERSION = '2.4.0'
end

BIN
test/fixtures/animated.png vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 62 KiB

BIN
test/fixtures/animated_without_gct.gif vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

BIN
test/fixtures/avif/fox.avif vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 77 KiB

BIN
test/fixtures/avif/hato.avif vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 253 KiB

BIN
test/fixtures/avif/kimono.avif vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 83 KiB

BIN
test/fixtures/avif/red_green_flash.avif vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 KiB

BIN
test/fixtures/avif/star.avifs vendored Normal file

Binary file not shown.

BIN
test/fixtures/heic/heic-collection.heic vendored Normal file

Binary file not shown.

BIN
test/fixtures/heic/heic-empty.heic vendored Normal file

Binary file not shown.

BIN
test/fixtures/heic/heic-iphone.heic vendored Normal file

Binary file not shown.

BIN
test/fixtures/heic/heic-iphone7.heic vendored Normal file

Binary file not shown.

BIN
test/fixtures/heic/heic-maybebroken.HEIC vendored Normal file

Binary file not shown.

BIN
test/fixtures/heic/heic-single.heic vendored Normal file

Binary file not shown.

BIN
test/fixtures/heic/inverted.heic vendored Normal file

Binary file not shown.

Binary file not shown.

BIN
test/fixtures/heic/test.heic vendored Normal file

Binary file not shown.

BIN
test/fixtures/isobmff.jxl vendored Normal file

Binary file not shown.

BIN
test/fixtures/naked.jxl vendored Normal file

Binary file not shown.

BIN
test/fixtures/test.dng vendored Normal file

Binary file not shown.

Binary file not shown.

1
test/fixtures/test5.svg vendored Normal file

File diff suppressed because one or more lines are too long

After

Width:  |  Height:  |  Size: 6.9 KiB

5
test/fixtures/test6.svg vendored Normal file
View File

@ -0,0 +1,5 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
<svg width="450" height="450" viewBox="0 0 450 450" overflow="visible" version="1.1" xmlns="http://www.w3.org/2000/svg">
<path d='M5,19h9l-1,68h-9z' fill='#e80028'/>
</svg>

26
test/fixtures/test7.svg vendored Normal file
View File

@ -0,0 +1,26 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- Generator: Adobe Illustrator 26.0.1, SVG Export Plug-In . SVG Version: 6.00 Build 0) -->
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" [
<!ENTITY ns_extend "http://ns.adobe.com/Extensibility/1.0/">
<!ENTITY ns_ai "http://ns.adobe.com/AdobeIllustrator/10.0/">
<!ENTITY ns_graphs "http://ns.adobe.com/Graphs/1.0/">
<!ENTITY ns_vars "http://ns.adobe.com/Variables/1.0/">
<!ENTITY ns_imrep "http://ns.adobe.com/ImageReplacement/1.0/">
<!ENTITY ns_sfw "http://ns.adobe.com/SaveForWeb/1.0/">
<!ENTITY ns_custom "http://ns.adobe.com/GenericCustomNamespace/1.0/">
<!ENTITY ns_adobe_xpath "http://ns.adobe.com/XPath/1.0/">
]>
<svg version="1.1" id="Layer_1" xmlns:x="&ns_extend;" xmlns:i="&ns_ai;" xmlns:graph="&ns_graphs;"
xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
viewBox="0 0 100 100"
style="enable-background:new 0 0 113.4 113.4;" xml:space="preserve">
<switch>
<g i:extraneous="self">
<g>
<g>
<circle cx="50" cy="50" r="20" fill="red" />
</g>
</g>
</g>
</switch>
</svg>

After

Width:  |  Height:  |  Size: 1.1 KiB

BIN
test/fixtures/webp_animated.webp vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

View File

@ -15,6 +15,8 @@ GoodFixtures = {
"test_v5header.bmp"=>[:bmp, [40, 27]],
"test.gif"=>[:gif, [17, 32]],
"animated.gif"=>[:gif, [400, 400]],
"animated.png"=>[:png, [100, 100]],
"animated_without_gct.gif"=>[:gif, [859, 478]],
"test.jpg"=>[:jpeg, [882, 470]],
"test.png"=>[:png, [30, 20]],
"test2.jpg"=>[:jpeg, [250, 188]],
@ -33,12 +35,32 @@ GoodFixtures = {
"webp_vp8x.webp" => [:webp, [386, 395]],
"webp_vp8l.webp" => [:webp, [386, 395]],
"webp_vp8.webp" => [:webp, [550, 368]],
"webp_animated.webp" => [:webp, [400, 400]],
"test.svg" => [:svg, [200, 300]],
"test_partial_viewport.svg" => [:svg, [860, 400]],
"test2.svg" => [:svg, [366, 271]],
"test3.svg" => [:svg, [255, 48]],
"test4.svg" => [:svg, [271, 271]],
"orient_6.jpg"=>[:jpeg, [1250,2500]]
"test5.svg" => [:svg, [255, 48]],
"test7.svg" => [:svg, [100, 100]],
"orient_6.jpg"=>[:jpeg, [1250,2500]],
"heic/test.heic"=>[:heic, [700,476]],
"heic/heic-empty.heic"=>[:heic, [3992,2992]],
"heic/heic-iphone.heic"=>[:heic,[4032,3024]],
"heic/heic-iphone7.heic"=>[:heic,[4032,3024]],
"heic/heic-maybebroken.HEIC"=>[:heic,[4032,3024]],
"heic/heic-single.heic"=>[:heif,[1440,960]],
"heic/heic-collection.heic"=>[:heif,[1440,960]],
"heic/inverted.heic"=>[:heic,[3024, 4032]],
"heic/test-meta-after-mdat.heic"=>[:heic,[4000, 3000]],
"test6.svg" => [:svg, [450, 450]],
"avif/hato.avif" => [:avif, [3082, 2048]],
"avif/fox.avif" => [:avif, [1204, 799]],
"avif/kimono.avif" => [:avif, [722, 1024]],
"avif/red_green_flash.avif" => [:avif, [256, 256]],
"isobmff.jxl" => [:jxl, [1280,1600]],
"naked.jxl" => [:jxl, [1000,1000]],
"test.dng" => [:tiff, [4032, 3024]]
}
BadFixtures = [
@ -47,7 +69,8 @@ BadFixtures = [
"test.xml",
"test2.xml",
"a.CR2",
"a.CRW"
"a.CRW",
"avif/star.avifs",
]
# man.ico courtesy of http://www.iconseeker.com/search-icon/artists-valley-sample/business-man-blue.html
# test_rgb.ct courtesy of http://fileformats.archiveteam.org/wiki/Scitex_CT
@ -92,22 +115,37 @@ end
class FastImageTest < Test::Unit::TestCase
def test_should_report_type_correctly
GoodFixtures.each do |fn, info|
assert_equal info[0], FastImage.type(TestUrl + fn)
assert_equal info[0], FastImage.type(TestUrl + fn, :raise_on_failure=>true)
assert_equal info[0], FastImage.type(TestUrl + fn), "type of image #{fn} must be #{info[0]}"
assert_equal info[0], FastImage.type(TestUrl + fn, :raise_on_failure=>true), "type of image #{fn} must be #{info[0]}"
end
end
def test_should_report_size_correctly
GoodFixtures.each do |fn, info|
assert_equal info[1], FastImage.size(TestUrl + fn)
assert_equal info[1], FastImage.size(TestUrl + fn, :raise_on_failure=>true)
assert_equal info[1], FastImage.size(TestUrl + fn), "size for #{fn} must be #{info[1]}"
assert_equal info[1], FastImage.size(TestUrl + fn, :raise_on_failure=>true), "size for #{fn} must be #{info[1]}"
end
end
def test_should_report_animated_correctly
assert_equal nil, FastImage.animated?(TestUrl + "test.png")
assert_equal nil, FastImage.animated?(TestUrl + "test.jpg")
assert_equal false, FastImage.animated?(TestUrl + "test.png")
assert_equal false, FastImage.animated?(TestUrl + "test.gif")
assert_equal true, FastImage.animated?(TestUrl + "animated.gif")
assert_equal true, FastImage.animated?(TestUrl + "animated.png")
assert_equal true, FastImage.animated?(TestUrl + "animated_without_gct.gif")
assert_equal false, FastImage.animated?(TestUrl + "webp_vp8x.webp")
assert_equal true, FastImage.animated?(TestUrl + "webp_animated.webp")
assert_equal false, FastImage.animated?(TestUrl + "avif/hato.avif")
assert_equal true, FastImage.animated?(TestUrl + "avif/red_green_flash.avif")
end
def test_should_report_multiple_properties
fi = FastImage.new(File.join(FixturePath, "animated.gif"))
assert_equal :gif, fi.type
assert_equal [400, 400], fi.size
assert_equal true, fi.animated
assert_equal 1001718, fi.content_length
end
def test_should_return_nil_on_fetch_failure
@ -168,13 +206,13 @@ class FastImageTest < Test::Unit::TestCase
def test_should_report_type_correctly_for_local_files
GoodFixtures.each do |fn, info|
assert_equal info[0], FastImage.type(File.join(FixturePath, fn))
assert_equal info[0], FastImage.type(File.join(FixturePath, fn)), "type of image #{fn} must be #{info[0]}"
end
end
def test_should_report_size_correctly_for_local_files
GoodFixtures.each do |fn, info|
assert_equal info[1], FastImage.size(File.join(FixturePath, fn))
assert_equal info[1], FastImage.size(File.join(FixturePath, fn)), "size for #{fn} must be #{info[1]}"
end
end
@ -185,7 +223,7 @@ class FastImageTest < Test::Unit::TestCase
def test_should_report_type_correctly_for_ios
GoodFixtures.each do |fn, info|
File.open(File.join(FixturePath, fn), "r") do |io|
assert_equal info[0], FastImage.type(io)
assert_equal info[0], FastImage.type(io), "type of image #{fn} must be #{info[0]}"
end
end
end
@ -193,7 +231,7 @@ class FastImageTest < Test::Unit::TestCase
def test_should_report_size_correctly_for_ios
GoodFixtures.each do |fn, info|
File.open(File.join(FixturePath, fn), "r") do |io|
assert_equal info[1], FastImage.size(io)
assert_equal info[1], FastImage.size(io), "size for #{fn} must be #{info[1]}"
end
end
end
@ -202,7 +240,7 @@ class FastImageTest < Test::Unit::TestCase
GoodFixtures.each do |fn, info|
File.open(File.join(FixturePath, fn), "r") do |io|
io.read
assert_equal info[0], FastImage.type(io)
assert_equal info[0], FastImage.type(io), "type of image #{fn} must be #{info[0]}"
end
end
end
@ -211,7 +249,7 @@ class FastImageTest < Test::Unit::TestCase
GoodFixtures.each do |fn, info|
File.open(File.join(FixturePath, fn), "r") do |io|
io.read
assert_equal info[1], FastImage.size(io)
assert_equal info[1], FastImage.size(io), "size for #{fn} must be #{info[1]}"
end
end
end
@ -408,6 +446,13 @@ class FastImageTest < Test::Unit::TestCase
FakeWeb.register_uri(:get, url, :body => File.join(FixturePath, "test.jpg"), :content_length => 52)
assert_equal 52, FastImage.new(url).content_length
assert_equal 322, FastImage.new(File.join(FixturePath, "test.png")).content_length
assert_equal 322, FastImage.new(Pathname.new(File.join(FixturePath, "test.png"))).content_length
string = File.read(File.join(FixturePath, "test.png"))
stringio = StringIO.new(string)
assert_equal 322, FastImage.new(stringio).content_length
end
def test_content_length_not_provided
@ -444,7 +489,7 @@ class FastImageTest < Test::Unit::TestCase
def test_should_support_data_uri_scheme_images
assert_equal DataUriImageInfo[0], FastImage.type(DataUriImage)
assert_equal DataUriImageInfo[1], FastImage.size(DataUriImage)
assert_raises(FastImage::ImageFetchFailure) do
assert_raises(FastImage::CannotParseImage) do
FastImage.type("data:", :raise_on_failure => true)
end
end
@ -465,4 +510,35 @@ class FastImageTest < Test::Unit::TestCase
FastImage.size(TestUrl + "a.CRW", :raise_on_failure=>true)
end
end
def test_returns_nil_when_uri_is_nil
assert_equal nil, FastImage.size(nil)
end
def test_raises_when_uri_is_nil_and_raise_on_failure_is_set
assert_raises(FastImage::BadImageURI) do
FastImage.size(nil, :raise_on_failure => true)
end
end
def test_width
assert_equal 30, FastImage.new(TestUrl + "test.png").width
assert_equal nil, FastImage.new(TestUrl + "does_not_exist").width
end
def test_height
assert_equal 20, FastImage.new(TestUrl + "test.png").height
assert_equal nil, FastImage.new(TestUrl + "does_not_exist").height
end
def test_content_length_after_size
fi = FastImage.new(File.join(FixturePath, "test.png"))
fi.size
assert_equal 322, fi.content_length
end
def test_unknown_protocol
FakeWeb.register_uri(:get, "http://example.com/test", body: "", location: "hhttp://example.com", :status => 301)
assert_nil FastImage.size("http://example.com/test")
end
end