more translations

AlphaFeld.cpp

@@ -8,8 +8,8 @@
 
 using namespace Framework;
 
-// Inhalt der AlphaFeld Klasse aus AlphaFeld.h
-// Konstruktor
+// Content of the AlphaFeld class from AlphaFeld.h
+// Constructor
 AlphaFeld::AlphaFeld()
     : Zeichnung(),
       strength(5),
@@ -18,20 +18,20 @@ AlphaFeld::AlphaFeld()
 
 AlphaFeld::~AlphaFeld() {}
 
-// nicht constant
-void AlphaFeld::setStrength(int st) // setzt die Staerke
+// non-constant
+void AlphaFeld::setStrength(int st) // sets the strength
 {
     strength = st;
     rend = 1;
 }
 
-void AlphaFeld::setFarbe(int f) // setzt die Farbe
+void AlphaFeld::setFarbe(int f) // sets the color
 {
     farbe = f;
     rend = 1;
 }
 
-void AlphaFeld::render(Bild& zRObj) // zeichnet nach zRObj
+void AlphaFeld::render(Bild& zRObj) // draws to zRObj
 {
     Zeichnung::render(zRObj);
     int br = gr.x - 1;
@@ -51,15 +51,15 @@ void AlphaFeld::render(Bild& zRObj) // zeichnet nach zRObj
         fc2 = (a << 24) | fc;
         int i2 = i << 1;
         zRObj.drawLinieHAlpha(
-            xp + i + 1, yp + i, br - i2, fc2); // oben links --- oben rechts
+            xp + i + 1, yp + i, br - i2, fc2); // top left --- top right
         zRObj.drawLinieVAlpha(xp + br - i,
             yp + i + 1,
             hi - i2,
-            fc2); // oben rechts -- unten rechts
+            fc2); // top right -- bottom right
         zRObj.drawLinieHAlpha(
-            xp + i, yp + hi - i, br - i2, fc2); // unten rechts - unten links
+            xp + i, yp + hi - i, br - i2, fc2); // bottom right - bottom left
         zRObj.drawLinieVAlpha(
-            xp + i, yp + i, hi - i2, fc2); // unten links -- oben links
+            xp + i, yp + i, hi - i2, fc2); // bottom left -- top left
     }
     if (index == br / 2)
     {
@@ -67,7 +67,7 @@ void AlphaFeld::render(Bild& zRObj) // zeichnet nach zRObj
             zRObj.drawLinieVAlpha(xp + i,
                 yp + index,
                 hi - (index << 1) + 1,
-                fc2); // rest Flaeche senkrecht
+                fc2); // remaining area vertical
     }
     else
     {
@@ -75,22 +75,22 @@ void AlphaFeld::render(Bild& zRObj) // zeichnet nach zRObj
             zRObj.drawLinieHAlpha(xp + index,
                 yp + i,
                 br - (index << 1) + 1,
-                fc2); // rest Flaeche waagerecht
+                fc2); // remaining area horizontal
     }
 }
 
 // constant
-int AlphaFeld::getStrength() const // gibt die Staerke zurueck
+int AlphaFeld::getStrength() const // returns the strength
 {
     return strength;
 }
 
-int AlphaFeld::getFarbe() const // gibt die Farbe zurueck
+int AlphaFeld::getFarbe() const // returns the color
 {
     return farbe;
 }
 
-Zeichnung* AlphaFeld::dublizieren() const // Kopiert das Zeichnung
+Zeichnung* AlphaFeld::dublizieren() const // copies the drawing object
 {
     AlphaFeld* obj = new AlphaFeld();
     obj->setPosition(pos);

AlphaFeld.h

@@ -6,10 +6,10 @@
 namespace Framework
 {
     class Bild;      //! Bild.h
-    class AlphaFeld; //! Aus dieser Datei
+    class AlphaFeld; //! from this file
 
-    //! Eine Zeichnung des 2D GUI Frameworks, die einen Farbuebergang zu einem
-    //! Rechteck darstellt
+    //! A 2D GUI Framework drawing that represents a color gradient
+    //! towards a rectangle
     class AlphaFeld : public Zeichnung
     {
     private:
@@ -17,26 +17,26 @@ namespace Framework
         int farbe;
 
     public:
-        //! Konstruktor
+        //! Constructor
         DLLEXPORT AlphaFeld();
-        //! Destruktor
+        //! Destructor
         DLLEXPORT virtual ~AlphaFeld();
-        //! Setzt die Staerke des UEbergangs. Dies ist der Wert um den der Alpha
-        //! Wert der Farbe fuer jeden Pixel nach innen abnimmt \param st Die
-        //! Staerke
+        //! Sets the strength of the transition. This is the value by which the
+        //! alpha value of the color decreases for each pixel inward
+        //! \param st The strength
         DLLEXPORT void setStrength(int st);
-        //! Setzt die Farbe des Alpha Feldes
-        //! \param f Die Farbe im A8R8G8B8 Format
+        //! Sets the color of the alpha field
+        //! \param f The color in A8R8G8B8 format
         DLLEXPORT void setFarbe(int f);
-        //! Zeichnet die Zeihnung in ein bestimmtes Bild
-        //! \param zRObj Das Bild, in das gezeichnet werden soll
+        //! Draws the drawing into a specific image
+        //! \param zRObj The image to draw into
         DLLEXPORT void render(Bild& zRObj) override;
-        //! Gibt die Staerke des Alpha Feldes zurueck
+        //! Returns the strength of the alpha field
         DLLEXPORT int getStrength() const;
-        //! gibt die Farbe des Alpha Feldes im A8R8G8B8 Format zurueck
+        //! returns the color of the alpha field in A8R8G8B8 format
         DLLEXPORT int getFarbe() const;
-        //! Kopiert das Alpha Feld, so dass es ohne auswirkungen auf das
-        //! Original verwendet werden kann
+        //! Copies the alpha field so that it can be used
+        //! without affecting the original
         DLLEXPORT Zeichnung* dublizieren() const override;
     };
 } // namespace Framework

Animation.h

@@ -11,7 +11,7 @@ namespace Framework
     class InitDatei; //! InitDatei.h
     class Rahmen;    //! Rahmen.h
 
-    //! Enthaelt alle Bilder einer Video Animation
+    //! Contains all images of a video animation
     class Animation2DData : public virtual ReferenceCounter
     {
     private:
@@ -23,60 +23,61 @@ namespace Framework
         Critical cs;
 
     public:
-        //! Konstruktor
+        //! Constructor
         DLLEXPORT Animation2DData();
-        //! Destruktor
+        //! Destructor
         DLLEXPORT ~Animation2DData();
-        //! Dies ist notwendig, falls mehrere Threads gleichzeitig dieses Objekt
-        //! benutzen. Wenn lock() von zwei threads aufgerufen wird, wartet der
-        //! letzte so lange, bis der erste unlock() aufgerufen hat.
+        //! This is necessary if multiple threads use this object simultaneously.
+        //! If lock() is called by two threads, the last one waits until the
+        //! first one has called unlock().
         DLLEXPORT void lock();
-        //! Dies ist notwendig, falls mehrere Threads gleichzeitig dieses Objekt
-        //! benutzen. Wenn lock() von zwei threads aufgerufen wird, wartet der
-        //! letzte so lange, bis der erste unlock() aufgerufen hat.
+        //! This is necessary if multiple threads use this object simultaneously.
+        //! If lock() is called by two threads, the last one waits until the
+        //! first one has called unlock().
         DLLEXPORT void unlock();
-        //! Laedt alle Bilder aus einer InitDatei ein. Auch die Werte 'fps',
-        //! 'wiederhohlen' (true, false), 'transparent' (true, false) werden
-        //! interpretiert. Die Bilder muessen in der richtiegen Reihenfolge in
-        //! der Datei stehen. Der Name der Werte ist egal undder Wert ist der
-        //! Pfad zur ltdb Datei mit /bildname hinten drann Beispiel: fps=30
+        //! Loads all images from an InitDatei. The values 'fps',
+        //! 'wiederhohlen' (true, false), 'transparent' (true, false) are also
+        //! interpreted. The images must be in the correct order in the file.
+        //! The name of the values does not matter, the value is the path to
+        //! the ltdb file with /imagename appended. Example: fps=30
         //!           x=a.ltdb\aaaa.jpg
         //!           y=a.ltdb\aaab.jpg
-        //! \param datei Die bereits eingelesene InitDatei
+        //! \param datei The already loaded InitDatei
         DLLEXPORT void ladeAnimation(InitDatei* datei);
-        //! Laedt alle Bilder aus einer LTDB Datei der reihenfolge nach ein, in
-        //! der sie gespeichert sind. \param datei Die LTDB Datei
+        //! Loads all images from an LTDB file in the order they are stored.
+        //! \param datei The LTDB file
         DLLEXPORT void ladeAnimation(LTDBDatei* datei);
-        //! Setzt die Bilder pro Sekunde der Video Animation
-        //! \param fps Die Anzahl an Bildern pro Sekunde
+        //! Sets the frames per second of the video animation
+        //! \param fps The number of frames per second
         DLLEXPORT void setFPS(int fps);
-        //! Legt fest, ob die Animation sich wiederhohlt, wenn sie am ende
-        //! angelangt ist \param wh 1, wenn sich die Animation wiederhohlen soll
+        //! Sets whether the animation repeats when it reaches the end
+        //! \param wh 1 if the animation should repeat
         DLLEXPORT void setWiederhohlend(bool wh);
-        //! Legt fest, ob beim Zeichnen der Bilder Alphablending benutzt werden
-        //! soll \param trp 1, wenn Alphablending benutzt werden soll
+        //! Sets whether alpha blending should be used when drawing the images
+        //! \param trp 1 if alpha blending should be used
         DLLEXPORT void setTransparent(bool trp);
-        //! Loescht alle Bilder aus der Animation und setzt alle Werte auf die
-        //! Standartwerte zurueck
+        //! Deletes all images from the animation and resets all values to
+        //! their defaults
         DLLEXPORT void reset();
-        //! Gibt ein Bestimmtes Bild der Animation zurueck
-        //! \param i Der Index des Bildes
+        //! Returns a specific image of the animation
+        //! \param i The index of the image
         DLLEXPORT Bild* getBild(int i) const;
-        //! Gibt ein Bestimmtes Bild der Animation ohne erhoehten Reference
-        //! Counter zurueck \param i Der Index des Bildes
+        //! Returns a specific image of the animation without increasing the
+        //! reference counter
+        //! \param i The index of the image
         DLLEXPORT Bild* zBild(int i) const;
-        //! Gibt die Anzahl der Bilder in der Animation zurueck
+        //! Returns the number of images in the animation
         DLLEXPORT int getBildAnzahl() const;
-        //! Gibt die Anzahl an Bildern pro Sekunde zurueck
+        //! Returns the number of frames per second
         DLLEXPORT int getFPS() const;
-        //! Gibt zurueck, ob sich die Animation wiederhohlt, wenn sie beim
-        //! letzten Bild angelangt ist
+        //! Returns whether the animation repeats when it reaches the last
+        //! image
         DLLEXPORT bool istWiederhohlend() const;
-        //! Gibt zurueck, ob beim Zeichnen der Bilder Alphablending benutzt wird
+        //! Returns whether alpha blending is used when drawing the images
         DLLEXPORT bool istTransparent() const;
     };
 
-    //! Eine Zeichnung, die eine Video Animation zeichnet
+    //! A drawing that renders a video animation
     class Animation2D : public Zeichnung
     {
     private:
@@ -91,63 +92,65 @@ namespace Framework
         bool sichtbar;
 
     public:
-        //! Konstruktor
+        //! Constructor
         DLLEXPORT Animation2D();
-        //! Destruktor
+        //! Destructor
         DLLEXPORT virtual ~Animation2D();
-        //! Legt fest, ob ein Rahmen um die Animation gezeichnet werden soll
-        //! \param ram 1, wenn ein Rahmen gezeichnet werden soll
+        //! Sets whether a border should be drawn around the animation
+        //! \param ram 1 if a border should be drawn
         DLLEXPORT void setRahmen(bool ram);
-        //! Setzt einen Zeiger auf den verfenteten Rahmen
-        //! \param ram Der Rahmen
+        //! Sets a pointer to the used border
+        //! \param ram The border
         DLLEXPORT void setRahmenZ(Rahmen* ram);
-        //! Setzt die Breite des Rahmens
-        //! \param br Die Breite in Pixeln
+        //! Sets the width of the border
+        //! \param br The width in pixels
         DLLEXPORT void setRahmenBreite(int br);
-        //! Setzt die Farbe des Rahmens
-        //! \param fc Die Farbe im A8R8G8B8 Format
+        //! Sets the color of the border
+        //! \param fc The color in A8R8G8B8 format
         DLLEXPORT void setRahmenFarbe(int fc);
-        //! Setzt die Animation, die Angezeigt werden soll
-        //! \param data Die Animationsdaten
+        //! Sets the animation to be displayed
+        //! \param data The animation data
         DLLEXPORT void setAnimationDataZ(Animation2DData* data);
-        //! Setzt die Transparenz der gesammten Animation
-        //! \param alpha Die Transparenz
+        //! Sets the transparency of the entire animation
+        //! \param alpha The transparency
         DLLEXPORT void setAlphaMaske(unsigned char alpha);
-        //! Setzt die Geschwindigkeit, in der die Animation ein und ausgeblendet
-        //! wird \param aps Alpha pro sekunde
+        //! Sets the speed at which the animation fades in and out
+        //! \param aps Alpha per second
         DLLEXPORT void setAPS(int aps);
-        //! Setzt die Sichtbarkeit der Animation
-        //! \param sichtbar 1, wenn die Animation eingeblendet werden soll. 0,
-        //! wenn sie ausgeblendet werden soll
+        //! Sets the visibility of the animation
+        //! \param sichtbar 1 if the animation should be shown, 0 if it should
+        //! be hidden
         DLLEXPORT void setSichtbar(bool sichtbar);
-        //! Verarbeitet die Zeit, die seit dem letzten aufruf dieser Funktion
-        //! vergangen ist \param zeit Die vergangene Zeit in Sekunden
+        //! Processes the time that has passed since the last call of this
+        //! function
+        //! \param zeit The elapsed time in seconds
         DLLEXPORT bool tick(double zeit) override;
-        //! Zeichnet die Animation in ein bestimmtes Bild
-        //! \param zRObj Das Bild, in das gezeichnet werden soll
+        //! Draws the animation into a specific image
+        //! \param zRObj The image to draw into
         DLLEXPORT void render(Bild& zRObj) override;
-        //! Gibt die Animationsdaten zurueck
+        //! Returns the animation data
         DLLEXPORT Animation2DData* getAnimationData() const;
-        //! Gibt die Animationsdaten ohne erhoehten Reference Counter zurueck
+        //! Returns the animation data without increasing the reference counter
         DLLEXPORT Animation2DData* zAnimationData() const;
-        //! Gibt zurueck ob die Animation sichtbar ist
+        //! Returns whether the animation is visible
         DLLEXPORT bool istSichtbar() const;
-        //! Gibt den Index des aktuell angezeigten Bildes zurueck
+        //! Returns the index of the currently displayed image
         DLLEXPORT int getJetzt() const;
-        //! Gibt die Transparenz der Animation zurueck
+        //! Returns the transparency of the animation
         DLLEXPORT unsigned char getAlphaMaske() const;
-        //! Gibt zurueck, ob ein Rahmen um die Animation gezeichnet wird
+        //! Returns whether a border is drawn around the animation
         DLLEXPORT bool hatRahmen() const;
-        //! Gibt den Rahmen der Animation zurueck
+        //! Returns the border of the animation
         DLLEXPORT Rahmen* getRahmen() const;
-        //! Gibt den Rahmen der Animation ohne erhoehten Reference Counter zurueck
+        //! Returns the border of the animation without increasing the
+        //! reference counter
         DLLEXPORT Rahmen* zRahmen() const;
-        //! Gibt die Breite des Rahmens in Pixeln zurueck
+        //! Returns the width of the border in pixels
         DLLEXPORT int getRahmenBreite() const;
-        //! Gibt die Farbe des Rahmens im A8R8G8B8 Format zurueck
+        //! Returns the color of the border in A8R8G8B8 format
         DLLEXPORT int getRahmenFarbe() const;
-        //! Kopiert die Animation, so dass sie ohne auswirkungen auf das
-        //! Original veraendert werden kann
+        //! Copies the animation so that it can be modified without
+        //! affecting the original
         DLLEXPORT Zeichnung* dublizieren() const override;
     };
 } // namespace Framework

