From 5c858db2917d787fc61f4a47ccc991af1d248085 Mon Sep 17 00:00:00 2001
From: ulrich <not disclosed>
Date: Sun, 14 Jan 2018 12:59:18 +0000
Subject: [PATCH] Erlaeuterungen zu kleiner.sh erweitert; Qualitaet bei der Bilderausgabe hinzugefuegt

---
 src/kleiner.sh |   43 +++++++++++++++++++++++++++++--------------
 1 files changed, 29 insertions(+), 14 deletions(-)

diff --git a/src/kleiner.sh b/src/kleiner.sh
index 932b156..e9cc656 100644
--- a/src/kleiner.sh
+++ b/src/kleiner.sh
@@ -1,19 +1,34 @@
 #!/bin/sh
 
-# Dieses Skript ruft Docker zum Start eines Containers mit Groovy und startet darin das 
-# Groovy-Skript bilder.groovy. Nach jedem solchen Durchlauf wird der Container wieder 
-# geloescht. 
-# 
-# Besagtes Docker Kommando reicht das augenblickliche Arbeitsverzeichnis 
-# der Maschine, auf der Docker laeuft, als Pfad /scripts an den Docker Container.
-# Auf diese Weise koennen Bilder im Dateisystem der Maschine, auf der Docker laeuft,  
-# verwendet werden.
+# Dieses Skript ruft Docker zum Start eines Containers mit Groovy und startet
+# darin das Groovy-Skript bilder.groovy.
 #
-# Aufruf mit ./kleiner.sh [groesse] [eingangsordner] [ausgangsordner]
-# Beispiel ./kleiner.sh 1200 /scripts/in /scripts/out
+# Nach jedem solchen Durchlauf wird der Container wieder geloescht.
 #
-# Mit obigem Beispiel verkleinert das Groovy-Skript alle Bilddateien in /scripts/in   
-# auf eine Laenge von 1.200 Bildpunkten entlang der laengsten Kante und 
-# legt die verkleinerten Bilder in /scripts/out ab
+# Besagtes Docker Kommando reicht das augenblickliche Arbeitsverzeichnis
+# der Maschine, auf der Docker laeuft, als Pfad /scripts an den
+# Docker Container. Auf diese Weise koennen Bilder im Dateisystem der Maschine,
+# auf der Docker laeuft, verwendet werden.
+#
+# Aufruf mit ./kleiner.sh [groesse] [qualitaet] [eingangsordner] [ausgangsordner]
+# Beispiel ./kleiner.sh 1200 75 /scripts/in /scripts/out
+#
+# Liegen dieses Skript (kleiner.sh) und das Groovy-Skript bilder.groovy
+# im Pfad /scripts und enthält dieser Pfad die Verzeichnisse in und out
+# wird mit dem Aufruf von kleiner.sh das Groovy-Skript ausgefuehrt.
+#
+# Der Aufruf mit den im Beispiel oben angegebenen Parametern bewirkt, dass alle
+# Bilddateien in /scripts/in auf eine Laenge von 1.200 Bildpunkten entlang
+# der laengsten Kante verkleinert und in /scripts/out abgelegt werden.
+#
+# Die Option -v im docker run Kommando verbindet einen Ablageort mit einem
+# Ordnernamen nach dem Schema [Ablageort]:[Ordnername]
+#
+# Die Option -w setzt das Arbeitsverzeichnis auf einen Ordner
+#
+# Die Kombination aus -v und -w im Kommando unten tut so, als gaebe es im
+# Docker-Container einen Ordner /scripts der auf das Arbeitsverezichnis der
+# lokalen Maschine verwaist, auf der Docker laeuft. Dieses Verzeichnis wird
+# dann das Arbeitsverzeichnis fuer den Docker-Container
 
-docker run --rm -v "$PWD":/scripts -w /scripts --name groovy groovy:alpine groovy bilder.groovy $1 $2 $3
+docker run --rm -v "$PWD":/scripts -w /scripts --name groovy groovy:alpine groovy bilder.groovy $1 $2 $3 $4

--
Gitblit v1.9.3