| Readme: | Short: Animation player, converter, and builder
Uploader: jpv@morphos-user.com (jPV^RNO)
Author: jPV^RNO
Type: gfx/show
Version: 1.2
Architecture: ppc-morphos
ABOUT
-----
RNOAnim is a compact animation player that also has some conversion and
editing functions. It supports IFF, GIF, and AVI (uncompressed/MJPEG) anims
internally, but also allows a wide range of other formats via plugins and
datatypes.
FEATURES
--------
- MUI GUI
- Internal loaders: IFF, GIF, AVI (uncompressed/MJPEG)
- Included plugins: APNG, FLI/FLC, YAFA
- Can save (convert) to: GIF, APNG, and AVI (MJPEG)
- Can export frames to PNG images
- Animations can be resized freely by resizing the window
- Several options to alter the playback speed
- Animation frames can be added, inserted, or removed
- All changes (size, speed, frames) will be saved when saving a new animation
- Drag & drop loading
- ARexx support
- Keyboard and mouse controls
INSTALLATION
------------
- Copy the whole directory anywhere you want
- See the provided filetype examples for Ambient integration, or use Grunch
to install the program and get the filetypes configured automatically
- New plugins can be installed by copying a plugin file (.hwp) to the RNOAnim
directory
CONTROLS
--------
Space/P . . . . . - Plays or pauses an animation
Left/Right . . . . - Jumps to previous or next frame
Shift+Left/Right . - Jumps 5 frames back or forward
PageDown/PageUp . - Jumps 10 frames back or forward
Home/End . . . . . - Jumps to the first or the last frame
Up/Down . . . . . - Changes the playback speed faster or slower
Shift+Up/Down . . - Changes the playback speed in bigger steps
O . . . . . . . . - Opens (loads) a new animation
S . . . . . . . . - Changes between different speed settings
D . . . . . . . . - Activates the delay input
Command+(1-5) . . - Resizes an anim between 25%, 50%, 100%, 200%, and 400%
Command+F . . . . - Adds frames
Command+I . . . . - Inserts frames
Command+R/R . . . - Removes a frame
Command+X . . . . - Cuts a frame
Command+C . . . . - Copies a frame
Command+V . . . . - Pastes a frame
Command+T . . . . - Opens a color adjustment window for transparent GIFs
Command+N . . . . - Clears the project
Command+G . . . . - Saves to GIF anim
Command+P . . . . - Saves to PNG anim
Command+A . . . . - Saves to AVI anim
Command+Q . . . . - Quits the program
Mouse wheel . . . - Jumps to previous or next frame
Shift+Mouse wheel - Jumps 5 frames back or forward
EDITING
-------
- "Add frame..." creates new frames from the selected pictures, and adds them
to the end of the animation.
- "Insert frame..." inserts the new frames to the current position.
- "Remove frame" removes a frame from the current position.
- The frame delay of each individual frame can be changed manually by typing
a new value in milliseconds. Note that saving the animation to GIF rounds
down the values with 10ms precision. IFF and PNG anims will work with 1ms
precision.
- The "Speed" setting is a multiplier to the frame delay values, and thus
respects the varying frame delay values, but speeds up or slows down the
playback overall.
- The "FPS" setting forces all frames to be played with a fixed frame-rate
forgetting the original potentially varying frame delays. Note that saving
to AVI takes the speed from this value only (defaults to 25 fps).
SETTINGS
--------
Settings are found from program's pull-down menu and they will be saved to
the ENVARC:RNOAnim/ directory.
Preload animation . - Loads the whole animation into memory instead of
streaming it. This is required when editing frames, but
can be disabled if you run out of the memory when
playing huge animations.
Play automatically - Starts the playback immediately after loading an anim.
Loop animation . . - Plays an animation in a loop.
Keep speed . . . . - Keeps the custom speed settings when loading a new anim.
Keep aspect ratio . - Keeps the aspect ratio of an anim when resizing it.
Keep zoom . . . . . - Keeps the zoom value when loading a new animation.
Smooth scaling . . - Uses anti-aliased interpolation when resizing an anim.
Transparency . . . - Defines if transparency values or alpha channels are
loaded when loading animations or adding frame images,
or if transparency values are saved with an anim. *Note*
that transparency in GIF anims is defined by a color,
but APNG anims use alpha channel values from frames.
Dithering . . . . . - Dithers frame images when saving to GIF likely requires
the number of colors used reducing, to a maximum of 256.
Insert mode . . . . - Dropped image files will be inserted to the animation
instead of being added to the end of the animation.
ENV settings which aren't found within the GUI:
RNOAnim/colors . . - The number of colors a GIF anim will use when saved.
Which can be from 1 up to 256 (defaults to 256).
COMMAND LINE OPTIONS
--------------------
RNOAnim uses non-standard command line arguments. Arguments must be given in
the form of (note the "-" prefix): -argument parameter
Allowed arguments (0 = disable, 1 = enable):
-file <file> . . . . - Loads an anim file at startup
-autoplay <0|1> . . . - Start the playback automatically after loading an anim
-autoquit <0|1> . . . - Quits the program at the end of the animation
-preload <0|1> . . . - Preloads the animation to RAM instead of streaming
-loop <0|1> . . . . . - Plays the animation in a loop
-speed <0.1-10> . . . - Playback speed multiplier
-fps <1-100> . . . . - Fixed framerate for the animation
-zoom <n> . . . . . . - Percentage value to resize the animation
-smoothscaling <0|1> - Resize with anti-aliased interpolation
-args . . . . . . . . - Shows the allowed arguments
Example:
RNOAnim -file "Work:Anims/Some Anim.gif" -autoplay 1 -autoquit 1
AREXX
-----
Program's ARexx port is RNOANIM and supported commands are:
HELP . . . . . . . . . . . - Returns a summary of the available commands
OPEN <file>. . . . . . . . - Loads a new animation
NEW . . . . . . . . . . . - Clears the project
PLAY . . . . . . . . . . . - Plays the loaded animation
PAUSE. . . . . . . . . . . - Pauses playback
TOGGLE . . . . . . . . . . - Toggles between pause and play
FRAME <n>. . . . . . . . . - Selects (displays) the requested frame
ADD <file> . . . . . . . . - Adds a new frame to the end of the animation
INSERT <file> . . . . . . - Inserts a new frame to the animation
REMOVE . . . . . . . . . . - Removes the selected frame from the animation
CUT . . . . . . . . . . . - Cuts the selected frame from the animation
COPY . . . . . . . . . . . - Copies the selected frame from the animation
PASTE . . . . . . . . . . - Inserts a copied frame to the current position
FRAMEDELAY <n> . . . . . . - Sets the frame delay value for the current frame
AUTOPLAY <ON|OFF>. . . . . - Sets the "Play automatically" setting
PRELOAD <ON|OFF> . . . . . - Sets the "Preload animation" setting
LOOP <ON|OFF>. . . . . . . - Sets the "Loop animation" setting
AUTOQUIT <ON|OFF>. . . . . - Sets the program to automatically quit
KEEPSPEED <ON|OFF> . . . . - Sets the "Keep speed" setting
SPEED <0.1-10> . . . . . . - Sets a value for the "Speed" setting
FPS <0-100> . . . . . . . - Sets a value for the "FPS" setting
KEEPZOOM <ON|OFF> . . . . - Sets the "Keep zoom" setting
ZOOM <n>. . . . . . . . . - Resizes the anim to <n> percent
SMOOTHSCALING <ON|OFF> . . - Sets the "Smooth scaling" setting
TRANSPARENCY <ON|OFF> . . - Sets the "Transparency" setting
GIFTPCOLOR <RRGGBB> . . . - Sets the transparency color for GIF anims
DITHERING <ON|OFF> . . . . - Sets the "Dithering" setting
SAVE <GIF|APNG|AVI> <file> - Saves the anim to the requested format
EXPORT <dir> . . . . . . . - Saves the selected frame as a PNG image
EXPORTALL <dir> . . . . . - Saves all frames to PNG images
QUIT . . . . . . . . . . . - Quits the program
GET <STATE|FILE|FRAME| . . - Returns the requested value
FRAMES|FRAMEDELAY|
SPEED|FPS|ZOOM>
Example:
RXCmd RNOANIM "GET STATE"
HISTORY
-------
Version 1.2:
- Animations get scaled if they don't fit within the screen size
- Support for transparency in GIF anims
Version 1.1 (thanks to Thomas Igracki for his suggestions):
- The "New" option to clear any previous project
- Frames can be cut, copied, and pasted
- Frames can be added by dragging image files into the program window
- Some frames played twice, caused by a last minute change introducing a bug
- Small changes (un-iconify, frame delay fix, new requesters...)
WEB
---
- Please visit http://jpv.wmhost.com/jpv_software/ for screenshots, support,
donations, and other software
- This program is made with Hollywood: http://www.hollywood-mal.com/
THANKS TO
---------
- Densho/RNO for the logo
- Neil Pearson for proof-reading
DISCLAIMER
----------
This software is made available to you as Freeware and you may use this
software in whatever way you wish, but the author accepts no liability for
any damage caused to your system or other connected peripherals by using
this software.
|
Ambient (143)
RNOAnim_1.2.lha