BackBufferCopy.xml 2.0 KB

123456789101112131415161718192021222324252627282930313233
  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <class name="BackBufferCopy" inherits="Node2D" version="3.6" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
  3. <brief_description>
  4. Copies a region of the screen (or the whole screen) to a buffer so it can be accessed in your shader scripts through the [code]texture(SCREEN_TEXTURE, ...)[/code] function.
  5. </brief_description>
  6. <description>
  7. Node for back-buffering the currently-displayed screen. The region defined in the [BackBufferCopy] node is buffered with the content of the screen it covers, or the entire screen according to the copy mode set. Use the [code]texture(SCREEN_TEXTURE, ...)[/code] function in your shader scripts to access the buffer.
  8. [b]Note:[/b] Since this node inherits from [Node2D] (and not [Control]), anchors and margins won't apply to child [Control]-derived nodes. This can be problematic when resizing the window. To avoid this, add [Control]-derived nodes as [i]siblings[/i] to the [BackBufferCopy] node instead of adding them as children.
  9. </description>
  10. <tutorials>
  11. </tutorials>
  12. <methods>
  13. </methods>
  14. <members>
  15. <member name="copy_mode" type="int" setter="set_copy_mode" getter="get_copy_mode" enum="BackBufferCopy.CopyMode" default="1">
  16. Buffer mode. See [enum CopyMode] constants.
  17. </member>
  18. <member name="rect" type="Rect2" setter="set_rect" getter="get_rect" default="Rect2( -100, -100, 200, 200 )">
  19. The area covered by the [BackBufferCopy]. Only used if [member copy_mode] is [constant COPY_MODE_RECT].
  20. </member>
  21. </members>
  22. <constants>
  23. <constant name="COPY_MODE_DISABLED" value="0" enum="CopyMode">
  24. Disables the buffering mode. This means the [BackBufferCopy] node will directly use the portion of screen it covers.
  25. </constant>
  26. <constant name="COPY_MODE_RECT" value="1" enum="CopyMode">
  27. [BackBufferCopy] buffers a rectangular region.
  28. </constant>
  29. <constant name="COPY_MODE_VIEWPORT" value="2" enum="CopyMode">
  30. [BackBufferCopy] buffers the entire screen.
  31. </constant>
  32. </constants>
  33. </class>