File: dialog.h

package info (click to toggle)
scummvm 2.9.1%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 450,580 kB
  • sloc: cpp: 4,299,825; asm: 28,322; python: 12,901; sh: 11,302; java: 9,289; xml: 7,895; perl: 2,639; ansic: 2,465; yacc: 1,670; javascript: 1,020; makefile: 933; lex: 578; awk: 275; objc: 82; sed: 11; php: 1
file content (166 lines) | stat: -rw-r--r-- 4,450 bytes parent folder | download | duplicates (3)
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
154
155
156
157
158
159
160
161
162
163
164
165
166
/* ScummVM - Graphic Adventure Engine
 *
 * ScummVM is the legal property of its developers, whose names
 * are too numerous to list here. Please refer to the COPYRIGHT
 * file distributed with this source distribution.
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 */

#ifndef STARK_RESOURCES_DIALOG_H
#define STARK_RESOURCES_DIALOG_H

#include "common/str.h"

#include "engines/stark/resources/object.h"
#include "engines/stark/resourcereference.h"

namespace Stark {

namespace Formats {
class XRCReadStream;
}

namespace Resources {

class Speech;
class Script;

/**
 * A dialog between two characters.
 *
 * Dialogs are made of a list of topics. Each topic has a list of
 * possible answers, one of which is played when the player selects the topic,
 * until all the possible answers have been played.
 *
 * Answers are made of a list of lines. All of the lines of an answer are played,
 * one after the other when an answer is played. Lines reference Speech resources.
 */
class Dialog : public Object {
public:
	static const Type::ResourceType TYPE = Type::kDialog;

	Dialog(Object *parent, byte subType, uint16 index, const Common::String &name);
	virtual ~Dialog();

	/**
	 * A topic reply
	 */
	class Reply {
	public:
		Reply();

		enum ConditionType {
			kConditionTypeAlways              = 0,
			kConditionTypeNoOtherOptions      = 1,
			kConditionTypeHasItem             = 3,
			kConditionTypeCheckValue4         = 4,
			kConditionTypeCheckValue5         = 5,
			kConditionTypeRunScriptCheckValue = 6
		};

		/** Start playing the reply. Sets the current line to the first one */
		void start();

		/** Select the next line to be played */
		void goToNextLine();

		/** Obtain the Speech resource for the current line, or null if the reply has ended */
		Speech *getCurrentSpeech();

		/** Evaluates the reply's condition */
		bool checkCondition() const;

		/** Should this reply only be made available when there are no other options left? */
		bool isLastOnly() const;

		// Static data
		Common::Array<ResourceReference> _lines;
		uint32 _conditionType;
		ResourceReference _conditionReference;
		ResourceReference _conditionScriptReference;
		uint32 _conditionReversed;
		uint32 _field_88;
		uint32 _minChapter;
		uint32 _maxChapter;
		uint32 _noCaption;
		int32 _nextDialogIndex;
		ResourceReference _nextScriptReference;

		// State
		int32 _nextSpeechIndex;

		friend class Dialog;
	};

	/**
	 * A dialog topic
	 */
	class Topic {
	public:
		Topic();

		/** Compute the next possible reply index after the currently selected reply */
		int32 getNextReplyIndex() const;

		/** Obtain the caption for the topic */
		Common::String getCaption() const;

		/** Select a reply from its index */
		Reply *startReply(uint32 index);

		/** Get the reply with the specified index */
		Reply *getReply(uint32 index);

		Common::Array<Reply> _replies;

		bool _removeOnceDepleted;
		int32 _currentReplyIndex;

		friend class Dialog;
	};

	typedef Common::Array<Topic *> TopicArray;

	// Resource API
	void readData(Formats::XRCReadStream *stream) override;
	void saveLoad(ResourceSerializer *serializer) override;

	/** List the currently available topics for this Dialog */
	TopicArray listAvailableTopics();

	/** Obtain the Dialog which should be played at the outcome of this one, if any */
	Dialog *getNextDialog(Reply *reply);

	/** Obtain the Script which should be executed after this dialog, if any */
	Script *getNextScript(Reply *reply);

	/** Get the dialog's title as shown in the diary */
	Common::String getDiaryTitle() const;

	/** Get the character's id - index in the KnowledgeSet */
	int32 getCharacter() const;

	void printData() override;

	Common::Array<Topic> _topics;
	uint32 _character;
	uint32 _hasAskAbout;
};

} // End of namespace Resources
} // End of namespace Stark

#endif // STARK_RESOURCES_DIALOG_H