Easy2d 文档教程之基础类型 上

最新推荐文章于 2023-07-17 10:08:24 发布
最新推荐文章于 2023-07-17 10:08:24 发布
阅读量434 收藏 2
点赞数 3
分类专栏： Easy2d 文档教程 文章标签： c++
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/zrc4889/article/details/119418893
版权

Point 坐标点

Point 类表示一个二维坐标系中的点，具有 x 和 y 两个属性。

类定义

class Point
	{
	public:
		float x;	// X 坐标
		float y;	// Y 坐标

	public:
		Point();

		Point(float x, float y);

		Point(const Point& other);

		Point operator + (Point const& point) const;
		Point operator - (Point const& point) const;
		Point operator * (float const& point) const;
		Point operator / (float const& point) const;
		Point operator - () const;
		bool operator== (const Point& point) const;

		operator easy2d::Size() const;

		// 判断两点间距离
		static float distance(const Point&, const Point&);
	};

由上可知，Point类型可以进行基本的运算和赋值，还可以判断两点距离。

定义与赋值

使用Point关键字定义一个Point
用法：

Point point;//定义一个Point类型的坐标点point
point.x = 10;//设定坐标x为10
point.y = 10;//设定坐标y为10

Point point_1;
point_1.x = 20;
point_1.y = 20;

以上代码也可以写成

Point point = Point(10, 10);
Point point_1 = Point(20, 20);

运算

Point类型的运算讲究点点对应。
因此有下代码

Point point = Point(10, 10);
Point point_1 = Point(20, 20);
Point point_2;
point_2 = point_1 - point;//point_2等于（10，10）
point_2 = point_1 + point;//point_2等于（30，30）
point_2 = point_1 * point;//point_2等于（200，200）
point_2 = point_1 / point;//point_2等于（2，2）
bool flag = point == point_1;//检测point是否等于point_1，值为false

第四行：相减得（10，10）
第五行：相加得（30，30）
第六行：相乘得（200，200）
第七行：相除得（2，2）
第八行：检测point是否等于point_1，值为false

distance 距离

使用distance获取坐标点的距离
用法：

Point::distance(point, point_1);

以上代码展现了distance的用法

Size 大小

Size 类表示一个二维坐标系中的物体大小，具有 width 和 height 两个属性。

类定义

class Size
	{
	public:
		float width;	// 宽度
		float height;	// 高度

	public:
		Size();

		Size(float width, float height);

		Size(const Size& other);

		Size operator + (Size const& size) const;
		Size operator - (Size const& size) const;
		Size operator * (float const& size) const;
		Size operator / (float const& size) const;
		Size operator - () const;
		bool operator== (const Size& size) const;

		operator easy2d::Point() const;
	};

定义与赋值

与Point类似，使用如下命令定义。

Size size = Size(100, 100);//注意Size不像Point不能为负
Size size = Size(50, 50);

运算

Size类型的运算讲究点点对应。
因此有下代码

Size size = Size(10, 10);
Size size_1 = Size(20, 20);
Size size_2;
size_2 = size_1 - size ;//size_2等于（10，10）
size_2 = size_1 + size ;//size_2等于（30，30）
size_2 = size_1 * size ;//size_2等于（200，200）
size_2 = size_1 / size ;//size_2等于（2，2）
bool flag = size == size_1;//检测size是否等于size_1，值为false

第四行：相减得（10，10）
第五行：相加得（30，30）
第六行：相乘得（200，200）
第七行：相除得（2，2）
第八行：检测size是否等于size_1，值为false

Rect 矩阵

这个部分还未完善，如果有懂得同学请留言

