From 6a6f83747ec67a47d5ad624d7559a57dd0c8dcf2 Mon Sep 17 00:00:00 2001 From: Dietmar Maurer Date: Tue, 8 Nov 2016 08:11:21 +0100 Subject: [PATCH] README.adoc: improve docs about screenshots --- README.adoc | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.adoc b/README.adoc index 2970e60..6964087 100644 --- a/README.adoc +++ b/README.adoc @@ -256,6 +256,25 @@ screenshot by setting the 'thumbnail' attribute on a paragraph: First, it should be noted ... ---- +The corresponding file need to reside inside folder +`images/screenshot`, and should be in `.png` image format. We include +the screenshots in printed documentation, and 'pdftex' uses the +density (DPI) specified inside the file. So all screenshots should use +the same density. We currently require the density set to 146 DPI, so +that we can display a 1024 pixels wide image. You should not include +larger screenshots (although it is possible). + +You can use the `./png-cleanup.pl` script to set the correct +density. Simply use the following command to import a screenshot +image: + +---- +# ./png-cleanup.pl screenshot.png images/screenshot/screenshot.png +---- + +TIP: You can use `identify -verbose screenshot.png` command to show +all image attributes (from debian package 'imagemagick') + -- 2.39.2