Dec 092017
 
PixEdit v1.0 is an easy-to use 256 color VGA/MCGA sprite editor. Easy file format capable of incorporation into any programming language.
File PIXEDIT1.ZIP from The Programmer’s Corner in
Category Printer + Display Graphics
PixEdit v1.0 is an easy-to use 256 color VGA/MCGA sprite editor. Easy file format capable of incorporation into any programming language.
File Name File Size Zip Size Zip Type
FONTLOAD.BAS 11522 2863 deflated
PIXEDIT.BAS 10884 2277 deflated
PIXEDIT.DOC 10968 4332 deflated
PIXEDIT.EXE 85784 53501 deflated
SAMPLE.PXD 414 78 deflated

Download File PIXEDIT1.ZIP Here

Contents of the PIXEDIT.DOC file



PixEdit version 1.0
by Matthew W. Lee

PixEdit is a simple-to-use yet powerful MCGA icon/sprite editor. To use
PixEdit, you must have a 256 color 320x200 MCGA graphics card. If you have
no idea what this is, MCGA is built into most standard VGA cards. It doesn't
matter if you have a color or b/w monitor, but it might be easier with a color
monitor to see all of the colors. For those who wish to start quickly and are
fairly good at picking up computer programs, here is a list of the commands.

Arrow keys (Up, Down, Left, Right, Home, End, PgUp, PgDn) - move
cursor around the screen
ESC - exits PixEdit
C - clears the screen
S - saves an image or part of an image
O - loads a saved image
SPACE - turns a point on (draws a dot)
+ (plus) - advances one color in the palette
- (minus) - decreases one color in the palette
* (asterisk) - changes the RGB values of a color in the palette
R - restores all colors to their original RGB values
L - draws lines, boxes, and filled boxes
E - draws circles, ellipses, arcs, and pie segments
G - moves directly to a specific point
F1 - sets step 1 (allows movement of 1 pixel per keypress)
F2 - sets step 2 (allows movement of 2 pixels per keypress)
F3 - sets step 3 (allows movement of 3 pixels per keypress)
F4 - sets step 4 (allows movement of 4 pixels per keypress)
F5 - sets step 5 (allows movement of 5 pixels per keypress)
P - paints the screen or fills enclosed objects
T - draws text

<<< Included Files >>>

PIXEDIT.EXE - main program file
PIXEDIT.DOC - this documentation file
FONTLOAD.BAS - font description file
PIXEDIT.BAS - BASIC source code (not necessary for program execution)
SAMPLE.PXD - Sample file for you to use

<<< Instructions on Using PixEdit >>>

The Title Screen
Okay, so it looks real cheesy, doesn't it? If you want to stop it short,
press any key while it is drawing text. By the way, this is the font that
the text draw function does. I will do a new title screen in the next
version.

Moving Around the Screen and Other Easy Stuff
To move, you can use all of the directional keys, including the diagonals
(Home, End, PgUp, PgDn). To move faster, press the first 5 function keys.
You will notice that when you press F2, you can move two pixels at a time.
It is the same with F3-F5. F1 returns you to your original mode, one pixel
per keypress. You will also notice at the bottom of the drawing box, there
is a line that looks like "X: 34 Y: 23 S:2 C:0". The X and Y displays
indicate your current X and Y coordinates. The S indicates your step, which
is selected by using F1-F5. C indicates your current color. To change C,
press + and -. While you are doing this, a small box around one color on the
palette will move, and the larger box below the palette will change to the
current color. Another movement tool is accessed by pressing G. It will
ask you for X and Y coordinates, and -whoosh- you will be taken to those
coordinates. By the way, the drawing box is 234 pixels wide and 149 pixels
high, just so you don't try to goto or draw any lines/boxes to points outside
those limits. It should stop you anyway. If you ever make a mistake with
anything drawn in PixEdit, press U to undo the operation IMMEDIATELY AFTER
you make the mistake. Otherwise, the mistake will be permanent if you draw
something else after making a mistake.

Drawing Lines, Boxes, Circles, Ellipses, Arcs, and Pie Segments
To draw lines, boxes, or filled boxes, first move the cursor to one corner of
the line or box you wish to make. Then select the color for the box to be
drawn in. Press L and then enter the X and Y coordinates of the other corner
of the line/box. Then enter L for a line, B for a box, or F for a filled
box. The line/box will be drawn and you will be taken to the opposite
corner. To draw circles, ellipses, arcs, and pie segments, first move the
cursor to the center of the circle/ellipse/etc. and select the color for it
to be drawn in. Then press E to draw the figure. It will ask for a vertical
radius and a horizontal radius. To make a circle or an arc/pie segment of a
circle, these values must be the same. Otherwise, the values must be
different. Then it will ask if you want to draw an arc or a pie. If you
want a circle or an ellipse, reply N. Otherwise, reply Y. When you reply
Y, it will ask for the start angle and the end angle. Zero degrees is not at
the top, it is on the horizontal axis on the right side of the circle. Make
your degree entries accordingly. Then it will ask if you want to draw an arc
or a pie. Enter A for an arc, P for a pie segment. It will draw the figure.
Remenber, U undos the last drawing function.

