ispring presenter guide player core module ... ispring presenter guide. ispring presenter guide....

iSpring Presenter Guide

Table of contents

1 iSpring PRESENTER Guide..............................................................................................6

1.1 iSpring PRESENTER Activation.................................................................................. 6

1.1.1 Trial version registration...........................................................................................9

1.2 Trial version limitations.............................................................................................. 10

1.3 Getting started with iSpring PRESENTER................................................................. 12

1.4 Product Features.......................................................................................................... 13

1.4.1 iSpring PRESENTER key features.........................................................................13

1.4.2 Animation Effects Support......................................................................................14

1.4.3 Slide Transitions Support........................................................................................18

1.5 Publish presentation.....................................................................................................19

1.5.1 Publish to Flash Window........................................................................................ 19

1.5.1.1 Destination options.............................................................................................19

1.5.1.2 Publish Presentation to My Computer................................................................20

1.5.1.3 Publish Presentation to SlideBoom.................................................................... 21

1.5.1.4 Publish Presentation to Web/FTP.......................................................................22

1.5.1.5 Send Presentation via E-Mail............................................................................. 26

1.5.2 Publish to Flash Window - General Tab.................................................................27

1.5.3 Publish to Flash Window - Settings Tab.................................................................30

1.5.4 Publish to Flash Window - Media Tab................................................................... 35

1.5.5 Publish to Flash Window - SCORM Tab............................................................... 37

1.6 iSpring Players.............................................................................................................39

1.7 Presentation management............................................................................................40

1.7.1 Presentation Explorer..............................................................................................40

1.7.1.1 Multilevel Navigation.........................................................................................41

Copyright © 2005-2009 iSpring Solutions, Inc. All rights reserved.

1.7.1.2 Hidden Slides......................................................................................................41

1.7.1.3 Slide Title........................................................................................................... 42

1.7.1.4 Presenters............................................................................................................42

1.7.1.5 Playback mode....................................................................................................42

1.7.1.6 Slide duration......................................................................................................42

1.7.1.7 Media - Audio.....................................................................................................43

1.7.1.8 Media - Video.....................................................................................................43

1.7.1.9 Media - Quiz.......................................................................................................43

1.7.2 Links....................................................................................................................... 44

1.7.2.1 Links - References Tab.......................................................................................44

1.7.2.2 Links - Web Links.............................................................................................. 47

1.7.3 Presenters................................................................................................................ 49

1.7.3.1 Presenters manager - Presenters Tab..................................................................49

1.7.3.2 Presenter manager - Company Tab.................................................................... 52

1.8 Narration......................................................................................................................54

1.8.1 Audio Recording.....................................................................................................54

1.8.2 Video Recording..................................................................................................... 56

1.8.3 Audio Importing......................................................................................................57

1.8.4 Video Importing......................................................................................................60

1.8.5 Synchronization...................................................................................................... 62

1.9 Insert............................................................................................................................ 63

1.9.1 Insert Flash..............................................................................................................63

1.9.2 Insert quiz................................................................................................................64

1.9.2.1 QuizBuilder........................................................................................................ 64

1.9.2.2 QuizBuilder - Settings........................................................................................ 69

1.9.2.2.1 Main............................................................................................................... 69

1.9.2.2.2 Question Defaults...........................................................................................71

1.9.2.2.3 Feedback........................................................................................................ 73

1.9.2.2.4 Result............................................................................................................. 74



1.9.2.2.5 Player Customization..................................................................................... 76

1.10 ActionScript API References.....................................................................................78

1.10.1 iSpring ActionScript API...................................................................................... 78

1.10.1.1 Presentation conversion modes overview.........................................................78

1.10.1.2 Presentation playback control facilities............................................................ 81

1.10.1.3 Slide playback control facilities........................................................................82

1.10.1.4 Skin development facilities...............................................................................82

1.10.2 iSpring Presentation structure............................................................................... 82

1.10.2.1 Presentation assets............................................................................................ 83

1.10.2.2 Player core module........................................................................................... 83

1.10.2.3 Skin module...................................................................................................... 84

1.10.2.4 References.........................................................................................................85

1.10.3 Flash Presentation ActionScript API.....................................................................85

1.10.3.1 Flash Presentation ActionScript API Reference...............................................85

1.10.3.2 fsplayer.api.CPresentationLoader Class........................................................... 88

1.10.3.3 fsplayer.api.IAnimationStep Interface..............................................................89

1.10.3.3.1 Remarks........................................................................................................90

1.10.3.4 fsplayer.api.IAnimationSteps Interface............................................................ 91

1.10.3.5 fsplayer.api.ICompanyInfo Interface................................................................92

1.10.3.6 fsplayer.api.ICompanyLogo Interface.............................................................. 93

1.10.3.7 fsplayer.api.ICompanyLogoLoadingListener Interface....................................94

1.10.3.8 fsplayer.api.IPlaybackListener Interface.......................................................... 95

1.10.3.9 fsplayer.api.IPlayer Interface............................................................................97

1.10.3.9.1 Remarks........................................................................................................99

1.10.3.10 fsplayer.api.IPlayerListener Interface........................................................... 100

1.10.3.11 fsplayer.api.IPresentationInfo Interface........................................................ 101

1.10.3.12 fsplayer.api.IPresentationPlaybackController Interface................................102

1.10.3.13 fsplayer.api.IPresenterInfo Interface.............................................................105

1.10.3.14 fsplayer.api.IPresenterPhoto Interface.......................................................... 106



1.10.3.14.1 Remarks.................................................................................................... 106

1.10.3.15 fsplayer.api.IPresenterPhotoLoadingListener Interface................................106

1.10.3.16 fsplayer.api.IReferenceInfo Interface............................................................107

1.10.3.17 fsplayer.api.IReferencesCollection Interface................................................ 107

1.10.3.18 fsplayer.api.ISlideInfo Interface....................................................................108

1.10.3.18.1 Remarks.................................................................................................... 109

1.10.3.19 fsplayer.api.ISlidesCollection Interface........................................................ 109

1.10.3.20 fsplayer.api.ISlideThumbnail Interface.........................................................109

1.10.3.20.1 Remarks.................................................................................................... 110

1.10.3.21 fsplayer.api.ISlideThumbnailLoadingListener Interface.............................. 110

1.10.3.22 fsplayer.api.ISoundController Interface........................................................111

1.10.3.22.1 Remarks.................................................................................................... 112

1.10.3.23 fsplayer.api.ISoundListener Interface........................................................... 112

1.10.3.24 fsplayer.api.IThumbnailsCollection Interface...............................................113

1.10.3.25 ActionScript 3 and Flex 2 support................................................................ 114

1.10.3.25.1 ActionScript 3 and Flex support in iSpring.............................................. 114

1.10.3.25.2 iSpring.as3bridge.AnimationStep Class................................................... 122

1.10.3.25.3 iSpring.as3bridge.AnimationSteps Class................................................. 124

1.10.3.25.4 iSpring.as3bridge.BridgeEvent Class....................................................... 125

1.10.3.25.5 iSpring.as3bridge.BridgeLoader Class..................................................... 131

1.10.3.25.6 iSpring.as3bridge.PlaybackController Class............................................ 131

1.10.3.25.7 iSpring.as3bridge.Player Class................................................................. 135

1.10.3.25.8 iSpring.flex.PresentationContainer Class................................................. 136

1.10.3.25.9 iSpring.as3bridge.PresentationInfo Class.................................................137

1.10.3.25.10 iSpring.as3bridge.PresenterInfo Class.................................................... 138

1.10.3.25.11 iSpring.as3bridge.ReferenceInfo Class...................................................139

1.10.3.25.12 iSpring.as3bridge.ReferencesCollection Class....................................... 139

1.10.3.25.13 iSpring.as3bridge.SlideInfo Class...........................................................140

1.10.3.25.14 iSpring.as3bridge.SlidesCollection Class............................................... 141



1.10.3.25.15 iSpring.as3bridge.SoundController Class...............................................142

1.10.4 Skin Development Reference..............................................................................143

1.10.4.1 Skin development........................................................................................... 143

1.10.4.2 fsplayer.ui.skins.ISkin Interface..................................................................... 145

1.10.4.2.1 Remarks......................................................................................................146

1.10.4.2.2 Samples...................................................................................................... 146

1.10.4.3 fsplayer.ui.skins.ISkinListener Interface........................................................ 148

1.10.4.4 fsplayer.ui.skins.ISlideShowWindow Interface..............................................149

1.10.5 Flash Slide ActionScript API.............................................................................. 149

1.10.5.1 Flash Slide ActionScript API Reference........................................................ 149

1.10.5.2 slideplayer.api.IHyperlinksManager Interface............................................... 151

1.10.5.3 slideplayer.api.IPlaybackController Interface................................................ 154

1.10.5.4 slideplayer.api.IPlaybackListener Interface....................................................157

1.10.5.5 slideplayer.api.ISlideController Interface.......................................................158

1.10.5.6 slideplayer.api.ISoundController Interface.....................................................160

1.11 Support.....................................................................................................................162

1.12 iSpring solutions...................................................................................................... 164



1. iSpring PRESENTER Guide

1.1. iSpring PRESENTER Activation

It is extremely important to go trough a registation and activation process before you startusing a full or a trial version of iSpring PRESENTER.

To register and activate your iSpring PRESENTER 4.1:

1. Click Activate button in the About section of the product toolbar to launch iSpringPRESENTER Activation Wizard window.



2. If you want to use iSpring PRESENTER unlimitedly, please, click Register the product.The product registration removes all the limitations of the evaluation version and entitlesto free upgrades to all subsequent 4.x versions of the product.

If you want to start a free fully functional 30 days trial of iSpring PRESENTER, please,click Start free trial usage.Free 30-day trial period allows evaluating all product features. During the trial period anevaluation mode watermark will be put into each generated Flash presentation.

3. If you have already purchased iSpring PRESENTER license, please enter yourregistration name and license key into the appropriate fields and click Next to proceed toLicense Activation.

If you want to get a license for unlimited use of iSpring PRESENTER, click Purchase alicense.

4. It is strongly recommended that you activate your iSpring PRESENTER right away.Please click Activate the License via Internet now for immediate license activation. Theactivation process requires active Internet connection and usually takes a few seconds



It is necessary to activate your license within 3 days. On the expiry of this period, anevaluation mode watermark will be added to generate Flash presentations until thelicense is activated.

If no Internet connection is available at your current computer or it is blocked by afirewall or in case PowerPoint has no permission to Internet access or any other reason,please select Manual Activation. You can send license activation request with LicenseRequest Code and License Key via email from another computer. When you receiveLicense Activation Code from iSpring Support Team, please enter it into thecorresponding field and click Done. Activation Requests are usually processed within onebusiness day.



1.1.1. Trial version registration

To register your free 30-days trial license, please copy and paste your registration name andlicense key you have received in an email when applying for it into the appropriate fields andhit Next.If you do not have free registration details, please go to Get the Free trial license to applyfor one at our website.



1.2. Trial version limitations

Installing iSpring PRESENTER Trial is the best way to evaluate the product. It gives you theopportunity to get acquainted with great capabilities of iSpring PRESENTER for free withoutany functionality restrictions. iSpring PRESENTER Trial provides all conversion featuresand Flash presentation tuning options avaliable in the registered product and produces Flashcontent of the same quality as the full version. To evaluate iSpring PRESENTER you need toregister your Trial copy. It will be valid for 30 days and after this period expires you need topurchase iSpring PRESENTER id you would like to continue using the product.

Trial version has iSpring banner at the bottom of each produced slide as you can see on thepicture below. After purchase and registration of iSpring PRESENTER this trial banner willvanish.



http://www.ispringsolutions.com/generate_free_serial.html?p=ispresenter

http://www.ispringsolutions.com/purchase.html

1.3. Getting started with iSpring PRESENTER

After successful completion of the iSpring setup, you can access the iSpring toolbar fromwithin PowerPoint. iSpring authoring functions provides you with the ability to makeconversion into Flash format in one click or to specify the playback settings, tune outputpresentation appearance and composition. You can include audio, video, Flash making yourpresentation even better. Refences will add additional information value to your presentation.

iSpring PRESENTER includes the following main windows:

• Publish To Flash Window• Presentation Explorer• Links Window• Presenters Window• Record Audio Window• Record Video Window• Synchronize Window• Add Quiz Window• Insert Flash Window

One click publishing

One click on the "Quick publish" button and you get a high quality Flash movie with thedefault settings. Once you've specified your conversion settings, iSpring Quick Publish willrespect them when publishing presentation.



1.4. Product Features

1.4.1. iSpring PRESENTER key features

Whatever you do in PowerPoint iSpring PRESENTER can make your PowerPoint brainchildeasily distributable, viewable and accessible everywhere.

PowerPoint Features Support

PowerPoint content

• 187 of 205 PP 2003/2007 animation effects• All PowerPoint 2003/2007 slide transitions• Vector representation of standard PPT objects• "Auto-reverse" and "Rewind at end" options new• Slide Masters with interactive elements• Animations by words and letters• Hidden slides support• Right-to-Left languages• Custom slideshows new• Slide notes styles new

Embedded multimedia support

• Embedded Flash movies• AVI/WMV/MPG/MP4 video clips• MP3, WAV and WMA audio• Background audio for a slide• Background audio for a presentation• Sounds for animation effects• Sounds for slide transitions• Animation and sound synchronization• Stop transition sound new

Flash Movie Tuning Features

Appearance & Playback

• Multilevel presentation structure• Solid/Separate/Standalone Flash movie• Allowing playback in set domain only• Flash context menu disabling• Looped Flash presentation playback• Flash movie autostart control• Flash movie preloader

Flash based Player

• 10 Flash player templates new• Customizable design, layout & color scheme• Presenter video• Live preview before publishing• Advanced Glossy Player new• Ink Annotation tools• Multilevel navigation• Flash banner skin

Advanced Features

Presentation enhancement

• QuizBuilder• Presentation Manager updated• Multiple Presenters & Company logos new• SCORM compliant content

Audio & video narrations

• Recording audio narrations• Recording video narrations

Flash movie programmatic control

• ActionScript API updated• All presentation info via ActionScrip API new• ActionScript 3 connector integration new• Interaction with JavaScript new



http://www.ispringsolutions.com/overview/animation_effects_support.html

http://www.ispringsolutions.com/overview/slide_transition_support.html

http://www.ispringsolutions.com/kb/docs/players/glossy/1.0/index.html

http://www.ispringsolutions.com/kb/docs/players/navigation_marker/1.0/index.html

• Audio, video & presentation sync

Publishing and Delivery Features

Destination

• All slides/Selected slides• Possible destinations

• Local folder at My Computer• Sharing at SlideBoom• Web site via remote FTP server• E-mail• SCORM compliant LMS

• Output formats• Flash file (.SWF)• .EXE file - no Flash Player required• HTML page• ZIP archive

Quality and Compression control

• "Smart" compression• Compression presets• Audio & Video bitrate control• JPEG and PNG image compression

1.4.2. Animation Effects Support

iSpring PRESENTER supports 180+ animation effects of PowerPoint 2003 and PowerPoint2007 as well as combinations of effects, effect enhancements & timing and all possibledirections for supported effects.

iSpring PRESENTER smoothly converts repeated animations with set number of strokes,animations with "Auto-reverse" and "Rewind at end" settings.

Animation effects are listed below in the same way as they appear in PowerPoint. Effects thatare not supported in current iSpring version are highlighted with light grey color.

Entrance Effects Exit Effects



http://www.slideboom.com

Emphasis Effects Motion Paths



1.4.3. Slide Transitions Support

iSpring PRESENTER supports all slide transition effects of PowerPoint 2003 andPowerPoint 2007. The list of supported slide transitions is given below. Names of all effectsare the same as in PowerPoint.

• Blinds Horizontal• Blinds Vertical• Box In• Box Out• Checkboard Across• Checkboard Down• Comb Horizontal• Comb Vertical• Cover Down• Cover Left• Cover Right• Cover Up• Cover Left-Down• Cover Left-Up• Cover Right-Down• Cover Right-Up• Cut• Cut Through Black• Dissolve• Fade Smoothly• Fade Through Black• Newsflash• Push Down

• Shape Diamond• Shape Plus• Split Horizontal In• Split Horizontal Out• Split Vertical In• Split Vertical Out• Strips Left-Down• Strips Left-Up• Strips Right-Down• Strips Right-Up• Uncover Down• Uncover Left• Uncover Right• Uncover Up• Uncover Left-Down• Uncover Left-Up• Uncover Right-Down• Uncover Right-Up• Wedge• Wheel Clockwise, 1 Spoke• Wheel Clockwise, 2 Spokes• Wheel Clockwise, 3 Spokes• Wheel Clockwise, 4 Spokes



• Push Left• Push Right• Push Up• Random Bars Horizontal• Random Bars Vertical• Shape Circle

• Wheel Clockwise, 8 Spokes• Wipe Down• Wipe Left• Wipe Right• Wipe Up• Random Transition

1.5. Publish presentation

1.5.1. Publish to Flash Window

Publish to Flash Window allows you to publish PowerPoint presentation to Flash format ina couple of clicks and tune appearance settings, composition and playback options for outputpresentation. All your last-used settings will be saved for the next time you publishpresentation.

1.5.1.1. Destination options

There are three publishing options on Publish Window that will help you to get results ofyour presentation faster:

