浏览代码

ImageTexture - document workaround for mipmap generation

lawnjelly 1 年之前
父节点
当前提交
fc78fa7ec5
共有 1 个文件被更改,包括 1 次插入0 次删除
  1. 1 0
      doc/classes/ImageTexture.xml

+ 1 - 0
doc/classes/ImageTexture.xml

@@ -26,6 +26,7 @@
 		[/codeblock]
 		[/codeblock]
 		An [ImageTexture] is not meant to be operated from within the editor interface directly, and is mostly useful for rendering images on screen dynamically via code. If you need to generate images procedurally from within the editor, consider saving and importing images as custom texture resources implementing a new [EditorImportPlugin].
 		An [ImageTexture] is not meant to be operated from within the editor interface directly, and is mostly useful for rendering images on screen dynamically via code. If you need to generate images procedurally from within the editor, consider saving and importing images as custom texture resources implementing a new [EditorImportPlugin].
 		[b]Note:[/b] The maximum texture size is 16384×16384 pixels due to graphics hardware limitations.
 		[b]Note:[/b] The maximum texture size is 16384×16384 pixels due to graphics hardware limitations.
+		[b]Note:[/b] Mipmap generation can fail with some graphics drivers (especially on Android), resulting in black textures. In these cases, consider either calling [method Image.generate_mipmaps], or creating an [ImageTexture] without [constant Texture.FLAG_MIPMAPS].
 	</description>
 	</description>
 	<tutorials>
 	<tutorials>
 		<link title="Importing images">$DOCS_URL/tutorials/assets_pipeline/importing_images.html</link>
 		<link title="Importing images">$DOCS_URL/tutorials/assets_pipeline/importing_images.html</link>