Character.ChangeRoomAutoPosition(int room_number, optional int newPosition)
Changes the room that the character is in, and positions him along one of the room edges.
This command simulates the behaviour of the old "Go to room" interaction command from AGS 2.72
and previous versions. If newPosition is not specified or is 0, the character will be
placed on the opposite side of the new room, if he is within 10 pixels of a room edge in the
current room.
Altenatively, you can specify the position where he will get placed in the new room.
newPosition can be 1000 for the left edge, 2000 for the right edge, 3000 for the
bottom edge and 4000 for the top edge. Then, add on the offset within that edge where
you want to place the character, in normal room co-ordinates.
IMPORTANT: This command does not change the room immediately; instead, it
will perform the actual room change once your script function has finished
(This is to avoid problems with unloading the script while it is still
running). This means that you should not use any other commands which rely
on the new room (object positionings, and so on) after this command within
the same function.
NOTE: This command can only be used with the player character.
Example:
player.ChangeRoomAutoPosition(4, 2100);
will move the player character to room 4 and place him half way down the right hand side of the screen.
This will also mean that the game moves into room 4.
See Also: Character.ChangeRoom
| 
Home