Files
godot-docs/classes/class_imagetexture.rst
2018-10-25 15:18:07 +02:00

133 lines
6.9 KiB
ReStructuredText

.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the ImageTexture.xml source instead.
.. The source is found in doc/classes or modules/<name>/doc_classes.
.. _class_ImageTexture:
ImageTexture
============
**Inherits:** :ref:`Texture<class_Texture>` **<** :ref:`Resource<class_Resource>` **<** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`
**Category:** Core
Brief Description
-----------------
A :ref:`Texture<class_Texture>` based on an :ref:`Image<class_Image>`.
Properties
----------
+-------------------------------------------+--------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`lossy_quality<class_ImageTexture_lossy_quality>` |
+-------------------------------------------+--------------------------------------------------------+
| :ref:`Storage<enum_ImageTexture_Storage>` | :ref:`storage<class_ImageTexture_storage>` |
+-------------------------------------------+--------------------------------------------------------+
Methods
-------
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`create<class_ImageTexture_create>` **(** :ref:`int<class_int>` width, :ref:`int<class_int>` height, :ref:`Format<enum_Image_Format>` format, :ref:`int<class_int>` flags=7 **)** |
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`create_from_image<class_ImageTexture_create_from_image>` **(** :ref:`Image<class_Image>` image, :ref:`int<class_int>` flags=7 **)** |
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Format<enum_Image_Format>` | :ref:`get_format<class_ImageTexture_get_format>` **(** **)** const |
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Error<enum_@GlobalScope_Error>` | :ref:`load<class_ImageTexture_load>` **(** :ref:`String<class_String>` path **)** |
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`set_data<class_ImageTexture_set_data>` **(** :ref:`Image<class_Image>` image **)** |
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`set_size_override<class_ImageTexture_set_size_override>` **(** :ref:`Vector2<class_Vector2>` size **)** |
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Enumerations
------------
.. _enum_ImageTexture_Storage:
enum **Storage**:
- **STORAGE_RAW** = **0** --- :ref:`Image<class_Image>` data is stored raw and unaltered.
- **STORAGE_COMPRESS_LOSSY** = **1** --- :ref:`Image<class_Image>` data is compressed with a lossy algorithm. You can set the storage quality with :ref:`set_lossy_storage_quality<class_ImageTexture_set_lossy_storage_quality>`.
- **STORAGE_COMPRESS_LOSSLESS** = **2** --- :ref:`Image<class_Image>` data is compressed with a lossless algorithm.
Description
-----------
A :ref:`Texture<class_Texture>` based on an :ref:`Image<class_Image>`. Can be created from an :ref:`Image<class_Image>` with :ref:`create_from_image<class_ImageTexture_create_from_image>`.
Property Descriptions
---------------------
.. _class_ImageTexture_lossy_quality:
- :ref:`float<class_float>` **lossy_quality**
+----------+----------------------------------+
| *Setter* | set_lossy_storage_quality(value) |
+----------+----------------------------------+
| *Getter* | get_lossy_storage_quality() |
+----------+----------------------------------+
The storage quality for ``ImageTexture``.STORAGE_COMPRESS_LOSSY.
.. _class_ImageTexture_storage:
- :ref:`Storage<enum_ImageTexture_Storage>` **storage**
+----------+--------------------+
| *Setter* | set_storage(value) |
+----------+--------------------+
| *Getter* | get_storage() |
+----------+--------------------+
The storage type (raw, lossy, or compressed).
Method Descriptions
-------------------
.. _class_ImageTexture_create:
- void **create** **(** :ref:`int<class_int>` width, :ref:`int<class_int>` height, :ref:`Format<enum_Image_Format>` format, :ref:`int<class_int>` flags=7 **)**
Create a new ``ImageTexture`` with "width" and "height".
"format" one of :ref:`Image<class_Image>`.FORMAT\_\*.
"flags" one or more of :ref:`Texture<class_Texture>`.FLAG\_\*.
.. _class_ImageTexture_create_from_image:
- void **create_from_image** **(** :ref:`Image<class_Image>` image, :ref:`int<class_int>` flags=7 **)**
Create a new ``ImageTexture`` from an :ref:`Image<class_Image>` with "flags" from :ref:`Texture<class_Texture>`.FLAG\_\*. An sRGB to linear color space conversion can take place, according to :ref:`Image<class_Image>`.FORMAT\_\*.
.. _class_ImageTexture_get_format:
- :ref:`Format<enum_Image_Format>` **get_format** **(** **)** const
Return the format of the ``ImageTexture``, one of :ref:`Image<class_Image>`.FORMAT\_\*.
.. _class_ImageTexture_load:
- :ref:`Error<enum_@GlobalScope_Error>` **load** **(** :ref:`String<class_String>` path **)**
Load an ``ImageTexture`` from a file path.
.. _class_ImageTexture_set_data:
- void **set_data** **(** :ref:`Image<class_Image>` image **)**
Set the :ref:`Image<class_Image>` of this ``ImageTexture``.
.. _class_ImageTexture_set_size_override:
- void **set_size_override** **(** :ref:`Vector2<class_Vector2>` size **)**
Resizes the ``ImageTexture`` to the specified dimensions.