Show Posts
1
Editor Development / [Experiment] Custom Room Viewport and Camera
« on: 22 Oct 2018, 02:11 »
This is the first WIP version of a custom room viewport, built on top of AGS 3.5.0 (alpha 6):
Build: https://www.dropbox.com/s/bkgmb8a129qr9sr/ags-3.5.0--roomviewport-wip1.zip?dl=0
The feature is discussed here on github: https://github.com/adventuregamestudio/ags/issues/473
Source branch: https://github.com/ivan-mogilko/ags-refactoring/tree/ags3--roomviewport
KNOWN ISSUES:
* does not work with Software driver yet, but it's in plans.
* when camera is larger than the room, it is not positioned correctly on screen.
In short, this feature lets you to change the way ROOM (and all inside it) is shown on game screen. This is done by setting up Room Viewport and Camera.
Camera is an "eye" inside the room, that has certain size and position in room coordinates. The existing "viewport" commands in current AGS serve for the same purpose.
Viewport is a surface on game screen where what camera "sees" gets drawn to. It also has a size and position, but in screen coordinates.
You may imagine a piece of room (the size of camera) is cut out and pasted in the viewport, resized if necessary.
If the Camera is smaller than the viewport, then the room will appear scaled up on screen. If the Camera is larger than the viewport, the room will appear scaled down.
Note, that with the smaller Camera size you may get a scrolling room even with rooms that are equal to game's size.
The feature is controlled by two temporary script commands (these will be changed to something better later):
The manual camera position is still controlled using SetViewport(x,y) function, although it is not viewport but camera room coordinates what it sets.
For example, following code will put x2 downscaled room in the center of the screen:
Another example, in 320x200 game this will put 160x100 room view at the top-left corner and zoom in twice:
The purpose of these features are:
1) Display room in a custom rectangle on screen;
2) Add zoom in/out effects in your game.
3) Potentially - also add rotation to the room view (if I am able to make it work correctly).
This also have a potential to have multiple room cameras in the future, although that may not be easy to add so I don't really plan to do that for AGS 3.5.0. The problem here is not so much in drawing them on screen, but rather in resolving interactions. Right now all the logic in AGS is based on the single viewport into the room: clicks, finding objects on screen, etc. Multiple viewports would demand a good thought and possibly script redesign.
Build: https://www.dropbox.com/s/bkgmb8a129qr9sr/ags-3.5.0--roomviewport-wip1.zip?dl=0
The feature is discussed here on github: https://github.com/adventuregamestudio/ags/issues/473
Source branch: https://github.com/ivan-mogilko/ags-refactoring/tree/ags3--roomviewport
KNOWN ISSUES:
* does not work with Software driver yet, but it's in plans.
* when camera is larger than the room, it is not positioned correctly on screen.
In short, this feature lets you to change the way ROOM (and all inside it) is shown on game screen. This is done by setting up Room Viewport and Camera.
Camera is an "eye" inside the room, that has certain size and position in room coordinates. The existing "viewport" commands in current AGS serve for the same purpose.
Viewport is a surface on game screen where what camera "sees" gets drawn to. It also has a size and position, but in screen coordinates.
You may imagine a piece of room (the size of camera) is cut out and pasted in the viewport, resized if necessary.
If the Camera is smaller than the viewport, then the room will appear scaled up on screen. If the Camera is larger than the viewport, the room will appear scaled down.
Note, that with the smaller Camera size you may get a scrolling room even with rooms that are equal to game's size.
The feature is controlled by two temporary script commands (these will be changed to something better later):
Code: Adventure Game Studio
- // Defines where the room view is located on screen (in game screen's coordinates)
- void SetRoomViewport(int scrx, int scry, int width, int height);
- // Defines the size of the room camera (in room's coordinates)
- void SetRoomCamera(int width, int height);
The manual camera position is still controlled using SetViewport(x,y) function, although it is not viewport but camera room coordinates what it sets.
For example, following code will put x2 downscaled room in the center of the screen:
Code: Adventure Game Studio
- function game_start()
- {
- int viewwidth = System.ViewportWidth / 2;
- int viewheight = System.ViewportHeight / 2;
- SetRoomViewport(viewwidth / 2, viewheight / 2, viewwidth, viewheight);
- }
Another example, in 320x200 game this will put 160x100 room view at the top-left corner and zoom in twice:
Code: Adventure Game Studio
- function game_start()
- {
- SetRoomViewport(10, 10, 160, 100);
- SetRoomCamera(80, 50);
- }
The purpose of these features are:
1) Display room in a custom rectangle on screen;
2) Add zoom in/out effects in your game.
3) Potentially - also add rotation to the room view (if I am able to make it work correctly).
This also have a potential to have multiple room cameras in the future, although that may not be easy to add so I don't really plan to do that for AGS 3.5.0. The problem here is not so much in drawing them on screen, but rather in resolving interactions. Right now all the logic in AGS is based on the single viewport into the room: clicks, finding objects on screen, etc. Multiple viewports would demand a good thought and possibly script redesign.
Add spoiler tag for Hidden:
.