类型 函数 库 display.* 返回值 无 修订 版本 2024.3703 关键词 默认值，设置默认值，颜色，图形，矢量对象 另请参阅 display.getDefault() 形状 — 路径、填充、描边 display.newLine() display.newText() object.anchorX object.anchorY
设置默认显示值，包括显示对象的默认颜色、锚点默认值、纹理环绕设置等。
以下任何一项均有效
display.setDefault( key, value ) display.setDefault( key, r, g, b, alpha ) display.setDefault( key, r, g, b ) display.setDefault( key, gray ) display.setDefault( key, gray, alpha )
字符串. 指定要设置默认值的键。
数字. 介于 0 和 1 之间的颜色值。
这些键指定所有显示对象的默认锚点值和锚点边界。
"anchorX" — 沿 x 方向的锚点对齐方式。此值用于新对象中 anchorX 属性的值。默认值为 0.5（沿 x 方向居中）。
"anchorY" — 沿 y 方向的锚点对齐方式。此值用于新对象中 anchorY 属性的值。默认值为 0.5（沿 y 方向居中）。
"isAnchorClamped" — 如果设置为 false，则沿 x 或 y 方向的锚点位置**不**限制在 0 和 1 之间的值。在这种情况下，将锚点值设置在此范围之外（负值或正值）会将锚点定位在显示对象的边界之外。默认值为 true。
某些显示对象与0.5)，以免其他对象受到意外影响。
颜色键指定要设置的默认颜色值。
"background" — 对应于清除屏幕的默认颜色。默认值最初为黑色 (0,0,0)。
"fillColor" — 对应于矢量对象（如 display.newRect()）的默认填充颜色。默认值最初为白色 (1,1,1)。
"strokeColor" — 对应于矢量对象（如 display.newRect()）的默认描边颜色。默认值最初为白色 (1,1,1)。
"lineColor" — 对应于线条对象（如 display.newLine()）的默认颜色。默认值最初为白色 (1,1,1)。
"isNativeTextBoxFontSizeScaled" — 设置通过 native.newTextBox() 函数创建时要分配给原生文本框的 object.isFontSizeScaled 属性的默认 布尔值。默认值为 true。设置为 false 可启用旧版字体处理支持。
"isNativeTextFieldFontSizeScaled" — 设置通过 native.newTextField() 函数创建时要分配给原生文本字段的 object.isFontSizeScaled 属性的默认 布尔值。默认值为 true。设置为 false 可启用旧版字体处理支持。
"preloadTextures" — 纹理加载的默认行为是在创建显示对象或显示对象使用它时加载纹理。将此值设置为 false 将延迟纹理加载，直到对象出现在屏幕上或变得可见时为止。
"isExternalTextureRetina" — 外部纹理的默认行为是像视网膜纹理一样采样，在解析纹理坐标时对 `width` 和 `height` 应用内容缩放。将此值设置为 `false` 将直接使用 `width` 和 `height`。
"isImageSheetFrameTrimCorrected" — 修剪后的精灵的默认（旧版）行为在对其进行旋转或缩放时可能会导致奇怪的行为。将此值设置为 `true` 将应用适当的校正。（它还会稍微影响 object.anchorChildren 的更新方式。有关更多详细信息，请参阅链接。）
"isImageSheetSampledInsideFrame" — 影响 图像表 帧的采样方式。如果设置为 `true`，则采样会侵入源纹理像素大小的一半以避免边界伪影。默认值为 `false`。
"magTextureFilter" — Solar2D 加载图像时应用的默认放大采样过滤器。首次加载图像后，将对同一文件的任何后续加载应用相同的采样过滤器。这是因为每个文件只加载一次纹理。默认值为 `“linear”`。备用值为 `“nearest”`。
"minTextureFilter" — Solar2D 加载图像时应用的默认缩小采样过滤器。首次加载图像后，将对同一文件的任何后续加载应用相同的采样过滤器。这是因为每个文件只加载一次纹理。默认值为 `“linear”`。备用值为 `“nearest”`。
"textureWrapX" — 沿 x 方向的纹理环绕模式。首次加载图像后，将对同一文件的任何后续加载应用相同的环绕模式。这是因为每个文件只加载一次纹理。默认值为 `“clampToEdge”`。其他值对图案很有用，包括 `“repeat”` 或 `“mirroredRepeat”`。
"textureWrapY" — 沿 y 方向的纹理环绕模式。首次加载图像后，将对同一文件的任何后续加载应用相同的环绕模式。这是因为每个文件只加载一次纹理。默认值为 `“clampToEdge”`。其他值对图案很有用，包括 `“repeat”` 或 `“mirroredRepeat”`。
"cameraSource" — 相机对象填充的默认行为是使用后置摄像头。将此值设置为 `“front”` 将更改行为以使用-- Set default anchor point for objects to bottom-left display.setDefault( "anchorX", 0 ) display.setDefault( "anchorY", 1 )
display.setDefault( "isAnchorClamped", false )
--display.setDefault( "isAnchorClamped", true )
local rect = display.newRect( 200, 240, 100, 100 )
rect.anchorX = -1
rect.anchorY = 1.5
transition.to( rect, { rotation=135, delay=500 } )
-- Set default fill color for vector objects to red display.setDefault( "fillColor", 1, 0, 0 ) -- Set default screen background color to blue display.setDefault( "background", 0, 0, 1 )
display.setDefault( "textureWrapX", "repeat" )
display.setDefault( "textureWrapY", "repeat" )
local x,y = display.contentCenterX, display.contentCenterY
local o = display.newRect( x, y, display.contentWidth, display.contentHeight )
o.fill = { type="image", filename="fish.small.red.png" }
o.fill.scaleX = 0.1
o.fill.scaleY = 0.1
if ( system.getInfo( "environment" ) ~= "simulator" ) then
display.setDefault( "cameraSource", "front" ) -- Front-facing camera
--display.setDefault( "cameraSource", "back" ) -- Back-facing camera
end