BGRABitmap/de

From Lazarus wiki
Revision as of 08:27, 25 July 2017 by Circular (talk | contribs) (→‎Download: letzte)
Jump to navigationJump to search

Deutsch (de) English (en) español (es) français (fr) русский (ru) 中文(中国大陆)‎ (zh_CN)

bgrabitmap logo.jpg

Siehe auch: Entwickung mit Grafik

Beschreibung

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.

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).

Verwendung von BGRABitmap

Tutorial

Overview

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.

Einige besondere Merkmale erfordern bestimmte Units, aber möglicherweise benötigen Sie diese nicht:

  • TBGRAMultishapeFiller für antialiasierte Verbindungen bei Polygonen ist in BGRAPolygon
  • TBGRATextEffect ist in BGRATextFX
  • 2D Transformationen sind in BGRATransform
  • TBGRAScene3D ist in BGRAScene3D
  • Falls Sie Ebenen benötigen, bietet Ihnen BGRALayers eine TBGRALayeredBitmap

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.

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.

Einfaches Beispiel

Sie kopieren dazu die BGRABitmap-Units und linken sie zu Ihrem Projekt:

Uses Classes, SysUtils, BGRABitmap, BGRABitmapTypes;

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:

var bmp: TBGRABitmap;
begin
  bmp := TBGRABitmap.Create(100,100,BGRABlack); //erzeugt ein 100x100 Pixel großes Bild mit schwarzem Hintergrund

  bmp.FillRect(20,20,60,60,BGRAWhite, dmSet); //zeichnet ein weißes Quadrat ohne Transparenz
  bmp.FillRect(40,40,80,80,BGRA(0,0,255,128), dmDrawWithTransparency); //zeichnet ein transparentes blaues Quadrat
end;

Zuletzt wird die Bitmap angezeigt:

procedure TFMain.FormPaint(Sender: TObject);
begin
  bmp.Draw(Canvas, 0, 0, True); // zeichnet die Bitmap im opaquen Modus (schneller)
end;

Anmerkungen

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.

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.

Die BGRABitmap-Funktionen bieten dazu 4 Modi an:

  • dmSet : ersetzt die 4 Bytes des gezeichneten Pixels. Die vorhandene Transparenz bleibt nicht erhalten.
  • dmDrawWithTransparency : zeichnet mit Alphablending und mit Gammakorrektur (siehe unten)
  • dmFastBlend oder dmLinearBlend : zeichnet mit Alphablending aber ohne Gammakorrektur (schneller, bewirkt aber Farbverzerrungen bei geringen Intensitäten).
  • 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) )

Integrierte Zeichenfunktionen

  • Zeichnen/Löschen von Pixeln
  • Zeichnen einer Linie mit oder ohne Antialiasing
  • Koordinaten in Fließkommagenauigkeit
  • Stiftbreite in Fließkommagenauigkeit
  • Rechteck (gerahmt oder gefüllt)
  • Ellipse und Polygone mit Antialiasing
  • Spline-Berechnung (abgerundete Kurven)
  • einfache Füllung (Floodfill) oder progressive Füllung
  • Farbverläufe (linear, radial...)
  • abgerundete Rechtecke
  • Texte mit Transparenz

Zeichnen auf der Leinwand

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.

Direkter Zugriff auf ein Pixel

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.

var 
   bmp: TBGRABitmap;
   p: PBGRAPixel;
   n: integer;

begin
     bmp := TBGRABitmap.Create('image.png');
     p := bmp.Data;
     for n := bmp.NbPixels-1 downto 0 do
     begin
          p^.red := not p^.red;  //invertiert den roten Kanal
          inc(p);
     end;
     bmp.InvalidateBitmap;  //beachten Sie, dass wir direkt auf die Pixels zugegriffen haben
     bmp.Draw(Canvas,0,0,True);
     bmp.Free;
end;

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.

Siehe auch den Vergleich zwischen verschiedenen Methoden des direkten Pixel-Zugriffs.

Bildmanipulation

