Configure graphical console

  console [--x <width>] [--y <height>]
          [--left <left margin>] [--right <right margin>]
          [--top <top margin>] [--bottom <bottom margin>]
          [--depth <colour depth>]
          [--picture <background picture>] [--keep]

  console --x 1024 --y 768

  console --picture http://boot.ipxe.org/ipxe.png

  console --picture http://boot.ipxe.org/texture.png --left 32 --right 32 --top 32 --bottom 48

  console

Configure the console with the specified width, height, margins, colour depth, and background picture. All distances are specified in pixels. The width, height, and colour depth are specified as minimum requirements; the actual values used may be higher than specified. If a background picture is used then the width and height may be omitted; the console size will then be chosen based on the size of the background picture.

The background picture will be discarded after configuring the console unless the --keep option is specified.

Any non-zero margins are treated as being relative to the specified minimum width and height.

• colour
• cpair
• Console configuration in iPXE
• List of all iPXE commands

This command is available only when the build option CONSOLE_CMD is enabled.

Support for graphical consoles is available only when the relevant build options (e.g. CONSOLE_FRAMEBUFFER for the graphical framebuffer console) are enabled.

Support for background pictures is available only when the relevant build options (e.g. IMAGE_PNG for PNG images) are enabled.

You can use the console command (with no options) to reset the console and clear the screen.

To select the graphical framebuffer console you must either specify a width and height, or specify a background picture.

You can use the margins to define a text area within a background picture. For example, you could place your company logo in the top right corner, and specify a top margin to ensure that iPXE's text does not overwrite your logo.

You can use the colour and cpair commands to change the text colour scheme to match your background picture.

You can use the --keep option if you intend to reuse the same background image in a future console command, to avoid downloading the image a second time.