viewvc.cgi/VRac/Screen.pm

package Screen;

# Dobrica Pavlinusic, <dpavlin@rot13.org> 07/30/07 17:58:55 CEST

use strict;
use warnings;

use SDL::App;
use SDL::Rect;
use SDL::Color;
use SDL::Constants;

use Carp qw/confess/;
use Data::Dump qw/dump/;

use Exporter 'import';
our @EXPORT = qw'$white $black';

use base qw(Class::Accessor Prefs);
__PACKAGE__->mk_accessors(qw(app event));

=head1 NAME

Screen - simulated 256*256 pixels monochrome screen using SDL

=head1 Architecture dependent

You may override following methods if you want to implement keyboard on each
keypress event. Alternative is to use <read> hook and trap memory access.

=head2 key_down

  $self->key_down( 'a' );

=cut

sub key_down {}

=head2 key_up

  $self->key_up( 'a' );

=cut

sub key_up {}


=head1 Architecture independent

You don't need to override any of following function in your architecture,
but you might want to call them.

=head2 open_screen

Open simulated screen

=cut

our $app;

sub open_screen {
        my $self = shift;

        $self->prefs;

        if ( ! $self->scale ) {
                $self->scale( 1 );
                warn "using default unscaled display\n";
        }

        $app = SDL::App->new(
                -width  => 256 * $self->scale + ( $self->show_mem ? 256 : 0 ),
                -height => 256 * $self->scale,
                -depth  => 16,
                -flags=>SDL_DOUBLEBUF | SDL_HWSURFACE | SDL_HWACCEL,
        );
        #$app->grab_input( SDL_GRAB_QUERY );
        $app->grab_input( SDL_GRAB_OFF );
        $app->title( ref($self) );

        $self->app( $app );

        my $event = SDL::Event->new();
        $self->event( $event );

        warn "# created SDL::App\n";
}

our $white      = SDL::Color->new( -r => 0xff, -g => 0xff, -b => 0xff );
our $black      = SDL::Color->new( -r => 0x80, -g => 0x80, -b => 0x80 );

my $red         = SDL::Color->new( -r => 0xff, -g => 0x00, -b => 0x00 );
my $green       = SDL::Color->new( -r => 0x00, -g => 0xff, -b => 0x00 );
my $blue        = SDL::Color->new( -r => 0x00, -g => 0x00, -b => 0xff );

=head2 mem_xy

Helper to return x and y coordinates in memory map

  my ( $x,$y ) = $screen->mem_xy( $address );

=cut

sub mem_xy {
        my $self = shift;
        my $offset = shift;
        my $x = $offset & 0xff;
        $x += 256 * $self->scale;
        my $y = $offset >> 8;
        return ($x,$y);
}

=head2 mmap_pixel

Draw pixel in memory map

  $self->mmap_pixel( $addr, $r, $g, $b );

=cut

# keep accesses to memory
my $_mem_stat;

sub mmap_pixel {
        my ( $self, $addr, $r, $g, $b ) = @_;
        return unless $self->show_mem && $self->app;

        my ( $x, $y ) = $self->mem_xy( $addr );
        warn sprintf "## mem %04x %02x %02x %02d*%02d\n", $addr, $r, $g, $x, $y if $self->debug;

        my $col = SDL::Color->new( -r => $r, -g => $g, -b => $b );
        $self->app->pixel( $x, $y, $col );

        $_mem_stat++;
        if ( $_mem_stat % 1000 == 0 ) {
                $self->app->sync;
        }
}


=head2 sync

  $self->sync;

=cut

sub sync {
        $app->sync;
}

=head2 render_vram

Render one frame of video ram

  $self->render_vram;

=cut

sub render_vram {
        my $self = shift;

        confess "please implement $self::render_vram";
}


=head2 render_frame

Render one frame of video ram

  $self->render_frame( $vram_sdl_surface );

=cut

