quick-cocos2d-x（8）
quick 中的 create_project 工具在创建项目时，可以用 -o 参数指定屏幕方向。但如果要修改已有项目的屏幕方向，就要按如下步骤进行。
对于 iOS 项目
设置工程可用的屏幕方向：
找到 RootViewController.mm 文件，做如下修改：
如果需要横屏：
- (BOOL)shouldAutorotateToInterfaceOrientation:(UIInterfaceOrientation)interfaceOrientation
return UIInterfaceOrientationIsLandscape(interfaceOrientation);
- (NSUInteger) supportedInterfaceOrientations
#ifdef __IPHONE_6_0
return UIInterfaceOrientationMaskL
如果需要竖屏：
- (BOOL)shouldAutorotateToInterfaceOrientation:(UIInterfaceOrientation)interfaceOrientation
return UIInterfaceOrientationIsPortrait(interfaceOrientation);
- (NSUInteger) supportedInterfaceOrientations
#ifdef __IPHONE_6_0
return UIInterfaceOrientationMaskP
按照 Apple 文档要求，制作不同屏幕方向需要的启动画面文件 （Default.png）。文档地址：
对于 Android 项目
修改 AndroidManifest.xml 文件中的 android:screenOrientation 属性：
landscape 横屏portrait 竖屏
修改 config.lua 配置
如果需要横屏：
CONFIG_SCREEN_WIDTH
CONFIG_SCREEN_HEIGHT = 640
CONFIG_SCREEN_ORIENTATION = &landscape&
CONFIG_SCREEN_AUTOSCALE = &FIXED_HEIGHT&
如果需要竖屏：
CONFIG_SCREEN_WIDTH
CONFIG_SCREEN_HEIGHT = 960
CONFIG_SCREEN_ORIENTATION = &portrait&
CONFIG_SCREEN_AUTOSCALE = &FIXED_WIDTH&
参考知识库
* 以上用户言论只代表其个人观点，不代表CSDN网站的观点或立场
访问：54121次
积分：1141
积分：1141
排名：千里之外
原创：42篇
转载：112篇
(16)(4)(17)(8)(3)(3)(1)(7)(5)(17)(4)(17)(6)(17)(20)(10)主题 : 游戏截屏分享到朋友圈的问题
级别: 新手上路
可可豆: 88 CB
威望: 78 点
在线时间: 30(时)
发自: Web Page
来源于&&分类
游戏截屏分享到朋友圈的问题&&&
用官方提供的例子我已经加到我的游戏里已经搞定了，但有个问题是官方提供分享图片，分到朋友圈显示的是 分享一个链接&&然后是&&一个特别小的缩略图旁边跟着一个文字，点击之后就到浏览器了。而我希望的是 分享纯图片，点击查看大图的样子。我试着把UmengShareSDK 里 shareImg 函数 的&&getInstance().mController.setShareContent(text);这句话注释掉。然后使用游戏截图，也就是本地图片分享到朋友圈，回调显示成功，但朋友圈里没有。用官方提供的例子的网络图片，分享到朋友圈，可以成功，但图片是灰色的。我的问题是，做一个简单的游戏截图分享，在朋友圈里展示就是一个缩略图，点击查看大图。 应该怎么做。。。谢谢大家
UID: 42534
发帖: 52897
可可豆: 524806 CB
威望: 524071 点
在线时间: 1012(时)
发自: Web Page
这个需要看 UmengShareSDK 的分享图片的接口是怎么调用的。
级别: 新手上路
可可豆: 88 CB
威望: 78 点
在线时间: 30(时)
发自: Web Page
回 1楼(yangtao19cs) 的帖子
&& 接口函数 public static void shareImg(final String text, final String img) {&&&&&&&&mContext.runOnUiThread(new Runnable() {&&&&&&&&&&&&@Override&&&&&&&&&&&&public void run() {//&&&&&&&&&&&&&&&&getInstance().mController.setShareContent(text);&&&&&&&&&&&&&&&&UMImage image =&&&&&&&&&&&&&&&&try {&&&&&&&&&&&&&&&&&&&&if (img.startsWith(&http&)) {&&&&&&&&&&&&&&&&&&&&&&&&image = new UMImage(mContext, img);&&&&&&&&&&&&&&&&&&&&} else {&&&&&&&&&&&&&&&&&&&&&&&&image = new UMImage(mContext, BitmapFactory.decodeFile(img));//&&&&&&&&&&&&&&&&&&&&&&&&image = new UMImage(mContext, new File(img));//&&&&&&&&&&&&&&&&&&&&&&&&image = new UMImage(mContext, BitmapFactory.decodeStream(mContext.getAssets().open(img)));&&&&&&&&&&&&&&&&&&&&}&&&&&&&&&&&&&&&&} catch (Exception e) {&&&&&&&&&&&&&&&&&&&&image =&&&&&&&&&&&&&&&&}&&&&&&&&&&&&&&&&if (null != image) {&&&&&&&&&&&&&&&&&&&&getInstance().mController.setShareMedia(new UMImage(mContext, img));&&&&&&&&&&&&&&&&}&&&&&&&&&&&&&& &&&&&&&&&&&&&&&&getInstance().mController.openShare(mContext, false);&&&&&&&&&&&&}&&&&&&&&});&&&&}
级别: 新手上路
可可豆: 88 CB
威望: 78 点
在线时间: 30(时)
发自: Web Page
用网络图片是可以成功的， 之前说分享成功，图片不显示，是因为友盟的这个图片，打不开了。。。
级别: 圣骑士
UID: 313161
可可豆: 592 CB
威望: 584 点
在线时间: 286(时)
发自: Web Page
微信的分享里如果传了文字，就会认为是一个链接的形式，所以要实现在楼主要求的，点图片看大图，需要不分享文字现在官方提供的接口，是必须要传文字的楼主可以用以下方式实现自己的需求1.&&在UmengShareSDK中的shareImg(final String text, final String img)函数加入如下代码if (null != image) {&&&&//新加，这两行就是专门为微信朋友圈设置分享内容，这里没有传text&&&&CircleShareContent circleContent = new CircleShareContent(img);&&&&getInstance().mController.setShareMedia(circleContent);&&&&getInstance().mController.setShareMedia(new UMImage(mContext, img));}2.我提交了只分享图片的接口path，正在等待合并，楼主也可看修改地方，改为自己需要的
级别: 新手上路
可可豆: 88 CB
威望: 78 点
在线时间: 30(时)
发自: Web Page
回 4楼(htlxyz) 的帖子
&&&&CircleShareContent circleContent = new CircleShareContent(img);&&&&getInstance().mController.setShareMedia(circleContent);有问题，这样朋友圈直接把图片的本地地址显示出来了
级别: 新手上路
可可豆: 88 CB
威望: 78 点
在线时间: 30(时)
发自: Web Page
回 4楼(htlxyz) 的帖子
我搞定了，总算分享成功了！！本地图片的话，需要这样写getInstance().mController.setShareMedia(new UMImage(mContext,&&BitmapFactory.decodeFile(img)));
级别: 新手上路
可可豆: 56 CB
威望: 26 点
在线时间: 27(时)
发自: Web Page
看看，学习下。感谢分享
关注本帖(如果有新回复会站内信通知您)
苹果公司现任CEO是谁？2字 正确答案:库克
发帖、回帖都会得到可观的积分奖励。
按"Ctrl+Enter"直接提交
关注CocoaChina
关注微信 每日推荐
扫一扫 浏览移动版quick-Cocos2d/framework/display.lua(这个组件提供的功能是很重要的，包括场景、层、精灵、动画这些游戏中必要的组件)
quick-Cocos2d/framework/display.lua(这个组件提供的功能是很重要的，包括场景、层、精灵、动画这些游戏中必要的组件)
[摘要：取表现图象、场景有闭的功效 br / display 模块启拆了尽大局部取表现有闭的功效，并担任依据 config.lua 中界说的区分率设定盘算屏幕的计划区分率。 br / 框架初初化后，display 模块供应下]
与显示图像、场景有关的功能
display 模块封装了绝大部分与显示有关的功能，并负责根据 config.lua 中定义的分辨率设定计算屏幕的设计分辨率。
框架初始化后，display 模块提供下列属性：
- & display.sizeInPixels.width,
- & display.sizeInPixels.height 屏幕的像素分辨率
- & display.widthInPixels,
- & display.heightInPixels 屏幕的像素分辨率
- & display.contentScaleFactor 内容缩放因子
- & display.size.width,
- & display.size.height 屏幕的设计分辨率
- & display.width,
- & display.height 屏幕的设计分辨率
- & display.cx,
- & display.cy 屏幕中央的 x 坐标和 y 坐标
- & display.left,
- & display.top,
- & display.right,
- & display.bottom 屏幕四边的坐标
- & display.c_left,
- & display.c_top,
- & display.c_right,
- & display.c_bottom 当父对象在屏幕中央时，屏幕四边的坐标
- & display.COLOR_WHITE 白色, ccc3(255, 255, 255)
- & display.COLOR_BLACK 黑色, ccc3(0, 0, 0)
local display = {}
local sharedDirector & & & & = CCDirector:sharedDirector()
local sharedTextureCache & & = CCTextureCache:sharedTextureCache()
local sharedSpriteFrameCache = CCSpriteFrameCache:sharedSpriteFrameCache()
local sharedAnimationCache & = CCAnimationCache:sharedAnimationCache()
-- check device screen size
local glview = sharedDirector:getOpenGLView()
local size = glview:getFrameSize()
display.sizeInPixels = {width = size.width, height = size.height}
local w = display.sizeInPixels.width
local h = display.sizeInPixels.height
if CONFIG_SCREEN_WIDTH == nil or CONFIG_SCREEN_HEIGHT == nil then
& & CONFIG_SCREEN_WIDTH = w
& & CONFIG_SCREEN_HEIGHT = h
if not CONFIG_SCREEN_AUTOSCALE then
& & if w & h then
& & & & CONFIG_SCREEN_AUTOSCALE = &FIXED_HEIGHT&
& & & & CONFIG_SCREEN_AUTOSCALE = &FIXED_WIDTH&
& & CONFIG_SCREEN_AUTOSCALE = string.upper(CONFIG_SCREEN_AUTOSCALE)
local scale, scaleX, scaleY
if CONFIG_SCREEN_AUTOSCALE then
& & if type(CONFIG_SCREEN_AUTOSCALE_CALLBACK) == &function& then
& & & & scaleX, scaleY = CONFIG_SCREEN_AUTOSCALE_CALLBACK(w, h, device.model)
& & if not scaleX or not scaleY then
& & & & scaleX, scaleY = w / CONFIG_SCREEN_WIDTH, h / CONFIG_SCREEN_HEIGHT
& & if CONFIG_SCREEN_AUTOSCALE == &FIXED_WIDTH& then
& & & & scale = scaleX
& & & & CONFIG_SCREEN_HEIGHT = h / scale
& & elseif CONFIG_SCREEN_AUTOSCALE == &FIXED_HEIGHT& then
& & & & scale = scaleY
& & & & CONFIG_SCREEN_WIDTH = w / scale
& & & & scale = 1.0
& & & & printError(string.format(&display - invalid CONFIG_SCREEN_AUTOSCALE &%s&&, CONFIG_SCREEN_AUTOSCALE))
& & glview:setDesignResolutionSize(CONFIG_SCREEN_WIDTH, CONFIG_SCREEN_HEIGHT, kResolutionNoBorder)
local winSize = sharedDirector:getWinSize()
display.contentScaleFactor = scale
display.size & & & & & & & = {width = winSize.width, height = winSize.height}
display.width & & & & & & &= display.size.width
display.height & & & & & & = display.size.height
display.cx & & & & & & & & = display.width / 2
display.cy & & & & & & & & = display.height / 2
display.c_left & & & & & & = -display.width / 2
display.c_right & & & & & &= display.width / 2
display.c_top & & & & & & &= display.height / 2
display.c_bottom & & & & & = -display.height / 2
display.left & & & & & & & = 0
display.right & & & & & & &= display.width
display.top & & & & & & & &= display.height
display.bottom & & & & & & = 0
display.widthInPixels & & &= display.sizeInPixels.width
display.heightInPixels & & = display.sizeInPixels.height
printInfo(string.format(&# CONFIG_SCREEN_AUTOSCALE & & &= %s&, CONFIG_SCREEN_AUTOSCALE))
printInfo(string.format(&# CONFIG_SCREEN_WIDTH & & & & &= %0.2f&, CONFIG_SCREEN_WIDTH))
printInfo(string.format(&# CONFIG_SCREEN_HEIGHT & & & & = %0.2f&, CONFIG_SCREEN_HEIGHT))
printInfo(string.format(&# display.widthInPixels & & & &= %0.2f&, display.widthInPixels))
printInfo(string.format(&# display.heightInPixels & & & = %0.2f&, display.heightInPixels))
printInfo(string.format(&# display.contentScaleFactor & = %0.2f&, display.contentScaleFactor))
printInfo(string.format(&# display.width & & & & & & & &= %0.2f&, display.width))
printInfo(string.format(&# display.height & & & & & & & = %0.2f&, display.height))
printInfo(string.format(&# display.cx & & & & & & & & & = %0.2f&, display.cx))
printInfo(string.format(&# display.cy & & & & & & & & & = %0.2f&, display.cy))
printInfo(string.format(&# display.left & & & & & & & & = %0.2f&, display.left))
printInfo(string.format(&# display.right & & & & & & & &= %0.2f&, display.right))
printInfo(string.format(&# display.top & & & & & & & & &= %0.2f&, display.top))
printInfo(string.format(&# display.bottom & & & & & & & = %0.2f&, display.bottom))
printInfo(string.format(&# display.c_left & & & & & & & = %0.2f&, display.c_left))
printInfo(string.format(&# display.c_right & & & & & & &= %0.2f&, display.c_right))
printInfo(string.format(&# display.c_top & & & & & & & &= %0.2f&, display.c_top))
printInfo(string.format(&# display.c_bottom & & & & & & = %0.2f&, display.c_bottom))
printInfo(&#&)
display.COLOR_WHITE = ccc3(255, 255, 255)
display.COLOR_BLACK = ccc3(0, 0, 0)
display.COLOR_RED & = ccc3(255, 0, 0)
display.COLOR_GREEN = ccc3(0, 255, 0)
display.COLOR_BLUE &= ccc3(0, 0, 255)
display.AUTO_SIZE & & &= 0
display.FIXED_SIZE & & = 1
display.LEFT_TO_RIGHT &= 0
display.RIGHT_TO_LEFT &= 1
display.TOP_TO_BOTTOM &= 2
display.BOTTOM_TO_TOP &= 3
display.CENTER & & & &= 1
display.LEFT_TOP & & &= 2; display.TOP_LEFT & & &= 2
display.CENTER_TOP & &= 3; display.TOP_CENTER & &= 3
display.RIGHT_TOP & & = 4; display.TOP_RIGHT & & = 4
display.CENTER_LEFT & = 5; display.LEFT_CENTER & = 5
display.CENTER_RIGHT &= 6; display.RIGHT_CENTER &= 6
display.BOTTOM_LEFT & = 7; display.LEFT_BOTTOM & = 7
display.BOTTOM_RIGHT &= 8; display.RIGHT_BOTTOM &= 8
display.BOTTOM_CENTER = 9; display.CENTER_BOTTOM = 9
display.ANCHOR_POINTS = {
& & CCPoint(0.5, 0.5), &-- CENTER
& & CCPoint(0, 1), & & &-- TOP_LEFT
& & CCPoint(0.5, 1), & &-- TOP_CENTER
& & CCPoint(1, 1), & & &-- TOP_RIGHT
& & CCPoint(0, 0.5), & &-- CENTER_LEFT
& & CCPoint(1, 0.5), & &-- CENTER_RIGHT
& & CCPoint(0, 0), & & &-- BOTTOM_LEFT
& & CCPoint(1, 0), & & &-- BOTTOM_RIGHT
& & CCPoint(0.5, 0), & &-- BOTTOM_CENTER
display.SCENE_TRANSITIONS = {
& & CROSSFADE & & & = {CCTransitionCrossFade, 2},
& & FADE & & & & & &= {CCTransitionFade, 3, ccc3(0, 0, 0)},
& & FADEBL & & & & &= {CCTransitionFadeBL, 2},
& & FADEDOWN & & & &= {CCTransitionFadeDown, 2},
& & FADETR & & & & &= {CCTransitionFadeTR, 2},
& & FADEUP & & & & &= {CCTransitionFadeUp, 2},
& & FLIPANGULAR & & = {CCTransitionFlipAngular, 3, kCCTransitionOrientationLeftOver},
& & FLIPX & & & & & = {CCTransitionFlipX, 3, kCCTransitionOrientationLeftOver},
& & FLIPY & & & & & = {CCTransitionFlipY, 3, kCCTransitionOrientationUpOver},
& & JUMPZOOM & & & &= {CCTransitionJumpZoom, 2},
& & MOVEINB & & & & = {CCTransitionMoveInB, 2},
& & MOVEINL & & & & = {CCTransitionMoveInL, 2},
& & MOVEINR & & & & = {CCTransitionMoveInR, 2},
& & MOVEINT & & & & = {CCTransitionMoveInT, 2},
& & PAGETURN & & & &= {CCTransitionPageTurn, 3, false},
& & ROTOZOOM & & & &= {CCTransitionRotoZoom, 2},
& & SHRINKGROW & & &= {CCTransitionShrinkGrow, 2},
& & SLIDEINB & & & &= {CCTransitionSlideInB, 2},
& & SLIDEINL & & & &= {CCTransitionSlideInL, 2},
& & SLIDEINR & & & &= {CCTransitionSlideInR, 2},
& & SLIDEINT & & & &= {CCTransitionSlideInT, 2},
& & SPLITCOLS & & & = {CCTransitionSplitCols, 2},
& & SPLITROWS & & & = {CCTransitionSplitRows, 2},
& & TURNOFFTILES & &= {CCTransitionTurnOffTiles, 2},
& & ZOOMFLIPANGULAR = {CCTransitionZoomFlipAngular, 2},
& & ZOOMFLIPX & & & = {CCTransitionZoomFlipX, 3, kCCTransitionOrientationLeftOver},
& & ZOOMFLIPY & & & = {CCTransitionZoomFlipY, 3, kCCTransitionOrientationUpOver},
display.TEXTURES_PIXEL_FORMAT = {}
创建一个新场景，并返回 CCScene 场景对象。
指定场景名称方便调试。
@param string name 场景名称
@return CCScene 场景对象
@see CCScene
function display.newScene(name)
& & local scene = CCScene:create()
& & scene:setNodeEventEnabled(true)
& & scene:setAutoCleanupEnabled()
& & scene.name = name or &&unknown-scene&&
& & return scene
用场景切换过渡效果包装场景对象，并返回场景过渡对象。
-- 创建一个新场景
local nextScene = display.newScene(&NextScene&)
-- 包装过渡效果
local transition = display.wrapSceneWithTransition(nextScene, &fade&, 0.5)
-- 切换到新场景
display.replaceScene(nextScene)
可用的过渡效果有：
- & crossFade 淡出当前场景的同时淡入下一个场景
- & fade 淡出当前场景到指定颜色，默认颜色为 ccc3(0, 0, 0)，可用 wrapSceneWithTransition() 的最后一个参数指定颜色
- & fadeBL 从左下角开始淡出场景
- & fadeDown 从底部开始淡出场景
- & fadeTR 从右上角开始淡出场景
- & fadeUp 从顶部开始淡出场景
- & flipAngular 当前场景倾斜后翻转成下一个场景，默认从左边开始翻转，可以指定为：
& & - & kCCTransitionOrientationLeftOver 从左边开始
& & - & kCCTransitionOrientationRightOver 从右边开始
& & - & kCCTransitionOrientationUpOver 从顶部开始
& & - & kCCTransitionOrientationDownOver 从底部开始
- & flipX 水平翻转，默认从左往右翻转，可用的附加参数同上
- & flipY 垂直翻转，默认从上往下翻转，可用的附加参数同上
- & zoomFlipAngular 倾斜翻转的同时放大，可用的附加参数同上
- & zoomFlipX 水平翻转的同时放大，可用的附加参数同上
- & zoomFlipY 垂直翻转的同时放大，可用的附加参数同上
- & jumpZoom 跳跃放大切换场景
- & moveInB 新场景从底部进入，现有场景同时从顶部退出
- & moveInL 新场景从左侧进入，现有场景同时从右侧退出
- & moveInR 新场景从右侧进入，现有场景同时从左侧退出
- & moveInT 新场景从顶部进入，现有场景同时从底部退出
- & pageTurn 翻页效果，如果指定附加参数为 true，则表示从左侧往右翻页
- & rotoZoom 旋转放大切换场景
- & shrinkGrow 收缩交叉切换场景
- & slideInB 新场景从底部进入，直接覆盖现有场景
- & slideInL 新场景从左侧进入，直接覆盖现有场景
- & slideInR 新场景从右侧进入，直接覆盖现有场景
- & slideInT 新场景从顶部进入，直接覆盖现有场景
- & splitCols 分成多列切换入新场景
- & splitRows 分成多行切换入新场景，类似百叶窗
- & turnOffTiles 当前场景分成多个块，逐渐替换为新场景
@param CCScene scene 场景对象
@param string transitionType 过渡效果名
@param number time 过渡时间
@param string more 过渡效果附加参数
@return CCScene 场景对象
function display.wrapSceneWithTransition(scene, transitionType, time, more)
& & local key = string.upper(tostring(transitionType))
& & if string.sub(key, 1, 12) == &CCTRANSITION& then
& & & & key = string.sub(key, 13)
& & if key == &RANDOM& then
& & & & local keys = table.keys(display.SCENE_TRANSITIONS)
& & & & key = keys[math.random(1, #keys)]
& & if display.SCENE_TRANSITIONS[key] then
& & & & local cls, count, default = unpack(display.SCENE_TRANSITIONS[key])
& & & & time = time or 0.2
& & & & if count == 3 then
& & & & & & scene = cls:create(time, scene, more or default)
& & & & else
& & & & & & scene = cls:create(time, scene)
& & & & end
& & & & printError(&display.wrapSceneWithTransition() - invalid transitionType %s&, tostring(transitionType))
& & return scene
切换到新场景
-- 使用红色做过渡色
display.replaceScene(nextScene, &fade&, 0.5, ccc3(255, 0, 0))
@param CCScene newScene 场景对象
@param string transitionType 过渡效果名
@param number time 过渡时间
@param mixed more 过渡效果附加参数
function display.replaceScene(newScene, transitionType, time, more)
& & if sharedDirector:getRunningScene() then
& & & & if transitionType then
& & & & & & newScene = display.wrapSceneWithTransition(newScene, transitionType, time, more)
& & & & end
& & & & sharedDirector:replaceScene(newScene)
& & & & sharedDirector:runWithScene(newScene)
返回当前正在运行的场景对象
@return CCScene 场景对象
function display.getRunningScene()
& & return sharedDirector:getRunningScene()
暂停当前场景
function display.pause()
& & sharedDirector:pause()
恢复当前暂停的场景
function display.resume()
& & sharedDirector:resume()
创建并返回一个 CCLayer 层对象
CCLayer 对象提供了触摸事件、重力感应、Android 按键检测等功能，具体请参考 CCLayer。
@see CCLayer
function display.newLayer()
& & return CCLayer:create()
创建一个颜色填充层
CCLayerColor 对象使用指定的颜色填充。
@param ccColor3B color
@return CCLayerColor
@see CCLayerColor
function display.newColorLayer(color)
& & return CCLayerColor:create(color)
创建并返回一个 CCNode 对象
CCNode 对象并不能显示对象，但可以作为其他显示对象的容器（起到群组的作用）。具体请参考 CCNode 。
local group = display.newNode() & & -- 创建一个容器
group:addChild(sprite1) & & & & & & -- 添加显示对象到容器中
group:addChild(sprite2) & & & & & & -- 添加显示对象到容器中
-- 移动容器时，其中包含的子对象也会同时移动
transition.moveBy(group, {time = 2.0, x = 100})
@return CCNode CCNode对象
@see CCNode
function display.newNode()
& & return CCNode:create()
创建并返回一个 CCClippingRegionNode 对象。
创建 CCClippingRegionNode 对象时需要指定一个屏幕区域，然后在显示时，所以加入 CCClippingRegionNode 对象的内容都会进行剪裁，超出指定区域的内容不会显示。
-- 剪裁区域从屏幕左下角靠内 100 点，到屏幕右上角
local rect = CCRect(display.left + 100,
& & & & & & & & & & display.bottom + 100,
& & & & & & & & & & display.width - 200,
& & & & & & & & & & display.height - 200)
local clipnode = display.newClippingRegionNode(rect)
clipnode:addChild(sprite1)
clipnode:addChild(sprite2)
scene:addChild(clipnode)
注意：CCClippingRegionNode 的父对象其坐标必须是 0, 0。
@param CCRect rect 指定的区域
@return CCClippingRegionNode CCClippingRegionNode对象
function display.newClippingRegionNode(rect)
& & return CCClippingRegionNode:create(rect)
创建并返回一个 CCSprite 显示对象。
display.newSprite() 有三种方式创建显示对象：
- & 从图片文件创建
- & 从缓存的图像帧创建
- & 从 CCSpriteFrame 对象创建
-- 从图片文件创建显示对象
local sprite1 = display.newSprite(&hello1.png&)
-- 从缓存的图像帧创建显示对象
-- 图像帧的名字就是图片文件名，但为了和图片文件名区分，所以此处需要在文件名前添加 “#” 字符
-- 添加 “#” 的规则适用于所有需要区分图像和图像帧的地方
local sprite2 = display.newSprite(&#frame0001.png&)
-- 从 CCSpriteFrame 对象创建
local frame = display.newFrame(&frame0002.png&)
local sprite3 = display.newSprite(frame)
如果指定了 x,y 参数，那么创建显示对象后会调用对象的 setPosition() 方法设置对象位置。
@param mixed 图像名或CCSpriteFrame对象
@param number x
@param number y
@param table params
@return CCSprite
@see CCSprite
function display.newSprite(filename, x, y, params)
& & local spriteClass = nil
& & local size = nil
& & if params then
& & & & spriteClass = params.class
& & & & size = params.size
& & if not spriteClass then spriteClass = CCSprite end
& & local t = type(filename)
& & if t == &userdata& then t = tolua.type(filename) end
& & local sprite
& & if not filename then
& & & & sprite = spriteClass:create()
& & elseif t == &string& then
& & & & if string.byte(filename) == 35 then -- first char is #
& & & & & & local frame = display.newSpriteFrame(string.sub(filename, 2))
& & & & & & if frame then
& & & & & & & & sprite = spriteClass:createWithSpriteFrame(frame)
& & & & & & end
& & & & else
& & & & & & if display.TEXTURES_PIXEL_FORMAT[filename] then
& & & & & & & & CCTexture2D:setDefaultAlphaPixelFormat(display.TEXTURES_PIXEL_FORMAT[filename])
& & & & & & & & sprite = spriteClass:create(filename)
& & & & & & & & CCTexture2D:setDefaultAlphaPixelFormat(kCCTexture2DPixelFormat_RGBA8888)
& & & & & & else
& & & & & & & & sprite = spriteClass:create(filename)
& & & & & & end
& & & & end
& & elseif t == &CCSpriteFrame& then
& & & & sprite = spriteClass:createWithSpriteFrame(filename)
elseif t == &CCTexture2D& then
sprite = spriteClass:createWithTexture(filename)
& & & & printError(&display.newSprite() - invalid filename value type&)
& & & & sprite = spriteClass:create()
& & if sprite then
& & & & if x and y then sprite:setPosition(x, y) end
& & & & if size then sprite:setContentSize(size) end
& & & & printError(&display.newSprite() - create sprite failure, filename %s&, tostring(filename))
& & & & sprite = spriteClass:create()
& & return sprite
创建并返回一个 CCSprite9Scale 显示对象。
格式：
sprite = display.newScale9Sprite(图像名, [x, y], [CCSize 对象])
CCSprite9Scale 就是通常所說的“九宫格”图像。一个矩形图像会被分为 9 部分，然后根据要求拉伸图像，同时保证拉伸后的图像四边不变形。
-- 创建一个 Scale9 图像，并拉伸到 400, 300 点大小
local sprite = display.newScale9Sprite(&Box.png&, 0, 0, CCSize(400, 300))
@param string filename 图像名
@param integer x
@param integer y
@param CCSize size
@return CCSprite9Scale CCSprite9Scale显示对象
function display.newScale9Sprite(filename, x, y, size)
return display.newSprite(filename, x, y, {class = CCScale9Sprite, size = size})
function display.newTilesSprite(filename, rect)
& & if not rect then
& & & & rect = CCRect(0, 0, display.width, display.height)
& & local sprite = CCSprite:create(filename, rect)
& & if not sprite then
& & & & printError(&display.newTilesSprite() - create sprite failure, filename %s&, tostring(filename))
& & & & return
& & local tp = ccTexParams()
& & tp.minFilter = 9729
& & tp.magFilter = 9729
& & tp.wrapS = 10497
& & tp.wrapT = 10497
& & sprite:getTexture():setTexParameters(tp)
& & display.align(sprite, display.LEFT_BOTTOM, 0, 0)
& & return sprite
create a tiled CCSpriteBatchNode, the image can not a POT file.
@param mixed filename As same a the first parameter for display.newSprite
@param string plistFile Texture(plist) image filename, filename must be a part of the texture.
@param CCSize size The tiled node size, use cc.size create it please.
@param integer hPadding Horizontal padding, it will display 1 px gap on moving the node, set padding for fix it.
@param integer vPadding Vertical padding.
@return A CCSpriteBatchNode
function display.newTiledBatchNode(filename, plistFile, size, hPadding, vPadding)
size = size or cc.size(display.width, display.height)
hPadding = hPadding or 0
vPadding = vPadding or 0
local __sprite = display.newSprite(filename)
local __sliceSize = __sprite:getContentSize()
__sliceSize.width = __sliceSize.width - hPadding
__sliceSize.height = __sliceSize.height - vPadding
local __xRepeat = math.ceil(size.width/__sliceSize.width)
local __yRepeat = math.ceil(size.height/__sliceSize.height)
-- How maney sprites we need to fill in tiled node?
local __capacity = __xRepeat * __yRepeat
local __batch = display.newBatchNode(plistFile, __capacity)
local __newSize = cc.size(0,0)
--printf(&newTileNode xRepeat:%u, yRepeat:%u&, __xRepeat, __yRepeat)
for y=0,__yRepeat-1 do
for x=0,__xRepeat-1 do
__newSize.width = __newSize.width + __sliceSize.width
__sprite = display.newSprite(filename)
:align(display.LEFT_BOTTOM,x*__sliceSize.width, y*__sliceSize.height)
:addTo(__batch)
--print(&newTileNode:&, x*__sliceSize.width, y*__sliceSize.height)
__newSize.height = __newSize.height + __sliceSize.height
__batch:setContentSize(__newSize)
return __batch, __newSize.width, __newSize.height
Create a masked sprite
function display.newMaskedSprite(__mask, __pic)
local __mb = ccBlendFunc()
__mb.src = GL_ONE
__mb.dst = GL_ZERO
local __pb = ccBlendFunc()
__pb.src = GL_DST_ALPHA
__pb.dst = GL_ZERO
local __maskSprite = display.newSprite(__mask):align(display.LEFT_BOTTOM, 0, 0)
__maskSprite:setBlendFunc(__mb)
local __picSprite = display.newSprite(__pic):align(display.LEFT_BOTTOM, 0, 0)
__picSprite:setBlendFunc(__pb)
local __maskSize = __maskSprite:getContentSize()
local __canva = CCRenderTexture:create(__maskSize.width,__maskSize.height)
__canva:begin()
__maskSprite:visit()
__picSprite:visit()
__canva:endToLua()
local __resultSprite = CCSprite:createWithTexture(__canva:getSprite():getTexture())
& & __resultSprite:setFlipY(true)
return __resultSprite
Create a Filtered Sprite
@param mixed filename As same a the first parameter for display.newSprite
@param mixed filters One of the following:
- More CCFilter names(in a table);
- An instance of CCF
- Some instances of CCFilter(in a table);
- A CCArray inclueds some instances of CCFilter.
@param table params A or some parameters for CCFilter.
@return An instance of CCFilteredSprite
function display.newFilteredSprite(filename, filters, params)
local __one = {class=CCFilteredSpriteWithOne}
local __multi = {class=CCFilteredSpriteWithMulti}
if not filters then return display.newSprite(filtename, nil,nil , __one) end
local __sp = nil
local __type = type(filters)
& & if __type == &userdata& then __type = tolua.type(filters) end
--print(&display.newFSprite type:&, __type)
if __type == &string& then
__sp = display.newSprite(filename, nil, nil, __one)
filters = filter.newFilter(filters, params)
__sp:setFilter(filters)
elseif __type == &table& then
assert(#filters & 1, &display.newFilteredSprite() - Please give me 2 or more filters!&)
__sp = display.newSprite(filename, nil, nil, __multi)
-- treat filters as {&FILTER_NAME&, &FILTER_NAME&}
if type(filters[1]) == &string& then
__sp:setFilters(filter.newFilters(filters, params))
-- treat filters as {CCFilter, CCFilter , ...}
local __filters = CCArray:create()
for i in ipairs(filters) do
__filters:addObject(filters[i])
__sp:setFilters(__filters)
elseif __type == &CCArray& then
-- treat filters as CCArray(CCFilter, CCFilter, ...)
__sp = display.newSprite(filename, nil, nil, __multi)
__sp:setFilters(filters)
-- treat filters as CCFilter
__sp = display.newSprite(filename, nil, nil, __one)
__sp:setFilter(filters)
return __sp
Create a Gray Sprite by CCFilteredSprite
@param mixed filename As same a the first parameter for display.newSprite
@param table params As same as the third parameter for display.newFilteredSprite
@return An instance of CCFilteredSprite
function display.newGraySprite(filename, params)
return display.newFilteredSprite(filename, &GRAY&, params)
function display.newDrawNode()
return CCDrawNode:create()
Create a circle or a sector or a pie by CCDrawNode
@author zrong(zengrong.net)
@param mixed filename As same a the first parameter for display.newSprite
@param table params As same as the third parameter for display.newFilteredSprite
@return An instance of CCFilteredSprite
function display.newSolidCircle(radius, params)
local circle = display.newDrawNode()
circle:drawCircle(radius, params)
local x,y = 0,0
if params then
x = params.x or x
y = params.y or y
circle:pos(x,y)
return circle
创建并返回一个 CCCircleShape （圆）对象。
@param number radius
@return CCCircleShape
@see CCShapeNode
function display.newCircle(radius, params)
& & local circle = CCCircleShape:create(radius)
local x,y = 0,0
local align=display.CENTER
if params then
x = params.x or x
y = params.y or y
align = params.align or align
if params.fill then circle:setFill(params.fill) end
if params.color then circle:setLineColor(params.color) end
if params.strippleEnabled then circle:setLineStippleEnabled(params.strippleEnabled) end
if params.lineStripple then circle:setLineStipple(params.lineStripple) end
local lineWidth = params.lineWidth or params.borderWidth
if lineWidth then circle:setLineWidth(lineWidth) end
circle:setContentSize(cc.size(radius*2,radius*2))
circle:align(align, x,y)
return circle
创建并返回一个 CCRectShape （矩形）对象。
格式：
shape = display.newRect(宽度, 高度 | CCRect | CCSize)
-- 下面两行代码都创建一个宽度 200，高度 100 的矩形
local shape1 = display.newRect(200, 100)
local shape2 = display.newRect(CCSize(200, 100))
-- 创建一个宽度 200，高度 100 的矩形，并且定位于 50, 80
local shape3 = display.newRect(CCRect(50, 80, 200, 100))
@param [mixed ...] 宽度，高度 或 CCRect 或 CCSize
@return CCRectShape
@see CCShapeNode
function display.newRect(width, height, params)
& & local x, y = 0, 0
& & if type(width) == &userdata& then
& & & & local t = tolua.type(width)
& & & & if t == &CCRect& then
& & & & & & x = width.origin.x
& & & & & & y = width.origin.y
& & & & & & height = width.size.height
& & & & & & width = width.size.width
& & & & elseif t == &CCSize& then
& & & & & & height = width.height
& & & & & & width = width.width
& & & & else
& & & & & & printError(&display.newRect() - invalid parameters&)
& & & & & & return
& & & & end
& & local rect = CCRectShape:create(CCSize(width, height))
local align=display.CENTER
if type(height) == &table& then params = hight end
if type(params) == &table& then
x = params.x or x
y = params.y or y
align = params.align or align
if params.color then rect:setLineColor(params.color) end
if params.strippleEnabled then rect:setLineStippleEnabled(params.strippleEnabled) end
if params.lineStripple then rect:setLineStipple(params.lineStripple) end
if params.fill then rect:setFill(params.fill) end
local lineWidth = params.lineWidth or params.borderWidth
if lineWidth then rect:setLineWidth(lineWidth) end
rect:setContentSize(cc.size(width, height))
rect:align(align, x,y)
& & return rect
创建并返回一个 CCPolygonShape （多边形）对象。
local points = {
& & {10, 10}, &-- point 1
& & {50, 50}, &-- point 2
& & {100, 10}, -- point 3
local polygon = display.newPolygon(points)
polygon:setClose(true) -- 将第一个点和最后一个点相连
@param table points 包含多边形每一个点坐标的表格对象
@param number scale 缩放比例
@return CCPolygonShape CCPolygonShape对象
@see CCShapeNode
function display.newPolygon(points, scale)
& & if type(scale) ~= &number& then scale = 1 end
& & local arr = CCPointArray:create(#points)
& & local ccp = cc.p
& & for i, p in ipairs(points) do
& & & & p = ccp(p[1] * scale, p[2] * scale)
& & & & arr:add(p)
& & return CCPolygonShape:create(arr)
将指定的显示对象按照特定锚点对齐。
格式：
display.align(显示对象, 锚点位置, [x, y])
显示对象锚点位置：
- & display.CENTER 图像中央
- & display.LEFT_TOP,
- & display.TOP_LEFT 图像左上角
- & display.CENTER_TOP,
- & display.TOP_CENTER 图像顶部的中间
- & display.RIGHT_TOP,
- & display.TOP_RIGHT 图像顶部的中间
- & display.CENTER_LEFT,
- & display.LEFT_CENTER 图像左边的中间
- & display.CENTER_RIGHT,
- & display.RIGHT_CENTER 图像右边的中间
- & display.BOTTOM_LEFT,
- & display.LEFT_BOTTOM 图像左边的底部
- & display.BOTTOM_RIGHT,
- & display.RIGHT_BOTTOM 图像右边的底部
- & display.BOTTOM_CENTER,
- & display.CENTER_BOTTOM 图像中间的底部
-- 将图像按左上角对齐，并放置在屏幕左上角
display.align(sprite, display.LEFT_TOP, 0, 0)
@param CCSprite target 显示对象
@param integer anchorPoint 锚点位置
@param integer x
@param integer y
function display.align(target, anchorPoint, x, y)
& & target:setAnchorPoint(display.ANCHOR_POINTS[anchorPoint])
& & if x and y then target:setPosition(x, y) end
function display.addImageAsync(imagePath, callback)
& & sharedTextureCache:addImageAsync(imagePath, callback)
将指定的 Sprite Sheets 材质文件及其数据文件载入图像帧缓存。
格式：
display.addSpriteFramesWithFile(数据文件名, 材质文件名)
display.addSpriteFramesWithFile(&Sprites.plist&, &Sprites.png&)
Sprite Sheets 通俗一点解释就是包含多张图片的集合。Sprite Sheets 材质文件由多张图片组成，而数据文件则记录了图片在材质文件中的位置等信息。
@param string plistFilename 数据文件名
@param string image 材质文件名
@see Sprite Sheets
function display.addSpriteFramesWithFile(plistFilename, image, handler)
local async = type(handler) == &function&
local asyncHandler = nil
if async then
asyncHandler = function()
-- printf(&%s, %s async done.&, plistFilename, image)
local texture = sharedTextureCache:textureForKey(image)
assert(texture, string.format(&The texture %s, %s is unavailable.&, plistFilename, image))
sharedSpriteFrameCache:addSpriteFramesWithFile(plistFilename, texture)
handler(plistFilename, image)
& & if display.TEXTURES_PIXEL_FORMAT[image] then
& & & & CCTexture2D:setDefaultAlphaPixelFormat(display.TEXTURES_PIXEL_FORMAT[image])
if async then
sharedTextureCache:addImageAsync(image, asyncHandler)
sharedSpriteFrameCache:addSpriteFramesWithFile(plistFilename, image)
& & & & CCTexture2D:setDefaultAlphaPixelFormat(kCCTexture2DPixelFormat_RGBA8888)
if async then
sharedTextureCache:addImageAsync(image, asyncHandler)
sharedSpriteFrameCache:addSpriteFramesWithFile(plistFilename, image)
从内存中卸载 Sprite Sheets 材质和数据文件
@param string plistFilename 数据文件名
@param string image 材质文件名
function display.removeSpriteFramesWithFile(plistFilename, imageName)
& & sharedSpriteFrameCache:removeSpriteFramesFromFile(plistFilename)
& & if imageName then
& & & & display.removeSpriteFrameByImageName(imageName)
设置材质格式。
为了节约内存，我们会使用一些颜色品质较低的材质格式，例如针对背景图使用 kCCTexture2DPixelFormat_RGB565 格式。
display.setTexturePixelFormat() 可以指定材质文件的材质格式，这样在加载材质文件时就会使用指定的格式。
@param string filename 材质文件名
@param integer format 材质格式
@see Texture Pixel Format
function display.setTexturePixelFormat(filename, format)
& & display.TEXTURES_PIXEL_FORMAT[filename] = format
从图像帧缓存中删除一个图像。
有时候，某些图像仅在特定场景中使用，例如背景图。那么在场景退出时，就可以用 display.removeSpriteFrameByImageName() 从缓存里删除不再使用的图像数据。
此外，CCScene 提供了 markAutoCleanupImage() 接口，可以指定场景退出时需要自动清理的图像，推荐使用。
@param string imageName 图像文件名
function display.removeSpriteFrameByImageName(imageName)
& & sharedSpriteFrameCache:removeSpriteFrameByName(imageName)
& & CCTextureCache:sharedTextureCache():removeTextureForKey(imageName)
从指定的图像文件创建并返回一个批量渲染对象。
local imageName = &Sprites.png&
display.addSpriteFramesWithFile(&Sprites.plist&, imageName) -- 载入图像到帧缓存
-- 下面的代码绘制 100 个图像只用了 1 次 OpenGL draw call
local batch = display.newBatch(imageName)
for i = 1, 100 do
& & local sprite = display.newSprite(&#Sprite0001.png&)
& & batch:addChild(sprite)
-- 下面的代码绘制 100 个图像则要使用 100 次 OpenGL draw call
local group = display.newNode()
for i = 1, 100 do
& & local sprite = display.newSprite(&#Sprite0001.png&)
& & group:addChild(sprite)
@param string image 图像文件名
@param integer capacity
@return CCSpriteBatchNode
@see Batch Node
function display.newBatchNode(image, capacity)
& & return CCSpriteBatchNode:create(image, capacity or 100)
创建并返回一个图像帧对象。
display.addSpriteFramesWithFile(&Sprites.plist&, &Sprites.png&)
-- 创建一个 CCSprite
local sprite = display.newSprite(&#Yes.png&)
-- 创建一个图像帧
local frameNo = display.newSpriteFrame(&No.png&)
-- 在需要时，修改 CCSprite 的显示内容
sprite:setDisplayFrame(frameNo)
@param string 图像帧名称
@return CCSpriteFrameCache
function display.newSpriteFrame(frameName)
& & local frame = sharedSpriteFrameCache:spriteFrameByName(frameName)
& & if not frame then
& & & & printError(&display.newSpriteFrame() - invalid frameName %s&, tostring(frameName))
& & return frame
以特定模式创建一个包含多个图像帧对象的数组。
-- 创建一个数组，包含 Walk0001.png 到 Walk0008.png 的 8 个图像帧对象
local frames = display.newFrames(&Walk%04d.png&, 1, 8)
-- 创建一个数组，包含 Walk0008.png 到 Walk0001.png 的 8 个图像帧对象
local frames = display.newFrames(&Walk%04d.png&, 1, 8, true)
@param string pattern 模式字符串
@param integer begin 起始索引
@param integer length 长度
@param boolean isReversed 是否是递减索引
@return table 图像帧数组
function display.newFrames(pattern, begin, length, isReversed)
& & local frames = {}
& & local step = 1
& & local last = begin + length - 1
& & if isReversed then
& & & & last, begin = begin, last
& & & & step = -1
& & for index = begin, last, step do
& & & & local frameName = string.format(pattern, index)
& & & & local frame = sharedSpriteFrameCache:spriteFrameByName(frameName)
& & & & if not frame then
& & & & & & printError(&display.newFrames() - invalid frame, name %s&, tostring(frameName))
& & & & & & return
& & & & end
& & & & frames[#frames + 1] = frame
& & return frames
以包含图像帧的数组创建一个动画对象。
local frames = display.newFrames(&Walk%04d.png&, 1, 8)
local animation = display.newAnimation(frames, 0.5 / 8) -- 0.5 秒播放 8 桢
sprite:playAnimationOnce(animation) -- 播放一次动画
@param table frames 图像帧的数组
@param number time 每一桢动画之间的间隔时间
@return CCAnimation CCAnimation对象
function display.newAnimation(frames, time)
& & local count = #frames
& & local array = CCArray:create()
& & for i = 1, count do
& & & & array:addObject(frames[i])
& & time = time or 1.0 / count
& & return CCAnimation:createWithSpriteFrames(array, time)
以指定名字缓存创建好的动画对象，以便后续反复使用。
local frames = display.newFrames(&Walk%04d.png&, 1, 8)
local animation = display.newAnimation(frames, 0.5 / 8) -- 0.5 秒播放 8 桢
display.setAnimationCache(&Walk&, animation)
-- 在需要使用 Walk 动画的地方
sprite:playAnimationOnce(display.getAnimationCache(&Walk&)) -- 播放一次动画
@param string name 名字
@param CCAnimation animation 动画对象
function display.setAnimationCache(name, animation)
& & sharedAnimationCache:addAnimation(animation, name)
取得以指定名字缓存的动画对象，如果不存在则返回 nil。
@param string name
@return CCAnimation
function display.getAnimationCache(name)
& & return sharedAnimationCache:animationByName(name)
删除指定名字缓存的动画对象。
@param string name
function display.removeAnimationCache(name)
& & sharedAnimationCache:removeAnimationByName(name)
function display.removeUnusedSpriteFrames()
& & sharedSpriteFrameCache:removeUnusedSpriteFrames()
& & sharedTextureCache:removeUnusedTextures()
display.PROGRESS_TIMER_BAR = kCCProgressTimerTypeBar
display.PROGRESS_TIMER_RADIAL = kCCProgressTimerTypeRadial
function display.newProgressTimer(image, progresssType)
& & if type(image) == &string& then
& & & & image = display.newSprite(image)
& & local progress = CCProgressTimer:create(image)
& & progress:setType(progresssType)
& & return progress
-- Get a screenshot of a CCNode
-- @author zrong(zengrong.net)
-- Creation:
-- @param node A node to print.
-- @param args
-- @return An instance of CCSprite or CCFilteredSprite.
function display.printscreen(node, args)
local sp = true
local file = nil
local filters = nil
local filterParams = nil
if args then
if args.sprite ~= nil then sp = args.sprite end
file = args.file
filters = args.filters
filterParams = args.filterParams
local size = node:getContentSize()
local canvas = CCRenderTexture:create(size.width,size.height)
canvas:begin()
node:visit()
canvas:endToLua()
if sp then
local texture = canvas:getSprite():getTexture()
if filters then
sp = display.newFilteredSprite(texture, filters, filterParams)
sp = display.newSprite(texture)
sp:flipY(true)
if file and device.platform ~= &mac& then
canvas:saveToFile(file)
return sp, file
return display
感谢关注 Ithao123Lua频道，是专门为互联网人打造的学习交流平台，全面满足互联网人工作与学习需求，更多互联网资讯尽在 IThao123!
Laravel是一套简洁、优雅的PHP Web开发框架(PHP Web Framework)。它可以让你从面条一样杂乱的代码中解脱出来；它可以帮你构建一个完美的网络APP，而且每行代码都可以简洁、富于表达力。
产品设计是互联网产品经理的核心能力，一个好的产品经理一定在产品设计方面有扎实的功底，本专题将从互联网产品设计的几个方面谈谈产品设计
随着国内互联网的发展，产品经理岗位需求大幅增加，在国内，从事产品工作的大部分岗位为产品经理，其实现实中，很多从事产品工作的岗位是不能称为产品经理，主要原因是对产品经理的职责不明确，那产品经理的职责有哪些，本专题将详细介绍产品经理的主要职责
Swift是Apple在WWDC2014所发布的一门编程语言，用来撰写OS X和iOS应用程序[1]。在设计Swift时．就有意和Objective-C共存，Objective-C是Apple操作系统在导入Swift前使用的编程语言
Swift是供iOS和OS X应用编程的新编程语言，基于C和Objective-C，而却没有C的一些兼容约束。Swift采用了安全的编程模式和添加现代的功能来使得编程更加简单、灵活和有趣。界面则基于广受人民群众爱戴的Cocoa和Cocoa Touch框架，展示了软件开发的新方向。
IThao123周刊