On this page:
6.1 Bilder
image
empty-image
image?
6.2 Modi und Farben
mode
octet
rgb-color
make-color
color-red
color-green
color-blue
image-color
image-color?
6.3 Einfache geometrische Figuren
rectangle
circle
ellipse
triangle
line
text
6.4 Eigenschaften von Bildern
image-width
image-height
6.5 Bilder zusammensetzen
h-place
v-place
h-mode
v-mode
overlay
beside
above
clip
pad

6 Bilder konstruieren: "image.ss"

Note: This is documentation for the image.ss teachpack that goes with the German textbook Die Macht der Abstraktion.

Dieses Teachpack definiert Prozeduren für die Konstruktion von Bildern. Einfache Bilder werden als geometrische Formen oder Bitmaps konstruiert. Zusätzliche Prozeduren erlauben die Komposition von Bildern.

6.1 Bilder

image : signature
Ein Bild (Name: image) ist die Repräsentation eines Bildes.

Ein leeres Bild mit Breite und Höhe 0.

image? : (%a -> boolean?)
Der Aufruf (image? x) stellt fest, ob x ein Bild ist.

6.2 Modi und Farben

mode : signature
(one-of "solid" "outline")

Ein Modus (Name: mode) legt fest, ob die Darstellung einer Form diese füllt oder nur einen Umriss zeichnet.

octet : signature
(combined natural (predicate (lambda (n) (<= n 255))))

Ein Oktet (Name: octet) ist eine natürliche Zahl zwischen 0 und 255.

rgb-color : signature
Eine RGB-Farbe ist eine Farbe (Name: color, die vom Record-Konstruktor make-color zurückgegeben wird:

Eine RGB-Farbe beschreibt eine Farbe mit den roten, blauen und grünen Anteilen, also z.B. (make-color 100 200 30).

color-red : (color -> octet)
liefert den Rot-Anteil einer RGB-Farbe.
color-green : (color -> octet)
liefert den Grün-Anteil einer RGB-Farbe.
color-blue : (color -> octet)
liefert den Blau-Anteil einer RGB-Farbe.

image-color : signature
(mixed string color)

Eine Farbe (Name: image-color) ist eine Zeichenkette aus einer Farbbezeichnung (z.B. "blue") oder eine RGB-Farbe.

stellt fest, ob ein Objekt eine Farbe ist.

6.3 Einfache geometrische Figuren

Die folgenden Prozeduren erzeugen Bilder mit einfachen geometrischen Formen:

rectangle : (natural natural mode image-color -> image)
Der Aufruf (rectangle w h m c) erzeugt ein Rechteck mit Breite w und Höhe h, gefüllt mit Modus m und in Farbe c.

circle : (natural mode image-color -> image)
Der Aufruf (circle r m c) erzeugt einen Kreis oder eine Scheibe mit Radius r, gefüllt mit Modus m und in Farbe c.

ellipse : (natural natural mode image-color -> image)
Der Aufruf (ellipse w h m c) erzeugt eine Ellipse mit Breite w und Höhe h, gefüllt mit Modus m und in Farbe c.

triangle : (integer mode image-color -> image)
Der Aufruf (triangle s m c) erzeugt ein nach oben zeigendes gleichseitiges Dreieck, wobei s die Seitenlänge angibt, gefüllt mit Modus m und in Farbe c.

line : (natural natural number number number number image-color -> image)
Der Aufruf (line w h sx sy ex ey c) erzeugt ein Bild mit einer farbigen Strecke, wobei w die Breite und h die Höhe des Bilds, sowie sx die X- und sx die Y-Koordinate des Anfangspunkts und ex die X- und ey die Y-Koordinate des Endpunkts angeben, gefüllt mit Modus m und in Farbe c.

text : (string natural image-color -> image)
Der Aufruf (text s f c) erzeugt ein Bild mit Text s, wobei die Buchstaben die Größe f haben, in Farbe c

Außerdem können beliebige Bitmap-Bilder in ein Scheme-Programm eingeklebt werden.

6.4 Eigenschaften von Bildern

Zwei Eigenschaften von Bildern sind für ihre Manipulation nützlich, nämlich Breite und Höhe:

image-width : (image -> natural)
liefert die Breite von i in Pixeln.

image-height : (image -> natural)
liefert die Höhe von i in Pixeln.

6.5 Bilder zusammensetzen

The nächste Gruppe von Prozeduren baut aus Bildern neue Bilder:

h-place : signature
(mixed integer (one-of "left" "right" "center"))

Eine horizontale Positionsangabe (Name: h-place) gibt an, wie zwei Bilder horizontal zueinander positioniert werden

Im ersten Fall, wenn es sich um eine Zahl x handelt, wird das zweite Bild x Pixel vom linken Rand auf das erste gelegt. Die drei Fälle mit Zeichenketten sagen, daß die Bilder am linken Rand bzw. am rechten Rand bündig plaziert werden, bzw. das zweite Bild horizontal in die Mitte des ersten gesetzt wird.

v-place : signature
(mixed integer (one-of "top" "bottom" "center"))

Eine vertikale Positionsangabe (Name: v-place) gibt an, wie zwei Bilder vertikal zueinander positioniert werden

Im ersten Fall, wenn es sich um eine Zahl y handelt, wird das zweite Bild y Pixel vom oberen Rand auf das erste gelegt. Die drei Fälle mit Zeichenketten sagen, daß die Bilder am oberen Rand bzw. am unteren Rand bündig plaziert werden, bzw. das zweite Bild vertikal in die Mitte des ersten gesetzt wird.

h-mode : signature
(one-of "left" "right" "center") Eine horizontale Justierungsangabe (Name: h-mode) gibt an, ob zwei Bilder, die übereinander angeordnet werden, entlang der linken Kante, der rechten Kante oder der Mitte angeordnet werden.

v-mode : signature
(one-of "top" "bottom" "center")

Eine vertikale Justierungsangabe (Name: V-mode) gibt an, ob zwei Bilder, die nebenander angeordnet werden, entlang der oberen Kante, der untern Kante oder der Mitte angeordnet werden.

Der Aufruf (overlay img other h v) legt zweite Bild other auf das erste img. Die beiden anderen Argumente geben an, wie die beiden Bilder zueinander positioniert werden.

Der Aufruf (beside img other v) ordnet die beiden Bilder entsprechend des v-Arguments nebeneinander an.

Der Aufruf (img other h -> image) ordnet die beiden Bilder entsprechend des h-Arguments übereinander an.

clip : (image natural natural natural natural -> image)
Der Aufruf (clip img x y w h) liefert das Teilrechteck des Bildes img bei (x, y), Breite w und Höhe h.

pad : (image natural natural natural natural -> image)
Der Aufruf (pad img l r t b) fügt an den Seiten von img noch transparenten Leerraum an: l Pixel links, r Pixel rechts, t Pixel oben und b Pixel unten.