summaryrefslogtreecommitdiff
path: root/doc/manual/en_US/dita/topics/max-resolution-guests.dita
blob: 8beed05f9a94a225bf3f28ee841d9c307e383e90 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic xml:lang="en-us" id="max-resolution-guests">
  <title>Configuring the Maximum Resolution of Guests When Using the Graphical
        Frontend</title>
  
  <body>
    <p>
        When guest systems with the Guest Additions installed are
        started using the graphical frontend, the normal Oracle VM VirtualBox
        application, they will not be allowed to use screen resolutions
        greater than the host's screen size unless the user manually
        resizes them by dragging the window, switching to full screen or
        seamless mode or sending a video mode hint using
        <userinput>VBoxManage</userinput>. This behavior is what most users
        will want, but if you have different needs, you can change it by
        issuing one of the following commands from the command line:
      </p>
    <ul>
      <li>
        <p>
            Remove all limits on guest resolutions.
          </p>
        <pre xml:space="preserve">VBoxManage setextradata global GUI/MaxGuestResolution any</pre>
      </li>
      <li>
        <p>
            Manually specify a maximum resolution.
          </p>
        <pre xml:space="preserve">VBoxManage setextradata global GUI/MaxGuestResolution <varname>width</varname>x<varname>height</varname>
                        </pre>
      </li>
      <li>
        <p>
            Restore the default settings to all guest VMs.
          </p>
        <pre xml:space="preserve">VBoxManage setextradata global GUI/MaxGuestResolution auto</pre>
      </li>
    </ul>
  </body>
  
</topic>