Image Specifications

Images are referenced by strings in the following formats:

  • if a string starts with "http:," it will be recognized as a link to an ordinary external URL (Qubes 5.4);
  • if it starts with "https:," it will be recognized as a link to an ordinary external URL (Qubes 6.0);
  • if it starts with "stdico:," it will be recognized as a standard Qubes icon image (Qubes 5.6);
  • if it starts with "folio:," it will be recognized as an image from a folio, in the format "folio:DocID/imageName" (Qubes 5.6);
  • if it starts with "/," it will be recognized as a link to the current HTTP server's root (web process context: Qubes 5.6);
  • if it starts with "." (or ".."), it will be recognized as a link to the current HTTP path (web process context: Qubes 5.6);
  • otherwise, it will be interpreted as the name of one of the resources on the screen.

Examples for remote images

If you want to display the satellite image of France from an external HTTP server, the Image property will be:
"http://www.sat24.com/image.ashx?country=fr&type=loop&sat=vis"

In the context of a web process:

  • if you want to display the logo associated with the Qubes database, which is accessible at the root of QubesExpress, the Image property will be:
    "/COMPANYLOGO.QICO"
  • if you want to display a background.png image defined in the Img element of the same web process, the Image property will be:
    "./Img?background.png"
  • if you want to display a background.png image defined in the Img element of another web process, WP001, the Image property will be:
    "/WebProcess.cit/WP001/Img?background.png"

List of standard icons

The list of standard icons can be accessed at the URL /list.stdico, called from a Qubes web server (QubesExpress, QubesEpon, Xforms in test mode, web process in test mode, etc.).