2
0

class_bitmap.rst 6.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117
  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 BitMap.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_BitMap:
  6. BitMap
  7. ======
  8. **Inherits:** :ref:`Resource<class_Resource>` **<** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`
  9. **Category:** Core
  10. Brief Description
  11. -----------------
  12. Boolean matrix.
  13. Methods
  14. -------
  15. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  16. | void | :ref:`create<class_BitMap_method_create>` **(** :ref:`Vector2<class_Vector2>` size **)** |
  17. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  18. | void | :ref:`create_from_image_alpha<class_BitMap_method_create_from_image_alpha>` **(** :ref:`Image<class_Image>` image, :ref:`float<class_float>` threshold=0.1 **)** |
  19. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  20. | :ref:`bool<class_bool>` | :ref:`get_bit<class_BitMap_method_get_bit>` **(** :ref:`Vector2<class_Vector2>` position **)** const |
  21. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  22. | :ref:`Vector2<class_Vector2>` | :ref:`get_size<class_BitMap_method_get_size>` **(** **)** const |
  23. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  24. | :ref:`int<class_int>` | :ref:`get_true_bit_count<class_BitMap_method_get_true_bit_count>` **(** **)** const |
  25. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  26. | void | :ref:`grow_mask<class_BitMap_method_grow_mask>` **(** :ref:`int<class_int>` pixels, :ref:`Rect2<class_Rect2>` rect **)** |
  27. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  28. | :ref:`Array<class_Array>` | :ref:`opaque_to_polygons<class_BitMap_method_opaque_to_polygons>` **(** :ref:`Rect2<class_Rect2>` rect, :ref:`float<class_float>` epsilon=2.0 **)** const |
  29. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  30. | void | :ref:`set_bit<class_BitMap_method_set_bit>` **(** :ref:`Vector2<class_Vector2>` position, :ref:`bool<class_bool>` bit **)** |
  31. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  32. | void | :ref:`set_bit_rect<class_BitMap_method_set_bit_rect>` **(** :ref:`Rect2<class_Rect2>` rect, :ref:`bool<class_bool>` bit **)** |
  33. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  34. Description
  35. -----------
  36. A two-dimensional array of boolean values, can be used to efficiently store a binary matrix (every matrix element takes only one bit) and query the values using natural cartesian coordinates.
  37. Method Descriptions
  38. -------------------
  39. .. _class_BitMap_method_create:
  40. - void **create** **(** :ref:`Vector2<class_Vector2>` size **)**
  41. Creates a bitmap with the specified size, filled with ``false``.
  42. ----
  43. .. _class_BitMap_method_create_from_image_alpha:
  44. - void **create_from_image_alpha** **(** :ref:`Image<class_Image>` image, :ref:`float<class_float>` threshold=0.1 **)**
  45. Creates a bitmap that matches the given image dimensions, every element of the bitmap is set to ``false`` if the alpha value of the image at that position is equal to ``threshold`` or less, and ``true`` in other case.
  46. ----
  47. .. _class_BitMap_method_get_bit:
  48. - :ref:`bool<class_bool>` **get_bit** **(** :ref:`Vector2<class_Vector2>` position **)** const
  49. Returns bitmap's value at the specified position.
  50. ----
  51. .. _class_BitMap_method_get_size:
  52. - :ref:`Vector2<class_Vector2>` **get_size** **(** **)** const
  53. Returns bitmap's dimensions.
  54. ----
  55. .. _class_BitMap_method_get_true_bit_count:
  56. - :ref:`int<class_int>` **get_true_bit_count** **(** **)** const
  57. Returns the amount of bitmap elements that are set to ``true``.
  58. ----
  59. .. _class_BitMap_method_grow_mask:
  60. - void **grow_mask** **(** :ref:`int<class_int>` pixels, :ref:`Rect2<class_Rect2>` rect **)**
  61. ----
  62. .. _class_BitMap_method_opaque_to_polygons:
  63. - :ref:`Array<class_Array>` **opaque_to_polygons** **(** :ref:`Rect2<class_Rect2>` rect, :ref:`float<class_float>` epsilon=2.0 **)** const
  64. ----
  65. .. _class_BitMap_method_set_bit:
  66. - void **set_bit** **(** :ref:`Vector2<class_Vector2>` position, :ref:`bool<class_bool>` bit **)**
  67. Sets the bitmap's element at the specified position, to the specified value.
  68. ----
  69. .. _class_BitMap_method_set_bit_rect:
  70. - void **set_bit_rect** **(** :ref:`Rect2<class_Rect2>` rect, :ref:`bool<class_bool>` bit **)**
  71. Sets a rectangular portion of the bitmap to the specified value.