AsynchronCall.cpp

@@ -2,10 +2,10 @@
 
 using namespace Framework;
 
-// Inhalt der AsynchronCall Klasse
-// Konstruktor
-//  f: Die Funktion die asynchron aufgerufen werden soll
-//  Muss mit new aufgerufen werden. Das Objekt loescht sich selbst
+// Content of the AsynchronCall class
+// Constructor
+//  f: The function to be called asynchronously
+//  Must be called with new. The object deletes itself
 AsynchronCall::AsynchronCall(std::function<void()> f)
     : Thread()
 {
@@ -14,11 +14,11 @@ AsynchronCall::AsynchronCall(std::function<void()> f)
     start();
 }
 
-// Inhalt der AsynchronCall Klasse
-// Konstruktor
-//  name: Der Name des Threads
-//  f: Die Funktion die asynchron aufgerufen werden soll
-//  Muss mit new aufgerufen werden. Das Objekt loescht sich selbst
+// Content of the AsynchronCall class
+// Constructor
+//  name: The name of the thread
+//  f: The function to be called asynchronously
+//  Must be called with new. The object deletes itself
 AsynchronCall::AsynchronCall(const char* name, std::function<void()> f)
     : Thread()
 {
@@ -28,10 +28,10 @@ AsynchronCall::AsynchronCall(const char* name, std::function<void()> f)
     start();
 }
 
-// Konstruktor
-//  f: Die Funktion die asynchron aufgerufen werden soll
-//  finished: Wird auf 1 gesetzt wenn der Aufruf abgearbeitet wurde
-//  Muss mit new aufgerufen werden. Das Objekt loescht sich selbst
+// Constructor
+//  f: The function to be called asynchronously
+//  finished: Set to 1 when the call has been processed
+//  Must be called with new. The object deletes itself
 AsynchronCall::AsynchronCall(std::function<void()> f, bool* finished)
     : Thread()
 {
@@ -41,11 +41,11 @@ AsynchronCall::AsynchronCall(std::function<void()> f, bool* finished)
     start();
 }
 
-// Konstruktor
-//  name: Der Name des Threads
-//  f: Die Funktion die asynchron aufgerufen werden soll
-//  finished: Wird auf 1 gesetzt wenn der Aufruf abgearbeitet wurde
-//  Muss mit new aufgerufen werden. Das Objekt loescht sich selbst
+// Constructor
+//  name: The name of the thread
+//  f: The function to be called asynchronously
+//  finished: Set to 1 when the call has been processed
+//  Must be called with new. The object deletes itself
 AsynchronCall::AsynchronCall(
     const char* name, std::function<void()> f, bool* finished)
     : Thread()

Bild.h

@@ -117,254 +117,242 @@ namespace Framework
         DLLEXPORT void setAlpha(unsigned char alpha);
         //! Removes the last alpha limit set with setAlpha()
         DLLEXPORT void releaseAlpha();
-        //! Setzt einen Zeiger auf die Pixel, in die gezeichnet werden soll
-        //! \param buffer Ein Array mit den A8R8G8B8 Farbwerten
-        //! \param deleteBuffer 1, fals der Array vom Bild geloescht werden soll
-        //! \param breite Die Breite in Pixeln
-        //! \param height Die Hoehe in Pixeln
+        //! Sets a pointer to the pixels to draw into
+        //! \param buffer An array with A8R8G8B8 color values
+        //! \param deleteBuffer 1 if the array should be deleted by the image
+        //! \param breite The width in pixels
+        //! \param height The height in pixels
         DLLEXPORT void setPixelBuffer(
             int* buffer, bool deleteBuffer, int breite, int height);
-        //! Erstellt ein neues Bild
-        //! \param breite Die Breite des Bildes in Pixeln
-        //! \param hoehe Die Hoehe des Bildes in Pixeln
-        //! \param fillColor Die startfarbe, auf die alle Pixel gesetzt werden
+        //! Creates a new image
+        //! \param breite The width of the image in pixels
+        //! \param hoehe The height of the image in pixels
+        //! \param fillColor The initial color all pixels are set to
         DLLEXPORT void neuBild(int breite, int height, int fillColor);
