Setting the application's desktop icon

You can specify custom application icons to be displayed in the desktop and other interfaces of the operating system.

The icon property of the application descriptor file specifies one or more icon files to be used for the application. Including an icon is optional. If you do not specify an icon property, the operating system will display a default application icon.

The path specified is relative to the application root directory. For the Apollo Alpha release, PNG, GIF, and JPEG formats are supported. To avoid scaling, you can specify all of the following icon sizes (16x16, 32x32, 48x48, 128x128):

 <icon>
     <image16x16>ApolloApp_16.png</image16x16>
     <image32x32>ApolloApp_32.jpg</image32x32>
     <image48x48>ApolloApp_48.gif</image48x48>
     <image128x128>ApolloApp_128.png</image128x128> 
 </icon>

If an image is specified, it must be the size specified or application installation will fail. If all sizes are not provided, the closest size will be scaled to fit for a given use of the icon by the operating system.

The SDK provides sample icons in the /samples/icons directory.

Back to: Apollo Documentation home page