C 语言链式调用与Tween算法实现(4)链式封装接口

2024-04-16 18:08
文章标签 算法 语言 实现 接口 封装 调用 链式 tween

本文主要是介绍C 语言链式调用与Tween算法实现(4)链式封装接口，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

在有上下文this指针的语言中，可以把this指针return出去。这样就可以形成一种链式调用的效果。配合上良好的方法命名，能够让函数功能的组合调用，使用起来非常的直觉化。在C语言中并没有this指针，所有的上下文对象需要，手动传入上下文对象。

以前介绍了3篇关于C语言如何实现tween缓动算法的。

  • C 实现通用Tween缓动动画(1)插值公式
  • C 实现通用Tween缓动动画(2)Tween数据结构

然而，函数的调用缺少链式调用非常的不流畅。而tween又很多默认参数的设定，往往链式调用能够更加方便的使用。


本文结合一种实现链式调用的方式，来在tween的实现之上进行一个链式调用的封装。我的思路很简单，链式调用需要上下文，C没有，那我们就要构造一个上下文以供使用。那我们看代码。

struct ATweenTool
{/*** Create one TweenAction in context for chain setting*/struct ATweenTool* (*SetAction)       ();/*** Create action with no actionValue* just through duration time then callback*/struct ATweenTool* (*SetInterval)     (float duration);//--------------------------------------------------------------------------------------------------
// Create one TweenAction with TweenActionValue
//--------------------------------------------------------------------------------------------------struct ATweenTool* (*SetActionMoveX)  (float moveX,   float duration);struct ATweenTool* (*SetActionMoveY)  (float moveY,   float duration);struct ATweenTool* (*SetActionMove)   (float moveX,   float moveY,  float duration, bool isRelative, TweenEaseType easeType);struct ATweenTool* (*SetActionScaleX) (float scaleX,  float duration);struct ATweenTool* (*SetActionScaleY) (float scaleY,  float duration);struct ATweenTool* (*SetActionScale)  (float scaleX,  float scaleY, float duration, bool isRelative, TweenEaseType easeType);struct ATweenTool* (*SetActionRotateZ)(float rotateZ, float duration);struct ATweenTool* (*SetActionFadeTo) (float fadeTo,  float duration);//--------------------------------------------------------------------------------------------------
// After SetAction then set TweenAction property for current context created
//--------------------------------------------------------------------------------------------------struct ATweenTool* (*SetDuration)     (float                     duration);struct ATweenTool* (*SetUserData)     (void*                     userData);struct ATweenTool* (*SetQueue)        (bool                      isQueue);struct ATweenTool* (*SetOnComplete)   (TweenActionOnComplete     OnComplete);struct ATweenTool* (*SetTarget)       (void*                     target);/*** Get TweenAction in current context*/struct ATweenTool* (*GetAction)       (TweenAction**             outActionPtr);//--------------------------------------------------------------------------------------------------
// Add new TweenActionValue into context TweenAction
//--------------------------------------------------------------------------------------------------struct ATweenTool* (*SetMoveX)        (float                     moveX);struct ATweenTool* (*SetMoveY)        (float                     moveY);struct ATweenTool* (*SetScaleX)       (float                     scaleX);struct ATweenTool* (*SetScaleY)       (float                     scaleY);struct ATweenTool* (*SetRotateZ)      (float                     rotateZ);struct ATweenTool* (*SetFadeTo)       (float                     fadeTo);//--------------------------------------------------------------------------------------------------
// After SetValue then set TweenActionValue property for current context created
//--------------------------------------------------------------------------------------------------/*** After SetValue then SetRelative on new created TweenActiveValue*/struct ATweenTool* (*SetRelative)     (bool                      isRelative);/*** After SetValue then SetEaseType on new created TweenActiveValue*/struct ATweenTool* (*SetEaseType)     (TweenEaseType             easeType);//--------------------------------------------------------------------------------------------------/*** Run actions all in current context, set action target if has actionValue* and use target be tweenId*/void               (*RunActions)      (void*                      target);/*** Run actions all in current context, action must set target* if has actionValue and return tweenId*/void*              (*RunTargets)      ();
};extern struct ATweenTool ATweenTool[1];

我们需要一个链式调用的发起者，通常是一个单例对象。这里就是有ATweenTool充当。可以看到，几乎所有的函数都会直接返回 ATweenTool结构指针，这样就可以在函数调用完成的时候，链式的调用所属的其它函数形成链式调用。ATweenTool的方法有3大类。


第一类，生成一个Action，以SetAction开头的函数以及SetInterval函数，都会生成一个上下文Action对象。以后针对Action属性的设置函数，比如SetDuration，SetUserData等等，都会使用这个上下文的Action，可以看到这些函数并没有传入Action对象作为参数。当重新SetAction的时候，上下文对象就会重置。


