A Bookmark is a set of bytes in a file that are marked as having special significance. Bookmarks may be interpreted as any of the standard data types or data types defined in a Binary Template, and edited with the Inspector. All bookmarks are persistent, meaning that created bookmarks will still exist after exiting and restarting 010 Editor. All bookmarks for the current file will be displayed in the Bookmarks tab of the Inspector (see Using the Inspector).

Adding Bookmarks

To add a bookmark, click the 'Search > Add/Edit Bookmark' menu option, or press Ctrl+B. The 'Add Bookmark' dialog will be displayed, which lists the attributes for the bookmark to create. To keep track of different bookmarks, a name can be assigned using the Name field, but this field is optional. Select the data type to interpret the bytes of the bookmark using the Type combo box. If a Binary Template has been run on the current file, the Type combo box will also include custom data types defined in the template (note that all bookmarks for a file using custom data types must come from the same Binary Template). If the bookmark to create is not an array, enter '(none)' or nothing in the Array Size field. To interpret the bookmark bytes as an array, enter the size in the Array Size field (note that a list of previously used sizes can be accessed by clicking the down arrow to the right of field). Select which endian should be used when interpreting the data (see Introduction to Byte Ordering) using the Little or Big toggles. By default, the endian will be the same endian as the file. If the Move Bookmark with Cursor toggle is enabled, the bookmark will move to the current cursor position every time the Hex Editor Window is clicked with the mouse or the cursor is moved with the cursor keys. This feature is useful to apply structures from a Binary Template to a file when the exact file format is not known.

The foreground color (text color), or background color of the bookmark can be chosen by clicking the color rectangles to the right of the Foreground or Background labels respectively. Clicking the color rectangle shows a drop-down list of colors. A new color for the bookmark can be chosen by clicking one of the colors in the list. Selecting None from the list means that the bookmark will not change the color. Click the More Colors... button from the drop-down list to select a different color using a standard color selection dialog.

The start address and size of bookmark to be created will be listed beside the Start Address and Size labels respectively. If no bytes were selected in the file when the 'Add Bookmark' dialog was opened, the Start Address will be the cursor position in the file, and the Size will be calculated from the Type and Array Size. If a selection was made when opening the dialog, the Start Address will be the start of the selection, and the Size will be the size of the selection (note that the Array Size will be adjusted automatically to try to fit inside the selection). When defining a bookmark using a custom data type from a Binary Template, sometimes the size cannot be calculated so the size will be displayed as '???'.

Click the OK button to create the bookmark, or the Cancel button to dismiss the dialog. The generated bookmarks will color the current file and be displayed in the Bookmarks tab of the Inspector. Note that when bookmarks are added to a file, that file will be displayed in the Bookmarked Files list in the Workspace (see Using the Workspace).

Editing Bookmarks

To edit a bookmark, position the cursor over a bookmark in a file, or select the bookmark from the Bookmarks tab of the Inspector. Clicking the 'Search > Add/Edit Bookmark' menu option or pressing Ctrl+B will display the above dialog will all the values from the selected bookmark. Change any values and click OK to apply the changes or Cancel to ignore the changes.

Removing Bookmarks

To remove a bookmark, place the cursor over the bookmark in the file or select the bookmark from the Bookmarks tab of the Inspector. Click the 'Search > Remove Bookmark' menu option or press Shift+Ctrl+B to remove the bookmark from the file. Alternately, all bookmarks can be removed from the file at once by clicking the 'Search > Clear All Bookmarks' menu option.

Searching for Bookmarks

To search for the next bookmark after the current cursor position, click the 'Search > Next Bookmark' menu option or press F2. If a bookmark is found it will be selected in the file. The search will wrap to the beginning of the file if no more bookmarks are found. Similarly, to search for the previous bookmark before the current cursor position, click the 'Search > Previous Bookmark' menu option or press Ctrl+F2.