ugBASIC 1.18
An isomorphic BASIC language compiler for retrocomputers
Loading...
Searching...
No Matches
vdcz.h
Go to the documentation of this file.
1#ifndef __UGBC_VDCZ__
2#define __UGBC_VDCZ__
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 14 // GREY
38#define COLOR_WHITE 15
39#define COLOR_LIGHT_WHITE COLOR_WHITE
40#define COLOR_DARK_RED 8 // RED
41#define COLOR_RED 8
42#define COLOR_LIGHT_RED 9
43#define COLOR_CYAN 6
44#define COLOR_VIOLET 10
45#define COLOR_DARK_GREEN 4 // GREEN
46#define COLOR_GREEN 4
47#define COLOR_LIGHT_GREEN 5
48#define COLOR_DARK_BLUE 2 // BLUE
49#define COLOR_BLUE 2
50#define COLOR_LIGHT_BLUE 3
51#define COLOR_YELLOW 12
52#define COLOR_ORANGE COLOR_RED
53#define COLOR_BROWN COLOR_RED
54#define COLOR_DARK_GREY 1
55#define COLOR_GREY 14
56#define COLOR_LIGHT_GREY 14
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_COUNT 16
68
69#define IMAGE_WIDTH_SIZE 2
70#define IMAGE_WIDTH_OFFSET 0
71#define IMAGE_HEIGHT_SIZE 1
72#define IMAGE_HEIGHT_OFFSET 2
73
74#define DEFAULT_PEN_COLOR COLOR_WHITE
75#define DEFAULT_PAPER_COLOR COLOR_BLACK
76
77#define TEXT_COLUMNS_COUNT 40
78#define TEXT_ROWS_COUNT 25
79
80#define BITMAP_MODE_STANDARD 1 // Standard Bitmap Mode 640 x 200 x 2
81#define BITMAP_MODE_MULTICOLOR 2 // Standard Multicolor Mode 640 x 176 x 16
82#define BITMAP_MODE_STANDARD_INT 5 // Interlaced Bitmap Mode 640 x 400 x 2
83#define BITMAP_MODE_MULTICOLOR_INT 6 // Interlaced Multicolor Mode 640 x 352 x 16
84
85#define BITMAP_MODE_DEFAULT BITMAP_MODE_STANDARD
86
87#define TILEMAP_MODE_STANDARD 0 // Standard Character Mode 80 x 25 x 16
88
89#define SPRITE_COUNT 0
90#define SPRITE_WIDTH 0
91#define SPRITE_HEIGHT 0
92#define SPRITE_X_MIN 0
93#define SPRITE_Y_MIN 0
94#define SPRITE_X_MAX 366
95#define SPRITE_Y_MAX 255
96
97#define SCREEN_SPRITE_RATIO_X 100
98#define SCREEN_SPRITE_RATIO_Y 100
99#define SCREEN_BORDER_X 0
100#define SCREEN_BORDER_Y 0
101
102#define DOUBLE_BUFFER_PAGE_0 0
103#define DOUBLE_BUFFER_PAGE_1 1
104
105int vdcz_screen_mode_enable( Environment * _environment, ScreenMode * _screen_mode );
106
107void vdcz_initialization( Environment * _environment );
108void vdcz_finalization( Environment * _environment );
109
110void vdcz_back( Environment * _environment );
111void vdcz_background_color( Environment * _environment, int _index, int _background_color );
112void vdcz_background_color_vars( Environment * _environment, char * _index, char * _background_color );
113void vdcz_background_color_semivars( Environment * _environment, int _index, char * _background_color );
114void vdcz_background_color_get_vars( Environment * _environment, char * _index, char * _background_color );
115void vdcz_border_color( Environment * _environment, char * _border_color );
116Variable * vdcz_collision( Environment * _environment, char * _sprite );
117void vdcz_hit( Environment * _environment, char * _sprite_mask, char * _result );
118void vdcz_next_raster( Environment * _environment );
119void vdcz_next_raster_at( Environment * _environment, char * _label, char * _positionlo, char * _positionhi );
120void vdcz_raster_at( Environment * _environment, char * _label, char * _positionlo, char * _positionhi );
121void vdcz_sprite_common_color( Environment * _environment, char * _index, char * _common_color );
122void vdcz_bitmap_enable( Environment * _environment, int _width, int _height, int _colors );
123void vdcz_bitmap_disable( Environment * _environment );
124void vdcz_bitmap_at( Environment * _environment, char * _address );
125void vdcz_colormap_at( Environment * _environment, char * _address );
126void vdcz_textmap_at( Environment * _environment, char * _address );
127void vdcz_tiles_at( Environment * _environment, char * _address );
128void vdcz_tilemap_enable( Environment * _environment, int _width, int _height, int _colors, int _tile_width, int _tile_height );
129
130void vdcz_bank_select( Environment * _environment, int _bank );
131void vdcz_screen_on( Environment * _environment );
132void vdcz_screen_off( Environment * _environment );
133void vdcz_screen_rows( Environment * _environment, char * _rows );
134void vdcz_screen_columns( Environment * _environment, char * _columns );
135
136void vdcz_sprite_data_from( Environment * _environment, char * _sprite, char * _address );
137void vdcz_sprite_data_set( Environment * _environment, char * _sprite, char * _address );
138void vdcz_sprite_enable( Environment * _environment, char *_sprite );
139void vdcz_sprite_disable( Environment * _environment, char * _sprite );
140void vdcz_sprite_at( Environment * _environment, char * _sprite, char * _x, char * _y );
141void vdcz_sprite_expand_vertical( Environment * _environment, char * _sprite );
142void vdcz_sprite_expand_horizontal( Environment * _environment, char * _sprite );
143void vdcz_sprite_compress_vertical( Environment * _environment, char * _sprite );
144void vdcz_sprite_compress_horizontal( Environment * _environment, char * _sprite );
145void vdcz_sprite_multicolor( Environment * _environment, char * _sprite );
146void vdcz_sprite_monocolor( Environment * _environment, char * _sprite );
147void vdcz_sprite_color( Environment * _environment, char * _sprite, char * _color );
148void vdcz_sprite_priority( Environment * _environment, char * _sprite, char * _priority );
149void vdcz_vertical_scroll( Environment * _environment, char * _displacement );
150void vdcz_horizontal_scroll( Environment * _environment, char * _displacement );
151void vdcz_busy_wait( Environment * _environment, char * _timing );
152
153void vdcz_tiles_get( Environment * _environment, char * _result );
154void vdcz_get_width( Environment * _environment, char * _result );
155void vdcz_get_height( Environment * _environment, char * _result );
156
157void vdcz_pset_int( Environment * _environment, int _x, int _y, int *_c );
158void vdcz_pset_vars( Environment * _environment, char *_x, char *_y, char *_c );
159void vdcz_pget_color_vars( Environment * _environment, char *_x, char *_y, char * _result );
160void vdcz_cls( Environment * _environment );
161void vdcz_cls_box( Environment * _environment, char * _x1, char * _y1, char * _w, char * _h );
162void vdcz_scroll_text( Environment * _environment, int _direction, int _overlap );
163void vdcz_hscroll_line( Environment * _environment, int _direction, int _overlap );
164void vdcz_hscroll_screen( Environment * _environment, int _direction, int _overlap );
165void vdcz_text( Environment * _environment, char * _text, char * _text_size, int _raw );
166void vdcz_cline( Environment * _environment, char * _characters );
167void vdcz_scroll( Environment * _environment, int _dx, int _dy );
168
169Variable * vdcz_get_raster_line( Environment * _environment );
170
171int vdcz_image_size( Environment * _environment, int _width, int _height, int _mode );
172Variable * vdcz_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 );
173Variable * vdcz_sprite_converter( Environment * _environment, char * _data, int _width, int _height, int _depth, RGBi * _color, int _flags );
174void vdcz_put_image( Environment * _environment, Resource * _image, char * _x, char * _y, char * _frame, char * _sequence, int _frame_size, int _frame_count, char * _flags );
175void vdcz_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 );
176void vdcz_wait_vbl( Environment * _environment, char * _raster_line );
177Variable * vdcz_new_image( Environment * _environment, int _width, int _height, int _mode );
178Variable * vdcz_new_images( Environment * _environment, int _frames, int _width, int _height, int _mode );
179Variable * vdcz_new_sequence( Environment * _environment, int _sequences, int _frames, int _width, int _height, int _mode );
180void vdcz_get_image( Environment * _environment, char * _image, char * _x, char * _y, char * _frame, char * _sequence, int _frame_size, int _frame_count, int _palette );
181
182void vdcz_put_tile( Environment * _environment, char * _image, char * _x, char * _y );
183void vdcz_put_tiles( Environment * _environment, char * _image, char * _x, char * _y, char *_w, char *_h );
184void vdcz_move_tiles( Environment * _environment, char * _image, char * _x, char * _y );
185void vdcz_use_tileset( Environment * _environment, char * _tileset );
186void vdcz_tile_at( Environment * _environment, char * _x, char * _y, char * _result );
187
188void vdcz_slice_image( Environment * _environment, char * _image, char * _frame, char * _sequence, int _frame_size, int _frame_count, char * _destination );
189int vdcz_palette_extract( Environment * _environment, char * _data, int _width, int _height, int _depth, int _flags, RGBi * _palette );
190void vdcz_calculate_sequence_frame_offset( Environment * _environment, char * _offset, char * _sequence, char * _frame, int _frame_size, int _frame_count );
191
192void vdcz_screen( Environment * _environment, char * _x, char * _y, char * _c );
193
194#endif
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.
void vdcz_slice_image(Environment *_environment, char *_image, char *_frame, char *_sequence, int _frame_size, int _frame_count, char *_destination)
Definition vdcz.c:3073
void vdcz_hit(Environment *_environment, char *_sprite_mask, char *_result)
VDCZ: emit code to check for collision
Definition vdcz.c:527
void vdcz_horizontal_scroll(Environment *_environment, char *_displacement)
Definition vdcz.c:2312
void vdcz_sprite_data_set(Environment *_environment, char *_sprite, char *_address)
Definition vdcz.c:2221
void vdcz_colormap_at(Environment *_environment, char *_address)
Definition vdcz.c:2116
void vdcz_screen_rows(Environment *_environment, char *_rows)
Definition vdcz.c:2213
void vdcz_textmap_at(Environment *_environment, char *_address)
Definition vdcz.c:2120
void vdcz_next_raster_at(Environment *_environment, char *_label, char *_positionlo, char *_positionhi)
VDCZ: emit code to wait for next raster irq at different position
Definition vdcz.c:703
void vdcz_finalization(Environment *_environment)
Definition vdcz.c:2578
void vdcz_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 vdcz.c:2908
void vdcz_sprite_monocolor(Environment *_environment, char *_sprite)
Definition vdcz.c:2284
Variable * vdcz_new_sequence(Environment *_environment, int _sequences, int _frames, int _width, int _height, int _mode)
Definition vdcz.c:2986
void vdcz_scroll(Environment *_environment, int _dx, int _dy)
Definition vdcz.c:3016
void vdcz_pset_int(Environment *_environment, int _x, int _y, int *_c)
Definition vdcz.c:2124
void vdcz_screen_columns(Environment *_environment, char *_columns)
Definition vdcz.c:2217
Variable * vdcz_new_images(Environment *_environment, int _frames, int _width, int _height, int _mode)
Definition vdcz.c:2975
void vdcz_tiles_get(Environment *_environment, char *_result)
Definition vdcz.c:2330
void vdcz_background_color_get_vars(Environment *_environment, char *_index, char *_background_color)
VDCZ: emit code to retrieve background color
Definition vdcz.c:634
int vdcz_screen_mode_enable(Environment *_environment, ScreenMode *_screen_mode)
Definition vdcz.c:743
void vdcz_get_height(Environment *_environment, char *_result)
Definition vdcz.c:2334
void vdcz_sprite_expand_vertical(Environment *_environment, char *_sprite)
Definition vdcz.c:2254
void vdcz_get_image(Environment *_environment, char *_image, char *_x, char *_y, char *_frame, char *_sequence, int _frame_size, int _frame_count, int _palette)
Definition vdcz.c:2997
void vdcz_bitmap_disable(Environment *_environment)
Definition vdcz.c:2086
Variable * vdcz_collision(Environment *_environment, char *_sprite)
VDCZ: emit code to check for collision
Definition vdcz.c:508
Variable * vdcz_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 vdcz.c:2628
void vdcz_calculate_sequence_frame_offset(Environment *_environment, char *_offset, char *_sequence, char *_frame, int _frame_size, int _frame_count)
Definition vdcz.c:2739
void vdcz_sprite_priority(Environment *_environment, char *_sprite, char *_priority)
Definition vdcz.c:2297
int vdcz_image_size(Environment *_environment, int _width, int _height, int _mode)
Definition vdcz.c:82
void vdcz_tilemap_enable(Environment *_environment, int _width, int _height, int _colors, int _tile_width, int _tile_height)
Definition vdcz.c:2090
void vdcz_cls(Environment *_environment)
Definition vdcz.c:2338
void vdcz_border_color(Environment *_environment, char *_border_color)
VDCZ: emit code to change border color
Definition vdcz.c:543
void vdcz_background_color_semivars(Environment *_environment, int _index, char *_background_color)
VDCZ: emit code to change background color
Definition vdcz.c:606
void vdcz_cline(Environment *_environment, char *_characters)
Definition vdcz.c:2613
void vdcz_scroll_text(Environment *_environment, int _direction, int _overlap)
Definition vdcz.c:2369
void vdcz_vertical_scroll(Environment *_environment, char *_displacement)
Definition vdcz.c:2308
void vdcz_tile_at(Environment *_environment, char *_x, char *_y, char *_result)
Definition vdcz.c:3051
void vdcz_screen_off(Environment *_environment)
Definition vdcz.c:2209
void vdcz_sprite_compress_vertical(Environment *_environment, char *_sprite)
Definition vdcz.c:2266
void vdcz_sprite_at(Environment *_environment, char *_sprite, char *_x, char *_y)
Definition vdcz.c:2246
void vdcz_screen(Environment *_environment, char *_x, char *_y, char *_c)
Definition vdcz.c:3091
void vdcz_bank_select(Environment *_environment, int _bank)
Definition vdcz.c:707
void vdcz_pset_vars(Environment *_environment, char *_x, char *_y, char *_c)
Definition vdcz.c:2150
void vdcz_background_color_vars(Environment *_environment, char *_index, char *_background_color)
VDCZ: emit code to change background color
Definition vdcz.c:582
void vdcz_sprite_color(Environment *_environment, char *_sprite, char *_color)
Definition vdcz.c:2290
void vdcz_sprite_disable(Environment *_environment, char *_sprite)
Definition vdcz.c:2240
void vdcz_raster_at(Environment *_environment, char *_label, char *_positionlo, char *_positionhi)
VDCZ: emit code to set raster irq
Definition vdcz.c:672
void vdcz_sprite_compress_horizontal(Environment *_environment, char *_sprite)
Definition vdcz.c:2272
void vdcz_back(Environment *_environment)
Definition vdcz.c:2607
void vdcz_initialization(Environment *_environment)
Definition vdcz.c:2421
void vdcz_sprite_common_color(Environment *_environment, char *_index, char *_common_color)
VDCZ: emit code to change common sprite's color
Definition vdcz.c:653
void vdcz_hscroll_screen(Environment *_environment, int _direction, int _overlap)
Definition vdcz.c:2601
void vdcz_move_tiles(Environment *_environment, char *_image, char *_x, char *_y)
Definition vdcz.c:3033
void vdcz_get_width(Environment *_environment, char *_result)
Definition vdcz.c:2326
void vdcz_sprite_expand_horizontal(Environment *_environment, char *_sprite)
Definition vdcz.c:2260
Variable * vdcz_get_raster_line(Environment *_environment)
Definition vdcz.c:3065
void vdcz_put_image(Environment *_environment, Resource *_image, char *_x, char *_y, char *_frame, char *_sequence, int _frame_size, int _frame_count, char *_flags)
Definition vdcz.c:2880
void vdcz_put_tile(Environment *_environment, char *_image, char *_x, char *_y)
Definition vdcz.c:3026
void vdcz_busy_wait(Environment *_environment, char *_timing)
Definition vdcz.c:2322
void vdcz_cls_box(Environment *_environment, char *_x1, char *_y1, char *_w, char *_h)
Definition vdcz.c:2350
void vdcz_hscroll_line(Environment *_environment, int _direction, int _overlap)
Definition vdcz.c:2595
Variable * vdcz_sprite_converter(Environment *_environment, char *_data, int _width, int _height, int _depth, RGBi *_color, int _flags)
Definition vdcz.c:2648
void vdcz_screen_on(Environment *_environment)
Definition vdcz.c:2205
Variable * vdcz_new_image(Environment *_environment, int _width, int _height, int _mode)
Definition vdcz.c:2964
void vdcz_sprite_multicolor(Environment *_environment, char *_sprite)
Definition vdcz.c:2278
void vdcz_sprite_data_from(Environment *_environment, char *_sprite, char *_address)
Definition vdcz.c:2225
void vdcz_use_tileset(Environment *_environment, char *_tileset)
Definition vdcz.c:3058
void vdcz_bitmap_at(Environment *_environment, char *_address)
Definition vdcz.c:2112
void vdcz_text(Environment *_environment, char *_text, char *_text_size, int _raw)
Definition vdcz.c:2381
int vdcz_palette_extract(Environment *_environment, char *_data, int _width, int _height, int _depth, int _flags, RGBi *_palette)
Definition vdcz.c:3077
void vdcz_pget_color_vars(Environment *_environment, char *_x, char *_y, char *_result)
Definition vdcz.c:2181
void vdcz_next_raster(Environment *_environment)
VDCZ: emit code to wait for next raster irq
Definition vdcz.c:686
void vdcz_sprite_enable(Environment *_environment, char *_sprite)
Definition vdcz.c:2234
void vdcz_bitmap_enable(Environment *_environment, int _width, int _height, int _colors)
Definition vdcz.c:2065
void vdcz_tiles_at(Environment *_environment, char *_address)
Definition vdcz.c:2304
void vdcz_put_tiles(Environment *_environment, char *_image, char *_x, char *_y, char *_w, char *_h)
Definition vdcz.c:3044
void vdcz_background_color(Environment *_environment, int _index, int _background_color)
VDCZ: emit code to change background color
Definition vdcz.c:557
void vdcz_wait_vbl(Environment *_environment, char *_raster_line)
Definition vdcz.c:2957