第二类，生成一个ActionValue，以SetMove，SetScale等等这样的函数，都会生成一个上下文的ActionValue对象。以后针对ActionValue属性的设置函数，比如SetRelative等函数，都会使用这个上下文的ActionValue，可以看到这些函数并没有传入ActionValue作为参数。 当重新SetMove等时候，上下文对象就会重置。


第三类，RunActions和RunTargets两个函数，返回值不再是ATweenTool这样返回。意味着这是链式调用的终点。一旦调用Tween动画开始执行。


接下来，看看上下文是如何生成的。

#define action_length 30static Array(TweenAction*) actionArr[1] =
{(TweenAction*[action_length]) {},0
};static TweenAction*      action      = NULL;
static TweenActionValue* actionValue = NULL;

就是简单的使用了一个static变量持有了Action数组。也就是说上下文Action的生成是有上限的。在执行tween动画执行之前，一共只能生成action_length个Action。那么，action和actionValue变量，就是记录了当前上下文的对象。随着新Action和ActionValue的设置，当前变量不断的被赋值。 


#define CheckAction(tag) \ALogA(action      != NULL, "ATweenTool " tag " TweenAction not created");#define CheckActionValue(tag) \ALogA(actionValue != NULL, "ATweenTool " tag " TweenActionValue invalid");static struct ATweenTool* SetAction()
{ALogA(actionArr->length <= action_length,"ATweenTool can not cache TweenActions = %d more than %d",actionArr->length,action_length);action      = ATween->GetAction();actionValue = NULL;AArraySet(actionArr,actionArr->length++,action,TweenAction*);return ATweenTool;
}static inline struct ATweenTool* SetValue(TweenActionValueGetSet* valueGetSet, float value)
{CheckAction("SetValue");actionValue        = ATween->AddTweenActionValue(action);actionValue->OnGet = valueGetSet->OnGet;actionValue->OnSet = valueGetSet->OnSet;actionValue->value = value;return ATweenTool;
}static struct ATweenTool* SetDuration(float duration)
{CheckAction("SetDuration");action->duration = duration;return ATweenTool;
}static struct ATweenTool* SetRelative(bool isRelative)
{CheckAction     ("SetRelative");CheckActionValue("SetRelative");actionValue->isRelative = isRelative;return ATweenTool;
}static struct ATweenTool* SetEaseType(TweenEaseType easeType)
{CheckAction     ("SetEaseType");CheckActionValue("SetEaseType");actionValue->easeType = easeType;return ATweenTool;
}static struct ATweenTool* SetInterval(float duration)
{SetAction();SetDuration(duration);return ATweenTool;
}//--------------------------------------------------------------------------------------------------static struct ATweenTool* SetActionMoveX(float moveX, float duration)
{SetAction();SetValue(ATweenActionValueGetSetImpl->moveX, moveX);SetDuration(duration);return ATweenTool;
}static struct ATweenTool* SetActionMoveY(float moveY, float duration)
{SetAction();SetValue(ATweenActionValueGetSetImpl->moveY, moveY);SetDuration(duration);return ATweenTool;
}static struct ATweenTool* SetActionMove(float moveX, float moveY, float duration, bool isRelative, TweenEaseType easeType)
{SetAction  ();SetValue   (ATweenActionValueGetSetImpl->moveX, moveX);SetRelative(isRelative);SetEaseType(easeType);SetValue   (ATweenActionValueGetSetImpl->moveY, moveY);SetRelative(isRelative);SetEaseType(easeType);SetDuration(duration);return ATweenTool;
}static struct ATweenTool* SetActionScaleX(float scaleX, float duration)
{SetAction();SetValue(ATweenActionValueGetSetImpl->scaleX, scaleX);SetDuration(duration);return ATweenTool;
}static struct ATweenTool* SetActionScaleY(float scaleY, float duration)
{SetAction();SetValue(ATweenActionValueGetSetImpl->scaleY, scaleY);SetDuration(duration);return ATweenTool;
}static struct ATweenTool* SetActionScale(float scaleX, float scaleY, float duration, bool isRelative, TweenEaseType easeType)
{SetAction  ();SetValue   (ATweenActionValueGetSetImpl->scaleX, scaleX);SetRelative(isRelative);SetEaseType(easeType);SetValue   (ATweenActionValueGetSetImpl->scaleY, scaleY);SetRelative(isRelative);SetEaseType(easeType);SetDuration(duration);return ATweenTool;
}static struct ATweenTool* SetActionRotateZ(float rotateZ, float duration)
{SetAction();SetValue(ATweenActionValueGetSetImpl->rotateZ, rotateZ);SetDuration(duration);return ATweenTool;
}static struct ATweenTool* SetActionFadeTo(float fadeTo, float duration)
{SetAction();SetValue(ATweenActionValueGetSetImpl->fadeTo, fadeTo);SetDuration(duration);return ATweenTool;
}//--------------------------------------------------------------------------------------------------static struct ATweenTool* SetUserData(void* userData)
{CheckAction("SetUserData");action->userData = userData;return ATweenTool;
}static struct ATweenTool* SetQueue(bool isQueue)
{CheckAction("SetQueue");action->isQueue = isQueue;return ATweenTool;
}static struct ATweenTool* SetOnComplete(TweenActionOnComplete OnComplete)
{CheckAction("SetOnComplete");action->OnComplete = OnComplete;return ATweenTool;
}static struct ATweenTool* SetTarget(void* target)
{CheckAction("SetTarget");action->target = target;return ATweenTool;
}static struct ATweenTool* GetAction(TweenAction** outActionPtr)
{CheckAction("GetAction");*outActionPtr = action;return ATweenTool;
}//--------------------------------------------------------------------------------------------------static struct ATweenTool* SetMoveX(float moveX)
{return SetValue(ATweenActionValueGetSetImpl->moveX, moveX);
}static struct ATweenTool* SetMoveY(float moveY)
{return SetValue(ATweenActionValueGetSetImpl->moveY, moveY);
}static struct ATweenTool* SetScaleX(float scaleX)
{return SetValue(ATweenActionValueGetSetImpl->scaleX, scaleX);
}static struct ATweenTool* SetScaleY(float scaleY)
{return SetValue(ATweenActionValueGetSetImpl->scaleY, scaleY);
}static struct ATweenTool* SetRotateZ(float rotateZ)
{return SetValue(ATweenActionValueGetSetImpl->rotateZ, rotateZ);
}static struct ATweenTool* SetFadeTo(float fadeTo)
{return SetValue(ATweenActionValueGetSetImpl->fadeTo, fadeTo);
}//--------------------------------------------------------------------------------------------------static void RunActions(void* target)
{ALogA(target, "RunActions, target must not NULL");for (int i = 0; i < actionArr->length; i++){TweenAction* action = AArrayGet(actionArr, i, TweenAction*);if (action->actionValueList->size > 0){action->target = target;}}ATween->RunActions(actionArr, &target);actionArr->length = 0;action            = NULL;actionValue       = NULL;
}static void* RunTargets()
{for (int i = 0; i < actionArr->length; i++){TweenAction* action = AArrayGet(actionArr, i, TweenAction*);if (action->actionValueList->size > 0){ALogA(action->target != NULL,"RunActions, the {%d} action has actionValue, so must set target",i);}}void* tweenId = NULL;ATween->RunActions(actionArr, &tweenId);actionArr->length = 0;action            = NULL;actionValue       = NULL;return tweenId;
}struct ATweenTool ATweenTool[1] =
{SetAction,SetInterval,SetActionMoveX,SetActionMoveY,SetActionMove,SetActionScaleX,SetActionScaleY,SetActionScale,SetActionRotateZ,SetActionFadeTo,SetDuration,SetUserData,SetQueue,SetOnComplete,SetTarget,GetAction,SetMoveX,SetMoveY,SetScaleX,SetScaleY,SetRotateZ,SetFadeTo,SetRelative,SetEaseType,RunActions,RunTargets,
};#undef action_length
#undef CheckAction
#undef CheckActionValue