Verfügbare Filter (mit der Vorsilbe Filter):

  • Radial blur : nicht-direktionale Unschärfe
  • Motion blur : richtungsabhängige Bewegungsunschärfe
  • Custom blur : benutzerdefinierte Unschärfe (verwendet eine Maske)
  • Median : berechnet den Median der Farben um jedes Pixel herum, macht Ecken weicher
  • Pixelate : vereinfacht das Bild durch Rechtecke gleicher Farbe
  • Smooth : macht das gesamte Bild weicher, Gegenteil von Sharpen
  • Sharpen : verstärkt Konturen, Gegenteil von Smooth
  • Contour : zeichnet Konturen auf einem weißen Hintergrund (wie eine Bleistiftzeichnung)
  • Emboss : zeichnet Konturen mit Schatten
  • EmbossHighlight : zeichnet Konturen einer Auswahl mit definierten Graustufen
  • Grayscale : konvertiert Farben in Graustufen mit Gammakorrektur
  • Normalize : verwende den vollen Umfang der Luminosität von Farben
  • Rotate : Drehung des Bildes um einen Punkt
  • Sphere : verzerrt das Bild wie in einer Projektion auf eine Kugel
  • Twirl : verzerrt das Bild mit einem Strudel-Effekt
  • Cylinder : verzerrt das Bild wie in einer Projektion auf einen Zylinder
  • Plane : berechnet eine hochpräzise Projektion auf eine waagrechte Ebene. Dies ist recht langsam.
  • SmartZoom3 : vergrößert das Bild 3x und entdeckt Ränder, ein nützlicher Zoom bei alten Spielesprites

Einige Funktionen scheinen nicht als Filter auf, weil sie kein neu erstelltes Bild zurückliefern. Sie verändern das vorhandene Bild:

  • VerticalFlip : vertikale Spiegelung
  • HorizontalFlip : horizontale Spiegelung
  • Negative : invertiert die Farben
  • LinearNegative : inveriert ohne Gammakorrektur
  • SwapRedBlue : tauscht den roten und den blauen Kanal aus (zu Umwandeln von BGRA und RGBA)
  • ConvertToLinearRGB : zum Umwandeln von sRGB zu RGB. Beachten Sie: Das von BGRABitmap verwendete Format ist sRGB bei dmDrawWithTransparency und RGB bei dmLinearBlend.
  • ConvertFromLinearRGB : konvertiert von RGB zu sRGB.

Bildüberblendung

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:

  • LinearBlend : einfache Überlagerung ohne Gammakorrektur (äquivalent zu dmFastBlend)
  • Transparent : Überlagerung mit Gammakorrektur
  • Multiply : Multiplikation von Farbwerten (mit Gammakorrektur)
  • LinearMultiply : Multiplikation von Farbwerten (ohne Gammakorrektur)
  • Additive : Addition von Farbwerten (mit Gammakorrektur)
  • LinearAdd : Addition von Farbwerten (ohne Gammakorrektur)
  • Difference : Differenz von Farbwerten (mit Gammakorrektur)
  • LinearDifference : Differenz von Farbwerten (ohne Gammakorrektur)
  • Negation : löscht gemeinsame Farben (mit Gammakorrektur)
  • LinearNegation : löscht gemeinsame Farben (ohne Gammakorrektur)
  • Reflect, Glow : Reflexion, Glühen - für Lichteffekte
  • ColorBurn, ColorDodge, Overlay, Screen : verschiedene Filter
  • Lighten : Aufhellen - erhält die hellen Farbwerte
  • Darken : Abdunkeln - erhält die dunklen Farbwerte
  • Xor : ausschließendes Oder von Farbwerten

Diese Modi können in TBGRALayeredBitmap benutzt werden, was es etwas vereinfacht, weil BlendImage nur die grundlegenden Überblendungsoperationen bietet.

Screenshots

Lazpaint contour.png Lazpaint curve redim.png Bgra wirecube.png Bgra chessboard.jpg

Lizenz

modified LGPL

Autor: Johann ELSASS (Facebook)

Download

Letzte Version : https://github.com/bgrabitmap/bgrabitmap/releases

Paket von Sourceforge enthält LazPaint : http://sourceforge.net/projects/lazpaint/files/src/

GitHub: https://github.com/bgrabitmap/lazpaint/

Alter Link : http://lazarus.johann-elsass.net/