MifGenerator

Created by Emanuele Giuseppe Esposito on 07/21/2016

This tool creates an Altera .mif (Memory Initialization File ) from an image file (.png,jpeg,.jpg,etc..).

Features :

• Resize the image
• Choice on deleting the resized image
• Edit a mif file by adding other images
• Choice to get the image in grayscale or colors (Not yet implemented yet)**.

** Right now, the image will be converted in grayscale therefore will be displayed in grayscale on the screen.

More informations about .mif extension can be found here

The file generated can be read from any text editor, and will have as address radix and data radix UNS.

###HOW TO RUN.

YOU MUST HAVE JAVA JDK 6+ INSTALLED.

By default, any image should be in this folder in order to be read, but if you want to use any image in other directories, just remember not to add the first slash. The file will be generated in the folder where the image is.

For example, java MifGenerator EXAMPLE/linux_pengui.mif

The file will be generated in EXAMPLE folder

If you want to create a new mif file:

1. Unzip these files.

2. With your terminal, go to the folder path

3. Compile the files by writing javac MifGenerator.java

4. Write java MifGenerator image_name.extension image_width image_height number_word q-output

5. If you do not understand these parameter, you can see them in Quartus 2 by going on Tools -> MegaWizard Plug-In Manager -> Next (choose your options) -> Next (choose your megafunction and give a name to the ram/rom) -> (here). If you forget the order or not sure on what to insert, you can write (going with the terminal in the folder path) java MifGenerator -help

6. The output will be a file generated in the loaded image folder with called the same name of the image + .mif

7. Enjoy

If you want to modify a mif file to add another image in its free memory words :

0. Make sure you have the free space declared in the following way : [2900..3000] : 0 where 0 can be any number.

1. Go to step 1, 2 and 3 of the previous section

2. Write java mif_file_name.mif (this is your mif file).

3. You will be asked what image do you want to insert and on which size

4. Insert a name for the resulting mif file (will be saved in the folder where is the image)

5. Enjoy

P.S. If you are really lazy, and don’t want to set every time these number, there is a bash script called run.sh that you can edit in order to automatically get the size of the memory or get the same memory size and word parameters, or just insert the mif file to modify.

To use it, first you have to give it the permission to be executed (chmod) and then you run it by writing ./run.sh (if you are in the path where the file is).

It only requires as argument an image file or mif file. For example

./run.sh EXAMPLE/linux_penguin.png

The default values for this script are 160 120 32768 8 (What I used to generate my 160 x 120 image to show in my 640 x 480 screen.)

Any help/correction of this code is appreciated. If you want to contact me, send me a mail.

I am not responsible of any use you will do of this tool.