Modification of Items

Many actions of the Adventure Language simply describe how to change the game. They modify the items the game is made of.

ChangeList

Item type	ChangeList
Description	modify the list of an item
Action	adds / removes item to / from list
Condition	true, if performed

Key	Type	Default	Description
list	item		an item with a item list
item	item		the item to add or remove
position	value	-1	the position of the item; see definitions for special values
update	bool	1	update flag; if false, the list change will not take effect immediately
insertAfter	Elems	<>	the position is relative to an element of the list
backwards	bool	0	the position is relative to the end of the list

Several items contain a list of references to other items. There is one action to modify the list of all of these items. The update flag should only be set to false, if other changes of the same list follow immediately.

List item type	Element item type	Update flag
Scene	Region	repaint scene
Dialog	DialogText	repaint dialog
Region	Action	-
Object	Action	-
Sequence	Actions	-
Condition	Conditions	-

ChangeImage

Item type	ChangeImage
Description	exchanges an image
Action	sets a new image
Condition	true, if performed

Key	Type	Default	Description
item	item	<>	item with image
image	Images	<>	new image; no item means no image
redraw	bool	1	if false, the change is not drawn immediately

If the item is the empty item <>, the player image for dialogs defined in the Game item is changed. Items with images are Scene, Region, Object, and Dialog.

ChangeFile

Item type	ChangeFile
Description	exchanges a file
Action	sets a new file
Condition	true, if performed

Key	Type	Default	Description
item	Media		item to change
file	file	""	new file

ChangeFile may be applied to PlayAudio and PlayVideo.

ChangeFrame

Item type	ChangeFrame
Description	changes the frame of an animation
Action	sets a new frame
Condition	true, if performed

Key	Type	Default	Description
item	Frames		item to change
frame	value	0	the frame value
type	byte	=	the start and direction of the change

ChangeFrame may be applied to Animation and Motion. The new frame will be used, when the next frame change occurs. If the new frame is outside of the frame length, the frame will be adapted as if the frames would be repeated in a loop.

ChangeAction

Item type	ChangeAction
Description	exchanges an action
Action	sets a new action
Condition	true, if performed

Key	Type	Default	Description
item	item		item to change
action	Actions	<>	new action
type	byte	s	flag for action type; see definitions for values

ChangePlace

Item type	ChangePlace
Description	changes placement
Action	sets a new placement
Condition	true, if performed

Key	Type	Default	Description
place	Places		placeable item
position	vpoint		new position
type	byte	+	type of placement; see definitions for valid types
stretch	bool	0	if true, size is changed instead of position
redraw	bool	1	if true, the item is redrawn immediately
angle	value	0	angle in degree

ChangePlace may be applied to any item with an image and to PlayVideo. In addition, it may be used to change the position of scenes and characters. The angle key is only valid for characters. A character is stopped if walking, before change place is performed. A character may be placed at a new position with a new orientation or may walk as if the player has changed its position.