可以看到，所有链式调用的函数最后都会return ATweenTool结构。但执行tween动画以后，就会重置当前的上下文变量。那么，使用起来是一下这个样子的。 

ATweenTool->SetActionMoveX(deltaX * 0.95f, enemy->hurtXTime)->SetEaseType   (tween_ease_quad_in)->SetQueue      (false)->SetOnComplete (AttackOnComplete)->SetUserData   (enemy)->SetActionMoveY(0.03f, enemy->hurtYUpTime)->SetEaseType   (tween_ease_quad_in)->SetActionMoveY(-0.03f, enemy->hurtYDownTime)->SetEaseType   (tween_ease_quad_out)->RunActions    (enemyDrawable);

最后给出，额外辅助的结构。 

typedef struct
{TweenActionValueOnGet OnGet;TweenActionValueOnSet OnSet;
}
TweenActionValueGetSet;struct ATweenActionValueGetSetImpl
{TweenActionValueGetSet moveX  [1];TweenActionValueGetSet moveY  [1];TweenActionValueGetSet scaleX [1];TweenActionValueGetSet scaleY [1];TweenActionValueGetSet rotateZ[1];TweenActionValueGetSet fadeTo [1];
};/*** Application must implement tween action value get set method*/
extern struct ATweenActionValueGetSetImpl ATweenActionValueGetSetImpl[1];


这篇关于C 语言链式调用与Tween算法实现(4)链式封装接口的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/909520。

