View source for Func door rotating

{{lang|Func door rotating}}
{{toc-right}}
{{base brush|func_door_rotating}} It is a rotating brush that can be "opened" by players or NPCs.

{{note|This entity exists to handle unusual shapes and sizes of doors. For everyday doors, use {{ent|prop_door_rotating}}.}}

{{code class|CRotDoor|doors.cpp}}

==Notes==
===Axis===
[[File:Hammer Axis visual guide.png|thumb|300px|A visual guide showing the axis in each viewport (Click to enlarge)]]
The func_door_rotating entity can only rotate around either the x, y or z axis and no combination of the two other than x and y. By default, the entity is set to rotate on the Z-axis and can be changed through altering the flags section of the object properties.

{{tip|The axis can be changed to a different one by changing the '''Pitch Yaw Roll''' keyvalue to set the door to a preferred rotation (result is only visible in-game). This does not work inside [[instances]].}}

===Setting the Origin===
The point of rotation can be changed through the alteration of the entities origin. The origin sets which point on the plane of movement the object will rotate through, think of it as a hinge for a door. With the ''show helpers'' option enabled in Hammer, the origin will appear as a small white circle in the center of the entity that can be dragged to a new location.{{clr}}

====Example====
{| class=standard-table
|-
| Here in the 3D view we have a brush we selected, '''1''', that is tied to the <code>func_door_rotating</code> entity.  We want it to rotate downward to land in position '''2''', bridging the gap between the two ledges.  To do this we need to alter the door's origin to sit at point '''3'''.||[[Image:Door_rotate_1.jpg]]
|-
| First thing to do is to find the axis we want the brush to rotate on.  A good way to do this is to look through the grid views and find the view which shows exactly where we want to place the origin.  Once found, drag the cursor to the upper left hand side of the view port to reveal which view port it is, '''1'''.  This view only shows two of the three axes, the missing one is the one we want, which in this case would be the '''Y''' axis.  Go to the flag section of the door's object properties, and check the <code>Y Axis</code> box.  The other thing to keep in mind is by default, a <code>func_door_rotating</code> moves clockwise around the point of rotation in the 2D view, we want it to move the other way, so we also need to check the <code>Reverse Dir</code> box as well in the flags tab of the object properties. Now move the cursor over the door's origin, '''2'''.||[[Image:Door_rotate_2.jpg]]

|-
| We want to rotate around the bottom right corner or the door, '''A''', so we need to drag the origin there.  When the mouse is over the origin it should change into a plus sign ('''B''') meaning it is ready to be moved, click on it and drag in down to point '''A''', you should notice a red dotted line that follows it as you move it. Once the origin is in point '''A''' we're done setting the origin. Now when the door is opened, it should rotate around point '''A'''.||[[Image:Door_rotate_3.jpg]]
|- 
|}

==Bugs==
*Sometimes there are situations when for unknown reason lighting just doesn't show correctly on door model and all is "black" and you can't do anything with it (move brushes around the door to avoid clipping, check material model shader of it (it's fine), disable shadows, etc). There is a simple and effective way to fix it: just select all your level and <b>move it</b>! [[Vrad]] sometimes can make mistakes like this on static and dynamic objects and when you adjust position of your whole level, it will change this calculations and coordinates for lighting.

==Keyvalues==
{{KV|Distance (distance)|float|Degrees the door should rotate. It will rotate away from the player if {{ent|+use}}d. Otherwise, direction is determined by if the value is negative or positive.}}
{{KV|Solid Type (solidbsp)|choices|How to calculate collisions. Set this to BSP if the player seems to rotate oddly relative to the surface.
:*0: [[VPhysics]]
:*1: BSP ([[QPhysics]])}}
{{KV Door}}
{{KV visiblebrush|l4d=1}}
{{KV BaseEntity|brush=1}}

==Flags==
*2: Reverse Dir - This door opens in the opposite direction.
*16: One-way - This door only opens in one direction.
*64: X Axis - This door rotates on the X axis.
*128: Y Axis - This door rotates on the Y axis.
{{Fl Door}}

==Inputs==
{{I Door}}
{{I visiblebrush|portal2=1}}
{{I BaseEntity}}

==Outputs==
{{O Door}}
{{O BaseEntity|l4d=1}}

==See Also==
*{{ent|func_rotating}}
*{{ent|func_door}} (sliding instead of rotating)
*[[Door creation]]
*[[WiseDoor]] - example use and illustration of doors.