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

From FenixWiki

Revision as of 01:14, 3 May 2007 (edit) Sandman (Talk | contribs) ← Previous diff		Current revision (12:03, 11 July 2008) (edit) (undo) Sandman (Talk | contribs) m (→Notes)
(8 intermediate revisions not shown.)
Line 4:		Line 4:
	Restore modes are used to define the type of restoration, needed to be applied to the screen background, by assigning them to the [[global variable]] [[restore_type]]. This influences if and how the background is restored after each frame.		Restore modes are used to define the type of restoration, needed to be applied to the screen background, by assigning them to the [[global variable]] [[restore_type]]. This influences if and how the background is restored after each frame.
-	See also [[dump_type]] and [[dump_modes|its constants]].	+	== List ==
-		+
	{|		{|
	| ''Constant'' || - ''Value'' || - ''Description''		| ''Constant'' || - ''Value'' || - ''Description''
Line 11:		Line 10:
	| NO_RESTORE || - -1 || - The background won't be restored (i.e. redrawn).		| NO_RESTORE || - -1 || - The background won't be restored (i.e. redrawn).
	|-		|-
-	| PARTIAL_RESTORE|| - 0 || - The background will be restored in areas where graphics have been painted or text written.	+	| PARTIAL_RESTORE|| - 0 || - The background will be restored in areas where graphics have been painted or text written (default).
	|-		|-
	| COMPLETE_RESTORE || - 1 || - The background will be completely restored.		| COMPLETE_RESTORE || - 1 || - The background will be completely restored.
	|}		|}
		+
		+	== Notes ==
		+	It is clear that completely restoring the background every frame is more expensive than updating only parts of it. However, detecting what parts need updating is no small thing either. So cost-wise both have their situations in which they are good.
		+
		+	PARTIAL_RESTORE is useful if there is relatively not much changing to the background. COMPLETE_RESTORE is useful if many parts of the background need restoration, like in the case of screen-wide partially transparent scrolls.
		+
		+	Be certain [[dump_type]] is compatible with the restore_type set, because some combinations can cause probably unwanted effects.
		+
		+	== See also ==
		+	* [[restore_type]]
		+	* [[dump_type]]
		+	* [[dump_modes]]

---

Current revision

Contents 1 Definition 2 List 3 Notes 4 See also

[edit] Definition

Restore modes are used to define the type of restoration, needed to be applied to the screen background, by assigning them to the global variable restore_type. This influences if and how the background is restored after each frame.

[edit] List

Constant	- Value	- Description
NO_RESTORE	- -1	- The background won't be restored (i.e. redrawn).
PARTIAL_RESTORE	- 0	- The background will be restored in areas where graphics have been painted or text written (default).
COMPLETE_RESTORE	- 1	- The background will be completely restored.

[edit] Notes

It is clear that completely restoring the background every frame is more expensive than updating only parts of it. However, detecting what parts need updating is no small thing either. So cost-wise both have their situations in which they are good.

PARTIAL_RESTORE is useful if there is relatively not much changing to the background. COMPLETE_RESTORE is useful if many parts of the background need restoration, like in the case of screen-wide partially transparent scrolls.

Be certain dump_type is compatible with the restore_type set, because some combinations can cause probably unwanted effects.

[edit] See also

• restore_type
• dump_type
• dump_modes