-        //! Blendet mittels Alphablending eine Farbe auf einen bestimmten Pixel
-        //! Beachtet nicht die begrenzung der Zeichnenflaeche und das Skroll
-        //! Offset \param x Die X Koordinate des Pixels \param y Die Y
-        //! Koordinate des Pixels \param f Die Farbe in A8R8G8B8 Format, die
-        //! geblendet werden soll
+        //! Blends a color onto a specific pixel using alpha blending.
+        //! Does not respect the drawing area boundary or scroll offset
+        //! \param x The X coordinate of the pixel
+        //! \param y The Y coordinate of the pixel
+        //! \param f The color in A8R8G8B8 format to be blended
         DLLEXPORT void alphaPixel2D(int x, int y, int f);
         DLLEXPORT void alphaPixel3D(int x, int y, int f);
-        //! Blendet mittels Alphablending eine Farbe auf einen bestimmten Pixel
-        //! Beachtet nicht die begrenzung der Zeichnenflaeche und das Skroll
-        //! Offset \param i Der Index des Pixels im Pixel Array \param f Die
-        //! Farbe in A8R8G8B8 Format, die geblendet werden soll
+        //! Blends a color onto a specific pixel using alpha blending.
+        //! Does not respect the drawing area boundary or scroll offset
+        //! \param i The index of the pixel in the pixel array
+        //! \param f The color in A8R8G8B8 format to be blended
         DLLEXPORT void alphaPixel2D(int i, int f);
         DLLEXPORT void alphaPixel3D(int i, int f);
-        //! Blendet mittels Alphablending eine Farbe auf einen bestimmten Pixel
-        //! \param x Die X Koordinate des Pixels
-        //! \param y Die Y Koordinate des Pixels
-        //! \param f Die Farbe in A8R8G8B8 Format, die geblendet werden soll
+        //! Blends a color onto a specific pixel using alpha blending
+        //! \param x The X coordinate of the pixel
+        //! \param y The Y coordinate of the pixel
+        //! \param f The color in A8R8G8B8 format to be blended
         DLLEXPORT void alphaPixelDP2D(int x, int y, int f);
         DLLEXPORT void alphaPixelDP3D(int x, int y, int f);
-        //! Blendet mittels Alphablending eine Farbe auf einen bestimmten Pixel
-        //! \param i Der Index des Pixels im Pixel Array
-        //! \param f Die Farbe in A8R8G8B8 Format, die geblendet werden soll
+        //! Blends a color onto a specific pixel using alpha blending
+        //! \param i The index of the pixel in the pixel array
+        //! \param f The color in A8R8G8B8 format to be blended
         DLLEXPORT void alphaPixelDP2D(int i, int f);
         DLLEXPORT void alphaPixelDP3D(int i, int f);
-        //! Setzt die Farbe eines besimmten Pixels
-        //! \param x Die X Koordinate des Pixels
-        //! \param y Die Y Koordinate des Pixels
-        //! \param f Die neue Farbe in A8R8G8B8 Format
+        //! Sets the color of a specific pixel
+        //! \param x The X coordinate of the pixel
+        //! \param y The Y coordinate of the pixel
+        //! \param f The new color in A8R8G8B8 format
         DLLEXPORT void setPixelDP(int x, int y, int f);
-        //! Setzt die Farbe eines besimmten Pixels
-        //! \param i Der Index des Pixels im Pixel Array
-        //! \param f Die neue Farbe in A8R8G8B8 Format
+        //! Sets the color of a specific pixel
+        //! \param i The index of the pixel in the pixel array
+        //! \param f The new color in A8R8G8B8 format
         DLLEXPORT void setPixelDP(int i, int f);
-        //! Setzt die Farbe aller Pixel des Bildes
-        //! \param f Die neue Farbe
+        //! Sets the color of all pixels in the image
+        //! \param f The new color
         DLLEXPORT void setFarbe(int f);
-        //! Setzt die Farben aller Pixel in einem Rechteck
-        //! \param x Die X Koordinate
-        //! \param y Die Y Koordinate
-        //! \param b Die Breite des Rechtecks
-        //! \param h Die Hoehe des Rechtecks
-        //! \param fc Die Farbe im A8R8G8B8 Format
+        //! Sets the colors of all pixels in a rectangle
+        //! \param x The X coordinate
+        //! \param y The Y coordinate
+        //! \param b The width of the rectangle
+        //! \param h The height of the rectangle
+        //! \param fc The color in A8R8G8B8 format
         DLLEXPORT void fillRegion(int x, int y, int b, int h, int fc);
-        //! Blendet eine Farbe mit Alphablending in einem Rechteck
-        //! \param x Die X Koordinate
-        //! \param y Die Y Koordinate
-        //! \param b Die Breite des Rechtecks
-        //! \param h Die Hoehe des Rechtecks
-        //! \param fc Die Farbe im A8R8G8B8 Format
+        //! Blends a color with alpha blending into a rectangle
+        //! \param x The X coordinate
+        //! \param y The Y coordinate
+        //! \param b The width of the rectangle
+        //! \param h The height of the rectangle
+        //! \param fc The color in A8R8G8B8 format
         DLLEXPORT void alphaRegion(int x, int y, int b, int h, int fc);
-        //! Zeichnet eine horizontale Linie
-        //! \param x Die X Koordinate des Startpunktes der Linie
-        //! \param y Die Y Koordinate des Startpunktes der Linie
-        //! \param length Die Laenge der Linie
-        //! \param fc Die Farbe im A8R8G8B8 Format
+        //! Draws a horizontal line
+        //! \param x The X coordinate of the starting point
+        //! \param y The Y coordinate of the starting point
+        //! \param length The length of the line
+        //! \param fc The color in A8R8G8B8 format
         DLLEXPORT void drawLinieH(int x, int y, int length, int fc);
-        //! Zeichnet eine vertikale Linie
-        //! \param x Die X Koordinate des Startpunktes der Linie
-        //! \param y Die Y Koordinate des Startpunktes der Linie
-        //! \param length Die Laenge der Linie
-        //! \param fc Die Farbe im A8R8G8B8 Format
+        //! Draws a vertical line
+        //! \param x The X coordinate of the starting point
+        //! \param y The Y coordinate of the starting point
+        //! \param length The length of the line
+        //! \param fc The color in A8R8G8B8 format
         DLLEXPORT void drawLinieV(int x, int y, int length, int fc);
-        //! Zeichnet eine horizontale Linie mit Alpha blending
-        //! \param x Die X Koordinate des Startpunktes der Linie
-        //! \param y Die Y Koordinate des Startpunktes der Linie
-        //! \param length Die Laenge der Linie
-        //! \param fc Die Farbe im A8R8G8B8 Format
+        //! Draws a horizontal line with alpha blending
+        //! \param x The X coordinate of the starting point
+        //! \param y The Y coordinate of the starting point
+        //! \param length The length of the line
+        //! \param fc The color in A8R8G8B8 format
         DLLEXPORT void drawLinieHAlpha(int x, int y, int length, int fc);
-        //! Zeichnet eine vertikale Linie mit Alpha Blending
-        //! \param x Die X Koordinate des Startpunktes der Linie
-        //! \param y Die Y Koordinate des Startpunktes der Linie
-        //! \param length Die Laenge der Linie
-        //! \param fc Die Farbe im A8R8G8B8 Format
+        //! Draws a vertical line with alpha blending
+        //! \param x The X coordinate of the starting point
+        //! \param y The Y coordinate of the starting point
+        //! \param length The length of the line
+        //! \param fc The color in A8R8G8B8 format
         DLLEXPORT void drawLinieVAlpha(int x, int y, int length, int fc);
-        //! Zeichnet eine Linie
-        //! \param a Der Startpunkt der Linie
-        //! \param b der Endpunkt der Linie
-        //! \param fc Die Farbe im A8R8G8B8 Format
+        //! Draws a bordered line
+        //! \param a The starting point of the line
+        //! \param b The ending point of the line
+        //! \param bc The border color in A8R8G8B8 format
+        //! \param fc The color in A8R8G8B8 format
         DLLEXPORT void drawLinieBordered(Punkt a, Punkt b, int bc, int fc);
-        //! Zeichnet eine Linie
-        //! \param a Der Startpunkt der Linie
-        //! \param b der Endpunkt der Linie
-        //! \param fc Die Farbe im A8R8G8B8 Format
+        //! Draws a bordered line with alpha blending
+        //! \param a The starting point of the line
+        //! \param b The ending point of the line
+        //! \param bc The border color in A8R8G8B8 format
+        //! \param fc The color in A8R8G8B8 format
         DLLEXPORT void drawLinieBorderedAlpha(Punkt a, Punkt b, int bc, int fc);
-        //! Zeichnet eine Linie
-        //! \param a Der Startpunkt der Linie
-        //! \param b der Endpunkt der Linie
-        //! \param fc Die Farbe im A8R8G8B8 Format
+        //! Draws a line
+        //! \param a The starting point of the line
+        //! \param b The ending point of the line
+        //! \param fc The color in A8R8G8B8 format
         DLLEXPORT void drawLinie(Punkt a, Punkt b, int fc);
-        //! Zeichnet eine Linie mit Alpha Blending
-        //! \param a Der Startpunkt der Linie
-        //! \param b der Endpunkt der Linie
-        //! \param fc Die Farbe im A8R8G8B8 Format
+        //! Draws a line with alpha blending
+        //! \param a The starting point of the line
+        //! \param b The ending point of the line
+        //! \param fc The color in A8R8G8B8 format
         DLLEXPORT void drawLinieAlpha(Punkt a, Punkt b, int fc);
-        //! Fuellt einen Kreis mit einer Farbe. (Unfertig)
-        //! \param xOff Die X Koordinate des Kreismittelpunktes
-        //! \param yOff Die Y Koordinate des Kreismittelpunktes
-        //! \param r Der Radius des Kreises in Pixeln
-        //! \param fc Die Farbe im A8R8G8B8 Format
+        //! Fills a circle with a color. (Unfinished)
+        //! \param xOff The X coordinate of the circle center
+        //! \param yOff The Y coordinate of the circle center
+        //! \param r The radius of the circle in pixels
+        //! \param fc The color in A8R8G8B8 format
         DLLEXPORT void fillCircle(int xOff, int yOff, int r, int fc);
