{"id":2690,"date":"2019-03-10T13:58:17","date_gmt":"2019-03-10T13:58:17","guid":{"rendered":"http:\/\/julius-ihle.de\/?p=2690"},"modified":"2019-03-10T17:16:29","modified_gmt":"2019-03-10T17:16:29","slug":"making-image-magick","status":"publish","type":"post","link":"https:\/\/julius-ihle.de\/?p=2690","title":{"rendered":"Making Image Magic(k)"},"content":{"rendered":"

\"imagemagick\"<\/a><\/p>\n

One of the things I found myself having to do more and more recently was creating contactsheets. This is mainly to keep an overview for myself over all the shots in every sequence for example. It usually saves me a lot of time, especially at the beginning of a show when I wasn’t neccesserely familiar yet with all the shots we had to work on.
\nCreating the contactsheets themselves however proved to be rather tedious as my workflow consisted of doing it all in Nuke. Adding, shuffling or annotating shots wasn’t really easy without some serious Python trickery. Luckily I found a great alternative.<\/p>\n

So what’s the fancy title all about? The tool that I’m going to be using is an open source command line image-editing utility called Image Magick<\/a>. The beauty of it is that it can be used to batch-process a ton of images. It can seem quite overwhelming at first as it ships with a lot of utilities and options but this is what also makes it so powerful. A lot details and examples can be found in the v6 documentation HERE<\/a>.<\/p>\n

I should preface this write-up by saying that I only touched the tip of the iceberg and am still discovering new things day by day.<\/p>\n

What I did know was the main purpose I wanted to use it for: Stitching thumbnails of all relevant shots from our database so that I would have a one-stop quick overview for the shots. Alongside this I wanted to have the following information displayed for each shot:
\n-annotate each thumbnail with the shotname
\n-show some info from the database about the status from relevant departments
\n-annotate each thumbnail with assigned artist<\/p>\n

Goal is set, so here’s a quick rundown on my humble tests. I have been using the following 3 utilities that ship with ImageMagick:
\nconvert<\/em><\/strong>
\nmontage<\/em><\/strong>
\nidentify<\/em><\/strong><\/p>\n

convert<\/em> is pretty straight forward. It’s main purpose is to do all sort of image manipulation. Transforms, filters, color corrections, annotations – you name it.
\nmontage<\/em> is very useful for stitching multiple images together to create a collage.
\nidentify<\/em> is a useful tool for getting information about an image such as resolution, color space, etc.<\/p>\n

I set up a testproject with some thumbnails based on a sort-of famous movie… I made up sequence- and shot names. Alltogether I have 7 sequences, each with a couple of shots inside them. The directory structure is split up so we have $PROJ\/$SEQ\/$SHOT\/thumbnail.png<\/em>:
\n.
\n\u251c\u2500\u2500 testproj
\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 FS
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0310
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 test.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 thumbnail.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0320
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 thumbnail.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0330
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 thumbnail.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0360
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 thumbnail.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0370
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 thumbnail.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 0390
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u2514\u2500\u2500 thumbnail.png
\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 GR
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0040
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 thumbnail.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0050
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 thumbnail.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0060
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 thumbnail.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0070
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 thumbnail.png<\/p>\n

etc…<\/p>\n

The general syntax for using the image magick tools is
\nmagick tool inputImage [-options] outputImage<\/em>
\nexample:<\/p>\n

[shell]magick convert thumbnail.png -resize 50% test.jpg[\/shell]<\/p>\n

This will shrink the input image thumbnail.png by 50% and save the output as test.jpg. Easy enough…
\n(Note that the magick<\/em> prefix has only been introduced from ImageMagick v7 onwards.)<\/p>\n

However my thumbnails are not really thumbnails at the moment. They are massive as they are just screenshots from the BluRay. I want to resize them down from their original size of 1920×1040 to 640×480. 640×480 is a different aspect ratio however and the default for resizing an image using convert<\/em> is to resize the image to the specified width and keep the aspect ratio from the original image. I could use -extent<\/em> in the following way to force the output resolution:<\/p>\n

[shell]magick convert thumbnail.png -resize 640×480 -background black -gravity center -extent 640×480 test.png[\/shell]<\/p>\n

This will resize the original image to 640×347 (due to the different aspect ratio), extend the resolution to 640×480 afterwards and fill the empty areas with black while keeping the image centered.<\/p>\n

\"im_01\"<\/a><\/p>\n

 <\/p>\n

There are multiple ways to add text to an image. You can use -draw<\/em> to place text exactly where you want. Preceding options can define the style and positioning of the text. This example will create white text saying ‘test’, outlined with black and a size of 250 in the center of the image:<\/p>\n

[shell]magick convert thumbnail.png \\
\n -font DejaVu-Sans \\
\n -pointsize 250 \\
\n -fill white \\
\n -stroke black \\
\n -strokewidth 5 \\
\n -gravity center \\
\n -draw “text 0,0 ‘test'” test.png[\/shell]<\/p>\n

\"im_02\"<\/a><\/p>\n

 <\/p>\n

 <\/p>\n

ImageMagick’s main benefit lies in batch processing a multitude of images. I could shrink all my images and annotate them with the shot name in the same way as outlined above (in this case using bash):<\/p>\n

[shell]for sequence in testproj\/*; do
\n#get the sequence name from folder
\nseqName=$(basename ${sequence})
\n#create directory of current sequence inside seqSheets dir
\nmkdir -p seqSheets\/${seqName};
\n#create annotated thumbnail and export to seqSheets directory
\nfor thumb in ${sequence}\/*\/thumbnail.png; do
\n shotName=$(basename $(dirname ${thumb}))
\n magick convert $thumb \\
\n -resize 640×480 \\
\n -background black \\
\n -gravity center \\
\n -extent 640×480 \\
\n -font DejaVu-Sans-Bold \\
\n -pointsize 150 \\
\n -fill rgba\\(255,255,255,0.30\\) \\
\n -stroke black \\
\n -strokewidth 5 \\
\n -gravity center \\
\n -draw “text 0,0 ‘${shotName}'” \\
\n “seqSheets\/${seqName}\/${shotName}.png”;
\n done;
\ndone[\/shell]<\/p>\n

This way I have a small annotated version of each thumbnail inside a newly created seqSheets folder as well:
\n.
\n\u251c\u2500\u2500 seqSheets
\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 FS
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0310.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0320.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0330.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0360.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0370.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 0390.png
\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 GR
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0040.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0050.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0060.png
\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 0070.png<\/p>\n

Now that I have each shot annotated with its name I can use montage<\/em> to stack them on top of each other. I would like to do that in a specific way tough. Preferably I would like my contact sheet to be aligned at the top so I have the sequence names in one row and the shots for each sequence stacked beneath them:
\n\"im_03_seqsheetexample\"<\/a><\/p>\n

montage<\/em> is a great utility for aligning images as it features a lot of options. To be able to easily update things on a per-sequence level I decided to do an individual sheet per sequence first.
\nIf montage<\/em> is not being given any options it will try to align images in a more-or-less smart manner itself:<\/p>\n

[shell]magick montage seqSheets\/FS\/*png test.png[\/shell]<\/p>\n

\"im_04montage_no_options\"<\/a><\/p>\n

There are a number of ways how you can set your alignment in montage. You can use the -tile AxB<\/em> option to define how many rows and column your montage should have (where A<\/em> are the columns and B<\/em> the rows). As with a lot of options on the ImageMagick toolset it’s possible to leave out either rows or columns and montage will just force one column for example independent of how many images you have.<\/p>\n

[shell]montage seqSheets\/FS\/*png -tile 1x test.png[\/shell]<\/p>\n

\"im_05_montage_base\"<\/a><\/p>\n

My goal is to put all the individual sequence sheets next to each other afterwards. For this to be more straight forward I want to force each sequence sheet to have the same number of rows. I will therefore just grab the sequence with the most number of shots and set every sheet to have this number of rows:<\/p>\n

[shell]#grab the maximum number of shots per sequence<\/p>\n

maxShots=$(find testproj\/ | rev | cut -d “\/” -f2- | rev | sort | uniq -c | sort -k1n,1 | tail -n1 | sed ‘s\/^\\s*\/\/’ | cut -d ” ” -f1)
\nfor sequence in $(ls -d seqSheets\/*\/); do
\n seqName=$(basename ${sequence})
\n magick montage ${sequence}\/* \\
\n -background black \\
\n -fill white \\
\n -pointsize 18 \\
\n -font DejaVu-Sans-Bold \\
\n -title $seqName \\
\n -tile “1x${maxShots}” \\
\n “seqSheets\/${seqName}.png”
\ndone[\/shell]<\/p>\n

The resulting sheets will consequently all have the same dimensions so stitching them together afterwards will be pretty easy:
\n\"im_06FS\"<\/a> \"im_06GR\"<\/a> \"im_06MFB\"<\/a><\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

I will use convert<\/em> this time instead of montage<\/em> to simply append all of the images together. Reason being is that it will just keep the input formats and it’s a bit easier to control spacing using the -border<\/em> option. +append<\/em> stacks the images horizontally, -append<\/em> would stack them vertically:<\/p>\n

[shell]convert seqSheets\/*png \\
\n -background black \\
\n -bordercolor black \\
\n -border 25x \\
\n +append \\
\n final_contactsheet.png \\[\/shell]<\/p>\n

\"im_07finalcontactsheet\"<\/a><\/p>\n

Taking this further one could grab additional information from the project database. If there’s a way to access it via a Python API for example one could annotate each shot with their respective department status, assigned user, etc. This way it can provide lot’s of very useful information at a glance. I just made up something here but I hope it shows the point:
\n\"im_08final_contactsheet_extraInfo\"<\/a>
\n_________________________________________________<\/span>
\n If this post has helped you in any way you can express your gratefulness by using the Donate <\/em>Button below to buy me a coffee! :)<\/span><\/span>
\n\"\"<\/a><\/p>\n

\n
3M5xNSV7g2NzVpHMqzYKhgoKJZ8CWa644m<\/span><\/span>
\n\"bc_ldgr_qrcode\"<\/div>\n
<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

One of the things I found myself having to do more and more recently was creating contactsheets. This is mainly to keep an overview for myself over all the shots in every sequence for example. It usually saves me a lot of time, especially at the beginning of a show when I wasn’t neccesserely familiar […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-2690","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p3MXK6-Ho","jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/julius-ihle.de\/index.php?rest_route=\/wp\/v2\/posts\/2690","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/julius-ihle.de\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/julius-ihle.de\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/julius-ihle.de\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/julius-ihle.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2690"}],"version-history":[{"count":18,"href":"https:\/\/julius-ihle.de\/index.php?rest_route=\/wp\/v2\/posts\/2690\/revisions"}],"predecessor-version":[{"id":2719,"href":"https:\/\/julius-ihle.de\/index.php?rest_route=\/wp\/v2\/posts\/2690\/revisions\/2719"}],"wp:attachment":[{"href":"https:\/\/julius-ihle.de\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2690"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/julius-ihle.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=2690"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/julius-ihle.de\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=2690"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}