Portal

From Eternity Wiki
Revision as of 14:03, 2 April 2008 by SoM (talk | contribs) (slight change.)
Jump to: navigation, search

Portals are a powerful mapping feature which allow a variety of rendering effects; they allow an architectural surface to be used as a "window" which can display something besides the texture that would normally cover the surface. Anything from simple fixed plane, to another area of the map can be rendered within these surfaces via the same architecture.

Terminology

Portal Window

'Portal window' refers to the area of the screen that a portal occupies. For example:

Pterminology01.png

This is a simple map with no portal surfaces, and no portal window.


Pterminology02.png

This is the same simple map with a fixed plane portal applied to the ceiling of the sector. The portal window is outlined in white.


Pterminology03.png

This is the map, but the same plane portal is applied to the ceiling and the far wall. The two surfaces display the same portal, and as such, they share a common portal window (also outlined in white).

All surfaces in a scene that have a common portal will share the same portal window.


Dummy Sector

A sector off of the main map area which is used by line or sector specials as a model, or as housing for lines which need to be a specific size.


Fixed Plane Portals

Fixed plane portals (as the name implies) render a single, fixed plane into the portal window. The plane is always rendered a the same height and texture offset even when the camera changes it's position.

Line specials:

283 Apply fixed plane portals to the ceilings of tagged sectors
284 Apply fixed plane portals to the floors of tagged sectors
285 Apply fixed plane portals to the floors and ceilings of tagged sectors


The front side sector of the special line is used to generate the plane. The ceiling texture, sector light, and ceiling texture scrolling are all used as attributes for the rendered fixed plane. The absolute height of the ceiling is used as the height of the plane. That is, if the special line front sector has a ceiling height of 64, the plane will always render at 64 units above the camera height. If the ceiling height is 128, the plane will always render at 128 units above the camera height, and so on.

For example:

Pfixedplane01.png

This shows a simple map with a small sector off to the side of the rest of the map. One of the lines in this sector has been given a 283 special which will apply a fixed play portal to all tagged sector ceilings. The height of the dummy sector is set to 128, the blue water texture FWATER1 is the ceiling texture, there is no scrolling applied to the ceiling, and the ceiling height is 128.

Pfixedplane02.png

Here is what the map looks like in Eternity. Notice the rendered height of the plane is the same as a ceiling 128 units above eye level.

The line special 289 can be used to apply fixed plane portals to walls as well. The special will find a portal with the same line tag and will display that portal on the surface of the line.

Here is the map from above:

Pfixedplane03.png

The highlighted wall has been given a special of 289 and tagged to the portal line.

Pfixedplane04.png

Here is what the map looks like in Eternity. Note: both surfaces are displaying the same portal and will share a common portal window.


(This article is currently a work in progress)