-        //! Zeichnet den Umriss eines Kreises
-        //! \param xOff Die X Koordinate des Kreismittelpunktes
-        //! \param yOff Die Y Koordinate des Kreismittelpunktes
-        //! \param r Der Radius des Kreises in Pixeln
-        //! \param fc Die Farbe im A8R8G8B8 Format
+        //! Draws the outline of a circle
+        //! \param xOff The X coordinate of the circle center
+        //! \param yOff The Y coordinate of the circle center
+        //! \param r The radius of the circle in pixels
+        //! \param fc The color in A8R8G8B8 format
         DLLEXPORT void drawKreis(int xOff, int yOff, int r, int fc);
-        //! Zeichnet den Umriss eines Kreises mit Alpha Blending
-        //! \param xOff Die X Koordinate des Kreismittelpunktes
-        //! \param yOff Die Y Koordinate des Kreismittelpunktes
-        //! \param r Der Radius des Kreises in Pixeln
-        //! \param fc Die Farbe im A8R8G8B8 Format
+        //! Draws the outline of a circle with alpha blending
+        //! \param xOff The X coordinate of the circle center
+        //! \param yOff The Y coordinate of the circle center
+        //! \param r The radius of the circle in pixels
+        //! \param fc The color in A8R8G8B8 format
         DLLEXPORT void drawKreisAlpha(int xOff, int yOff, int r, int fc);
-        //! Zeichnet ein Bild in ein bestimmtes Feld ohne Skallierung
-        //! \param x Die X Koordinate der linken oberen Ecke des Rechtecks in
-        //! dem das Bild gezeichnet werden soll \param y Die Y Koordinate der
-        //! linken oberen Ecke des Rechtecks in dem das Bild gezeichnet werden
-        //! soll \param br Die Breite des Rechecks in dem das Bild gezeichnet
-        //! werden soll \param hi Die Hoehe des Rechecks in dem das Bild
-        //! gezeichnet werden soll \param zBild Das Bild, was gezeichnet werden
-        //! soll
+        //! Draws an image into a specific area without scaling
+        //! \param x The X coordinate of the top left corner of the target area
+        //! \param y The Y coordinate of the top left corner of the target area
+        //! \param br The width of the target area
+        //! \param hi The height of the target area
+        //! \param zBild The image to be drawn
         DLLEXPORT void drawBild(
             int x, int y, int br, int hi, const Bild& zBild);
-        //! Zeichnet ein Bild in ein bestimmtes Feld ohne Skallierung mit alpha
-        //! blending \param x Die X Koordinate der linken oberen Ecke des
-        //! Rechtecks in dem das Bild gezeichnet werden soll \param y Die Y
-        //! Koordinate der linken oberen Ecke des Rechtecks in dem das Bild
-        //! gezeichnet werden soll \param br Die Breite des Rechecks in dem das
-        //! Bild gezeichnet werden soll \param hi Die Hoehe des Rechecks in dem
-        //! das Bild gezeichnet werden soll \param zBild Das Bild, was
-        //! gezeichnet werden soll
+        //! Draws an image into a specific area without scaling with alpha
+        //! blending
+        //! \param x The X coordinate of the top left corner of the target area
+        //! \param y The Y coordinate of the top left corner of the target area
+        //! \param br The width of the target area
+        //! \param hi The height of the target area
+        //! \param zBild The image to be drawn
         DLLEXPORT void alphaBild(
             int x, int y, int br, int hi, const Bild& zBild);
-        //! Zeichnet ein Bild in ein bestimmtes Feld ohne Skallierung mit alpha
-        //! blending \param x Die X Koordinate der linken oberen Ecke des
-        //! Rechtecks in dem das Bild gezeichnet werden soll \param y Die Y
-        //! Koordinate der linken oberen Ecke des Rechtecks in dem das Bild
-        //! gezeichnet werden soll \param br Die Breite des Rechecks in dem das
-        //! Bild gezeichnet werden soll \param hi Die Hoehe des Rechecks in dem
-        //! das Bild gezeichnet werden soll \param zBild Das Bild, was
-        //! gezeichnet werden soll
+        //! Draws an image into a specific area without scaling with associative
+        //! alpha blending
+        //! \param x The X coordinate of the top left corner of the target area
+        //! \param y The Y coordinate of the top left corner of the target area
+        //! \param br The width of the target area
+        //! \param hi The height of the target area
+        //! \param zBild The image to be drawn
         DLLEXPORT void alphaBildAssoz(
             int x, int y, int br, int hi, const Bild& zBild);
-        //! Zeichnet ein Bild um 90 grad nach rechts gedreht in ein bestimmtes
-        //! Feld ohne Skallierung \param x Die X Koordinate der linken oberen
-        //! Ecke des Rechtecks in dem das Bild gezeichnet werden soll \param y
-        //! Die Y Koordinate der linken oberen Ecke des Rechtecks in dem das
-        //! Bild gezeichnet werden soll \param br Die Breite des Rechecks in dem
-        //! das Bild gezeichnet werden soll \param hi Die Hoehe des Rechecks in
-        //! dem das Bild gezeichnet werden soll \param zBild Das Bild, was
-        //! gezeichnet werden soll
+        //! Draws an image rotated 90 degrees clockwise into a specific area
+        //! without scaling
+        //! \param x The X coordinate of the top left corner of the target area
+        //! \param y The Y coordinate of the top left corner of the target area
+        //! \param br The width of the target area
+        //! \param hi The height of the target area
+        //! \param zBild The image to be drawn
         DLLEXPORT void drawBild90(
             int x, int y, int br, int hi, const Bild& zBild);
-        //! Zeichnet ein Bild um 90 grad nach rechts gedreht in ein bestimmtes
-        //! Feld ohne Skallierung mit alpha Blending \param x Die X Koordinate
-        //! der linken oberen Ecke des Rechtecks in dem das Bild gezeichnet
-        //! werden soll \param y Die Y Koordinate der linken oberen Ecke des
-        //! Rechtecks in dem das Bild gezeichnet werden soll \param br Die
-        //! Breite des Rechecks in dem das Bild gezeichnet werden soll \param hi
-        //! Die Hoehe des Rechecks in dem das Bild gezeichnet werden soll \param
-        //! zBild Das Bild, was gezeichnet werden soll
+        //! Draws an image rotated 90 degrees clockwise into a specific area
+        //! without scaling with alpha blending
+        //! \param x The X coordinate of the top left corner of the target area
+        //! \param y The Y coordinate of the top left corner of the target area
+        //! \param br The width of the target area
+        //! \param hi The height of the target area
+        //! \param zBild The image to be drawn
         DLLEXPORT void alphaBild90(
             int x, int y, int br, int hi, const Bild& zBild);
-        //! Zeichnet ein Bild um 180 grad nach rechts gedreht in ein bestimmtes
-        //! Feld ohne Skallierung \param x Die X Koordinate der linken oberen
-        //! Ecke des Rechtecks in dem das Bild gezeichnet werden soll \param y
-        //! Die Y Koordinate der linken oberen Ecke des Rechtecks in dem das
-        //! Bild gezeichnet werden soll \param br Die Breite des Rechecks in dem
-        //! das Bild gezeichnet werden soll \param hi Die Hoehe des Rechecks in
-        //! dem das Bild gezeichnet werden soll \param zBild Das Bild, was
-        //! gezeichnet werden soll
+        //! Draws an image rotated 180 degrees into a specific area
+        //! without scaling
+        //! \param x The X coordinate of the top left corner of the target area
+        //! \param y The Y coordinate of the top left corner of the target area
+        //! \param br The width of the target area
+        //! \param hi The height of the target area
+        //! \param zBild The image to be drawn
         DLLEXPORT void drawBild180(
             int x, int y, int br, int hi, const Bild& zBild);
-        //! Zeichnet ein Bild um 180 grad nach rechts gedreht in ein bestimmtes
-        //! Feld ohne Skallierung mit alpha Blending \param x Die X Koordinate
-        //! der linken oberen Ecke des Rechtecks in dem das Bild gezeichnet
-        //! werden soll \param y Die Y Koordinate der linken oberen Ecke des
-        //! Rechtecks in dem das Bild gezeichnet werden soll \param br Die
-        //! Breite des Rechecks in dem das Bild gezeichnet werden soll \param hi
-        //! Die Hoehe des Rechecks in dem das Bild gezeichnet werden soll \param
-        //! zBild Das Bild, was gezeichnet werden soll
+        //! Draws an image rotated 180 degrees into a specific area
+        //! without scaling with alpha blending
+        //! \param x The X coordinate of the top left corner of the target area
+        //! \param y The Y coordinate of the top left corner of the target area
+        //! \param br The width of the target area
+        //! \param hi The height of the target area
+        //! \param zBild The image to be drawn
         DLLEXPORT void alphaBild180(
             int x, int y, int br, int hi, const Bild& zBild);
-        //! Zeichnet ein Bild um 270 grad nach rechts gedreht in ein bestimmtes
-        //! Feld ohne Skallierung \param x Die X Koordinate der linken oberen
-        //! Ecke des Rechtecks in dem das Bild gezeichnet werden soll \param y
-        //! Die Y Koordinate der linken oberen Ecke des Rechtecks in dem das
-        //! Bild gezeichnet werden soll \param br Die Breite des Rechecks in dem
-        //! das Bild gezeichnet werden soll \param hi Die Hoehe des Rechecks in
-        //! dem das Bild gezeichnet werden soll \param zBild Das Bild, was
-        //! gezeichnet werden soll
+        //! Draws an image rotated 270 degrees clockwise into a specific area
+        //! without scaling
+        //! \param x The X coordinate of the top left corner of the target area
+        //! \param y The Y coordinate of the top left corner of the target area
+        //! \param br The width of the target area
+        //! \param hi The height of the target area
+        //! \param zBild The image to be drawn
         DLLEXPORT void drawBild270(
             int x, int y, int br, int hi, const Bild& zBild);
-        //! Zeichnet ein Bild um 270 grad nach rechts gedreht in ein bestimmtes
-        //! Feld ohne Skallierung mit alpha Blending \param x Die X Koordinate
-        //! der linken oberen Ecke des Rechtecks in dem das Bild gezeichnet
-        //! werden soll \param y Die Y Koordinate der linken oberen Ecke des
-        //! Rechtecks in dem das Bild gezeichnet werden soll \param br Die
-        //! Breite des Rechecks in dem das Bild gezeichnet werden soll \param hi
-        //! Die Hoehe des Rechecks in dem das Bild gezeichnet werden soll \param
-        //! zBild Das Bild, was gezeichnet werden soll
+        //! Draws an image rotated 270 degrees clockwise into a specific area
+        //! without scaling with alpha blending
+        //! \param x The X coordinate of the top left corner of the target area
+        //! \param y The Y coordinate of the top left corner of the target area
+        //! \param br The width of the target area
+        //! \param hi The height of the target area
+        //! \param zBild The image to be drawn
         DLLEXPORT void alphaBild270(
             int x, int y, int br, int hi, const Bild& zBild);
