RenderTextureSave类 参考

#include <RenderTextureTest.h>

类 RenderTextureSave 继承关系图:

RenderTextureSave 的协作图:

Public 成员函数
	CREATE_FUNC (RenderTextureSave)
	RenderTextureSave ()
	~RenderTextureSave ()
virtual std::string	title () const override
virtual std::string	subtitle () const override
void	onTouchesMoved (const std::vector< cocos2d::Touch * > &touches, cocos2d::Event *event)
void	clearImage (cocos2d::Ref *pSender)
void	clearImageTransparent (cocos2d::Ref *sender)
void	saveImageWithPremultipliedAlpha (cocos2d::Ref *pSender)
void	saveImageWithNonPremultipliedAlpha (cocos2d::Ref *pSender)
void	addImage (cocos2d::Ref *sender)
Public 成员函数 继承自 TestCase
	TestCase ()
	~TestCase ()
virtual Type	getTestType () const
virtual float	getDuration () const
virtual std::string	getExpectedOutput () const
virtual std::string	getActualOutput () const
virtual void	restartTestCallback (cocos2d::Ref *sender)
virtual void	nextTestCallback (cocos2d::Ref *sender)
virtual void	priorTestCallback (cocos2d::Ref *sender)
virtual void	onBackCallback (cocos2d::Ref *sender)
void	setTestSuite (TestSuite *testSuite)
TestSuite *	getTestSuite () const
float	getRunTime () const
void	setTestCaseName (const std::string &name)
std::string	getTestCaseName () const
const cocos2d::Label *	getSubtitleLable () const
const cocos2d::MenuItemImage *	getRestartTestItem () const
virtual void	onEnter () override

Private 属性
cocos2d::RenderTexture *	_target
cocos2d::Vector< cocos2d::Sprite * >	_brushs

额外继承的成员函数
Public 类型 继承自 TestCase
enum class	Type { ROBUSTNESS , UNIT , GRAPHICAL_STATIC , MANUAL }
Public 属性 继承自 TestCase
CC_CONSTRUCTOR_ACCESS	__pad0__: virtual bool init() override
Protected 属性 继承自 TestCase
cocos2d::MenuItemImage *	_priorTestItem
cocos2d::MenuItemImage *	_restartTestItem
cocos2d::MenuItemImage *	_nextTestItem
cocos2d::Label *	_titleLabel
cocos2d::Label *	_subtitleLabel

详细描述

在文件 RenderTextureTest.h 第 37 行定义.

构造及析构函数说明

RenderTextureSave()

RenderTextureSave::RenderTextureSave

(

)

Implementation of RenderTextureSave

在文件 RenderTextureTest.cpp 第 46 行定义.

{
    auto s = Director::getInstance()->getWinSize();
 
    // create a render texture, this is what we are going to draw into
    _target = RenderTexture::create(s.width, s.height, backend::PixelFormat::RGBA8888);
    _target->retain();
    _target->setPosition(Vec2(s.width / 2, s.height / 2));
 
    // note that the render texture is a Node, and contains a sprite of its texture for convenience,
    // so we can just parent it to the scene like any other Node
    this->addChild(_target, -1);
 
    auto listener = EventListenerTouchAllAtOnce::create();
    listener->onTouchesMoved = CC_CALLBACK_2(RenderTextureSave::onTouchesMoved, this);
    _eventDispatcher->addEventListenerWithSceneGraphPriority(listener, this);
    
    // Save Image menu
    MenuItemFont::setFontSize(16);
    auto item1 = MenuItemFont::create("Save Image PMA", CC_CALLBACK_1(RenderTextureSave::saveImageWithPremultipliedAlpha, this));
    auto item2 = MenuItemFont::create("Save Image Non-PMA", CC_CALLBACK_1(RenderTextureSave::saveImageWithNonPremultipliedAlpha, this));
    auto item3 = MenuItemFont::create("Add Image", CC_CALLBACK_1(RenderTextureSave::addImage, this));
    auto item4 = MenuItemFont::create("Clear to Random", CC_CALLBACK_1(RenderTextureSave::clearImage, this));
    auto item5 = MenuItemFont::create("Clear to Transparent", CC_CALLBACK_1(RenderTextureSave::clearImageTransparent, this));
    auto menu = Menu::create(item1, item2, item3, item4, item5, nullptr);
    this->addChild(menu);
    menu->alignItemsVertically();
    menu->setPosition(Vec2(VisibleRect::rightTop().x - 80, VisibleRect::rightTop().y - 100));
}