• Publish Presentation to My Computer - Select this option to publish your presentaitonto a folder on your local computer or network share.

• Publish Presentation to SlideBoom - This option allows you to upload yourpresentation to online portal and release it worldwide.

• Publish Presentation to Web/FTP - Select this option if you want to upload yourpresentation to an FTP server.

• Send Presentation via E-Mail - Select this option if you want to e-mail yourpresentation.

Publish Window tabs

If you want to specify the individual settings for your presentation publishing, go through thetabs on the Publish Window:

• General - destination and composition of output Flash presentation• Settings - appearance, navigation, size and scale parameters for output Flash movie• Media - compression options for images, audio and video files• SCORM - settings for your learning-course

Should you have any questions about iSpring PRESENTER click the link Ask your questionat the bottom of the window. We will be happy to answer all your questions and help you toget maximum benefit of our product.



http://www.ispringsolutions.com/support.html

1.5.1.2. Publish Presentation to My Computer

To save published presentation to a folder on local computer or to a network share for localviewing, follow the Publish to My Computer instructions.

To publish presentation on local computer or network share:

1. Type the name for your output Flash movie next to the Presentation Title field.2. Specify a local folder or a network share to which you want to save the presentation next

to the Destination Folder field:• type the path to the destination folder manually, or• click the "Browse" button on the right of Destination Folder field, browse for the

folder, select it and click Ok.



3. When you finish with settings, click the Publish button to publish your presentation.

Back to Top

1.5.1.3. Publish Presentation to SlideBoom

You can publish your presentation to SlideBoom online portal and it will host your Flashslideshow for millions of online users. The membership is free.

To upload your presentation:

1. Click the "Edit Account" button on the right of Account field. You will see a windowwhere you can enter your account details or get free one.



2. When you enter your account details SlideBoom validates this data and you will see yourname in the Account field.

3. Click the Publish button. iSpring will save your presentation to a local folder and itconvert to Flash format. This is a time consuming process and it may take a few minutes.After conversion you can set descriptions and details for your Flash movie.#Allow public access# option makes your presentation available for viewing foreveryone. If you uncheck this option, your presentation will be uploaded but not shared.In this case only you will be able to view this presentation.

4. Click the Upload button and view your presentation at SlideBoom.

Back to Top

1.5.1.4. Publish Presentation to Web/FTP

If you want others to download and view your presentation all worldwide you can upload itto a web server on the Internet or Intranet.



http://www.slideboom.com

To publish presentation on the Web/FTP:

1. Type the name for your output Flash movie next to the Presentation Title field.2. Click the "FTP Accounts" button on the right of Destination FTP address field. You

will see a window where you can add, edit and delete FTP accounts.



To create a new FTP account, you need to fill in the window shown below:



FTP Account

Host name Textual host name (e.g. mysite.com) or IPaddress (e.g. 77.77.55.88) of the web serverwhere the presentation will be uploaded.

Port FTP servers generally use port 21, butsometimes the port number may differ. For moreinformation, contact your network administrator.

Path The DNS address of FTP site.

User name If anonymous access to the FTP is not allowed,type your user name.

Password If anonymous access to the FTP is not allowed,type your password.

3. When you finish with settings click the Publish button to publish and upload yourpresentation.

Back to Top



1.5.1.5. Send Presentation via E-Mail

If you want to send your presentation, select Send via E-Mail option. A new e-mail with thepresentation attached to it will be created by your mail program. You can immediately send itto the specified e-mail address.

To publish and e-mail presentation:

1. Type the name for your final Flash presentation next to the Presentation Title field.2. Type the recipient's e-mail address next to the E-Mail field.3. When you finished with the settings, click the Publish button to publish your

presentation.

Back to Top



1.5.2. Publish to Flash Window - General Tab

The General tab allows you to specify the Flash output of your PowerPoint presentation:title, destination, appearance, Player skin and composition.

General

Presentation Title A title for your Flash presentation which willdisplay in Player.

Destionation A local folder, SlideBoom portal, FTP Address ore-mail depending on where you want to storeyour Flash presentation.

File name The name for output .swf file, title for a folder if



you publish presentation as separate slides andname for the .zip file if you archive Flash movie.

General | Slide Range

All Slides Select this option if you want to convert intoFlash format the entire presentation.

Selected Slides This option will allow you to publish onlyselected slides from your presentation. Selectnecessary slides from within PowerPoint thenchoose the Selected Slides option and publishyour presentation.

General | Flash Output

Publish to LMS iSpring will publish your presentation ready toupload to any LMS. You can see the example ofhow to upload your presentation to Moodle andto OLAT LMS. Most of LMSs requires creating.zip archive for uploading, so we recommendyou to check ZIP output option that is on thebottom of this window.

Presentation PowerPoint presentation will be converted into asolid Flash movie or in a set of .swf files wrapedin Flash based Player.

All in one Flash file All slides of PowerPoint presentation will beconverted into a solid Flash movie with allexternal resources embedded in one .swf file.

Generate HTML file iSpring generates a simple HTML web page withFlash movie that simplifies publishing on theWeb. You can choose either presentationpublishing as a HTML file or as an executable(.exe) file.

Generate EXE file If selected, iSpring PRESENTER generates anexecutable (.exe) file with Flash presentation.Such movie can be displayed everywhere evenif you don't have Flash Player installed.

Full screen playback If this option is enabled, your presentation willoccupy the entire screen during playback.

Standalone Flash Slides iSpring will generate a set of .swf files. Eachslide of your PowerPoint presentation will be



converted into a separate Flash movie and noPlayer is created to control Flash clip playback.This mode can be useful if you plan embedcustom player or integrate Flash slide into webpages or your blog.

ZIP output Check this box if you want to archive (zip) yourFlash presentation. Note: set of Flash clips isalways zipped when publishing to E-mail.

General | Preveiw

Skin Select skin for Player from the drop-down menu. Tenskins are available:

Advance Glossy skin is new stylish and fullycustomizable Player with support of MultilevelNavigation, Presenter's video, Marker Tools andMultiple Presenters and logos.

Advance Matte skin is highly customizable skin thatallows you to adjust unique colors for Player andMarker tools, customize navigation elements andspecify your own captions for tabs and buttons.

Banner is special skin optimized for Flash bannercreation. It doesn't support transition effects andsounds but therefore the output file size is smaller incomparison with no skin option.

Classic skin wraps your Flash movie into the Playerwith thumbnails view, outlines view, slide notes viewand Presenter info.

Crystal skin allows you to customize player layout,navigation elements and create unique presentationappearance.

Lite provides basic navigation options to controlFlash presentation playback.

None allows you to publish presentation withoutvisible Player.

Navigation panel supports most commonly usednavigation operations to control slide navigation ofyour Flash presentation.

Navigation + Marker provides you with basicnavigation elements and Marker tool with



customizable types and colors.

Navigation + Notes provides you with basicnavigation elements and Notes.

Info You can get detailed description of how you cancustomize• Advanced Glossy Skin new• Advanced Matte Skin updated• Crystal Skin• Classic Skin• Navigation panel• Navigation + Marker.

Customize You can customize the Advanced Glossy,Advanced Matte, Classic, Crystal skins,Navigation + Marker and Navigation + Notespanels. The Live Preview feature allows you tosee immediately how your presentation will lookwhen after conversion.

1.5.3. Publish to Flash Window - Settings Tab

Use the Settings tab to configure the options for PowerPoint to Flash conversion, specify sizeof presentation and settings to control Flash movie playback.




http://www.ispringsolutions.com/kb/docs/players/advanced/4.0/index.html

http://www.ispringsolutions.com/kb/docs/players/crystal/1.0/index.html

http://www.ispringsolutions.com/kb/docs/players/classic/1.0/index.html

http://www.ispringsolutions.com/kb/docs/players/navigation_panel/1.0/index.html


Settings | Flash movie

Size Width and height of output Flash presentation.

Scale The number for the percentage of the movie'ssize relatively to the original presentation's size.

Note: width, height and scale are related parameters and iSpring maintains the aspect ratio asyou change one of these parameters. iSpring technology allows to reduce the height and thewidth of the presentation without loss of clarity.

Settings | Flash movie

Flash Movie Frame rate The number of Flash frames per second. Smallvalues are not recommended because this cancause flickering when playing animations.



Background color You can set a background color and yourchanges will apply to the whole presentation.Double click on the current color next to thisoption will open a standard window where youcan select a appropriate color.

Flash version Select the version of Flash Player. Flash playersof 7, 8, 9 versions are available.

Disable Flash printing Check the box if you don't want to allow yourend viewers to print your Flash presentation.Print option in the right-click menu will bedisabled in the generated Flash file.

Disable Flash menu Disables right click menu and top menu ofgenerated Flash movie playback window.

Optimize images for resolution Check the box to optimize images for givenscreen resolution which you can select from thedropdown menu. If set value is smaller thanpresentation size, images will be optimized forthe presentation dimensions.

Allow playback in the following domains only Restricts presentation playback to the specifieddomain(s). Generated Flash presentation willplay only in the specified domain(s) and all itssubdomains. It won't play on a local computer oron another web site. Use this option if you wantto protect your Flash content from unauthorizedredistribution.

Enable interaction with JavaScript If the option is checked out Flash presentationswill include the JavaScript Connector that allowsFlash movie playback control via HTML code.

Integrate ActionScript 3 connector Tick this option in case you use Flash fileswritten in ActionScript 3 to control presentationplayback. ActionScript 3 Connector module willbe integrated into output Flash presentation.

Provide complete presentation infoActionScript API

Tick this option if you need to performprogrammatic control over Flash presentation. Ifchecked all information about presentation willbe available via ActionScript API regardless ofthe player used.

Settings | Playback and Navigation

Add Preloader This option adds a preloader to Flash



presentation which shows a progress of theFlash presentation loading.

Start presentation automatically Thick this option if you would like your Flashpresentation to start playback automatically assoon as first slide is loaded.

Change all slides automatically If this option is checked slides in Flashpresentation will advance automatically.

Minimal slide duration This value indicates minimal playback time inseconds for non-animated slides. Slide durationfor particular slides can be specified inPresentation Explorer.

Auto-play on-click animations each Select it to automatically advance to the nextstep for on-click animations after the number ofseconds you enter."Automatic animations" option will also respecttiming set from within PowerPoint.

Advance animations on mouse click Select it to advance to the next animation stepwhen you click the mouse.This option applies only for slides that containmouse driven animations, 'Automaticanimations' will always start according to thetimings set from within the Custom Animationdialog of PowerPoint.

Keyboard playback control This option allows you to control presentationplayback by keyboard keys:• Page Up: transition to the previous slide• Page Down: advance to the next slide• Left: rewind• Right: fast forward• Up: increase volume• Down: decrease volume• Space: play/pause• Home: restart current slide• End: stop at the end of the current slide• Ctrl+Home: move to the first slide• Ctrl+End: move to the last slide• Backspace: return to the last viewed slide• Enter: move to the next animation step• Shift+Enter: return to the previous animation

step

Looped playback If selected, your presentation will automaticallystart from the beginning after the last slide is



completed. This feature is essential for creationof Flash banners and trade shows.



1.5.4. Publish to Flash Window - Media Tab

The Media tab allows you to configure compression settings for presentation. The lowerquality of images and audio/video objects, the smaller the size of your Flash presentation.

Compression

Use Preset iSpring Presenter provides you with 4 presentcompression modes that optimize Flash moviefor publishing to the web with low or highconnection speed, publishing to the LocalNetwork drive or publishing on CD. Also you cancreate up to 10 custom compression presetsspecial for your individual needs.



