Silverlight Mobile Visualiser 1.0.0.0
Copyright (C) Whitter Technology 2008. All rights reserved.


This ReadMe file contains the following sections:

   1. Introduction
   2. How to use the Silverlight Mobile Visualiser (SlmVisualiser)
   3. Source code availability
   4. Licence Agreement
   5. Support


1. Introduction

   Microsoft has announced Silverlight 2 for Mobile which enables Windows Mobile based
   devices and selected Nokia devices to run Silverlight applications. The intention is
   to provide very high levels of compatibility with the desktop version of Silverlight
   which means that Silverlight mobile applications can be developed using the standard
   development tools provided for the desktop version of Silverlight. However, testing
   applications can be challenging as there is no easy way to test applications on the
   many device form factors and screen resolutions that are in common use or to test the
   behaviour of applications when the screen orientation changes dynamically; it will
   be some time before the initial Community Technology Preview (CTP) of Silverlight 2
   for Mobile is released. The Silverlight Mobile Visualiser was therefore produced to
   allow developers to test their Silverlight mobile applications very quickly, easily
   and effectively.


2. How to use the Silverlight Mobile Visualiser (SlmVisualiser)

   It is quick and easy to configure the Silverlight Mobile Visualiser:

   1  Create a new project using the "Silverlight Application" template

   2  Add a project reference to Silverlight.Mobile.Visualisers.dll

   3  Add a new page called SlmV.xaml using the "Silverlight User Control" template

   4  In SlmV.xaml:

      a) Add the Silverlight.Mobile.Visualisers and project namespaces to the root
         element, for example:

         xmlns:slmv="clr-namespace:Silverlight.Mobile.Visualisers;
            assembly=Silverlight.Mobile.Visualisers"
         xmlns:local="clr-namespace:SlmVisualiserDemo"

      b) Delete the Width and Height attributes from the root element

      c) Replace the Grid element with the following code:

         <slmv:SlmVisualiser>
            <local:Page />
         </slmv:SlmVisualiser>

   5  Open App.xaml.cs, locate the Application_Startup method and then change the
      following line of code:

         this.RootVisual = new Page();

      to:

         // Select the appropriate start page
         #if DEBUG
            this.RootVisual = new SlmV();
         #else
            this.RootVisual = new Page();
         #endif

   6  Open Page.xaml and change the following attributes of the root element:

         Width="400" Height="300"

      to:

         MinWidth="240" MinHeight="320"

      or, to support square resolutions, to:

         MinWidth="240" MinHeight="240"

   7  Add content as normal to Page.xaml


3. Source code availability

   This ReadMe file accompanies the Silverlight Mobile Visualiser library (DLL). If you
   would like to create new custom resolutions or new skins for the Silverlight Mobile
   Visualiser then the full Microsoft Visual Studio 2008 solution complete with the full
   source code for the Silverlight Mobile Visualiser is available for download free of
   charge from http://www.whittertechnology.com.


4. Licence Agreement

   This software is provided free of charge "as is" and without any form of warranty. You may
   use the software for both personal and commercial uses. You may redistribute the software
   library (DLL) and the source code Zip file provided that they are always accompanied by a
   copy of their ReadMe.txt file, that they are not modified in any way and that no charge is
   made for the software or for its distribution. You may not sell this software or any other
   software which is substantially similar to this software or which is based on it. If you
   are uncertain about any aspects of this Licence Agreement please send questions via email
   to info@whittertechnology.com.


5. Support

   This software is not formally supported. However, please feel free to send questions and
   feedback to info@whittertechnology.com and we will do our best to respond.