@leejungkiin/awkit 1.5.4 → 1.5.6

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

@@ -0,0 +1,228 @@
+# Scene（场景）管理指南
+
+## 官方文档
+
+参考官方文档：https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+
+## 概述
+
+Scene 是场景图的根节点，通过 Director 管理场景的切换和生命周期。
+
+## 创建场景
+
+### 基本场景
+
+```cpp
+class GameScene : public Scene
+{
+public:
+    static Scene* createScene();
+    virtual bool init();
+    CREATE_FUNC(GameScene);
+};
+
+Scene* GameScene::createScene()
+{
+    return GameScene::create();
+}
+
+bool GameScene::init()
+{
+    if (!Scene::init())
+    {
+        return false;
+    }
+    
+    // 场景初始化代码
+    auto label = Label::createWithTTF("Game Scene", "fonts/Marker Felt.ttf", 24);
+    label->setPosition(Vec2(400, 300));
+    this->addChild(label);
+    
+    return true;
+}
+```
+
+## 场景切换
+
+### 直接切换
+
+```cpp
+// 切换到新场景
+auto newScene = GameScene::createScene();
+Director::getInstance()->replaceScene(newScene);
+```
+
+### 带过渡效果的切换
+
+```cpp
+// 淡入淡出过渡
+auto transition = TransitionFade::create(1.0f, GameScene::createScene());
+Director::getInstance()->replaceScene(transition);
+
+// 翻页过渡
+auto transition = TransitionPageTurn::create(1.0f, GameScene::createScene(), false);
+Director::getInstance()->replaceScene(transition);
+
+// 滑动过渡
+auto transition = TransitionSlideInR::create(1.0f, GameScene::createScene());
+Director::getInstance()->replaceScene(transition);
+```
+
+## 场景生命周期
+
+```cpp
+class GameScene : public Scene
+{
+public:
+    virtual void onEnter() override;
+    virtual void onEnterTransitionDidFinish() override;
+    virtual void onExit() override;
+    virtual void onExitTransitionDidStart() override;
+};
+
+void GameScene::onEnter()
+{
+    Scene::onEnter();
+    log("Scene entered");
+    // 场景进入时的初始化
+}
+
+void GameScene::onEnterTransitionDidFinish()
+{
+    Scene::onEnterTransitionDidFinish();
+    log("Scene transition finished");
+    // 过渡完成后的操作
+}
+
+void GameScene::onExit()
+{
+    Scene::onExit();
+    log("Scene exiting");
+    // 场景退出时的清理
+}
+
+void GameScene::onExitTransitionDidStart()
+{
+    Scene::onExitTransitionDidStart();
+    log("Scene transition started");
+    // 过渡开始时的操作
+}
+```
+
+## 场景层次结构
+
+```cpp
+bool GameScene::init()
+{
+    if (!Scene::init())
+    {
+        return false;
+    }
+    
+    // 背景层
+    auto backgroundLayer = Layer::create();
+    auto bgSprite = Sprite::create("background.png");
+    bgSprite->setPosition(Vec2(400, 300));
+    backgroundLayer->addChild(bgSprite);
+    this->addChild(backgroundLayer, 0);
+    
+    // 游戏层
+    auto gameLayer = Layer::create();
+    // 添加游戏对象
+    this->addChild(gameLayer, 1);
+    
+    // UI 层
+    auto uiLayer = Layer::create();
+    // 添加 UI 元素
+    this->addChild(uiLayer, 2);
+    
+    return true;
+}
+```
+
+## Director 使用
+
+### 获取 Director 实例
+
+```cpp
+auto director = Director::getInstance();
+```
+
+### 获取窗口信息
+
+```cpp
+auto director = Director::getInstance();
+auto visibleSize = director->getVisibleSize();
+Vec2 origin = director->getVisibleOrigin();
+Vec2 center = Vec2(visibleSize.width/2 + origin.x, 
+                   visibleSize.height/2 + origin.y);
+```
+
+### 暂停和恢复
+
+```cpp
+// 暂停场景
+Director::getInstance()->pause();
+
+// 恢复场景
+Director::getInstance()->resume();
+```
+
+## 完整示例
+
+```cpp
+class MenuScene : public Scene
+{
+public:
+    static Scene* createScene();
+    virtual bool init();
+    CREATE_FUNC(MenuScene);
+    
+private:
+    void onPlayButtonClicked(Ref* sender);
+};
+
+bool MenuScene::init()
+{
+    if (!Scene::init())
+    {
+        return false;
+    }
+    
+    auto visibleSize = Director::getInstance()->getVisibleSize();
+    Vec2 origin = Director::getInstance()->getVisibleOrigin();
+    
+    // 标题
+    auto title = Label::createWithTTF("My Game", "fonts/Marker Felt.ttf", 48);
+    title->setPosition(Vec2(origin.x + visibleSize.width/2,
+                            origin.y + visibleSize.height - 100));
+    this->addChild(title, 1);
+    
+    // 开始按钮
+    auto playButton = MenuItemImage::create(
+        "button_play.png",
+        "button_play_selected.png",
+        CC_CALLBACK_1(MenuScene::onPlayButtonClicked, this));
+    playButton->setPosition(Vec2(origin.x + visibleSize.width/2,
+                                 origin.y + visibleSize.height/2));
+    
+    auto menu = Menu::create(playButton, nullptr);
+    menu->setPosition(Vec2::ZERO);
+    this->addChild(menu, 1);
+    
+    return true;
+}
+
+void MenuScene::onPlayButtonClicked(Ref* sender)
+{
+    auto gameScene = GameScene::createScene();
+    auto transition = TransitionFade::create(0.5f, gameScene);
+    Director::getInstance()->replaceScene(transition);
+}
+```
+
+## 参考资源
+
+- **官方文档**: https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+- **Node 指南**: `examples/core/node-scene.md`
+- **Director API**: `api/director.md`

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

