Packages
image
0.36.1
0.72.0
0.71.0
0.70.0
0.69.0
0.68.0
0.67.0
0.67.0-dev
retired
0.66.0
0.65.0
0.64.0
0.63.0
0.62.1
0.62.0
0.61.1
0.61.0
0.60.0
0.59.3
0.59.2
0.59.1
0.59.0
0.58.0
0.57.0
0.56.1
0.56.0
0.55.2
0.55.1
retired
0.55.0
0.54.4
0.54.3
0.54.2
0.54.1
0.54.0
0.53.0
0.52.3
0.52.2
0.52.1
0.52.0
retired
0.51.0
0.50.0
0.49.0
0.48.1
0.48.0
0.47.0
0.46.0
0.45.0
0.44.0
0.43.2
0.43.1
0.43.0
0.42.0
0.41.0
0.40.0
0.39.3
0.39.2
0.39.1
0.39.0
0.38.4
0.38.3
0.38.2
0.38.1
0.38.0
0.37.0
0.36.2
0.36.1
0.36.0
0.35.0
0.34.0
0.33.0
0.32.0
0.31.1
0.31.0
0.30.0
0.29.0
0.28.2
0.28.1
0.28.0
0.27.0
0.26.0
0.25.1
0.25.0
0.24.1
0.24.0
0.23.2
0.23.1
0.23.0
0.22.1
0.22.0
0.21.0
0.20.0
retired
0.19.0
0.18.1
0.18.0
0.17.0
0.16.0
0.15.0
0.14.4
0.14.2
0.14.1
0.14.0
retired
0.13.1
0.13.0
0.12.0
0.11.0
0.10.0
0.10.0-rc.0
retired
0.9.0
retired
0.8.0
0.7.0
0.6.0
0.5.0
0.4.0
0.3.0
0.2.0
0.1.0
An approachable image processing library primarily based upon Vix and libvips that is NIF-based, fast, multi-threaded, pipelined and has a low memory footprint.
Current section
Files
Jump to
Current section
Files
lib/image/options/thumbnail.ex
defmodule Image.Options.Thumbnail do
@moduledoc """
Options and option validation for `Image.thumbnail/3`.
"""
alias Image.Options.Crop
alias Image.Color
import Color, only: [is_inbuilt_profile: 1]
import Image, only: [is_size: 1]
@typedoc """
Options applicable to Image.thumbnail/3
"""
@type thumbnail_options :: [
{:autorotate, boolean()}
| {:intent, Image.render_intent()}
| {:export_icc_profile, Color.icc_profile()}
| {:import_icc_profile, Color.icc_profile()}
| {:linear, boolean()}
| {:resize, resize_dimension()}
| {:height, pos_integer()}
| {:crop, Crop.crop_focus()}
| {:file, :fill | :contain | :cover}
]
@type resize_dimension :: :width | :height | :both
@intent_map %{
perceptual: :VIPS_INTENT_PERCEPTUAL,
relative: :VIPS_INTENT_RELATIVE,
saturation: :VIPS_INTENT_SATURATION,
absolute: :VIPS_INTENT_ABSOLUTE
}
@intent Map.keys(@intent_map)
@resize_map %{
up: :VIPS_SIZE_UP,
down: :VIPS_SIZE_DOWN,
both: :VIPS_SIZE_BOTH,
force: :VIPS_SIZE_FORCE
}
@resize Map.keys(@resize_map)
@doc """
Validate the options for `Image.resize/2`.
See `t:Image.Options.Resize.resize_options/0`.
"""
def validate_options(options) do
case Enum.reduce_while(options, options, &validate_option(&1, &2)) do
{:error, value} ->
{:error, value}
options ->
{:ok, options}
end
end
defp validate_option({:autorotate, autorotate}, options) when is_boolean(autorotate) do
options =
options
|> Keyword.delete(:autorotate)
|> Keyword.put(:"auto-rotate", autorotate)
{:cont, options}
end
defp validate_option({:resize, resize}, options) when resize in @resize do
resize = Map.fetch!(@resize_map, resize)
options =
options
|> Keyword.delete(:resize)
|> Keyword.put(:size, resize)
{:cont, options}
end
defp validate_option({:crop, crop}, options) do
Crop.validate_crop(crop, options)
end
defp validate_option({:linear, linear}, options) when is_boolean(linear) do
{:cont, options}
end
defp validate_option({:height, height}, options) when is_integer(height) and height > 0 do
{:cont, options}
end
defp validate_option({:intent, intent}, options) when intent in @intent do
intent = Map.fetch!(@intent_map, intent)
{:cont, Keyword.put(options, :intent, intent)}
end
defp validate_option({:import_icc_profile, profile}, options)
when is_inbuilt_profile(profile) or is_binary(profile) do
options =
options
|> Keyword.delete(:import_icc_profile)
|> Keyword.put(:"import-profile", to_string(profile))
if Image.Color.known_icc_profile?(profile) do
{:cont, options}
else
{:halt, {:error, "The color profile #{inspect(profile)} is not known"}}
end
end
defp validate_option({:export_icc_profile, profile}, options)
when is_inbuilt_profile(profile) or is_binary(profile) do
options =
options
|> Keyword.delete(:export_icc_profile)
|> Keyword.put(:"export-profile", to_string(profile))
if Image.Color.known_icc_profile?(profile) do
{:cont, options}
else
{:halt, {:error, "The color profile #{inspect(profile)} is not known"}}
end
end
defp validate_option({:fit, :fill}, options) do
options =
options
|> Keyword.put(:size, :VIPS_SIZE_FORCE)
|> Keyword.delete(:fit)
{:cont, options}
end
defp validate_option({:fit, :contain}, options) do
options =
options
|> Keyword.put(:crop, :VIPS_INTERESTING_NONE)
|> Keyword.put(:size, :VIPS_SIZE_BOTH)
{:cont, options}
end
defp validate_option({:fit, :cover}, options) do
current_crop = Keyword.get(options, :crop, :VIPS_INTERESTING_NONE)
crop =
if current_crop == :VIPS_INTERESTING_NONE, do: :VIPS_INTERESTING_CENTRE, else: current_crop
options =
options
|> Keyword.put(:crop, crop)
|> Keyword.put(:size, :VIPS_SIZE_BOTH)
|> Keyword.delete(:fit)
{:cont, options}
end
defp validate_option(option, _options) do
{:halt, {:error, invalid_option(option)}}
end
defp invalid_option(option) do
"Invalid Image.thumbnail option or option value: #{inspect(option)}"
end
@doc false
def validate_dimensions(dimensions, options) do
case dimensions(String.split(dimensions, ["x"])) do
width when is_size(width) ->
{:ok, width, options}
{width, height} when is_size(width) and is_size(height) ->
{:ok, width, Keyword.put(options, :height, height)}
_other ->
{:error, "Invalid dimensions. Found #{inspect(dimensions)}"}
end
end
defp dimensions([width]) do
case Integer.parse(width) do
{integer, ""} -> integer
_other -> width
end
end
defp dimensions([width, ""]) do
dimensions([width])
end
defp dimensions([width, height]) do
width = dimensions([width])
height = dimensions([height])
{width, height}
end
end