PPL6-Icon Patrick's Programming Library Version 6.4.21 - Dokumentation
ppl6::grafix::CImageList Klassenreferenz

Ein Container für eine Grafik mit mehreren gleichgroßen Icons. Mehr ...

Öffentliche Typen

enum  DRAWMETHOD { BLT =1, COLORKEY, ALPHABLT, DIFFUSE }
 

Öffentliche Methoden

 CImageList ()
 
 CImageList (const CImageList &other)
 
 CImageList (const CDrawable &draw, int icon_width, int icon_height, DRAWMETHOD method)
 
 CImageList (const CString &Filename, int icon_width, int icon_height, DRAWMETHOD method)
 
 CImageList (CFileObject &file, int icon_width, int icon_height, DRAWMETHOD method)
 
 CImageList (const CMemoryReference &mem, int icon_width, int icon_height, DRAWMETHOD method)
 
 ~CImageList ()
 
void clear ()
 
Color colorKey () const
 
int copy (const CImageList &other)
 
Color diffuseColor () const
 
DRAWMETHOD drawMethod () const
 
CDrawable getDrawable (int nr) const
 
Rect getRect (int nr) const
 
Size iconSize () const
 
int load (const CDrawable &draw, int icon_width, int icon_height, DRAWMETHOD method)
 
int load (const CString &Filename, int icon_width, int icon_height, DRAWMETHOD method)
 
int load (CFileObject &file, int icon_width, int icon_height, DRAWMETHOD method)
 
int load (const CMemoryReference &mem, int icon_width, int icon_height, DRAWMETHOD method)
 
int num () const
 
CImageListoperator= (const CImageList &other)
 
void setColorKey (const Color &key)
 
void setDiffuseColor (const Color &c)
 
void setDrawMethod (DRAWMETHOD method)
 
void setIconSize (int width, int height)
 
Verschiedenes
int create (int width, int height, const RGBFormat &format)
 Neues CImage erstellen. Mehr ...
 
int create (void *base, ppluint32 pitch, int width, int height, const RGBFormat &format)
 Neues CImage aus einem Speicherbereich erstellen. Mehr ...
 
int load (const CString &Filename, const RGBFormat &format=RGBFormat::unknown)
 Grafik aus einer Datei laden. Mehr ...
 
int load (CFileObject &file, const RGBFormat &format=RGBFormat::unknown)
 Grafik aus einer geöffneten Datei laden. Mehr ...
 
int load (const CMemoryReference &Mem, const RGBFormat &format=RGBFormat::unknown)
 Grafik aus einem Speicherbereich laden. Mehr ...
 
int copy (const CDrawable &other)
 Grafik von einem CDrawable kopieren. Mehr ...
 
int copy (const CDrawable &other, const Rect &rect)
 Grafikausschnitt von einem CDrawable kopieren. Mehr ...
 
int copy (const CImage &other)
 Grafik kopieren. Mehr ...
 
size_t numBytes () const
 Anzahl Bytes, die durch diese Grafik belegt sind. Mehr ...
 
CMemoryReference memory () const
 Referenz auf den Speicherbereich der Grafik holen. Mehr ...
 
 operator CMemoryReference () const
 Referenz auf den Speicherbereich der Grafik holen. Mehr ...
 
Verschiedenes
GRAFIX_FUNCTIONSgetFunctions ()
 Pointer auf die Grafik-Funktionen für das Farbformat dieses CDrawable holen. Mehr ...
 
DRAWABLE_DATAgetData ()
 Pointer auf die Datenstruktur des CDrawable holen. Mehr ...
 
Rect rect () const
 Rechteck des CDrawable auslesen. Mehr ...
 
Size size () const
 Größe des CDrawable auslesen. Mehr ...
 
int width () const
 Breite der Grafik in Pixel. Mehr ...
 
int height () const
 Höhe der Grafik in Pixel. Mehr ...
 
int pitch () const
 Bytes pro Zeile. Mehr ...
 
int bytesPerPixel () const
 Bytes pro Pixel. Mehr ...
 
int bitdepth () const
 Bittiefe der Grafik (Bits pro Pixel) Mehr ...
 
RGBFormat rgbformat () const
 Farbformat des CDrawable auslesen. Mehr ...
 
bool isEmpty () const
 Enthält dieses CDrawable eine Grafik? Mehr ...
 
void * adr () const
 Speicheradresse der Grafik. Mehr ...
 
void * adr (int x, int y) const
 Speicheradresse der angegebenen Koordinaten. Mehr ...
 
void cls (const Color &c)
 Grafik löschen. Mehr ...
 
void cls ()
 Grafik löschen. Mehr ...
 
CDrawable getDrawable () const
 Ein neues CDrawable erstellen. Mehr ...
 
CDrawable getDrawable (const Rect &rect) const
 Ein neues CDrawable anhand eines Ausschnitts erstellen. Mehr ...
 
CDrawable getDrawable (int x1, int y1, int x2, int y2) const
 Ein neues CDrawable anhand eines Ausschnitts erstellen. Mehr ...
 
Farben
SurfaceColor rgb (const Color &c) const
 Farbe in einen Farbformatspezifischen Wert umrechnen. Mehr ...
 
SurfaceColor rgb (int r, int g, int b, int alpha) const
 Farbe in einen Farbformatspezifischen Wert umrechnen. Mehr ...
 
Pixel
void putPixel (int x, int y, const Color &c)
 
void putPixel (const Point &p, const Color &c)
 
void alphaPixel (int x, int y, const Color &c)
 