class Size
	{
	public:
		float width;	// 宽度
		float height;	// 高度

	public:
		Size();

		Size(float width, float height);

		Size(const Size& other);

		Size operator + (Size const& size) const;
		Size operator - (Size const& size) const;
		Size operator * (float const& size) const;
		Size operator / (float const& size) const;
		Size operator - () const;
		bool operator== (const Size& size) const;

		operator easy2d::Point() const;
	};


	// 矩形
	class Rect
	{
	public:
		Point origin;	// 原点坐标
		Size  size;		// 宽度和高度

	public:
		Rect();

		Rect(float x, float y, float width, float height);

		Rect(const Point& pos, const Size& size);

		Rect(const Rect& other);

		Rect& operator= (const Rect& other);

		bool operator== (const Rect& rect) const;

		// 设置矩形
		void setRect(	
			float x,
			float y,
			float width,
			float height
		);

		// 判断点是否在矩形内
		bool containsPoint(
			const Point& point
		) const;

		// 判断两矩形是否相交
		bool intersects(
			const Rect& rect
		) const;

		inline Vector2 getCenter() const { return Vector2{ origin.x + size.width / 2, origin.y + size.height / 2 }; }

		inline Vector2 getLeftTop() const { return origin; }

		inline Vector2 getRightBottom() const { return Vector2{ getRight(), getBottom() }; }

		inline Vector2 getRightTop() const { return Vector2{ getRight(), getTop() }; }

		inline Vector2 getLeftBottom() const { return Vector2{ getLeft(), getBottom() }; }

		inline float getLeft() const { return origin.x; }

		inline float getTop() const { return origin.y; }

		inline float getRight() const { return origin.x + size.width; }

		inline float getBottom() const { return origin.y + size.height; }
	};


	// 二维变换矩阵
	template <typename _Lty, typename _Rty>
	struct MatrixMultiply;

	struct Matrix32
	{
		union
		{
			struct
			{
				float m[6];  // m[3][2]
			};

			struct
			{
				float
					_11, _12,
					_21, _22,
					_31, _32;
			};
		};

		Matrix32();

		Matrix32(float _11, float _12, float _21, float _22, float _31, float _32);

		Matrix32(Matrix32 const& other);

		template <typename T>
		Matrix32(T const& other)
		{
			for (int i = 0; i < 6; i++)
				m[i] = other[i];
		}

		template <typename _Lty, typename _Rty>
		inline Matrix32& operator= (MatrixMultiply<_Lty, _Rty> const& other)
		{
			Matrix32 result(other);
			(*this) = result;
			return *this;
		}

		float operator [](unsigned int index) const;


		void identity();

		Vector2 transform(const Vector2& v) const;

		Rect transform(const Rect& rect) const;

		void translate(float x, float y);

		void translate(const Vector2& v);

		float determinant() const;

		bool isIdentity() const;

		bool isInvertible() const;

		D2D1::Matrix3x2F const& toD2DMatrix() const;

		static Matrix32 translation(
			float x,
			float y);

		static Matrix32 scaling(
			float x,
			float y,
			const Point& center = Point());

		static Matrix32 rotation(
			float angle,
			const Point& center = Point());

		static Matrix32 skewing(
			float angle_x,
			float angle_y,
			const Point& center = Point());

		static Matrix32 invert(Matrix32 const& matrix);
	};

String 字符串

String 类是储存字符串内容的容器，是 std::wstring 类型的别名。
它曾经是 Easy2D 中实现的一种同时支持 char 和 wchar_t 的字符串类型，后来为了程序的兼容性，Easy2D 抛弃了这种方式，而选择 C++ 标准库提供的 std::wstring。

因为 String 只是简单的给 std::wstring 起了个别名，所以有关 String 的用法你都可以在各大学习网站上找到。

字符串以L开头

C++中以双引号括起来的字符串类型为 const char*，其中的字符都是 ASCII 码；以 L 开头的字符串类型为 const wchar_t*，其中的字符都是 Unicode 字符；在 Windows 编程中，推荐在代码中使用 Unicode 字符。

std::wstring 和 std::string

std::wstring 是 std::string 的 Unicode 版本，其中 w 的意思是 wide（宽），因为其储存的 wchar_t 是宽字符类型；使用时需要注意的地方有，将 std::cout、std::cin、std::to_string 等相关函数替换为 std::wcout、std::wcin、std::to_wstring 的宽字符版本。

// 字符串
using String = std::wstring;

// 窄字符串
using ByteString = std::string;

以上代码展示了String和ByteString的定义

Color 颜色

类定义

// 颜色
class Color
{
public:
	Color();

	Color(
		float r,
		float g,
		float b
	);

	Color(
		float r,
		float g,
		float b,
		float alpha
	);

	Color(
		UINT rgb
	);

