… | |
… | |
72 | |
72 | |
73 | @safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object'; |
73 | @safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object'; |
74 | |
74 | |
75 | # we bless all objects into (empty) derived classes to force a method lookup |
75 | # we bless all objects into (empty) derived classes to force a method lookup |
76 | # within the Safe compartment. |
76 | # within the Safe compartment. |
77 | for my $pkg (qw(cf::object cf::object::player cf::player cf::map cf::party cf::region cf::arch)) { |
77 | for my $pkg (qw(cf::object cf::object::player cf::player cf::map cf::party cf::region cf::arch cf::living)) { |
78 | no strict 'refs'; |
78 | no strict 'refs'; |
79 | @{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg; |
79 | @{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg; |
80 | } |
80 | } |
81 | |
81 | |
82 | $Event::DIED = sub { |
82 | $Event::DIED = sub { |
… | |
… | |
105 | } |
105 | } |
106 | |
106 | |
107 | ############################################################################# |
107 | ############################################################################# |
108 | # "new" plug-in system |
108 | # "new" plug-in system |
109 | |
109 | |
|
|
110 | =head3 EVENTS AND OBJECT ATTACHMENTS |
|
|
111 | |
|
|
112 | =over 4 |
|
|
113 | |
110 | =item $object->attach ($attachment, key => $value...) |
114 | =item $object->attach ($attachment, key => $value...) |
111 | |
115 | |
|
|
116 | =item $object->detach ($attachment) |
|
|
117 | |
112 | Attach a pre-registered attachment to an object. |
118 | Attach/detach a pre-registered attachment to an object. |
113 | |
119 | |
114 | =item $player->attach ($attachment, key => $value...) |
120 | =item $player->attach ($attachment, key => $value...) |
115 | |
121 | |
|
|
122 | =item $player->detach ($attachment) |
|
|
123 | |
116 | Attach a pre-registered attachment to a player. |
124 | Attach/detach a pre-registered attachment to a player. |
117 | |
125 | |
118 | =item $map->attach ($attachment, key => $value...) # not yet persistent |
126 | =item $map->attach ($attachment, key => $value...) |
119 | |
127 | |
|
|
128 | =item $map->detach ($attachment) |
|
|
129 | |
120 | Attach a pre-registered attachment to a map. |
130 | Attach/detach a pre-registered attachment to a map. |
|
|
131 | |
|
|
132 | =item $bool = $object->attached ($name) |
|
|
133 | |
|
|
134 | =item $bool = $player->attached ($name) |
|
|
135 | |
|
|
136 | =item $bool = $map->attached ($name) |
|
|
137 | |
|
|
138 | Checks wether the named attachment is currently attached to the object. |
121 | |
139 | |
122 | =item cf::attach_global ... |
140 | =item cf::attach_global ... |
123 | |
141 | |
124 | Attach handlers for global events. |
142 | Attach handlers for global events. |
125 | |
143 | |
… | |
… | |
173 | =item cf::attach_to_maps ... |
191 | =item cf::attach_to_maps ... |
174 | |
192 | |
175 | Attach handlers to all maps. |
193 | Attach handlers to all maps. |
176 | |
194 | |
177 | =item cf:register_attachment $name, ... |
195 | =item cf:register_attachment $name, ... |
|
|
196 | |
|
|
197 | Register an attachment by name through which objects can refer to this |
|
|
198 | attachment. |
|
|
199 | |
|
|
200 | =item cf:register_player_attachment $name, ... |
|
|
201 | |
|
|
202 | Register an attachment by name through which players can refer to this |
|
|
203 | attachment. |
|
|
204 | |
|
|
205 | =item cf:register_map_attachment $name, ... |
|
|
206 | |
|
|
207 | Register an attachment by name through which maps can refer to this |
|
|
208 | attachment. |
178 | |
209 | |
179 | =cut |
210 | =cut |
180 | |
211 | |
181 | # the following variables are defined in .xs and must not be re-created |
212 | # the following variables are defined in .xs and must not be re-created |
182 | our @CB_GLOBAL = (); # registry for all global events |
213 | our @CB_GLOBAL = (); # registry for all global events |
… | |
… | |
247 | } |
278 | } |
248 | |
279 | |
249 | sub _attach_attachment { |
280 | sub _attach_attachment { |
250 | my ($obj, $name, %arg) = @_; |
281 | my ($obj, $name, %arg) = @_; |
251 | |
282 | |
|
|
283 | return if exists $obj->{_attachment}{$name}; |
|
|
284 | |
252 | my $res; |
285 | my $res; |
253 | |
286 | |
254 | if (my $attach = $attachment{$name}) { |
287 | if (my $attach = $attachment{$name}) { |
255 | my $registry = $obj->registry; |
288 | my $registry = $obj->registry; |
256 | |
289 | |
… | |
… | |
262 | $obj->{$name} = \%arg; |
295 | $obj->{$name} = \%arg; |
263 | } else { |
296 | } else { |
264 | warn "object uses attachment '$name' that is not available, postponing.\n"; |
297 | warn "object uses attachment '$name' that is not available, postponing.\n"; |
265 | } |
298 | } |
266 | |
299 | |
267 | push @{$obj->{_attachment}}, $name; |
300 | $obj->{_attachment}{$name} = undef; |
268 | |
301 | |
269 | $res->{attachment} = $name; |
302 | $res->{attachment} = $name; |
270 | $res |
303 | $res |
271 | } |
304 | } |
272 | |
305 | |
273 | sub cf::object::attach { |
306 | *cf::object::attach = |
|
|
307 | *cf::player::attach = |
|
|
308 | *cf::map::attach = sub { |
274 | my ($obj, $name, %arg) = @_; |
309 | my ($obj, $name, %arg) = @_; |
275 | |
310 | |
276 | _attach_attachment $obj, $name, %arg; |
311 | _attach_attachment $obj, $name, %arg; |
277 | } |
312 | }; |
278 | |
313 | |
|
|
314 | # all those should be optimised |
|
|
315 | *cf::object::detach = |
279 | sub cf::player::attach { |
316 | *cf::player::detach = |
|
|
317 | *cf::map::detach = sub { |
280 | my ($obj, $name, %arg) = @_; |
318 | my ($obj, $name) = @_; |
281 | |
319 | |
282 | _attach_attachment KLASS_PLAYER, $obj, $name, %arg; |
320 | delete $obj->{_attachment}{$name}; |
283 | } |
321 | reattach ($obj); |
|
|
322 | }; |
284 | |
323 | |
285 | sub cf::map::attach { |
324 | *cf::object::attached = |
|
|
325 | *cf::player::attached = |
|
|
326 | *cf::map::attached = sub { |
286 | my ($obj, $name, %arg) = @_; |
327 | my ($obj, $name) = @_; |
287 | |
328 | |
288 | _attach_attachment KLASS_MAP, $obj, $name, %arg; |
329 | exists $obj->{_attachment}{$name} |
289 | } |
330 | }; |
290 | |
331 | |
291 | sub attach_global { |
332 | sub attach_global { |
292 | _attach @CB_GLOBAL, KLASS_GLOBAL, @_ |
333 | _attach @CB_GLOBAL, KLASS_GLOBAL, @_ |
293 | } |
334 | } |
294 | |
335 | |
… | |
… | |
313 | |
354 | |
314 | sub register_attachment { |
355 | sub register_attachment { |
315 | my $name = shift; |
356 | my $name = shift; |
316 | |
357 | |
317 | $attachment{$name} = [[KLASS_OBJECT, @_]]; |
358 | $attachment{$name} = [[KLASS_OBJECT, @_]]; |
|
|
359 | } |
|
|
360 | |
|
|
361 | sub register_player_attachment { |
|
|
362 | my $name = shift; |
|
|
363 | |
|
|
364 | $attachment{$name} = [[KLASS_PLAYER, @_]]; |
|
|
365 | } |
|
|
366 | |
|
|
367 | sub register_map_attachment { |
|
|
368 | my $name = shift; |
|
|
369 | |
|
|
370 | $attachment{$name} = [[KLASS_MAP, @_]]; |
318 | } |
371 | } |
319 | |
372 | |
320 | our $override; |
373 | our $override; |
321 | our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals? |
374 | our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals? |
322 | |
375 | |
… | |
… | |
346 | } |
399 | } |
347 | |
400 | |
348 | 0 |
401 | 0 |
349 | } |
402 | } |
350 | |
403 | |
|
|
404 | =item $bool = cf::invoke EVENT_GLOBAL_XXX, ... |
|
|
405 | |
|
|
406 | =item $bool = $object->invoke (EVENT_OBJECT_XXX, ...) |
|
|
407 | |
|
|
408 | =item $bool = $player->invoke (EVENT_PLAYER_XXX, ...) |
|
|
409 | |
|
|
410 | =item $bool = $map->invoke (EVENT_MAP_XXX, ...) |
|
|
411 | |
|
|
412 | Generate a global/object/player/map-specific event with the given arguments. |
|
|
413 | |
|
|
414 | This API is preliminary (most likely, the EVENT_KLASS_xxx prefix will be |
|
|
415 | removed in future versions), and there is no public API to access override |
|
|
416 | results (if you must, access C<@cf::invoke_results> directly). |
|
|
417 | |
|
|
418 | =back |
|
|
419 | |
|
|
420 | =head2 methods valid for all pointers |
|
|
421 | |
|
|
422 | =over 4 |
|
|
423 | |
|
|
424 | =item $object->valid |
|
|
425 | |
|
|
426 | =item $player->valid |
|
|
427 | |
|
|
428 | =item $map->valid |
|
|
429 | |
|
|
430 | Just because you have a perl object does not mean that the corresponding |
|
|
431 | C-level object still exists. If you try to access an object that has no |
|
|
432 | valid C counterpart anymore you get an exception at runtime. This method |
|
|
433 | can be used to test for existence of the C object part without causing an |
|
|
434 | exception. |
|
|
435 | |
|
|
436 | =back |
|
|
437 | |
|
|
438 | =cut |
|
|
439 | |
|
|
440 | *cf::object::valid = |
|
|
441 | *cf::player::valid = |
|
|
442 | *cf::map::valid = \&cf::_valid; |
|
|
443 | |
351 | ############################################################################# |
444 | ############################################################################# |
352 | # object support |
445 | # object support |
353 | |
446 | |
354 | sub instantiate { |
447 | sub instantiate { |
355 | my ($obj, $data) = @_; |
448 | my ($obj, $data) = @_; |
… | |
… | |
368 | my ($obj) = @_; |
461 | my ($obj) = @_; |
369 | my $registry = $obj->registry; |
462 | my $registry = $obj->registry; |
370 | |
463 | |
371 | @$registry = (); |
464 | @$registry = (); |
372 | |
465 | |
373 | delete $obj->{_attachment} unless @{ $obj->{_attachment} || [] }; |
466 | delete $obj->{_attachment} unless scalar keys %{ $obj->{_attachment} || {} }; |
374 | |
467 | |
375 | for my $name (@{ $obj->{_attachment} || [] }) { |
468 | for my $name (keys %{ $obj->{_attachment} || {} }) { |
376 | if (my $attach = $attachment{$name}) { |
469 | if (my $attach = $attachment{$name}) { |
377 | for (@$attach) { |
470 | for (@$attach) { |
378 | my ($klass, @attach) = @$_; |
471 | my ($klass, @attach) = @$_; |
379 | _attach @$registry, $klass, @attach; |
472 | _attach @$registry, $klass, @attach; |
380 | } |
473 | } |
… | |
… | |
385 | } |
478 | } |
386 | |
479 | |
387 | sub object_freezer_save { |
480 | sub object_freezer_save { |
388 | my ($filename, $objs) = @_; |
481 | my ($filename, $objs) = @_; |
389 | |
482 | |
390 | $filename .= ".pst"; |
|
|
391 | |
|
|
392 | if (@$objs) { |
483 | if (@$objs) { |
393 | open my $fh, ">:raw", "$filename~"; |
484 | open my $fh, ">:raw", "$filename.pst~"; |
394 | chmod $fh, SAVE_MODE; |
|
|
395 | syswrite $fh, Storable::nfreeze { version => 1, objs => $objs }; |
485 | syswrite $fh, Storable::nfreeze { version => 1, objs => $objs }; |
396 | close $fh; |
486 | close $fh; |
|
|
487 | chmod SAVE_MODE, "$filename.pst~"; |
397 | rename "$filename~", $filename; |
488 | rename "$filename.pst~", "$filename.pst"; |
398 | } else { |
489 | } else { |
399 | unlink $filename; |
490 | unlink "$filename.pst"; |
400 | } |
491 | } |
|
|
492 | |
|
|
493 | chmod SAVE_MODE, "$filename~"; |
|
|
494 | rename "$filename~", $filename; |
401 | } |
495 | } |
402 | |
496 | |
403 | sub object_thawer_load { |
497 | sub object_thawer_load { |
404 | my ($filename) = @_; |
498 | my ($filename) = @_; |
405 | |
499 | |
… | |
… | |
416 | |
510 | |
417 | @{$dst->registry} = @{$src->registry}; |
511 | @{$dst->registry} = @{$src->registry}; |
418 | |
512 | |
419 | %$dst = %$src; |
513 | %$dst = %$src; |
420 | |
514 | |
421 | $dst->{_attachment} = [@{ $src->{_attachment} }] |
515 | %{$dst->{_attachment}} = %{$src->{_attachment}} |
422 | if exists $src->{_attachment}; |
516 | if exists $src->{_attachment}; |
423 | }, |
517 | }, |
424 | ; |
518 | ; |
425 | |
519 | |
426 | ############################################################################# |
520 | ############################################################################# |
… | |
… | |
667 | my ($map) = @_; |
761 | my ($map) = @_; |
668 | |
762 | |
669 | my $path = $map->tmpname; |
763 | my $path = $map->tmpname; |
670 | defined $path or return; |
764 | defined $path or return; |
671 | |
765 | |
672 | unlink "$path.cfperl"; |
|
|
673 | unlink "$path.pst"; |
766 | unlink "$path.pst"; |
674 | }; |
767 | }; |
675 | |
768 | |
|
|
769 | # old style persistent data, TODO: remove #d# |
676 | *cf::mapsupport::on_swapin = |
770 | *cf::mapsupport::on_swapin = |
677 | *cf::mapsupport::on_load = sub { |
771 | *cf::mapsupport::on_load = sub { |
678 | my ($map) = @_; |
772 | my ($map) = @_; |
679 | |
773 | |
680 | my $path = $map->tmpname; |
774 | my $path = $map->tmpname; |
… | |
… | |
687 | |
781 | |
688 | $data->{version} <= 1 |
782 | $data->{version} <= 1 |
689 | or return; # too new |
783 | or return; # too new |
690 | |
784 | |
691 | $map->_set_obs ($data->{obs}); |
785 | $map->_set_obs ($data->{obs}); |
|
|
786 | $map->invoke (EVENT_MAP_UPGRADE); |
692 | }; |
787 | }; |
693 | |
788 | |
694 | attach_to_maps prio => -10000, package => cf::mapsupport::; |
789 | attach_to_maps prio => -10000, package => cf::mapsupport::; |
695 | |
790 | |
696 | ############################################################################# |
791 | ############################################################################# |