CanvasLayer.xml 2.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <class name="CanvasLayer" inherits="Node" version="3.4">
  3. <brief_description>
  4. Canvas drawing layer.
  5. </brief_description>
  6. <description>
  7. Canvas drawing layer. [CanvasItem] nodes that are direct or indirect children of a [CanvasLayer] will be drawn in that layer. The layer is a numeric index that defines the draw order. The default 2D scene renders with index 0, so a [CanvasLayer] with index -1 will be drawn below, and one with index 1 will be drawn above. This is very useful for HUDs (in layer 1+ or above), or backgrounds (in layer -1 or below).
  8. </description>
  9. <tutorials>
  10. <link title="Viewport and canvas transforms">https://docs.godotengine.org/en/3.3/tutorials/2d/2d_transforms.html</link>
  11. <link title="Canvas layers">https://docs.godotengine.org/en/3.3/tutorials/2d/canvas_layers.html</link>
  12. <link title="2D Dodge The Creeps Demo">https://godotengine.org/asset-library/asset/515</link>
  13. </tutorials>
  14. <methods>
  15. <method name="get_canvas" qualifiers="const">
  16. <return type="RID">
  17. </return>
  18. <description>
  19. Returns the RID of the canvas used by this layer.
  20. </description>
  21. </method>
  22. </methods>
  23. <members>
  24. <member name="custom_viewport" type="Node" setter="set_custom_viewport" getter="get_custom_viewport">
  25. The custom [Viewport] node assigned to the [CanvasLayer]. If [code]null[/code], uses the default viewport instead.
  26. </member>
  27. <member name="follow_viewport_enable" type="bool" setter="set_follow_viewport" getter="is_following_viewport" default="false">
  28. Sets the layer to follow the viewport in order to simulate a pseudo 3D effect.
  29. </member>
  30. <member name="follow_viewport_scale" type="float" setter="set_follow_viewport_scale" getter="get_follow_viewport_scale" default="1.0">
  31. Scales the layer when using [member follow_viewport_enable]. Layers moving into the foreground should have increasing scales, while layers moving into the background should have decreasing scales.
  32. </member>
  33. <member name="layer" type="int" setter="set_layer" getter="get_layer" default="1">
  34. Layer index for draw order. Lower values are drawn first.
  35. </member>
  36. <member name="offset" type="Vector2" setter="set_offset" getter="get_offset" default="Vector2( 0, 0 )">
  37. The layer's base offset.
  38. </member>
  39. <member name="rotation" type="float" setter="set_rotation" getter="get_rotation" default="0.0">
  40. The layer's rotation in radians.
  41. </member>
  42. <member name="rotation_degrees" type="float" setter="set_rotation_degrees" getter="get_rotation_degrees" default="0.0">
  43. The layer's rotation in degrees.
  44. </member>
  45. <member name="scale" type="Vector2" setter="set_scale" getter="get_scale" default="Vector2( 1, 1 )">
  46. The layer's scale.
  47. </member>
  48. <member name="transform" type="Transform2D" setter="set_transform" getter="get_transform" default="Transform2D( 1, 0, 0, 1, 0, 0 )">
  49. The layer's transform.
  50. </member>
  51. </members>
  52. <constants>
  53. </constants>
  54. </class>