Importar con use
use actor::Gobi as gobi : Spatial2D1 · Un actor de la escenause actor:: trae un actor de tu escena. Gobi es su nombre en la escena, gobi el nombre con el que lo usas en el código y Spatial2D su tipo.
fn _ready() void {
print(gobi.position)
}(10.0, 20.0)
use actor::Gobi as gobi : Spatial2D
use actor::Cartel as cartel : Label
fn _ready() void {
gobi.position.x += 30
cartel.text = "¡A jugar!"2 · CambiarloCon el actor en la mano puedes cambiarlo. Cada tipo tiene lo suyo: Gobi tiene una posición; el cartel, que es un Label, un texto. print(gobi.position)
print(cartel.text)
}(40.0, 20.0) ¡A jugar!
use prefab::Gema as gema
fn _ready() void {
mut g := gema.instantiate()
GetWorld.add_child(g)3 · Un prefabuse prefab:: trae un prefab por su nombre de archivo. instantiate() crea una copia y GetWorld.add_child la pone en la escena. El mensaje lo imprime el código de la propia gema.}Gema de 1 en (0.0, 0.0)
use prefab::Gema as gema
fn _ready() void {
for i : int in range(3) {
mut g := gema.instantiate()
g.position = Vector2(i * 40, 0)
GetWorld.add_child(g)4 · Muchas copiasDe un mismo prefab salen tantas copias como quieras. A cada una le das su posición antes de añadirla. }
}Gema de 1 en (0.0, 0.0) Gema de 1 en (40.0, 0.0) Gema de 1 en (80.0, 0.0)
Tu código casi nunca trabaja solo. El script de un nivel tiene que mover al jugador, cambiar el
texto de un cartel, crear monedas y enemigos. En Grost, todo eso entra por una sola puerta:
use.
Una sola puerta: use
module Nivel
use actor::Gobi as gobi : Spatial2Duse actor::Cartel as cartel : Label
fn _ready() void { print(gobi.position) print(cartel.text)}En esta escena hay dos actores además del nivel: Gobi y un cartel. Cada línea use trae uno:
| Parte | Qué hace |
|---|---|
use | Dice que traes algo a tu código |
actor:: | De dónde viene (el namespace): actor:: es un actor de tu escena |
Gobi | Cómo se llama el actor en la escena |
as gobi | El nombre con el que lo usarás en el código (el alias) |
: Spatial2D | Su tipo: qué clase de actor es |
Las líneas use van al principio del script, justo después de module. Sin as, el alias es
el mismo nombre del actor.
¿Y el actor raíz, el de la propia escena?
Se trae igual, por su nombre: use actor::Nivel as nivel : Spatial2D. Es lo que hiciste con
Gobi en la lección anterior. self no te sirve para eso: es el propio código, no el actor, y
Grost te avisa si le pides su position.
Los actores de tu escena
Con el actor en la mano puedes leerlo y cambiarlo. Lo que tiene cada uno depende de su tipo: un
Spatial2D tiene position, un Label (un texto en pantalla) tiene text.
module Nivel
use actor::Gobi as gobi : Spatial2Duse actor::Cartel as cartel : Label
fn _ready() void { gobi.position = Vector2(100, 20) cartel.text = "¡Bienvenido!" print(gobi.position) print(cartel.text)}Si vienes de otro motor, quizá busques get_node("Gobi") o $Gobi. En Grost no existen:
module Nivel
fn _ready() void { print(get_node("Gobi"))}El tipo, después de los dos puntos
El : Spatial2D del final es opcional, pero conviene ponerlo siempre. Sin él, Grost no sabe
qué clase de actor es, y te avisa cada vez que usas algo suyo:
module SinTipo
use actor::Gobi as gobi
fn _ready() void { print(gobi.position)}Funciona, pero el editor marca gobi.position con un aviso: la propiedad position no está en
el tipo Actor, el más general. Con el tipo puesto, el aviso desaparece y el editor te sugiere
lo que tiene Gobi mientras escribes.
El tipo tiene que ser el del actor de verdad. Si escribes use actor::Gobi as gobi : Label,
al usarlo da este error: Actor alias 'gobi' expects type 'Label', found 'Spatial2D'.
Prefabs: crear copias
Un prefab es un actor guardado en su propio archivo .prefab, con su propio código, listo
para copiarlo las veces que haga falta: monedas, balas, enemigos. Este es el código de
Gema.prefab:
module Gema
use actor::Gema as gema : Spatial2D
pub mut valor : int = 1
fn _ready() void { print($"Gema de {valor} en {gema.position}")}Y así la usa un nivel:
module Nivel
use prefab::Gema as gema
fn _ready() void { mut g := gema.instantiate() g.position = Vector2(50, 0) g.valor = 5 GetWorld.add_child(g)}use prefab::Gemabusca el archivoGema.prefabpor su nombre, esté en la carpeta que esté.gema.instantiate()crea una copia nueva. Todavía no está en la escena.g.valor = 5cambia un campo de esta copia. Se puede porque el código de la gema lo declarapub: visible desde otros scripts.GetWorld.add_child(g)la añade a la escena. En ese momento corre su_ready, y por eso ya ve la posición y el valor que le diste.
¿Qué pasa si quito el pub?
Que el nivel ya no puede tocar valor. Grost lo detecta antes de ejecutar:
Member "valor" is private. Add "pub" to access it from another script.
Otros archivos
use también trae otros archivos del proyecto. Todos se buscan por su nombre de archivo,
sin la carpeta y sin la extensión: use audio::salto encuentra salto.wav.
| Namespace | Trae |
|---|---|
prefab:: | un prefab (.prefab) |
ui:: | una interfaz de usuario (.uip) |
scene:: | una escena (.scene) |
audio:: | un sonido (.wav, .ogg, .mp3 o .flac) |
texture:: | una imagen (.png, .jpg, .jpeg, .webp o .svg) |
interface:: | datos compartidos entre scripts (lo verás al final de este módulo) |
En Grost no existen preload(...) ni load(...): todo lo que tu código necesita entra con
use.
Hora de practicar
¿Qué línea te da el actor Puerta de tu escena, con su tipo?
use actor::. get_node y $ no existen en Grost, y prefab:: es para archivos .prefab.Completa el código para crear una gema y ponerla en la escena.
Gema de 1 en (64.0, 0.0)
use ::Gema as gema
fn _ready() void {
mut g := gema.()
g.position = Vector2(64, 0)
GetWorld.add_child(g)
}use prefab::Gema as gema
fn _ready() void {
mut g := gema.instantiate()
g.position = Vector2(64, 0)
GetWorld.add_child(g)
}En la escena, Gobi está en (10, 20). ¿Qué imprime este código?
use actor::Gobi as gobi : Spatial2D
fn _ready() void {
gobi.position.y += 5
print(gobi.position)
}gobi es el Gobi de la escena, que ya estaba en (10, 20). Sumar 5 a y lo deja en (10, 25).y.El código de la gema declara pub mut valor : int = 1. ¿Para qué sirve el pub?
pub hace el campo visible desde otros scripts. Sin él, g.valor = 5 desde el nivel es un error.g.valor = 5.