相关文章

Spring Boot整合Redis注解实现增删改查功能(Redis注解使用)

Spring Boot整合Redis注解实现增删改查功能(Redis注解使用)

《SpringBoot整合Redis注解实现增删改查功能(Redis注解使用)》文章介绍了如何使用SpringBoot整合Redis注解实现增删改查功能,包括配置、实体类、Repository、Se... 目录配置Redis连接定义实体类创建Repository接口增删改查操作示例插入数据查询数据删除数据更
阅读更多...
Java Lettuce 客户端入门到生产的实现步骤

Java Lettuce 客户端入门到生产的实现步骤

《JavaLettuce客户端入门到生产的实现步骤》本文主要介绍了JavaLettuce客户端入门到生产的实现步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要... 目录1 安装依赖MavenGradle2 最小化连接示例3 核心特性速览4 生产环境配置建议5 常见问题
阅读更多...
linux ssh如何实现增加访问端口

linux ssh如何实现增加访问端口

《linuxssh如何实现增加访问端口》Linux中SSH默认使用22端口,为了增强安全性或满足特定需求,可以通过修改SSH配置来增加或更改SSH访问端口,具体步骤包括修改SSH配置文件、增加或修改... 目录1. 修改 SSH 配置文件2. 增加或修改端口3. 保存并退出编辑器4. 更新防火墙规则使用uf
阅读更多...
Java 的ArrayList集合底层实现与最佳实践

Java 的ArrayList集合底层实现与最佳实践

《Java的ArrayList集合底层实现与最佳实践》本文主要介绍了Java的ArrayList集合类的核心概念、底层实现、关键成员变量、初始化机制、容量演变、扩容机制、性能分析、核心方法源码解析、... 目录1. 核心概念与底层实现1.1 ArrayList 的本质1.1.1 底层数据结构JDK 1.7
阅读更多...
C++中unordered_set哈希集合的实现

C++中unordered_set哈希集合的实现

《C++中unordered_set哈希集合的实现》std::unordered_set是C++标准库中的无序关联容器,基于哈希表实现,具有元素唯一性和无序性特点,本文就来详细的介绍一下unorder... 目录一、概述二、头文件与命名空间三、常用方法与示例1. 构造与析构2. 迭代器与遍历3. 容量相关4
阅读更多...
C++中悬垂引用(Dangling Reference) 的实现

C++中悬垂引用(Dangling Reference) 的实现

《C++中悬垂引用(DanglingReference)的实现》C++中的悬垂引用指引用绑定的对象被销毁后引用仍存在的情况,会导致访问无效内存,下面就来详细的介绍一下产生的原因以及如何避免,感兴趣... 目录悬垂引用的产生原因1. 引用绑定到局部变量，变量超出作用域后销毁2. 引用绑定到动态分配的对象，对象
阅读更多...
SpringBoot基于注解实现数据库字段回填的完整方案

SpringBoot基于注解实现数据库字段回填的完整方案

《SpringBoot基于注解实现数据库字段回填的完整方案》这篇文章主要为大家详细介绍了SpringBoot如何基于注解实现数据库字段回填的相关方法,文中的示例代码讲解详细,感兴趣的小伙伴可以了解... 目录数据库表pom.XMLRelationFieldRelationFieldMapping基础的一些代
阅读更多...
Java HashMap的底层实现原理深度解析

Java HashMap的底层实现原理深度解析

《JavaHashMap的底层实现原理深度解析》HashMap基于数组+链表+红黑树结构,通过哈希算法和扩容机制优化性能,负载因子与树化阈值平衡效率,是Java开发必备的高效数据结构,本文给大家介绍... 目录一、概述：HashMap的宏观结构二、核心数据结构解析1. 数组（桶数组）2. 链表节点（Node
阅读更多...
Java AOP面向切面编程的概念和实现方式

Java AOP面向切面编程的概念和实现方式

《JavaAOP面向切面编程的概念和实现方式》AOP是面向切面编程,通过动态代理将横切关注点（如日志、事务）与核心业务逻辑分离,提升代码复用性和可维护性,本文给大家介绍JavaAOP面向切面编程的概... 目录一、AOP 是什么？二、AOP 的核心概念与实现方式核心概念实现方式三、Spring AOP 的关
阅读更多...
从基础到高级详解Go语言中错误处理的实践指南

从基础到高级详解Go语言中错误处理的实践指南

《从基础到高级详解Go语言中错误处理的实践指南》Go语言采用了一种独特而明确的错误处理哲学,与其他主流编程语言形成鲜明对比,本文将为大家详细介绍Go语言中错误处理详细方法,希望对大家有所帮助... 目录1 Go 错误处理哲学与核心机制1.1 错误接口设计1.2 错误与异常的区别2 错误创建与检查2.1 基础
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2