Ir al contenido
Descargar
Curso de Grost

Importar con use

Módulo 3 · Grost en el juegoLección 12 de 208 min de lectura4 retos
main.groPaso 1 de 4
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)
}
Output
(10.0, 20.0)
main.groPaso 2 de 4
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)
}
Output
(40.0, 20.0)
¡A jugar!
main.groPaso 3 de 4
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.}
Output
Gema de 1 en (0.0, 0.0)
main.groPaso 4 de 4
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.  }
}
Output
Gema de 1 en (0.0, 0.0)
Gema de 1 en (40.0, 0.0)
Gema de 1 en (80.0, 0.0)
También con las flechas ← →

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

main.gro
module Nivel
use actor::Gobi as gobi : Spatial2D
use actor::Cartel as cartel : Label
fn _ready() void {
print(gobi.position)
print(cartel.text)
}
Output(10.0, 20.0) Nivel 1

En esta escena hay dos actores además del nivel: Gobi y un cartel. Cada línea use trae uno:

ParteQué hace
useDice que traes algo a tu código
actor::De dónde viene (el namespace): actor:: es un actor de tu escena
GobiCómo se llama el actor en la escena
as gobiEl nombre con el que lo usarás en el código (el alias)
: Spatial2DSu 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.

main.gro
module Nivel
use actor::Gobi as gobi : Spatial2D
use actor::Cartel as cartel : Label
fn _ready() void {
gobi.position = Vector2(100, 20)
cartel.text = "¡Bienvenido!"
print(gobi.position)
print(cartel.text)
}
Output(100.0, 20.0) ¡Bienvenido!

Si vienes de otro motor, quizá busques get_node("Gobi") o $Gobi. En Grost no existen:

main.gro
module Nivel
fn _ready() void {
print(get_node("Gobi"))
}
OutputParse Error: "get_node()" was removed from Grost: declare the node with "use actor::Name".

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:

main.gro
module SinTipo
use actor::Gobi as gobi
fn _ready() void {
print(gobi.position)
}
Output(10.0, 20.0)

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:

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}")
}
OutputGema de 1 en (0.0, 0.0)

Y así la usa un nivel:

main.gro
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)
}
OutputGema de 5 en (50.0, 0.0)
  • use prefab::Gema busca el archivo Gema.prefab por su nombre, esté en la carpeta que esté.
  • gema.instantiate() crea una copia nueva. Todavía no está en la escena.
  • g.valor = 5 cambia un campo de esta copia. Se puede porque el código de la gema lo declara pub: 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.

NamespaceTrae
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

Retos: 0/4 resueltosSe guardan en este navegador
Reto 1 de 4sin resolver

¿Qué línea te da el actor Puerta de tu escena, con su tipo?

Los actores de la escena entran con use actor::. get_node y $ no existen en Grost, y prefab:: es para archivos .prefab.
Los actores de tu escena siempre entran por el mismo namespace.
Reto 2 de 4sin resolver

Completa el código para crear una gema y ponerla en la escena.

Salida esperada
Gema de 1 en (64.0, 0.0)
main.gro
use ::Gema as gema

fn _ready() void {
  mut g := gema.()
  g.position = Vector2(64, 0)
  GetWorld.add_child(g)
}
El primer hueco dice qué clase de archivo traes. El segundo es la función que crea una copia.
Solución:
main.gro
use prefab::Gema as gema

fn _ready() void {
  mut g := gema.instantiate()
  g.position = Vector2(64, 0)
  GetWorld.add_child(g)
}
Reto 3 de 4sin resolver

En la escena, Gobi está en (10, 20). ¿Qué imprime este código?

main.gro
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).
Solo cambia uno de los dos números: el de y.
Reto 4 de 4sin resolver

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.
Piensa en quién escribe g.valor = 5.