EDukeWiki - User contributions [en]

True Room Over Room Mapping Guide

2014-07-08T23:52:37Z

Micky C: /* Software renderer */

{{Build Intro}}

True Room Over Room is a feature new to EDuke32 that allows for the construction of [[sector]]s in a vertical arrangement. Other build games (Shadow Warrior, Blood, Redneck Rampage) are able to fake ROR by having sectors in different parts of the map and rendering them on top of each other, and EDuke32 has a similar feature using Sector Effectors. The difference between game ROR and TROR is that the sectors are physically on top of each other, making editing a lot easier and more automatic, while also making it easier to visualize what you're building. For the more technically minded, TROR is part of the engine and map format themselves, instead of an effect bolted on in the game code.

==TROR Editing Modes==
There are two modes you should be aware of before starting to build with TROR.

===Side view (orthographic view) mode===
This mode allows you see a 3D representation of your map while in 2D mode. This is toggled with '''[F3]'''. It can be rotated with the '''[Q]''' and '''[W]''' buttons, and the angle of viewing can be changed by pressing '''[A]''' and '''[Z]'''.
This mode is absolutely essential not only because it allows you to actually see what you're doing, but because in order to properly use TROR, you need to designate which is the 'active' layer that new sectors will connect to.

This can be done in 2 ways.

The first way is to press '''[Ctrl-A]''' which will grey out all other layers except the one the viewpoint (the arrow in 2D/side view mode)is in, which is the active layer. You can move the view point up and down, allowing you to edit above and below layers, by either pressing '''[page up]''' and '''[page down]''' respectively, or more accurately by pressing down the '''[middle mouse button]''' and moving the mouse forward or backwards. This method is usually prefered as it gives you much more control over the vertical position of the viewpoint. If you find the greyed-out walls distracting, you can remove them altogether by pressing '''[Ctrl-Alt-A]'''