@@ -0,0 +1,206 @@
+# Sprite（精灵）使用指南
+
+## 官方文档
+
+参考官方文档：https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+
+## Instructions
+
+Sprite 是 Cocos2d-x 中用于显示图片的基本节点类。Sprite 继承自 Node，可以显示纹理、支持动画、变换等操作。
+
+### Syntax
+
+#### 创建 Sprite
+
+- `Sprite::create("filename.png")` - 从图片文件创建
+- `Sprite::createWithTexture(texture)` - 从纹理创建
+- `Sprite::createWithSpriteFrame(frame)` - 从精灵帧创建
+- `Sprite::createWithSpriteFrameName("frame_name")` - 从精灵帧名称创建
+- `Sprite::create("filename.png", Rect(x, y, width, height))` - 从纹理区域创建
+
+### Example (从文件创建)
+
+```cpp
+// 从图片文件创建
+auto sprite = Sprite::create("player.png");
+this->addChild(sprite);
+
+// 指定位置
+sprite->setPosition(Vec2(100, 100));
+```
+
+### Example (从纹理创建)
+
+```cpp
+// 从纹理创建
+auto texture = Director::getInstance()->getTextureCache()->addImage("player.png");
+auto sprite = Sprite::createWithTexture(texture);
+this->addChild(sprite);
+```
+
+### Example (从纹理矩形创建)
+
+```cpp
+// 从纹理的某个区域创建（精灵表）
+auto sprite = Sprite::create("spritesheet.png", Rect(0, 0, 32, 32));
+this->addChild(sprite);
+```
+
+#### Sprite 属性
+
+- `setPosition(Vec2)` - 设置位置
+- `setRotation(float)` - 设置旋转角度
+- `setScale(float)` - 设置缩放
+- `setAnchorPoint(Vec2)` - 设置锚点
+- `setOpacity(GLubyte)` - 设置透明度
+- `setColor(Color3B)` - 设置颜色
+- `setFlippedX(bool)` - 水平翻转
+- `setFlippedY(bool)` - 垂直翻转
+
+### Example (位置和变换)
+
+```cpp
+auto sprite = Sprite::create("player.png");
+
+// 设置位置
+sprite->setPosition(Vec2(400, 300));
+
+// 设置锚点（默认 0.5, 0.5）
+sprite->setAnchorPoint(Vec2(0.5f, 0.5f));
+
+// 设置旋转
+sprite->setRotation(45.0f);
+
+// 设置缩放
+sprite->setScale(2.0f);  // 统一缩放
+sprite->setScaleX(1.5f); // X 轴缩放
+sprite->setScaleY(0.8f); // Y 轴缩放
+
+// 设置透明度
+sprite->setOpacity(128); // 0-255
+
+// 设置颜色
+sprite->setColor(Color3B::RED);
+```
+
+### 翻转
+
+```cpp
+// 水平翻转
+sprite->setFlippedX(true);
+
+// 垂直翻转
+sprite->setFlippedY(true);
+```
+
+### Example (动画 Sprite - 使用 SpriteFrame)
+
+```cpp
+// 创建 SpriteFrame 缓存
+auto cache = SpriteFrameCache::getInstance();
+cache->addSpriteFramesWithFile("spritesheet.plist", "spritesheet.png");
+
+// 从 SpriteFrame 创建
+auto sprite = Sprite::createWithSpriteFrameName("player_idle_01.png");
+this->addChild(sprite);
+```
+
+### Example (帧动画)
+
+```cpp
+Vector<SpriteFrame*> frames;
+for (int i = 1; i <= 4; i++)
+{
+    std::string frameName = StringUtils::format("player_walk_%02d.png", i);
+    auto frame = cache->getSpriteFrameByName(frameName);
+    frames.pushBack(frame);
+}
+
+auto animation = Animation::createWithSpriteFrames(frames, 0.1f);
+auto animate = Animate::create(animation);
+auto repeat = RepeatForever::create(animate);
+
+sprite->runAction(repeat);
+```
+
+### Example (完整示例)
+
+```cpp
+class GameScene : public Scene
+{
+public:
+    static Scene* createScene();
+    virtual bool init();
+    CREATE_FUNC(GameScene);
+    
+private:
+    Sprite* _player;
+};
+
+bool GameScene::init()
+{
+    if (!Scene::init())
+    {
+        return false;
+    }
+    
+    // 创建玩家精灵
+    _player = Sprite::create("player.png");
+    _player->setPosition(Vec2(400, 300));
+    _player->setAnchorPoint(Vec2(0.5f, 0.5f));
+    this->addChild(_player, 1);
+    
+    // 添加动画
+    auto cache = SpriteFrameCache::getInstance();
+    cache->addSpriteFramesWithFile("player.plist", "player.png");
+    
+    Vector<SpriteFrame*> frames;
+    for (int i = 1; i <= 4; i++)
+    {
+        auto frame = cache->getSpriteFrameByName(
+            StringUtils::format("player_walk_%02d.png", i));
+        frames.pushBack(frame);
+    }
+    
+    auto animation = Animation::createWithSpriteFrames(frames, 0.1f);
+    auto animate = Animate::create(animation);
+    auto repeat = RepeatForever::create(animate);
+    _player->runAction(repeat);
+    
+    return true;
+}
+```
+
+### Example (性能优化 - 使用 SpriteBatchNode)
+
+```cpp
+// 批量渲染相同纹理的精灵
+auto batchNode = SpriteBatchNode::create("spritesheet.png", 100);
+this->addChild(batchNode);
+
+for (int i = 0; i < 50; i++)
+{
+    auto sprite = Sprite::createWithTexture(batchNode->getTexture(), 
+                                             Rect(i * 32, 0, 32, 32));
+    sprite->setPosition(Vec2(i * 50, 100));
+    batchNode->addChild(sprite);
+}
+```
+
+### Example (纹理缓存)
+
+```cpp
+// 预加载纹理
+auto textureCache = Director::getInstance()->getTextureCache();
+textureCache->addImage("player.png");
+textureCache->addImage("enemy.png");
+
+// 使用缓存的纹理
+auto sprite = Sprite::create("player.png"); // 从缓存获取
+```
+
+## Reference
+
+- **官方文档**: https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+- **Texture 指南**: `examples/core/texture.md`
+- **Animation 指南**: `examples/core/animation.md`

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

