ugBASIC 1.18
An isomorphic BASIC language compiler for retrocomputers
Loading...
Searching...
No Matches
ted.h
Go to the documentation of this file.
1#ifndef __UGBC_TED__
2#define __UGBC_TED__
3
4/*****************************************************************************
5 * ugBASIC - an isomorphic BASIC language compiler for retrocomputers *
6 *****************************************************************************
7 * Copyright 2021-2026 Marco Spedaletti (asimov@mclink.it)
8 *
9 * Licensed under the Apache License, Version 2.0 (the "License");
10 * you may not use this file except in compliance with the License.
11 * You may obtain a copy of the License at
12 *
13 * http://www.apache.org/licenses/LICENSE-2.0
14 *
15 * Unless required by applicable law or agreed to in writing, software
16 * distributed under the License is distributed on an "AS IS" BASIS,
17 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18 * See the License for the specific language governing permissions and
19 * limitations under the License.
20 *----------------------------------------------------------------------------
21 * Concesso in licenza secondo i termini della Licenza Apache, versione 2.0
22 * (la "Licenza"); è proibito usare questo file se non in conformità alla
23 * Licenza. Una copia della Licenza è disponibile all'indirizzo:
24 *
25 * http://www.apache.org/licenses/LICENSE-2.0
26 *
27 * Se non richiesto dalla legislazione vigente o concordato per iscritto,
28 * il software distribuito nei termini della Licenza è distribuito
29 * "COSì COM'è", SENZA GARANZIE O CONDIZIONI DI ALCUN TIPO, esplicite o
30 * implicite. Consultare la Licenza per il testo specifico che regola le
31 * autorizzazioni e le limitazioni previste dalla medesima.
32 ****************************************************************************/
33
34#include "../ugbc.h"
35
36#define COLOR_BLACK 0
37#define COLOR_DARK_WHITE 12 // GREY
38#define COLOR_WHITE 1
39#define COLOR_DARK_RED 2 // RED
40#define COLOR_RED 2
41#define COLOR_CYAN 3
42#define COLOR_VIOLET 4
43#define COLOR_DARK_GREEN 5 // GREEN
44#define COLOR_GREEN 5
45#define COLOR_DARK_BLUE 6 // BLUE
46#define COLOR_BLUE 6
47#define COLOR_YELLOW 7
48#define COLOR_ORANGE 8
49#define COLOR_BROWN 9
50#define COLOR_LIGHT_RED 10
51#define COLOR_DARK_GREY 11
52#define COLOR_GREY 12
53#define COLOR_LIGHT_GREEN 13
54#define COLOR_LIGHT_BLUE 14
55#define COLOR_LIGHT_GREY 15
56#define COLOR_DARK_BLUE 6
57#define COLOR_MAGENTA COLOR_RED
58#define COLOR_PURPLE COLOR_VIOLET
59#define COLOR_LAVENDER COLOR_VIOLET
60#define COLOR_GOLD COLOR_YELLOW
61#define COLOR_TURQUOISE COLOR_LIGHT_BLUE
62#define COLOR_TAN COLOR_BROWN
63#define COLOR_YELLOW_GREEN COLOR_YELLOW
64#define COLOR_OLIVE_GREEN COLOR_GREEN
65#define COLOR_PINK COLOR_LIGHT_RED
66#define COLOR_PEACH COLOR_PINK
67#define COLOR_LIGHT_WHITE COLOR_WHITE
68#define COLOR_COUNT 16
69
70#define DEFAULT_PEN_COLOR COLOR_WHITE
71#define DEFAULT_PAPER_COLOR COLOR_BLACK
72
73#define TEXT_COLUMNS_COUNT 40
74#define TEXT_ROWS_COUNT 25
75
76#define BITMAP_MODE_STANDARD 2 // Standard Bitmap Mode 320 x 200 x 2
77#define BITMAP_MODE_MULTICOLOR 3 // Multicolor Bitmap Mode 160 x 200 x 4
78
79#define BITMAP_MODE_DEFAULT BITMAP_MODE_STANDARD
80
81#define TILEMAP_MODE_STANDARD 0 // Standard Character Mode 40 x 25 x 16
82#define TILEMAP_MODE_MULTICOLOR 1 // Multicolor Character Mode 40 x 25 x 16
83#define TILEMAP_MODE_EXTENDED 4 // Extended Background Color Mode 40 x 25 x 20
84
85#define SPRITE_COUNT 0
86#define SPRITE_WIDTH 0
87#define SPRITE_HEIGHT 0
88
89#define SPRITE_X_MIN 0
90#define SPRITE_Y_MIN 0
91#define SPRITE_X_MAX 0
92#define SPRITE_Y_MAX 0
93
94#define SCREEN_SPRITE_RATIO_X 100
95#define SCREEN_SPRITE_RATIO_Y 100
96#define SCREEN_BORDER_X 0
97#define SCREEN_BORDER_Y 0
98
99#define IMAGE_WIDTH_SIZE 2
100#define IMAGE_WIDTH_OFFSET 0
101#define IMAGE_HEIGHT_SIZE 1
102#define IMAGE_HEIGHT_OFFSET 2
103
104#define DOUBLE_BUFFER_PAGE_0 0
105#define DOUBLE_BUFFER_PAGE_1 1
106
107int ted_screen_mode_enable( Environment * _environment, ScreenMode * _screen_mode );
108
109void ted_initialization( Environment * _environment );
110void ted_finalization( Environment * _environment );
111
112void ted_back( Environment * _environment );
113void ted_background_color( Environment * _environment, int _index, int _background_color );
114void ted_background_color_vars( Environment * _environment, char * _index, char * _background_color );
115void ted_background_color_semivars( Environment * _environment, int _index, char * _background_color );
116void ted_background_color_get_vars( Environment * _environment, char * _index, char * _background_color );
117void ted_border_color( Environment * _environment, char * _border_color );
118void ted_collision( Environment * _environment, char * _sprite_mask, char * _result );
119void ted_hit( Environment * _environment, char * _sprite_mask, char * _result );
120void ted_next_raster( Environment * _environment );
121void ted_next_raster_at( Environment * _environment, char * _label, char * _positionlo, char * _positionhi );
122void ted_raster_at( Environment * _environment, char * _label, char * _positionlo, char * _positionhi );
123void ted_sprite_common_color( Environment * _environment, char * _index, char * _common_color );
124void ted_bitmap_enable( Environment * _environment, int _width, int _height, int _colors );
125void ted_bitmap_disable( Environment * _environment );
126void ted_bitmap_at( Environment * _environment, char * _address );
127void ted_colormap_at( Environment * _environment, char * _address );
128void ted_textmap_at( Environment * _environment, char * _address );
129void ted_charset_at( Environment * _environment, char * _address );
130void ted_charset_uppercase( Environment * _environment );
131void ted_charset_lowercase( Environment * _environment );
132void ted_tiles_at( Environment * _environment, char * _address );
133void ted_tilemap_enable( Environment * _environment, int _width, int _height, int _colors, int _tile_width, int _tile_height );
134
135void ted_bank_select( Environment * _environment, int _bank );
136void ted_screen_on( Environment * _environment );
137void ted_screen_off( Environment * _environment );
138void ted_screen_rows( Environment * _environment, char * _rows );
139void ted_screen_columns( Environment * _environment, char * _columns );
140
141void ted_sprite_data_from( Environment * _environment, char * _sprite, char * _address );
142void ted_sprite_data_set( Environment * _environment, char * _sprite, char * _address );
143void ted_sprite_enable( Environment * _environment, char *_sprite );
144void ted_sprite_disable( Environment * _environment, char * _sprite );
145void ted_sprite_at( Environment * _environment, char * _sprite, char * _x, char * _y );
146void ted_sprite_expand_vertical( Environment * _environment, char * _sprite );
147void ted_sprite_expand_horizontal( Environment * _environment, char * _sprite );
148void ted_sprite_compress_vertical( Environment * _environment, char * _sprite );
149void ted_sprite_compress_horizontal( Environment * _environment, char * _sprite );
150void ted_sprite_multicolor( Environment * _environment, char * _sprite );
151void ted_sprite_monocolor( Environment * _environment, char * _sprite );
152void ted_sprite_color( Environment * _environment, char * _sprite, char * _color );
153void ted_sprite_priority( Environment * _environment, char * _sprite, char * _priority );
154void ted_vertical_scroll( Environment * _environment, char * _displacement );
155void ted_horizontal_scroll( Environment * _environment, char * _displacement );
156void ted_busy_wait( Environment * _environment, char * _timing );
157
158void ted_tiles_get( Environment * _environment, char * _result );
159void ted_get_width( Environment * _environment, char * _result );
160void ted_get_height( Environment * _environment, char * _result );
161
162void ted_pset_int( Environment * _environment, int _x, int _y, int *_c );
163void ted_pset_vars( Environment * _environment, char *_x, char *_y, char *_c );
164void ted_pget_color_vars( Environment * _environment, char *_x, char *_y, char * _result );
165void ted_cls( Environment * _environment );
166void ted_cls_box( Environment * _environment, char * _x1, char * _y1, char * _w, char * _h );
167void ted_scroll_text( Environment * _environment, int _direction, int _overlap );
168void ted_hscroll_line( Environment * _environment, int _direction, int _overlap );
169void ted_hscroll_screen( Environment * _environment, int _direction, int _overlap );
170void ted_text( Environment * _environment, char * _text, char * _text_size, int _raw );
171void ted_scroll( Environment * _environment, int _dx, int _dy );
172
173Variable * ted_get_raster_line( Environment * _environment );
174
175int ted_image_size( Environment * _environment, int _width, int _height, int _mode );
176Variable * ted_image_converter( Environment * _environment, char * _data, int _width, int _height, int _depth, int _offset_x, int _offset_y, int _frame_width, int _frame_height, int _mode, int _transparent_color, int _flags );
177void ted_put_image( Environment * _environment, Resource * _image, char * _x, char * _y, char * _frame, char * _sequence, int _frame_size, int _frame_count, char * _flags );
178void ted_blit_image( Environment * _environment, char * _sources[], int _source_count, char * _blit, char * _x, char * _y, char * _frame, char * _sequence, int _frame_size, int _frame_count, int _flags );
179void ted_wait_vbl( Environment * _environment, char * _raster_line );
180Variable * ted_new_image( Environment * _environment, int _width, int _height, int _mode );
181Variable * ted_new_images( Environment * _environment, int _frames, int _width, int _height, int _mode );
182Variable * ted_new_sequence( Environment * _environment, int _sequences, int _frames, int _width, int _height, int _mode );
183void ted_get_image( Environment * _environment, char * _image, char * _x, char * _y, char * _frame, char * _sequence, int _frame_size, int _frame_count, int _palette );
184
185void ted_put_tile( Environment * _environment, char * _image, char * _x, char * _y );
186void ted_put_tiles( Environment * _environment, char * _image, char * _x, char * _y, char *_w, char *_h );
187void ted_move_tiles( Environment * _environment, char * _image, char * _x, char * _y );
188void ted_use_tileset( Environment * _environment, char * _tileset );
189void ted_tile_at( Environment * _environment, char * _x, char * _y, char * _result );
190
191void ted_start( Environment * _environment, int _channel );
192void ted_set_volume( Environment * _environment, int _channel, int _volume );
193void ted_set_program( Environment * _environment, int _channel, int _program );
194void ted_set_parameter( Environment * _environment, int _channel, int _parameter, int _value );
195void ted_set_frequency( Environment * _environment, int _channel, int _frequency );
196void ted_set_pitch( Environment * _environment, int _channel, int _pitch );
197void ted_set_note( Environment * _environment, int _channel, int _note );
198void ted_stop( Environment * _environment, int _channel );
199void ted_set_duration( Environment * _environment, int _channel, int _duration );
200void ted_wait_duration( Environment * _environment, int _channels );
201
202void ted_start_var( Environment * _environment, char * _channel );
203void ted_set_volume_semi_var( Environment * _environment, char * _channel, int _volume );
204void ted_set_volume_vars( Environment * _environment, char * _channel, char * _volume );
205void ted_set_program_semi_var( Environment * _environment, char * _channel, int _program );
206void ted_set_frequency_vars( Environment * _environment, char * _channel, char * _frequency );
207void ted_set_pitch_vars( Environment * _environment, char * _channel, char * _pitch );
208void ted_set_note_vars( Environment * _environment, char * _channel, char * _note );
209void ted_stop_vars( Environment * _environment, char * _channel );
210void ted_set_duration_vars( Environment * _environment, char * _channel, char * _duration );
211void ted_wait_duration_vars( Environment * _environment, char * _channel );
212
213void ted_music( Environment * _environment, char * _music, int _size, int _loop );
214
215void ted_slice_image( Environment * _environment, char * _image, char * _frame, char * _sequence, int _frame_size, int _frame_count, char * _destination );
216int ted_palette_extract( Environment * _environment, char * _data, int _width, int _height, int _depth, int _flags, RGBi * _palette );
217void ted_calculate_sequence_frame_offset( Environment * _environment, char * _offset, char * _sequence, char * _frame, int _frame_size, int _frame_count );
218void ted_flip_image( Environment * _environment, Resource * _image, char * _frame, char * _sequence, int _frame_size, int _frame_count, char * _direction );
219
220void ted_screen( Environment * _environment, char * _x, char * _y, char * _c );
221
222#endif
void ted_start_var(Environment *_environment, char *_channel)
Definition ted.c:2749
int ted_palette_extract(Environment *_environment, char *_data, int _width, int _height, int _depth, int _flags, RGBi *_palette)
Definition ted.c:3088
void ted_screen_columns(Environment *_environment, char *_columns)
Definition ted.c:1125
void ted_set_frequency(Environment *_environment, int _channel, int _frequency)
Definition ted.c:2716
void ted_sprite_multicolor(Environment *_environment, char *_sprite)
Definition ted.c:1181
void ted_collision(Environment *_environment, char *_sprite_mask, char *_result)
Definition ted.c:517
void ted_set_pitch(Environment *_environment, int _channel, int _pitch)
Definition ted.c:2725
void ted_background_color_semivars(Environment *_environment, int _index, char *_background_color)
TED: emit code to change background color
Definition ted.c:589
void ted_scroll_text(Environment *_environment, int _direction, int _overlap)
Definition ted.c:1301
void ted_colormap_at(Environment *_environment, char *_address)
Definition ted.c:986
void ted_set_duration(Environment *_environment, int _channel, int _duration)
Definition ted.c:3146
void ted_slice_image(Environment *_environment, char *_image, char *_frame, char *_sequence, int _frame_size, int _frame_count, char *_destination)
Definition ted.c:3084
Variable * ted_image_converter(Environment *_environment, char *_data, int _width, int _height, int _depth, int _offset_x, int _offset_y, int _frame_width, int _frame_height, int _mode, int _transparent_color, int _flags)
Definition ted.c:1698
void ted_background_color_vars(Environment *_environment, char *_index, char *_background_color)
TED: emit code to change background color
Definition ted.c:569
void ted_set_duration_vars(Environment *_environment, char *_channel, char *_duration)
Definition ted.c:3164
Variable * ted_new_images(Environment *_environment, int _frames, int _width, int _height, int _mode)
Definition ted.c:2120
void ted_hit(Environment *_environment, char *_sprite_mask, char *_result)
Definition ted.c:521
void ted_charset_at(Environment *_environment, char *_address)
Definition ted.c:1002
void ted_sprite_priority(Environment *_environment, char *_sprite, char *_priority)
Definition ted.c:1193
void ted_pget_color_vars(Environment *_environment, char *_x, char *_y, char *_result)
Definition ted.c:1073
void ted_sprite_monocolor(Environment *_environment, char *_sprite)
Definition ted.c:1185
void ted_cls(Environment *_environment)
Definition ted.c:1265
void ted_text(Environment *_environment, char *_text, char *_text_size, int _raw)
Definition ted.c:1331
void ted_initialization(Environment *_environment)
Definition ted.c:1357
void ted_bitmap_disable(Environment *_environment)
Definition ted.c:951
Variable * ted_new_sequence(Environment *_environment, int _sequences, int _frames, int _width, int _height, int _mode)
Definition ted.c:2152
void ted_set_pitch_vars(Environment *_environment, char *_channel, char *_pitch)
Definition ted.c:3007
void ted_sprite_color(Environment *_environment, char *_sprite, char *_color)
Definition ted.c:1189
void ted_sprite_data_from(Environment *_environment, char *_sprite, char *_address)
Definition ted.c:1145
void ted_horizontal_scroll(Environment *_environment, char *_displacement)
Definition ted.c:1210
void ted_pset_vars(Environment *_environment, char *_x, char *_y, char *_c)
Definition ted.c:1035
void ted_back(Environment *_environment)
Definition ted.c:1473
void ted_set_frequency_vars(Environment *_environment, char *_channel, char *_frequency)
Definition ted.c:2990
void ted_calculate_sequence_frame_offset(Environment *_environment, char *_offset, char *_sequence, char *_frame, int _frame_size, int _frame_count)
Definition ted.c:1721
void ted_scroll(Environment *_environment, int _dx, int _dy)
Definition ted.c:1316
void ted_set_note(Environment *_environment, int _channel, int _note)
Definition ted.c:2734
int ted_screen_mode_enable(Environment *_environment, ScreenMode *_screen_mode)
Definition ted.c:744
void ted_sprite_disable(Environment *_environment, char *_sprite)
Definition ted.c:1157
void ted_vertical_scroll(Environment *_environment, char *_displacement)
Definition ted.c:1201
void ted_stop_vars(Environment *_environment, char *_channel)
Definition ted.c:3053
void ted_hscroll_screen(Environment *_environment, int _direction, int _overlap)
Definition ted.c:1461
void ted_busy_wait(Environment *_environment, char *_timing)
Definition ted.c:1219
void ted_get_image(Environment *_environment, char *_image, char *_x, char *_y, char *_frame, char *_sequence, int _frame_size, int _frame_count, int _palette)
Definition ted.c:2185
void ted_screen_rows(Environment *_environment, char *_rows)
Definition ted.c:1105
void ted_tiles_get(Environment *_environment, char *_result)
Definition ted.c:1249
void ted_hscroll_line(Environment *_environment, int _direction, int _overlap)
Definition ted.c:1447
void ted_sprite_common_color(Environment *_environment, char *_index, char *_common_color)
Definition ted.c:620
void ted_blit_image(Environment *_environment, char *_sources[], int _source_count, char *_blit, char *_x, char *_y, char *_frame, char *_sequence, int _frame_size, int _frame_count, int _flags)
Definition ted.c:2030
void ted_cls_box(Environment *_environment, char *_x1, char *_y1, char *_w, char *_h)
Definition ted.c:1277
void ted_set_note_vars(Environment *_environment, char *_channel, char *_note)
Definition ted.c:3024
void ted_sprite_expand_vertical(Environment *_environment, char *_sprite)
Definition ted.c:1165
void ted_bitmap_at(Environment *_environment, char *_address)
Definition ted.c:982
void ted_tilemap_enable(Environment *_environment, int _width, int _height, int _colors, int _tile_width, int _tile_height)
Definition ted.c:964
void ted_pset_int(Environment *_environment, int _x, int _y, int *_c)
Definition ted.c:1006
void ted_background_color_get_vars(Environment *_environment, char *_index, char *_background_color)
TED: emit code to retrieve background color
Definition ted.c:609
void ted_sprite_enable(Environment *_environment, char *_sprite)
Definition ted.c:1153
void ted_wait_duration_vars(Environment *_environment, char *_channel)
Definition ted.c:3186
void ted_charset_uppercase(Environment *_environment)
Definition ted.c:994
void ted_screen_on(Environment *_environment)
Definition ted.c:1097
void ted_finalization(Environment *_environment)
Definition ted.c:1423
void ted_background_color(Environment *_environment, int _index, int _background_color)
TED: emit code to change bac_kground color
Definition ted.c:552
void ted_sprite_at(Environment *_environment, char *_sprite, char *_x, char *_y)
Definition ted.c:1161
void ted_get_height(Environment *_environment, char *_result)
Definition ted.c:1256
void ted_textmap_at(Environment *_environment, char *_address)
Definition ted.c:990
void ted_put_tiles(Environment *_environment, char *_image, char *_x, char *_y, char *_w, char *_h)
Definition ted.c:2270
void ted_sprite_compress_vertical(Environment *_environment, char *_sprite)
Definition ted.c:1173
void ted_set_parameter(Environment *_environment, int _channel, int _parameter, int _value)
Definition ted.c:2712
void ted_next_raster(Environment *_environment)
TED: emit code to wait for next raster irq
Definition ted.c:674
void ted_get_width(Environment *_environment, char *_result)
Definition ted.c:1240
void ted_next_raster_at(Environment *_environment, char *_label, char *_positionlo, char *_positionhi)
TED: emit code to wait for next raster irq at different position
Definition ted.c:694
void ted_border_color(Environment *_environment, char *_border_color)
TED: emit code to change border color
Definition ted.c:534
void ted_bitmap_enable(Environment *_environment, int _width, int _height, int _colors)
Definition ted.c:933
void ted_raster_at(Environment *_environment, char *_label, char *_positionlo, char *_positionhi)
TED: emit code to set raster irq
Definition ted.c:639
Variable * ted_new_image(Environment *_environment, int _width, int _height, int _mode)
Definition ted.c:2096
void ted_use_tileset(Environment *_environment, char *_tileset)
Definition ted.c:2315
void ted_music(Environment *_environment, char *_music, int _size, int _loop)
Definition ted.c:3063
void ted_wait_vbl(Environment *_environment, char *_raster_line)
Definition ted.c:2088
void ted_sprite_expand_horizontal(Environment *_environment, char *_sprite)
Definition ted.c:1169
void ted_flip_image(Environment *_environment, Resource *_image, char *_frame, char *_sequence, int _frame_size, int _frame_count, char *_direction)
Definition ted.c:3102
void ted_wait_duration(Environment *_environment, int _channels)
Definition ted.c:3155
void ted_set_volume_semi_var(Environment *_environment, char *_channel, int _volume)
Definition ted.c:2778
void ted_set_program(Environment *_environment, int _channel, int _program)
Definition ted.c:2510
void ted_move_tiles(Environment *_environment, char *_image, char *_x, char *_y)
Definition ted.c:2229
void ted_stop(Environment *_environment, int _channel)
Definition ted.c:2740
Variable * ted_get_raster_line(Environment *_environment)
Definition ted.c:2326
void ted_screen(Environment *_environment, char *_x, char *_y, char *_c)
Definition ted.c:3202
void ted_tile_at(Environment *_environment, char *_x, char *_y, char *_result)
Definition ted.c:2298
void ted_screen_off(Environment *_environment)
Definition ted.c:1101
void ted_put_image(Environment *_environment, Resource *_image, char *_x, char *_y, char *_frame, char *_sequence, int _frame_size, int _frame_count, char *_flags)
Definition ted.c:1996
void ted_charset_lowercase(Environment *_environment)
Definition ted.c:998
int ted_image_size(Environment *_environment, int _width, int _height, int _mode)
Definition ted.c:1481
void ted_tiles_at(Environment *_environment, char *_address)
Definition ted.c:1197
void ted_start(Environment *_environment, int _channel)
Definition ted.c:2357
void ted_set_program_semi_var(Environment *_environment, char *_channel, int _program)
Definition ted.c:2788
void ted_set_volume_vars(Environment *_environment, char *_channel, char *_volume)
Definition ted.c:2763
void ted_set_volume(Environment *_environment, int _channel, int _volume)
Definition ted.c:2371
void ted_sprite_data_set(Environment *_environment, char *_sprite, char *_address)
Definition ted.c:1149
void ted_bank_select(Environment *_environment, int _bank)
Definition ted.c:717
void ted_put_tile(Environment *_environment, char *_image, char *_x, char *_y)
Definition ted.c:2208
void ted_sprite_compress_horizontal(Environment *_environment, char *_sprite)
Definition ted.c:1177
struct _ScreenMode ScreenMode
struct _Resource Resource
struct _RGBi RGBi
Structure to store color components (red, green and blue).
struct _Variable Variable
Structure of a single variable.
struct _Environment Environment
Structure of compilation environment.