CoreGraphics基本数据类型

来源:互联网 发布:sqlserver下载安装 编辑:程序博客网 时间:2024/04/29 11:19


基本类型

CGFloat

表示一个基本的浮点数值,在32位的机器上它就是float,64位的机器是double

CGFloat
12
typedef float CGFloat;     // 32-bittypedef double CGFloat;    // 64-bit
CGPoint

表示屏幕上的一个点,由两个CGFloat值构成,分别表示 x 和 y 值

CGPoint
12345
struct CGPoint {  CGFloat x;  CGFloat y;};typedef struct CGPoint CGPoint;
CGSize

包含了两个CGPoint,通常用来表示宽度和高度

CGSize
12345
struct CGSize {  CGFloat width;  CGFloat height;};typedef struct CGSize CGSize;
CGRect

表示一个矩形的位置和大小,由一个CGPoint和CGSize组成

CGRect
12345
struct CGRect {  CGPoint origin;  CGSize size;};typedef struct CGRect CGRect;

函数

CGPointMake CGSizeMake CGRectMake

CoreGraphic提供了创建这些类型对象的函数,例如:CGPointMake,CGSizeMake,CGRectMake

123
CGPoint point = CGPointMake(10.0f, 10.0f);CGSize size = CGSizeMake(50.0f, 60.0f);CGRect rect = CGRectMake(10.0f, 10.0f, 50.0f, 60.0f);
CGPointEqualToPoint
1234
CGPoint point1 = CGPointMake(10.0f, 12.0f);CGPoint point2 = CGPointMake(10.0f, 12.0f);// 比较两个点是否相同BOOL result = CGPointEqualToPoint(point1, point2); // YES
CGSizeEqualToSize
1234
CGSize size1 = CGSizeMake(50.0f, 60.0f);CGSize size2 = CGSizeMake(50.0f, 60.1f);// 比较两个Size的值是否一致BOOL result = CGSizeEqualToSize(size1, size2); // NO
CGRectEqualToRect
1234
CGRect rect1 = CGRectMake(10.0f, 10.0f, 50.0f, 50.0f);CGRect rect2 = CGRectMake(10.1f, 10.1f, 50.0f, 50.0f);// 比较两个矩形是否在相同的位置,并且大小一致BOOL result = CGRectEqualToRect(rect1, rect2); // NO
CGRectIntersectsRect

检测两个矩形是否有相交,这个是检测物体碰触最简单的方法

12345678
CGRect rect1 = CGRectMake(10.0f, 10.0f, 50.0f, 50.0f);CGRect rect2 = CGRectMake(62.0f, 62.0f, 50.0f, 50.0f);BOOL result = CGRectIntersectsRect(rect1, rect2) // NOCGRect rect1 = CGRectMake(10.0f, 10.0f, 50.0f, 50.0f);CGRect rect2 = CGRectMake(59.0f, 59.0f, 50.0f, 50.0f);BOOL result = CGRectIntersectsRect(rect1, rect2); // YES
CGRectContainsPoint

检测一个Point是否在一个Rect之内

1234
CGRect rectangle = CGRectMake(10.0f, 10.0f, 50.0f, 50.0f);CGPoint point = CGPointMake(25.0f, 25.0f);BOOL result = CGRectContainsPoint(rectangle, point);  // YES
CGRectContainsRect #####$

检测一个Rect是否包括在另一个Rect之内

1234
CGRect rect1 = CGRectMake(0.0f, 0.0f, 50.0f, 50.0f);CGRect rect2 = CGRectMake(5.0f, 5.0f, 10.0f, 10.0f);BOOL result = CGRectContainsRect(rect1, rect2); // YES

注意:如果第二个rect没有完全包含在第一个rect,这个函数将返回NO

1234
CGRect rect1 = CGRectMake(0.0f, 0.0f, 50.0f, 50.0f);CGRect rect2 = CGRectMake(5.0f, 5.0f, 50.0f, 50.0f);BOOL result = CGRectContainsRect(rect1, rect2); // NO
CGRectMinX

