Panda3D
Loading...
Searching...
No Matches
collisionHandlerEvent.h
Go to the documentation of this file.
1/**
2 * PANDA 3D SOFTWARE
3 * Copyright (c) Carnegie Mellon University. All rights reserved.
4 *
5 * All use of this software is subject to the terms of the revised BSD
6 * license. You should have received a copy of this license along
7 * with this source code in a file named "LICENSE."
8 *
9 * @file collisionHandlerEvent.h
10 * @author drose
11 * @date 2002-03-16
12 */
13
14#ifndef COLLISIONHANDLEREVENT_H
15#define COLLISIONHANDLEREVENT_H
16
17#include "pandabase.h"
18
19#include "collisionHandler.h"
20#include "collisionNode.h"
21#include "collisionEntry.h"
22
23#include "vector_string.h"
24#include "pointerTo.h"
25#include "extension.h"
26
27/**
28 * A specialized kind of CollisionHandler that throws an event for each
29 * collision detected. The event thrown may be based on the name of the
30 * moving object or the struck object, or both. The first parameter of the
31 * event will be a pointer to the CollisionEntry that triggered it.
32 */
33class EXPCL_PANDA_COLLIDE CollisionHandlerEvent : public CollisionHandler {
34PUBLISHED:
36
37public:
38 virtual void begin_group();
39 virtual void add_entry(CollisionEntry *entry);
40 virtual bool end_group();
41
42PUBLISHED:
43 INLINE void clear_in_patterns();
44 INLINE void add_in_pattern(const std::string &in_pattern);
45 INLINE void set_in_pattern(const std::string &in_pattern);
46 INLINE int get_num_in_patterns() const;
47 INLINE std::string get_in_pattern(int n) const;
48 MAKE_SEQ(get_in_patterns, get_num_in_patterns, get_in_pattern);
49
50 INLINE void clear_again_patterns();
51 INLINE void add_again_pattern(const std::string &again_pattern);
52 INLINE void set_again_pattern(const std::string &again_pattern);
53 INLINE int get_num_again_patterns() const;
54 INLINE std::string get_again_pattern(int n) const;
55 MAKE_SEQ(get_again_patterns, get_num_again_patterns, get_again_pattern);
56
57 INLINE void clear_out_patterns();
58 INLINE void add_out_pattern(const std::string &out_pattern);
59 INLINE void set_out_pattern(const std::string &out_pattern);
60 INLINE int get_num_out_patterns() const;
61 INLINE std::string get_out_pattern(int n) const;
62 MAKE_SEQ(get_out_patterns, get_num_out_patterns, get_out_pattern);
63
64 MAKE_SEQ_PROPERTY(in_patterns, get_num_in_patterns, get_in_pattern);
65 MAKE_SEQ_PROPERTY(again_patterns, get_num_again_patterns, get_again_pattern);
66 MAKE_SEQ_PROPERTY(out_patterns, get_num_out_patterns, get_out_pattern);
67
68 void clear();
69 void flush();
70
71 // These help implement Python pickle support.
72 EXTENSION(PyObject *__reduce__(PyObject *self) const);
73 EXTENSION(void __setstate__(PyObject *self, vector_uchar data));
74
75 void write_datagram(Datagram &destination) const;
76 void read_datagram(DatagramIterator &source);
77
78protected:
79 void throw_event_for(const vector_string &patterns, CollisionEntry *entry);
80 void throw_event_pattern(const std::string &pattern, CollisionEntry *entry);
81
82 vector_string _in_patterns;
83 vector_string _again_patterns;
84 vector_string _out_patterns;
85
86 int _index;
87
88 class SortEntries {
89 public:
90 INLINE bool
91 operator () (const PT(CollisionEntry) &a,
92 const PT(CollisionEntry) &b) const;
93 INLINE void operator = (const SortEntries &other);
94 };
95
96 typedef pset<PT(CollisionEntry), SortEntries> Colliding;
97 Colliding _current_colliding;
98 Colliding _last_colliding;
99
100public:
101 static TypeHandle get_class_type() {
102 return _type_handle;
103 }
104 static void init_type() {
105 CollisionHandler::init_type();
106 register_type(_type_handle, "CollisionHandlerEvent",
107 CollisionHandler::get_class_type());
108 }
109 virtual TypeHandle get_type() const {
110 return get_class_type();
111 }
112 virtual TypeHandle force_init_type() {init_type(); return get_class_type();}
113
114private:
115 static TypeHandle _type_handle;
116};
117
119
120#endif
Defines a single collision event.
void set_out_pattern(const std::string &out_pattern)
This method is deprecated; it completely replaces all the in patterns that have previously been set w...
void add_out_pattern(const std::string &out_pattern)
Adds the pattern string that indicates how the event names are generated when a collision between two...
get_num_again_patterns
Returns the number of in pattern strings that have been added.
void clear_again_patterns()
Removes all of the previously-added in patterns.
get_again_pattern
Returns the nth pattern string that indicates how the event names are generated for each collision de...
void clear_out_patterns()
Removes all of the previously-added in patterns.
void add_again_pattern(const std::string &again_pattern)
Adds the pattern string that indicates how the event names are generated when a collision between two...
get_out_pattern
Returns the nth pattern string that indicates how the event names are generated for each collision de...
get_num_in_patterns
Returns the number of in pattern strings that have been added.
void add_in_pattern(const std::string &in_pattern)
Adds a pattern string to the list of events that will be generated in response to a collision.
void clear_in_patterns()
Removes all of the previously-added in patterns.
void flush()
Same as clear() except "out" events are thrown.
void set_in_pattern(const std::string &in_pattern)
This method is deprecated; it completely replaces all the in patterns that have previously been set w...
CollisionHandlerEvent()
The default CollisionHandlerEvent will throw no events.
get_in_pattern
Returns the nth pattern string that indicates how the event names are generated for each collision de...
void read_datagram(DatagramIterator &source)
Restores the object state from the given datagram, previously obtained using __getstate__.
void set_again_pattern(const std::string &again_pattern)
This method is deprecated; it completely replaces all the in patterns that have previously been set w...
void clear()
Empties the list of elements that all colliders are known to be colliding with.
get_num_out_patterns
Returns the number of in pattern strings that have been added.
void write_datagram(Datagram &destination) const
Serializes this object, to implement pickle support.
virtual bool end_group()
Called by the CollisionTraverser at the completion of all collision detections for this traversal.
virtual void begin_group()
Will be called by the CollisionTraverser before a new traversal is begun.
virtual void add_entry(CollisionEntry *entry)
Called between a begin_group() .
A class to retrieve the individual data elements previously stored in a Datagram.
An ordered list of data elements, formatted in memory for transmission over a socket or writing to a ...
Definition datagram.h:38
TypeHandle is the identifier used to differentiate C++ class types.
Definition typeHandle.h:81
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
void register_type(TypeHandle &type_handle, const std::string &name)
This inline function is just a convenient way to call TypeRegistry::register_type(),...
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.