@@ -0,0 +1,186 @@
+# Texture（纹理）使用指南
+
+## 官方文档
+
+参考官方文档：https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+
+## Instructions
+
+Texture 用于加载和管理图片资源。Cocos2d-x 使用 TextureCache 来缓存纹理，提高性能。
+
+### Syntax
+
+#### 纹理加载
+
+- 使用 `Director::getInstance()->getTextureCache()` 获取纹理缓存
+- `addImage()` 方法加载并缓存纹理
+- `getTextureForKey()` 获取已缓存的纹理
+- `removeTexture()` 移除纹理
+- `removeAllTextures()` 清除所有纹理
+
+#### 纹理属性
+
+- `getPixelsWide()` - 获取纹理宽度
+- `getPixelsHigh()` - 获取纹理高度
+- `getContentSize()` - 获取内容大小
+- `getPixelFormat()` - 获取像素格式
+
+### Example (加载纹理)
+
+```cpp
+// 获取纹理缓存
+auto textureCache = Director::getInstance()->getTextureCache();
+
+// 加载纹理（会自动缓存）
+auto texture = textureCache->addImage("player.png");
+
+// 从纹理创建精灵
+auto sprite = Sprite::createWithTexture(texture);
+this->addChild(sprite);
+```
+
+### Example (异步加载纹理)
+
+```cpp
+auto textureCache = Director::getInstance()->getTextureCache();
+
+// 异步加载纹理
+textureCache->addImageAsync("large_image.png", [this](Texture2D* texture) {
+    if (texture)
+    {
+        auto sprite = Sprite::createWithTexture(texture);
+        this->addChild(sprite);
+        log("Texture loaded successfully");
+    }
+    else
+    {
+        log("Failed to load texture");
+    }
+});
+```
+
+### Example (纹理缓存管理)
+
+```cpp
+auto textureCache = Director::getInstance()->getTextureCache();
+
+// 预加载纹理
+textureCache->addImage("player.png");
+textureCache->addImage("enemy.png");
+textureCache->addImage("background.png");
+
+// 获取已缓存的纹理
+auto texture = textureCache->getTextureForKey("player.png");
+if (texture)
+{
+    auto sprite = Sprite::createWithTexture(texture);
+    this->addChild(sprite);
+}
+
+// 移除单个纹理
+textureCache->removeTexture(texture);
+
+// 清除所有纹理（谨慎使用）
+// textureCache->removeAllTextures();
+```
+
+### Example (纹理信息)
+
+```cpp
+auto texture = Director::getInstance()->getTextureCache()->addImage("player.png");
+
+// 获取纹理尺寸
+int width = texture->getPixelsWide();
+int height = texture->getPixelsHigh();
+log("Texture size: %d x %d", width, height);
+
+// 获取内容大小
+Size contentSize = texture->getContentSize();
+log("Content size: %.2f x %.2f", contentSize.width, contentSize.height);
+
+// 获取像素格式
+Texture2D::PixelFormat format = texture->getPixelFormat();
+log("Pixel format: %d", format);
+```
+
+### Example (从纹理区域创建精灵)
+
+```cpp
+// 加载纹理
+auto texture = Director::getInstance()->getTextureCache()->addImage("spritesheet.png");
+
+// 从纹理的某个区域创建精灵（精灵表）
+Rect rect(0, 0, 32, 32); // x, y, width, height
+auto sprite = Sprite::createWithTexture(texture, rect);
+sprite->setPosition(Vec2(400, 300));
+this->addChild(sprite);
+```
+
+### Example (纹理预加载)
+
+```cpp
+class GameScene : public Scene
+{
+public:
+    static Scene* createScene();
+    virtual bool init();
+    CREATE_FUNC(GameScene);
+    
+private:
+    void preloadTextures();
+    int _loadedCount;
+    int _totalCount;
+};
+
+void GameScene::preloadTextures()
+{
+    auto textureCache = Director::getInstance()->getTextureCache();
+    
+    std::vector<std::string> textures = {
+        "player.png",
+        "enemy.png",
+        "background.png",
+        "bullet.png"
+    };
+    
+    _totalCount = textures.size();
+    _loadedCount = 0;
+    
+    for (const auto& texturePath : textures)
+    {
+        textureCache->addImageAsync(texturePath, [this](Texture2D* texture) {
+            _loadedCount++;
+            log("Loaded %d/%d textures", _loadedCount, _totalCount);
+            
+            if (_loadedCount == _totalCount)
+            {
+                log("All textures loaded!");
+                // 开始游戏
+            }
+        });
+    }
+}
+```
+
+### Example (内存管理)
+
+```cpp
+// 在场景退出时清理不需要的纹理
+void GameScene::onExit()
+{
+    Scene::onExit();
+    
+    // 移除游戏相关的纹理
+    auto textureCache = Director::getInstance()->getTextureCache();
+    textureCache->removeTextureForKey("player.png");
+    textureCache->removeTextureForKey("enemy.png");
+    
+    // 注意：不要清除所有纹理，因为可能其他场景还在使用
+}
+```
+
+## Reference
+
+- **官方文档**: https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+- **Sprite 指南**: `examples/core/sprite.md`
+- **资源管理**: `examples/core/resources.md`

