texture.h 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644
  1. /*************************************************************************/
  2. /* texture.h */
  3. /*************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /*************************************************************************/
  8. /* Copyright (c) 2007-2020 Juan Linietsky, Ariel Manzur. */
  9. /* Copyright (c) 2014-2020 Godot Engine contributors (cf. AUTHORS.md). */
  10. /* */
  11. /* Permission is hereby granted, free of charge, to any person obtaining */
  12. /* a copy of this software and associated documentation files (the */
  13. /* "Software"), to deal in the Software without restriction, including */
  14. /* without limitation the rights to use, copy, modify, merge, publish, */
  15. /* distribute, sublicense, and/or sell copies of the Software, and to */
  16. /* permit persons to whom the Software is furnished to do so, subject to */
  17. /* the following conditions: */
  18. /* */
  19. /* The above copyright notice and this permission notice shall be */
  20. /* included in all copies or substantial portions of the Software. */
  21. /* */
  22. /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
  23. /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
  24. /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
  25. /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
  26. /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
  27. /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
  28. /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
  29. /*************************************************************************/
  30. #ifndef TEXTURE_H
  31. #define TEXTURE_H
  32. #include "core/io/resource_loader.h"
  33. #include "core/math/rect2.h"
  34. #include "core/os/file_access.h"
  35. #include "core/os/mutex.h"
  36. #include "core/os/rw_lock.h"
  37. #include "core/os/thread_safe.h"
  38. #include "core/resource.h"
  39. #include "scene/resources/curve.h"
  40. #include "scene/resources/gradient.h"
  41. #include "servers/camera_server.h"
  42. #include "servers/visual_server.h"
  43. class Texture : public Resource {
  44. GDCLASS(Texture, Resource);
  45. public:
  46. Texture() {}
  47. };
  48. class Texture2D : public Texture {
  49. GDCLASS(Texture2D, Texture);
  50. OBJ_SAVE_TYPE(Texture2D); // Saves derived classes with common type so they can be interchanged.
  51. protected:
  52. static void _bind_methods();
  53. public:
  54. virtual int get_width() const = 0;
  55. virtual int get_height() const = 0;
  56. virtual Size2 get_size() const;
  57. virtual RID get_rid() const = 0;
  58. virtual bool is_pixel_opaque(int p_x, int p_y) const;
  59. virtual bool has_alpha() const = 0;
  60. virtual void draw(RID p_canvas_item, const Point2 &p_pos, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT) const;
  61. virtual void draw_rect(RID p_canvas_item, const Rect2 &p_rect, bool p_tile = false, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT) const;
  62. virtual void draw_rect_region(RID p_canvas_item, const Rect2 &p_rect, const Rect2 &p_src_rect, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT, bool p_clip_uv = true) const;
  63. virtual bool get_rect_region(const Rect2 &p_rect, const Rect2 &p_src_rect, Rect2 &r_rect, Rect2 &r_src_rect) const;
  64. virtual Ref<Image> get_data() const { return Ref<Image>(); }
  65. Texture2D();
  66. };
  67. class BitMap;
  68. class ImageTexture : public Texture2D {
  69. GDCLASS(ImageTexture, Texture2D);
  70. RES_BASE_EXTENSION("tex");
  71. mutable RID texture;
  72. Image::Format format;
  73. bool mipmaps;
  74. int w, h;
  75. Size2 size_override;
  76. mutable Ref<BitMap> alpha_cache;
  77. bool image_stored;
  78. protected:
  79. virtual void reload_from_file();
  80. bool _set(const StringName &p_name, const Variant &p_value);
  81. bool _get(const StringName &p_name, Variant &r_ret) const;
  82. void _get_property_list(List<PropertyInfo> *p_list) const;
  83. void _reload_hook(const RID &p_hook);
  84. virtual void _resource_path_changed();
  85. static void _bind_methods();
  86. public:
  87. void create_from_image(const Ref<Image> &p_image);
  88. Image::Format get_format() const;
  89. void update(const Ref<Image> &p_image, bool p_immediate = false);
  90. Ref<Image> get_data() const;
  91. int get_width() const;
  92. int get_height() const;
  93. virtual RID get_rid() const;
  94. bool has_alpha() const;
  95. virtual void draw(RID p_canvas_item, const Point2 &p_pos, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT) const;
  96. virtual void draw_rect(RID p_canvas_item, const Rect2 &p_rect, bool p_tile = false, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT) const;
  97. virtual void draw_rect_region(RID p_canvas_item, const Rect2 &p_rect, const Rect2 &p_src_rect, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT, bool p_clip_uv = true) const;
  98. bool is_pixel_opaque(int p_x, int p_y) const;
  99. void set_size_override(const Size2 &p_size);
  100. virtual void set_path(const String &p_path, bool p_take_over = false);
  101. ImageTexture();
  102. ~ImageTexture();
  103. };
  104. class StreamTexture : public Texture2D {
  105. GDCLASS(StreamTexture, Texture2D);
  106. public:
  107. enum DataFormat {
  108. DATA_FORMAT_IMAGE,
  109. DATA_FORMAT_LOSSLESS,
  110. DATA_FORMAT_LOSSY,
  111. DATA_FORMAT_BASIS_UNIVERSAL,
  112. };
  113. enum {
  114. FORMAT_VERSION = 1
  115. };
  116. enum FormatBits {
  117. FORMAT_MASK_IMAGE_FORMAT = (1 << 20) - 1,
  118. FORMAT_BIT_LOSSLESS = 1 << 20,
  119. FORMAT_BIT_LOSSY = 1 << 21,
  120. FORMAT_BIT_STREAM = 1 << 22,
  121. FORMAT_BIT_HAS_MIPMAPS = 1 << 23,
  122. FORMAT_BIT_DETECT_3D = 1 << 24,
  123. //FORMAT_BIT_DETECT_SRGB = 1 << 25,
  124. FORMAT_BIT_DETECT_NORMAL = 1 << 26,
  125. FORMAT_BIT_DETECT_ROUGNESS = 1 << 27,
  126. };
  127. private:
  128. Error _load_data(const String &p_path, int &tw, int &th, int &tw_custom, int &th_custom, Ref<Image> &image, bool &r_request_3d, bool &r_request_normal, bool &r_request_roughness, int &mipmap_limit, int p_size_limit = 0);
  129. String path_to_file;
  130. mutable RID texture;
  131. Image::Format format;
  132. int w, h;
  133. mutable Ref<BitMap> alpha_cache;
  134. virtual void reload_from_file();
  135. static void _requested_3d(void *p_ud);
  136. static void _requested_roughness(void *p_ud, const String &p_normal_path, VS::TextureDetectRoughnessChannel p_roughness_channel);
  137. static void _requested_normal(void *p_ud);
  138. protected:
  139. static void _bind_methods();
  140. void _validate_property(PropertyInfo &property) const;
  141. public:
  142. static Ref<Image> load_image_from_file(FileAccess *p_file, int p_size_limit);
  143. typedef void (*TextureFormatRequestCallback)(const Ref<StreamTexture> &);
  144. typedef void (*TextureFormatRoughnessRequestCallback)(const Ref<StreamTexture> &, const String &p_normal_path, VS::TextureDetectRoughnessChannel p_roughness_channel);
  145. static TextureFormatRequestCallback request_3d_callback;
  146. static TextureFormatRoughnessRequestCallback request_roughness_callback;
  147. static TextureFormatRequestCallback request_normal_callback;
  148. Image::Format get_format() const;
  149. Error load(const String &p_path);
  150. String get_load_path() const;
  151. int get_width() const;
  152. int get_height() const;
  153. virtual RID get_rid() const;
  154. virtual void set_path(const String &p_path, bool p_take_over);
  155. virtual void draw(RID p_canvas_item, const Point2 &p_pos, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT) const;
  156. virtual void draw_rect(RID p_canvas_item, const Rect2 &p_rect, bool p_tile = false, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT) const;
  157. virtual void draw_rect_region(RID p_canvas_item, const Rect2 &p_rect, const Rect2 &p_src_rect, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT, bool p_clip_uv = true) const;
  158. virtual bool has_alpha() const;
  159. bool is_pixel_opaque(int p_x, int p_y) const;
  160. virtual Ref<Image> get_data() const;
  161. StreamTexture();
  162. ~StreamTexture();
  163. };
  164. class ResourceFormatLoaderStreamTexture : public ResourceFormatLoader {
  165. public:
  166. virtual RES load(const String &p_path, const String &p_original_path = "", Error *r_error = NULL, bool p_use_sub_threads = false, float *r_progress = nullptr);
  167. virtual void get_recognized_extensions(List<String> *p_extensions) const;
  168. virtual bool handles_type(const String &p_type) const;
  169. virtual String get_resource_type(const String &p_path) const;
  170. };
  171. class AtlasTexture : public Texture2D {
  172. GDCLASS(AtlasTexture, Texture2D);
  173. RES_BASE_EXTENSION("atlastex");
  174. protected:
  175. Ref<Texture2D> atlas;
  176. Rect2 region;
  177. Rect2 margin;
  178. bool filter_clip;
  179. static void _bind_methods();
  180. public:
  181. virtual int get_width() const;
  182. virtual int get_height() const;
  183. virtual RID get_rid() const;
  184. virtual bool has_alpha() const;
  185. void set_atlas(const Ref<Texture2D> &p_atlas);
  186. Ref<Texture2D> get_atlas() const;
  187. void set_region(const Rect2 &p_region);
  188. Rect2 get_region() const;
  189. void set_margin(const Rect2 &p_margin);
  190. Rect2 get_margin() const;
  191. void set_filter_clip(const bool p_enable);
  192. bool has_filter_clip() const;
  193. virtual void draw(RID p_canvas_item, const Point2 &p_pos, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT) const;
  194. virtual void draw_rect(RID p_canvas_item, const Rect2 &p_rect, bool p_tile = false, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT) const;
  195. virtual void draw_rect_region(RID p_canvas_item, const Rect2 &p_rect, const Rect2 &p_src_rect, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT, bool p_clip_uv = true) const;
  196. virtual bool get_rect_region(const Rect2 &p_rect, const Rect2 &p_src_rect, Rect2 &r_rect, Rect2 &r_src_rect) const;
  197. bool is_pixel_opaque(int p_x, int p_y) const;
  198. AtlasTexture();
  199. };
  200. class Mesh;
  201. class MeshTexture : public Texture2D {
  202. GDCLASS(MeshTexture, Texture2D);
  203. RES_BASE_EXTENSION("meshtex");
  204. Ref<Texture2D> base_texture;
  205. Ref<Mesh> mesh;
  206. Size2i size;
  207. protected:
  208. static void _bind_methods();
  209. public:
  210. virtual int get_width() const;
  211. virtual int get_height() const;
  212. virtual RID get_rid() const;
  213. virtual bool has_alpha() const;
  214. void set_mesh(const Ref<Mesh> &p_mesh);
  215. Ref<Mesh> get_mesh() const;
  216. void set_image_size(const Size2 &p_size);
  217. Size2 get_image_size() const;
  218. void set_base_texture(const Ref<Texture2D> &p_texture);
  219. Ref<Texture2D> get_base_texture() const;
  220. virtual void draw(RID p_canvas_item, const Point2 &p_pos, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT) const;
  221. virtual void draw_rect(RID p_canvas_item, const Rect2 &p_rect, bool p_tile = false, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT) const;
  222. virtual void draw_rect_region(RID p_canvas_item, const Rect2 &p_rect, const Rect2 &p_src_rect, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT, bool p_clip_uv = true) const;
  223. virtual bool get_rect_region(const Rect2 &p_rect, const Rect2 &p_src_rect, Rect2 &r_rect, Rect2 &r_src_rect) const;
  224. bool is_pixel_opaque(int p_x, int p_y) const;
  225. MeshTexture();
  226. };
  227. class LargeTexture : public Texture2D {
  228. GDCLASS(LargeTexture, Texture2D);
  229. RES_BASE_EXTENSION("largetex");
  230. protected:
  231. struct Piece {
  232. Point2 offset;
  233. Ref<Texture2D> texture;
  234. };
  235. Vector<Piece> pieces;
  236. Size2i size;
  237. Array _get_data() const;
  238. void _set_data(const Array &p_array);
  239. static void _bind_methods();
  240. public:
  241. virtual int get_width() const;
  242. virtual int get_height() const;
  243. virtual RID get_rid() const;
  244. virtual bool has_alpha() const;
  245. int add_piece(const Point2 &p_offset, const Ref<Texture2D> &p_texture);
  246. void set_piece_offset(int p_idx, const Point2 &p_offset);
  247. void set_piece_texture(int p_idx, const Ref<Texture2D> &p_texture);
  248. void set_size(const Size2 &p_size);
  249. void clear();
  250. int get_piece_count() const;
  251. Vector2 get_piece_offset(int p_idx) const;
  252. Ref<Texture2D> get_piece_texture(int p_idx) const;
  253. Ref<Image> to_image() const;
  254. virtual void draw(RID p_canvas_item, const Point2 &p_pos, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT) const;
  255. virtual void draw_rect(RID p_canvas_item, const Rect2 &p_rect, bool p_tile = false, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT) const;
  256. virtual void draw_rect_region(RID p_canvas_item, const Rect2 &p_rect, const Rect2 &p_src_rect, const Color &p_modulate = Color(1, 1, 1), bool p_transpose = false, const Ref<Texture2D> &p_normal_map = Ref<Texture2D>(), const Ref<Texture2D> &p_specular_map = Ref<Texture2D>(), const Color &p_specular_color_shininess = Color(1, 1, 1, 1), VS::CanvasItemTextureFilter p_texture_filter = VS::CANVAS_ITEM_TEXTURE_FILTER_DEFAULT, VS::CanvasItemTextureRepeat p_texture_repeat = VS::CANVAS_ITEM_TEXTURE_REPEAT_DEFAULT, bool p_clip_uv = true) const;
  257. bool is_pixel_opaque(int p_x, int p_y) const;
  258. LargeTexture();
  259. };
  260. class TextureLayered : public Texture {
  261. GDCLASS(TextureLayered, Texture);
  262. VS::TextureLayeredType layered_type;
  263. mutable RID texture;
  264. Image::Format format;
  265. int width;
  266. int height;
  267. int layers;
  268. bool mipmaps;
  269. Error _create_from_images(const Array &p_images);
  270. Array _get_images() const;
  271. protected:
  272. static void _bind_methods();
  273. public:
  274. Image::Format get_format() const;
  275. uint32_t get_width() const;
  276. uint32_t get_height() const;
  277. uint32_t get_layers() const;
  278. bool has_mipmaps() const;
  279. Error create_from_images(Vector<Ref<Image> > p_images);
  280. void update_layer(const Ref<Image> &p_image, int p_layer);
  281. Ref<Image> get_layer_data(int p_layer) const;
  282. virtual RID get_rid() const;
  283. virtual void set_path(const String &p_path, bool p_take_over = false);
  284. TextureLayered(VS::TextureLayeredType p_layered_type);
  285. ~TextureLayered();
  286. };
  287. class Texture2DArray : public TextureLayered {
  288. GDCLASS(Texture2DArray, TextureLayered)
  289. public:
  290. Texture2DArray() :
  291. TextureLayered(VS::TEXTURE_LAYERED_2D_ARRAY) {}
  292. };
  293. class Cubemap : public TextureLayered {
  294. GDCLASS(Cubemap, TextureLayered);
  295. public:
  296. Cubemap() :
  297. TextureLayered(VS::TEXTURE_LAYERED_CUBEMAP) {}
  298. };
  299. class CubemapArray : public TextureLayered {
  300. GDCLASS(CubemapArray, TextureLayered);
  301. public:
  302. CubemapArray() :
  303. TextureLayered(VS::TEXTURE_LAYERED_CUBEMAP_ARRAY) {}
  304. };
  305. class ResourceFormatLoaderTextureLayered : public ResourceFormatLoader {
  306. public:
  307. enum Compression {
  308. COMPRESSION_LOSSLESS,
  309. COMPRESSION_VRAM,
  310. COMPRESSION_UNCOMPRESSED
  311. };
  312. virtual RES load(const String &p_path, const String &p_original_path = "", Error *r_error = NULL, bool p_use_sub_threads = false, float *r_progress = nullptr);
  313. virtual void get_recognized_extensions(List<String> *p_extensions) const;
  314. virtual bool handles_type(const String &p_type) const;
  315. virtual String get_resource_type(const String &p_path) const;
  316. };
  317. class CurveTexture : public Texture2D {
  318. GDCLASS(CurveTexture, Texture2D);
  319. RES_BASE_EXTENSION("curvetex")
  320. private:
  321. mutable RID _texture;
  322. Ref<Curve> _curve;
  323. int _width;
  324. void _update();
  325. protected:
  326. static void _bind_methods();
  327. public:
  328. void set_width(int p_width);
  329. int get_width() const;
  330. void ensure_default_setup(float p_min = 0, float p_max = 1);
  331. void set_curve(Ref<Curve> p_curve);
  332. Ref<Curve> get_curve() const;
  333. virtual RID get_rid() const;
  334. virtual int get_height() const { return 1; }
  335. virtual bool has_alpha() const { return false; }
  336. CurveTexture();
  337. ~CurveTexture();
  338. };
  339. /*
  340. enum CubeMapSide {
  341. CUBEMAP_LEFT,
  342. CUBEMAP_RIGHT,
  343. CUBEMAP_BOTTOM,
  344. CUBEMAP_TOP,
  345. CUBEMAP_FRONT,
  346. CUBEMAP_BACK,
  347. };
  348. */
  349. //VARIANT_ENUM_CAST( Texture::CubeMapSide );
  350. class GradientTexture : public Texture2D {
  351. GDCLASS(GradientTexture, Texture2D);
  352. public:
  353. struct Point {
  354. float offset;
  355. Color color;
  356. bool operator<(const Point &p_ponit) const {
  357. return offset < p_ponit.offset;
  358. }
  359. };
  360. private:
  361. Ref<Gradient> gradient;
  362. bool update_pending;
  363. RID texture;
  364. int width;
  365. void _queue_update();
  366. void _update();
  367. protected:
  368. static void _bind_methods();
  369. public:
  370. void set_gradient(Ref<Gradient> p_gradient);
  371. Ref<Gradient> get_gradient() const;
  372. void set_width(int p_width);
  373. int get_width() const;
  374. virtual RID get_rid() const { return texture; }
  375. virtual int get_height() const { return 1; }
  376. virtual bool has_alpha() const { return true; }
  377. virtual Ref<Image> get_data() const;
  378. GradientTexture();
  379. virtual ~GradientTexture();
  380. };
  381. class ProxyTexture : public Texture2D {
  382. GDCLASS(ProxyTexture, Texture2D);
  383. private:
  384. mutable RID proxy_ph;
  385. mutable RID proxy;
  386. Ref<Texture2D> base;
  387. protected:
  388. static void _bind_methods();
  389. public:
  390. void set_base(const Ref<Texture2D> &p_texture);
  391. Ref<Texture2D> get_base() const;
  392. virtual int get_width() const;
  393. virtual int get_height() const;
  394. virtual RID get_rid() const;
  395. virtual bool has_alpha() const;
  396. ProxyTexture();
  397. ~ProxyTexture();
  398. };
  399. class AnimatedTexture : public Texture2D {
  400. GDCLASS(AnimatedTexture, Texture2D);
  401. //use readers writers lock for this, since its far more times read than written to
  402. RWLock *rw_lock;
  403. private:
  404. enum {
  405. MAX_FRAMES = 256
  406. };
  407. RID proxy_ph;
  408. RID proxy;
  409. struct Frame {
  410. Ref<Texture2D> texture;
  411. float delay_sec;
  412. Frame() {
  413. delay_sec = 0;
  414. }
  415. };
  416. Frame frames[MAX_FRAMES];
  417. int frame_count;
  418. int current_frame;
  419. float fps;
  420. float time;
  421. uint64_t prev_ticks;
  422. void _update_proxy();
  423. protected:
  424. static void _bind_methods();
  425. void _validate_property(PropertyInfo &property) const;
  426. public:
  427. void set_frames(int p_frames);
  428. int get_frames() const;
  429. void set_frame_texture(int p_frame, const Ref<Texture2D> &p_texture);
  430. Ref<Texture2D> get_frame_texture(int p_frame) const;
  431. void set_frame_delay(int p_frame, float p_delay_sec);
  432. float get_frame_delay(int p_frame) const;
  433. void set_fps(float p_fps);
  434. float get_fps() const;
  435. virtual int get_width() const;
  436. virtual int get_height() const;
  437. virtual RID get_rid() const;
  438. virtual bool has_alpha() const;
  439. virtual Ref<Image> get_data() const;
  440. bool is_pixel_opaque(int p_x, int p_y) const;
  441. AnimatedTexture();
  442. ~AnimatedTexture();
  443. };
  444. class CameraTexture : public Texture2D {
  445. GDCLASS(CameraTexture, Texture2D);
  446. private:
  447. int camera_feed_id;
  448. CameraServer::FeedImage which_feed;
  449. protected:
  450. static void _bind_methods();
  451. public:
  452. virtual int get_width() const;
  453. virtual int get_height() const;
  454. virtual RID get_rid() const;
  455. virtual bool has_alpha() const;
  456. virtual void set_flags(uint32_t p_flags);
  457. virtual uint32_t get_flags() const;
  458. virtual Ref<Image> get_data() const;
  459. void set_camera_feed_id(int p_new_id);
  460. int get_camera_feed_id() const;
  461. void set_which_feed(CameraServer::FeedImage p_which);
  462. CameraServer::FeedImage get_which_feed() const;
  463. void set_camera_active(bool p_active);
  464. bool get_camera_active() const;
  465. CameraTexture();
  466. ~CameraTexture();
  467. };
  468. #endif