Andrew Branscom at 23:52, 3 April 2025

2025-04-03T23:52:30Z

← Older revision		Revision as of 19:52, 3 April 2025
Line 2:		Line 2:
	[[Category:AGI Pages to be Edited]]		[[Category:AGI Pages to be Edited]]

	<div align="center"><span style="font-size: 22pt"></div>		<div align="center"><span style="font-size: 22pt">Screen object</div>

	<br />		<br />

Andrew Branscom: /* Introduction */

2025-04-03T23:51:51Z

Introduction

← Older revision		Revision as of 19:51, 3 April 2025
Line 7:		Line 7:
	==<br /> Introduction ==		==<br /> Introduction ==

	The screen object data type (sometimes called a VIEW object; not to be confused with a [[View (AGI)]] resource) represents the animated sprites that are controlled by AGI. Unlike [[~~variable~~\|variables]] and [[Flag (AGI)\|flags]], screen objects must be explicitly created in order to access them in AGI. Each screen object must be initialized, assigned a loaded [[View Resource (AGI)\|view]] resource, positioned on the screen and then drawn in order to appear on screen.		The screen object data type (sometimes called a VIEW object; not to be confused with a [[View (AGI)]] resource) represents the animated sprites that are controlled by AGI. Unlike [[Variable (AGI)\|variables]] and [[Flag (AGI)\|flags]], screen objects must be explicitly created in order to access them in AGI. Each screen object must be initialized, assigned a loaded [[View Resource (AGI)\|view]] resource, positioned on the screen and then drawn in order to appear on screen.

	Screen objects are represented in source code by the letter 'o' and their index number (i.e. o0, o1, etc.)		Screen objects are represented in source code by the letter 'o' and their index number (i.e. o0, o1, etc.)

Andrew Branscom: /* Introduction */

2025-04-03T23:51:24Z

Introduction

← Older revision		Revision as of 19:51, 3 April 2025
Line 7:		Line 7:
	==<br /> Introduction ==		==<br /> Introduction ==

	The screen object data type (sometimes called a VIEW object; not to be confused with a [[~~view~~]] resource) represents the animated sprites that are controlled by AGI. Unlike [[variable\|variables]] and [[~~flag~~\|flags]], screen objects must be explicitly created in order to access them in AGI. Each screen object must be initialized, assigned a loaded [[View Resource (AGI)\|view]] resource, positioned on the screen and then drawn in order to appear on screen.		The screen object data type (sometimes called a VIEW object; not to be confused with a [[View (AGI)]] resource) represents the animated sprites that are controlled by AGI. Unlike [[variable\|variables]] and [[Flag (AGI)\|flags]], screen objects must be explicitly created in order to access them in AGI. Each screen object must be initialized, assigned a loaded [[View Resource (AGI)\|view]] resource, positioned on the screen and then drawn in order to appear on screen.

	Screen objects are represented in source code by the letter 'o' and their index number (i.e. o0, o1, etc.)		Screen objects are represented in source code by the letter 'o' and their index number (i.e. o0, o1, etc.)

Andrew Branscom: Created page with "Category:AGI Pages Category:AGI Pages to be Edited

==
Introduction == The screen object data type (sometimes called a VIEW object; not to be confused with a view resource) represents the animated sprites that are controlled by AGI. Unlike variables and flags, screen objects must be explicitly created in order to access them in AGI. Each screen object must be initial..."

2025-04-03T21:19:18Z

Created page with "Category:AGI Pages Category:AGI Pages to be Edited <div align="center"><span style="font-size: 22pt"></div> <br /> ==<br /> Introduction == The screen object data type (sometimes called a VIEW object; not to be confused with a view resource) represents the animated sprites that are controlled by AGI. Unlike variables and flags, screen objects must be explicitly created in order to access them in AGI. Each screen object must be initial..."

New page

[[Category:AGI Pages]]
[[Category:AGI Pages to be Edited]]

<div align="center"><span style="font-size: 22pt"></div>

<br />
==<br /> Introduction ==

The screen object data type (sometimes called a VIEW object; not to be confused with a [[view]] resource) represents the animated sprites that are controlled by AGI. Unlike [[variable|variables]] and [[flag|flags]], screen objects must be explicitly created in order to access them in AGI. Each screen object must be initialized, assigned a loaded [[View Resource (AGI)|view]] resource, positioned on the screen and then drawn in order to appear on screen.

Screen objects are represented in source code by the letter 'o' and their index number (i.e. o0, o1, etc.)

