View source for Patches

==Introduction==

A patch:

* is a two dimensional sheet with only one visible surface. It can be bent, curved and twisted in three dimensions but always remains a sheet. It produces better curves and textures better on them than multiple brushes.
* can also be a cylinder, great for pipes, bars, logs, ect... or it can be a cone good for tree branches.
* is a primitive - a child of the worldspawn entity. This means it is a direct offshoot of the game world and inherits any properties applied to the worldspawn. If you select a brush and look in the Entity Inspector you will see the worldspawn properties. 
* may be parented to another entity when it will inherit its properties.
* will not seal against the void.
* is suitable for decals - textures such as stains to be placed over other surfaces.

==Round and Softened Corners: Bevels==

[[Image:bevel01.jpg|right|140px]]

''written by Fidcal''

No matter how beautiful the texturing, a mathematically-sharp convex corner is likely to spoil it.

These can be rounded off nicely using a patch bevel. The same method can of course be used to produce larger rounded corners.

{{clear}}

<div style="float:right">[[Image:bevel02.jpg|160px]]   [[Image:bevel03.jpg|160px|top]]</div>
* Select the brush that forms the corner.
* Zoom in and set the grid to about 4 or 8. How rounded you want the corner will depend on the texture and other things. I crisp new brick wall might be better with a small rounded corner whereas old round stone blocks will take a larger curve. You can of course, use this method for very large curves where they are an architectural feature not merely a softening of a sharp edge.
* Press {{key-ctrl}}+{{key|name=X}} for ''Clipper'' or select [[Image:DRclipper.jpg]] on the left toolbar
{{clear}}
* Click the two diagonals in order 0 then 1 as shown in the diagram so that the corner is to the right if 0 was 12 on a clock and 1 is 6.

[[Image:bevel04.jpg|center|200px]]

* {{key-shift}}+{{key-enter}} to split off the corner without deleting it
* {{key-esc}} to deselect then exclusively select the corner triangle. This might be easier in camera view.

[[Image:bevel05.jpg|center|200px]]

* Bevels are always created with their curve in the horizontal plane which is what we want here for a vertical corner (if you need a different orientation you have to rotate it after creation.)
* Select {{menu|l1=Patch|l2=Bevel}}
* If the bevel is facing the wrong way (in top view) then rotate it, grid snap if necessary to as shown in the image below. The bevel might not have the same number of faces as in the diagram. Don't worry. We set that separately anyway.

[[Image:bevel06.jpg|center|200px]]

* Delete the original brush corner triangle that was the template for this bevel.
* Reselect the bevel patch.
* Press {{key-shift}}+{{key|name=S}} for patch inspector
* Click the check box 'Fixed Subdivision' else Doom might change the quality when optimising.
* In the 'Horizontal' input just below that in '''Patch Inspector''' set the value to 3 or 4. The higher the value the lower the game performance and beyond a certain value you cannot tell any difference so don't be tempted to go high. It's a matter of experience, judgement, how big the curve is, and the type of texture.

<center>[[Image:bevel07.jpg]]   [[Image:bevel08.jpg]]  [[Image:bevel09.jpg]]</center>

* Close the '''Patch Inspector''' and use {{key-esc}} to deselect the bevel
* Use {{key-ctrl}}+{{key-shift}}+{{LMB}} to select only the surface of the brush wall to one side of the bevel. Use a side where you do not want to have to re-align the texture on that wall, eg, there is a window further along and it might be awkward. This is because later, the wall texture on the OTHER side of the bevel may have to be realigned to the bevel.
* Use {{menu|l1=Edit|l2=Copy Shader}} or the key/mouse shortcut
* Press {{key-esc}} to deselect and select the bevel again
* Use {{menu|l1=Edit|l2=Paste Shader (Natural)}} or the shortcut. Do NOT use the normal paste - nor normal paste followed by ''Natural'' in the '''Surface Inspector'''.
* The texture on the bevel should be aligned to that wall.
* Check texture alignment on the wall on the other side of the bevel and shift it in '''Surface Inspector''' as needed.

