begin_gameloop.c

Go to the documentation of this file.

/*****************************************************************************
 * ugBASIC - an isomorphic BASIC language compiler for retrocomputers        *
 *****************************************************************************
 * Copyright 2021-2026 Marco Spedaletti (asimov@mclink.it)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *----------------------------------------------------------------------------
 * Concesso in licenza secondo i termini della Licenza Apache, versione 2.0
 * (la "Licenza"); è proibito usare questo file se non in conformità alla
 * Licenza. Una copia della Licenza è disponibile all'indirizzo:
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Se non richiesto dalla legislazione vigente o concordato per iscritto,
 * il software distribuito nei termini della Licenza è distribuito
 * "COSÌ COM'È", SENZA GARANZIE O CONDIZIONI DI ALCUN TIPO, esplicite o
 * implicite. Consultare la Licenza per il testo specifico che regola le
 * autorizzazioni e le limitazioni previste dalla medesima.
 ****************************************************************************/
 
/****************************************************************************
 * INCLUDE SECTION 
 ****************************************************************************/
 
#include "../../ugbc.h"
 
/****************************************************************************
 * CODE SECTION 
 ****************************************************************************/

/* <usermanual>
@keyword BEGIN GAMELOOP
 
@english
Define the starting point of a game loop. A game loop is nothing more 
than an implicit loop, within which all the logic of the program (or
of the game) runs. The end point of a game loop can correspond to 
the end of the program or to the ''END GAMELOOP'' statement.
 
In some platforms, it will implictly "sync" the activity with the
vertical blank, so the action inside the loop should be executed
in a single "frame" of game.
 
@italian
Definisce il punto di partenza di un loop di gioco. Un loop di 
gioco non è altro che un ciclo implicito, all'interno del quale 
tutta la logica del programma (o del gioco) viene eseguita. 
Il punto finale di un ciclo di gioco può corrispondere al termine
del programma o all'istruzione ''END GAMELOOP''. 
 
In alcune piattaforme, "sincronizza" implicitamente l'attività con il
"vertical blank", quindi l'azione all'interno del ciclo dovrebbe 
essere eseguita in un unico "frame" di gioco.
 
@syntax BEGIN GAMELOOP
 
@example BEGIN GAMELOOP
 
@target coleco
</usermanual> */
void begin_gameloop( Environment * _environment ) {
 
    MAKE_LABEL
 
    Loop * loop = malloc( sizeof( Loop ) );
    memset( loop, 0, sizeof( Loop ) );
    loop->label = strdup( label );
    loop->type = LT_GAMELOOP;
    loop->next = _environment->loops;
    _environment->loops = loop;
    
    cpu_label( _environment, loop->label );
    
    _environment->hasGameLoop = 1;
 
}