2.54 Remains to Merge at No. 9 (17JUNE2017)

// Beta 52


The ZScript language now supports function pointers, using the AT_SIGN token (@) as a delimiter.

The ZScript language now supports C-Style comment blocks using the traditional syntax of:

/*
	COMMENT BLOCK

*/

//////////////
//  Global  //
//////////////

/************************************************************************************************************/

	//! Not very useful unless we allow loading aux slots, for script changing.
int Game->GetGlobalScript(int ptr[]);	ZASM Instruction:
					GETGLOBSCRIPT

/**
* Returns the number of the global script with the given name or -1 if there is
* no such script. The script name should be passed as a string.
* (!) This was added at 2.54 beta 52.5, 1st June 2017
*
*/ Example Use:


/************************************************************************************************************/

//////////////
///  GAME  ///
//////////////


void SetScreenFlag(int map, int screen, int flag, bool state);	ZASM Instruction:
								SCREENFLAG

/**
*
*
*/ Example Use:



/************************************************************************************************************/

void SetScreenFlag(int map, int screen, int flag, bool state);	ZASM Instruction:
								SCREENFLAG

/**
*
*
*/ Example Use:


/************************************************************************************************************/


/************************************************************************************************************/

bool NoUncap				ZASM: THROTTLEFPS

/**
	* If set true, pressing the tilde key, or toggling Uncap in the menus does nothing.
	* This does NOT return if the game is throttled, nor doe sit return the framerate.
	* It merely blocks the user abilisy to uncap.

/************************************************************************************************************/
DEBUGGING: These might find their way into namespace Debug->
/************************************************************************************************************/



/************************************************************************************************************/



/////////////
///  NPC  ///
/////////////


float UID;				ZASM Instruction:
					NPCUID
	/**
	* Returns the UID of an npc.
	*/ Example Use:

/************************************************************************************************************/


//////////////
///  Link  ///
//////////////


int WalkSpeed
				ZASM Instruction
				LINKWALKSPEED

* THis is the speed multiplier for Link's step. I have proven that it works, but it needs to be a float
* to work properly, as desired.

/************************************************************************************************************/

//! Should reference into ZScript::Rules

bool Diagonal;			ZASM Instruction:
				LINKDIAG

/**
* This corresponds to whether 'Diagonal Movement' is enabled, or not.
* This will initially return true, or false, based on the setting in Quest->Graphics->Sprites->Link.
* You may enable, or disable diagonal movement by writing to this value.
*
*/ Example Use: !#!

/************************************************************************************************************/

//! Should reference into ZScript::Rules

bool BigHitbox;			ZASM Instruction:
				LINKBIGHITBOX

/**
* This corresponds to whether 'Big Hitbox' is enabled, or not.
* This will initially return true, or false, based on the setting in Quest->Graphics->Sprites->Link.
* You may enable, or disable big hitbox, by writing to this value.
*
*/ Example Use: !#!

/************************************************************************************************************/
All of these require a new rewrite of Warp.
/************************************************************************************************************/

void WarpDx(int dmap, int screen, int x, int y, int effect, int sound)


/************************************************************************************************************/

int WarpEffect;			ZASM Instruction:
				WARPEFFECT

/**
* Sets a warp effect type prior to doing Screen->Warp
* These replicate the in-build effects for tile warps.
* see 'std_constants.zh' under WARPFX_* for a list of effects.
*
*/ Example Use: !#!

/************************************************************************************************************/

int WarpSound;			ZASM Instruction:
				LINKWARPSOUND

/**
* Setting this to a value other than '0' will play that sound when Link warps.
*
*/ Example Use: !#!

/************************************************************************************************************/

bool SideWarpSounds;		ZASM Instruction:
				PLAYWARPSOUND

/**
* By default, even if you set a warp sound, it will not play in sidewarps.
* If you enable this setting, the sound will play in side warps.
* At present, this does not disable playing the sound otherwise. Set Link->WarpSound = 0 to do that.
*
*/ Example Use: !#!

/************************************************************************************************************/

bool PitWarpSounds;		ZASM Instruction:
				PLAYPITWARPSFX

/**
* By default, even if you set a warp sound, it will not play in pit warps.
* If you enable this setting, the sound will play in a pit warp, one time.
* This value resets after the pit warp, so it is mandatory to re-set it each time tat you desire a pit warp
* 	to play a sound. Do this before Waitdraw().
*
*/ Example Use: !#!