返回Rect在x方向上最小的值

12
CGRect rectangle = CGRectMake(10.0f, 10.0f, 40.0f, 40.0f);CGFloat x = CGRectGetMinX(rectangle); // x = 10.0
CGRectMidX

返回Rect的中心点在x方向的值

12
CGRect rectangle = CGRectMake(10.0f, 10.0f, 40.0f, 40.0f);CGFloat x = CGRectGetMidX(rectangle); // x = 30.0
CGRectMaxX

返回Rect在x方向上最大的值

12
CGRect rectangle = CGRectMake(10.0f, 10.0f, 40.0f, 40.0f);CGFloat x = CGRectGetMaxX(rectangle); // x = 50.0
CGRectMinY

返回Rect在y方向上最小的值

12
CGRect rectangle = CGRectMake(10.0f, 10.0f, 40.0f, 40.0f);CGFloat y = CGRectGetMinY(rectangle); // y = 10.0
CGRectMidY

返回Rect的中心点在y方向的值

12
CGRect rectangle = CGRectMake(10.0f, 10.0f, 40.0f, 40.0f);CGFloat y = CGRectGetMinX(rectangle); // y = 30.0
CGRectMaxY

返回Rect在y方向上最大的值

12
CGRect rectangle = CGRectMake(10.0f, 10.0f, 40.0f, 40.0f);CGFloat y = CGRectGetMaxY(rectangle); // y = 50.0
CGRectGetWidth CGRectGetHeight

返回Rect的高度和宽度

123
CGRect rectangle = CGRectMake(10.0f, 10.0f, 40.0f, 40.0f);CGFloat width = CGRectGetWidth(rectangle); // 40.0CGFloat height = CGRectGetHeight(rectangle); // 40.0
CGRectIsEmpty

检测Rect的大小是否是零,如果width和height之中有一个值是零,这个函数就会返回YES

123456
CGRect rectangle = CGRectMake(10.0f, 10.0f, 40.0f, 40.0f);BOOL isEmpty = CGRectIsEmpty(rectangle); // NOCGRect rectangle = CGRectMake(10.0f, 10.0f, -40.0f, -40.0f);BOOL isEmpty = CGRectIsEmpty(rectangle); // NOCGRect rectangle = CGRectMake(10.0f, 10.0f, 0.0f, 0.0f);BOOL isEmpty = CGRectIsEmpty(rectangle); // YES
CGRectIsNull

只有传递给它的参数是CGRectNull的时候,它才返回YES。CGRectNull是一个常量,稍后会提到。

1
BOOL isNull = CGRectIsNull(CGRectNull); // YES
CGRectInset

这个函数的作用在原有的Rect的基础上根据给定的x,y进行调整,例如

12345678
CGRect source = CGRectMake(100.0f, 100.0f, 10.0f, 10.0f);CGRect result = CGRectInset(source, 4.0f, 4.0f);// 新的rect的位置大小分别为: 104.0, 104.0, 2.0, 2.0// 生成了一个内嵌与原来Rect的新RectCGRect source = CGRectMake(100.0f, 100.0f, 10.0f, 10.0f);CGRect result = CGRectInset(source, -4.0f, -4.0f);// 新的rect的位置大小分别为: 96.0, 96.0, 18.0, 18.0// 生成了一个包含原来的Rect的新Rect

这个函数的行为可以总结出

假如:

1
CGRect new = CGRectInset(source, dx, dy);

那么:

1234
new.x = source.x + dxnew.y = source.y + dynew.width = source.width - 2 * dxnew.height = source.height - 2 * dy
CGRectIntegral

将一个rect的位置以及长宽的数值,根据四舍五入的原则取整