引用了 _target, addImage(), clearImage(), clearImageTransparent(), onTouchesMoved(), VisibleRect::rightTop(), saveImageWithNonPremultipliedAlpha() , 以及 saveImageWithPremultipliedAlpha().

函数调用图:

~RenderTextureSave()

RenderTextureSave::~RenderTextureSave

(

)

在文件 RenderTextureTest.cpp 第 164 行定义.

{
    _target->release();
    Director::getInstance()->getTextureCache()->removeUnusedTextures();
}

引用了 _target.

成员函数说明

addImage()

void RenderTextureSave::addImage

(

cocos2d::Ref *

sender

)

在文件 RenderTextureTest.cpp 第 149 行定义.

{
    auto s = Director::getInstance()->getWinSize();
 
    // begin drawing to the render texture
    _target->begin();
 
    Sprite* sprite = Sprite::create("Images/test-rgba1.png");
    sprite->setPosition(sprite->getContentSize().width + CCRANDOM_0_1() * (s.width - sprite->getContentSize().width), sprite->getContentSize().height + CCRANDOM_0_1() * (s.height - sprite->getContentSize().height));
    sprite->visit();
 
    // finish drawing and return context back to the screen
    _target->end();
}

引用了 _target.

被这些函数引用 RenderTextureSave().

这是这个函数的调用关系图:

clearImage()

void RenderTextureSave::clearImage

(

cocos2d::Ref *

pSender

)

在文件 RenderTextureTest.cpp 第 86 行定义.

{
    _target->clear(CCRANDOM_0_1(), CCRANDOM_0_1(), CCRANDOM_0_1(), CCRANDOM_0_1());
}

引用了 _target.

被这些函数引用 RenderTextureSave().

这是这个函数的调用关系图:

clearImageTransparent()

void RenderTextureSave::clearImageTransparent

(

cocos2d::Ref *

sender

)

在文件 RenderTextureTest.cpp 第 91 行定义.

{
    _target->clear(0, 0, 0, 0);
}

引用了 _target.

被这些函数引用 RenderTextureSave().

这是这个函数的调用关系图:

CREATE_FUNC()

RenderTextureSave::CREATE_FUNC

(

RenderTextureSave

)

onTouchesMoved()

void RenderTextureSave::onTouchesMoved	(	const std::vector< cocos2d::Touch * > &	touches,
		cocos2d::Event *	event
	)

在文件 RenderTextureTest.cpp 第 170 行定义.

{
     auto touch = touches[0];
     auto start = touch->getLocation();
     auto end = touch->getPreviousLocation();
 
     // begin drawing to the render texture
     _target->begin();
 
     // for extra points, we'll draw this smoothly from the last position and vary the sprite's
     // scale/rotation/offset
     float distance = start.getDistance(end);
     if (distance > 1)
     {
         int d = (int)distance;
         _brushs.clear();
         for(int i = 0; i < d; ++i)
         {
             Sprite * sprite = Sprite::create("Images/fire.png");
             sprite->setColor(Color3B::RED);
             sprite->setOpacity(20);
             _brushs.pushBack(sprite);
         }
         for (int i = 0; i < d; i++)
         {
             float difx = end.x - start.x;
             float dify = end.y - start.y;
             float delta = (float)i / distance;
             _brushs.at(i)->setPosition(Vec2(start.x + (difx * delta), start.y + (dify * delta)));
             _brushs.at(i)->setRotation(rand() % 360);
             float r = (float)(rand() % 50 / 50.f) + 0.25f;
             _brushs.at(i)->setScale(r);
             /*_brush->setColor(Color3B(CCRANDOM_0_1() * 127 + 128, 255, 255));*/
             // Use CCRANDOM_0_1() will cause error when loading libtests.so on android, I don't know why.
             _brushs.at(i)->setColor(Color3B(rand() % 127 + 128, 255, 255));
             // Call visit to draw the brush, don't call draw..
             _brushs.at(i)->visit();
         }
     }
 
     // finish drawing and return context back to the screen
     _target->end();
}

