Added Documentation for Sprite3D, AnimatedSprite3D and SpriteBase3D etc.
This commit is contained in:
parent
7430bbdac1
commit
a2f504c728
|
@ -4,7 +4,7 @@
|
||||||
Sprite node that can use multiple textures for animation.
|
Sprite node that can use multiple textures for animation.
|
||||||
</brief_description>
|
</brief_description>
|
||||||
<description>
|
<description>
|
||||||
Sprite node that can use multiple textures for animation. Animations are created using a [SpriteFrames] resource, which can be configured in the editor via the SpriteFrames panel.
|
Animations are created using a [SpriteFrames] resource, which can be configured in the editor via the SpriteFrames panel.
|
||||||
</description>
|
</description>
|
||||||
<tutorials>
|
<tutorials>
|
||||||
</tutorials>
|
</tutorials>
|
||||||
|
@ -149,7 +149,7 @@
|
||||||
</methods>
|
</methods>
|
||||||
<members>
|
<members>
|
||||||
<member name="animation" type="String" setter="set_animation" getter="get_animation">
|
<member name="animation" type="String" setter="set_animation" getter="get_animation">
|
||||||
The current animation from the [code]frames[/code] resource. If this value is changed, the [code]frame[/code] counter is reset.
|
The current animation from the [code]frames[/code] resource. If this value changes, the [code]frame[/code] counter is reset.
|
||||||
</member>
|
</member>
|
||||||
<member name="centered" type="bool" setter="set_centered" getter="is_centered">
|
<member name="centered" type="bool" setter="set_centered" getter="is_centered">
|
||||||
If [code]true[/code] texture will be centered. Default value: [code]true[/code].
|
If [code]true[/code] texture will be centered. Default value: [code]true[/code].
|
||||||
|
@ -161,7 +161,7 @@
|
||||||
If [code]true[/code] texture is flipped vertically. Default value: [code]false[/code].
|
If [code]true[/code] texture is flipped vertically. Default value: [code]false[/code].
|
||||||
</member>
|
</member>
|
||||||
<member name="frame" type="int" setter="set_frame" getter="get_frame">
|
<member name="frame" type="int" setter="set_frame" getter="get_frame">
|
||||||
The current frame index.
|
The displayed animation frame's index.
|
||||||
</member>
|
</member>
|
||||||
<member name="frames" type="SpriteFrames" setter="set_sprite_frames" getter="get_sprite_frames">
|
<member name="frames" type="SpriteFrames" setter="set_sprite_frames" getter="get_sprite_frames">
|
||||||
The [SpriteFrames] resource containing the animation(s).
|
The [SpriteFrames] resource containing the animation(s).
|
||||||
|
@ -170,7 +170,7 @@
|
||||||
The texture's drawing offset.
|
The texture's drawing offset.
|
||||||
</member>
|
</member>
|
||||||
<member name="playing" type="bool" setter="_set_playing" getter="_is_playing">
|
<member name="playing" type="bool" setter="_set_playing" getter="_is_playing">
|
||||||
If [code]true[/code] the [code]animation[/code] is currently playing.
|
If [code]true[/code] the [member animation] is currently playing.
|
||||||
</member>
|
</member>
|
||||||
</members>
|
</members>
|
||||||
<signals>
|
<signals>
|
||||||
|
@ -181,7 +181,7 @@
|
||||||
</signal>
|
</signal>
|
||||||
<signal name="frame_changed">
|
<signal name="frame_changed">
|
||||||
<description>
|
<description>
|
||||||
Emitted when [code]frame[/code] changes.
|
Emitted when [member frame] changed.
|
||||||
</description>
|
</description>
|
||||||
</signal>
|
</signal>
|
||||||
</signals>
|
</signals>
|
||||||
|
|
|
@ -1,8 +1,10 @@
|
||||||
<?xml version="1.0" encoding="UTF-8" ?>
|
<?xml version="1.0" encoding="UTF-8" ?>
|
||||||
<class name="AnimatedSprite3D" inherits="SpriteBase3D" category="Core" version="3.0.alpha.custom_build">
|
<class name="AnimatedSprite3D" inherits="SpriteBase3D" category="Core" version="3.0.alpha.custom_build">
|
||||||
<brief_description>
|
<brief_description>
|
||||||
|
2D sprite node in 3D world, that can use multiple 2D textures for animation.
|
||||||
</brief_description>
|
</brief_description>
|
||||||
<description>
|
<description>
|
||||||
|
Animations are created using a [SpriteFrames] resource, which can be configured in the editor via the SpriteFrames panel.
|
||||||
</description>
|
</description>
|
||||||
<tutorials>
|
<tutorials>
|
||||||
</tutorials>
|
</tutorials>
|
||||||
|
@ -83,18 +85,22 @@
|
||||||
</methods>
|
</methods>
|
||||||
<members>
|
<members>
|
||||||
<member name="animation" type="String" setter="set_animation" getter="get_animation">
|
<member name="animation" type="String" setter="set_animation" getter="get_animation">
|
||||||
|
The current animation from the [code]frames[/code] resource. If this value changes, the [code]frame[/code] counter is reset.
|
||||||
</member>
|
</member>
|
||||||
<member name="frame" type="int" setter="set_frame" getter="get_frame">
|
<member name="frame" type="int" setter="set_frame" getter="get_frame">
|
||||||
|
The displayed animation frame's index.
|
||||||
</member>
|
</member>
|
||||||
<member name="frames" type="SpriteFrames" setter="set_sprite_frames" getter="get_sprite_frames">
|
<member name="frames" type="SpriteFrames" setter="set_sprite_frames" getter="get_sprite_frames">
|
||||||
|
The [SpriteFrames] resource containing the animation(s).
|
||||||
</member>
|
</member>
|
||||||
<member name="playing" type="bool" setter="_set_playing" getter="_is_playing">
|
<member name="playing" type="bool" setter="_set_playing" getter="_is_playing">
|
||||||
|
If [code]true[/code] the [member animation] is currently playing.
|
||||||
</member>
|
</member>
|
||||||
</members>
|
</members>
|
||||||
<signals>
|
<signals>
|
||||||
<signal name="frame_changed">
|
<signal name="frame_changed">
|
||||||
<description>
|
<description>
|
||||||
Emitted when frame is changed.
|
Emitted when [member frame] changed.
|
||||||
</description>
|
</description>
|
||||||
</signal>
|
</signal>
|
||||||
</signals>
|
</signals>
|
||||||
|
|
|
@ -202,7 +202,7 @@
|
||||||
</methods>
|
</methods>
|
||||||
<members>
|
<members>
|
||||||
<member name="centered" type="bool" setter="set_centered" getter="is_centered">
|
<member name="centered" type="bool" setter="set_centered" getter="is_centered">
|
||||||
If [code]true[/code] texture will be centered. Default value: [code]true[/code].
|
If [code]true[/code] texture is centered. Default value: [code]true[/code].
|
||||||
</member>
|
</member>
|
||||||
<member name="flip_h" type="bool" setter="set_flip_h" getter="is_flipped_h">
|
<member name="flip_h" type="bool" setter="set_flip_h" getter="is_flipped_h">
|
||||||
If [code]true[/code] texture is flipped horizontally. Default value: [code]false[/code].
|
If [code]true[/code] texture is flipped horizontally. Default value: [code]false[/code].
|
||||||
|
@ -211,40 +211,42 @@
|
||||||
If [code]true[/code] texture is flipped vertically. Default value: [code]false[/code].
|
If [code]true[/code] texture is flipped vertically. Default value: [code]false[/code].
|
||||||
</member>
|
</member>
|
||||||
<member name="frame" type="int" setter="set_frame" getter="get_frame">
|
<member name="frame" type="int" setter="set_frame" getter="get_frame">
|
||||||
Current frame to display from sprite sheet. [code]vframes[/code] or [code]hframes[/code] must be greater than 1.
|
Current frame to display from sprite sheet. [member vframes] or [member hframes] must be greater than 1.
|
||||||
</member>
|
</member>
|
||||||
<member name="hframes" type="int" setter="set_hframes" getter="get_hframes">
|
<member name="hframes" type="int" setter="set_hframes" getter="get_hframes">
|
||||||
The number of horizontal frames in the sprite sheet.
|
The number of collumns in the sprite sheet.
|
||||||
</member>
|
</member>
|
||||||
<member name="normal_map" type="Texture" setter="set_normal_map" getter="get_normal_map">
|
<member name="normal_map" type="Texture" setter="set_normal_map" getter="get_normal_map">
|
||||||
|
The normal map gives depth to the Sprite.
|
||||||
</member>
|
</member>
|
||||||
<member name="offset" type="Vector2" setter="set_offset" getter="get_offset">
|
<member name="offset" type="Vector2" setter="set_offset" getter="get_offset">
|
||||||
The texture's drawing offset.
|
The texture's drawing offset.
|
||||||
</member>
|
</member>
|
||||||
<member name="region_enabled" type="bool" setter="set_region" getter="is_region">
|
<member name="region_enabled" type="bool" setter="set_region" getter="is_region">
|
||||||
If [code]true[/code] texture will be cut from a larger atlas texture. See [code]region_rect[/code]. Default value: [code]false[/code].
|
If [code]true[/code] texture is cut from a larger atlas texture. See [code]region_rect[/code]. Default value: [code]false[/code].
|
||||||
</member>
|
</member>
|
||||||
<member name="region_filter_clip" type="bool" setter="set_region_filter_clip" getter="is_region_filter_clip_enabled">
|
<member name="region_filter_clip" type="bool" setter="set_region_filter_clip" getter="is_region_filter_clip_enabled">
|
||||||
|
If [code]true[/code] the outermost pixels get blurred out.
|
||||||
</member>
|
</member>
|
||||||
<member name="region_rect" type="Rect2" setter="set_region_rect" getter="get_region_rect">
|
<member name="region_rect" type="Rect2" setter="set_region_rect" getter="get_region_rect">
|
||||||
The region of the atlas texture to display. [code]region_enabled[/code] must be [code]true[/code].
|
The region of the atlas texture to display. [member region_enabled] must be [code]true[/code].
|
||||||
</member>
|
</member>
|
||||||
<member name="texture" type="Texture" setter="set_texture" getter="get_texture">
|
<member name="texture" type="Texture" setter="set_texture" getter="get_texture">
|
||||||
[Texture] object to draw.
|
[Texture] object to draw.
|
||||||
</member>
|
</member>
|
||||||
<member name="vframes" type="int" setter="set_vframes" getter="get_vframes">
|
<member name="vframes" type="int" setter="set_vframes" getter="get_vframes">
|
||||||
The number of vertical frames in the sprite sheet.
|
The number of rows in the sprite sheet.
|
||||||
</member>
|
</member>
|
||||||
</members>
|
</members>
|
||||||
<signals>
|
<signals>
|
||||||
<signal name="frame_changed">
|
<signal name="frame_changed">
|
||||||
<description>
|
<description>
|
||||||
Emitted when the [code]frame[/code] changes.
|
Emitted when the [member frame] changes.
|
||||||
</description>
|
</description>
|
||||||
</signal>
|
</signal>
|
||||||
<signal name="texture_changed">
|
<signal name="texture_changed">
|
||||||
<description>
|
<description>
|
||||||
Emitted when the [code]texture[/code] changes.
|
Emitted when the [member texture] changes.
|
||||||
</description>
|
</description>
|
||||||
</signal>
|
</signal>
|
||||||
</signals>
|
</signals>
|
||||||
|
|
|
@ -1,8 +1,10 @@
|
||||||
<?xml version="1.0" encoding="UTF-8" ?>
|
<?xml version="1.0" encoding="UTF-8" ?>
|
||||||
<class name="Sprite3D" inherits="SpriteBase3D" category="Core" version="3.0.alpha.custom_build">
|
<class name="Sprite3D" inherits="SpriteBase3D" category="Core" version="3.0.alpha.custom_build">
|
||||||
<brief_description>
|
<brief_description>
|
||||||
|
2D Sprite node in 3D world.
|
||||||
</brief_description>
|
</brief_description>
|
||||||
<description>
|
<description>
|
||||||
|
A node that displays a 2D texture in a 3D environment. The texture displayed can be a region from a larger atlas texture, or a frame from a sprite sheet animation.
|
||||||
</description>
|
</description>
|
||||||
<tutorials>
|
<tutorials>
|
||||||
</tutorials>
|
</tutorials>
|
||||||
|
@ -96,21 +98,28 @@
|
||||||
</methods>
|
</methods>
|
||||||
<members>
|
<members>
|
||||||
<member name="frame" type="int" setter="set_frame" getter="get_frame">
|
<member name="frame" type="int" setter="set_frame" getter="get_frame">
|
||||||
|
Current frame to display from sprite sheet. [member vframes] or [member hframes] must be greater than 1.
|
||||||
</member>
|
</member>
|
||||||
<member name="hframes" type="int" setter="set_hframes" getter="get_hframes">
|
<member name="hframes" type="int" setter="set_hframes" getter="get_hframes">
|
||||||
|
The number of columns in the sprite sheet.
|
||||||
</member>
|
</member>
|
||||||
<member name="region_enabled" type="bool" setter="set_region" getter="is_region">
|
<member name="region_enabled" type="bool" setter="set_region" getter="is_region">
|
||||||
|
If [code]true[/code] texture will be cut from a larger atlas texture. See [member region_rect]. Default value: [code]false[/code].
|
||||||
</member>
|
</member>
|
||||||
<member name="region_rect" type="Rect2" setter="set_region_rect" getter="get_region_rect">
|
<member name="region_rect" type="Rect2" setter="set_region_rect" getter="get_region_rect">
|
||||||
|
The region of the atlas texture to display. [member region_enabled] must be [code]true[/code].
|
||||||
</member>
|
</member>
|
||||||
<member name="texture" type="Texture" setter="set_texture" getter="get_texture">
|
<member name="texture" type="Texture" setter="set_texture" getter="get_texture">
|
||||||
|
[Texture] object to draw.
|
||||||
</member>
|
</member>
|
||||||
<member name="vframes" type="int" setter="set_vframes" getter="get_vframes">
|
<member name="vframes" type="int" setter="set_vframes" getter="get_vframes">
|
||||||
|
The number of rows in the sprite sheet.
|
||||||
</member>
|
</member>
|
||||||
</members>
|
</members>
|
||||||
<signals>
|
<signals>
|
||||||
<signal name="frame_changed">
|
<signal name="frame_changed">
|
||||||
<description>
|
<description>
|
||||||
|
Emitted when the [member frame] changes.
|
||||||
</description>
|
</description>
|
||||||
</signal>
|
</signal>
|
||||||
</signals>
|
</signals>
|
||||||
|
|
|
@ -1,8 +1,10 @@
|
||||||
<?xml version="1.0" encoding="UTF-8" ?>
|
<?xml version="1.0" encoding="UTF-8" ?>
|
||||||
<class name="SpriteBase3D" inherits="GeometryInstance" category="Core" version="3.0.alpha.custom_build">
|
<class name="SpriteBase3D" inherits="GeometryInstance" category="Core" version="3.0.alpha.custom_build">
|
||||||
<brief_description>
|
<brief_description>
|
||||||
|
2D Sprite node in 3D environment.
|
||||||
</brief_description>
|
</brief_description>
|
||||||
<description>
|
<description>
|
||||||
|
A node that displays 2D texture information in a 3D environment.
|
||||||
</description>
|
</description>
|
||||||
<tutorials>
|
<tutorials>
|
||||||
</tutorials>
|
</tutorials>
|
||||||
|
@ -164,36 +166,51 @@
|
||||||
<member name="alpha_cut" type="int" setter="set_alpha_cut_mode" getter="get_alpha_cut_mode" enum="SpriteBase3D.AlphaCutMode">
|
<member name="alpha_cut" type="int" setter="set_alpha_cut_mode" getter="get_alpha_cut_mode" enum="SpriteBase3D.AlphaCutMode">
|
||||||
</member>
|
</member>
|
||||||
<member name="axis" type="int" setter="set_axis" getter="get_axis" enum="Vector3.Axis">
|
<member name="axis" type="int" setter="set_axis" getter="get_axis" enum="Vector3.Axis">
|
||||||
|
The direction in which the front of the texture faces.
|
||||||
</member>
|
</member>
|
||||||
<member name="centered" type="bool" setter="set_centered" getter="is_centered">
|
<member name="centered" type="bool" setter="set_centered" getter="is_centered">
|
||||||
|
If [code]true[/code] texture will be centered. Default value: [code]true[/code].
|
||||||
</member>
|
</member>
|
||||||
<member name="double_sided" type="bool" setter="set_draw_flag" getter="get_draw_flag">
|
<member name="double_sided" type="bool" setter="set_draw_flag" getter="get_draw_flag">
|
||||||
|
If [code]true[/code] texture can be seen from the back as well, if [code]false[/code], it is invisible when looking at it from behind. Default value: [code]true[/code].
|
||||||
</member>
|
</member>
|
||||||
<member name="flip_h" type="bool" setter="set_flip_h" getter="is_flipped_h">
|
<member name="flip_h" type="bool" setter="set_flip_h" getter="is_flipped_h">
|
||||||
|
If [code]true[/code] texture is flipped horizontally. Default value: [code]false[/code].
|
||||||
</member>
|
</member>
|
||||||
<member name="flip_v" type="bool" setter="set_flip_v" getter="is_flipped_v">
|
<member name="flip_v" type="bool" setter="set_flip_v" getter="is_flipped_v">
|
||||||
|
If [code]true[/code] texture is flipped vertically. Default value: [code]false[/code].
|
||||||
</member>
|
</member>
|
||||||
<member name="modulate" type="Color" setter="set_modulate" getter="get_modulate">
|
<member name="modulate" type="Color" setter="set_modulate" getter="get_modulate">
|
||||||
|
A color value that gets multiplied on, could be used for mood-coloring or to simulate the color of light.
|
||||||
</member>
|
</member>
|
||||||
<member name="offset" type="Vector2" setter="set_offset" getter="get_offset">
|
<member name="offset" type="Vector2" setter="set_offset" getter="get_offset">
|
||||||
|
The texture's drawing offset.
|
||||||
</member>
|
</member>
|
||||||
<member name="opacity" type="float" setter="set_opacity" getter="get_opacity">
|
<member name="opacity" type="float" setter="set_opacity" getter="get_opacity">
|
||||||
|
The objects visibility on a scale from [code]0[/code] fully invisible to [code]1[/code] fully visible.
|
||||||
</member>
|
</member>
|
||||||
<member name="pixel_size" type="float" setter="set_pixel_size" getter="get_pixel_size">
|
<member name="pixel_size" type="float" setter="set_pixel_size" getter="get_pixel_size">
|
||||||
|
The size of one pixel's width on the Sprite to scale it in 3D.
|
||||||
</member>
|
</member>
|
||||||
<member name="shaded" type="bool" setter="set_draw_flag" getter="get_draw_flag">
|
<member name="shaded" type="bool" setter="set_draw_flag" getter="get_draw_flag">
|
||||||
|
If [code]true[/code] the [Light] in the [Environment] has effects on the Sprite. Default value: [code]false[/code].
|
||||||
</member>
|
</member>
|
||||||
<member name="transparent" type="bool" setter="set_draw_flag" getter="get_draw_flag">
|
<member name="transparent" type="bool" setter="set_draw_flag" getter="get_draw_flag">
|
||||||
|
If [code]true[/code] the texture's transparency and the opacity are used to make those parts of the Sprite invisible. Default value: [code]true[/code].
|
||||||
</member>
|
</member>
|
||||||
</members>
|
</members>
|
||||||
<constants>
|
<constants>
|
||||||
<constant name="FLAG_TRANSPARENT" value="0">
|
<constant name="FLAG_TRANSPARENT" value="0">
|
||||||
|
If set, the texture's transparency and the opacity are used to make those parts of the Sprite invisible.
|
||||||
</constant>
|
</constant>
|
||||||
<constant name="FLAG_SHADED" value="1">
|
<constant name="FLAG_SHADED" value="1">
|
||||||
|
If set, the Light in the Environment has effects on the Sprite.
|
||||||
</constant>
|
</constant>
|
||||||
<constant name="FLAG_DOUBLE_SIDED" value="2">
|
<constant name="FLAG_DOUBLE_SIDED" value="2">
|
||||||
|
If set, texture can be seen from the back as well, if not, it is invisible when looking at it from behind.
|
||||||
</constant>
|
</constant>
|
||||||
<constant name="FLAG_MAX" value="3">
|
<constant name="FLAG_MAX" value="3">
|
||||||
|
Used internally to mark the end of the Flags section.
|
||||||
</constant>
|
</constant>
|
||||||
<constant name="ALPHA_CUT_DISABLED" value="0">
|
<constant name="ALPHA_CUT_DISABLED" value="0">
|
||||||
</constant>
|
</constant>
|
||||||
|
|
Loading…
Reference in New Issue