First of all, I am assuming that you are familiar with UMS in it's pre-1.6 state. If not, I would recommend that you use the tutorials on www.unframed.org/ums/ in conjunction with these instructions.

In 1.6, the classes are divided up into modules - this makes it a lot easier for people to either write their own add-ons for UMS, and also for me to be able to write extra bits and release them in chunks.

First of all, an overview of the packages:

UMS1_6.u ---------- The main package - all the main classes are in here. Director,
                    MovieInfo, SimplePoint and MoviePlayer are all in here. However,
                    that is about it. On it's own, all it can do is change level,
                    trigger another Director, and loop itself, which is pretty useless
                    on it's own. A new class in here is UMSModule - this is the base
                    class for all the add-on modules. I have included in the .zip a
                    file calles Module.txt which explains the inner working of the
                    module classes, and how to write your own modules.
                    There is one difference, in that, to trigger another Director,
                    the command is "Director DirectorName" instead of "Effect DirectorName"

UMSCamera.u ------- This contains all the camera classes - the only actual classes that
                    are in there are MovieCamera, and UMSCamera, which is the module
                    itself. The functions are all still there, and should all work the
                    same as they always have done.

UMSPawn.u --------- This class contains all the pawn-related stuff that was in UMS
                    before - including all the head animation classes, and MoviePawn
                    itself.

UMSAudio.u -------- I'm sure you're getting the idea now... This one only has MovieSound
                    in at the moment - this, in case you don't know, allows you to attatch
                    a sound to a pawn, so that it follows it around. Before the final
                    release, this package may have more stuff in it.

UMSCredits.u ------ This contains the credits system that is detailed in one of the
                    tutorials on the UMS website.

UMSEffects.u ------ This contains the blur effect, and a moving light which can follow an
                    actor.

UMSHud.u ---------- This has three slightly different HUD's in it. Firstly is the one that
                    was released with previous versions of UMS - Letterbox. Then, when I
                    discovered that the Letterbox HUD that we had wasn't actually widescreen
                    dimensions, I made another one - Anamorphic (that's the term used for how
                    they get the widescreen shape onto normal size film). Then there is also
                    a DialogueHUD which will allow text to be put on the HUD. I will probably
                    be modifying this package slightly before the final release to enable
                    textures to be placed on the HUD, and a couple of other things.

UMSSmoothCamera.u - This will enable you to have cameras which will accelerate and decelerate
                    at the beginning and end of each move. This facility was in the most recent
                    UMS release, but I wasn't happy with it at all, so I took it out of UMSCamera
                    and decided to make a new package out of it.



                                     What's yet to come
                                     ==================

I've got another few of packages in production at the moment - I'll just run through what they'll do:


UMSOggVorbis.u ---- If you haven't heard of Ogg Vorbis, I'll explain. Ogg Vorbis is a
                    sound compression, similar to mp3, but it's free. Someome I know
                    wrote an Ogg Vorbis tool for UT, and gave me permission to modify it
                    for UMS. This package will enable you to play .ogg files in your movie.
                    These can either be locally played (stuck to a point in the level) or
                    globally (you will be able to hear it wherever you are.
                    
                    The most exciting thing about this package will be the audio/video
                    synchronisation capabilities. It will include a new Director which can
                    keep perfectly in time with the music or sound. The only difference with
                    the current Director is that the new one won't take WaitTime's - you will
                    time it by putting in the timecode of the music that you want things to
                    happen at.
                    
                    This module is currently working, but I still have some modifications to make
                    to the UnrealScript code (as opposed to the C++ code) to make working with
                    it easier.
                    
                    Anyway, this is the most exciting, in my mind, of the new ones, but I ought
                    to get on with the rest.
                    
UMSSmoothPawn.u --- Basically, this is the same as UMSSmoothCamera, but for pawns. This could be
                    useful for cars, as there should be the ability to turn smooth corners, as
                    well as accelerate and decellerate smoothly.



                                     How to use it
                                     =============

Well, the basic useage of UMS 1.6 is the same as it always has been, but for a couple of points:

1. You need to tell the Director which modules to load up. This is done in the UMSModules array of the Director. There are four that are in there by default - UMSCamera, UMSPawn, UMSEffects and UMSHud although these can be removed if you don't feel you need them.

The scene must always start off with only one director, which can then call the other directors - this is the only one that needs to have all the modules listed (although do make sure you have all the modules that you'll need loaded at this point) Any additional modules listed in later Directors will be ignored.

