title: Xamarin.Forms ContentPage.BackgroundImage
body: <ul>
  <li>Xamarin.Forms </li>
  <li>VS2013 IDE</li>
  </ul>
  
  <p>I know there are other topics on this, but they don't answer my problem.</p>
  
  <p>For Android, the background image works fine.</p>
  
  <pre><code>BackgroundImage = Device.OnPlatform("Resources/HTbg@2x.png",
                                      "Drawable/HTMobile.png",
                                      "Images/HTMobile.png");
  </code></pre>
  
  <p>For iOS, I can't get it to work.</p>
  
  <ul>
  <li>I've tried the normal and retina versions of the image, which are of
  the correct dimensions for those screens.  </li>
  <li>I've tried placing them in the root folder of the project</li>
  <li>I've tried images with transparent or solid colored image backgrounds</li>
  </ul>
  
  <p>In iOS, the background image, in any of the scenarios above, just shows a white screen ontop of all the CustomContentPage controls. I comment out the background line of code, and my page shows normally, with all controls and navigations links...</p>
  
  <p>With the following code (no 'Resouces' folder), the page shows normally, but no image...</p>
  
  <pre><code>BackgroundImage = Device.OnPlatform("HTbg@2x.png",
                                      "Drawable/HTMobile.png",
                                      "Images/HTMobile.png");
  </code></pre>
  
  <p>How do you set the background image in iOS?
  For this answer, I need to know the following:</p>
  
  <ul>
  <li>Where do you put the image in the project so it's picked up properly?</li>
  <li>What type of image do you use? Size? Resolution? Color depth? Transparency? </li>
  <li>How do you let iOS 'know' what image to use if it's a 4s, 5s or 6/6+ iPhone?</li>
  </ul>
  
  <p><strong>EDIT</strong></p>
  
  <p>ContentPage.BackgroundImage is of type FileImageSource - meaning the correct resolution is loaded automatically; therefore the call should be...</p>
  
  <pre><code>BackgroundImage = Device.OnPlatform("HTbg.png",
                                      "Drawable/HTMobile.png",
                                      "Images/HTMobile.png");
  </code></pre>
  
  <p>But this still doesn't work. I'll add in the 4-inch image version and see if that helps...</p>