PALMEDIA Player version 2.1©1996 Lee Moon. All rights reserved.PALMEDIA Player Documentation                                          Version 2.15/4/96The PALMEDIA Player package allows you to view images on your Newton MessagePad.  This package combines and extends the capabilities of my previously released Newton Slide Show and Newton Movie Player.  PALMEDIA Player runs on Newton OS 2.0 MessagePads only.Features of PALMEDIA Player include:¥ Automatic playback mode with user selectable pauses between images.¥ Manual viewing mode for moving forward or backwards through the images.¥ User selectable transition special effects.¥ Movie mode for animation playback.¥ Uses images imported (via 3rd party shareware) from a Macintosh or Windows  PC.¥ Uses images created with NewtPaintª from Landware, Inc.¥ Uses sound imported (via 3rd party shareware) from a Macintosh.¥ Can be used as a "Helper Application" for Newt's Cape.¥ Auto-detection of soups containing images.¥ Drag an image from PALMEDIA Player onto the Notepad for routing (beam, fax, print, email).¥ Pop-up palette with image name display and a rotate button (for changing the screen orientation).This version of PALMEDIA Player is a shareware ($10) application for displaying still images and movies on Newton MessagePads running Newton OS 2.0.Requirements:1) A Newton MessagePad using Newton OS 2.0 with at least 120K-150K free (either internal or memory card) for PALMEDIA Player, Slurpee, and any soup tools.  PALMEDIA Player by itself requires 29K of memory.2) A Macintosh or Windows computer with appropriate communications software and a Newton serial cable.  Or, if using a Macintosh, PALMEDIA Image Transfer, a HyperCard stack to use instead of a communications program.  PALMEDIA Image Transfer is much easier than using and configuring most communications programs (and it's freeware!)3) Slurpee 1.8 (recommended) or higher installed on the Newton.4) A soup management tool installed on the Newton (not absolutely required, but recommended as a safety net for removing unwanted images).5) Though not strictly necessary, a graphics program capable of saving files in 1-bit (Black and White) GIF or PICT formats installed on the Macintosh or Windows computer.6) Newt's Cape Graphic Converter installed on the Macintosh or Windows computer.-or-If you wish to create and view graphics entirely on the Newton, a Newton MessagePad using Newton OS 2.0 with at least 150K free (either internal or memory card) for PALMEDIA Player and NewtPaintª instead of the requirements listed above.*** NOTICE ***Slurpee and Newt's Cape Graphic Converter are shareware packages by Steve Weyer and Greg Simon.  Please be sure to pay your shareware fees!  Without their software, you wouldn't be able to import images into PALMEDIA Player.  Here's the URL for more information regarding Slurpee and Newt's Cape:http://www.netaxs.com/~weyer/newton/newtscape.htmlUsing PALMEDIA Player:1) Install the PALMEDIA Player application (PMPlay.pkg) using traditional means.2) Launch PALMEDIA Player via the PMPlay2.1 icon in Extras.  A screen will appear while PALMEDIA Player locates images stored on the Newton.  In a few seconds, this screen will disappear and the main screen will open.3) Tap the "Play" button to start (autoplay) the slide show.  The "Play" button toggles to a "Stop" button while the slide show plays.  Tapping the "Stop" button halts the show and toggles back to a "Play" button.4) The "Slow" button indicates the delay time between images is 5 seconds.  The "Slow" button toggles to a "Fast" button, setting the delay time to 1 second.  Tap the "Fast" button to switch to "Movie" mode.  This mode configures PALMEDIA Player for animation playback.  Tapping the "Movie" button switches back to "Slow" mode.5) Tapping the up scroll arrow displays the previous image, while tapping the down scroll arrow displays the next one.  Note that a running slide show or animation will be stopped when using the arrow buttons.  To resume autoplay, tap the Play button again.Tap the overview button to open/close the floating palette.  You'll see the current image name displayed here and a "Rotate" button.  Tap "Rotate" to switch between landscape and portrait screen orientations.  Note that the palette always closes during movie playback (for maximum playback speed).6) Tapping the "Pop" button will open a list of all the available special effects transitions.  You may use this button during autoplay or in manual mode.  Note that the "Pop" transition essentially displays (pops) the next image without any special effects.  While in Movie mode, the special effects button will disappear.7) The button next to the close box is the Soup chooser button.  Tapping it switches between all the Newton soups which contain images.  If PALMEDIA Player can't find any images, "no images" will be displayed instead of a soup name.  Note that this button is hidden during autoplay (you can't change image soups during playback), but reappears when either the stop, up, or down buttons are tapped.8) Tapping the "i" button pops up an information screen.9) Tap anywhere on the currently displayed image and drag it to the side of the screen.  The image will be placed in the Newton clipboard.  You can then paste the image into the Notepad.10) To remove PALMEDIA Player from your MessagePad, simply use the normal Remove Software methods.11) To import images, use the 3rd party shareware application "Slurpee 1.8" (older versions will work) along with "Newt's Cape Graphic Converter" (see the following Notes section for more information) and a communications program (such as Zterm or PALMEDIA Image Transfer).  Please note that Slurpee runs on the Newton, while NC Graphic Converter runs on both Macintosh and Windows platforms.  See the Slurpee release notes for more details.12) To remove the image and sound soup entries, use a soup management application such as TrashPak (RemoveIt!), StewPot, BitSound, etc.Notes on this version of PALMEDIA Player:¥ The player looks for Newton soups containing graphics.  One soup, called "Bitmaps" contains all of the images transferred from the desktop to the Newton via Slurpee.  Another soup, called "NewtPaint" contains all of the images created with NewtPaintª.  You'll need to put (or create) images in a soup before PALMEDIA Player becomes useful (otherwise, you're stuck looking at the built-in title picture).  While not necessary, it is recommended that your images be no larger than 234 pixels across by 290 pixels down for portrait screen orientation or 314 pixels across by 210 pixels down for landscape screen orientation.  Images larger than these sizes will be clipped to fit the display area.  PALMEDIA Player currently restricts you to a maximum of 300 images in a soup.  Also, you may have no more than 10 different soups which contain images.¥ NewtPaintª owners can create their own graphics and then switch to PALMEDIA Player for viewing as a slide show or a movie.  NewtPaintª and PALMEDIA Player can be used for making cel animations.¥ You may transfer a sound file into a soup called "pmSndTrk" which will enable audio playback.  Note that this sound plays only once (when autoplay is started).  Also note that the player will just search for the first entry in "pmSndTrk", all other sound files are ignored.  In order to hear any soundtrack, open Extras > Prefs > Sound and turn on "Action sound effects."  Also adjust the volume to a comfortable level.¥ To use PALMEDIA Player as a Newt's Cape helper application, add a similar line to your HTML document:<a href="PMPlay2.1:LeeMoon">Touch Here</a> to run PALMEDIA Player.Make sure PALMEDIA Player and your images are already loaded.  The resulting Newt's Cape book will locate PALMEDIA Player and run it once you tap on the "Touch Here" hyperlink.  This will allow you to run a slideshow or animation directly from a Newt's Cape generated Newton Book!Future enhancements:1) Add some sort of scripting to let the user choose the time delay and transition effect for every image (i.e., display image 1 for 2 seconds with the dissolve transition, display image 2 for 5 seconds with the confetti transition,...)2) Create more special effects (and weed out the boring ones!)3) Add better sound playback support.4) Create built-in Help.5) Revise this documentation for better explanations on importing graphics via Slurpee, creating animation frames from Mac and PC, and various hints and tips for using all the tools.6) Enhance drag and drop feature.For further information, questions, or comments you may contact me via the following:AOL:  LeeMoon  (LeeMoon@aol.com)CompuServe:  76641,3317URL:  http://members.aol.com/LeeMoon/If you decide to register PALMEDIA Player, please send $10 (cash or check) to:Lee Moon2914 W. Neptune St.Tampa, FL 33629I may set up a Compuserve software registration number later.I'd like to thank all the folks who have used Newton Movie Player, Newton Slide Show, and PALMEDIA Player versions 1.0 and 2.0.  Thanks for trying PALMEDIA Player version 2.1!Lee MoonVersion history:1.0 beta 0 - 10/10/95     Released for beta testing.1.0 beta 1 - 10/12/95     Fixed heap space problem which caused Restart errors if the Bitmaps soup was larger than available heap space.  The unfortunate consequence of this is that movie playback is degraded.  I'll have to come up with a faster method of retrieving the images.     Made BETA Warning Screen display only on package startup.  You won't see the BETA screen during slide show or movie playback.  The BETA Warning Screen will be replaced by the PALMEDIA Player Title Screen when the product is released into the public domain.1.0 beta 2 - 10/16/95     Put sound playback code back in.     Put beta version number in the "i" button information screen.     Declared local variables and saved package in uncompressed format in an attempt to speed up movie playback.     Rewrote image retrieval from soups using index and key queries.  DRAMATIC improvement in speed!  Movie mode playback speed is now equal to Newton Movie Player!!!     There is currently a maximum of 300 images that can be used.  I will likely remove this limit in an upcoming release.  I've loaded 98 images (the animation frames from my NMP demo) without any difficulties.1.0 - 11/30/95     Public release!     Replaced Beta startup screen with PALMEDIA Player startup screen.     Changed "i" button information screen (removed Beta version).     A BIG "Thank you" to everyone who participated in the beta test phase!!!1.5 Beta - 3/11/96 (not publicly released)     Optimized playback for Newton OS 2.0 (turned off Newton 2.0's Busy Icon).     Made code a Newton OS 2.0 package.     Removed status bar (clock and power).     Updated Info button, startup screen, and documentation.     Renamed package to PMPlay (old name was PALMplay).1.6 Beta - 3/13/96 (not publicly released)     Revised this version to access Landware's NewtPaint image soup.     Updated Info, startup screen, and documentation accordingly.1.7 Beta - 3/14/96 (not publicly released)     Increased screen size for main app and the image view.     Shrunk buttons to give more room for the soup chooser button.     Added Bitmaps/NewtPaint button to toggle between the 2 soups.  Button doesn't work yet.     Removed protoTitle from app to give more room for images.     Updated Info, startup screen, and documentation accordingly.1.8 Beta - 3/15/96 (not publicly released)     Activated Bitmaps/NewtPaint toggle button.     Revised up/down arrow buttons to show soup toggle button.     Play button hides/shows soup toggle button to disallow changing soups when autoplay is running.     Updated Info, startup screen, and documentation accordingly.1.9 Beta - 3/16/96 (not publicly released)     Changed effects button to a pop up list.     Updated Info button and documentation accordingly.1.9a Beta - 3/17/96 (not publicly released)     Application now resizes to screen dimensions.     Made application rotate-savvy.  Currently works in portrait and landscape screen orientations.     Changed image view fill pattern to improve view redrawing speed.     *KNOWN BUG* - You can't rotate the screen with PALMEDIA Player running - it doesn't redraw properly, leaving the close box offscreen.  To change between landscape/portrait, exit PALMEDIA Player, rotate the screen, and re-open PALMEDIA Player.1.9b Beta - 3/20/96 (not released)     Put all buttons on a floating palette.  It functions fine, but takes more room than having buttons on the main screen.1.9c Beta - 3/23/96 (not publicly released)     Removed floating palette from 1.9b.     Added new special effect (Angles).     Put hooks in for using the Overview button for something (perhaps picture information, i.e. name, size, etc.)     Updated Info button and documentation accordingly.     Wrote PALMEDIA Image Transfer (HyperCard stack) as a companion to PALMEDIA Player.2.0 - 3/27/96     Public Release of version 2.0!     Removed hooks for using the Overview - I'll think of something to throw into a later release.     Removed BETA screens and updated Info button, Startup screen, and documentation accordingly.2.1a - 4/1/96    Fixed some of the rotation bug.  The screen rotates fine, but the special effects button forgets its location and drifts on the screen (when in movie mode).    Added an image soup finder which locates all soups (internal and external) that might contain graphics (bitmap or image).  The soup chooser button now toggles between ALL available soups containing graphics.2.1b - 4/6/96     Fixed the special effects button when rotating the screen.     Fixed a problem with the initial soup finder routine.  If a card was not installed, it would throw an error.2.1c - 4/13/96     Added a floating palette (for doing screen rotation, heap usage, garbage collection.) which is invoked with the Overview button - these functions will change in the public version (heap/garbage collection used for my tuning).     Fixed soup finder which now initializes to the first image soup instead of NewtPaint soup.     Added GC() in a few scripts (makes sure we have maximum heap before doing some time critical functions).2.1d - 4/21/96     Modified floating palette to display the image name and the rotate button.     Fixed soup finder to display "no images" when there are no soups with images.     Switching soups now displays the first image in the soup.2.1e - 4/22/96     Experimental version - trying to get soup picker to be a pop up list like the special effects picker.  This is not working yet.  I will hang on to this version and may revisit it later.2.1f - 4/26/96     Added drag (from PALMEDIA Player) and drop (to another application - i.e. Notepad) of the currently displayed image.2.1g - 4/27/96     Finally revised the "i" button information screen to a real floating slip.     Added a "Looking for images..." floating slip at application startup.  It takes a few seconds for PMP to locate any images on the Newton before the main application appears.2.1 -5/4/96     Public Release of 2.1!     This is version 2.1g with the name changed and copy protection turned off (you can beam PALMEDIA Player 2.1 to another Newton OS 2.0 MessagePad now).