-        //! Zeichnet ein Bild in ein bestimmtes Feld mit Skallierung
-        //! \param x Die X Koordinate der linken oberen Ecke des Rechtecks in
-        //! dem das Bild gezeichnet werden soll \param y Die Y Koordinate der
-        //! linken oberen Ecke des Rechtecks in dem das Bild gezeichnet werden
-        //! soll \param br Die Breite des Rechecks in dem das Bild gezeichnet
-        //! werden soll \param hi Die Hoehe des Rechecks in dem das Bild
-        //! gezeichnet werden soll \param zBild Das Bild, was gezeichnet werden
-        //! soll
+        //! Draws an image into a specific area with scaling
+        //! \param x The X coordinate of the top left corner of the target area
+        //! \param y The Y coordinate of the top left corner of the target area
+        //! \param br The width of the target area
+        //! \param hi The height of the target area
+        //! \param zBild The image to be drawn
         DLLEXPORT void drawBildSkall(
             int x, int y, int br, int hi, const Bild& zBild);
-        //! Zeichnet ein Bild in ein bestimmtes Feld mit Skallierung mit Alpha
-        //! Blending \param x Die X Koordinate der linken oberen Ecke des
-        //! Rechtecks in dem das Bild gezeichnet werden soll \param y Die Y
-        //! Koordinate der linken oberen Ecke des Rechtecks in dem das Bild
-        //! gezeichnet werden soll \param br Die Breite des Rechecks in dem das
-        //! Bild gezeichnet werden soll \param hi Die Hoehe des Rechecks in dem
-        //! das Bild gezeichnet werden soll \param zBild Das Bild, was
-        //! gezeichnet werden soll
+        //! Draws an image into a specific area with scaling and alpha blending
+        //! \param x The X coordinate of the top left corner of the target area
+        //! \param y The Y coordinate of the top left corner of the target area
+        //! \param br The width of the target area
+        //! \param hi The height of the target area
+        //! \param zBild The image to be drawn
         DLLEXPORT void alphaBildSkall(
             int x, int y, int br, int hi, const Bild& zBild);
-        //! Fuellt ein Dreieck mit einer bestimmten Farbe
-        //! \param a Eine Ecke des Dreiecks
-        //! \param b Eine Ecke des Dreiecks
-        //! \param c Eine Ecke des Dreiecks
-        //! \param farbe die Farbe im A8R8G8B8 Format
+        //! Fills a triangle with a specific color
+        //! \param a A corner of the triangle
+        //! \param b A corner of the triangle
+        //! \param c A corner of the triangle
+        //! \param farbe The color in A8R8G8B8 format
         DLLEXPORT void drawDreieck(Punkt a, Punkt b, Punkt c, int farbe);
-        //! Fuellt ein Dreieck mit einer bestimmten Textur
-        //! \param a Eine Ecke des Dreiecks
-        //! \param b Eine Ecke des Dreiecks
-        //! \param c Eine Ecke des Dreiecks
-        //! \param ta Die Koordinaten von a in der Textur
-        //! \param tb Die Koordinaten von b in der Textur
-        //! \param tc Die Koordinaten von c in der Textur
-        //! \param textur Das Bild, was als Textur verwendet werden soll
+        //! Fills a triangle with a specific texture
+        //! \param a A corner of the triangle
+        //! \param b A corner of the triangle
+        //! \param c A corner of the triangle
+        //! \param ta The coordinates of a in the texture
+        //! \param tb The coordinates of b in the texture
+        //! \param tc The coordinates of c in the texture
+        //! \param textur The image to use as texture
         DLLEXPORT void drawDreieckTextur(Punkt a,
             Punkt b,
             Punkt c,
@@ -372,20 +360,20 @@ namespace Framework
             Punkt tb,
             Punkt tc,
             const Bild& textur);
-        //! Fuellt ein Dreieck mit einer bestimmten Farbe mit alpha blending
-        //! \param a Eine Ecke des Dreiecks
-        //! \param b Eine Ecke des Dreiecks
-        //! \param c Eine Ecke des Dreiecks
-        //! \param farbe die Farbe im A8R8G8B8 Format
+        //! Fills a triangle with a specific color with alpha blending
+        //! \param a A corner of the triangle
+        //! \param b A corner of the triangle
+        //! \param c A corner of the triangle
+        //! \param farbe The color in A8R8G8B8 format
         DLLEXPORT void drawDreieckAlpha(Punkt a, Punkt b, Punkt c, int farbe);
-        //! Fuellt ein Dreieck mit einer bestimmten Textur mit alpha blending
-        //! \param a Eine Ecke des Dreiecks
-        //! \param b Eine Ecke des Dreiecks
-        //! \param c Eine Ecke des Dreiecks
-        //! \param ta Die Koordinaten von a in der Textur
-        //! \param tb Die Koordinaten von b in der Textur
-        //! \param tc Die Koordinaten von c in der Textur
-        //! \param textur Das Bild, was als Textur verwendet werden soll
+        //! Fills a triangle with a specific texture with alpha blending
+        //! \param a A corner of the triangle
+        //! \param b A corner of the triangle
+        //! \param c A corner of the triangle
+        //! \param ta The coordinates of a in the texture
+        //! \param tb The coordinates of b in the texture
+        //! \param tc The coordinates of c in the texture
+        //! \param textur The image to use as texture
         DLLEXPORT void drawDreieckTexturAlpha(Punkt a,
             Punkt b,
             Punkt c,
@@ -393,120 +381,113 @@ namespace Framework
             Punkt tb,
             Punkt tc,
             const Bild& textur);
-        //! Ersetzt eine bestimmte Farbe durch Transparenz
+        //! Replaces a specific color with transparency
         DLLEXPORT void replaceColorWithAlpha(int color);
-        //! Begrenzt die Zeichenflaeche in die bis zum naechsten aufruf von
-        //! releaseDrawOptions() gezeichnet werden kann. Alles ausserhalb der
-        //! Flaeche wird automatisch ignoriert. Wenn die Zeichenflaeche ueber den
-        //! Rand einer bestehenden Zeichenflaeche hinausragt, wird sie
-        //! automatisch auf die bestehende Zeichnenflaeche beschnitten. \param
-        //! pos Die Koordinaten der linken oberen Ecke der Zeichenflaeche \param
-        //! gr Die Groesse der Zeichenflaeche \return 1, falls die neue
-        //! Zeichenflaeche ganz oder teilweise innerhalb der bestehenden
-        //! Zeichenflaeche ligt. Wenn 0 zurueckgegeben wird, wurde die
-        //! Zeichenflaeche nicht gesetzt und es braucht nicht
-        //! releaseDrawOptions() aufgerufen werden
+        //! Restricts the drawing area until the next call of
+        //! releaseDrawOptions(). Everything outside the area is automatically
+        //! ignored. If the drawing area extends beyond an existing drawing area,
+        //! it is automatically clipped to the existing one.
+        //! \param pos The coordinates of the top left corner of the drawing area
+        //! \param gr The size of the drawing area
+        //! \return 1 if the new drawing area is fully or partially within the
+        //! existing drawing area. If 0 is returned, the drawing area was not set
+        //! and releaseDrawOptions() does not need to be called
         DLLEXPORT bool setDrawOptions(const Punkt& pos, const Punkt& gr);
-        //! Begrenzt die Zeichenflaeche in die bis zum naechsten aufruf von
-        //! releaseDrawOptions() gezeichnet werden kann. Alles ausserhalb der
-        //! Flaeche wird automatisch ignoriert. Wenn die Zeichenflaeche ueber den
-        //! Rand einer bestehenden Zeichenflaeche hinausragt, wird sie
-        //! automatisch auf die bestehende Zeichnenflaeche beschnitten. \param x
-        //! Die X Koordinate der linken oberen Ecke der Zeichenflaeche \param y
-        //! Die X Koordinate der linken oberen Ecke der Zeichenflaeche \param br
-        //! Die Breite der Zeichenflaeche \param hi Die Hoehe der Zeichenflaeche
-        //! \return 1, falls die neue Zeichenflaeche ganz oder teilweise
-        //! innerhalb der bestehenden Zeichenflaeche ligt. Wenn 0 zurueckgegeben
-        //! wird, wurde die Zeichenflaeche nicht gesetzt und es braucht nicht
-        //! releaseDrawOptions() aufgerufen werden
+        //! Restricts the drawing area until the next call of
+        //! releaseDrawOptions(). Everything outside the area is automatically
+        //! ignored. If the drawing area extends beyond an existing drawing area,
+        //! it is automatically clipped to the existing one.
+        //! \param x The X coordinate of the top left corner of the drawing area
+        //! \param y The Y coordinate of the top left corner of the drawing area
+        //! \param br The width of the drawing area
+        //! \param hi The height of the drawing area
+        //! \return 1 if the new drawing area is fully or partially within the
+        //! existing drawing area. If 0 is returned, the drawing area was not set
+        //! and releaseDrawOptions() does not need to be called
         DLLEXPORT bool setDrawOptions(int x, int y, int br, int hi);
-        //! Begrenzt die Zeichenflaeche in die bis zum naechsten aufruf von
-        //! releaseDrawOptions() gezeichnet werden kann. Alles ausserhalb der
-        //! Flaeche wird automatisch ignoriert. Wenn die Zeichenflaeche darf ueber
-        //! den Rand einer bestehenden Zeichenflaeche hinausragen \param pos Die
-        //! Koordinaten der linken oberen Ecke der Zeichenflaeche \param gr Die
-        //! Groesse der Zeichenflaeche \return 1, falls die neue Zeichenflaeche ganz
-        //! oder teilweise innerhalb des Bildes ligt. Wenn 0 zurueckgegeben wird,
-        //! wurde die Zeichenflaeche nicht gesetzt und es braucht nicht
-        //! releaseDrawOptions() aufgerufen werden
+        //! Restricts the drawing area until the next call of
+        //! releaseDrawOptions(). Everything outside the area is automatically
+        //! ignored. The drawing area may extend beyond an existing drawing area.
+        //! \param pos The coordinates of the top left corner of the drawing area
+        //! \param gr The size of the drawing area
+        //! \return 1 if the new drawing area is fully or partially within the
+        //! image. If 0 is returned, the drawing area was not set and
+        //! releaseDrawOptions() does not need to be called
         DLLEXPORT bool setDrawOptionsErzwingen(
             const Punkt& pos, const Punkt& gr);
