Back To MUSHii Page

MUSHii Tutorial: Importing A Bitmap

You can import and convert bitmap images into MUSH format. Because of the size of each "pixel" (a character) in MUSH/MUX, it is usually only practical to import very small bitmaps. Keep in mind that for each pixel on the bitmap, that's 1 or 2 characters (depending on how you import it) on the MUSH or MUX. The standard screen width on many clients is 80, so try not to exceed that if you want other people to be able to see your image properly. Let's try an example. Let's suppose we've surfed the web, found a screenshot from a video game, and cropped out mario into a bitmap:

Next save the bitmap somewhere, and close the editor.

Now open up MUSHii, and click on File | Import | Bitmap:

A file dialog box pops up.

 Browse your folders and find the bitmap, click Open.

Now MUSHii pops up this message. Selecting "1 pixel=2 tiles" will convert the image so that for every pixel in the bitmap, it creates two characters in the MUSHii file. This option will take up more space, but may make the picture look better than "1=1" would. "2=1" is suggested only for really small bitmaps. The "1 pixel=1 tile" will convert the bitmap with one pixel equaling one character.

In this example we'll choose "1 pixel=2 tiles". MUSHii then brings up the picture with upside down question marks throughout it:

Though you may be tempted to hit "Go!" now, do not. MUSHii has only loaded in the colors used by that picture, but the question marks tell you that the picture still needs to be converted to MUSH colors. This needs to be done by you.

Select bright red for a background color by right-clicking on it:

Now place the mouse over one of the red question marks, and Right-Click. This will change all tiles of that color to the MUSH bright-red, and remove the question marks:

Make the sky bright-cyan or bright-blue. Make the skin bright or dull yellow:

We are almost done. For the last color, we are going to use a FANSI pseudo-color. Using the middle shading character, and a foreground of dull-yellow, and background of gray, we can create the following character:

Select this character, and then right-click over the last question-marked color to fill it with these:

Hit "Go!", "Ok", and the code is generated.

If you're wondering why MUSHii doesn't convert the colors automatically, it's because there are so few actual MUSH colors (16), and millions of shades of possible bitmap colors. What if you have five shades of red in a picture, would you really want MUSHii converting them all too one of the two possible red colors? How is MUSHii supposed to know that a pinkish-orange color should be turned bright-yellow (like in this picture) because it represents skin? It's just not practical.