Options
All
  • Public
  • Public/Protected
  • All
Menu

Class ObjectGroup

The "ObjectGroup" is a type of layer that can contain objects. It will henceforth be referred to as a layer.

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

  • Constructs a new object layer, which can be added to a TileMap.

Properties

Readonly asset

asset: null | Asset

The asset this object is part of, or null.

className

className: string

Class name of the object.

Replaced the "type" of MapObject and Tile in Tiled 1.9.

since

1.9

color

color: color

Color of shape and point objects on this layer (when not set by object type).

drawOrder

drawOrder: typeof UnknownOrder | typeof TopDownOrder | typeof IndexOrder

The objects can either be drawn top down (sorted by their y-coordinate) or by index (manual stacking order).

The default is top down.

since

1.8

Readonly id

id: number

Unique (map-wide) ID of the layer

since

1.5

Readonly isGroupLayer

isGroupLayer: boolean

Whether this layer is a GroupLayer.

Readonly isImageLayer

isImageLayer: boolean

Whether this layer is an ImageLayer.

Readonly isObjectLayer

isObjectLayer: boolean

Whether this layer is an ObjectGroup.

Readonly isTileLayer

isTileLayer: boolean

Whether this layer is a TileLayer.

locked

locked: boolean

Whether the layer is locked (affects whether child layers are locked for group layers).

Readonly map

map: null | TileMap

Map that this layer is part of, or null in case of a standalone layer.

name

name: string

Name of the layer.

Readonly objectCount

objectCount: number

Number of objects on this layer.

Readonly objects

objects: MapObject[]

Array of all objects on this layer.

offset

offset: point

Offset in pixels that is applied when this layer is rendered.

opacity

opacity: any

Opacity of the layer, from 0 (fully transparent) to 1 (fully opaque).

parallaxFactor

parallaxFactor: point

The parallax factor of this layer.

Readonly parentLayer

parentLayer: null | GroupLayer

The group layer this layer is part of, or null in case the layer is not grouped.

Readonly readOnly

readOnly: boolean

Whether the object is read-only.

selected

selected: boolean

Whether the layer is selected.

tintColor

tintColor: color

Tint color of the layer. Will be used to tint any images rendered by this layer or by any child layers. Affects tile layers, image layers and tile objects.

Since Tiled 1.8.5, this property is #ffffff when no tint color has been set on this layer (before it was #000000 in that case).

since

1.8

visible

visible: boolean

Whether the layer is visible (affects child layer visibility for group layers).

Static Readonly GroupLayerType

GroupLayerType: number

Static Readonly ImageLayerType

ImageLayerType: number

Static Readonly IndexOrder

IndexOrder: typeof IndexOrder

Static Readonly ObjectGroupType

ObjectGroupType: number

Static Readonly TileLayerType

TileLayerType: number

Static Readonly TopDownOrder

TopDownOrder: typeof TopDownOrder

Static Readonly UnknownOrder

UnknownOrder: typeof UnknownOrder

Methods

addObject

  • Adds the given object to the layer. The object can’t already be part of a layer.

insertObjectAt

  • insertObjectAt(index: number, object: MapObject): void

  • Inserts the object at the given index. The object can’t already be part of a layer.

objectAt

  • Returns a reference to the object at the given index. When the object is removed, the reference turns into a standalone copy of the object.

properties

  • Returns all custom properties set on this object.

    Modifications to the properties will not affect the original object. Does not include inherited values (see resolvedProperties).

property

  • Returns the value of the custom property with the given name, or undefined if no such property is set on the object. Does not include inherited values (see resolvedProperty).

    file properties are returned as FilePath.

    object properties are returned as MapObject when possible, or ObjectRef when the object could not be found.

removeObject

  • Removes the given object from this layer. The object reference turns into a standalone copy of the object.

removeObjectAt

  • removeObjectAt(index: number): void

  • Removes the object at the given index.

removeProperty

  • removeProperty(name: string): void

resolvedProperties

  • Returns all custom properties set on this object. Modifications to the properties will not affect the original object. Includes values inherited from object types, templates and tiles where applicable.

resolvedProperty

  • Returns the value of the custom property with the given name, or undefined if no such property is set. Includes values inherited from object types, templates and tiles where applicable.

setColorProperty

  • setColorProperty(name: string, value: color): void
  • setColorProperty(name: string, red: number, green: number, blue: number, alpha?: number): void

  • Sets the value of the custom property with the given name to the given color value.

    The color is specified as a string "#RGB", "#RRGGBB" or "#AARRGGBB".

    since

    1.10

    deprecated

    Use setProperty with a value created by tiled.color instead.

  • Sets the value of the custom property with the given name to the given color value.

    The color is specified by its red, green, blue and alpha components. Each component takes a value from 0 to 255. When not provided, the alpha defaults to 255.

    since

    1.10

    deprecated

    Use setProperty with a value created by tiled.color instead.

setFloatProperty

  • setFloatProperty(name: string, value: number): void

  • Sets the value of the custom property with the given name to the given float value.

    This function is provided as alternative to setProperty, since that function will set whole numbers as int properties.

    since

    1.10

setProperties

  • Replaces all currently set custom properties with a new set of properties.

setProperty

  • Sets the value of the custom property with the given name.

    Supported types are bool, number, string, color, FilePath, ObjectRef, MapObject and PropertyValue.

    note

    When setting a number, the property type will be set to either int or float, depending on whether it is a whole number. To force the property to be float, use setFloatProperty.

  • Sets the value of an object's property identified by the given path to the given value.

    The path is a list of property names, where each name identifies a member of the previous member's value. The last name in the list identifies the property to set.

    Supported types are bool, number, string, color, FilePath, ObjectRef, MapObject and PropertyValue.

    note

    When setting a number, the property type will be set to either int or float, depending on whether it is a whole number. To force the property to be float, use setFloatProperty.

    since

    1.11

Generated using TypeDoc