docToolchain icon indicating copy to clipboard operation
docToolchain copied to clipboard

Image Editing features

Open rdmueller opened this issue 6 years ago • 2 comments

Imagine you want to use exported ppt slides in your docs, but you don't want to always show the header and footer of the slides which might containt the slide number and other details. This disturbs the look and feel of your docs.

Wouldn't it be nice if you could crop those images on the fly? Something like `image::slide3.png[crop="10%,0,5%,0"]?

This looks like a change to asciidoc or asciidoctor extension, but asciidoctor does not change images or create new images. So a different mechanism would be needed - sounds like a feature for docToolchain, doesn't it?

Here are some ideas which come to my mind:

  • crop: just crop the image given the amount to crop as pixels or percentage. top, right, bottom, left
  • spot: a spotlight effect like the one created by keynote or the logitech presenter: spotlight
  • frame: insert the image into a frame. This can be used to add a frame of a mobile device or just to add a shadow
  • overlay: add something like a watermark

This feature could be implemented

  • as part of the pptExport. But then it wouldn't be universally usable
  • as part of the adoc-file. Add seomthing as comment which will be parsed by docToolchain. dT will then create the images upfront and the doc can expect them to be available. Problem: dT will not know about the imagesDir

rdmueller avatar Dec 27 '18 11:12 rdmueller

here is some code for image manipulation: https://github.com/asciidoctor/asciidoctorj-screenshot/blob/7991c455c5079ceba1d8b097f0dbe8904df9c248/src/main/groovy/org/asciidoctor/extension/ScreenshotTaker.groovy

rdmueller avatar Dec 27 '18 11:12 rdmueller

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Just add a small comment to keep it open. Thank you for your contributions.

stale[bot] avatar Aug 13 '20 14:08 stale[bot]