	Color(
		UINT rgb,
		float alpha
	);

	D2D1_COLOR_F toD2DColorF() const;

public:
	enum Value : UINT
	{
		Black = 0x000000,
		Blue = 0x0000FF,
		BlueViolet = 0x8A2BE2,
		Brown = 0xA52A2A,
		Chocolate = 0xD2691E,
		DarkBlue = 0x00008B,
		DarkGray = 0xA9A9A9,
		DarkGreen = 0x006400,
		DarkOrange = 0xFF8C00,
		DarkRed = 0x8B0000,
		DarkViolet = 0x9400D3,
		ForestGreen = 0x228B22,
		Gold = 0xFFD700,
		Gray = 0x808080,
		Green = 0x008000,
		GreenYellow = 0xADFF2F,
		LightBlue = 0xADD8E6,
		LightCyan = 0xE0FFFF,
		LightGreen = 0x90EE90,
		LightGray = 0xD3D3D3,
		LightPink = 0xFFB6C1,
		LightSeaGreen = 0x20B2AA,
		LightSkyBlue = 0x87CEFA,
		LightYellow = 0xFFFFE0,
		Orange = 0xFFA500,
		OrangeRed = 0xFF4500,
		Pink = 0xFFC0CB,
		Purple = 0x800080,
		Red = 0xFF0000,
		Silver = 0xC0C0C0,
		SkyBlue = 0x87CEEB,
		Snow = 0xFFFAFA,
		Violet = 0xEE82EE,
		Wheat = 0xF5DEB3,
		White = 0xFFFFFF,
		WhiteSmoke = 0xF5F5F5,
		Wood = 0xDEB887,
		Yellow = 0xFFFF00,
		YellowGreen = 0x9ACD32
	};

private:
	void _init(
		UINT rgb,
		float alpha
	);

private:
	float r;
	float g;
	float b;
	float a;
};

分支形式

Color一共有四种形式：
分别是

Color(
	float r,
	float g,
	float b
);

Color(
	float r,
	float g,
	float b,
	float alpha
);

Color(
	UINT rgb
);

Color(
	UINT rgb,
	float alpha
);

其中UINT的值可以是（格式：单元 = 16进制码）

Black = 0x000000,
Blue = 0x0000FF,
BlueViolet = 0x8A2BE2,
Brown = 0xA52A2A,
Chocolate = 0xD2691E,
DarkBlue = 0x00008B,
DarkGray = 0xA9A9A9,
DarkGreen = 0x006400,
DarkOrange = 0xFF8C00,
DarkRed = 0x8B0000,
DarkViolet = 0x9400D3,
ForestGreen = 0x228B22,
Gold = 0xFFD700,
Gray = 0x808080,
Green = 0x008000,
GreenYellow = 0xADFF2F,
LightBlue = 0xADD8E6,
LightCyan = 0xE0FFFF,
LightGreen = 0x90EE90,
LightGray = 0xD3D3D3,
LightPink = 0xFFB6C1,
LightSeaGreen = 0x20B2AA,
LightSkyBlue = 0x87CEFA,
LightYellow = 0xFFFFE0,
Orange = 0xFFA500,
OrangeRed = 0xFF4500,
Pink = 0xFFC0CB,
Purple = 0x800080,
Red = 0xFF0000,
Silver = 0xC0C0C0,
SkyBlue = 0x87CEEB,
Snow = 0xFFFAFA,
Violet = 0xEE82EE,
Wheat = 0xF5DEB3,
White = 0xFFFFFF,
WhiteSmoke = 0xF5F5F5,
Wood = 0xDEB887,
Yellow = 0xFFFF00,
YellowGreen = 0x9ACD32

记住，使用的时候应该如下代码格式书写。

Color::White        // 白色
Color::Black        // 黑色
Color::Blue         // 蓝色
Color::Brown        // 棕色
Color::Gray         // 灰色
Color::Green        // 绿色
Color::Red          // 红色
Color::Pink         // 粉色
Color::Orange       // 橘黄色
Color::OrangeRed    // 橘红色
Color::Purple       // 紫色
Color::Yellow       // 黄色

Color::Chocolate    // 巧克力色
Color::Gold         // 金色

