【Unity API 翻译】UGUI 屏幕坐标转UI坐标方法 – ScreenPointToLocalPointInRectangle()
写在前面的话
1. 本站所有的文档都是由 絮大王 翻译,转载请注明出处!
2. 所有絮大王翻译的文档,都有絮大王认真排版了的PDF版本,请在文章的末尾处观看 或者 下载QuQ!(PDF文档有水印,请谅解哒哒哒!)
3. 有的文档翻译只有PDF版本,是因为絮大王太懒了,懒得在网页里重新排版了,请见谅哒!
4. 如果你看不懂文档,可以联系我,我可以尽快制作出此插件的视频教程QuQ!联系方式在网站的底部喵!(因为插件的教程几乎没人看,所以没人有需求的话,我就不做啦!如果有人有需求,哪怕是只有一个人想看,我也会做哒!)
方法介绍
我们在网上很容易就可以查到屏幕坐标转世界坐标的相关文章,但是 屏幕坐标转UI坐标(UGUI) 的相关文章却非常少!就算有,也是讲得不清不楚的。
首先我们来明确下三个坐标概念:
世界坐标:指的是Transform组件的position字段
UI坐标:指的是RectTransform组件的anchoredPosition字段
屏幕坐标:指的是屏幕空间的坐标 (也可以说是相机空间的坐标)。反正关于屏幕坐标,大家只要知道以下2点即可
- 我们在Unity中获取的鼠标的坐标,就是屏幕坐标!
- 屏幕坐标和世界坐标不是一个东西,屏幕坐标和UI坐标不是一个东西!
Unity官方提供了一个方法,让我们可以很简单的把屏幕坐标 转换成UI坐标!
这个方法就是:
RectTransformUtility.ScreenPointToLocalPointInRectangle(RectTransform rect, Vector2 screenPoint, Camera cam, out Vector2 localPoint);
但是,我一直没太搞懂这个方法,网上又查找不到相关的资料。
官方文档感觉根本没描述清楚,只有自己慢慢尝试。
以下是自己对官方文档的翻译,以及自己尝试之后对官方文档的一些理解。
理解之后,这个方法还是非常好用哒!
(也可能有错误的地方,希望大家指出呢!文章的最后附带有排版好的PDF文件,欢迎观看+下载哒!)
参数详解
RectTransformUtility.ScreenPointToLocalPointInRectangle(
RectTransform rect,
Vector2 screenPoint,
Camera cam,
out Vector2 localPoint);
参数 rect:
这个参数需要你提供一个父物体的RectTransform。因为这个方法是取得UI坐标,而UI坐标都是局部坐标,所以一定需要一个父物体,才能计算出局部坐标。(有父物体才有局部坐标对吧!)
最后,这个方法就会把屏幕上的点转化为这个父物体下的局部坐标。
参数 screenPoint:
这个参数需要你提供一个屏幕空间 的坐标 (屏幕坐标)。
最后,这个方法会把这个屏幕坐标 转化为ui坐标。
参数 cam:
这个参数需要你指定一个相机。
因为UI坐标是根据相机来确定的。(如果Canvas是Screen Space-overlay模式,cam参数应为null)
参数 localPoint:
这个参数需要你提供一个装"返回值"的容器给方法。(如果不能理解高级参数out,可以在这里了解下:https://www.cnblogs.com/linfenghp/p/6618580.html)
最后,这个方法会把屏幕点的UI坐标的结果,装到这个变量中。、
你也可以这样理解:你给指定一个Vector2变量给这个参数,这个方法最后会把转换好的UI坐标赋值给你指定的这个变量。
返回值 - bool类型:
这个方法有一个返回值,但是我自己没使用过这个返回值(感觉用处不大?)。
官方的说法是:这个返回值是,判断此点是否在Rect所在的平面上。
如果在,就返回true。
总结一下就是:
提供一个屏幕坐标点,再指定一个相机,再指定一个父物体。
就可以得到UI坐标点!
PDF文档
ScreenPointToLocalPointInRectangle-xudawang此文档由 絮大王 翻译并制作!转载请注明出处!请注明出处!
PDF文档下载地址:点击下载
[注意:下面这个不是图片,是PDF文档,按底部的按钮可以进行翻页哒!~]