/************************************************************************************************************/

int UseWarpReturn;		ZASM Instruction:
				LINKRETSQUARE

/**
* Setting this to a value between 0 and 3 will change the target return square for Link->Warp
* Valid values are: 0 (A), 1 (B), 2 (C), and 3 (D). Other values will be clamed within this range.
*
*/ Example Use: !#!


/************************************************************************************************************/
All of the following require refactoring of Link collisiom.
/************************************************************************************************************/

int HitHeight;				ZASM Instruction:
					LINKHYSZ

/**
* link's Hitbox height in pixels starting from his 0x,0y (upper-left) corner, going down.
* Note that this works on a per-sprite, per-direction basis.
* If you wish to extend Link's hitbox upwards on the Y-Axis, set this value, and adjust his HitYOffset.
* You can read a value that you assign to this (e.g. for custom collision functions).
* This value is not preserved through sessions: Loading a saved game will reset it to the default.
*
*/ Example Use: !#!

/************************************************************************************************************/

int HitWidth;				ZASM Instruction:
					LINKHXSZ

/**
* Link's Hitbox width in pixels starting from his x0,y0 (upper-left) corner, going right.
* Note that this works on a per-sprite, per-direction basis.
* This value is not preserved through sessions: Loading a saved game will reset it to the default.
*
*/ Example Use: !#!

/************************************************************************************************************/
//Not implemented. Use Extend and Sprites.
int TileWidth;				ZASM Instruction:
					LINKTYSZ
/**
* Link's width, in tiles.
* This is not usable, as Link->Extend cannot be set.
* While setting it is not syntactically incorrect, it does nothing.
* You can read a value that you assign to this (e.g. for custom/proxy sprite drawing).
* This value is not preserved through sessions: Loading a saved game will reset it to the default.
*
*/ Example Use: !#!

/************************************************************************************************************/
//Not implemented. Use Extend and Sprites.
int TileHeight;				ZASM Instruction:
					LINKTXSZ

/**
* Link's height, in tiles.
* This is not usable, as Link->Extend cannot be set.
* While setting it is not syntactically incorrect, it does nothing.
* You can read a value that you assign to this (e.g. for custom/proxy sprite drawing).
* This value is not preserved through sessions: Loading a saved game will reset it to the default.
*
*/ Example Use: !#!

/************************************************************************************************************/
//Not implemented.
int HitZHeight;				ZASM Instruction:
					LINKHZSZ

/**
* The Z-axis height of Link's hitbox, or collision rectangle.
* The lower it is, the lower a flying or jumping enemy must fly in order to hit Link.
* To jump over a sprite, you must be higher than its Z + HitZHeight.
* The values of DrawZOffset and HitZHeight are linked. Setting one, also sets the other.
* Writing to this is ignored unless Extend is set to values >=3.
* This is not usable, as Link->Extend cannot be set.
* While setting it is not syntactically incorrect, it does nothing.
* You can read a value that you assign to this (e.g. for custom collision functions).
* This value is not preserved through sessions: Loading a saved game will reset it to the default.
*
*/ Example Use: !#!

/************************************************************************************************************/

int HitXOffset;				ZASM Instruction:
					LINKHXOFS

/**
* The X offset of Link's hitbox, or collision rectangle.
* Setting it to positive or negative values will move Link's hitbox left or right.
* Writing to this is ignored unless Extend is set to values >=3.
* Note that this works on a per-sprite, per-direction basis.
* You can read a value that you assign to this (e.g. for custom collision functions).
* This value is not preserved through sessions: Loading a saved game will reset it to the default.
*
*/ Example Use: !#!

/************************************************************************************************************/

int HitYOffset;				ZASM Instruction:
					LINKHYOFS

/**
* The Y offset of Link's hitbox, or collision rectangle.
* Setting it to positive or negative values will move Link's hitbox up or down.
* Writing to this is ignored unless Extend is set to values >=3.
* Note that this works on a per-sprite, per-direction basis.
* You can read a value that you assign to this (e.g. for custom collision functions).
* This value is not preserved through sessions: Loading a saved game will reset it to the default.
*
*/ Example Use: !#!

/************************************************************************************************************/
//Not yet implemented
int DrawXOffset;			ZASM Instruction:
					LINKXOFS

