Replacing Apple iOS graphics
The DME 4.x client for Apple iOS supports the following alternative background images, in Portrait and Landscape orientation:
To replace the built-in graphics on the DME client for iOS with your own, you need to create a new folder in the directory specified in the Local data directory field. The Local data directory is specified in the Server tab > Server configuration > Data > Data storage directories. See Data. The name of the folder must be:
/whitelabel/ios/
For instance, if the path specified in the Local data directory field is /usr/local/jboss-4.3.0.GA/server/base/filestore/, then you must open a terminal and create the following folder:
/usr/local/jboss-4.3.0.GA/server/base/filestore/whitelabel/ios/
Note that you must not change the value of the Local data directory field - the value in this field is for your information only so you know where to create the graphics folders.
Place the graphics in this folder. The graphics must be named according to the pattern in the tables below to be recognized correctly by the different supported types of Apple iOS devices.
To fit the background below the ios status bar and the toolbar, the size of the Swipe, Desktop, and AppBox backgrounds must be adjusted in the height.
These adjustments have been included in the list of required image sizes in the table below:
Orientation |
iOS device |
Filename |
Size (pixels) |
Portrait |
iPhone |
background_{module}.png |
320 x 416 |
|
iPhone w/Retina |
background_{module}@2x.png |
640 x 832 |
|
iPhone 5 |
background_{module}-568@2x.png |
640 x 1008 |
|
iPhone 6 |
background_{module}-667@2x.png |
750 x 1206 |
|
iPhone 6 Plus |
background_{module}-736@3x.png |
1242 x 2016 |
|
iPad (incl. mini) |
background_{module}~ipad.png |
768 x 960 |
|
iPad w/Retina |
background_{module}@2x~ipad.png |
1536 x 1920 |
Landscape |
iPhone |
background_{module}_landscape.png |
480 x 268 |
|
iPhone w/Retina |
background_{module}_landscape@2x.png |
960 x 536 |
|
iPhone 5 |
background_{module}_landscape-568@2x.png |
1136 x 536 |
|
iPhone 6 |
background_{module}_landscape-667@2x.png |
1334 x 646 |
|
iPhone 6 Plus |
background_{module}_landscape-736@3x.png |
2208 x 1050 |
|
iPad (incl. mini) |
background_{module}_landscape~ipad.png |
1024 x 704 |
|
iPad w/Retina |
background_{module}_landscape@2x~ipad.png |
2048 x 1408 |
Replace the {module} part of the filename with the following:
swipe. Note that there is no Landscape orientation for the Unlock pattern screen.desktopappboxThe Login screen background fills the whole screen, with no status bar or toolbar, and therefore use these sizes:
Orientation |
iOS device |
Filename |
Size (pixels) |
Portrait |
iPhone |
background_login.png |
320 x 480 |
|
iPhone w/Retina |
background_login@2x.png |
640 x 960 |
|
iPhone 5 |
background_login-568@2x.png |
640 x 1136 |
|
iPhone 6 |
background_login-667@2x.png |
750 x 1334 |
|
iPhone 6 Plus |
background_login-736@3x.png |
1242 x 2208 |
|
iPad (incl. mini) |
background_login~ipad.png |
768 x 1024 |
|
iPad w/Retina |
background_login@2x~ipad.png |
1536 x 2048 |
Landscape |
iPhone |
background_login_landscape.png |
480 x 320 |
|
iPhone w/Retina |
background_login_landscape@2x.png |
960 x 640 |
|
iPhone 5 |
background_login_landscape-568@2x.png |
1136 x 640 |
|
iPhone 6 |
background_login_landscape-667@2x.png |
1334 x 750 |
|
iPhone 6 Plus |
background_login_landscape-736@3x.png |
2208 x 1242 |
|
iPad (incl. mini) |
background_login_landscape~ipad.png |
1024 x 768 |
|
iPad w/Retina |
background_login_landscape@2x~ipad.png |
2048 x 1536 |
|
|
|
|
When the graphics have been placed in the /whitelabel/ios folder, shut down the DME client completely, and start it again. The custom graphics will then be used by DME. The client will check every 24 hours if the custom graphics have changed on the server, and update them if they have.