Image compression If you check "Smart compression" mode forconverting your presentation to Flash, all imageswill be saved keeping high quality and smallsize. Read more about Smart compression in(http://blog.ispringsolutions.com/?p=133) iSpringblog. "Lossy" compression will convert and saveall embedded images to .jpg format. "Lossless"compression converts all images in yourpresentation with the highest quality.

Audio compression By default iSpring PRESENTER keeps originalquality of audio in presentation. If needed youcan set higher or less bitrate but it will influenceoutput file size and audio quality.

Video compression By default iSpring PRESENTER keeps originalquality of video in presentation. If needed youcan set higher or less bitrate but it will influenceoutput file size and video quality.

Flash Multimedia Tuning

Smooth raster images Smoothing usually enhances the quality of rasterimages rendering but sometimes can lead toundesirable results when the Flash movie iscreated for Flash Player version 8 or higher. It isrecommended to set this propety to false whenthe target Flash player version is 8 or highersince the rendering quality of Flash Player 8 isquite good and additional smoothing makesraster images blurred.

Detach media content

Using these options makes sense if you convert presentation into solid Flash movie.

Embedded Flash movies If you check this option, your presentation andembedded Flash movies will be saved intoseparate .swf files.

Video clips Check this option if you have large video clipsembedded into your presentation. Each videofile will be converted into separate .flv files andthis will remove the limits of .swf format.

Audio Files In case the audio embedded into yourpresentation is large, it is recommended toenable this option. The audio will be saved into



http://kb.adobe.com/selfservice/viewContent.do?externalId=tn_14437

separate file and your Flash presentation willload faster.

1.5.5. Publish to Flash Window - SCORM Tab

The SCORM tab allows you to choose the version of SCORM, set information about thepresentation and customise settings for your training course.

LMS Settings | Version

Version Select SCORM version for you training course.Learn more about SCORM version features anddifferences from Wikipedia.



http://en.wikipedia.org/wiki/SCORM

LMS Settings | Information

Course title The name for your training course.

Lesson title The name for your lesson.

Description Type here the brief description of your trainingcourse.

Keywords Specify keywords for your LMS. They will helppeople to find your training course by thiskeywords.

LMS Settings | Options

Min number of slides viewed to complete Set the minimum number of slides learner mustview to complete the lesson.

Duration The time allocated to the lesson. It is impliedthat during the time set students would learn thelesson well.

Timeout actions When the time allocated to the lesson is out youcan set the following actions: terminate lessonand/or show message that the time has run out.



1.6. iSpring Players

iSpring PRESENTER can wrap output presentation into Flash based Player. Current versionincludes 9 different players, 5 of which are highly customizable. Your Flash presentation canlook as in PowerPoint with a simple Navigation + Marker panel or can be wraped in theAdvanced Player which contains notes, outlines, thumbnails, PRESENTER info andreferences. You can find detailed description of how you can customize the player creatingunique appearance and keeping handy navigation of your Flash presentation.

• Advanced Glossy nuw• Advanced Matte updated• Crystal Player• Classic Player• Navigation panel• Navigation + Marker

The other Banner, Lite and None players are not customizable. Navigation + Notes playercan only adjoin left or right side of the presentation.





http://www.ispringsolutions.com/kb/docs/players/crystal/1.0/index.html

http://www.ispringsolutions.com/kb/docs/players/classic/1.0/index.html

http://www.ispringsolutions.com/kb/docs/players/navigation_panel/1.0/index.html


1.7. Presentation management

1.7.1. Presentation Explorer

New Presentation Explorer is an efficient tool that allows you to set up a presentationstructure and slide advance options,add presenters and media resources in a single window. With Presentation Explorer it'seasy to add audio and video narrationsor quizzes. You can edit your presentation slide by slide or apply similar setting to a selectedgroup of slides using Presentation Explorer toolbar or the right-click context menu.

With iSpring Presentation Explorer you can easily:

• Organize Multilevel Navigation• Manage Hidden Slides• Edit Slide Titles• Assign Presenters to slides• Set Playback mode - manual or automatic• Set Slide Duration• Import Audio Narration to a slide• Import Video Narration to a slide• Add Quizzes



1.7.1.1. Multilevel Navigation

You can adjust slides nesting level to organize multilevel navigation in your presentationwith the slide nesting level control buttons:Available levels will increase each time you move a slide to a subsequent level. For example,when all slides of your presentation are assigned to the top level (1), you have an option toadd only one nested level (2). If you assign any slide to level 2 than you can movesubsequent slide to level 2 or 3 and so on.Your presentation may contain up to 8 levels in hierarchy. Also you can collapse and expandnested slides using "-" and "+" icons on the left of a top level slide.

1.7.1.2. Hidden Slides

You can mark any slide as hidden double clicking its thumbnail. Hidden slides are not shownin navigation and thumbnails and skipped during presentation playback. Please note thathidden slides are still exist in you Flash presentation and can be reached via links from other



slides hyperlinks or action buttons.

1.7.1.3. Slide Title

Titles of slides are shown in the Outline tab of Advanced, Crystal and Classic Players. Bydefault, titles are taken from PowerPoint slide titles of the presentation. To change a slidetitle, double-click on it and enter a new one. The new titles will display in your Flashpresentation navigation and can differ from PowerPoint slide titles.

1.7.1.4. Presenters

To assign a Presenter to the selected slide, double click on a Presenter photo/name and selecta different one from a drop-down list of available Presenters. By default a Presenter markedas Default is added to all slides in you presentation. To change a default Presenter, click thePresenters icon on iSpring toolbar.

1.7.1.5. Playback mode

You can set up a slide to advance to the next one automatically after time delay, or require auser to click to advance. To change advance type click on a mouse (manual mode) or timer(automatic mode) icon.

1.7.1.6. Slide duration

You can set timing for automatic advance on the right of changing mode icon.Note: Slide advance time also depends on "Minimal slide duration" that can be managed inSettings tab of Publish window.

Media

This section allows you to manage external audio, video and quiz in a slide. If media hasbeen already added to a slide, the corresponding icons are active, allowing playing audio andvideo or editing a quiz.Note: the option to insert quizzes and videos into a slide is available only in iSpring PresenterMaster Edition.

You can also add audio and video narrations to a slide using the Import Audio and ImportVideo buttons of the iSpring Presenter toolbar.Note: iSpring Presenter allows you to add one audio and one video per slide. You can alsoadd a background audio for the entire presentation.

Further to importing media resources, you can record audio and video narration with iSpringPresenter.



1.7.1.7. Media - Audio

iSpring Presentation Explorer lets you import audio narration to the selected slide.

To add an audio:

1. Click the Import audio narration icon to launch the Windows Explorer.2. Choose the audio you would like to insert. iSpring Presenter supports .MP3, .WMA and

.WAV audio file formats.Selected audio track starts playback automatically. To disable this option uncheck theAuto Play checkbox at the bottom of the explorer window.

By default the slide duration is adjusted to the audio file duration. If you uncheck theAdjust slide duration to fit audio option, PowerPoint timings for animated slides andminimal slide duration for non-animated slides may affect slide duration and your audiomay not playback in full.

3. Click Open. The audio file will be added to the selected slide.

1.7.1.8. Media - Video

iSpring Presentation Explorer lets you import video narration to the selected slide.

To insert video to the selected slide click the Import video narration icon and choose thevideo file. Supported video file formats are .AVI, .WMV, .MPG and .MP4.

You can preview the video before inserting it to slide. The selected video starts to playautomatically in the explorer viewport. To disable this feature uncheck the Auto Playcheckbox at the bottom of the explorer window.

By default slide duration is adjusted to the video duration. If you uncheck the Adjust slideduration to fit video option, PowerPoint settings for animated slides and minimal slideduration for non-animated slides may affect slide duration and your video may not playbackin full.

By default iSpring creates a folder in a directory with your presentation for all externalresources of PowerPoint presentation and copies the video file into that folder. If you want toedit or show presentation on another computer you can easily copy PPT presentation andfolder with all external resources. In Flash format all media resources are embedded into themovie and you have solid SWF file from your presentation. To disable gathering mediaresources in additional folder uncheck the Copy to presentation resource folder option.Note: audio and quizzes are always copied to the resource folder.

1.7.1.9. Media - Quiz



iSpring Presentation Explorer lets insert quizzes into PowerPoint slides via quiz editingbuttons. Please refer to QuizBuilder documentation to learn more about QuizBuilderfacilities.

Quick managment

Managment

Toolbar Use the options on the Presentation Explorer toolbarto edit a group of selected slides. These settingsbehave the same way as for a single slide. Please seethe detailed description above.

Right-click menu You can also manage slide or group of selected slidevia context menu. Right-click in the area of the slidelist to set Presenters, adjust playback mode, changeslide nesting level and show/hide slides.

Presentation Background Audio

Check the box to add a background audio for the entire presentation. iSpring Presentersupports .MP3, .WMA and .WAV audio file formats.

To add an audio file, click the "..." button and select an audio track. You can listen to theaudio clicking on the speaker icon.

Check the box to loop audio during presentation playback. The audio will loop ifpresentation playback duration is longer than the background audio duration.

1.7.2. Links

1.7.2.1. Links - References Tab

References are external resources that you would like your audience to view during yourpresentation playback. You can add references of 2 types:

• Web References - links to web pages• File Attachments - links to local files, like .pdf or .xls document or .jpg image.

The references are available in the Reference tab of the Advanced player and in theReference window of the Crystal player. To make them available, enable References inplayers using Customize button on the Publish window.

To manage references:



1. Click the Links button on the iSpring toolbar.2. Presentation Links window will launch. All references added to a presentation are

accessible in the References tab.

To open a selected reference in a new browser window, check the box New Window. Toedit and delete reference, use the icons on the right of the References window.You can also test your references accessibility clicking a reference file path or URLunder Location option. For more effective management you can rearrange the referencesclicking the Type, Title, Location, New Window options to sort the references accordingto desired attribute. To delete all references from your presentation, use Remove AllReferences button. You will be asked to confirm the deletion.

3. When you have finished with your references, click OK to save your updates. To quitwithout saving, click Cancel.

To add a Web Reference



1. Click Links on iSpring toolbar, Presentation Links window will open.2. Click the Add Web Reference button at the bottom of the window opened.

3. Enter a Title for a web link. It will display in the Reference screen of the player.4. Enter a web address of the web page, blog or other web resource. The URL field is

prefilled with "http//:", please don#t omit this part of URL in your link.5. Check "Open in new browser" window option to if you want to open each web

reference in a new browser window.6. When you finished with your settings, click Ok to save a reference. To exit without

saving changes, click Cancel.To add a File Attachment

1. Click Links on iSpring toolbar, Presentation Links window will launch.2. Click the Add File Attachment button at the bottom of the window opened.3. The Explorer window is automatically launched. Find and select the file you want to add

and click Open.



4. Add File Attachment window will be opened and prefilled with descriptions of the fileyou've chose. You can select a different file clicking the ":" button on the right of thePath field. The Title that is displayed in the Reference screen of the player is taken yourfile name by default. You can easily edit it and enter the title you#d like to show yourviewers.

5. Check "Open in new browser" window option to if you want to open each file in a newbrowser window. This option makes sense only for files that are viewable via internetbrowser, e.g. .jpg or .pdf files.

6. When you finished with your settings, click Ok to save an attachment. To exit withoutsaving changes, click Cancel.

1.7.2.2. Links - Web Links

The Web Links tab allows you to link your Flash presentation to web pages. When youcreate a hyperlink to a page the hyperlink destination is represented by the path to a webresource (e.g. http://www.ispringsolutions.com).

To manage web links in a Flash presentation:

1. Click the Links button on the iSpring toolbar.2. Select the Web Links tab on the Presentation Links window opened.



3. Set up links settings to configure links for your Flash presentation.Hyperlinks target

This option allows you to manage all external links in you presentation. External links arehyperlinks to some external resources, not a slide in presentation. You can set up howhyperlink destination should be opened: in the same browser window wherepresentation is displayed, in a new browser window or in a parent window.

Mouse click hyperlink

Check this option to open a web page or blog on a mouse click. When published, anyclick on the presentation area will open the specified web page or file. This feature isuseful for creation of Flash banners and trade shows.If the option is enabled, type manually the URL (address) of web page or a file path. Bydefault the path is prefilled with "http://". Be sure to keep it in your web link.



Check the Open link in new browser window box if you want to open the destinationweb resource in a new browser window.

Flash presentation redirect

Check this option to open automatically a specified web page after presentation playbackis completed.If the option is enabled, type manually the URL address of web page. By default the pathis prefilled with "http://". Be sure to keep it for your web link.Check the Open link in new browser window box if you want to open the destinationweb resource in a new browser window.

4. Click OK to save your updates. To quit without saving changes, click Cancel.

1.7.3. Presenters

1.7.3.1. Presenters manager - Presenters Tab

Presenters Tab allows you to add, edit or delete presenters and set up a default presenter thatwill be automatically added to your Flash presentation.

All information about presenters is stored in your presentation. So it will be available ifediting a PPT presentation on another computer or sending it via email. Presenter info is alsostored on your local computer so when you open a presentation you can always update thepresenter to the latest one. And being stored in your computer presenter?s info can beupdated and added to any presentation.

And being stored in your computer presenter#s info can be updated and added to anypresentation.



All presenters you add can be managed in a Presenters window. Use Add Presenter andEdit Presenter buttons to update information about a presenter. To delete a presenter, selecta presenter and click the Delete Presenter button.

You can specify a Default Presenter that will be automatically assigned to all slides in yourFlash presentation. Select a presenter from your list and check the Default box. To assigndifferent presenter to each slide in presentation, use Presentation Explorer.



To add Presenter or edit Presenter details:

1. Click the Presenters icon on the iSpring toolbar. The Presenters window will launch.2. Click the Add Presenter button to add a new presenter. To update info on an existing

presenter select a presenter and click the Edit Presenter button.3. Enter the details into the corresponding fields of the Edit Presenter Info window. Name

is the only required filed. If you leave any other field blank, it will not display in thePresenter info during Flash presentation preview or playback.

You can enter the following info about presenter:

Presenter info

Name The first and the last name of the presenter.



Title The title of the presenter (e.g. Project Manager).

E-mail The contact e-mail address of the presenter.

Web The Presenter#s web site address

Info Brief info about the presenter, work experience,success story or any information you considervaluable to the viewers.

Photo Click the Browse button to add or change apresenter#s photo. iSpring supports all most popularimage file formats as .JPG, .PNG, .GIF, .BMP,.WFM, .EMF. The best presenter photo dimensionsare 62x82 for Advanced player, 100x130 for Crystalplayer and 60x40 for Classic player. If the photo isnot fit the dimensions iSpring automatically adjustsphoto to fit the width/height of the photo area in aplayer.

Company logo Use presenter-specific company logo Check the boxto set custom company logo for a specific presenter.Click Browse, navigate and select an image file in.JPG, .PNG, .GIF, .BMP, .WMF or .EMF format.You can also assign custom link with the selectedcompany logo.A company logo and web site that apply to allpresenters without specific logo could be set in theDefault Company tab of the Presenters window.

1.7.3.2. Presenter manager - Company Tab

Company Tab allows you to brand your Flash presentation with your company logo andassign a link to your company web site.



To add info about your company:



1. Click Presenters icon on the iSpring toolbar.2. Select the Company tab on the Presenters window launched.3. Customize the following options.Company info

Company Logo Click the Browse button and select your companylogo. iSpring supports all popu.JPG, .PNG, .GIF,.BMP, .WFM, .EMF image file formats.

Company Web Site Enter your company#s website URL and yourviewers will be able to get to your website clickingon your company logo. The field is prefilled with"http://", please be sure to keep it when addingwebsite URL.

1.8. Narration

1.8.1. Audio Recording

You can record audio narrations either reading aloud your text notices or any other verbalannouncement and synchronize it with your slideshow. Just click Record Audio button tolaunch Record Audio Narration and start playing.

To record Audio:

1. Click Record Audio in the Narration area in your iSpring toolbar to launch Record AudioNarration window.



2. Choose the slide you would like to record audio narration to or the one to start recordingat from the drop-down slide list.

3. Click Start record to start recording audio narration.4. Click Ok to apply the changes or Cancel to quit Record Audio narrations without saving

any changes.How to record audio:

Drop-down Slide list Choose the slide you want to record audio to or tostart recording at

Start record /Next animation/Next slide/Stop

Click to start audio recording/Click to advance to the next animation/Click to advance to the next slide/Click to stop

Show notes Tick this option to show text notices for the slide

Process this slide only Tick this option to process one chosen slide only

Prompt to overwrite existing audio Tick this option to be additionally asked if you dowant to rerecord an existing audio

Settings Click to select audio recording device



Resync Click to resynchronize the recorded audio with aslide(s)

Play/pause button Click to play/pause recorded audio

Stop button Click to stop recorded audio

Left arrow button Click to go to the previous slide

Right arrow button Click to go to the next slide

1.8.2. Video Recording

You can provide your presentation with video narration using a usual web cam and iSpringPRESENTER. Click Record Video and shoot your film.Note: video recording is available in iSpring PRESENTER only.

To record Video:

1. Click Record Video to in the Narration area in your iSpring toolbar to launch NarrationRecord Video window



2. Choose the slide you would like to record video to from the drop-down slide list3. Click Start record to start video recording4. Click Ok to apply the changes or Cancel to quit Record Audio narrations without saving

any changes.How to record video:

Slide drop-down list Choose the slide you want to record video for

Start record /Next animation/Next slide/Stop

Click to start video recording/Click to advance to the next animation/Click to advance to the next slide/Click to stop



Prompt to overwrite existing video Tick this option to be additionally asked if you dowant to rerecord an existing video

Settings Click to select video recording device

Resync Click to resynchronize the slide with the recordedvideo



1.8.3. Audio Importing

Audio always adds up to an expressive slideshow. Click Import Audio to embed andsynchronize audio tracks in your presentation.



To import Audio:

1. Click Import Audio in the Narration area in your iSpring toolbar to launch Openwindow



2. Choose an audio file that you would like to add to your presentationNOTE: Supported audio files formats are WAV, MP3, WMA.

3. Select the slide you would like your audio to start at from a Start slide drop-down list4. Click Open to import the selected audio or Cancel to quit without saving any changesHow to import audio:



File name Shows the audio file that is intended to be added

Files of types Displays audio files of selected types only

Adjust slide duration to fit audio Tick this option for an automatic adjustment of slidetiming in accordance with audio duration

Auto play Tick this option for a preliminary playback ofimported audio

Play/Stop

Click to play the selected audio/Click to stop the playing audio

Start slide drop-down list Choose the slide that the audio starts at

Open Click to import the chosen audio file

Cancel Quit the Open window without saving any changes

Note! To add presentation background audio use Presentation Explorer.

1.8.4. Video Importing

Vivify your presentation with a video clip. Just find the right one to insert and embed it withan Import Video option in iSpring PRESENTER.

To import Video:

1. Click Import Video in the Narration area in your iSpring toolbar to launch OpenWindow



NOTE: Supported video formats are AVI, MWV, MPG, MP4.

2. Select the slide to play the video from the Slide drop-down list.3. Click Open to import the video to the selected slide or Cancel to quit the Open window

without saving any changes.How to import video:



File name Shows the selected video

Files of types Displays video files of selected types only

Adjust slide duration to fit video Tick this option for an automatic adjustment of slidetiming in accordance with video duration

Auto play Tick this option for a preliminary playback ofimported video

Play/Stop

Click to play the selected video/Click to stop the playing video

Copy to presentation resource folder Tick this option to copy the video to an automaticallycreated Video folder in your original presentationresource folder(When converting with iSpring PRESENTER, threenew separate folders Audio, Video and Quiz areautomatically created in the presentation resourcefolder that will get the same name as your original.ppt/.pptx).

Slide drop-down list Select the slide number to add the video to

NOTE: audios and videos can also be imported with Presentation Explorer.

1.8.5. Synchronization

Perfect playback has to be flawlessly timed and easy-to-handle. Make your slideshow playsmoothly with the Sync option.

To synchronize your presentation narration:

1. Click in the Narration area in your iSpring toolbar to launch Synchronize presentation



narration window.

2. Choose the slide to slide synchronization from the slide drop-down list.3. Click Start sync./ Stop to start/stop synchronization process.4. Click Ok/Cancel to save/dismiss the synchronization.How to sinchronize:

Drop-down list Choose the slide you want to synchronize

Start sync/next animation /next slide

Click to start synchronization process/to advance to the next animation/to advance to the next slide



Video window Displays the video



1.9. Insert

1.9.1. Insert Flash

Insert Flash Window allows you to insert external Flash (.swf) movies into your PowerPointslides easily. You can also add Flash movies to Master slides of your presentation as to any



other slide of your presentation.

To insert a Flash movie clip:

1. On the iSpring toolbar, click the Flash button.2. Choose a Flash file to be inserted into the presentation. Only .SWF file format is

supported. You can insert only one Flash movie per slide. PleaseNote: iSpring doesn#t support Flash files previously converted from PowerPoint withiSpring.

3. Click the Open button and you will see first frame of Flash movie placed on a slide.PowerPoint 2007 doesn#t allow embedding Flash movie into PPT presentation due tosecurity restrictions. It only creates a link to a Flash file. So if you desire to movePowerPoint presentation to another computer, be sure to copy your Flash file as well.You will need to create a folder for Flash file with the same name as on an originalcomputer or insert Flash file once again.After conversion to a solid Flash file, all inserted Flash resources will be embedded intoyour Flash presentation. On the other hand if you have a lot of external Flash files or abig Flash file inserted in your PPT presentation we recommend storing them in a separateresource folder (use the Detach Embedded Flash movies option).

1.9.2. Insert quiz

1.9.2.1. QuizBuilder



Quiz section:

Quiz section

Save Use Save button to save your quiz.

NOTE: By default iSpring creates a folder in thesame directory with your presentation for all externalresources of PowerPoint presentation and new



quizzes are automatically stored into that folder.If you want to edit or show presentation on anothercomputer you can easily copy PPT presentation andfolder with all external resources. In Flash format allmedia resources are embedded into the movie andyou have solid SWF file from your presentation.

Clear Click the Clear button to delete all the questionsfrom your quiz.

Settings Quiz settings allows you to manage appearance,feedback, question defaults for your quiz. (see aSettings window for more info)

Clipboard section:

Clipboard section contains three standard tools Copy, Cut and Paste for copying, cutting andpasting text fragments correspondingly.

Preview section:

Preview section has the only button Quiz preview for live preview and taking a quiz beforepublishing.

Add Question section:

Add Question section is used for adding new questions to the quiz.

Clipboard

True/False A student is asked to definewhether a statement is True orFalse.

Multiple Choice A student has several alternativesto choose from and with only onecorrect answer.

Multiple Response A student has several alternativesand more than one of them can bea correct answer.

Fill in the Blank A student should enter an answerin the blank. You can specifyseveral keys that are counted as a



correct answer. For example, forthe question #What is the star ofour system# you can set up #sun#,#Sun# and #the sun# as correctanswers.

Matching A student should match pairs.

Sequence A student should arrange the itemsin the required order.

Numeric A student should enter a number.You can set up whether it shouldbe an exact number, can begrater/less than a number or can befrom a specified interval.

QUESTION area

Each question could be accompanied with a picture or/and an audio.



To add an image/an audio to a certain question:

• Select the question in the QuizBuilder window.• Click Add Image/Add Audio button and browse for a picture/an audio file

To remove added image/audio:

• Select the question in the QuizBuilder window.• Click Delete to remove existing image/audio.

ANSWER area

Answer

Add Click to add an extra answer

Delete Click to remove the answer



Move Up Click to move the answer up

Move Down Click to move the answer down

OPTIONS area

Options

Use default option Tick this checkbox to apply default options settings(1 attempt; 10 points awarded per a correct answer;shuffled answers; partial answer - not allowed).

Attempts Specify the number of attempts possible

Points Specify the number of points given for a correctanswer

Shuffle answers Tick this checkbox to deliver answers in a shuffledorder

Allow partial answer Tick this checkbox to count a partial answer for thequestion

Preview question Click to preview the question

iSpring QuizBuilder is easy to customize. It is featuring various settings options as managingtiming, questions arrangements, feedback, quiz results and even player interface.

1.9.2.2. QuizBuilder - Settings

Main



Main

Quiz title Type your quiz name here

Randomize question order Tick this checkbox to shuffle question order

Passing score Specify passing score and select measurement (pointsor percentage)

Allow users to finish without answering allquestions

Tick this checkbox to allow quiz takers to quitwithout answering all the questions



Submit one question at a time Choosing this option you will get feedback messageright away

Submit all at once Choosing this option you will learn your total pointsin the end of the quiz

Submit one question at a time Choosing this option you will get feedback messageright away

Submit all at once Choosing this option you will learn your total pointsin the end of the quiz

Enable time limit Tick this checkbox to set the time limit

Display remaining time/elapsed time Tick this checkbox to display remaining/elapsed time

Display cumulative score with each question Tick this checkbox to display total score with eachquestion

Display question point value Tick this option to display the question point value

Question Defaults



Question Defaults

Points awarded Specify the number of points awarded per question

Attempts Choose the number of attempts to take the quiz here

Shuffle answers Tick this checkbox to shuffle the answers in a quiz

Allow partial answer Tick this checkbox to count partial answer for aquestion



Feedback

Feedback

Provide feedback Tick this checkbox to enable notification messages

Display correct/incorrect icons Click here to allow to display correct/incorrect icons

Display actual points awarded Click here to allow to display current points awarded



When answer is correct, display the following: Type in the message to be displayed when the answeris correct here

When answer is incorrect, display the following: Type in the message to be displayed when the answeris wrong here

When answer is partially correct, display thefollowing:

Type in the message to be displayed when the answeris partially correct

Result



Result

Enable Quiz Review Tick this checkbox to allow to review the quiz

Allow user to email result Tick this checkbox to allow quiz results emailing

NOTE: If this option is ticked, an authorization isasked when starting the quiz

Allow user to print result Tick this checkbox to allow quiz results printing



Display user score Tick this checkbox to allow the display of the quiztaker’s score

Display passing score Tick this checkbox to allow viewing the passingscore

Display pass/fail messages Tick this checkbox to allow displaying pass/failmessages

Display this message if the user passes: Type in the message to be displayed if the quiz iscompleted successfully

Display this message if the user fails: Type in the message to be displayed if the quiz is notcompleted

Perform the following actions when the “Finish”button is clicked:

Perform the following actions when the “Finish”button is clicked:

Send quiz result to email Tick this checkbox to automatically email the quizresult to (specify email address)

If user fails: Select either to close the window or send the quiztaker to web page (specify the URL in the spaceprovided) if he/she fails

If user passes: Select either to close the window or send the quiztaker to web page (specify the URL in the spaceprovided) if he/she passes

Player Customization



Player Customization

Color Color iSpring QuizBuilder provides 8 color schemesfor quiz Player. To customize player color click thearrow and select theme that fits your content the bestway from the drop-down menu. You can immediatelysee new player layout in the preview. To viewfull-size quiz, select a theme and click Preview.

Hue Drag the slider to pick out the right color



Saturation Drag the slider to regulate the saturation of the color

Lightness Drag the slider to regulate the lightness

Preview The preview window automatically displays thechanges in the color scheme of the quiz

Text Labels Change the labels names and popup messages inaccordance with your preferences. Please don'tchange elements in "%%" like %INDEX%.

Save as… Save the labels scheme

Load… Apply a ready-to-use labels scheme

1.10. ActionScript API References

1.10.1. iSpring ActionScript API

iSpring products provide PowerPoint to Flash conversion facilities on the highest level.Moreover, Flash content created with iSpring Presenter and iSpring SDK providesprogrammatic control facilities - it can be loaded and controlled by external Flash movies.

This article is a brief overview of the following topics:

• Presentation conversion modes• A solid Flash presentation• A compound Flash presentation• Standalone Flash slides

• Presentation playback control facilities• Slide playback control facilities• Skin development facilities

1.10.1.1. Presentation conversion modes overview

iSpring can convert PowerPoint presentations into one of the three following formats:

1. A Solid Flash Presentation. This is one solid Flash file containing player core, skin,preloader and presentation resources. Solid Flash presentation is the most compact typeof Flash presentations. It is optimized for progressive downloading and starts playing assoon the player core, the skin and data for the first slide are loaded. However, due to



Flash format limitations, it is suitable for small and medium size presentations (50-200slides). A Solid Flash Presentation structure is shown in the following picture.

Solid Flash Presentation structure

2. A Compound Flash Presentation. This type of presentation consists of the playbackmodule and a set of presentation resource files such as slides, thumbnails, sounds,presenter photo, company logo and presentation attachments. Playback module is a Flashfile containing the player core, the skin and the preloader. A compound presentationstructure is shown in the following picture.



http://www.adobe.com/go/tn_14437

Compound presentation structure

Since all presentation resources are stored in separate Flash files, the compound Flashpresentation allows playback of large presentations containing hundreds of slides. Sliderelated resources such as fonts and images are not shared between slide files (i.e. eachslide has its own copy for fonts and images) in comparison with Solid Flash presentation,so the overall size of a compound presentation is 50-120% larger than size of thecorresponding solid flash presentation.

3. Standalone Flash Slides. Each presentation slide is converted to the standalone Flashfile which can be played independently from other slides. However standalone slides donot play slide transition effects and do not perform slide switching. Standalone slides canbe loaded and managed by external Flash application, so this conversion mode is mainlysuitable for Flash developers. Standalone slide structure is shown in the picture below.



Standalone Slide Structure

The detailed description of the Flash Presentation Structure can be found in the followingarticle.

iSpring Presentation Structure

1.10.1.2. Presentation playback control facilities

Flash presentations created with iSpring can be controlled programmatically. For thispurposes solid and compound Flash presentations provide Flash Presentation ActionScriptAPI, a set of ActionScript 2.0 interfaces for controlling presentation playback andnavigation. The following article provides a detailed description of the Presentation APImethods and interfaces.

Flash Presentation ActionScript API Reference



1.10.1.3. Slide playback control facilities

Standalone slides provide Flash Slide ActionScript API, a set of ActionScript 2.0 interfacesfor controlling slide playback and navigation. The following article provides a detaileddescription of the Slide API.

Flash Slide ActionScript API Reference

1.10.1.4. Skin development facilities

iSpring generated presentation can be wrapped into a "skin", a special user interface modulewhich simplify presentation navigation displaying slide thumbnails and other navigationelements. There are several predefined skins providing various UI capabilities - from the"NullSkin" having no navigation elements to the "Advanced" one.

iSpring users are not limited by the set of predefined player skins. Skin modules can bedeveloped by any Flash developer familiar with ActionScript 2.0 and basic principles ofObject oriented programming. The following article describes the skin development process

Skin Development Reference

See also

Flash format limitationsFlash Presentation ActionScript API ReferenceFlash Slide ActionScript API ReferenceiSpring Presentation StructureSkin Development Reference

1.10.2. iSpring Presentation structure

Each iSpring generated Flash presentation consists of the following parts.

• Presentation assets• Player core module• Skin module

iSpring presentation structure is shown in the following diagram.




http://www.adobe.com/go/tn_14437

1.10.2.1. Presentation assets

Presentation assets are various multimedia resources containing within the presentation.When a presentation is a solid Flash movie file, all resources are stored within this fileoptimized for progressive downloading from the Internet. When a presentation is convertedto a set of Flash files with player, each resource is stored in a separate file.

1.10.2.2. Player core module

Player core is a Flash module which loads presentation assets and controls slide animationseffects, transition effects and sounds. Player core is a blackbox providing external Flash filesand skin modules with programmatic navigation and playback control via ActionScript API.



In order to load and play presentation slides the core needs a target MovieClip object whereslide assets are loaded. Since the location of this MovieClip depends on skin user interface,each skin module exposes the ISkin interface to inform the core about slide assets targetmovie clip.

1.10.2.3. Skin module

Skins are Flash modules which main responsibility is providing the player core with theMovieClip where slide assets should be loaded and displayed. Skins also provide viewerswith navigation and playback facilities. Skins interacts with the player core via ActionScriptAPI provided by player core.

There is a set of predefined skin modules with iSpring products. Some of them providesimple user interface while other skins provide full featured customizable User Interface.

It is possible to develop a customized skin module using Player Core ActionScript APIfunctionality. You can find more information in the Skin development article.



1.10.2.4. References

IPlayer InterfaceISkin InterfaceSkin developmentFlash Presentation ActionScript API Reference

1.10.3. Flash Presentation ActionScript API

1.10.3.1. Flash Presentation ActionScript API Reference

Solid and compound Flash presentations generated with iSpring contain the player exposingan ActionScript API which provides external Flash applications with programmatic access tothe Flash presentation:

• Presentation playback control - navigation by slides, animation steps, and position, abilityto play and pause presentation

• Sound volume control• Playback event notifications• Access to the presentation information

iSpring generated Flash presentations are able to start playing being loaded from the Internet;this significantly reduces the delay between the beginning of the loading and the first slideplayback. As soon as the player core and the first slide data are loaded, the getPlayer()function becomes available on the root MovieClip of the loaded Flash presentation. Thisfunction returns the fsplayer.api.IPlayer interface providing an access to the rest interfaces ofthe Flash presentation. There is the fsplayer.api.CPresentationLoader class which simplifiesloading of the the presentation and obtaining its fsplayer.api.IPlayer interface.

Flash Presentation ActionScript API interfaces are shown in the following diagram.



Flash Presentation ActionScript API diagram

The following table lists all interfaces and classes of the Flash Presentation ActionScript API.They are located within fsplayer.api package.

Name Description

CPresentationLoader Simplifies Flash presentation loading and providesaccess to its IPlayer interface.

IAnimationStep Provides the information about animation step timing

IAnimationSteps Stores a collection of the slide animation steps

ICompanyInfo Provides the information about company



ICompanyLogo Provides the information about company logotype

ICompanyLogoLoadingListener Receives company logo loading event notifications

IPlaybackListener Receives presentation playback event notifications

IPlayer Provides an access to the presentation playback core

IPlayerListener Receives player initialization event notifications

IPresentationInfo Provides an access to the presentation information

IPresentationPlaybackController Provides presentation navigation and playbackcontrol facilities

IPresenterInfo Provides the information about presenter

IPresenterPhoto Provides the information about presenter photo

IPresenterPhotoLoadingListener Receives the presenter photo loading eventnotifications

IReferenceInfo Provides the information about the particularpresentation reference

IReferencesCollection Stores a collection of presentation references

ISlideInfo Provides the information about the particular slide

ISlidesCollection Stores a collection of slides

ISlideThumbnail Provides the information about the particularthumbnail

ISlideThumbnailLoadingListener Receives thumbnail loading event notifications

ISoundController Provides sound control facilities

ISoundListener Receives sound event notifications



IThumbnailsCollection Stores a collection of thumbnails

See also

iSpring presentation structureiSpring ActionScript API

1.10.3.2. fsplayer.api.CPresentationLoader Class

This class extends the standard MovieClipLoader class available since Adobe Flash Player 7and simplifies the process of iSpring generated Flash movies loading.

This class is not a part of the ActionScript API provided by generated Flash movies. Asource code of this class is included into the fsplayer.api package.

The following methods and properties are provided by the CPresentationLoader class:

Methods

Method Description

CPresentationLoader() Class constructor. It is used to create instances of theCPresentationLoader class

setPlayerListener(listener:IPlayerListener):Void This method passes the IPlayerListener interface tothe loader. The passed listener object will receive anotification when player is initialized

loadClip(url:String, target:MovieClip):Void This method loads iSpring generated presentationinto the specified movie clip

Properties

Property Type Description

player IPlayer Returns the reference to the playerin loaded Flash presentation

bytesLoaded Number Returns number of loaded bytes ofthe Flash presentation

bytesTotal Number Returns total number of bytes ofthe Flash presentation



Samples

The following example illustrates the usage of the CPresentationLoader class.import fsplayer.api.*;

var loader:CPresentationLoader = new CPresentationLoader();

// this object (in our case it is _root MovieClip) will listening to theplayerloader.setPlayerListener(this);

// load generated Flash presentationloader.loadClip("presentation.swf", presentation);

// this method is invoked when player gets initializedfunction onPlayerInit(p:IPlayer):Void{

// add your extra initialization code here}

See also

IPlayer InterfaceIPlayerListener InterfaceFlash Presentation ActionScript API Reference

1.10.3.3. fsplayer.api.IAnimationStep Interface

The IAnimationStep Interface provides the information about animation step timings. Itexposes the following methods:

Methods

Method Description

getPlayTime():Number Returns animation step play time (see the remarkssection)

getPauseTime():Number Returns animation step pause time (see the remarkssection)

getStartTime():Number Returns animation step start time (see the remarkssection)

getPauseStartTime():Number Returns animation step pause start time (see theremarks section)



getPauseEndTime():Number Returns animation step pause end time (see theremarks section)

Remarks

Each slide consists of one or more animation steps with the following structure.

Animation step structure

An Animation step starts playing at the Step start time. Animations are playing for the Playtime. Then, at the Pause start time, animations are suspended for the Pause time period tillthe Pause end time. Pause time depends on slide timings that were set using "Recordnarration" or "Rehearse timings" menu of PowerPoint.

stepStartTime0 = 0

pauseStartTimei = stepStartTimei + playTimeipauseEndTimei = pauseStartTimei + pauseTimeistepStartTimei+1 = pauseEndTimei



If the slide has no timings (i.e. user has to click slide background to advance mouse-drivenanimations), Pause time and Pause end time are undefined. In this case returned timings areas follows:

pauseStartTimei = stepStartTimei + playTimeipauseEndTimei = undefined

stepStartTimei+1 = pauseStartTimei

See also

IAnimationSteps InterfaceFlash Presentation ActionScript API Reference

1.10.3.4. fsplayer.api.IAnimationSteps Interface

The IAnimationSteps Interface provides the information about animation steps on the slide.

Methods

Method Description

getStepsCount():Number Returns number of animation steps on the slide

getDuration():Number Returns the total duration of animation steps inseconds. The duration of animation steps is equal tothe duration of the slide

getStep(index:Number):IAnimationStep Returns the IAnimationStep Interface providing theinformation about animation step timings

Remarks

Slide animation timeline consists of one or more animation steps. Animation step is asequence of animation effects playing without mouse click requirement.

Slide background, static shapes, and shapes animated before the first mouse driven animationare playing at the animation step 0. So there is at least 1 animation step in each slide.

Each mouse-driven animation along with the subsequent non mouse-driven animations areplaying at the separate animation step. In other words, the number of animation steps is equalto number of on-click animations plus 1.

Example



There are 4 animation effects in the following slide. They are represented by 3 animationsteps in the generated Flash presentation (click to start animations).

• Effect 1 starts "With previous" animation effect. It is played at animation step 0• Effects 2 and 3 start "On Click". They are played at animation steps 1 and 2• Effect 4 starts "After previous" animation effect. It is played at animation step 2 after

Effect 3.

See also

IAnimationStep InterfaceISlideInfo InterfaceFlash Presentation ActionScript API Reference

1.10.3.5. fsplayer.api.ICompanyInfo Interface



The ICompanyInfo Interface provides the following methods for retrieving companyinformation:

Methods

Method Description

hasLogo():Boolean Indicates whether the company has logo

getLogo():ICompanyLogo Returns the ICompanyLogo interface providinginformation about company logotype

See also

ICompanyLogo InterfaceIPresentationInfo InterfaceFlash Presentation ActionScript API Reference

1.10.3.6. fsplayer.api.ICompanyLogo Interface

The ICompanyInfo Interface provides the following methods for retrieving company logoinformation:

Methods

Method Description

load(target:MovieClip,[listener:ICompanyLogoLoadingListener]):Void

Loads company logo into the specified MovieClip.The listener is an optional parameter which willreceive notification when company logo is loaded

getHyperlinkURL():String Returns a web page URL, for example, the companyweb site address, which should be opened when userclicks the company logo.Note: An empty string indicates that no hyperlink isattached to the company logo

getHyperlinkTarget():String Returns the target window name ("_self", "_blank","_parent", "_top", or custom window name) wherecompany logo hyperlink should be opened

See also



ICompanyInfo InterfaceICompanyLogoLoadingListener InterfaceFlash Presentation ActionScript API Reference

1.10.3.7. fsplayer.api.ICompanyLogoLoadingListener Interface

The ICompanyLogoLoadingListener Interface is used to receive the notification thatcompany logo has been loaded. This interface exposes the following methods.

Methods

Method Description

onCompanyLogoLoadInit():Void Invoked when the company logo has been loaded

This interface is mainly used for the development of a custom skin displaying company logo.It allows getting a notification that the company logo has been loaded in order to update skinlayout at the proper time.

Usually you need to create a class implementing this interface and pass its instance to theload() method of ICompanyLogo interface.

Sampes

The following example illustrates how to load and place the company logo within targetMovieClip.

import fsplayer.api.*;

class MyCompanyLogoPanel implements ICompanyLogoLoadingListener{

private var m_target:MovieClip;private var m_logo:MovieClip;

MyCompanyLogoPanel(target:MovieClip, logo:ICompanyLogo){

m_target = target;m_logo = target.createEmptyMovieClip("logo",

target.getNextHighestDepth());

logo.load(target, this);}

// implementation ofICompanyLogoLoadingListener.onCompanyLogoLoadInit() method

function onCompanyLogoLoadInit():Void{



// company logo has been loaded. We need to update its positionwith the target MovieClip

centerLogo();}

function centerLogo(){

var logoWidth:Number = m_logo._width;var logoHeight:Number = m_logo._height;

m_logo._x = (m_target._width - logoWidth) / 2;m_logo._y = (m_target._height - logoHeight) / 2;

}}

See also

ICompanyLogo InterfaceFlash Presentation ActionScript API Reference

1.10.3.8. fsplayer.api.IPlaybackListener Interface

There are various events occurring during presentation playback. The playback controllernotifies external objects about these events via IPlaybackListener interface. This interfacedefines a set of methods which are invoked by playback controller when the correspondingevents occur. These methods are as follows.

Methods

Method Description

onPausePlayback():Void Invoked when presentation playback is suspended

onStartPlayback():Void Invoked when presentation playback is resumed

onAnimationStepChanged(stepIndex:Number):Void Invoked when slide animation step is changed duringplayback

onSlidePositionChanged(position:Number):Void Invoked when playback position is changed duringplayback

onCurrentSlideIndexChanged(slideIndex:Number):VoidInvoked when slide switching occurs

onSlideLoadingComplete(slideIndex:Number):Void Invoked when slide loading is completed



onPresentationPlaybackComplete():Void Invoked at the end of presentation playback

In order to receive event notifications you need to create a class which implementsIPlaybackListener interface and pass the instance of this class to the addListener method ofthe IPresentationPlaybackController interface.

Samples

The following example illustrates the simplest implementation of IPlaybackListenerinterface.

Create MyPlaybackListener.as source file with the following content.


class MyPlaybackListener implements IPlaybackListener{

function onPausePlayback():Void{

trace("Presentation has been paused");}

function onStartPlayback():Void{

trace("Presentation playback was started");}

function onCurrentSlideIndexChanged(slideIndex:Number):Void{

trace("Current slide index has been changed to " + slideIndex);}

function onSlideLoadingComplete(slideIndex:Number):Void{

trace("Slide " + slideIndex + " has been just loaded");}

function onSlidePositionChanged(position:Number):Void{

trace("Current slide playback position was changed to " +position);

}

function onPresentationPlaybackComplete():Void{

trace("Presentation playback has been completed");}

function onAnimationStepChanged(stepIndex:Number):Void{

trace("Animation step index has been changed to " + stepIndex);



}}

Usage of MyPlaybackListener class:

import fsplayer.api.*;import MyPlaybackListener;

var presentation:MovieClip = this.createEmptyMovieClip("presentation", 1);

var loader:CPresentationLoader = new CPresentationLoader()loader.setPlayerListener(this);loader.loadClip("c:\\test.swf", presentation);

function onPlayerInit(player:IPlayer){

var listener:MyPlaybackListener = new MyPlaybackListener();player.getPlaybackController().addListener(listener);

}

Instead of implementing IPlaybackListener interface it is also possible to create an Objectinstance with a subset of IPlaybackListener functions and pass it to the addListener()method as it is shown in the following example:


var presentation:MovieClip = this.createEmptyMovieClip("presentation", 1);

var loader:CPresentationLoader = new CPresentationLoader()loader.setPlayerListener(this);loader.loadClip("c:\\test.swf", presentation);

function onPlayerInit(player:IPlayer){

var listener = new Object();listener.onCurrentSlideIndexChanged = function(index:Number):Void{

trace("Current slide index has been changed to " + index);}

player.getPlaybackController().addListener(listener);}

See also

IPresentationPlaybackController InterfaceFlash Presentation ActionScript API Reference

1.10.3.9. fsplayer.api.IPlayer Interface



iSpring generated Flash presentations contain an embedded player which plays slideanimations, transition effects and sounds. This player exposes an ActionScript 2.0 APIavailable to external Flash applications.

The IPlayer interface is provided by Flash presentations generated with iSpring. It exposesthe following methods:

Methods

Method Description

isInitialized():Boolean Returns a Boolean value indicating whether theplayer was initialized.The following methods return an undefined valueuntil the player gets initialized:

• getPresentationInfo()• getPlaybackController()• getSoundController()• getSettings()

addListener(listener:IPlayerListener):Void Adds an external listener object implementing theIPlayerListener interface to the player. The passedlistener object will receive notifications from theplayer

removeListener(listener:IPlayerListener):Void Removes the listener object added earlier withaddListener() method

getPlaybackController():IPresentationPlaybackControllerReturns the IPresentationPlaybackControllerinterface providing presentation playback control andnavigation facilites

getSoundController():ISoundController Returns the ISoundController interface providingsound volume control facilities

getPresentationInfo():IPresentationInfo Returns the IPresentationInfo interface providing thepresentation content information

getSettings():Object Returns an Object storing playback and navigationsettings as well as skin related settings (see theremarks section)This method is mainly used for the custom skinsdevelopment. In most cases you don't need to use it.



getSkin():ISkin Returns the ISkin interface of the player

Remarks

An object returned by the getSettings() method contains a set of implementation specificproperties. Currently, this object has the following structure:

• navigation (Object) - the set of navigation properties:• keyboard (Object) - keyboard navigation properties:

• enabled (String) - determines whether keyboard navigation is enabled ("1") or not

• mouse (Object) - mouse navigation properties• enabled (String) - determines whether navigation by mouse clicks on the slide

background is enabled ("1")or not• target (String) - determines whether the mouse click navigation is performed by

slides ("slide") or steps ("step")

• colorScheme (Object) - color cheme settings:• primaryColor (String) - this property is obsolete and must not be used in new skins

• appearance (Object) - appearance settings:• fullScreen (String) - determines whether player window is opened full screen ("1") or

not

• playback (Object) - playback settings:• autoStart (String) - determines whether the player starts presentation playback

automatically ("1" or undefined) or not

• webLinks (Object) - the set of external web links related to the presentation:• slideAreaLink (Object) - web link related to the slide area

• href (String) - web page reference, e.g. "http://www.ispringsolutions.com"• target (String) - target window, e.g. "_self", "_blank", "_parent" or custom

window name

• presentationEndLink (Object) - web link related to the presentation finish event• href (String) - web page reference, e.g. "http://www.ispringsolutions.com• target (String) - target window, e.g. "_self", "_blank", "_parent" or custom

window name

See also

IPlayerListener Interface



IPresentationPlaybackController InterfaceISoundController InterfaceIPresentationInfo InterfaceISkin InterfaceFlash Presentation ActionScript API Reference

1.10.3.10. fsplayer.api.IPlayerListener Interface

The IPlayerListener interface is used to receive the notification that the player has beeninitialized. Until the player gets initialized it is not possible to control presentation playbackor get presentation information.

The IPlayerListener interface declares the following method.

Methods

Method Description

onPlayerInit(player:IPlayer):Void This method is invoked when the player initializationis complete.

Usually a class implementing the IPlayerListener interface is created.

import fsplayer.api.IPlayerListener;import fsplayer.api.IPlayer;

class MyPlayerListener implements IPlayerListener{

// ...

function onPlayerInit(player:IPlayer):Void{

// write your player initialization handler here}

// ...}

Then the instance of MyPlayerListener object is passed to addListener() method of theIPlayer interface or to the setPlayerListener() method of the CPresentationLoader classwhich simplifies this process.import fsplayer.api.IPlayer;import MyPlayerListener;import fsplayer.api.CPresentationLoader;

// create instances of the presentation loader and the player listener



objectsvar loader:CPresentationLoader = new CPresentationLoader();var listener:MyPlayerListener = new MyPlayerListener();

// pass the listener object to the loaderloader.setPlayerListener(listener);

// create a MovieClip instance where the presentation will be loadedvar presentationMC:MovieClip = this.createEmptyMovieClip("presentation",1);

// load the presentationloader.loadClip("presentation.swf", presentationMC);

See also

IPlayer InterfaceFlash Presentation ActionScript API Reference

1.10.3.11. fsplayer.api.IPresentationInfo Interface

The IPresentationInfo Interface provides the following methods about the presentation:

Methods

Method Description

getTitle():String Returns presentation title

getSlides():ISlidesCollection Returns ISlidesCollection interface providinginformation about presentation slides

getSlideWidth():Number Returns slide width in pixels

getSlideHeight():Number Returns slide height in pixels

hasThumbnails():Boolean Indicates whether the presentation contains thumbnailimages

getThumbnails():IThumbnailsCollection Returns IThumbnailsCollection interface that allowsto get information about presentation thumbnails

hasPresenter():Boolean Indicates whether the presentation has got presenterinformation

getPresenterInfo():IPresenterInfo Returns the IPresenterInfo interface which provides



the information about presentation presenter

getFrameRate():Number Returns presentation frame rate (number of framesper second)

getDuration():Number Returns presentation duration in seconds

hasCompanyInfo():Boolean Indicates whether the presentation contains companyinformation

getCompanyInfo():ICompanyInfo Returns the ICompanyInfo interface providingcompany information

hasReferences():Boolean Indicates whether the presentation containsreferences

getReferences():IReferencesCollection Returns the IReferencesCollection interfaceproviding the information about presentationreferences

See also

ICompanyInfo InterfaceIPresenterInfo InterfaceIReferencesCollection InterfaceISlidesCollection InterfaceIThumbnailsCollection InterfaceFlash Presentation ActionScript API Reference

1.10.3.12. fsplayer.api.IPresentationPlaybackController Interface

The IPresentationPlaybackController interface provides methods for presentationplayback and navigation control. This interface can be obtained by calling thegetPlaybackController() method on IPlayer interface.

Methods

Method Description

addListener(listener:IPlaybackListener):Void Adds an external listener object implementing theIPlaybackListener interface; the passed object will benotified about presentation playback events



removeListener(listener:IPlaybackListener):Void Removes previously added listener object. Thepassed object won't receive notifications from theplayer any more

isPlaying():Boolean Returns a Boolean value indicating whether thepresentation is playing or not

getCurrentSlideDuration():Number Returns current slide duration in seconds

play():Void Resumes presentation playback

pause():Void Suspends presentation playback

gotoNextSlide([autoStart:Boolean = true]):Void Switches to the next presentation slide and starts itsplayback.Note: if the autoStart parameter was set to false, slideplayback would not be started after switching

gotoPreviousSlide([autoStart:Boolean = true]):Void Switches to the previous presentation slide and startsits playback.Note: if the autoStart parameter was set to false, slideplayback would not be started after switching

gotoLastViewedSlide([autoStart:Boolean =true]):Void

Switches to the previously viewed slide and starts itsplayback.Note: if the autoStart parameter was set to false,slide playback would not be started after switching

getCurrentSlideIndex():Number Returns a zero-based index of currently playing slide

gotoSlide(slideIndex:Number, [autoStart:Boolean =true]):Void

Switches to the given slide of the presentation andstarts its playbackNotes: Slide index is zero-based.If the autoStart parameter was set to false, slideplayback would not be started after switching

getCurrentSlidePlaybackPosition():Number Returns playback position within current slide.Note: playback position is a number between 0 and 1

pauseCurrentSlideAt(position:Number):Void Suspends currently playing slide at the given positionNote: position is a number in between 0 and 1



playCurrentSlideFrom(position:Number):Void Restarts current slide from the given position.Note: position is a number between 0 and 1

seek(position:Number):Void Seeks the current slide to the given position. Afterthis operation slide playback gets suspended until theendSeek() method or other playback control methodis calledNote: position is a number between 0 and 1

endSeek([resumePlayback:Boolean =undefined]):Void

Exits from seeking mode and restores playback.Note: the resumePlayback parameter allows to startor pause slide after seeking explicitly

getCurrentStepIndex():Number Returns current animation step index

gotoNextStep():Void Plays current slide from the beginning of the nextanimation step.Note: being called at the end of the slide this methodplays presentation from the beginning of the nextslide

gotoPreviousStep():Void Moves slide playback one step back. This methodsuspends slide playback at the end of the previousanimation step.Note: being called on the start slide step this methodcauses playback switching to the end of the previousslide

setAnimationStepPause(pause:Number):Void This method allows setting a pause betweenanimation steps. If an undefined value is passed aspause value, animation steps will not be playedautomatically

playFromStep(stepIndex:Number):Void Plays current slide from the beginning of thespecified animation step

pauseAtStepStart(stepIndex:Number):Void Suspends current slide at the beginning of thespecified animation step

pauseAtStepEnd(stepIndex:Number):Void Suspends current slide at the end of specifiedanimations step

enableAutomaticSlideSwitching(enableSwitching:Boolean):VoidEnables or disables automatic switching to the next



slide.Note: this method affects automatically switchingslides only.

getAutomaticSlideSwitching():Boolean Returns true if automatic slide switching has beenenabled, false otherwise.Note: automatic slide switching is enabled by default

See also

IPlaybackListener InterfaceIPlayer InterfaceFlash Presentation ActionScript API Reference

1.10.3.13. fsplayer.api.IPresenterInfo Interface

The IPresenterInfo interface provides the following methods for presenter informationretrieving:

Methods

Method Description

getName():String Returns presenter name

getTitle():String Returns presenter title

getBiographyText():String Returns brief information about the presenter

getEmail():String Returns presenter email address

getWebSite():String Returns presenter web site address

hasPhoto():Boolean Indicates whether the presenter has photo

getPhoto():IPresenterPhoto Returns the IPresenterPhoto interface which allows toload presenter photo

See also

IPresentationInfo InterfaceIPresenterPhoto Interface



Flash Presentation ActionScript API Reference

1.10.3.14. fsplayer.api.IPresenterPhoto Interface

The IPresenterPhoto interface allows to load presenter photo.

Methods

Method Description

load(target:MovieClip,listener:IPresenterPhotoLoadingListener):Void

This method loads presenter photo into the specifiedtarget MovieClip (see the remarks section for moredetails). The listener will be notified when presenterphoto is loaded

Remarks

The IPresenterPhoto interface provides a unified way of the presenter photo loading nometter if the presentation has been exported into a solid Flash file, or into a set of Flash fileswith a player.

It is highly recommended that the target MovieClip resides within the skin MovieClip.

See also

IPresenterInfo InterfaceIPresenterPhotoLoadingListener InterfaceFlash Presentation ActionScript API Reference

1.10.3.15. fsplayer.api.IPresenterPhotoLoadingListener Interface

The IPresenterPhotoLoadingListener Interface is used to receive the notification that thepresenter photo has been loaded. This interface exposes the following methods.

Methods

Method Description

onPresenterPhotoLoadInit():Void This method is invoked when the presenter photo hasbeen loaded.The load() method of the IPresenterPhoto interfaceloads the presenter photo into the specified targetMovieClip



See also

IPresenterPhoto InterfaceFlash Presentation ActionScript API Reference

1.10.3.16. fsplayer.api.IReferenceInfo Interface

The IReferenceInfo Interface provides the following methods for retrieving referenceinformation:

Methods

Method Description

getTitle():String Returns reference title

getURL():String Returns reference URL

getTarget():String Returns target window name where the referenceshould be opened

See also

IReferencesCollection InterfaceFlash Presentation ActionScript API Reference

1.10.3.17. fsplayer.api.IReferencesCollection Interface

The IReferencesCollection Interface provides the following methods for retrieving thepresentation references information:

Methods

Method Description

getCount():Number Number of references in the collection

getReference(index:Number):IReferenceInfo Returns IReferenceInfo interface providing theinformation about the specified reference.Note: the index parameter is an integer value from 0to (number of references - 1)

See also



IReferenceInfo InterfaceIPresentationInfo InterfaceFlash Presentation ActionScript API Reference

1.10.3.18. fsplayer.api.ISlideInfo Interface

The ISlideInfo Interface provides information about the particular slide of the presentationsuch as title, duration, text, etc. It exposes the following methods.

Methods

Method Description

isLoaded():Boolean Returns Boolean value indicating whether the slidehas been loaded completely

getTitle():String Returns slide title

getAnimationSteps():IAnimationSteps Returns IAnimationSteps interface providing theinformation about slide animation steps

getDuration():Number Returns slide duration in seconds

getNotesText():String Returns text of the slide notes

getStartTime():Number Returns slide start time within the presentationtimeline

getEndTime():Number Returns slide end time within the presentationtimeline

getStartStepIndex():Number Returns slide start step index within the presentation

getEndStepIndex():Number Returns slide end step index within the presentation

getSlideText():String Returns slide text in the normalized form (see theremarks section)

getNotesTextNormalized():String Returns text of the slide notes in the normalizedform (see the remarks section)



getTitleNormalized():String Returns slide title in the normalized form (see theremarks section)

Remarks

Normalized strings are strings having all characters in the lower case with no extra spacesbetween words. This simplifies and speeds up full text search implementation.

See also

IAnimationSteps InterfaceISlidesCollection InterfaceFlash Presentation ActionScript API Reference

1.10.3.19. fsplayer.api.ISlidesCollection Interface

The ISlidesCollection interface represents a collection of presentation slides. It provides thefollowing methods:

Methods

Method Description

getSlidesCount():Number Returns number of slides in the presentation

getSlideInfo(slideIndex:Number):ISlideInfo Returns ISlideInfo Interface which represents anindividual presentation slide with the specified slideindex.Note: Slide index is zero-based

See also

IPresentationInfo InterfaceISlideInfo InterfaceFlash Presentation ActionScript API Reference

1.10.3.20. fsplayer.api.ISlideThumbnail Interface

The ISlideThumbnail interface provides the information about the particular presentationthumbnail and provides method for thumbnail loading into the specified MovieClip.

Methods



Method Description

getSlideIndex():Number Returns slide index the thumbnail corresponds to

load(target:MovieClip,[listener:ISlideThumbnailLoadingListener]):Void

Loads the thumbnail image into the target MovieClip.When the thumbnail is loaded, the notification will besent to the passed listener interface.The target parameter is a MovieClip within the skinMovieClip (see the remarks section)

Remarks

When the presentation is wrapped into a skin which supports thumbnails (Classic, Crystal,Advanced or Lite), iSpring generates thumbnails in one of the following ways:

• When the presentation is exported into a solid Flash movie, iSpring stores Flashpresentation thumbnails as internal Flash movie assets. Such assets are created usingMovieClip.attachMovie() method.The reason for the target parameter of the load() method restriction is as follows:thumbnails, the skin and the player core are located within the same Flash file, sothumbnails assets are accessible within that Flash file only.

• When the presentation is exported into a set of Flash files with player, each thumbnail issaved into a separate Flash file. Such assets are loaded using MovieClip.loadMovie()method or via MovieClipLoader class.

The ISlideThumbnail interface provides skins with the unified way of internal and externalthumbnails loading. Thumbnails are loaded in the proper way by player core. The core alsonotifies skin when the particular thumbnail is loaded via theISlideThumbnailLoadingListener Interface.

See also

ISlideThumbnailLoadingListener InterfaceIThumbnailsCollection InterfaceFlash Presentation ActionScript API Reference

1.10.3.21. fsplayer.api.ISlideThumbnailLoadingListener Interface

The IPresenterThumbnailLoadingListener Interface is used to receive the notification thatthe slide thumbnail has been loaded. This inteface exposes the following methods:

Methods



Method Description

onSlideThumbnailLoadInit(thumbnail:ISlideThumbnail):VoidInvoked when the thumbnail has been loaded. Thethumbnail parameter can be used to determine theindex of the loaded slide

See also

ISlideThumbnail InterfaceFlash Presentation ActionScript API Reference

1.10.3.22. fsplayer.api.ISoundController Interface

The ISoundController Interface provides the following methods for sound control.

Methods

Method Description

addListener(listener:ISoundListener):Void Adds an external object implementingISoundListener interface which will receive soundcontroller notifications

removeListener(listener:ISoundListener):Void Removes the previously added listener. The passedobject will stop receiving sound controllernotifications

getVolume():Number Returns current sound volume.Note: sound volume is a number between 0 and 1

setVolume(volume:Number):Void Sets sound volume.Note: sound volume is a number between 0 and 1

tweak(parameterName:String,parameterValue:Object):Void

Tweaks the implementation specific parameter of thesound controller.See the list of currently supported parameters in theRemarks section

getTweakableParameter(parameterName:String):ObjectReturns the value of the implementation specificparameter.See the list of currently supported parameters in theRemarks section



Remarks

Currently supported tweakable parameters are as follows:

Parameter name Type Default value Description

blinkSounds Boolean true Sound blinking is asound shutdown for ashort period of time(less than 1/100 ofsecond) during slideswitching.This technique is usedonly when the slidecontaining anembedded Flashmovie is changed bysome other slide.The reason for usingthis trick is thatembedded Flash filescan play sounds bytheir own and there isthe only way to preventpossible sound issues.Sometimes this featurecan be undesirableand can be turned offby setting theblinkSound parameterto false

See also

IPlayer InterfaceISoundListener InterfaceFlash Presentation ActionScript API Reference

1.10.3.23. fsplayer.api.ISoundListener Interface

The ISoundListener interface defines the following set of methods invoked by soundcontroller when the corresponding events occur.

Methods

Method Description



onSoundVolumeChanged(soundController:ISoundController):VoidThis method is invoked when sound volume ischanged. Use getVolume() method of the passedISoundController interface to get new volume

In order to receive sound notifications you need to create a class which implementsISoundListener interface and pass it to the addListener() method of the ISoundControllerInterface.

See also

ISoundController InterfaceFlash Presentation ActionScript API Reference

1.10.3.24. fsplayer.api.IThumbnailsCollection Interface

The IThumbnailsCollection Interface represents a collection of slide thumbnails. It providesthe following methods for retrieving thumbnail dimensions and accessing individualthumbnails.

Methods

Method Description

getThumbnail(slideIndex:Number): ISlideThumbnail Returns the ISlideThumbnail interface representingthe particular presentation thumbnail withinthumbnails collection

getThumbnailWidth():Number Returns thumbnail width in pixels

getThumbnailHeight():Number Returns thumbnail height in pixels

getThumbnailsCount():Number Returns the number of thumbnails in the presentation.Note: The number of thumbnails is the same as thenumber of slides within the presentation. If thepresentation skin doesn't support thumbnails or if thethumbnails were turned off in skin settings, thenumber of thumbnails is equal to 0

Remarks

The IThumbnailsCollection interface is mainly used for the development of custom skinssupporting thumbnails.

See also



ISlideThumbnail InterfaceIPresentationInfo InterfaceFlash Presentation ActionScript API Reference

1.10.3.25. ActionScript 3 and Flex 2 support

ActionScript 3 and Flex support in iSpring

This article describes the way of the iSpring generated presentations communication withFlash applications written in ActionScript 3 and Flex.

Table of contents:

• ActionScript 3.0 and ActionScript 2.0 communication• ActionScript 3 bridge communication module API• Integration with Flex applications• Samples

• ActionScript 3 sample source code• ActionScript 3 communication demo• Adobe Flex communication demo

• References

ActionScript 3.0 and ActionScript 2.0 communication

iSpring generated Flash presentations provide ActionScript 2.0 API. Being loaded by Flash9 or Flex applications which use ActionScript 3, this API is not accessible anymore -ActionScript 2 and ActionScript 3 object model are not compatible; Flash movies version 8or below work in isolated environment within Flash 9 (AS3) and Flex applications.

However, there is a way AS2 and AS3 Flash movies can communicate. It is aLocalConnection class usage. One Flash movie creates a named LocalConnection object,defines some functions in it and calls connect() method:

var lc:LocalConnection = new LocalConnection();lc.sayHello = function(name:String):Void{

trace("Hello, " + name + "!");}

lc.connect("connectionName");

Another Flash movie calls these methods using send() method:



http://livedocs.adobe.com/flash/mx2004/main_7_2/wwhelp/wwhimpl/common/html/wwhelp.htm?context=Flash_MX_2004&file=00001421.html

var lc:LocalConnection = new LocalConnection();lc.send("connectionName", "sayHello", "John Smith");

The first Flash movie will receive and execute commands froth the second. When a two-wayinteraction is needed, each Flash movie must create 2 LocalConnection objects: oneconnection to send commands and another one to receive them.

There is one thing which must be taken into account. It is possible to create only 1LocalConnection with a given name on the same PC. So it is recommended to generateconnection name based on some random information such as date. The sending Flash movieneeds a connection name of the receiving Flash movie. This connection name can be passedas an URL parameter:var lc:LocalConnection = new LocalConnection();lc.sayHello = function(name:String):Void{

trace("Hello, " + name + "!");}

// generate connection name which is most likely uniquevar connectionName:String = "conn" + (new Date().getTime());lc.connect(connectionName);var childMove:MovieClip = this.createEmptyMovieClip("mc",this.getNextHighestDepth());

// load child movie and pass the connection name in URL parameterchildMovie.loadMovie("someMovie.swf?lcid=" + escape(connectionName));

A child Flash movie gets the connection name from URL variables:

var lc:LocalConnection = new LocalConnection();lc.send(this.lcid, "sayHello", "John Smith");

A similar way of Flash movies interaction can be used to establish communication betweenActionScript 3 Flash movie and iSpring generated presentations. Flash9 / Flex applicationloads a special bridge SWF module written in ActionScript 2 which loads the presentation.This bridge module communicates with the presentation using its ActionScript API; fromthe other hand the bridge communicates with Flash 9 / Flex application usingLocalConnection. This process is illustrated in the following diagram.



ActionScript 3 <-> iSpring presentation communication

ActionScript 3 bridge communication module API

A bridge communication module (with source code) is included in iSpring Presenter andiSpring SDK samples. There is also a set of ActionScript 3 classes providing ActionScript 3API simplifying communication with iSpring presentations.



http://www.ispringsolutions.com/products/ispring_presenter.html

http://www.ispringsolutions.com/products/ispring_sdk.html

iSpring ActionScript 3 bridge API

Class name Description

AnimationStep Provides the information about animation step timing

AnimationSteps Stores a collection of the slide animation steps

BridgeEvent Stores the information about events occurringduriong presentation loading and playback

BridgeLoader Loads the presentation using bridge communicationmodule.



PlaybackController Receives presentation playback event notifications

Player Provides an access to the presentation playback core

PresentationInfo Provides an access to the presentation information

PresenterInfo Provides the information about presenter

ReferenceInfo Provides the information about the particularpresentation reference

ReferencesCollection Stores a collection of presentation references

SlideInfo Provides the information about the particular slide

SlidesCollection Stores a collection of slides

SoundController Provides sound control facilities

Integration with Flex applications

iSpring generated presentations can be easily integrated with Flex applications usingispring.flex.PresentationContainer class. This class extends the standardmx.core.UIComponent class.

Samples

The following example illustrates the usage of the AS3 bridge module in Adobe Flash CS3:

import ispring.as3bridge.*;import flash.display.*;import flash.events.*;

var player:Player;

if (flash.system.Capabilities.playerType == "External"){

writeLog("This example will work in browser plugin, ActiveX orStandalone Flash player");

return;}



http://livedocs.adobe.com/flex/2/langref/mx/core/UIComponent.html

// create target spritevar target:Sprite = new Sprite();addChild(target);

// load bridgevar loader:BridgeLoader = new BridgeLoader(target);loader.addEventListener(BridgeEvent.PLAYER_INIT, onPlayerInit);player = loader.loadPresentation("as3bridge.swf", "presentation.swf");

function onPlayClick(e:MouseEvent):void{

player.playbackController.play();}

function onPauseClick(e:MouseEvent):void{

player.playbackController.pause();}

function onPlayerInit(e:BridgeEvent):void{

writeLog("Player initialized");player.playbackController.addEventListener(BridgeEvent.SLIDE_CHANGE,

onSlideChange);

playButton.buttonMode = true;playButton.addEventListener(MouseEvent.CLICK, onPlayClick);pauseButton.buttonMode = true;pauseButton.addEventListener(MouseEvent.CLICK, onPauseClick);

}

function onSlideChange(e:BridgeEvent):void{

writeLog("current slide: " + e.slideIndex);}

function writeLog(txt:String):void{

log.appendText((log.text.length == 0) ? txt : "\n" + txt);log.scrollV = log.maxScrollV;

}

ActionScript 3 communication demo



ActionScript 3 example

Adobe Flex communication demo



Flex example

References

AnimationStep ClassAnimationSteps ClassBridgeEvent ClassBridgeLoader ClassPlaybackController ClassPlayer ClassPresentationContainer Class



PresentationInfo ClassPresenterInfo ClassReferenceInfo ClassReferencesCollection ClassSlideInfo ClassSlidesCollection ClassSoundController ClassiSpring ActionScript API

iSpring.as3bridge.AnimationStep Class

The AnimationStep class provides the information about animation step timings. It exposesthe following properties:

Properties


playTime Number Animation step play time (see theremarks section)

pauseTime Number Animation step pause time (see theremarks section)

startTime Number Animation step start time (see theremarks section)

pauseStartTime Number Animation step pause start time(see the remarks section)

pauseEndTime Number Animation step pause end time(see the remarks section)

Remarks

Each slide consists of one or more animation steps with the following structure.



Animation step structure

An Animation step starts playing at the Step start time. Animations are playing for the Playtime. Then, at the Pause start time, animations are suspended for the Pause time period tillthe Pause end time. Pause time depends on slide timings that were set using "Recordnarration" or "Rehearse timings" menu of PowerPoint.

stepStartTime0 = 0

pauseStartTimei = stepStartTimei + playTimeipauseEndTimei = pauseStartTimei + pauseTimeistepStartTimei+1 = pauseEndTimei

If the slide has no timings (i.e. user has to click slide background to advance mouse-drivenanimations), Pause time and Pause end time are undefined. In this case returned timings areas follows:

pauseStartTimei = stepStartTimei + playTimeipauseEndTimei = undefined



stepStartTimei+1 = pauseStartTimei

See also

AnimationSteps ClassActionScript 3 and Flex support in iSpring

iSpring.as3bridge.AnimationSteps Class

The AnimationSteps Class provides the information about animation steps on the slide.

Properties


duration Number The total duration of animationsteps in seconds. The duration ofanimation steps is equal to theduration of the slide

stepsCount Number Number of slide animation steps

Methods

Method Description

getStep(index:Number):AnimationStep Returns the AnimationStep Class providing theinformation about animation step timings

Remarks

Slide animation timeline consists of one or more animation steps. Animation step is asequence of animation effects playing without mouse click requirement.

Slide background, static shapes, and shapes animated before the first mouse driven animationare playing at the animation step 0. So there is at least 1 animation step in each slide.

Each mouse-driven animation and the subsequent non mouse-driven animations are playingat the separate animation step. In other words, the number of animation steps is equal tonumber of on-click animations plus 1.

Example

There are 4 animation effects in the following slide. They are represented by 3 animation



steps in the generated Flash presentation (click to start animations).

• Effect 1 starts "With previous" animation effect. It is played at animation step 0• Effects 2 and 3 start "On Click". They are played at animation steps 1 and 2• Effect 4 starts "After previous" animation effect. It is played at animation step 2 after

Effect 3.

See also

AnimationStep ClassSlideInfo ClassActionScript 3 and Flex support in iSpring

iSpring.as3bridge.BridgeEvent Class



The BridgeEvent Class extends the standard flash.events.Event class and exposes thefollowing constants and properties:

Constants

Constant Type Value Description

PAUSE String pause Defines the value of thetype property of a pauseevent object. This type ofevent occurs whenpresentation playback issuspended.A pause event containsthe following properties:playbackController

PLAY String play Defines the value of thetype property of a playevent object. This type ofevent occurs whenpresentation playback isresumed.A play event contains thefollowing properties:playbackController

STEP_CHANGE String stepChange Defines the value of thetype property of thestepChange eventobject. This type of eventoccurs when currentlyplaying animation stepindex is changed.A stepChange eventcontains the followingproperties:playbackController,stepIndex

POSITION_CHANGE String positionChange Defines the value of thetype property of thepositionChange eventobject. This type of eventoccurs when theplayback position of the



http://livedocs.adobe.com/flash/9.0/ActionScriptLangRefV3/flash/events/Event.html

currently playing slide ischanged.A positionChange eventcontains the followingproperties:playbackController,position

SLIDE_CHANGE String slideChange Defines the value of thetype property of theslideChange eventobject. This type of eventoccurs when current slideis changed by anotherslide of the presentation.A slideChange eventcontains the followingproperties:playbackController,slideIndex

SLIDE_LOAD_COMPLETEString slideLoadComplete Defines the value of thetype property of theslideLoadCompleteevent object. This type ofevent occurs when thegiven slide of thepresentation is loaded.A slideLoadCompleteevent contains thefollowing properties:playbackController,slideIndex

PLAYBACK_COMPLETEString playbackComplete Defines the value of thetype property of theplaybackCompleteevent object. This type ofevent occurs when theplayback of thepresentation iscompleted.A playbackCompleteevent contains thefollowing properties:playbackController



BRIDGE_LOADED String bridgeLoaded Defines the value of thetype property of thebridgeLoaded eventobject. This type of eventoccurs when theActionScirpt bridgemodule is loaded andready to receivecommands from theparent Flash movie.A bridgeLoaded eventcontains the followingproperties:succeeded, player

PLAYER_INIT String playerInit Defines the value of thetype property of theplayerInit event object.This type of event occurswhen player initializationis completed, just afterthe bridgeLoaded event.A playerInit eventcontains the followingproperties:succeeded, player

VOLUME_CHANGE String volumeChange Defines the value of thetype property of thevolumeChange eventobject. This type of eventoccurs when the soundvolume is changed.A volumeChange eventcontains the followingproperties:soundController, volume

SEEKING_COMPLETE String seekingComplete Defines the value of thetype property of theseekingComplete eventobject. This type of eventoccurs when the seekcommand execution iscompleted.A seekingComplete eventcontains the following



properties:playbackController,position

VOLUME_CHANGING_COMPLETEString volumeChangingComplete Defines the value of thetype property of thevolumeChangingCompleteevent object. This type ofevent occurs when thesound volume propertyof the SoundControllerobject is changed.AvolumeChangingCompleteevent contains thefollowing properties:soundController, volume

SLIDE_METADATA_LOADString slideMetadataLoad Defines the value of thetype property of theslideMetadataLoadevent object. This type ofevent is generated bySlideInfo object when itsmetadata is loaded.A slideMetadataLoadevent contains thefollowing properties:slideInfo, slideIndex

Properties


playbackController PlaybackController The PlaybackController classinstance.The following events contain thisproperty:play, pause, stepChange,positionChange, slideChange,slideLoadComplete,playbackComplete,seekingComplete

slideIndex Number Slide index.



The following events contain thisproperty:slideLoadComplete,slideMetadataLoad, slideChange

stepIndex Number Animation step index.The following events contain thisproperty:stepChange

position Number Slide playback position.The following events contain thisproperty:positionChange, seekingComplete

succeeded Boolean Indicates whether the bridge orplayer was loaded and initializedsuccessfully.The following events contain thisproperty:bridgeLoaded, playerInit

player Player The Player class instance.The following events contain thisproperty:bridgeLoaded, playerInit

volume Number A sound volume value.The following events contain thisproperty:volumeChange,volumeChangingComplete

slideInfo SlideInfo A SlideInfo class instance.The following events contain thisproperty:slideMetadataLoad

soundController SoundController A SoundController class instance.The following events contain thisproperty:volumeChange,volumeChangingComplete



See also

PlaybackController ClassPlayer ClassSlideInfo ClassSoundController ClassActionScript3 and Flex support in iSpring

iSpring.as3bridge.BridgeLoader Class

The BridgeLoader Class extends the standard flash.events.EventDispatcher class andexposes the following methods and events:

Methods

Method Description

BridgeLoader(target:flash.display.DisplayObjectContainer)Constructs a new BridgeLoader object which willload the bridge SWF module into the targetDisplayObjectContainer object

loadPresentation(bridgeURL:String,presentationURL:String,commandConnectionName:String = "",eventConnectionName:String = ""):Player

Loads the ActionScript 3 bridge module and theiSpring generated Flash presentation.Notes: If command or event connection name isempty, it will be generated using current time stamp.

Events

Type Description

BridgeEvent.PLAYER_INIT Occurs when player initialization is completed, justafter the BridgeEvent.BRIDGE_LOADED event.

See also

BridgeEvent ClassPlayer Classflash.events.EventDispatcher Classflash.display.DisplayObjectContainer ClassActionScript 3 and Flex support in iSpring

iSpring.as3bridge.PlaybackController Class



http://livedocs.adobe.com/flash/9.0/ActionScriptLangRefV3/flash/events/EventDispatcher.html

http://livedocs.adobe.com/flash/9.0/ActionScriptLangRefV3/flash/display/DisplayObjectContainer.html


http://livedocs.adobe.com/flash/9.0/ActionScriptLangRefV3/flash/display/DisplayObjectContainer.html

The PlaybackController class extends the standard flash.events.EventDispatcher Class andprovides the following properties, methods and events for presentation playback andnavigation control.

Properties


isPlaying Boolean Indicates whether the presentationis playing or not (read only)

currentSlideDuration Number A duration of the currently playingslide (read only)

currentSlideIndex Number Current slide index (read only)

currentSlidePlaybackPosition Number Returns playback position withincurrent slide.Note: playback position is anumber between 0 and 1

currentStepIndex Number Returns current animation stepindex

Methods

Method Description

play():Void Resumes presentation playback

pause():Void Suspends presentation playback

gotoNextSlide([autoStart:Boolean = true]):Void Switches to the next presentation slide and starts itsplayback.Note: if the autoStart parameter was set to false, slideplayback would not be started after switching

gotoPreviousSlide([autoStart:Boolean = true]):Void Switches to the previous presentation slide and startsits playback.Note: if the autoStart parameter was set to false, slideplayback would not be started after switching




gotoLastViewedSlide([autoStart:Boolean =true]):Void

Switches to the previously viewed slide and starts itsplayback.Note: if the autoStart parameter was set to false,slide playback would not be started after switching

getCurrentSlideIndex():Number Returns a zero-based index of currently playing slide

gotoSlide(slideIndex:Number, [autoStart:Boolean =true]):Void

Switches to the given slide of the presentation andstarts its playbackNotes: Slide index is zero-based.If the autoStart parameter was set to false, slideplayback would not be started after switching

getCurrentSlidePlaybackPosition():Number Returns playback position within current slide.Note: playback position is a number between 0 and 1

pauseCurrentSlideAt(position:Number):Void Suspends currently playing slide at the given positionNote: position is a number in between 0 and 1

playCurrentSlideFrom(position:Number):Void Restarts current slide from the given position.Note: position is a number between 0 and 1

seek(position:Number):Void Seeks the current slide to the given position. Afterthis operation slide playback gets suspended until theendSeek() method or other playback control methodis calledNote: position is a number between 0 and 1

endSeek([resumePlayback:Boolean =undefined]):Void

Exits from seeking mode and restores playback.Note: the resumePlayback parameter allows to startor pause slide after seeking explicitly


gotoNextStep():Void Plays current slide from the beginning of the nextanimation step.Note: being called at the end of the slide this methodplays presentation from the beginning of the nextslide

gotoPreviousStep():Void Moves slide playback one step back. This methodsuspends slide playback at the end of the previousanimation step.



Note: being called on the start slide step this methodcauses playback switching to the end of the previousslide

setAnimationStepPause(pause:Number):Void This method allows setting a pause betweenanimation steps. If an undefined value is passed aspause value, animation steps will not be playedautomatically

playFromStep(stepIndex:Number):Void Plays current slide from the beginning of thespecified animation step

pauseAtStepStart(stepIndex:Number):Void Suspends current slide at the beginning of thespecified animation step

pauseAtStepEnd(stepIndex:Number):Void Suspends current slide at the end of specifiedanimations step

enableAutomaticSlideSwitching(enableSwitching:Boolean):VoidEnables or disables automatic switching to the nextslide.Note: this method affects automatically switchingslides only.

getAutomaticSlideSwitching():Boolean Returns true if automatic slide switching has beenenabled, false otherwise.Note: automatic slide switching is enabled by default

Events

Type Description

BridgeEvent.PAUSE Occurs when presentation playback is suspended

BridgeEvent.PLAY Occurs when presentation playback is suspended

BridgeEvent.STEP_CHANGE Occurs when currently playing animation step indexis changed

BridgeEvent.POSITION_CHANGE Occurs when the playback position of the currentlyplaying slide is changed



BridgeEvent.SLIDE_CHANGE Occurs when current slide is changed by anotherslide of the presentation

BridgeEvent.SLIDE_LOAD_COMPLETE Occurs when a slide of the presentation is loaded

BridgeEvent.PLAYBACK_COMPLETE Occurs when the presentation playback is completed

BridgeEvent.SEEKING_COMPLETE Occurs when a seek command execution iscompleted

See also

IPlaybackListener InterfaceIPlayer InterfaceFlash Presentation ActionScript API Reference

iSpring.as3bridge.Player Class

The Player Class extends the standard flash.events.EventDispatcher class and exposes thefollowing properties and events:

Properties


playbackController PlaybackController Returns the PlaybackControllerclass providing presentationplayback control and navigationfacilities

soundController SoundController Returns the SoundController classproviding sound volume controlfacilities

presentationInfo PresentationInfo Returns the PresentationInfo classproviding the presentation contentinformation

initialized Boolean Returns a Boolean value indicatingwhether the player was initialized.The following properties return anundefined value until the playergets initialized:




• presentationInfo• playbackController• soundController

Events

Type Description

BridgeEvent.BRIDGE_LOADED Occurs when the ActionScript bridge module isloaded and ready to receive commands from theparent Flash movie.

See also

PlaybackController ClassPresentationInfo ClassSoundController Classflash.events.EventDispatcher ClassActionScript 3 and Flex support in iSpring

iSpring.flex.PresentationContainer Class

The PresentationContainer class extends the standard mx.core.UIComponent class andprovides the following properties:

Properties


bridgeLoader BridgeLoader Returns a BridgeLoader objectproviding an ability to load iSpringgenerated presentations

Samples

This class can be used in Flex applications to put a presentation container UI component to aFlex form.<?xml version="1.0" encoding="utf-8"?><mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute"creationComplete="{creationComplete()}" xmlns:mc="ispring.flex.*"frameRate="30" minWidth="470" minHeight="200">

<mx:Script source="main.as"/><mc:PresentationContainer id="presentationContainer" width="780"

height="524" x="10" y="36">





</mc:PresentationContainer>

</mx:Application>

The following code loads the generated presentation into the presentation container (filemain.as).

import iSpring.flex.PresentationContainer;import iSpring.as3bridge.*;

private function creationComplete():void{

var bridgeLoader:BridgeLoader = presentationContainer.bridgeLoader;bridgeLoader.loadPresentation("as3bridge.swf", "presentation.swf");

}

See also

BridgeLoader Classmx.core.UIComponent ClassActionScript 3 and Flex support in iSpring

iSpring.as3bridge.PresentationInfo Class

The PresentationInfo class stores the presentation information and provides the followingproperties:

Properties


hasPresenter Boolean Indicates whether the presentationcontains presenter information

PresenterInfo PresenterInfo Returns the PresenterInfo Classproviding the information aboutpresentation Presenter

slides SlidesCollection Returns the SlidesCollection Classproviding information aboutpresentation slides

hasReferences Boolean Indicates whether the presentationcontains references

references ReferencesCollection Returns the ReferencesCollection

Class providing the informationabout presentation references

title String Presentation title

duration Number Presentation duration in seconds

slideWidth Number Presentation slide width in pixels

slideHeight Number Presentation slide height in pixels

frameRate Number Presentation frame rate (number offrames per second)Note: when iSpring generatedpresentation is loaded by anotherFlash movie, it always plays at itsframe rate.

See also

PresenterInfo ClassSlidesCollection ClassReferencesCollection ClassActionScript 3 and Flex support in iSpring

iSpring.as3bridge.PresenterInfo Class

The PresenterInfo Class stores the information about presenter and provides the followingproperties:

Properties


name String Presenter name

title String Presenter title

biographyText String A brief information aboutpresenter

email String Presenter e-mail address



webSite String Presenter Web site address

See also

PresentationInfo ClassActionScript 3 and Flex support in iSpring

iSpring.as3bridge.ReferenceInfo Class

The ReferenceInfo Class provides the following properties for retrieving referenceinformation:

Properties


title String Reference title

url String Reference URL

target String Target window name where thereference should be opened

See also

ReferencesCollection ClassActionScript 3 and Flex support in iSpring

iSpring.as3bridge.ReferencesCollection Class

The ReferencesCollection class provides the following properties and methods for accessingpresentation references:

Properties


referencesCount Number Number of references in thecollection

Methods

Method Description



getReference(index:Number):ReferenceInfo Returns ReferenceInfo class providing theinformation about the specified reference.Note: the index parameter is an integer value from 0to (number of references minus 1)

See also

ReferenceInfo ClassPresentationInfo ClassActionScript 3 and Flex support in iSpring

iSpring.as3bridge.SlideInfo Class

The SlideInfo Class provides information about the particular slide of the presentation suchas title, duration, text, etc. It exposes the following properties and methods.

Properties


animationSteps AnimationSteps Returns the AnimationSteps classproviding the information aboutslide animation steps

metadataLoaded Boolean Indicates whether slide metadatahas been loadedNote: all slide properties exceptstartTime property are undefineduntil slide metadata is loaded

isLoaded Boolean Indicates whether slide has beenloadedNote: it is guaranteed that loadedslide metadata is loaded

title String Slide title

duration Number Slide duration in seconds

notesText String Slide notes text

startTime Number Slide start time within presentationtimeline



endTime Number Slide end time within presentationtimeline

startStepIndex Number Slide start step index within thepresentation

endStepIndex Number Slide end step index within thepresentation

slideText String Slide text in the normalized form(see the remarks section)

notesTextNormalized String Slide notes text in the normalizedform (see the remarks section)

titleNormalized String Slide title in the normalized form(see the remarks section)

Remarks

Normalized strings are strings having all characters in the lower case with no extra spacesbetween words. This simplifies and speeds up full text search implementation.

See also

AnimationSteps ClassSlidesCollection ClassActionScript 3 and Flex support in iSpring

iSpring.as3bridge.SlidesCollection Class

The ISlidesCollection interface represents a collection of presentation slides. It provides thefollowing properties and methods:

Properties


slidesCount Number Number of slides in thepresentation



Methods

Method Description

getSlideInfo(slideIndex:Number):SlideInfo Returns SlideInfo Class providing information aboutthe specified slideNote: Slide index is zero-based

See also

PresentationInfo ClassSlideInfo ClassActionScript 3 and Flex support in iSpring

iSpring.as3bridge.SoundController Class

The SoundController class provides sound volume control facilities. It extends the standardflash.events.EventDispatcher class and provides the following properties and events.

Properties


volume Number Sound volumeNote: sound volume is a numberbetween 0 and 1

Events

Type Description

BridgeEvent.VOLUME_CHANGE Occurs when the sound volume is changed

BridgeEvent.VOLUME_CHANGING_COMPLETE Occurs when the sound volume is changed viavolume property of the SoundController object

See also

Player Classflash.events.EventDispatcher ClassActionScript 3 and Flex support in iSpring





1.10.4. Skin Development Reference

1.10.4.1. Skin development

iSpring provides Flash developers with custom skin development facilities. Creation of acustom skin is a quite easy task for developers familiar with Flash 7 or 8 and ActionScript2.0.

Each skin is just an ordinary Flash file with the only feature - the first frame of its main (aka_root) MovieClip contains the following function.function createSkin(target:MovieClip):fsplayer.ui.skins.ISkin;

The target parameter is a MovieClip object where skin must create user interface objects.The createSkin() function is called by the player core. It must return a newly created objectimplementing fsplayer.ui.skins.ISkin Interface. Visibility of the passed target MovieClip canbe controlled by the Flash presentation preloader.

When the skin is created, the player is initialized. Player initialization scheme is illustrated inthe following diagram.



iSpring Player initialization scheme

The following interfaces are used for the development of custom skins. They are locatedwithin fsplayer.ui.skins package.

Name Description

ISkin Provided by all iSpring-compatible skin modules

ISkinListener Implemented by the player core and allows receivingskin initialization event notifications

ISlideShowWindow Provides the player core with the target MovieClipobject where slides are loaded

Samples



A typical implementation of the createSkin() function is as follows:

import fsplayer.ui.skins.ISkin;import MySkin;

function createSkin(target:MovieClip):ISkin{

return new MySkin(target);}

MySkin class can be declared in the following way:

import fsplayer.ui.skins.ISkin;

class MySkin implements ISkin{

// implementation of ISkin interface methods}

A minimal implementation of the ISkin interface can be found in the sampes section of theISkin interface description.

See also

ISkin InterfaceISkin Interface implementationiSpring presentation structure

1.10.4.2. fsplayer.ui.skins.ISkin Interface

The ISkin interface is provided by all iSpring-compatible skin modules and used to connectthe player core with the User Interface. The ISkin interface exposes the following methodscalled by the player core.

Methods

Method Description

initialize(player:IPlayer):Void This method is invoked by the player core toinitialize the skin. The information provided by thepassed player parameter can be used by the skin toinitialize its visual components.Note: playback control methods of theIPresentationPlaybackController interface areinaccessible until the skin gets initialized.Skins use ISkinListener interface to notify the core at



the end of the skin initialization process. SeeRemarks section for more details.

getSlideShowWindow():ISlideShowWindow Returns the ISlideShowWindow interface providingthe player core with the target MovieClip forpresentation slides loading.

setListener(listener:ISkinListener):Void The player core passes ISkinListener interface thatallows core to receive notifications about skininitializaiton process.

Remarks

Skin initialization can take some time, especially when the skin loads some extra data fromthe Internet. In order to get the initialization notification the player core implements theISkinListener Interface and passes it to the skin via the setListener() method.

Samples

The following example illustrates the minimal implementation of the ISkin,ISlideShowWindow, an IPlaybackListener interfaces.

import fsplayer.ui.skins.*;import fsplayer.api.*;

class CSkinImpl implements IPlaybackListener, ISkin, ISlideShowWindow{private var m_skinTarget:MovieClip;

private var m_slideAssetsTargetMovieClip:MovieClip;

private var m_listener:ISkinListener;private var m_player:IPlayer;private var m_skinSettings:Object;private var m_presentation:IPresentationInfo;private var m_playbackController:IPresentationPlaybackController;private var m_skinInitialized:Boolean;

public function CSkinImpl(target:MovieClip){

m_skinTarget = target;}

// This method is called to initialize the skinfunction initialize(playerAPI:IPlayer):Void{

m_player = playerAPI;



m_skinSettings = m_player.getSettings();m_playbackController = m_player.getPlaybackController();m_presentation = m_player.getPresentationInfo();

m_playbackController.addListener(this);}

// returns slide show windowfunction getSlideShowWindow():ISlideShowWindow{

return this;}

// ISlideShowWindow.getTarget() returns the target MovieClip where slideswill be loaded and displayed by player corefunction getTarget():MovieClip{

if (!m_slideAssetsTargetMovieClip){

m_slideAssetsTargetMovieClip = createSlideAssetsTarget();}

return m_slideAssetsTargetMovieClip;}

// this method is called by playback core to get notified when the skin isloadedfunction setListener(listener:ISkinListener):Void{

m_listener = listener;if (!m_skinInitialized){

m_skinInitialized = true;m_listener.onSkinInit(this);

}}

// empty implementation of IPlaybackListener interface methods. They can beoverriden by inherited classesfunction onPausePlayback():Void{}function onStartPlayback():Void{}function onCurrentSlideIndexChanged(slideIndex:Number):Void{}function onSlideLoadingComplete(slideIndex:Number):Void{}function onSlidePositionChanged(position:Number):Void{}function onAnimationStepChanged(stepIndex:Number):Void{}function onPresentationPlaybackComplete():Void{}

// This method can be used in the inherited classes to get the skinsettingsprivate function getSkinSettings():Object{

return m_skinSettings;}



// returns the target MovieClip where the skin resides. This method can beoverriden in inherited classes.private function getSkinTarget():MovieClip{

return m_skinTarget;}