The second way allows for more precision as you can narrow the active editing range to the height of a single (or set of) sectors. Firstly, select the sector(s) that you want to be able to edit with '''[Right-Alt]''', and press '''[Ctrl-R]'''. It's as easy as that. Press '''[Ctrl-R]''' without having any sectors highlighted to unlock the range again and be able to edit them normally.

===Invisible surfaces viewing mode===
This is for 3D mode when you want to toggle seeing invisible objects.
All you have to do to toggle this mode is press '''[I]''', which primarily allows you to see objects you've made invisible with '''['-I]'''. However, the reason why it's so useful here, is that it also shows you the boundaries between TROR layers (which are invisible in-game). This is a huge benefit when you want to visualize/figure out what's actually going on. It also allows you to edit the TROR surfaces and apply transparent or masked floors, and edit characteristics like the blocking and hitscan bits.

==Properties and Terminology==
TROR is created by selecting a sector and extending it (this will be covered later in method). This means that it creates a new sector directly on top of or below the selected sector, which is exactly the same size and shape as the original. The ceiling of the bottom sector is linked with the floor of the top sector. It then makes sense that the extended sector is called an '''extension'''.

You can have more than one extension on a sector. You can extend it above and below, then take the bottom and extend that down again and again, and the same with the top. You are effectively stacking sectors on top of each other, so these sectors are part of a '''stack'''. The great thing about stacks (even with only one extension) is that if you move the vertex of a wall of one layer, it will automatically move the vertices of all the other layers, so that they're easy to change the shape of without worrying about breaking the connection.

You can highlight a group of sectors and extend them all at the same time so that there can be a single extension covering them all. This is useful because it saves walls, and you can still edit all the child sectors with ease. Now, as soon as you extend these sectors so that they share an extension, they all become a part of the same '''bunch'''.

If you take a room with a child sector in the middle, and extend everything upwards except the child layer, there will now be void space in the top layer where the child sector is. If you press '''[Ctrl-S]''' there to make it into a child sector in the top layer, you'll then find that you have a floating normal (non-TROR) sector between the two TROR layers that you can do with as you please. This is called an '''island'''. I suppose it's still an island even if you don't make it a child sector in the top layer but hey, now you can create floating sectors. These can potentially be glitchy if you're not using the polymer renderer, but we'll get onto that later.

==TROR related keys==
The following are a list of keys which are related to editing TROR. They can also be found in the [http://wiki.eduke32.com/wiki/Build/Mapster32_Keyboard_Commands mapster32 keyboard commands page]

===2D mode===
'''[Ctrl-E]''' sector extension prompt (sectors to extend must be highlighted) 
'''[Ctrl-E]''' make sandwich [''if extending a sector in a direction that has already been extended, see below''] 
'''[Ctrl-E]''' punch loop through extension (loop points must be highlighted, e.g. with '''[Right Shift]'''+'''[Left Ctrl]''') 
 
'''[Ctrl-A]''' toggle auto-grayout of non-extended sectors 
'''[Ctrl-J]''' TROR-join sectors. The selection must consist of the two sets of sectors you wish to join. 
'''[Ctrl-U]''' Clear extension: delete the bunch (i.e. ceiling-floor connection) of the aimed-at sector's floor 
'''[PGUP]'''/'''[PGDN]''' Change 'player' height in discrete steps in order to go through the different levels 
'''[Ctrl-tab]''' Display one currently aimed at sector (of potentially many that lie under the mouse crosshair) 
'''[HOME]''' and '''[END]''' as modifiers to AltGr: select all sectors whose floor's/ceiling's bunchnum equal the bunchnum of the aimed at sector (useful for further operations on whole bunches)

===3D mode===
'''I''' invisibility preview: toggle fake ROR texture on non-masked portals 
'''LENTER+CTRL''' When aiming at an extended floor/ceiling, paste to all floors/ceilings of the bunch of the aimed at one 
'''T''', '''B''' and '''H''' work as with walls, though they set/toggle the bits only on '''one''' side 

===Advanced Highlighting===
Not really specific to TROR, but having greater control over which or how many sectors you can highlight makes doing extensions in TROR much easier. Make sure you're familiar with [http://wiki.eduke32.com/wiki/Level_editing#Copying_and_Pasting_Sectors advanced sector highlighting].

The information on the advanced features is outlined below:

You can highlight a second, third, and multiple sectors by holding down '''[']''' as you drag the selection box over them. This way you can highlight sectors in different parts of the map. Likewise, use the '''[;]''' key to deselect sectors. A small plus or minus will appear next to the cursor depending on which button you're holding.

You can select individual sectors with the mouse by moving the cursor inside the sector you want, holding '''[RIGHT ALT]''', and holding '''[RIGHT CTRL]''' as you release '''[RIGHT ALT]'''. The sector is now highlighted. This method of selection also works with '''[']''' and '''[;]''' to select/deselect additional sectors by mouse. Simply hold '''[RIGHT ALT]''' and the appropriate button depending on what you want to do, then hold '''[RIGHT CTRL]''' while releasing the other buttons. This becomes very quick and easy to do after doing it a few times.

==TROR Mapping Examples==

===Manhole Sewer Example===

In this straightforward example, you're going to make a manhole that goes below a street, and some area around the end of the hole at the bottom.

1. Create the child sector where you want the manhole to be.

2. Highlight the sector with '''[Right-Alt]'''.

3. Press '''[Ctrl-E]'''. Mapster will prompt you whether you want to extend up or down.

4. We want to extend down so press '''[Z]''' ('''[A]''' if you're extending up).

5. Go into side view mode with '''[F3]''', and move the viewpoint down until you're editing the bottom layer.

6. The child sector you created should now have a white boundary, with the street sectors above either greyed out or gone depending on your settings.

7. Now you can treat the manhole sector (the extension) as the very first room you've made on a new map. You can draw sectors on the side of it to attach some rooms there. If you go into 3D mode, you should be able to see that if you go down that manhole, there should now be some area at the bottom which overlaps the street. This was not previously possible without using some kind of cheap trick. Congratulations, you've just made TROR.

===Two Story Building Example===

I'm sure that a big reason that people want to use TROR is to build multiple story buildings, and this is how you do it.

1. Design the first floor of your building, both inside and out. This is going to be the first layer, which means the ceiling of every sector, especially the outdoor sectors should not be any higher than the roof of the first floor. Pretend that the second floor doesn't even exist.

2. Make your windows, doors, and anything you want.

Highlight with '''[Right-Alt]''' all of the ''outdoor'' sectors (the outdoor sectors should all have the same ceiling height, and should not be parallaxed). Knowing your advanced highlighting will come in useful here to select all the sectors.

3. Extend the highlighted area up, and make the top layer the active editing layer.

4. You should notice that the outline of your house has become completely white, and the area inside the house is empty. This is because this area is the second floor of your house.

5. Make a sector inside the house outline, this will be the room on the second floor of your house. Draw small sectors between that room and the house outline to create second floor windows. Alternatively you could just press '''[Ctrl-S]''' inside the house sector to make it a regular child sector, and if you go into 3D mode, you'll see your house has a roof you can stand on top of.

6. If you're learning TROR for the first time, it is very helpful at this point to go into 3D mode and press '''[i]''' to reveal the boundaries between layers so that you can understand what you've done.

7. You can connect the ground floor to the second floor the same way you'd connect two sector-over-sector sectors; by having a staircase or lift that connects to a different area on the top floor than it does on the bottom (because a lift for example cannot directly cross TROR layers, therefore it must be connected to sectors which do not overlap; i.e have the entrance on one side and the exit on the other.)
Or you can connect the ground floor and second floor via TROR and have some sprite stairs or something.

At this stage you should have a perfect two story house where you can look into and enter both stories. Cool stuff eh? ;)

There's nothing stopping you from going on to build a third.. forth.. fifth.. floor in the same manner either.

===TROR water example===

This is how you create transparent water using TROR. It works just like regular water, but there are a few things you need to be aware of.

1. Create a main sector, then a child sector in that and extend it downwards.

2. Make both the top and bottom of the TROR surface masked or transparent, and give it the water texture.

3. Give the floor of the top sector a lotag of 1 for water. Give the floor of the bottom sector a lotag of 2 for underwater.

4. Place an SE 7 with the same hitag in the same position in both the top and bottom sector.

5. This is the one that people normally forget. Set the TROR surface in both the top and bottom layer to BLOCKING otherwise it will not work as intended.

See, it's not too bad, just remember the lotags and the blocking. Note if you split up the water sector or add more sectors, make sure those sectors are in both the top and bottom layers, and have new SE 7s, just like normal water. In the future TROR water will be more automatic in that you won't need the SE 7, however this is incomplete as of this writing.

Something that might make life a bit easier is that if you extend the floor of the below-water sector downwards, you can then edit the floor of the new bottom layer and make as complex as you want without having to worry about placing lots of SE 7s.

===Retro-fitting via Joining Example===

If you're absolutely clueless with the whole idea of extending, or you want to go back and retrofit some TROR into maps you've done in the past, there's a very easy way of joining them to form TROR.
If you have two sectors that have the same shape, area, and external vertices have the same relative positions (essentially they're the same sector, at least as far as their edges are concerned), then all you have to do is highlight both sectors with '''[Right-Alt]''', and press '''[Ctrl-J]''' to join, the same as joining two sectors normally. It will then prompt you with a few questions such as which sector you want to have on top of the other, which sector(s) you want to move (doesn't matter most of the time), and whether you'd like to move all the connected non-TROR sectors as well (definitely yes).

The good thing about this method is that besides the questions you have to answer, mapster does everything automatically, it even moves the heights for you. Now there'll be a quick example of this method below.

1. Make a child sector in a larger sector and copy-paste it into void space.

2. Give the floor of the original child sector and the ceiling of the new sector the water texture.

3. Highlight both the child sector and new sector with '''[Right-Alt]'''.

4. Press '''[Ctrl-J]''' and answer the simple questions.

5. You should end up with a TROR water sector just as you would via the extension method. You can now alter the transparency of the water to your preference.

===Sandwiching and Sector Punching===
It's possible and easy to create a new TROR layer between two TROR layers. All you have to do is highlight one of them, and extend it as you would normally, and it automatically adds a new layer in the middle.

It's also possible to easily create an island sector in the middle of a TROR sector. This is called ''sector punching'', and mainly involves stamping a child sector into the sector below or above. Follow the example below.

1. Extend a sector downwards.

2. Create a child sector in the original sector.

3. Select the vertices of the child sector with '''[Right-Shift]''' or '''[R-Ctrl + R-Shift]''' and press '''[Ctrl-E]''' as though you're extending a sector.

4. It will prompt you whether to punch up or down, in this case, choose down and hit '''[Enter]'''. A sector identical in size, shape and position should now be in the bottom layer.

5. Point the mouse cursor at the child sector in the top layer and press '''[Ctrl-U]'''. It will prompt you whether you want to break the connection, and unless you press [Ctrl-U] accidentally, you usually do.

6. The child sector should now be a floating sector island. Have fun.

Note that '''[Ctrl-U]''' only breaks the connection of a single sector if that sector has been punched. Otherwise it'll break the connection of the entire bunch, which is usually bad.

===List of TROR maps===

This (hopefully up to date) list contains maps which make heavy use of the TROR feature in order to make a huge variety of constructions. They each contain a wealth of examples for you to look at to see what's possible and how it works/how to make it. This is not a complete list, as other maps make minor or simple use of the effect and hence are not listed here.

1. The trueror.map in the Samples folder included with eduke32 contains a large amount of random examples of TROR.

2. Retaliation is a small hi-tech map by Loke that was the first proper TROR map and makes some great use of the feature. [http://www.scent-88.com/reviews/R/retaliation/retaliation.php Download here]

3. Parkade is a large city themed map containing large multiple story buildings, along with a large amount of unique, pioneering uses of the feature, made by myself (Micky C) and Paul B. It is the largest, most extensive TROR map and perhaps the best example of what TROR is capable of so far, if I do say so myself. [http://www.scent-88.com/reviews/P/parkade/parkade.php Download here]

4. Brooklyn Bridge is another city themed map which also makes extensive and interesting use of TROR, such as an alien ship that flies over water, shooting rockets, and in vents. [http://www.scent-88.com/reviews/B/brooklyn/brooklyn.php Download here]

==Tricks and Effects with TROR==

===SE 13 destructible floor/ceiling===

If you have a TROR extension in the floor, you can place an SE 13 on it (facing downwards in 2D mode, and it will become a solid floor in-game (blocked and masked). When the hitag is activated, the TROR surface will become invisible as though a hole has just formed in the floor. You can place the SE 13 on the surface, or above, in which case the floor will initially have the height of the SE 13 just like with the original effect. You can also place it near the ceiling to make the SE 13 control the ceiling instead, or have one near the ceiling and one near the floor to control both.

When placed in a TROR extension with many sectors, it will not just control the sector, but rather the entire extension. So you can add sectors and give them different textures and don't have to worry about adding extra SE 13's. If you want to have TROR surfaces have different heights with different SE 13 sprites, they need to be different extensions; i.e they need to have a sector in both the top and bottom layer, and be extended individually.

The SE 13 also works with TROR slopes, allowing you to create relatively complex destructible objects compared to sprites. But remember that TROR is pretty wall hungry, so keep an eye on complexity.
Note that regardless of whether a TROR surface is set to masked or transparent in mapster, it will always become invisible after SE 13 activation.

===TROR water height manipulation===

TROR water can also be made to move up and down using the SE 31/32, much like the raising/lowering submergible water in e1l4 Toxic Dump. The effect is the same, however it's easier with TROR, because you only have to set up the effect on one side, either in the top layer or bottom layer, because this effect is set up so that if the ceiling of the bottom sector is moved, it moves the floor of the top sector as well, and vice versa.

==Visual Glitches and Workarounds==

===Software renderer===
Even though TROR sectors are already physically overlapping, the 8-bit software renderer still needs to render them separately, having to do an extra rendering pass for each additional TROR extension in view. Theoretically if you create a huge amount of extensions in the same area the framerate could potentially drop to unplayable levels, however this is far fetched and I wouldn't worry about it.

The real problem with the software renderer is HOM glitching. In each rendering pass, there can only be one area along the x-interval drawn. For example, if you have an island on the ground, the area between you and the island will be fine, but everything on the other side of the island will show HOM. Try it out yourself to see what I mean. Technically this means that TROR extensions cannot contain islands (although it's been kind of hacked in to do exta-extra passes to overcome this problem, I wouldn't rely on them for perfect drawing.)

However, this can be overcome by breaking up the sector surrounding the child sector, and extending each sector individually. This means there will be multiple drawing portals around the island instead of one big one, and none of the individual extensions would contain the island, hence it should draw fine.

This HOM doesn't just occur due to islands, it can also happen when part of a normal sector is jutting out into a TROR sector, this can be thought of here as a mini-island even though it's connected to something. Don't call it a mini-island, I only called it that to explain why it would cause that glitching. This means that TROR extensions should be ''convex'', i.e if you draw a straight line through a TROR portal so that it leaves the sector, and then comes back, it is not convex (and is most likely due to something jutting out.) However if you draw a line through it and this does not happen, as is the case for a circle, square etc.. then it is convex, and should draw fine.

Also note that currently the software renderer doesn't allow the player to see through more than 8 layers of TROR (it draws the texture on the surface instead). This normally isn't a problem in small sectors of TROR because the player typically won't be able to look up high enough to see the 8 layers due to vertical distortion. The limit could potentially be increased if someone desperately needed it (talk to the devs for that.)

Having void sectors (white-walled sectors with null space inside them) inside a TROR sector, or inside a sector adjacent to/bounding a TROR sector, it will cause visual glitches when viewed from some angles. Consider turning potential void sectors into child sectors, and raise the floor to the ceiling to fix this, as the result would look identical to having a void sector, but without the glitching.

===Polymer renderer===
Masked floors and ceilings in polymer are always the last thing drawn on the screen. That means if you have a transparent surface such as a masked wall or sprite, it would cause everything all the TROR masked surfaces behind the transparent surface to stop being drawn and become invisible. There's no real work around for this, just try not to use masked walls or sprites with big transparent surfaces around TROR masked surfaces.

Other than that, polymer is by far the most stable renderer for TROR, and apart from what's written above, is 100% glitch free. Despite being slow sometimes, it is the renderer of choice for TROR. It works by drawing the entire scene, TROR and all in a single rendering pass. This means that it doesn't require any additional computer power to draw TROR, hence TROR will not affect the framerate in polymer.

===Polymost renderer===
The polymost renderer is bad, M'kay? It's like a comic relief in bad Hollywood films who can't do anything right. Don't use it. It has also been observed that some TROR constructions work perfectly on some computers, however are incredibly glitchy on others, so if you do decide to use this renderer, and TROR works for you, make sure you have two or three other people check it on their setups before you release your map. There are no plans to add complete polymost TROR compatibility as polymost will be obsolete once polymer is finished and optimised.

==Random Trivia==
Extended sectors can be sloped, but the bunch has to be 1:1 in that case. I.e you can't have any child sectors within a sloped TROR sector. If you want different TROR sectors with different slopes, you must use completely different extensions for that, as opposed to breaking up a single extension.

Maps containing one or more TROR bunches are saved in a new map format (v9) since some fields had to be taken over: xrepeat is unavailable on TROR'ed floors and ceilings, and on walls it's lotag if the ceiling, and extra if the floor of the wall's sector is extended. When in-game, these get transferred to internal arrays though.

The system is supposed to be used for 'large-scale' RoR, as a rule of thumb each affected sector should be at least a Duke high [that's too strict though].

[[Category:Level editing documentation]]

User:Micky C

2013-11-13T13:43:37Z

Micky C: Created page with "Micky C is an eduke32 mapper who started playing around with the editor in 2009. Being highly skilled in TROR (and polymer lighting), Micky C wrote the True Room Over Room map..."

Micky C is an eduke32 mapper who started playing around with the editor in 2009. Being highly skilled in TROR (and polymer lighting), Micky C wrote the True Room Over Room mapping guide, with tweaks from Helixhorned (TROR's creator). He also did the polymer lighting maphacks for episodes 2 and 3 (with minor changes in episodes 1 and 4) for the HRP, as well as those for Duke it out in DC's HRP.

He is perhaps considered the community's expert mapper on TROR and polymer lights, certainly being amongst the most experienced in both fields.

EDuke32 Modifications

2013-11-13T12:44:36Z

Micky C: /* Released */

True Room Over Room Mapping Guide

2013-06-23T07:52:21Z

Micky C: /* Software renderer */

{{Build Intro}}

True Room Over Room is a feature new to EDuke32 that allows for the construction of [[sector]]s in a vertical arrangement. Other build games (Shadow Warrior, Blood, Redneck Rampage) are able to fake ROR by having sectors in different parts of the map and rendering them on top of each other, and EDuke32 has a similar feature using Sector Effectors. The difference between game ROR and TROR is that the sectors are physically on top of each other, making editing a lot easier and more automatic, while also making it easier to visualize what you're building. For the more technically minded, TROR is part of the engine and map format themselves, instead of an effect bolted on in the game code.

==TROR Editing Modes==
There are two modes you should be aware of before starting to build with TROR.

===Side view (orthographic view) mode===
This mode allows you see a 3D representation of your map while in 2D mode. This is toggled with '''[F3]'''. It can be rotated with the '''[Q]''' and '''[W]''' buttons, and the angle of viewing can be changed by pressing '''[A]''' and '''[Z]'''.
This mode is absolutely essential not only because it allows you to actually see what you're doing, but because in order to properly use TROR, you need to designate which is the 'active' layer that new sectors will connect to.

This can be done in 2 ways.

The first way is to press '''[Ctrl-A]''' which will grey out all other layers except the one the viewpoint (the arrow in 2D/side view mode)is in, which is the active layer. You can move the view point up and down, allowing you to edit above and below layers, by either pressing '''[page up]''' and '''[page down]''' respectively, or more accurately by pressing down the '''[middle mouse button]''' and moving the mouse forward or backwards. This method is usually prefered as it gives you much more control over the vertical position of the viewpoint. If you find the greyed-out walls distracting, you can remove them altogether by pressing '''[Ctrl-Alt-A]'''

The second way allows for more precision as you can narrow the active editing range to the height of a single (or set of) sectors. Firstly, select the sector(s) that you want to be able to edit with '''[Right-Alt]''', and press '''[Ctrl-R]'''. It's as easy as that. Press '''[Ctrl-R]''' without having any sectors highlighted to unlock the range again and be able to edit them normally.

===Invisible surfaces viewing mode===
This is for 3D mode when you want to toggle seeing invisible objects.
All you have to do to toggle this mode is press '''[I]''', which primarily allows you to see objects you've made invisible with '''['-I]'''. However, the reason why it's so useful here, is that it also shows you the boundaries between TROR layers (which are invisible in-game). This is a huge benefit when you want to visualize/figure out what's actually going on. It also allows you to edit the TROR surfaces and apply transparent or masked floors, and edit characteristics like the blocking and hitscan bits.

==Properties and Terminology==
TROR is created by selecting a sector and extending it (this will be covered later in method). This means that it creates a new sector directly on top of or below the selected sector, which is exactly the same size and shape as the original. The ceiling of the bottom sector is linked with the floor of the top sector. It then makes sense that the extended sector is called an '''extension'''.

You can have more than one extension on a sector. You can extend it above and below, then take the bottom and extend that down again and again, and the same with the top. You are effectively stacking sectors on top of each other, so these sectors are part of a '''stack'''. The great thing about stacks (even with only one extension) is that if you move the vertex of a wall of one layer, it will automatically move the vertices of all the other layers, so that they're easy to change the shape of without worrying about breaking the connection.

You can highlight a group of sectors and extend them all at the same time so that there can be a single extension covering them all. This is useful because it saves walls, and you can still edit all the child sectors with ease. Now, as soon as you extend these sectors so that they share an extension, they all become a part of the same '''bunch'''.

If you take a room with a child sector in the middle, and extend everything upwards except the child layer, there will now be void space in the top layer where the child sector is. If you press '''[Ctrl-S]''' there to make it into a child sector in the top layer, you'll then find that you have a floating normal (non-TROR) sector between the two TROR layers that you can do with as you please. This is called an '''island'''. I suppose it's still an island even if you don't make it a child sector in the top layer but hey, now you can create floating sectors. These can potentially be glitchy if you're not using the polymer renderer, but we'll get onto that later.

==TROR related keys==
The following are a list of keys which are related to editing TROR. They can also be found in the [http://wiki.eduke32.com/wiki/Build/Mapster32_Keyboard_Commands mapster32 keyboard commands page]

===2D mode===
'''[Ctrl-E]''' sector extension prompt (sectors to extend must be highlighted) 
'''[Ctrl-E]''' make sandwich [''if extending a sector in a direction that has already been extended, see below''] 
'''[Ctrl-E]''' punch loop through extension (loop points must be highlighted, e.g. with '''[Right Shift]'''+'''[Left Ctrl]''') 
 
'''[Ctrl-A]''' toggle auto-grayout of non-extended sectors 
'''[Ctrl-J]''' TROR-join sectors. The selection must consist of the two sets of sectors you wish to join. 
'''[Ctrl-U]''' Clear extension: delete the bunch (i.e. ceiling-floor connection) of the aimed-at sector's floor 
'''[PGUP]'''/'''[PGDN]''' Change 'player' height in discrete steps in order to go through the different levels 
'''[Ctrl-tab]''' Display one currently aimed at sector (of potentially many that lie under the mouse crosshair) 
'''[HOME]''' and '''[END]''' as modifiers to AltGr: select all sectors whose floor's/ceiling's bunchnum equal the bunchnum of the aimed at sector (useful for further operations on whole bunches)

===3D mode===
'''I''' invisibility preview: toggle fake ROR texture on non-masked portals 
'''LENTER+CTRL''' When aiming at an extended floor/ceiling, paste to all floors/ceilings of the bunch of the aimed at one 
'''T''', '''B''' and '''H''' work as with walls, though they set/toggle the bits only on '''one''' side 

===Advanced Highlighting===
Not really specific to TROR, but having greater control over which or how many sectors you can highlight makes doing extensions in TROR much easier. Make sure you're familiar with [http://wiki.eduke32.com/wiki/Level_editing#Copying_and_Pasting_Sectors advanced sector highlighting].

The information on the advanced features is outlined below:

You can highlight a second, third, and multiple sectors by holding down '''[']''' as you drag the selection box over them. This way you can highlight sectors in different parts of the map. Likewise, use the '''[;]''' key to deselect sectors. A small plus or minus will appear next to the cursor depending on which button you're holding.

You can select individual sectors with the mouse by moving the cursor inside the sector you want, holding '''[RIGHT ALT]''', and holding '''[RIGHT CTRL]''' as you release '''[RIGHT ALT]'''. The sector is now highlighted. This method of selection also works with '''[']''' and '''[;]''' to select/deselect additional sectors by mouse. Simply hold '''[RIGHT ALT]''' and the appropriate button depending on what you want to do, then hold '''[RIGHT CTRL]''' while releasing the other buttons. This becomes very quick and easy to do after doing it a few times.

==TROR Mapping Examples==

===Manhole Sewer Example===

In this straightforward example, you're going to make a manhole that goes below a street, and some area around the end of the hole at the bottom.

1. Create the child sector where you want the manhole to be.

2. Highlight the sector with '''[Right-Alt]'''.

3. Press '''[Ctrl-E]'''. Mapster will prompt you whether you want to extend up or down.

4. We want to extend down so press '''[Z]''' ('''[A]''' if you're extending up).

5. Go into side view mode with '''[F3]''', and move the viewpoint down until you're editing the bottom layer.

6. The child sector you created should now have a white boundary, with the street sectors above either greyed out or gone depending on your settings.

7. Now you can treat the manhole sector (the extension) as the very first room you've made on a new map. You can draw sectors on the side of it to attach some rooms there. If you go into 3D mode, you should be able to see that if you go down that manhole, there should now be some area at the bottom which overlaps the street. This was not previously possible without using some kind of cheap trick. Congratulations, you've just made TROR.

===Two Story Building Example===

I'm sure that a big reason that people want to use TROR is to build multiple story buildings, and this is how you do it.

1. Design the first floor of your building, both inside and out. This is going to be the first layer, which means the ceiling of every sector, especially the outdoor sectors should not be any higher than the roof of the first floor. Pretend that the second floor doesn't even exist.

2. Make your windows, doors, and anything you want.

Highlight with '''[Right-Alt]''' all of the ''outdoor'' sectors (the outdoor sectors should all have the same ceiling height, and should not be parallaxed). Knowing your advanced highlighting will come in useful here to select all the sectors.

3. Extend the highlighted area up, and make the top layer the active editing layer.

4. You should notice that the outline of your house has become completely white, and the area inside the house is empty. This is because this area is the second floor of your house.

5. Make a sector inside the house outline, this will be the room on the second floor of your house. Draw small sectors between that room and the house outline to create second floor windows. Alternatively you could just press '''[Ctrl-S]''' inside the house sector to make it a regular child sector, and if you go into 3D mode, you'll see your house has a roof you can stand on top of.

6. If you're learning TROR for the first time, it is very helpful at this point to go into 3D mode and press '''[i]''' to reveal the boundaries between layers so that you can understand what you've done.

7. You can connect the ground floor to the second floor the same way you'd connect two sector-over-sector sectors; by having a staircase or lift that connects to a different area on the top floor than it does on the bottom (because a lift for example cannot directly cross TROR layers, therefore it must be connected to sectors which do not overlap; i.e have the entrance on one side and the exit on the other.)
Or you can connect the ground floor and second floor via TROR and have some sprite stairs or something.

At this stage you should have a perfect two story house where you can look into and enter both stories. Cool stuff eh? ;)

There's nothing stopping you from going on to build a third.. forth.. fifth.. floor in the same manner either.

===TROR water example===

This is how you create transparent water using TROR. It works just like regular water, but there are a few things you need to be aware of.

1. Create a main sector, then a child sector in that and extend it downwards.

2. Make both the top and bottom of the TROR surface masked or transparent, and give it the water texture.

3. Give the floor of the top sector a lotag of 1 for water. Give the floor of the bottom sector a lotag of 2 for underwater.

4. Place an SE 7 with the same hitag in the same position in both the top and bottom sector.

5. This is the one that people normally forget. Set the TROR surface in both the top and bottom layer to BLOCKING otherwise it will not work as intended.

See, it's not too bad, just remember the lotags and the blocking. Note if you split up the water sector or add more sectors, make sure those sectors are in both the top and bottom layers, and have new SE 7s, just like normal water. In the future TROR water will be more automatic in that you won't need the SE 7, however this is incomplete as of this writing.

Something that might make life a bit easier is that if you extend the floor of the below-water sector downwards, you can then edit the floor of the new bottom layer and make as complex as you want without having to worry about placing lots of SE 7s.

===Retro-fitting via Joining Example===

If you're absolutely clueless with the whole idea of extending, or you want to go back and retrofit some TROR into maps you've done in the past, there's a very easy way of joining them to form TROR.
If you have two sectors that have the same shape, area, and external vertices have the same relative positions (essentially they're the same sector, at least as far as their edges are concerned), then all you have to do is highlight both sectors with '''[Right-Alt]''', and press '''[Ctrl-J]''' to join, the same as joining two sectors normally. It will then prompt you with a few questions such as which sector you want to have on top of the other, which sector(s) you want to move (doesn't matter most of the time), and whether you'd like to move all the connected non-TROR sectors as well (definitely yes).

The good thing about this method is that besides the questions you have to answer, mapster does everything automatically, it even moves the heights for you. Now there'll be a quick example of this method below.

1. Make a child sector in a larger sector and copy-paste it into void space.

2. Give the floor of the original child sector and the ceiling of the new sector the water texture.

3. Highlight both the child sector and new sector with '''[Right-Alt]'''.

4. Press '''[Ctrl-J]''' and answer the simple questions.

5. You should end up with a TROR water sector just as you would via the extension method. You can now alter the transparency of the water to your preference.

===Sandwiching and Sector Punching===
It's possible and easy to create a new TROR layer between two TROR layers. All you have to do is highlight one of them, and extend it as you would normally, and it automatically adds a new layer in the middle.

It's also possible to easily create an island sector in the middle of a TROR sector. This is called ''sector punching'', and mainly involves stamping a child sector into the sector below or above. Follow the example below.

1. Extend a sector downwards.

2. Create a child sector in the original sector.

3. Select the vertices of the child sector with '''[Right-Shift]''' or '''[R-Ctrl + R-Shift]''' and press '''[Ctrl-E]''' as though you're extending a sector.

4. It will prompt you whether to punch up or down, in this case, choose down and hit '''[Enter]'''. A sector identical in size, shape and position should now be in the bottom layer.

5. Point the mouse cursor at the child sector in the top layer and press '''[Ctrl-U]'''. It will prompt you whether you want to break the connection, and unless you press [Ctrl-U] accidentally, you usually do.

6. The child sector should now be a floating sector island. Have fun.

Note that '''[Ctrl-U]''' only breaks the connection of a single sector if that sector has been punched. Otherwise it'll break the connection of the entire bunch, which is usually bad.

===List of TROR maps===

This (hopefully up to date) list contains maps which make heavy use of the TROR feature in order to make a huge variety of constructions. They each contain a wealth of examples for you to look at to see what's possible and how it works/how to make it. This is not a complete list, as other maps make minor or simple use of the effect and hence are not listed here.

1. The trueror.map in the Samples folder included with eduke32 contains a large amount of random examples of TROR.

2. Retaliation is a small hi-tech map by Loke that was the first proper TROR map and makes some great use of the feature. [http://www.scent-88.com/reviews/R/retaliation/retaliation.php Download here]

3. Parkade is a large city themed map containing large multiple story buildings, along with a large amount of unique, pioneering uses of the feature, made by myself (Micky C) and Paul B. It is the largest, most extensive TROR map and perhaps the best example of what TROR is capable of so far, if I do say so myself. [http://www.scent-88.com/reviews/P/parkade/parkade.php Download here]

4. Brooklyn Bridge is another city themed map which also makes extensive and interesting use of TROR, such as an alien ship that flies over water, shooting rockets, and in vents. [http://www.scent-88.com/reviews/B/brooklyn/brooklyn.php Download here]

==Tricks and Effects with TROR==

===SE 13 destructible floor/ceiling===

If you have a TROR extension in the floor, you can place an SE 13 on it (facing downwards in 2D mode, and it will become a solid floor in-game (blocked and masked). When the hitag is activated, the TROR surface will become invisible as though a hole has just formed in the floor. You can place the SE 13 on the surface, or above, in which case the floor will initially have the height of the SE 13 just like with the original effect. You can also place it near the ceiling to make the SE 13 control the ceiling instead, or have one near the ceiling and one near the floor to control both.

When placed in a TROR extension with many sectors, it will not just control the sector, but rather the entire extension. So you can add sectors and give them different textures and don't have to worry about adding extra SE 13's. If you want to have TROR surfaces have different heights with different SE 13 sprites, they need to be different extensions; i.e they need to have a sector in both the top and bottom layer, and be extended individually.

The SE 13 also works with TROR slopes, allowing you to create relatively complex destructible objects compared to sprites. But remember that TROR is pretty wall hungry, so keep an eye on complexity.
Note that regardless of whether a TROR surface is set to masked or transparent in mapster, it will always become invisible after SE 13 activation.

===TROR water height manipulation===

TROR water can also be made to move up and down using the SE 31/32, much like the raising/lowering submergible water in e1l4 Toxic Dump. The effect is the same, however it's easier with TROR, because you only have to set up the effect on one side, either in the top layer or bottom layer, because this effect is set up so that if the ceiling of the bottom sector is moved, it moves the floor of the top sector as well, and vice versa.

==Visual Glitches and Workarounds==

===Software renderer===
Even though TROR sectors are already physically overlapping, the 8-bit software renderer still needs to render them separately, having to do an extra rendering pass for each additional TROR extension in view. Theoretically if you create a huge amount of extensions in the same area the framerate could potentially drop to unplayable levels, however this is far fetched and I wouldn't worry about it.

The real problem with the software renderer is HOM glitching. In each rendering pass, there can only be one area along the x-interval drawn. For example, if you have an island on the ground, the area between you and the island will be fine, but everything on the other side of the island will show HOM. Try it out yourself to see what I mean. Technically this means that TROR extensions cannot contain islands (although it's been kind of hacked in to do exta-extra passes to overcome this problem, I wouldn't rely on them for perfect drawing.)

However, this can be overcome by breaking up the sector surrounding the child sector, and extending each sector individually. This means there will be multiple drawing portals around the island instead of one big one, and none of the individual extensions would contain the island, hence it should draw fine.

This HOM doesn't just occur due to islands, it can also happen when part of a normal sector is jutting out into a TROR sector, this can be thought of here as a mini-island even though it's connected to something. Don't call it a mini-island, I only called it that to explain why it would cause that glitching. This means that TROR extensions should be ''convex'', i.e if you draw a straight line through a TROR portal so that it leaves the sector, and then comes back, it is not convex (and is most likely due to something jutting out.) However if you draw a line through it and this does not happen, as is the case for a circle, square etc.. then it is convex, and should draw fine.

Also note that currently the software renderer doesn't allow the player to see through more than 8 layers of TROR (it draws the texture on the surface instead). This normally isn't a problem in small sectors of TROR because the player typically won't be able to look up high enough to see the 8 layers due to vertical distortion. The limit could potentially be increased if someone desperately needed it (talk to the devs for that.)

===Polymer renderer===
Masked floors and ceilings in polymer are always the last thing drawn on the screen. That means if you have a transparent surface such as a masked wall or sprite, it would cause everything all the TROR masked surfaces behind the transparent surface to stop being drawn and become invisible. There's no real work around for this, just try not to use masked walls or sprites with big transparent surfaces around TROR masked surfaces.

Other than that, polymer is by far the most stable renderer for TROR, and apart from what's written above, is 100% glitch free. Despite being slow sometimes, it is the renderer of choice for TROR. It works by drawing the entire scene, TROR and all in a single rendering pass. This means that it doesn't require any additional computer power to draw TROR, hence TROR will not affect the framerate in polymer.

===Polymost renderer===
The polymost renderer is bad, M'kay? It's like a comic relief in bad Hollywood films who can't do anything right. Don't use it. It has also been observed that some TROR constructions work perfectly on some computers, however are incredibly glitchy on others, so if you do decide to use this renderer, and TROR works for you, make sure you have two or three other people check it on their setups before you release your map. There are no plans to add complete polymost TROR compatibility as polymost will be obsolete once polymer is finished and optimised.

==Random Trivia==
Extended sectors can be sloped, but the bunch has to be 1:1 in that case. I.e you can't have any child sectors within a sloped TROR sector. If you want different TROR sectors with different slopes, you must use completely different extensions for that, as opposed to breaking up a single extension.

Maps containing one or more TROR bunches are saved in a new map format (v9) since some fields had to be taken over: xrepeat is unavailable on TROR'ed floors and ceilings, and on walls it's lotag if the ceiling, and extra if the floor of the wall's sector is extended. When in-game, these get transferred to internal arrays though.

The system is supposed to be used for 'large-scale' RoR, as a rule of thumb each affected sector should be at least a Duke high [that's too strict though].

[[Category:Level editing documentation]]

True Room Over Room Mapping Guide

2013-03-16T02:56:27Z

Micky C:

{{Build Intro}}

True Room Over Room is a feature new to EDuke32 that allows for the construction of [[sector]]s in a vertical arrangement. Other build games (Shadow Warrior, Blood, Redneck Rampage) are able to fake ROR by having sectors in different parts of the map and rendering them on top of each other, and EDuke32 has a similar feature using Sector Effectors. The difference between game ROR and TROR is that the sectors are physically on top of each other, making editing a lot easier and more automatic, while also making it easier to visualize what you're building. For the more technically minded, TROR is part of the engine and map format themselves, instead of an effect bolted on in the game code.

==TROR Editing Modes==
There are two modes you should be aware of before starting to build with TROR.

===Side view (orthographic view) mode===
This mode allows you see a 3D representation of your map while in 2D mode. This is toggled with '''[F3]'''. It can be rotated with the '''[Q]''' and '''[W]''' buttons, and the angle of viewing can be changed by pressing '''[A]''' and '''[Z]'''.
This mode is absolutely essential not only because it allows you to actually see what you're doing, but because in order to properly use TROR, you need to designate which is the 'active' layer that new sectors will connect to.

This can be done in 2 ways.

The first way is to press '''[Ctrl-A]''' which will grey out all other layers except the one the viewpoint (the arrow in 2D/side view mode)is in, which is the active layer. You can move the view point up and down, allowing you to edit above and below layers, by either pressing '''[page up]''' and '''[page down]''' respectively, or more accurately by pressing down the '''[middle mouse button]''' and moving the mouse forward or backwards. This method is usually prefered as it gives you much more control over the vertical position of the viewpoint. If you find the greyed-out walls distracting, you can remove them altogether by pressing '''[Ctrl-Alt-A]'''

The second way allows for more precision as you can narrow the active editing range to the height of a single (or set of) sectors. Firstly, select the sector(s) that you want to be able to edit with '''[Right-Alt]''', and press '''[Ctrl-R]'''. It's as easy as that. Press '''[Ctrl-R]''' without having any sectors highlighted to unlock the range again and be able to edit them normally.

===Invisible surfaces viewing mode===
This is for 3D mode when you want to toggle seeing invisible objects.
All you have to do to toggle this mode is press '''[I]''', which primarily allows you to see objects you've made invisible with '''['-I]'''. However, the reason why it's so useful here, is that it also shows you the boundaries between TROR layers (which are invisible in-game). This is a huge benefit when you want to visualize/figure out what's actually going on. It also allows you to edit the TROR surfaces and apply transparent or masked floors, and edit characteristics like the blocking and hitscan bits.

==Properties and Terminology==
TROR is created by selecting a sector and extending it (this will be covered later in method). This means that it creates a new sector directly on top of or below the selected sector, which is exactly the same size and shape as the original. The ceiling of the bottom sector is linked with the floor of the top sector. It then makes sense that the extended sector is called an '''extension'''.

You can have more than one extension on a sector. You can extend it above and below, then take the bottom and extend that down again and again, and the same with the top. You are effectively stacking sectors on top of each other, so these sectors are part of a '''stack'''. The great thing about stacks (even with only one extension) is that if you move the vertex of a wall of one layer, it will automatically move the vertices of all the other layers, so that they're easy to change the shape of without worrying about breaking the connection.

You can highlight a group of sectors and extend them all at the same time so that there can be a single extension covering them all. This is useful because it saves walls, and you can still edit all the child sectors with ease. Now, as soon as you extend these sectors so that they share an extension, they all become a part of the same '''bunch'''.

If you take a room with a child sector in the middle, and extend everything upwards except the child layer, there will now be void space in the top layer where the child sector is. If you press '''[Ctrl-S]''' there to make it into a child sector in the top layer, you'll then find that you have a floating normal (non-TROR) sector between the two TROR layers that you can do with as you please. This is called an '''island'''. I suppose it's still an island even if you don't make it a child sector in the top layer but hey, now you can create floating sectors. These can potentially be glitchy if you're not using the polymer renderer, but we'll get onto that later.

==TROR related keys==
The following are a list of keys which are related to editing TROR. They can also be found in the [http://wiki.eduke32.com/wiki/Build/Mapster32_Keyboard_Commands mapster32 keyboard commands page]

===2D mode===
'''[Ctrl-E]''' sector extension prompt (sectors to extend must be highlighted) 
'''[Ctrl-E]''' make sandwich [''if extending a sector in a direction that has already been extended, see below''] 
'''[Ctrl-E]''' punch loop through extension (loop points must be highlighted, e.g. with '''[Right Shift]'''+'''[Left Ctrl]''') 
 
'''[Ctrl-A]''' toggle auto-grayout of non-extended sectors 
'''[Ctrl-J]''' TROR-join sectors. The selection must consist of the two sets of sectors you wish to join. 
'''[Ctrl-U]''' Clear extension: delete the bunch (i.e. ceiling-floor connection) of the aimed-at sector's floor 
'''[PGUP]'''/'''[PGDN]''' Change 'player' height in discrete steps in order to go through the different levels 
'''[Ctrl-tab]''' Display one currently aimed at sector (of potentially many that lie under the mouse crosshair) 
'''[HOME]''' and '''[END]''' as modifiers to AltGr: select all sectors whose floor's/ceiling's bunchnum equal the bunchnum of the aimed at sector (useful for further operations on whole bunches)

===3D mode===
'''I''' invisibility preview: toggle fake ROR texture on non-masked portals 
'''LENTER+CTRL''' When aiming at an extended floor/ceiling, paste to all floors/ceilings of the bunch of the aimed at one 
'''T''', '''B''' and '''H''' work as with walls, though they set/toggle the bits only on '''one''' side 

===Advanced Highlighting===
Not really specific to TROR, but having greater control over which or how many sectors you can highlight makes doing extensions in TROR much easier. Make sure you're familiar with [http://wiki.eduke32.com/wiki/Level_editing#Copying_and_Pasting_Sectors advanced sector highlighting].

The information on the advanced features is outlined below:

You can highlight a second, third, and multiple sectors by holding down '''[']''' as you drag the selection box over them. This way you can highlight sectors in different parts of the map. Likewise, use the '''[;]''' key to deselect sectors. A small plus or minus will appear next to the cursor depending on which button you're holding.

You can select individual sectors with the mouse by moving the cursor inside the sector you want, holding '''[RIGHT ALT]''', and holding '''[RIGHT CTRL]''' as you release '''[RIGHT ALT]'''. The sector is now highlighted. This method of selection also works with '''[']''' and '''[;]''' to select/deselect additional sectors by mouse. Simply hold '''[RIGHT ALT]''' and the appropriate button depending on what you want to do, then hold '''[RIGHT CTRL]''' while releasing the other buttons. This becomes very quick and easy to do after doing it a few times.

==TROR Mapping Examples==

===Manhole Sewer Example===

In this straightforward example, you're going to make a manhole that goes below a street, and some area around the end of the hole at the bottom.

1. Create the child sector where you want the manhole to be.

2. Highlight the sector with '''[Right-Alt]'''.

3. Press '''[Ctrl-E]'''. Mapster will prompt you whether you want to extend up or down.

4. We want to extend down so press '''[Z]''' ('''[A]''' if you're extending up).

5. Go into side view mode with '''[F3]''', and move the viewpoint down until you're editing the bottom layer.

6. The child sector you created should now have a white boundary, with the street sectors above either greyed out or gone depending on your settings.

7. Now you can treat the manhole sector (the extension) as the very first room you've made on a new map. You can draw sectors on the side of it to attach some rooms there. If you go into 3D mode, you should be able to see that if you go down that manhole, there should now be some area at the bottom which overlaps the street. This was not previously possible without using some kind of cheap trick. Congratulations, you've just made TROR.

===Two Story Building Example===

I'm sure that a big reason that people want to use TROR is to build multiple story buildings, and this is how you do it.

1. Design the first floor of your building, both inside and out. This is going to be the first layer, which means the ceiling of every sector, especially the outdoor sectors should not be any higher than the roof of the first floor. Pretend that the second floor doesn't even exist.

2. Make your windows, doors, and anything you want.

Highlight with '''[Right-Alt]''' all of the ''outdoor'' sectors (the outdoor sectors should all have the same ceiling height, and should not be parallaxed). Knowing your advanced highlighting will come in useful here to select all the sectors.

3. Extend the highlighted area up, and make the top layer the active editing layer.

4. You should notice that the outline of your house has become completely white, and the area inside the house is empty. This is because this area is the second floor of your house.

5. Make a sector inside the house outline, this will be the room on the second floor of your house. Draw small sectors between that room and the house outline to create second floor windows. Alternatively you could just press '''[Ctrl-S]''' inside the house sector to make it a regular child sector, and if you go into 3D mode, you'll see your house has a roof you can stand on top of.

6. If you're learning TROR for the first time, it is very helpful at this point to go into 3D mode and press '''[i]''' to reveal the boundaries between layers so that you can understand what you've done.

7. You can connect the ground floor to the second floor the same way you'd connect two sector-over-sector sectors; by having a staircase or lift that connects to a different area on the top floor than it does on the bottom (because a lift for example cannot directly cross TROR layers, therefore it must be connected to sectors which do not overlap; i.e have the entrance on one side and the exit on the other.)
Or you can connect the ground floor and second floor via TROR and have some sprite stairs or something.

At this stage you should have a perfect two story house where you can look into and enter both stories. Cool stuff eh? ;)

There's nothing stopping you from going on to build a third.. forth.. fifth.. floor in the same manner either.

===TROR water example===

This is how you create transparent water using TROR. It works just like regular water, but there are a few things you need to be aware of.

1. Create a main sector, then a child sector in that and extend it downwards.

2. Make both the top and bottom of the TROR surface masked or transparent, and give it the water texture.

3. Give the floor of the top sector a lotag of 1 for water. Give the floor of the bottom sector a lotag of 2 for underwater.

4. Place an SE 7 with the same hitag in the same position in both the top and bottom sector.

5. This is the one that people normally forget. Set the TROR surface in both the top and bottom layer to BLOCKING otherwise it will not work as intended.

See, it's not too bad, just remember the lotags and the blocking. Note if you split up the water sector or add more sectors, make sure those sectors are in both the top and bottom layers, and have new SE 7s, just like normal water. In the future TROR water will be more automatic in that you won't need the SE 7, however this is incomplete as of this writing.

Something that might make life a bit easier is that if you extend the floor of the below-water sector downwards, you can then edit the floor of the new bottom layer and make as complex as you want without having to worry about placing lots of SE 7s.

===Retro-fitting via Joining Example===

If you're absolutely clueless with the whole idea of extending, or you want to go back and retrofit some TROR into maps you've done in the past, there's a very easy way of joining them to form TROR.
If you have two sectors that have the same shape, area, and external vertices have the same relative positions (essentially they're the same sector, at least as far as their edges are concerned), then all you have to do is highlight both sectors with '''[Right-Alt]''', and press '''[Ctrl-J]''' to join, the same as joining two sectors normally. It will then prompt you with a few questions such as which sector you want to have on top of the other, which sector(s) you want to move (doesn't matter most of the time), and whether you'd like to move all the connected non-TROR sectors as well (definitely yes).

The good thing about this method is that besides the questions you have to answer, mapster does everything automatically, it even moves the heights for you. Now there'll be a quick example of this method below.

1. Make a child sector in a larger sector and copy-paste it into void space.

2. Give the floor of the original child sector and the ceiling of the new sector the water texture.

3. Highlight both the child sector and new sector with '''[Right-Alt]'''.

4. Press '''[Ctrl-J]''' and answer the simple questions.

5. You should end up with a TROR water sector just as you would via the extension method. You can now alter the transparency of the water to your preference.

===Sandwiching and Sector Punching===
It's possible and easy to create a new TROR layer between two TROR layers. All you have to do is highlight one of them, and extend it as you would normally, and it automatically adds a new layer in the middle.

It's also possible to easily create an island sector in the middle of a TROR sector. This is called ''sector punching'', and mainly involves stamping a child sector into the sector below or above. Follow the example below.

1. Extend a sector downwards.

2. Create a child sector in the original sector.

3. Select the vertices of the child sector with '''[Right-Shift]''' or '''[R-Ctrl + R-Shift]''' and press '''[Ctrl-E]''' as though you're extending a sector.

4. It will prompt you whether to punch up or down, in this case, choose down and hit '''[Enter]'''. A sector identical in size, shape and position should now be in the bottom layer.

5. Point the mouse cursor at the child sector in the top layer and press '''[Ctrl-U]'''. It will prompt you whether you want to break the connection, and unless you press [Ctrl-U] accidentally, you usually do.

6. The child sector should now be a floating sector island. Have fun.

Note that '''[Ctrl-U]''' only breaks the connection of a single sector if that sector has been punched. Otherwise it'll break the connection of the entire bunch, which is usually bad.

===List of TROR maps===

This (hopefully up to date) list contains maps which make heavy use of the TROR feature in order to make a huge variety of constructions. They each contain a wealth of examples for you to look at to see what's possible and how it works/how to make it. This is not a complete list, as other maps make minor or simple use of the effect and hence are not listed here.

1. The trueror.map in the Samples folder included with eduke32 contains a large amount of random examples of TROR.

2. Retaliation is a small hi-tech map by Loke that was the first proper TROR map and makes some great use of the feature. [http://www.scent-88.com/reviews/R/retaliation/retaliation.php Download here]

3. Parkade is a large city themed map containing large multiple story buildings, along with a large amount of unique, pioneering uses of the feature, made by myself (Micky C) and Paul B. It is the largest, most extensive TROR map and perhaps the best example of what TROR is capable of so far, if I do say so myself. [http://www.scent-88.com/reviews/P/parkade/parkade.php Download here]

4. Brooklyn Bridge is another city themed map which also makes extensive and interesting use of TROR, such as an alien ship that flies over water, shooting rockets, and in vents. [http://www.scent-88.com/reviews/B/brooklyn/brooklyn.php Download here]

==Tricks and Effects with TROR==

===SE 13 destructible floor/ceiling===

If you have a TROR extension in the floor, you can place an SE 13 on it (facing downwards in 2D mode, and it will become a solid floor in-game (blocked and masked). When the hitag is activated, the TROR surface will become invisible as though a hole has just formed in the floor. You can place the SE 13 on the surface, or above, in which case the floor will initially have the height of the SE 13 just like with the original effect. You can also place it near the ceiling to make the SE 13 control the ceiling instead, or have one near the ceiling and one near the floor to control both.

When placed in a TROR extension with many sectors, it will not just control the sector, but rather the entire extension. So you can add sectors and give them different textures and don't have to worry about adding extra SE 13's. If you want to have TROR surfaces have different heights with different SE 13 sprites, they need to be different extensions; i.e they need to have a sector in both the top and bottom layer, and be extended individually.

The SE 13 also works with TROR slopes, allowing you to create relatively complex destructible objects compared to sprites. But remember that TROR is pretty wall hungry, so keep an eye on complexity.
Note that regardless of whether a TROR surface is set to masked or transparent in mapster, it will always become invisible after SE 13 activation.

===TROR water height manipulation===

TROR water can also be made to move up and down using the SE 31/32, much like the raising/lowering submergible water in e1l4 Toxic Dump. The effect is the same, however it's easier with TROR, because you only have to set up the effect on one side, either in the top layer or bottom layer, because this effect is set up so that if the ceiling of the bottom sector is moved, it moves the floor of the top sector as well, and vice versa.

==Visual Glitches and Workarounds==

===Software renderer===
Even though TROR sectors are already physically overlapping, the 8-bit software renderer still needs to render them separately, having to do an extra rendering pass for each additional TROR extension in view. Theoretically if you create a huge amount of extensions in the same area the framerate could potentially drop to unplayable levels, however this is far fetched and I wouldn't worry about it.

The real problem with the software renderer is HOM glitching. In each rendering pass, there can only be one area along the x-interval drawn. For example, if you have an island on the ground, the area between you and the island will be fine, but everything on the other side of the island will show HOM. Try it out yourself to see what I mean. Technically this means that TROR extensions cannot contain islands (although it's been kind of hacked in to do exta-extra passes to overcome this problem, I wouldn't rely on them for perfect drawing.)

However, this can be overcome by breaking up the sector surrounding the child sector, and extending each sector individually. This means there will be multiple drawing portals around the island instead of one big one, and none of the individual extensions would contain the island, hence it should draw fine.

This HOM doesn't just occur due to islands, it can also happen when part of a normal sector is jutting out into a TROR sector, this can be thought of here as a mini-island even though it's connected to something. Don't call it a mini-island, I only called it that to explain why it would cause that glitching. This means that TROR extensions should be ''convex'', i.e if you draw a straight line through a TROR portal so that it leaves the sector, and then comes back, it is not convex (and is most likely due to something jutting out.) However if you draw a line through it and this does not happen, as is the case for a circle, square etc.. then it is convex, and should draw fine.

===Polymer renderer===
Masked floors and ceilings in polymer are always the last thing drawn on the screen. That means if you have a transparent surface such as a masked wall or sprite, it would cause everything all the TROR masked surfaces behind the transparent surface to stop being drawn and become invisible. There's no real work around for this, just try not to use masked walls or sprites with big transparent surfaces around TROR masked surfaces.

Other than that, polymer is by far the most stable renderer for TROR, and apart from what's written above, is 100% glitch free. Despite being slow sometimes, it is the renderer of choice for TROR. It works by drawing the entire scene, TROR and all in a single rendering pass. This means that it doesn't require any additional computer power to draw TROR, hence TROR will not affect the framerate in polymer.

===Polymost renderer===
The polymost renderer is bad, M'kay? It's like a comic relief in bad Hollywood films who can't do anything right. Don't use it. It has also been observed that some TROR constructions work perfectly on some computers, however are incredibly glitchy on others, so if you do decide to use this renderer, and TROR works for you, make sure you have two or three other people check it on their setups before you release your map. There are no plans to add complete polymost TROR compatibility as polymost will be obsolete once polymer is finished and optimised.

==Random Trivia==
Extended sectors can be sloped, but the bunch has to be 1:1 in that case. I.e you can't have any child sectors within a sloped TROR sector. If you want different TROR sectors with different slopes, you must use completely different extensions for that, as opposed to breaking up a single extension.

Maps containing one or more TROR bunches are saved in a new map format (v9) since some fields had to be taken over: xrepeat is unavailable on TROR'ed floors and ceilings, and on walls it's lotag if the ceiling, and extra if the floor of the wall's sector is extended. When in-game, these get transferred to internal arrays though.

The system is supposed to be used for 'large-scale' RoR, as a rule of thumb each affected sector should be at least a Duke high [that's too strict though].

[[Category:Level editing documentation]]

True Room Over Room Mapping Guide

2013-03-16T02:53:55Z

Micky C:

{{Build Intro}}

True Room Over Room is a feature new to EDuke32 that allows for the construction of [[sector]]s in a vertical arrangement. Other build games (Shadow Warrior, Blood, Redneck Rampage) are able to fake ROR by having sectors in different parts of the map and rendering them on top of each other, and EDuke32 has a similar feature using Sector Effectors. The difference between game ROR and TROR is that the sectors are physically on top of each other, making editing a lot easier and more automatic, while also making it easier to visualize what you're building. For the more technically minded, TROR is part of the engine and map format themselves, instead of an effect bolted on in the game code.

==TROR Editing Modes==
There are two modes you should be aware of before starting to build with TROR.

===Side view (orthographic view) mode===
This mode allows you see a 3D representation of your map while in 2D mode. This is toggled with '''[F3]'''. It can be rotated with the '''[Q]''' and '''[W]''' buttons, and the angle of viewing can be changed by pressing '''[A]''' and '''[Z]'''.
This mode is absolutely essential not only because it allows you to actually see what you're doing, but because in order to properly use TROR, you need to designate which is the 'active' layer that new sectors will connect to.

This can be done in 2 ways.

The first way is to press '''[Ctrl-A]''' which will grey out all other layers except the one the viewpoint (the arrow in 2D/side view mode)is in, which is the active layer. You can move the view point up and down, allowing you to edit above and below layers, by either pressing '''[page up]''' and '''[page down]''' respectively, or more accurately by pressing down the '''[middle mouse button]''' and moving the mouse forward or backwards. This method is usually prefered as it gives you much more control over the vertical position of the viewpoint. If you find the greyed-out walls distracting, you can remove them altogether by pressing '''[Ctrl-Alt-A]'''

The second way allows for more precision as you can narrow the active editing range to the height of a single (or set of) sectors. Firstly, select the sector(s) that you want to be able to edit with '''[Right-Alt]''', and press '''[Ctrl-R]'''. It's as easy as that. Press '''[Ctrl-R]''' without having any sectors highlighted to unlock the range again and be able to edit them normally.

===Invisible surfaces viewing mode===
This is for 3D mode when you want to toggle seeing invisible objects.
All you have to do to toggle this mode is press '''[I]''', which primarily allows you to see objects you've made invisible with '''['-I]'''. However, the reason why it's so useful here, is that it also shows you the boundaries between TROR layers (which are invisible in-game). This is a huge benefit when you want to visualize/figure out what's actually going on. It also allows you to edit the TROR surfaces and apply transparent or masked floors, and edit characteristics like the blocking and hitscan bits.

==Properties and Terminology==
TROR is created by selecting a sector and extending it (this will be covered later in method). This means that it creates a new sector directly on top of or below the selected sector, which is exactly the same size and shape as the original. The ceiling of the bottom sector is linked with the floor of the top sector. It then makes sense that the extended sector is called an '''extension'''.

You can have more than one extension on a sector. You can extend it above and below, then take the bottom and extend that down again and again, and the same with the top. You are effectively stacking sectors on top of each other, so these sectors are part of a '''stack'''. The great thing about stacks (even with only one extension) is that if you move the vertex of a wall of one layer, it will automatically move the vertices of all the other layers, so that they're easy to change the shape of without worrying about breaking the connection.

You can highlight a group of sectors and extend them all at the same time so that there can be a single extension covering them all. This is useful because it saves walls, and you can still edit all the child sectors with ease. Now, as soon as you extend these sectors so that they share an extension, they all become a part of the same '''bunch'''.

If you take a room with a child sector in the middle, and extend everything upwards except the child layer, there will now be void space in the top layer where the child sector is. If you press '''[Ctrl-S]''' there to make it into a child sector in the top layer, you'll then find that you have a floating normal (non-TROR) sector between the two TROR layers that you can do with as you please. This is called an '''island'''. I suppose it's still an island even if you don't make it a child sector in the top layer but hey, now you can create floating sectors. These can potentially be glitchy if you're not using the polymer renderer, but we'll get onto that later.

==TROR related keys==
The following are a list of keys which are related to editing TROR. They can also be found in the [http://wiki.eduke32.com/wiki/Build/Mapster32_Keyboard_Commands mapster32 keyboard commands page]

===2D mode===
'''[Ctrl-E]''' sector extension prompt (sectors to extend must be highlighted) 
'''[Ctrl-E]''' make sandwich [''if extending a sector in a direction that has already been extended, see below''] 
'''[Ctrl-E]''' punch loop through extension (loop points must be highlighted, e.g. with '''[Right Shift]'''+'''[Left Ctrl]''') 
 
'''[Ctrl-A]''' toggle auto-grayout of non-extended sectors 
'''[Ctrl-J]''' TROR-join sectors. The selection must consist of the two sets of sectors you wish to join. 
'''[Ctrl-U]''' Clear extension: delete the bunch (i.e. ceiling-floor connection) of the aimed-at sector's floor 
'''[PGUP]'''/'''[PGDN]''' Change 'player' height in discrete steps in order to go through the different levels 
'''[Ctrl-tab]''' Display one currently aimed at sector (of potentially many that lie under the mouse crosshair) 
'''[HOME]''' and '''[END]''' as modifiers to AltGr: select all sectors whose floor's/ceiling's bunchnum equal the bunchnum of the aimed at sector (useful for further operations on whole bunches)

===3D mode===
'''I''' invisibility preview: toggle fake ROR texture on non-masked portals 
'''LENTER+CTRL''' When aiming at an extended floor/ceiling, paste to all floors/ceilings of the bunch of the aimed at one 
'''T''', '''B''' and '''H''' work as with walls, though they set/toggle the bits only on '''one''' side 

===Advanced Highlighting===
Not really specific to TROR, but having greater control over which or how many sectors you can highlight makes doing extensions in TROR much easier. Make sure you're familiar with [http://wiki.eduke32.com/wiki/Level_editing#Copying_and_Pasting_Sectors advanced sector highlighting].

The information on the advanced features is outlined below:

You can highlight a second, third, and multiple sectors by holding down '''[']''' as you drag the selection box over them. This way you can highlight sectors in different parts of the map. Likewise, use the '''[;]''' key to deselect sectors. A small plus or minus will appear next to the cursor depending on which button you're holding.

You can select individual sectors with the mouse by moving the cursor inside the sector you want, holding '''[RIGHT ALT]''', and holding '''[RIGHT CTRL]''' as you release '''[RIGHT ALT]'''. The sector is now highlighted. This method of selection also works with '''[']''' and '''[;]''' to select/deselect additional sectors by mouse. Simply hold '''[RIGHT ALT]''' and the appropriate button depending on what you want to do, then hold '''[RIGHT CTRL]''' while releasing the other buttons. This becomes very quick and easy to do after doing it a few times.

==TROR Mapping Examples==

===Manhole Sewer Example===

In this straightforward example, you're going to make a manhole that goes below a street, and some area around the end of the hole at the bottom.

1. Create the child sector where you want the manhole to be.

2. Highlight the sector with '''[Right-Alt]'''.

3. Press '''[Ctrl-E]'''. Mapster will prompt you whether you want to extend up or down.

4. We want to extend down so press '''[Z]''' ('''[A]''' if you're extending up).

5. Go into side view mode with '''[F3]''', and move the viewpoint down until you're editing the bottom layer.

6. The child sector you created should now have a white boundary, with the street sectors above either greyed out or gone depending on your settings.

7. Now you can treat the manhole sector (the extension) as the very first room you've made on a new map. You can draw sectors on the side of it to attach some rooms there. If you go into 3D mode, you should be able to see that if you go down that manhole, there should now be some area at the bottom which overlaps the street. This was not previously possible without using some kind of cheap trick. Congratulations, you've just made TROR.

===Two Story Building Example===

I'm sure that a big reason that people want to use TROR is to build multiple story buildings, and this is how you do it.

1. Design the first floor of your building, both inside and out. This is going to be the first layer, which means the ceiling of every sector, especially the outdoor sectors should not be any higher than the roof of the first floor. Pretend that the second floor doesn't even exist.

2. Make your windows, doors, and anything you want.

Highlight with '''[Right-Alt]''' all of the ''outdoor'' sectors (the outdoor sectors should all have the same ceiling height, and should not be parallaxed). Knowing your advanced highlighting will come in useful here to select all the sectors.

3. Extend the highlighted area up, and make the top layer the active editing layer.

4. You should notice that the outline of your house has become completely white, and the area inside the house is empty. This is because this area is the second floor of your house.

5. Make a sector inside the house outline, this will be the room on the second floor of your house. Draw small sectors between that room and the house outline to create second floor windows. Alternatively you could just press '''[Ctrl-S]''' inside the house sector to make it a regular child sector, and if you go into 3D mode, you'll see your house has a roof you can stand on top of.

6. If you're learning TROR for the first time, it is very helpful at this point to go into 3D mode and press '''[i]''' to reveal the boundaries between layers so that you can understand what you've done.

7. You can connect the ground floor to the second floor the same way you'd connect two sector-over-sector sectors; by having a staircase or lift that connects to a different area on the top floor than it does on the bottom (because a lift for example cannot directly cross TROR layers, therefore it must be connected to sectors which do not overlap; i.e have the entrance on one side and the exit on the other.)
Or you can connect the ground floor and second floor via TROR and have some sprite stairs or something.

At this stage you should have a perfect two story house where you can look into and enter both stories. Cool stuff eh? ;)

There's nothing stopping you from going on to build a third.. forth.. fifth.. floor in the same manner either.

===TROR water example===

This is how you create transparent water using TROR. It works just like regular water, but there are a few things you need to be aware of.

1. Create a main sector, then a child sector in that and extend it downwards.

2. Make both the top and bottom of the TROR surface masked or transparent, and give it the water texture.

3. Give the floor of the top sector a lotag of 1 for water. Give the floor of the bottom sector a lotag of 2 for underwater.

4. Place an SE 7 with the same hitag in the same position in both the top and bottom sector.

5. This is the one that people normally forget. Set the TROR surface in both the top and bottom layer to BLOCKING otherwise it will not work as intended.

See, it's not too bad, just remember the lotags and the blocking. Note if you split up the water sector or add more sectors, make sure those sectors are in both the top and bottom layers, and have new SE 7s, just like normal water. In the future TROR water will be more automatic in that you won't need the SE 7, however this is incomplete as of this writing.

===Retro-fitting via Joining Example===

If you're absolutely clueless with the whole idea of extending, or you want to go back and retrofit some TROR into maps you've done in the past, there's a very easy way of joining them to form TROR.
If you have two sectors that have the same shape, area, and external vertices have the same relative positions (essentially they're the same sector, at least as far as their edges are concerned), then all you have to do is highlight both sectors with '''[Right-Alt]''', and press '''[Ctrl-J]''' to join, the same as joining two sectors normally. It will then prompt you with a few questions such as which sector you want to have on top of the other, which sector(s) you want to move (doesn't matter most of the time), and whether you'd like to move all the connected non-TROR sectors as well (definitely yes).

The good thing about this method is that besides the questions you have to answer, mapster does everything automatically, it even moves the heights for you. Now there'll be a quick example of this method below.

1. Make a child sector in a larger sector and copy-paste it into void space.

2. Give the floor of the original child sector and the ceiling of the new sector the water texture.

3. Highlight both the child sector and new sector with '''[Right-Alt]'''.

4. Press '''[Ctrl-J]''' and answer the simple questions.

5. You should end up with a TROR water sector just as you would via the extension method. You can now alter the transparency of the water to your preference.

===Sandwiching and Sector Punching===
It's possible and easy to create a new TROR layer between two TROR layers. All you have to do is highlight one of them, and extend it as you would normally, and it automatically adds a new layer in the middle.

It's also possible to easily create an island sector in the middle of a TROR sector. This is called ''sector punching'', and mainly involves stamping a child sector into the sector below or above. Follow the example below.

1. Extend a sector downwards.

2. Create a child sector in the original sector.

3. Select the vertices of the child sector with '''[Right-Shift]''' or '''[R-Ctrl + R-Shift]''' and press '''[Ctrl-E]''' as though you're extending a sector.

4. It will prompt you whether to punch up or down, in this case, choose down and hit '''[Enter]'''. A sector identical in size, shape and position should now be in the bottom layer.

5. Point the mouse cursor at the child sector in the top layer and press '''[Ctrl-U]'''. It will prompt you whether you want to break the connection, and unless you press [Ctrl-U] accidentally, you usually do.

6. The child sector should now be a floating sector island. Have fun.

Note that '''[Ctrl-U]''' only breaks the connection of a single sector if that sector has been punched. Otherwise it'll break the connection of the entire bunch, which is usually bad.

===List of TROR maps===

This (hopefully up to date) list contains maps which make heavy use of the TROR feature in order to make a huge variety of constructions. They each contain a wealth of examples for you to look at to see what's possible and how it works/how to make it. This is not a complete list, as other maps make minor or simple use of the effect and hence are not listed here.

1. The trueror.map in the Samples folder included with eduke32 contains a large amount of random examples of TROR.

2. Retaliation is a small hi-tech map by Loke that was the first proper TROR map and makes some great use of the feature. [http://www.scent-88.com/reviews/R/retaliation/retaliation.php Download here]

3. Parkade is a large city themed map containing large multiple story buildings, along with a large amount of unique, pioneering uses of the feature, made by myself (Micky C) and Paul B. It is the largest, most extensive TROR map and perhaps the best example of what TROR is capable of so far, if I do say so myself. [http://www.scent-88.com/reviews/P/parkade/parkade.php Download here]

4. Brooklyn Bridge is another city themed map which also makes extensive and interesting use of TROR, such as an alien ship that flies over water, shooting rockets, and in vents. [http://www.scent-88.com/reviews/B/brooklyn/brooklyn.php Download here]

==Tricks and Effects with TROR==

===SE 13 destructible floor/ceiling===

If you have a TROR extension in the floor, you can place an SE 13 on it (facing downwards in 2D mode, and it will become a solid floor in-game (blocked and masked). When the hitag is activated, the TROR surface will become invisible as though a hole has just formed in the floor. You can place the SE 13 on the surface, or above, in which case the floor will initially have the height of the SE 13 just like with the original effect. You can also place it near the ceiling to make the SE 13 control the ceiling instead, or have one near the ceiling and one near the floor to control both.

When placed in a TROR extension with many sectors, it will not just control the sector, but rather the entire extension. So you can add sectors and give them different textures and don't have to worry about adding extra SE 13's. If you want to have TROR surfaces have different heights with different SE 13 sprites, they need to be different extensions; i.e they need to have a sector in both the top and bottom layer, and be extended individually.

The SE 13 also works with TROR slopes, allowing you to create relatively complex destructible objects compared to sprites. But remember that TROR is pretty wall hungry, so keep an eye on complexity.
Note that regardless of whether a TROR surface is set to masked or transparent in mapster, it will always become invisible after SE 13 activation.

===TROR water height manipulation===

TROR water can also be made to move up and down using the SE 31/32, much like the raising/lowering submergible water in e1l4 Toxic Dump. The effect is the same, however it's easier with TROR, because you only have to set up the effect on one side, either in the top layer or bottom layer, because this effect is set up so that if the ceiling of the bottom sector is moved, it moves the floor of the top sector as well, and vice versa.

==Visual Glitches and Workarounds==

===Software renderer===
Even though TROR sectors are already physically overlapping, the 8-bit software renderer still needs to render them separately, having to do an extra rendering pass for each additional TROR extension in view. Theoretically if you create a huge amount of extensions in the same area the framerate could potentially drop to unplayable levels, however this is far fetched and I wouldn't worry about it.

The real problem with the software renderer is HOM glitching. In each rendering pass, there can only be one area along the x-interval drawn. For example, if you have an island on the ground, the area between you and the island will be fine, but everything on the other side of the island will show HOM. Try it out yourself to see what I mean. Technically this means that TROR extensions cannot contain islands (although it's been kind of hacked in to do exta-extra passes to overcome this problem, I wouldn't rely on them for perfect drawing.)

However, this can be overcome by breaking up the sector surrounding the child sector, and extending each sector individually. This means there will be multiple drawing portals around the island instead of one big one, and none of the individual extensions would contain the island, hence it should draw fine.

This HOM doesn't just occur due to islands, it can also happen when part of a normal sector is jutting out into a TROR sector, this can be thought of here as a mini-island even though it's connected to something. Don't call it a mini-island, I only called it that to explain why it would cause that glitching. This means that TROR extensions should be ''convex'', i.e if you draw a straight line through a TROR portal so that it leaves the sector, and then comes back, it is not convex (and is most likely due to something jutting out.) However if you draw a line through it and this does not happen, as is the case for a circle, square etc.. then it is convex, and should draw fine.

===Polymer renderer===
Masked floors and ceilings in polymer are always the last thing drawn on the screen. That means if you have a transparent surface such as a masked wall or sprite, it would cause everything all the TROR masked surfaces behind the transparent surface to stop being drawn and become invisible. There's no real work around for this, just try not to use masked walls or sprites with big transparent surfaces around TROR masked surfaces.

Other than that, polymer is by far the most stable renderer for TROR, and apart from what's written above, is 100% glitch free. Despite being slow sometimes, it is the renderer of choice for TROR. It works by drawing the entire scene, TROR and all in a single rendering pass. This means that it doesn't require any additional computer power to draw TROR, hence TROR will not affect the framerate in polymer.

===Polymost renderer===
The polymost renderer is bad, M'kay? It's like a comic relief in bad Hollywood films who can't do anything right. Don't use it. It has also been observed that some TROR constructions work perfectly on some computers, however are incredibly glitchy on others, so if you do decide to use this renderer, and TROR works for you, make sure you have two or three other people check it on their setups before you release your map. There are no plans to add complete polymost TROR compatibility as polymost will be obsolete once polymer is finished and optimised.

==Random Trivia==
Extended sectors can be sloped, but the bunch has to be 1:1 in that case. I.e you can't have any child sectors within a sloped TROR sector. If you want different TROR sectors with different slopes, you must use completely different extensions for that, as opposed to breaking up a single extension.

Maps containing one or more TROR bunches are saved in a new map format (v9) since some fields had to be taken over: xrepeat is unavailable on TROR'ed floors and ceilings, and on walls it's lotag if the ceiling, and extra if the floor of the wall's sector is extended. When in-game, these get transferred to internal arrays though.

The system is supposed to be used for 'large-scale' RoR, as a rule of thumb each affected sector should be at least a Duke high [that's too strict though].

[[Category:Level editing documentation]]

True Room Over Room Mapping Guide

2013-03-16T02:53:25Z

Micky C:

{{Build Intro}}

True Room Over Room is a feature new to EDuke32 that allows for the construction of [[sector]]s in a vertical arrangement. Other build games (Shadow Warrior, Blood, Redneck Rampage) are able to fake ROR by having sectors in different parts of the map and rendering them on top of each other, and EDuke32 has a similar feature using Sector Effectors. The difference between game ROR and TROR is that the sectors are physically on top of each other, making editing a lot easier and more automatic, while also making it easier to visualize what you're building. For the more technically minded, TROR is part of the engine and map format themselves, instead of an effect bolted on in the game code.

==TROR Editing Modes==
There are two modes you should be aware of before starting to build with TROR.

===Side view (orthographic view) mode===
This mode allows you see a 3D representation of your map while in 2D mode. This is toggled with '''[F3]'''. It can be rotated with the '''[Q]''' and '''[W]''' buttons, and the angle of viewing can be changed by pressing '''[A]''' and '''[Z]'''.
This mode is absolutely essential not only because it allows you to actually see what you're doing, but because in order to properly use TROR, you need to designate which is the 'active' layer that new sectors will connect to.

This can be done in 2 ways.

The first way is to press '''[Ctrl-A]''' which will grey out all other layers except the one the viewpoint (the arrow in 2D/side view mode)is in, which is the active layer. You can move the view point up and down, allowing you to edit above and below layers, by either pressing '''[page up]''' and '''[page down]''' respectively, or more accurately by pressing down the '''[middle mouse button]''' and moving the mouse forward or backwards. This method is usually prefered as it gives you much more control over the vertical position of the viewpoint. If you find the greyed-out walls distracting, you can remove them altogether by pressing '''[Ctrl-Alt-A]'''

The second way allows for more precision as you can narrow the active editing range to the height of a single (or set of) sectors. Firstly, select the sector(s) that you want to be able to edit with '''[Right-Alt]''', and press '''[Ctrl-R]'''. It's as easy as that. Press '''[Ctrl-R]''' without having any sectors highlighted to unlock the range again and be able to edit them normally.

===Invisible surfaces viewing mode===
This is for 3D mode when you want to toggle seeing invisible objects.
All you have to do to toggle this mode is press '''[I]''', which primarily allows you to see objects you've made invisible with '''['-I]'''. However, the reason why it's so useful here, is that it also shows you the boundaries between TROR layers (which are invisible in-game). This is a huge benefit when you want to visualize/figure out what's actually going on. It also allows you to edit the TROR surfaces and apply transparent or masked floors, and edit characteristics like the blocking and hitscan bits.

==Properties and Terminology==
TROR is created by selecting a sector and extending it (this will be covered later in method). This means that it creates a new sector directly on top of or below the selected sector, which is exactly the same size and shape as the original. The ceiling of the bottom sector is linked with the floor of the top sector. It then makes sense that the extended sector is called an '''extension'''.

You can have more than one extension on a sector. You can extend it above and below, then take the bottom and extend that down again and again, and the same with the top. You are effectively stacking sectors on top of each other, so these sectors are part of a '''stack'''. The great thing about stacks (even with only one extension) is that if you move the vertex of a wall of one layer, it will automatically move the vertices of all the other layers, so that they're easy to change the shape of without worrying about breaking the connection.

You can highlight a group of sectors and extend them all at the same time so that there can be a single extension covering them all. This is useful because it saves walls, and you can still edit all the child sectors with ease. Now, as soon as you extend these sectors so that they share an extension, they all become a part of the same '''bunch'''.

If you take a room with a child sector in the middle, and extend everything upwards except the child layer, there will now be void space in the top layer where the child sector is. If you press '''[Ctrl-S]''' there to make it into a child sector in the top layer, you'll then find that you have a floating normal (non-TROR) sector between the two TROR layers that you can do with as you please. This is called an '''island'''. I suppose it's still an island even if you don't make it a child sector in the top layer but hey, now you can create floating sectors. These can potentially be glitchy if you're not using the polymer renderer, but we'll get onto that later.

==TROR related keys==
The following are a list of keys which are related to editing TROR. They can also be found in the [http://wiki.eduke32.com/wiki/Build/Mapster32_Keyboard_Commands mapster32 keyboard commands page]

===2D mode===
'''[Ctrl-E]''' sector extension prompt (sectors to extend must be highlighted) 
'''[Ctrl-E]''' make sandwich [''if extending a sector in a direction that has already been extended, see below''] 
'''[Ctrl-E]''' punch loop through extension (loop points must be highlighted, e.g. with '''[Right Shift]'''+'''[Left Ctrl]''') 
 
'''[Ctrl-A]''' toggle auto-grayout of non-extended sectors 
'''[Ctrl-J]''' TROR-join sectors. The selection must consist of the two sets of sectors you wish to join. 
'''[Ctrl-U]''' Clear extension: delete the bunch (i.e. ceiling-floor connection) of the aimed-at sector's floor 
'''[PGUP]'''/'''[PGDN]''' Change 'player' height in discrete steps in order to go through the different levels 
'''[Ctrl-tab]''' Display one currently aimed at sector (of potentially many that lie under the mouse crosshair) 
'''[HOME]''' and '''[END]''' as modifiers to AltGr: select all sectors whose floor's/ceiling's bunchnum equal the bunchnum of the aimed at sector (useful for further operations on whole bunches)

===3D mode===
'''I''' invisibility preview: toggle fake ROR texture on non-masked portals 
'''LENTER+CTRL''' When aiming at an extended floor/ceiling, paste to all floors/ceilings of the bunch of the aimed at one 
'''T''', '''B''' and '''H''' work as with walls, though they set/toggle the bits only on '''one''' side 

===Advanced Highlighting===
Not really specific to TROR, but having greater control over which or how many sectors you can highlight makes doing extensions in TROR much easier. Make sure you're familiar with [http://wiki.eduke32.com/wiki/Level_editing#Copying_and_Pasting_Sectors advanced sector highlighting].

The information on the advanced features is outlined below:

You can highlight a second, third, and multiple sectors by holding down '''[']''' as you drag the selection box over them. This way you can highlight sectors in different parts of the map. Likewise, use the '''[;]''' key to deselect sectors. A small plus or minus will appear next to the cursor depending on which button you're holding.

You can select individual sectors with the mouse by moving the cursor inside the sector you want, holding '''[RIGHT ALT]''', and holding '''[RIGHT CTRL]''' as you release '''[RIGHT ALT]'''. The sector is now highlighted. This method of selection also works with '''[']''' and '''[;]''' to select/deselect additional sectors by mouse. Simply hold '''[RIGHT ALT]''' and the appropriate button depending on what you want to do, then hold '''[RIGHT CTRL]''' while releasing the other buttons. This becomes very quick and easy to do after doing it a few times.

==TROR Mapping Examples==

===Manhole Sewer Example===

In this straightforward example, you're going to make a manhole that goes below a street, and some area around the end of the hole at the bottom.

1. Create the child sector where you want the manhole to be.

2. Highlight the sector with '''[Right-Alt]'''.

3. Press '''[Ctrl-E]'''. Mapster will prompt you whether you want to extend up or down.

4. We want to extend down so press '''[Z]''' ('''[A]''' if you're extending up).

5. Go into side view mode with '''[F3]''', and move the viewpoint down until you're editing the bottom layer.

6. The child sector you created should now have a white boundary, with the street sectors above either greyed out or gone depending on your settings.

7. Now you can treat the manhole sector (the extension) as the very first room you've made on a new map. You can draw sectors on the side of it to attach some rooms there. If you go into 3D mode, you should be able to see that if you go down that manhole, there should now be some area at the bottom which overlaps the street. This was not previously possible without using some kind of cheap trick. Congratulations, you've just made TROR.

===Two Story Building Example===

I'm sure that a big reason that people want to use TROR is to build multiple story buildings, and this is how you do it.

1. Design the first floor of your building, both inside and out. This is going to be the first layer, which means the ceiling of every sector, especially the outdoor sectors should not be any higher than the roof of the first floor. Pretend that the second floor doesn't even exist.

2. Make your windows, doors, and anything you want.

Highlight with '''[Right-Alt]''' all of the ''outdoor'' sectors (the outdoor sectors should all have the same ceiling height, and should not be parallaxed). Knowing your advanced highlighting will come in useful here to select all the sectors.

3. Extend the highlighted area up, and make the top layer the active editing layer.

4. You should notice that the outline of your house has become completely white, and the area inside the house is empty. This is because this area is the second floor of your house.

5. Make a sector inside the house outline, this will be the room on the second floor of your house. Draw small sectors between that room and the house outline to create second floor windows. Alternatively you could just press '''[Ctrl-S]''' inside the house sector to make it a regular child sector, and if you go into 3D mode, you'll see your house has a roof you can stand on top of.

6. If you're learning TROR for the first time, it is very helpful at this point to go into 3D mode and press '''[i]''' to reveal the boundaries between layers so that you can understand what you've done.

7. You can connect the ground floor to the second floor the same way you'd connect two sector-over-sector sectors; by having a staircase or lift that connects to a different area on the top floor than it does on the bottom (because a lift for example cannot directly cross TROR layers, therefore it must be connected to sectors which do not overlap; i.e have the entrance on one side and the exit on the other.)
Or you can connect the ground floor and second floor via TROR and have some sprite stairs or something.

At this stage you should have a perfect two story house where you can look into and enter both stories. Cool stuff eh? ;)

There's nothing stopping you from going on to build a third.. forth.. fifth.. floor in the same manner either.

===TROR water example===

This is how you create transparent water using TROR. It works just like regular water, but there are a few things you need to be aware of.

1. Create a main sector, then a child sector in that and extend it downwards.
2. Make both the top and bottom of the TROR surface masked or transparent, and give it the water texture.
3. Give the floor of the top sector a lotag of 1 for water. Give the floor of the bottom sector a lotag of 2 for underwater.
4. Place an SE 7 with the same hitag in the same position in both the top and bottom sector.
5. This is the one that people normally forget. Set the TROR surface in both the top and bottom layer to BLOCKING otherwise it will not work as intended.

See, it's not too bad, just remember the lotags and the blocking. Note if you split up the water sector or add more sectors, make sure those sectors are in both the top and bottom layers, and have new SE 7s, just like normal water. In the future TROR water will be more automatic in that you won't need the SE 7, however this is incomplete as of this writing.

===Retro-fitting via Joining Example===

If you're absolutely clueless with the whole idea of extending, or you want to go back and retrofit some TROR into maps you've done in the past, there's a very easy way of joining them to form TROR.
If you have two sectors that have the same shape, area, and external vertices have the same relative positions (essentially they're the same sector, at least as far as their edges are concerned), then all you have to do is highlight both sectors with '''[Right-Alt]''', and press '''[Ctrl-J]''' to join, the same as joining two sectors normally. It will then prompt you with a few questions such as which sector you want to have on top of the other, which sector(s) you want to move (doesn't matter most of the time), and whether you'd like to move all the connected non-TROR sectors as well (definitely yes).

The good thing about this method is that besides the questions you have to answer, mapster does everything automatically, it even moves the heights for you. Now there'll be a quick example of this method below.

1. Make a child sector in a larger sector and copy-paste it into void space.

2. Give the floor of the original child sector and the ceiling of the new sector the water texture.

3. Highlight both the child sector and new sector with '''[Right-Alt]'''.

4. Press '''[Ctrl-J]''' and answer the simple questions.

5. You should end up with a TROR water sector just as you would via the extension method. You can now alter the transparency of the water to your preference.

===Sandwiching and Sector Punching===
It's possible and easy to create a new TROR layer between two TROR layers. All you have to do is highlight one of them, and extend it as you would normally, and it automatically adds a new layer in the middle.

It's also possible to easily create an island sector in the middle of a TROR sector. This is called ''sector punching'', and mainly involves stamping a child sector into the sector below or above. Follow the example below.

1. Extend a sector downwards.

2. Create a child sector in the original sector.

3. Select the vertices of the child sector with '''[Right-Shift]''' or '''[R-Ctrl + R-Shift]''' and press '''[Ctrl-E]''' as though you're extending a sector.

4. It will prompt you whether to punch up or down, in this case, choose down and hit '''[Enter]'''. A sector identical in size, shape and position should now be in the bottom layer.

5. Point the mouse cursor at the child sector in the top layer and press '''[Ctrl-U]'''. It will prompt you whether you want to break the connection, and unless you press [Ctrl-U] accidentally, you usually do.

6. The child sector should now be a floating sector island. Have fun.

Note that '''[Ctrl-U]''' only breaks the connection of a single sector if that sector has been punched. Otherwise it'll break the connection of the entire bunch, which is usually bad.

===List of TROR maps===

This (hopefully up to date) list contains maps which make heavy use of the TROR feature in order to make a huge variety of constructions. They each contain a wealth of examples for you to look at to see what's possible and how it works/how to make it. This is not a complete list, as other maps make minor or simple use of the effect and hence are not listed here.

1. The trueror.map in the Samples folder included with eduke32 contains a large amount of random examples of TROR.

2. Retaliation is a small hi-tech map by Loke that was the first proper TROR map and makes some great use of the feature. [http://www.scent-88.com/reviews/R/retaliation/retaliation.php Download here]

3. Parkade is a large city themed map containing large multiple story buildings, along with a large amount of unique, pioneering uses of the feature, made by myself (Micky C) and Paul B. It is the largest, most extensive TROR map and perhaps the best example of what TROR is capable of so far, if I do say so myself. [http://www.scent-88.com/reviews/P/parkade/parkade.php Download here]

4. Brooklyn Bridge is another city themed map which also makes extensive and interesting use of TROR, such as an alien ship that flies over water, shooting rockets, and in vents. [http://www.scent-88.com/reviews/B/brooklyn/brooklyn.php Download here]

==Tricks and Effects with TROR==

===SE 13 destructible floor/ceiling===

If you have a TROR extension in the floor, you can place an SE 13 on it (facing downwards in 2D mode, and it will become a solid floor in-game (blocked and masked). When the hitag is activated, the TROR surface will become invisible as though a hole has just formed in the floor. You can place the SE 13 on the surface, or above, in which case the floor will initially have the height of the SE 13 just like with the original effect. You can also place it near the ceiling to make the SE 13 control the ceiling instead, or have one near the ceiling and one near the floor to control both.

When placed in a TROR extension with many sectors, it will not just control the sector, but rather the entire extension. So you can add sectors and give them different textures and don't have to worry about adding extra SE 13's. If you want to have TROR surfaces have different heights with different SE 13 sprites, they need to be different extensions; i.e they need to have a sector in both the top and bottom layer, and be extended individually.

The SE 13 also works with TROR slopes, allowing you to create relatively complex destructible objects compared to sprites. But remember that TROR is pretty wall hungry, so keep an eye on complexity.
Note that regardless of whether a TROR surface is set to masked or transparent in mapster, it will always become invisible after SE 13 activation.

===TROR water height manipulation===

TROR water can also be made to move up and down using the SE 31/32, much like the raising/lowering submergible water in e1l4 Toxic Dump. The effect is the same, however it's easier with TROR, because you only have to set up the effect on one side, either in the top layer or bottom layer, because this effect is set up so that if the ceiling of the bottom sector is moved, it moves the floor of the top sector as well, and vice versa.

==Visual Glitches and Workarounds==

===Software renderer===
Even though TROR sectors are already physically overlapping, the 8-bit software renderer still needs to render them separately, having to do an extra rendering pass for each additional TROR extension in view. Theoretically if you create a huge amount of extensions in the same area the framerate could potentially drop to unplayable levels, however this is far fetched and I wouldn't worry about it.

The real problem with the software renderer is HOM glitching. In each rendering pass, there can only be one area along the x-interval drawn. For example, if you have an island on the ground, the area between you and the island will be fine, but everything on the other side of the island will show HOM. Try it out yourself to see what I mean. Technically this means that TROR extensions cannot contain islands (although it's been kind of hacked in to do exta-extra passes to overcome this problem, I wouldn't rely on them for perfect drawing.)

However, this can be overcome by breaking up the sector surrounding the child sector, and extending each sector individually. This means there will be multiple drawing portals around the island instead of one big one, and none of the individual extensions would contain the island, hence it should draw fine.

This HOM doesn't just occur due to islands, it can also happen when part of a normal sector is jutting out into a TROR sector, this can be thought of here as a mini-island even though it's connected to something. Don't call it a mini-island, I only called it that to explain why it would cause that glitching. This means that TROR extensions should be ''convex'', i.e if you draw a straight line through a TROR portal so that it leaves the sector, and then comes back, it is not convex (and is most likely due to something jutting out.) However if you draw a line through it and this does not happen, as is the case for a circle, square etc.. then it is convex, and should draw fine.

===Polymer renderer===
Masked floors and ceilings in polymer are always the last thing drawn on the screen. That means if you have a transparent surface such as a masked wall or sprite, it would cause everything all the TROR masked surfaces behind the transparent surface to stop being drawn and become invisible. There's no real work around for this, just try not to use masked walls or sprites with big transparent surfaces around TROR masked surfaces.

Other than that, polymer is by far the most stable renderer for TROR, and apart from what's written above, is 100% glitch free. Despite being slow sometimes, it is the renderer of choice for TROR. It works by drawing the entire scene, TROR and all in a single rendering pass. This means that it doesn't require any additional computer power to draw TROR, hence TROR will not affect the framerate in polymer.

===Polymost renderer===
The polymost renderer is bad, M'kay? It's like a comic relief in bad Hollywood films who can't do anything right. Don't use it. It has also been observed that some TROR constructions work perfectly on some computers, however are incredibly glitchy on others, so if you do decide to use this renderer, and TROR works for you, make sure you have two or three other people check it on their setups before you release your map. There are no plans to add complete polymost TROR compatibility as polymost will be obsolete once polymer is finished and optimised.

==Random Trivia==
Extended sectors can be sloped, but the bunch has to be 1:1 in that case. I.e you can't have any child sectors within a sloped TROR sector. If you want different TROR sectors with different slopes, you must use completely different extensions for that, as opposed to breaking up a single extension.

Maps containing one or more TROR bunches are saved in a new map format (v9) since some fields had to be taken over: xrepeat is unavailable on TROR'ed floors and ceilings, and on walls it's lotag if the ceiling, and extra if the floor of the wall's sector is extended. When in-game, these get transferred to internal arrays though.

The system is supposed to be used for 'large-scale' RoR, as a rule of thumb each affected sector should be at least a Duke high [that's too strict though].

[[Category:Level editing documentation]]

True Room Over Room Mapping Guide

2013-03-16T02:44:38Z

Micky C:

{{Build Intro}}

True Room Over Room is a feature new to EDuke32 that allows for the construction of [[sector]]s in a vertical arrangement. Other build games (Shadow Warrior, Blood, Redneck Rampage) are able to fake ROR by having sectors in different parts of the map and rendering them on top of each other, and EDuke32 has a similar feature using Sector Effectors. The difference between game ROR and TROR is that the sectors are physically on top of each other, making editing a lot easier and more automatic, while also making it easier to visualize what you're building. For the more technically minded, TROR is part of the engine and map format themselves, instead of an effect bolted on in the game code.

==TROR Editing Modes==
There are two modes you should be aware of before starting to build with TROR.

===Side view (orthographic view) mode===
This mode allows you see a 3D representation of your map while in 2D mode. This is toggled with '''[F3]'''. It can be rotated with the '''[Q]''' and '''[W]''' buttons, and the angle of viewing can be changed by pressing '''[A]''' and '''[Z]'''.
This mode is absolutely essential not only because it allows you to actually see what you're doing, but because in order to properly use TROR, you need to designate which is the 'active' layer that new sectors will connect to.

This can be done in 2 ways.

The first way is to press '''[Ctrl-A]''' which will grey out all other layers except the one the viewpoint (the arrow in 2D/side view mode)is in, which is the active layer. You can move the view point up and down, allowing you to edit above and below layers, by either pressing '''[page up]''' and '''[page down]''' respectively, or more accurately by pressing down the '''[middle mouse button]''' and moving the mouse forward or backwards. This method is usually prefered as it gives you much more control over the vertical position of the viewpoint. If you find the greyed-out walls distracting, you can remove them altogether by pressing '''[Ctrl-Alt-A]'''

The second way allows for more precision as you can narrow the active editing range to the height of a single (or set of) sectors. Firstly, select the sector(s) that you want to be able to edit with '''[Right-Alt]''', and press '''[Ctrl-R]'''. It's as easy as that. Press '''[Ctrl-R]''' without having any sectors highlighted to unlock the range again and be able to edit them normally.

===Invisible surfaces viewing mode===
This is for 3D mode when you want to toggle seeing invisible objects.
All you have to do to toggle this mode is press '''[I]''', which primarily allows you to see objects you've made invisible with '''['-I]'''. However, the reason why it's so useful here, is that it also shows you the boundaries between TROR layers (which are invisible in-game). This is a huge benefit when you want to visualize/figure out what's actually going on. It also allows you to edit the TROR surfaces and apply transparent or masked floors, and edit characteristics like the blocking and hitscan bits.

==Properties and Terminology==
TROR is created by selecting a sector and extending it (this will be covered later in method). This means that it creates a new sector directly on top of or below the selected sector, which is exactly the same size and shape as the original. The ceiling of the bottom sector is linked with the floor of the top sector. It then makes sense that the extended sector is called an '''extension'''.

You can have more than one extension on a sector. You can extend it above and below, then take the bottom and extend that down again and again, and the same with the top. You are effectively stacking sectors on top of each other, so these sectors are part of a '''stack'''. The great thing about stacks (even with only one extension) is that if you move the vertex of a wall of one layer, it will automatically move the vertices of all the other layers, so that they're easy to change the shape of without worrying about breaking the connection.

You can highlight a group of sectors and extend them all at the same time so that there can be a single extension covering them all. This is useful because it saves walls, and you can still edit all the child sectors with ease. Now, as soon as you extend these sectors so that they share an extension, they all become a part of the same '''bunch'''.

If you take a room with a child sector in the middle, and extend everything upwards except the child layer, there will now be void space in the top layer where the child sector is. If you press '''[Ctrl-S]''' there to make it into a child sector in the top layer, you'll then find that you have a floating normal (non-TROR) sector between the two TROR layers that you can do with as you please. This is called an '''island'''. I suppose it's still an island even if you don't make it a child sector in the top layer but hey, now you can create floating sectors. These can potentially be glitchy if you're not using the polymer renderer, but we'll get onto that later.

==TROR related keys==
The following are a list of keys which are related to editing TROR. They can also be found in the [http://wiki.eduke32.com/wiki/Build/Mapster32_Keyboard_Commands mapster32 keyboard commands page]

===2D mode===
'''[Ctrl-E]''' sector extension prompt (sectors to extend must be highlighted) 
'''[Ctrl-E]''' make sandwich [''if extending a sector in a direction that has already been extended, see below''] 
'''[Ctrl-E]''' punch loop through extension (loop points must be highlighted, e.g. with '''[Right Shift]'''+'''[Left Ctrl]''') 
 
'''[Ctrl-A]''' toggle auto-grayout of non-extended sectors 
'''[Ctrl-J]''' TROR-join sectors. The selection must consist of the two sets of sectors you wish to join. 
'''[Ctrl-U]''' Clear extension: delete the bunch (i.e. ceiling-floor connection) of the aimed-at sector's floor 
'''[PGUP]'''/'''[PGDN]''' Change 'player' height in discrete steps in order to go through the different levels 
'''[Ctrl-tab]''' Display one currently aimed at sector (of potentially many that lie under the mouse crosshair) 
'''[HOME]''' and '''[END]''' as modifiers to AltGr: select all sectors whose floor's/ceiling's bunchnum equal the bunchnum of the aimed at sector (useful for further operations on whole bunches)

===3D mode===
'''I''' invisibility preview: toggle fake ROR texture on non-masked portals 
'''LENTER+CTRL''' When aiming at an extended floor/ceiling, paste to all floors/ceilings of the bunch of the aimed at one 
'''T''', '''B''' and '''H''' work as with walls, though they set/toggle the bits only on '''one''' side 

===Advanced Highlighting===
Not really specific to TROR, but having greater control over which or how many sectors you can highlight makes doing extensions in TROR much easier. Make sure you're familiar with [http://wiki.eduke32.com/wiki/Level_editing#Copying_and_Pasting_Sectors advanced sector highlighting].

The information on the advanced features is outlined below:

You can highlight a second, third, and multiple sectors by holding down '''[']''' as you drag the selection box over them. This way you can highlight sectors in different parts of the map. Likewise, use the '''[;]''' key to deselect sectors. A small plus or minus will appear next to the cursor depending on which button you're holding.

You can select individual sectors with the mouse by moving the cursor inside the sector you want, holding '''[RIGHT ALT]''', and holding '''[RIGHT CTRL]''' as you release '''[RIGHT ALT]'''. The sector is now highlighted. This method of selection also works with '''[']''' and '''[;]''' to select/deselect additional sectors by mouse. Simply hold '''[RIGHT ALT]''' and the appropriate button depending on what you want to do, then hold '''[RIGHT CTRL]''' while releasing the other buttons. This becomes very quick and easy to do after doing it a few times.

==TROR Mapping Examples==

===Manhole Sewer Example===

In this straightforward example, you're going to make a manhole that goes below a street, and some area around the end of the hole at the bottom.

1. Create the child sector where you want the manhole to be.

2. Highlight the sector with '''[Right-Alt]'''.

3. Press '''[Ctrl-E]'''. Mapster will prompt you whether you want to extend up or down.

4. We want to extend down so press '''[Z]''' ('''[A]''' if you're extending up).

5. Go into side view mode with '''[F3]''', and move the viewpoint down until you're editing the bottom layer.

6. The child sector you created should now have a white boundary, with the street sectors above either greyed out or gone depending on your settings.

7. Now you can treat the manhole sector (the extension) as the very first room you've made on a new map. You can draw sectors on the side of it to attach some rooms there. If you go into 3D mode, you should be able to see that if you go down that manhole, there should now be some area at the bottom which overlaps the street. This was not previously possible without using some kind of cheap trick. Congratulations, you've just made TROR.

===Two Story Building Example===

I'm sure that a big reason that people want to use TROR is to build multiple story buildings, and this is how you do it.

1. Design the first floor of your building, both inside and out. This is going to be the first layer, which means the ceiling of every sector, especially the outdoor sectors should not be any higher than the roof of the first floor. Pretend that the second floor doesn't even exist.

2. Make your windows, doors, and anything you want.

Highlight with '''[Right-Alt]''' all of the ''outdoor'' sectors (the outdoor sectors should all have the same ceiling height, and should not be parallaxed). Knowing your advanced highlighting will come in useful here to select all the sectors.

3. Extend the highlighted area up, and make the top layer the active editing layer.

4. You should notice that the outline of your house has become completely white, and the area inside the house is empty. This is because this area is the second floor of your house.

5. Make a sector inside the house outline, this will be the room on the second floor of your house. Draw small sectors between that room and the house outline to create second floor windows. Alternatively you could just press '''[Ctrl-S]''' inside the house sector to make it a regular child sector, and if you go into 3D mode, you'll see your house has a roof you can stand on top of.

6. If you're learning TROR for the first time, it is very helpful at this point to go into 3D mode and press '''[i]''' to reveal the boundaries between layers so that you can understand what you've done.

7. You can connect the ground floor to the second floor the same way you'd connect two sector-over-sector sectors; by having a staircase or lift that connects to a different area on the top floor than it does on the bottom (because a lift for example cannot directly cross TROR layers, therefore it must be connected to sectors which do not overlap; i.e have the entrance on one side and the exit on the other.)
Or you can connect the ground floor and second floor via TROR and have some sprite stairs or something.

At this stage you should have a perfect two story house where you can look into and enter both stories. Cool stuff eh? ;)

There's nothing stopping you from going on to build a third.. forth.. fifth.. floor in the same manner either.

===Retro-fitting via Joining Example===

If you're absolutely clueless with the whole idea of extending, or you want to go back and retrofit some TROR into maps you've done in the past, there's a very easy way of joining them to form TROR.
If you have two sectors that have the same shape, area, and external vertices have the same relative positions (essentially they're the same sector, at least as far as their edges are concerned), then all you have to do is highlight both sectors with '''[Right-Alt]''', and press '''[Ctrl-J]''' to join, the same as joining two sectors normally. It will then prompt you with a few questions such as which sector you want to have on top of the other, which sector(s) you want to move (doesn't matter most of the time), and whether you'd like to move all the connected non-TROR sectors as well (definitely yes).

The good thing about this method is that besides the questions you have to answer, mapster does everything automatically, it even moves the heights for you. Now there'll be a quick example of this method below.

1. Make a child sector in a larger sector and copy-paste it into void space.

2. Give the floor of the original child sector and the ceiling of the new sector the water texture.

3. Highlight both the child sector and new sector with '''[Right-Alt]'''.

4. Press '''[Ctrl-J]''' and answer the simple questions.

5. You should end up with a TROR water sector just as you would via the extension method. You can now alter the transparency of the water to your preference.

===Sandwiching and Sector Punching===
It's possible and easy to create a new TROR layer between two TROR layers. All you have to do is highlight one of them, and extend it as you would normally, and it automatically adds a new layer in the middle.

It's also possible to easily create an island sector in the middle of a TROR sector. This is called ''sector punching'', and mainly involves stamping a child sector into the sector below or above. Follow the example below.

1. Extend a sector downwards.

2. Create a child sector in the original sector.

3. Select the vertices of the child sector with '''[Right-Shift]''' or '''[R-Ctrl + R-Shift]''' and press '''[Ctrl-E]''' as though you're extending a sector.

4. It will prompt you whether to punch up or down, in this case, choose down and hit '''[Enter]'''. A sector identical in size, shape and position should now be in the bottom layer.

5. Point the mouse cursor at the child sector in the top layer and press '''[Ctrl-U]'''. It will prompt you whether you want to break the connection, and unless you press [Ctrl-U] accidentally, you usually do.

6. The child sector should now be a floating sector island. Have fun.

Note that '''[Ctrl-U]''' only breaks the connection of a single sector if that sector has been punched. Otherwise it'll break the connection of the entire bunch, which is usually bad.

===List of TROR maps===

This (hopefully up to date) list contains maps which make heavy use of the TROR feature in order to make a huge variety of constructions. They each contain a wealth of examples for you to look at to see what's possible and how it works/how to make it. This is not a complete list, as other maps make minor or simple use of the effect and hence are not listed here.

1. The trueror.map in the Samples folder included with eduke32 contains a large amount of random examples of TROR.

2. Retaliation is a small hi-tech map by Loke that was the first proper TROR map and makes some great use of the feature. [http://www.scent-88.com/reviews/R/retaliation/retaliation.php Download here]

3. Parkade is a large city themed map containing large multiple story buildings, along with a large amount of unique, pioneering uses of the feature, made by myself (Micky C) and Paul B. It is the largest, most extensive TROR map and perhaps the best example of what TROR is capable of so far, if I do say so myself. [http://www.scent-88.com/reviews/P/parkade/parkade.php Download here]

4. Brooklyn Bridge is another city themed map which also makes extensive and interesting use of TROR, such as an alien ship that flies over water, shooting rockets, and in vents. [http://www.scent-88.com/reviews/B/brooklyn/brooklyn.php Download here]

==Tricks and Effects with TROR==

===SE 13 destructible floor/ceiling===

If you have a TROR extension in the floor, you can place an SE 13 on it (facing downwards in 2D mode, and it will become a solid floor in-game (blocked and masked). When the hitag is activated, the TROR surface will become invisible as though a hole has just formed in the floor. You can place the SE 13 on the surface, or above, in which case the floor will initially have the height of the SE 13 just like with the original effect. You can also place it near the ceiling to make the SE 13 control the ceiling instead, or have one near the ceiling and one near the floor to control both.

When placed in a TROR extension with many sectors, it will not just control the sector, but rather the entire extension. So you can add sectors and give them different textures and don't have to worry about adding extra SE 13's. If you want to have TROR surfaces have different heights with different SE 13 sprites, they need to be different extensions; i.e they need to have a sector in both the top and bottom layer, and be extended individually.

The SE 13 also works with TROR slopes, allowing you to create relatively complex destructible objects compared to sprites. But remember that TROR is pretty wall hungry, so keep an eye on complexity.
Note that regardless of whether a TROR surface is set to masked or transparent in mapster, it will always become invisible after SE 13 activation.

===TROR water height manipulation===

TROR water can also be made to move up and down using the SE 31/32, much like the raising/lowering submergible water in e1l4 Toxic Dump. The effect is the same, however it's easier with TROR, because you only have to set up the effect on one side, either in the top layer or bottom layer, because this effect is set up so that if the ceiling of the bottom sector is moved, it moves the floor of the top sector as well, and vice versa.

==Visual Glitches and Workarounds==

===Software renderer===
Even though TROR sectors are already physically overlapping, the 8-bit software renderer still needs to render them separately, having to do an extra rendering pass for each additional TROR extension in view. Theoretically if you create a huge amount of extensions in the same area the framerate could potentially drop to unplayable levels, however this is far fetched and I wouldn't worry about it.

The real problem with the software renderer is HOM glitching. In each rendering pass, there can only be one area along the x-interval drawn. For example, if you have an island on the ground, the area between you and the island will be fine, but everything on the other side of the island will show HOM. Try it out yourself to see what I mean. Technically this means that TROR extensions cannot contain islands (although it's been kind of hacked in to do exta-extra passes to overcome this problem, I wouldn't rely on them for perfect drawing.)

However, this can be overcome by breaking up the sector surrounding the child sector, and extending each sector individually. This means there will be multiple drawing portals around the island instead of one big one, and none of the individual extensions would contain the island, hence it should draw fine.

This HOM doesn't just occur due to islands, it can also happen when part of a normal sector is jutting out into a TROR sector, this can be thought of here as a mini-island even though it's connected to something. Don't call it a mini-island, I only called it that to explain why it would cause that glitching. This means that TROR extensions should be ''convex'', i.e if you draw a straight line through a TROR portal so that it leaves the sector, and then comes back, it is not convex (and is most likely due to something jutting out.) However if you draw a line through it and this does not happen, as is the case for a circle, square etc.. then it is convex, and should draw fine.

===Polymer renderer===
Masked floors and ceilings in polymer are always the last thing drawn on the screen. That means if you have a transparent surface such as a masked wall or sprite, it would cause everything all the TROR masked surfaces behind the transparent surface to stop being drawn and become invisible. There's no real work around for this, just try not to use masked walls or sprites with big transparent surfaces around TROR masked surfaces.

Other than that, polymer is by far the most stable renderer for TROR, and apart from what's written above, is 100% glitch free. Despite being slow sometimes, it is the renderer of choice for TROR. It works by drawing the entire scene, TROR and all in a single rendering pass. This means that it doesn't require any additional computer power to draw TROR, hence TROR will not affect the framerate in polymer.

===Polymost renderer===
The polymost renderer is bad, M'kay? It's like a comic relief in bad Hollywood films who can't do anything right. Don't use it. It has also been observed that some TROR constructions work perfectly on some computers, however are incredibly glitchy on others, so if you do decide to use this renderer, and TROR works for you, make sure you have two or three other people check it on their setups before you release your map. There are no plans to add complete polymost TROR compatibility as polymost will be obsolete once polymer is finished and optimised.

==Random Trivia==
Extended sectors can be sloped, but the bunch has to be 1:1 in that case. I.e you can't have any child sectors within a sloped TROR sector. If you want different TROR sectors with different slopes, you must use completely different extensions for that, as opposed to breaking up a single extension.

Maps containing one or more TROR bunches are saved in a new map format (v9) since some fields had to be taken over: xrepeat is unavailable on TROR'ed floors and ceilings, and on walls it's lotag if the ceiling, and extra if the floor of the wall's sector is extended. When in-game, these get transferred to internal arrays though.

The system is supposed to be used for 'large-scale' RoR, as a rule of thumb each affected sector should be at least a Duke high [that's too strict though].

[[Category:Level editing documentation]]

True Room Over Room Mapping Guide

2013-03-16T02:22:25Z

Micky C: /* List of TROR maps */

{{Build Intro}}

True Room Over Room is a feature new to EDuke32 that allows for the construction of [[sector]]s in a vertical arrangement. Other build games (Shadow Warrior, Blood, Redneck Rampage) are able to fake ROR by having sectors in different parts of the map and rendering them on top of each other, and EDuke32 has a similar feature using Sector Effectors. The difference between game ROR and TROR is that the sectors are physically on top of each other, making editing a lot easier and more automatic, while also making it easier to visualize what you're building. For the more technically minded, TROR is part of the engine and map format themselves, instead of an effect bolted on in the game code.

==TROR Editing Modes==
There are two modes you should be aware of before starting to build with TROR.

===Side view (orthographic view) mode===
This mode allows you see a 3D representation of your map while in 2D mode. This is toggled with '''[F3]'''. It can be rotated with the '''[Q]''' and '''[W]''' buttons, and the angle of viewing can be changed by pressing '''[A]''' and '''[Z]'''.
This mode is absolutely essential not only because it allows you to actually see what you're doing, but because in order to properly use TROR, you need to designate which is the 'active' layer that new sectors will connect to.

This can be done in 2 ways.

The first way is to press '''[Ctrl-A]''' which will grey out all other layers except the one the viewpoint (the arrow in 2D/side view mode)is in, which is the active layer. You can move the view point up and down, allowing you to edit above and below layers, by either pressing '''[page up]''' and '''[page down]''' respectively, or more accurately by pressing down the '''[middle mouse button]''' and moving the mouse forward or backwards. This method is usually prefered as it gives you much more control over the vertical position of the viewpoint. If you find the greyed-out walls distracting, you can remove them altogether by pressing '''[Ctrl-Alt-A]'''

The second way allows for more precision as you can narrow the active editing range to the height of a single (or set of) sectors. Firstly, select the sector(s) that you want to be able to edit with '''[Right-Alt]''', and press '''[Ctrl-R]'''. It's as easy as that. Press '''[Ctrl-R]''' without having any sectors highlighted to unlock the range again and be able to edit them normally.

===Invisible surfaces viewing mode===
This is for 3D mode when you want to toggle seeing invisible objects.
All you have to do to toggle this mode is press '''[I]''', which primarily allows you to see objects you've made invisible with '''['-I]'''. However, the reason why it's so useful here, is that it also shows you the boundaries between TROR layers (which are invisible in-game). This is a huge benefit when you want to visualize/figure out what's actually going on. It also allows you to edit the TROR surfaces and apply transparent or masked floors, and edit characteristics like the blocking and hitscan bits.

==Properties and Terminology==
TROR is created by selecting a sector and extending it (this will be covered later in method). This means that it creates a new sector directly on top of or below the selected sector, which is exactly the same size and shape as the original. The ceiling of the bottom sector is linked with the floor of the top sector. It then makes sense that the extended sector is called an '''extension'''.

You can have more than one extension on a sector. You can extend it above and below, then take the bottom and extend that down again and again, and the same with the top. You are effectively stacking sectors on top of each other, so these sectors are part of a '''stack'''. The great thing about stacks (even with only one extension) is that if you move the vertex of a wall of one layer, it will automatically move the vertices of all the other layers, so that they're easy to change the shape of without worrying about breaking the connection.

You can highlight a group of sectors and extend them all at the same time so that there can be a single extension covering them all. This is useful because it saves walls, and you can still edit all the child sectors with ease. Now, as soon as you extend these sectors so that they share an extension, they all become a part of the same '''bunch'''.

If you take a room with a child sector in the middle, and extend everything upwards except the child layer, there will now be void space in the top layer where the child sector is. If you press '''[Ctrl-S]''' there to make it into a child sector in the top layer, you'll then find that you have a floating normal (non-TROR) sector between the two TROR layers that you can do with as you please. This is called an '''island'''. I suppose it's still an island even if you don't make it a child sector in the top layer but hey, now you can create floating sectors. These can potentially be glitchy if you're not using the polymer renderer, but we'll get onto that later.

==TROR related keys==
The following are a list of keys which are related to editing TROR. They can also be found in the [http://wiki.eduke32.com/wiki/Build/Mapster32_Keyboard_Commands mapster32 keyboard commands page]

===2D mode===
'''[Ctrl-E]''' sector extension prompt (sectors to extend must be highlighted) 
'''[Ctrl-E]''' make sandwich [''if extending a sector in a direction that has already been extended, see below''] 
'''[Ctrl-E]''' punch loop through extension (loop points must be highlighted, e.g. with '''[Right Shift]'''+'''[Left Ctrl]''') 
 
'''[Ctrl-A]''' toggle auto-grayout of non-extended sectors 
'''[Ctrl-J]''' TROR-join sectors. The selection must consist of the two sets of sectors you wish to join. 
'''[Ctrl-U]''' Clear extension: delete the bunch (i.e. ceiling-floor connection) of the aimed-at sector's floor 
'''[PGUP]'''/'''[PGDN]''' Change 'player' height in discrete steps in order to go through the different levels 
'''[Ctrl-tab]''' Display one currently aimed at sector (of potentially many that lie under the mouse crosshair) 
'''[HOME]''' and '''[END]''' as modifiers to AltGr: select all sectors whose floor's/ceiling's bunchnum equal the bunchnum of the aimed at sector (useful for further operations on whole bunches)

===3D mode===
'''I''' invisibility preview: toggle fake ROR texture on non-masked portals 
'''LENTER+CTRL''' When aiming at an extended floor/ceiling, paste to all floors/ceilings of the bunch of the aimed at one 
'''T''', '''B''' and '''H''' work as with walls, though they set/toggle the bits only on '''one''' side 

===Advanced Highlighting===
Not really specific to TROR, but having greater control over which or how many sectors you can highlight makes doing extensions in TROR much easier. Make sure you're familiar with [http://wiki.eduke32.com/wiki/Level_editing#Copying_and_Pasting_Sectors advanced sector highlighting].

The information on the advanced features is outlined below:

You can highlight a second, third, and multiple sectors by holding down '''[']''' as you drag the selection box over them. This way you can highlight sectors in different parts of the map. Likewise, use the '''[;]''' key to deselect sectors. A small plus or minus will appear next to the cursor depending on which button you're holding.

You can select individual sectors with the mouse by moving the cursor inside the sector you want, holding '''[RIGHT ALT]''', and holding '''[RIGHT CTRL]''' as you release '''[RIGHT ALT]'''. The sector is now highlighted. This method of selection also works with '''[']''' and '''[;]''' to select/deselect additional sectors by mouse. Simply hold '''[RIGHT ALT]''' and the appropriate button depending on what you want to do, then hold '''[RIGHT CTRL]''' while releasing the other buttons. This becomes very quick and easy to do after doing it a few times.

==TROR Mapping Examples==

===Manhole Sewer Example===

In this straightforward example, you're going to make a manhole that goes below a street, and some area around the end of the hole at the bottom.

1. Create the child sector where you want the manhole to be.

2. Highlight the sector with '''[Right-Alt]'''.

3. Press '''[Ctrl-E]'''. Mapster will prompt you whether you want to extend up or down.

4. We want to extend down so press '''[Z]''' ('''[A]''' if you're extending up).

5. Go into side view mode with '''[F3]''', and move the viewpoint down until you're editing the bottom layer.

6. The child sector you created should now have a white boundary, with the street sectors above either greyed out or gone depending on your settings.

7. Now you can treat the manhole sector (the extension) as the very first room you've made on a new map. You can draw sectors on the side of it to attach some rooms there. If you go into 3D mode, you should be able to see that if you go down that manhole, there should now be some area at the bottom which overlaps the street. This was not previously possible without using some kind of cheap trick. Congratulations, you've just made TROR.

===Two Story Building Example===

I'm sure that a big reason that people want to use TROR is to build multiple story buildings, and this is how you do it.

1. Design the first floor of your building, both inside and out. This is going to be the first layer, which means the ceiling of every sector, especially the outdoor sectors should not be any higher than the roof of the first floor. Pretend that the second floor doesn't even exist.

2. Make your windows, doors, and anything you want.

Highlight with '''[Right-Alt]''' all of the ''outdoor'' sectors (the outdoor sectors should all have the same ceiling height, and should not be parallaxed). Knowing your advanced highlighting will come in useful here to select all the sectors.

3. Extend the highlighted area up, and make the top layer the active editing layer.

4. You should notice that the outline of your house has become completely white, and the area inside the house is empty. This is because this area is the second floor of your house.

5. Make a sector inside the house outline, this will be the room on the second floor of your house. Draw small sectors between that room and the house outline to create second floor windows. Alternatively you could just press '''[Ctrl-S]''' inside the house sector to make it a regular child sector, and if you go into 3D mode, you'll see your house has a roof you can stand on top of.

6. If you're learning TROR for the first time, it is very helpful at this point to go into 3D mode and press '''[i]''' to reveal the boundaries between layers so that you can understand what you've done.

7. You can connect the ground floor to the second floor the same way you'd connect two sector-over-sector sectors; by having a staircase or lift that connects to a different area on the top floor than it does on the bottom (because a lift for example cannot directly cross TROR layers, therefore it must be connected to sectors which do not overlap; i.e have the entrance on one side and the exit on the other.)
Or you can connect the ground floor and second floor via TROR and have some sprite stairs or something.

At this stage you should have a perfect two story house where you can look into and enter both stories. Cool stuff eh? ;)

There's nothing stopping you from going on to build a third.. forth.. fifth.. floor in the same manner either.

===Retro-fitting via Joining Example===

If you're absolutely clueless with the whole idea of extending, or you want to go back and retrofit some TROR into maps you've done in the past, there's a very easy way of joining them to form TROR.
If you have two sectors that have the same shape, area, and external vertices have the same relative positions (essentially they're the same sector, at least as far as their edges are concerned), then all you have to do is highlight both sectors with '''[Right-Alt]''', and press '''[Ctrl-J]''' to join, the same as joining two sectors normally. It will then prompt you with a few questions such as which sector you want to have on top of the other, which sector(s) you want to move (doesn't matter most of the time), and whether you'd like to move all the connected non-TROR sectors as well (definitely yes).

The good thing about this method is that besides the questions you have to answer, mapster does everything automatically, it even moves the heights for you. Now there'll be a quick example of this method below.

1. Make a child sector in a larger sector and copy-paste it into void space.

2. Give the floor of the original child sector and the ceiling of the new sector the water texture.

3. Highlight both the child sector and new sector with '''[Right-Alt]'''.

4. Press '''[Ctrl-J]''' and answer the simple questions.

5. You should end up with a TROR water sector just as you would via the extension method. You can now alter the transparency of the water to your preference.

===Sandwiching and Sector Punching===
It's possible and easy to create a new TROR layer between two TROR layers. All you have to do is highlight one of them, and extend it as you would normally, and it automatically adds a new layer in the middle.

It's also possible to easily create an island sector in the middle of a TROR sector. This is called ''sector punching'', and mainly involves stamping a child sector into the sector below or above. Follow the example below.

1. Extend a sector downwards.

2. Create a child sector in the original sector.

3. Select the vertices of the child sector with '''[Right-Shift]''' or '''[R-Ctrl + R-Shift]''' and press '''[Ctrl-E]''' as though you're extending a sector.

4. It will prompt you whether to punch up or down, in this case, choose down and hit '''[Enter]'''. A sector identical in size, shape and position should now be in the bottom layer.

5. Point the mouse cursor at the child sector in the top layer and press '''[Ctrl-U]'''. It will prompt you whether you want to break the connection, and unless you press [Ctrl-U] accidentally, you usually do.

6. The child sector should now be a floating sector island. Have fun.

Note that '''[Ctrl-U]''' only breaks the connection of a single sector if that sector has been punched. Otherwise it'll break the connection of the entire bunch, which is usually bad.

===List of TROR maps===

This (hopefully up to date) list contains maps which make heavy use of the TROR feature in order to make a huge variety of constructions. They each contain a wealth of examples for you to look at to see what's possible and how it works/how to make it. This is not a complete list, as other maps make minor or simple use of the effect and hence are not listed here.

1. The trueror.map in the Samples folder included with eduke32 contains a large amount of random examples of TROR.

2. Retaliation is a small hi-tech map by Loke that was the first proper TROR map and makes some great use of the feature. [http://www.scent-88.com/reviews/R/retaliation/retaliation.php Download here]

3. Parkade is a large city themed map containing large multiple story buildings, along with a large amount of unique, pioneering uses of the feature, made by myself (Micky C) and Paul B. It is the largest, most extensive TROR map and perhaps the best example of what TROR is capable of so far, if I do say so myself. [http://www.scent-88.com/reviews/P/parkade/parkade.php Download here]

4. Brooklyn Bridge is another city themed map which also makes extensive and interesting use of TROR, such as an alien ship that flies over water, shooting rockets, and in vents. [http://www.scent-88.com/reviews/B/brooklyn/brooklyn.php Download here]

==Visual Glitches and Workarounds==

===Software renderer===
Even though TROR sectors are already physically overlapping, the 8-bit software renderer still needs to render them separately, having to do an extra rendering pass for each additional TROR extension in view. Theoretically if you create a huge amount of extensions in the same area the framerate could potentially drop to unplayable levels, however this is far fetched and I wouldn't worry about it.

The real problem with the software renderer is HOM glitching. In each rendering pass, there can only be one area along the x-interval drawn. For example, if you have an island on the ground, the area between you and the island will be fine, but everything on the other side of the island will show HOM. Try it out yourself to see what I mean. Technically this means that TROR extensions cannot contain islands (although it's been kind of hacked in to do exta-extra passes to overcome this problem, I wouldn't rely on them for perfect drawing.)

However, this can be overcome by breaking up the sector surrounding the child sector, and extending each sector individually. This means there will be multiple drawing portals around the island instead of one big one, and none of the individual extensions would contain the island, hence it should draw fine.

This HOM doesn't just occur due to islands, it can also happen when part of a normal sector is jutting out into a TROR sector, this can be thought of here as a mini-island even though it's connected to something. Don't call it a mini-island, I only called it that to explain why it would cause that glitching. This means that TROR extensions should be ''convex'', i.e if you draw a straight line through a TROR portal so that it leaves the sector, and then comes back, it is not convex (and is most likely due to something jutting out.) However if you draw a line through it and this does not happen, as is the case for a circle, square etc.. then it is convex, and should draw fine.

===Polymer renderer===
Masked floors and ceilings in polymer are always the last thing drawn on the screen. That means if you have a transparent surface such as a masked wall or sprite, it would cause everything all the TROR masked surfaces behind the transparent surface to stop being drawn and become invisible. There's no real work around for this, just try not to use masked walls or sprites with big transparent surfaces around TROR masked surfaces.

Other than that, polymer is by far the most stable renderer for TROR, and apart from what's written above, is 100% glitch free. Despite being slow sometimes, it is the renderer of choice for TROR. It works by drawing the entire scene, TROR and all in a single rendering pass. This means that it doesn't require any additional computer power to draw TROR, hence TROR will not affect the framerate in polymer.

===Polymost renderer===
The polymost renderer is bad, M'kay? It's like a comic relief in bad Hollywood films who can't do anything right. Don't use it.

==Random Trivia==
Extended sectors can be sloped, but the bunch has to be 1:1 in that case. I.e you can't have any child sectors within a sloped TROR sector. If you want different TROR sectors with different slopes, you must use completely different extensions for that, as opposed to breaking up a single extension.

Maps containing one or more TROR bunches are saved in a new map format (v9) since some fields had to be taken over: xrepeat is unavailable on TROR'ed floors and ceilings, and on walls it's lotag if the ceiling, and extra if the floor of the wall's sector is extended. When in-game, these get transferred to internal arrays though.

The system is supposed to be used for 'large-scale' RoR, as a rule of thumb each affected sector should be at least a Duke high [that's too strict though].

[[Category:Level editing documentation]]

SE49

2013-01-31T23:19:21Z

Micky C:

'''SE49''' or '''Point Lights''' are used to cast a round light when the [[Polymer]] Renderer is used, it will not cast a light in other rendering modes and is unavailable in other ports. Unlike [[SE50]], this type of light does not cast shadows.

==Setup==
Mappers can create an SE49 by placing a [[SECTOREFFECTOR]] into their map and editing it's properties in 2D Mode.

{| border="1" class="wikitable"
|+ SE49 Properties
! Property
! Value
! Notes
|-
! Lotag
| 49 || Use '''ALT+T''' in 2D Mode to set the Lotag value. Set it to 49.
|-
! Hitag
| Range || Use '''ALT+H''' in 2D Mode to set the Hitag value, this will determine the range or "spherical radius" of the light (the size of the area it will light up). unlike many other SE's, the Hitag does not have to be unique.
|-
! Xvel
| Red || Use '''F8''' in 2D Mode to edit the sprite's properties.
The '''cursor''' and '''Return''' keys are used to navigate and select which property to edit in this mode, you can use the '''Esc''' key to exit this window.
XVEL, YVEL and ZVEL represent the RGB (Red, Green and Blue) color levels for the light respectively.

Set the XVEL to the desired amount of Red, the value must not be less than 0 and can be no more than 255.
|-
! Yvel
| Green || The same as above except this sets the level of Green, the value must not be less than 0 and can be no more than 255.
|-
! Zvel
| Blue || The same as above except this sets the level of Blue, the value must not be less than 0 and can be no more than 255.
|-
! Transparency
| Priority || This controls the priority of the light and can be set using the '''T''' key in 3D Mode, a solid sprite is the highest priority, a 33% transparent light is a lower priority and a 66% transparent light is an even lower priority. Changing the transparency will not affect how the light appears. Lights with a low priority tend to do these first in low framerates: stop casting shadows (SE 50), stop casting light in a sector if there are too many lights in the sector (see notes).
|-
! Center Bit
| Negative || If you press '''C''' in 3D Mode, the light will remove light instead of casting it, can be used to make very dark spots in otherwise well lit areas, and other interesting light effects.
|-
|}

You should also use '''PGUP''' and '''PGDN''' in 3D Mode to set the height of the light, leaving it too close to a floor will prevent the light from being cast very far.

==Notes==
* You can preview lights in Mapster32 by pressing ''''+X''' in 3D Mode, although you may have to use the [[console]] to enable Polymer with the command ''setrendermode 4''.
* If a lot of lights are visible at the same time, performance begins to decrease quickly, keep an eye on the framerate counter. Aim for segmented maps that consist of smaller areas separated by ceiling doors, corridors or teleporters rather than huge outdoor areas.
* Also, if too many lights are visible in one sector, some will disappear. This can usually be fixed by splitting up the sector.
* Lights will often move with sectors, but it may cause flickering with certain effects. Sectors that the lights will move horizontally with (when the floor relativity bit is set) include: two way trains, subway vehicles, SE 1&0 rotating sectors (lights can be made to move in a circular path, or can be made to spin which great for spotlights). Lights will also move up and down with elevators.
* There is currently no way to turn the lights off in the game, you could use a door to cover them up or use a mod such as [http://fissile.duke4.net/ DukePlus] or [http://forums.duke4.net/topic/6269-polymer-light-control/ CONtrol].
* It might be useful to use the Edit Colors mode in Paint to help you get a grasp on how the RGB values work. It's also useful for finding values of a specific colour you have in mind.

SE49

2013-01-31T23:16:40Z

Micky C: /* Setup */

'''SE49''' or '''Point Lights''' are used to cast a round light when the [[Polymer]] Renderer is used, it will not cast a light in other rendering modes and is unavailable in other ports. Unlike [[SE50]], this type of light does not cast shadows.

==Setup==
Mappers can create an SE49 by placing a [[SECTOREFFECTOR]] into their map and editing it's properties in 2D Mode.

{| border="1" class="wikitable"
|+ SE49 Properties
! Property
! Value
! Notes
|-
! Lotag
| 49 || Use '''ALT+T''' in 2D Mode to set the Lotag value. Set it to 49.
|-
! Hitag
| Range || Use '''ALT+H''' in 2D Mode to set the Hitag value, this will determine the range or "spherical radius" of the light (the size of the area it will light up). unlike many other SE's, the Hitag does not have to be unique.
|-
! Xvel
| Red || Use '''F8''' in 2D Mode to edit the sprite's properties.
The '''cursor''' and '''Return''' keys are used to navigate and select which property to edit in this mode, you can use the '''Esc''' key to exit this window.
XVEL, YVEL and ZVEL represent the RGB (Red, Green and Blue) color levels for the light respectively.

Set the XVEL to the desired amount of Red, the value must not be less than 0 and can be no more than 255.
|-
! Yvel
| Green || The same as above except this sets the level of Green, the value must not be less than 0 and can be no more than 255.
|-
! Zvel
| Blue || The same as above except this sets the level of Blue, the value must not be less than 0 and can be no more than 255.
|-
! Transparency
| Priority || This controls the priority of the light and can be set using the '''T''' key in 3D Mode, a solid sprite is the highest priority, a 33% transparent light is a lower priority and a 66% transparent light is an even lower priority. Changing the transparency will not affect how the light appears. Lights with a low priority tend to do these first in low framerates: stop casting shadows (SE 50), stop casting light in a sector if there are too many lights in the sector (see notes).
|-
! Center Bit
| Negative || If you press '''C''' in 3D Mode, the light will remove light instead of casting it, can be used to make very dark spots in otherwise well lit areas, and other interesting light effects.
|-
|}

You should also use '''PGUP''' and '''PGDN''' in 3D Mode to set the height of the light, leaving it too close to a floor will prevent the light from being cast very far.

==Notes==
* You can preview lights in Mapster32 by pressing ''''+X''' in 3D Mode, although you may have to use the [[console]] to enable Polymer with the command ''setrendermode 4''.
* If a lot of lights are visible at the same time, performance begins to decrease quickly, keep an eye on the framerate counter.
* Also, if too many lights are visible in one sector, some will disappear. This can usually be fixed by splitting up the sector.
* Lights will often move with sectors, but it may cause flickering with certain effects. Sectors that the lights will move horizontally with (when the floor relativity bit is set) include: two way trains, subway vehicles, SE 1&0 rotating sectors (lights can be made to move in a circular path, or can be made to spin which great for spotlights). Lights will also move up and down with elevators.
* There is currently no way to turn the lights off in the game, you could use a door to cover them up or use a mod such as [http://fissile.duke4.net/ DukePlus] or [http://forums.duke4.net/topic/6269-polymer-light-control/ CONtrol].
* It might be useful to use the Edit Colors mode in Paint to help you get a grasp on how the RGB values work. It's also useful for finding values of a specific colour you have in mind.

SE49

2013-01-31T23:15:59Z

Micky C:

'''SE49''' or '''Point Lights''' are used to cast a round light when the [[Polymer]] Renderer is used, it will not cast a light in other rendering modes and is unavailable in other ports. Unlike [[SE50]], this type of light does not cast shadows.

==Setup==
Mappers can create an SE49 by placing a [[SECTOREFFECTOR]] into their map and editing it's properties in 2D Mode.

{| border="1" class="wikitable"
|+ SE49 Properties
! Property
! Value
! Notes
|-
! Lotag
| 49 || Use '''ALT+T''' in 2D Mode to set the Lotag value. Set it to 49.
|-
! Hitag
| Range || Use '''ALT+H''' in 2D Mode to set the Hitag value, this will determine the range or "spherical radius" of the light (the size of the area it will light up). unlike many other SE's, the Hitag does not have to be unique.
|-
! Xvel
| Red || Use '''F8''' in 2D Mode to edit the sprite's properties.
The '''cursor''' and '''Return''' keys are used to navigate and select which property to edit in this mode, you can use the '''Esc''' key to exit this window.
XVEL, YVEL and ZVEL represent the RGB (Red, Green and Blue) color levels for the light respectively.

Set the XVEL to the desired amount of Red, the value must not be less than 0 and can be no more than 255.
|-
! Yvel
| Green || The same as above except this sets the level of Green, the value must not be less than 0 and can be no more than 255.
|-
! Zvel
| Blue || The same as above except this sets the level of Blue, the value must not be less than 0 and can be no more than 255.
|-
! Transparency
| Priority || This controls the priority of the light and can be set using the '''T''' key in 3D Mode, a solid sprite is the highest priority, a 33% transparent light is a lower priority and a 66% transparent light is an even lower priority. Changing the transparency will not affect how the light appears. Lights with a low priority tend to do these first in low framerates: stop casting shadows, stop casting light in a sector if there are too many lights in the sector (see notes).
|-
! Center Bit
| Negative || If you press '''C''' in 3D Mode, the light will remove light instead of casting it, can be used to make very dark spots in otherwise well lit areas, and other interesting light effects.
|-
|}

You should also use '''PGUP''' and '''PGDN''' in 3D Mode to set the height of the light, leaving it too close to a floor will prevent the light from being cast very far.

==Notes==
* You can preview lights in Mapster32 by pressing ''''+X''' in 3D Mode, although you may have to use the [[console]] to enable Polymer with the command ''setrendermode 4''.
* If a lot of lights are visible at the same time, performance begins to decrease quickly, keep an eye on the framerate counter.
* Also, if too many lights are visible in one sector, some will disappear. This can usually be fixed by splitting up the sector.
* Lights will often move with sectors, but it may cause flickering with certain effects. Sectors that the lights will move horizontally with (when the floor relativity bit is set) include: two way trains, subway vehicles, SE 1&0 rotating sectors (lights can be made to move in a circular path, or can be made to spin which great for spotlights). Lights will also move up and down with elevators.
* There is currently no way to turn the lights off in the game, you could use a door to cover them up or use a mod such as [http://fissile.duke4.net/ DukePlus] or [http://forums.duke4.net/topic/6269-polymer-light-control/ CONtrol].
* It might be useful to use the Edit Colors mode in Paint to help you get a grasp on how the RGB values work. It's also useful for finding values of a specific colour you have in mind.

SE49

2013-01-31T23:06:20Z

Micky C: /* Setup */

'''SE49''' or '''Point Lights''' are used to cast a round light when the [[Polymer]] Renderer is used, it will not cast a light in other rendering modes and is unavailable in other ports. Unlike [[SE50]], this type of light does not cast shadows.

==Setup==
Mappers can create an SE49 by placing a [[SECTOREFFECTOR]] into their map and editing it's properties in 2D Mode.

{| border="1" class="wikitable"
|+ SE49 Properties
! Property
! Value
! Notes
|-
! Lotag
| 49 || Use '''ALT+T''' in 2D Mode to set the Lotag value. Set it to 49.
|-
! Hitag
| Range || Use '''ALT+H''' in 2D Mode to set the Hitag value, this will determine the range of the light (the size of the area it will light up). unlike many other SE's, the Hitag does not have to be unique.
|-
! Xvel
| Red || Use '''F8''' in 2D Mode to edit the sprite's properties.
The '''cursor''' and '''Return''' keys are used to navigate and select which property to edit in this mode, you can use the '''Esc''' key to exit this window.
XVEL, YVEL and ZVEL represent the RGB (Red, Green and Blue) color levels for the light respectively.

Set the XVEL to the desired amount of Red, the value must not be less than 0 and can be no more than 255.
|-
! Yvel
| Green || The same as above except this sets the level of Green, the value must not be less than 0 and can be no more than 255.
|-
! Zvel
| Blue || The same as above except this sets the level of Blue, the value must not be less than 0 and can be no more than 255.
|-
! Transparency
| Priority || This controls the priority of the light and can be set using the '''T''' key in 3D Mode, a solid sprite is the highest priority, a 33% transparent light is a lower priority and a 66% transparent light is an even lower priority. Changing the transparency will not affect how the light appears.
|-
! Center Bit
| Negative || If you press '''C''' in 3D Mode, the light will remove light instead of casting it, can be used to make very dark spots in otherwise well lit areas.
|-
|}

You should also use '''PGUP''' and '''PGDN''' in 3D Mode to set the height of the light, leaving it too close to a floor will prevent the light from being cast very far.

==Notes==
* You can preview lights in Mapster32 by pressing ''''+X''' in 3D Mode, although you may have to use the [[console]] to enable Polymer with the command ''setrendermode 4''.
* If a lot of lights are visible at the same time, performance begins to decrease quickly, keep an eye on the framerate counter.
* Also, if too many lights are visible, some will disappear.
* Lights will often move with sectors, but it may cause flickering with certain effects.
* There is currently no way to turn the lights off in the game, you could use a door to cover them up or use a mod such as [http://fissile.duke4.net/ DukePlus] or [http://forums.duke4.net/topic/6269-polymer-light-control/ CONtrol].
* It might be useful to use the Edit Colors mode in Paint to help you get a grasp on how the RGB values work.

Sector Effector Reference Guide

2013-01-02T00:38:15Z

Micky C: /* Sector Effector Lotag Listing */

{{Build Intro}}

==Sector Effector Lotag Listing==
{| class="wikitable"
! bgcolor="#c0c0c0" | '''Tag number'''
! bgcolor="#c0c0c0" | '''Name'''
! bgcolor="#c0c0c0" | '''Associated sector tag'''

! bgcolor="#c0c0c0" | '''Description'''
|-
|'''0'''
|Rotating Sector
|30 (optional)
|See [[:Category:Editing Moving Sectors#Rotating Sectors (Gears)]]. The hitag of this sectoreffector must be something other than zero because a sectoreffector with both tags equal to zero causes an error.
|-
|'''1'''
| Pivot Sprite for SE 0
| 30 (optional)
|See [[:Category:Editing Moving Sectors#Rotating Sectors (Gears)]].
|-
|'''2'''
|Earthquake
|N/A
|See [[:Category:Editing General Sector Effects#Earthquake]].
|-
|'''3'''
|Random Lights After Shot Out
|N/A
|See [[:Category:Editing Lighting Effects#Making Lights Blink When Shot]]
|-
|'''4'''
|Random Lights
|N/A
|See [[:Category:Editing Lighting Effects#Making Lights Blink]].
|-
|bgcolor="#ffb099"|'''5'''
|bgcolor="#ffb099"|(undocumented)
|bgcolor="#ffb099"|N/A
|bgcolor="#ffb099"|When used with a series of sequentially numbered [[Level_editing#Locator|locator]]s, this causes the sector to move rapidly to the locator nearest the player. It also spawns some fireballs in a way they won't hit the player. It was intended to be a boss ship in Lameduke but it got eventually scratched. The effect is very buggy. There are graphics glitches, and the moving sector eventually seems to just go around in circles.
|-
|'''6'''
|Subway
|N/A
|See [[:Category:Editing Moving Sectors#One Car Subways]].
|-
|'''7'''
|Teleporter
|N/A
|See [[:Category:Editing Teleporters]]
|-
|'''8'''
| Up Open Door Lights
|20, 21, 22, 23, 25 or 26
|See [[:Category:Editing Lighting_Effects#Open Door & Room Lights Up]]
|-
|'''9'''
|Down Open Door Lights
|20, 21, 22, 23, 25 or 26
|See [[:Category:Editing Lighting_Effects#Open Door & Room Lights Up]]
|-
|'''10'''
|Door Auto Close
|20, 21, 22, 23, 25 or 26
|Hitag = delay
|-
|'''11'''
|Rotate Sector Door
|23
|Hinge for the swinging door. See [[Swinging Doors]].
|-
|'''12'''
| Light Switch
|N/A
|See [[:Category:Editing Lighting Effects#Light Switches]].
|-
|'''13'''
| C-9 Explosive
| N/A
| See [[:Category:Editing C-9 Effects#Cracked Walls]].
|-
|'''14'''
|Subway Car
|N/A
|See [[:Category:Editing Moving Sectors#Making Multi-Car Subways]].
|-
|'''15'''
|Slide Door
|25
|See [[Sliding Doors]].
|-
|bgcolor="#ffb099"|'''16'''
|bgcolor="#ffb099"|Rotate Reactor Sector
|bgcolor="#ffb099"|N/A
|bgcolor="#ffb099"|All this does is rotate the sector a small amount and raise the ceiling by about a quarter of a step at runtime. It is an incomplete effect that is not used in the game.
|-
|'''17'''
|Elevator Transport
|15
|See [[:Category:Editing Sectors That Rise and Fall#Elevator Transports]].
|-
|'''18'''
|Incremental Sector Rise/Fall
|N/A
|Causes the sector to be raised or lowered by one step every time it is activated. Only works in version 1.4 or above. See [[:Category:Editing Sectors That Rise and Fall]].
|-
|'''19'''
|Explosion Lowers Ceiling
|N/A
|If an explosion occurs in a sector containing this SE, the ceiling drops to the floor. This effect is not used in the game but is fully functional. The rate the ceiling falls can be controlled with a [[Level_editing#GPSPEED|GPSPEED]]. [[See [[:Category:Editing Sectors That Rise and Fall#Making the Ceiling Fall Upon an Explosion]].
|-
|'''20'''
|Stretch (also known as "Bridge")
|27
||See [[:Category:Editing General Sector Effects#Stretching Sectors]].
|-
|'''21'''
|Drop Floor
|28
|See [[:Category:Editing Sectors That Rise and Fall]].
|-
|'''22'''
|Teeth Door Prong
|29
|See [[Teeth Doors]]
|-
|'''23'''
|One-Way Teleporter Destination
|N/A
|See [[:Category:Editing Teleporters#One Way Teleporters (Version 1.4 or 1.5 Required)]].
|-
|'''24'''
|Conveyor Belt or Water Current
|N/A
||See [[:Category:Editing General Sector Effects#Conveyor Belts & Water Current]].
|-
|'''25'''
|Engine
|N/A
|Ceiling continually lowers to the floor and raises again. Its speed can be regulated with a [[Level_editing#GPSPEED|GPSPEED]].
|-
|bgcolor="#ffb099"|'''26'''
|bgcolor="#ffb099"|(undocumented)
|bgcolor="#ffb099"|N/A
|bgcolor="#ffb099"|A rudimentary and incomplete implementation of a step escalator. The effect repeatedly raises the sector by two clicks and moves it one grid size 3 square in the direction of the SE's angle, and then snaps back instantly. It carries sprites along with it. The effect is incomplete, so there are graphics glitches like stretching textures, and it can kill Duke by carrying him into non-player space. Use with caution.
|-
|'''27'''
|Demo Camera
|N/A
|Used to record demos.
|-
|'''28'''
| Lightning
|N/A
|Version 1.4 or above
|-
|'''29'''
|Float
|N/A
|See [[:Category:Editing Water#Making Waves]].
|-
|'''30'''
|Two-Way Train
|31
|See [[:Category:Editing Moving Sectors#Two-Way Trains]].
|-
|'''31'''
|Floor Rise/Fall
|N/A
|See [[:Category:Editing Sectors That Rise and Fall]].
|-
|'''32'''
|Ceiling Rise/Fall
|N/A
|See [[:Category:Editing Sectors That Rise and Fall]].
|-
|'''33'''
|Earthquake Debris
|N/A
|Use in conjunction with an earthquake (SE 2) to spawn bits of scrap. See [[:Category:Editing General Sector Effects#Earthquake]]. It is also used in the exploding ceiling effect (see [[:Category:Editing C-9 Effects#Making the Ceiling Blow Up (And Enemies Fall From the Sky!)]]).
|-
|bgcolor="#ffb099"|'''34'''
|bgcolor="#ffb099"|(undocumented)
|bgcolor="#ffb099"|N/A
|bgcolor="#ffb099"|A conveyor belt effect very similar to SE 24. It moves at about half the speed, and the floor texture moves at right angles to the direction of motion.
|-
|bgcolor="#ffb099"|'''35'''
|bgcolor="#ffb099"|(undocumented)
|bgcolor="#ffb099"|N/A
|bgcolor="#ffb099"|An unfinished implementation of a drill head. The floor is lowered at runtime, and then the ceiling lowers to the floor repeatedly. Silent, harmless explosions and bits of scrap are continually spawned in the sector. Can be combined with rotating sectors (SE 0,1) to simulate a drill, but is pretty much useless.
|-
|'''36'''
|Projectile Shooter
|N/A
|See [[:Category:Editing Miscellaneous#Shooters]]
|-
|bgcolor="#99ff99"|'''49'''
|bgcolor="#99ff99"|Point Light
|bgcolor="#99ff99"|N/A
|bgcolor="#99ff99"|Casts uniform light in all directions as name suggests. Does not cast shadows. HITAG = light distance (range: 0-65535)
XVEL/YVEL/ZVEL = RGB values (range: 0-255) (edit with F8 when SE highlighted in 2D mode.)
TRANSPARENCY = priority (solid sprite = high priority, 33% transparency = lower priority, 66% = lowest priority. This is required to avoid glitches resulting from projectile lights interacting with world lights.)
Centre bit (press c on SE in 3D mode): Inverts colours so it subtracts light to the scene instead of adding it. E.g use a pure white light to make the SE emit pure black.
|-
|bgcolor="#99ff99"|'''50'''
|bgcolor="#99ff99"|Spotlight
|bgcolor="#99ff99"|N/A
|bgcolor="#99ff99"|Casts light in one direction as name suggests. Casts shadows. HITAG = light distance (range: 0-65535)
XVEL/YVEL/ZVEL = RGB values (range: 0-255) (edit with F8 when SE highlighted in 2D mode.)
Angle of SE = direction light points in.
Shade = width of light (range: -127 to 127)
Extra = horizontal up/down angle. Light points roughly 45 degrees down by default. An extra of 100 points straight ahead. Positive values angle light up, negative values angle light downn.
Owner = picnum of sprite/texture to project.
TRANSPARENCY = priority (solid sprite = high priority, 33% transparency = lower priority, 66% = lowest priority. This is required to avoid glitches resulting from projectile lights interacting with world lights.)
1-Way (press 1 on SE to make 1-sided) = Does not project shadow maps. Spotlights without shadows are much better for performance, and useful for projecting textures.
Centre bit (press c on SE in 3D mode): Inverts colours so it subtracts light to the scene instead of adding it. E.g use a pure white light to make the SE emit pure black.
|}

[[Category:Level editing documentation]]

True Room Over Room Mapping Guide

2012-04-20T06:15:03Z

Micky C: /* TROR Mapping Examples */

{{Build Intro}}

True Room Over Room is a feature new to EDuke32 that allows for the construction of [[sector]]s in a vertical arrangement. Other build games (Shadow Warrior, Blood, Redneck Rampage) are able to fake ROR by having sectors in different parts of the map and rendering them on top of each other, and EDuke32 has a similar feature using Sector Effectors. The difference between game ROR and TROR is that the sectors are physically on top of each other, making editing a lot easier and more automatic, while also making it easier to visualize what you're building. For the more technically minded, TROR is part of the engine and map format themselves, instead of an effect bolted on in the game code.

==TROR Editing Modes==
There are two modes you should be aware of before starting to build with TROR.

===Side view (orthographic view) mode===
This mode allows you see a 3D representation of your map while in 2D mode. This is toggled with '''[F3]'''. It can be rotated with the '''[Q]''' and '''[W]''' buttons, and the angle of viewing can be changed by pressing '''[A]''' and '''[Z]'''.
This mode is absolutely essential not only because it allows you to actually see what you're doing, but because in order to properly use TROR, you need to designate which is the 'active' layer that new sectors will connect to.

This can be done in 2 ways.

The first way is to press '''[Ctrl-A]''' which will grey out all other layers except the one the viewpoint (the arrow in 2D/side view mode)is in, which is the active layer. You can move the view point up and down, allowing you to edit above and below layers, by either pressing '''[page up]''' and '''[page down]''' respectively, or more accurately by pressing down the '''[middle mouse button]''' and moving the mouse forward or backwards. This method is usually prefered as it gives you much more control over the vertical position of the viewpoint. If you find the greyed-out walls distracting, you can remove them altogether by pressing '''[Ctrl-Alt-A]'''

The second way allows for more precision as you can narrow the active editing range to the height of a single (or set of) sectors. Firstly, select the sector(s) that you want to be able to edit with '''[Right-Alt]''', and press '''[Ctrl-R]'''. It's as easy as that. Press '''[Ctrl-R]''' without having any sectors highlighted to unlock the range again and be able to edit them normally.

===Invisible surfaces viewing mode===
This is for 3D mode when you want to toggle seeing invisible objects.
All you have to do to toggle this mode is press '''[I]''', which primarily allows you to see objects you've made invisible with '''['-I]'''. However, the reason why it's so useful here, is that it also shows you the boundaries between TROR layers (which are invisible in-game). This is a huge benefit when you want to visualize/figure out what's actually going on. It also allows you to edit the TROR surfaces and apply transparent or masked floors, and edit characteristics like the blocking and hitscan bits.

==Properties and Terminology==
TROR is created by selecting a sector and extending it (this will be covered later in method). This means that it creates a new sector directly on top of or below the selected sector, which is exactly the same size and shape as the original. The ceiling of the bottom sector is linked with the floor of the top sector. It then makes sense that the extended sector is called an '''extension'''.

You can have more than one extension on a sector. You can extend it above and below, then take the bottom and extend that down again and again, and the same with the top. You are effectively stacking sectors on top of each other, so these sectors are part of a '''stack'''. The great thing about stacks (even with only one extension) is that if you move the vertex of a wall of one layer, it will automatically move the vertices of all the other layers, so that they're easy to change the shape of without worrying about breaking the connection.

You can highlight a group of sectors and extend them all at the same time so that there can be a single extension covering them all. This is useful because it saves walls, and you can still edit all the child sectors with ease. Now, as soon as you extend these sectors so that they share an extension, they all become a part of the same '''bunch'''.

If you take a room with a child sector in the middle, and extend everything upwards except the child layer, there will now be void space in the top layer where the child sector is. If you press '''[Ctrl-S]''' there to make it into a child sector in the top layer, you'll then find that you have a floating normal (non-TROR) sector between the two TROR layers that you can do with as you please. This is called an '''island'''. I suppose it's still an island even if you don't make it a child sector in the top layer but hey, now you can create floating sectors. These can potentially be glitchy if you're not using the polymer renderer, but we'll get onto that later.

==TROR related keys==
The following are a list of keys which are related to editing TROR. They can also be found in the [http://wiki.eduke32.com/wiki/Build/Mapster32_Keyboard_Commands mapster32 keyboard commands page]

===2D mode===
'''[Ctrl-E]''' sector extension prompt (sectors to extend must be highlighted) 
'''[Ctrl-E]''' make sandwich [''if extending a sector in a direction that has already been extended, see below''] 
'''[Ctrl-E]''' punch loop through extension (loop points must be highlighted, e.g. with '''[Right Shift]'''+'''[Left Ctrl]''') 
 
'''[Ctrl-A]''' toggle auto-grayout of non-extended sectors 
'''[Ctrl-J]''' TROR-join sectors. The selection must consist of the two sets of sectors you wish to join. 
'''[Ctrl-U]''' Clear extension: delete the bunch (i.e. ceiling-floor connection) of the aimed-at sector's floor 
'''[PGUP]'''/'''[PGDN]''' Change 'player' height in discrete steps in order to go through the different levels 
'''[Ctrl-tab]''' Display one currently aimed at sector (of potentially many that lie under the mouse crosshair) 
'''[HOME]''' and '''[END]''' as modifiers to AltGr: select all sectors whose floor's/ceiling's bunchnum equal the bunchnum of the aimed at sector (useful for further operations on whole bunches)

===3D mode===
'''I''' invisibility preview: toggle fake ROR texture on non-masked portals 
'''LENTER+CTRL''' When aiming at an extended floor/ceiling, paste to all floors/ceilings of the bunch of the aimed at one 
'''T''', '''B''' and '''H''' work as with walls, though they set/toggle the bits only on '''one''' side 

===Advanced Highlighting===
Not really specific to TROR, but having greater control over which or how many sectors you can highlight makes doing extensions in TROR much easier. Make sure you're familiar with [http://wiki.eduke32.com/wiki/Level_editing#Copying_and_Pasting_Sectors advanced sector highlighting].

The information on the advanced features is outlined below:

You can highlight a second, third, and multiple sectors by holding down '''[']''' as you drag the selection box over them. This way you can highlight sectors in different parts of the map. Likewise, use the '''[;]''' key to deselect sectors. A small plus or minus will appear next to the cursor depending on which button you're holding.

You can select individual sectors with the mouse by moving the cursor inside the sector you want, holding '''[RIGHT ALT]''', and holding '''[RIGHT CTRL]''' as you release '''[RIGHT ALT]'''. The sector is now highlighted. This method of selection also works with '''[']''' and '''[;]''' to select/deselect additional sectors by mouse. Simply hold '''[RIGHT ALT]''' and the appropriate button depending on what you want to do, then hold '''[RIGHT CTRL]''' while releasing the other buttons. This becomes very quick and easy to do after doing it a few times.

==TROR Mapping Examples==

===Manhole Sewer Example===

In this straightforward example, you're going to make a manhole that goes below a street, and some area around the end of the hole at the bottom.

1. Create the child sector where you want the manhole to be.

2. Highlight the sector with '''[Right-Alt]'''.

3. Press '''[Ctrl-E]'''. Mapster will prompt you whether you want to extend up or down.

4. We want to extend down so press '''[Z]''' ('''[A]''' if you're extending up).

5. Go into side view mode with '''[F3]''', and move the viewpoint down until you're editing the bottom layer.

6. The child sector you created should now have a white boundary, with the street sectors above either greyed out or gone depending on your settings.

7. Now you can treat the manhole sector (the extension) as the very first room you've made on a new map. You can draw sectors on the side of it to attach some rooms there. If you go into 3D mode, you should be able to see that if you go down that manhole, there should now be some area at the bottom which overlaps the street. This was not previously possible without using some kind of cheap trick. Congratulations, you've just made TROR.

===Two Story Building Example===

I'm sure that a big reason that people want to use TROR is to build multiple story buildings, and this is how you do it.

1. Design the first floor of your building, both inside and out. This is going to be the first layer, which means the ceiling of every sector, especially the outdoor sectors should not be any higher than the roof of the first floor. Pretend that the second floor doesn't even exist.

2. Make your windows, doors, and anything you want.

Highlight with '''[Right-Alt]''' all of the ''outdoor'' sectors (the outdoor sectors should all have the same ceiling height, and should not be parallaxed). Knowing your advanced highlighting will come in useful here to select all the sectors.

3. Extend the highlighted area up, and make the top layer the active editing layer.

4. You should notice that the outline of your house has become completely white, and the area inside the house is empty. This is because this area is the second floor of your house.

5. Make a sector inside the house outline, this will be the room on the second floor of your house. Draw small sectors between that room and the house outline to create second floor windows. Alternatively you could just press '''[Ctrl-S]''' inside the house sector to make it a regular child sector, and if you go into 3D mode, you'll see your house has a roof you can stand on top of.

6. If you're learning TROR for the first time, it is very helpful at this point to go into 3D mode and press '''[i]''' to reveal the boundaries between layers so that you can understand what you've done.

7. You can connect the ground floor to the second floor the same way you'd connect two sector-over-sector sectors; by having a staircase or lift that connects to a different area on the top floor than it does on the bottom (because a lift for example cannot directly cross TROR layers, therefore it must be connected to sectors which do not overlap; i.e have the entrance on one side and the exit on the other.)
Or you can connect the ground floor and second floor via TROR and have some sprite stairs or something.

At this stage you should have a perfect two story house where you can look into and enter both stories. Cool stuff eh? ;)

There's nothing stopping you from going on to build a third.. forth.. fifth.. floor in the same manner either.

===Retro-fitting via Joining Example===

If you're absolutely clueless with the whole idea of extending, or you want to go back and retrofit some TROR into maps you've done in the past, there's a very easy way of joining them to form TROR.
If you have two sectors that have the same shape, area, and external vertices have the same relative positions (essentially they're the same sector, at least as far as their edges are concerned), then all you have to do is highlight both sectors with '''[Right-Alt]''', and press '''[Ctrl-J]''' to join, the same as joining two sectors normally. It will then prompt you with a few questions such as which sector you want to have on top of the other, which sector(s) you want to move (doesn't matter most of the time), and whether you'd like to move all the connected non-TROR sectors as well (definitely yes).

The good thing about this method is that besides the questions you have to answer, mapster does everything automatically, it even moves the heights for you. Now there'll be a quick example of this method below.

1. Make a child sector in a larger sector and copy-paste it into void space.

2. Give the floor of the original child sector and the ceiling of the new sector the water texture.

3. Highlight both the child sector and new sector with '''[Right-Alt]'''.

4. Press '''[Ctrl-J]''' and answer the simple questions.

5. You should end up with a TROR water sector just as you would via the extension method. You can now alter the transparency of the water to your preference.

===Sandwiching and Sector Punching===
It's possible and easy to create a new TROR layer between two TROR layers. All you have to do is highlight one of them, and extend it as you would normally, and it automatically adds a new layer in the middle.

It's also possible to easily create an island sector in the middle of a TROR sector. This is called ''sector punching'', and mainly involves stamping a child sector into the sector below or above. Follow the example below.

1. Extend a sector downwards.

2. Create a child sector in the original sector.

3. Select the vertices of the child sector with '''[Right-Shift]''' or '''[R-Ctrl + R-Shift]''' and press '''[Ctrl-E]''' as though you're extending a sector.

4. It will prompt you whether to punch up or down, in this case, choose down and hit '''[Enter]'''. A sector identical in size, shape and position should now be in the bottom layer.

5. Point the mouse cursor at the child sector in the top layer and press '''[Ctrl-U]'''. It will prompt you whether you want to break the connection, and unless you press [Ctrl-U] accidentally, you usually do.

6. The child sector should now be a floating sector island. Have fun.

Note that '''[Ctrl-U]''' only breaks the connection of a single sector if that sector has been punched. Otherwise it'll break the connection of the entire bunch, which is usually bad.

===List of TROR maps===

This (hopefully up to date) list contains maps which make heavy use of the TROR feature in order to make a huge variety of constructions. They each contain a wealth of examples for you to look at to see what's possible and how it works/how to make it.

1. The trueror.map in the Samples folder included with eduke32 contains a large amount of random examples of TROR.

2. Retaliation is a small hi-tech map by Loke that was the first proper TROR map and makes some great use of the feature. [http://www.scent-88.com/reviews/R/retaliation/retaliation.php Download here]

3. Parkade is a large city themed map containing large multiple story buildings, along with a large amount of unique, pioneering uses of the feature, made by myself (Micky C) and Paul B. It is the largest, most extensive TROR map and perhaps the best example of what TROR is capable of so far, if I do say so myself. [http://www.scent-88.com/reviews/P/parkade/parkade.php Download here]

==Visual Glitches and Workarounds==

===Software renderer===
Even though TROR sectors are already physically overlapping, the 8-bit software renderer still needs to render them separately, having to do an extra rendering pass for each additional TROR extension in view. Theoretically if you create a huge amount of extensions in the same area the framerate could potentially drop to unplayable levels, however this is far fetched and I wouldn't worry about it.

The real problem with the software renderer is HOM glitching. In each rendering pass, there can only be one area along the x-interval drawn. For example, if you have an island on the ground, the area between you and the island will be fine, but everything on the other side of the island will show HOM. Try it out yourself to see what I mean. Technically this means that TROR extensions cannot contain islands (although it's been kind of hacked in to do exta-extra passes to overcome this problem, I wouldn't rely on them for perfect drawing.)

However, this can be overcome by breaking up the sector surrounding the child sector, and extending each sector individually. This means there will be multiple drawing portals around the island instead of one big one, and none of the individual extensions would contain the island, hence it should draw fine.

This HOM doesn't just occur due to islands, it can also happen when part of a normal sector is jutting out into a TROR sector, this can be thought of here as a mini-island even though it's connected to something. Don't call it a mini-island, I only called it that to explain why it would cause that glitching. This means that TROR extensions should be ''convex'', i.e if you draw a straight line through a TROR portal so that it leaves the sector, and then comes back, it is not convex (and is most likely due to something jutting out.) However if you draw a line through it and this does not happen, as is the case for a circle, square etc.. then it is convex, and should draw fine.

===Polymer renderer===
Masked floors and ceilings in polymer are always the last thing drawn on the screen. That means if you have a transparent surface such as a masked wall or sprite, it would cause everything all the TROR masked surfaces behind the transparent surface to stop being drawn and become invisible. There's no real work around for this, just try not to use masked walls or sprites with big transparent surfaces around TROR masked surfaces.

Other than that, polymer is by far the most stable renderer for TROR, and apart from what's written above, is 100% glitch free. Despite being slow sometimes, it is the renderer of choice for TROR. It works by drawing the entire scene, TROR and all in a single rendering pass. This means that it doesn't require any additional computer power to draw TROR, hence TROR will not affect the framerate in polymer.

===Polymost renderer===
The polymost renderer is bad, M'kay? It's like a comic relief in bad Hollywood films who can't do anything right. Don't use it.

==Random Trivia==
Extended sectors can be sloped, but the bunch has to be 1:1 in that case. I.e you can't have any child sectors within a sloped TROR sector. If you want different TROR sectors with different slopes, you must use completely different extensions for that, as opposed to breaking up a single extension.

Maps containing one or more TROR bunches are saved in a new map format (v9) since some fields had to be taken over: xrepeat is unavailable on TROR'ed floors and ceilings, and on walls it's lotag if the ceiling, and extra if the floor of the wall's sector is extended. When in-game, these get transferred to internal arrays though.

The system is supposed to be used for 'large-scale' RoR, as a rule of thumb each affected sector should be at least a Duke high [that's too strict though].

[[Category:Level editing documentation]]

True Room Over Room Mapping Guide

2012-04-20T06:14:43Z

Micky C: /* TROR Mapping Examples */

{{Build Intro}}

True Room Over Room is a feature new to EDuke32 that allows for the construction of [[sector]]s in a vertical arrangement. Other build games (Shadow Warrior, Blood, Redneck Rampage) are able to fake ROR by having sectors in different parts of the map and rendering them on top of each other, and EDuke32 has a similar feature using Sector Effectors. The difference between game ROR and TROR is that the sectors are physically on top of each other, making editing a lot easier and more automatic, while also making it easier to visualize what you're building. For the more technically minded, TROR is part of the engine and map format themselves, instead of an effect bolted on in the game code.

==TROR Editing Modes==
There are two modes you should be aware of before starting to build with TROR.

===Side view (orthographic view) mode===
This mode allows you see a 3D representation of your map while in 2D mode. This is toggled with '''[F3]'''. It can be rotated with the '''[Q]''' and '''[W]''' buttons, and the angle of viewing can be changed by pressing '''[A]''' and '''[Z]'''.
This mode is absolutely essential not only because it allows you to actually see what you're doing, but because in order to properly use TROR, you need to designate which is the 'active' layer that new sectors will connect to.

This can be done in 2 ways.

The first way is to press '''[Ctrl-A]''' which will grey out all other layers except the one the viewpoint (the arrow in 2D/side view mode)is in, which is the active layer. You can move the view point up and down, allowing you to edit above and below layers, by either pressing '''[page up]''' and '''[page down]''' respectively, or more accurately by pressing down the '''[middle mouse button]''' and moving the mouse forward or backwards. This method is usually prefered as it gives you much more control over the vertical position of the viewpoint. If you find the greyed-out walls distracting, you can remove them altogether by pressing '''[Ctrl-Alt-A]'''

The second way allows for more precision as you can narrow the active editing range to the height of a single (or set of) sectors. Firstly, select the sector(s) that you want to be able to edit with '''[Right-Alt]''', and press '''[Ctrl-R]'''. It's as easy as that. Press '''[Ctrl-R]''' without having any sectors highlighted to unlock the range again and be able to edit them normally.

===Invisible surfaces viewing mode===
This is for 3D mode when you want to toggle seeing invisible objects.
All you have to do to toggle this mode is press '''[I]''', which primarily allows you to see objects you've made invisible with '''['-I]'''. However, the reason why it's so useful here, is that it also shows you the boundaries between TROR layers (which are invisible in-game). This is a huge benefit when you want to visualize/figure out what's actually going on. It also allows you to edit the TROR surfaces and apply transparent or masked floors, and edit characteristics like the blocking and hitscan bits.

==Properties and Terminology==
TROR is created by selecting a sector and extending it (this will be covered later in method). This means that it creates a new sector directly on top of or below the selected sector, which is exactly the same size and shape as the original. The ceiling of the bottom sector is linked with the floor of the top sector. It then makes sense that the extended sector is called an '''extension'''.

You can have more than one extension on a sector. You can extend it above and below, then take the bottom and extend that down again and again, and the same with the top. You are effectively stacking sectors on top of each other, so these sectors are part of a '''stack'''. The great thing about stacks (even with only one extension) is that if you move the vertex of a wall of one layer, it will automatically move the vertices of all the other layers, so that they're easy to change the shape of without worrying about breaking the connection.

You can highlight a group of sectors and extend them all at the same time so that there can be a single extension covering them all. This is useful because it saves walls, and you can still edit all the child sectors with ease. Now, as soon as you extend these sectors so that they share an extension, they all become a part of the same '''bunch'''.

If you take a room with a child sector in the middle, and extend everything upwards except the child layer, there will now be void space in the top layer where the child sector is. If you press '''[Ctrl-S]''' there to make it into a child sector in the top layer, you'll then find that you have a floating normal (non-TROR) sector between the two TROR layers that you can do with as you please. This is called an '''island'''. I suppose it's still an island even if you don't make it a child sector in the top layer but hey, now you can create floating sectors. These can potentially be glitchy if you're not using the polymer renderer, but we'll get onto that later.

==TROR related keys==
The following are a list of keys which are related to editing TROR. They can also be found in the [http://wiki.eduke32.com/wiki/Build/Mapster32_Keyboard_Commands mapster32 keyboard commands page]

===2D mode===
'''[Ctrl-E]''' sector extension prompt (sectors to extend must be highlighted) 
'''[Ctrl-E]''' make sandwich [''if extending a sector in a direction that has already been extended, see below''] 
'''[Ctrl-E]''' punch loop through extension (loop points must be highlighted, e.g. with '''[Right Shift]'''+'''[Left Ctrl]''') 
 
'''[Ctrl-A]''' toggle auto-grayout of non-extended sectors 
'''[Ctrl-J]''' TROR-join sectors. The selection must consist of the two sets of sectors you wish to join. 
'''[Ctrl-U]''' Clear extension: delete the bunch (i.e. ceiling-floor connection) of the aimed-at sector's floor 
'''[PGUP]'''/'''[PGDN]''' Change 'player' height in discrete steps in order to go through the different levels 
'''[Ctrl-tab]''' Display one currently aimed at sector (of potentially many that lie under the mouse crosshair) 
'''[HOME]''' and '''[END]''' as modifiers to AltGr: select all sectors whose floor's/ceiling's bunchnum equal the bunchnum of the aimed at sector (useful for further operations on whole bunches)

===3D mode===
'''I''' invisibility preview: toggle fake ROR texture on non-masked portals 
'''LENTER+CTRL''' When aiming at an extended floor/ceiling, paste to all floors/ceilings of the bunch of the aimed at one 
'''T''', '''B''' and '''H''' work as with walls, though they set/toggle the bits only on '''one''' side 

===Advanced Highlighting===
Not really specific to TROR, but having greater control over which or how many sectors you can highlight makes doing extensions in TROR much easier. Make sure you're familiar with [http://wiki.eduke32.com/wiki/Level_editing#Copying_and_Pasting_Sectors advanced sector highlighting].

The information on the advanced features is outlined below:

You can highlight a second, third, and multiple sectors by holding down '''[']''' as you drag the selection box over them. This way you can highlight sectors in different parts of the map. Likewise, use the '''[;]''' key to deselect sectors. A small plus or minus will appear next to the cursor depending on which button you're holding.

You can select individual sectors with the mouse by moving the cursor inside the sector you want, holding '''[RIGHT ALT]''', and holding '''[RIGHT CTRL]''' as you release '''[RIGHT ALT]'''. The sector is now highlighted. This method of selection also works with '''[']''' and '''[;]''' to select/deselect additional sectors by mouse. Simply hold '''[RIGHT ALT]''' and the appropriate button depending on what you want to do, then hold '''[RIGHT CTRL]''' while releasing the other buttons. This becomes very quick and easy to do after doing it a few times.

==TROR Mapping Examples==

===Manhole Sewer Example===

In this straightforward example, you're going to make a manhole that goes below a street, and some area around the end of the hole at the bottom.

1. Create the child sector where you want the manhole to be.

2. Highlight the sector with '''[Right-Alt]'''.

3. Press '''[Ctrl-E]'''. Mapster will prompt you whether you want to extend up or down.

4. We want to extend down so press '''[Z]''' ('''[A]''' if you're extending up).

5. Go into side view mode with '''[F3]''', and move the viewpoint down until you're editing the bottom layer.

6. The child sector you created should now have a white boundary, with the street sectors above either greyed out or gone depending on your settings.

7. Now you can treat the manhole sector (the extension) as the very first room you've made on a new map. You can draw sectors on the side of it to attach some rooms there. If you go into 3D mode, you should be able to see that if you go down that manhole, there should now be some area at the bottom which overlaps the street. This was not previously possible without using some kind of cheap trick. Congratulations, you've just made TROR.

===Two Story Building Example===

I'm sure that a big reason that people want to use TROR is to build multiple story buildings, and this is how you do it.

1. Design the first floor of your building, both inside and out. This is going to be the first layer, which means the ceiling of every sector, especially the outdoor sectors should not be any higher than the roof of the first floor. Pretend that the second floor doesn't even exist.

2. Make your windows, doors, and anything you want.

Highlight with '''[Right-Alt]''' all of the ''outdoor'' sectors (the outdoor sectors should all have the same ceiling height, and should not be parallaxed). Knowing your advanced highlighting will come in useful here to select all the sectors.

3. Extend the highlighted area up, and make the top layer the active editing layer.

4. You should notice that the outline of your house has become completely white, and the area inside the house is empty. This is because this area is the second floor of your house.

5. Make a sector inside the house outline, this will be the room on the second floor of your house. Draw small sectors between that room and the house outline to create second floor windows. Alternatively you could just press '''[Ctrl-S]''' inside the house sector to make it a regular child sector, and if you go into 3D mode, you'll see your house has a roof you can stand on top of.

6. If you're learning TROR for the first time, it is very helpful at this point to go into 3D mode and press '''[i]''' to reveal the boundaries between layers so that you can understand what you've done.

7. You can connect the ground floor to the second floor the same way you'd connect two sector-over-sector sectors; by having a staircase or lift that connects to a different area on the top floor than it does on the bottom (because a lift for example cannot directly cross TROR layers, therefore it must be connected to sectors which do not overlap; i.e have the entrance on one side and the exit on the other.)
Or you can connect the ground floor and second floor via TROR and have some sprite stairs or something.

At this stage you should have a perfect two story house where you can look into and enter both stories. Cool stuff eh? ;)

There's nothing stopping you from going on to build a third.. forth.. fifth.. floor in the same manner either.

===Retro-fitting via Joining Example===

If you're absolutely clueless with the whole idea of extending, or you want to go back and retrofit some TROR into maps you've done in the past, there's a very easy way of joining them to form TROR.
If you have two sectors that have the same shape, area, and external vertices have the same relative positions (essentially they're the same sector, at least as far as their edges are concerned), then all you have to do is highlight both sectors with '''[Right-Alt]''', and press '''[Ctrl-J]''' to join, the same as joining two sectors normally. It will then prompt you with a few questions such as which sector you want to have on top of the other, which sector(s) you want to move (doesn't matter most of the time), and whether you'd like to move all the connected non-TROR sectors as well (definitely yes).

The good thing about this method is that besides the questions you have to answer, mapster does everything automatically, it even moves the heights for you. Now there'll be a quick example of this method below.

1. Make a child sector in a larger sector and copy-paste it into void space.

2. Give the floor of the original child sector and the ceiling of the new sector the water texture.

3. Highlight both the child sector and new sector with '''[Right-Alt]'''.

4. Press '''[Ctrl-J]''' and answer the simple questions.

5. You should end up with a TROR water sector just as you would via the extension method. You can now alter the transparency of the water to your preference.

===Sandwiching and Sector Punching===
It's possible and easy to create a new TROR layer between two TROR layers. All you have to do is highlight one of them, and extend it as you would normally, and it automatically adds a new layer in the middle.

It's also possible to easily create an island sector in the middle of a TROR sector. This is called ''sector punching'', and mainly involves stamping a child sector into the sector below or above. Follow the example below.

1. Extend a sector downwards.

2. Create a child sector in the original sector.

3. Select the vertices of the child sector with '''[Right-Shift]''' or '''[R-Ctrl + R-Shift]''' and press '''[Ctrl-E]''' as though you're extending a sector.

4. It will prompt you whether to punch up or down, in this case, choose down and hit '''[Enter]'''. A sector identical in size, shape and position should now be in the bottom layer.

5. Point the mouse cursor at the child sector in the top layer and press '''[Ctrl-U]'''. It will prompt you whether you want to break the connection, and unless you press [Ctrl-U] accidentally, you usually do.

6. The child sector should now be a floating sector island. Have fun.

Note that '''[Ctrl-U]''' only breaks the connection of a single sector if that sector has been punched. Otherwise it'll break the connection of the entire bunch, which is usually bad.

===List of TROR maps===

This (hopefully up to date) list contains maps which make heavy use of the TROR feature in order to make a huge variety of constructions. They each contain a wealth of examples for you to look at to see what's possible and how it works/how to make it.

1. The trueror.map in the Samples folder included with eduke32 contains a large amount of random examples of TROR.

2. Retaliation is a small hi-tech map by Loke that was the first proper TROR map and makes some great use of the feature. [http://www.scent-88.com/reviews/R/retaliation/retaliation.php Download here]

3. Parkade is a large city themed map containing large multiple story buildings, along with a large amount of unique, pioneering uses of the feature, made by myself (Micky C) and Paul B. It is the largest, most extensive TROR map and perhaps the best example of what TROR is capable of so far, if I do say so myself. [http://www.scent-88.com/reviews/P/parkade/parkade.php Download here]

==Visual Glitches and Workarounds==

===Software renderer===
Even though TROR sectors are already physically overlapping, the 8-bit software renderer still needs to render them separately, having to do an extra rendering pass for each additional TROR extension in view. Theoretically if you create a huge amount of extensions in the same area the framerate could potentially drop to unplayable levels, however this is far fetched and I wouldn't worry about it.

The real problem with the software renderer is HOM glitching. In each rendering pass, there can only be one area along the x-interval drawn. For example, if you have an island on the ground, the area between you and the island will be fine, but everything on the other side of the island will show HOM. Try it out yourself to see what I mean. Technically this means that TROR extensions cannot contain islands (although it's been kind of hacked in to do exta-extra passes to overcome this problem, I wouldn't rely on them for perfect drawing.)

However, this can be overcome by breaking up the sector surrounding the child sector, and extending each sector individually. This means there will be multiple drawing portals around the island instead of one big one, and none of the individual extensions would contain the island, hence it should draw fine.

This HOM doesn't just occur due to islands, it can also happen when part of a normal sector is jutting out into a TROR sector, this can be thought of here as a mini-island even though it's connected to something. Don't call it a mini-island, I only called it that to explain why it would cause that glitching. This means that TROR extensions should be ''convex'', i.e if you draw a straight line through a TROR portal so that it leaves the sector, and then comes back, it is not convex (and is most likely due to something jutting out.) However if you draw a line through it and this does not happen, as is the case for a circle, square etc.. then it is convex, and should draw fine.

===Polymer renderer===
Masked floors and ceilings in polymer are always the last thing drawn on the screen. That means if you have a transparent surface such as a masked wall or sprite, it would cause everything all the TROR masked surfaces behind the transparent surface to stop being drawn and become invisible. There's no real work around for this, just try not to use masked walls or sprites with big transparent surfaces around TROR masked surfaces.

Other than that, polymer is by far the most stable renderer for TROR, and apart from what's written above, is 100% glitch free. Despite being slow sometimes, it is the renderer of choice for TROR. It works by drawing the entire scene, TROR and all in a single rendering pass. This means that it doesn't require any additional computer power to draw TROR, hence TROR will not affect the framerate in polymer.

===Polymost renderer===
The polymost renderer is bad, M'kay? It's like a comic relief in bad Hollywood films who can't do anything right. Don't use it.

==Random Trivia==
Extended sectors can be sloped, but the bunch has to be 1:1 in that case. I.e you can't have any child sectors within a sloped TROR sector. If you want different TROR sectors with different slopes, you must use completely different extensions for that, as opposed to breaking up a single extension.

Maps containing one or more TROR bunches are saved in a new map format (v9) since some fields had to be taken over: xrepeat is unavailable on TROR'ed floors and ceilings, and on walls it's lotag if the ceiling, and extra if the floor of the wall's sector is extended. When in-game, these get transferred to internal arrays though.

The system is supposed to be used for 'large-scale' RoR, as a rule of thumb each affected sector should be at least a Duke high [that's too strict though].

[[Category:Level editing documentation]]

True Room Over Room Mapping Guide

2012-04-20T06:04:58Z

Micky C: /* Two Story Building Example */

{{Build Intro}}

True Room Over Room is a feature new to EDuke32 that allows for the construction of [[sector]]s in a vertical arrangement. Other build games (Shadow Warrior, Blood, Redneck Rampage) are able to fake ROR by having sectors in different parts of the map and rendering them on top of each other, and EDuke32 has a similar feature using Sector Effectors. The difference between game ROR and TROR is that the sectors are physically on top of each other, making editing a lot easier and more automatic, while also making it easier to visualize what you're building. For the more technically minded, TROR is part of the engine and map format themselves, instead of an effect bolted on in the game code.

==TROR Editing Modes==
There are two modes you should be aware of before starting to build with TROR.

===Side view (orthographic view) mode===
This mode allows you see a 3D representation of your map while in 2D mode. This is toggled with '''[F3]'''. It can be rotated with the '''[Q]''' and '''[W]''' buttons, and the angle of viewing can be changed by pressing '''[A]''' and '''[Z]'''.
This mode is absolutely essential not only because it allows you to actually see what you're doing, but because in order to properly use TROR, you need to designate which is the 'active' layer that new sectors will connect to.

This can be done in 2 ways.

The first way is to press '''[Ctrl-A]''' which will grey out all other layers except the one the viewpoint (the arrow in 2D/side view mode)is in, which is the active layer. You can move the view point up and down, allowing you to edit above and below layers, by either pressing '''[page up]''' and '''[page down]''' respectively, or more accurately by pressing down the '''[middle mouse button]''' and moving the mouse forward or backwards. This method is usually prefered as it gives you much more control over the vertical position of the viewpoint. If you find the greyed-out walls distracting, you can remove them altogether by pressing '''[Ctrl-Alt-A]'''

The second way allows for more precision as you can narrow the active editing range to the height of a single (or set of) sectors. Firstly, select the sector(s) that you want to be able to edit with '''[Right-Alt]''', and press '''[Ctrl-R]'''. It's as easy as that. Press '''[Ctrl-R]''' without having any sectors highlighted to unlock the range again and be able to edit them normally.

===Invisible surfaces viewing mode===
This is for 3D mode when you want to toggle seeing invisible objects.
All you have to do to toggle this mode is press '''[I]''', which primarily allows you to see objects you've made invisible with '''['-I]'''. However, the reason why it's so useful here, is that it also shows you the boundaries between TROR layers (which are invisible in-game). This is a huge benefit when you want to visualize/figure out what's actually going on. It also allows you to edit the TROR surfaces and apply transparent or masked floors, and edit characteristics like the blocking and hitscan bits.

==Properties and Terminology==
TROR is created by selecting a sector and extending it (this will be covered later in method). This means that it creates a new sector directly on top of or below the selected sector, which is exactly the same size and shape as the original. The ceiling of the bottom sector is linked with the floor of the top sector. It then makes sense that the extended sector is called an '''extension'''.

You can have more than one extension on a sector. You can extend it above and below, then take the bottom and extend that down again and again, and the same with the top. You are effectively stacking sectors on top of each other, so these sectors are part of a '''stack'''. The great thing about stacks (even with only one extension) is that if you move the vertex of a wall of one layer, it will automatically move the vertices of all the other layers, so that they're easy to change the shape of without worrying about breaking the connection.

You can highlight a group of sectors and extend them all at the same time so that there can be a single extension covering them all. This is useful because it saves walls, and you can still edit all the child sectors with ease. Now, as soon as you extend these sectors so that they share an extension, they all become a part of the same '''bunch'''.

If you take a room with a child sector in the middle, and extend everything upwards except the child layer, there will now be void space in the top layer where the child sector is. If you press '''[Ctrl-S]''' there to make it into a child sector in the top layer, you'll then find that you have a floating normal (non-TROR) sector between the two TROR layers that you can do with as you please. This is called an '''island'''. I suppose it's still an island even if you don't make it a child sector in the top layer but hey, now you can create floating sectors. These can potentially be glitchy if you're not using the polymer renderer, but we'll get onto that later.

==TROR related keys==
The following are a list of keys which are related to editing TROR. They can also be found in the [http://wiki.eduke32.com/wiki/Build/Mapster32_Keyboard_Commands mapster32 keyboard commands page]

===2D mode===
'''[Ctrl-E]''' sector extension prompt (sectors to extend must be highlighted) 
'''[Ctrl-E]''' make sandwich [''if extending a sector in a direction that has already been extended, see below''] 
'''[Ctrl-E]''' punch loop through extension (loop points must be highlighted, e.g. with '''[Right Shift]'''+'''[Left Ctrl]''') 
 
'''[Ctrl-A]''' toggle auto-grayout of non-extended sectors 
'''[Ctrl-J]''' TROR-join sectors. The selection must consist of the two sets of sectors you wish to join. 
'''[Ctrl-U]''' Clear extension: delete the bunch (i.e. ceiling-floor connection) of the aimed-at sector's floor 
'''[PGUP]'''/'''[PGDN]''' Change 'player' height in discrete steps in order to go through the different levels 
'''[Ctrl-tab]''' Display one currently aimed at sector (of potentially many that lie under the mouse crosshair) 
'''[HOME]''' and '''[END]''' as modifiers to AltGr: select all sectors whose floor's/ceiling's bunchnum equal the bunchnum of the aimed at sector (useful for further operations on whole bunches)

===3D mode===
'''I''' invisibility preview: toggle fake ROR texture on non-masked portals 
'''LENTER+CTRL''' When aiming at an extended floor/ceiling, paste to all floors/ceilings of the bunch of the aimed at one 
'''T''', '''B''' and '''H''' work as with walls, though they set/toggle the bits only on '''one''' side 

===Advanced Highlighting===
Not really specific to TROR, but having greater control over which or how many sectors you can highlight makes doing extensions in TROR much easier. Make sure you're familiar with [http://wiki.eduke32.com/wiki/Level_editing#Copying_and_Pasting_Sectors advanced sector highlighting].

The information on the advanced features is outlined below:

You can highlight a second, third, and multiple sectors by holding down '''[']''' as you drag the selection box over them. This way you can highlight sectors in different parts of the map. Likewise, use the '''[;]''' key to deselect sectors. A small plus or minus will appear next to the cursor depending on which button you're holding.

You can select individual sectors with the mouse by moving the cursor inside the sector you want, holding '''[RIGHT ALT]''', and holding '''[RIGHT CTRL]''' as you release '''[RIGHT ALT]'''. The sector is now highlighted. This method of selection also works with '''[']''' and '''[;]''' to select/deselect additional sectors by mouse. Simply hold '''[RIGHT ALT]''' and the appropriate button depending on what you want to do, then hold '''[RIGHT CTRL]''' while releasing the other buttons. This becomes very quick and easy to do after doing it a few times.

==TROR Mapping Examples==

===Manhole Sewer Example===

In this straightforward example, you're going to make a manhole that goes below a street, and some area around the end of the hole at the bottom.

1. Create the child sector where you want the manhole to be.

2. Highlight the sector with '''[Right-Alt]'''.

3. Press '''[Ctrl-E]'''. Mapster will prompt you whether you want to extend up or down.

4. We want to extend down so press '''[Z]''' ('''[A]''' if you're extending up).

5. Go into side view mode with '''[F3]''', and move the viewpoint down until you're editing the bottom layer.

6. The child sector you created should now have a white boundary, with the street sectors above either greyed out or gone depending on your settings.

7. Now you can treat the manhole sector (the extension) as the very first room you've made on a new map. You can draw sectors on the side of it to attach some rooms there. If you go into 3D mode, you should be able to see that if you go down that manhole, there should now be some area at the bottom which overlaps the street. This was not previously possible without using some kind of cheap trick. Congratulations, you've just made TROR.

===Two Story Building Example===

I'm sure that a big reason that people want to use TROR is to build multiple story buildings, and this is how you do it.

1. Design the first floor of your building, both inside and out. This is going to be the first layer, which means the ceiling of every sector, especially the outdoor sectors should not be any higher than the roof of the first floor. Pretend that the second floor doesn't even exist.

2. Make your windows, doors, and anything you want.

Highlight with '''[Right-Alt]''' all of the ''outdoor'' sectors (the outdoor sectors should all have the same ceiling height, and should not be parallaxed). Knowing your advanced highlighting will come in useful here to select all the sectors.

3. Extend the highlighted area up, and make the top layer the active editing layer.

4. You should notice that the outline of your house has become completely white, and the area inside the house is empty. This is because this area is the second floor of your house.

5. Make a sector inside the house outline, this will be the room on the second floor of your house. Draw small sectors between that room and the house outline to create second floor windows. Alternatively you could just press '''[Ctrl-S]''' inside the house sector to make it a regular child sector, and if you go into 3D mode, you'll see your house has a roof you can stand on top of.

6. If you're learning TROR for the first time, it is very helpful at this point to go into 3D mode and press '''[i]''' to reveal the boundaries between layers so that you can understand what you've done.

7. You can connect the ground floor to the second floor the same way you'd connect two sector-over-sector sectors; by having a staircase or lift that connects to a different area on the top floor than it does on the bottom (because a lift for example cannot directly cross TROR layers, therefore it must be connected to sectors which do not overlap; i.e have the entrance on one side and the exit on the other.)
Or you can connect the ground floor and second floor via TROR and have some sprite stairs or something.

At this stage you should have a perfect two story house where you can look into and enter both stories. Cool stuff eh? ;)

There's nothing stopping you from going on to build a third.. forth.. fifth.. floor in the same manner either.

===Retro-fitting via Joining Example===

If you're absolutely clueless with the whole idea of extending, or you want to go back and retrofit some TROR into maps you've done in the past, there's a very easy way of joining them to form TROR.
If you have two sectors that have the same shape, area, and external vertices have the same relative positions (essentially they're the same sector, at least as far as their edges are concerned), then all you have to do is highlight both sectors with '''[Right-Alt]''', and press '''[Ctrl-J]''' to join, the same as joining two sectors normally. It will then prompt you with a few questions such as which sector you want to have on top of the other, which sector(s) you want to move (doesn't matter most of the time), and whether you'd like to move all the connected non-TROR sectors as well (definitely yes).

The good thing about this method is that besides the questions you have to answer, mapster does everything automatically, it even moves the heights for you. Now there'll be a quick example of this method below.

1. Make a child sector in a larger sector and copy-paste it into void space.

2. Give the floor of the original child sector and the ceiling of the new sector the water texture.

3. Highlight both the child sector and new sector with '''[Right-Alt]'''.

4. Press '''[Ctrl-J]''' and answer the simple questions.

5. You should end up with a TROR water sector just as you would via the extension method. You can now alter the transparency of the water to your preference.

===Sandwiching and Sector Punching===
It's possible and easy to create a new TROR layer between two TROR layers. All you have to do is highlight one of them, and extend it as you would normally, and it automatically adds a new layer in the middle.

It's also possible to easily create an island sector in the middle of a TROR sector. This is called ''sector punching'', and mainly involves stamping a child sector into the sector below or above. Follow the example below.

1. Extend a sector downwards.

2. Create a child sector in the original sector.

3. Select the vertices of the child sector with '''[Right-Shift]''' or '''[R-Ctrl + R-Shift]''' and press '''[Ctrl-E]''' as though you're extending a sector.

4. It will prompt you whether to punch up or down, in this case, choose down and hit '''[Enter]'''. A sector identical in size, shape and position should now be in the bottom layer.

5. Point the mouse cursor at the child sector in the top layer and press '''[Ctrl-U]'''. It will prompt you whether you want to break the connection, and unless you press [Ctrl-U] accidentally, you usually do.

6. The child sector should now be a floating sector island. Have fun.

Note that '''[Ctrl-U]''' only breaks the connection of a single sector if that sector has been punched. Otherwise it'll break the connection of the entire bunch, which is usually bad.

==Visual Glitches and Workarounds==

===Software renderer===
Even though TROR sectors are already physically overlapping, the 8-bit software renderer still needs to render them separately, having to do an extra rendering pass for each additional TROR extension in view. Theoretically if you create a huge amount of extensions in the same area the framerate could potentially drop to unplayable levels, however this is far fetched and I wouldn't worry about it.

The real problem with the software renderer is HOM glitching. In each rendering pass, there can only be one area along the x-interval drawn. For example, if you have an island on the ground, the area between you and the island will be fine, but everything on the other side of the island will show HOM. Try it out yourself to see what I mean. Technically this means that TROR extensions cannot contain islands (although it's been kind of hacked in to do exta-extra passes to overcome this problem, I wouldn't rely on them for perfect drawing.)

However, this can be overcome by breaking up the sector surrounding the child sector, and extending each sector individually. This means there will be multiple drawing portals around the island instead of one big one, and none of the individual extensions would contain the island, hence it should draw fine.

This HOM doesn't just occur due to islands, it can also happen when part of a normal sector is jutting out into a TROR sector, this can be thought of here as a mini-island even though it's connected to something. Don't call it a mini-island, I only called it that to explain why it would cause that glitching. This means that TROR extensions should be ''convex'', i.e if you draw a straight line through a TROR portal so that it leaves the sector, and then comes back, it is not convex (and is most likely due to something jutting out.) However if you draw a line through it and this does not happen, as is the case for a circle, square etc.. then it is convex, and should draw fine.

===Polymer renderer===
Masked floors and ceilings in polymer are always the last thing drawn on the screen. That means if you have a transparent surface such as a masked wall or sprite, it would cause everything all the TROR masked surfaces behind the transparent surface to stop being drawn and become invisible. There's no real work around for this, just try not to use masked walls or sprites with big transparent surfaces around TROR masked surfaces.

Other than that, polymer is by far the most stable renderer for TROR, and apart from what's written above, is 100% glitch free. Despite being slow sometimes, it is the renderer of choice for TROR. It works by drawing the entire scene, TROR and all in a single rendering pass. This means that it doesn't require any additional computer power to draw TROR, hence TROR will not affect the framerate in polymer.

===Polymost renderer===
The polymost renderer is bad, M'kay? It's like a comic relief in bad Hollywood films who can't do anything right. Don't use it.

==Random Trivia==
Extended sectors can be sloped, but the bunch has to be 1:1 in that case. I.e you can't have any child sectors within a sloped TROR sector. If you want different TROR sectors with different slopes, you must use completely different extensions for that, as opposed to breaking up a single extension.

Maps containing one or more TROR bunches are saved in a new map format (v9) since some fields had to be taken over: xrepeat is unavailable on TROR'ed floors and ceilings, and on walls it's lotag if the ceiling, and extra if the floor of the wall's sector is extended. When in-game, these get transferred to internal arrays though.

The system is supposed to be used for 'large-scale' RoR, as a rule of thumb each affected sector should be at least a Duke high [that's too strict though].

[[Category:Level editing documentation]]

True Room Over Room Mapping Guide

2012-04-20T06:01:28Z

Micky C: /* TROR Mapping Examples */

{{Build Intro}}

True Room Over Room is a feature new to EDuke32 that allows for the construction of [[sector]]s in a vertical arrangement. Other build games (Shadow Warrior, Blood, Redneck Rampage) are able to fake ROR by having sectors in different parts of the map and rendering them on top of each other, and EDuke32 has a similar feature using Sector Effectors. The difference between game ROR and TROR is that the sectors are physically on top of each other, making editing a lot easier and more automatic, while also making it easier to visualize what you're building. For the more technically minded, TROR is part of the engine and map format themselves, instead of an effect bolted on in the game code.

==TROR Editing Modes==
There are two modes you should be aware of before starting to build with TROR.

===Side view (orthographic view) mode===
This mode allows you see a 3D representation of your map while in 2D mode. This is toggled with '''[F3]'''. It can be rotated with the '''[Q]''' and '''[W]''' buttons, and the angle of viewing can be changed by pressing '''[A]''' and '''[Z]'''.
This mode is absolutely essential not only because it allows you to actually see what you're doing, but because in order to properly use TROR, you need to designate which is the 'active' layer that new sectors will connect to.

This can be done in 2 ways.

The first way is to press '''[Ctrl-A]''' which will grey out all other layers except the one the viewpoint (the arrow in 2D/side view mode)is in, which is the active layer. You can move the view point up and down, allowing you to edit above and below layers, by either pressing '''[page up]''' and '''[page down]''' respectively, or more accurately by pressing down the '''[middle mouse button]''' and moving the mouse forward or backwards. This method is usually prefered as it gives you much more control over the vertical position of the viewpoint. If you find the greyed-out walls distracting, you can remove them altogether by pressing '''[Ctrl-Alt-A]'''

The second way allows for more precision as you can narrow the active editing range to the height of a single (or set of) sectors. Firstly, select the sector(s) that you want to be able to edit with '''[Right-Alt]''', and press '''[Ctrl-R]'''. It's as easy as that. Press '''[Ctrl-R]''' without having any sectors highlighted to unlock the range again and be able to edit them normally.

===Invisible surfaces viewing mode===
This is for 3D mode when you want to toggle seeing invisible objects.
All you have to do to toggle this mode is press '''[I]''', which primarily allows you to see objects you've made invisible with '''['-I]'''. However, the reason why it's so useful here, is that it also shows you the boundaries between TROR layers (which are invisible in-game). This is a huge benefit when you want to visualize/figure out what's actually going on. It also allows you to edit the TROR surfaces and apply transparent or masked floors, and edit characteristics like the blocking and hitscan bits.

==Properties and Terminology==
TROR is created by selecting a sector and extending it (this will be covered later in method). This means that it creates a new sector directly on top of or below the selected sector, which is exactly the same size and shape as the original. The ceiling of the bottom sector is linked with the floor of the top sector. It then makes sense that the extended sector is called an '''extension'''.

You can have more than one extension on a sector. You can extend it above and below, then take the bottom and extend that down again and again, and the same with the top. You are effectively stacking sectors on top of each other, so these sectors are part of a '''stack'''. The great thing about stacks (even with only one extension) is that if you move the vertex of a wall of one layer, it will automatically move the vertices of all the other layers, so that they're easy to change the shape of without worrying about breaking the connection.

You can highlight a group of sectors and extend them all at the same time so that there can be a single extension covering them all. This is useful because it saves walls, and you can still edit all the child sectors with ease. Now, as soon as you extend these sectors so that they share an extension, they all become a part of the same '''bunch'''.

If you take a room with a child sector in the middle, and extend everything upwards except the child layer, there will now be void space in the top layer where the child sector is. If you press '''[Ctrl-S]''' there to make it into a child sector in the top layer, you'll then find that you have a floating normal (non-TROR) sector between the two TROR layers that you can do with as you please. This is called an '''island'''. I suppose it's still an island even if you don't make it a child sector in the top layer but hey, now you can create floating sectors. These can potentially be glitchy if you're not using the polymer renderer, but we'll get onto that later.

==TROR related keys==
The following are a list of keys which are related to editing TROR. They can also be found in the [http://wiki.eduke32.com/wiki/Build/Mapster32_Keyboard_Commands mapster32 keyboard commands page]

===2D mode===
'''[Ctrl-E]''' sector extension prompt (sectors to extend must be highlighted) 
'''[Ctrl-E]''' make sandwich [''if extending a sector in a direction that has already been extended, see below''] 
'''[Ctrl-E]''' punch loop through extension (loop points must be highlighted, e.g. with '''[Right Shift]'''+'''[Left Ctrl]''') 
 
'''[Ctrl-A]''' toggle auto-grayout of non-extended sectors 
'''[Ctrl-J]''' TROR-join sectors. The selection must consist of the two sets of sectors you wish to join. 
'''[Ctrl-U]''' Clear extension: delete the bunch (i.e. ceiling-floor connection) of the aimed-at sector's floor 
'''[PGUP]'''/'''[PGDN]''' Change 'player' height in discrete steps in order to go through the different levels 
'''[Ctrl-tab]''' Display one currently aimed at sector (of potentially many that lie under the mouse crosshair) 
'''[HOME]''' and '''[END]''' as modifiers to AltGr: select all sectors whose floor's/ceiling's bunchnum equal the bunchnum of the aimed at sector (useful for further operations on whole bunches)

===3D mode===
'''I''' invisibility preview: toggle fake ROR texture on non-masked portals 
'''LENTER+CTRL''' When aiming at an extended floor/ceiling, paste to all floors/ceilings of the bunch of the aimed at one 
'''T''', '''B''' and '''H''' work as with walls, though they set/toggle the bits only on '''one''' side 

===Advanced Highlighting===
Not really specific to TROR, but having greater control over which or how many sectors you can highlight makes doing extensions in TROR much easier. Make sure you're familiar with [http://wiki.eduke32.com/wiki/Level_editing#Copying_and_Pasting_Sectors advanced sector highlighting].

The information on the advanced features is outlined below:

You can highlight a second, third, and multiple sectors by holding down '''[']''' as you drag the selection box over them. This way you can highlight sectors in different parts of the map. Likewise, use the '''[;]''' key to deselect sectors. A small plus or minus will appear next to the cursor depending on which button you're holding.

You can select individual sectors with the mouse by moving the cursor inside the sector you want, holding '''[RIGHT ALT]''', and holding '''[RIGHT CTRL]''' as you release '''[RIGHT ALT]'''. The sector is now highlighted. This method of selection also works with '''[']''' and '''[;]''' to select/deselect additional sectors by mouse. Simply hold '''[RIGHT ALT]''' and the appropriate button depending on what you want to do, then hold '''[RIGHT CTRL]''' while releasing the other buttons. This becomes very quick and easy to do after doing it a few times.

==TROR Mapping Examples==

===Manhole Sewer Example===

In this straightforward example, you're going to make a manhole that goes below a street, and some area around the end of the hole at the bottom.

1. Create the child sector where you want the manhole to be.

2. Highlight the sector with '''[Right-Alt]'''.

3. Press '''[Ctrl-E]'''. Mapster will prompt you whether you want to extend up or down.

4. We want to extend down so press '''[Z]''' ('''[A]''' if you're extending up).

5. Go into side view mode with '''[F3]''', and move the viewpoint down until you're editing the bottom layer.

6. The child sector you created should now have a white boundary, with the street sectors above either greyed out or gone depending on your settings.

7. Now you can treat the manhole sector (the extension) as the very first room you've made on a new map. You can draw sectors on the side of it to attach some rooms there. If you go into 3D mode, you should be able to see that if you go down that manhole, there should now be some area at the bottom which overlaps the street. This was not previously possible without using some kind of cheap trick. Congratulations, you've just made TROR.

===Two Story Building Example===

I'm sure that a big reason that people want to use TROR is to build multiple story buildings, and this is how you do it.

1. Design the first floor of your building, both inside and out. This is going to be the first layer, which means the ceiling of every sector, especially the outdoor sectors should not be any higher than the roof of the first floor. Pretend that the second floor doesn't even exist.

2. Make your windows, doors, and anything you want.

Highlight with '''[Right-Alt]''' all of the ''outdoor'' sectors (the outdoor sectors should all have the same ceiling height, and should not be parallaxed). Knowing your advanced highlighting will come in useful here to select all the sectors.

3. Extend the highlighted area up, and make the top layer the active editing layer.

4. You should notice that the outline of your house has become completely white, and the area inside the house is empty. This is because this area is the second floor of your house.

5. Make a sector inside the house outline, this will be the room on the second floor of your house. Draw small sectors between that room and the house outline to create second floor windows. Alternatively you could just press '''[Ctrl-S]''' inside the house sector to make it a regular child sector, and if you go into 3D mode, you'll see your house has a roof you can stand on top of.

6. If you're learning TROR for the first time, it is very helpful at this point to go into 3D mode and press '''[i]''' to reveal the boundaries between layers so that you can understand what you've done.

7. You can connect the ground floor to the second floor the same way you'd connect two sector-over-sector sectors; by having a staircase or lift that connects to a different area on the top floor than it does on the bottom (because a lift for example cannot directly cross TROR layers, therefore it must be connected to sectors which do not overlap; i.e have the entrance on one side and the exit on the other.)
Or you can connect the ground floor and second floor via TROR and have some sprite stairs or something.

===Retro-fitting via Joining Example===

If you're absolutely clueless with the whole idea of extending, or you want to go back and retrofit some TROR into maps you've done in the past, there's a very easy way of joining them to form TROR.
If you have two sectors that have the same shape, area, and external vertices have the same relative positions (essentially they're the same sector, at least as far as their edges are concerned), then all you have to do is highlight both sectors with '''[Right-Alt]''', and press '''[Ctrl-J]''' to join, the same as joining two sectors normally. It will then prompt you with a few questions such as which sector you want to have on top of the other, which sector(s) you want to move (doesn't matter most of the time), and whether you'd like to move all the connected non-TROR sectors as well (definitely yes).

The good thing about this method is that besides the questions you have to answer, mapster does everything automatically, it even moves the heights for you. Now there'll be a quick example of this method below.

1. Make a child sector in a larger sector and copy-paste it into void space.

2. Give the floor of the original child sector and the ceiling of the new sector the water texture.

3. Highlight both the child sector and new sector with '''[Right-Alt]'''.

4. Press '''[Ctrl-J]''' and answer the simple questions.

5. You should end up with a TROR water sector just as you would via the extension method. You can now alter the transparency of the water to your preference.

===Sandwiching and Sector Punching===
It's possible and easy to create a new TROR layer between two TROR layers. All you have to do is highlight one of them, and extend it as you would normally, and it automatically adds a new layer in the middle.

It's also possible to easily create an island sector in the middle of a TROR sector. This is called ''sector punching'', and mainly involves stamping a child sector into the sector below or above. Follow the example below.

1. Extend a sector downwards.

2. Create a child sector in the original sector.

3. Select the vertices of the child sector with '''[Right-Shift]''' or '''[R-Ctrl + R-Shift]''' and press '''[Ctrl-E]''' as though you're extending a sector.

4. It will prompt you whether to punch up or down, in this case, choose down and hit '''[Enter]'''. A sector identical in size, shape and position should now be in the bottom layer.

5. Point the mouse cursor at the child sector in the top layer and press '''[Ctrl-U]'''. It will prompt you whether you want to break the connection, and unless you press [Ctrl-U] accidentally, you usually do.

6. The child sector should now be a floating sector island. Have fun.

Note that '''[Ctrl-U]''' only breaks the connection of a single sector if that sector has been punched. Otherwise it'll break the connection of the entire bunch, which is usually bad.

==Visual Glitches and Workarounds==

===Software renderer===
Even though TROR sectors are already physically overlapping, the 8-bit software renderer still needs to render them separately, having to do an extra rendering pass for each additional TROR extension in view. Theoretically if you create a huge amount of extensions in the same area the framerate could potentially drop to unplayable levels, however this is far fetched and I wouldn't worry about it.

The real problem with the software renderer is HOM glitching. In each rendering pass, there can only be one area along the x-interval drawn. For example, if you have an island on the ground, the area between you and the island will be fine, but everything on the other side of the island will show HOM. Try it out yourself to see what I mean. Technically this means that TROR extensions cannot contain islands (although it's been kind of hacked in to do exta-extra passes to overcome this problem, I wouldn't rely on them for perfect drawing.)

However, this can be overcome by breaking up the sector surrounding the child sector, and extending each sector individually. This means there will be multiple drawing portals around the island instead of one big one, and none of the individual extensions would contain the island, hence it should draw fine.

This HOM doesn't just occur due to islands, it can also happen when part of a normal sector is jutting out into a TROR sector, this can be thought of here as a mini-island even though it's connected to something. Don't call it a mini-island, I only called it that to explain why it would cause that glitching. This means that TROR extensions should be ''convex'', i.e if you draw a straight line through a TROR portal so that it leaves the sector, and then comes back, it is not convex (and is most likely due to something jutting out.) However if you draw a line through it and this does not happen, as is the case for a circle, square etc.. then it is convex, and should draw fine.

===Polymer renderer===
Masked floors and ceilings in polymer are always the last thing drawn on the screen. That means if you have a transparent surface such as a masked wall or sprite, it would cause everything all the TROR masked surfaces behind the transparent surface to stop being drawn and become invisible. There's no real work around for this, just try not to use masked walls or sprites with big transparent surfaces around TROR masked surfaces.

Other than that, polymer is by far the most stable renderer for TROR, and apart from what's written above, is 100% glitch free. Despite being slow sometimes, it is the renderer of choice for TROR. It works by drawing the entire scene, TROR and all in a single rendering pass. This means that it doesn't require any additional computer power to draw TROR, hence TROR will not affect the framerate in polymer.

===Polymost renderer===
The polymost renderer is bad, M'kay? It's like a comic relief in bad Hollywood films who can't do anything right. Don't use it.

==Random Trivia==
Extended sectors can be sloped, but the bunch has to be 1:1 in that case. I.e you can't have any child sectors within a sloped TROR sector. If you want different TROR sectors with different slopes, you must use completely different extensions for that, as opposed to breaking up a single extension.

Maps containing one or more TROR bunches are saved in a new map format (v9) since some fields had to be taken over: xrepeat is unavailable on TROR'ed floors and ceilings, and on walls it's lotag if the ceiling, and extra if the floor of the wall's sector is extended. When in-game, these get transferred to internal arrays though.

The system is supposed to be used for 'large-scale' RoR, as a rule of thumb each affected sector should be at least a Duke high [that's too strict though].

[[Category:Level editing documentation]]

True Room Over Room Mapping Guide

2012-04-20T06:01:12Z

Micky C: /* Two Story Building Example */

{{Build Intro}}

True Room Over Room is a feature new to EDuke32 that allows for the construction of [[sector]]s in a vertical arrangement. Other build games (Shadow Warrior, Blood, Redneck Rampage) are able to fake ROR by having sectors in different parts of the map and rendering them on top of each other, and EDuke32 has a similar feature using Sector Effectors. The difference between game ROR and TROR is that the sectors are physically on top of each other, making editing a lot easier and more automatic, while also making it easier to visualize what you're building. For the more technically minded, TROR is part of the engine and map format themselves, instead of an effect bolted on in the game code.

==TROR Editing Modes==
There are two modes you should be aware of before starting to build with TROR.

===Side view (orthographic view) mode===
This mode allows you see a 3D representation of your map while in 2D mode. This is toggled with '''[F3]'''. It can be rotated with the '''[Q]''' and '''[W]''' buttons, and the angle of viewing can be changed by pressing '''[A]''' and '''[Z]'''.
This mode is absolutely essential not only because it allows you to actually see what you're doing, but because in order to properly use TROR, you need to designate which is the 'active' layer that new sectors will connect to.

This can be done in 2 ways.

The first way is to press '''[Ctrl-A]''' which will grey out all other layers except the one the viewpoint (the arrow in 2D/side view mode)is in, which is the active layer. You can move the view point up and down, allowing you to edit above and below layers, by either pressing '''[page up]''' and '''[page down]''' respectively, or more accurately by pressing down the '''[middle mouse button]''' and moving the mouse forward or backwards. This method is usually prefered as it gives you much more control over the vertical position of the viewpoint. If you find the greyed-out walls distracting, you can remove them altogether by pressing '''[Ctrl-Alt-A]'''

The second way allows for more precision as you can narrow the active editing range to the height of a single (or set of) sectors. Firstly, select the sector(s) that you want to be able to edit with '''[Right-Alt]''', and press '''[Ctrl-R]'''. It's as easy as that. Press '''[Ctrl-R]''' without having any sectors highlighted to unlock the range again and be able to edit them normally.

===Invisible surfaces viewing mode===
This is for 3D mode when you want to toggle seeing invisible objects.
All you have to do to toggle this mode is press '''[I]''', which primarily allows you to see objects you've made invisible with '''['-I]'''. However, the reason why it's so useful here, is that it also shows you the boundaries between TROR layers (which are invisible in-game). This is a huge benefit when you want to visualize/figure out what's actually going on. It also allows you to edit the TROR surfaces and apply transparent or masked floors, and edit characteristics like the blocking and hitscan bits.

==Properties and Terminology==
TROR is created by selecting a sector and extending it (this will be covered later in method). This means that it creates a new sector directly on top of or below the selected sector, which is exactly the same size and shape as the original. The ceiling of the bottom sector is linked with the floor of the top sector. It then makes sense that the extended sector is called an '''extension'''.

You can have more than one extension on a sector. You can extend it above and below, then take the bottom and extend that down again and again, and the same with the top. You are effectively stacking sectors on top of each other, so these sectors are part of a '''stack'''. The great thing about stacks (even with only one extension) is that if you move the vertex of a wall of one layer, it will automatically move the vertices of all the other layers, so that they're easy to change the shape of without worrying about breaking the connection.

You can highlight a group of sectors and extend them all at the same time so that there can be a single extension covering them all. This is useful because it saves walls, and you can still edit all the child sectors with ease. Now, as soon as you extend these sectors so that they share an extension, they all become a part of the same '''bunch'''.

If you take a room with a child sector in the middle, and extend everything upwards except the child layer, there will now be void space in the top layer where the child sector is. If you press '''[Ctrl-S]''' there to make it into a child sector in the top layer, you'll then find that you have a floating normal (non-TROR) sector between the two TROR layers that you can do with as you please. This is called an '''island'''. I suppose it's still an island even if you don't make it a child sector in the top layer but hey, now you can create floating sectors. These can potentially be glitchy if you're not using the polymer renderer, but we'll get onto that later.

==TROR related keys==
The following are a list of keys which are related to editing TROR. They can also be found in the [http://wiki.eduke32.com/wiki/Build/Mapster32_Keyboard_Commands mapster32 keyboard commands page]

===2D mode===
'''[Ctrl-E]''' sector extension prompt (sectors to extend must be highlighted) 
'''[Ctrl-E]''' make sandwich [''if extending a sector in a direction that has already been extended, see below''] 
'''[Ctrl-E]''' punch loop through extension (loop points must be highlighted, e.g. with '''[Right Shift]'''+'''[Left Ctrl]''') 
 
'''[Ctrl-A]''' toggle auto-grayout of non-extended sectors 
'''[Ctrl-J]''' TROR-join sectors. The selection must consist of the two sets of sectors you wish to join. 
'''[Ctrl-U]''' Clear extension: delete the bunch (i.e. ceiling-floor connection) of the aimed-at sector's floor 
'''[PGUP]'''/'''[PGDN]''' Change 'player' height in discrete steps in order to go through the different levels 
'''[Ctrl-tab]''' Display one currently aimed at sector (of potentially many that lie under the mouse crosshair) 
'''[HOME]''' and '''[END]''' as modifiers to AltGr: select all sectors whose floor's/ceiling's bunchnum equal the bunchnum of the aimed at sector (useful for further operations on whole bunches)

===3D mode===
'''I''' invisibility preview: toggle fake ROR texture on non-masked portals 
'''LENTER+CTRL''' When aiming at an extended floor/ceiling, paste to all floors/ceilings of the bunch of the aimed at one 
'''T''', '''B''' and '''H''' work as with walls, though they set/toggle the bits only on '''one''' side 

===Advanced Highlighting===
Not really specific to TROR, but having greater control over which or how many sectors you can highlight makes doing extensions in TROR much easier. Make sure you're familiar with [http://wiki.eduke32.com/wiki/Level_editing#Copying_and_Pasting_Sectors advanced sector highlighting].

The information on the advanced features is outlined below:

You can highlight a second, third, and multiple sectors by holding down '''[']''' as you drag the selection box over them. This way you can highlight sectors in different parts of the map. Likewise, use the '''[;]''' key to deselect sectors. A small plus or minus will appear next to the cursor depending on which button you're holding.

You can select individual sectors with the mouse by moving the cursor inside the sector you want, holding '''[RIGHT ALT]''', and holding '''[RIGHT CTRL]''' as you release '''[RIGHT ALT]'''. The sector is now highlighted. This method of selection also works with '''[']''' and '''[;]''' to select/deselect additional sectors by mouse. Simply hold '''[RIGHT ALT]''' and the appropriate button depending on what you want to do, then hold '''[RIGHT CTRL]''' while releasing the other buttons. This becomes very quick and easy to do after doing it a few times.

==TROR Mapping Examples==

===Manhole Sewer Example===

In this straightforward example, you're going to make a manhole that goes below a street, and some area around the end of the hole at the bottom.

1. Create the child sector where you want the manhole to be.

2. Highlight the sector with '''[Right-Alt]'''.

3. Press '''[Ctrl-E]'''. Mapster will prompt you whether you want to extend up or down.

4. We want to extend down so press '''[Z]''' ('''[A]''' if you're extending up).

5. Go into side view mode with '''[F3]''', and move the viewpoint down until you're editing the bottom layer.

6. The child sector you created should now have a white boundary, with the street sectors above either greyed out or gone depending on your settings.

7. Now you can treat the manhole sector (the extension) as the very first room you've made on a new map. You can draw sectors on the side of it to attach some rooms there. If you go into 3D mode, you should be able to see that if you go down that manhole, there should now be some area at the bottom which overlaps the street. This was not previously possible without using some kind of cheap trick. Congratulations, you've just made TROR.

===Two Story Building Example===

I'm sure that a big reason that people want to use TROR is to build multiple story buildings, and this is how you do it.

1. Design the first floor of your building, both inside and out. This is going to be the first layer, which means the ceiling of every sector, especially the outdoor sectors should not be any higher than the roof of the first floor. Pretend that the second floor doesn't even exist.

2. Make your windows, doors, and anything you want.

Highlight with '''[Right-Alt]''' all of the ''outdoor'' sectors (the outdoor sectors should all have the same ceiling height, and should not be parallaxed). Knowing your advanced highlighting will come in useful here to select all the sectors.

3. Extend the highlighted area up, and make the top layer the active editing layer.

4. You should notice that the outline of your house has become completely white, and the area inside the house is empty. This is because this area is the second floor of your house.

5. Make a sector inside the house outline, this will be the room on the second floor of your house. Draw small sectors between that room and the house outline to create second floor windows. Alternatively you could just press '''[Ctrl-S]''' inside the house sector to make it a regular child sector, and if you go into 3D mode, you'll see your house has a roof you can stand on top of.

6. If you're learning TROR for the first time, it is very helpful at this point to go into 3D mode and press '''[i]''' to reveal the boundaries between layers so that you can understand what you've done.

7. You can connect the ground floor to the second floor the same way you'd connect two sector-over-sector sectors; by having a staircase or lift that connects to a different area on the top floor than it does on the bottom (because a lift for example cannot directly cross TROR layers, therefore it must be connected to sectors which do not overlap; i.e have the entrance on one side and the exit on the other.)
Or you can connect the ground floor and second floor via TROR and have some sprite stairs or something.

===Retro-fitting via Joining Example===

If you're absolutely clueless with the whole idea of extending, or you want to go back and retrofit some TROR into maps you've done in the past, there's a very easy way of joining them to form TROR.
If you have two sectors that have the same shape, area, and external vertices have the same relative positions (essentially they're the same sector, at least as far as their edges are concerned), then all you have to do is highlight both sectors with '''[Right-Alt]''', and press '''[Ctrl-J]''' to join, the same as joining two sectors normally. It will then prompt you with a few questions such as which sector you want to have on top of the other, which sector(s) you want to move (doesn't matter most of the time), and whether you'd like to move all the connected non-TROR sectors as well (definitely yes).

The good thing about this method is that besides the questions you have to answer, mapster does everything automatically, it even moves the heights for you. Now there'll be a quick example of this method below.

1. Make a child sector in a larger sector and copy-paste it into void space.

2. Give the floor of the original child sector and the ceiling of the new sector the water texture.

3. Highlight both the child sector and new sector with '''[Right-Alt]'''.

4. Press '''[Ctrl-J]''' and answer the simple questions.

5. You should end up with a TROR water sector just as you would via the extension method. You can now alter the transparency of the water to your preference.

===Sandwiching and Sector Punching===
It's possible and easy to create a new TROR layer between two TROR layers. All you have to do is highlight one of them, and extend it as you would normally, and it automatically adds a new layer in the middle.

It's also possible to easily create an island sector in the middle of a TROR sector. This is called ''sector punching'', and mainly involves stamping a child sector into the sector below or above. Follow the example below.

1. Extend a sector downwards.

2. Create a child sector in the original sector.

3. Select the vertices of the child sector with '''[Right-Shift]''' or '''[R-Ctrl + R-Shift]''' and press '''[Ctrl-E]''' as though you're extending a sector.

4. It will prompt you whether to punch up or down, in this case, choose down and hit '''[Enter]'''. A sector identical in size, shape and position should now be in the bottom layer.

5. Point the mouse cursor at the child sector in the top layer and press '''[Ctrl-U]'''. It will prompt you whether you want to break the connection, and unless you press [Ctrl-U] accidentally, you usually do.

6. The child sector should now be a floating sector island. Have fun.

Note that '''[Ctrl-U]''' only breaks the connection of a single sector if that sector has been punched. Otherwise it'll break the connection of the entire bunch, which is usually bad.

==Visual Glitches and Workarounds==

===Software renderer===
Even though TROR sectors are already physically overlapping, the 8-bit software renderer still needs to render them separately, having to do an extra rendering pass for each additional TROR extension in view. Theoretically if you create a huge amount of extensions in the same area the framerate could potentially drop to unplayable levels, however this is far fetched and I wouldn't worry about it.

The real problem with the software renderer is HOM glitching. In each rendering pass, there can only be one area along the x-interval drawn. For example, if you have an island on the ground, the area between you and the island will be fine, but everything on the other side of the island will show HOM. Try it out yourself to see what I mean. Technically this means that TROR extensions cannot contain islands (although it's been kind of hacked in to do exta-extra passes to overcome this problem, I wouldn't rely on them for perfect drawing.)

However, this can be overcome by breaking up the sector surrounding the child sector, and extending each sector individually. This means there will be multiple drawing portals around the island instead of one big one, and none of the individual extensions would contain the island, hence it should draw fine.

This HOM doesn't just occur due to islands, it can also happen when part of a normal sector is jutting out into a TROR sector, this can be thought of here as a mini-island even though it's connected to something. Don't call it a mini-island, I only called it that to explain why it would cause that glitching. This means that TROR extensions should be ''convex'', i.e if you draw a straight line through a TROR portal so that it leaves the sector, and then comes back, it is not convex (and is most likely due to something jutting out.) However if you draw a line through it and this does not happen, as is the case for a circle, square etc.. then it is convex, and should draw fine.

===Polymer renderer===
Masked floors and ceilings in polymer are always the last thing drawn on the screen. That means if you have a transparent surface such as a masked wall or sprite, it would cause everything all the TROR masked surfaces behind the transparent surface to stop being drawn and become invisible. There's no real work around for this, just try not to use masked walls or sprites with big transparent surfaces around TROR masked surfaces.

Other than that, polymer is by far the most stable renderer for TROR, and apart from what's written above, is 100% glitch free. Despite being slow sometimes, it is the renderer of choice for TROR. It works by drawing the entire scene, TROR and all in a single rendering pass. This means that it doesn't require any additional computer power to draw TROR, hence TROR will not affect the framerate in polymer.

===Polymost renderer===
The polymost renderer is bad, M'kay? It's like a comic relief in bad Hollywood films who can't do anything right. Don't use it.

==Random Trivia==
Extended sectors can be sloped, but the bunch has to be 1:1 in that case. I.e you can't have any child sectors within a sloped TROR sector. If you want different TROR sectors with different slopes, you must use completely different extensions for that, as opposed to breaking up a single extension.

Maps containing one or more TROR bunches are saved in a new map format (v9) since some fields had to be taken over: xrepeat is unavailable on TROR'ed floors and ceilings, and on walls it's lotag if the ceiling, and extra if the floor of the wall's sector is extended. When in-game, these get transferred to internal arrays though.

The system is supposed to be used for 'large-scale' RoR, as a rule of thumb each affected sector should be at least a Duke high [that's too strict though].

[[Category:Level editing documentation]]

True Room Over Room Mapping Guide

2012-04-20T05:58:51Z

Micky C: /* TROR Mapping Examples */

{{Build Intro}}

True Room Over Room is a feature new to EDuke32 that allows for the construction of [[sector]]s in a vertical arrangement. Other build games (Shadow Warrior, Blood, Redneck Rampage) are able to fake ROR by having sectors in different parts of the map and rendering them on top of each other, and EDuke32 has a similar feature using Sector Effectors. The difference between game ROR and TROR is that the sectors are physically on top of each other, making editing a lot easier and more automatic, while also making it easier to visualize what you're building. For the more technically minded, TROR is part of the engine and map format themselves, instead of an effect bolted on in the game code.

==TROR Editing Modes==
There are two modes you should be aware of before starting to build with TROR.

===Side view (orthographic view) mode===
This mode allows you see a 3D representation of your map while in 2D mode. This is toggled with '''[F3]'''. It can be rotated with the '''[Q]''' and '''[W]''' buttons, and the angle of viewing can be changed by pressing '''[A]''' and '''[Z]'''.
This mode is absolutely essential not only because it allows you to actually see what you're doing, but because in order to properly use TROR, you need to designate which is the 'active' layer that new sectors will connect to.

This can be done in 2 ways.

The first way is to press '''[Ctrl-A]''' which will grey out all other layers except the one the viewpoint (the arrow in 2D/side view mode)is in, which is the active layer. You can move the view point up and down, allowing you to edit above and below layers, by either pressing '''[page up]''' and '''[page down]''' respectively, or more accurately by pressing down the '''[middle mouse button]''' and moving the mouse forward or backwards. This method is usually prefered as it gives you much more control over the vertical position of the viewpoint. If you find the greyed-out walls distracting, you can remove them altogether by pressing '''[Ctrl-Alt-A]'''

The second way allows for more precision as you can narrow the active editing range to the height of a single (or set of) sectors. Firstly, select the sector(s) that you want to be able to edit with '''[Right-Alt]''', and press '''[Ctrl-R]'''. It's as easy as that. Press '''[Ctrl-R]''' without having any sectors highlighted to unlock the range again and be able to edit them normally.

===Invisible surfaces viewing mode===
This is for 3D mode when you want to toggle seeing invisible objects.
All you have to do to toggle this mode is press '''[I]''', which primarily allows you to see objects you've made invisible with '''['-I]'''. However, the reason why it's so useful here, is that it also shows you the boundaries between TROR layers (which are invisible in-game). This is a huge benefit when you want to visualize/figure out what's actually going on. It also allows you to edit the TROR surfaces and apply transparent or masked floors, and edit characteristics like the blocking and hitscan bits.

==Properties and Terminology==
TROR is created by selecting a sector and extending it (this will be covered later in method). This means that it creates a new sector directly on top of or below the selected sector, which is exactly the same size and shape as the original. The ceiling of the bottom sector is linked with the floor of the top sector. It then makes sense that the extended sector is called an '''extension'''.

You can have more than one extension on a sector. You can extend it above and below, then take the bottom and extend that down again and again, and the same with the top. You are effectively stacking sectors on top of each other, so these sectors are part of a '''stack'''. The great thing about stacks (even with only one extension) is that if you move the vertex of a wall of one layer, it will automatically move the vertices of all the other layers, so that they're easy to change the shape of without worrying about breaking the connection.

You can highlight a group of sectors and extend them all at the same time so that there can be a single extension covering them all. This is useful because it saves walls, and you can still edit all the child sectors with ease. Now, as soon as you extend these sectors so that they share an extension, they all become a part of the same '''bunch'''.

If you take a room with a child sector in the middle, and extend everything upwards except the child layer, there will now be void space in the top layer where the child sector is. If you press '''[Ctrl-S]''' there to make it into a child sector in the top layer, you'll then find that you have a floating normal (non-TROR) sector between the two TROR layers that you can do with as you please. This is called an '''island'''. I suppose it's still an island even if you don't make it a child sector in the top layer but hey, now you can create floating sectors. These can potentially be glitchy if you're not using the polymer renderer, but we'll get onto that later.

==TROR related keys==
The following are a list of keys which are related to editing TROR. They can also be found in the [http://wiki.eduke32.com/wiki/Build/Mapster32_Keyboard_Commands mapster32 keyboard commands page]

===2D mode===
'''[Ctrl-E]''' sector extension prompt (sectors to extend must be highlighted) 
'''[Ctrl-E]''' make sandwich [''if extending a sector in a direction that has already been extended, see below''] 
'''[Ctrl-E]''' punch loop through extension (loop points must be highlighted, e.g. with '''[Right Shift]'''+'''[Left Ctrl]''') 
 
'''[Ctrl-A]''' toggle auto-grayout of non-extended sectors 
'''[Ctrl-J]''' TROR-join sectors. The selection must consist of the two sets of sectors you wish to join. 
'''[Ctrl-U]''' Clear extension: delete the bunch (i.e. ceiling-floor connection) of the aimed-at sector's floor 
'''[PGUP]'''/'''[PGDN]''' Change 'player' height in discrete steps in order to go through the different levels 
'''[Ctrl-tab]''' Display one currently aimed at sector (of potentially many that lie under the mouse crosshair) 
'''[HOME]''' and '''[END]''' as modifiers to AltGr: select all sectors whose floor's/ceiling's bunchnum equal the bunchnum of the aimed at sector (useful for further operations on whole bunches)

===3D mode===
'''I''' invisibility preview: toggle fake ROR texture on non-masked portals 
'''LENTER+CTRL''' When aiming at an extended floor/ceiling, paste to all floors/ceilings of the bunch of the aimed at one 
'''T''', '''B''' and '''H''' work as with walls, though they set/toggle the bits only on '''one''' side 

===Advanced Highlighting===
Not really specific to TROR, but having greater control over which or how many sectors you can highlight makes doing extensions in TROR much easier. Make sure you're familiar with [http://wiki.eduke32.com/wiki/Level_editing#Copying_and_Pasting_Sectors advanced sector highlighting].

The information on the advanced features is outlined below:

You can highlight a second, third, and multiple sectors by holding down '''[']''' as you drag the selection box over them. This way you can highlight sectors in different parts of the map. Likewise, use the '''[;]''' key to deselect sectors. A small plus or minus will appear next to the cursor depending on which button you're holding.

You can select individual sectors with the mouse by moving the cursor inside the sector you want, holding '''[RIGHT ALT]''', and holding '''[RIGHT CTRL]''' as you release '''[RIGHT ALT]'''. The sector is now highlighted. This method of selection also works with '''[']''' and '''[;]''' to select/deselect additional sectors by mouse. Simply hold '''[RIGHT ALT]''' and the appropriate button depending on what you want to do, then hold '''[RIGHT CTRL]''' while releasing the other buttons. This becomes very quick and easy to do after doing it a few times.

==TROR Mapping Examples==

===Manhole Sewer Example===

In this straightforward example, you're going to make a manhole that goes below a street, and some area around the end of the hole at the bottom.

1. Create the child sector where you want the manhole to be.

2. Highlight the sector with '''[Right-Alt]'''.

3. Press '''[Ctrl-E]'''. Mapster will prompt you whether you want to extend up or down.

4. We want to extend down so press '''[Z]''' ('''[A]''' if you're extending up).

5. Go into side view mode with '''[F3]''', and move the viewpoint down until you're editing the bottom layer.

6. The child sector you created should now have a white boundary, with the street sectors above either greyed out or gone depending on your settings.

7. Now you can treat the manhole sector (the extension) as the very first room you've made on a new map. You can draw sectors on the side of it to attach some rooms there. If you go into 3D mode, you should be able to see that if you go down that manhole, there should now be some area at the bottom which overlaps the street. This was not previously possible without using some kind of cheap trick. Congratulations, you've just made TROR.

===Two Story Building Example===

I'm sure that a big reason that people want to use TROR is to build multiple story buildings, and this is how you do it.

1. Design the first floor of your building, both inside and out. This is going to be the first layer, which means the ceiling of every sector, especially the outdoor sectors should not be any higher than the roof of the first floor. Pretend that the second floor doesn't even exist.

2. Make your windows, doors, and anything you want.

Highlight with '''[Right-Alt]''' all of the ''outdoor'' sectors (the outdoor sectors should all have the same ceiling height, and should not be parallaxed). Knowing your advanced highlighting will come in useful here to select all the sectors.

3. Extend the highlighted area up, and make the top layer the active editing layer.

4. You should notice that the outline of your house has become completely white, and the area inside the house is empty. This is because this area is the second floor of your house.

5. Make a sector inside the house outline, this will be the room on the second floor of your house. Draw small sectors between that room and the house outline to create second floor windows. Alternatively you could just press '''[Ctrl-S]''' inside the house sector to make it a regular child sector, and if you go into 3D mode, you'll see your house has a roof you can stand on top of.

6. You can connect the ground floor to the second floor the same way you'd connect two sector-over-sector sectors; by having a staircase or lift that connects to a different area on the top floor than it does on the bottom (because a lift for example cannot directly cross TROR layers, therefore it must be connected to sectors which do not overlap; i.e have the entrance on one side and the exit on the other.)
Or you can connect the ground floor and second floor via TROR and have some sprite stairs or something.

===Retro-fitting via Joining Example===

If you're absolutely clueless with the whole idea of extending, or you want to go back and retrofit some TROR into maps you've done in the past, there's a very easy way of joining them to form TROR.
If you have two sectors that have the same shape, area, and external vertices have the same relative positions (essentially they're the same sector, at least as far as their edges are concerned), then all you have to do is highlight both sectors with '''[Right-Alt]''', and press '''[Ctrl-J]''' to join, the same as joining two sectors normally. It will then prompt you with a few questions such as which sector you want to have on top of the other, which sector(s) you want to move (doesn't matter most of the time), and whether you'd like to move all the connected non-TROR sectors as well (definitely yes).

The good thing about this method is that besides the questions you have to answer, mapster does everything automatically, it even moves the heights for you. Now there'll be a quick example of this method below.

1. Make a child sector in a larger sector and copy-paste it into void space.

2. Give the floor of the original child sector and the ceiling of the new sector the water texture.

3. Highlight both the child sector and new sector with '''[Right-Alt]'''.

4. Press '''[Ctrl-J]''' and answer the simple questions.

5. You should end up with a TROR water sector just as you would via the extension method. You can now alter the transparency of the water to your preference.

===Sandwiching and Sector Punching===
It's possible and easy to create a new TROR layer between two TROR layers. All you have to do is highlight one of them, and extend it as you would normally, and it automatically adds a new layer in the middle.

It's also possible to easily create an island sector in the middle of a TROR sector. This is called ''sector punching'', and mainly involves stamping a child sector into the sector below or above. Follow the example below.

1. Extend a sector downwards.

2. Create a child sector in the original sector.

3. Select the vertices of the child sector with '''[Right-Shift]''' or '''[R-Ctrl + R-Shift]''' and press '''[Ctrl-E]''' as though you're extending a sector.

4. It will prompt you whether to punch up or down, in this case, choose down and hit '''[Enter]'''. A sector identical in size, shape and position should now be in the bottom layer.

5. Point the mouse cursor at the child sector in the top layer and press '''[Ctrl-U]'''. It will prompt you whether you want to break the connection, and unless you press [Ctrl-U] accidentally, you usually do.

6. The child sector should now be a floating sector island. Have fun.

Note that '''[Ctrl-U]''' only breaks the connection of a single sector if that sector has been punched. Otherwise it'll break the connection of the entire bunch, which is usually bad.

==Visual Glitches and Workarounds==

===Software renderer===
Even though TROR sectors are already physically overlapping, the 8-bit software renderer still needs to render them separately, having to do an extra rendering pass for each additional TROR extension in view. Theoretically if you create a huge amount of extensions in the same area the framerate could potentially drop to unplayable levels, however this is far fetched and I wouldn't worry about it.

The real problem with the software renderer is HOM glitching. In each rendering pass, there can only be one area along the x-interval drawn. For example, if you have an island on the ground, the area between you and the island will be fine, but everything on the other side of the island will show HOM. Try it out yourself to see what I mean. Technically this means that TROR extensions cannot contain islands (although it's been kind of hacked in to do exta-extra passes to overcome this problem, I wouldn't rely on them for perfect drawing.)

However, this can be overcome by breaking up the sector surrounding the child sector, and extending each sector individually. This means there will be multiple drawing portals around the island instead of one big one, and none of the individual extensions would contain the island, hence it should draw fine.

This HOM doesn't just occur due to islands, it can also happen when part of a normal sector is jutting out into a TROR sector, this can be thought of here as a mini-island even though it's connected to something. Don't call it a mini-island, I only called it that to explain why it would cause that glitching. This means that TROR extensions should be ''convex'', i.e if you draw a straight line through a TROR portal so that it leaves the sector, and then comes back, it is not convex (and is most likely due to something jutting out.) However if you draw a line through it and this does not happen, as is the case for a circle, square etc.. then it is convex, and should draw fine.

===Polymer renderer===
Masked floors and ceilings in polymer are always the last thing drawn on the screen. That means if you have a transparent surface such as a masked wall or sprite, it would cause everything all the TROR masked surfaces behind the transparent surface to stop being drawn and become invisible. There's no real work around for this, just try not to use masked walls or sprites with big transparent surfaces around TROR masked surfaces.

Other than that, polymer is by far the most stable renderer for TROR, and apart from what's written above, is 100% glitch free. Despite being slow sometimes, it is the renderer of choice for TROR. It works by drawing the entire scene, TROR and all in a single rendering pass. This means that it doesn't require any additional computer power to draw TROR, hence TROR will not affect the framerate in polymer.

===Polymost renderer===
The polymost renderer is bad, M'kay? It's like a comic relief in bad Hollywood films who can't do anything right. Don't use it.

==Random Trivia==
Extended sectors can be sloped, but the bunch has to be 1:1 in that case. I.e you can't have any child sectors within a sloped TROR sector. If you want different TROR sectors with different slopes, you must use completely different extensions for that, as opposed to breaking up a single extension.

Maps containing one or more TROR bunches are saved in a new map format (v9) since some fields had to be taken over: xrepeat is unavailable on TROR'ed floors and ceilings, and on walls it's lotag if the ceiling, and extra if the floor of the wall's sector is extended. When in-game, these get transferred to internal arrays though.

The system is supposed to be used for 'large-scale' RoR, as a rule of thumb each affected sector should be at least a Duke high [that's too strict though].

[[Category:Level editing documentation]]

True Room Over Room Mapping Guide

2012-04-15T04:04:44Z

Micky C: /* 2D mode */

True Room Over Room Mapping Guide

2012-04-15T04:03:30Z

Micky C: /* 2D mode */

True Room Over Room Mapping Guide

2012-04-15T04:00:44Z

Micky C: /* Invisible surfaces viewing mode */

True Room Over Room Mapping Guide

2012-04-15T04:00:10Z

Micky C: /* Polymer renderer */

True Room Over Room Mapping Guide

2012-04-06T03:54:34Z

Micky C: /* Random Trivia */

True Room Over Room Mapping Guide

2012-04-06T00:58:20Z

Micky C: /* Advanced Highlighting */

True Room Over Room Mapping Guide

2012-04-06T00:57:56Z

Micky C:

True Room Over Room Mapping Guide

2012-04-06T00:55:01Z

Micky C: /* TROR related keys */

True Room Over Room Mapping Guide

2012-04-06T00:44:42Z

Micky C:

True Room Over Room Mapping Guide

2012-04-06T00:31:57Z

Micky C: /* Random Trivia */

True Room Over Room Mapping Guide

2012-04-06T00:30:48Z

Micky C:

True Room Over Room Mapping Guide

2012-04-06T00:26:27Z

Micky C: /* Retro-fitting via Joining Example */

True Room Over Room Mapping Guide

2012-04-06T00:26:08Z

Micky C:

True Room Over Room Mapping Guide

2012-04-06T00:25:34Z

Micky C:

True Room Over Room Mapping Guide

2012-04-06T00:13:39Z

Micky C:

True Room Over Room Mapping Guide

2012-04-05T23:41:04Z

Micky C: /* Properties and Terminology */

True Room Over Room Mapping Guide

2012-04-05T23:39:44Z

Micky C: /* Properties and Terminology */

True Room Over Room Mapping Guide

2012-04-05T09:23:27Z

Micky C:

True Room Over Room Mapping Guide

2012-04-05T06:39:40Z

Micky C:

True Room Over Room Mapping Guide

2012-04-05T06:21:42Z

Micky C:

True Room Over Room Mapping Guide

2012-04-05T05:59:04Z

Micky C: