Tutorial de scripts para Unity 3d

Window:



static function Window (id : int, screenRect : Rect, func : GUI.WindowFunction, text : String, : ) : Rect
static function Window (id : int, screenRect : Rect, func : GUI.WindowFunction, image : Texture, : ) : Rect
static function Window (id : int, screenRect : Rect, func : GUI.WindowFunction, content : GUIContent, : ) : Rect
static function Window (id : int, screenRect : Rect, func : GUI.WindowFunction, text : String, style : GUIStyle, : ) : Rect
static function Window (id : int, screenRect : Rect, func : GUI.WindowFunction, image : Texture, style : GUIStyle, : ) : Rect
static function Window (id : int, screenRect : Rect, func : GUI.WindowFunction, content : GUIContent, style : GUIStyle, : ) : Rect


Crea una ventana emergente que distribuye su contenido automáticamente. Las ventanas flotan sobre los controles GUI normales y pueden opcionalmente ser arrastradas por el usuario final. A diferencia de otros controles, necesitas pasarles una función separada a los controles GUI para ponerlos dentro de la ventana.

Devuelve un rect, que es el rectángulo en el que está la ventana y que puede tener una posición y tamaño diferentes que aquélla.


Width:

static function Width (width : float) : GUILayoutOption

Opción pasada a un control para darle una anchura absoluta.

function OnGUI() {
  GUILayout.Button("Botón con una anchura fija", GUILayout.Width(300));
}

MinWidth:

static function MinWidth (minWidth : float) : GUILayoutOption


Opción pasada a un control para especificar una anchura mínima.


MaxWidth:

static function MaxWidth (maxWidth : float) : GUILayoutOption


Opción pasada a un control para especificar una anchura máxima.


Height:

static function Height (height : float) : GUILayoutOption


Opción pasada a un control para darle una altura absoluta.


MinHeight:

static function MinHeight (minHeight : float) : GUILayoutOption


Opción pasada a un control para especificar una altura mínima.


MaxHeight:

static function MaxHeight (maxHeight : float) : GUILayoutOption


Opción pasada a un control para especificar una altura máxima.


ExpandWidth:

static function ExpandWidth (expand : boolean) : GUILayoutOption


Opción pasada a un control para habilitar o deshabilitar la expansión horizontal.


ExpandHeight:

tatic function ExpandHeight (expand : boolean) : GUILayoutOption



Opción pasada a un control para habilitar o deshabilitar la expansión vertical.

Space:

static function Space (pixels : float) : void


Inserta un espacio en el actual grupo de distribución. La dirección de dicho espacio dependerá del la dirección del grupo de distribución en el que estemos trabajando. Si por ejemplo se trata de un grupo vertical, el espacio será vertical.

Observemos la diferencia con dos ejemplos:

function OnGUI () {
  GUILayout.Button ("Primer botón");
  GUILayout.Space (20);
  GUILayout.Button ("Segundo botón");
}

Si ejecutamos este primer script, observaremos dos botones situados uno encima del otro, con un espacio (vertical) entre ambos de 20 píxeles. En cambio, si estuviéramos trabajando con un grupo de distribución horizontal...

function OnGUI () {
  GUILayout.BeginHorizontal();
  GUILayout.Button ("Primer botón");
  GUILayout.Space (20);
  GUILayout.Button ("Segundo botón");
  GUILayout.EndHorizontal();
}

... nos encontraríamos con un botón al lado del otro separados por un espacio (horizontal) de 20 píxeles. (En breve estudiaremos las funciones BeginHorizontal y EndHorizontal, aunque supongo que se intuye su cometido)


FlexibleSpace:

static function FlexibleSpace () : void


Inserta un elemento de espacio flexible. Esta función utiliza cualquier espacio que sobra en un diseño.



BeginHorizontal:

static function BeginHorizontal (params options : GUILayoutOption[]) : void
static function BeginHorizontal (style : GUIStyle, params options : GUILayoutOption[]) : void
static function BeginHorizontal (text : String, style : GUIStyle, params options : GUILayoutOption[]) : void
static function BeginHorizontal (image : Texture, style : GUIStyle, params options : GUILayoutOption[]) : void
static function BeginHorizontal (content : GUIContent, style : GUIStyle, params options : GUILayoutOption[]) : void