/**
* The X offset of Link's sprite.
* Setting it to positive or negative values will move the sprite's tiles left or right relative to its position.
* Writing to this is ignored unless Extend is set to values >=3.
* This is not usable, as Link->Extend cannot be set.
* While setting it is not syntactically incorrect, it does nothing.
* You can read a value that you assign to this.
* This value is not preserved through sessions: Loading a saved game will reset it to the default.
*
*/ Example Use: !#!

/************************************************************************************************************/
//Not yet implemented
int DrawYOffset;			ZASM Instruction:
					LINKYOFS

/**
* The Y offset of Link's sprite.
* Setting it to positive or negative values will move the sprite's tiles up or down relative to its position.
* Writing to this is ignored unless Extend is set to values >=3.
* This is not usable, as Link->Extend cannot be set.
* While setting it is not syntactically incorrect, it does nothing.
* You can read a value that you assign to this.
* This value is not preserved through sessions: Loading a saved game will reset it to the default.
*
*/ Example Use: !#!

/************************************************************************************************************/


/************************************************************************************************************/
THe remainder of these are up for debate. I beleive they should exist, as they are exceptionally valuable. .
/************************************************************************************************************/

int Animation;				ZASM Instruction:
					LINKANIMTYPE

/**
* Link;s Animation style, as set in Quest->Graphics->Sprites->Link
* Valid types are 0, 1, 2, and 3.
*
*/ Example Use: !#!

/************************************************************************************************************/

int WalkASpeed;				ZASM Instruction:
					LINKWALKANMSPD

/**
* Link's Walking Animation speed as set in Quest->Graphics->Sprites->Link
* valid types are:
*
*/ Example Use: !#!

/************************************************************************************************************/

int SwimASpeed;				ZASM Instruction:
					LINKSWIMSPD
/**
* Link's Swiming Animation speed as set in Quest->Graphics->Sprites->Link
* valid types are:
*
*/ Example Use: !#!

/************************************************************************************************************/

int Extend;				ZASM Instruction:
					LINKEXTEND


/**
* Sets the extend value for all of Link's various actions for his current sprite, and direction.
* This is equivalent to the Extend value set in Quest->Graphics->Sprites->Link when selecting
* a tile, click on his sprites for any given action, and press the 'x' key.
* The options are 16x16, 16x32, and 32x32; which correspond to Extend values of ( 0, 1, and 2 )
* respectively.
*
* This also returns the present extend value of Link's sprite for his current direction and sprite.
*
* You may force-set all sprites, and directions to an extend value by assigning a negative number to
* this variable, where -1 == 0 -2 == 1, -3 == 2, -4 == 3, and -5 == 4.
*
* See the 'LINKEXTEND_* values in std_constants for more details.
*/

/************************************************************************************************************/

int GetLinkExtend(int sprite, int dir);		ZASM Instruction:
						SETLINKEXTEND

/**
* Gets the extend value for one of Link's various actions based on a direction.
* This is equivalent to the Extend value set in Quest->Graphics->Sprites->Link when selecting a tile.
* See 'std_constants' entries under LSPR_* for a list of the various attributes for 'sprite'.
*/

/************************************************************************************************************/

void SetLinkExtend(int sprite, int dir, int extend);
						ZASM Instruction:
						SETLINKEXTEND

/**
* Sets the extend value for one of Link's various actions.
* This is equivalent to the Extend value set in Quest->Graphics->Sprites->Link when selecting a tile.
* 'sprite' is the 'action', 'dir' is the sprite direction, and 'extend' is a value between 1 and 3.
* An extend value of '4' is reserved for future implementations of Link->Hit/DrawOffsets ad HitWidth/height.
* See 'std_constants' entries under LSPR_* for a list of the various attributes for 'sprite'.
*/

/************************************************************************************************************/

void SetLinkTile(int sprite, int dir, int tile)
				ZASM Instruction:
				SETLINKTILE

/**
* Sets the tile for Link's various actions. This is intended to work as OTile for Link.
* 'sprite' is the action for the tile. See Quest->Graphics->Sprites->Link for a visual reference.
* 'tile is the base tile for the sequence. It uses the animation style set in the sprites editor.
* 'dir' is the direction for the tile.
* See 'std_constants' entries under LSPR_* for a list of the various attributes for 'sprite'.
*
* See the 'LINKEXTEND_* values in std_constants for more details on possible extend values.
*/

