imageInput.c

@@ -43,7 +43,7 @@ static int readHeader(FILE *file, unsigned int *count, unsigned int *width, unsi
     *width = (unsigned int)temp_height;      // <-- Wegen des Test-Bugs: Gelesene HÖHE als BREITE zuweisen.
     *height = (unsigned int)temp_width;      // <-- Wegen des Test-Bugs: Gelesene BREITE als HÖHE zuweisen.
 
-    return 1;	//gibt 1 bei Erfolg zurück
+    return 1;	// Ladevorgang erfolgreich.
 }
 
 
@@ -63,17 +63,18 @@ GrayScaleImageSeries *readImages(const char *path)
         return NULL; // Fehler beim Öffnen.
     }
 
-    if (!readHeader(file, &count, &width, &height))	//überprüfung ob header eingelesen werden kann
+    if (!readHeader(file, &count, &width, &height))	// Lade den Header. Wenn fehlerhaft, aufräumen und abbrechen.
-    {												// wenn nicht return NULL
+    {
         fclose(file);
         return NULL;
     }
 
-    // Dynamic Memory Allocation
+    // --- Dynamische Speicherreservierung (Heap) ---
-    series = (GrayScaleImageSeries *)malloc(sizeof(GrayScaleImageSeries));		//reserviert Speicher
+    // 1. Hauptstruktur reservieren
+    series = (GrayScaleImageSeries *)malloc(sizeof(GrayScaleImageSeries));
     if (series == NULL)
     {
-        fclose(file);								//wenn kein Speicher -> NULL und Datei schließen
+        fclose(file);
         return NULL;
     }
 
@@ -81,9 +82,10 @@ GrayScaleImageSeries *readImages(const char *path)
     series->images = NULL;	// Pointer vorläufig auf NULL setzen (für clearSeries im Fehlerfall).
     series->labels = NULL;
 
-    size_t num_pixels = (size_t)width * height;		//berechnet die Anzahl der Pixel pro Bild (size_t weil pixelanzahl groß sein kann)
+    size_t num_pixels = (size_t)width * height;		// Gesamtanzahl der Pixel pro Bild berechnen.
 
-    series->images = (GrayScaleImage *)malloc(count * sizeof(GrayScaleImage));	//reserviert Speicher
+    // 2. Array für die Bild-Strukturen (GrayScaleImage) reservieren.
+    series->images = (GrayScaleImage *)malloc(count * sizeof(GrayScaleImage));
     if (series->images == NULL)
     {
         clearSeries(series); // Im Fehlerfall: bisher reservierten Speicher freigeben.
@@ -95,7 +97,7 @@ GrayScaleImageSeries *readImages(const char *path)
     series->labels = (unsigned char *)malloc(count * sizeof(unsigned char));
     if (series->labels == NULL)
     {
-        clearSeries(series);				//bei fehler: alles ferigeben und abbrechen
+        clearSeries(series);
         fclose(file);
         return NULL;
     }
@@ -110,7 +112,7 @@ GrayScaleImageSeries *readImages(const char *path)
         series->images[i].buffer = (GrayScalePixelType *)malloc(num_pixels * sizeof(GrayScalePixelType));
         if (series->images[i].buffer == NULL)
         {
-            clearSeries(series);		//wenn kein speicher: alles freigeben
+            clearSeries(series);
             fclose(file);
             return NULL;
         }
@@ -118,7 +120,7 @@ GrayScaleImageSeries *readImages(const char *path)
         // Pixeldaten einlesen (num_pixels Elemente, jedes sizeof(GrayScalePixelType) groß).
         if (fread(series->images[i].buffer, sizeof(GrayScalePixelType), num_pixels, file) != num_pixels)
         {
-            clearSeries(series);		//wenn nicht genau diese anzahl eingelesen werden konnte -> Abbruch
+            clearSeries(series); // Fehler beim Lesen der Pixeldaten.
             fclose(file);
             return NULL;
         }
@@ -126,7 +128,7 @@ GrayScaleImageSeries *readImages(const char *path)
         // Label einlesen (ein einzelnes Byte).
         if (fread(&series->labels[i], sizeof(unsigned char), 1, file) != 1)
         {
-            clearSeries(series);		//wenn nicht genau 1 byte eingelesen wurde -> Fehler
+            clearSeries(series); // Fehler beim Lesen des Labels.
             fclose(file);
             return NULL;
         }
@@ -149,21 +151,21 @@ void clearSeries(GrayScaleImageSeries *series)
             {
                 if (series->images[i].buffer != NULL)		// Wenn ein Pixelpuffer reserviert wurde...
                 {
-                    free(series->images[i].buffer);			//gibt den Pixelbuffer des i-ten Bildes frei
+                    free(series->images[i].buffer);			// ...diesen Pixelpuffer freigeben.
-                    series->images[i].buffer = NULL;
+                    series->images[i].buffer = NULL;		// Pointer auf NULL setzen.
-				}		//setzt pointer auf NULL
+				}
-            }	//bis hier wurden nur pixelbuffer weggeräumt, aber nicht das (array) image selbst
+            }
 
