View 类型

模块: _decorator 父模块: cc

cc.view is the singleton object which represents the game window.
It's main task include:

• Apply the design resolution policy
  
• Provide interaction with the window, like resize event on web, retina display support, etc...
  
• Manage the game view port which can be different with the window
  
• Manage the content scale and translation
  
  Since the cc.view is a singleton, you don't need to call any constructor or create functions,
  the standard way to use it is by calling:
  
• cc.view.methodName();
  

索引

方法

• setTargetDensityDPI 设置目标内容的每英寸像素点密度。
• getTargetDensityDPI 获取目标内容的每英寸像素点密度。
• resizeWithBrowserSize 设置当发现浏览器的尺寸改变时，是否自动调整 canvas 尺寸大小。
• setResizeCallback 仅在 Web 平台下有效。
• setOrientation 设置游戏屏幕朝向，它能够是横版，竖版或自动。
• adjustViewportMeta 设置引擎是否调整 viewport meta 来配合屏幕适配。
• enableRetina 它仅会在你调用 setDesignResolutionPolicy 方法时有影响。
• isRetinaEnabled 检查是否对 Retina 显示设备进行优化。
• enableAntiAlias 控制抗锯齿是否开启
• isAntiAliasEnabled 返回当前是否抗锯齿
• enableAutoFullScreen 启动时，移动端游戏会在移动端自动尝试进入全屏模式。
• isAutoFullScreenEnabled 检查自动进入全屏模式是否启动。
• getCanvasSize 返回视图中 canvas 的尺寸。
• getFrameSize 返回视图中边框尺寸。
• setFrameSize 在 native 平台下，设置视图框架尺寸。
• getVisibleSize 返回视图窗口可见区域尺寸。
• getVisibleSizeInPixel 返回视图窗口可见区域像素尺寸。
• getVisibleOrigin 返回视图窗口可见区域原点。
• getVisibleOriginInPixel 返回视图窗口可见区域像素原点。
• getResolutionPolicy 返回当前分辨率方案
• setResolutionPolicy 设置当前分辨率模式
• setDesignResolutionSize 通过设置设计分辨率和匹配模式来进行游戏画面的屏幕适配。
• getDesignResolutionSize 返回视图的设计分辨率。
• setRealPixelResolution 设置容器（container）需要的像素分辨率并且适配相应分辨率的游戏内容。
• setViewportInPoints 用设计分辨率下的点尺寸来设置视窗。
• setScissorInPoints 用设计分辨率下的点的尺寸来设置 scissor 剪裁区域。
• isScissorEnabled 检查 scissor 是否生效。
• getScissorRect 返回当前的 scissor 剪裁区域。
• getViewportRect 返回视窗剪裁区域。
• getScaleX 返回横轴的缩放比，这个缩放比是将画布像素分辨率放到设计分辨率的比例。
• getScaleY 返回纵轴的缩放比，这个缩放比是将画布像素分辨率缩放到设计分辨率的比例。
• getDevicePixelRatio 返回设备或浏览器像素比例。
• convertToLocationInView 将屏幕坐标转换为游戏视图下的坐标。

事件

• design-resolution-changed 当设计分辨率改变时发送。
• canvas-resize 当画布大小改变时发送。

Details

方法

setTargetDensityDPI

设置目标内容的每英寸像素点密度。

参数列表

• densityDPI String

getTargetDensityDPI

获取目标内容的每英寸像素点密度。

resizeWithBrowserSize

设置当发现浏览器的尺寸改变时，是否自动调整 canvas 尺寸大小。 仅在 Web 模式下有效。

参数列表

• enabled Boolean Whether enable automatic resize with browser's resize event

setResizeCallback

设置 cc.view 调整视窗尺寸行为的回调函数， 这个回调函数会在应用适配模式之前被调用， 因此你可以在这个回调函数内添加任意附加改变， 仅在 Web 平台下有效。

参数列表

• callback Function | Null The callback function

setOrientation

设置游戏屏幕朝向，它能够是横版，竖版或自动。 当设置为横版或竖版，并且屏幕的宽高比例不匹配时， cc.view 会自动用 CSS 旋转游戏场景的 canvas， 这个方法不会对 native 部分产生任何影响，对于 native 而言，你需要在应用设置中的设置排版。

参数列表

• orientation Number Possible values: cc.macro.ORIENTATION_LANDSCAPE | cc.macro.ORIENTATION_PORTRAIT | cc.macro.ORIENTATION_AUTO

adjustViewportMeta

设置引擎是否调整 viewport meta 来配合屏幕适配。 默认设置为启动，我们强烈建议你不要将它设置为关闭。 即使当它启动时，你仍然能够设置你的 viewport meta，它不会被覆盖。 仅在 Web 模式下有效

参数列表

• enabled Boolean Enable automatic modification to "viewport" meta

enableRetina

对于 Apple 这种支持 Retina 显示的设备上默认进行优化而其他类型设备默认不进行优化， 它仅会在你调用 setDesignResolutionPolicy 方法时有影响。 仅在 Web 模式下有效。

参数列表

• enabled Boolean Enable or disable retina display

isRetinaEnabled

检查是否对 Retina 显示设备进行优化。 仅在 Web 模式下有效。

enableAntiAlias

控制抗锯齿是否开启

参数列表

• enabled Boolean Enable or not anti-alias

isAntiAliasEnabled

返回当前是否抗锯齿

enableAutoFullScreen

启动时，移动端游戏会在移动端自动尝试进入全屏模式。 你能够传入 true 为参数去启动它，用 false 参数来关闭它。

参数列表

• enabled Boolean Enable or disable auto full screen on mobile devices

isAutoFullScreenEnabled

检查自动进入全屏模式是否启动。 仅在 Web 模式下有效。

getCanvasSize

返回视图中 canvas 的尺寸。 在 native 平台下，它返回全屏视图下屏幕的尺寸。 在 Web 平台下，它返回 canvas 元素尺寸。

getFrameSize

返回视图中边框尺寸。 在 native 平台下，它返回全屏视图下屏幕的尺寸。 在 web 平台下，它返回 canvas 元素的外层 DOM 元素尺寸。

setFrameSize

在 native 平台下，设置视图框架尺寸。 在 web 平台下，设置 canvas 外层 DOM 元素尺寸。

参数列表

• width Number
• height Number

getVisibleSize

返回视图窗口可见区域尺寸。

getVisibleSizeInPixel

返回视图窗口可见区域像素尺寸。

getVisibleOrigin

返回视图窗口可见区域原点。

getVisibleOriginInPixel

返回视图窗口可见区域像素原点。

getResolutionPolicy

返回当前分辨率方案

setResolutionPolicy

设置当前分辨率模式

参数列表

• resolutionPolicy ResolutionPolicy | Number

setDesignResolutionSize

通过设置设计分辨率和匹配模式来进行游戏画面的屏幕适配。

参数列表

• width Number Design resolution width.
• height Number Design resolution height.
• resolutionPolicy ResolutionPolicy | Number The resolution policy desired

getDesignResolutionSize

返回视图的设计分辨率。 默认下分辨率尺寸同 getFrameSize 方法相同

setRealPixelResolution

设置容器（container）需要的像素分辨率并且适配相应分辨率的游戏内容。

参数列表

• width Number Design resolution width.
• height Number Design resolution height.
• resolutionPolicy ResolutionPolicy | Number The resolution policy desired

setViewportInPoints

用设计分辨率下的点尺寸来设置视窗。

参数列表

• x Number
• y Number
• w Number width
• h Number height

setScissorInPoints

用设计分辨率下的点的尺寸来设置 scissor 剪裁区域。

参数列表

• x Number
• y Number
• w Number
• h Number

isScissorEnabled

检查 scissor 是否生效。

getScissorRect

返回当前的 scissor 剪裁区域。

getViewportRect

返回视窗剪裁区域。

getScaleX

返回横轴的缩放比，这个缩放比是将画布像素分辨率放到设计分辨率的比例。

getScaleY

返回纵轴的缩放比，这个缩放比是将画布像素分辨率缩放到设计分辨率的比例。

getDevicePixelRatio

返回设备或浏览器像素比例。

convertToLocationInView

将屏幕坐标转换为游戏视图下的坐标。

参数列表

• tx Number The X axis translation
• ty Number The Y axis translation
• relatedPos Object The related position object including "left", "top", "width", "height" informations

事件

design-resolution-changed Event

模块: _decorator 父模块: cc

!en Emit when design resolution changed. !zh 当设计分辨率改变时发送。

索引

Details

canvas-resize Event

模块: _decorator 父模块: cc

!en Emit when canvas resize. !zh 当画布大小改变时发送。

索引

Details