ENEDIT_I.KXP

Installation

Just unzip the files in the 3ds Studio process directory with the -d param.  
Note the files that must be in the process directory are ENEDIT_I.KXP 
and TEMPLATE.ENV.  


ENV.TXT and TUTOR.TXT are sample scripts.



Basics

Enedit is a KXP that allows you to take a text file that consists 
of node points and convert it into .env envelope file that can be 
read in by LenZFX.  It is designed to assist in creating LenZFX 
enevelopes that are large and have repeating data that are hard 
to create using the LenZFX envelope editor.

Basically ENEDIT_I.KXP takes a text script which consist of 
nodes, marker, and loops and converts it to a LenZFX env 
format.  The basic script structure is as follows.

node  FRAME_NUMBER VALUE
repeat COUNT
marker

node FRAME_NUMBER  VALUE is a basic node entry for an 
envelope.  It consist of the keyword node followed by a frame 
number and then the y value

repeat COUNT is a basic loop structure that loops the above 
nodes COUNT times.

marker keyword is used to mark groups of nodes to be repeated.

Tutor

Basic work flow is to create a text file script which list nodes, 
load up the ENEDIT_I.KXP and pick the text file and hit OK.  
The endit KXP then creates an ENV file with the same name as 
the text file but with the .env extension in the same directory as 
the text file.  Then load up LenZFX and  load up any the 
modules and then load the newly created envelope file.  NOTE 
the first time you load up an envelope you must exit the 
envelope editor then reload the envelope editor to see the 
envelope correctly.  This due to the fact that I had to hack the 
env structure and am still unsure about some of the fields.

Load the TUTOR.TXT file in the text editor.  It should look as 
follows.

node 0.0 0.0       <-------------|
node 2.0 10.0                    |       
node 6.0 10.0                    |-- these nodes are repeated 5 more 
node 8.0 0.0                     |   times realative to last frame of 
node 16.0 0.0     <------------- |   the first group
repeat 5
node 100.0 0.0
node 120.0 50.0
marker
node 140,0 50.0 <_---------|
node 150.0 100.0           |     - this group is repeated 5 more times
node 160.0 0.0  <----------|
repeat 5

Exit out of the keyframer and load the ENEDIT_I.KXP and 
pick the TUTOR.TXT file.  Hit OK and then  load of the video 
post and add a LenZFX entry and enter the LenZFX setup.  
Select the Aura  module and click on the Envelope button next 
to the size slider.   This will bring you into the envelope editor, 
click on the Load Envelope button and choose the TUTOR.ENV 
that you created.  The initial graph display needs to updated 
which can be done by clickuing on the USE ENVELOPE button 
and exiting the editor.  Then clicking on the same Envelope 
button that used the first time twice to get you back in the 
envelope editor.  You now have the correct view of the 
envelope.



Bugs

Currently this IPAS routine only works if your 3ds studio 
process path is C::\3DS4\PROCESS.  Also beware of strange 
scripts where the nodes are out of order  example:

node 10 20
node 5 20

unpredictable results will occur..

Legalities
-----------

This program is Copyrighted (C) 1995 by Spectral Imaging
All rights reserved. This software is provided as is, 
without any warranty of any kind. 

Feel free to modify the files as you see fit.
The free distribution of this program is limited to:
  
  - Compuserve (R)
  
  - Any 'free download' section of any BBS, web, FTP, etc...

Any other kind of distribution (CD-ROM, floppy disk, etc..) 
is illegal without a written agreement from Spectral Imaging. 

All comments and questions can be directed to

Spectral Imaging
Attn: Peter Watje

interent - peterw@blarg.net
compuserve - 74453,225

