💾 Archived View for mirrors.apple2.org.za › archive › apple.cabi.net › Graphics › PIX.WHIZ.INFO.txt captured on 2023-01-29 at 04:40:58.
-=-=-=-=-=-=-
Brief Instructions for PIX.WHIZ
The text file PIX.WHIZ.DOCS contains the manual for PIX.WHIZ. What you need
to know to run the program is contained in that file, but here are some
things you need to know right off.
1. To create a self-booting disk, just copy ProDOS 8 onto the disc. In order
to make room for ProDOS, you will need to move the files PIX.WHIZ.DOCS and
READ.ME.FIRST to the back of 5.25" discs. If you launch the program from a
program launcher, choose the file MICOL.SYSTEM.
2. The program can be used even if you only have one disc drive, although you
will be in for some disc swapping.
3. Some of the operations take a while, so don't be impatient.
4. I have fixed the hardware conflict that prevented running PIX.WHIZ with a
RAM drive installed on my Super Expander C aux type memory card, and I hope
it is now fixed for most if not all of these cards. The problem, if you still
encounter it, manifests itself when the program must switch between drives,
such as during a load file or a save file operation, and a ProDOS "Volume not
found" error is generated, regardless of whether the proper disc is in the
drive. Shutting down the RAM drive seems to fix the problem.
5. PIX.WHIZ now runs with the Applied Engineering IIc system clock installed.
Those of you who had conflicts with clocks may want to try it with them
running now. If you still have trouble getting it to run, try turning off the
clock driver.
7. Pix.Whiz is flaky on some IIgs's. I am attempting to fix the problems, but
if you can't get it to work, try shutting off the IIgs and booting directly
into ProDOS 8 as you turn it back on. If you have an accelerator card, it may
help to set the speed back to 2.8 Mhz.
8. If you need to ask me anything about Pix.Whiz, my E-mail address is
included below. If you find a bug, PLEASE PLEASE PLEASE let me know! I can't
fix it if I don't know it exists.
Gerry (the Applesoft-aholic)
g.wright12@genie.com
g.wright@the-hermes.net
REVISION HISTORY
Version 2.2
1. New capabilities
---substantial increase in speed of file operations
---new splash screen
---increased # of files that can be cataloged to 128
---can load Print Shop GS graphics
2. Bug fixes
---error recovery did not handle locked graphics files
---error recovery during save of hi-res files could result in scrambled
lo-res portion of file
---did not recover from swapping out a disc before being in its root
directory when pressing an Open Apple-B for backup during file ops
---if program was run on a IIgs without first shutting it off and rebooting
directly into ProDOS 8, the splash screen and drawing screen would be
scrambled
---removed hardware conflict with some aux type memory cards and some clocks
Version 2.1
1. New capabilities
---substantial increase in speed of graphics operations
---version number now displayed on splash screen
---splash screen can be dismissed early by pressing a key
---undo feature to cancel change to last pixel
2. New commands
---U: undo last change
3. Bug fixes
---after saving a graphic, did not return to same view you were working on
---prompt to replace program disc when switching to drawing module did not
strip subdirectories from path name for message box display
---if edited existing graphic, then started new one & pressed S instead of
Open-Apple S, new graphic wrote over first one instead of dropping into
"Save As"
---if edited a graphic, then pressed N to start a new graphic, it did not
reset to lo-res color graphic, but remained same type as type you just
edited
---if edited a file and it became shorter, EOF and number of blocks used were
not updated correctly
---if you ran a program using hi-res or double hi-res graphics, then started
PIX.WHIZ without shutting off computer, splash screen was scrambled
Version 2.0
1. New capabilities
---creates low and high resolution graphics, monochrome and color
---converts graphics from one type to another
2. New commands
---V: convert graphics
---H: hi-res/lo-res toggle
---<OPEN APPLE-ARROW>: move 10 pixels at a time
---<SOLID APPLE-ARROW>: scroll between parts of hi-res pic
3. Bug fixes
---recovery from "DISK FULL" error did not work
---loading very large hi-res color graphics could crash program
---under some circumstances, version 1.01 would save a picture in a
scrambled state
Version 1.01
---Bug fix: cataloging disc whose volume name was less than 4 characters
long crashed program
Version 1.0
---Release
-----------------------------------------------------------------------------
PIX.WHIZ Documentation
copyright 1995 by Geraldine Wright
ACKNOWLEDGEMENTS
I would like to extend a special thanks to Abbey Birk, who did a mighty fine
job of beta testing version 1.0 of PIX.WHIZ. Without her help, I would never
have been able to find all the nasty little buglets hiding inside the
program.
Gerry (the Applesoft-aholic)
g.wright12@genie.com
g.wright@the-hermes.net
INTRODUCTION
Broderbund's New Print Shop program can print color graphics in your signs,
banners, calenders and greeting cards. Unfortunately, Broderbund never
provided a way for Apple IIe and IIc owners to create their own color
graphics. The graphics editor within the New Print Shop only creates
monochrome graphics. IIgs owners could create color graphics for the New
Print Shop using Print Shop GS Companion, and export them to New Print Shop
format. Unfortunately, the color graphics created this way did not look as
good when printed out in medium and large sizes as did the graphics on the
discs Broderbund sold.
I wrote PIX.WHIZ to correct this problem. Version 2.0 will allow you to make
both monochrome and color graphics for the New Print Shop that look good
whether printed in small, medium or large sizes, and do it on the same
computer you use to make New Print Shop projects. The system requirements
are:
Enhanced IIe w/80 column card or IIc or IIgs
Color monitor
BACKGROUND INFORMATION ON NPS GRAPHICS
Here is some background on the New Print Shop graphics files which you will
need to understand the discussion of PIX.WHIZ's which follows.
The movable NPS graphics (as opposed to the full panels, which can't be
moved) come in 4 types. All the graphics on the NPS program disc, as well as
the ones sold by Broderbund on the graphics libraries discs, are what I call
"high resolution" graphics, and they can be monochrome or in color. When
these graphics are printed out in the small size, they are composed of 52
rows of pixels, with 88 pixels in each row. When they are printed out in the
medium or large size, they have 104 rows of pixels with 176 pixels in each
row. In other words, you get an increase in the detail as you go from the
small to the medium size. New Print Shop will tell you whether a picture is
color or monochrome before you load it for a project. When you are browsing a
library to choose a graphic, and press <SPACE> to preview it, NPS also prints
a label under the preview if the graphics is in color. If there is no label,
you know it is monochrome. The Graphics Editor in NPS allows you to make the
high resolution monochrome graphics. Until now, there was no way to make the
high resolution color graphics.
If you use the "Convert" feature of New Print Shop to import old Print Shop
graphics, you create what I call "low resolution" monochrome graphics. These
behave exactly like the old Print Shop graphics. They are composed of the
same amount of pixels whether they are printed in small, medium or large
sizes. You do not get an increase of detail going from small to medium size.
Plus, they can only be black and white. Most of the freeware libraries of NPS
graphics you can get are of this type, and there are thousands of them. When
you preview these graphics while browsing a graphics library, NPS will print
a label below the picture that says "Lo Res".
If you (or a friend with a IIgs) use Print Shop GS Companion to make color
pictures and then export them to the New Print Shop format, you get "low
resolution" color graphics. Like the lo-res monochrome graphics, they have
the same number of pixels no matter what size you print them in. They have
the advantage of printing out in color. In the last few years, people have
begun to make these types of graphics, and there are a few hundred of them on
the A2 library on GEnie. When you preview one of these graphics while
browsing a graphics library, NPS prints two labels below the picture. One
says "Color" and one says "Lo Res".
Each of these 4 types of graphics can contain from 1 to 4 complete and
separate pictures. All 4 types of graphics contain a low resolution
monochrome representation of the graphic. This lo-res mono picture is used to
make the picture seen when you preview a graphic while browsing a disc, or if
you preview a project in which you have put a small graphic. It is also what
gets printed out when you print a hi-res mono graphic in the small size, or a
lo-res mono graphic in any size. In addition, if you print out a hi-res color
graphic in the small size, but only have a monochrome printer, you will get
this picture. A lo-res color graphic printed out in any size on a monochrome
printer will give you this picture.
In addition to the lo-res mono picture, the lo-res color graphics also
contain a lo-res color picture, as does the hi-res color graphics. This gets
printed when you print a hi-res color graphic in the small size, or a lo-res
color graphic in any size.
There is also a hi-res mono picture, and both the hi-res mono and the hi-res
color graphics have one of these. If you print a hi-res mono graphic in the
medium or large size, this is the picture that gets printed. If you print a
hi-res color graphic with a monochrome printer, you will also get this
picture. This is the picture you see when you preview a project in which you
have put a medium or large size graphic.
Finally, there is a hi-res color picture. Only the hi-res color graphics have
one of these. You get this picture by printing a hi-res color graphic in
medium or large size.
PIX.WHIZ can make any of these 4 types of graphics. It is important to note
that PIX.WHIZ edits the various pictures contained within a graphic
completely independently. If you create a graphic which is supposed to have 2
or 4 pictures, but only put pixels in one picture, you will get a blank
picture when NPS needs to use the picture that you neglected to put pixels
in.
Note: If you have any color NPS graphics that you know were made with Print
Shop GS companion, you might want to go back and edit the monochrome picture
in these files. PSGS Companion doesn't let you edit the monochrome picture,
it just makes a guess what it should look like for you. What it guesses isn't
always very representative of the color picture, and you may want to touch it
up a little.
Note to PublishIt4 users: PublishIt4 can import New Print Shop graphics. If
you import a color graphic, it will ask if you want the color or the
monochrome picture.
INSTALLATION
All the files you need to run PIX.WHIZ, with the exception of ProDOS, are on
the disc or in the shrunk file this document was obtained from. Make sure not
to change the name of any of them. All the files, with the exception of
PIX.WHIZ.DOCS and READ.ME.FIRST, must be in the same directory for PIX.WHIZ
to run. You can make the PIX.WHIZ startup disc self booting by putting ProDOS
on it. If you are booting PIX.WHIZ off a 5.25" disc, you will need to put the
files PIX.WHIZ.DOCS and READ.ME.FIRST on the back side of the disc before
putting ProDOS on the disc. If you choose to run PIX.WHIZ from a program
launcher, run the file MICOL.SYSTEM.
PIX.WHIZ is flaky on some IIgs's, and I am attempting to ferret out these
problems. If it isn't working on your IIgs, try shutting off the IIgs and
restarting directly into ProDOS 8. Sometimes it conflicts with accelerator
cards, so try setting the speed back to 2.8 MHz.
PIX.WHIZ will now run with a RAM drive installed on a Super Expander C aux
type memory card, and hopefully will run on other types as well. I have also
gotten it to run with an Applied Engineering IIc system clock. If you have
some other brand of aux type memory card and/or clock and are having trouble
getting PIX.WHIZ to run, try shutting off the clock or shutting off the RAM
drive in the aux memory.
DRAWING SCREEN
The drawing screen is where you will actually do editing on your NPS
graphics. PIX.WHIZ will automatically bring you here after the program loads
and the initial splash screen displays. (The splash screen will display for
about a minute. However, you may dismiss it as soon as the disc access stops
by pressing a key.) The large white square at the right will display the
picture as you edit it. The graphic has been initialized to all white, so for
a new picture, it is not necessary to insert white pixels. At startup, the
program is set to edit a lo-res color graphic, and will display the lo-res
color picture.
There is an arrow shaped cursor which points to the pixel to be changed. The
cursor is moved by the arrow keys. The arrow keys by themselves move single
pixels. If you need to move the cursor a long way, there is a "fast cursor"
move. Use the Open Apple key in concert with an arrow key, and the cursor
will move 10 pixels in the direction of the arrow. The cursor will wrap
around at both sides, and at the top and bottom.
At the left of the screen are a list of 1-key commands for activating
PIX.WHIZ functions. There are prompt lines at the bottom with instructions
requiring more text. Messages to the user also will appear here, and commands
which require further user input also will print prompts here.
Finally, there are a few lines of status information at the left. The current
position of the arrow shaped cursor is displayed, along with the current
drawing color.
In the drawing area, the hi-res and lo-res pictures are displayed
differently. When you edit a lo-res picture within a graphic, it can be
displayed in its entirety. Unfortunately, it is not possible to make the
pixels small enough to view the hi-res pictures in their entirety and still
have a true representation of the colors. Therefore, the hi-res pictures are
displayed in quarters. You scroll around between the quarters of the hi-res
picture using the Solid Apple key in concert with one of the arrow keys. The
operation of the <SOLID APPLE-ARROW> scrolling is as follows:
HR:4 LR
^ ^
| |
------------------- HR:3
| | | ^
| |-> | |
LR <- | HR:1 | HR:2 | -> HR:3 -----------
| ^ <-| ^ | | |
| | | | | | |
------------------- HR:4 <- | LR | -> HR:1
| | | | | | |
| v |-> v | | |
HR:2 <- | HR:3 | HR:4 | -> LR -----------
| <-| | |
| | | v
------------------- HR:2
| |
v v
LR HR:1
As you can see, <SOLID APPLE-ARROW> not only lets you scroll around in the
hi-res picture, it also lets you move between the lo-res and hi-res picture.
By pressing the appropriate arrow key while editing the lo-res picture, you
can get to any of the 4 hi-res quarters you want. You can also get from any
of the hi-res quarters to the lo-res picture. <SOLID APPLE-ARROW> only lets
you move between lo and hi-res pictures which are both monochrome or both
color. If you want to switch from a color picture to a monochrome, or vice
versa, use the "M" key, as described below in the section on commands.
The cursor position status line shows you the position from the top left
corner of the entire picture being edited, NOT from the top left corner of
the view you are currently working on. For the lo-res pictures, this is just
like it was in version 1.0. But for the hi-res pictures, the cursor only
shows position from the top left of the particular view you are editing when
you are in the first quarter of the picture. I did it this way to accommodate
those who wish to design their pictures ahead of time by plotting out the
pixels on a grid. In that case, it is more intuitive to count the pixels from
the top left of the entire picture.
It is important to note the if you move the cursor off one edge while editing
one of the hi-res quarters, the picture DOES NOT scroll to the next quarter.
The cursor just wraps around to the opposite edge of the same quarter.
COMMANDS
All of the commands and user responses are activated by a single key press.
It is not necessary to press <RTN>. Illegal key presses will cause a beep.
The commands are listed here.
<SPACE> - draws a pixel in the current color at the current cursor location
U - undo. The last pixel changed will be erased, and the pixel will be
returned to the color it had before being changed. You may move away
from the pixel and still be able to undo the change.
C - change the current color. A prompt line at the bottom will ask what color
you want. Press the 1-key response required to choose the desired color.
M - toggle between color picture and monochrome picture. The behavior of the
space bar changes slightly when you are editing the mono picture. It
toggles pixels between black and white, rather than painting them in the
current color. The list of 1-key commands also changes. You no longer
see the C command, since you can't choose a new color. The M command now
will take you back to the color picture.
H - toggle between the lo-res and hi-res pictures. It will take you from any
one of the hi-res quarters to the lo-res picture. It will also take you
from the lo-res picture to the first quarter of the hi-res picture.
N - new picture. The entire graphic, both the color and mono pictures, are
erased to white so you can start over. If you made changes to the
currently displayed picture but have not yet saved them, you will be
warned and asked if you want to abort the N command. This gives you a
chance to save the changes you made. The new graphic will initially be
set to a lo-res color graphic, and you will be editing the lo-res color
picture.
L - load an NPS or PSGS graphic from disc. (see caveat below) As with the N
command, if you have made changes to a picture that were not saved, you
will be given a chance to abort. If you choose to continue, you will
taken to the file operations screen to choose the graphic you want to
load. When you load an NPS graphic, PIX.WHIZ loads the graphic as the
same type it was on the disc you got it from. If you load a PSGS
graphic, it will be converted to an NPS graphic of the same type, color
or mono. If you have loaded a color graphic, you will initially be
viewing the lo-res color picture. If you loaded a monochrome graphic,
you will initially view the lo-res mono picture.
S - save the file. This is used to save modifications to a pre-existing
graphic when you want the changed file to be stored under the same name
on the same disc as you loaded it from. If you accidentally press S to
save a new file you had just created, you will be diverted to the Save
As command, which is described below.
Open Apple-S - save the file using a different path name than it was loaded
from, or save a new file. You will taken to the file operations module
to choose the disc on which to store the graphic and give it a name.
V - convert a graphic to another type of graphic. When you press it, the
prompt line changes to ask you what the new type should be. You are
reminded what it is now, and asked to press a number designating which
of the types you want it changed to. You can convert an NPS graphic to
any other kind of NPS graphic, but you cannot convert an NPS graphic to
a PSGS graphic. The prompt line has abbreviations next to the numbers,
and they mean:
LRM - Lo-res mono
LRC - Lo-res color
HRM - Hi-res mono
HRC - Hi-res color
Some of the conversions take a while, so be patient. In particular, it
takes 2 1/2 minutes to convert a lo-res color graphic to a hi-res color
graphic. If you convert either of the 2 hi-res types to a lo-res type,
the hi-res pictures within the graphic are thrown out. If you convert a
color graphic to a monochrome, any color pictures in the file are thrown
out. If you convert a mono graphic to a color graphic, PIX.WHIZ creates
color pictures whose pixels are initially all black and white. When a
lo-res graphic is converted to a hi-res graphic, hi-res pictures are
created where each lo-res pixel is replaced by a 2X2 square of smaller
pixels.
Q - quit. As with the N command, if you have made changes to a picture that
were not saved, you will be given a chance to abort the N command.
Caveat: The graphics on the Print Shop GS program disc are not separate
files, but are batched, several to a file. PIX.WHIZ cannot extract the
individual graphics out of these batched files. To make an NPS graphic from
one of these, start PSGS and get into the Graphics Editor. Choose the desired
graphic to edit, then save it on another disc, and it will now be in a file
all by itself. This new file can be loaded and edited with PIX.WHIZ. PIX.WHIZ
should be able to load graphics from any of the PSGS library discs, or any
you download.
The type of graphic being edited will effect the commands that available to
you. While editing a monochrome graphic, the "M" and "C" commands are not
available. While editing a lo-res graphic, the "H" command is not available.
Obviously, using the "V" command to change the type of graphic will change
the commands you can use on the graphic.
FILE OPERATIONS SCREEN
When you press L or Open Apple-S while editing a graphic, you will be brought
to the file operations screen to choose a path from which to load a file or
to which to save a file. The S command does not bring up the file operations
screen, because it assumes you want to save to the original path, and do not
need to choose one. All three commands need to read the file operations
module from the PIX.WHIZ startup disc, so you should not remove the disc
while you are editing a graphic. If you have removed the disc, you will be
nagged to put it back in. If you are saving a file, there will be a delay
while the file is being compressed. A friendly message box will appear to let
you know that the file is being compressed and saved, and you have not been
sent to never-never land.
PIX.WHIZ will then do a search for on-line volumes and present them in a
"point and shoot" list so you can pick which one you want. Move through the
list of volumes using the up and down arrow keys. When the one you want is
highlighted, press <RTN> to select it. Open Apple-B can be used to redo the
on-line volumes search. This is especially helpful if you only have one disc
drive. Take out the PIX.WHIZ startup disc and replace it with the disc that
has the graphic you want. Then press Open Apple-B to redo the on-line volumes
search, and you will be able to choose your graphics disc. MAKE SURE YOU
REPLACE THE DISC FIRST, THEN PRESS OPEN APPLE-B. DON'T SWAP THESE STEPS!
OTHERWISE, PIX.WHIZ MAY BE POLLING THE DRIVE AS YOU PUT IN A DISC, AND YOU
COULD TRASH THE DISC. Open Apple-B is also useful if you realize you forgot
to put your graphics disc in a drive, or you put in the wrong one. In either
case, put in the disc you want and then press Open Apple-B. If you decide you
want to abort the entire operation and return to the drawing screen, press
<ESC>.
Once a disc has been chosen, its volume name will be displayed on the top
line and it will be cataloged. NPS library discs have "PSL." appended to the
front of their volume names. PIX.WHIZ will recognize these as NPS library
discs and automatically append "/GRAPHICS" to the path before displaying the
path and doing the catalog. This is the subdirectory on all NPS library discs
where your graphics will be found. PIX.WHIZ saves you a little time in
automatically taking you there. When the catalog is done, it will be
displayed in a "point and shoot" list, much as for the on-line volumes list.
You highlight file names and choose them for action in the same way. <ESC>
will abort the operation. Open Apple-B will back you up to the previous
directory. You can press Open Apple-B repeatedly to back up to ever more
previous levels, and if you press it while the root directory is displayed at
the top, PIX.WHIZ will redo the on-line volumes search.
The files that PIX.WHIZ will list for you to choose during a load operation
are:
Low resolution monochrome NPS graphics
Low resolution color NPS graphics
High resolution monochrome NPS graphics
High resolution color NPS graphics
Subdirectories within the subdirectory you have cataloged
You cannot load full panel graphics or letterheads, so you will not see
these.
The files that PIX.WHIZ will list for you to choose during a save operation
are:
Subdirectories within the subdirectory you have cataloged
If you choose a subdirectory, that subdirectory will be appended to the path,
and the new path will be cataloged. You may choose a graphics file if you are
loading, and that file will be loaded. While saving a graphic you may only
choose subdirectories. When the full path down to the subdirectory in which
you want to save a file is shown on the top line, press Open Apple-A to
select that path. You will then be prompted to supply a name for the graphic.
You will not be allowed to enter an illegal name. If there is already a file
with the name you typed, you will be asked if you want to overwrite it. If
the file is locked, you will be asked if you want to unlock it and proceed
with the save.
The desired file operation will now take place, and PIX.WHIZ will return to
the drawing screen. This requires reading a module from the PIX.WHIZ startup
disc, If you have removed the disc, you will be prompted to put it back in.
If you were loading a file, there will be an additional brief delay while the
loaded file is decompressed.
ADDITIONAL INFO
Because of the peculiarities of the Apple 2 color graphics, the picture you
see when viewing a graphic with PIX.WHIZ may differ in subtle ways from what
it will look like when printed. Pixels of some colors appear narrower on the
screen than when printed. Some colors, when painted next to each other on the
screen, can seem to give rise to unexpected effects. For instance, a black
pixel painted directly to the right of a red pixel displays on the screen as
red. PIX.WHIZ has recorded the pixel correctly, however. If you are unsure of
exactly what is in the graphic, fire up the New Print Shop and print it out.
PIX.WHIZ is a "work in progress". I myself use it to make NPS graphics, and
so am committed to improving it as time goes by. If you find a bug in the
program, please don't hesitate to contact me about it.
PIX.WHIZ is freeware. You may give it to anyone who wants it without charge.
AN EXHORTATION
Make lots of pretty NPS graphics and share them with all the rest of us!! ;-)