BGRABitmap/de: what changed

Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.

Title: BGRABitmap/de

New		Line
1	+	Siehe auch: [[Developing with Graphics/de\|Entwickung mit Grafik]]
2	+
3	+	### Beschreibung
4	+
5	+	BGRABitmap ist eine Sammlung von Units zum Erzeugen und Modifizieren von Bildern mit Transparenzinformationen (Alphakanal). Der direkte Zugriff auf einzelne Pixels erlaubt eine schnelle Bildbearbeitung. Diese Bibliothek wurde optimiert und getestet unter Windows, Ubuntu und Mac OS X, mit den Schnittstellen win32, gtk1, gtk2 und carbon.
6	+
7	+	Die Hauptklasse ist TBGRABitmap, die von TFPCustomImage abgeleitet wurde. Es gibt auch eine Klasse TBGRAPtrBitmap, die es erlaubt, bereits allozierte BGRA-Daten zu bearbeiten. Dieses Format besteht aus 4 Bytes pro Pixel (blau, grün, rot und alpha; in dieser Reihenfolge).
8	+
9	+	### Verwendung von BGRABitmap
10	+
11	+	#### Tutorial
12	+
13	+	- [How to convert an application from TCanvas to BGRABitmap](http://www.youtube.com/watch?v=HGYSLgtYx-U)
14	+	- [[BGRABitmap tutorial TAChart\|Using BGRABitmap to render a TAChart]]
15	+	- [[BGRABitmap tutorial/de\|Eine Serie von Tutorials zum schrittweisen Lernen]]
16	+	- Beispiele im [LazPaint Repositorium](http://lazpaint.svn.sourceforge.net/viewvc/lazpaint/).
17	+
18	+	#### Overview
19	+
20	+	Die Funktionen haben lange Namen um verstehbar zu sein. Nahezu Alles ist erreichbar über eine Funktion oder eine Eigenschaft des TBGRABitmap-Objekts. Beispielsweise können Sie CanvasBGRA benutzen, um eine Zeichenfläche ähnlich zu TCanvas (mit Transparenz und Antialiasing) zu erhalten; und mit Canvas2D haben Sie die gleichen Merkmale wie bei [HTML canvas](https://developer.mozilla.org/en/HTML:Canvas).
21	+
22	+	Einige besondere Merkmale erfordern bestimmte Units, aber möglicherweise benötigen Sie diese nicht:
23	+
24	+	- TBGRAMultishapeFiller für antialiasierte Verbindungen bei Polygonen ist in BGRAPolygon
25	+	- TBGRATextEffect ist in BGRATextFX
26	+	- 2D Transformationen sind in BGRATransform
27	+	- TBGRAScene3D ist in BGRAScene3D
28	+	- Falls Sie Ebenen benötigen, bietet Ihnen BGRALayers eine TBGRALayeredBitmap
29	+
30	+	Die Doppel-Pufferung ist kein Bestandteil von BGRABitmap, weil es dabei mehr um den Umgang mit Forms geht. Um ein Double-buffering zu machen, können Sie TBGRAVirtualScreen aus dem [[BGRAControls]]-Package verwenden.
31	+
32	+	Abgesehen davon, arbeitet die Doppel-Pufferung in BGRABitmap wie gewohnt. Sie benötigen eine Bitmap, wo Sie Ihre Zeichnung speichern, und zeigen diese mit der Einzelanweisung Draw an.
33	+
34	+	#### Einfaches Beispiel
35	+
36	+	Sie kopieren dazu die BGRABitmap-Units und linken sie zu Ihrem Projekt:
37	+
38	+	``` pascal
39	+	Uses
40	+	Classes, SysUtils, BGRABitmap, BGRABitmapTypes;
41	+	```
42	+
43	+	Die Unit BGRABitmapTypes enthält alle notwendigen Definitionen, aber Sie können auch einfach eine Variable vom Typ BGRABitmap deklarieren, um eine Bitmap zu laden und anzuzeigen. Dann ist der erste Schritt der, ein TBGRABitmap-Objekt zu erzeugen:
44	+
45	+	``` pascal
46	+	var
47	+	bmp: TBGRABitmap;
48	+	begin
49	+	bmp := TBGRABitmap.Create(100, 100, BGRABlack); // erzeugt ein 100x100 Pixel großes Bild mit schwarzem Hintergrund
50	+
51	+	bmp.FillRect(20, 20, 60, 60, BGRAWhite, dmSet); // zeichnet ein weißes Quadrat ohne Transparenz
52	+	bmp.FillRect(40, 40, 80, 80, BGRA(0, 0, 255, 128), dmDrawWithTransparency); // zeichnet ein transparentes blaues Quadrat
53	+	end;
54	+	```
55	+
56	+	Zuletzt wird die Bitmap angezeigt:
57	+
58	+	``` pascal
59	+	procedure TFMain.FormPaint(Sender: TObject);
60	+	begin
61	+	bmp.Draw(Canvas, 0, 0, True); // zeichnet die Bitmap im opaquen Modus (schneller)
62	+	end;
63	+	```
64	+
65	+	### Anmerkungen
66	+
67	+	Die Pixels in einer transparenten Bitmap werden in 4 Werten gespeichert, also 4 Bytes in der Reihenfolge Blau, Grün, Rot, Alpha. Der letzte Kanal definiert die Transparenzstufe (0 bedeutet transparent, 255 bedeutet undurchsichtig/opak), die anderen Kanäle definieren die Farbe und die Luminosität.
68	+
69	+	Grundsätzlich gibt es zwei Zeichenmodi. Der erste besteht darin, die Inhaltsinformation eines Pixels vollständig zu ersetzen. Die zweite besteht darin, das vorhandene Pixel mit einem anderen zu überblenden, das nennt man Alphablending.
70	+
71	+	Die BGRABitmap-Funktionen bieten dazu 4 Modi an:
72	+
73	+	- dmSet : ersetzt die 4 Bytes des gezeichneten Pixels. Die vorhandene Transparenz bleibt nicht erhalten.
74	+	- dmDrawWithTransparency : zeichnet mit Alphablending und mit Gammakorrektur (siehe unten)
75	+	- dmFastBlend oder dmLinearBlend : zeichnet mit Alphablending aber ohne Gammakorrektur (schneller, bewirkt aber Farbverzerrungen bei geringen Intensitäten).
76	+	- dmXor : wendet Xor auf jede Komponente an und enthält Alpha (falls Sie die Farben invertieren wollen, aber Alpha beibehalten, nehmen Sie BGRA(255,255,255,0) )
77	+
78	+	### Integrierte Zeichenfunktionen
79	+
80	+	- Zeichnen/Löschen von Pixeln
81	+	- Zeichnen einer Linie mit oder ohne Antialiasing
82	+	- Koordinaten in Fließkommagenauigkeit
83	+	- Stiftbreite in Fließkommagenauigkeit
84	+	- Rechteck (gerahmt oder gefüllt)
85	+	- Ellipse und Polygone mit Antialiasing
86	+	- Spline-Berechnung (abgerundete Kurven)
87	+	- einfache Füllung (Floodfill) oder progressive Füllung
88	+	- Farbverläufe (linear, radial...)
89	+	- abgerundete Rechtecke
90	+	- Texte mit Transparenz
91	+
92	+	### Zeichnen auf der Leinwand
93	+
94	+	Sie können mit einem Canvas-Objekt zeichnen, mit den üblichen Funktionen, aber ohne Antialiasing. Die Opazität (Undurchsichtbarkeit) der Zeichnung ist durch die Eigenschaft CanvasOpacity definiert. Dieses Verfahren ist langsamer, weil dazu Bildumformungen angewendet werden.
95	+
96	+	### Direkter Zugriff auf ein Pixel
97	+
98	+	Zur direkten Bearbeitung von Pixels gibt es zwei Eigenschaften, Data und Scanline. Die erste gibt einen Zeiger auf das erste Pixel im Bild zurück, die zweite hingegen einen Zeiger auf das erste Pixel einer bestimmten Zeile.
99	+
100	+	``` pascal
101	+	var
102	+	bmp: TBGRABitmap;
103	+	p: PBGRAPixel;
104	+	n: integer;
105	+
106	+	begin
107	+	bmp := TBGRABitmap.Create('image.png');
108	+	p := bmp.Data;
109	+	for n := bmp.NbPixels-1 downto 0 do begin
110	+	p^.red := not p^.red; // invertiert den roten Kanal
111	+	inc(p);
112	+	end;
113	+	bmp.InvalidateBitmap; // beachten Sie, dass wir direkt auf die Pixels zugegriffen haben
114	+	bmp.Draw(Canvas, 0, 0, True);
115	+	bmp.Free;
116	+	end;
117	+	```
118	+
119	+	Es ist erforderlich, die Funktion InvalidateBitmap aufzurufen, um das Bild beim nächsten Aufruf von Draw neu zeichnen zu lassen. Beachten Sie: Die Reihenfolge der Zeilen kann auch umgekehrt sein, abhängig von der Eigenschaft LineOrder.
120	+
121	+	Siehe auch den Vergleich zwischen verschiedenen [[Fast direct pixel access\|Methoden des direkten Pixel-Zugriffs]].
122	+
123	+	### Bildmanipulation
124	+
125	+	Verfügbare Filter (mit der Vorsilbe Filter):
126	+
127	+	- Radial blur : nicht-direktionale Unschärfe
128	+	- Motion blur : richtungsabhängige Bewegungsunschärfe
129	+	- Custom blur : benutzerdefinierte Unschärfe (verwendet eine Maske)
130	+
131	+	- Median : berechnet den Median der Farben um jedes Pixel herum, macht Ecken weicher
132	+	- Pixelate : vereinfacht das Bild durch Rechtecke gleicher Farbe
133	+	- Smooth : macht das gesamte Bild weicher, Gegenteil von Sharpen
134	+	- Sharpen : verstärkt Konturen, Gegenteil von Smooth
135	+
136	+	- Contour : zeichnet Konturen auf einem weißen Hintergrund (wie eine Bleistiftzeichnung)
137	+	- Emboss : zeichnet Konturen mit Schatten
138	+	- EmbossHighlight : zeichnet Konturen einer Auswahl mit definierten Graustufen
139	+
140	+	- Grayscale : konvertiert Farben in Graustufen mit Gammakorrektur
141	+	- Normalize : verwende den vollen Umfang der Luminosität von Farben
142	+
143	+	- Rotate : Drehung des Bildes um einen Punkt
144	+	- Sphere : verzerrt das Bild wie in einer Projektion auf eine Kugel
145	+	- Twirl : verzerrt das Bild mit einem Strudel-Effekt
146	+	- Cylinder : verzerrt das Bild wie in einer Projektion auf einen Zylinder
147	+	- Plane : berechnet eine hochpräzise Projektion auf eine waagrechte Ebene. Dies ist recht langsam.
148	+	- SmartZoom3 : vergrößert das Bild 3x und entdeckt Ränder, ein nützlicher Zoom bei alten Spielesprites
149	+
150	+	Einige Funktionen scheinen nicht als Filter auf, weil sie kein neu erstelltes Bild zurückliefern. Sie verändern das vorhandene Bild:
151	+
152	+	- VerticalFlip : vertikale Spiegelung
153	+	- HorizontalFlip : horizontale Spiegelung
154	+	- Negative : invertiert die Farben
155	+	- LinearNegative : inveriert ohne Gammakorrektur
156	+	- SwapRedBlue : tauscht den roten und den blauen Kanal aus (zu Umwandeln von BGRA und RGBA)
157	+	- ConvertToLinearRGB : zum Umwandeln von sRGB zu RGB. Beachten Sie: Das von BGRABitmap verwendete Format ist sRGB bei dmDrawWithTransparency und RGB bei dmLinearBlend.
158	+	- ConvertFromLinearRGB : konvertiert von RGB zu sRGB.
159	+
160	+	### Bildüberblendung
161	+
162	+	PutImage (= Ersetzen) ist die normale Zeichenfunktion. Im Gegensatz dazu erlaubt es BlendImage, Bilder zu überblenden, wie mittels Ebenen bei kommerziellen Bildbearbeitungsprogrammen. Die folgenden Modi sind verfügbar:
163	+
164	+	- LinearBlend : einfache Überlagerung ohne Gammakorrektur (äquivalent zu dmFastBlend)
165	+	- Transparent : Überlagerung mit Gammakorrektur
166	+	- Multiply : Multiplikation von Farbwerten (mit Gammakorrektur)
167	+	- LinearMultiply : Multiplikation von Farbwerten (ohne Gammakorrektur)
168	+	- Additive : Addition von Farbwerten (mit Gammakorrektur)
169	+	- LinearAdd : Addition von Farbwerten (ohne Gammakorrektur)
170	+	- Difference : Differenz von Farbwerten (mit Gammakorrektur)
171	+	- LinearDifference : Differenz von Farbwerten (ohne Gammakorrektur)
172	+	- Negation : löscht gemeinsame Farben (mit Gammakorrektur)
173	+	- LinearNegation : löscht gemeinsame Farben (ohne Gammakorrektur)
174	+	- Reflect, Glow : Reflexion, Glühen - für Lichteffekte
175	+	- ColorBurn, ColorDodge, Overlay, Screen : verschiedene Filter
176	+	- Lighten : Aufhellen - erhält die hellen Farbwerte
177	+	- Darken : Abdunkeln - erhält die dunklen Farbwerte
178	+	- Xor : ausschließendes Oder von Farbwerten
179	+
180	+	Diese Modi können in TBGRALayeredBitmap benutzt werden, was es etwas vereinfacht, weil BlendImage nur die grundlegenden Überblendungsoperationen bietet.
181	+
182	+	### Screenshots
183	+
184	+	![](/wiki-images/5/5d/Lazpaint_contour.png) ![](/wiki-images/2/25/Lazpaint_curve_redim.png) ![](/wiki-images/2/23/Bgra_wirecube.png) ![](/wiki-images/b/b0/Bgra_chessboard.jpg)
185	+
186	+	### Lizenz
187	+
188	+	modified LGPL
189	+
190	+	Autor: [Johann ELSASS](http://johann-elsass.net) ([Facebook](http://www.facebook.com/johann.elsass.1))
191	+
192	+	### Download
193	+
194	+	Letzte Version : <https://github.com/bgrabitmap/bgrabitmap/releases>
195	+
196	+	Paket von Sourceforge enthält [[LazPaint]] : <http://sourceforge.net/projects/lazpaint/files/src/> (veraltet max. ver.9.2.2)
197	+
198	+	GitHub: <https://github.com/bgrabitmap/lazpaint/>
199	+
200	+	---
201	+	From the Free Pascal wiki, page "BGRABitmap/de", as it stood on 2022-09-11 after a change by Circular, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history