【第三组】用例文档+功能说明书+技术说明书+(测试文档)，修改时间：2017/07/25

用例文档：

　　标题：切换夜间模式

　　角色：在昏暗环境下游玩的玩家

　　主要成功场景：

　　　　一、玩家从默认模式手动切换到夜间模式

　　　　步骤：

　　　　　　1）玩家点击option按钮跳转到设置界面

　　　　　　2）玩家点击夜间模式开关，界面变换为暗色

　　　　　　3）玩家点击返回按钮，发现所有界面均为暗色

　　　　二、保存夜间模式状态

　　　　步骤：

　　　　　　1）玩家已切换为夜间模式

　　　　　　2）玩家关闭程序

　　　　　　3）系统保存夜间模式状态

　　　　　　4）玩家重新打开程序，发现所有界面均为暗色

　　扩展场景：

　　　　自动夜间模式：程序根据系统时间自动切换主题颜色，此功能有开关

 

功能说明书：

　　目标：点击夜间模式开关，所有界面变换主题颜色

　　用户：在昏暗环境下游玩的玩家

　　术语：

　　　　1）Button: 按钮，有点击操作，用于跳转页面

　　　　2）ToggleButton: 切换按钮，有开关两种状态，可在默认模式和夜间模式之间切换

　　使用：

　　　　1）打开Geomystery

　　　　2）点击Option按钮，进入设置界面

　　　　3）点击Night Mode 开关，界面颜色从亮色切换到暗色

　　　　4）再次点击开关，界面颜色从暗色切换为亮色

　　　　5）再次点击切换为暗色，点击返回按钮，进入主界面

　　　　6）主界面为暗色背景

　　　　7）关闭Geomystery

　　　　8）第二次打开Geomystery

　　　　9）主界面依然为暗色背景

　　　　10）点击Option按钮，进入设置界面

　　　　11）点击Night Mode 开关，界面颜色从暗色切换到亮色

　　边界条件：

　　　　1）模式尽在设置界面切换

　　　　2）尽在程序正常关闭时可以保存夜间模式状态

 

技术说明书：

　　一、日间模式资源字典

　　　　同理，再创建一个夜间模式资源字典

　　　　注意每一个brush要定义key

<ResourceDictionary
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:Geomystery.Pages">
    <!--日间模式-->
    
    <!--浅橙色背景-->
    <SolidColorBrush x:Key="SystemBackgroundAltHighBrush" Color="#FFFEF2DA"/>
    <!--暗紫色背景-->
    <SolidColorBrush x:Key="SystemBackgroundBaseHighBrush" Color="#FF352D3A"/>
    <!--紫色文字-->
    <SolidColorBrush x:Key="TextColorPurple" Color="#FF644385"/>
    <!--粉紫色渐变-->
    <LinearGradientBrush x:Key="ColorGradient1" StartPoint="0,0" EndPoint="1,1">
        <GradientStop Color="#ffc954bf" Offset="0.0" />
        <GradientStop Color="#ff825be6" Offset="1.0" />
    </LinearGradientBrush>
    
    <Color x:Key="SystemTranslucentBaseHighColor">#FF000000</Color>
    <Color x:Key="SystemThemeMainColor">#FF0074CE</Color>

</ResourceDictionary>

　　　　然后需要把资源放在Page

    <Page.Resources>
        <ResourceDictionary>
            <ResourceDictionary.ThemeDictionaries>
                <ResourceDictionary x:Key="Light" Source="LightThemeDictionary.xaml"></ResourceDictionary>
                <ResourceDictionary x:Key="Dark" Source="DarkThemeDictionary.xaml"></ResourceDictionary>
            </ResourceDictionary.ThemeDictionaries>
        </ResourceDictionary>
    </Page.Resources>

　　二、ViewModel

　　　　建立ViewModel，其中ViewModel继承NotifyProperty

　　　　这个类主要是INotifyPropertyChanged

    public class NotifyProperty : INotifyPropertyChanged
    {
        public NotifyProperty()
        {
        }

        public void UpdateProper<T>(ref T properValue, T newValue, [CallerMemberName] string properName = "")
        {
            if (Equals(properValue, newValue))
            {
                return;
            }

            properValue = newValue;
            OnPropertyChanged(properName);
        }

        public async void OnPropertyChanged([CallerMemberName] string name = "")
        {
            PropertyChangedEventHandler handler = PropertyChanged;
            await CoreApplication.MainView.CoreWindow.Dispatcher.RunAsync(CoreDispatcherPriority.Normal,
                () =>
                {
                    handler?.Invoke(this, new PropertyChangedEventArgs(name));
                });
        }

        public event PropertyChangedEventHandler PropertyChanged;
    }

　　　　模式切换

　　　　ViewModel主要是属性ElementTheme Theme，ElementTheme 有Default，Light，Dark，就是要把key叫light和dark，这样就可以绑定ViewModel修改

    public class ViewModel : NotifyProperty
    {
        public ViewModel()
        {
            this.Theme= !APPDATA.app_data.ISNIGHT ? ElementTheme.Light : ElementTheme.Dark;
        }

        public ElementTheme Theme
        {
            get
            {
                return _theme;
            }
            set
            {
                _theme = value;
                OnPropertyChanged();
            }
        }

        public bool? AreChecked
        {
            set
            {
                _areChecked = value;
                Theme = value == false ? ElementTheme.Light : ElementTheme.Dark;
                OnPropertyChanged();
            }
            get
            {
                return _areChecked;
            }
        }

        private bool? _areChecked = true;

        private ElementTheme _theme = ElementTheme.Light;
    }

