author | truebrain |
Wed, 26 Mar 2008 15:17:40 +0000 | |
branch | noai |
changeset 9823 | 0b7f816cf46f |
parent 9801 | 03a3eebd7fb7 |
child 9829 | 80fbe02a4184 |
permissions | -rw-r--r-- |
9511 | 1 |
/* $Id$ */ |
2 |
||
3 |
/** @file ai_sign.hpp Everything to query and build signs */ |
|
4 |
||
5 |
#ifndef AI_SIGN_HPP |
|
6 |
#define AI_SIGN_HPP |
|
7 |
||
8 |
#include "ai_object.hpp" |
|
9 |
||
10 |
/** |
|
9513
258f78c74b0c
(svn r9410) [NoAI] -Fix: some copy-paste mistakes...
rubidium
parents:
9511
diff
changeset
|
11 |
* Class that handles all sign related functions. |
9511 | 12 |
*/ |
13 |
class AISign : public AIObject { |
|
14 |
public: |
|
15 |
/** |
|
9529
5f26f4bc574b
(svn r9450) [NoAI] -Fix: don't allow static-method calls from SQ to non-static functions
truelight
parents:
9526
diff
changeset
|
16 |
* The name of the class, needed by several sub-processes. |
5f26f4bc574b
(svn r9450) [NoAI] -Fix: don't allow static-method calls from SQ to non-static functions
truelight
parents:
9526
diff
changeset
|
17 |
*/ |
5f26f4bc574b
(svn r9450) [NoAI] -Fix: don't allow static-method calls from SQ to non-static functions
truelight
parents:
9526
diff
changeset
|
18 |
static const char *GetClassName() { return "AISign"; } |
5f26f4bc574b
(svn r9450) [NoAI] -Fix: don't allow static-method calls from SQ to non-static functions
truelight
parents:
9526
diff
changeset
|
19 |
|
5f26f4bc574b
(svn r9450) [NoAI] -Fix: don't allow static-method calls from SQ to non-static functions
truelight
parents:
9526
diff
changeset
|
20 |
/** |
9511 | 21 |
* Gets the maximum sign index; there are no valid signs with a higher index. |
9513
258f78c74b0c
(svn r9410) [NoAI] -Fix: some copy-paste mistakes...
rubidium
parents:
9511
diff
changeset
|
22 |
* @return the maximum sign index. |
9511 | 23 |
* @post return value is always non-negative. |
24 |
*/ |
|
9737
ee408edf3851
(svn r12216) [NoAI] -Codechange: made most functions 'static', which removes the need to create an instance to get, for example, engine information, and therefor heavily simplifying AI creation (Morloth)
truebrain
parents:
9596
diff
changeset
|
25 |
static SignID GetMaxSignID(); |
9511 | 26 |
|
27 |
/** |
|
9513
258f78c74b0c
(svn r9410) [NoAI] -Fix: some copy-paste mistakes...
rubidium
parents:
9511
diff
changeset
|
28 |
* Gets the number of signs. This is different than GetMaxSignID() |
9511 | 29 |
* because of the way OpenTTD works internally. |
30 |
* @return the number of signs. |
|
31 |
* @post return value is always non-negative. |
|
32 |
*/ |
|
9737
ee408edf3851
(svn r12216) [NoAI] -Codechange: made most functions 'static', which removes the need to create an instance to get, for example, engine information, and therefor heavily simplifying AI creation (Morloth)
truebrain
parents:
9596
diff
changeset
|
33 |
static int32 GetSignCount(); |
9511 | 34 |
|
35 |
/** |
|
36 |
* Checks whether the given sign index is valid. |
|
37 |
* @param sign_id the index to check. |
|
38 |
* @return true if and only if the sign is valid. |
|
39 |
*/ |
|
40 |
static bool IsValidSign(SignID sign_id); |
|
41 |
||
42 |
/** |
|
43 |
* Get the text on the sign. |
|
44 |
* @param sign_id the sign to get the text of. |
|
45 |
* @pre sign_id has to be valid (use IsValidSign()). |
|
46 |
* @return the text on the sign. |
|
47 |
* @note the returned name must be free'd (C++ only). |
|
48 |
*/ |
|
9737
ee408edf3851
(svn r12216) [NoAI] -Codechange: made most functions 'static', which removes the need to create an instance to get, for example, engine information, and therefor heavily simplifying AI creation (Morloth)
truebrain
parents:
9596
diff
changeset
|
49 |
static char *GetText(SignID sign_id); |
9511 | 50 |
|
51 |
/** |
|
52 |
* Gets the location of the sign. |
|
53 |
* @param sign_id the sign to get the location of. |
|
54 |
* @pre sign_id has to be valid (use IsValidSign()). |
|
55 |
* @return the location of the sign. |
|
9801
03a3eebd7fb7
(svn r12307) [NoAI] -Codechange: as followup on r12303 (trunk), use ::IsValidTile to check if a tile is inside the map, instead of all our custom ways
truebrain
parents:
9737
diff
changeset
|
56 |
* @post return value is always valid with AIMap::IsValidTile(). |
9511 | 57 |
*/ |
9737
ee408edf3851
(svn r12216) [NoAI] -Codechange: made most functions 'static', which removes the need to create an instance to get, for example, engine information, and therefor heavily simplifying AI creation (Morloth)
truebrain
parents:
9596
diff
changeset
|
58 |
static TileIndex GetLocation(SignID sign_id); |
9511 | 59 |
|
60 |
/** |
|
61 |
* Removes a sign from the map. |
|
62 |
* @param sign_id the sign to remove. |
|
63 |
* @pre sign_id has to be valid (use IsValidSign()). |
|
64 |
* @return true if and only if the sign has been removed. |
|
65 |
*/ |
|
9737
ee408edf3851
(svn r12216) [NoAI] -Codechange: made most functions 'static', which removes the need to create an instance to get, for example, engine information, and therefor heavily simplifying AI creation (Morloth)
truebrain
parents:
9596
diff
changeset
|
66 |
static bool RemoveSign(SignID sign_id); |
9511 | 67 |
|
68 |
/** |
|
69 |
* Builds a sign on the map. |
|
70 |
* @param location the place to build the sign. |
|
71 |
* @param text the text to place on the sign. |
|
9801
03a3eebd7fb7
(svn r12307) [NoAI] -Codechange: as followup on r12303 (trunk), use ::IsValidTile to check if a tile is inside the map, instead of all our custom ways
truebrain
parents:
9737
diff
changeset
|
72 |
* @pre AIMap::IsValidTile(location). |
9511 | 73 |
* @pre text is not NULL and non-empty, i.e. length is positive. |
74 |
* @return the SignID of the build sign (use IsValidSign() to check for validity). |
|
9562
2f4087d63527
(svn r9500) [NoAI] -Add: document behavoir in test-mode
truelight
parents:
9541
diff
changeset
|
75 |
* In test-mode it returns 0 if successful, or any other value to indicate |
2f4087d63527
(svn r9500) [NoAI] -Add: document behavoir in test-mode
truelight
parents:
9541
diff
changeset
|
76 |
* failure. |
9511 | 77 |
*/ |
9737
ee408edf3851
(svn r12216) [NoAI] -Codechange: made most functions 'static', which removes the need to create an instance to get, for example, engine information, and therefor heavily simplifying AI creation (Morloth)
truebrain
parents:
9596
diff
changeset
|
78 |
static SignID BuildSign(TileIndex location, const char *text); |
9511 | 79 |
}; |
80 |
||
81 |
#endif /* AI_SIGN_HPP */ |