Empieza un grupo de controles horizontal. Todos los controles dentro de este elemento serán colocados horizontalmente uno junto a otro. El grupo debe cerrarse con una llamada a EndHorizontal.

EndHorizontal:

static function EndHorizontal () : void


Cierra el grupo abierto por BeginHorizontal.


BeginVertical:

static function BeginVertical (params options : GUILayoutOption[]) : void
static function BeginVertical (style : GUIStyle, params options : GUILayoutOption[]) : void
static function BeginVertical (text : String, style : GUIStyle, params options : GUILayoutOption[]) : void
static function BeginVertical (image : Texture, style : GUIStyle, params options : GUILayoutOption[]) : void
static function BeginVertical (content : GUIContent, style : GUIStyle, params options : GUILayoutOption[]) : void

Empieza un grupo de controles vertical. Todos los controles dentro de este elemento serán situados verticalmente uno debajo del otro. El grupo debe cerrarse con EndVertical


EndVertical:

static function EndVertical () : void


Cierra un grupo iniciado por BeginVertical.


BeginArea:



static function BeginArea (screenRect : Rect) : void
static function BeginArea (screenRect : Rect, text : String) : void
static function BeginArea (screenRect : Rect, image : Texture) : void
static function BeginArea (screenRect : Rect, content : GUIContent) : void
static function BeginArea (screenRect : Rect, style : GUIStyle) : void
static function BeginArea (screenRect : Rect, text : String, style : GUIStyle) : void
static function BeginArea (screenRect : Rect, image : Texture, style : GUIStyle) : void
static function BeginArea (screenRect : Rect, content : GUIContent, style : GUIStyle) : void


Comienza un bloque GUILayout de controles GUI en un determinado área de la pantalla.
Por defecto, cualquier control GUI hecho usando GUILayout es situado en la parte superior izquierda de la pantalla. Si queremos colocar una serie de controles en una zona arbitraria, hemos de usar esta función para definir un nuevo area.

por ejemplo:

function OnGUI () {
  GUILayout.BeginArea (Rect (10,10,100,100));
  GUILayout.Button ("Un botón");
  GUILayout.Button ("Otro botón");
  GUILayout.EndArea ();
}

Aquí iniciamos un área de controles ubicada en las coordenadas 10,10 y con unas dimensiones de 100 X 100.


EndArea:

static function EndArea () : void


Cierra un área de controles abierto con BeginArea.


BeginScrollView:

static function BeginScrollView (scrollPosition : Vector2, params options : GUILayoutOption[]) : Vector2
static function BeginScrollView (scrollPosition : Vector2, alwaysShowHorizontal : boolean, alwaysShowVertical : boolean, params options : GUILayoutOption[]) : Vector2
static function BeginScrollView (scrollPosition : Vector2, horizontalScrollbar : GUIStyle, verticalScrollbar : GUIStyle, params options : GUILayoutOption[]) : Vector2
static function BeginScrollView (scrollPosition : Vector2, style : GUIStyle) : Vector2
static function BeginScrollView (scrollPosition : Vector2, alwaysShowHorizontal : boolean, alwaysShowVertical : boolean, horizontalScrollbar : GUIStyle, verticalScrollbar : GUIStyle, params options : GUILayoutOption[]) : Vector2
static function BeginScrollView (scrollPosition : Vector2, alwaysShowHorizontal : boolean, alwaysShowVertical : boolean, horizontalScrollbar : GUIStyle, verticalScrollbar : GUIStyle, background : GUIStyle, params options : GUILayoutOption[]) : Vector2

Comienza un scrollview (o vista de desplazamiento) automáticamente distribuído. Este puede tomar cualquier contenido que le metas dentro y lo muestra normalmente (sin que se vea el scroll). Si no cabe el contenido, aparece la barra. Una llamada a esta función debe siempre acabar con una llamada a EndScrollView.

Esta función devuelve un Vector2 con la posición del scroll modificada.

Cuenta con los siguientes parámetros:

scrollPosition:      La posición de uso de la pantalla. 
alwayShowHorizontal: Parámetro opcional para enseñar siempre el scrollbar 
                     horizontal. Si está en falso o no se aporta, sólo se mostrará 
                     el scrollbar cuando el contenido dentro del scrollview sea más 
                     ancho que éste. 
alwayShowVertical:   Lo mismo que el anterior para el scrollbar vertical. 
horizontalScrollbar: GUIStyle opcional a usar para el scrollbar horizontal. Si no se 
                     indica, se usará el estilo de horizontalScrollbar del GUISkin 
                     que se esté usando. 
verticalScrollbar    Lo mismo pra el scrollbar vertical.

EndScrollView:

static function EndScrollView () : void


Finaliza un scroll view empezado con una llamada a BeginScrollView.

Toggle:

static function Toggle (value : boolean, image : Texture, params options : GUILayoutOption[]) : boolean
static function Toggle (value : boolean, text : String, params options : GUILayoutOption[]) : boolean
static function Toggle (value : boolean, content : GUIContent, params options : GUILayoutOption[]) : boolean
static function Toggle (value : boolean, image : Texture, style : GUIStyle, params options : GUILayoutOption[]) : boolean
static function Toggle (value : boolean, text : String, style : GUIStyle, params options : GUILayoutOption[]) : boolean
static function Toggle (value : boolean, content : GUIContent, style : GUIStyle, params options : GUILayoutOption[]) : boolean

Crea un botón que alterna on/off. Devuelve un booleano que indica el estado de dicho botón


Toolbar:

static function Toolbar (selected : int, images : Texture[], params options : GUILayoutOption[]) : int
static function Toolbar (selected : int, content : GUIContent[], params options : GUILayoutOption[]) : int
static function Toolbar (selected : int, texts : string[], style : GUIStyle, params options : GUILayoutOption[]) : int
static function Toolbar (selected : int, images : Texture[], style : GUIStyle, params options : GUILayoutOption[]) : int
static function Toolbar (selected : int, contents : GUIContent[], style : GUIStyle, params options : GUILayoutOption[]) : int

Crea un toolbar (barra de herramientas). Devuelve un int que contiene el índice del botón seleccionado.


SelectionGrid:

static function SelectionGrid (selected : int, texts : string[], xCount : int, params options : GUILayoutOption[]) : int
static function SelectionGrid (selected : int, images : Texture[], xCount : int, params options : GUILayoutOption[]) : int
static function SelectionGrid (selected : int, content : GUIContent[], xCount : int, params options : GUILayoutOption[]) : int
static function SelectionGrid (selected : int, texts : string[], xCount : int, style : GUIStyle, params options : GUILayoutOption[]) : int
static function SelectionGrid (selected : int, images : Texture[], xCount : int, style : GUIStyle, params options : GUILayoutOption[]) : int
static function SelectionGrid (selected : int, contents : GUIContent[], xCount : int, style : GUIStyle, params options : GUILayoutOption[]) : int

Crea una cuadrícula de selección, devolviendo el int con el índice del botón seleccionado.


HorizontalSlider:

static function HorizontalSlider (value : float, leftValue : float, rightValue : float, params options : GUILayoutOption[]) : float
static function HorizontalSlider (value : float, leftValue : float, rightValue : float, slider : GUIStyle, thumb : GUIStyle, params options : GUILayoutOption[]) : float

Crea una barra de desplazamiento horizontal que el usuario puede arrastrar desde un mínimo hasta un máximo. Devuelve un float con el valor que ha sido escogido por el usuario.


VerticalSlider:

static function VerticalSlider (value : float, leftValue : float, rightValue : float, params options : GUILayoutOption[]) : float
static function VerticalSlider (value : float, leftValue : float, rightValue : float, slider : GUIStyle, thumb : GUIStyle, params options : GUILayoutOption[]) : float

Crea una barra de desplazamiento vertical que el usuario puede arrastrar desde un mínimo hasta un máximo.


HorizontalScrollbar:

static function HorizontalScrollbar (value : float, size : float, leftValue : float, rightValue : float, params options : GUILayoutOption[]) : float
static function HorizontalScrollbar (value : float, size : float, leftValue : float, rightValue : float, style : GUIStyle, params options : GUILayoutOption[]) : float

Crea un scrollbar horizontal. Devuelve el valor modificado en float, que puede ser cambiado por el usuario arrastrando el scrollbar o haciendo click en las flechas al final.


VerticalScrollbar:

static function VerticalScrollbar (value : float, size : float, topValue : float, bottomValue : float, params options : GUILayoutOption[]) : float
static function VerticalScrollbar (value : float, size : float, topValue : float, bottomValue : float, style : GUIStyle, params options : GUILayoutOption[]) : float

Crea un scrollbar vertical.