-        //! Begrenzt die Zeichenflaeche in die bis zum naechsten aufruf von
-        //! releaseDrawOptions() gezeichnet werden kann. Alles ausserhalb der
-        //! Flaeche wird automatisch ignoriert. Wenn die Zeichenflaeche darf ueber
-        //! den Rand einer bestehenden Zeichenflaeche hinausragen \param x Die X
-        //! Koordinate der linken oberen Ecke der Zeichenflaeche \param y Die X
-        //! Koordinate der linken oberen Ecke der Zeichenflaeche \param br Die
-        //! Breite der Zeichenflaeche \param hi Die Hoehe der Zeichenflaeche
-        //! \return 1, falls die neue Zeichenflaeche ganz oder teilweise
-        //! innerhalb des Bildes ligt. Wenn 0 zurueckgegeben wird, wurde die
-        //! Zeichenflaeche nicht gesetzt und es braucht nicht
-        //! releaseDrawOptions() aufgerufen werden
+        //! Restricts the drawing area until the next call of
+        //! releaseDrawOptions(). Everything outside the area is automatically
+        //! ignored. The drawing area may extend beyond an existing drawing area.
+        //! \param x The X coordinate of the top left corner of the drawing area
+        //! \param y The Y coordinate of the top left corner of the drawing area
+        //! \param br The width of the drawing area
+        //! \param hi The height of the drawing area
+        //! \return 1 if the new drawing area is fully or partially within the
+        //! image. If 0 is returned, the drawing area was not set and
+        //! releaseDrawOptions() does not need to be called
         DLLEXPORT bool setDrawOptionsErzwingen(int x, int y, int br, int hi);
-        //! Setzt neue Draw options auf bildgroesse
+        //! Resets draw options to image size
         DLLEXPORT void setDrawOptionsReset();
-        //! Setzt Koordinaten, die bei den Zeichenfunktionen von den Positionen
-        //! abgezogen werden Vorher sollte eine Zeichenflaeche mit SetDrawOptions
-        //! gesetzt worden sein. Die Werte werden mit dem aufruf von
-        //! releaseDrawOptions() wieder zurueckgesetzt. \param xOff Ein Wert, der
-        //! von allen X Koordinaten abgezogen wird \param yOff Ein Wert, der von
-        //! allen Y Koordinaten abgezogen wird
+        //! Sets coordinates that are subtracted from positions in drawing
+        //! functions. A drawing area should have been set with setDrawOptions
+        //! beforehand. The values are reset with the call of
+        //! releaseDrawOptions().
+        //! \param xOff A value subtracted from all X coordinates
+        //! \param yOff A value subtracted from all Y coordinates
         DLLEXPORT void addScrollOffset(int xOff, int yOff);
-        //! Entfernt die als letztes gesetzte begrenzung der Zeichenflaeche und
-        //! alle seit dem gesetzten Scroll Offsets Stellt die vorherige
-        //! Zeichenflaeche und die zugehoerigen Scroll Offsets wieder her
+        //! Removes the last set drawing area restriction and all scroll offsets
+        //! set since then. Restores the previous drawing area and its
+        //! associated scroll offsets
         DLLEXPORT void releaseDrawOptions();
-        //! Gibt zurueck, ob sich das Bild seit dem letzten Aufruf dieser
-        //! Funktion veraendert hat
+        //! Returns whether the image has changed since the last call of this
+        //! function
         DLLEXPORT bool getRend();
-        //! Gibt den Array mit A8R8G8B8 Farbwerten der Pixel zurueck
-        //! Der Index eines Pixels berechnet sich durch x + y * Bildbreite
+        //! Returns the array of A8R8G8B8 pixel color values.
+        //! The index of a pixel is calculated as x + y * image width
         DLLEXPORT int* getBuffer() const;
-        //! Gibt den A8R8G8B8 Farbwert eines Pixels zurueck
-        //! \param x Die X Koordinate des Pixels
-        //! \param y Die Y Koordinate des Pixels
+        //! Returns the A8R8G8B8 color value of a pixel
+        //! \param x The X coordinate of the pixel
+        //! \param y The Y coordinate of the pixel
         DLLEXPORT int getPixel(int x, int y) const;
-        //! Gibt die Groesse des Bildes zurueck
+        //! Returns the size of the image
         DLLEXPORT const Punkt& getSize() const;
-        //! Gibt die Breite des Bildes zurueck
+        //! Returns the width of the image
         DLLEXPORT int getBreite() const;
-        //! Gibt die Hoehe des Bildes zurueck
+        //! Returns the height of the image
         DLLEXPORT int getHeight() const;
-        //! Gibt den aktuellen mindest Transparenz Wert zurueck
+        //! Returns the current minimum transparency value
         DLLEXPORT unsigned char getAlpha() const;
-        //! Gibt die Koordinaten der linken oberen Ecke der aktuellen
-        //! Zeichenflaeche zurueck
+        //! Returns the coordinates of the top left corner of the current
+        //! drawing area
         DLLEXPORT const Punkt& getDrawPos() const;
-        //! Gibt die Groesse der aktuelen Zeichenflaeche zurueck
+        //! Returns the size of the current drawing area
         DLLEXPORT const Punkt& getDrawGr() const;
-        //! Gibt die Koordinaten zurueck, die zu allen Positionen vor dem
-        //! Zeichnen hinzugefuegt werden
+        //! Returns the coordinates added to all positions before drawing
         DLLEXPORT const Punkt& getDrawOff() const;
-        //! Wird dieser Flag gesetzt, so wird beim Alpha Blending wenn die
-        //! vorheriege Farbe 0 ist nur die neue mit ihrem Alpha Wert kopiert.
-        //! Das ist sinnvoll fuer die Verwendung im 3DBildschirm, wo das
-        //! Gezeichnette Bild spaeter mittels Alpha Blending angezeigt wird. Der
-        //! Flag wird im 3DBildschirm automatisch gesetzt
+        //! If this flag is set, when alpha blending and the previous color
+        //! is 0, the new color is only copied with its alpha value.
+        //! This is useful for use in the 3D screen, where the drawn image
+        //! is later displayed using alpha blending. The flag is set
+        //! automatically in the 3D screen
         DLLEXPORT bool hasAlpha3D() const;
-        //! Berechnet die durchschnittliche Farbe aller Pixel des Bildes
+        //! Calculates the average color of all pixels in the image
         DLLEXPORT int getAverageColor() const;
     };
 
-    //! Eine Zeichnung des 2d GUI Frameworks, die ein Bild anzeigt.
+    //! A 2D GUI Framework drawing that displays an image.
     class BildZ : public ZeichnungHintergrund
     {
     public:
         class Style : public ZeichnungHintergrund::Style
         {
         public:
-            //! Wenn dieser Flag gesetzt ist, wird zum Zeichnen des Bildes Alpha
-            //! Blending verwendet
+            //! If this flag is set, alpha blending is used when drawing
+            //! the image
             static const __int64 Alpha = 0x1000;
-            //! Wenn dieser Flag gesetzt ist, wird das Bild in die Zeichenflaeche
-            //! skalliert
+            //! If this flag is set, the image is scaled to the drawing area
             static const __int64 Skalliert = 0x2000;
 
-            //! Der Normale Style einer Bild Zeichnung Bestehend aus HScroll,
+            //! The normal style of an image drawing consisting of HScroll,
             //! Sichtbar, Erlaubt, Rahmen, VScroll
             static const __int64 normal
                 = HScroll | Sichtbar | Erlaubt | Rahmen | VScroll;
@@ -516,43 +497,44 @@ namespace Framework
         Bild* bild;
 
     protected:
-        //! Verarbeitet ein Maus Ereignis. Wird vom Framework automatisch
-        //! aufgerufen. \param me Das Ereignis
+        //! Processes a mouse event. Called automatically by the framework.
+        //! \param me The event
         DLLEXPORT void doMausEreignis(MausEreignis& me, bool userRet) override;
 
     public:
-        //! Konstruktor
+        //! Constructor
         DLLEXPORT BildZ();
-        //! Destruktor
+        //! Destructor
         DLLEXPORT virtual ~BildZ();
-        //! Setzt einen Zeiger auf das Bild, was angezeigt werden soll
-        //! \param b Das Bild
+        //! Sets a pointer to the image to be displayed
+        //! \param b The image
         DLLEXPORT void setBildZ(Bild* b);
-        //! Setzt das Bild, was angezeigt werden soll. Der Inhalt des Bildes
-        //! wird Kopiert \param b Das Bild
+        //! Sets the image to be displayed. The image content is copied
+        //! \param b The image
         DLLEXPORT void setBild(Bild* b);
-        //! Updated den Zeichenhintergrund
-        //! \param tickVal Die vergangene Zeit in Sekunden, die seit dem Letzten
-        //! Aufruf dieser Funktion verstrichen ist \return 1, wenn das Bild neu
-        //! gezeichnet werden muss. 0 sonnst
+        //! Updates the drawing background
+        //! \param tickVal The elapsed time in seconds since the last call
+        //! of this function
+        //! \return 1 if the image needs to be redrawn. 0 otherwise
         DLLEXPORT bool tick(double tickVal) override;
-        //! Zeichnet die Zeihnung in ein bestimmtes Bild
-        //! \param zRObj Das Bild, in das gezeichnet werden soll
+        //! Draws the drawing into a specific image
+        //! \param zRObj The image to draw into
         DLLEXPORT void render(Bild& zRObj) override;
-        //! Gibt das angezeigte Bild zurueck
+        //! Returns the displayed image
         DLLEXPORT Bild* getBild() const;
-        //! Gbt das angezeigte Bild ohne erhoehten Reference Counter zurueck
+        //! Returns the displayed image without increased reference counter
         DLLEXPORT Bild* zBild() const;
-        //! Kopiert die Komplette Zeichnung, so dass sie ohne Effekt auf das
-        //! Original veraendert werden kann
+        //! Copies the complete drawing so it can be modified without
+        //! affecting the original
         DLLEXPORT Zeichnung* dublizieren() const override;
     };
 
 #ifdef WIN32
-    //! Laedt ein Bild aus einer .bmp, .jpg, .gif oder .png Datei
-    //! \param pfad Der Pfad zur Bilddatei
-    //! \param zError Ein Zeiger auf ein Text Objekt, in dem ein moeglicher
-    //! Fehler zurueckgegeben wird \return Das geladene Bild
+    //! Loads an image from a .bmp, .jpg, .gif or .png file
+    //! \param pfad The path to the image file
+    //! \param zError A pointer to a Text object where a possible error is
+    //! returned
+    //! \return The loaded image
     DLLEXPORT Bild* ladeBild(const char* pfad, Text* zError);
 #endif
 } // namespace Framework

