Class RectangleShape

Readonly[graphicsNative]

Readonly[mutableValue]

Readonly[shapeState]

Readonly[transformableState]

[dispatchDrawable]

• "[dispatchDrawable]"(
      this: Shape,
      target: RenderTarget,
      states: RenderStates,
  ): void

  Parameters

  • this: Shape
  • target: RenderTarget
  • states: RenderStates

  Returns void

getFillColor

• getFillColor(): Color

  返回填充颜色的独立副本。

  Returns Color

getGeometricCenter

• getGeometricCenter(): Vector2f

  返回形状在局部坐标中的几何中心。

  Returns Vector2f

getGlobalBounds

• getGlobalBounds(): FloatRect

  返回应用位置、旋转和缩放后的轴对齐包围框。

  Returns FloatRect

getInverseTransform

• getInverseTransform(): ReadonlyValue<Transform>

  返回从父坐标系到局部的只读逆变换缓存；不可逆时为单位矩阵。

  Returns ReadonlyValue<Transform>

getLocalBounds

• getLocalBounds(): FloatRect

  返回包含轮廓的局部轴对齐包围框。

  Returns FloatRect

getMiterLimit

• getMiterLimit(): number

  返回轮廓尖角延伸限制。

  Returns number

getOrigin

• getOrigin(): Vector2f

  返回局部变换原点的独立副本。

  Returns Vector2f

getOutlineColor

• getOutlineColor(): Color

  返回轮廓颜色的独立副本。

  Returns Color

getOutlineThickness

• getOutlineThickness(): number

  返回轮廓厚度。

  Returns number

getPosition

• getPosition(): Vector2f

  返回位置的独立副本。

  Returns Vector2f

getRotation

• getRotation(): Angle

  返回归一化到 [0°, 360°) 的旋转角度副本。

  Returns Angle

getScale

• getScale(): Vector2f

  返回缩放因子的独立副本。

  Returns Vector2f

getTexture

• getTexture(): | null
  | Readonly<
      Pick<
          Texture,
          | "getSize"
          | typeof graphicsNative
          | typeof textureId
          | typeof textureOwner
          | "copyToImage"
          | "isSmooth"
          | "isRepeated"
          | "isSrgb"
          | "getNativeHandle",
      >,
  >

  返回当前纹理引用；未设置时为 null。

  Returns
      | null
      | Readonly<
          Pick<
              Texture,
              | "getSize"
              | typeof graphicsNative
              | typeof textureId
              | typeof textureOwner
              | "copyToImage"
              | "isSmooth"
              | "isRepeated"
              | "isSrgb"
              | "getNativeHandle",
          >,
      >

getTextureRect

• getTextureRect(): ReadonlyValue<IntRect>

  返回当前纹理像素区域的只读类型视图。

  Returns ReadonlyValue<IntRect>

getTransform

• getTransform(): ReadonlyValue<Transform>

  返回从局部到父坐标系的只读变换缓存；后续读取可更新同一对象。

  Returns ReadonlyValue<Transform>

move

• move(this: TransformableHost, offset: ReadonlyValue<Vector2f>): void

  将 offset 加到当前位置。

  Parameters

  • this: TransformableHost
  • offset: ReadonlyValue<Vector2f>

  Returns void

rotate

• rotate(this: TransformableHost, angle: ReadonlyValue<Angle>): void

  在当前旋转角度上累加 angle。

  Parameters

  • this: TransformableHost
  • angle: ReadonlyValue<Angle>

  Returns void

scale

• scale(this: TransformableHost, factors: ReadonlyValue<Vector2f>): void

  将当前 X、Y 缩放因子分别乘以 factors。

  Parameters

  • this: TransformableHost
  • factors: ReadonlyValue<Vector2f>

  Returns void

setFillColor

• setFillColor(this: ShapeResource, color: ReadonlyValue<Color>): void

  设置填充颜色，绘制时与纹理颜色相乘。

  Parameters

  • this: ShapeResource
  • color: ReadonlyValue<Color>

  Returns void

setMiterLimit

• setMiterLimit(this: ShapeResource, limit: number): void

  设置轮廓尖角延伸与厚度的最大比例，必须至少为 1。

  Parameters

  • this: ShapeResource
  • limit: number

  Returns void

setOrigin

• setOrigin(this: TransformableHost, origin: ReadonlyValue<Vector2f>): void

  设置局部坐标中的变换原点，旋转和缩放围绕该点进行。

  Parameters

  • this: TransformableHost
  • origin: ReadonlyValue<Vector2f>

  Returns void

setOutlineColor

• setOutlineColor(this: ShapeResource, color: ReadonlyValue<Color>): void

  复制轮廓颜色。

  Parameters

  • this: ShapeResource
  • color: ReadonlyValue<Color>

  Returns void

setOutlineThickness

• setOutlineThickness(this: ShapeResource, thickness: number): void

  设置局部坐标中的轮廓厚度；正值向外扩展，负值向内扩展。

  Parameters

  • this: ShapeResource
  • thickness: number

  Returns void

setPosition

• setPosition(this: TransformableHost, position: ReadonlyValue<Vector2f>): void

  设置对象原点在父坐标系中的位置，复制 position 的值。

  Parameters

  • this: TransformableHost
  • position: ReadonlyValue<Vector2f>

  Returns void

setRotation

• setRotation(this: TransformableHost, angle: ReadonlyValue<Angle>): void

  设置旋转角度；屏幕坐标中正角度为顺时针。

  Parameters

  • this: TransformableHost
  • angle: ReadonlyValue<Angle>

  Returns void

setScale

• setScale(this: TransformableHost, factors: ReadonlyValue<Vector2f>): void

  设置 X、Y 缩放因子；(1, 1) 为原始大小，负值可翻转。

  Parameters

  • this: TransformableHost
  • factors: ReadonlyValue<Vector2f>

  Returns void

setTexture

• setTexture(
      this: ShapeResource,
      texture:
          | null
          | Readonly<
              Pick<
                  Texture,
                  | "getSize"
                  | typeof graphicsNative
                  | typeof textureId
                  | typeof textureOwner
                  | "copyToImage"
                  | "isSmooth"
                  | "isRepeated"
                  | "isSrgb"
                  | "getNativeHandle",
              >,
          >,
      resetRect?: boolean,
  ): void

  设置并保留纹理引用；null 禁用纹理，resetRect 为 true 时覆盖整个纹理。

  Parameters

  • this: ShapeResource
  • texture:
        | null
        | Readonly<
            Pick<
                Texture,
                | "getSize"
                | typeof graphicsNative
                | typeof textureId
                | typeof textureOwner
                | "copyToImage"
                | "isSmooth"
                | "isRepeated"
                | "isSrgb"
                | "getNativeHandle",
            >,
        >
  • resetRect: boolean = false

  Returns void

setTextureRect

• setTextureRect(this: ShapeResource, rectangle: ReadonlyValue<IntRect>): void

  复制要使用的纹理像素区域，负尺寸可翻转纹理。

  Parameters

  • this: ShapeResource
  • rectangle: ReadonlyValue<IntRect>

  Returns void