@leejungkiin/awkit 1.5.5 → 1.5.6

package/skill-packs/cocos2d/skills/cocos2d-x/examples/core/input.md

@@ -0,0 +1,291 @@
+# Input（输入）处理指南
+
+## 官方文档
+
+参考官方文档：https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+
+## 概述
+
+Cocos2d-x 支持触摸、鼠标和键盘输入事件。
+
+## 触摸事件
+
+### 单点触摸
+
+```cpp
+class TouchLayer : public Layer
+{
+public:
+    CREATE_FUNC(TouchLayer);
+    virtual bool init() override;
+    
+private:
+    bool onTouchBegan(Touch* touch, Event* event);
+    void onTouchMoved(Touch* touch, Event* event);
+    void onTouchEnded(Touch* touch, Event* event);
+    void onTouchCancelled(Touch* touch, Event* event);
+};
+
+bool TouchLayer::init()
+{
+    if (!Layer::init())
+    {
+        return false;
+    }
+    
+    // 创建触摸监听器
+    auto listener = EventListenerTouchOneByOne::create();
+    listener->setSwallowTouches(true);
+    
+    // 绑定回调函数
+    listener->onTouchBegan = CC_CALLBACK_2(TouchLayer::onTouchBegan, this);
+    listener->onTouchMoved = CC_CALLBACK_2(TouchLayer::onTouchMoved, this);
+    listener->onTouchEnded = CC_CALLBACK_2(TouchLayer::onTouchEnded, this);
+    listener->onTouchCancelled = CC_CALLBACK_2(TouchLayer::onTouchCancelled, this);
+    
+    // 注册监听器
+    _eventDispatcher->addEventListenerWithSceneGraphPriority(listener, this);
+    
+    return true;
+}
+
+bool TouchLayer::onTouchBegan(Touch* touch, Event* event)
+{
+    Vec2 location = touch->getLocation();
+    log("Touch began at: (%.2f, %.2f)", location.x, location.y);
+    return true; // 返回 true 表示要接收后续事件
+}
+
+void TouchLayer::onTouchMoved(Touch* touch, Event* event)
+{
+    Vec2 location = touch->getLocation();
+    log("Touch moved to: (%.2f, %.2f)", location.x, location.y);
+}
+
+void TouchLayer::onTouchEnded(Touch* touch, Event* event)
+{
+    Vec2 location = touch->getLocation();
+    log("Touch ended at: (%.2f, %.2f)", location.x, location.y);
+}
+
+void TouchLayer::onTouchCancelled(Touch* touch, Event* event)
+{
+    log("Touch cancelled");
+}
+```
+
+### 多点触摸
+
+```cpp
+class MultiTouchLayer : public Layer
+{
+public:
+    CREATE_FUNC(MultiTouchLayer);
+    virtual bool init() override;
+    
+private:
+    void onTouchesBegan(const std::vector<Touch*>& touches, Event* event);
+    void onTouchesMoved(const std::vector<Touch*>& touches, Event* event);
+    void onTouchesEnded(const std::vector<Touch*>& touches, Event* event);
+};
+
+bool MultiTouchLayer::init()
+{
+    if (!Layer::init())
+    {
+        return false;
+    }
+    
+    auto listener = EventListenerTouchAllAtOnce::create();
+    listener->onTouchesBegan = CC_CALLBACK_2(MultiTouchLayer::onTouchesBegan, this);
+    listener->onTouchesMoved = CC_CALLBACK_2(MultiTouchLayer::onTouchesMoved, this);
+    listener->onTouchesEnded = CC_CALLBACK_2(MultiTouchLayer::onTouchesEnded, this);
+    
+    _eventDispatcher->addEventListenerWithSceneGraphPriority(listener, this);
+    
+    return true;
+}
+
+void MultiTouchLayer::onTouchesBegan(const std::vector<Touch*>& touches, Event* event)
+{
+    log("Touches began: %zu touches", touches.size());
+    for (auto touch : touches)
+    {
+        Vec2 location = touch->getLocation();
+        log("  Touch at: (%.2f, %.2f)", location.x, location.y);
+    }
+}
+```
+
+## 鼠标事件
+
+```cpp
+class MouseLayer : public Layer
+{
+public:
+    CREATE_FUNC(MouseLayer);
+    virtual bool init() override;
+    
+private:
+    void onMouseDown(Event* event);
+    void onMouseUp(Event* event);
+    void onMouseMove(Event* event);
+    void onMouseScroll(Event* event);
+};
+
+bool MouseLayer::init()
+{
+    if (!Layer::init())
+    {
+        return false;
+    }
+    
+    auto listener = EventListenerMouse::create();
+    listener->onMouseDown = CC_CALLBACK_1(MouseLayer::onMouseDown, this);
+    listener->onMouseUp = CC_CALLBACK_1(MouseLayer::onMouseUp, this);
+    listener->onMouseMove = CC_CALLBACK_1(MouseLayer::onMouseMove, this);
+    listener->onMouseScroll = CC_CALLBACK_1(MouseLayer::onMouseScroll, this);
+    
+    _eventDispatcher->addEventListenerWithSceneGraphPriority(listener, this);
+    
+    return true;
+}
+
+void MouseLayer::onMouseDown(Event* event)
+{
+    EventMouse* mouseEvent = static_cast<EventMouse*>(event);
+    Vec2 location = mouseEvent->getLocationInView();
+    log("Mouse down at: (%.2f, %.2f)", location.x, location.y);
+}
+
+void MouseLayer::onMouseScroll(Event* event)
+{
+    EventMouse* mouseEvent = static_cast<EventMouse*>(event);
+    float scrollY = mouseEvent->getScrollY();
+    log("Mouse scroll: %.2f", scrollY);
+}
+```
+
+## 键盘事件
+
+```cpp
+class KeyboardLayer : public Layer
+{
+public:
+    CREATE_FUNC(KeyboardLayer);
+    virtual bool init() override;
+    
+private:
+    void onKeyPressed(EventKeyboard::KeyCode keyCode, Event* event);
+    void onKeyReleased(EventKeyboard::KeyCode keyCode, Event* event);
+};
+
+bool KeyboardLayer::init()
+{
+    if (!Layer::init())
+    {
+        return false;
+    }
+    
+    auto listener = EventListenerKeyboard::create();
+    listener->onKeyPressed = CC_CALLBACK_2(KeyboardLayer::onKeyPressed, this);
+    listener->onKeyReleased = CC_CALLBACK_2(KeyboardLayer::onKeyReleased, this);
+    
+    _eventDispatcher->addEventListenerWithSceneGraphPriority(listener, this);
+    
+    return true;
+}
+
+void KeyboardLayer::onKeyPressed(EventKeyboard::KeyCode keyCode, Event* event)
+{
+    switch (keyCode)
+    {
+        case EventKeyboard::KeyCode::KEY_LEFT_ARROW:
+            log("Left arrow pressed");
+            break;
+        case EventKeyboard::KeyCode::KEY_RIGHT_ARROW:
+            log("Right arrow pressed");
+            break;
+        case EventKeyboard::KeyCode::KEY_SPACE:
+            log("Space pressed");
+            break;
+        default:
+            break;
+    }
+}
+```
+
+## 拖拽示例
+
+```cpp
+class DragLayer : public Layer
+{
+public:
+    CREATE_FUNC(DragLayer);
+    virtual bool init() override;
+    
+private:
+    bool onTouchBegan(Touch* touch, Event* event);
+    void onTouchMoved(Touch* touch, Event* event);
+    void onTouchEnded(Touch* touch, Event* event);
+    
+    Sprite* _draggedSprite;
+    bool _isDragging;
+};
+
+bool DragLayer::init()
+{
+    if (!Layer::init())
+    {
+        return false;
+    }
+    
+    // 创建可拖拽的精灵
+    _draggedSprite = Sprite::create("player.png");
+    _draggedSprite->setPosition(Vec2(400, 300));
+    this->addChild(_draggedSprite);
+    
+    _isDragging = false;
+    
+    auto listener = EventListenerTouchOneByOne::create();
+    listener->onTouchBegan = CC_CALLBACK_2(DragLayer::onTouchBegan, this);
+    listener->onTouchMoved = CC_CALLBACK_2(DragLayer::onTouchMoved, this);
+    listener->onTouchEnded = CC_CALLBACK_2(DragLayer::onTouchEnded, this);
+    
+    _eventDispatcher->addEventListenerWithSceneGraphPriority(listener, this);
+    
+    return true;
+}
+
+bool DragLayer::onTouchBegan(Touch* touch, Event* event)
+{
+    Vec2 location = touch->getLocation();
+    Rect rect = _draggedSprite->getBoundingBox();
+    
+    if (rect.containsPoint(location))
+    {
+        _isDragging = true;
+        return true;
+    }
+    return false;
+}
+
+void DragLayer::onTouchMoved(Touch* touch, Event* event)
+{
+    if (_isDragging)
+    {
+        Vec2 location = touch->getLocation();
+        _draggedSprite->setPosition(location);
+    }
+}
+
+void DragLayer::onTouchEnded(Touch* touch, Event* event)
+{
+    _isDragging = false;
+}
+```
+
+## 参考资源
+
+- **官方文档**: https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+- **Event 系统**: `examples/core/event.md`