void alphaPixel (const Point &p, const Color &c)
 
Color blendPixel (int x, int y, const Color &c, float brightness)
 
Color blendPixel (int x, int y, const Color &c, int brightness)
 
Color getPixel (int x, int y) const
 
Color getPixel (const Point &p) const
 
Geometrische Formen
void drawRect (const Rect &rect, const Color &c)
 Rechteck zeichnen. Mehr ...
 
void drawRect (int x1, int y1, int x2, int y2, const Color &c)
 Rechteck zeichnen. Mehr ...
 
void fillRect (const Rect &rect, const Color &c)
 Ausgefülltes Rechteck zeichnen. Mehr ...
 
void fillRect (int x1, int y1, int x2, int y2, const Color &c)
 Ausgefülltes Rechteck zeichnen. Mehr ...
 
void floodFill (int x, int y, const Color &color, const Color &border)
 Fläche mit Farbe füllen. Mehr ...
 
void elipse (int x, int y, int radx, int rady, const Color &c, bool fill=false)
 
void elipse (int x, int y, int radx, int rady, const Color &c, bool fill, const Color &fillcolor, int startangle, int endangle)
 
void circle (int x, int y, int rad, const Color &c, bool fill=false)
 
Effekte
void xchange (const Rect &rect, const Color &color, const Color &replace)
 Farben ersetzen. Mehr ...
 
void invert (const Rect &rect, const Color &color1, const Color &color2)
 Farben vertauschen. Mehr ...
 
void negativ (const Rect &rect)
 Negativ-Farben erstellen. Mehr ...
 
void colorGradient (const Rect &rect, const Color &c1, const Color &c2, int direction)
 
void colorGradient (int x1, int y1, int x2, int y2, const Color &c1, const Color &c2, int direction)
 
Linien zeichnen
void line (int x1, int y1, int x2, int y2, const Color &c)
 
void line (const Point &start, const Point &end, const Color &c)
 
void lineAA (int x1, int y1, int x2, int y2, const Color &c, int strength=1)
 
void lineAA (const Point &start, const Point &end, const Color &c, int strength=1)
 
Textausgabe
void print (const CFont &font, int x, int y, const CWString &text)
 Text ausgeben. Mehr ...
 
void printf (const CFont &font, int x, int y, const char *fmt,...)
 Formatierten Text ausgeben. Mehr ...
 
Blit-Funktionen

Kopieren von Grafiken mit verschiedenen Methoden

int fitRect (int &x, int &y, Rect &r)
 Überprüft, ob eine Blit-Aktion in den Zeichenbereich passt. Mehr ...
 
int blt (const CDrawable &source, int x=0, int y=0)
 Rechteck 1:1 kopieren. Mehr ...
 
int blt (const CDrawable &source, const Rect &srect, int x=0, int y=0)
 Rechteck 1:1 kopieren. Mehr ...
 
int bltDiffuse (const CDrawable &source, int x=0, int y=0, const Color &c=Color())
 Rechteck anhand der Intensität der Quellfarbe kopieren. Mehr ...
 
int bltDiffuse (const CDrawable &source, const Rect &srect, int x=0, int y=0, const Color &c=Color())
 Rechteck anhand der Intensität der Quellfarbe kopieren. Mehr ...
 
int bltColorKey (const CDrawable &source, int x=0, int y=0, const Color &c=Color())
 Rechteck unter Berücksichtigung einer transparenten Schlüsselfarbe kopieren. Mehr ...
 
int bltColorKey (const CDrawable &source, const Rect &srect, int x=0, int y=0, const Color &c=Color())
 Rechteck unter Berücksichtigung einer transparenten Schlüsselfarbe kopieren. Mehr ...
 
int bltAlpha (const CDrawable &source, int x=0, int y=0)
 Rechteck unter Berücksichtigung des Alpha-Kanals kopieren. Mehr ...
 
int bltAlpha (const CDrawable &source, const Rect &srect, int x=0, int y=0)
 Rechteck unter Berücksichtigung des Alpha-Kanals kopieren. Mehr ...
 
int draw (const CImageList &iml, int nr, int x, int y)
 Grafik aus einer Image-Liste kopieren. Mehr ...
 
int draw (const CImageList &iml, int nr, int x, int y, const Color &diffuse)
 Grafik aus einer Image-Liste kopieren. Mehr ...
 
int draw (const CSprite &sprite, int nr, int x, int y)
 

Private Attribute

Color colorkey
 
Color diffuse
 
int height
 
DRAWMETHOD method
 
int numIcons
 
int numX
 
int numY
 
int width
 

Freundbeziehungen

class CDrawable
 

Ausführliche Beschreibung

Rückgabe

Dokumentation der Aufzählungstypen

Aufzählungswerte
BLT 
COLORKEY 
ALPHABLT 
DIFFUSE 

Beschreibung der Konstruktoren und Destruktoren

ppl6::grafix::CImageList::CImageList ( )
ppl6::grafix::CImageList::CImageList ( const CImageList other)
ppl6::grafix::CImageList::CImageList ( const CDrawable draw,
int  icon_width,
int  icon_height,
DRAWMETHOD  method 
)
ppl6::grafix::CImageList::CImageList ( const CString Filename,
int  icon_width,
int  icon_height,
DRAWMETHOD  method 
)
ppl6::grafix::CImageList::CImageList ( CFileObject file,
int  icon_width,
int  icon_height,
DRAWMETHOD  method 
)
ppl6::grafix::CImageList::CImageList ( const CMemoryReference mem,
int  icon_width,
int  icon_height,
DRAWMETHOD  method 
)
ppl6::grafix::CImageList::~CImageList ( )

