C#探索笔记

1.C#与GDScirpt
Godot的Mono版本同时支持这两种编程语言。C#需要运行在一个叫做Dot（一个小圆点）NET的框架上，而Mono是这个框架的一个开源实现，可以跨平台。Godot3.3中用的是Mono6.12，支持C# 8.0的语法。
（1）使用C#的好处
C#是一种流行的通用编程语言，因此可以使用C#的标准库
（2）使用C#的坏处
容易卡住
（3）查看运行时
System.Runtime.InteropServices中的RuntimeInformation.FrameworkDescription可以查看运行时，除此之外，还有一个Environment.Version返回的是CLR的版本。

2.基本使用
（1）生成解决方案
在新建项目后，不会自动地生成解决方案，在第一次新建C#脚本并构建的时候，会自动生成解决方案，然后就可以用Visual Studio打开了。
（2）可以使用的库
在C#中，这个被称作namespace，可以使用using引入。除了可以使用Godot提供的库，也可以使用标准库。
（3）和GDScript的区别
除了语法和命名有所不同之外，和GDScript差不多。正所谓入乡随俗，C#起初是由某企业开发的，他们习惯于将方法的所有单词的首字母大写，因此Godot的C#库（以下简称为Godot#）也遵循这种格式去命名，并且每个单词的名称都没有发生变化。
一些GDScript中的类型，例如PoolByteArray在Godot#中并没有提供，这些类型需要使用一些C#中的代替方法，例如声明一个byte的数组；一些类型，例如Vector2在Godot#中有提供，需要与标准库中的Vector2相区别。
（4）区别的方式
当导入的多个namespace中有同名时，可以在该使用该名称的地方，在名称前加上它所在的namespace和一个点。
（5）导出
导出时，会发现比标准版的导出多了一个文件夹，删除这个文件夹，一般不会影响程序的运行。

3.Nuget以及使用OpenCVSharp
上一次写了一个用C++使用OpenCV的方法，但是由于直接使用C++十分的麻烦，于是就有了这一节。
（1）Nuget
Nuget是一个包管理器，有了它就能下载很多好用的东西了，这样就不需要造轮子了。
（2）添加项目引用
OpenCVSharp是一个OpenCV的C#实现，可以使用Nuget安装，完成下载后将两个dll添加为项目的引用。还有一个OpenCVSharp.Runtime，这是运行时，需要手动复制到程序的运行目录下。
（3）参考代码
假设场景中有一个叫做Sprite的Sprite节点，
首先需要导入OpenCvSharp这个namespace。然后在相应的方法中写代码，例如：
Mat img=new Mat();
VideoCapture cam=new VideoCapture(0);
cam.Read(img);
int k=0;
byte[] arr=new byte[img.Rows*img.Cols*3];
for(int i=0;i<img.Rows;i++){
for(int j=0;j<img.Cols;j++){
Vec3b pixel=img.Get<Vec3b>(i,j);
arr[k++]=pixel[2];
arr[k++]=pixel[1];
arr[k++]=pixel[0];
}
}
Image img2=new Image();
img2.CreateFromData(img.Cols,img.Rows,false,Image.Format.Rgb8,img);
Texture tex=new Texture();
tex.CreateFromImage(img2);
GetNode<Sprite>("Sprite").Texture=tex;

4.获取节点
我们可以使用GetNode方法来获得代码所挂载的节点的子节点，参数为一个字符串，即节点的名称，在这个字符串中，也可以使用两个小数点代表挂载节点的父节点。
GetNode方法所获得的是一个Node类的实例，因此不能调用其子类的属性和方法，所以需要先进行类型的转换或者使用泛型方法，例如转成Label类型（名称为title），可以这样写：
(Label)GetNode("title");
但是这样的强制类型转换是不安全的，所以要进行异常处理，因此太麻烦了，所以还有另外一种写法：
GetNode("title") as Label;
此时，类型转换是安全的，当不能成功转换时，会返回null
除此之外，最方便的是使用泛型方法，例如：
GetNode<Label>("title");
有了返回值，为了能够使用它返回的对象的实例，我们需要把它赋值给一个变量，除了可以直接使用类似于Label、Sprite等的对应的强类型之外，还可以使用var关键字，它们的区别在于强类型就直接断定类型了，而var关键字则在编译时自动推断类型，所以在运行时类型都是确定的，需要与dynamic相区别。
dynamic则是在运行时确定类型，Godot中的类型不能使用dynamic关键字在运行时进行推断。

5.文件的读写
我们除了可以使用Godot提供的File类进行文件的读写，还可以使用C#提供的System.IO中的各种类进行文件的读写。前者如同在GDScript中一样，后者如同在C#中一样。
一堆废话之后，我们的主要关注点在于它们的区别。它们主要的区别在于文件的路径。在Godot的File类中，我们可以使用res://和user://这样的前缀，但是System.IO中就不能使用这些前缀，在这些类中，如果是相对路径，则指的是当前的文件夹。
在C#中，我们可以使用斜杠或者反斜杠来写路径，但是，反斜杠的默认含义是转义字符，所以要么使用两个反斜杠来表示一个反斜杠，要么在字符串的前双引号前面加上一个At符号（也就是数字2上面的那个符号，之所以不把符号打出来，是因为这个符号在一些程序上有着特殊的含义）

6.输入与输出
（1）输出
System中的Console类提供的输出，只会输出在黑色的控制台中，Godot中提供了一个GD类，该类中的Print方法，既会在控制台中输出，也会在Godot编辑器中的“输出”栏中进行输出。
（2）输入
输入的一种处理方式，即是在_Input方法中，我们需要重写该方法，即：
public override void _Input(InputEvent e){}
然后在大括号中写代码，在有输入（比如鼠标、键盘等）时，就会运行该函数中的代码。
通过在该函数中，编写一些代码，我们可以看到，实际传入的输入事件是InputEvent的子类，因此我们可以使用is运算符判断是否是某一个具体的子类，并且使用as运算符进行类型的转换。
需要注意，is运算符判断一个实例的类型是否是某一个类或者其派生类，通俗地讲，就是：
“基类实例 is 基类” 返回true
“基类实例 is 派生类”返回false
“派生类实例 is 派生类”返回true
“派生类实例 is 基类”返回true

7.向量
Godot中的Sprite等节点的Position等属性的类型是二维向量，即Godot.Vector2，但是System.Numerics中也有Vector2类型，这两个类型是不同的。在需要引入后者的使用，需要在前面加入namespace以示区分。
另外，Godot.Vector2的x和y使用的是小写的字母，并且是只读的。要修改这个向量，必须整体地进行修改。而System.Numerics.Vector2的X和Y属性是大写的字母。