package/skill-packs/cocos2d/skills/cocos2d-x/examples/core/label.md

@@ -0,0 +1,184 @@
+# Label（标签）使用指南
+
+## 官方文档
+
+参考官方文档：https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+
+## Instructions
+
+Label 用于在游戏中显示文本。Cocos2d-x 支持多种标签类型：TTF、BMFont、CharMap。
+
+### Syntax
+
+#### Label 类型
+
+- `Label::createWithTTF()` - 使用 TTF 字体文件
+- `Label::createWithBMFont()` - 使用 BMFont 位图字体
+- `Label::createWithCharMap()` - 使用字符映射
+- `Label::createWithSystemFont()` - 使用系统字体
+
+#### Label 属性
+
+- `setString()` - 设置文本内容
+- `setFontSize()` - 设置字体大小
+- `setTextColor()` - 设置文本颜色
+- `setAlignment()` - 设置对齐方式
+- `setDimensions()` - 设置文本区域大小
+
+### Example (TTF 标签)
+
+```cpp
+// 使用 TTF 字体文件创建标签
+auto label = Label::createWithTTF("Hello Cocos2d-x", "fonts/Marker Felt.ttf", 24);
+label->setPosition(Vec2(400, 300));
+label->setColor(Color3B::WHITE);
+this->addChild(label);
+```
+
+### Example (系统字体标签)
+
+```cpp
+// 使用系统字体创建标签
+auto label = Label::createWithSystemFont("Hello World", "Arial", 24);
+label->setPosition(Vec2(400, 300));
+this->addChild(label);
+```
+
+### Example (BMFont 标签)
+
+```cpp
+// 使用 BMFont 位图字体创建标签
+auto label = Label::createWithBMFont("fonts/bitmap-font.fnt", "Hello");
+label->setPosition(Vec2(400, 300));
+this->addChild(label);
+```
+
+### Example (标签属性设置)
+
+```cpp
+auto label = Label::createWithTTF("Hello World", "fonts/Marker Felt.ttf", 24);
+
+// 设置文本
+label->setString("New Text");
+
+// 设置字体大小
+label->setFontSize(32);
+
+// 设置文本颜色
+label->setTextColor(Color4B::RED);
+label->setColor(Color3B::GREEN);
+
+// 设置对齐方式
+label->setAlignment(TextHAlignment::CENTER, TextVAlignment::CENTER);
+
+// 设置文本区域（自动换行）
+label->setDimensions(200, 100);
+label->enableWrap(true);
+
+// 设置行间距
+label->setLineSpacing(10);
+
+// 设置透明度
+label->setOpacity(200);
+```
+
+### Example (多行文本)
+
+```cpp
+auto label = Label::createWithTTF(
+    "This is a long text that will wrap to multiple lines",
+    "fonts/Marker Felt.ttf",
+    20
+);
+
+// 设置文本区域大小（自动换行）
+label->setDimensions(300, 0); // 宽度 300，高度自动
+label->enableWrap(true);
+label->setAlignment(TextHAlignment::LEFT, TextVAlignment::TOP);
+
+label->setPosition(Vec2(400, 300));
+this->addChild(label);
+```
+
+### Example (标签效果)
+
+```cpp
+auto label = Label::createWithTTF("Hello", "fonts/Marker Felt.ttf", 48);
+
+// 描边效果
+label->enableOutline(Color4B::BLACK, 2);
+
+// 阴影效果
+label->enableShadow(Color4B::GRAY, Size(2, -2), 0);
+
+// 发光效果
+label->enableGlow(Color4B::YELLOW);
+
+label->setPosition(Vec2(400, 300));
+this->addChild(label);
+```
+
+### Example (动态更新文本)
+
+```cpp
+class ScoreLabel : public Label
+{
+public:
+    CREATE_FUNC(ScoreLabel);
+    virtual bool init() override;
+    
+    void updateScore(int score);
+    
+private:
+    int _score;
+};
+
+bool ScoreLabel::init()
+{
+    if (!Label::initWithTTF("Score: 0", "fonts/Marker Felt.ttf", 24))
+    {
+        return false;
+    }
+    
+    _score = 0;
+    this->setPosition(Vec2(100, 500));
+    this->setColor(Color3B::WHITE);
+    
+    return true;
+}
+
+void ScoreLabel::updateScore(int score)
+{
+    _score += score;
+    std::string text = StringUtils::format("Score: %d", _score);
+    this->setString(text);
+}
+```
+
+### Example (富文本标签)
+
+```cpp
+// 创建富文本标签
+auto richText = RichText::create();
+richText->setContentSize(Size(400, 100));
+
+// 添加普通文本
+auto text1 = RichElementText::create(1, Color3B::WHITE, 255, "Hello ", "fonts/Marker Felt.ttf", 24);
+richText->pushBackElement(text1);
+
+// 添加彩色文本
+auto text2 = RichElementText::create(2, Color3B::RED, 255, "Cocos2d-x", "fonts/Marker Felt.ttf", 24);
+richText->pushBackElement(text2);
+
+// 添加图片
+auto image = RichElementImage::create(3, Color3B::WHITE, 255, "icon.png");
+richText->pushBackElement(image);
+
+richText->setPosition(Vec2(400, 300));
+this->addChild(richText);
+```
+
+## Reference
+
+- **官方文档**: https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+- **Sprite 指南**: `examples/core/sprite.md`