== [[Screen Object Table]] ==

Each screen object is represented by a structured block of memory that contains all the data associated with the object. AGI creates a table of screen object structures on start up which is then accessed as needed while AGI is running. See the [[Screen Object Table|Screen Object Data Structure]] Topic for details on the information stored in AGI for each screen object.

== Maximum Screen Objects ==

The size of the screen object table is set by the Maximum Screen Objects property of the game's [[OBJECT File (AGI)|OBJECT]] file. AGI allocates [[memory]] for the screen object table based on the Maximum Screen Objects value when the game starts. The size of the table cannot be adjusted after that.

The screen object table size is always one plus the actual value of Maximum Screen Objects, i.e. if maximum is set to 10, the table will actually hold 11 objects. This is because the first object (o0, known as [[ego]]) is always allocated a space in the screen object table. Due to [[memory]] limitations, you should try to limit the Maximum Screen Objects to as low a value as possible. You can even use a value of zero, which would mean that the only object that would be usable would be the [[ego]] object. A common value in many Sierra games for Maximum Screen Objects was 16.

== Ego Object ==

The first screen object in the table (o0) is reserved by AGI to function as the character that represents the player in the game. This is the screen object which the player can control, moving around the screen as they progress through the game.

In AGI, this screen object (o0) is referred to as "[[ego]]". AGI provides commands and functionality specifically for ego that is unique from other screen objects. It is the only screen object that can be set to allow [[player.control|player control]] via the [[keyboard]], [[joystick]] and/or [[mouse]]. None of the other objects can be controlled directly by the player.

== Loop Assignment to Screen Objects ==

In order to actually display an object on screen, a [[view]] must be assigned using the '''[[set.view]]''' command. In each [[interpreter cycle]], AGI displays each cel in the currently assigned loop successively, which creates the illusion of movement. See the [[Working with Screen Objects]] topic for additional information.

== Auto Loop Feature ==

If the view assigned to an object has 2, 3 or 4 loops, AGI will automatically assign a [[loop]] based on the direction an object is moving. For example, when walking to the right, show a right facing loop, when walking toward the horizon, show a rear view loop, etc. When an object's direction changes, AGI assigns a loop as follows:

{| border="1" cellpadding="2"
| style="background-color: #efefef" width="200" | '''Direction'''
| style="background-color: #efefef" width="175" | '''New Loop'''<BR/>(2,3 loops)
| style="background-color: #efefef" width="175" | '''New Loop'''<BR/>(4 loops)
|-
|0 - STOPPED
| no change
| no change
|-
|1 - UP
|no change
|3
|-
|2 - UP_RIGHT
|0
|0
|-
|3 - RIGHT
|0
|0
|-
|4 - DOWN_RIGHT
|0
|0
|-
|5 - DOWN
|no change
|2
|-
|6 - DOWN_LEFT
|1
|1
|-
|7 - LEFT
|1
|1
|-
|8 - UP_LEFT
|1
|1
|-
|}

If the view has only one or more than four loops, AGI will not automatically assign loops based on direction. However, in AGI [[version]] 3.002.098 and above, reserved flag [[f20 (force auto-loop)]] can be set to force the auto-loop behavior even if there are more than four loops in the view. (There is a bug in [[version 3.002.086]] that makes all views automatically update no matter how many loops they have.)

The auto-loop feature can be disabled by using the '''[[fix.loop]]''' command. Also, there is a bug in all versions of AGI that will disable the auto-loop feature if [[step size]] is set to 0.

== Screen Object Number Validation ==

It is important to be aware that AGI is notorious for failing to validate values passed to commands. In the case of screen objects, beginning in version 2.272, most of the AGI commands no longer verify that the value passed for screen objects is less than or equal to the maximum (exceptions are the '''[[erase]]''', '''[[animate.obj]]''', and '''[[draw]]''' commands).

This means that when an invalid screen object value is passed to a command, AGI will attempt to read or write data in memory that is outside the screen object table. This will most certainly result in wildly unpredictable results, and usually ends up [[crashing AGI]].

As a game programmer it is extremely important that you verify all commands involving screen objects are passed a valid value. See the [[Internal Error Handling]] topic for additional information on how AGI handles errors in logic code.

==<br /> References ==

<references />

==<br /> Related Links ==
*  
 
[[Category:Commands]]
[[Category:AGI Logic Commands]]

Screen object - Revision history

Andrew Branscom at 23:52, 3 April 2025

Andrew Branscom: /* Introduction */

Andrew Branscom: /* Introduction */