Critical.cpp

@@ -8,7 +8,7 @@
 
 using namespace Framework;
 
-// Inhalt der Critical class aus Critical.h
+// Content of the Critical class from Critical.h
 // Konstructor
 Critical::Critical()
 {
@@ -30,7 +30,7 @@ pthread_t CachedCurrentThread()
     return (pthread_t)t;
 }
 
-// sperrt das Objekt
+// locks the object
 void Critical::lock()
 {
     getThreadRegister()->lock();
@@ -42,7 +42,7 @@ void Critical::lock()
     lockCount++;
 }
 
-// versucht das Objekt zu sperren
+// tries to lock the object
 bool Critical::tryLock()
 {
     if (lockCount > 0) return false;
@@ -56,7 +56,7 @@ bool Critical::tryLock()
     return true;
 }
 
-// entsperrt das Objekt
+// unlocks the object
 void Critical::unlock()
 {
     getThreadRegister()->lock();
@@ -78,13 +78,13 @@ void Critical::unlock()
     getThreadRegister()->unlock();
 }
 
-// gibt true zurueck, wenn das Objekt gesperrt ist
+// returns true if the object is locked
 bool Critical::isLocked() const
 {
     return lockCount > 0;
 }
 
-// gibt einen Zeiger auf den Thread zurueck, der das Objekt gesperrt hat
+// returns a pointer to the thread that locked the object
 const Thread* Critical::zOwner() const
 {
     return owner;

DLLRegister.cpp

@@ -1,16 +1,16 @@
-#include "DLLRegister.h"
+#include "DLLRegister.h"
 
 using namespace Framework;
 
-// Inhalt der DLLDateien Klasse aus DLLDateien.h
-// Konstruktor
+// Content of the DLLDateien class from DLLDateien.h
+// Constructor
 DLLRegister::DLLRegister()
     : ReferenceCounter()
 {
     dlls = new Array<DLLDatei*>();
 }
 
-// Destruktor
+// Destructor
 DLLRegister::~DLLRegister()
 {
     cs.lock();
@@ -31,7 +31,7 @@ DLLRegister::~DLLRegister()
     cs.unlock();
 }
 
-// nicht constant
+// non-constant
 HINSTANCE DLLRegister::ladeDLL(const char* name, const char* pfad)
 {
     cs.lock();

Rahmen.h

@@ -5,7 +5,7 @@
 
 namespace Framework
 {
-    class Bild; //! aus Bild.h
+    class Bild; //! Bild.h
 
     class Rahmen : public Zeichnung
     {
@@ -19,72 +19,73 @@ namespace Framework
         int lineLength;
 
     public:
-        //! Konstruktor
+        //! Constructor
         DLLEXPORT Rahmen();
-        //! Destruktor
+        //! Destructor
         DLLEXPORT virtual ~Rahmen();
-        //! Setzt die Breite des Rahmens
-        //! \param br Die Breite in Pixeln
+        //! Sets the width of the border
+        //! \param br The width in pixels
         DLLEXPORT void setRamenBreite(int br);
-        //! wenn dieser Flag gesetzt wird, wird der Rahmen gestrichelt
-        //! gezeichnet \param br 1 -> gestrichelt, 0 -> durchgehend \param brOff
-        //! startpunkt des ersten linienabschnittes \param brLength laenge einer
-        //! luecke \param lineLength laenge einer linie
+        //! If this flag is set, the border is drawn dashed
+        //! \param br 1 -> dashed, 0 -> solid
+        //! \param brOff Starting point of the first line segment
+        //! \param brLength Length of a gap
+        //! \param lineLength Length of a line
         DLLEXPORT void setBreaks(
             bool br, int brOff = 0, int brLength = 10, int lineLength = 10);
-        //! Gibt die Breite des Rahmens in Pixeln zurueck
+        //! Returns the width of the border in pixels
         DLLEXPORT int getRBreite() const;
-        //! Legt fest, ob beim zeichnen alpha blending verwendet werden soll
-        //! \param a 1, falls alpha blending verwendet werden soll
+        //! Sets whether alpha blending should be used when drawing
+        //! \param a 1 if alpha blending should be used
         DLLEXPORT void setAlpha(bool a);
-        //! Setzt die Fare des Rahmens
-        //! \param f Die Farbe im A8R8G8B8 Format
+        //! Sets the color of the border
+        //! \param f The color in A8R8G8B8 format
         DLLEXPORT void setFarbe(int f);
-        //! Gibt die Farbe des Rahmens im A8R8G8B8 Format zurueck
+        //! Returns the color of the border in A8R8G8B8 format
         DLLEXPORT int getFarbe() const;
-        //! Gibt zurueck, ob der Rahmen mit Alpha Blending gezeichnet wird
+        //! Returns whether the border is drawn with alpha blending
         DLLEXPORT bool hatAlpha() const;
-        //! Gibt 1 zurueck, falls der Rahmen gestrichelt gezeichnet wird
+        //! Returns 1 if the border is drawn dashed
         DLLEXPORT bool hasBreaks() const;
-        //! startpunkt des ersten linienabschnittes
+        //! Starting point of the first line segment
         DLLEXPORT int getBreakOffset() const;
-        //! laenge einer luecke
+        //! Length of a gap
         DLLEXPORT int getBreakLength() const;
-        //! laenge einer linie
+        //! Length of a line
         DLLEXPORT int getLineLength() const;
     };
 
-    //! Eine Zeichnung des 2D GUI Frameworks, die einen Linienrahmen um ein
-    //! Rechteck zeichnet
+    //! A 2D GUI Framework drawing that draws a line border around a
+    //! rectangle
     class LRahmen : public Rahmen
     {
     private:
 
     public:
-        //! Konstruktor
+        //! Constructor
         DLLEXPORT LRahmen();
-        //! Destruktor
+        //! Destructor
         DLLEXPORT virtual ~LRahmen();
-        //! Zeichnet den Rahmen
-        //! \param zRObj Das Bild, in den der Rahmen gezeichnet werden soll
+        //! Draws the border
+        //! \param zRObj The image to draw the border into
         DLLEXPORT void render(Bild& zRObj) override;
-        //! Kopiert den Rahmen, so dass er ohne auswirkungen auf das Original
-        //! veraendert werden kann
+        //! Copies the border so that it can be modified without affecting
+        //! the original
         DLLEXPORT Zeichnung* dublizieren() const override;
     };
 
     class Rahmen3D : public Rahmen
     {
     public:
-        //! Konstruktor
+        //! Constructor
         DLLEXPORT Rahmen3D();
-        //! Destruktor
+        //! Destructor
         DLLEXPORT virtual ~Rahmen3D();
-        //! Zeichnet den Rahmen
-        //! \param zRObj Das Bild, in den der Rahmen gezeichnet werden soll
+        //! Draws the border
+        //! \param zRObj The image to draw the border into
         DLLEXPORT void render(Bild& zRObj) override;
-        //! Kopiert den Rahmen, so dass er ohne auswirkungen auf das Original
-        //! veraendert werden kann
+        //! Copies the border so that it can be modified without affecting
+        //! the original
         DLLEXPORT Zeichnung* dublizieren() const override;
     };
 } // namespace Framework

Scroll.h

@@ -16,7 +16,7 @@ namespace Framework
         int scrollPos;
     };
 
-    //! Die Baseklasse vuer die Horizontale und Vertikale Scrollbar
+    //! The base class for horizontal and vertical scrollbars
     class ScrollBar : public virtual ReferenceCounter
     {
     protected:
@@ -31,115 +31,113 @@ namespace Framework
         bool rend;
 
     public:
-        //! Konstruktor
+        //! Constructor
         DLLEXPORT ScrollBar();
-        //! Destruktor
+        //! Destructor
         DLLEXPORT virtual ~ScrollBar();
-        //! Setzt die Fordergrundfarbe der Scrollbar
-        //! \param fc Die Farbe in A8R8G8B8 Format
+        //! Sets the foreground color of the scrollbar
+        //! \param fc The color in A8R8G8B8 format
         DLLEXPORT void setFarbe(int fc);
-        //! Setzt die Hintergrundfarbe der Scrollbar
-        //! \param fc Die Farbe in A8R8G8B8 Format
-        //! \param bgF 1, fals ein Hintergrund gezeichnet werden soll
+        //! Sets the background color of the scrollbar
+        //! \param fc The color in A8R8G8B8 format
+        //! \param bgF 1 if a background should be drawn
         DLLEXPORT void setBgFarbe(int fc, bool bgF);
-        //! Aktualisiert die Scrollbar
-        //! \param maxGr Die Maximale Groesse des Fensters in Pixeln
-        //! \param anzeigeGr Die angezeigte Groesse des Fensters in Pixeln
+        //! Updates the scrollbar
+        //! \param maxGr The maximum size of the window in pixels
+        //! \param anzeigeGr The displayed size of the window in pixels
         DLLEXPORT void update(int maxGr, int anzeigeGr);
-        //! Setzt die Scroll geschwindigkeit
-        //! \param klickScroll Die anzahl an Pixeln, die pro Klick gescrollt
-        //! werden
+        //! Sets the scroll speed
+        //! \param klickScroll The number of pixels scrolled per click
         DLLEXPORT void setKlickScroll(int klickScroll);
-        //! Scrollt zu einer bestimmten Position
-        //! \param pos Die Position in Pixeln im Fenster, ab der gezeichnet
-        //! werden soll
+        //! Scrolls to a specific position
+        //! \param pos The position in pixels in the window from which drawing
+        //! should start
         DLLEXPORT void scroll(int pos);
-        //! Verarbeitet ein Maus Ereignis
-        //! \param x Die X Position der Scroll Bar im Fenster
-        //! \param y Die Y Position der Scroll Bar im Fenster
-        //! \param br Die Breite der Scroll Bar
-        //! \param hi Die Hoehe der Scroll Bar
-        //! \return 1, falls die Nachricht verarbeitet wurde. Setzt dafuer nicht
-        //! den verarbeitet flag des Maus Ereignisses
+        //! Processes a mouse event
+        //! \param x The X position of the scroll bar in the window
+        //! \param y The Y position of the scroll bar in the window
+        //! \param br The width of the scroll bar
+        //! \param hi The height of the scroll bar
+        //! \return 1 if the message was processed. Does not set the
+        //! processed flag of the mouse event
         DLLEXPORT virtual bool doMausMessage(
             int x, int y, int br, int hi, MausEreignis& me)
             = 0;
-        //! Gibt zurueck, ob sich die Scrollbar seit dem letzten Aufruf der
-        //! Funktion veraendert hat
+        //! Returns whether the scrollbar has changed since the last call of
+        //! this function
         DLLEXPORT bool getRend();
-        //! Zeichnet die Scrollbar
-        //! \param x Die X Position der Scroll Bar
-        //! \param y Die Y Position der Scroll Bar
-        //! \param br Die Breite der Scroll Bar
-        //! \param hi Die Hoehe der Scroll Bar
-        //! \param zRObj Das Bild, in das gezeichnet werden soll
+        //! Draws the scrollbar
+        //! \param x The X position of the scroll bar
+        //! \param y The Y position of the scroll bar
+        //! \param br The width of the scroll bar
+        //! \param hi The height of the scroll bar
+        //! \param zRObj The image to draw into
         DLLEXPORT virtual void render(
             int x, int y, int br, int hi, Bild& zRObj) const = 0;
-        //! Gibt einen zeiger auf die Scroll Daten zurueck
+        //! Returns a pointer to the scroll data
         DLLEXPORT ScrollData* getScrollData() const;
-        //! Gibt die Scroll geschwindigkeit zurueck. Die Anzahl der gescrollten
-        //! Pixel pro Klick
+        //! Returns the scroll speed. The number of pixels scrolled per click
         DLLEXPORT int getKlickScroll() const;
-        //! Gibt die Fordergrundfarbe der Scrollbar zurueck
+        //! Returns the foreground color of the scrollbar
         DLLEXPORT int getFarbe() const;
-        //! Gibt die Hintergrundfarbe der Scrollbar zurueck
+        //! Returns the background color of the scrollbar
         DLLEXPORT int getBgFarbe() const;
-        //! Gibt die aktuelle Scroll Position zurueck
+        //! Returns the current scroll position
         DLLEXPORT int getScroll() const;
     };
 
-    //! Eine vertikale Scrollbar, wie sie in manchen 2D GUI Zeichnungen des
-    //! Frameworks verwendet wird
+    //! A vertical scrollbar, as used in some 2D GUI drawings of the
+    //! framework
     class VScrollBar : public ScrollBar
     {
     public:
-        //! Konstruktor
+        //! Constructor
         DLLEXPORT VScrollBar();
-        //! Destruktor
+        //! Destructor
         DLLEXPORT virtual ~VScrollBar();
-        //! Verarbeitet ein Maus Ereignis
-        //! \param x Die X Position der Scroll Bar im Fenster
-        //! \param y Die Y Position der Scroll Bar im Fenster
-        //! \param br Die Breite der Scroll Bar
-        //! \param hi Die Hoehe der Scroll Bar
-        //! \return 1, falls die Nachricht verarbeitet wurde. Setzt dafuer nicht
-        //! den verarbeitet flag des Maus Ereignisses
+        //! Processes a mouse event
+        //! \param x The X position of the scroll bar in the window
+        //! \param y The Y position of the scroll bar in the window
+        //! \param br The width of the scroll bar
+        //! \param hi The height of the scroll bar
+        //! \return 1 if the message was processed. Does not set the
+        //! processed flag of the mouse event
         DLLEXPORT bool doMausMessage(
             int x, int y, int br, int hi, MausEreignis& me) override;
-        //! Zeichnet die Scrollbar
-        //! \param x Die X Position der Scroll Bar
-        //! \param y Die Y Position der Scroll Bar
-        //! \param br Die Breite der Scroll Bar
-        //! \param hi Die Hoehe der Scroll Bar
-        //! \param zRObj Das Bild, in das gezeichnet werden soll
+        //! Draws the scrollbar
+        //! \param x The X position of the scroll bar
+        //! \param y The Y position of the scroll bar
+        //! \param br The width of the scroll bar
+        //! \param hi The height of the scroll bar
+        //! \param zRObj The image to draw into
         DLLEXPORT void render(
             int x, int y, int br, int hi, Bild& zRObj) const override;
     };
 
-    //! Eine horizontale Scrollbar, wie sie in manchen 2D GUI Zeichnungen des
-    //! Frameworks verwendet wird
+    //! A horizontal scrollbar, as used in some 2D GUI drawings of the
+    //! framework
     class HScrollBar : public ScrollBar
     {
     public:
-        //! Konstruktor
+        //! Constructor
         DLLEXPORT HScrollBar();
-        //! Destruktor
+        //! Destructor
         DLLEXPORT virtual ~HScrollBar();
-        //! Verarbeitet ein Maus Ereignis
-        //! \param x Die X Position der Scroll Bar im Fenster
-        //! \param y Die Y Position der Scroll Bar im Fenster
-        //! \param br Die Breite der Scroll Bar
-        //! \param hi Die Hoehe der Scroll Bar
-        //! \return 1, falls die Nachricht verarbeitet wurde. Setzt dafuer nicht
-        //! den verarbeitet flag des Maus Ereignisses
+        //! Processes a mouse event
+        //! \param x The X position of the scroll bar in the window
+        //! \param y The Y position of the scroll bar in the window
+        //! \param br The width of the scroll bar
+        //! \param hi The height of the scroll bar
+        //! \return 1 if the message was processed. Does not set the
+        //! processed flag of the mouse event
         DLLEXPORT bool doMausMessage(
             int x, int y, int br, int hi, MausEreignis& me) override;
-        //! Zeichnet die Scrollbar
-        //! \param x Die X Position der Scroll Bar
-        //! \param y Die Y Position der Scroll Bar
-        //! \param br Die Breite der Scroll Bar
-        //! \param hi Die Hoehe der Scroll Bar
-        //! \param zRObj Das Bild, in das gezeichnet werden soll
+        //! Draws the scrollbar
+        //! \param x The X position of the scroll bar
+        //! \param y The Y position of the scroll bar
+        //! \param br The width of the scroll bar
+        //! \param hi The height of the scroll bar
+        //! \param zRObj The image to draw into
         DLLEXPORT void render(
             int x, int y, int br, int hi, Bild& zRObj) const override;
     };

Zeichnung.h

@@ -110,15 +110,14 @@ namespace Framework
         //! Sets the parameter passed to the callback function on a mouse event
         //! \param p The parameter
         DLLEXPORT void setMausEreignisParameter(void* p);
-        //! Setzt den Parameter, der bei einem Tastatur Ereignis an die
-        //! Rueckruffunktion uebergeben wird \param p Der Parameter
+        //! Sets the parameter passed to the callback function on a keyboard event
+        //! \param p The parameter
         DLLEXPORT void setTastaturEreignisParameter(void* p);
-        //! Setzt die Rueckruffunktion, die bei einem Maus Ereignis aufgerufen
-        //! werden soll. Wenn die Rueckruffunktion 0 zurueckgiebt, oder nicht
-        //! gesetzt wurde, wird ein Maus Ereignis von der Zeichnung nicht weiter
-        //! beachtet Es kann die Standartfunktion __ret1ME verwendet werden, die
-        //! in MausEreignis.h and always returns 1 \param ak A pointer to
-        //! the callback function
+        //! Sets the callback function to be called on a mouse event.
+        //! If the callback returns 0, or was not set, the mouse event
+        //! is not further processed by the drawing. The standard function
+        //! __ret1ME can be used, which is defined in MausEreignis.h and always
+        //! returns 1 \param ak A pointer to the callback function
         DLLEXPORT void setMausEreignis(MausAktion ak);
         //! Adds a callback function to be called on a mouse event.
         //! If any callback returns 0, or none was set, the mouse event
@@ -239,14 +238,14 @@ namespace Framework
         DLLEXPORT int getX() const;
         //! Returns the Y position of the drawing in pixels
         DLLEXPORT int getY() const;
-        //! Prueft, ob ein Punkt in diesem Objekt liegt
-        //! \param p der Punkt
-        //! \return 1, wenn der punkt innen ist, 0 sonst
+        //! Checks whether a point is inside this object
+        //! \param p The point
+        //! \return 1 if the point is inside, 0 otherwise
         DLLEXPORT virtual bool istPunktInnen(Punkt p) const;
-        //! Prueft, ob ein Punkt in diesem Objekt liegt
-        //! \param x die x koordinate des punktes
-        //! \param y die y koordinate des punktes
-        //! \return 1, wenn der punkt innen ist, 0 sonst
+        //! Checks whether a point is inside this object
+        //! \param x The x coordinate of the point
+        //! \param y The y coordinate of the point
+        //! \return 1 if the point is inside, 0 otherwise
         DLLEXPORT virtual bool istPunktInnen(int x, int y) const;
         //! Returns a pointer to the tooltip object, if it is used
         DLLEXPORT ToolTip* getToolTip() const;
@@ -329,13 +328,13 @@ namespace Framework
         //! Sets a pointer to the AlphaFeld (requires drawing flag:
         //! Style::Buffered) \param buff The AlphaFeld to draw over the background
         DLLEXPORT void setAlphaFeldZ(AlphaFeld* buff);
-        //! Setzt die Staerke des AlphaFeldes (benoetigt Flag zum Zeichnen:
-        //! Style::Buffered) \param st Die Staerke des AlphaFeldes, welches ueber
-        //! dem Hintergrund gezeichnet werden soll
+        //! Sets the strength of the AlphaFeld (requires drawing flag:
+        //! Style::Buffered) \param st The strength of the AlphaFeld drawn
+        //! over the background
         DLLEXPORT void setAlphaFeldStrength(int st);
-        //! Setzt die Farbe des AlphaFeldes (benoetigt Flag zum Zeichnen:
-        //! Style::Buffered) \param fc Die Farbe des AlphaFeldes, welches ueber
-        //! dem Hintergrund gezeichnet werden soll
+        //! Sets the color of the AlphaFeld (requires drawing flag:
+        //! Style::Buffered) \param fc The color of the AlphaFeld drawn
+        //! over the background
         DLLEXPORT void setAlphaFeldFarbe(int fc);
         //! Sets a pointer to the line border drawn around the text field
         //! (requires drawing flag: Style::Rahmen)