<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<title>javahexeditor User Guide</title>
</head>
<body>
<div class="content" style="float:left; width:20%">
<a href="http://sourceforge.net">
<img src="http://sflogo.sourceforge.net/sflogo.php?group_id=165536&type=2" width="125" height="37"
border="0" alt="SourceForge.net Logo" /></a>
<ul class="menu">
<li class="leaf"><a href="http://sourceforge.net/projects/javahexeditor/">Home</a></li>
<li class="leaf"><a href="http://sourceforge.net/project/showfiles.php?group_id=165536">Download</a>
</li>
<li class="leaf"><a href="http://sourceforge.net/forum/?group_id=165536">Mailing Lists</a></li>
</ul>
</div>
<div style="float:right; width:80%; padding-left:20">
<h1><em>javahexeditor</em> User Guide</h1>
<br/>
<b>Introduction</b>
<p>
<em>javahexeditor</em> is a
<a href="http://java.sun.com">java</a>
<a href="http://www.bellevuelinux.org/hex_editor.html">hex editor</a>.
It is released as a standalone application (<a href="http://www.eclipse.org/swt">SWT</a>
widgets) and
<a href="http://www.eclipse.org">Eclipse</a> plugin. It has support for very large files;
hex, Ascii and Unicode find; overwrite/insert modes; binary and text cut/copy/paste; undo/redo.
</p><br/>
<b>Installation Notes</b>
<p>
There are three different possible ways to run <em>javahexeditor</em>:<br/>
1- Precompiled in a 32-bit Windows operating system.<br/>
2- Standalone java application.<br/>
3- Plugin for Eclipse.<br/>
</p><br/>
<p>
Requirements for <em>javahexeditor</em> precompiled:<br/>
- 32-bit Windows operating system.<br/>
<br/>
Installation of <em>javahexeditor</em> precompiled:<br/>
- Not needed, just double-click on <code>javahexeditor-win32_x.y.z.exe</code><br/>
</p><br/>
<p>
Requirements for <em>javahexeditor</em> standalone:<br/>
- Java 1.4 or later (<a href="http://java.sun.com">java.sun.com</a>).<br/>
- SWT 3.1 or 3.4 (<a href="http://www.eclipse.org/swt">www.eclipse.org/swt</a>).
Versions 3.2 or 3.3 might work as well.<br/>
<br/>
Installation of <em>javahexeditor</em> standalone:<br/>
- Create a new empty directory (folder).<br/>
- Unjar (unzip) the <code>net.sourceforge.javahexeditor_x.y.z.jar</code> file
contents into the directory.<br/>
- Unzip the SWT zip file (<code>swt-3.x-win32-win32-x86.zip</code> in Windows,
<code>swt-3.x-gtk-linux-x86.zip</code> in Linux) into the same directory.<br/>
- Windows users: Double-click on <code>gowin32.bat</code><br/>
Linux users: open a terminal (console), <code>cd</code> to the directory, make
<code>golinux</code> runnable (<code>chmod +x golinux</code>), and run it (<code>./golinux</code>)
<br/>
</p><br/>
<p>
Requirements for <em>javahexeditor</em> Eclipse plugin:<br/>
- Eclipse 3.1 or 3.4 (<a href="http://www.eclipse.org">www.eclipse.org</a>).
Versions 3.2 or 3.3 might work as well.<br/>
<br/>
Installation of <em>javahexeditor</em> Eclipse plugin:<br/>
- Copy the <code>net.sourceforge.javahexeditor_x.y.z.jar</code> file into the
plugins directory in your Eclipse installation.<br/>
- Restart Eclipse.<br/>
- Any file currently in the workspace (but not part of a jar file)
and with one of the extensions listed below can be opened with
<em>javahexeditor</em> by right clicking on the file name, expanding the
'Open With' menu option, and selecting <em>javahexeditor</em>.<br/>
- File extensions defined for use by <em>javahexeditor</em>: <code>a, bin, cab,
class, com, dat, data, drv, dll, exe, hex, iso, jar, lib, o, out,
part, pdf, png, ram, res, rom, sys, txt, zip</code>.<br/>
- Other file extensions can be added in the following preferences
dialog: Window -> Preferences... -> General (+) Editors (+) File
Associations<br/>
</p><br/>
<b>Open files</b>
<p>Use the File -> Open File... menu option.</p>
<p>Drag the file you want to open and drop it inside the editor area.</p>
<p>To start editing a new file from scratch use the File -> New menu option.</p>
<p>Specify the file to edit as a command parameter: <em>javahexeditor</em> reads just the first
parameter and interprets it as the file to open. One way this would be done is:<br/>(linux):
<code>java -cp .:swt.jar -Djava.library.path=. net.sourceforge.javahexeditor.Manager file.bin</code>
<br/>
(win32):<code>java -cp .;swt.jar -Djava.library.path=. net.sourceforge.javahexeditor.Manager
file.bin</code>
</p><br/>
<b>Browsing</b>
<p>You can move around the file as you would in any other text editor. To change from hex to text,
or vice versa, press the [Tab] key, or click the mouse in the appropriate area.
</p><p>
To locate a specific position within the file use the Goto dialog (Edit -> Go to Location... or
[Ctrl] L). This is especially useful when editing very big files and the scrollbar is not accurate
enough.
</p><p>
To select text move the cursor to the selection start and then press the [Shift] key when changing the cursor to the selection end.
</p><br/>
<b>Modifying</b>
<p>There are two modify modes: insert and overwrite. You can switch between insert/overwite modes
with the [Insert] key in your keyboard (as in some text editors, for instance).
</p><p>You can insert/delete/trim bytes in insert mode only. In overwrite mode the file length never
changes and you cannot paste things bigger than the space left in the file.
</p><p>
You can insert another file(s) by copying it (in explorer, for instance,
select the file and then Edit -> Copy), and pasting it (in <em>javahexeditor</em>,
Edit -> Paste).
</p><p>
Copying to a text editor has a limit of 4MBytes. Binary copying (from <em>javahexeditor</em> to
<em>javahexeditor</em>) is limited by disk space only.
</p><p>
Modified text is displayed in blue, so it is easier to see the changes made to the file.
</p>
<br /><br />
</div>
</body>
</html>
