Legacy Documentation: Version 5.2
LanguageEnglish
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

Gizmos.DrawGUITexture

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Sumbission failed

For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Switch to Manual
public static function DrawGUITexture(screenRect: Rect, texture: Texture, mat: Material = null): void;
public static void DrawGUITexture(Rect screenRect, Texture texture, Material mat = null);
public static function DrawGUITexture(screenRect: Rect, texture: Texture, mat: Material = null): void;
public static void DrawGUITexture(Rect screenRect, Texture texture, Material mat = null);
public static function DrawGUITexture(screenRect: Rect, texture: Texture, leftBorder: int, rightBorder: int, topBorder: int, bottomBorder: int, mat: Material = null): void;
public static void DrawGUITexture(Rect screenRect, Texture texture, int leftBorder, int rightBorder, int topBorder, int bottomBorder, Material mat = null);
public static function DrawGUITexture(screenRect: Rect, texture: Texture, leftBorder: int, rightBorder: int, topBorder: int, bottomBorder: int, mat: Material = null): void;
public static void DrawGUITexture(Rect screenRect, Texture texture, int leftBorder, int rightBorder, int topBorder, int bottomBorder, Material mat = null);

Parameters

screenRect The size and position of the texture on the "screen" defined by the XY plane.
texture The texture to be displayed.
mat An optional material to apply the texture.
leftBorder Inset from the rectangle's left edge.
rightBorder Inset from the rectangle's right edge.
topBorder Inset from the rectangle's top edge.
bottomBorder Inset from the rectangle's bottom edge.

Description

Draw a texture in the scene.

The chosen texture is drawn in 3D space on a "screen" defined by the XY plane (ie, the plane where the Z coordinate is zero). The values of the texture rectangle are given in scene units. The optional border values specify an inset from each edge within the rectangle in scene units; the texture is drawn inside the inset rectangle and the edge pixels are repeated outwards. This is a useful quick way to create a large background region around the main texture when its edges are of a single colour.

This function can be useful for creating GUI backgrounds in conjunction with a camera pointing directly at the texture.

	var myTexture : Texture;

function OnDrawGizmos () { Gizmos.DrawGUITexture(Rect(10, 10, 20, 20), myTexture); }
Copyright © 2023 Unity Technologies
优美缔软件(上海)有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961