sub render_frame {
        my $self = shift;

        my $vram = shift;
        confess "need SDL::Surface as argument" unless ref($vram) eq 'SDL::Surface';

        $vram->display_format;

        my $scale = $self->scale || confess "no scale?";

        my $rect        = SDL::Rect->new( -x => 0, -y => 0, -width => 256 * $scale, -height => 256 * $scale );
        my $rect_screen = SDL::Rect->new( -x => 0, -y => 0, -width => 256 * $scale, -height => 256 * $scale );

        if ( $scale > 1 ) {
                use SDL::Tool::Graphic;
                # last parametar is anti-alias
                my $zoomed = SDL::Tool::Graphic->zoom( $vram, $self->scale, $self->scale, 1 );
                $zoomed->blit( $rect, $app, $rect_screen );
        } else {
                $vram->blit( $rect, $app, $rect_screen );
        }

        $app->sync;
}


=head2 render_mem

  $self->render_mem( @mem );

=cut

sub render_mem {
        my $self = shift;

        return unless $self->show_mem;

        my $pixels = pack("C*", @_);

        my $vram = SDL::Surface->new(
                -width => 256,
                -height => 256,
                -depth => 8,    # 1 bit per pixel
                -pitch => 256,  # bytes per line
                -from => $pixels,
                -Rmask => 0xffff00ff,
                -Gmask => 0xffff00ff,
                -Bmask => 0xffff00ff,
        );

        $vram->display_format;

        my $rect     = SDL::Rect->new( -x => 0, -y => 0, -width => 256, -height => 256 );
        my $rect_mem = SDL::Rect->new( -x => 256 * $self->scale, -y => 0, -width => 256, -height => 256 );

        $vram->blit( $rect, $app, $rect_mem );

        $app->sync;
}

=head2 key_pressed

Check SDL event loop if there are any pending keys

  my $key = $self->key_pressed;

  if ( $self->key_pressed( 1 ) ) {
        # just to check other events, don't process
        # key
  }

=cut

my $pending_key;
my $run_for = 2000;

sub key_pressed {
        my $self = shift;

        # don't take key, just pull event
        my $just_checking = shift || 0;

        my $event = $self->event || confess "no event?";

        if ( ! $event->poll ) {
                return $pending_key unless $self->can('session_event');
                if ( my $h = $self->session_event('key_pressed') ) {
                        my ( $key, $state ) = %$h;
                        if ( $state ) {
                                $pending_key = $key;
                                $self->key_down( $key );
                        } else {
                                undef $pending_key;
                                $self->key_up( $key );
                        }
                }
                return $pending_key;
        }

        my $type = $event->type();

        exit if ($type == SDL_QUIT);

        my $k = $pending_key;

        if ($type == SDL_KEYDOWN) {
                $k = $event->key_name();
                if ( $k eq 'escape' ) {
                        $run_for = $self->cli;
                        warn "will check event loop every $run_for cycles\n";
                        $pending_key = '~';
                } else {
                        warn "SDL_KEYDOWN ($type) = '$k'", $just_checking ? ' fake' : '', "\n";
                        $pending_key = $k;
                        $self->key_down( $k );
                        $self->record_session('key_pressed', { $k => 1 });
                }
        } elsif ( $type == SDL_KEYUP ) {
                my $up = $event->key_name();
                warn "SDL_KEYUP ($type) = '$up'", $just_checking ? ' fake' : '', "\n";
                $self->key_up( $up );
                $self->record_session('key_pressed', { $up => 0 });
                undef $pending_key;
        }

        warn "key_pressed = $pending_key\n" if ( $pending_key );

        return $pending_key;
}

=head2 loop

Implement CPU run for C<$run_run> cycles inside SDL event loop

  $self->loop( sub {
        my $run_for = shift;
        CPU::exec( $run_for );
        $self->render_vram;
  } );

=cut

sub loop {
        my $self = shift;
        my $exec = shift;

        confess "need coderef as argument" unless ref($exec) eq 'CODE';
        my $event = SDL::Event->new();

        while ( 1 ) {
                $self->key_pressed( 1 );
                $exec->($run_for);
        }
}

=head1 SEE ALSO

L<Orao> is sample implementation using this module

=head1 AUTHOR