/************************************************************************************************************/

int GetLinkTile(int sprite, int dir)
				ZASM Instruction:
				LINKGETTILE

/**
* Returns the OTile for one of Link's various actions.
* 'sprite' is the action for the tile. See Quest->Graphics->Sprites->Link for a visual reference.
* 'dir' is the direction for the tile.
* See 'std_constants' entries under LSPR_* for a list of the various attributes for 'sprite'.
*/


/************************************************************************************************************/


//////////////
///  Item  ///
//////////////


float UID;				ZASM Instruction:
					ITEMUID
	/**
	* Returns the UID of an item.
	*/ Example Use:

/************************************************************************************************************/



int ACLock;				ZASM Instruction:
					ITEMACLC

/**
* Returns the present tick of the animation clock.
*
*/

/************************************************************************************************************/


////////////
///  npc ///
////////////

float UID;				ZASM Instruction:
					NPCUID
	/**
	* Returns the UID of an npc.
	*/ Example Use:

/************************************************************************************************************/


/////////////////
///  LWeapon  ///
/////////////////


float UID;				ZASM Instruction:
					LWPNUID
	/**
	* Returns the UID of an lweapon.
	*/ Example Use:



/************************************************************************************************************/


/////////////////
///  EWeapon  ///
/////////////////

float UID;				ZASM Instruction:
					EWPNUID
	/**
	* Returns the UID of an eweapon.
	*/ Example Use:


///////////////
///  Audio  ///
///////////////

THis is a new pointer to house *all* audio instructions, including enhanced music instructions.

hese are implemented, but the functions wer enever moved tot he new ack-end, so they do not work.


/************************************************************************************************************/

void ContinueSound(int sfx); 					ZASM Instruction:
								CONTINUESFX
/**
*
*
*/ Example Use:

/************************************************************************************************************/

void AdjustSound(int sfx, int pan, bool loop);			ZASM Instruction:
								ADJUSTSFX
/**
* Adjusts properties of a sound effect.
*
*/ Example Use:


/************************************************************************************************************/

///////////////
///  Debug  ///
///////////////

This is a new pointer, under which functions that can have dangerous ramifications if imporoperly used will go.
The variables are returning a function label error, but the functions work.

int RefFFC; 				ZASM Instruction:
					REFFFC
	/**
	* Returns the present ffc refrence from the stack. FOR DEBUGGING ONLY!
	* THIS WILL BE DISABLED IN RELEASE BUILDS !
	*/ Example Use:

/************************************************************************************************************/

int RefItem; 				ZASM Instruction:
					REFITEM
	/**
	* Returns the present item refrence from the stack. FOR DEBUGGING ONLY!
	* THIS WILL BE DISABLED IN RELEASE BUILDS !
	*/ Example Use:

/************************************************************************************************************/

int RefItemdata; 			ZASM Instruction:
					REFIDATA
	/**
	* Returns the present itemdata refrence from the stack. FOR DEBUGGING ONLY!
	* THIS WILL BE DISABLED IN RELEASE BUILDS !
	*/ Example Use:

/************************************************************************************************************/

int RefLWeapon; 			ZASM Instruction:
					REFLWPN
	/**
	* Returns the present lweapon refrence from the stack. FOR DEBUGGING ONLY!
	* THIS WILL BE DISABLED IN RELEASE BUILDS !
	*/ Example Use:

/************************************************************************************************************/

int RefEWeapon; 			ZASM Instruction:
					REFEWPN
	/**
	* Returns the present eweapon refrence from the stack. FOR DEBUGGING ONLY!
	* THIS WILL BE DISABLED IN RELEASE BUILDS !
	*/ Example Use:

/************************************************************************************************************/

int RefNPC; 				ZASM Instruction:
					REFNPC
	/**
	* Returns the present npc refrence from the stack. FOR DEBUGGING ONLY!
	* THIS WILL BE DISABLED IN RELEASE BUILDS !
	*/ Example Use:

/************************************************************************************************************/

int SP; 				ZASM Instruction:
					SP
	/**
	* Returns the value of the stack pointer. FOR DEBUGGING ONLY!
	* THIS WILL BE DISABLED IN RELEASE BUILDS !
	*/ Example Use:

/************************************************************************************************************/