Palette Changes, Painting/Filling, and Text Drawing
Changing the palette in PixEdit is very easy if you know how the RGB color
system works. To change one color, select that color with the + and - keys,
and then press * (asterisk). It will prompt you for red, green and blue
values, each being between 0 and 63, inclusive. After this is entered, the
color will change. To return all colors to their original RGB values, press
R. Warning: this operation is irreversible; you cannot use the undo key to
set the colors back to the values that you set them to. (This may be changed
in future versions.) To paint/fill, move the cursor inside an ENCLOSED
object that has a boundary composing of only ONE COLOR. If this is not done,
the paint/fill operation may make a mess of your current drawing. Then
select the color you wish to fill with. Also determine the color of the
object's boundary. Then press P. Enter the color to paint to (the color of
the boundary). The area will be filled. Text drawing is very easy with
PixEdit and its module file, FONTLOAD.BAS. This module holds the brains for
all of the font drawing included in PixEdit. An example of this is the
title screen when you first start the program. To draw text, select the
color you wish to draw text in and move the cursor to the lower left hand
corner of where you want the text to be. Basically, this is the beginning
of the first word on the text baseline. Note: some letters such as g, j, p,
y, and q will drop below the baseline. Then press T and it will ask you for
the text size. This is sort of tricky, because a value of 4 is normal size,
and two times normal size is 8, four times is 16, etc. It is a good idea to
use multiples of 4, because other values that aren't multiples of 4 can
screw up some parts of some letters. An example of normal size is the words
"by Matthew W. Lee" on the title screen. Then it will ask you for the text
angle. Again, it is based on the same system as the angles for arcs and
pie segments, with 0 degrees being horizontal, the text going left to right.
Then it will ask you for the message. Just type in the text you would like
to draw, using uppercase and lowercase, and almost any other character you
can think of, including all of the ASCII characters with accents on them.
Hint: For boldface, draw the same message again one pixel to the left or
right of the previously drawn message in the same size.

Loading and Saving Images
PixEdit uses a very simple image format to record 256 color images. The only
disadvantage to the system currently in use is that the files can become
quite large and it takes a while to load and save large images. The format
consists of decimal numbers only. The first two numbers indicate the size
in X and Y of the image. The rest of the numbers are decimals ranging from
0 to 255, indicating the pixel values. The arrangement is from left to
right, top to bottom. Look at a .PXD file (PiXedit Data file) to explore
this further. To load an image, move the cursor to the upper left hand
corner of the rectangle where you want the image to be loaded to. Then press
O to load(open) a file. It will ask you for a filename; just enter the name
without an extension. The image will be loaded, and it will return you to
normal drawing mode. To save a file, figure out the width and height of the
image you want to save by moving the cursor using the arrow keys. Then
position the cursor in the upper left hand corner of the image. Press S to
save an image. It will ask you for the size in X and Y. Enter width and
height accordingly, with a comma in between. Then enter an 8-letter name
for the file without extension. It will save the image. If it is large,
this step may take a while. Then it will return you to normal drawing mode.
Also, when entering file names for saving and loading, you can enter "#" for
a file listing of current .PXD files. PixEdit will not load or save files
with an extension of anything other than ".PXD".

A Final Notice
PixEdit is shareware. If you enjoy this program and/or use it often, please
show your support by sending $5.00+ to the author. This donation supports
future versions of PixEdit and other fine software creations. As we all
know, money is what makes this world go round. By the way, this is not
crippleware. This is a fully functional version of PixEdit, with no hidden
or annoying messages to send me money (except this one!).
Send your donations to:
Matthew W. Lee
9503 Angelina Circle
Columbia, MD 21045
USA

Future Versions
In future versions, you may see:
* More fonts
* An easier-to-use interface with menus, nice text messages, etc.
* A help system
* A better file format, but it will be backwards compatible.
* And much, much more!

Thank you for downloading PixEdit from whichever BBS you got it from. If you
have any comments, bug fixes, constructive complaints, etc., send them to
me at the above address or contact me on Maryland's best BBS (voted by
Computer Shopper Magazine (yea, that big thick one)) at user # 2985. I enjoy
your comments and it will help me to make better versions of PixEdit and give
me new ideas for programming outreach. By the way, if you are expecting me to
be a twenty-something year-old computer idiot that stops only to eat, I'm not.
I'm a fifteen-year old highschool student at Oakland Mills High School in
Columbia, MD that just likes to program and obviously has a God-given gift for
it. (Wow, you have an overactive ego, Matt.) Oh well, this document is long
enough. Enjoy PixEdit and send me money! Thank you very much!





 December 9, 2017  Add comments

Leave a Reply