Dokumentation der Elementfunktionen

void * ppl6::grafix::CDrawable::adr ( ) const
inherited
Beschreibung:
Diese Funktion gibt die Speicheradresse zurück, an der die Daten dieser Grafik beginnen.
Rückgabe
Speicheradresse
void * ppl6::grafix::CDrawable::adr ( int  x,
int  y 
) const
inherited
Beschreibung:
Diese Funktion gibt die Speicheradresse zurück, an der sich die angegebenen Koordinaten x und y befinden.
Parameter
xX-Koordinate
yY-Koordinate
Rückgabe
Speicheradresse
void ppl6::grafix::CDrawable::alphaPixel ( int  x,
int  y,
const Color c 
)
inherited
void ppl6::grafix::CDrawable::alphaPixel ( const Point p,
const Color c 
)
inherited
int ppl6::grafix::CDrawable::bitdepth ( ) const
inherited
Beschreibung:
Diese Funktion liefert die Anzahl Bits pro Pixel für das verwendete Farbformat zurück.
Rückgabe
Bits pro Pixel
Color ppl6::grafix::CDrawable::blendPixel ( int  x,
int  y,
const Color c,
float  brightness 
)
inherited
Color ppl6::grafix::CDrawable::blendPixel ( int  x,
int  y,
const Color c,
int  brightness 
)
inherited
int ppl6::grafix::CDrawable::blt ( const CDrawable source,
int  x = 0,
int  y = 0 
)
inherited
Beschreibung:
Mit dieser Funktion wird die Quellzeichenfläche source an die Position x / y der Zielzeichenfläche kopiert, wobei alle Farbinformationen 1:1 übernommen werden. Es wird weder Alphablending (siehe CDrawable::bltAlpha) noch Colorkeying (siehe CDrawable::bltColorKey) verwendet. Falls die Quelle nicht in die Zielzeichenfläche passt, wird nur der passende Teil kopiert (siehe CDrawable::fitRect).
Parameter
[in]sourceDie Quellzeichenfläche
[in]xOptionale X-Koordinate der linken oberen Ecke in der Zielzeichenfläche. Wird der Parameter nicht angegeben, wird 0 verwendet.
[in]yOptionale Y-Koordinate der linken oberen Ecke in der Zielzeichenfläche. Wird der Parameter nicht angegebenm wird 0 verwendet.
Rückgabe
Bei Erfolg gibt die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CDrawable::blt ( const CDrawable source,
const Rect srect,
int  x = 0,
int  y = 0 
)
inherited
Beschreibung:
Mit dieser Funktion wird der Ausschnitt srect aus der Quellzeichenfläche source an die Position x / y kopiert, wobei alle Farbinformationen 1:1 übernommen werden. Es wird weder Alphablending (siehe CDrawable::bltAlpha) noch Colorkeying (siehe CDrawable::bltColorKey) verwendet. Falls srect 0 ist, wird die komplette Quellzeichenfläche kopiert, andernfalls nur der angegebene Ausschnitt. Falls die Quelle nicht in die Zielzeichenfläche passt, wird nur der passende Teil kopiert (siehe CDrawable::fitRect).
Parameter
[in]sourceDie Quellzeichenfläche
[in]srectRechteckiger Ausschnitt aus der Quellzeichenfläche, der kopiert werden soll
[in]xX-Koordinate der linken oberen Ecke in der Zielzeichenfläche
[in]yY-Koordinate der linken oberen Ecke in der Zielzeichenfläche
Rückgabe
Bei Erfolg gibt die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CDrawable::bltAlpha ( const CDrawable source,
int  x = 0,
int  y = 0 
)
inherited
Beschreibung:
Mit dieser Funktion wird die Quellzeichenfläche source an die Position x / y unter Berücksichtigung des Alphakanals der Quelle kopiert. Der Alphakanal bestimmt die Transparenz eines Pixels. Ist sie 0, wird der Pixel nicht kopiert, bei einem Wert von 255 wird er 1:1 kopiert. Dazwischen wird die Farbe abhängig vom Transparenz-Wert mit dem Hintergrund vermischt.
Falls die Quelle nicht in die Zielzeichenfläche passt, wird nur der passende Teil kopiert (siehe CDrawable::fitRect).
Parameter
[in]sourceDie Quellzeichenfläche
[in]xX-Koordinate der linken oberen Ecke in der Zielzeichenfläche
[in]yY-Koordinate der linken oberen Ecke in der Zielzeichenfläche
[in]cDie gewünschte Schlüsselfarbe (ColorKey)
Rückgabe
Bei Erfolg gibt die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CDrawable::bltAlpha ( const CDrawable source,
const Rect srect,
int  x = 0,
int  y = 0 
)
inherited
Beschreibung:
Mit dieser Funktion wird der Ausschnitt srect aus der Quellzeichenfläche source an die Position x / y unter Berücksichtigung des Alphakanals der Quelle kopiert. Der Alphakanal bestimmt die Transparenz eines Pixels. Ist sie 0, wird der Pixel nicht kopiert, bei einem Wert von 255 wird er 1:1 kopiert. Dazwischen wird die Farbe abhängig vom Transparenz-Wert mit dem Hintergrund vermischt.
Falls srect 0 ist, wird die komplette Quellzeichenfläche kopiert, andernfalls nur der angegebene Ausschnitt. Falls die Quelle nicht in die Zielzeichenfläche passt, wird nur der passende Teil kopiert (siehe CDrawable::fitRect).
Parameter
[in]sourceDie Quellzeichenfläche
[in]srectRechteckiger Ausschnitt aus der Quellzeichenfläche, der kopiert werden soll
[in]xX-Koordinate der linken oberen Ecke in der Zielzeichenfläche
[in]yY-Koordinate der linken oberen Ecke in der Zielzeichenfläche
[in]cDie gewünschte Schlüsselfarbe (ColorKey)
Rückgabe
Bei Erfolg gibt die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CDrawable::bltColorKey ( const CDrawable source,
int  x = 0,
int  y = 0,
const Color c = Color() 
)
inherited
Beschreibung:
Mit dieser Funktion wird die Quellzeichenfläche source an die Position x / y unter Berücksichtigung der Schlüsselfarbe c kopiert. Pixel, die der Farbe entsprechen, bleiben dabei vollständig transparent, alle anderen Pixel werden wie bei CDrawable::blt 1:1 kopiert.
Falls die Quelle nicht in die Zielzeichenfläche passt, wird nur der passende Teil kopiert (siehe CDrawable::fitRect).
Parameter
[in]sourceDie Quellzeichenfläche
[in]xX-Koordinate der linken oberen Ecke in der Zielzeichenfläche
[in]yY-Koordinate der linken oberen Ecke in der Zielzeichenfläche
[in]cDie gewünschte Schlüsselfarbe (ColorKey)
Rückgabe
Bei Erfolg gibt die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CDrawable::bltColorKey ( const CDrawable source,
const Rect srect,
int  x = 0,
int  y = 0,
const Color c = Color() 
)
inherited
Beschreibung:
Mit dieser Funktion wird der Ausschnitt srect aus der Quellzeichenfläche source an die Position x / y unter Berücksichtigung der Schlüsselfarbe c kopiert. Pixel, die der Farbe entsprechen, bleiben dabei vollständig transparent, alle anderen Pixel werden wie bei CDrawable::blt 1:1 kopiert.
Falls srect 0 ist, wird die komplette Quellzeichenfläche kopiert, andernfalls nur der angegebene Ausschnitt. Falls die Quelle nicht in die Zielzeichenfläche passt, wird nur der passende Teil kopiert (siehe CDrawable::fitRect).
Parameter
[in]sourceDie Quellzeichenfläche
[in]srectRechteckiger Ausschnitt aus der Quellzeichenfläche, der kopiert werden soll
[in]xX-Koordinate der linken oberen Ecke in der Zielzeichenfläche
[in]yY-Koordinate der linken oberen Ecke in der Zielzeichenfläche
[in]cDie gewünschte Schlüsselfarbe (ColorKey)
Rückgabe
Bei Erfolg gibt die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CDrawable::bltDiffuse ( const CDrawable source,
int  x = 0,
int  y = 0,
const Color c = Color() 
)
inherited
Beschreibung:
Mit dieser Funktion wird die Quellzeichenfläche source an die Position x / y kopiert, wobei die Intensität der Quellpixel geprüft wird und diese in gleicher Intensität mit der angegebenen Farbe gezeichnet werden. Bei halbtransparenten Pixeln wird die Farbe mit dem Hintergrund gemischt. Die Funktion ist daher zum Zeichnen von einfarbigen Grafiken unterschiedlicher Intensität gedacht (z.B. grafische Elemente einer GUI).
Falls die Quelle nicht in die Zielzeichenfläche passt, wird nur der passende Teil kopiert (siehe CDrawable::fitRect).
Parameter
[in]sourceDie Quellzeichenfläche
[in]xX-Koordinate der linken oberen Ecke in der Zielzeichenfläche
[in]yY-Koordinate der linken oberen Ecke in der Zielzeichenfläche
[in]cDie gewünschte Pixelfarbe
Rückgabe
Bei Erfolg gibt die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CDrawable::bltDiffuse ( const CDrawable source,
const Rect srect,
int  x = 0,
int  y = 0,
const Color c = Color() 
)
inherited
Beschreibung:
Mit dieser Funktion wird der Ausschnitt srect aus der Quellzeichenfläche source an die Position x / y kopiert, wobei die Intensität der Quellpixel geprüft wird und diese in gleicher Intensität mit der angegebenen Farbe gezeichnet werden. Bei halbtransparenten Pixeln wird die Farbe mit dem Hintergrund gemischt. Die Funktion ist daher zum Zeichnen von einfarbigen Grafiken unterschiedlicher Intensität gedacht (z.B. grafische Elemente einer GUI).
Falls srect 0 ist, wird die komplette Quellzeichenfläche kopiert, andernfalls nur der angegebene Ausschnitt. Falls die Quelle nicht in die Zielzeichenfläche passt, wird nur der passende Teil kopiert (siehe CDrawable::fitRect).
Parameter
[in]sourceDie Quellzeichenfläche
[in]srectRechteckiger Ausschnitt aus der Quellzeichenfläche, der kopiert werden soll
[in]xX-Koordinate der linken oberen Ecke in der Zielzeichenfläche
[in]yY-Koordinate der linken oberen Ecke in der Zielzeichenfläche
[in]cDie gewünschte Pixelfarbe
Rückgabe
Bei Erfolg gibt die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CDrawable::bytesPerPixel ( ) const
inherited
Beschreibung:
Mit dieser Funktion kann ausgelesen werden, wieviele Bytes ein einzelner Pixel benötigt.
Rückgabe
Bytes pro Pixel
void ppl6::grafix::CDrawable::circle ( int  x,
int  y,
int  rad,
const Color c,
bool  fill = false 
)
inherited
void ppl6::grafix::CImageList::clear ( )
void ppl6::grafix::CDrawable::cls ( const Color c)
inherited
Beschreibung:
Durch Aufruf dieser Funktion wird die komplette Grafik gelöscht und mit der Angegebenen Farbe gefüllt.
Parameter
[in]cFarbwert
void ppl6::grafix::CDrawable::cls ( )
inherited
Beschreibung:
Durch Aufruf dieser Funktion wird die komplette Grafik gelöscht, indem der Speicherbereich mit 0 beschrieben wird. Optional kann die Funktion auch mit einem Farbwert aufgerufen werden (siehe CDrawable::cls(const Color &c)).
void ppl6::grafix::CDrawable::colorGradient ( const Rect rect,
const Color c1,
const Color c2,
int  direction 
)
inherited
void ppl6::grafix::CDrawable::colorGradient ( int  x1,
int  y1,
int  x2,
int  y2,
const Color c1,
const Color c2,
int  direction 
)
inherited
Color ppl6::grafix::CImageList::colorKey ( ) const
int ppl6::grafix::CImage::copy ( const CDrawable other)
inherited
Beschreibung:
Grafik von einem anderen CDrawable kopieren.
Parameter
otherAnderes CDrawable
Rückgabe
Im Erfolgsfall gibt die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CImage::copy ( const CDrawable other,
const Rect rect 
)
inherited
Beschreibung:
Grafikausschnitt von einem anderen CDrawable kopieren.
Parameter
otherAnderes CDrawable
rectGewünschter Ausschnitt
Rückgabe
Im Erfolgsfall gibt die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CImage::copy ( const CImage other)
inherited
Beschreibung:
Grafik von einem anderen CImage kopieren.
Parameter
otherAnderes CImage
Rückgabe
Im Erfolgsfall gibt die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CImageList::copy ( const CImageList other)
int ppl6::grafix::CImage::create ( int  width,
int  height,
const RGBFormat format 
)
inherited
Beschreibung:
Mit dieser Funktion wird eine neue Grafik mit der Größe width * height und dem Farbformat format erstellt.
Parameter
widthBreite der Grafik
heightHöhe der Grafik
formatFarbformat der Grafik
Rückgabe
Bei Erfolg liefert die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CImage::create ( void *  base,
ppluint32  pitch,
int  width,
int  height,
const RGBFormat format 
)
inherited
Beschreibung:
Mit dieser Funktion wird eine neue Grafik anhand des angegebenen Speicherbereichs erstellt. Dabei wird zunächst eine neues CImage erstellt und die Bilddaten des angegebenen Speicherbereichs hineinkopiert.
Parameter
baseSpeicheradresse
pitchAnzahl Bytes pro Bildzeile
widthBreite der Grafik in Pixel
heightHöhe der Grafik in Pixel
formatFarbformat
Rückgabe
Im Erfolgsfall liefert die Funktion 1 zurück, im Fehlerfall 0.
Color ppl6::grafix::CImageList::diffuseColor ( ) const
int ppl6::grafix::CDrawable::draw ( const CImageList iml,
int  nr,
int  x,
int  y 
)
inherited
Beschreibung:
Mit dieser Funktion wird eine Grafik aus einer Image-Liste (siehe CImageList) kopiert. Jenachdem welche Zeichenmethode in der Image-Liste definiert ist, wird dazu entweder CDrawable::blt, CDrawable::bltDiffuse, CDrawable::bltColorKey oder CDrawable::bltAlpha verwendet.
Parameter
imlImage-Liste
nrNummer der Grafik innerhalb der Image-Liste
xX-Koordinate der Zielposition
yY-Koordinate der Zielposition
Rückgabe
Bei Erfolg gibt die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CDrawable::draw ( const CImageList iml,
int  nr,
int  x,
int  y,
const Color diffuse 
)
inherited
Beschreibung:
Mit dieser Funktion wird eine Grafik aus einer Image-Liste (siehe CImageList) kopiert. Jenachdem welche Zeichenmethode in der Image-Liste definiert ist, wird dazu entweder CDrawable::blt, CDrawable::bltDiffuse, CDrawable::bltColorKey oder CDrawable::bltAlpha verwendet. Ist die Methode CImageList::DIFFUSE, wird die Farbe diffuse statt der in der Image-Liste definierten Farbe verwendet.
Parameter
imlImage-Liste
nrNummer der Grafik innerhalb der Image-Liste
xX-Koordinate der Zielposition
yY-Koordinate der Zielposition
diffuseFarbwert, sofern die Diffuse Zeichenmethode verwendet wird. Bei allen anderen Zeichenmethoden wird der Parameter ignoriert.
Rückgabe
Bei Erfolg gibt die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CDrawable::draw ( const CSprite sprite,
int  nr,
int  x,
int  y 
)
inherited
CImageList::DRAWMETHOD ppl6::grafix::CImageList::drawMethod ( ) const
void ppl6::grafix::CDrawable::drawRect ( const Rect rect,
const Color c 
)
inherited
Beschreibung:
Diese Funktion zeichnet ein Rechteck an die gewünschte Position
Parameter
[in]rectKoordinaten des Rechtecks
[in]cFarbe des Rechtecks
void ppl6::grafix::CDrawable::drawRect ( int  x1,
int  y1,
int  x2,
int  y2,
const Color c 
)
inherited
Beschreibung:
Diese Funktion zeichnet ein Rechteck an die gewünschte Position
Parameter
[in]x1X-Koordinate der oberen linken Ecke
[in]y1Y-Koordinate der oberen linken Ecke
[in]x2X-Koordinate der unteren rechten Ecke
[in]y2Y-Koordinate der unteren rechten Ecke
[in]cFarbe des Rechtecks
void ppl6::grafix::CDrawable::elipse ( int  x,
int  y,
int  radx,
int  rady,
const Color c,
bool  fill = false 
)
inherited
void ppl6::grafix::CDrawable::elipse ( int  x,
int  y,
int  radx,
int  rady,
const Color c,
bool  fill,
const Color fillcolor,
int  startangle,
int  endangle 
)
inherited
void ppl6::grafix::CDrawable::fillRect ( const Rect rect,
const Color c 
)
inherited
Beschreibung:
Diese Funktion zeichnet ein ausgefülltes Rechteck in der Farbe c an die gewünschte Position
Parameter
[in]rectKoordinaten des Rechtecks
[in]cFarbe des Rechtecks
void ppl6::grafix::CDrawable::fillRect ( int  x1,
int  y1,
int  x2,
int  y2,
const Color c 
)
inherited
Beschreibung:
Diese Funktion zeichnet ein ausgefülltes Rechteck in der Farbe c an die gewünschte Position
Parameter
[in]x1X-Koordinate der oberen linken Ecke
[in]y1Y-Koordinate der oberen linken Ecke
[in]x2X-Koordinate der unteren rechten Ecke
[in]y2Y-Koordinate der unteren rechten Ecke
[in]cFarbe des Rechtecks
int ppl6::grafix::CDrawable::fitRect ( int &  x,
int &  y,
Rect r 
)
inherited
Beschreibung:
Diese Funktion prüft, ob das zu zeichnende Rechteck überhaupt in die aktuelle Zeichenfläche. Dabei wird das Quellrechteck bei Bedarf angepasst.
Parameter
[in,out]xX-Koordinate der Zielposition
[in,out]yY-Koordinate der Zielposition
[in,out]rQuell-Rechteck
Rückgabe
Die Funktion liefert 0 zurück, wenn das Rechteck komplett ausserhalb der Zeichenfläche liegt, oder 1, wenn es ganz oder zumindest teilweise innerhalb der Zeichenfläche liegt. In letzterem Fall werden die Koordinaten x, y und die Dimensionen des Rechtecks r so angepasst, dass durch die nachfolgende Blt-Funktion nur der sichtbare Bereich an die korrekte Position gezeichnet wird.
void ppl6::grafix::CDrawable::floodFill ( int  x,
int  y,
const Color color,
const Color border 
)
inherited
Beschreibung:
Mit dieser Funktion kann eine beliebig geformte Fläche mit einer Farbe ausgefüllt werden.
Parameter
[in]xX-Koordinate eines beliebigen Punktes innerhalb der zu füllenden Fläche
[in]yY-Koordinate eines beliebigen Punktes innerhalb der zu füllenden Fläche
[in]colorFarbwert, mit der die Fläche gefüllt werden soll
[in]borderFarbwert, der die Grenze der zu füllenden Fläche darstellt
Bemerkungen
Die Funktion ruft sich selbst mehrfach rekursiv auf. Der Code wurde im wesentlichen aus der freien GD-Library, Version 1.2 entnommen
Portions copyright 1994, 1995, 1996, 1997, 1998, by Cold Spring
Harbor Laboratory. Funded under Grant P41-RR02188 by the National
Institutes of Health.
Portions copyright 1996, 1997, 1998, by Boutell.Com, Inc.
DRAWABLE_DATA * ppl6::grafix::CDrawable::getData ( )
inherited
Beschreibung:
Diese Funktion liefert einen Pointer auf die Struktur DRAWABLE_DATA des CDrawable zurück. Diese enthält alle Informationen des CDrawable, wie den Speicherbereich der Grafik, Breite und Höhe, Bytes pro Zeile (pitch) und das Farbformat.
Rückgabe
Pointer auf die DRAWABLE_DATA Struktur des CDrawable.
CDrawable ppl6::grafix::CDrawable::getDrawable ( ) const
inherited
Beschreibung:
Diese Funktion liefert eine Kopie dieses CDrawable zurück.
Rückgabe
Kopie des CDrawable
CDrawable ppl6::grafix::CDrawable::getDrawable ( const Rect rect) const
inherited
Beschreibung:
Diese Funktion erstellt ein neues CDrawable Objekt anhand des angegebenen Ausschnitts rect.
Parameter
rectDer gewünschte Bildausschnitt
Rückgabe
Neues CDrawable, das den gewünschten Ausschnitt repräsentiert
CDrawable ppl6::grafix::CDrawable::getDrawable ( int  x1,
int  y1,
int  x2,
int  y2 
) const
inherited
Beschreibung:
Diese Funktion erstellt ein neues CDrawable Objekt anhand des angegebenen Koordinaten. Dabei ist zu beachten, dass der Ausschnitt inklusive der rechten unteren Ecke erstellt wird.
Parameter
x1X-Koordinate der linken oberen Ecke
y1Y-Koordinate der linken oberen Ecke
x2X-Koordinate der rechten unteren Ecke
y2Y-Koordinate der rechten unteren Ecke
Rückgabe
Neues CDrawable, das den gewünschten Ausschnitt repräsentiert
CDrawable ppl6::grafix::CImageList::getDrawable ( int  nr) const
GRAFIX_FUNCTIONS * ppl6::grafix::CDrawable::getFunctions ( )
inherited
Beschreibung:
Diese Funktion liefert einen Pointer auf die Grafik-Funktionen für das Farbformat dieses CDrawable zurück. Dieser kann NULL sein, wenn das CDrawable noch nicht initialisiert wurde oder das angegebene Farbformat nicht unterstützt wird.
Rückgabe
Pointer auf eine GRAFIX_FUNCTIONS Struktur oder NULL. Es wird kein Fehlercode gesetzt.
Color ppl6::grafix::CDrawable::getPixel ( int  x,
int  y 
) const
inherited
Color ppl6::grafix::CDrawable::getPixel ( const Point p) const
inherited
Rect ppl6::grafix::CImageList::getRect ( int  nr) const
int ppl6::grafix::CDrawable::height ( ) const
inherited
Beschreibung:
Diese Funktion liefert die Höhe der Grafik in Pixel zurück.
Rückgabe
Höhe in Pixel
Size ppl6::grafix::CImageList::iconSize ( ) const
void ppl6::grafix::CDrawable::invert ( const Rect rect,
const Color color1,
const Color color2 
)
inherited
Beschreibung:
Mit dieser Funktion werden sämtliche Pixel innerhalb eines Rechtecks, die der Farbe color1 entsprechen, durch color2 ersetzt, und alle Farben mit dem Farbwert color2 werden durch color1 ersetzt.
Parameter
[in]rectKoordinaten des Rechtecks
[in]color1Erste Farbe
[in]color2Zweite Farbe
bool ppl6::grafix::CDrawable::isEmpty ( ) const
inherited
Beschreibung:
Mit dieser Funktion kann geprüft werden, ob das CDrawable eine gültige und somit nutzbare Grafik enthält. Dies ist der Fall, wenn eine Basisadresse vorhanden ist, die Grafik eine Höhe und Breite größer 0 und ein gültiges Farbformat enthält.
Rückgabe
Liefert true zurück, wenn das CDrawable eine gültige Grafik enthält, andernfalls false.
void ppl6::grafix::CDrawable::line ( int  x1,
int  y1,
int  x2,
int  y2,
const Color c 
)
inherited
void ppl6::grafix::CDrawable::line ( const Point start,
const Point end,
const Color c 
)
inherited
void ppl6::grafix::CDrawable::lineAA ( int  x1,
int  y1,
int  x2,
int  y2,
const Color c,
int  strength = 1 
)
inherited
void ppl6::grafix::CDrawable::lineAA ( const Point start,
const Point end,
const Color c,
int  strength = 1 
)
inherited
int ppl6::grafix::CImage::load ( const CString Filename,
const RGBFormat format = RGBFormat::unknown 
)
inherited
Beschreibung:
Mit dieser Funktion wird eine Grafik aus einer Datei geladen.
Parameter
FilenameDer Dateiname
formatOptionales Farbformat. Falls nicht angegeben, wird das Farbformat der Grafikdatei verwendet. Andernfalls werden die Originalfarben der Grafikdatei in das angegebene Format konvertiert.
Rückgabe
Im Erfolgsfall liefert die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CImage::load ( CFileObject file,
const RGBFormat format = RGBFormat::unknown 
)
inherited
Beschreibung:
Mit dieser Funktion wird eine Grafik aus einer geöffneten Datei geladen.
Parameter
fileReferenz auf eine bereits geöffnete Datei.
formatOptionales Farbformat. Falls nicht angegeben, wird das Farbformat der Grafikdatei verwendet. Andernfalls werden die Originalfarben der Grafikdatei in das angegebene Format konvertiert.
Rückgabe
Im Erfolgsfall liefert die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CImage::load ( const CMemoryReference Mem,
const RGBFormat format = RGBFormat::unknown 
)
inherited
Beschreibung:
Mit dieser Funktion wird eine Grafik aus einem Speicherbereich geladen.
Parameter
MemReferenz auf einen Speicherbereich
formatOptionales Farbformat. Falls nicht angegeben, wird das Farbformat der Grafikdatei verwendet. Andernfalls werden die Originalfarben der Grafikdatei in das angegebene Format konvertiert.
Rückgabe
Im Erfolgsfall liefert die Funktion 1 zurück, im Fehlerfall 0.
int ppl6::grafix::CImageList::load ( const CDrawable draw,
int  icon_width,
int  icon_height,
DRAWMETHOD  method 
)
int ppl6::grafix::CImageList::load ( const CString Filename,
int  icon_width,
int  icon_height,
DRAWMETHOD  method 
)
int ppl6::grafix::CImageList::load ( CFileObject file,
int  icon_width,
int  icon_height,
DRAWMETHOD  method 
)
int ppl6::grafix::CImageList::load ( const CMemoryReference mem,
int  icon_width,
int  icon_height,
DRAWMETHOD  method 
)
CMemoryReference ppl6::grafix::CImage::memory ( ) const
inherited
Beschreibung:
Mit dieser Funktion kann eine Referenz des Speicherbereich der Grafik als CMemoryReference-Objekt geholt werden.
Rückgabe
CMemoryReference-Objekt mit referenz auf den Speicherbereich der Grafik
void ppl6::grafix::CDrawable::negativ ( const Rect rect)
inherited
Beschreibung:
Mit dieser Funktion werden sämtliche Pixel innerhalb eines Rechtecks durch ihren negativen Wert ersetzt.
Parameter
[in]rectKoordinaten des Rechtecks
int ppl6::grafix::CImageList::num ( ) const
size_t ppl6::grafix::CImage::numBytes ( ) const
inherited
Beschreibung:
Diese Funktion liefert die Anzahl Bytes zurück, die durch diese Grafik belegt sind.
Rückgabe
Anzahl Bytes
ppl6::grafix::CImage::operator CMemoryReference ( ) const
inherited
Beschreibung:
Mit dieser Funktion kann eine Referenz des Speicherbereich der Grafik als CMemoryReference-Objekt geholt werden.
Rückgabe
CMemoryReference-Objekt mit referenz auf den Speicherbereich der Grafik
CImageList & ppl6::grafix::CImageList::operator= ( const CImageList other)
int ppl6::grafix::CDrawable::pitch ( ) const
inherited
Beschreibung:
Mit dieser Funktion kann abgefragt werden, wieviele Bytes eine Grafikzeile benötigt. Dies muss nicht unbedingt das Ergebnis von Breite mal BytesProPixel sein, sondern kann auch mehr sein, z.B. wenn das CDrawable nur einen Ausschnitt aus einer größeren Grafik enthält.
Rückgabe
Bytes pro Grafikzeile
void ppl6::grafix::CDrawable::print ( const CFont font,
int  x,
int  y,
const CWString text 
)
inherited
Beschreibung:
Mit dieser Funktion wird der Text text auf der Grafik an den Koordinaten x und y unter Verwendeung des Fonts font ausgegeben.
Parameter
fontZu verwendende Font-Parameter
xX-Koordinate
yY-Koordinate
textDer auszugebende Text
void ppl6::grafix::CDrawable::printf ( const CFont font,
int  x,
int  y,
const char *  fmt,
  ... 
)
inherited
Beschreibung:
Mit dieser Funktion wird zunächst ein Text anhand des Formatstrings fmt erstellt und dann auf der Grafik an den Koordinaten x und y unter Verwendeung des Fonts font ausgegeben.
Parameter
fontZu verwendende Font-Parameter
xX-Koordinate
yY-Koordinate
fmtFormatstring
...optionale Parameter für den Formatstring
void ppl6::grafix::CDrawable::putPixel ( int  x,
int  y,
const Color c 
)
inherited
void ppl6::grafix::CDrawable::putPixel ( const Point p,
const Color c 
)
inherited
Rect ppl6::grafix::CDrawable::rect ( ) const
inherited
Beschreibung:
Dieser Funktion liefert das Rechteck des CDrawable zurück. Die Koordinaten des Rechtecks sind immer 0/0, Breite und Höhe sind die des CDrawable.
Rückgabe
Ein Objekt von Typ Rect.
SurfaceColor ppl6::grafix::CDrawable::rgb ( const Color c) const
inherited
Beschreibung:
Mit dieser Funktion wird eine farbformat unabhängige Farbe c in einen format spezifischen Wert umgerechnet.
Parameter
cFarbe
Rückgabe
Farbwert
SurfaceColor ppl6::grafix::CDrawable::rgb ( int  r,
int  g,
int  b,
int  alpha 
) const
inherited
Beschreibung:
Mit dieser Funktion wird eine farbformat unabhängige Farbe mit den Komponenten rot, grün, blau und Transparenz in einen format spezifischen Wert umgerechnet.
Parameter
rrot-Wert
ggrün-Wert
bblau-Wert
alphaTransparenz
Rückgabe
Farbwert
RGBFormat ppl6::grafix::CDrawable::rgbformat ( ) const
inherited
Beschreibung:
Diese Funktion liefert das Farbformat des CDrawable zurück.
Rückgabe
Farbformat
void ppl6::grafix::CImageList::setColorKey ( const Color key)
void ppl6::grafix::CImageList::setDiffuseColor ( const Color c)
void ppl6::grafix::CImageList::setDrawMethod ( DRAWMETHOD  method)
void ppl6::grafix::CImageList::setIconSize ( int  width,
int  height 
)
Size ppl6::grafix::CDrawable::size ( ) const
inherited
Beschreibung:
Diese Funktion liefert Breite und Höhe des CDrawable in einem Size-Objekt zurück.
Rückgabe
Objekt von Typ Size.
int ppl6::grafix::CDrawable::width ( ) const
inherited
Beschreibung:
Diese Funktion liefert die Breite der Grafik in Pixel zurück.
Rückgabe
Breite in Pixel
void ppl6::grafix::CDrawable::xchange ( const Rect rect,
const Color color,
const Color replace 
)
inherited
Beschreibung:
Mit dieser Funktion werden sämtliche Pixel innerhalb eines Rechtecks, die der Farbe color entsprechen, durch die Ersatzfarbe replace ersetzt
Parameter
[in]rectKoordinaten des Rechtecks
colorAlte Farbe
replaceNeu Farbe

Freundbeziehungen und Funktionsdokumentation

friend class CDrawable
friend

Dokumentation der Datenelemente

Color ppl6::grafix::CImageList::colorkey
private
Color ppl6::grafix::CImageList::diffuse
private
int ppl6::grafix::CImageList::height
private
DRAWMETHOD ppl6::grafix::CImageList::method
private
int ppl6::grafix::CImageList::numIcons
private
int ppl6::grafix::CImageList::numX
private
int ppl6::grafix::CImageList::numY
private
int ppl6::grafix::CImageList::width
private

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Dateien: