NoesisGUI和WPF / UWP之间的区别

本指南适用于来自XAML，Silverlight，Xamarin或UWP之类的XAML体系结构的用户。熟悉这些体系结构对于精通NoesisGUI无疑是非常有帮助的。在以下各节中，我们将分析Noesis与其他XAML风格的不同之处，以及将项目迁移到Noesis时应将重点放在哪里。如果你不熟悉XAML，那么你可以跳过本教程并继续阅读其余教程。

Noesis基于WPF

NoesisGUI的设计考虑了WPF。当我们开始这个项目时，我们爱上了WPF的体系结构，但是我们希望它更快，针对实时和多平台进行优化。NoesisGUI从头开始编程为轻量级且没有外部依赖性。NoesisGUI如此深深地基于WPF，以至于我们总是推荐出色的WPF Unleashed作为参考手册。

如果您打算将项目转换为NoesisGUI，我们建议的第一件事是将Visual Studio解决方案移植到WPF。这比直接从其他XAML平台（例如UWP或Xamarin）跳转要容易得多。

NoesisGUI中有两种概念上不同的API，即Framework API和Integration API。

框架API(Framework API)

这是API，用于公开诸如Controls和Panels的高级对象。它还公开了相应的序列化文档XAML格式，这是所有体系结构中的关键部分。该框架 API尝试设计为越类似于WPF越好。我们发布的每个版本都越来越接近WPF。实际上，任何与WPF的偏差都被视为错误(Bug)，如果在Noesis中遇到这种情况，建议您提交错误(Bug)。

如果使用的是C＃API，则该接口与WPF中的接口几乎相同。作为基于C＃的WPF，我们的C ++ API有所不同，并进行了调整，使其更加原生。我们需要添加诸如反射，委托和可为空的关键概念。这些详细信息在《C ++体系结构指南》中有详细描述。

我们的类层次结构索引与语言无关，并且公开了Integration API中包含的所有类。如果您想知道Noesis是否实现了某些东西，那么您应该首先在这里看看。

整合API(Integration API)

Noesis Core库是一个与操作系统无关的低级组件，需要为其提供有关如何渲染，如何加载资源，如何打开URI等信息。这些任务对应于在Noesis.GUI命名空间下的IntegrationAPI.h头中公开的Integration API 。如果要将Noesis集成到您自己的引擎中，则需要了解此API。集成教程中对此进行了详细描述。如果您在Unity或Unreal之类的引擎中使用Noesis，那么集成已经完成，您无需担心。

我们还提供了一个与集成API交互的应用程序框架，以提供一个类似于WPF的应用程序模型，其概念包括应用程序（App.xaml）和窗口（Window.xaml）。C ++和C＃SDK中的所有示例均使用此框架。

Integration API和Framework API 之间的连接由View执行。一查看封装的交互和视觉树的渲染成一个GPU表面。视图是线程公寓，您可以将它们视为独立的WPF API。在“ 渲染体系结构”文档中对它们进行了更详细的描述。

Noesis不限于WPF

尽管基于WPF，但NoesisGUI还以Noesis扩展的形式实现了来自其他XAML风格的概念。这些扩展是作为核心库的一部分实现的，也作为NuGet包公开以在Blend项目中使用。在许多情况下，这些Blend扩展是空的实现，只是为了避免WPF项目中的编译错误。例如，使用NoesisGUI可以使用stroke渲染文本， WPF中的相应扩展名不会渲染该效果。这些扩展的源代码也可以在GitHub上获得。在那里，您会找到扩展，例如Silverlight的3D转换和UWP的游戏手柄支持。这套扩展将随着NoesisGUI的每个新版本而不断增长。

代码背后的差异

在WPF中，Visual Studio自动生成部分代码隐藏并将其存储在隐藏的.g.cs文件中。在NoesisGUI中，这不会自动完成，至少目前还不会自动完成。您必须按照事件教程中的说明，手动连接事件并在“隐藏代码”中按名称查找元素。

我们建议使用预处理器宏来处理这些差异：

C＃

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();
    }

#if NOESIS
    TextBox Address;
    TextBlock EntryTitle;
    TextBlock EntryDesc;

    private void InitializeComponent()
    {
        GUI.LoadComponent(this, "MainWindow.xaml");

        this.Address = (TextBox)FindName("Address");
        this.EntryTitle = (TextBlock)FindName("EntryTitle");
        this.EntryDesc = (TextBlock)FindName("EntryDesc");
    }
#endif
}

命名空间差异

所有框架类都在NoesisGUI 的Noesis命名空间内定义。这在WPF中有所不同，在WPF中，类分布在多个名称空间之间。

C＃

#if NOESIS
    using Noesis;
#else
    using System;
    using System.Windows;
    using System.Windows.Controls;
#endif

渲染差异

NoesisGUI针对呈现动态接口进行了优化，而WPF针对静态高质量接口进行了优化。WPF使用复杂的算法以完美的抗锯齿质量渲染矢量，而NoesisGUI则将界面渲染为视频游戏引擎。几乎不使用位图缓存，几乎所有接口都是按帧呈现的。必须准备一个具有GPU意识的现代UI中间件，以便在每个帧上绘制每个像素。您可以在我们在Gamasutra上发表的文章中找到有关此问题的更多详细信息：定义下一代用户界面。

性能折衷

作为NoesisGUI的多平台库，必须采取一些折衷措施才能在所有受支持的设备上有效地进行渲染：从低端移动设备到高性能游戏机。

浮点数

WPF使用double几乎所有的定点性能，同时NoesisGUI采用float为相同的属性。例如，FrameworkElement的ActualWidth属性在WPF中为double，但在NoesisGUI中为float。如果您使用C＃SDK并在WPF和Noesis之间共享项目，我们建议使用别名来封装此差异。

C＃

#if NOESIS
    using Float = System.Single;
#else
    using Float = System.Double;
#endif

private void Slider_ValueChanged(object sender, RoutedPropertyChangedEventArgs<Float> e);
private void UpdateColor(Float r, Float g, Float b, Float a);

例外情况

由于NoesisGUI是针对性能进行了优化的C ++核心库，因此代码在编译时已禁用Exceptions和RTTI。这意味着与WPF相比，Noesis不会引发异常来通知错误。在几乎所有情况下，Noesis中的错误都不是致命的，并且在将有关程序的信息发送到在初始化时设置的用户回调之后，程序可以继续执行。

相反，构建在C ++之上的C＃层使用异常来通知这两个层之间的通信中发生的严重错误。

应用词典

应用程序词典是您在WPF应用程序的App.xaml中找到的ResourceDictionary。

XAML

<Application xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
  <Application.Resources>
    <ResourceDictionary>
      <SolidColorBrush x:Key="Background0" Color="#FF2F3F4F" />
      <SolidColorBrush x:Key="Background1" Color="SlateGray" />
      <SolidColorBrush x:Key="Foreground0" Color="White" />
      <SolidColorBrush x:Key="Foreground1" Color="SkyBlue" />
      <SolidColorBrush x:Key="Foreground2" Color="Black" />
      <SolidColorBrush x:Key="Border" Color="LightSlateGray" />
    </ResourceDictionary>
  </Application.Resources>
</Application>

在所有XAML之间共享的应用程序范围资源字典是优化加载时间和内存使用的建议之一。为此，Integration API公开了Noesis :: GUI :: SetApplicationResources。有关如何设置全局样式的更多信息，请参见 样式教程。

主题

默认情况下，WPF使用操作系统提供的主题。在Noesis中，我们不为此使用操作系统。默认情况下，提供了支持所有核心控件的简约主题，该主题嵌入在核心库中。这解释了为什么默认情况下Blend和Noesis生成的渲染不同。如果您想要Blend中的默认主题，则在初始化应用程序时需要覆盖它。例如：

C＃

public partial class App : Application
{
    public App()
    {
        // NoesisTheme added to Application.Resources to have same look as Noesis
        ResourceDictionary theme = (ResourceDictionary)LoadComponent(new Uri("NoesisTheme.xaml", UriKind.Relative));
        Resources.MergedDictionaries.Insert(0, theme);
    }
}

NoesisTheme.xaml是NuGet中提供的Extensions包的一部分。