home *** CD-ROM | disk | FTP | other *** search
-
- ******************************************************************************
- * *
- * ReadMeBeforeYouUseThem *
- * *
- * Documentation For The AREXX Scripti Collection *
- * *
- * All Work Written And Copyrighted By: *
- * *
- * Jan Van Overbeke, 3-DEE, ©1993. *
- * *
- ******************************************************************************
- Release Date: 22/05/1993
-
- ------------------------------------------------------------------------------
- Copyrighted By Jan Van Overbeke, 3-DEE.
- ------------------------------------------------------------------------------
- All that is assembled to complete the AREXX-Scripti Collection, is written by
- Jan Van Overbeke, 3-DEE (with exception of item 5 and 6 below). Therefore,
- Jan Van Overbeke allows you to copy and distribute his work, on the following
- conditions:
-
- 1. When you sell this collection, or you sell it with any package, you have
- to get a written permission from me.
-
- 2. When distributing this collection, it must be assembled as described below.
- Nothing should be left out. If this is the case, you are distributing an
- illegal collection. Please don't.
-
- 3. You can edit anything that contains this collection. However, when
- distributing, you MUST do the UNEDITED collection. If you edit ANYTHING
- in the collection, it is no more distributable.
-
- 4. As it is freeware, this collection may be distributed without having to
- pay any contribution to the author. In fact, Jan Van Overbeke wants you
- to spread the word AND the disk!
-
- 5. The author strongly states that the PPMore2.0, its docs, the
- "install_libs", powerpacker.library and reqtools.labrary are copyrighted by
- Nico Francois, NOT by Jan Van Overbeke. Read his docs if you want to know
- about Nico's rights. Nico Francois gave permission to include these files.
-
- 6. Brush2Icon and its doc also are NOT copyrighted by Jan Van Overbeke. Sadly
- I don't know who should receive the credits for making this program. All I
- know it is free to the public, and I haven't found any rights about it.
- This program is included to successfully operate the "ImageIcon.rexx"
- script. This script needs a sort of Brush to Icon utility.
-
- Please stick to these Freeware rules!
- Thank you.
-
-
-
-
- ------------------------------------------------------------------------------
- AREXX Scripti Collection Contents
- ------------------------------------------------------------------------------
- Remember: when distributing, the collection must be assembled as described in
- this chapter. If not, it is an illegal collection.
-
- 1. Operation Scripts:
- - Remove.new.rexx
- - StartADPro.rexx
- - StopADPro.rexx
-
- 2. Composition Scripts:
- - Emboss.rexx
- - Foreground.rexx
- - Morph.rexx
-
- 3. General Scripts:
- - 24Bit->IFF.rexx
- - ImageIcon.rexx
- - ImageInfo.rexx
- - NegativeImage.rexx
- - SaveFormat.rexx
- - Scale.rexx
-
- 4. ColorCorrection Scripts:
- - Colors.rexx
- - ColorToGray.rexx
- - Dither.rexx
- - LockPalette.rexx
- - UnlockPalette.rexx
-
- 5. Renamer Scripts:
- - RenameToAnim.rexx
- - RenameToImagine
- - RenameToSculpt.rexx
-
- 6. Screenmodes Script:
- - Screenmode.rexx
- - Screenmode-codes text
-
- 7. This "ReadMeBeforeYouUseThem"-doc and its icon
-
- 8. The "InstallScripts"-script along with its icon. If you want this script
- to operate successfully, you should not change ANY name of ANY directory.
- If you changed some names, the script will have to be adjusted. In this
- case, you have the permission to edit this script and distribute the
- collection.
-
- 9. PPMore2.0, its icon, its doc+icon, powerpacker.library, reqtools.library,
- Install_scripts+icon are all copyrighted by Nico Francois.
-
- 10. Brush2Icon and its doc, not copyrighted by Jan Van Overbeke.
- InstallBrush2Icon-CLI-script, copyrighted by Jan Van Overbeke.
-
-
- ******************************************************************************
- * I assembled this collection in such a manner, so it is very easy to use. *
- * This is important for novices. I want to keep it that way. So please help. *
- ******************************************************************************
-
-
-
-
- ------------------------------------------------------------------------------
- A Little Note
- ------------------------------------------------------------------------------
- It is not my intention to help non-registered ADpro-users, if they don't have
- a manual. I want to make clear I just want to show how easy it is to process
- images with AREXX-ADPRO-DOPUS, and how powerfull it can be. And most of all,
- it shows how you to write your own, as you can see what you have to do when
- you're in a awkward situation. I also fell and got up.
-
- It will help people to create high quality images and animations.
-
- AREXX is difficult to get you started, but once away, you're going fast! The
- sky is the limit, believe me!
-
-
-
-
- ------------------------------------------------------------------------------
- Integration into Directory Opus (®INOVATRONICS)
- ------------------------------------------------------------------------------
- Suppose you have 250 images which will be part of a huge animation later. As
- a special effect, you want them all embossed. If you use the Shell, this will
- take 250 of these commands:
-
- rx rexx:Emboss.rexx <ImageX> COLOR 1 1
-
- With or without my scripts, it's quite a task!
-
- But DOpus (3.0 or higher) comes to the rescue! The point is that you put the
- images into a drawer, which you put on one of the DOpus' windows, select all
- images and click e.g. the "Emboss"-button. The onliest thing you have to do
- is sit back and watch or drink some coffee. Your question should be now:
- "How do I configure this button?". Configure this:
-
- AMIGADOS/EXECUTABLE
- rx rexx:<Script.rexx> {f} <arg1> <arg2> <arg3> <arg4> <arg5>
-
- CD Source
- Do All Files
- No Filename Quotes
- Output Window
- DOpus To Front
- Rescan Source
-
- Close Delay 2
-
- If you need any arguments, you could use your own defaults.
- When the scripts are explained, there's a guide for Shell as well as DOpus
- users, who get some default settings for their configuration.
-
-
-
-
- ------------------------------------------------------------------------------
- Overall Use Of Scripts Explained
- ------------------------------------------------------------------------------
- When you executed a script to process any image, and it performed flawlessly,
- the image won't be written over. There is a new image saved which has the same
- name as the original, but .new at the end.
-
- e.g.: rx rexx:Emboss.rexx ram:MyImage.IFF GRAY
-
- This will create a new image, called:
-
- ram:MYIMAGE.IFF.new
-
- I implied this to make sure wrong results won't replace the original image.
- As a result, you would need lots of disk space if you have lots of images.
-
- If you like the result, execute this command:
-
- rx rexx:Remove.new.rexx ram:MYIMAGE.IFF.new
-
- It will cause ram:MYIMAGE.IFF.new to be renamed as ram:MYIMAGE.IFF
-
- rx rexx:Remove.new.rexx ram:MYIMAGE.IFF.NEW.NEW.NEW.NEW.new
-
- Will rename it as ram:MYIMAGE.IFF
-
-
-
-
- ------------------------------------------------------------------------------
- Scripts Explained To Get You Started
- ------------------------------------------------------------------------------
- All scripts are designed to flawlessly process ANY image: gray images as well
- as 24Bit images. The scripts will even handle them in the required way. All
- IFF images will get a new palette, especially adjusted while processed. The
- following colors will get an appropriate DPaintIV palette:
-
- HAM8: 64 (<- Hope this is the right setting, because
- I'm a nonAGA user! (yes, I know, I should upgrade)
- <sigh> )
- HAM: 16
- 256: 256
- 128: 128
- 64: 64
- 32: 32
- 16: 16
- 8: 8
- 4: 4
- 2: 2
-
- --------------------
- 1. Operation Scripts:
- --------------------
-
- * Remove.new.rexx:
- Have a look at the chapter above.
-
- Useage DOpus (AMIGADOS):
- rx rexx:Remove.new.rexx {f}
-
- * StartADPro.rexx:
- No arguments at all needed!
- If you execute this one, it will attempt to run ADPro, put it in the
- back (so your DOpus or Shell comes back to front) and arrange some
- defaults like the Saver, Loader and Dither-Settings.
-
- Useage DOpus (AMIGADOS):
- rx rexx:StartADPro.rexx
-
- * StopADPro.rexx
- No arguments needed!
- Just quit ADPro.
-
- Useage DOPus (AMIGADOS):
- rx rexx:StopADPro.rexx
-
- ----------------------
- 2. Composition Scripts:
- ----------------------
-
- * Emboss.rexx:
- Useage:
- rx rexx:Emboss.rexx <name> <COLOR/GRAY> <OffX> <OffY>
-
- Example:
- rx rexx:Emboss.rexx ram:MyImage COLOR 2 1
- rx rexx:Emboss.rexx ram:MyImage GRAY 0 1
-
- Where:
- OffX: The offset in X-axis for the negative image
- default=1
- OffY: The offset in Y-axis for the negative image
- default=1
- This script will perform an Emboss technique on your images.If the
- 2nd argument says 'GRAY', the original image will be turned gray
- before embossing. If it says 'COLOR', it won't. See the difference
- with a multicolor-image for yourself.
-
- The Emboss Technique works this way:
- Overlay a (gray) image with its negative and put it onto a
- new one, with a little offset.
-
- Useage DOpus:
- rx rexx:Emboss.rexx {f} GRAY
- rx rexx:Emboss.rexx {f} COLOR
-
- * Foreground.rexx:
- Useage:
- rx rexx:Foreground.rexx <Backgr-name> <Foregr-name>
- <OffX> <OffY> <Mix> <ZeroRed> <ZeroBl> <ZeroGr>
-
- where:
- Backgr-Name: Filename of the background image.
- Foregr-Name: Filename of the foreground image. if the
- foreground is located in the same directory as
- the background, you don't have to write the
- path.
- OffX: Width offset, pixel amount of position
- of the foreground image.
- Default: 0
- OffY: Height offset, pixel amount of position
- of the foreground image.
- Default: 0
- Mix: Percentage of mixing (0%-100%).
- Default: 100
- ZeroRed: Red color value to see through.
- Default: 0
- ZeroBl: Blue color value.....
- Default: 0
- ZeroGr: Green color value.....
- Default: 0
-
- Example:
- rx rexx:Foreground.rexx ram:1.IFF 2.IFF 0 0 50 0 0 0
-
- This script will overlap any two images onto a new one.
- !!!!Warning!!!!
- The number of colors for the result is determined by the background!!!
- Make sure both images have the same amount of colors! Or at least the
- foreground less than the background!
-
- Example useage DOpus (AMIGADOS):
- rx rexx:Foeground.rexx {f} Foreground 0 0 100 0 0 0
-
- Provided that Foreground always is in your backgr-directory!
- You could create another button for that.
-
- * Morph.rexx:
- Useage:
- rx rexx:Morph.rexx <name> <enmorphname> <frames>
-
- Where:
- name: the filename you wish to morph FROM.
- endmorphname: the filename you wish to morph TO.
- If it is in the same directory as the FROM-image,
- you don't have to add the path.
- frames: amount of in-between-frames.
-
- This script will morph from the first argument to the second by any
- number of frames (other then 0!). It is a very simple morph, using
- the foreground's mix-controller. The number of colors of the result
- is determined by the endmorph-image!
-
- Example Useage DOpus (AMIGADOS):
- rx rexx:Morph.rexx {f} Endmorph
- {aEnter Amount Of In-Between-Frames:0}
-
- It will put up a requester, and the script will look in the
- source dir for the endmorph-image.
-
- ------------------
- 3. General Scripts:
- ------------------
-
- * 24Bit->IFF.rexx
- Useage:
- rx rexx:24Bit->IFF.rexx <name> <colors> <dither> <scaleX>
- <scaleY> <screenmode>
-
- Where:
- colors: HAM/HAM8/256/128/64/32/16/8/4/2
- dither: 0-6 (1= Floyd-Steinmann)
- scaleX: absolute scale-value
- scaleY: obsolute scale-value
- screenmode: see the screenmode-text for codes!
-
- This script will convert any, but epecially 24Bit, image to a standard
- Amiga IFF image. The arguments offer complete controll for the best
- result. The palette will also be optimal.
-
- Example useage DOpus (AMIGADOS):
- - AGA machines:
- rx rexx:24Bit->IFF.rexx {f} HAM8 0 640 512 7
-
- - nonAGA machines:
- rx rexx:24Bit->IFF.rexx {f} HAM 1 320 512 6
-
- * ImageIcon.rexx
- Useage:
- rx rexx:ImageIcon.rexx <name> <IconWidth> <IconHeight> <Dithr>
-
- Where:
- IconWidth: Icon width in pixels
- IconHeight: Icon height in pixels
- Dither: 0-6 (1= Floyd-Steinmann)
-
- This script will create an icon for ANY image. Provided is that you
- have the (or a) "Brush2Icon"-Tool, incuded into this collection.
- However, this "Brush2Icon" is an old program, and only works success-
- fully with 2 or 4 color WB's. You can use your own tool if you find
- one.
- The script is designed to fully use the WB's colors and amount of
- colors. This means also 16/32/64/128/256 colors. All you need is a
- tool which will support this many colors.
-
- Example Useage DOpus (AMIGADOS):
- rx rexx:ImageIcon.rexx {f} 80 60 1
-
- * ImageInfo.rexx:
- Useage:
- rx rexx:ImageInfo.rexx <name>
-
- This script will give as much information about an image as it can.
- If an image is 24Bit, information is very scarce. All you can know is
- the size, and if it is rendered.
-
- Useage DOpus (AMIGADOS):
- rx rexx:ImageInfo.rexx {f}
-
- * Negative.rexx
- Useage:
- rx rexx:Negative.rexx <name>
-
- This script will turn an image to its negative. This counts for gray
- as well as color images. No big deal.
-
- Example Useage DOpus (AMIGADOS):
- rx rexx:Negative.rexx {f}
-
- * SaveFormat.rexx
- Useage:
- rx rexx:SaveFormat.rexx <name> <format>
-
- Where:
- format: this is the format of the saver!
-
- This script will attempt to save an image into the format YOU wish.
- Provided is that you append your preferences into the list (located
- into the script itselve). Make sure you know the difference between
- IMAGE and RAW savemode.
-
- Example Useage DOpus (AMIGADOS):
- rx rexx:SaveFormat.rexx <name> JPEG
-
- This will save any image in the JPEG-format.
-
- * Scale.rexx
- Useage:
- rx rexx:Scale.rexx <name> <SizeX/FactorX> <SizeY/FactorY>
-
- Example:
- rx rexx:Scale.rexx ram:MyImage 1280 512
- rx rexx:Scale.rexx ram:MyImage 50% 50%
- (This will activate the "Halve"-operator!)
- rx rexx:Scale.rexx ram:MyImage 1280 50%
- rx rexx:Scale.rexx ram:MyImage 50% 512
-
- Where:
- SizeX/FactorX: the widthsizer.
- Have a look at the example!
- SizeY/FactorY: the heightsizer
- Have a look at the example!
-
- Example Useage DOpus (AMIGADOS):
- rx rexx:Scale.rexx {f} 640 512
- rx rexx:Scale.rexx {f} 50% 50%
-
- -----------------------
- 4. ColorCorrection.rexx:
- -----------------------
-
- * Colors.rexx:
- Useage:
- rx rexx:Colors.rexx <name> <colors>
-
- Where:
- colors: HAM8/HAM/256/128/64/32/16/8/4/2
-
- This script will convert any image to YOUR colors.
- Even non-AGA machines can render HAM8/256/128/64 images, but they
- won't be able to view it.
-
- Example Useage DOpus (AMIGADOS):
- rx rexx:Colors.rexx {f} HAM8
- rx rexx:Colors.rexx {f} HAM
- rx rexx:Colors.rexx {f} 256
-
- * ColorToGray.rexx:
- Useage:
- rx rexx:ColorToGray.rexx <name>
-
- This script will turn any image to gray.
- I can't predict the amount of colors in the result:
- 24Bit: 8Bit gray data
- AGA machines: 256/128/64/32/16/8/4/2
- non-AGA machines: 16/8/4/2
- It all depends on the source image.
-
- Useage DOpus (AMIGADOS):
- rx rexx:ColorToGray.rexx {f}
-
- * Dither.rexx:
- Useage:
- rx rexx:Dither.rexx <name> <dither>
-
- Where:
- dither: 0-6 (1= Floyd-Steinmann)
-
- This script will attempt to apply some dither onto the image. It won't
- work with 24Bit! Therefore, the result could be very low. It only
- shows you how to apply dithering with AREXX.
-
- Example useage DOpus (AMIGADOS):
- rx rexx:Dither.rexx {f} 1
-
- * LockPalette.rexx:
- Useage:
- rx rexx:LockPalette.rexx <name>
-
- This script will load the palette of the file, and lock it. This will
- cause other images processed afterwarts to get the same palette. It
- is very usefull for images which may change their palette for the
- final animation, as some animplayers do not support palette changings.
-
- Useage DOpus (AMIGADOS):
- rx rexx:LockPalette.rexx {f}
-
- * UnLockPalette.rexx
- Useage:
- rx rexx:UnLockPalette.rexx
-
- No arguments!
- It will switch the palette back to normal.
-
- -----------
- 5. Renamers:
- -----------
-
- Images which are part of a sequence all have an extension.
- Programs like:
- Imagine
- Sculpt
- AniMagic
- AnimationStation
- all create their own different extensions:
-
- Imagine: .0001 .0010 .0100 .1000
- Sculpt: .1.image .10.image .100.image .1000.image
- AnimStation: .1 .10 .100 .1000
-
- As I prefer the Imagine version, I always execute:
-
- rx rexx:RenameToImagine.rexx <name>
-
- With DOpus (AMIGADOS):
- rx rexx:RenameToImagine.rexx {f}
-
- The 2 other scripts work the same way.
-
- -------------
- 6. ScreenMode:
- -------------
-
- Only one script.
-
- Useage:
- rx rexx:ScreenMode.rexx <name> <screencode>
-
- Where:
- screencode: you can find the right PAL codes for lores, hires,super-
- hires and productivity in a text file which should be located
- in the same directory as this script.
-
- Example useage DOpus (AMIGADOS):
- rx rexx:ScreenMode.rexx {f} 7
- -> Hires Interlaced
- rx rexx:ScreenMode.rexx {f} 6
- -> Lores Interlaced
-
-
-
-
- ------------------------------------------------------------------------------
- Scripti History
- ------------------------------------------------------------------------------
- The AREXX-Scripti is the result of improving other AREXX releases:
-
- - 3-DEE-AREXX:
- Very first release of my AREXX scripts. As a result of very bad
- programming (like no multiple arguments), this collection has 52
- scripts. Some routines also are slow and are not prepared to handle
- 24Bit images or gray images.
- AREXX-Scripti can help YOU not to make such mistakes.
-
- - 3-DEE-AREXX-V2:
- Next release of some scripts. I added a few new ones and improved them
- with multiple arguments. Unfortunately, very bad documented scripts,
- and poor manual. ±25 scripts. Still they were not fully prepared for
- all situations, and palettes are not fully supported.
-
- Things should be a lot better with Scripti. I'm prepared to include new
- scripts into future collections. If you find any bugs, which is very likely
- as I tested all scripts on my own, let me know if you can.
-
-
-
-
- -----------------------------------------------------------------------------
- Previous And Future Releases
- ------------------------------------------------------------------------------
- The AREXX-Scripti Collection is the result of developing my skills to improve
- the quality of my images and animations. Also, I sometimes get new plans in my
- head. Some never come true, some will one day.
-
- This is what Jan Van Overbeke previously released:
-
- 1. F-16C FIGHTING FALCON
- Unsurpassed 3-dimensional reality! The fighter has original
- Wild Weasel 1988 decals, carries 4 missiles and one fuel pod.
- 4 images are shown on a hires 640x512 HAM8 screen.
- All images are packed to keep down the size.
- Needs ±1.05 Meg free diskspace!
-
- 2. F-16C DEMO
- To ensure quality for boards, I created an image showing all
- 4 images on one 640x256 medres HAM8 screen.
- Some people throw in some pictures, just to get more credits
- from the board. Therefore, modem users are a bit carefull.
-
- 3. M1-ABRAMS
- USA's deadliest tank shown in winter camouflage. Realistic
- images, like you'd expect from me. (hem)
- What can I say! Just make sure you get them, and pass them
- thru, but above all, enjoy it!
-
- This is what Geert Van Overbeke previously released:
-
- 1. SpaceMouse
- A 60 frame animation of a very original space-shuttle. Shows
- techniques like brush-mapping and mirror. Two versions are
- available: Full version: 1031908 bytes, HAM, 2MB ram req.
- Quarter version: 313682 bytes, HAM, 1MB ram req.
-
- 2. IntelOut
- Our contribution to the "IntelOutside project" setup by
- Session Studios ©1993. It's an animation of the IntelOut-logo
- in 3D.
- Again there are two versions:
- -Full version: 48 frames, HAM, 1146136 bytes, HAM, 2MB ram
- -Quarter version: 48 frames, HAM, ±300000 bytes, HAM, 1MB ram
-
- This is what Jan Van Overbeke <is intend to> release:
-
- 1. <BATTLESHIP>
- I'm intend to model a historical battleship, dating from
- WWII. As a surprise, I won't tell her name.
-
- 2. <ATTACK HELI>
- I'm also intend to model a modern attack heli. Sadly, it
- won't be the Hughes AH-64A APACHE. It is the most sophist-
- icated heli in the world, but it allready is modelled by
- several other artists.
-
- 3. <CAR>
- I think I will be doing a classic car, of which production is
- still going on the time I'm releasing this collection.
-
- Lots of plans, Jeeeez, I want to start right now, but exams are
- keeping me from it.
-
- This is what Geert Van Overbeke <is intend to> release:
-
- 1. TurboDuck
-
- 2. Aphaia: A Greek temple
-
-
-
-
-
- ------------------------------------------------------------------------------
- About 3-DEE
- ------------------------------------------------------------------------------
- 3-DEE is formed by Jan & Geert Van Overbeke. Together we produce three-
- dimensional arts. If you want to write us, contact us or obtain any 3-DEE
- productions, look at the chapter below.
-
- If you have found any bug, I would appreciate it you'd send it to me. In that
- way, I can continue writing these scripts with your help, and deliver good
- quality scripts. ANY comment is welcome!
-
-
-
- ------------------------------------------------------------------------------
- 3-DEE Can Be Contacted:
- ------------------------------------------------------------------------------
-
- Jan & Geert Van Overbeke
-
- Dalenstraat 9
- B-3020 Herent
- Belgium
- +32 016/48 09 33 (VOICE)
-
-
-
- Support BBS: Great Balls Of Fire
- Public Domain BBS: the best in Belgium.
- Sysop: Herman Stevens
- +32-16-640912
-
- Support Dealer: FC Systems
- Ain't no dealer with better service and a nicer
- representative.
- Bruul 82
- 2800 Mechelen
- Belgium
- Fax: +32 015/21 76 55
- Voice: +32 015/21 78 67
- Don't bother this man too much. Contact him at your
- very last choice!
-
- Fido-Net:
- 2:292/603.29
-
-
-
-
-
-