Dobrica Pavlinusic, C<< <dpavlin@rot13.org> >>

=head1 COPYRIGHT & LICENSE

Copyright 2007 Dobrica Pavlinusic, All Rights Reserved.

This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.

=cut

1;
1	dpavlin	29	package Screen;
2
3			# Dobrica Pavlinusic, <dpavlin@rot13.org> 07/30/07 17:58:55 CEST
4
5			use strict;
6			use warnings;
7
8			use SDL::App;
9			use SDL::Rect;
10			use SDL::Color;
11	dpavlin	75	use SDL::Constants;
12	dpavlin	29
13	dpavlin	33	use Carp qw/confess/;
14	dpavlin	75	use Data::Dump qw/dump/;
15	dpavlin	33
16	dpavlin	125	use Exporter 'import';
17			our @EXPORT = qw'$white $black';
18
19	dpavlin	56	use base qw(Class::Accessor Prefs);
20	dpavlin	98	__PACKAGE__->mk_accessors(qw(app event));
21	dpavlin	29
22	dpavlin	55	=head1 NAME
23
24			Screen - simulated 256*256 pixels monochrome screen using SDL
25
26	dpavlin	161	=head1 Architecture dependent
27
28			You may override following methods if you want to implement keyboard on each
29			keypress event. Alternative is to use <read> hook and trap memory access.
30
31			=head2 key_down
32
33			$self->key_down( 'a' );
34
35			=cut
36
37			sub key_down {}
38
39			=head2 key_up
40
41			$self->key_up( 'a' );
42
43			=cut
44
45			sub key_up {}
46
47
48			=head1 Architecture independent
49
50			You don't need to override any of following function in your architecture,
51			but you might want to call them.
52
53	dpavlin	30	=head2 open_screen
54	dpavlin	29
55			Open simulated screen
56
57			=cut
58
59			our $app;
60
61	dpavlin	30	sub open_screen {
62	dpavlin	29	my $self = shift;
63	dpavlin	31
64	dpavlin	56	$self->prefs;
65
66	dpavlin	31	if ( ! $self->scale ) {
67			$self->scale( 1 );
68			warn "using default unscaled display\n";
69			}
70
71	dpavlin	29	$app = SDL::App->new(
72			-width => 256 * $self->scale + ( $self->show_mem ? 256 : 0 ),
73			-height => 256 * $self->scale,
74			-depth => 16,
75	dpavlin	142	-flags=>SDL_DOUBLEBUF \| SDL_HWSURFACE \| SDL_HWACCEL,
76	dpavlin	29	);
77	dpavlin	75	#$app->grab_input( SDL_GRAB_QUERY );
78			$app->grab_input( SDL_GRAB_OFF );
79	dpavlin	155	$app->title( ref($self) );
80	dpavlin	29
81	dpavlin	98	$self->app( $app );
82
83			my $event = SDL::Event->new();
84			$self->event( $event );
85
86	dpavlin	29	warn "# created SDL::App\n";
87			}
88
89	dpavlin	125	our $white = SDL::Color->new( -r => 0xff, -g => 0xff, -b => 0xff );
90			our $black = SDL::Color->new( -r => 0x80, -g => 0x80, -b => 0x80 );
91	dpavlin	29
92			my $red = SDL::Color->new( -r => 0xff, -g => 0x00, -b => 0x00 );
93			my $green = SDL::Color->new( -r => 0x00, -g => 0xff, -b => 0x00 );
94			my $blue = SDL::Color->new( -r => 0x00, -g => 0x00, -b => 0xff );
95
96			=head2 mem_xy
97
98			Helper to return x and y coordinates in memory map
99
100			my ( $x,$y ) = $screen->mem_xy( $address );
101
102			=cut
103
104			sub mem_xy {
105			my $self = shift;
106			my $offset = shift;
107			my $x = $offset & 0xff;
108			$x += 256 * $self->scale;
109			my $y = $offset >> 8;
110			return ($x,$y);
111			}
112
113	dpavlin	32	=head2 mmap_pixel
114
115			Draw pixel in memory map
116
117			$self->mmap_pixel( $addr, $r, $g, $b );
118
119			=cut
120
121			# keep accesses to memory
122			my $_mem_stat;
123
124			sub mmap_pixel {
125			my ( $self, $addr, $r, $g, $b ) = @_;
126	dpavlin	33	return unless $self->show_mem && $self->app;
127	dpavlin	32
128	dpavlin	33	my ( $x, $y ) = $self->mem_xy( $addr );
129	dpavlin	41	warn sprintf "## mem %04x %02x %02x %02d*%02d\n", $addr, $r, $g, $x, $y if $self->debug;
130	dpavlin	32
131	dpavlin	33	my $col = SDL::Color->new( -r => $r, -g => $g, -b => $b );
132			$self->app->pixel( $x, $y, $col );
133	dpavlin	32
134			$_mem_stat++;
135			if ( $_mem_stat % 1000 == 0 ) {
136	dpavlin	33	$self->app->sync;
137	dpavlin	32	}
138			}
139
140	dpavlin	33
141			=head2 sync
142
143			$self->sync;
144
145			=cut
146
147			sub sync {
148			$app->sync;
149			}
150
151	dpavlin	107	=head2 render_vram
152	dpavlin	73
153	dpavlin	76	Render one frame of video ram
154
155	dpavlin	126	$self->render_vram;
156	dpavlin	73
157			=cut
158
159	dpavlin	125	sub render_vram {
160			my $self = shift;
161	dpavlin	107
162	dpavlin	125	confess "please implement $self::render_vram";
163	dpavlin	107	}
164
165
166	dpavlin	125	=head2 render_frame
167	dpavlin	73
168	dpavlin	125	Render one frame of video ram
169	dpavlin	106
170	dpavlin	125	$self->render_frame( $vram_sdl_surface );
171	dpavlin	106
172	dpavlin	125	=cut
173	dpavlin	107
174	dpavlin	125	sub render_frame {
175			my $self = shift;
176
177			my $vram = shift;
178			confess "need SDL::Surface as argument" unless ref($vram) eq 'SDL::Surface';
179
180	dpavlin	75	$vram->display_format;
181	dpavlin	73
182	dpavlin	125	my $scale = $self->scale \|\| confess "no scale?";
183	dpavlin	73
184	dpavlin	143	my $rect = SDL::Rect->new( -x => 0, -y => 0, -width => 256 * $scale, -height => 256 * $scale );
185	dpavlin	121	my $rect_screen = SDL::Rect->new( -x => 0, -y => 0, -width => 256 * $scale, -height => 256 * $scale );
186
187			if ( $scale > 1 ) {
188			use SDL::Tool::Graphic;
189			# last parametar is anti-alias
190			my $zoomed = SDL::Tool::Graphic->zoom( $vram, $self->scale, $self->scale, 1 );
191			$zoomed->blit( $rect, $app, $rect_screen );
192			} else {
193			$vram->blit( $rect, $app, $rect_screen );
194			}
195
196	dpavlin	73	$app->sync;
197			}
198
199	dpavlin	125
200	dpavlin	76	=head2 render_mem
201
202	dpavlin	126	$self->render_mem( @mem );
203	dpavlin	76
204			=cut
205
206			sub render_mem {
207			my $self = shift;
208
209			return unless $self->show_mem;
210
211			my $pixels = pack("C*", @_);
212
213			my $vram = SDL::Surface->new(
214			-width => 256,
215			-height => 256,
216			-depth => 8, # 1 bit per pixel
217			-pitch => 256, # bytes per line
218			-from => $pixels,
219			-Rmask => 0xffff00ff,
220			-Gmask => 0xffff00ff,
221			-Bmask => 0xffff00ff,
222			);
223
224			$vram->display_format;
225
226	dpavlin	143	my $rect = SDL::Rect->new( -x => 0, -y => 0, -width => 256, -height => 256 );
227			my $rect_mem = SDL::Rect->new( -x => 256 * $self->scale, -y => 0, -width => 256, -height => 256 );
228
229	dpavlin	76	$vram->blit( $rect, $app, $rect_mem );
230
231			$app->sync;
232			}
233
234	dpavlin	98	=head2 key_pressed
235
236			Check SDL event loop if there are any pending keys
237
238			my $key = $self->key_pressed;
239
240			if ( $self->key_pressed( 1 ) ) {
241			# just to check other events, don't process
242			# key
243			}
244
245			=cut
246
247			my $pending_key;
248			my $run_for = 2000;
249
250			sub key_pressed {
251			my $self = shift;
252
253			# don't take key, just pull event
254	dpavlin	101	my $just_checking = shift \|\| 0;
255	dpavlin	98
256			my $event = $self->event \|\| confess "no event?";
257
258	dpavlin	150	if ( ! $event->poll ) {
259	dpavlin	155	return $pending_key unless $self->can('session_event');
260	dpavlin	150	if ( my $h = $self->session_event('key_pressed') ) {
261			my ( $key, $state ) = %$h;
262			if ( $state ) {
263			$pending_key = $key;
264	dpavlin	161	$self->key_down( $key );
265	dpavlin	150	} else {
266			undef $pending_key;
267	dpavlin	161	$self->key_up( $key );
268	dpavlin	150	}
269			}
270			return $pending_key;
271			}
272	dpavlin	98
273			my $type = $event->type();
274
275			exit if ($type == SDL_QUIT);
276
277	dpavlin	99	my $k = $pending_key;
278	dpavlin	98
279			if ($type == SDL_KEYDOWN) {
280			$k = $event->key_name();
281			if ( $k eq 'escape' ) {
282			$run_for = $self->cli;
283			warn "will check event loop every $run_for cycles\n";
284	dpavlin	101	$pending_key = '~';
285	dpavlin	98	} else {
286	dpavlin	101	warn "SDL_KEYDOWN ($type) = '$k'", $just_checking ? ' fake' : '', "\n";
287			$pending_key = $k;
288	dpavlin	161	$self->key_down( $k );
289	dpavlin	150	$self->record_session('key_pressed', { $k => 1 });
290	dpavlin	98	}
291			} elsif ( $type == SDL_KEYUP ) {
292			my $up = $event->key_name();
293	dpavlin	150	warn "SDL_KEYUP ($type) = '$up'", $just_checking ? ' fake' : '', "\n";
294	dpavlin	161	$self->key_up( $up );
295	dpavlin	150	$self->record_session('key_pressed', { $up => 0 });
296	dpavlin	99	undef $pending_key;
297	dpavlin	98	}
298
299	dpavlin	150	warn "key_pressed = $pending_key\n" if ( $pending_key );
300	dpavlin	99
301			return $pending_key;
302	dpavlin	98	}
303
304	dpavlin	96	=head2 loop
305
306	dpavlin	126	Implement CPU run for C<$run_run> cycles inside SDL event loop
307	dpavlin	96
308	dpavlin	126	$self->loop( sub {
309			my $run_for = shift;
310			CPU::exec( $run_for );
311			$self->render_vram;
312			} );
313
314	dpavlin	96	=cut
315
316			sub loop {
317			my $self = shift;
318	dpavlin	126	my $exec = shift;
319
320			confess "need coderef as argument" unless ref($exec) eq 'CODE';
321	dpavlin	96	my $event = SDL::Event->new();
322
323			while ( 1 ) {
324	dpavlin	98	$self->key_pressed( 1 );
325	dpavlin	126	$exec->($run_for);
326	dpavlin	96	}
327			}
328
329	dpavlin	55	=head1 SEE ALSO
330
331			L<Orao> is sample implementation using this module
332
333			=head1 AUTHOR
334
335			Dobrica Pavlinusic, C<< <dpavlin@rot13.org> >>
336
337			=head1 COPYRIGHT & LICENSE
338
339			Copyright 2007 Dobrica Pavlinusic, All Rights Reserved.
340
341			This program is free software; you can redistribute it and/or modify it
342			under the same terms as Perl itself.
343
344			=cut
345	dpavlin	148
346	dpavlin	32	1;