| 1 | <?xml version='1.0' encoding='UTF-8'?>
|
|---|
| 2 | <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|---|
| 3 | <topic xml:lang="en-us" id="customvesa">
|
|---|
| 4 | <title>Custom VESA Resolutions</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p>
|
|---|
| 8 | Apart from the standard VESA resolutions, the <ph conkeyref="vbox-conkeyref-phrases/product-name"/>
|
|---|
| 9 | VESA BIOS enables you to add up to 16 custom video modes which
|
|---|
| 10 | will be reported to the guest operating system. When using
|
|---|
| 11 | Windows guests with the <ph conkeyref="vbox-conkeyref-phrases/product-name"/> Guest Additions, a custom
|
|---|
| 12 | graphics driver will be used instead of the fallback VESA
|
|---|
| 13 | solution so this information does not apply.
|
|---|
| 14 | </p>
|
|---|
| 15 | <p>
|
|---|
| 16 | Additional video modes can be configured for each VM using the
|
|---|
| 17 | extra data facility. The extra data key is called
|
|---|
| 18 | <codeph>CustomVideoMode<varname>x</varname>
|
|---|
| 19 | </codeph>
|
|---|
| 20 | with <varname>x</varname> being a number from 1 to 16.
|
|---|
| 21 | Please note that modes will be read from 1 until either the
|
|---|
| 22 | following number is not defined or 16 is reached. The following
|
|---|
| 23 | example adds a video mode that corresponds to the native display
|
|---|
| 24 | resolution of many notebook computers:
|
|---|
| 25 | </p>
|
|---|
| 26 | <pre xml:space="preserve">$ VBoxManage setextradata <varname>VM-name</varname> "CustomVideoMode1" "1400x1050x16"</pre>
|
|---|
| 27 | <p>
|
|---|
| 28 | The VESA mode IDs for custom video modes start at
|
|---|
| 29 | <codeph>0x160</codeph>. In order to use the above defined
|
|---|
| 30 | custom video mode, the following command line has to be supplied
|
|---|
| 31 | to Linux:
|
|---|
| 32 | </p>
|
|---|
| 33 | <pre xml:space="preserve">vga = 0x200 | 0x160
|
|---|
| 34 | vga = 864</pre>
|
|---|
| 35 | <p>
|
|---|
| 36 | For guest operating systems with <ph conkeyref="vbox-conkeyref-phrases/product-name"/> Guest Additions,
|
|---|
| 37 | a custom video mode can be set using the video mode hint
|
|---|
| 38 | feature.
|
|---|
| 39 | </p>
|
|---|
| 40 | </body>
|
|---|
| 41 |
|
|---|
| 42 | </topic>
|
|---|