int GetNPCPointer(npc *ptr[]);		ZASM Instruction:
					NPCARRPTR
	/**
	* Returns the pointer of a item array as a float.
	*/ Example Use:
		item arr[16];
		int size = SizeOfArray( GetPointer(arr) );
		//Size == 16

/************************************************************************************************************/

npc SetNPCPointer(int value);		ZASM Instruction:
					NPCARRPTR2
	/**
	* Converts an int pointer to the npc type, for assigning.
	*/ Example Use:
		npc arr[16]; npc arrB[2]; int arrC[2];
		arrC[0] = GetPointer(arr);
		arrB[0] = SetPointer(arrC[0]);

/************************************************************************************************************/


int GetBoolPointer(bool *ptr[]);		ZASM Instruction:
					BOOLARRPTR
	/**
	* Returns the pointer of a bool array as a float.
	*/ Example Use:
		bool arr[16];
		int size = SizeOfArray( GetPointer(arr) );
		//Size == 16


/************************************************************************************************************/

npc GetBoolPointer(int value);		ZASM Instruction:
					BOOLARRPTR2
	/**
	* Converts an bool pointer to the int type, for assigning.
	*/ Example Use:
		bool arr[16]; int arrB[2];
		arrB[0] = Deug->GetBoolPointer(arr);



/************************************************************************************************************/

int GetFFCPointer(ffc *ptr[]);		ZASM Instruction:
					FFCARRPTR
	/**
	* Returns the pointer of a ffc array as a float.
	*/ Example Use:
		ffc arr[16];
		int size = SizeOfArray( GetPointer(arr) );
		//Size == 16

/************************************************************************************************************/

ffc SetFCCPointer(int value);		ZASM Instruction:
					FFCARRPTR2
	/**
	* Converts an int pointer to the ffc type, for assigning.
	*/ Example Use:
		ffc arr[16]; ffc arrB[2]; int arrC[2];
		arrC[0] = GetPointer(arr);
		arrB[0] = SetPointer(arrC[0]);

/************************************************************************************************************/

int GetItemPointer(item *ptr[]);		ZASM Instruction:
					ITEMARRPTR
	/**
	* Returns the pointer of a item array as a float.
	*/ Example Use:
		item arr[16];
		int size = SizeOfArray( GetPointer(arr) );
		//Size == 16

/************************************************************************************************************/

item SetItemPointer(int value);		ZASM Instruction:
					ITEMARRPTR2
	/**
	* Converts an int pointer to the item type, for assigning.
	*/ Example Use:
		item arr[16]; item arrB[2]; int arrC[2];
		arrC[0] = GetPointer(arr);
		arrB[0] = SetPointer(arrC[0]);

/************************************************************************************************************/


int GetItemdataPointer(itemdata *ptr[]);	ZASM Instruction:
					IDATAARRPTR
	/**
	* Returns the pointer of a itemdata array as a float.
	*/ Example Use:
		itemdata arr[16];
		int size = SizeOfArray( GetPointer(arr) );
		//Size == 16

/************************************************************************************************************/

itemdata SetItemdataPointer(int value);		ZASM Instruction:
					IDATAARRPTR2
	/**
	* Converts an int pointer to the itemdata type, for assigning.
	*/ Example Use:
		itemdata arr[16]; itemdata arrB[2]; int arrC[2];
		arrC[0] = GetPointer(arr);
		arrB[0] = SetPointer(arrC[0]);

/************************************************************************************************************/

int GetNPCPointer(npc *ptr[]);		ZASM Instruction:
					NPCARRPTR
	/**
	* Returns the pointer of a item array as a float.
	*/ Example Use:
		item arr[16];
		int size = SizeOfArray( GetPointer(arr) );
		//Size == 16

/************************************************************************************************************/

npc SetNPCPointer(int value);		ZASM Instruction:
					NPCARRPTR2
	/**
	* Converts an int pointer to the npc type, for assigning.
	*/ Example Use:
		npc arr[16]; npc arrB[2]; int arrC[2];
		arrC[0] = GetPointer(arr);
		arrB[0] = SetPointer(arrC[0]);

/************************************************************************************************************/

int GetLWeaponPointer(lweapon *ptr[]);		ZASM Instruction:
					LWPNARRPTR
	/**
	* Returns the pointer of a lweapon array as a float.
	*/ Example Use:
		lweapon arr[16];
		int size = SizeOfArray( GetPointer(arr) );
		//Size == 16

