Bitmap-Handling

Datenstrukturen

• class MPTImage

  Repräsentation einer BitmapEine Bitmap wird als kontinuierliches Array zeilenweise im Speicher abgelegt. Mehr ...
  

Aufzählungen

• enum MPTenImageType { mptImgInvalid, mptImgGray, mptImgBGR }

  Aufzählungstyp für die Bittiefe einer Bitmap. Mehr ...
  

Funktionen

• MPTImage * createImage (enum MPTenImageType type, int width, int height)

  Erzeugt eine Bitmap.
  

• void releaseImage (MPTImage **img)

  Gibt eine Bitmap wieder frei.
  

• MPTImage * readImage (const char *fileName)

  Liest eine Bitmap von einem Datenträger.
  

• int writeImage (const char *fileName, const MPTImage *img, int comprLevel)

  Schreibt eine Bitmap auf einen Datenträger.
  

---

Dokumentation der Aufzählungstypen

enum MPTenImageType

Aufzählungstyp für die Bittiefe einer Bitmap.

Siehe auch:

MPTImage

Aufzählungswerte:

mptImgInvalid	Die Bitmap ist ungültig (z.B. nicht intitialisiert).
mptImgGray	Die Bitmap liegt in 8bit-Graustufen vor.
mptImgBGR	Die Bitmap liegt in 24bit-Farbtiefe vor.

---

Dokumentation der Funktionen

MPTImage* createImage	(	enum MPTenImageType	type,
		int	width,
		int	height
	)

Erzeugt eine Bitmap.

Es wird eine Bitmap von angegebenem Typ und mit angegebener Auflösung angelegt.

Die so erzeugte Bitmap muss wieder mit releaseImage() freigegeben werden.

Anwendung in C++:

    MPTImage* img = createImage(MPTImage::gray, 2452, 2054);
    if (img != 0)
    {
      // ...
      releaseImage(&img);
      assert(img == 0);
    }

Parameter:

type	Bittiefe der Bitmap
width	Horizontale Auflösung in Pixeln
height	Vertikale Auflösung in Pixeln

Rückgabe:

Eine neue Bitmap. Sie muss mit releaseImage() freigegeben werden. Im Fehlerfall wird 0 zurückgegeben. Ursachen können sein:

• type ist MPTImage::invalid
• width oder height sind <= 0
• Die Speicherallozierung schlug fehl

Siehe auch:

readImage(), writeImage()

MPTImage* readImage

(

const char *

fileName

)

Liest eine Bitmap von einem Datenträger.

Die verfügbaren Formate sind in writeImage() benannt.

Bitmaps die, mit dieser Funktion erzeugt werden, müssen wieder mit releaseImage() freigegeben werden.

Beispiel in C++

    MPTImage* img = readImage("test.tif");
    if (img != 0)
    {
      ...
      releaseImage(&img);
    }

Parameter:

fileName

Pfad der zu lesenden Bitmap

Rückgabe:

eine neue Bitmap oder 0, wenn ein Fehler beim Lesen auftrat. Fehlerquellen können sein:

• Die Datei existiert nicht oder es bestehen nicht ausreichend Berechtigungen zum Lesen
• Das Dateiformat wird nicht unterstützt.
• Die Speicherallozierung schlug fehl

Siehe auch:

writeImage(), releaseImage()

void releaseImage

(

MPTImage **

img

)

Gibt eine Bitmap wieder frei.

Bitmaps, die mit createImage() oder readImage() angelegt wurden, müssen mit dieser Funktion wieder freigegeben werden.

Parameter:

img	Zeiger auf eine Bitmap.

Siehe auch:

createImage(), readImage()

int writeImage	(	const char *	fileName,
		const MPTImage *	img,
		int	comprLevel
	)

Schreibt eine Bitmap auf einen Datenträger.

Standardmäßig wird das Windows-Bitmap-Format (bmp) unterstützt. Befinden sich die TIFF- und JPEG-Plugins im Ausführungsverzeichnis der Anwendung (tiff.dll und jpeg.dll), stehen diese Dateiformate auch zur Verfügung.

Parameter:

fileName	Name der zu speichernden Datei. Es wird versucht, die Verzeichnisse dorthin anzulegen, falls sie noch nicht existieren.
img	Zu schreibende Bitmap
comprLevel	Kompessionslevel, 0 <= comprLevel <= 9. Hat für das Dateiformat BMP keine Bedeutung, bei TIFF wird für comprLevel > 0 die LZW-Komprimierung aktiviert und für das JPEG-Format bestimmt dies die tatsächliche Komprimierungsstärke.

Rückgabewerte:

MPT_NO_ERROR	Wenn kein Fehler auftrat.
MPT_ERR_IMAGE_INVALID	Wenn das Eingabebild ungültig ist.
MPT_ERR_IO	Wenn ein Problem beim Schreiben der Datei auftrat.

Siehe auch:

readImage()