// This method creates the MovieClip slides will be loaded into// This method can be overriden in the inherited classesprivate function createSlideAssetsTarget():MovieClip{

return getSkinTarget().createEmptyMovieClip("assets",getSkinTarget().getNextHighestDepth());}}

See also

IPlayer InterfaceIPresentationPlaybackController InterfaceISkinListener InterfaceISlideShowWindow InterfaceSkin development

1.10.4.3. fsplayer.ui.skins.ISkinListener Interface

The ISkinListener interface is implemented by the player core and allows it to receive thenotification from the skin when the skin has been initialized.

Methods

Method Description

onSkinInit(skin:ISkin):Void This method is invoked by skins to notify the playercore that the skin has been initialized. The skinparameter is an object which implements the ISkininterface.

Remarks

Skin initialization can require some time especially if the skin needs to load someinformation from the Internet in order to finish the initialization process. Skin notifies theplayer core via onSkinInit() method call on the ISkinListener interface. The ISkinListenerInterface is passed to the skin via setListener() method of the ISkin Interface.

The player core will not start loading presentation slides until it gets onSkinInit notification.



See also

ISkin InterfaceSkin development

1.10.4.4. fsplayer.ui.skins.ISlideShowWindow Interface

The ISlideShowWindow interface provides the player core with the target MovieClip forpresentation slides loading.