引用了 _brushs , 以及 _target.

被这些函数引用 RenderTextureSave().

这是这个函数的调用关系图:

saveImageWithNonPremultipliedAlpha()

void RenderTextureSave::saveImageWithNonPremultipliedAlpha

(

cocos2d::Ref *

pSender

)

在文件 RenderTextureTest.cpp 第 122 行定义.

{
    static int counter = 0;
 
    char png[20];
    sprintf(png, "image-no-pma-%d.png", counter);
    
    auto callback = [&](RenderTexture* rt, const std::string& path)
    {
        auto sprite = Sprite::create(path);
        addChild(sprite);
        sprite->setScale(0.3f);
        sprite->setPosition(Vec2(40.0f, 40.0f));
        sprite->setRotation(counter * 3);
        rt->release();
    };
    
    _target->retain();
    _target->saveToFileAsNonPMA(png, Image::Format::PNG, true, callback);
                                                                 
    //Add this function to avoid crash if we switch to a new scene.
    Director::getInstance()->getRenderer()->render();
    CCLOG("Image saved %s", png);
 
    counter++;
}

引用了 _target.

被这些函数引用 RenderTextureSave().

这是这个函数的调用关系图:

saveImageWithPremultipliedAlpha()

void RenderTextureSave::saveImageWithPremultipliedAlpha

(

cocos2d::Ref *

pSender

)

在文件 RenderTextureTest.cpp 第 96 行定义.

{
    static int counter = 0;
 
    char png[20];
    sprintf(png, "image-pma-%d.png", counter);
 
    auto callback = [&](RenderTexture* rt, const std::string& path)
    {
        auto sprite = Sprite::create(path);
        addChild(sprite);
        sprite->setScale(0.3f);
        sprite->setPosition(Vec2(40.0f, 40.0f));
        sprite->setRotation(counter * 3);
        _target->release();
    };
 
    _target->retain();
    _target->saveToFile(png, Image::Format::PNG, true, callback);
    //Add this function to avoid crash if we switch to a new scene.
    Director::getInstance()->getRenderer()->render();
    CCLOG("Image saved %s", png);
 
    counter++;
}

引用了 _target.

被这些函数引用 RenderTextureSave().

这是这个函数的调用关系图:

subtitle()

std::string RenderTextureSave::subtitle ( ) const

overridevirtual

重载 TestCase .

在文件 RenderTextureTest.cpp 第 81 行定义.

{
    return "Press 'Save Image' to create an snapshot of the render texture";
}

title()

std::string RenderTextureSave::title ( ) const

overridevirtual

重载 TestCase .

在文件 RenderTextureTest.cpp 第 76 行定义.

{
    return "Touch the screen";
}

类成员变量说明

_brushs

cocos2d::Vector<cocos2d::Sprite*> RenderTextureSave::_brushs

private

在文件 RenderTextureTest.h 第 54 行定义.

被这些函数引用 onTouchesMoved().

_target

cocos2d::RenderTexture* RenderTextureSave::_target

private

在文件 RenderTextureTest.h 第 53 行定义.

被这些函数引用 addImage(), clearImage(), clearImageTransparent(), onTouchesMoved(), RenderTextureSave(), saveImageWithNonPremultipliedAlpha(), saveImageWithPremultipliedAlpha() , 以及 ~RenderTextureSave().

---

该类的文档由以下文件生成:

• /Users/yujizhu/Documents/Git/cocos2d-x-4.0/tests/cpp-tests/Classes/RenderTextureTest/RenderTextureTest.h
• /Users/yujizhu/Documents/Git/cocos2d-x-4.0/tests/cpp-tests/Classes/RenderTextureTest/RenderTextureTest.cpp