=====================================
= G16ed - UnrealEd3 G16 file editor =
=====================================

Martin Bell
http://homepage.ntlworld.com/martingbell/


Brief:
=====
Windows PSP-like interface G16 editor for modifying UnrealEd3 heightmaps.
Not meant to replace the editor functionality in any way - that does a good enough job as it stands.

Main Features:
=============
 - Rotate & flip all/sections of heightmap.
 - Easy ramp creation.
 - Cut/copy/paste/crop sections of heightmap.
 - Import raw data (8/16/24/32 bit big/little-endian), 8-bit greyscale bmp.
 - Export raw data (8/16/24/32 bit big/little-endian), 8-bit greyscale bmp.
 - Resize heightmap to specified dims.
 - Add/Replace/Subtract fractal noise to selection.
 - Multilevel zoom with mousewheel.
 - One level undo.

UT2003 Usage:
============
1. Export your G16 heightmap from UEd3 as .bmp
2. Run G16ed and load in the heightmap.
3. Edit away ;)
4. Save and then reimport the heightmap into the myLevel texture package.


Tools:
=====

Selections:
----------
Allows rotation/flip/cut/copy of the (non floating) selection.
Select a rectangle with LMB, copy/move/modify as a floating selection with LMB.
Cut/copy/paste works in similar way to Paintshop Pro - you paste a 'floating selection' that isn't fixed until you either make a new selection, fix it (Enter), or discard it (Esc).
Set the current fill height with Ctrl+LMB on the heightmap (~pipette function).
Drag the % button on the toolbar left / right to set a new fill level.


Watch the status bar at the bottom-left for help.


Tool options dialog:
===================

Noise Generation
----------------
Allows you to add/replace/subtract noise in the current selection.
 - Strength: The percentage magnitude of the produced noise (1=small height, 100=full).
 - Frequency: The percentage 'roughness' of the noise produced (0=large hills, 100=many small hills).
 - Combine mode (how the noise will be combined to the current selection):
	Replace: The selection heightmap data will be totally replaced.
	Add: The noise will be added to the current heightmap.
	Subtract: The noise data will be subtracted from the current heightmap.

Gradient
--------
Allows quick drawing of ramps (currently constrained to 90 degrees only :P ).
Currently, just joins the start and end heights with a ramp, (either linear or sinusoidal smoothing).

Note: A lot of controls on the dialogs are disabled - they are future enhancements on my todo list ;)


Comments/suggestions/bugs/requests to: (see the Help->About dialog)
For the latest version go to: http://homepage.ntlworld.com/martingbell/


Notes:
-----
Still in development!

There are no other programs I found that allow manipulation of 16-bit grayscale images.  Photoshop can load them but doesn't allow editing in 16 bits.
Of course, with 24/32-bit colour it is currently impossible to display 16-bit grayscale as we are stuck with 256 possible shades, so this is what is displayed on-screen, while the actual operations are carried out with full 16 bit accuracy.


Todo:
----

Scrolling in the main window.
Implement the disabled dialog controls.
Erm, lots of other things :P


Sad disclaimer thingy:
I take no responsibility whatsoever for loss of data caused by this program :P
Use at own risk!  Running this app is your acceptance of this!


Thanks to:
---------
KGB - Feedback.
D.Kimber/Mr.Carnival - Suggestions.
UnrealWiki/Tarquin - Improvement suggestions.


Change History:
--------------

1.46.0 - 27 March 2009
 Allow any size of heightmap.

1.45.0 
 Added export 8-bit greyscale bmp.
 Added menu options and keys for zoom.
 Made RAW import dialog more intelligent (guesses pixel size).
 Fixed some minor bugs.

1.43
 Import 8-bit greyscale bitmaps.

1.42
 Import RAW data.  Selection tweaks.

1.4
 Interface overhaul.