Methods

Method Description

getTarget():MovieClip Returns the MovieClip which will be used by theplayer core to load and display slides

Remarks

iSpring generated presentations can be wrapped into one of the existing skins or into acustom made skin. Each skin provides its unique user interface. Slide loading and playback isa responsibility of the player core while UI and navigation is a responsibility of skins. TheISlideShowWindow interface provides playback core with the necessary target MovieClipfor presentation slides loading and display.

See also

ISkin InterfaceSkin development

1.10.5. Flash Slide ActionScript API

1.10.5.1. Flash Slide ActionScript API Reference

Each Standalone Flash slide created with iSpring contain a small slide controller. This is asmall Flash module which manages synchronous playback of animations and sounds on theslide. It also exposes an ActionScript API providing programmatic access to the slide:

• Providing information about slide dimensions and animation steps count• Slide playback control• Sound volume control• Hyperlinks and actions handling• Receiving playback event notifications



This API is accessible via the getSlideController() function on the root MovieClip of eachstandalone slide. This function returns the slideplayer.api.ISlideController interfaceproviding an access to the rest interfaces of the generated standalone slide. The StandaloneSlide ActionScript API diagram is shown in the following picture:

Standalone Slide ActionScript API diagram

The following table lists all ActionScript interfaces provided by standalone slides. Theseinterfaces reside in slideplayer.api package.

