osfmk/console/panic_ui/README

   1 Creating a Panic UI image (either the default or loadable)
   2
   3 The key steps are: create an indexed image using the MacOS X system 8 clut, saved
   4 in QuickTime uncompressed 256 color format. Run it through the genimage tool
   5 to create a C structure or a kernel loadable file.
   6
   7
   8 ===== Create the image
   9
  10 Using an application like Photoshop, create an image to be used as the image
  11 displayed at panic time. Your selection of colors is limited to those found in
  12 the MacOS X system 8 clut; in the application you're using, make sure you are
  13 in "indexed mode" and that the supplied CLUT (appleClut8.act) has been selected.
  14
  15 * The appleClut8.act is the default Mac OS X CLUT.
  16
  17 Keep in mind the following.
  18
  19 * There must be at least 20 lines at the bottom of the image reserved.  This is
  20 used by the system for displaying extra panic information.  There can be more than
  21 20 lines, but you'll have to provide this information when generating the image for
  22 the kernel.
  23
  24 * You must determine the colors used by the font for displaying the panic information.
  25 There are forground and background colors.  The default foreground is "100% White".
  26 It is represented by a 24-bit value of 0xFFFFFF.  The default background is
  27 "13% White, or Dark Gray".  It is represented by a 24-bit value of 0x222222. To change
  28 the defaults, you'll have to provide this information when generating the image for
  29 the kernel.
  30
  31 Save the completed image as a TIFF (still indexed off the CLUT).
  32
  33
  34 ===== Convert the TIFF indexed image to QuickTime RAW
  35
  36 Using Preview, open the TIFF image. Use File:Export to save the TIFF image in
  37 QuickTime image format with options of "None" for compression and "256 Colors"
  38 for the depth.  Quality should be "Best".  The saved results should be a .qtif
  39 formatted RAW image.
  40
  41
  42 ===== Generate an image for the kernel.
  43
  44 To generate the default kernel panic image file "panic_image.c", in your working
  45 directory, execute:
  46
  47 genimage -i <your .qtif image> -n <lines> -fg <24-bit color> -bg <24-bit color>
  48 ** options other than -i are optional.
  49
  50 To genertate a kernel loadable panic image file, execute:
  51
  52 qtif2kraw -i <your .qtif image> -o <your .kraw file> -n <lines> -fg <24-bit color> -bg <24-bit color>
  53 ** options other than -i and -o are optional.
  54
  55
  56
  57 ===== Other Info
  58
  59 The reason an 8-bit image was choosen, was because it is easy to convert to 24 or 16 bit colors.
  60 The system does not typically run in 8-bit mode.  If the system is in 8-bit mode.  Then we have
  61 to check to see if the active CLUT is the same as the one that the image was created with.  If the
  62 CLUTs are different.  The image is converted to grayscale and the nearest matching gray in the active
  63 CLUT is used.
  64
  65