PALMEDIA Player 2000 version 1.0©1997 Lee Moon. All rights reserved.PALMEDIA Player 2000 Documentation                                   Version 1.04/30/97The PALMEDIA Player 2000 package allows you to view images and movies on your Newton MessagePad.  PALMEDIA Player 2000 runs on Newton OS 2.1 MessagePads only (MessagePad 2000/eMate 300).Features of PALMEDIA Player include:¥ Greyscale image/movie display on MP 2000.¥ Supports 2 PC cards on MP 2000.¥ Automatic playback mode with user selectable pauses between images.¥ Manual viewing mode for moving forwards 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).¥ Supports both landscape and portrait screen modes.This version of PALMEDIA Player is a shareware ($10) application for displaying still images and movies on Newton MessagePads running Newton OS 2.1.Requirements:1) A Newton MessagePad using Newton OS 2.1 with at least 120K-150K free (either internal or memory card) for PALMEDIA Player, Slurpee, and any soup tools.  PALMEDIA Player by itself requires 56K of memory.2) Slurpee 1.9 ( Slurpee 2.0 recommended) or higher installed on the Newton.3) Though not strictly necessary, a graphics program capable of saving files in 16 grays PICT format installed on the Macintosh.4) PALMEDIA Media Transfer version 2.3 installed on the Macintosh.  This HyperCard stack converts and transfers images and movies to the Newton.  I've heard there is a utility program for PC owners called "BMP2BIT" (or something similar) that can be used on Windows (instead of PALMEDIA Media Transfer).*** NOTICE ***Slurpee is a shareware package by Steve Weyer.  Please be sure to pay your shareware fees!  Without his 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 (Player2K.pkg) using traditional means.2) Launch PALMEDIA Player via the Player2K 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.6) Tapping the overview button (between the up and down arrows) will display the image information floater.  The current image name will be displayed as well as buttons for rotating the screen and turning the backlight on/off.  You can drag the information floater to a convenient location.  To hide the floater, simply tap the overview button again.7) 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.8) 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, down, or overview buttons are tapped.9) Tapping the "i" button pops up an information screen.10) 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.11) To remove PALMEDIA Player from your MessagePad, simply use the normal Remove Software methods.12) To import images, use the 3rd party shareware application "Slurpee 1.9" (Slurpee 2.0 or better is highly recommended for importing large grayscale images) along with  PALMEDIA Media Transfer 2.3 which converts and transfers images/sounds/movies directly to the Newton.  Please note that Slurpee runs on the Newton, while PALMEDIA Media Transfer 2.3 runs on the Macintosh.  See the Slurpee release notes for more details on that application.13) To remove an entire image soup, open Extras, choose Storage (each soup is a little vault icon), and scrub out the unwanted image soup.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 312 pixels across by 406 pixels down for portrait screen orientation or 422 pixels across by 290 pixels down for landscape screen orientation.  Images larger than these sizes will be clipped to fit the display area.¥ 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="Player2K: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)URL:  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'd like to thank all the folks who have used Newton Movie Player, Newton Slide Show, and PALMEDIA Player versions 1.0 and 2.x.  Thanks for trying PALMEDIA Player 2000 version 1.0!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).2.3 - 12/29/96     Public Release of 2.3!     Added button to turn backlight on/off in the floating palette.     Increased maximum number of image soups from 10 to 20.     Increased maximum number of images per soup from 300 to 500.2.3.1 - 3/23/97     Public Release of 2.3.1!     Revised code to support larger screen size and 2 PC cards on MP2000.2000 version 1.0 - 4/30/97     Public Release of 2000 version 1.0!     Unlimited images per soup.     Unlimited number of soups.     Increased screen size to fill a MessagePad 2000 screen.     Increased image display area to fill the larger Player window size.     Larger floating information palette (to avoid clipping of image name).     Grayscale "welcome" screen.