Name Description

IHyperlinksManager Provides slides with ability to handle hyperlinks toother slides and external web pages

IPlaybackController



IPlaybackListener

ISlideController Provides an access to the slide core

ISoundController

See also

IHyperlinksManager InterfaceIPlaybackController InterfaceIPlaybackListener InterfaceISlideController InterfaceISoundController Interface

1.10.5.2. slideplayer.api.IHyperlinksManager Interface

The IHyperlinksManager Interface provides slides with an ability to switch to anotherslides or open external web pages. A standalone slide does not switch to another slide when ahyperlink is clicked. An external Flash application can use setHyperlinksManager() methodof the ISlideController interface to pass an object implementing the IHyperlinksManagerinterface which receive notifications when user clicks a hyperlink or action button.

The following methods are exposed by the IHyperlinksManager interface.

Methods

Method Description

gotoSlide(slideIndex:Number):Void This method is invoked when user clicks a hyperlinkto another slideAn implementation can hide the current slide andload and show the new one

openURL(url:String, target:String):Void This method is invoked when user clicks a hyperlinkto an external web page or other resourceNote: the simplest way to implement this method isto call following ActionScript function:getURL(url, target)

gotoLastViewedSlide():Void This method is invoked when user clicks a hyperlinkto the last viewed slide.An implementation must hide the current slide andshow the slide that was shown before



