$\texttt{cargar\_pgm}(nombre)$

Nombre

cargar_pgm - Lee una imagen PGM binaria P5 y la devuelve como matriz.

Sinopsis

M = imagenes.cargar_pgm(nombre)

Descripcion

Lee un archivo PGM binario P5 y construye una MATRIZ M[alto][ancho] con intensidades entre 0 y maxval.

Soporta solo archivos con maxval <= 255, es decir, PGM de 8 bits por pixel.

Comportamiento

• Abre el archivo en modo binario de lectura.
• Verifica que el encabezado comience con la firma P5.
• Lee ancho, alto y maxval desde el header del archivo.
• Rechaza dimensiones invalidas y archivos con maxval > 255.
• Consume los espacios en blanco finales del header y luego carga los pixeles en una MATRIZ.
• Emite ERROR() si encuentra fin de archivo inesperado o si falla la apertura.

Funciones API relacionadas

• imagenes.guardar_pgm()

Parámetros

Valor de retorno

MATRIZ - Matriz M[alto][ancho] con las intensidades leidas del archivo.

Ejemplo

INCLUIR "matrices.api"
INCLUIR "imagenes.api"
INCLUIR "strings.api"


FUNCION PRINCIPAL
INICIO


    // --------------------------
    // Test convolucion_2d
    // --------------------------
    MATRIZ M[][]
    MATRIZ K2[3][3], C[][]

    K2 = [[-1, -1, -1],
          [-1,  8, -1], 
          [-1, -1, -1]]

    IMPRIMIR("\nCargando Imagen PGM...")
    M = imagenes.cargar_pgm("dog.pgm")

    IMPRIMIR("\nImagen PGM cargada...")

    IMPRIMIR("\n\nConvolucionando con k2")
    C = CONVOLUCION(M, K2)

    IMPRIMIR("\n\nGuardando imagen PGM")
	  imagenes.guardar_pgm(C, "PROG80 - API - MATRICES - convolucion 2D cargar_pgm().pgm", 255)


FINAL