Having written a function to read a PGM image, how do we use it?
Well, the testbench at the bottom of the pgm vhdl file has an example:
variable i : pixel\_array\_ptr;
-- Without the transpose function, we would have to present the initialisation data in a non-intuitive way.
constant testdata : pixel\_array(0 to 7, 0 to 3) := transpose(pixel\_array'(
(000, 027, 062, 095, 130, 163, 198, 232),
(000, 000, 000, 000, 000, 000, 000, 000),
(255, 255, 255, 255, 255, 255, 255, 255),
(100, 100, 100, 100, 100, 255, 255, 255))
);
Being by setting up a variable to store the image in. We also create a constant which contains the data we expect to read from the file. As explained previously we have to transpose the array in order for it to “look as expected” in the code (which is more important than an extra function call to my mind)
Then we can test and check:
-- test on a proper image
i := pgm_read("testimage_ascii.pgm");
assert i /= null report "pixels are null" severity error;
assert_equal("ASCII PGM Width", i.all'length(1), 8);
assert_equal("ASCII PGM Height", i.all'length(2), 4);
assert_equal("ASCII PGM data", i.all, testdata);
That simple!
Code for this series can be found on github