Paledit V1.67 Readme File.

---

What is it?
  Well, in case you didn't guess, it is an palette editor designed for
  the OHRRPGCE. It also has another use associated with palettes;
  see below.

Commandline:
paledit [-pic] [input] [output] [palette]
	If you specify just an input file, that file is loaded, and you enter
	the gui. If you specify an input and output, it converts between the
	two. Finally, if you specify nothing, you enter the gui with the 
	default IBM palette set.[palette] belongs to -pic mode, see below.

"-pic" mode

-pic mode remaps the 8/15/16/24bit image in [input] to the 8bit picture file
specified in [output], using the palette stored in the file called [palette].
Scaling and/or horizontal and/or vertical flipping may also be performed...

See config info. (pic_*)

*Tip - If you have some pictures/sprites that are stored w/out a palette or 
	with different palettes :

	a) copy them all into a 24/16bit picture file. (eg CRAZY.PCX)

	b) run paledit, and load the file you just made. It will generate
	   an optimum palette for that image. Save that palette (eg CRAZY.MAS)

	c) run eg."paledit -pic CRAZY.PCX OUT.PCX CRAZY.MAS"
	   and the OUT.PCX will be an 8bit PCX with the same contents as 
	   CRAZY.PCX, but remapped to the palette in CRAZY.MAS.
	   You can now use that CRAZY.MAS in the OHRRPGCE,
	   but you'll need to split the OUT.PCX back into its
	   separate parts to be able to import them properly.

	   (by default bright magenta(R255,G0,B255) gets remapped to palette
	   entry #0.
	   If that's a problem, see the config info.)
	   
imports: PAL,MAS(ohr),RGB,NEW(ie. ohrrpgce.new),PCX,BMP,TGA,LBM.

exports: RGB,MAS,RGB,PCX,BMP,TGA.

(note: Paste mode #13 (multiply) is disabled because it doesn't seem to work right)
The gui is pretty much self-explanatory. Just click on a color in the palette to
select it as the color that's being modified, and use the sliders,etc.
The currently selected color is the one that will be used as the starting color
for copy,paste,and gradient.

Copy and gradient selections don't mind whether the second color you select is
before or after the first, they still do it properly.

I fixed the problems with the mouse pointer disappearing, BUT:
 - Palette entries 1 and 2 need to be highly visible.

Save/load always defaults to ".\default.pal"

Don't use longest path! It doesn't work right now.


Config settings: (note: it won't complain if one of these isn't here,it'll
just rewrite it.)

Case Is ImPoRtAnT. fps isn't the same as FpS or FPS

pic_hflip:
Horizontal flipping. 1 is on, other is off. 

pic_vflip:
Vertical flipping. See above. both h and v flip default to 0.

pic_scaling:
multiplier for scaling the picture. 0 is the same as 1(the default). Pal-Edit 
can use all physical memory and up to 128mb of virtual memory, so don't be
afraid to use large multipliers. Don't do anything absurd like 50 or 1000, 
though ;-)

pic_remapcol:
Color that is a fixed-remapping to pic_remapto. Hex RRGGBB
Default FF00FF (Red 255,green 0,Blue 255).

If it is more than FFFFFF, there will be no fixed remapping.

pic_remapto:
index into the palette that pic_remapcol gets remapped to.
Default 0.


Ciao,
Neo the Lion (David Gowers) -- 

Comments, suggestions etc. are welcome! Send to :

neo_@teamartail.com

(Note: I will NOT tolerate anybody suggesting that I make a version of this
 for any of certain Microsoft products that begin with the letter W. If you are
 so foolish, just watch out!)

Future:

At such a time when a version of the OHRRPGCE is released that works with DOSEMU,
I may consider porting this to Linux. (as it is _it(PalEdit) should probably run 
under DOSEMU without any mods))

Yes, this edition is exclusive to the OHRRPGCE: You may not distribute it 
separately. James and I are the only ones who have the right to distribute it 
separately.
And BTW, you people who have copies of an OHR game.exe on their
website, please don't! It does neither you or the players of your games any
good(As the OHRRPGCE is updated relatively frequently with new features and
BUGFIXES), and if you have a link to the OHRRPGCE homepage, perhaps you'll
actually remember to go there and look for new updates occasionally ;-)