These are the available tags:
The <DefaultMenuLanguage>, <DefaultAudioLanguage> and <DefaultSubtitleLanguage> tags should be set to your preferred ISO-639 2-character language code. Depending on how the DVD uses these values you might get different languages when playing the dvd.
<ParentalCountry> and <ParentalLevel> are used by the DVD to choose what you will be allowed to watch.
<PlayerRegion> should be set to the region the DVD expects to be played in. An incorrect region might result in that the disc will refuse to play or show a screen telling you that you have the wrong region. This setting has nothing to do with the region setting of your DVD-ROM drive.
<path> is the path to your DVD-ROM drive
The audio driver to use, it can be one of 'oss', 'alsa', 'solaris', 'obsd' or 'null'.
If you choose 'null' no audio will be output. This can be useful if you don't have a soundcard.
The path to your audio device.
The name of the alsa device when using alsa.
<geometry_src> tells where to get the geometry from.
The geometry is the size (in millimeters) of your display. It can be set to "X11" or "user" not including the "". If set to "X11" the geometry will be delivered by your X-server. If your X-server isn't set up correctly it might deliver the wrong geometry resulting in an incorrect aspect (the picture will be stretched in some direction).
You can set the geometry manually by choosing "user" and filling in the <width> and <height> tags in the <geometry> section.
this tells that you have a monitor which has a width of 400 mm and a hight of 300 mm.
The resolution is the number of pixels (in x and y direction) your display has.
<resolution_src> tells where to get the resolution from.
It can be set to "X11", "XF86VidMode", "Xinerama" or "user", not including the "".
|"X11"||the resolution is taken from the X-server,|
|"XF86VidMode"||from the XF86VidMode extension (if you change resolution with <ctrl><alt><+/->)|
|"Xinerama"||if you use the Xinerama extension|
|"user"||if you want to force it manually to a certain resolution.|
When set to "user" you must fill in the correct values in the <horizontal_pixels> and <vertical_pixels> tags.
By using the "user" mode of both the <resolution> and <geometry> you can change the aspect of the picture and size. As an example, if you are using a tv-out output on your gfx-card to show the picture on a widescreen TV the following can be used. Assuming your gfx-card outputs 720x576 pixels to the tv-out when you have set the gfx-card to a resolution of 800x600.
The geometry should be the size of your tv in millimeters, the exact size isn't that important, as long as the proportions are correct. 1600/900 == 16/9 == widescreen tv. For a normal tv you should use something like 400/300.
This tells us to only use 720x576 pixels in fullscreen and not the entire space available on your monitor/desktop.
<initial_state> contains information about the state of the video window at start up. If <fullscreen> is set to yes, the video will start in fullscreen mode (default is no).
Autosave saves the position where you exit. Autoload starts the dvd at a previously autosaved position if available.
<digit_timeout>2</digit_timeout> Timeout between digits in a number entered. If you enter '1', '2' and the time between '1' and '2' is more than the timeout the final number will be 2, if the time is less the number will be 12.
<number_timeout>5</number_timeout> Timeout between a number entered and the action. If a number is entered and the time until the associated action key is pressed is greater than the timeout the number will not be used (reset).
<default_skiptime>60</default_skiptime> The default time used for the SkipForward/Backward actions
<prevpg_timeout>1</prevpg_timeout> When PrevPG(previous chapter) is pressed the first jump is to the beginning of the current chapter and if PrevPG is pressed again within the timeout the next jump will be to the beginning of the previous chapter. If prevpg_timeout is set to 0 the jump will be directly to the previous chapter. The timeout is in seconds.
<!-- Each binding contains an action and one or more keys.
The keys are given as X11 keysyms -->
Each binding binds a number of keys to an action. The keys are normal X11 keysyms. The available actions are the following:
|PauseToggle||space||Toggles pause on and off|
|Faster||period (.)||Increases the playback speed|
|Slower||comma (,)||Decreases the playback speed|
|NextPG||greater (>)||Jumps to the next program|
|PrevPG||less (<)||Jumps to the previous program|
|UpperButton||Up (Arrow up)||Used in navigating the menus|
|LowerButton||Down (Arrow down)||Used in navigating the menus|
|RightButton||Right (Arrow right)||Used in navigating the menus|
|LeftButton||Left (Arrow left)||Used in navigating the menus|
|ButtonActivate||Return, KP_Enter||Activates the selected button|
|TitleMenu||t||Jumps to the Title Menu|
|RootMenu||r||Jumps to the Root Menu|
|AudioMenu||a||Jumps to the Audio Menu|
|AngleMenu||A||Jumps to the Angle Menu|
|PTTMenu||P||Jumps to the Chapter Menu|
|SubtitleMenu||S||Jumps to the Subtitle Menu|
|SubtitleToggle||s||Toggles the subtitles on/off|
|FullScreenToggle||f, F||Toggles fullscreen mode on/off|
|Quit||q, Q||Quits Ogle|
|DigitZero||0,KP_0||0 (used to enter numbers)|
|BookmarkAdd||Insert||Adds a bookmark|
|BookmarkRemove||Del||Removes a bookmark (nr)|
|BookmarkRestore||b||Restores state from bookmark (nr)|
|SkipForward||Next(PageDown)||Skip x seconds forward (nr)|
|SkipBackward||Prior(PageUp)||Skip x seconds backward (nr)|
|SaveScreenshot||i||Saves a screenshot (.jpg)|
|SaveScreenshotWithSPU||I||Saves a screenshot including the subtitle/overlay graphics.|
|AudioStreamChange||z||Changes to the next audio stream (nr)|
|SubtitleStreamChange||x||Changes to the next subtitle stream (nr)|
The actions above that has (nr) in the description can take an optional number as argument.
The number is entered with the digit keys and then the key for the action is pressed.
To jump to the 3rd bookmark for the current dvd press '3' and then 'b' When you don't give any number to the bookmark actions they will use the entry at the end of the bookmark list by default or when an invalid number is entered.
Bookmarks will be saved in files in the directory $HOME/.ogle/bookmarks/
The SkipForward and SkipBackward actions use the number argument as the number of seconds to skip. The default value is 10 seconds. Entering '30' and then pressing Next(PageDown) will skip 30 seconds forwards. The Skip actions will use the last value entered for any following skips even if no number is entered. To get back to the default value, enter 0 and the skip.
The Audio- and SubtitleStreamChange actions use the number argument to switch directly to that stream, instead of cycling through the available streams.
In addition to the above the arrow buttons and mouse can be used to move around in the DVD menues. Return, the keypad enter and left mouse button may be used to activate a DVD button.
Cropping the picture can be done by pressing the middle mouse button at the upper left corner of the crop area and dragging it to the lower right corner and then release the button. To uncrop press and release the middle mouse button without dragging it around.