BGRABitmap/de: what changed
Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | - | ||
| 2 | - | ||
| 3 | 1 | Siehe auch: [[Developing with Graphics/de|Entwickung mit Grafik]] | |
| 4 | 2 | ||
| 5 | - | ||
| 6 | - | ||
| 7 | - | ||
| 8 | - | ||
| 9 | - | ||
| 10 | - | ||
| 11 | - | ||
| 12 | - | ||
| 13 | - | ||
| 14 | - | ||
| 15 | - | ||
| 16 | - | ||
| 17 | - | ||
| 18 | - | ||
| 19 | - | ||
| 20 | - | ||
| 21 | - | ||
| 22 | 3 | ### Beschreibung | |
| 23 | 4 | ||
| 24 | - | ||
| 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. | |
| 25 | 6 | ||
| 26 | - | ||
| 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). | |
| 27 | 8 | ||
| 28 | 9 | ### Verwendung von BGRABitmap | |
| 29 | 10 | ||
| 30 | 11 | #### Tutorial | |
| 31 | 12 | ||
| 32 | - | ||
| 33 | - | ||
| 34 | - | ||
| 35 | - | ||
| 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/). | |
| 36 | 17 | ||
| 37 | 18 | #### Overview | |
| 38 | 19 | ||
| 39 | - | ||
| 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). | |
| 40 | 21 | ||
| 41 | - | ||
| 22 | + | Einige besondere Merkmale erfordern bestimmte Units, aber möglicherweise benötigen Sie diese nicht: | |
| 42 | 23 | ||
| 43 | - | ||
| 44 | - | ||
| 45 | - | ||
| 46 | - | ||
| 47 | - | ||
| 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 | |
| 48 | 29 | ||
| 49 | - | ||
| 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. | |
| 50 | 31 | ||
| 51 | - | ||
| 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. | |
| 52 | 33 | ||
| 53 | 34 | #### Einfaches Beispiel | |
| 54 | 35 | ||
| 55 | - | ||
| 56 | - | ||
| 36 | + | Sie kopieren dazu die BGRABitmap-Units und linken sie zu Ihrem Projekt: | |
| 37 | + | ||
| 38 | + | ``` pascal | |
| 57 | 39 | Uses | |
| 58 | - | ||
| 40 | + | Classes, SysUtils, BGRABitmap, BGRABitmapTypes; | |
| 59 | 41 | ``` | |
| 60 | 42 | ||
| 61 | - | ||
| 62 | - | ||
| 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 | |
| 63 | 46 | var | |
| 64 | - | ||
| 65 | - | ||
| 66 | - | ||
| 67 | - | ||
| 68 | - | ||
| 69 | - | ||
| 70 | - | ||
| 71 | - | ||
| 47 | + | bmp: TBGRABitmap; | |
| 48 | + | begin | |
| 49 | + | bmp := TBGRABitmap.Create(100, 100, BGRABlack); // erzeugt ein 100x100 Pixel großes Bild mit schwarzem Hintergrund | |
| 72 | 50 | ||
| 73 | - | ||
| 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; | |
| 74 | 54 | ``` | |
| 55 | + | ||
| 56 | + | Zuletzt wird die Bitmap angezeigt: | |
| 57 | + | ||
| 58 | + | ``` pascal | |
| 75 | 59 | procedure TFMain.FormPaint(Sender: TObject); | |
| 76 | - | ||
| 77 | - | ||
| 78 | - | ||
| 60 | + | begin | |
| 61 | + | bmp.Draw(Canvas, 0, 0, True); // zeichnet die Bitmap im opaquen Modus (schneller) | |
| 62 | + | end; | |
| 79 | 63 | ``` | |
| 80 | 64 | ||
| 81 | 65 | ### Anmerkungen | |
| 82 | 66 | ||
| 83 | - | ||
| 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. | |
| 84 | 68 | ||
| 85 | - | ||
| 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. | |
| 86 | 70 | ||
| 87 | - | ||
| 71 | + | Die BGRABitmap-Funktionen bieten dazu 4 Modi an: | |
| 88 | 72 | ||
| 89 | - | ||
| 90 | - | ||
| 91 | - | ||
| 92 | - | ||
| 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) ) | |
| 93 | 77 | ||
| 94 | 78 | ### Integrierte Zeichenfunktionen | |
| 95 | 79 | ||
| 96 | - | ||
| 97 | - | ||
| 98 | - | ||
| 99 | - | ||
| 100 | - | ||
| 101 | - | ||
| 102 | - | ||
| 103 | - | ||
| 104 | - | ||
| 105 | - | ||
| 106 | - | ||
| 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 | |
| 107 | 91 | ||
| 108 | 92 | ### Zeichnen auf der Leinwand | |
| 109 | 93 | ||
| 110 | - | ||
| 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. | |
| 111 | 95 | ||
| 112 | 96 | ### Direkter Zugriff auf ein Pixel | |
| 113 | 97 | ||
| 114 | - | ||
| 115 | - | ||
| 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 | |
| 116 | 101 | var | |
| 117 | - | ||
| 118 | - | ||
| 119 | - | ||
| 120 | - | ||
| 121 | - | ||
| 122 | - | ||
| 123 | - | ||
| 124 | - | ||
| 125 | - | ||
| 126 | - | ||
| 127 | - | ||
| 128 | - | ||
| 129 | - | ||
| 130 | - | ||
| 131 | - | ||
| 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; | |
| 132 | 117 | ``` | |
| 133 | 118 | ||
| 134 | - | ||
| 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*. | |
| 135 | 120 | ||
| 136 | - | ||
| 121 | + | Siehe auch den Vergleich zwischen verschiedenen [[Fast direct pixel access|Methoden des direkten Pixel-Zugriffs]]. | |
| 137 | 122 | ||
| 138 | 123 | ### Bildmanipulation | |
| 139 | 124 | ||
| 140 | - | ||
| 125 | + | Verfügbare Filter (mit der Vorsilbe Filter): | |
| 141 | 126 | ||
| 142 | - | ||
| 143 | - | ||
| 144 | - | ||
| 127 | + | - Radial blur : nicht-direktionale Unschärfe | |
| 128 | + | - Motion blur : richtungsabhängige Bewegungsunschärfe | |
| 129 | + | - Custom blur : benutzerdefinierte Unschärfe (verwendet eine Maske) | |
| 145 | 130 | ||
| 146 | - | ||
| 147 | - | ||
| 148 | - | ||
| 149 | - | ||
| 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 | |
| 150 | 135 | ||
| 151 | - | ||
| 152 | - | ||
| 153 | - | ||
| 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 | |
| 154 | 139 | ||
| 155 | - | ||
| 156 | - | ||
| 140 | + | - Grayscale : konvertiert Farben in Graustufen mit Gammakorrektur | |
| 141 | + | - Normalize : verwende den vollen Umfang der Luminosität von Farben | |
| 157 | 142 | ||
| 158 | - | ||
| 159 | - | ||
| 160 | - | ||
| 161 | - | ||
| 162 | - | ||
| 163 | - | ||
| 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 | |
| 164 | 149 | ||
| 165 | - | ||
| 150 | + | Einige Funktionen scheinen nicht als Filter auf, weil sie kein neu erstelltes Bild zurückliefern. Sie verändern das vorhandene Bild: | |
| 166 | 151 | ||
| 167 | - | ||
| 168 | - | ||
| 169 | - | ||
| 170 | - | ||
| 171 | - | ||
| 172 | - | ||
| 173 | - | ||
| 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. | |
| 174 | 159 | ||
| 175 | 160 | ### Bildüberblendung | |
| 176 | 161 | ||
| 177 | - | ||
| 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: | |
| 178 | 163 | ||
| 179 | - | ||
| 180 | - | ||
| 181 | - | ||
| 182 | - | ||
| 183 | - | ||
| 184 | - | ||
| 185 | - | ||
| 186 | - | ||
| 187 | - | ||
| 188 | - | ||
| 189 | - | ||
| 190 | - | ||
| 191 | - | ||
| 192 | - | ||
| 193 | - | ||
| 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 | |
| 194 | 179 | ||
| 195 | - | ||
| 180 | + | Diese Modi können in TBGRALayeredBitmap benutzt werden, was es etwas vereinfacht, weil BlendImage nur die grundlegenden Überblendungsoperationen bietet. | |
| 196 | 181 | ||
| 197 | 182 | ### Screenshots | |
| 198 | 183 | ||
| 199 | - | ||
| 184 | + |     | |
| 200 | 185 | ||
| 201 | 186 | ### Lizenz | |
| 202 | 187 | ||
| 203 | - | ||
| 188 | + | modified LGPL | |
| 204 | 189 | ||
| 205 | - | ||
| 190 | + | Autor: [Johann ELSASS](http://johann-elsass.net) ([Facebook](http://www.facebook.com/johann.elsass.1)) | |
| 206 | 191 | ||
| 207 | 192 | ### Download | |
| 208 | 193 | ||
| 209 | 194 | Letzte Version : <https://github.com/bgrabitmap/bgrabitmap/releases> | |
| 210 | 195 | ||
| 211 | - | ||
| 196 | + | Paket von Sourceforge enthält [[LazPaint]] : <http://sourceforge.net/projects/lazpaint/files/src/> (veraltet max. ver.9.2.2) | |
| 212 | 197 | ||
| 213 | 198 | GitHub: <https://github.com/bgrabitmap/lazpaint/> | |
| 214 | 199 | ||
| 215 | 200 | --- | |
| 216 | - | ||
| 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).* |