endShow():Void This method is invoked when user clicks a hyperlinkthat finishes slide showTypically, an implementation unloads all slides of thecurrent presentation

Samples

The following example illustrates a typical IHyperlinksManager interface implementationand shows its usage.

CMyHyperlinksManager.as

import slideplayer.api.*;

class CMyHyperlinksManager implements IHyperlinksManager{

private var m_viewedSlides:Array;private var m_currentSlideIndex:Number;

function CMyHyperlinksManager(){

m_viewedSlides = new Array();}

function gotoSlide(slideIndex:Number):Void{

m_currentSlideIndex = slideIndex;m_viewedSlides.push(slideIndex);loadSlide(slideIndex);

}

function loadSlide(slideIndex:Number):Void{

// empty}

function openURL(url:String, target:String):Void{

getURL(url, "_blank");}

function gotoLastViewedSlide():Void{

if (m_viewedSlides.length > 1){

var curSlide:Number = Number(m_viewedSlides.pop());var lastViewedSlide:Number;

do{

lastViewedSlide = Number(m_viewedSlides.pop());



} while ((lastViewedSlide == curSlide) &&(m_viewedSlides.length != 0));

if (lastViewedSlide != curSlide){

gotoSlide(lastViewedSlide);}else{

m_viewedSlides.push(curSlide);}

}}

function endShow():Void{

fscommand("quit", "true");}

}

CMyHyperlinksManager class usage example:

import slideplayer.api.*;System.security.allowDomain("*");

var rootMC:MovieClip = this;var slidesMC:MovieClip = rootMC.createEmptyMovieClip("slidesMC", 2);var slideMC1:MovieClip = slidesMC.createEmptyMovieClip("slide1", 1);

var g_slideController:ISlideController;var g_hyperlinksManager:CMyHyperlinksManager = new CMyHyperlinksManager();

g_hyperlinksManager.loadSlide = function(slideIndex:Number):Void{

loadSlide(slideIndex);}

g_hyperlinksManager.gotoSlide(0);

// loads slide with the specified slide indexfunction loadSlide(slideIndex:Number):Void{

// remove hyperlinks manager from the current slideg_slideController.setHyperlinksManager(undefined);

var ml:MovieClipLoader = new MovieClipLoader();ml.addListener(this);ml.loadClip("data_hl/slide" + (slideIndex + 1) + ".swf", slideMC1);

}