123
CGRect source = CGRectMake(10.25f, 10.45f, 10.5f, 10.5f);CGRect result = CGRectIntegral(source);// the result is (10.0f, 10.0f, 11.0f, 11.0f)
CGRectIntersection

返回两个Rect相交的部分的Rect

1234
CGRect rect1 = CGRectMake(0.0f, 0.0f, 10.0f, 10.0f);CGRect rect2 = CGRectMake(5.0f, 5.0f, 10.0f, 10.0f);CGRect result = CGRectIntersection(rect1, rect2);// the result is (5.0f, 5.0f, 5.0f, 5.0f)

如果其中一个rect内嵌于另一个rect之中,那么函数返回的就是内侧的那个rect。如果两个rect没有相交,那么返回的将是常量CGRectNull,可以用CGRectIsNull函数来检测是否有相交。

CGRectOffset

将一个rect的x,y加上指定量的位移,返回新的rect与原来的rect大小不变

123
CGRect rectangle = CGRectMake(10.0f, 10.0f, 10.0f, 10.0f);CGRect result = CGRectOffset(rectangle, 5.0f, 5.0f);// the result is (15.0f, 15.0f, 10.0f, 10.0f)
CGRectStandardize

将一个rect的宽度和高度变为它们的绝对值

123
CGRect rectangle = CGRectMake(10.0f, 10.0f, -10.0f, -10.0f);CGRect result = CGRectStandardize(rectangle);// the result is (10.0f, 10.0f, 10.0f, 10.0f)
CGRectUnion

返回一个新的Rect,它是最小的可以将两个rect完全包含再内的rect

1234
CGRect rect1 = CGRectMake(10.0f, 10.0f, 10.0f, 10.0f);CGRect rect2 = CGRectMake(30.0f, 30.0f, 10.0f, 10.0f);CGRect result = CGRectUnion(rect1, rect2);// the result is (10.0f, 10.0f, 10.0f, 10.0f)
CGRectDivide

这个函数有复杂,先看看它的定义

void CGRectDivide(CGRect rect, CGRect slice, CGRect remainder, CGFloat amount, CGRectEdge edge) 简单来说,这个函数的作用是将一个rect切成两个rect,切下来的部分放在slice参数指向的rect,剩余的部分放在remainder参数指向的rect。可以注意到slice和remainder参数都是指向CGRect的指针。那么从那里下刀切呢?就要看后两个参数amount和edge,先说edge,它是一个enum类型的参数,可以是CGRectMinXEdge,CGRectMaxXEdge,CGRectMinYEdge,CGRectMaxYEdge。可以理解这四个值是rect的四条边,它的作用是指定我们的“刀”要平行与哪条边来切。amount参数的作用是指定我们的“刀”距离edge指定的边的距离。通过例子来看看:

123456
CGRect slice;CGRect remainder;CGRect rectangle = CGRectMake(0.0f, 0.0f, 100.0f, 100.0f);CGRectDivide(rectangle, &slice, &remainder, 10.0f, CGRectMaxXEdge);// the slien is (90.0f, 0.0f, 10.0f, 100.0f)// the remainder is (0.0f, 0.0f, 90.0, 100.f)

上面是一个竖着切的例子,我们的“刀”是靠着右边来切的,“刀”离右边的距离有10.0f。slice得到了一个10.0f宽,100.0f高的rect。

常量

CGPointZero CGSizeZero CGRectZero

这三个常量很好理解,它们所有的值都是零,CGPointZero完全等价于CGPointMake(0.0f, 0.0f)

CGRectNull

表示一个为NULL的矩形,NULL的矩形并不是ZERO矩形。当我们函数CGRectIntersection函数的时候,传入的两个rect没有相交的时候,就会返回CGRectNull,我们只可以用CGRectIsNull来检测某个rect是不是NULL矩形。 可以看到,CoreGraphics里面定义了非常基本的数据结构,以及对这些数据进行操作的函数,对于学习CoreGraphics来说,这些是非常基础的东西。

原创粉丝点击