module Frameit class Editor attr_accessor :screenshot # reference to the screenshot object to fetch the path, title, etc. attr_accessor :frame # the frame of the device attr_accessor :image # the current image used for editing attr_accessor :top_space_above_device def frame!(screenshot) self.screenshot = screenshot prepare_image if load_frame # Mac doesn't need a frame self.frame = MiniMagick::Image.open(load_frame) self.frame.rotate(90) unless self.screenshot.portrait? # we use portrait device frames for landscape screenshots elsif self.class == Editor # Couldn't find device frame (probably an iPhone 4, for which there are no images available any more) # Message is already shown elsewhere return end if should_add_title? @image = complex_framing else # easy mode from 1.0 - no title or background put_into_frame # put it in the frame end store_result # write to file system end def load_frame TemplateFinder.get_template(screenshot) end def prepare_image @image = MiniMagick::Image.open(screenshot.path) end private def store_result output_path = screenshot.path.gsub('.png', '_framed.png').gsub('.PNG', '_framed.png') image.format("png") image.write(output_path) UI.success "Added frame: '#{File.expand_path(output_path)}'" end # puts the screenshot into the frame def put_into_frame # We have to rotate the screenshot, since the offset information is for portrait # only. Instead of doing the calculations ourselves, it's much easier to let # imagemagick do the hard lifting for landscape screenshots unless self.screenshot.portrait? frame.rotate(-90) @image.rotate(-90) end @image = frame.composite(image, "png") do |c| c.compose "Over" c.geometry offset['offset'] end # We have to revert the state to be landscape screenshots unless self.screenshot.portrait? frame.rotate(90) @image.rotate(90) end end def offset return @offset_information if @offset_information @offset_information = fetch_config['offset'] || Offsets.image_offset(screenshot).dup if @offset_information and (@offset_information['offset'] or @offset_information['offset']) return @offset_information end UI.user_error! "Could not find offset_information for '#{screenshot}'" end ######################################################################################### # Everything below is related to title, background, etc. and is not used in the easy mode ######################################################################################### # this is used to correct the 1:1 offset information # the offset information is stored to work for the template images # since we resize the template images to have higher quality screenshots # we need to modify the offset information by a certain factor def modify_offset(multiplicator) # Format: "+133+50" hash = offset['offset'] x = hash.split("+")[1].to_f * multiplicator y = hash.split("+")[2].to_f * multiplicator new_offset = "+#{x.round}+#{y.round}" @offset_information['offset'] = new_offset end # Do we add a background and title as well? def should_add_title? return (fetch_config['background'] and (fetch_config['title'] or fetch_config['keyword'])) end # more complex mode: background, frame and title def complex_framing background = generate_background self.top_space_above_device = vertical_frame_padding if fetch_config['title'] background = put_title_into_background(background, fetch_config['stack_title']) end if self.frame # we have no frame on le mac resize_frame! put_into_frame # Decrease the size of the framed screenshot to fit into the defined padding + background frame_width = background.width - horizontal_frame_padding * 2 frame_height = background.height - top_space_above_device - vertical_frame_padding if fetch_config['show_complete_frame'] # calculate the final size of the screenshot to resize in one go # it may be limited either by the width or height of the frame image_aspect_ratio = @image.width.to_f / @image.height.to_f image_width = [frame_width, @image.width].min image_height = [frame_height, image_width / image_aspect_ratio].min image_width = image_height * image_aspect_ratio @image.resize "#{image_width}x#{image_height}" if image_width < @image.width || image_height < @image.height else # the screenshot size is only limited by width. # If higher than the frame, the screenshot is cut off at the bottom @image.resize "#{frame_width}x" if frame_width < @image.width end end @image = put_device_into_background(background) image end # Horizontal adding around the frames def horizontal_frame_padding padding = fetch_config['padding'] if padding.kind_of?(String) && padding.split('x').length == 2 padding = padding.split('x')[0].to_i end return scale_padding(padding) end # Vertical adding around the frames def vertical_frame_padding padding = fetch_config['padding'] if padding.kind_of?(String) && padding.split('x').length == 2 padding = padding.split('x')[1].to_i end return scale_padding(padding) end def scale_padding(padding) if padding.kind_of?(String) && padding.end_with?('%') padding = ([image.width, image.height].min * padding.to_f * 0.01).ceil end multi = 1.0 multi = 1.7 if self.screenshot.triple_density? return padding * multi end # Returns a correctly sized background image def generate_background background = MiniMagick::Image.open(fetch_config['background']) if background.height != screenshot.size[1] background.resize "#{screenshot.size[0]}x#{screenshot.size[1]}!" # `!` says it should ignore the ratio end background end def put_device_into_background(background) left_space = (background.width / 2.0 - image.width / 2.0).round @image = background.composite(image, "png") do |c| c.compose "Over" c.geometry "+#{left_space}+#{top_space_above_device}" end return image end # Resize the frame as it's too low quality by default def resize_frame! screenshot_width = self.screenshot.portrait? ? screenshot.size[0] : screenshot.size[1] multiplicator = (screenshot_width.to_f / offset['width'].to_f) # by how much do we have to change this? new_frame_width = multiplicator * frame.width # the new width for the frame frame.resize "#{new_frame_width.round}x" # resize it to the calculated width modify_offset(multiplicator) # modify the offset to properly insert the screenshot into the frame later end def resize_text(text) width = text.width ratio = (width + (keyword_padding + horizontal_frame_padding) * 2) / image.width.to_f if ratio > 1.0 # too large - resizing now smaller = (1.0 / ratio) text.resize "#{(smaller * text.width).round}x" end end # Add the title above the device def put_title_into_background_stacked(background, title, keyword) resize_text(title) resize_text(keyword) title_width = title.width keyword_width = keyword.width vertical_padding = vertical_frame_padding keyword_top_space = vertical_padding spacing_between_title_and_keyword = (title.height / 2) title_top_space = vertical_padding + keyword.height + spacing_between_title_and_keyword title_left_space = (background.width / 2.0 - title_width / 2.0).round keyword_left_space = (background.width / 2.0 - keyword_width / 2.0).round self.top_space_above_device += title.height + keyword.height + spacing_between_title_and_keyword + vertical_padding # keyword background = background.composite(keyword, "png") do |c| c.compose "Over" c.geometry "+#{keyword_left_space}+#{keyword_top_space}" end # Then, put the title on top of the screenshot next to the keyword background = background.composite(title, "png") do |c| c.compose "Over" c.geometry "+#{title_left_space}+#{title_top_space}" end background end def put_title_into_background(background, stack_title) title_images = build_title_images(image.width - 2 * horizontal_frame_padding, image.height - 2 * vertical_frame_padding) keyword = title_images[:keyword] title = title_images[:title] if stack_title && !keyword.nil? && !title.nil? && keyword.width > 0 && title.width > 0 background = put_title_into_background_stacked(background, title, keyword) return background end # sum_width: the width of both labels together including the space inbetween # is used to calculate the ratio sum_width = title.width sum_width += keyword.width + keyword_padding if keyword # Resize the 2 labels if necessary smaller = 1.0 # default ratio = (sum_width + (keyword_padding + horizontal_frame_padding) * 2) / image.width.to_f if ratio > 1.0 # too large - resizing now smaller = (1.0 / ratio) UI.verbose("Text for image #{self.screenshot.path} is quite long, reducing font size by #{(ratio - 1.0).round(2)}") title.resize "#{(smaller * title.width).round}x" keyword.resize "#{(smaller * keyword.width).round}x" if keyword sum_width *= smaller end vertical_padding = vertical_frame_padding top_space = vertical_padding + (actual_font_size - title.height) / 2 left_space = (background.width / 2.0 - sum_width / 2.0).round self.top_space_above_device += actual_font_size + vertical_padding # First, put the keyword on top of the screenshot, if we have one if keyword background = background.composite(keyword, "png") do |c| c.compose "Over" c.geometry "+#{left_space}+#{top_space}" end left_space += keyword.width + (keyword_padding * smaller) end # Then, put the title on top of the screenshot next to the keyword background = background.composite(title, "png") do |c| c.compose "Over" c.geometry "+#{left_space}+#{top_space}" end background end def actual_font_size font_scale_factor = fetch_config['font_scale_factor'] || 0.1 [@image.width * font_scale_factor].max.round end # The space between the keyword and the title def keyword_padding (actual_font_size / 3.0).round end # This will build 2 individual images with the title, which will then be added to the real image def build_title_images(max_width, max_height) words = [:keyword, :title].keep_if { |a| fetch_text(a) } # optional keyword/title results = {} words.each do |key| # Create empty background empty_path = File.join(Frameit::ROOT, "lib/assets/empty.png") title_image = MiniMagick::Image.open(empty_path) image_height = max_height # gets trimmed afterwards anyway, and on the iPad the `y` would get cut title_image.combine_options do |i| # Oversize as the text might be larger than the actual image. We're trimming afterwards anyway i.resize "#{max_width * 5.0}x#{image_height}!" # `!` says it should ignore the ratio end current_font = font(key) text = fetch_text(key) UI.verbose("Using #{current_font} as font the #{key} of #{screenshot.path}") if current_font UI.verbose("Adding text '#{text}'") text.gsub! '\n', "\n" text.gsub!(/(?