6 Bilder konstruieren: "image.ss"
Note: This is documentation for the "image.rkt" 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
Ein
Bild (Name:
image) ist die Repräsentation eines Bildes.
Ein leeres Bild mit Breite und Höhe 0.
Der Aufruf
(image? x) stellt fest, ob
x ein Bild ist.
6.2 Modi und Farben
(one-of "solid" "outline")
Ein Modus (Name: mode) legt fest, ob die Darstellung einer Form diese füllt
oder nur einen Umriss zeichnet.
(combined natural (predicate (lambda (n) (<= n 255)))) Ein Oktet (Name: octet) ist eine natürliche Zahl zwischen 0 und 255.
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).
liefert den Rot-Anteil einer RGB-Farbe.
liefert den Grün-Anteil einer RGB-Farbe.
liefert den Blau-Anteil einer RGB-Farbe.
stellt fest, ob ein Objekt eine
RGB-Farbe ist.
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.
Eine
Alpha/RGB-Farbe ist eine Farbe (Name:
color, die vom
Record-Konstruktor
make-alpha-color zurückgegeben wird:
Eine
Alpha/RGB-Farbe beschreibt eine Farbe mit den Alpha-, roten,
blaue und grünen Anteilen, also z.B.
(make-color 50 100 200 30). Der Alpha-Anteil beschreibt, wie durchsichtig die Farbe ist.
liefert den Rot-Anteil einer RGB-Farbe.
liefert den Grün-Anteil einer RGB-Farbe.
liefert den Blau-Anteil einer RGB-Farbe.
liefert den Alpha-Anteil einer RGB-Farbe.
6.3 Einfache geometrische Figuren
Die folgenden Prozeduren erzeugen Bilder mit einfachen geometrischen Formen:
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.
Der Aufruf
(circle r m c)
erzeugt einen Kreis oder eine Scheibe mit Radius
r, gefüllt mit Modus
m und in Farbe
c.
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.
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.
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.
Der Aufruf
(text s f c)
erzeugt ein Bild mit Text
s,
wobei die Buchstaben die Größe
f haben, in Farbe
cAuß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:
liefert die Breite von i in Pixeln.
liefert die Höhe von i in Pixeln.
Der Aufruf
(image-inside? i1 i2) stellt fest, ob das Bild
i2 im Bild
i1 enthalten ist.
Der Aufruf
(find-image i1 i2) findet die Position von
i2
im Bild
i1 (in dem es vorkommen muss).
6.5 Bilder zusammensetzen
The nächste Gruppe von Prozeduren baut aus Bildern neue Bilder:
(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.
(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.
(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.
(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.
Der Aufruf
(clip img x y w h)
liefert das Teilrechteck des Bildes
img
bei (
x,
y), Breite
w und Höhe
h.
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.
6.6 Bilder aus Pixeln konstruieren
Der Aufruf
(color-list->image lis w h) stellt ein Bild mit
Breite
w und Höhe
h her, in dem die Pixel die
Farben aus der Liste
lis (welche die Länge
(* w h)
haben muß) haben.
Diese Prozedur liefert eine Liste der RGB-Farben der Pixel eines Bildes.
Der Aufruf
(color-list->image lis w h) stellt ein Bild mit
Breite
w und Höhe
h her, in dem die Pixel die
Farben aus der Liste
lis (welche die Länge
(* w h)
haben muß) haben.
Diese Prozedur liefert eine Liste der Alpha/RGB-Farben der Pixel
eines Bildes.