Color::LightBlue    // 淡蓝色
Color::LightGray    // 淡灰色
Color::LightGreen   // 淡绿色

Color::DarkBlue     // 深蓝色
Color::DarkGray     // 深灰色
Color::DarkGreen    // 深绿色

// 还有更多，不再列出

构造新 Color

指定 RGB 三原色的程度来构造颜色
// 构造一个纯红色
Color red = Color(1.0, 0.0, 0.0);

颜色为红，其圆括号中三个小数分别为r, g, b

alpha 通道
// 构造一个纯红色，且透明度为 0.7
Color red = Color(1.0, 0.0, 0.0, 0.7);

颜色为带有0.7透明的红，其圆括号中三个小数分别为r, g, b, alpha 通道
alpha 通道相当于透明度。

十六进制的RGB颜色值
Color red = Color(0xFF0000);

为纯红色，同Color red = Color(1.0, 0.0, 0.0);

UNIT值
Color red = Color(Color::Red);//红色
Color blue = Color(Color::Blue);//蓝色

结束

本章只是基础类型的上章，关于所有的类型，原作者并未完全写明再Easy2d的官方网站，所以恳请大佬们帮忙补充好文档，提及贵见。
在基础类型的下章，我们将会整合KeyCode, MouseCode, Image, Font, Listener, Function几类类型，
其中KeyCode, MouseCode涉及Input功能，初学者建议有针对性的去翻阅我编写的文档教程，在了解一章的内容之后，循序渐进的去了解更多实现的必要。而不是一章一章的翻阅，会显得有些吃力。

