class_texture2d.rst 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112
  1. :github_url: hide
  2. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  3. .. DO NOT EDIT THIS FILE, but the Texture2D.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_Texture2D:
  6. Texture2D
  7. =========
  8. **Inherits:** :ref:`Texture<class_Texture>` **<** :ref:`Resource<class_Resource>` **<** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`
  9. **Inherited By:** :ref:`AnimatedTexture<class_AnimatedTexture>`, :ref:`AtlasTexture<class_AtlasTexture>`, :ref:`CameraTexture<class_CameraTexture>`, :ref:`CurveTexture<class_CurveTexture>`, :ref:`GradientTexture<class_GradientTexture>`, :ref:`ImageTexture<class_ImageTexture>`, :ref:`LargeTexture<class_LargeTexture>`, :ref:`MeshTexture<class_MeshTexture>`, :ref:`NoiseTexture<class_NoiseTexture>`, :ref:`ProxyTexture<class_ProxyTexture>`, :ref:`StreamTexture<class_StreamTexture>`, :ref:`ViewportTexture<class_ViewportTexture>`
  10. Texture for 2D and 3D.
  11. Description
  12. -----------
  13. A texture works by registering an image in the video hardware, which then can be used in 3D models or 2D :ref:`Sprite<class_Sprite>` or GUI :ref:`Control<class_Control>`.
  14. Textures are often created by loading them from a file. See :ref:`@GDScript.load<class_@GDScript_method_load>`.
  15. ``Texture2D`` is a base for other resources. It cannot be used directly.
  16. Methods
  17. -------
  18. +-------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  19. | void | :ref:`draw<class_Texture2D_method_draw>` **(** :ref:`RID<class_RID>` canvas_item, :ref:`Vector2<class_Vector2>` position, :ref:`Color<class_Color>` modulate=Color( 1, 1, 1, 1 ), :ref:`bool<class_bool>` transpose=false, :ref:`Texture2D<class_Texture2D>` normal_map=null, :ref:`Texture2D<class_Texture2D>` specular_map=null, :ref:`Color<class_Color>` specular_color_shininess=Color( 1, 1, 1, 1 ), :ref:`CanvasItemTextureFilter<enum_VisualServer_CanvasItemTextureFilter>` texture_filter=0, :ref:`CanvasItemTextureRepeat<enum_VisualServer_CanvasItemTextureRepeat>` texture_repeat=0 **)** const |
  20. +-------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  21. | void | :ref:`draw_rect<class_Texture2D_method_draw_rect>` **(** :ref:`RID<class_RID>` canvas_item, :ref:`Rect2<class_Rect2>` rect, :ref:`bool<class_bool>` tile, :ref:`Color<class_Color>` modulate=Color( 1, 1, 1, 1 ), :ref:`bool<class_bool>` transpose=false, :ref:`Texture2D<class_Texture2D>` normal_map=null, :ref:`Texture2D<class_Texture2D>` specular_map=null, :ref:`Color<class_Color>` specular_color_shininess=Color( 1, 1, 1, 1 ), :ref:`CanvasItemTextureFilter<enum_VisualServer_CanvasItemTextureFilter>` texture_filter=0, :ref:`CanvasItemTextureRepeat<enum_VisualServer_CanvasItemTextureRepeat>` texture_repeat=0 **)** const |
  22. +-------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  23. | void | :ref:`draw_rect_region<class_Texture2D_method_draw_rect_region>` **(** :ref:`RID<class_RID>` canvas_item, :ref:`Rect2<class_Rect2>` rect, :ref:`Rect2<class_Rect2>` src_rect, :ref:`Color<class_Color>` modulate=Color( 1, 1, 1, 1 ), :ref:`bool<class_bool>` transpose=false, :ref:`Texture2D<class_Texture2D>` normal_map=null, :ref:`Texture2D<class_Texture2D>` specular_map=null, :ref:`Color<class_Color>` specular_color_shininess=Color( 1, 1, 1, 1 ), :ref:`CanvasItemTextureFilter<enum_VisualServer_CanvasItemTextureFilter>` texture_filter=0, :ref:`CanvasItemTextureRepeat<enum_VisualServer_CanvasItemTextureRepeat>` texture_repeat=0, :ref:`bool<class_bool>` clip_uv=true **)** const |
  24. +-------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  25. | :ref:`Image<class_Image>` | :ref:`get_data<class_Texture2D_method_get_data>` **(** **)** const |
  26. +-------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  27. | :ref:`int<class_int>` | :ref:`get_height<class_Texture2D_method_get_height>` **(** **)** const |
  28. +-------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  29. | :ref:`Vector2<class_Vector2>` | :ref:`get_size<class_Texture2D_method_get_size>` **(** **)** const |
  30. +-------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  31. | :ref:`int<class_int>` | :ref:`get_width<class_Texture2D_method_get_width>` **(** **)** const |
  32. +-------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  33. | :ref:`bool<class_bool>` | :ref:`has_alpha<class_Texture2D_method_has_alpha>` **(** **)** const |
  34. +-------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  35. Method Descriptions
  36. -------------------
  37. .. _class_Texture2D_method_draw:
  38. - void **draw** **(** :ref:`RID<class_RID>` canvas_item, :ref:`Vector2<class_Vector2>` position, :ref:`Color<class_Color>` modulate=Color( 1, 1, 1, 1 ), :ref:`bool<class_bool>` transpose=false, :ref:`Texture2D<class_Texture2D>` normal_map=null, :ref:`Texture2D<class_Texture2D>` specular_map=null, :ref:`Color<class_Color>` specular_color_shininess=Color( 1, 1, 1, 1 ), :ref:`CanvasItemTextureFilter<enum_VisualServer_CanvasItemTextureFilter>` texture_filter=0, :ref:`CanvasItemTextureRepeat<enum_VisualServer_CanvasItemTextureRepeat>` texture_repeat=0 **)** const
  39. Draws the texture using a :ref:`CanvasItem<class_CanvasItem>` with the :ref:`VisualServer<class_VisualServer>` API at the specified ``position``.
  40. ----
  41. .. _class_Texture2D_method_draw_rect:
  42. - void **draw_rect** **(** :ref:`RID<class_RID>` canvas_item, :ref:`Rect2<class_Rect2>` rect, :ref:`bool<class_bool>` tile, :ref:`Color<class_Color>` modulate=Color( 1, 1, 1, 1 ), :ref:`bool<class_bool>` transpose=false, :ref:`Texture2D<class_Texture2D>` normal_map=null, :ref:`Texture2D<class_Texture2D>` specular_map=null, :ref:`Color<class_Color>` specular_color_shininess=Color( 1, 1, 1, 1 ), :ref:`CanvasItemTextureFilter<enum_VisualServer_CanvasItemTextureFilter>` texture_filter=0, :ref:`CanvasItemTextureRepeat<enum_VisualServer_CanvasItemTextureRepeat>` texture_repeat=0 **)** const
  43. Draws the texture using a :ref:`CanvasItem<class_CanvasItem>` with the :ref:`VisualServer<class_VisualServer>` API.
  44. ----
  45. .. _class_Texture2D_method_draw_rect_region:
  46. - void **draw_rect_region** **(** :ref:`RID<class_RID>` canvas_item, :ref:`Rect2<class_Rect2>` rect, :ref:`Rect2<class_Rect2>` src_rect, :ref:`Color<class_Color>` modulate=Color( 1, 1, 1, 1 ), :ref:`bool<class_bool>` transpose=false, :ref:`Texture2D<class_Texture2D>` normal_map=null, :ref:`Texture2D<class_Texture2D>` specular_map=null, :ref:`Color<class_Color>` specular_color_shininess=Color( 1, 1, 1, 1 ), :ref:`CanvasItemTextureFilter<enum_VisualServer_CanvasItemTextureFilter>` texture_filter=0, :ref:`CanvasItemTextureRepeat<enum_VisualServer_CanvasItemTextureRepeat>` texture_repeat=0, :ref:`bool<class_bool>` clip_uv=true **)** const
  47. Draws a part of the texture using a :ref:`CanvasItem<class_CanvasItem>` with the :ref:`VisualServer<class_VisualServer>` API.
  48. ----
  49. .. _class_Texture2D_method_get_data:
  50. - :ref:`Image<class_Image>` **get_data** **(** **)** const
  51. Returns an :ref:`Image<class_Image>` with the data from this ``Texture2D``. :ref:`Image<class_Image>`\ s can be accessed and manipulated directly.
  52. ----
  53. .. _class_Texture2D_method_get_height:
  54. - :ref:`int<class_int>` **get_height** **(** **)** const
  55. Returns the texture height.
  56. ----
  57. .. _class_Texture2D_method_get_size:
  58. - :ref:`Vector2<class_Vector2>` **get_size** **(** **)** const
  59. Returns the texture size.
  60. ----
  61. .. _class_Texture2D_method_get_width:
  62. - :ref:`int<class_int>` **get_width** **(** **)** const
  63. Returns the texture width.
  64. ----
  65. .. _class_Texture2D_method_has_alpha:
  66. - :ref:`bool<class_bool>` **has_alpha** **(** **)** const
  67. Returns ``true`` if this ``Texture2D`` has an alpha channel.