Thief 2 - Wooden filing cabinets
--------------------------------
This archive contains models for two and three drawer filing cabinets 
for Thief 2. The drawers in the objects are jointed, so it is possible 
to make them open when frobbed, and if the instructions provided are
followed it is easy to lock them.


Contents
--------

This archive should contain the following files:

readme.txt                  - this file
filecabs.jpg                - picture of the cabinets
obj/fcab2.bin               - Two drawer filing cabinet
    fcab3.bin               - Three drawer filing cabinet
    txt16/
src/fcab2.lwo               - Two drawer cabinet lightwave model
    fcab2.e                 - Two drawer cabinet edited .e file
    fcab3.lwo               - Three drawer cabinet lightwave model
    fcab3.e                 - Three drawer cabinet edited .e file
    
The contents of the src folder are not required to use these objects,
if you are not interested in the source objects, ignore the src 
directory. 

Installing
----------

Unpack the archive somewhere, copy the obj directory into your 
Thief2 directory. In theory, nothing should be overwritten
if there is a name clash, contact me at the addess below!

Now start dromed. To use the object you'll have to modify your 
gamesys:

 1. Open the Object Hierarchy (Editors menu)
 2. Select physical -> Container
 3. Click Add
       New Object Name: FilingCab2
       Click OK
 4. Select FilingCab2
 5. Click Edit
 6. Add Shape -> Model Name
       Model name: fcab2
       Click OK
 7. Add Tweq -> JointsState
       Click OK
 8. Add Tweq -> Joints
       Halt: Stop Tweq
       AnimC: Sim
       MiscC: [none]
       CurveC: [none]
       Primary Joint: 2
       Joint1AnimC: [none]
       Joint1CurveC: [none]
       rate-low-high: X: 0 Y: 0 Z: 0
       Joint2AnimC: Sim
       Joint2CurveC: [none]
       rate-low-high: X: 0.3 Y: 0 Z: 2
       Click OK
 9. Add Object System -> Immobile
       Tick the checkbox
       Click OK
10. Click Done
11. Select physical -> Container -> FilingCab2
12. Click Add
       New Object Name: FilingCab3
       Click OK
13. Select FilingCab3
14. Click Edit
15. Add Shape -> Model Name
       Model Name: fcab3
       Click OK
16. Click Done
17. Click Close

Now save your gamesys (don't overwrite dark.mis!). If you were not 
using a custom gamesys before, remember to use set_gamesys and save 
your .mis

When you add a FilingCab2 or 3 to your map, it will initially be
set to open the bottom drawer when frobbed. If you want to have
the top drawer of a FilingCab2, or the middle drawer of a FilingCab3,
open instead, you should:

edit the properties for the object in your level
add Tweq -> Joints
change Primary Joint to 3
remove Sim from Joint2AnimC
add Sim to Joint3AnimC
Copy the X,Y,Z values from rate-low-high2 to rate-low-high3

If you want the top drawer of a FilingCab3 to open, follow the 
directions above, but use Primary Joint 4, set Joint4AnimC rather
than Joint3AnimC, and set rate-low-high4 rather than 3.

If you want a cabinet to be locked, just treat it like any other
lockable container. There is no visual indication of lock state in 
these versions of the objects.


Known Bugs
----------

Not exactly a bug, but undesirable anyway: at present it is only 
possible to open one drawer per concrete object in response to a
frob. Dark does not provide any facilities to selectively frob
jointed subobjects, so there is no way to select any arbitrary
drawer to open in-game. The "easy" way around this would be to 
replace the 'compond' filing cabinet object with one object
for the cabinet housing, and one object for each drawer. 
Unfortunately, this does mean using three or four objects in 
the place of one, and involves very careful alignment by the 
editor. 

For the moment, I'm going with the current versions, and I 
may come back to deal with the multiple drawers issue at some
later date.


Contact Information
-------------------

Author: Chris <chris@starforge.co.uk>
The Watcher on the ttlg forums.

Email or PM me if you have problems, want an enhancement or find this 
useful :)


Legal Blurb
-----------

This object and any included original graphics are copyright (c) 2008 
Chris Page and released under the Creative Commons Attribution-ShareAlike
License. To view a copy of this license, visit 

http://creativecommons.org/licenses/by-sa/1.0/ 

or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, 
California 94305, USA.

Essentially this means you can do what you want with it as long as you
include credit and don't try to prevent anyone else from using it or
any derivative of it.
