Repository URL to install this package:
Version:
2.4.1b3 ▾
|
import inspect
from wagtail.images.exceptions import InvalidFilterSpecError
from wagtail.images.rect import Rect
from wagtail.images.utils import parse_color_string
class Operation:
def __init__(self, method, *args):
self.method = method
self.args = args
# Check arguments
try:
inspect.getcallargs(self.construct, *args)
except TypeError as e:
raise InvalidFilterSpecError(e)
# Call construct
try:
self.construct(*args)
except ValueError as e:
raise InvalidFilterSpecError(e)
def construct(self, *args):
raise NotImplementedError
def run(self, willow, image, env):
raise NotImplementedError
class DoNothingOperation(Operation):
def construct(self):
pass
def run(self, willow, image, env):
pass
class FillOperation(Operation):
vary_fields = ('focal_point_width', 'focal_point_height', 'focal_point_x', 'focal_point_y')
def construct(self, size, *extra):
# Get width and height
width_str, height_str = size.split('x')
self.width = int(width_str)
self.height = int(height_str)
# Crop closeness
self.crop_closeness = 0
for extra_part in extra:
if extra_part.startswith('c'):
self.crop_closeness = int(extra_part[1:])
else:
raise ValueError("Unrecognised filter spec part: %s" % extra_part)
# Divide it by 100 (as it's a percentage)
self.crop_closeness /= 100
# Clamp it
if self.crop_closeness > 1:
self.crop_closeness = 1
def run(self, willow, image, env):
image_width, image_height = willow.get_size()
focal_point = image.get_focal_point()
# Get crop aspect ratio
crop_aspect_ratio = self.width / self.height
# Get crop max
crop_max_scale = min(image_width, image_height * crop_aspect_ratio)
crop_max_width = crop_max_scale
crop_max_height = crop_max_scale / crop_aspect_ratio
# Initialise crop width and height to max
crop_width = crop_max_width
crop_height = crop_max_height
# Use crop closeness to zoom in
if focal_point is not None:
# Get crop min
crop_min_scale = max(focal_point.width, focal_point.height * crop_aspect_ratio)
crop_min_width = crop_min_scale
crop_min_height = crop_min_scale / crop_aspect_ratio
# Sometimes, the focal point may be bigger than the image...
if not crop_min_scale >= crop_max_scale:
# Calculate max crop closeness to prevent upscaling
max_crop_closeness = max(
1 - (self.width - crop_min_width) / (crop_max_width - crop_min_width),
1 - (self.height - crop_min_height) / (crop_max_height - crop_min_height)
)
# Apply max crop closeness
crop_closeness = min(self.crop_closeness, max_crop_closeness)
if 1 >= crop_closeness >= 0:
# Get crop width and height
crop_width = crop_max_width + (crop_min_width - crop_max_width) * crop_closeness
crop_height = crop_max_height + (crop_min_height - crop_max_height) * crop_closeness
# Find focal point UV
if focal_point is not None:
fp_x, fp_y = focal_point.centroid
else:
# Fall back to positioning in the centre
fp_x = image_width / 2
fp_y = image_height / 2
fp_u = fp_x / image_width
fp_v = fp_y / image_height
# Position crop box based on focal point UV
crop_x = fp_x - (fp_u - 0.5) * crop_width
crop_y = fp_y - (fp_v - 0.5) * crop_height
# Convert crop box into rect
rect = Rect.from_point(crop_x, crop_y, crop_width, crop_height)
# Make sure the entire focal point is in the crop box
if focal_point is not None:
rect = rect.move_to_cover(focal_point)
# Don't allow the crop box to go over the image boundary
rect = rect.move_to_clamp(Rect(0, 0, image_width, image_height))
# Crop!
willow = willow.crop(rect.round())
# Get scale for resizing
# The scale should be the same for both the horizontal and
# vertical axes
aftercrop_width, aftercrop_height = willow.get_size()
scale = self.width / aftercrop_width
# Only resize if the image is too big
if scale < 1.0:
# Resize!
willow = willow.resize((self.width, self.height))
return willow
class MinMaxOperation(Operation):
def construct(self, size):
# Get width and height
width_str, height_str = size.split('x')
self.width = int(width_str)
self.height = int(height_str)
def run(self, willow, image, env):
image_width, image_height = willow.get_size()
horz_scale = self.width / image_width
vert_scale = self.height / image_height
if self.method == 'min':
if image_width <= self.width or image_height <= self.height:
return
if horz_scale > vert_scale:
width = self.width
height = int(image_height * horz_scale)
else:
width = int(image_width * vert_scale)
height = self.height
elif self.method == 'max':
if image_width <= self.width and image_height <= self.height:
return
if horz_scale < vert_scale:
width = self.width
height = int(image_height * horz_scale)
else:
width = int(image_width * vert_scale)
height = self.height
else:
# Unknown method
return
return willow.resize((width, height))
class WidthHeightOperation(Operation):
def construct(self, size):
self.size = int(size)
def run(self, willow, image, env):
image_width, image_height = willow.get_size()
if self.method == 'width':
if image_width <= self.size:
return
scale = self.size / image_width
width = self.size
height = int(image_height * scale)
elif self.method == 'height':
if image_height <= self.size:
return
scale = self.size / image_height
width = int(image_width * scale)
height = self.size
else:
# Unknown method
return
return willow.resize((width, height))
class ScaleOperation(Operation):
def construct(self, percent):
self.percent = float(percent)
def run(self, willow, image, env):
image_width, image_height = willow.get_size()
scale = self.percent / 100
width = float(image_width * scale)
height = float(image_height * scale)
return willow.resize((width, height))
class JPEGQualityOperation(Operation):
def construct(self, quality):
self.quality = int(quality)
if self.quality > 100:
raise ValueError("JPEG quality must not be higher than 100")
def run(self, willow, image, env):
env['jpeg-quality'] = self.quality
class FormatOperation(Operation):
def construct(self, fmt):
self.format = fmt
if self.format not in ['jpeg', 'png', 'gif']:
raise ValueError("Format must be either 'jpeg', 'png' or 'gif'")
def run(self, willow, image, env):
env['output-format'] = self.format
class BackgroundColorOperation(Operation):
def construct(self, color_string):
self.color = parse_color_string(color_string)
def run(self, willow, image, env):
return willow.set_background_color_rgb(self.color)