package/skill-packs/cocos2d/skills/cocos2d-x/examples/core/node-scene.md

@@ -0,0 +1,212 @@
+# Node 和 Scene 基础
+
+## 官方文档
+
+参考官方文档：https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+
+## Instructions
+
+Node 是 Cocos2d-x 中所有显示对象的基础类，Scene 是场景图的根节点。理解 Node 和 Scene 的关系是使用 Cocos2d-x 的基础。
+
+### Syntax
+
+#### Node 基础
+
+- 所有显示对象都继承自 `Node`
+- Node 支持位置、旋转、缩放、锚点等变换
+- Node 可以添加子节点形成树结构
+- Node 有生命周期方法：`onEnter()`, `onExit()`, `onEnterTransitionDidFinish()`, `onExitTransitionDidStart()`
+
+#### Scene 基础
+
+- Scene 继承自 Node，是场景图的根节点
+- 通过 Director 管理场景切换
+- 一个应用同时只能有一个运行的 Scene
+
+### Example (创建基本 Node)
+
+```cpp
+#include "cocos2d.h"
+
+USING_NS_CC;
+
+// 创建一个简单的 Node
+auto node = Node::create();
+node->setPosition(Vec2(400, 300));
+node->setRotation(45.0f);
+node->setScale(1.5f);
+node->setAnchorPoint(Vec2(0.5f, 0.5f));
+
+// 添加到场景
+scene->addChild(node);
+```
+
+### Example (Node 层次结构)
+
+```cpp
+// 创建父节点
+auto parent = Node::create();
+parent->setPosition(Vec2(400, 300));
+
+// 创建子节点
+auto child1 = Sprite::create("sprite1.png");
+child1->setPosition(Vec2(-50, 0)); // 相对于父节点
+parent->addChild(child1);
+
+auto child2 = Sprite::create("sprite2.png");
+child2->setPosition(Vec2(50, 0)); // 相对于父节点
+parent->addChild(child2);
+
+// 添加到场景
+scene->addChild(parent);
+```
+
+### Example (创建 Scene)
+
+```cpp
+class HelloWorld : public Scene
+{
+public:
+    static Scene* createScene();
+    virtual bool init();
+    CREATE_FUNC(HelloWorld);
+};
+
+Scene* HelloWorld::createScene()
+{
+    return HelloWorld::create();
+}
+
+bool HelloWorld::init()
+{
+    if (!Scene::init())
+    {
+        return false;
+    }
+    
+    auto visibleSize = Director::getInstance()->getVisibleSize();
+    Vec2 origin = Director::getInstance()->getVisibleOrigin();
+    
+    // 添加内容到场景
+    auto label = Label::createWithTTF("Hello World", "fonts/Marker Felt.ttf", 24);
+    label->setPosition(Vec2(origin.x + visibleSize.width/2,
+                            origin.y + visibleSize.height - label->getContentSize().height));
+    this->addChild(label, 1);
+    
+    return true;
+}
+```
+
+### Example (Node 生命周期)
+
+```cpp
+class MyNode : public Node
+{
+public:
+    CREATE_FUNC(MyNode);
+    virtual bool init() override;
+    virtual void onEnter() override;
+    virtual void onEnterTransitionDidFinish() override;
+    virtual void onExit() override;
+    virtual void onExitTransitionDidStart() override;
+};
+
+bool MyNode::init()
+{
+    if (!Node::init())
+    {
+        return false;
+    }
+    log("Node initialized");
+    return true;
+}
+
+void MyNode::onEnter()
+{
+    Node::onEnter();
+    log("Node entered");
+}
+
+void MyNode::onEnterTransitionDidFinish()
+{
+    Node::onEnterTransitionDidFinish();
+    log("Node transition finished");
+}
+
+void MyNode::onExit()
+{
+    Node::onExit();
+    log("Node exited");
+}
+
+void MyNode::onExitTransitionDidStart()
+{
+    Node::onExitTransitionDidStart();
+    log("Node transition started");
+}
+```
+
+### Example (坐标系统)
+
+```cpp
+// Cocos2d-x 使用 OpenGL 坐标系
+// 原点在左下角，Y 轴向上
+
+auto sprite = Sprite::create("player.png");
+
+// 设置位置（世界坐标）
+sprite->setPosition(Vec2(400, 300));
+
+// 设置锚点（0.5, 0.5 表示中心）
+sprite->setAnchorPoint(Vec2(0.5f, 0.5f));
+
+// 获取世界坐标
+Vec2 worldPos = sprite->getPosition();
+
+// 转换为节点本地坐标
+Vec2 localPos = sprite->convertToNodeSpace(worldPos);
+
+// 转换为世界坐标
+Vec2 worldPos2 = sprite->convertToWorldSpace(localPos);
+```
+
+### Example (Node 变换)
+
+```cpp
+auto node = Node::create();
+
+// 位置
+node->setPosition(Vec2(400, 300));
+node->setPositionX(400);
+node->setPositionY(300);
+
+// 旋转（角度）
+node->setRotation(45.0f);
+node->setRotationX(30.0f);
+node->setRotationY(60.0f);
+
+// 缩放
+node->setScale(2.0f);        // 统一缩放
+node->setScaleX(1.5f);       // X 轴缩放
+node->setScaleY(0.8f);       // Y 轴缩放
+
+// 锚点
+node->setAnchorPoint(Vec2(0.5f, 0.5f)); // 中心
+node->setAnchorPoint(Vec2(0.0f, 0.0f)); // 左下角
+node->setAnchorPoint(Vec2(1.0f, 1.0f)); // 右上角
+
+// 可见性
+node->setVisible(true);
+node->setVisible(false);
+
+// 透明度
+node->setOpacity(255); // 完全不透明
+node->setOpacity(128); // 半透明
+node->setOpacity(0);   // 完全透明
+```
+
+## Reference
+
+- **官方文档**: https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+- **Scene 指南**: `examples/core/scene.md`
+- **Sprite 指南**: `examples/core/sprite.md`