VirtualBox

Ignore:
Timestamp:
Oct 11, 2017 7:26:12 PM (7 years ago)
Author:
vboxsync
Message:

DevEFI: Easier configuration approach using a single CFGM entry, falling back to old configuration if not used. Turn EFI logging to LogRel2 (too chatty for normal use).
EFI/Firmware: Support for custom video modes (reusing existing DevVGA mechanism). Shuffle around the graphics mode initialization code to make sure the blanking is handled correctly.
Main/Console: Curresponding configuration using a single extradata entry.

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/doc/manual/en_US/user_BasicConcepts.xml

    r68977 r69054  
    14731473
    14741474      <para>EFI provides two distinct video interfaces: GOP (Graphics Output
    1475       Protocol) and UGA (Universal Graphics Adapter). Mac OS X uses GOP, while
    1476       Linux tends to use UGA. VirtualBox provides a configuration option to
    1477       control the framebuffer size for both interfaces.</para>
    1478 
    1479       <para>To control GOP, use the following
    1480       <computeroutput>VBoxManage</computeroutput> command: <screen>VBoxManage setextradata "VM name" VBoxInternal2/EfiGopMode N</screen>
    1481       Where N can be one of 0,1,2,3,4,5 referring to the 640x480, 800x600,
    1482       1024x768, 1280x1024, 1440x900, 1920x1200 screen resolution respectively.</para>
    1483 
    1484       <para>To change the UGA resolution: <screen>VBoxManage setextradata "VM name" VBoxInternal2/UgaHorizontalResolution 1440
    1485 VBoxManage setextradata "VM name" VBoxInternal2/UgaVerticalResolution    900</screen></para>
    1486 
    1487       <para>The video mode for both GOP and UGA can only be changed when the
    1488       VM is powered off and remains persistent until changed.</para>
     1475      Protocol) and UGA (Universal Graphics Adapter). Modern operating systems
     1476      (such as Mac OS X) generally use GOP, while some older ones still use
     1477      UGA. VirtualBox provides a configuration option to control the
     1478      graphics resolution for both interfaces, making the difference mostly
     1479      irrelevant for users.</para>
     1480
     1481      <para>The default resolution is 1024x768. To select a graphics resolution
     1482      for EFI, use the following <computeroutput>VBoxManage</computeroutput>
     1483      command:
     1484      <screen>VBoxManage setextradata "VM name" VBoxInternal2/EfiGraphicsResolution HxV</screen>
     1485      Determine the horizontal resolution H and the vertical resolution V from
     1486      the following list of default resolutions:</para>
     1487
     1488      <glosslist>
     1489        <glossentry>
     1490          <glossterm>VGA</glossterm>
     1491          <glossdef>
     1492            <para>640x480, 32bpp, 4:3</para>
     1493          </glossdef>
     1494        </glossentry>
     1495
     1496        <glossentry>
     1497          <glossterm>SVGA</glossterm>
     1498          <glossdef>
     1499            <para>800x600, 32bpp, 4:3</para>
     1500          </glossdef>
     1501        </glossentry>
     1502
     1503        <glossentry>
     1504          <glossterm>XGA</glossterm>
     1505          <glossdef>
     1506            <para>1024x768, 32bpp, 4:3</para>
     1507          </glossdef>
     1508        </glossentry>
     1509
     1510        <glossentry>
     1511          <glossterm>XGA+</glossterm>
     1512          <glossdef>
     1513            <para>1152x864, 32bpp, 4:3</para>
     1514          </glossdef>
     1515        </glossentry>
     1516
     1517        <glossentry>
     1518          <glossterm>HD</glossterm>
     1519          <glossdef>
     1520            <para>1280x720, 32bpp, 16:9</para>
     1521          </glossdef>
     1522        </glossentry>
     1523
     1524        <glossentry>
     1525          <glossterm>WXGA</glossterm>
     1526          <glossdef>
     1527            <para>1280x800, 32bpp, 16:10</para>
     1528          </glossdef>
     1529        </glossentry>
     1530
     1531        <glossentry>
     1532          <glossterm>SXGA</glossterm>
     1533          <glossdef>
     1534            <para>1280x1024, 32bpp, 5:4</para>
     1535          </glossdef>
     1536        </glossentry>
     1537
     1538        <glossentry>
     1539          <glossterm>SXGA+</glossterm>
     1540          <glossdef>
     1541            <para>1400x1050, 32bpp, 4:3</para>
     1542          </glossdef>
     1543        </glossentry>
     1544
     1545        <glossentry>
     1546          <glossterm>WXGA+</glossterm>
     1547          <glossdef>
     1548            <para>1440x900, 32bpp, 16:10</para>
     1549          </glossdef>
     1550        </glossentry>
     1551
     1552        <glossentry>
     1553          <glossterm>HD+</glossterm>
     1554          <glossdef>
     1555            <para>1600x900, 32bpp, 16:9</para>
     1556          </glossdef>
     1557        </glossentry>
     1558
     1559        <glossentry>
     1560          <glossterm>UXGA</glossterm>
     1561          <glossdef>
     1562            <para>1600x1200, 32bpp, 4:3</para>
     1563          </glossdef>
     1564        </glossentry>
     1565
     1566        <glossentry>
     1567          <glossterm>WSXGA+</glossterm>
     1568          <glossdef>
     1569            <para>1680x1050, 32bpp, 16:10</para>
     1570          </glossdef>
     1571        </glossentry>
     1572
     1573        <glossentry>
     1574          <glossterm>Full HD</glossterm>
     1575          <glossdef>
     1576            <para>1920x1080, 32bpp, 16:9</para>
     1577          </glossdef>
     1578        </glossentry>
     1579
     1580        <glossentry>
     1581          <glossterm>WUXGA</glossterm>
     1582          <glossdef>
     1583            <para>1920x1200, 32bpp, 16:10</para>
     1584          </glossdef>
     1585        </glossentry>
     1586
     1587        <glossentry>
     1588          <glossterm>DCI 2K</glossterm>
     1589          <glossdef>
     1590            <para>2048x1080, 32bpp, 19:10</para>
     1591          </glossdef>
     1592        </glossentry>
     1593
     1594        <glossentry>
     1595          <glossterm>Full HD+</glossterm>
     1596          <glossdef>
     1597            <para>2160x1440, 32bpp, 3:2</para>
     1598          </glossdef>
     1599        </glossentry>
     1600
     1601        <glossentry>
     1602          <glossterm>Unnamed</glossterm>
     1603          <glossdef>
     1604            <para>2304x1440, 32bpp, 16:10</para>
     1605          </glossdef>
     1606        </glossentry>
     1607
     1608        <glossentry>
     1609          <glossterm>QHD</glossterm>
     1610          <glossdef>
     1611            <para>2560x1440, 32bpp, 16:9</para>
     1612          </glossdef>
     1613        </glossentry>
     1614
     1615        <glossentry>
     1616          <glossterm>WQXGA</glossterm>
     1617          <glossdef>
     1618            <para>2560x1600, 32bpp, 16:10</para>
     1619          </glossdef>
     1620        </glossentry>
     1621
     1622        <glossentry>
     1623          <glossterm>QWXGA+</glossterm>
     1624          <glossdef>
     1625            <para>2880x1800, 32bpp, 16:10</para>
     1626          </glossdef>
     1627        </glossentry>
     1628
     1629        <glossentry>
     1630          <glossterm>QHD+</glossterm>
     1631          <glossdef>
     1632            <para>3200x1800, 32bpp, 16:9</para>
     1633          </glossdef>
     1634        </glossentry>
     1635
     1636        <glossentry>
     1637          <glossterm>WQSXGA</glossterm>
     1638          <glossdef>
     1639            <para>3200x2048, 32bpp, 16:10</para>
     1640          </glossdef>
     1641        </glossentry>
     1642
     1643        <glossentry>
     1644          <glossterm>4K UHD</glossterm>
     1645          <glossdef>
     1646            <para>3840x2160, 32bpp, 16:9</para>
     1647          </glossdef>
     1648        </glossentry>
     1649
     1650        <glossentry>
     1651          <glossterm>WQUXGA</glossterm>
     1652          <glossdef>
     1653            <para>3840x2400, 32bpp, 16:10</para>
     1654          </glossdef>
     1655        </glossentry>
     1656
     1657        <glossentry>
     1658          <glossterm>DCI 4K</glossterm>
     1659          <glossdef>
     1660            <para>4096x2160, 32bpp, 19:10</para>
     1661          </glossdef>
     1662        </glossentry>
     1663
     1664        <glossentry>
     1665          <glossterm>HXGA</glossterm>
     1666          <glossdef>
     1667            <para>4096x3072, 32bpp, 4:3</para>
     1668          </glossdef>
     1669        </glossentry>
     1670
     1671        <glossentry>
     1672          <glossterm>UHD+</glossterm>
     1673          <glossdef>
     1674            <para>5120x2880, 32bpp, 16:9</para>
     1675          </glossdef>
     1676        </glossentry>
     1677
     1678        <glossentry>
     1679          <glossterm>WHXGA</glossterm>
     1680          <glossdef>
     1681            <para>5120x3200, 32bpp, 16:10</para>
     1682          </glossdef>
     1683        </glossentry>
     1684
     1685        <glossentry>
     1686          <glossterm>WHSXGA</glossterm>
     1687          <glossdef>
     1688            <para>6400x4096, 32bpp, 16:10</para>
     1689          </glossdef>
     1690        </glossentry>
     1691
     1692        <glossentry>
     1693          <glossterm>HUXGA</glossterm>
     1694          <glossdef>
     1695            <para>6400x4800, 32bpp, 4:3</para>
     1696          </glossdef>
     1697        </glossentry>
     1698
     1699        <glossentry>
     1700          <glossterm>8K UHD2</glossterm>
     1701          <glossdef>
     1702            <para>7680x4320, 32bpp, 16:9</para>
     1703          </glossdef>
     1704        </glossentry>
     1705
     1706      </glosslist>
     1707
     1708      <para>If this list of default resolution does not cover your needs, see
     1709      <xref linkend="customvesa" />. Note that the color depth value specified
     1710      in a custom video mode must be specified (8, 16, 24 and 32 are accepted),
     1711      but it is silently assumed to be 32 by EFI.</para>
     1712
     1713      <para>The EFI default video resolution settings can only be changed when
     1714      the VM is powered off.</para>
    14891715    </sect2>
    14901716
Note: See TracChangeset for help on using the changeset viewer.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette