display.newPolygon()

类型 功能
display.*
返回值 ShapeObject
修订版 2024.3703 版
关键词 形状,多边形,向量
另请参阅 形状 - 路径、填充、线型 (指南)
显示对象 (指南)

概述

通过提供形状的轮廓(轮廓线)来绘制多边形形状。这包括凸形或凹形。但是,不支持自相交形状,并且会导致行为未定义。

本地原点位于多边形的中心,锚点初始化为此本地原点。

语法

display.newPolygon( [parent,] x, y, vertices )
parent (可选)

GroupObject. 用于插入多边形的可选显示组。

x / y (必需)

数字. 对象相对于其父级的位置。

vertices (必需)

数组.xy 坐标的数组。这些坐标将自动围绕多边形的中心重新居中。

需要注意的事项

如果请求的形状无效,例如具有相交线的形状,则可能无法正确呈现。类似地,如果任何坐标点被复制,包括第一个或最后一个点,则形状无效。为了获得正确的结果,你必须指定有效的形状坐标。

示例

local halfW = display.contentWidth * 0.5
local halfH = display.contentHeight * 0.5

local vertices = { 0,-110, 27,-35, 105,-35, 43,16, 65,90, 0,45, -65,90, -43,15, -105,-35, -27,-35, }

local o = display.newPolygon( halfW, halfH, vertices )
o.fill = { type="image", filename="mountains.png" }
o.strokeWidth = 10
o:setStrokeColor( 1, 0, 0 )