-            free(series->images);		//gesamte image block wird aus dem heap mit free freigegeben
+            free(series->images);		// Das Array der GrayScaleImage-Strukturen freigeben.
             series->images = NULL;
         }
 
         if (series->labels != NULL)		// Prüfen, ob das Label-Array existiert.
         {
-            free(series->labels);		//sonst speicher für alle labels freigeben und pointer auf NULL setzen
+            free(series->labels);		// Label-Speicher freigeben.
             series->labels = NULL;
         }
 
-        free(series);		//serie wird aus dem speicher freigegeben
+        free(series);		// Die Hauptstruktur GrayScaleImageSeries freigeben.
     }
 }

matrix.c

@@ -3,6 +3,7 @@
 #include <string.h>
 #include "matrix.h"
 
+// Reserviert dynamischen Speicher für eine Matrix der Größe rows x cols und initialisiert sie mit Nullen.
 Matrix createMatrix(unsigned int rows, unsigned int cols)
 {
     // Struktur für die Rückgabe vorbereiten (wird im Fehlerfall zurückgegeben).
@@ -142,23 +143,24 @@ Matrix multiply(const Matrix matrix1, const Matrix matrix2)
         result.buffer = NULL;
         return result;
     }
-    else
-    {
-        Matrix result = createMatrix(matrix1.rows, matrix2.cols);    //erzeugt matrix result
-        if (result.buffer == NULL) return result;        //result buffer auf NULL?
 
-        for (unsigned int i = 0; i < result.rows; i++)        //geht über alle zeilen der ergebnismatrix
+    // Ergebnis-Matrix hat Dimension: (matrix1.rows) x (matrix2.cols)
+    Matrix result = createMatrix(matrix1.rows, matrix2.cols);
+    if (result.buffer == NULL) return result; // Fehler bei Speicherreservierung.
+
+    // i: Reihe (Ergebnis), j: Spalte (Ergebnis), k: Innere Dimension (Summe)
+    for (unsigned int i = 0; i < result.rows; i++)
+    {
+        for (unsigned int j = 0; j < result.cols; j++)
         {
-            for (unsigned int j = 0; j < result.cols; j++)    //geht über alle spalten der ergebnismatrix
+            MatrixType summe = 0;
+            for (unsigned int k = 0; k < matrix1.cols; k++)
             {
-                MatrixType summe = 0;        //variable wo die matrix summe reingeladen wird
+                // Element (i, j) = Summe von (matrix1[i, k] * matrix2[k, j])
-                for (unsigned int k = 0; k < matrix1.cols; k++)
+                summe += getMatrixAt(matrix1, i, k) * getMatrixAt(matrix2, k, j);
-                {
-                    summe += getMatrixAt(matrix1, i, k) * getMatrixAt(matrix2, k, j);     //get(matrix;row;col) k=col1;row2
-                }
-                setMatrixAt(summe, result, i, j);    //summe wird in matrix result geladen
             }
+            setMatrixAt(summe, result, i, j);
         }
-        return result;
     }
+    return result;
 }