cocos2d-x多分辨率和随后的自适应CCListView的bug修复

cocos2d-x是一款众所周知的跨平台的游戏开发引擎。因为其跨平台的特性。多分辨率支持也自然就有其需求。

因此。在某一次更新中(抱歉,笔者已经忘了是哪次更新了),cocos2d-x加入了一个新的方法。能够很简便地让cocos2d依据屏幕尺寸的大小做自适配。

方法名:

    virtual void setDesignResolutionSize(float width, float height, ResolutionPolicy resolutionPolicy);

该方法所传的參数中,前两个參数width、height,指的是开发人员在设计界面时默认设计的尺寸。比如:开发人员在设计界面时以iphone5为准,则width和height就是568*320;若是以iphone4为准。则width和height就是480*320;以此类推。

第三个參数resolutionPolicy指的是cocos2d在缩放时须要遵守的规则。ResolutionPolicy这个自己定义结构例如以下:

cocos2d-x多分辨率和随后的自适应CCListView的bug修复
enum ResolutionPolicy
{
// The entire application is visible in the specified area without trying to preserve the original aspect ratio.
// Distortion can occur, and the application may appear stretched or compressed.
kResolutionExactFit,
// The entire application fills the specified area, without distortion but possibly with some cropping,
// while maintaining the original aspect ratio of the application.
kResolutionNoBorder,
// The entire application is visible in the specified area without distortion while maintaining the original
// aspect ratio of the application. Borders can appear on two sides of the application.
kResolutionShowAll, kResolutionUnKnown,
};
cocos2d-x多分辨率和随后的自适应CCListView的bug修复

通过凝视能够看出:

kResolutionExactFit是指cocos2d缩放的时候不考虑画面失真,直接用画面填充满整个屏幕

kResolutionNoBorder是指cocos2d缩放的时候尽量顶满画面,假设因此有超出画面的部分,就会把超出的部分切除掉(举例来说:假设设计大小是568*320,在480*320大小的屏幕上自适配的时候,就会把宽度超出的部分切除)

kResolutionShowAll是指cocos2d缩放的时候显示全部的画面,假设有填不满屏幕的地方就会显示黑条。

这三种规则各有优缺点,详细使用哪种规则须要考量项目的须要进行合理的选择。

然而。须要特别注意的一点是:setDesignResolutionSize和enableRetina这两个方法是不能够同一时候使用的。

这即意味着使用自适配的时候是不能够做高清版的。

假设查看cocos2d-x源码。能够看到在setDesignResolutionSize方法中有一句代码:

    CCAssert(m_bIsRetinaEnabled == false, "can not enable retina while set design resolution size!");

在下觉得这是由于高清模式下图片资源都是进行了缩小的,全部的坐标都是定义的point,而不是pixel。因此高清模式和自适配可能有某些冲突存在。

(以上仅仅是笔者的推測,不靠谱勿怪)

总之,假设想要使用自适配。就必须在项目一開始就放弃高清。假设要做高清版,眼下看来就仅仅能自己依据屏幕尺寸的比例变化设置setContentScaleFactor,这一部分的设置方法这里就不展开了。

另外,笔者在刚開始使用自适配功能时,误以为开发时要把UI元素的位置坐标和大小都写成相对于屏幕大小的一定比例。比如:

    CCSprite* avatarSprite = CCSprite::create("avatar.png");
avatarSprite->setPosition(ccp(winSize.width * 0.000878, winSize.height * 0.653125));
addChild(avatarSprite);

但实际上这是没有必要的。

自适配功能是直接调整整个CCDirector的画布大小,因此不论什么加入到CCDirector中的元素都会被缩放对应的比例。没有必要再特意将坐标写成相对屏幕比例的模式。

以下笔者将分享一下在使用自适配功能的时候遇到的一个问题,即CCListView在多分辨率模式下可能出现的被过多地切除一部分内容的问题。

首先先介绍下笔者发现问题时的背景:当时笔者是在实现一款跨平台的游戏的当中一个界面,该游戏的画面是依照iphone5的低清版设计。DesignResolutionSize设置的是568*320。在安装到iphone5上时一切正常。可是随后,在安装到iphone4机器上进行调试时,发现画面上全部的CCListView都被切除了左边的一部分内容。

因为在iphone5上一切正常。在iphone4上画面被切除了一部分。因此笔者马上怀疑是CCListView与setDesignResolutionSize之间有某些冲突。

通过debug和log。最后将问题锁定到了CCListView类的visit方法。

方法的源码例如以下:

cocos2d-x多分辨率和随后的自适应CCListView的bug修复
void CCListView::visit(void)
{
if (!m_pListViewParent)
{
CCRect rectSelf;
float factor = CC_CONTENT_SCALE_FACTOR();
rectSelf.origin = convertToWorldSpace(CCPoint(0,0));
rectSelf.origin.x *= factor;
rectSelf.origin.y *= factor;
rectSelf.size = this->getContentSize();
rectSelf.size.width *= factor;
rectSelf.size.height *= factor;
glScissor((GLsizei)rectSelf.origin.x, (GLsizei)rectSelf.origin.y, (GLsizei)rectSelf.size.width , (GLsizei)rectSelf.size.height);
glEnable(GL_SCISSOR_TEST);
}
CCLayerColor::visit();
if (!m_pListViewParent)
{
glDisable(GL_SCISSOR_TEST);
}
}
cocos2d-x多分辨率和随后的自适应CCListView的bug修复

这段代码中调用了一个方法:glScissor。这种方法是框定了CCListView将会显示在屏幕上的范围。

而因为在使用自适配模式。对CC_CONTENT_SCALE_FACTOR没有做不论什么改动,因此这个框出来的范围是相应于DesignResolutionSize设定的原始设计画面大小的。而在屏幕尺寸发生了变化。整个CCDirector被缩放的情况下。这个rectSelf却没有做不论什么改变,所以就导致了上述的被切除一部分的问题。

随后,笔者通过搜索。发现已经有人遇到了同一个问题。并且还提供了修复的方法:http://www.cocos2d-x.org/boards/18/topics/14464

简单讲就是,用CCEGLView::sharedOpenGLView()->setScissorInPoints方法替换glScissor方法。其他不论什么地方都不用变。

改动好以后在iphone4和5上调试都没问题,因此这个bug本身能够算是修复了。

PS:因为对这种方法可以奏效感到好奇,笔者查看了setScissorInPoints方法的源文件。代码例如以下:

cocos2d-x多分辨率和随后的自适应CCListView的bug修复
void CCEGLViewProtocol::setScissorInPoints(float x , float y , float w , float h)
{
glScissor((GLint)(x * m_fScaleX + m_obViewPortRect.origin.x),
(GLint)(y * m_fScaleY + m_obViewPortRect.origin.y),
(GLsizei)(w * m_fScaleX),
(GLsizei)(h * m_fScaleY));
}
cocos2d-x多分辨率和随后的自适应CCListView的bug修复

能够看出这种方法内部仍然是调用了glScissor方法,可是传递的參数则考考虑到在屏幕尺寸的变化,因此,为了确保这种方法不切割过多CCListView内容。

其他,在project搜索glScissor发现CCScrollView这个方法也被称为,假定的使用CCScrollView建议同时更换的源代码glScissor方法。

上一篇:Saiku Table展示数据合并bug修复(二十五)


下一篇:maven 构建web项目index.jsp报错