1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
#pragma once
#include "inode.h"
#include "ientity.h"
#include <memory>
#include "wxutil/dataview/TreeModel.h"
#include "Conversation.h"
namespace conversation
{
struct ConvEntityColumns :
public wxutil::TreeModel::ColumnRecord
{
ConvEntityColumns() :
displayName(add(wxutil::TreeModel::Column::String)),
entityName(add(wxutil::TreeModel::Column::String))
{}
wxutil::TreeModel::Column displayName;
wxutil::TreeModel::Column entityName;
};
struct ConversationColumns :
public wxutil::TreeModel::ColumnRecord
{
ConversationColumns() :
index(add(wxutil::TreeModel::Column::Integer)),
name(add(wxutil::TreeModel::Column::String))
{}
wxutil::TreeModel::Column index; // conversation index
wxutil::TreeModel::Column name; // conversation name
};
/**
* Representation of a single conversation entity (atdm:conversation_info).
*
* In The Dark Mod, conversations are stored as numbered spawnargs on a conversation
* entity, e.g. <b>conv_1_name</b>. Each conversation entity can contain any number
* of conversations described in this way.
*
* The ConversationEntity class provides an object-oriented view of the conversation
* information, by wrapping a pointer to an Entity and providing methods to
* retrieve and manipulate conversation information without seeing the spawnargs
* directly. When changes are completed, the ConversationEntity::writeToEntity()
* method is invoked to save all changes in the form of spawnargs.
*
* @see Entity
*/
class ConversationEntity
{
// The actual entity's world node and entity pointer
scene::INodeWeakPtr _entityNode;
// Indexed conversations
ConversationMap _conversations;
public:
/**
* Construct an ConversationEntity wrapper around the given Node.
*/
ConversationEntity(const scene::INodePtr& node);
/**
* Return an Conversation reference by numeric index.
*
* @param iIndex
* The numberic index of the conversation to retrieve.
*
* @return
* A non-const reference to an Conversation object, corresponding to the
* given index. If the provided index did not previously exist, a new
* Conversation object will be created and returned.
*/
Conversation& getConversation(int iIndex) {
return _conversations[iIndex];
}
// Returns the highest used conversation index (will return -1 if no conversations are present)
int getHighestIndex();
/**
* Add a new conversation, starting from the first unused conversation ID.
* Will return the ID of the newly inserted conv
*/
int addConversation();
/**
* Delete a numbered conversation. This re-orders all conversations so that the
* numbering is consistent again (deleting conv 2 will re-number 3 => 2, 4 => 3, etc.)
*/
void deleteConversation(int index);
/**
* Move the conversation with the given index either up or down.
* Will return the conversation's index after the move
*/
int moveConversation(int index, bool moveUp);
/**
* Clear all conversations.
*/
void clearConversations() {
_conversations.clear();
}
/**
* Test whether this entity contains conversations or not.
*/
bool isEmpty() const {
return _conversations.empty();
}
/**
* Delete the actual entity node from the map. This will render any further
* operations on this ConversationEntity undefined, and it should immediately
* be deleted.
*/
void deleteWorldNode();
/**
* Populate the given list store with the conversations from this entity.
*
* @param store
* The list store to populate. This must have 2 columns -- an integer
* column for the conversation number, and a text column for the name.
*/
void populateListStore(wxutil::TreeModel& store, const ConversationColumns& columns) const;
/**
* Write all conversation data to keyvals on the underlying entity.
*/
void writeToEntity();
private:
// Removes all conversation-related spawnargs from the given entity
void clearEntity(Entity* entity);
};
/**
* Conversation entity pointer type.
*/
typedef std::shared_ptr<ConversationEntity> ConversationEntityPtr;
/**
* Conversation entity named map type.
*/
typedef std::map<std::string, ConversationEntityPtr> ConversationEntityMap;
} // namespace conversation
|