[[Image:bevel10.jpg|right|400px]]
Hopefully that should now look far better:
{{clear}}

== Cylinders and Cones ==
''by Baddcog''

To create a cylindrical patch:
* drag out a brush an ortho view. The cylinder will be created in the plane of the ortho view you created the brush in. If you used the top view you will end up with a cylinder standing upright.
* with the brush selected choose the ''patch'' menu
* '''cylinder''' will give you a nice and round cylinder with one set of rows (lenghtwise). It will be the size of the brush you had selected.

'More cylinders' gives you more options: '''dense cylinder'''; a cylinder with 2 rows, '''very dense cylinder'''; a cylinder with 3 rows, '''square cylinder'''; a four sided cylinder. All patches are rendered smooth, so you can use a square cylinder and it will still have an almost round look to it in game as opposed to a square brush that will render flat and very square.
The more dense of a cylinder you use the more you can bend it into a tight angle.

[[Image:patch_tut_08.jpg]]
*deleted the brush you used to create the cylinder, you will notice that it has no ends and looks pretty bad. To fix this we'll need to create an ''end cap'', see below.
[[Image:patch_tut_09.jpg]]

Hit the ''v'' and you'll see the verts of the cylinder, these can be dragged around to create shapes, bends. Hit v again to toggle the vert edit mode off, or hit escape twice. In this picture I used a very dense cylinder and dragged the verts to make a bend, it's very rough but there are already alot of Doom3 tuts out there that go into detail about how to bend a cylinder. 

[[Image:patch_tut_11.jpg]]

Creating a cone is the same process but you will choose'' cone'' from the patch menu.

== End Caps ==
''by Baddcog''

End caps are useful for sealing off the end of a cylinder patch. The patch is created like a piece of paper wrapped around in a circle leaving two open ends.

To create an end cap:
* select the cylinder patch you just made
* choose patch menu '''cap selection''' {{Shift}}+{{C}} and choose ''cylinder''.

[[Image:Patch_tut_05.jpg]]

If you did everything correctly you will have a round cap at each end of your cylinder. You can only see these caps if you are looking at them as they only have tex on one side. If your cylinder was setting on the floor you will have to fly down below it and look up.

[[Image:Patch_tut_10.jpg]]

You can bend a patch, then cap it and the caps will be in the correct places. You can also select a cap and a cylinder at the same time, hit {{V}} and drag verts of both patches together to keep their shapes aligned.

You also notice that in the caps menu there are other shapes of end caps, these can be good to fill in archways.

== Archways ==
''by Baddcog''

Patches are great for smooth arches, much smoother than can be created with brushes. You  can also create the opposite of an archway using the same steps, this could be useful for creating a covered wagons top.

To create an archway:
* create a doorway or hallway with terrain brushes, you can use caulk on the ceiling as those polys won't be seen and this way they won't be rendered either.
[[Image:Patch_tut_01.jpg]]
* create a brush in the doorway you want an arch in, make it the size you want the arch, so approximately the size of the curves at the top of the doorway.
* out of the patch menu select '''end cap''', end caps are not only round cylinder caps, in this case we will get the inside of the archway. Most likely it will have to be rotated/resized to fit the area you want it in.
Again, patches only have tex on one side so if you don't see it in 3d it doesn't mean it isn't there. Look in the ortho views when you create it. Delete the brush you used to create the end cap patch.

[[Image:Patch_tut_02.jpg]] [[Image:Patch_tut_03.jpg]]

Sometimes the texture ends up on the wrong side, so it would be facing the ceiling and the player couldn't see it. To fix it:
* select the patch
* patch menu: Matrix: '''Invert''' {{Ctrl}}+{{I}}
[[Image:Patch_tut_04.jpg]]

Now you've got a doorway or a hallway and an arched ceiling to it, but the ends of it are open and it looks like the ceiling is just paper. We need to cap the end so it looks solid.

* select the arch patch you just created.
* patch menu: '''cap selection''' {{Shift}}+{{C}}
* choose ''inverted end cap'' 
[[Image:Patch_tut_05.jpg]]