OaKuN
关注
  • 3
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
EasyMotion2D 编码手册
04-24
Unity3D 2D动画插件 EasyMotion2D 编码手册
Easy2d 文档教程之基础类型 下
zrc4889的博客
08-06 189
KeyCode 键盘键值 类定义 包含了所有支持的按键 // 键盘键值 struct KeyCode { enum Value : int { Unknown = 0, Up = VK_UP, Left = VK_LEFT, Right = VK_RIGHT, Down = VK_DOWN, Enter = VK_RETURN, Space = VK_SPACE, Esc = VK_ESCAPE, Ctrl = VK_CONTROL, Shift = VK_SHI
Easy Ropes 2D 1.1.8.4.zip
02-01
地址:https://assetstore.unity.com/packages/tools/sprite-management/easy-ropes-2d-40202 -绳索系统和三个示例预制件（简单绳索、链式绳索和桥绳）。 -绳索切割机系统。 -气球系统。 -简单的气球插件和绳子创建窗口。 -定位系统和吊索。 -编辑器检查器和动态绳索（甚至在编辑器SceneView中）。 -张力小控件，帮助您实现吊索效果。 -48易碎物品
【游戏引擎Easy2D】三分钟学会游戏的控制移动，键盘识别详解
iecne的博客
08-15 3978
哈喽大家好，我是iecne，本期为大家带来的是CPP/C++游戏引擎Easy2D教程 —— 精灵与坐标，包教包会，快来看看吧！
Easy2d 文档教程之常用元素 Text
zrc4889的博客
09-21 414
Text 文本 声明 简易 auto text = new Text(L"你好"); 以上代码展示了如何将字符串存入text中。 复杂 auto text = new Text(L"你好", Font(L"宋体", 23, Font::Weight::Thin, true), style ); 以上代码初学者不必完全理解，style指文本样式。 运行起来应该是这样子的： 原型 explicit Text( const Str
Easy2D平台跳跃附加内容
01-26
在本文中，我们将深入探讨如何使用Easy2D平台来创建一款平台跳跃游戏，并结合提供的"SceneManage.cpp"、"Camera.cpp"、"SceneManage.h"和"Camera.h"这四个关键文件来理解游戏开发中的核心概念和技术。Easy2D是一个为...
Easy2D iecne安装包 免费
08-13
如果你喜欢用 C/C++ 编写自己的小游戏，那么 Easy2D 将是个不错的选择，它大大简化了游戏制作过程，可以帮助你快速开发 Windows 上的 2D 小游戏。 它的特点和它的名字一样，Everything is Easy！ ​ 使用简易安装器...
C++飞机大战-Easy2D实例
12-31
【标题】"C++飞机大战-Easy2D实例"是一个基于C++编程语言，利用Easy2D图形库开发的简单游戏项目。Easy2D是一个轻量级的2D图形库，它为开发者提供了方便快捷的方式来创建2D游戏或图形应用程序。在本实例中，我们将在...
Easy Performant Outline 2D 3D URP HDRP 3.4.2
02-10
5. **易于集成**：提供清晰的文档和教程，帮助开发者快速理解和集成到项目中。 总结来说，"Easy Performant Outline 2D 3D URP HDRP 3.4.2"是一款强大的Unity 插件，它为开发者提供了一种简便的方法，用以实现高...
string,wstring,cout,wcout 与中文字符的输入输出
qq_21141511的博客
10-23 3968
首先说明是什么string与wstring 在C++标准里定义了两个字符串string和wstring  typedef basic_string string;  typedef basic_string wstring;  前者string是常用类型，可以看作char[]，其实这正是与string定义中的_Elem=char相一致。而wstring，使用的是wchar_t类型，这是
宽字符和正常字符，string和wstring,cout以及wcout的区别，ASCII 字符和Unicode区别
最新发布
森明帮大于黑虎帮的博客
07-17 859
字符集是最早的字符编码标准之一，使用 7 位二进制数表示字符。它定义了 128 个字符，包括英文字母、数字、标点符号和一些控制字符。字符集主要用于表示英语等西方语言的字符。是一种字符集，它包含了几乎所有已知的字符，并为每个字符分配了一个唯一的数字码点。为不同的字符分配了不同的编码，可以用不同的编码方式来表示字符。常用的编码方式包括 UTF-8、UTF-16 和 UTF-32。字符：‘A’ 表示大写字母 A，其码为 65。字符：‘世’ 表示中文字符 “世”，其码点为 U+4E16。
1229C++中wstring处理宽字符
我也想当个程序员
02-26 677
#include &lt;iostream&gt; #include &lt;string&gt; using namespace std; #define tab "\t" int main() { locale def; cout&lt;&lt;def.name()&lt;&lt;endl; locale current = cout.getloc(); c...
《数字、string、wstring之间的相互转换》
GodLei1995
06-29 1万+
使用C++版本 C++11及更高版本 string和wstring的区别 &lt;span style="color:#333333"&gt;wstring（wchar_t string）是宽char，Unicode编码，一般情况下一个字符占两个字节大小 string（char string）是窄char，&lt;a data-cke-saved-href="https://www.bai...
std::string和std::wstring声明和用法解释
qq_31209383的博客
01-18 1万+
平时用到string的一些成员函数，但是自己总记不住声明的参数类型和个数，所以特此记载一下。 用到时翻翻查查。最近用string就写了个爬虫程序，把天涯的经济论的前5页帖子爬了一下。全部记录了下来。 相信使用过MFC编程的朋友对CString这个类的印象应该非常深刻吧？的确，MFC中的CString类使用起来真的非常的方便好用。但是如果离开了MFC框架，还有没有这样使用起来非常
C++：中文编码转换
热门推荐
netyeaxi的专栏
07-13 3万+
C++11标准库，中文编码转换问题。
字节的转换
weixin_69797860的博客
10-07 288
字节转换
【c++】std::wstring和std::string相互转换
鸟哥的博客
01-01 2871
#include <string> #include <iostream> #include <locale> #include <codecvt> // 将 string 转为 wstring inline std::wstring to_wstring(const std::string& input) { std::wstring_convert<std::codecvt_utf8<wchar_t>> conv
c++11:基于STL实现字符串分割更简单 wstring,string split
10km的专栏
05-04 1万+
关于string的分割，网上有好多好多写得很详细的文章，但基本上都是基于标准C++的。 比如下面这段代码基于strtok函数实现的split(from 《C++之split字符串分割》): vector&lt;string&gt; split(const string&amp; str, const string&amp; delim) { vector&lt;string&g...
jQuery Easy UI全方位教程：从入门到精通
教程还提供了基础组件的详细文档，如 EasyLoader、Draggable、Droppable、Resizable 等，以及 layout、Menu and Button、Form、Window、DataGrid 和 Tree 的用法，帮助开发者深入理解和使用 jQuery Easy UI。...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值