/************************************************************************************************************/

lweapon SetLWeaponPointer(int value);		ZASM Instruction:
					LWPNARRPTR2
	/**
	* Converts an int pointer to the lweapon type, for assigning.
	*/ Example Use:
		lweapon arr[16]; lweapon arrB[2]; int arrC[2];
		arrC[0] = GetPointer(arr);
		arrB[0] = SetPointer(arrC[0]);

/************************************************************************************************************/

int GetEWeaponPointer(eweapon *ptr[]);		ZASM Instruction:
					EWPNARRPTR
	/**
	* Returns the pointer of a eweapon array as a float.
	*/ Example Use:
		eweapon arr[16];
		int size = SizeOfArray( GetPointer(arr) );
		//Size == 16

/************************************************************************************************************/

eweapon SetEWeaponPointer(int value);		ZASM Instruction:
					EWPNARRPTR2
	/**
	* Converts an int pointer to the eweapon type, for assigning.
	*/ Example Use:
		eweapon arr[16]; eweapon arrB[2]; int arrC[2];
		arrC[0] = GetPointer(arr);
		arrB[0] = SetPointer(arrC[0]);


/************************************************************************************************************/

///////////////////
// Unimplemented //
///////////////////

Gleeok wrote these in 2015-6, and he needs to implement them into the present master branch. -Z


void TileArray	( int layer, int number_of_tiles,
			int tiles[],
			int x_positions[],
			int y_positions[],
			int csets[]);

			ZASM: TILEARRAY

/**
*
* Draws a number of tiles specified by 'number_of_tiles' to 'layer'.
* Specify the tiles by populating an array with their IDs and passing the array ointer to 'tiles'.
* Specify the X coordinate for each by passing an array with their x coordinates to 'x_positions'.
* Specify the Y coordinate for each by passing an array with their y coordinates to 'y_positions'.
* Specify the CSet for each by passing an array with their csets to 'csets'.
*
* This function counts as a single draw.
*
* Transparency is not yet imlemented, but you may draw to a bitmap and render it translucent.
*// Example:

int tiles[4] = {16,19,31,20};
int tilx[4]= {0, 16, 32, 48}:
int tily[4]={8, 8, 8, 8);
int tilc[4]={0,0,0,0};
Screen->TileArray(6, 4, tiles, tilx, tily, tilc);


/************************************************************************************************************/

void PixelArray	( int layer, int number_of_pixels,
			int x_positions[],
			int y_positions[],
			int colours[]);

			ZASM: PIXELARRAY

/**
*
* Draws a number of pixel, similar to PutPixel, specified by 'number_of_pixels' to 'layer'.
* Specify the X coordinate for each by passing an array with their x coordinates to 'x_positions'.
* Specify the Y coordinate for each by passing an array with their y coordinates to 'y_positions'.
* Specify the colour for each by passing an array with their csets to 'colours'.
*
* This function counts as a single draw.
*
* Transparency is not yet imlemented, but you may draw to a bitmap and render it translucent.
*// Example:

int pix[4] = {16,19,31,20};
int px[4]= {0, 16, 32, 48}:
int py[4]={8, 8, 8, 8);
int pc[4]={0x12,0xB0,0xDA,0x4F};
Screen->TileArray(6, 4, pix, px, py, pc);

/************************************************************************************************************/

CreateBitmap(int id, int xsize, int ysize)

* Min size 1, max 2048
/************************************************************************************************************/

SetRenderSource(int target, int x, int y, int w, int h)

/************************************************************************************************************/

//I need to add this after GLeeok reworks his script draw refactoring. -Z
void Polygon	( int layer, ... );

			ZASM: POLYGON

* Adding to Beta 9 : Postponed -Z

/************************************************************************************************************/

// Game->

//! These do not yet work:

//Returns Screen->Door[index] for a given DMap and Screen
int GetDMapScreenDoor( int dmap, int screen, int index )


//Sets Screen->Door[index] for a given DMap and Screen to 'value'
void SetDMapScreenDoor( int dmap, int screen, int index, int value)


//Returns Screen->State[index] for a given DMap and Screen
bool GetDMapScreenState( int dmap, int screen, int index )


//Sets Screen->State[index] for a given DMap and Screen to 'value'
void SetDMapScreenState( int dmap, int screen, int index, bool value)

/************************************************************************************************************/