2017-09-13 04:42:36 +08:00
<?xml version="1.0" encoding="UTF-8" ?>
2023-03-01 08:44:37 +08:00
<class name= "MeshLibrary" inherits= "Resource" version= "4.1" xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation= "../class.xsd" >
2017-09-13 04:42:36 +08:00
<brief_description >
Library of meshes.
</brief_description>
<description >
2019-11-30 08:21:34 +08:00
A library of meshes. Contains a list of [Mesh] resources, each with a name and ID. Each item can also include collision and navigation shapes. This resource is used in [GridMap].
2017-09-13 04:42:36 +08:00
</description>
<tutorials >
2020-10-01 16:34:47 +08:00
<link title= "3D Kinematic Character Demo" > https://godotengine.org/asset-library/asset/126</link>
<link title= "3D Platformer Demo" > https://godotengine.org/asset-library/asset/125</link>
2017-09-13 04:42:36 +08:00
</tutorials>
<methods >
<method name= "clear" >
2021-07-30 21:28:05 +08:00
<return type= "void" />
2017-09-13 04:42:36 +08:00
<description >
2019-09-24 22:05:49 +08:00
Clears the library.
2017-09-13 04:42:36 +08:00
</description>
</method>
<method name= "create_item" >
2021-07-30 21:28:05 +08:00
<return type= "void" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "id" type= "int" />
2017-09-13 04:42:36 +08:00
<description >
2019-11-30 08:21:34 +08:00
Creates a new item in the library with the given ID.
You can get an unused ID from [method get_last_unused_item_id].
2017-09-13 04:42:36 +08:00
</description>
</method>
<method name= "find_item_by_name" qualifiers= "const" >
2021-07-30 21:28:05 +08:00
<return type= "int" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "name" type= "String" />
2017-09-13 04:42:36 +08:00
<description >
2019-11-30 08:21:34 +08:00
Returns the first item with the given name.
2017-09-13 04:42:36 +08:00
</description>
</method>
<method name= "get_item_list" qualifiers= "const" >
2021-07-30 21:28:05 +08:00
<return type= "PackedInt32Array" />
2017-09-13 04:42:36 +08:00
<description >
2019-11-30 08:21:34 +08:00
Returns the list of item IDs in use.
2017-09-13 04:42:36 +08:00
</description>
</method>
<method name= "get_item_mesh" qualifiers= "const" >
2021-07-30 21:28:05 +08:00
<return type= "Mesh" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "id" type= "int" />
2017-09-13 04:42:36 +08:00
<description >
2019-11-30 08:21:34 +08:00
Returns the item's mesh.
2017-09-13 04:42:36 +08:00
</description>
</method>
2021-09-01 07:17:33 +08:00
<method name= "get_item_mesh_transform" qualifiers= "const" >
<return type= "Transform3D" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "id" type= "int" />
2021-09-01 07:17:33 +08:00
<description >
Returns the transform applied to the item's mesh.
</description>
</method>
2017-09-13 04:42:36 +08:00
<method name= "get_item_name" qualifiers= "const" >
2021-07-30 21:28:05 +08:00
<return type= "String" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "id" type= "int" />
2017-09-13 04:42:36 +08:00
<description >
2019-11-30 08:21:34 +08:00
Returns the item's name.
2017-09-13 04:42:36 +08:00
</description>
</method>
2022-11-30 03:01:31 +08:00
<method name= "get_item_navigation_layers" qualifiers= "const" >
<return type= "int" />
<param index= "0" name= "id" type= "int" />
<description >
Returns the item's navigation layers bitmask.
</description>
</method>
2022-12-12 01:02:35 +08:00
<method name= "get_item_navigation_mesh" qualifiers= "const" >
2021-07-30 21:28:05 +08:00
<return type= "NavigationMesh" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "id" type= "int" />
2017-09-13 04:42:36 +08:00
<description >
2019-11-30 08:21:34 +08:00
Returns the item's navigation mesh.
2017-09-13 04:42:36 +08:00
</description>
</method>
2022-12-12 01:02:35 +08:00
<method name= "get_item_navigation_mesh_transform" qualifiers= "const" >
2021-07-30 21:28:05 +08:00
<return type= "Transform3D" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "id" type= "int" />
2019-04-15 20:49:41 +08:00
<description >
2019-11-30 08:21:34 +08:00
Returns the transform applied to the item's navigation mesh.
2019-04-15 20:49:41 +08:00
</description>
</method>
2017-09-13 04:42:36 +08:00
<method name= "get_item_preview" qualifiers= "const" >
2021-07-30 21:28:05 +08:00
<return type= "Texture2D" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "id" type= "int" />
2017-09-13 04:42:36 +08:00
<description >
2020-02-17 07:01:52 +08:00
When running in the editor, returns a generated item preview (a 3D rendering in isometric perspective). When used in a running project, returns the manually-defined item preview which can be set using [method set_item_preview]. Returns an empty [Texture2D] if no preview was manually set in a running project.
2017-09-13 04:42:36 +08:00
</description>
</method>
<method name= "get_item_shapes" qualifiers= "const" >
2021-07-30 21:28:05 +08:00
<return type= "Array" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "id" type= "int" />
2017-09-13 04:42:36 +08:00
<description >
2019-11-30 08:21:34 +08:00
Returns an item's collision shapes.
2020-05-03 16:27:36 +08:00
The array consists of each [Shape3D] followed by its [Transform3D].
2017-09-13 04:42:36 +08:00
</description>
</method>
<method name= "get_last_unused_item_id" qualifiers= "const" >
2021-07-30 21:28:05 +08:00
<return type= "int" />
2017-09-13 04:42:36 +08:00
<description >
2019-09-24 22:05:49 +08:00
Gets an unused ID for a new item.
2017-09-13 04:42:36 +08:00
</description>
</method>
<method name= "remove_item" >
2021-07-30 21:28:05 +08:00
<return type= "void" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "id" type= "int" />
2017-09-13 04:42:36 +08:00
<description >
2019-06-22 07:04:47 +08:00
Removes the item.
2017-09-13 04:42:36 +08:00
</description>
</method>
<method name= "set_item_mesh" >
2021-07-30 21:28:05 +08:00
<return type= "void" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "id" type= "int" />
<param index= "1" name= "mesh" type= "Mesh" />
2017-09-13 04:42:36 +08:00
<description >
2019-09-24 22:05:49 +08:00
Sets the item's mesh.
2017-09-13 04:42:36 +08:00
</description>
</method>
2021-09-01 07:17:33 +08:00
<method name= "set_item_mesh_transform" >
<return type= "void" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "id" type= "int" />
<param index= "1" name= "mesh_transform" type= "Transform3D" />
2021-09-01 07:17:33 +08:00
<description >
Sets the transform to apply to the item's mesh.
</description>
</method>
2017-09-13 04:42:36 +08:00
<method name= "set_item_name" >
2021-07-30 21:28:05 +08:00
<return type= "void" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "id" type= "int" />
<param index= "1" name= "name" type= "String" />
2017-09-13 04:42:36 +08:00
<description >
2019-09-24 22:05:49 +08:00
Sets the item's name.
2019-11-30 08:21:34 +08:00
This name is shown in the editor. It can also be used to look up the item later using [method find_item_by_name].
2017-09-13 04:42:36 +08:00
</description>
</method>
2022-11-30 03:01:31 +08:00
<method name= "set_item_navigation_layers" >
<return type= "void" />
<param index= "0" name= "id" type= "int" />
<param index= "1" name= "navigation_layers" type= "int" />
<description >
Sets the item's navigation layers bitmask.
</description>
</method>
2022-12-12 01:02:35 +08:00
<method name= "set_item_navigation_mesh" >
2021-07-30 21:28:05 +08:00
<return type= "void" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "id" type= "int" />
2022-12-12 01:02:35 +08:00
<param index= "1" name= "navigation_mesh" type= "NavigationMesh" />
2017-09-13 04:42:36 +08:00
<description >
2019-11-30 08:21:34 +08:00
Sets the item's navigation mesh.
2017-09-13 04:42:36 +08:00
</description>
</method>
2022-12-12 01:02:35 +08:00
<method name= "set_item_navigation_mesh_transform" >
2021-07-30 21:28:05 +08:00
<return type= "void" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "id" type= "int" />
2022-12-12 01:02:35 +08:00
<param index= "1" name= "navigation_mesh" type= "Transform3D" />
2019-04-15 20:49:41 +08:00
<description >
2019-11-30 08:21:34 +08:00
Sets the transform to apply to the item's navigation mesh.
2019-04-15 20:49:41 +08:00
</description>
</method>
2017-09-13 04:42:36 +08:00
<method name= "set_item_preview" >
2021-07-30 21:28:05 +08:00
<return type= "void" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "id" type= "int" />
<param index= "1" name= "texture" type= "Texture2D" />
2017-09-13 04:42:36 +08:00
<description >
2019-11-30 08:21:34 +08:00
Sets a texture to use as the item's preview icon in the editor.
2017-09-13 04:42:36 +08:00
</description>
</method>
<method name= "set_item_shapes" >
2021-07-30 21:28:05 +08:00
<return type= "void" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "id" type= "int" />
<param index= "1" name= "shapes" type= "Array" />
2017-09-13 04:42:36 +08:00
<description >
2019-11-30 08:21:34 +08:00
Sets an item's collision shapes.
2020-05-03 16:27:36 +08:00
The array should consist of [Shape3D] objects, each followed by a [Transform3D] that will be applied to it. For shapes that should not have a transform, use [constant Transform3D.IDENTITY].
2017-09-13 04:42:36 +08:00
</description>
</method>
</methods>
</class>