This wiki is out of date, use the continuation of this wiki instead

Scroll

From FenixWiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 20:18, 30 November 2007 (edit)
Sandman (Talk | contribs)
(New page: category:variables category:predefined category:global variables '''Up to Global Variables''' ---- == Definition == '''STRUCT[9]''' Scroll Scroll is a...)
← Previous diff		 Current revision (16:20, 8 March 2008) (edit) (undo)
Sandman (Talk | contribs)
m
 
(3 intermediate revisions not shown.)
Line 25: Line 25:
| '''INT''' y1 || - The [[Y]]-coordinate of the the background graphic.* | '''INT''' y1 || - The [[Y]]-coordinate of the the background graphic.*
|- |-
-| '''INT''' z || - The [[Z]]-coordinate of the scroll window (default: 512).+| '''INT''' z || - The [[Z]]-coordinate of the scroll window (default: 512).**
|- |-
-| '''INT''' camera || - The [[processID]] of the process to be followed (default: 0).**+| '''INT''' camera || - The [[processID]] of the process to be followed (default: 0).***
|- |-
-| '''INT''' ratio || - The ratio in percent the foreground will move related to the background (default: 200).**,***+| '''INT''' ratio || - The ratio in percent the foreground will move related to the background (default: 200).***,****
|- |-
-| '''INT''' speed || - The maximum speed of the foreground, 0 for no limit (default: 0).**+| '''INT''' speed || - The maximum speed of the foreground, 0 for no limit (default: 0).***
|- |-
-| '''INT''' region1 || - The [[region]] in which the scroll won't move, -1 for none (default: -1).**+| '''INT''' region1 || - The [[region]] in which the scroll won't move, -1 for none (default: -1).***
|- |-
-| '''INT''' region2 || - The [[region]] in which the maximum speed is ignored, -1 for none (default: -1).**+| '''INT''' region2 || - The [[region]] in which the maximum speed is ignored, -1 for none (default: -1).***
|- |-
| '''INT''' flags1 || - The [[bit flags]] for the foreground graphic. | '''INT''' flags1 || - The [[bit flags]] for the foreground graphic.
|- |-
-| '''INT''' flags2 || - The [[bit flags]] for the foreground graphic.+| '''INT''' flags2 || - The [[bit flags]] for the background graphic.
|- |-
| '''INT''' follow || - The scrollID of the [[scroll window]] to follow, -1 means none (default: -1). | '''INT''' follow || - The scrollID of the [[scroll window]] to follow, -1 means none (default: -1).
Line 46: Line 46:
|} |}
{| {|
-| '''<nowiki>*</nowiki>''' || - These fields become ''read only'' when the scroll window is in automatic mode.+| '''<nowiki>*</nowiki>''' || - These fields become ''read only'' when the scroll window is in automatic mode (see [[#Notes|notes]]).
|- |-
-| '''<nowiki>**</nowiki>''' || - These fields only make sense when the scroll window is in automatic mode.+| '''<nowiki>**</nowiki>''' || - [[Process]]es on the scroll use this [[z]] value (see [[#Notes|notes]]).
|- |-
-| '''<nowiki>***</nowiki>''' || - The ratio is in percent: 200 means the background moves twice as slow.+| '''<nowiki>***</nowiki>''' || - These fields only make sense when the scroll window is in automatic mode (see [[#Notes|notes]]).
 +|-
 +| '''<nowiki>****</nowiki>''' || - The ratio is in percent: 200 means the background moves twice as slow.
|} |}
== Notes == == Notes ==
There are two main method of controlling a [[scroll window]]. One is the manual way, thus changing the values of the x0,y0,x1 and y1 manually. This mode is used when the ''camera'' field is not set (is 0). When it is set with a [[processID]], the scroll window is in automatic mode and will follow that [[process]]' coordinates and will try to keep it centered. This can be influenced by other members of the scroll struct. There are two main method of controlling a [[scroll window]]. One is the manual way, thus changing the values of the x0,y0,x1 and y1 manually. This mode is used when the ''camera'' field is not set (is 0). When it is set with a [[processID]], the scroll window is in automatic mode and will follow that [[process]]' coordinates and will try to keep it centered. This can be influenced by other members of the scroll struct.
 +
The foreground is the plane to be controlled and the background moves relative to the foreground. The foreground is the plane to be controlled and the background moves relative to the foreground.
 +
 +[[Process]]es in a scroll take over the [[z]] value of that scroll's z. Between processes on the same scroll the [[local variable]] [[z]] of that process does have the expected effect.
== Example == == Example ==
{{Globals}} {{Globals}}

Current revision

Up to Global Variables


Contents

[edit] Definition

STRUCT[9] Scroll

Scroll is a global variable struct array, containing information about the current state of the ten available scrolls (0..9). It is used to influence the settings of a scroll window, initiated by start_scroll().

[edit] Members of one Struct

Member name - Description
INT x0 - The X-coordinate of the foreground graphic.*
INT y0 - The Y-coordinate of the foreground graphic.*
INT x1 - The X-coordinate of the the background graphic.*
INT y1 - The Y-coordinate of the the background graphic.*
INT z - The Z-coordinate of the scroll window (default: 512).**
INT camera - The processID of the process to be followed (default: 0).***
INT ratio - The ratio in percent the foreground will move related to the background (default: 200).***,****
INT speed - The maximum speed of the foreground, 0 for no limit (default: 0).***
INT region1 - The region in which the scroll won't move, -1 for none (default: -1).***
INT region2 - The region in which the maximum speed is ignored, -1 for none (default: -1).***
INT flags1 - The bit flags for the foreground graphic.
INT flags2 - The bit flags for the background graphic.
INT follow - The scrollID of the scroll window to follow, -1 means none (default: -1).
INT[6] reserved - Seven reserved integers.
* - These fields become read only when the scroll window is in automatic mode (see notes).
** - Processes on the scroll use this z value (see notes).
*** - These fields only make sense when the scroll window is in automatic mode (see notes).
**** - The ratio is in percent: 200 means the background moves twice as slow.

[edit] Notes

There are two main method of controlling a scroll window. One is the manual way, thus changing the values of the x0,y0,x1 and y1 manually. This mode is used when the camera field is not set (is 0). When it is set with a processID, the scroll window is in automatic mode and will follow that process' coordinates and will try to keep it centered. This can be influenced by other members of the scroll struct.

The foreground is the plane to be controlled and the background moves relative to the foreground.

Processes in a scroll take over the z value of that scroll's z. Between processes on the same scroll the local variable z of that process does have the expected effect.

[edit] Example

Global variables
• Argc • Argv • Cdinfo • Dump_type • Fading • Fileinfo • Fps • Frame_time • Full_screen • Graph_mode • Mouse • Os_id • Restore_type • Scale_mode • Scroll • Sound_channels • Sound_freq • Sound_mode • Text_flags • Text_z • Timer •
Retrieved from "http://fenixwiki.booleansoup.com/index.php/Scroll"
Personal tools