diff options
Diffstat (limited to 'doc/classes/ResourceLoader.xml')
| -rw-r--r-- | doc/classes/ResourceLoader.xml | 62 |
1 files changed, 31 insertions, 31 deletions
diff --git a/doc/classes/ResourceLoader.xml b/doc/classes/ResourceLoader.xml index 729058c9b3..d51a5293ec 100644 --- a/doc/classes/ResourceLoader.xml +++ b/doc/classes/ResourceLoader.xml @@ -14,8 +14,8 @@ <methods> <method name="add_resource_format_loader"> <return type="void" /> - <argument index="0" name="format_loader" type="ResourceFormatLoader" /> - <argument index="1" name="at_front" type="bool" default="false" /> + <param index="0" name="format_loader" type="ResourceFormatLoader" /> + <param index="1" name="at_front" type="bool" default="false" /> <description> Registers a new [ResourceFormatLoader]. The ResourceLoader will use the ResourceFormatLoader as described in [method load]. This method is performed implicitly for ResourceFormatLoaders written in GDScript (see [ResourceFormatLoader] for more information). @@ -23,59 +23,59 @@ </method> <method name="exists"> <return type="bool" /> - <argument index="0" name="path" type="String" /> - <argument index="1" name="type_hint" type="String" default="""" /> + <param index="0" name="path" type="String" /> + <param index="1" name="type_hint" type="String" default="""" /> <description> - Returns whether a recognized resource exists for the given [code]path[/code]. - An optional [code]type_hint[/code] can be used to further specify the [Resource] type that should be handled by the [ResourceFormatLoader]. Anything that inherits from [Resource] can be used as a type hint, for example [Image]. + Returns whether a recognized resource exists for the given [param path]. + An optional [param type_hint] can be used to further specify the [Resource] type that should be handled by the [ResourceFormatLoader]. Anything that inherits from [Resource] can be used as a type hint, for example [Image]. </description> </method> <method name="get_dependencies"> <return type="PackedStringArray" /> - <argument index="0" name="path" type="String" /> + <param index="0" name="path" type="String" /> <description> - Returns the dependencies for the resource at the given [code]path[/code]. + Returns the dependencies for the resource at the given [param path]. </description> </method> <method name="get_recognized_extensions_for_type"> <return type="PackedStringArray" /> - <argument index="0" name="type" type="String" /> + <param index="0" name="type" type="String" /> <description> Returns the list of recognized extensions for a resource type. </description> </method> <method name="get_resource_uid"> <return type="int" /> - <argument index="0" name="path" type="String" /> + <param index="0" name="path" type="String" /> <description> Returns the ID associated with a given resource path, or [code]-1[/code] when no such ID exists. </description> </method> <method name="has_cached"> <return type="bool" /> - <argument index="0" name="path" type="String" /> + <param index="0" name="path" type="String" /> <description> - Returns whether a cached resource is available for the given [code]path[/code]. + Returns whether a cached resource is available for the given [param path]. Once a resource has been loaded by the engine, it is cached in memory for faster access, and future calls to the [method load] method will use the cached version. The cached resource can be overridden by using [method Resource.take_over_path] on a new resource for that same path. </description> </method> <method name="load"> <return type="Resource" /> - <argument index="0" name="path" type="String" /> - <argument index="1" name="type_hint" type="String" default="""" /> - <argument index="2" name="cache_mode" type="int" enum="ResourceLoader.CacheMode" default="1" /> + <param index="0" name="path" type="String" /> + <param index="1" name="type_hint" type="String" default="""" /> + <param index="2" name="cache_mode" type="int" enum="ResourceLoader.CacheMode" default="1" /> <description> - Loads a resource at the given [code]path[/code], caching the result for further access. + Loads a resource at the given [param path], caching the result for further access. The registered [ResourceFormatLoader]s are queried sequentially to find the first one which can handle the file's extension, and then attempt loading. If loading fails, the remaining ResourceFormatLoaders are also attempted. - An optional [code]type_hint[/code] can be used to further specify the [Resource] type that should be handled by the [ResourceFormatLoader]. Anything that inherits from [Resource] can be used as a type hint, for example [Image]. - The [code]cache_mode[/code] property defines whether and how the cache should be used or updated when loading the resource. See [enum CacheMode] for details. + An optional [param type_hint] can be used to further specify the [Resource] type that should be handled by the [ResourceFormatLoader]. Anything that inherits from [Resource] can be used as a type hint, for example [Image]. + The [param cache_mode] property defines whether and how the cache should be used or updated when loading the resource. See [enum CacheMode] for details. Returns an empty resource if no [ResourceFormatLoader] could handle the file. GDScript has a simplified [method @GDScript.load] built-in method which can be used in most situations, leaving the use of [ResourceLoader] for more advanced scenarios. </description> </method> <method name="load_threaded_get"> <return type="Resource" /> - <argument index="0" name="path" type="String" /> + <param index="0" name="path" type="String" /> <description> Returns the resource loaded by [method load_threaded_request]. If this is called before the loading thread is done (i.e. [method load_threaded_get_status] is not [constant THREAD_LOAD_LOADED]), the calling thread will be blocked until the resource has finished loading. @@ -83,34 +83,34 @@ </method> <method name="load_threaded_get_status"> <return type="int" enum="ResourceLoader.ThreadLoadStatus" /> - <argument index="0" name="path" type="String" /> - <argument index="1" name="progress" type="Array" default="[]" /> + <param index="0" name="path" type="String" /> + <param index="1" name="progress" type="Array" default="[]" /> <description> - Returns the status of a threaded loading operation started with [method load_threaded_request] for the resource at [code]path[/code]. See [enum ThreadLoadStatus] for possible return values. - An array variable can optionally be passed via [code]progress[/code], and will return a one-element array containing the percentage of completion of the threaded loading. + Returns the status of a threaded loading operation started with [method load_threaded_request] for the resource at [param path]. See [enum ThreadLoadStatus] for possible return values. + An array variable can optionally be passed via [param progress], and will return a one-element array containing the percentage of completion of the threaded loading. </description> </method> <method name="load_threaded_request"> <return type="int" enum="Error" /> - <argument index="0" name="path" type="String" /> - <argument index="1" name="type_hint" type="String" default="""" /> - <argument index="2" name="use_sub_threads" type="bool" default="false" /> - <argument index="3" name="cache_mode" type="int" enum="ResourceLoader.CacheMode" default="1" /> + <param index="0" name="path" type="String" /> + <param index="1" name="type_hint" type="String" default="""" /> + <param index="2" name="use_sub_threads" type="bool" default="false" /> + <param index="3" name="cache_mode" type="int" enum="ResourceLoader.CacheMode" default="1" /> <description> - Loads the resource using threads. If [code]use_sub_threads[/code] is [code]true[/code], multiple threads will be used to load the resource, which makes loading faster, but may affect the main thread (and thus cause game slowdowns). - The [code]cache_mode[/code] property defines whether and how the cache should be used or updated when loading the resource. See [enum CacheMode] for details. + Loads the resource using threads. If [param use_sub_threads] is [code]true[/code], multiple threads will be used to load the resource, which makes loading faster, but may affect the main thread (and thus cause game slowdowns). + The [param cache_mode] property defines whether and how the cache should be used or updated when loading the resource. See [enum CacheMode] for details. </description> </method> <method name="remove_resource_format_loader"> <return type="void" /> - <argument index="0" name="format_loader" type="ResourceFormatLoader" /> + <param index="0" name="format_loader" type="ResourceFormatLoader" /> <description> Unregisters the given [ResourceFormatLoader]. </description> </method> <method name="set_abort_on_missing_resources"> <return type="void" /> - <argument index="0" name="abort" type="bool" /> + <param index="0" name="abort" type="bool" /> <description> Changes the behavior on missing sub-resources. The default behavior is to abort loading. </description> |