package/skill-packs/cocos2d/skills/cocos2d-x/examples/getting-started/about-engine.md

@@ -0,0 +1,53 @@
+# Cocos2d-x 引擎概述
+
+## 官方文档
+
+参考官方文档：https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+
+## 概述
+
+Cocos2d-x 是一个开源的跨平台游戏开发框架，支持 C++ 开发，可以发布到多个平台。
+
+## 引擎特性
+
+### 跨平台支持
+- **桌面平台**: Windows, macOS, Linux
+- **移动平台**: Android, iOS
+- **Web平台**: 通过 Cocos Creator 支持
+
+### 核心功能
+- 2D 图形渲染
+- 精灵（Sprite）系统
+- 动作（Action）系统
+- 场景（Scene）管理
+- 物理引擎集成（Box2D）
+- 音频系统
+- 粒子系统
+- 动画系统
+
+### 技术特点
+- 基于 OpenGL ES 渲染
+- 使用 C++ 开发
+- CMake 构建系统
+- 高性能渲染管线
+- 支持自定义 Shader
+
+## 版本信息
+
+- **当前版本**: Cocos2d-x v4
+- **主要语言**: C++
+- **构建系统**: CMake
+- **渲染后端**: OpenGL ES
+
+## 适用场景
+
+- 2D 游戏开发
+- 跨平台游戏应用
+- 教育类应用
+- 工具类应用
+
+## 参考资源
+
+- **官方文档**: https://docs.cocos.com/cocos2d-x/v4/manual/zh/
+- **GitHub**: https://github.com/cocos2d/cocos2d-x
+- **社区论坛**: https://forum.cocos.org/