<?xml version="1.0" encoding="UTF-8" ?>
<class name="PortableCompressedTexture2D" inherits="Texture2D" api_type="core" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
	<brief_description>
		Provides a compressed texture for disk and/or VRAM in a way that is portable.
	</brief_description>
	<description>
		This class allows storing compressed textures as self contained (not imported) resources.
		For 2D usage (compressed on disk, uncompressed on VRAM), the lossy and lossless modes are recommended. For 3D usage (compressed on VRAM) it depends on the target platform.
		If you intend to only use desktop, S3TC or BPTC are recommended. For only mobile, ETC2 is recommended.
		For portable, self contained 3D textures that work on both desktop and mobile, Basis Universal is recommended (although it has a small quality cost and longer compression time as a tradeoff).
		This resource is intended to be created from code.
	</description>
	<tutorials>
	</tutorials>
	<methods>
		<method name="create_from_image">
			<return type="void" />
			<param index="0" name="image" type="Image" />
			<param index="1" name="compression_mode" type="int" enum="PortableCompressedTexture2D.CompressionMode" />
			<param index="2" name="normal_map" type="bool" default="false" />
			<param index="3" name="lossy_quality" type="float" default="0.8" />
			<description>
				Initializes the compressed texture from a base image. The compression mode must be provided.
				[param normal_map] is recommended to ensure optimum quality if this image will be used as a normal map.
				If lossy compression is requested, the quality setting can optionally be provided. This maps to Lossy WebP compression quality.
			</description>
		</method>
		<method name="get_compression_mode" qualifiers="const">
			<return type="int" enum="PortableCompressedTexture2D.CompressionMode" />
			<description>
				Return the compression mode used (valid after initialized).
			</description>
		</method>
		<method name="is_keeping_all_compressed_buffers" qualifiers="static">
			<return type="bool" />
			<description>
				Returns [code]true[/code] if the flag is overridden for all textures of this type.
			</description>
		</method>
		<method name="set_basisu_compressor_params">
			<return type="void" />
			<param index="0" name="uastc_level" type="int" />
			<param index="1" name="rdo_quality_loss" type="float" />
			<description>
				Sets the compressor parameters for Basis Universal compression. See also the settings in [ResourceImporterTexture].
				[b]Note:[/b] This method must be called before [method create_from_image] for this to work.
			</description>
		</method>
		<method name="set_keep_all_compressed_buffers" qualifiers="static">
			<return type="void" />
			<param index="0" name="keep" type="bool" />
			<description>
				If [param keep] is [code]true[/code], overrides the flag globally for all textures of this type. This is used primarily by the editor.
			</description>
		</method>
	</methods>
	<members>
		<member name="keep_compressed_buffer" type="bool" setter="set_keep_compressed_buffer" getter="is_keeping_compressed_buffer" default="false">
			If [code]true[/code], when running in the editor, this texture will keep the source-compressed data in memory, allowing the data to persist after loading. Otherwise, the source-compressed data is lost after loading and the texture can't be re-saved.
			[b]Note:[/b] This property must be set before [method create_from_image] for this to work.
		</member>
		<member name="resource_local_to_scene" type="bool" setter="set_local_to_scene" getter="is_local_to_scene" overrides="Resource" default="false" />
		<member name="size_override" type="Vector2" setter="set_size_override" getter="get_size_override" default="Vector2(0, 0)">
			Allows overriding the texture's size (for 2D only).
		</member>
	</members>
	<constants>
		<constant name="COMPRESSION_MODE_LOSSLESS" value="0" enum="CompressionMode">
		</constant>
		<constant name="COMPRESSION_MODE_LOSSY" value="1" enum="CompressionMode">
		</constant>
		<constant name="COMPRESSION_MODE_BASIS_UNIVERSAL" value="2" enum="CompressionMode">
		</constant>
		<constant name="COMPRESSION_MODE_S3TC" value="3" enum="CompressionMode">
		</constant>
		<constant name="COMPRESSION_MODE_ETC2" value="4" enum="CompressionMode">
		</constant>
		<constant name="COMPRESSION_MODE_BPTC" value="5" enum="CompressionMode">
		</constant>
		<constant name="COMPRESSION_MODE_ASTC" value="6" enum="CompressionMode">
		</constant>
	</constants>
</class>
