@ts-defold/types 1.2.8 → 1.2.11

package/index.d.ts

@@ -2,7 +2,7 @@
 /// <reference types="lua-types/5.1" />
 /// <reference types="typescript-to-lua/language-extensions" />
 
-// DEFOLD. stable version 1.2.190 (d31d6397a72178541a5ef6e7ef2bed090d828f58)
+// DEFOLD. stable version 1.3.0 (0e77ba11ac957ee01878bbde2e6ac0c9fae6dc01)
 // =^..^=   =^..^=   =^..^=    =^..^=    =^..^=    =^..^=    =^..^= //
 
 
@@ -406,6 +406,7 @@ declare namespace go {
 	* - Sprite
 	* - Tile Grid
 	* - Model
+	* - Mesh
 	* 
 	*/
 	export type disable = "disable"
@@ -423,6 +424,7 @@ declare namespace go {
 	* - Sprite
 	* - Tile Grid
 	* - Model
+	* - Mesh
 	* 
 	*/
 	export type enable = "enable"
@@ -1485,12 +1487,6 @@ with a custom curve. See the animation guide for more information.
 	*/
 	export function cancel_flipbook(node: node): void
 
-	/**
-	* cancel a spine animation
-	* @param node  spine node that should cancel its animation
-	*/
-	export function cancel_spine(node: node): void
-
 	/**
 	* Make a clone instance of a node.
 	* This function does not clone the supplied node's children nodes.
@@ -1838,7 +1834,7 @@ with a custom curve. See the animation guide for more information.
 	* The size mode defines how the node will adjust itself in size. Automatic
 	* size mode alters the node size based on the node's content. Automatic size
 	* mode works for Box nodes and Pie nodes which will both adjust their size
-	* to match the assigned image. Spine, Particle fx and Text nodes will ignore
+	* to match the assigned image. Particle fx and Text nodes will ignore
 	* any size mode setting.
 	* @param node  node from which to get the size mode (node)
 	* @return size_mode  the current size mode
@@ -1856,52 +1852,6 @@ with a custom curve. See the animation guide for more information.
 	*/
 	export function get_slice9(node: node): vmath.vector4
 
-	/**
-	* Gets the playing animation on a spine node
-	* @param node  node to get spine skin from
-	* @return id  spine animation id, 0 if no animation is playing
-	*/
-	export function get_spine_animation(node: node): hash
-
-	/**
-	* The returned node can be used for parenting and transform queries.
-	* This function has complexity O(n), where n is the number of bones in the spine model skeleton.
-	* @param node  spine node to query for bone node
-	* @param bone_id  id of the corresponding bone
-	* @return bone  node corresponding to the spine bone
-	*/
-	export function get_spine_bone(node: node, bone_id: string | hash): node
-
-	/**
-	* This is only useful for spine nodes. Gets the normalized cursor of the animation on a spine node.
-	* @param node  spine node to get the cursor for (node)
-	* @return cursor  cursor value
-	*/
-	export function get_spine_cursor(node: node): any
-
-	/**
-	* This is only useful for spine nodes. Gets the playback rate of the animation on a spine node.
-	* @param node  spine node to set the cursor for
-	* @return rate  playback rate
-	*/
-	export function get_spine_playback_rate(node: node): number
-
-	/**
-	* Returns the spine scene id of the supplied node.
-	* This is currently only useful for spine nodes.
-	* The returned spine scene must be mapped to the gui scene in the gui editor.
-	* @param node  node to get texture from
-	* @return spine_scene  spine scene id
-	*/
-	export function get_spine_scene(node: node): hash
-
-	/**
-	* Gets the spine skin of a spine node
-	* @param node  node to get spine skin from
-	* @return id  spine skin id, 0 if no explicit skin is set
-	*/
-	export function get_spine_skin(node: node): hash
-
 	/**
 	* Returns the text value of a text node. This is only useful for text nodes.
 	* @param node  node from which to get the text
@@ -2011,14 +1961,6 @@ with a custom curve. See the animation guide for more information.
 	*/
 	export function new_pie_node(pos: vmath.vector3 | vmath.vector4, size: vmath.vector3): node
 
-	/**
-	* Dynamically create a new spine node.
-	* @param pos  node position
-	* @param spine_scene  spine scene id
-	* @return node  new spine node
-	*/
-	export function new_spine_node(pos: vmath.vector3 | vmath.vector4, spine_scene: string | hash): node
-
 	/**
 	* Dynamically create a new text node.
 	* @param pos  node position
@@ -2105,32 +2047,6 @@ the new state of the emitter:
 	*/
 	export function play_particlefx(node: node, emitter_state_function?: any): void
 
-	/**
-	* Starts a spine animation.
-	* @param node  spine node that should play the animation
-	* @param animation_id  id of the animation to play
-	* @param playback  playback mode
-
-- `gui.PLAYBACK_ONCE_FORWARD`
-- `gui.PLAYBACK_ONCE_BACKWARD`
-- `gui.PLAYBACK_ONCE_PINGPONG`
-- `gui.PLAYBACK_LOOP_FORWARD`
-- `gui.PLAYBACK_LOOP_BACKWARD`
-- `gui.PLAYBACK_LOOP_PINGPONG`
-
-	* @param play_properties  optional table with properties
-
-`blend_duration`
-The duration of a linear blend between the current and new animation
-`offset`
-The normalized initial value of the animation cursor when the animation starts playing
-`playback_rate`
-The rate with which the animation will be played. Must be positive
-
-	* @param complete_function  function to call when the animation has completed
-	*/
-	export function play_spine_anim(node: node, animation_id: string | hash, playback: any, play_properties?: any, complete_function?: any): void
-
 	/**
 	* Resets the input context of keyboard. This will clear marked text.
 	*/
@@ -2143,6 +2059,14 @@ The rate with which the animation will be played. Must be positive
 	*/
 	export function reset_nodes(): void
 
+	/**
+	* Convert the screen position to the local position of supplied node
+	* @param node  node used for getting local transformation matrix
+	* @param screen_position  screen position
+	* @return local_position  local position
+	*/
+	export function screen_to_local(node: node, screen_position: vmath.vector3): vmath.vector3
+
 	/**
 	* Sets the adjust mode on a node.
 	* The adjust mode defines how the node will adjust itself to screen
@@ -2415,6 +2339,13 @@ The rate with which the animation will be played. Must be positive
 	*/
 	export function set_scale(node: node, scale: vmath.vector3 | vmath.vector4): void
 
+	/**
+	* Set the screen position to the supplied node
+	* @param node  node to set the screen position to
+	* @param screen_position  screen position
+	*/
+	export function set_screen_position(node: node, screen_position: vmath.vector3): void
+
 	/**
 	* Sets the shadow color of the supplied node.
 	* See gui.set_color for info how vectors encode color values.
@@ -2436,7 +2367,7 @@ The rate with which the animation will be played. Must be positive
 	* The size mode defines how the node will adjust itself in size. Automatic
 	* size mode alters the node size based on the node's content. Automatic size
 	* mode works for Box nodes and Pie nodes which will both adjust their size
-	* to match the assigned image. Spine, Particle fx and Text nodes will ignore
+	* to match the assigned image. Particle fx and Text nodes will ignore
 	* any size mode setting.
 	* @param node  node to set size mode for
 	* @param size_mode  size mode to set
@@ -2454,35 +2385,6 @@ The rate with which the animation will be played. Must be positive
 	*/
 	export function set_slice9(node: node, values: vmath.vector4): void
 
-	/**
-	* This is only useful for spine nodes. The cursor is normalized.
-	* @param node  spine node to set the cursor for
-	* @param cursor  cursor value
-	*/
-	export function set_spine_cursor(node: node, cursor: number): void
-
-	/**
-	* This is only useful for spine nodes. Sets the playback rate of the animation on a spine node. Must be positive.
-	* @param node  spine node to set the cursor for
-	* @param playback_rate  playback rate
-	*/
-	export function set_spine_playback_rate(node: node, playback_rate: number): void
-
-	/**
-	* Set the spine scene on a spine node. The spine scene must be mapped to the gui scene in the gui editor.
-	* @param node  node to set spine scene for
-	* @param spine_scene  spine scene id
-	*/
-	export function set_spine_scene(node: node, spine_scene: string | hash): void
-
-	/**
-	* Sets the spine skin on a spine node.
-	* @param node  node to set the spine skin on
-	* @param spine_skin  spine skin id
-	* @param spine_slot  optional slot id to only change a specific slot
-	*/
-	export function set_spine_skin(node: node, spine_skin: string | hash, spine_slot?: string | hash): void
-
 	/**
 	* Set the text value of a text node. This is only useful for text nodes.
 	* @param node  node to set text for
@@ -2716,6 +2618,18 @@ See each joint type for possible properties field. The one field that is accepte
 	*/
 	export function get_gravity(): vmath.vector3
 
+	/**
+	* Returns the group name of a collision object as a hash.
+	* @param url  the collision object to return the group of.
+	* @return   hash value of the group.
+local function check_is_enemy()
+    local group = physics.get_group(&quot;#collisionobject&quot;)
+    return group == hash(&quot;enemy&quot;)
+end
+
+	*/
+	export function get_group(url: string | hash | url): hash
+
 	/**
 	* Get a table for properties for a connected joint. The joint has to be created before
 	* properties can be retrieved.
@@ -2749,6 +2663,21 @@ See each joint type for possible properties field. The one field that is accepte
 	*/
 	export function get_joint_reaction_torque(collisionobject: string | hash | url, joint_id: string | hash): any
 
+	/**
+	* Returns true if the specified group is set in the mask of a collision
+	* object, false otherwise.
+	* @param url  the collision object to check the mask of.
+	* @param group  the name of the group to check for.
+	* @return   boolean value of the maskbit. 'true' if present, 'false' otherwise.
+local function is_invincible()
+    -- check if the collisionobject would collide with the &quot;bullet&quot; group
+    local invincible = physics.get_maskbit(&quot;#collisionobject&quot;, &quot;bullet&quot;)
+    return invincible
+end
+
+	*/
+	export function get_maskbit(url: string | hash | url, group: string): boolean
+
 	/**
 	* Ray casts are used to test for intersections against collision objects in the physics world.
 	* Collision objects of types kinematic, dynamic and static are tested against. Trigger objects
@@ -2793,6 +2722,19 @@ Set to `true` to return all ray cast hits. If `false`, it will only return the c
 	*/
 	export function set_gravity(gravity: vmath.vector3): void
 
+	/**
+	* Updates the group property of a collision object to the specified
+	* string value. The group name should exist i.e. have been used in
+	* a collision object in the editor.
+	* @param url  the collision object affected.
+	* @param group  the new group name to be assigned.
+local function change_collision_group()
+     physics.set_group(&quot;#collisionobject&quot;, &quot;enemy&quot;)
+end
+
+	*/
+	export function set_group(url: string | hash | url, group: string): void
+
 	/**
 	* Flips the collision shapes horizontally for a collision object
 	* @param url  the collision object that should flip its shapes
@@ -2811,6 +2753,19 @@ Note: The `collide_connected` field cannot be updated/changed after a connection
 	*/
 	export function set_joint_properties(collisionobject: string | hash | url, joint_id: string | hash, properties: any): void
 
+	/**
+	* Sets or clears the masking of a group (maskbit) in a collision object.
+	* @param url  the collision object to change the mask of.
+	* @param group  the name of the group (maskbit) to modify in the mask.
+	* @param maskbit  boolean value of the new maskbit. 'true' to enable, 'false' to disable.
+local function make_invincible()
+    -- no longer collide with the &quot;bullet&quot; group
+    physics.set_maskbit(&quot;#collisionobject&quot;, &quot;bullet&quot;, false)
+end
+
+	*/
+	export function set_maskbit(url: string | hash | url, group: string, maskbit: boolean): void
+
 	/**
 	* Flips the collision shapes vertically for a collision object
 	* @param url  the collision object that should flip its shapes
@@ -3956,6 +3911,7 @@ declare namespace resource {
 	/**
 	* Gets the text metrics from a font
 	* @param url  the font to get the (unscaled) metrics from
+	* @param text  text to measure
 	* @param options  A table containing parameters for the text. Supported entries:
 
 `width`
@@ -3975,7 +3931,7 @@ If the calculation should consider line breaks (default false)
 - max_descent
 
 	*/
-	export function get_text_metrics(url: hash, options: any): any
+	export function get_text_metrics(url: hash, text: string, options?: any): any
 
 	/**
 	* Is any liveupdate data mounted and currently in use?
@@ -4337,7 +4293,7 @@ Only available on iOS and Android.
 `manufacturer`
 Only available on iOS and Android.
 `system_name`
-The system OS name: "Darwin", "Linux", "Windows", "HTML5", "Android" or "iPhone OS"
+The system name: "Darwin", "Linux", "Windows", "HTML5", "Android" or "iPhone OS"
 `system_version`
 The system OS version.
 `api_version`
@@ -4919,6 +4875,13 @@ The elapsed time - on first trigger it is time since timer.delay call, otherwise
 	*/
 	export function delay(delay: number, repeat: boolean, callback: any): hash
 
+	/**
+	* Manual triggering a callback for a timer.
+	* @param handle  the timer handle returned by timer.delay()
+	* @return true  if the timer was active, false if the timer is already cancelled / complete
+	*/
+	export function trigger(handle: hash): boolean
+
 }
 // =^..^=   =^..^=   =^..^=    =^..^=    =^..^=    =^..^=    =^..^= //
 
@@ -5425,6 +5388,24 @@ declare namespace camera {
 	*/
 	export type acquire_camera_focus = "acquire_camera_focus"
 
+	/**
+	* Camera frustum far plane.
+	* The type of the property is float.
+	*/
+	export let far_z: any
+
+	/**
+	* Vertical field of view of the camera.
+	* The type of the property is float.
+	*/
+	export let fov: any
+
+	/**
+	* Camera frustum near plane.
+	* The type of the property is float.
+	*/
+	export let near_z: any
+
 	/**
 	* 
 	* Post this message to a camera-component to deactivate it. The camera is then removed from the active cameras.
@@ -6204,6 +6185,11 @@ declare namespace spine {
 
 declare namespace sprite {
 
+	/**
+	* hash.
+	*/
+	export let animation: any
+
 	/**
 	* This message is sent to the sender of a `play_animation` message when the
 	* animation has completed.
@@ -6324,6 +6310,31 @@ declare namespace tilemap {
 	*/
 	export let tile_source: any
 
+	/**
+	* flip tile horizontally
+	*/
+	export let H_FLIP: any
+
+	/**
+	* rotate tile 180 degrees clockwise
+	*/
+	export let ROTATE_180: any
+
+	/**
+	* rotate tile 270 degrees clockwise
+	*/
+	export let ROTATE_270: any
+
+	/**
+	* rotate tile 90 degrees clockwise
+	*/
+	export let ROTATE_90: any
+
+	/**
+	* flip tile vertically
+	*/
+	export let V_FLIP: any
+
 	/**
 	* Get the bounds for a tile map. This function returns multiple values:
 	* The lower left corner index x and y coordinates (1-indexed),
@@ -6372,15 +6383,17 @@ declare namespace tilemap {
 	* The coordinates must be within the bounds of the tile map as it were created.
 	* That is, it is not possible to extend the size of a tile map by setting tiles outside the edges.
 	* To clear a tile, set the tile to number 0. Which tile map and layer to manipulate is identified by the URL and the layer name parameters.
+	* Transform bitmask is arithmetic sum of one or both FLIP constants (`tilemap.H_FLIP`, `tilemap.V_FLIP`) and/or one of ROTATION constants
+	* (`tilemap.ROTATE_90`, `tilemap.ROTATE_180`, `tilemap.ROTATE_270`).
+	* Flip always applies before rotation (clockwise).
 	* @param url  the tile map
 	* @param layer  name of the layer for the tile
 	* @param x  x-coordinate of the tile
 	* @param y  y-coordinate of the tile
 	* @param tile  index of new tile to set. 0 resets the cell
-	* @param h_flipped  optional if the tile should be horizontally flipped
-	* @param v_flipped  optional i the tile should be vertically flipped
+	* @param transform_bitmask  optional flip and/or rotation should be applied to the tile
 	*/
-	export function set_tile(url: string | hash | url, layer: string | hash, x: number, y: number, tile: number, h_flipped?: boolean, v_flipped?: boolean): void
+	export function set_tile(url: string | hash | url, layer: string | hash, x: number, y: number, tile: number, transform_bitmask?: number): void
 
 	/**
 	* Sets the visibility of the tilemap layer

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ts-defold/types",
-  "version": "1.2.8",
+  "version": "1.2.11",
   "description": "TypeScript definitions for Defold",
   "repository": "github:ts-defold/types",
   "keywords": [