　　　　在xaml.cs中

private ViewModel.ViewModel View { set; get; }=new ViewModel.ViewModel();

　　　　在xaml中

<Page
    RequestedTheme="{x:Bind View.Theme,Mode=OneWay}">

        <Grid Background="{ThemeResource SystemBackgroundAltHighBrush}"> 
           <ToggleSwitch HorizontalAlignment="Center" Toggled="ToggleSwitch_OnToggled"></ToggleSwitch>
       </Grid>

　　三、全局配置与保存

　　　　新建一个APPDATA.cs

    public class APPDATA
    {
        public bool ISNIGHT { get; set; }
    }

        public void setNight()
        {
            app_data.ISNIGHT = !app_data.ISNIGHT;
            update_views();
        }

　　　　安装SQLite nutget和vs扩展

 

　　　　在APPDATA.cs中

        public static void SAVE()
        {
            string DbPath = Path.Combine(ApplicationData.Current.LocalFolder.Path, "APPDATA.db");
            var conn = new SQLiteConnection(new SQLitePlatformWinRT(), DbPath);
            conn.CreateTable<option_data>();// 创建 option_data 模型对应的表，如果已存在，则忽略该操作。
            var db = conn.Table<option_data>();
            var k = new option_data();
            if (db.Count() == 0) conn.Insert(k);
            else
            {
                conn.DeleteAll(typeof(option_data));
                conn.Insert(k);
            }
        }

 

补充的测试文档：

　　测试功能：求鼠标在屏幕上点击一点P

　　　　1）P附近如果有一条直线L，P到L的垂足与P到L最近的距离

　　　　2）P附近如果有一个圆C，P到C最近的距离，还有最近的距离点

　　　　　　（用来使屏幕上的点击“吸附”在点击附近的元素上）

　　单元测试类名：

　　　　Output Coordinate

　　单元测试时间：

　　　　

　　　　TestDistanceOfPointAndLine 　　　　 13毫秒

　　　　TestDistanceOfPointAndCircle   　　 < 1毫秒

　　单元测试函数：

　　　　点到直线距离公式

　　　　　　public void TestDistanceOfPointAndLine()

　　　　　　OutputCoordinate.DistanceOfPointAndLine(lpo, lv, outerPoint,ref result)

        [TestMethod]
        public void TestDistanceOfPointAndLine()
        {
            Vector2 lpo = new Vector2() { X = 0, Y = 10 };                  //直线上的点点
            Vector2 lv = new Vector2() { X = 1, Y = 1 } ;                   //直线方向向量（非0）
            Vector2 outerPoint = new Vector2() { X = 10, Y = 10 };          //直线上或者直线外的一点
            Vector2 result = new Vector2() { X = 1, Y = 1 };                //过outerPoint作l的垂线，result为垂足
            float distance = OutputCoordinate.DistanceOfPointAndLine(lpo, lv, outerPoint,ref result);   //点到直线距离
            Assert.AreEqual(distance,5 * Math.Sqrt(2), delta);
            Assert.IsFalse(result.X == 1);
            Assert.IsFalse(result.Y == 1);
            float dotMulti = Vector2.Dot(outerPoint - result, lv);          //垂线
            Assert.AreEqual(dotMulti, 0f, delta);
            Vector2 result2 = new Vector2();
            float distance2 = OutputCoordinate.DistanceOfPointAndLine(lpo, lv, result, ref result2);       //垂足在l上
            Assert.AreEqual(distance2, 0f, delta);
        }

点到圆距离公式

　　TestDistanceOfPointAndCircle()

　　OutputCoordinate.DistanceOfPointAndCircle(center, radius, outerPoint, ref result)

        [TestMethod]
        public void TestDistanceOfPointAndCircle()
        {
            Vector2 center = new Vector2() { X = 10, Y = 10 };              //圆心
            float radius = 5;                                           //半径（>0）
            Vector2 outerPoint = new Vector2() { X = 5, Y = 5 };        //圆外一点或圆内一点或圆上一点
            Vector2 result = new Vector2() { X = 0, Y = 0 };            //类似与垂足，result为圆上与outerPoint最接近的点(连接圆心与outerPoint并两端延长，与圆的最近的交点)
            float distance = OutputCoordinate.DistanceOfPointAndCircle(center, radius, outerPoint, ref result);     //点到圆最近的距离
            Assert.AreEqual(distance, 5 * Math.Sqrt(2) - 5, delta);
            Assert.IsFalse(result.X == 0);
            Assert.IsFalse(result.Y == 0);
            Vector2 result2 = new Vector2();
            float distance2 = OutputCoordinate.DistanceOfPointAndCircle(center, radius, result, ref result2);       //最近的点在圆上
            Assert.AreEqual(distance2, 0f, delta);
        }

 

 

　　单元测试结果：全部通过