# The configuration dialog

Here you can set global options for &EasySok;.

## The core settings

### Jump to next level when solved a level

If this box is checked, &EasySok; jumps to the next level in the collection, whenever you solve a level.

### Treat illegal moves as virtual moves

If this box is checked, illegal moves (for example when you try to move trough a wall) are treated as moves for the virtual keeper. Note that all moves are considered moves of the virtual keeper afterwards, until the virtual keeper becomes real.

### Wrap the virtual keeper

If this box is checked, the virtual keeper can cross the borders of the map. This means he will appear at the top, if you move him down at a field in the lowest line and so on.

### Allow goto to any level

If this box is checked, you are allowed to go to any level. If the box is unchecked, you can only go to solved levels or levels which directly follow a solved level.

### Always show advanced options

If this box is checked, the advanced options for complex dialogs are always shown.

### Automatic saving of collections, solutions and bookmarks

Here you can decide, if &EasySok; should automatically store changed collections, new solutions and changed bookmarks in regular intervals. If you don't check the option, than these are only stored when you exit &EasySok; (unfortunately only if you don't exit by a crash). If the option is checked on the other hand, then changed collection, solutions and bookmarks will be saved in regular intervals, which can specified by you.

### Number of recent collections

Here you can determine the number of collections which are displayed in the recent collections menu entry.

### Show difficulty

If this option is checked, the difficulty of the current level is shown in the status bar. Because this can make the status bar quite huge, you may want to disable it if you have only a small screen.

### Show linear pushes

If this option is checked, the number of linear pushes made so far is displayed in the status bar. Because this can make the status bar quite huge, you may want to disable it if you have only a small screen.

### Show gem changes

If this option is checked, the number of gem changes made so far is displayed in the status bar. Because this can make the status bar quite huge, you may want to disable it if you have only a small screen.

### Show gems left

If this option is checked, the number of gems left is displayed in the status bar.

### Show author

If this option is checked, the author(s) of the level are displayed in the status bar.

### Show user

If this option is checked, the current user (for the highscore server) is displayed in the status bar.

## The mouse settings

### Auto hiding of mouse cursor

Sometimes (especially if you play &EasySok; only via the keyboard) the mouse pointer stands in your way. Therefore &EasySok; lets you select, that the mouse cursor automatically disappears if not move for a specific ammount of time (or a key on the keyboard ist pressed). If you want you mouse cursor back, simply move the mouse.

### Mouse repeat delay

Here you can set the time after which the repeat of the undo and redo functionality (by pressing the &MMB; or &RMB;) is enabled.

### Mouse repeat rate

Here you can set the rate of the auto repeat of the undo and redo functionality of the mouse.

## The solver settings

### Number of solver steps in a row

Here you can set the number of steps the solver should perform without interruption. The higher the given value, the more slower the solver dialog will react on user input, but the higher the performance will be. Depending on your system, a value between 1,000 and 10,000 will be fine.

### Number of entries in the cache

The solver tries to memorize the position it has already visited, in order to increase the speed. Here you can set how large his memory (called the cache) should be. Larger values will result in more memory consumption, so you should probably start with values of about 10,000 and increase this value only, if &EasySok; doesn't uses to much memory.

## The bookmarks settings

### Number of bookmarks

Here you can adjust the number of bookmarks you want to use. Note that bookmarks which fall outside the range are not deleted, but merely invisible. You can can them by increasing the number of bookmarks later.

### Bookmark format

Here you can determine the format in which the bookmarks are displayed.

#### Date and Time information

Here you can select the date and time format used in the bookmarks text. The date and time is the one, when you last set the bookmark. You can either select, that no date and time information should be displayed, or that only the date or both date and time should be displayed.

#### Collection and level information

Here you can select which information about the level and the collection of the bookmark should be displayed. You can either select to show no information about the collection and level at all, only the collection name or the collection name and the level number.

#### Annotations

Here you can select, if you want your bookmark annotations to be displayed or not.

## The animation settings

Here you can fine tune the three animation speeds for fast, normal and slow animations. Note that depending on the operating system you use, a very small value (say 1 ms) will give you sluggish animations.

## The scaling settings

### The minimum size of a field

Here you can set the minimum size of the fields in pixels. &EasySok; will not create fields beyond the given size and instead will offer you to scroll the map in order to see the whole map.

### Scaling quality

&EasySok; tries to always use as much of the window size for the sokoban maps as possible. Therefore it scales the images to the needed sizes. Unfortunately a high quality scaling takes some time and a faster scaling method doesn't produces very good results. So &EasySok; offers you the option, to select between the two scaling methods. But there is also a third option. Here the fields are first produced in lower quality and after a predefined amount of time replaced by the high quality images. Because the reduced performance of the high quality scaling is mostly noticed if you sweep through the levels, this option is as fast as the low quality scaling for this operation. So if you don't mind, that the quality of the fields improves shortly after you stopped at a level, this is the method of choice.

## The confirmation settings

&EasySok; sometimes ask for confirmations, if you are performing a possible dangerous task. Normally every confirmation dialog has (or should have) a check box, which allows you to suppress the dialog in the future. And here you can activate a former disabled confirmation dialog again.