As you can see from the icon (the blue is what you get) you will get caps on each side of the arch that fill in the corners. Like the cylinder cap this will give you a cap on each end, so if you only needed one you'll have to delete the spare. Maybe you made an alcove and the back side of the arch is against a wall.

[[Image:Patch_tut_06.jpg]]

You can see that the inc=verted end cap has a pretty ugly looking texture alignment, this needs fixed.
To align the textures with the surrounding bricks:
* {{Shift}}+{{Ctrl}}+{{LMB}} click on the wall next to the arch.
* Edit menu: copy shader
* Select the end cap(s)
* Edit menu: paste shader
(I think the shortcut for this is {{Shift}}+{{Ctrl}}+{{MMB}}

[[Image:Patch_tut_07.jpg]]

I failed to align the texture properly on the left wall due to a pizza break during the tut, forgive my slacker ways, however I did get the end cap properly textured and aligned to the wall on the right. (I should've aligned the textures top, left and right before doing the end cap).
Do the same with one of the inside walls and the inside of the arch. Aligning this inside curve with the outside curve is probably impossible, in that case you'll probably want to create another stone trim arch for the end. This is up to you, do you want to build a decent level fast or do you want to create the mother of all beautiful levels? You aren't getting paid, how much free time do you have?

==Trim Arches==

OK, you've decided that you do have more time and want your arches to look better than a simple cap like above. Instead you want a realistic arch with stones across the top. This effect can easily be achieved by using patches and a little bit of texture alignment.

* Select the ''end cap patch'' that creates the inside of the archway, the one the player will look up at inside the hall or doorway.
[[Image:Archway_01.jpg]]
* The tetxure used there is obviously a terrible choice for a stable archway so pick something that is made up of large square stones and apply it to the patch. Then drag the patch out so it is wider than the doorway. This will make the bricks wider than the doorway giving more depth and also avoiding any z-fighting issues with the wall. Now use the texture alignment tools to fit the bricks onto that patch nicely. I prefer to work with very small increments in the horizontal and vertical scaling and alignment sliders. 
* With the patch selected go to the patch menu and select '''Thicken Patch'''. Use the setting shown. '''16''' will make the new patch 16 units thick, approximately a foot.
[[Image:Thicken_Patches.jpg]] [[Image:Patch_Thicken.jpg]]
* Now you will have a complete stone arch. It's easiest to drag all the patches away from the wall and into an open area so you can easily see and align the textures. Also you will notice there are 2 patches at the bottom of the arch, these will most likely end up inside your wall so they can be deleted.
[[Image:Archway_02.jpg]]
* There is a problem with this arch, this happened because I made a very flat topped arch. Patches will ''optimize'' themselves and because the arch was fairly ''flat'' it doesn't have enough shape to match the outside of the arch. The cure for this is to make the arch rounder in shape. So with all the arch patches selected (don't forget both sides, top and bottom) resize it height-wise until you see the patch sub-divide so it has the same amount of sections as the outside.
[[Image:Archway_03.jpg]]
* This creates another issue, the patches no longer align properly. Hit {{V}} to enter vertex edit mode and adjust the verts so the patches match up or come very close to matching. If you can't get an exact match it is alright, just hit {{Ctrl}} + {{G}} to grid snap the verts. This should snap them altogether, if not try a different grid size.

[[Image:Archway_04.jpg]]
* Your patches now align cleanly and make a nice archway, now spend a little time aligning the textures on each side of the arch. You will have ''holes'' at the bottom of the arch so add a few blocks at the bottom of it to support it and give it a little extra realism.
* I like to select all the patches and the two blocks under the arch, right-click in an ortho view and convert them to a func_static. This will keep the arch from divinding the surrounding terrain into more triangles, make it easier to move by itself and clone for other doorways. You can also add ''NoShadows 1'' to it if you are trying to drop framerate in that area, this may or may not be good depending on how lights in the area hit the archway.

==Other References==

General patches tutorial:  http://www.modwiki.net/wiki/Patch

{{tutorial-editing}}