void set_text_region( int id_texto, uchar region )

Descripción:

Establece la región de pantalla para el texto escrito.

Esto es útil para hacer efectos de aparición y desaparición de texto de la pantalla, como recorte del mismo. Se especifica como parámetro el identificador del texto (id_texto) que es un código numérico que devuelve las funciones write() y write_int() cuando se les pide que escriban un texto, y la región de pantalla definida por define_region().

int id_text = 0, w_fnt = 0, switch_fnt = 1;

MAIN_PROGRAM_CDIV
BEGIN_PROGRAM 

 // Definimos el modo gráfico
 set_gfx(GFX_AUTODETECT_WINDOWED);

 // Definimos la resolución
 set_mode(m320x200);

 // Escribimos "¡ Hola mundo !"
 id_text = write(0, 160, 2, 1, "¡ Hola mundo !");

 define_region(1, 0, 0, 320, 12);
 set_text_region(id_text, 1);

 // Bucle de espera
 LOOP{
  w_fnt = w_fnt + switch_fnt;

  define_region(1, 0, 0, 320, 12 - w_fnt);

  if( w_fnt == 12 ) switch_fnt = -1;
  if( w_fnt == 0 ) switch_fnt = 1;

  FRAME;
 }

END_PROGRAM

En el ejemplo se imprime un texto con la función write() en el centro de la pantalla. Esta función nos devuelve el identificador de dicho texto, que se guarda en la variable id_texto.

En cada paso de bucle, aumenta y disminuye la región, por lo que aparece la sensación el texto aparece y desaparece, al aumentar y disminuir la altura de la región con la función define_region().

Para borrar un texto definitivamente también se requiere el identificador del texto, y se debe utilizar para ello la función delete_text().

Ver: write() - write_int() - delete_text() - define_region()