function onLoadInit(target:MovieClip):Void{

g_slideController = target.getSlideController();



slideController.setHyperlinksManager(g_hyperlinksManager);}

Demo

The following demo illustrates hyperlinks and action buttons handling viaIHyperlinksManager interface.

See also

ISlideController InterfaceFlash Slide ActionScript API Reference

1.10.5.3. slideplayer.api.IPlaybackController Interface

The IPlaybackController interface provides methods for slide playback control. This



interface can be obtained by calling getPlaybackController() method on ISlideControllerinterface.

The IPlaybackController interface exposes the following methods:

Methods

Method Description

addListener(listener:IPlaybackListener):Void Adds an external object implementingIPlaybackListener interface; it will be notified aboutevents during playback; the passed object will receiveslide playback event notifications

removeListener(listener:IPlaybackListener):Void Removes previously added listener object. Thepassed object won't receive notifications from theplayback controller any more

isPlaying():Boolean Returns a Boolean value indicating whether the slideis playing or not

play():Void Resumes slide playback

pause():Void Suspends slide playback

getPosition():Number Returns slide playback positionNote: playback position is a number between 0 and 1

playFromPosition(position:Number):Void Plays the slide from specified position.Note: playback position is a number between 0 and 1

pauseAtPosition(position:Number):Void Suspends slide at the specified position.Note: playback position is a number between 0 and 1


gotoNextStep():Void Plays the slide from the beginning of the nextanimation step

gotoPreviousStep():Void Moves slide playback one step back. This methodsuspends slide playback at the end of the previousanimation step



playFromStep(stepIndex:Number):Void Plays the slide from the beginning of the specifiedanimation step

pauseAtStepStart(stepIndex:Number):Void Suspends the slide at the beginning of the specifiedanimation step

pauseAtStepEnd(stepIndex:Number):Void Suspends the slide at the end of specified animationsstep

Samples

The following example illustrates how to obtain and use the IPlaybackController interface tocontrol slide playback

import slideplayer.api.*;

// slide loading and initialization code is placed here// ...

var g_slideController:ISlideController;var g_playbackController:IPlaybackController;

// this function is called when slide movie clip has been loadedfunction onLoadInit(target:MovieClip):Void{

g_slideController = target.getSlideController();g_playbackController = g_slideController.getPlaybackController();

}

playPauseSlideButton.onRelease = function(){

if (g_playbackController){

if (g_playbackController.isPlaying()){

g_playbackController.pause();}else{

g_playbackController.play();}

}}

Demo

This demo illustrates slide playback control via IPlaybackController interface.



References

IPlaybackListener InterfaceISlideController InterfaceFlash Slide ActionScript API Reference

1.10.5.4. slideplayer.api.IPlaybackListener Interface

There are various events occurring during slide playback. The playback controller notifiesexternal objects about these events via IPlaybackListener interface. This interface defines aset of methods which are invoked by playback controller when the corresponding eventsoccur. These methods are as follows.



Methods

Method Description

onPausePlayback():Void Invoked when presentation playback is suspended

onStartPlayback():Void Invoked when presentation playback is resumed

onSlidePositionChanged(position:Number):Void Invoked when playback position is changed duringplayback

onAnimationStepChanged(stepIndex:Number):Void Invoked when slide animation step is changed duringplayback

onSlidePlaybackFinished():Void This method is called when slide playback wasfinished.

In order to receive event notifications you need to create a class which implementsIPlaybackListener interface and pass the instance of this class to the addListener methodof the IPlaybackController interface.

See also

IPlaybackController InterfaceFlash Slide ActionScript API Reference

1.10.5.5. slideplayer.api.ISlideController Interface

The ISlideController interface is exposed by each standalone slide. It provides the followingmethods.

Methods

Method Description

getPlaybackController():IPlaybackController Returns the IPlaybackController interface providingslide playback control facilities

getSoundController():ISoundController Returns the ISoundController interface providingsound volume control facilities

getHyperlinskManager():IHyperlinksManager Returns the IHyperlinksManager interface providing



hyperlink action handling facilities

setHyperlinksManager(manager:IHyperlinksManager):VoidSets the new IHyperlinksManager interface whichwill handle hyperlink actions

getSlideWidth():Number Returns slide width in pixels

getSlideHeight():Number Returns slide height in pixels

getStepsCount():Number Returns number of animation steps on the slide

Samples

The following example illustrates how to load a flash slide and get its ISlideControllerinterface.

import slideplayer.api.*;System.security.allowDomain("*");

// create a movie clip where slide will be loadedvar slideMC1:MovieClip = this.createEmptyMovieClip("slide1", 1);

// load slide with name slide1.swf into slideMC1 movie clipvar ml:MovieClipLoader = new MovieClipLoader();ml.addListener(this);ml.loadClip("slide1.swf", slideMC1);

var g_slideController:ISlideController;

// this function is invoked by MovieClipLoader when the loaded Flash slideis initializedfunction onLoadInit(target:MovieClip):Void{

// now we can get ISlideController interface and access its methodsg_slideController = target.getSlideController();

}

Demo

The following demo illustrates standalone slide loading and playback control viaIPlaybackController interface.



See also

IHyperlinksManager InterfaceIPlaybackController InterfaceISoundController InterfaceFlash Slide ActionScript API Reference

1.10.5.6. slideplayer.api.ISoundController Interface

The ISoundController Interface provides the following methods for sound control.

Methods



Method Description

getVolume():Number Returns current sound volume.Note: sound volume is a number between 0 and 1

setVolume(volume:Number):Void Sets sound volume.Note: sound volume is a number between 0 and 1

Samples

var g_slideController:ISlideController;var g_soundController:ISoundController;

function loadSlide(slideIndex:Number):Void{

var ml:MovieClipLoader = new MovieClipLoader();ml.addListener(this);var fileName:String = "data_snd/slide" + slideIndex + ".swf";

var slashPos:Number = Math.max(this._url.lastIndexOf("/"),this._url.lastIndexOf("\\"));

var fullPath:String = this._url.substr(0, slashPos + 1) + fileName;ml.loadClip(fullPath, slideMC1);loadingLabel.text = this._url;

}

function onLoadInit(target:MovieClip):Void{

g_slideController = target.getSlideController();g_soundController = g_slideController.getSoundController();g_trackBar.setPos(g_soundController.getVolume());

}

g_trackBar.newPos = function(pos:Number):Void{

g_soundController.setVolume(pos);}

Demo

The following demo illustrates ISoundController interface usage to control sound volume onthe slide.



See also

ISlideController InterfaceFlash Slide ActionScript API Reference

1.11. Support

We are trying to develop our product to the maximum ease of use. But in case you haveproblems using iSpring, please first consult the documentation provided with the product andtry to find the competent answers to your questions in the iSpring FAQ base.



http://www.ispringsolutions.com/kb/faq.html

If your question remains unanswered, please get in touch with us through online feedbackform. We will be happy to give you our helping hand and to find a quick solution to yourrequest.

We appreciate any comments, concerns, kudos or critique. Share your opinion on the serviceyou have received when using our product. Feel free to send us your feedback at supportpage on www.ispringsolutions.com. Also now you can post your questions and opinions,exchange ideas and discuss technical issues on iSpring Community Forum.







http://www.ispringsolutions.com

http://community.ispringsolutions.com/

All users of iSpring are entitled to absolutely free and prompt technical support. We stopproviding support only to refunded copies' users.

Free Technical Support includes:

• Unlimited free patches for stability-related bugs• The iSpring online knowledge base• Email questions that will be answered within five business days

To get the most benefit out of iSpring PRESENTER, sign up for a Premium TechnicalSupport or Consulting Service and receive prompt and personalized service from theiSpring Support Team.

Premium Technical Support includes:

• Free iSpring upgrades including major releases and patches• Unlimited telephone support• Email questions answered within one business day• 20% discount on iSpring Consulting services

Contact us for details about Premium Technical Support and Consulting Services.

1.12. iSpring solutions

iSpring Solutions provides a product line for desktop and server-side PowerPoint to Flashconversion. We have years of experience in PowerPoint to Flash conversion area. iSpringproducts implement our latest researches and achievements in PowerPoint and Flashtechnology.

iSpring SDK

iSpring SDK provides effective server-sidePowerPoint to Flash conversion facilities for websites and online applications. It is optimized formultitasking processing and produces fast batchconversion of thousands of PowerPoint presentationsto high-quality Flash clips.

download |

purchase | learn more...

ActiveSWF SDK



http://www.ispringsolutions.com/consulting.html


http://www.ispringsolutions.com/products/ispring_sdk.html

http://www.ispringsolutions.com/download.html

http://www.ispringsolutions.com/purchase.html

http://www.ispringsolutions.com/products/iSpring_sdk.html

ActiveSWF SDK provides smart components forFlash applications development in C++, C#,VisualBasic, ASP, PHP for .NET/COM/Win32platforms.

download |

purchase | learn more...

iSpring Custom Solutions

While iSpring Pro and iSpring SDK are designed tocover general customers' needs, a lot of users wouldlike to have extra features or additional functionality.iSpring Team provides development services tocreate custom solutions tailored to the uniquerequirements of our customers.Our creative developers will implement a fullycustomized application based on the iSpring Pro oriSpring SDK core. Our project manager will be intouch with you from the conception through detailedelaboration to high quality result delivery.

Order a custom solution now!

If you are interested in a custom solution or need more information about the products andservice, visit iSpring web site and feel free to e-mail us to



http://www.activeswf.com

http://www.activeswf.com#download

http://www.activeswf.com#purchase

http://www.activeswf.com

http://www.ispringsolutions.com

ispring presenter guide player core module ... ispring presenter guide. ispring presenter guide....

Documents