Sunteți pe pagina 1din 255

iSpring

iSpring Presenter 4.3


User Guide
iSpring Presenter 4.3 Guide

Table of contents
1 Welcome to iSpring PRESENTER Guide....................................................................... 11
2 iSpring PRESENTER Activation.................................................................................... 12
2.1 To register and activate your iSpring PRESENTER: ...................................................12
2.2 Trial version registration............................................................................................... 16
2.3 License Deactivation..................................................................................................... 18
3 Trial version limitations................................................................................................... 19
4 Getting started with iSpring PRESENTER......................................................................21
5 Product Features...............................................................................................................22
5.1 Product features............................................................................................................. 22
5.1.1 Publishing to iSpring Online portal............................................................................ 22
5.1.2 AICC compliant Flash content creation......................................................................22
5.1.3 New quiz question types: Fill-in the Blank and Multiple Choice Text...................... 22
5.1.4 Video-enhanced questions in quizzes......................................................................... 22
5.1.5 Advanced processing of SmartArt objects..................................................................23
5.1.6 Custom company logo in Lite player..........................................................................23
5.1.7 Random Effects animation support.............................................................................23
5.1.8 Standard PowerPoint audio objects sound volume control.........................................23
5.1.9 Keyboard playback control customization..................................................................23
5.1.10 YouTube video insert................................................................................................ 23
5.1.11 Presets........................................................................................................................23
5.1.12 System Fonts Display................................................................................................23
5.1.13 Animations and Slide Transition Cancelling............................................................ 24
5.1.14 Watermark protection of your slides......................................................................... 24
5.1.15 Password protection of your presentation................................................................. 24

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


iSpring Presenter 4.3 Guide

5.1.16 More feedback from your quiz takers....................................................................... 25


5.1.17 QuizMaker.................................................................................................................25
5.1.18 Advanced Glossy Player........................................................................................... 25
5.1.19 Slides Notes Styles.................................................................................................... 25
5.1.20 Presentation Explorer................................................................................................ 25
5.1.21 Audio Recording and Synchronization..................................................................... 26
5.1.22 Multilevel Navigation............................................................................................... 27
5.1.23 Multiple Presenters....................................................................................................28
5.2 iSpring PRESENTER key features............................................................................... 30
5.3 Animation Effects Support............................................................................................ 31
5.4 Slide Transitions Support.............................................................................................. 35
6 Publish presentation......................................................................................................... 36
6.1 Publish presentation.......................................................................................................36
6.2 Publish to Flash Window...............................................................................................37
6.2.1 Destination options..................................................................................................... 37
6.2.2 Publish presets............................................................................................................ 38
6.2.3 Publish Presentation to My Computer........................................................................ 39
6.2.4 Publish Presentation to iSpring Online....................................................................... 40
6.2.5 Publish Presentation to SlideBoom.............................................................................42
6.2.6 Publish Presentation to Web/FTP............................................................................... 44
6.2.7 Send Presentation via E-Mail......................................................................................48
6.3 Publish to Flash Window - General Tab....................................................................... 49
6.4 Publish to Flash Window - Advanced Tab....................................................................52
6.4.1 Keyboard Customization.............................................................................................56
6.5 Publish to Flash Window - Media Tab..........................................................................59
6.6 Publish to Flash Window - LMS Tab............................................................................61
6.7 Publish to Flash Window - Protection tab.....................................................................65
6.7.1 Watermark protection of your slides...........................................................................65
6.7.2 Password protection of your presentation...................................................................66

Page 3
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

6.7.3 Domain restriction.......................................................................................................66


7 Players..............................................................................................................................66
7.1 iSpring Players...............................................................................................................66
8 Presentation management................................................................................................ 68
8.1 Presentation Management............................................................................................. 68
8.2 Presentation Explorer.................................................................................................... 68
8.2.1 Multilevel Navigation................................................................................................. 69
8.2.2 Hidden Slides.............................................................................................................. 69
8.2.3 Slide Title....................................................................................................................70
8.2.4 Presenters.................................................................................................................... 70
8.2.5 Playback mode............................................................................................................ 70
8.2.6 Slide duration.............................................................................................................. 70
8.2.7 Media - Audio............................................................................................................. 71
8.2.8 Media - Video............................................................................................................. 71
8.2.9 Media - Quiz............................................................................................................... 72
8.3 Links.............................................................................................................................. 72
8.3.1 Links........................................................................................................................... 72
8.3.2 Links - References Tab............................................................................................... 73
8.3.3 Links - Web Links.......................................................................................................76
8.4 Presenters.......................................................................................................................78
8.4.1 Presenters.................................................................................................................... 78
8.4.2 Presenters manager - Presenters Tab.......................................................................... 78
8.4.3 Presenter manager - Company Tab.............................................................................81
9 Narration.......................................................................................................................... 83
9.1 Narration section........................................................................................................... 83
9.2 Audio Recording........................................................................................................... 83
9.3 Video Recording............................................................................................................85
9.4 Audio Importing............................................................................................................ 87
9.5 Video Importing............................................................................................................ 89

Page 4
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

9.6 Synchronization.............................................................................................................91
10 Insert...............................................................................................................................92
10.1 Insert............................................................................................................................ 92
10.2 Insert Flash...................................................................................................................93
10.3 Insert Quiz....................................................................................................................93
10.3.1 QuizMaker.................................................................................................................93
10.3.2 QuizMaker - Settings.................................................................................................99
10.3.2.1 Main........................................................................................................................ 99
10.3.2.2 Question Defaults................................................................................................. 101
10.3.2.3 Feedback............................................................................................................... 103
10.3.2.4 Result.................................................................................................................... 104
10.3.2.5 Player Customization............................................................................................106
10.4 YouTube video insert.................................................................................................108
11 ActionScript API References....................................................................................... 109
11.1 iSpring ActionScript API...........................................................................................109
11.1.1 Presentation conversion modes overview............................................................... 110
11.1.2 ................................................................................................................................. 113
11.1.3 ................................................................................................................................. 114
11.1.4 ................................................................................................................................. 114
11.2 iSpring Presentation structure....................................................................................114
11.2.1 Presentation assets...................................................................................................115
11.2.2 Player core module..................................................................................................115
11.2.3 Skin module.............................................................................................................116
11.2.4 References............................................................................................................... 117
11.3 Flash Presentation ActionScript API Reference........................................................117
11.3.1 Flash Presentation ActionScript API Reference..................................................... 117
11.3.2 fsplayer.api.ActionType Class................................................................................ 119
11.3.3 fsplayer.api.CPresentationLoader Class..................................................................121
11.3.4 fsplayer.api.IAnimationStep Interface.................................................................... 122

Page 5
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

11.3.4.1 Remarks................................................................................................................ 123


11.3.5 fsplayer.api.IAnimationSteps Interface...................................................................124
11.3.6 fsplayer.api.ICompanyInfo Interface...................................................................... 125
11.3.7 fsplayer.api.ICompanyLogo Interface.....................................................................126
11.3.8 fsplayer.api.ICompanyLogoLoadingListener Interface.......................................... 127
11.3.9 fsplayer.api.IKeyboardSettings Interface................................................................ 128
11.3.10 fsplayer.api.IPlaybackAction Interface................................................................. 128
11.3.11 fsplayer.api.IPlaybackListener Interface............................................................... 129
11.3.12 fsplayer.api.IPlayer Interface.................................................................................132
11.3.12.1 Remarks...............................................................................................................133
11.3.13 fsplayer.api.IPlayerCore Interface......................................................................... 134
11.3.14 fsplayer.api.IPlayerEx Interface............................................................................ 134
11.3.15 fsplayer.api.IPlayerListener Interface....................................................................135
11.3.16 fsplayer.api.IPlayerListenerEx Interface............................................................... 136
11.3.17 fsplayer.api.IPresentationInfo Interface.................................................................137
11.3.18 fsplayer.api.IPresentationPlaybackController Interface........................................ 138
11.3.19 fsplayer.api.IPresentationPlaybackControllerEx Interface....................................141
11.3.20 fsplayer.api.IPresenterInfo Interface..................................................................... 142
11.3.21 fsplayer.api.IPresenterPhoto Interface...................................................................143
11.3.21.1 Remarks...............................................................................................................143
11.3.22 fsplayer.api.IPresenterPhotoLoadingListener Interface........................................ 143
11.3.23 fsplayer.api.IPresentersCollection Interface..........................................................144
11.3.24 fsplayer.api.IPresenterVideo Interface.................................................................. 144
11.3.25 fsplayer.api.IPresenterVideoController Interface..................................................145
11.3.26 fsplayer.api.IPresenterVideoListener Interface..................................................... 145
11.3.27 fsplayer.api.IReferenceInfo Interface.................................................................... 146
11.3.28 fsplayer.api.IReferencesCollection Interface.........................................................146
11.3.29 fsplayer.api.ISlideInfo Interface............................................................................ 147
11.3.29.1 Remarks...............................................................................................................149

Page 6
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

11.3.30 fsplayer.api.ISlidesCollection Interface.................................................................149


11.3.31 fsplayer.api.ISlideThumbnail Interface................................................................. 150
11.3.31.1 Remarks...............................................................................................................150
11.3.32 fsplayer.api.ISlideThumbnailLoadingListener Interface.......................................151
11.3.33 fsplayer.api.ISlideResources Interface.................................................................. 151
11.3.34 fsplayer.api.ISoundController Interface................................................................ 152
11.3.34.1 Remarks...............................................................................................................153
11.3.35 fsplayer.api.ISoundListener Interface....................................................................153
11.3.36 fsplayer.api.IThumbnailsCollection Interface....................................................... 154
11.3.37 ActionScript 3 and Flex 2 support......................................................................... 155
11.3.37.1 ActionScript 3 and Flex support in iSpring.........................................................155
11.3.37.1.1 .......................................................................................................................... 155
11.3.37.1.2 .......................................................................................................................... 157
11.3.37.1.3 Samples.............................................................................................................160
11.3.37.1.4 ActionScript 3 communication demo............................................................... 161
11.3.37.1.5 Adobe Flex communication demo....................................................................161
11.3.37.1.6 References.........................................................................................................161
11.3.37.2 ispring.as2player.AcquireFocusEvent Class.......................................................162
11.3.37.3 ispring.as2player.IAnimationStep Interface........................................................163
11.3.37.3.1 Remarks............................................................................................................ 163
11.3.37.4 ispring.as2player.IAnimationSteps Interface...................................................... 165
11.3.37.5 ispring.as2player.ICompanyInfo Interface..........................................................166
11.3.37.6 ispring.as2player.ICompanyLogo Interface........................................................167
11.3.37.7 ispring.as2player.IPlayer Interface......................................................................168
11.3.37.7.1 Remarks............................................................................................................ 169
11.3.37.8 ispring.as2player.IPresentationInfo Interface..................................................... 170
11.3.37.9 ispring.as2player.IPresentationPlaybackController Interface............................. 172
11.3.37.10 ispring.as2player.IPresenterInfo Interface.........................................................176
11.3.37.11 ispring.as2player.IPresentersCollection Interface............................................. 176

Page 7
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

11.3.37.12 ispring.as2player.IPresenterVideo Interface..................................................... 177


11.3.37.13 ispring.as2player.IReferenceInfo Interface....................................................... 177
11.3.37.14 ispring.as2player.IReferencesCollection Interface............................................178
11.3.37.15 iSpring.as2bridge.ISlideInfo Interface.............................................................. 179
11.3.37.15.1 Remarks.......................................................................................................... 180
11.3.37.16 iSpring.as2bridge.ISlideResources Interface.....................................................181
11.3.37.17 ispring.as2player.ISlidesCollection Interface....................................................181
11.3.37.18 ispring.as2player.ISoundController Interface................................................... 182
11.3.37.19 ispring.as2player.PlaybackEvent Class............................................................. 183
11.3.37.20 ispring.as2player.PlaybackPositionEvent Class................................................184
11.3.37.21 ispring.as2player.PlayerEvent Class................................................................. 185
11.3.37.22 ispring.as2player.PresentationLoader Class......................................................185
11.3.37.23 ispring.as2player.SlidePlaybackEvent Class.....................................................186
11.3.37.24 ispring.as2player.SoundEvent Class................................................................. 187
11.3.37.25 ispring.as2player.StepPlaybackEvent Class......................................................188
11.3.37.26 Obsolete ActionScript 3 API............................................................................. 189
11.3.37.26.1 Obsolete ActionScript 3 API...........................................................................189
11.3.37.26.1.1 ...................................................................................................................... 189
11.3.37.26.1.2 ...................................................................................................................... 191
11.3.37.26.1.3 ...................................................................................................................... 193
11.3.37.26.1.4 Samples.........................................................................................................193
11.3.37.26.1.5 ActionScript 3 communication demo...........................................................194
11.3.37.26.1.6 Adobe Flex communication demo................................................................195
11.3.37.26.1.7 References.................................................................................................... 196
11.3.37.26.2 iSpring.as3bridge.AnimationStep Class......................................................... 197
11.3.37.26.2.1 Remarks........................................................................................................197
11.3.37.26.3 iSpring.as3bridge.AnimationSteps Class........................................................199
11.3.37.26.4 iSpring.as3bridge.BridgeEvent Class............................................................. 200
11.3.37.26.5 iSpring.as3bridge.BridgeLoader Class........................................................... 206

Page 8
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

11.3.37.26.6 iSpring.as3bridge.PlaybackController Class...................................................206


11.3.37.26.7 iSpring.as3bridge.Player Class....................................................................... 210
11.3.37.26.8 iSpring.flex.PresentationContainer Class....................................................... 211
11.3.37.26.9 iSpring.as3bridge.PresentationInfo Class....................................................... 212
11.3.37.26.10 iSpring.as3bridge.PresenterInfo Class.......................................................... 213
11.3.37.26.11 iSpring.as3bridge.ReferenceInfo Class......................................................... 214
11.3.37.26.12 iSpring.as3bridge.ReferencesCollection Class..............................................214
11.3.37.26.13 iSpring.as3bridge.SlideInfo Class................................................................. 215
11.3.37.26.13.1 .................................................................................................................... 216
11.3.37.26.14 iSpring.as3bridge.SlidesCollection Class..................................................... 216
11.3.37.26.15 iSpring.as3bridge.SoundController Class..................................................... 217
11.4 Skin Development Reference.................................................................................... 218
11.4.1 Skin development.................................................................................................... 218
11.4.2 fsplayer.ui.skins.ISkin Interface..............................................................................220
11.4.2.1 Remarks................................................................................................................ 221
11.4.2.2 Samples.................................................................................................................221
11.4.3 fsplayer.ui.skins.ISkinListener Interface.................................................................223
11.4.4 fsplayer.ui.skins.ISkinSizeController Interface.......................................................224
11.4.5 fsplayer.ui.skins.ISlideShowWindow Interface...................................................... 225
11.5 Flash Slide ActionScript API Reference................................................................... 225
11.5.1 Flash Slide ActionScript API Reference................................................................. 225
11.5.2 slideplayer.api.IAnimationStep Interface................................................................227
11.5.2.1 Remarks................................................................................................................ 228
11.5.3 slideplayer.api.IAnimationSteps Interface.............................................................. 229
11.5.4 slideplayer.api.IHyperlinksManager Interface........................................................ 230
11.5.5 slideplayer.api.IPlaybackController Interface.........................................................234
11.5.6 slideplayer.api.IPlaybackListener Interface............................................................ 237
11.5.7 slideplayer.api.ISlideController Interface............................................................... 238
11.5.8 slideplayer.api.ISoundController Interface............................................................. 240

Page 9
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

12 JavaScript API Reference.............................................................................................242


12.1 JavaScript support in iSpring.....................................................................................242
12.1.1 References............................................................................................................... 243
12.2 fsplayer.api.Player Class............................................................................................243
12.3 iSpring.as2player.PresentationLoader Class..............................................................244
12.4 fsplayer.api.PlaybackController Class.......................................................................245
12.5 fsplayer.api.PlaybackControllerEvents Class............................................................ 249
12.6 fsplayer.api.PresentationInfo Class............................................................................250
12.7 fsplayer.api.PresentersCollection Class.....................................................................250
12.8 fsplayer.api.SlideInfo Class....................................................................................... 251
12.9 fsplayer.api.SlidesCollection Class............................................................................251
12.10 fsplayer.api.SoundController Class..........................................................................252
13 Support......................................................................................................................... 253
14 iSpring solutions...........................................................................................................254

Page 10
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

iSpring PRESENTER Guide

1 Welcome to iSpring PRESENTER Guide


iSpring PRESENTER is a Microsoft PowerPoint
add-in for transforming your PowerPoint
presentations into Flash, the most portable
multimedia format. iSpring PRESENTER lets you
create high-quality interactive Flash e-learning
courses from your PowerPoint content with audio and
video narrations. With iSpring PRESENTER you can
easily make interactive quizzes that can be published
to any SCORM compliant LMS.

Page 11
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

2 iSpring PRESENTER Activation


It is extremely important to go trough a registation and activation process before you start
using a full or a trial version of iSpring PRESENTER.
You are entitled to install and use iSpring product on two computers, one work PC and one
home PC or laptop according to iSpring licensing. You have two activations avaliable for a
License Key you receive after purchase. Please note, you can deactivate your license when
changing a PC or reinstalling Windows system.

In the sections below you will learn how to


• register and activate a full version, you need to purchase iSpring product and after the
order is processed you will receive a License Key via email;
• register a free trial version which is a 30-day fully functional version of iSpring product;
• deactivate your license when you install iSpring on another PC or reinstall entire system
on your computer;

2.1 To register and activate your iSpring PRESENTER:


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

Page 12
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 entitles
to 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 an
evaluation mode watermark will be put into each generated Flash presentation.
3. If you have already purchased iSpring PRESENTER license, please enter your
registration name and license key into the appropriate fields and click Next to proceed to
License Activation.

Page 13
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

If you want to get a license for unlimited use of iSpring PRESENTER, click Purchase a
license.
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. The
activation 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, an
evaluation mode watermark will be added to generate Flash presentations until the
license is activated.

Page 14
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

If no Internet connection is available at your current computer or it is blocked by a


firewall 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 License
Request Code and License Key via email from another computer. When you receive
License Activation Code from iSpring Support Team, please enter it into the
corresponding field and click Done. Activation Requests are usually processed within one
business day.

Page 15
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

2.2 Trial version registration


1. Click Activate button in the About section of the product toolbar to launch iSpring
PRESENTER Activation Wizard. Select the Start free trial usage option and click Next.

Page 16
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

2. Please copy and paste your registration name and license key you have received in an
email when applying for it into the appropriate fields and hit Next.
If you do not have free registration details, please go to Get the Free trial license to
apply for one at our website.

Page 17
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

3. After you entered your trial license data, you can enjoy the full-functional trail for 30
days. After the trial period is expired, you need to purchase iSpring license to continue
using iSpring software.

2.3 License Deactivation


iSpring 1-seat license implies two activations for installation on a work computer and a home
PC/laptop. If you need to change computer where iSpring installed or reinstall the system on
your PC, you need to uninstall iSpring and select Deactivate my license option prompted
when uninstalling the product. Your license will be deactivated so you can activate iSpring
on another machine. After successful deactivation a number of available and total activations
will be shown to you.

Page 18
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

3 Trial version limitations


Installing iSpring PRESENTER Trial is the best way to evaluate the product. It gives you the
opportunity to get acquainted with great capabilities of iSpring PRESENTER for free without
any functionality restrictions. iSpring PRESENTER Trial provides all conversion features
and Flash presentation tuning options avaliable in the registered product and produces Flash
content of the same quality as the full version. To evaluate iSpring PRESENTER you need to
register your Trial copy. It will be valid for 30 days and after this period expires you need to
purchase 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 the
picture below. After purchase and registration of iSpring PRESENTER this trial banner will
vanish.

Page 19
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Page 20
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

4 Getting started with iSpring PRESENTER


After successful completion of the iSpring setup, you can access the iSpring toolbar from
within PowerPoint. iSpring authoring functions provides you with the ability to make
conversion into Flash format in one click or to specify the playback settings, tune output
presentation appearance and composition. You can include audio, video, Flash making your
presentation 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
• Insert YouTube Window

One click publishing


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

Page 21
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

5 Product Features

5.1 Product features


PRESENTER 4.3 now implements our latest innovations in its PowerPoint to Flash
conversion process, providing the most accurate conversion in today's market, while also
adding new and powerful features.

5.1.1 Publishing to iSpring Online portal


Check out new facility by iSpring Solutions - iSpring Online, the professional service for
your Flash presentations sharing. Track your content in every way - who views it, who takes
quizzes, who is more active, etc.

5.1.2 AICC compliant Flash content creation


More eLearning professionals can now use iSpring Presenter as AICC format is supported as
well as SCORM 1.2 and 2004. So if AICC compatibility of your course is important, just
select a corresponding Course type in before publishing to Flash:

5.1.3 New quiz question types: Fill-in the Blank and Multiple Choice Text
iSpring-made quizzes can now be richer and more diversified with two new question types.
Fill-in the Blank and Multiple Choice Text questions are the novelties for this edition.

5.1.4 Video-enhanced questions in quizzes


Make your quiz even more captivating and fun. Have new QuizMaker video embed option
illustrate your questions with a video for you. Your movie will play in the upper-right corner
of your quiz so that a quiz-taker can think over a question while watching a clip.

Page 22
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

5.1.5 Advanced processing of SmartArt objects


SmartArt graphics now get processed by iSpring as easily as never before. So design your
presentation with this expressive mean of PowerPoint all you want and iSpring will take care
of its decent look in Flash output.

5.1.6 Custom company logo in Lite player


Handy Lite player is ready to look more professional and fancy with your company logo on
it. You'll like a nice combination of functionality and "brandability".

5.1.7 Random Effects animation support


Amaze your viewers with animated objects applied random effects to so that they'll be
different every time played. iSpring now easily handles the conversion of such animations.

5.1.8 Standard PowerPoint audio objects sound volume control


Standard PowerPoint sound control will play at the same level as this PowerPoint setting is
now supported by iSpring. So set it for high, medium, low or mute in your original
presentation and enjoy it in the Flash output.

5.1.9 Keyboard playback control customization


iSpring 4.3 allows you to control your output Flash presentation playback with your
keyboard keys, customize them the way you want, import/export shortcut combination
from/into a file.

5.1.10 YouTube video insert


With an opportunity to insert a YouTube video into your slide you have of a great likelihood
to impress. Now that you dispose this feature, the tricky part is to find the right clip to
showcase.

5.1.11 Presets
It's so less time consuming to select an offered by iSpring or individually customized preset
for certain project types. Why bother going through all of the options again and again when
you can have it all nicely preset for your convenience.

5.1.12 System Fonts Display

Page 23
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

More opportunities for speakers of oriental languages, which now get easily displayed within
Advanced Glossy, Advanced Matte and Crystal player skins.

5.1.13 Animations and Slide Transition Cancelling


Important to reduce the size of the output Flash? Easy, with a new option featured by iSpring
PRESENTER 4.2. Just uncheck 'Preserve shape animations effects´ and ´Preserve slide
transitions´ and your published newly produced file will be much lighter.

5.1.14 Watermark protection of your slides


Your copyrights can now be secured by a watermark on your slides. Its image, transparency
and position are fully customizable. Plus, you can set a web page to be opened in the same or
separate browser window when a watermark is clicked.

5.1.15 Password protection of your presentation


Unauthorized viewing is no longer an issue. Protect your presentation by setting a password
for it. It will be asked for whenever your slideshow is attempted to be viewed, even when
uploaded to SlideBoom.

Page 24
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

5.1.16 More feedback from your quiz takers


You can now track all your quiz takers detailed results. They now can be emailed or sent
directly to your LMS.

5.1.17 QuizMaker
iSpring PRESENTER features a great tool for interactive quizzes creation. iSpring
QuizMaker generates SCORM compatible content that can be published to LMS or
integrated with iSpring.

5.1.18 Advanced Glossy Player


The new highly customizable and stylish Player supports that supports Multilevel navigation,
Notes, References, Company logo and presenter's photo and info, Presenter's video

5.1.19 Slides Notes Styles


iSpring PRESENTER 4.1 accurately keeps bold, italic, underline, color, font size, bullets
styles of slides notices. Please, check the Notes tab in the sample presentation above.

5.1.20 Presentation Explorer


This intuitive tool makes your presentation structure clear, transparent and easy to customize.
You can control your timing, media positioning, as well as a presenter for each single slide.

Page 25
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

5.1.21 Audio Recording and Synchronization


Record audio narrations and synchronize them with your slideshow's playback and
animations. You will capture the attention of the viewer more easily, due to the added audio
elements supporting the presentation.

Page 26
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

5.1.22 Multilevel Navigation


A feature that is extremely helpful in expanding on any topic presented in a particular slide is
attained by making use of the 'hidden' slides function in the same directory. Group your
slides by topics within one compound presentation to make it easy to navigate. iSpring makes
this not only easy, but intuitive via the built in presenter handling tool.

Page 27
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

5.1.23 Multiple Presenters


This feature is very important for a group of people presenting one course or slideshow
together. It allows to store and access all the necessary info about each presenter: photo, title,
email, web, etc.

Page 28
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Page 29
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

5.2 iSpring PRESENTER key features


Whatever you do in PowerPoint iSpring PRESENTER can make your PowerPoint brainchild
easily distributable, viewable and accessible everywhere.
PowerPoint Features Support

PowerPoint content Embedded multimedia support


• 189 of 199 PP 2003/2007 animation effects • YouTube videos
updated • Embedded Flash movies
• All PowerPoint 2003/2007 slide transitions • AVI/WMV/MPG/MP4 video clips
• Animations by words and letters • MP3, WAV and WMA audio
• Vector representation of standard PPT objects • Background audio for a slide
updated • Background audio for a presentation
• Slide Masters with interactive elements • Sounds for animation effects
• Hidden slides support • Sounds for slide transitions
• Right-to-Left languages • Animation and sound synchronization
• Custom slideshows • Stop transition sound
• Slide notes styles • PowerPoint sound volume control new

Flash Movie Tuning Features

Appearance & Playback Flash based Player


• Animations and slide transition disabling • 10 Flash player templates
• Watermark protection of your slides • Customizable design, layout & color scheme
• Password protection of your presentation • System fonts settings
• Multilevel presentation structure • Presenter video
• Solid/Separate/Standalone Flash movie • Live preview before publishing
• Allowing playback in set domain only • Highly customizable Player template updated
• Flash context menu disabling • Ink Annotation tools
• Looped Flash presentation playback • Multilevel navigation
• Flash movie autostart control • Flash banner skin
• Flash movie preloader • Keyboard Customization new

Advanced Features

Presentation enhancement Flash movie programmatic control


• Publishing Presets • ActionScript API
• QuizMaker updated • All presentation info via ActionScrip API
• Presentation Manager • ActionScript 3 connector integration
• Multiple Presenters & Company logos • Interaction with JavaScript
• SCORM and AICCnew compliant content
• Detailed quiz results receipt Quality and Compression control
• "Smart" compression
Audio & video narrations • Compression presets

Page 30
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

• Recording audio narrations • Audio & Video bitrate control


• Recording video narrations • JPEG and PNG image compression
• Audio, video & presentation sync

Publishing and Delivery Features

Destination
• All slides/Selected slides
• Possible destinations
• Local folder at My Computer
• Sharing at iSpring Online new
• Sharing at SlideBoom
• Web site via remote FTP server
• E-mail
• SCORM and AICC new compliant LMS
• Output formats
• Flash file (.SWF)
• .EXE file - no Flash Player required
• HTML page
• ZIP archive

5.3 Animation Effects Support


iSpring PRESENTER supports 180+ animation effects of PowerPoint 2003 and PowerPoint
2007 as well as combinations of effects, effect enhancements & timing and all possible
directions 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 that
are not supported in current iSpring version are highlighted with light grey color.

Entrance Effects Exit Effects

Page 31
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Page 32
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Emphasis Effects Motion Paths

Page 33
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Page 34
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

5.4 Slide Transitions Support


iSpring PRESENTER supports all slide transition effects of PowerPoint 2003 and
PowerPoint 2007. The list of supported slide transitions is given below. Names of all effects
are the same as in PowerPoint.
• Blinds Horizontal • Shape Diamond
• Blinds Vertical • Shape Plus
• Box In • Split Horizontal In
• Box Out • Split Horizontal Out
• Checkboard Across • Split Vertical In
• Checkboard Down • Split Vertical Out
• Comb Horizontal • Strips Left-Down
• Comb Vertical • Strips Left-Up
• Cover Down • Strips Right-Down
• Cover Left • Strips Right-Up
• Cover Right • Uncover Down
• Cover Up • Uncover Left
• Cover Left-Down • Uncover Right
• Cover Left-Up • Uncover Up
• Cover Right-Down • Uncover Left-Down
• Cover Right-Up • Uncover Left-Up
• Cut • Uncover Right-Down
• Cut Through Black • Uncover Right-Up
• Dissolve • Wedge
• Fade Smoothly • Wheel Clockwise, 1 Spoke
• Fade Through Black • Wheel Clockwise, 2 Spokes
• Newsflash • Wheel Clockwise, 3 Spokes
• Push Down • Wheel Clockwise, 4 Spokes

Page 35
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

• Push Left • Wheel Clockwise, 8 Spokes


• Push Right • Wipe Down
• Push Up • Wipe Left
• Random Bars Horizontal • Wipe Right
• Random Bars Vertical • Wipe Up
• Shape Circle • Random Transition

6 Publish presentation

6.1 Publish presentation


Presentation conversion process starts with clicking Publish on your iSpring toolbar.

Publish Window helps you apply individual settings for your presentation conversion. It
consists of five different tabs described below:
• General - determines destination and composition of output Flash presentation
• Advanced - sets playback options, size and scale parameters for your output Flash movie
• Media - manages your multimedia content, and makes large presentations conversion
considerably easier by detaching media content files
• LMS - helps to organize your elearning course and its interaction with LMS
• Protection - provides options for protection of the published presentation from
unauthorized access and distribution

Page 36
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

6.2 Publish to Flash Window


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

6.2.1 Destination options


There are five publishing options on Publish Window that will help you to get results of
your presentation faster:
• Publish Presentation to My Computer - Select this option to publish your presentaiton

Page 37
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

to a folder on your local computer or network share.


• Publish Presentation to iSpring Online - This option lets you publish your presentation
online and track user viewing and e-learning activities.
• Publish Presentation to SlideBoom - This option allows you to upload your
presentation to online portal and release it worldwide.
• Publish Presentation to Web/FTP - Select this option if you want to upload your
presentation to an FTP server.
• Send Presentation via E-Mail - Select this option if you want to e-mail your
presentation.
Publish Window tabs
If you want to specify the individual settings for your presentation publishing, go through the
tabs on the Publish Window:
• General - destination and composition of output Flash presentation
• Advanced - appearance, navigation, size and scale parameters for output Flash movie
• Media - compression options for images, audio and video files
• LMS - settings for your learning-course
• Protection - copyright security settings of your Flash presentation
Should you have any questions about iSpring PRESENTER click the link Ask your question
at the bottom of the window. We will be happy to answer all your questions and help you to
get maximum benefit of our product.

6.2.2 Publish presets


iSpring 4 features a presets managing tool. It allows applying necessary settings for a certain
project. All you do is selecting a preset type from a drop-down list out of offered or newly
created ones.
To manage presets:
1. Click Custom presets on the lower part of your Publish window.
2. To apply a preset, choose it from an Available presets dropdown list and click Use
selected preset.
3. To create a new preset, hit More 'Create new. Type in a name for your new custom
preset.
4. To change your custom preset's name, click Rename and type in a new name.
5. To save your preset in an outside file, go to Import and choose a new preset containing
file destination.
NOTE! Exporting presets, iSpring creates new files in .ISX format.
6. To access already existing preset from an outside file, click Import and choose the

Page 38
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

necessary file from your resource.


7. To completely remove a preset from your computer, click Delete.
8. To leave Publish Advanced Manager, click Close.

6.2.3 Publish Presentation to My Computer


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

Page 39
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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

6.2.4 Publish Presentation to iSpring Online

Page 40
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

You can publish your presentation to iSpring Online portal which allows public or private
sharing of your content and tracking all the user activities on it.

To upload your presentation:


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

Page 41
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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

3. Click the Publish button. iSpring will save your presentation to a local folder and it
convert to Flash format. This is a time consuming process and it may take a few minutes.
4. Click the Upload button and view your presentation at iSpring Online.
Back to Top

6.2.5 Publish Presentation to SlideBoom


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

Page 42
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

To upload your presentation:


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

Page 43
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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

3. Click the Publish button. iSpring will save your presentation to a local folder and it
convert 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 for
everyone. 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

6.2.6 Publish Presentation to Web/FTP


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

Page 44
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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.

Page 45
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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

Page 46
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

FTP Account

Host name Textual host name (e.g. mysite.com) or IP


address (e.g. 77.77.55.88) of the web server
where the presentation will be uploaded.

Port FTP servers generally use port 21, but


sometimes the port number may differ. For more
information, 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 your
presentation.
Back to Top

Page 47
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

6.2.7 Send Presentation via E-Mail


If you want to send your presentation, select Send via E-Mail option. A new e-mail with the
presentation attached to it will be created by your mail program. You can immediately send it
to 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.

Page 48
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Back to Top

6.3 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 will


display in Player.

Destionation A local folder, SlideBoom portal, FTP Address or


e-mail depending on where you want to store

Page 49
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

your Flash presentation.

File name The name for output .swf file, title for a folder if
you publish presentation as separate slides and
name for the .zip file if you archive Flash movie.

General | Slide Range

All Slides Select this option if you want to convert into


Flash format the entire presentation.

Selected Slides This option will allow you to publish only


selected slides from your presentation. Select
necessary slides from within PowerPoint then
choose the Selected Slides option and publish
your presentation.

General | Flash Output

Publish to LMS iSpring will publish your presentation ready to


upload to any LMS. You can see the example of
how to upload your presentation to Moodle and
to OLAT LMS. Most of LMSs requires creating
.zip archive for uploading, so we recommend
you to check ZIP output option that is on the
bottom of this window.

Presentation PowerPoint presentation will be converted into a


solid Flash movie or in a set of .swf files wraped
in Flash based Player.

All in one Flash file All slides of PowerPoint presentation will be


converted into a solid Flash movie with all
external resources embedded in one .swf file.

Generate HTML file iSpring generates a simple HTML web page with
Flash movie that simplifies publishing on the
Web. You can choose either presentation
publishing as a HTML file or as an executable
(.exe) file.

Generate EXE file If selected, iSpring PRESENTER generates an


executable (.exe) file with Flash presentation.
Such movie can be displayed everywhere even
if you don't have Flash Player installed.

Full screen playback If this option is enabled, your presentation will


occupy the entire screen during playback.

Page 50
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Standalone Flash Slides iSpring will generate a set of .swf files. Each
slide of your PowerPoint presentation will be
converted into a separate Flash movie and no
Player is created to control Flash clip playback.
This mode can be useful if you plan embed
custom player or integrate Flash slide into web
pages or your blog.

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

General | Preveiw

Skin Select skin for Player from the drop-down menu. Ten
skins are available:
Advance Glossy skin is new stylish and fully
customizable Player with support of Multilevel
Navigation, Presenter's video, Marker Tools and
Multiple Presenters and logos.
Advance Matte skin is highly customizable skin that
allows you to adjust unique colors for Player and
Marker tools, customize navigation elements and
specify your own captions for tabs and buttons.
Banner is special skin optimized for Flash banner
creation. It doesn't support transition effects and
sounds but therefore the output file size is smaller in
comparison with no skin option.
Classic skin wraps your Flash movie into the Player
with thumbnails view, outlines view, slide notes view
and Presenter info.
Crystal skin allows you to customize player layout,
navigation elements and create unique presentation
appearance.
Lite updated provides basic navigation options to
control Flash presentation playback and allows to
customize company logo.
None allows you to publish presentation without
visible Player.
Navigation panel supports most commonly used
navigation operations to control slide navigation of
your Flash presentation.

Page 51
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Navigation + Marker provides you with basic


navigation elements and Marker tool with
customizable types and colors.
Navigation + Notes provides you with basic
navigation elements and Notes.

Info You can get detailed description of how you can


customize
• Advanced Glossy Skin
• Advanced Matte Skin
• Crystal Skin
• Classic Skin
• Navigation panel
• Navigation + Marker.

Customize You can customize the Advanced Glossy,


Advanced Matte, Lite, Classic, Crystal skins,
Navigation + Marker and Navigation + Notes
panels. The Live Preview feature allows you to
see immediately how your presentation will look
when after conversion.

6.4 Publish to Flash Window - Advanced Tab


Use the Advanced tab to configure the options for PowerPoint to Flash conversion, specify
size of presentation and settings to control Flash movie playback.

Page 52
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Advanced | Flash movie

Size Width and height of output Flash presentation.

Scale Percentage of the movie's size relatively to the


original presentation's size.

Note: width, height and scale are related parameters and iSpring maintains the aspect ratio as
you change one of these parameters. iSpring technology allows to reduce the height and the
width of the presentation without loss of clarity.
Advanced | Flash movie

Flash Movie Frame rate The number of Flash frames per second. Small
values are not recommended because this can

Page 53
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

cause flickering when playing animations.

Background color You can set a background color for the entire
presentation. Double clicking the current color
next to this option will open a standard window
where you can select an appropriate color.

Flash version Select the version of Flash Player. Flash players


of 7, 8, 9 versions are available.

Disable Flash printing Check the box if you don#t want to allow printing
your output Flash presentation. #Print# option in
the right-click menu will be disabled in the
generated Flash file.

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

Optimize images for resolution Check the box to optimize images for given
screen resolution which you can select from the
dropdown menu. If set value is smaller than
presentation size, images will be optimized for
the presentation dimensions.

Enable interaction with JavaScript If this option is checked out Flash presentations
will include the JavaScript Connector that allows
Flash movie playback control via HTML code.

Integrate ActionScript 3 connector Tick this option in case you use Flash files
written in ActionScript 3 to control presentation
playback. ActionScript 3 Connector module will
be integrated into output Flash presentation.

Provide complete presentation info Tick this option if you need to perform
ActionScript API programmatic control over Flash presentation. If
checked all information about presentation will
be available via ActionScript API regardless of
the player template used.

Advanced | Playback and Navigation

Add Preloader This option adds a preloader to Flash


presentation which shows a progress of the
Flash presentation loading.

Start presentation automatically Tick this option if you would like your Flash
presentation to start playing automatically as
soon as the first slide is loaded.

Page 54
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Change all slides automatically If this option is checked slides in your Flash
presentation will advance automatically.

Minimal slide duration This value indicates minimal playback time in


seconds for non-animated slides. Slide duration
for particular slides can be specified in
Presentation Explorer.

Auto-play on-click animations each Select it to automatically advance to the next


step for on-click animations after the number of
seconds you enter.
"Automatic animations" option will also respect
timing set from within PowerPoint.

Advance animations on mouse click Select it to advance to the next animation step
when you click the mouse.
This option applies only for slides that contain
mouse driven animations, 'Automatic
animations' will always start according to the
timings set from within the Custom Animation
dialog of PowerPoint.

Keyboard playback control This option allows you to control presentation


playback by keyboard keys.
Mark this option, if you want to control your
output presentation playback with keyboard. The
following set of keys will be applied by default:
• 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
Click Customize if you want to change the
keys for certain actions. You can set up to 3
keys per each action and import/export a set of
shortcut keys from/into a file.

Looped playback If selected, your presentation will automatically

Page 55
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

start from the beginning after the last slide is


finished. This feature is essential for creation of
Flash banners and trade shows.

Preserve shape animations effects + Unmark these options to reduce the output file
Preserve slide transitions size, disregarding animation effects and slide
transitions

6.4.1 Keyboard Customization


You can control your output Flash presentation playback with your keyboard keys, customize
them the way you want, import/export shortcut combination from/into a file.
To make Keyboard Playback control available for your output Flash file, please tick
Keyboard playback control and click Customize.
To reassign the shortcut keys, click Customize.

Each action can be set to be controlled by up to 3 different keyboard keys.


To add a new key for an action, click a blue pen icon in one of the three columns in a
corresponding line and press a required key or key combination with Ctrl or Shift.
Note: You cannot assign one key for two or more actions. If you enter an already assigned
key or key combination, you will be additionally asked if you really want to replace it.
Click red cross icon to remove a shortcut key.

Page 56
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

You can export a set of shortcuts into a file to further apply it to other projects. Once you are
done assigning all the shortcuts, click Export. Name the file and select the directory to save it
to in the Save As dialog window.

Page 57
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

To apply an already saved shortcut set, click Import and select a necessary file with an .isk
extension.
Click Reset defaults to cancel all the implied changes and get back to the default set of
shortcuts.

Page 58
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

6.5 Publish to Flash Window - Media Tab


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

Compression

Use Preset iSpring Presenter provides you with 4 present


compression modes that optimize Flash movie
for publishing to the web with low or high
connection speed, publishing to the Local
Network drive or publishing on CD. Also you can
create up to 10 custom compression presets
special for your individual needs.

Page 59
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Image compression If you check "Smart compression" mode for


converting your presentation to Flash, all images
will be saved keeping high quality and small
size. Read more about Smart compression in
(http://blog.ispringsolutions.com/?p=133) iSpring
blog. "Lossy" compression will convert and save
all embedded images to .jpg format. "Lossless"
compression converts all images in your
presentation with the highest quality.

Audio compression By default iSpring PRESENTER keeps original


quality of audio in presentation. If needed you
can set higher or less bitrate but it will influence
output file size and audio quality.

Video compression By default iSpring PRESENTER keeps original


quality of video in presentation. If needed you
can set higher or less bitrate but it will influence
output file size and video quality.

Flash Multimedia Tuning

Smooth raster images Smoothing usually enhances the quality of raster


images rendering but sometimes can lead to
undesirable results when the Flash movie is
created for Flash Player version 8 or higher. It is
recommended to set this propety to false when
the target Flash player version is 8 or higher
since the rendering quality of Flash Player 8 is
quite good and additional smoothing makes
raster images blurred.

Advanced Smart Art Processing This feature allows getting a better quality of
SmartArt objects and save the animation effects
applied to them. As this option is using
Clipboard, it is recommended not to use
Clipboard during the iSpring conversion process.
Due to technical characteristics some SmartArt
objects may look or play slightly differently. In
this case, the option may be turned off so that
SmartArt object will be saved as raster images
and animation will be lost.

Detach media content

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

Flash movies If you check this option, your presentation and

Page 60
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

embedded Flash movies will be saved into


separate .swf files.

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

Audio Files In case the audio embedded into your


presentation is large, it is recommended to
enable this option. The audio will be saved into
separate file and your Flash presentation will
load faster.

6.6 Publish to Flash Window - LMS Tab


LMS tab allows you to select your course type, set information about the presentation and
customize settings for your training course.

Page 61
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

LMS Settings | Course type

Version Select a type of standard version for you training


course: SCORM 1.2, 2004 or AICC. Learn more
about SCORM versions and AICC features and
differences between them Wikipedia.

LMS Settings | Information

Course title Put in your training course name here.

Lesson title / Course identifier Put in your lesson name / Put your course
identifier

Description Type in a brief description of your training

Page 62
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

course here.

Keywords / Course creator Specify keywords for your LMS. They will help
people find your training course by these
keywords / Name the course author here

Note! If AICC is selected as a course type, the following changes apply:

LMS Settings | Options

Minimum number of slides viewed to Set a minimum number of slides learner must
complete view to complete the lesson.

Duration The time given for the lesson. It is implied that


during the time set students would learn the
lesson well.

Timeout actions When the time given to the lesson is out you can
set the following actions: terminate lesson
and/or show message that the time has run out.

Report progress and completion You can choose how to report student's
progress and completion. Having it by Using
number of slides viewed, you have to specify
the minimum number of slides viewed for the
lesson to be completed.
If you set as Using quiz results, you have to
select the quiz to be counted.

Using quiz results Your quiztakers# results can be sent directly to

Page 63
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

LMS. Tick Report progress and completion to


have minimum, maximum and actual scores
reported to your LMS.

Page 64
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

6.7 Publish to Flash Window - Protection tab


Your copyrights can now be secured by a watermark on your slides, password for your
presentation and playback on certain domain only.

6.7.1 Watermark protection of your slides


Watermark image, transparency and position are fully customizable. Plus, you can set a web
page to be opened in the same or separate browser window when a watermark is clicked.
1. To add a watermark to your slides, tick Add watermark and select an image from your
resource.

Page 65
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

2. Use Position radio-button, to determine the placement of your watermark on a slide.


3. Drag-and-drop Transparency slider to regulate the transparency level of your watermark
from 100% Opaque to 0% Transparent.
4. Tick Open the following page on mouse click, to have the stated webpage opened
whenever the watermark is clicked.
5. To have a webpage opened in a separate browser window, tick Open link in a new
browser window.

6.7.2 Password protection of your presentation


The password protects your presentation from unauthorized viewing. It will be asked for
whenever your slideshow is attempted to be viewed, even when uploaded to SlideBoom.
1. Tick Protect presentation from unauthorized viewing with the following password.
2. Type in your password twice in Password and Confirm password blank fields.
NOTE! Please, take into consideration that the password is saved in the Flash presentation in
encrypted form. There is no way to restore this password except checking all possible
alternatives.

6.7.3 Domain restriction


Restricts presentation playback to the specified domain(s). Generated Flash presentation will
play only in the specified domain(s) and all its subdomains. It won't play on a local computer
or on another web site. Use this option if you want to protect your Flash content from
unauthorized redistribution.
Note! This option doesn't prevent Flash presentation playback when it is referenced from
another domain using <object> HTML tag.

7 Players

7.1 iSpring Players


iSpring PRESENTER can wrap output presentation into Flash based Player. Current version
includes 10 different players, 7 of which are highly customizable. Your Flash presentation
can look as in PowerPoint with a simple Navigation + Marker panel or can be wraped in the
Advanced Player which contains notes, outlines, thumbnails, PRESENTER info and
references.
Follow the links below to find detailed description of how you can customize a player
creating unique appearance and keeping handy navigation.
The players were updated with support of system fonts that improves representation of

Page 66
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

oriental characters in player templates.


• Advanced Glossy
• Advanced Matte
• Crystal Player
• Classic Player
• Navigation panel
• Navigation + Marker
You can set custom company logo for the Lite player. Navigation + Notes player can only
adjoin left or right side of the presentation. The other Banner and None players are not
customizable.

Page 67
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

8 Presentation management

8.1 Presentation Management


iSpring PRESENTER new interface was updated with the Presentation section containing
tools to manage structure and media content of your Flash presentation. There are 3 tools for
presentation management:
• Presentation Explorer to organize presentation structure, import media narrations and add
quizzes.
• Links to manage references, attachments and web links in the presentation.
• Presenters to add presenters info, company logo and links to company website.

8.2 Presentation Explorer


New Presentation Explorer is an efficient tool that allows you to set up a presentation
structure and slide advance options,
add presenters and media resources in a single window. With Presentation Explorer it's
easy to add audio and video narrations
or quizzes. You can edit your presentation slide by slide or apply similar setting to a selected
group 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

Page 68
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

8.2.1 Multilevel Navigation


You can adjust slides nesting level to organize multilevel navigation in your presentation
with 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 to
add only one nested level (2). If you assign any slide to level 2 than you can move
subsequent slide to level 2 or 3 and so on.
Your presentation may contain up to 8 levels in hierarchy. Also you can collapse and expand
nested slides using "-" and "+" icons on the left of a top level slide.

8.2.2 Hidden Slides

Page 69
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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

8.2.3 Slide Title


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

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

8.2.5 Playback mode


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

8.2.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 in
Settings tab of Publish window.
Media
This section allows you to manage external audio, video and quiz in a slide. If media has
been already added to a slide, the corresponding icons are active, allowing playing audio and
video or editing a quiz.
You can also add audio and video narrations to a slide using the Import Audio and Import
Video buttons of the iSpring Presenter toolbar.
Note: iSpring Presenter allows you to add one audio and one video per slide. You can also
add a background audio for the entire presentation.
Further to importing media resources, you can record audio and video narration with iSpring

Page 70
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Presenter.

8.2.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 the
Auto Play checkbox at the bottom of the explorer window.
By default the slide duration is adjusted to the audio file duration. If you uncheck the
Adjust slide duration to fit audio option, PowerPoint timings for animated slides and
minimal slide duration for non-animated slides may affect slide duration and your audio
may not playback in full.
3. Click Open. The audio file will be added to the selected slide.
8.2.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 the
video 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 play
automatically in the explorer viewport. To disable this feature uncheck the Auto Play
checkbox at the bottom of the explorer window.
By default slide duration is adjusted to the video duration. If you uncheck the Adjust slide
duration to fit video option, PowerPoint settings for animated slides and minimal slide
duration for non-animated slides may affect slide duration and your video may not playback
in full.
By default iSpring creates a folder in a directory with your presentation for all external
resources of PowerPoint presentation and copies the video file into that folder. If you want to
edit or show presentation on another computer you can easily copy PPT presentation and
folder with all external resources. In Flash format all media resources are embedded into the
movie and you have solid SWF file from your presentation. To disable gathering media
resources in additional folder uncheck the Copy to presentation resource folder option.
Note: audio and quizzes are always copied to the resource folder.

Page 71
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

8.2.9 Media - Quiz


iSpring Presentation Explorer lets insert quizzes into PowerPoint slides via quiz editing
buttons. Please refer to QuizMaker documentation to learn more about QuizMaker facilities.
Quick managment
Managment

Toolbar Use the options on the Presentation Explorer toolbar


to edit a group of selected slides. These settings
behave the same way as for a single slide. Please see
the detailed description above.

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

Presentation Background Audio


Check the box to add a background audio for the entire presentation. iSpring Presenter
supports .MP3, .WMA and .WAV audio file formats.
To add an audio file, click the "..." button and select an audio track. You can listen to the
audio clicking on the speaker icon.
Check the box to loop audio during presentation playback. The audio will loop if
presentation playback duration is longer than the background audio duration.

8.3 Links

8.3.1 Links
Presentation Links manager allows you to add, edit and delete references, file attachments
and web links in a Flash presentation.

Presentation Links includes 2 windows:


• References to manage web references and file attachments in a Flash presentation

Page 72
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

• Web Links to link your presentation to web page or blog

8.3.2 Links - References Tab


References are external resources that you would like your audience to view during your
presentation 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 the
Reference window of the Crystal player. To make them available, enable References in
players 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.

Page 73
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

To open a selected reference in a new browser window, check the box New Window. To
edit 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 URL
under Location option. For more effective management you can rearrange the references
clicking the Type, Title, Location, New Window options to sort the references according
to desired attribute. To delete all references from your presentation, use Remove All
References button. You will be asked to confirm the deletion.
3. When you have finished with your references, click OK to save your updates. To quit
without 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.

Page 74
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 file

Page 75
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

you've chose. You can select a different file clicking the ":" button on the right of the
Path field. The Title that is displayed in the Reference screen of the player is taken your
file name by default. You can easily edit it and enter the title you#d like to show your
viewers.
5. Check "Open in new browser" window option to if you want to open each file in a new
browser window. This option makes sense only for files that are viewable via internet
browser, e.g. .jpg or .pdf files.
6. When you finished with your settings, click Ok to save an attachment. To exit without
saving changes, click Cancel.

8.3.3 Links - Web Links


The Web Links tab allows you to link your Flash presentation to web pages. When you
create a hyperlink to a page the hyperlink destination is represented by the path to a web
resource (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.

Page 76
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 are
hyperlinks to some external resources, not a slide in presentation. You can set up how
hyperlink destination should be opened: in the same browser window where
presentation 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, any
click on the presentation area will open the specified web page or file. This feature is
useful 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. By
default the path is prefilled with "http://". Be sure to keep it in your web link.

Page 77
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Check the Open link in new browser window box if you want to open the destination
web resource in a new browser window.
Flash presentation redirect
Check this option to open automatically a specified web page after presentation playback
is completed.
If the option is enabled, type manually the URL address of web page. By default the path
is 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 destination
web resource in a new browser window.
4. Click OK to save your updates. To quit without saving changes, click Cancel.

8.4 Presenters

8.4.1 Presenters
Presenters# manager allows you to add, edit and delete presenters in your Flash presentation
and manage company info.
Presenter and company info are available in Advanced Crystal, Advanced Matte, Crystal and
Classic players. Please, be sure to enable presenter info option within a player.
Since version 4.1 iSpring allows to specify custom company logo for each presenter. Also
you can set a common logo that is applied to all presenters by default.

Presenter manager includes 2 windows:


• Presenters to manage presenters.
• Company to add company logo and URL to company web site.

8.4.2 Presenters manager - Presenters Tab


Presenters Tab allows you to add, edit or delete presenters and set up a default presenter that
will be automatically added to your Flash presentation.
All information about presenters is stored in your presentation. So it will be available if
editing a PPT presentation on another computer or sending it via email. Presenter info is also
stored on your local computer so when you open a presentation you can always update the

Page 78
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

presenter to the latest one. And being stored in your computer presenter?s info can be
updated and added to any presentation.
And being stored in your computer presenter#s info can be updated and added to any
presentation.

All presenters you add can be managed in a Presenters window. Use Add Presenter and
Edit Presenter buttons to update information about a presenter. To delete a presenter, select

Page 79
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

a presenter and click the Delete Presenter button.


You can specify a Default Presenter that will be automatically assigned to all slides in your
Flash presentation. Select a presenter from your list and check the Default box. To assign
different 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 the
Presenter info during Flash presentation preview or playback.

Page 80
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 consider
valuable to the viewers.

Photo Click the Browse button to add or change a


presenter#s photo. iSpring supports all most popular
image file formats as .JPG, .PNG, .GIF, .BMP,
.WFM, .EMF. The best presenter photo dimensions
are 62x82 for Advanced player, 100x130 for Crystal
player and 60x40 for Classic player. If the photo is
not fit the dimensions iSpring automatically adjusts
photo to fit the width/height of the photo area in a
player.

Company logo Use presenter-specific company logo Check the box


to 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 selected
company logo.
A company logo and web site that apply to all
presenters without specific logo could be set in the
Default Company tab of the Presenters window.

8.4.3 Presenter manager - Company Tab


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

Page 81
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

To add info about your company:

Page 82
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 company
logo. iSpring supports all popu.JPG, .PNG, .GIF,
.BMP, .WFM, .EMF image file formats.

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

9 Narration

9.1 Narration section


iSpring PRESENTER gives you an opportunity to deliver audio and video narrations to your
audience. There are two ways of providing your presentation with narrations: importing
existing audios and videos or recording new ones right within your PowerPoint. Easy to
handle. Easy to synchronize.
• Record audio
• Record video
• Import audio
• Import video
• Synchronize

9.2 Audio Recording


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

Page 83
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

To record Audio:
1. Click Record Audio in the Narration area in your iSpring toolbar to launch Record Audio
Narration window.

2. Choose the slide you would like to record audio narration to or the one to start recording
at 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 to
start recording at

Page 84
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Start record / Click to start audio recording/


Next animation/ Click to advance to the next animation/
Next slide/ Click to advance to the next slide/
Stop 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 do
want to rerecord an existing audio

Settings Click to select audio recording device

Resync Click to resynchronize the recorded audio with a


slide(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

9.3 Video Recording


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

To record Video:

Page 85
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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

2. Choose the slide you would like to record video to from the drop-down slide list
3. Click Start record to start video recording
4. 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 / Click to start video recording/


Next animation/ Click to advance to the next animation/
Next slide/ Click to advance to the next slide/
Stop 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 video Tick this option to be additionally asked if you do
want to rerecord an existing video

Settings Click to select video recording device

Resync Click to resynchronize the slide with the recorded


video

Left arrow button Click to go to the previous slide

Page 86
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Right arrow button Click to go to the next slide

9.4 Audio Importing


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

To import Audio:
1. Click Import Audio in the Narration area in your iSpring toolbar to launch Open
window

Page 87
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

2. Choose an audio file that you would like to add to your presentation
NOTE: 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 list
4. Click Open to import the selected audio or Cancel to quit without saving any changes
How to import audio:

Page 88
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 slide
timing in accordance with audio duration

Auto play Tick this option for a preliminary playback of


imported audio

Play/ Click to play the selected audio/


Stop 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.

9.5 Video Importing


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

To import Video:
1. Click Import Video in the Narration area in your iSpring toolbar to launch Open
Window

Page 89
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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:

Page 90
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 slide
timing in accordance with video duration

Auto play Tick this option for a preliminary playback of


imported video

Play/ Click to play the selected video/


Stop Click to stop the playing video

Copy to presentation resource folder Tick this option to copy the video to an automatically
created Video folder in your original presentation
resource folder
(When converting with iSpring PRESENTER, three
new separate folders Audio, Video and Quiz are
automatically created in the presentation resource
folder 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.

9.6 Synchronization
Perfect playback has to be flawlessly timed and easy-to-handle. Make your slideshow play
smoothly with the Sync option.

To synchronize your presentation narration:


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

Page 91
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

narration window.

2. Choose the necessary slide 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 synchronize:

Drop-down list Choose the slide you want to synchronize

Start sync/ Click to start synchronization process/


next animation / to advance to the next animation/
next slide to advance to the next slide

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

Video window Displays the video

Left arrow button Click to go to the previous slide

Right arrow button Click to go to the next slide

10 Insert

10.1 Insert
iSpring PRESENTER lets you easily insert Flash movies (.SWF files) to your slides, create
interactive Flash Quizzes and add YouTube videos.

Page 92
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

The "Insert" section provides you with the following functions:


• Flash option allows you to insert a Flash object into the slide;
• Quiz option opens iSpring Quiz Builder application allowing you to create or edit Quiz;
• YouTube option allows you to insert video clip from YouTube.com web site.

10.2 Insert Flash


Insert Flash Window allows you to insert external Flash (.swf) movies into your PowerPoint
slides 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. Please
Note: iSpring doesn#t support Flash files previously converted from PowerPoint with
iSpring.
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 to
security restrictions. It only creates a link to a Flash file. So if you desire to move
PowerPoint 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 original
computer or insert Flash file once again.
After conversion to a solid Flash file, all inserted Flash resources will be embedded into
your Flash presentation. On the other hand if you have a lot of external Flash files or a
big Flash file inserted in your PPT presentation we recommend storing them in a separate
resource folder (use the Detach Embedded Flash movies option).

10.3 Insert Quiz

10.3.1 QuizMaker

Page 93
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Quiz section:
Quiz section

Save Use Save button to save your quiz.


NOTE: By default iSpring creates a folder in the
same directory with your presentation for all external
resources of PowerPoint presentation and new

Page 94
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

quizzes are automatically stored into that folder.


If you want to edit or show presentation on another
computer you can easily copy PPT presentation and
folder with all external resources. In Flash format all
media resources are embedded into the movie and
you have solid SWF file from your presentation.

Clear Click the Clear button to delete all the questions


from your quiz.

Settings Quiz settings allows you to manage appearance,


feedback, question defaults for your quiz. (see a
Settings window for more info)

Clipboard section:
Clipboard section contains three standard tools Copy, Cut and Paste for copying, cutting and
pasting text fragments correspondingly.
Preview section:
Preview section has the only button Quiz preview for live preview and taking a quiz before
publishing.
Add Question section:
Add Question section is used for adding new questions to the quiz.
Clipboard

True/False A student is asked to define


whether a statement is True or
False.

Multiple Choice A student has several alternatives


to choose from and with only one
correct answer.

Multiple Response A student has several alternatives


and more than one of them can be
a correct answer.

Type In A student should enter an answer


in the blank. You can specify
several keys that are counted as a

Page 95
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

correct answer. For example, for


the question #What is the star of
our system# you can set up #sun#,
#Sun# and #the sun# as correct
answers.

Matching A student should match pairs.

Sequence A student should arrange the items


in the required order.

Numeric A student should enter a number.


You can set up whether it should
be an exact number, can be
grater/less than a number or can be
from a specified interval.

Fill-in the Blank A student is asked to feel in the


blanks in the text given.

Multiple Choice Text A student is offered to select a


correct answer out of the
alternatives given in a drop-down
list for each blank.

QUESTION area
Each question could be enhanced with a picture, an audio or/and a video.

Page 96
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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


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

Page 97
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

To remove added image/audio/video:


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

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

Page 98
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 correct


answer

Shuffle answers Tick this checkbox to deliver answers in a shuffled


order

Allow partial answer Tick this checkbox to count a partial answer for the
question

Preview question Click to preview the question

iSpring QuizMaker is easy to customize. It is featuring various settings options as managing


timing, questions arrangements, feedback, quiz results and even player interface.

10.3.2 QuizMaker - Settings

Main

Page 99
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 (points


or percentage)

Allow users to finish without answering all Tick this checkbox to allow quiz takers to quit
questions without answering all the questions

Page 100
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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

Submit all at once Choosing this option you will learn your total points
in 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 each
question

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

Question Defaults

Page 101
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 a
question

Page 102
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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

Page 103
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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

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

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

Result

Page 104
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Result

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

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

Display passing score Tick this checkbox to allow viewing the passing
score

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


messages

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

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

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

Send quiz result to email Tick this checkbox to automatically email the quiz
result to (specify email address). You can enable the
Send detailed results to received detailed info on the
questions and users' answers, e.g. answers variants
available and the selected one for the Multiple
Choice questions.
NOTE: If this option is ticked, an authorization is
asked when starting the quiz

Send quiz result to server Tick this checkbox to automatically receive the quiz
result on the server.
You can receive detailed quiz results on your server
using the variables and .xml document sent as a
POST request. The following variables are sent to a
server via POST method:
v - report version
dr - detailed result in .xml format corresponding to
the schema below.
sp - gained score in points
ps - passing score OR psp - passing score in percent,

Page 105
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

that is how much of a total score in percent a user


must gain to pass a quiz
tp - gained score
sn - quiztaker username
se - quiztaker email
qt - quiz title
You can also check the detailed schema specifying
the .xml document format.
NOTE: If this option is ticked, an authorization is
asked when starting the quiz

If user fails: Select either to close the window or send the quiz
taker to web page (specify the URL in the space
provided) if he/she fails

If user passes: Select either to close the window or send the quiz
taker to web page (specify the URL in the space
provided) if he/she passes

Player Customization

Page 106
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Player Customization

Color Color iSpring QuizMaker provides 8 color schemes


for quiz Player. To customize player color click the
arrow and select theme that fits your content the best
way from the drop-down menu. You can immediately
see new player layout in the preview. To view
full-size quiz, select a theme and click Preview.

Hue Drag the slider to pick out the right color

Page 107
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 the


changes in the color scheme of the quiz

Text Labels Change the labels names and popup messages in


accordance with your preferences. Please don't
change elements in "%%" like %INDEX%.

Save as… Save the labels scheme

Load… Apply a ready-to-use labels scheme

10.4 YouTube video insert


iSpring makes it possible to insert a YouTube video into your presentation.

Note 1: Internet connection is essential for YouTube videos transmission within your
presentation.
Note 2: your videos should have public access and be viewable for everyone.
To insert a YouTube video:
1. Click YouTube button in the Insert section of the iSpring panel in your PowerPoint.
2. Open www.youtube.com in your browser; find a necessary video clip to later insert it into
your presentation. When you are done searching for a video clip, copy its URL from the
URL option on the right of a video clip or address line of your browser window.
3. Paste a preferred YouTube video URL into the Video Link blank field and click Preview
to view a clip.

Page 108
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

4. Tick "Turn off automatic slide transition for this slide" to cancel automatic advance of a
YouTube video containing slide to a next one.
5. Click OK to insert YouTube video into your slide.

11 ActionScript API References

11.1 iSpring ActionScript API


iSpring products provide PowerPoint to Flash conversion facilities on the highest level.

Page 109
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Moreover, Flash content created with iSpring Presenter and iSpring SDK provides
programmatic 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

11.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 type
of Flash presentations. It is optimized for progressive downloading and starts playing as
soon 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-200
slides). A Solid Flash Presentation structure is shown in the following picture.

Page 110
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Solid Flash Presentation structure


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

Page 111
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Compound presentation structure


Since all presentation resources are stored in separate Flash files, the compound Flash
presentation allows playback of large presentations containing hundreds of slides. Slide
related resources such as fonts and images are not shared between slide files (i.e. each
slide 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 the
corresponding solid flash presentation.
3. Standalone Flash Slides. Each presentation slide is converted to the standalone Flash
file which can be played independently from other slides. However standalone slides do
not play slide transition effects and do not perform slide switching. Standalone slides can
be loaded and managed by external Flash application, so this conversion mode is mainly
suitable for Flash developers. Standalone slide structure is shown in the picture below.

Page 112
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Standalone Slide Structure

The detailed description of the Flash Presentation Structure can be found in the following
article.
iSpring Presentation Structure

11.1.2
Presentation playback control facilities
Flash presentations created with iSpring can be controlled programmatically. For this
purposes solid and compound Flash presentations provide Flash Presentation ActionScript
API, a set of ActionScript 2.0 interfaces for controlling presentation playback and
navigation. The following article provides a detailed description of the Presentation API
methods and interfaces.

Page 113
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Flash Presentation ActionScript API Reference

11.1.3
Slide playback control facilities
Standalone slides provide Flash Slide ActionScript API, a set of ActionScript 2.0 interfaces
for controlling slide playback and navigation. The following article provides a detailed
description of the Slide API.
Flash Slide ActionScript API Reference

11.1.4
Skin development facilities
iSpring generated presentation can be wrapped into a "skin", a special user interface module
which simplify presentation navigation displaying slide thumbnails and other navigation
elements. 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 be
developed by any Flash developer familiar with ActionScript 2.0 and basic principles of
Object oriented programming. The following article describes the skin development process
Skin Development Reference
See also
Flash format limitations
Flash Presentation ActionScript API Reference
Flash Slide ActionScript API Reference
iSpring Presentation Structure
Skin Development Reference

11.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.

Page 114
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

11.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 file
optimized for progressive downloading from the Internet. When a presentation is converted
to a set of Flash files with player, each resource is stored in a separate file.

11.2.2 Player core module

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

Page 115
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

In order to load and play presentation slides the core needs a target MovieClip object where
slide 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 target
movie clip.

11.2.3 Skin module

Skins are Flash modules which main responsibility is providing the player core with the
MovieClip where slide assets should be loaded and displayed. Skins also provide viewers
with navigation and playback facilities. Skins interacts with the player core via ActionScript
API provided by player core.
There is a set of predefined skin modules with iSpring products. Some of them provide
simple user interface while other skins provide full featured customizable User Interface.

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

Page 116
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

11.2.4 References
IPlayer Interface
ISkin Interface
Skin development
Flash Presentation ActionScript API Reference

11.3 Flash Presentation ActionScript API Reference

11.3.1 Flash Presentation ActionScript API Reference


Solid and compound Flash presentations generated with iSpring contain the player exposing
an ActionScript API which provides external Flash applications with programmatic access to
the Flash presentation:
• Presentation playback control - navigation by slides, animation steps, and position, ability
to 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 slide
playback. 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. This
function returns the fsplayer.api.IPlayer interface providing an access to the rest interfaces of
the Flash presentation. There is the fsplayer.api.CPresentationLoader class which simplifies
loading 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

ActionType Defines a set of playback action types

CPresentationLoader Simplifies Flash presentation loading and provides


access to its IPlayer interface.

Page 117
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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

IKeyboardSettings Allows determining of the playback action which


corresponds to the given key combination

IPlaybackAction Provides information about keyboard playback action

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 playback


control facilities

IPresenterInfo Provides the information about presenter

IPresenterPhoto Provides the information about presenter photo

IPresenterPhotoLoadingListener Receives the presenter photo loading event


notifications

IReferenceInfo Provides the information about the particular


presentation reference

IReferencesCollection Stores a collection of presentation references

ISlideInfo Provides the information about the particular slide

Page 118
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

ISlidesCollection Stores a collection of slides

ISlideThumbnail Provides the information about the particular


thumbnail

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 structure
iSpring ActionScript API

11.3.2 fsplayer.api.ActionType Class


The ActionType class defines the following action types:
Properties

Property Value Type Access Property Value Property


description

PLAY_PAUSE String Read only playPause Defines a


play/pause action
type

NEXT_SLIDE String Read only nextSlide Defines a go to


next slide action
type

PREVIOUS_SLIDE String Read only previousSlide Defines a go to


previous slide
action type

FIRST_SLIDE String Read only firstSlide Defines a go to the


first slide action
type

Page 119
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

LAST_SLIDE String Read only lastSlide Defines a go to the


last slide action
type

LAST_VIEWED_SLIDE
String Read only lastViewedSlide Defines a return to
the previously
viewed slide action
type

SLIDE_START String Read only slideStart Defines a go to the


beginning of the
current slide
action type

SLIDE_END String Read only slideEnd Defines a go to the


end of the current
slide action type

SEEK_FORWARD String Read only seekForward Defines a seek


forward action
type

SEEK_BACKWARD String Read only seekBackward Defines a seek


backward action
type

NEXT_STEP String Read only nextStep Defines a go to


next step action
type

PREVIOUS_STEP String Read only previousStep Defines a go to


previous step
action type

VOLUME_UP String Read only volumeUp Defines an increase


sound volume
action type

VOLUME_DOWN String Read only volumeDown Defines a decrease


sound volume
action type

Page 120
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

See also
IPlaybackAction Interface
Flash Presentation ActionScript API Reference

11.3.3 fsplayer.api.CPresentationLoader Class


This class extends the standard MovieClipLoader class available since Adobe Flash Player 7
and simplifies the process of iSpring generated Flash movies loading.
This class is not a part of the ActionScript API provided by generated Flash movies. A
source 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 the


CPresentationLoader class

setPlayerListener(listener:IPlayerListener):Void This method passes the IPlayerListener interface to


the loader. The passed listener object will receive a
notification when player is initialized

loadClip(url:String, target:MovieClip):Void This method loads iSpring generated presentation


into the specified movie clip

Properties

Property Type Description

player IPlayer Returns the reference to the player


in loaded Flash presentation

bytesLoaded Number Returns number of loaded bytes of


the Flash presentation

bytesTotal Number Returns total number of bytes of


the Flash presentation

Page 121
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 the
player
loader.setPlayerListener(this);
// load generated Flash presentation
loader.loadClip("presentation.swf", presentation);
// this method is invoked when player gets initialized
function onPlayerInit(p:IPlayer):Void
{
// add your extra initialization code here
}

See also
IPlayer Interface
IPlayerListener Interface
Flash Presentation ActionScript API Reference

11.3.4 fsplayer.api.IAnimationStep Interface


The IAnimationStep Interface provides the information about animation step timings. It
exposes the following methods:
Methods

Method Description

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


section)

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


section)

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


section)

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


remarks section)

Page 122
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

getPauseEndTime():Number Returns 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 Play
time. Then, at the Pause start time, animations are suspended for the Pause time period till
the Pause end time. Pause time depends on slide timings that were set using "Record
narration" or "Rehearse timings" menu of PowerPoint.
stepStartTime0 = 0
pauseStartTimei = stepStartTimei + playTimei
pauseEndTimei = pauseStartTimei + pauseTimei
stepStartTimei+1 = pauseEndTimei

Page 123
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

If the slide has no timings (i.e. user has to click slide background to advance mouse-driven
animations), Pause time and Pause end time are undefined. In this case returned timings are
as follows:
pauseStartTimei = stepStartTimei + playTimei
pauseEndTimei = undefined
stepStartTimei+1 = pauseStartTimei

See also
IAnimationSteps Interface
Flash Presentation ActionScript API Reference

11.3.5 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 in


seconds. The duration of animation steps is equal to
the duration of the slide

getStep(index:Number):IAnimationStep Returns the IAnimationStep Interface providing the


information about animation step timings

Remarks
Slide animation timeline consists of one or more animation steps. Animation step is a
sequence of animation effects playing without mouse click requirement.
Slide background, static shapes, and shapes animated before the first mouse driven animation
are 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 are
playing at the separate animation step. In other words, the number of animation steps is equal
to number of on-click animations plus 1.
Example

Page 124
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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
IAnimationStep Interface
ISlideInfo Interface
Flash Presentation ActionScript API Reference

11.3.6 fsplayer.api.ICompanyInfo Interface

Page 125
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

The ICompanyInfo Interface provides the following methods for retrieving company
information:
Methods

Method Description

hasLogo():Boolean Indicates whether the company has logo

getLogo():ICompanyLogo Returns the ICompanyLogo interface providing


information about company logotype

See also
ICompanyLogo Interface
IPresentationInfo Interface
Flash Presentation ActionScript API Reference

11.3.7 fsplayer.api.ICompanyLogo Interface


The ICompanyInfo Interface provides the following methods for retrieving company logo
information:
Methods

Method Description

load(target:MovieClip, Loads company logo into the specified MovieClip.


[listener:ICompanyLogoLoadingListener]):Void The listener is an optional parameter which will
receive notification when company logo is loaded

getHyperlinkURL():String Returns a web page URL, for example, the company


web site address, which should be opened when user
clicks the company logo.
Note: An empty string indicates that no hyperlink is
attached to the company logo

getHyperlinkTarget():String Returns the target window name ("_self", "_blank",


"_parent", "_top", or custom window name) where
company logo hyperlink should be opened

See also

Page 126
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

ICompanyInfo Interface
ICompanyLogoLoadingListener Interface
Flash Presentation ActionScript API Reference

11.3.8 fsplayer.api.ICompanyLogoLoadingListener Interface


The ICompanyLogoLoadingListener Interface is used to receive the notification that
company 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 skin
layout at the proper time.
Usually you need to create a class implementing this interface and pass its instance to the
load() method of ICompanyLogo interface.
Sampes
The following example illustrates how to load and place the company logo within target
MovieClip.

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 of
ICompanyLogoLoadingListener.onCompanyLogoLoadInit() method
function onCompanyLogoLoadInit():Void
{

Page 127
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

// company logo has been loaded. We need to update its position


with 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 Interface
Flash Presentation ActionScript API Reference

11.3.9 fsplayer.api.IKeyboardSettings Interface


The IKeyboardSettings interface allows determining of the playback action which
corresponds to the given key combination. The following methods are exposed by this
interface:
Methods

Method Description

getPlaybackAction(keyCode:Number, Returns the IPlaybackAction interface which


controlPressed:Boolean, represents IPlaybackAction corresponding to the
shiftPressed:Boolean):IPlaybackAction given key combination.
An undefined value is returned when there is no
playback action associated with the specified key
combination.

See also
IPlayer Interface
IPlaybackAction Interface
Flash Presentation ActionScript API Reference

11.3.10 fsplayer.api.IPlaybackAction Interface


The IPlaybackAction interface provides information about playback action:

Page 128
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Methods

Method Description

getType():String Returns a string identifying playback action type.


The ActionType class defines a set of supported
action types.

See also
ActionType Class
IKeyboardSettings Interface
Flash Presentation ActionScript API Reference

11.3.11 fsplayer.api.IPlaybackListener Interface


There are various events occurring during presentation playback. The playback controller
notifies external objects about these events via IPlaybackListener interface. This interface
defines a set of methods which are invoked by playback controller when the corresponding
events 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 during


playback

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


playback

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

onKeyboardFocusStateChanged(acquireFocus:Boolean):Void
Invoked when interactive element of the presentation

Page 129
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

(e.g. a text field of a Quiz) acquires or loses keyboard


focus

onPlaybackSuspended():Void Invoked when automatick playback is suspeneded at


animation step end

onPlaybackResumed():Void Invoked when automatic playback is resumed on


user's request

In order to receive event notifications you need to create a class which implements
IPlaybackListener interface and pass the instance of this class to the addListener method of
the IPresentationPlaybackController interface.
Samples
The following example illustrates the simplest implementation of IPlaybackListener
interface.
Create MyPlaybackListener.as source file with the following content.

import fsplayer.api.*;
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);
}

Page 130
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 Object


instance with a subset of IPlaybackListener functions and pass it to the addListener()
method as it is shown in the following example:

import fsplayer.api.*;
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);

Page 131
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

See also
IPresentationPlaybackController Interface
Flash Presentation ActionScript API Reference

11.3.12 fsplayer.api.IPlayer Interface


iSpring generated Flash presentations contain an embedded player which plays slide
animations, transition effects and sounds. This player exposes an ActionScript 2.0 API
available to external Flash applications.
The IPlayer interface is provided by Flash presentations generated with iSpring. It exposes
the following methods:
Methods

Method Description

isInitialized():Boolean Returns a Boolean value indicating whether the


player was initialized.
The following methods return an undefined value
until the player gets initialized:
• getPresentationInfo()
• getPlaybackController()
• getSoundController()
• getSettings()

addListener(listener:IPlayerListener):Void Adds an external listener object implementing the


IPlayerListener interface to the player. The passed
listener object will receive notifications from the
player

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


addListener() method

getPlaybackController():IPresentationPlaybackControllerReturns the IPresentationPlaybackController


interface providing presentation playback control and
navigation facilites

getSoundController():ISoundController Returns the ISoundController interface providing


sound volume control facilities

Page 132
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

getPresentationInfo():IPresentationInfo Returns the IPresentationInfo interface providing the


presentation content information

getSettings():Object Returns an Object storing playback and navigation


settings as well as skin related settings (see the
remarks section)
This method is mainly used for the custom skins
development. In most cases you don't need to use it.

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

getKeyboardSettings():IKeyboardSettings Returns the IKeyboardSettings interface providing


keyboard navigation options

Remarks

An object returned by the getSettings() method contains a set of implementation specific


properties. 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 scheme 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"

Page 133
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

• 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
IKeyboardSettings Interface
IPlayerListener Interface
IPresentationInfo Interface
IPresentationPlaybackController Interface
ISkin Interface
ISoundController Interface
Flash Presentation ActionScript API Reference

11.3.13 fsplayer.api.IPlayerCore Interface


The IPlayerCore interface provides advanced facilities for customizing iSpring player
functionality. This interface should be used by skilled developers only. An improper use
of this interface may lead to the player malfunction.
Methods

Method Description

setExternalPresenterVideoPlayer(player:IVideoPlayer):Void
Method allows replacing of the standard presenter
video player with the custom one during player
initialization. Note: this method should be called
before player gets initialized, in the onPlayerPreInit
event of the IPlayerListenerEx.

See also
IPlayerListenerEx Interface
IPlayerEx Interface

11.3.14 fsplayer.api.IPlayerEx Interface


Extends the IPlayer interface providing access to the advanced functionality of the
presentation player.

Page 134
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

The IPlayerEx interface has following method:


Methods

Method Description

getPlayerCore():IPlayerCore Returns the IPlayerCore interface providing access to


the player core functionality.

See also
IPlayer Interface
IPlayerCore Interface
Flash Presentation ActionScript API Reference

11.3.15 fsplayer.api.IPlayerListener Interface


The IPlayerListener interface is used to receive the notification that the player has been
initialized. Until the player gets initialized it is not possible to control presentation playback
or get presentation information.
The IPlayerListener interface declares the following method.
Methods

Method Description

onPlayerInit(player:IPlayer):Void This method is invoked when the player initialization


is 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
}
// ...
}

Page 135
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Then the instance of MyPlayerListener object is passed to addListener() method of the


IPlayer interface or to the setPlayerListener() method of the CPresentationLoader class
which simplifies this process.
import fsplayer.api.IPlayer;
import MyPlayerListener;
import fsplayer.api.CPresentationLoader;
// create instances of the presentation loader and the player listener
objects
var loader:CPresentationLoader = new CPresentationLoader();
var listener:MyPlayerListener = new MyPlayerListener();
// pass the listener object to the loader
loader.setPlayerListener(listener);
// create a MovieClip instance where the presentation will be loaded
var presentationMC:MovieClip = this.createEmptyMovieClip("presentation",
1);
// load the presentation
loader.loadClip("presentation.swf", presentationMC);
See also
IPlayer Interface
Flash Presentation ActionScript API Reference

11.3.16 fsplayer.api.IPlayerListenerEx Interface


The IPlayerListenerEx interface is used to receive advanced notification that the player has
been preinitialized.
The IPlayerListenerEx interface declares the following method.
Methods

Method Description

onPlayerPreInit(player:IPlayerEx):Void This method is invoked before the player


initialization is completed.

See also
IPlayerEx Interface
IPlayerCore Interface
Flash Presentation ActionScript API Reference

Page 136
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

11.3.17 fsplayer.api.IPresentationInfo Interface


The IPresentationInfo Interface provides the following methods for retrieving presentation
information:
Methods

Method Description

getTitle():String Returns presentation title

getSlides():ISlidesCollection Returns ISlidesCollection interface providing


information about presentation slides

getSlideWidth():Number Returns slide width in pixels

getSlideHeight():Number Returns slide height in pixels

hasThumbnails():Boolean Indicates whether the presentation contains thumbnail


images

getThumbnails():IThumbnailsCollection Returns IThumbnailsCollection interface that allows


to get information about presentation thumbnails

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


information

getPresenterInfo():IPresenterInfo Returns the IPresenterInfo interface which provides


the information about presentation presenter

getFrameRate():Number Returns presentation frame rate (number of frames


per second)

getDuration():Number Returns presentation duration in seconds

hasCompanyInfo():Boolean Indicates whether the presentation contains company


information

getCompanyInfo():ICompanyInfo Returns the ICompanyInfo interface providing


company information

Page 137
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

hasReferences():Boolean Indicates whether the presentation contains


references

getReferences():IReferencesCollection Returns the IReferencesCollection interface


providing the information about presentation
references

getVisibleDuration():Number Returns duration of visible slides in seconds

getPresenters():IPresentersCollection Returns the IPresentersCollection interface providing


the information about presentation presenters

See also
ICompanyInfo Interface
IPresentersCollection
IPresenterInfo Interface
IReferencesCollection Interface
ISlidesCollection Interface
IThumbnailsCollection Interface
Flash Presentation ActionScript API Reference

11.3.18 fsplayer.api.IPresentationPlaybackController Interface


The IPresentationPlaybackController interface provides methods for presentation
playback and navigation control. This interface can be obtained by calling the
getPlaybackController() method on IPlayer interface.
Methods

Method Description

addListener(listener:IPlaybackListener):Void Adds an external listener object implementing the


IPlaybackListener interface; the passed object will be
notified about presentation playback events

removeListener(listener:IPlaybackListener):Void Removes previously added listener object. The


passed object won't receive notifications from the
player any more

isPlaying():Boolean Returns a Boolean value indicating whether the


presentation is playing or not

Page 138
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 its
playback.
Note: if the autoStart parameter was set to false, slide
playback would not be started after switching

gotoPreviousSlide([autoStart:Boolean = true]):Void Switches to the previous presentation slide and starts


its playback.
Note: if the autoStart parameter was set to false, slide
playback would not be started after switching

gotoLastViewedSlide([autoStart:Boolean = Switches to the previously viewed slide and starts its


true]):Void playback.
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 = Switches to the given slide of the presentation and


true]):Void starts its playback
Notes: Slide index is zero-based.
If the autoStart parameter was set to false, slide
playback 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 position


Note: 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. After


this operation slide playback gets suspended until the
endSeek() method or other playback control method

Page 139
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

is called
Note: position is a number between 0 and 1

endSeek([resumePlayback:Boolean = Exits from seeking mode and restores playback.


undefined]):Void Note: the resumePlayback parameter allows to start
or pause slide after seeking explicitly

getCurrentStepIndex():Number Returns current animation step index

gotoNextStep():Void Plays current slide from the beginning of the next


animation step.
Note: being called at the end of the slide this method
plays presentation from the beginning of the next
slide

gotoPreviousStep():Void Moves slide playback one step back. This method


suspends slide playback at the end of the previous
animation step.
Note: being called on the start slide step this method
causes playback switching to the end of the previous
slide

setAnimationStepPause(pause:Number):Void This method allows setting a pause between


animation steps. If an undefined value is passed as
pause value, animation steps will not be played
automatically

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


specified animation step

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


specified animation step

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


animations step

enableAutomaticSlideSwitching(enableSwitching:Boolean):Void
Enables or disables automatic switching to the next
slide.
Note: this method affects automatically switching
slides only.

getAutomaticSlideSwitching():Boolean Returns true if automatic slide switching has been


enabled, false otherwise.

Page 140
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Note: automatic slide switching is enabled by default

getCurrentVisibleSlideIndex():Number Returns index of currently playing slide within


visible slides.
Returns an undefined value if current slide is hidden.
Note: Slide index is zero-based.

gotoVisibleSlide(visibleSlideIndex:Number, Switches to the given index within visible slides and


[autoStart:Boolean = true]):Void starts its playback
Notes: Slide index is zero-based.
If the autoStart parameter was set to false, slide
playback would not be started after switching

gotoFirstSlide([autoStart:Boolean = true]):Void Switches to the first presentation slide and starts its
playback.
Note: if the autoStart parameter was set to false,
slide playback would not be started after switching

gotoLastSlide([autoStart:Boolean = true]):Void Switches to the last presentation slide and starts its
playback.
Note: if the autoStart parameter was set to false,
slide playback would not be started after switching

getNextSlideIndex():Number Returns next slide index or an undifined value in case


if current slide is the latest one

getPreviousSlideIndex():Number Returns previous slide index or an undifined value in


case if current slide is the first one

isNamedSlideShowPlaying():Boolean Returns Boolean value that indicates whether some


named slide show is playing

See also
IPlaybackListener Interface
IPlayer Interface
Flash Presentation ActionScript API Reference

11.3.19 fsplayer.api.IPresentationPlaybackControllerEx Interface


Extends the IPresentationPlaybackController interface providing information about currently
playing quiz.

Page 141
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

The IPresentationPlaybackControllerEx interface has following method:


Methods

Method Description

getActiveQuiz():IQuizApi Returns the IQuizApi interface that allows to get


information about currently shown quiz.
Note: the IQuizApi interface is used for internal
purposes only and is not available for public access in
current version of the API.

See also
IPresentationPlaybackController
IPlaybackListener Interface
Flash Presentation ActionScript API Reference

11.3.20 fsplayer.api.IPresenterInfo Interface


The IPresenterInfo interface provides the following methods for presenter information
retrieving:
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 to


load presenter photo

Page 142
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

getIndex():Number Returns index within presenters collection

hasCompany():Boolean Indicates whether the presenter has company

getCompany():ICompanyInfo Returns the ICompanyInfo interface providing


information about presenter custom company

See also
ICompanyInfo Interface
IPresentationInfo Interface
IPresenterPhoto Interface
Flash Presentation ActionScript API Reference

11.3.21 fsplayer.api.IPresenterPhoto Interface


The IPresenterPhoto interface allows to load presenter photo.
Methods

Method Description

load(target:MovieClip, This method loads presenter photo into the specified


listener:IPresenterPhotoLoadingListener):Void target MovieClip (see the remarks section for more
details). The listener will be notified when presenter
photo is loaded

Remarks

The IPresenterPhoto interface provides a unified way of the presenter photo loading no
metter if the presentation has been exported into a solid Flash file, or into a set of Flash files
with a player.
It is highly recommended that the target MovieClip resides within the skin MovieClip.
See also
IPresenterInfo Interface
IPresenterPhotoLoadingListener Interface
Flash Presentation ActionScript API Reference

11.3.22 fsplayer.api.IPresenterPhotoLoadingListener Interface

Page 143
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

The IPresenterPhotoLoadingListener Interface is used to receive the notification that the


presenter photo has been loaded. This interface exposes the following methods.
Methods

Method Description

onPresenterPhotoLoadInit():Void This method is invoked when the presenter photo has


been loaded.
The load() method of the IPresenterPhoto interface
loads the presenter photo into the specified target
MovieClip

See also
IPresenterPhoto Interface
Flash Presentation ActionScript API Reference

11.3.23 fsplayer.api.IPresentersCollection Interface


The IPresentersCollection Interface represents a collection of the presentaiton presenters. It
exposes the following methods:
Methods

Method Description

getCount():Number Returns number of presenters in the collection

getPresenter(index:Number):IPresenterInfo Returns the IPresenterInfo interface providing the


information about the specified presenter.
Note: the index parameter is an integer value from 0
to (number of presenters - 1)

See also
IPresenterInfo Interface
IPresentationInfo Interface
Flash Presentation ActionScript API Reference

11.3.24 fsplayer.api.IPresenterVideo Interface


The IPresenterVideo interface provides the following methods for presenter video
information retrieving:

Page 144
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Methods

Method Description

getWidth():Number Returns width of the presenter video.

getHeight():Number Returns height of the presenter video.

See also
IPresenterInfo Interface
IPresenterVideoListener Interface
Flash Presentation ActionScript API Reference

11.3.25 fsplayer.api.IPresenterVideoController Interface


The IPresenterVideoController Interface provides the following methods for presenter
video control.
Methods

Method Description

addListener(listener:IPresenterVideoListener):Void Adds an external object implementing


IPresenterVideoListener interface which will receive
presenter video controller notifications.

removeListener(listener:IPresenterVideoListener):Void Removes the previously added listener. The passed


object will stop receiving presenter video controller
notifications.

getCurrentVideo():IPresenterVideo Returns current presenter video

See also
IPresenterVideo Interface
IPresenterVideoListener Interface
Flash Presentation ActionScript API Reference

11.3.26 fsplayer.api.IPresenterVideoListener Interface


The IPresenterVideoListener interface defines a method invoked by presenter video
controller when a particular events occur during presenter video playback.

Page 145
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Methods

Method Description

onChangePresenterVideo(video:IPresenterVideo):Void This method is invoked when presenter video is


changed. Use the getCurrentVideo() method of the
passed IPresenterVideoController interface to get
new video

In order to receive presenter video notifications you need to create a class which implements
IPresenterVideoListener interface and pass it to the addListener() method of the
IPresenterVideoController Interface.
See also
IPresenterVideo
IPresenterVideoController Interface
Flash Presentation ActionScript API Reference

11.3.27 fsplayer.api.IReferenceInfo Interface


The IReferenceInfo Interface provides the following methods for retrieving reference
information:
Methods

Method Description

getTitle():String Returns reference title

getURL():String Returns reference URL

getTarget():String Returns target window name where the reference


should be opened

See also
IReferencesCollection Interface
Flash Presentation ActionScript API Reference

11.3.28 fsplayer.api.IReferencesCollection Interface


The IReferencesCollection Interface provides the following methods for retrieving the

Page 146
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

presentation references information:


Methods

Method Description

getCount():Number Number of references in the collection

getReference(index:Number):IReferenceInfo Returns IReferenceInfo interface providing the


information about the specified reference.
Note: the index parameter is an integer value from 0
to (number of references - 1)

See also
IReferenceInfo Interface
IPresentationInfo Interface
Flash Presentation ActionScript API Reference

11.3.29 fsplayer.api.ISlideInfo Interface


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

Method Description

isLoaded():Boolean Returns Boolean value indicating whether the slide


has been loaded completely

getTitle():String Returns slide title

getAnimationSteps():IAnimationSteps Returns IAnimationSteps interface providing the


information 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 presentation


timeline

Page 147
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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


timeline

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 the


remarks section)

getNotesTextNormalized():String Returns text of the slide notes in the normalized


form (see the remarks section)

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


remarks section)

getLevel():Number Returns slide level (0 - upper level)

isHidden():Boolean Returns Boolean value that indicates whether the


slide is hidden

getIndex():Number Returns slide index within presentation

getVisibleIndex():Number Returns slide index within visible slides


Note: This method returns an undefined value if the
slide is hidden

getVisibleStartTime:Number Returns slide start time within the presentation


timeline for visible slides only
Note: This method returns an undefined value if the
slide is hidden

getVisibleEndTime:Number Returns slide end time within the presentation


timeline for visible slides only
Note: This method returns an undefined value if the
slide is hidden

getVisibleStartStepIndex:Number Returns slide start step index within visible slides


only
Note: This method returns an undefined value if the
slide is hidden

Page 148
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

getVisibleEndStepIndex:Number Returns slide end step index within visible slides only
Note: This method returns an undefined value if the
slide is hidden

getPresenterIndex():Number Returns index of presenter associated with the slide


Note: This method returns an undefined value if no
presenter is associated with the slide

getResources():ISlideResources Returns the ISlideResources interface providing the


information about resources contained in the slide

getNotesHtml():String Returns HTML representation of the slide notes

getAutoChange():Boolean Indicates whether automatic slide advance is turned


on for the slide

Remarks

Normalized strings are strings having all characters in the lower case with no extra spaces
between words. This can simplify and speed up full text search implementation.
See also
IAnimationSteps Interface
ISlidesCollection Interface
ISlideResources Interface
Flash Presentation ActionScript API Reference

11.3.30 fsplayer.api.ISlidesCollection Interface


The ISlidesCollection interface represents a collection of presentation slides. It provides the
following methods:
Methods

Method Description

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

getSlideInfo(slideIndex:Number):ISlideInfo Returns ISlideInfo Interface which represents an


individual presentation slide with the specified slide

Page 149
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

index.
Note: Slide index is zero-based

getVisibleSlidesCount():Number Returns number of visible slides in the presentation

getVisibleSlide(visibleSlideIndex:Number):ISlideInfo Returns ISlideInfo Interface which represents an


individual visible slide with the specified slide index.
Note: Slide index is zero-based

Remarks:
There are 2 types of slides in the presentation:
• Visible slides. These are slides which are normally displayed during slide show
• Hidden slides. These are slides which were marked as hidden in PowerPoint during
presentation creation. They are shown only by hyperlink from visible presentation slide.
See also
IPresentationInfo Interface
ISlideInfo Interface
Flash Presentation ActionScript API Reference

11.3.31 fsplayer.api.ISlideThumbnail Interface


The ISlideThumbnail interface provides the information about the particular presentation
thumbnail 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, Loads the thumbnail image into the target MovieClip.


[listener:ISlideThumbnailLoadingListener]):Void When the thumbnail is loaded, the notification will be
sent to the passed listener interface.
The target parameter is a MovieClip within the skin
MovieClip (see the remarks section)

Remarks

When the presentation is wrapped into a skin which supports thumbnails (Classic, Crystal,

Page 150
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Advanced or Lite), iSpring generates thumbnails in one of the following ways:


• When the presentation is exported into a solid Flash movie, iSpring stores Flash
presentation thumbnails as internal Flash movie assets. Such assets are created using
MovieClip.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, so
thumbnails assets are accessible within that Flash file only.
• When the presentation is exported into a set of Flash files with player, each thumbnail is
saved 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 external
thumbnails loading. Thumbnails are loaded in the proper way by player core. The core also
notifies skin when the particular thumbnail is loaded via the
ISlideThumbnailLoadingListener Interface.
See also
ISlideThumbnailLoadingListener Interface
IThumbnailsCollection Interface
Flash Presentation ActionScript API Reference

11.3.32 fsplayer.api.ISlideThumbnailLoadingListener Interface


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

Method Description

onSlideThumbnailLoadInit(thumbnail:ISlideThumbnail):Void
Invoked when the thumbnail has been loaded. The
thumbnail parameter can be used to determine the
index of the loaded slide

See also
ISlideThumbnail Interface
Flash Presentation ActionScript API Reference

11.3.33 fsplayer.api.ISlideResources Interface


The ISlideResources interface provides the information about resources related to this

Page 151
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

presentation slide such as presenter video. The Interface exposes the following methods:
Methods

Method Description

hasPresenterVideo():Boolean Indicate whether the slide has a presenter video.

getPresenterVideo():IPresenterVideo Returns the IPresenterVideo interface providing


information about presenter video.
If there is no presenter video, an undefined value is
returned.

See also
IPresenterVideo Interface

11.3.34 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 implementing


ISoundListener interface which will receive sound
controller notifications

removeListener(listener:ISoundListener):Void Removes the previously added listener. The passed


object will stop receiving sound controller
notifications

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, Tweaks the implementation specific parameter of the


parameterValue:Object):Void sound controller.
See the list of currently supported parameters in the
Remarks section

Page 152
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

getTweakableParameter(parameterName:String):Object Returns the value of the implementation specific


parameter.
See the list of currently supported parameters in the
Remarks section

Remarks

Currently supported tweakable parameters are as follows:

Parameter name Type Default value Description

blinkSounds Boolean true Sound blinking is a


sound shutdown for a
short period of time (less
than 1/100 of second)
during slide switching.
This technique is used
only when the slide
containing an embedded
Flash movie is changed
by some other slide.
The reason for using this
trick is that embedded
Flash files can play
sounds by their own and
there is the only way to
prevent possible sound
issues.
Sometimes this feature
can be undesirable and
can be turned off by
setting the blinkSound
parameter to false

See also
IPlayer Interface
ISoundListener Interface
Flash Presentation ActionScript API Reference

11.3.35 fsplayer.api.ISoundListener Interface


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

Page 153
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Methods

Method Description

onSoundVolumeChanged(soundController:ISoundController):Void
This method is invoked when sound volume is
changed. Use getVolume() method of the passed
ISoundController interface to get new volume

In order to receive sound notifications you need to create a class which implements
ISoundListener interface and pass it to the addListener() method of the ISoundController
Interface.
See also
ISoundController Interface
Flash Presentation ActionScript API Reference

11.3.36 fsplayer.api.IThumbnailsCollection Interface


The IThumbnailsCollection Interface represents a collection of slide thumbnails. It provides
the following methods for retrieving thumbnail dimensions and accessing individual
thumbnails.
Methods

Method Description

getThumbnail(slideIndex:Number): ISlideThumbnail Returns the ISlideThumbnail interface representing


the particular presentation thumbnail within
thumbnails 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 the
number of slides within the presentation. If the
presentation skin doesn't support thumbnails or if the
thumbnails were turned off in skin settings, the
number of thumbnails is equal to 0

Remarks

Page 154
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

The IThumbnailsCollection interface is mainly used for the development of custom skins
supporting thumbnails.
See also
ISlideThumbnail Interface
IPresentationInfo Interface
Flash Presentation ActionScript API Reference

11.3.37 ActionScript 3 and Flex 2 support

ActionScript 3 and Flex support in iSpring

This article describes the way of the iSpring generated presentations communication with
Flash 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 Flash
9 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 8
or 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 a
LocalConnection 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 + "!");
}

Page 155
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

lc.connect("connectionName");

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

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-way
interaction is needed, each Flash movie must create 2 LocalConnection objects: one
connection 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 1
LocalConnection with a given name on the same PC. So it is recommended to generate
connection name based on some random information such as date. The sending Flash movie
needs a connection name of the receiving Flash movie. This connection name can be passed
as an URL parameter:
var lc:LocalConnection = new LocalConnection();
lc.sayHello = function(name:String):Void
{
trace("Hello, " + name + "!");
}
// generate connection name which is most likely unique
var 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 parameter
childMovie.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");

The similar way of Flash movies interaction can be used to establish communication
between ActionScript 3 Flash movie and iSpring generated presentations.
iSpring Presenter and iSpring SDK products allow embedding a special ActionScript
communication module (AS3 Connector) into the generated flash presentation. This
communication module provides presentation playback control facilities via
LocalConnection protocol accessible from Flash applications written in ActionScript 3.

Page 156
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

iSpring SDK and iSpring Presenter products include a set of AS3 classes and interfaces
which simplify communication between AS3 applications and iSpring generated
presentations with embedded AS3 connector. These classes and interfaces provide facilities
for presentation loading and playback control. They can also broadcast notifications about
various events during presentation playback.
The communication between ActionScript 3 application and iSprign generated presentation is
illustrated in the following diagram.

ActionScript 3 <-> iSpring presentation communication

ActionScript3 Connector
ActionScript3 Connector (with source code) is included in iSpring Presenter and iSpring
SDK samples. There is also a set of ActionScript 3 classes providing ActionScript 3 API
simplifying communication with iSpring presentations.

Page 157
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Page 158
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

iSpring ActionScript 3 API

Class name Description

AcquireFocusEvent Creates acquire keyboard focus event objects.

IAnimationStep Provides the information about animation step


timing.

IAnimationSteps Stores a collection of the slide animation steps.

ICompanyInfo Stores the information about company.

ICompanyLogo Stores the information about company logotype.

IPlayer Provides an access to the presentation playback core.

IPresentationInfo Provides an access to the presentation information.

IPresentationPlaybackController Provides presentation playback and navigation


control.

IPresenterInfo Stores the presenter information.

IPresentersCollection Stores a collection of presentation presenters.

IPresenterVideo Stores the information about presenter video.

IReferenceInfo Provides the information about the particular


presentation reference.

IReferencesCollection Stores a collection of presentation references.

ISlideInfo Provides the information about the particular slide.

ISlideResources Provides the information about resources associated


with particular slide.

ISlidesCollection Stores a collection of slides.

Page 159
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

ISoundController Provides sound control facilities.

PlaybackEvent Creates playback event objects.

PlaybackPositionEvent Creates playback position event objects.

PlayerEvent Creates player initialization event objects.

PresentationLoader Simplifies the process of iSpring generated Flash


movies loading.

SlidePlaybackEvent Creates slide playback event objects.

SoundEvent Creates sound event objects.

StepPlaybackEvent Creates animation step playback event objects.

Samples

The following example illustrates the usage of the ActioScript3 API module in Adobe Flash
CS3:

import ispring.as2player.*;
import flash.events.*;
var g_player:IPlayer;
// load presentation
var loader:PresentationLoader = new PresentationLoader();
addChild(loader);
loader.addEventListener(PlayerEvent.PLAYER_INIT, playerInit);
loader.load(new URLRequest("presentation1.swf"));
// send after presentation loaded and initialized
function playerInit(e:PlayerEvent):void
{
g_player = loader.player;
g_player.playbackController.addEventListener(SlidePlaybackEvent.CURRENT_SLIDE_INDEX_CHAN
onSlideChange);
playButton.buttonMode = true;
playButton.addEventListener(MouseEvent.CLICK, onPlayClick);
pauseButton.buttonMode = true;

Page 160
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

pauseButton.addEventListener(MouseEvent.CLICK, onPauseClick);
}
function onSlideChange(e:SlidePlaybackEvent):void
{
trace("current slide: " + e.slideIndex);
}
function onPlayClick(e:MouseEvent):void
{
g_player.playbackController.play();
}
function onPauseClick(e:MouseEvent):void
{
g_player.playbackController.pause();
}

ActionScript 3 communication demo

ActionScript 3 example

Adobe Flex communication demo

Flex example

References

AcquireFocusEvent
IAnimationStep
IAnimationSteps
ICompanyInfo
ICompanyLogo
IPlayer
IPresentationInfo
IPresentationPlaybackController
IPresenterInfo
IPresentersCollection
IPresenterVideo
IReferenceInfo
IReferencesCollection
ISlideInfo

Page 161
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

ISlideResources
ISlidesCollection
ISoundController
PlaybackEvent
PlaybackPositionEvent
PlayerEvent
PresentationLoader
SlidePlaybackEvent
SoundEvent
StepPlaybackEvent
iSpring ActionScript API

ispring.as2player.AcquireFocusEvent Class

The AcquireFocusEvent Class extends the standard flash.events.Event class and exposes the
following constants and properties:
Constants

Constant Type Value Description

KEYBOARD_FOCUS_STATE_CHANGED
String keyboardFocusStateChangedDefines the value of the
type property of a
keyboardFocusStateChanged
event object. This type of
event occurs when
interactive element of the
presentation (e.g. a text
field of a Quiz) acquires
or loses keyboard focus.
A
keyboardFocusStateChanged
event contains the
following properties:
acquireFocus.

Properties

Property Type Description

acquireFocus Boolean Indicates whether the interactive


element of the presentation
acquires or lost keyboard focus.
The following event contain this

Page 162
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

property:
keyboardFocusStateChanged

See also
IPresentationPlaybackController Interface
ActionScript3 and Flex support in iSpring

ispring.as2player.IAnimationStep Interface

The IAnimationStep interface provides the information about animation step timings. It
exposes the following properties:
Properties

Property Type Description

playTime Number Animation step play time (see the


remarks section)

pauseTime Number Animation step pause time (see the


remarks section)

startTime Number Animation step start time (see the


remarks 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.

Page 163
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Animation step structure

An Animation step starts playing at the Step start time. Animations are playing for the Play
time. Then, at the Pause start time, animations are suspended for the Pause time period till
the Pause end time. Pause time depends on slide timings that were set using "Record
narration" or "Rehearse timings" menu of PowerPoint.
stepStartTime0 = 0
pauseStartTimei = stepStartTimei + playTimei
pauseEndTimei = pauseStartTimei + pauseTimei
stepStartTimei+1 = pauseEndTimei

If the slide has no timings (i.e. user has to click slide background to advance mouse-driven
animations), Pause time and Pause end time are undefined. In this case returned timings are
as follows:
pauseStartTimei = stepStartTimei + playTimei
pauseEndTimei = undefined

Page 164
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

stepStartTimei+1 = pauseStartTimei

See also
IAnimationSteps Interface
ActionScript 3 and Flex support in iSpring

ispring.as2player.IAnimationSteps Interface

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

Property Type Description

duration Number The total duration of animation


steps in seconds. The duration of
animation steps is equal to the
duration of the slide

stepsCount Number Number of slide animation steps

Methods

Method Description

getStep(index:Number):IAnimationStep Returns the IAnimationStep Interface providing the


information about animation step timings

Remarks
Slide animation timeline consists of one or more animation steps. Animation step is a
sequence of animation effects playing without mouse click requirement.
Slide background, static shapes, and shapes animated before the first mouse driven animation
are 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 playing
at the separate animation step. In other words, the number of animation steps is equal to
number of on-click animations plus 1.
Example

Page 165
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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
IAnimationStep Interface
SlideInfo Interface
ActionScript 3 and Flex support in iSpring

ispring.as2player.ICompanyInfo Interface

Page 166
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

The ICompanyInfo Interface provides the following methods for retrieving company
information.
Properties

Property Type Description

logo Number Returns the ICompanyLogo


interface providing information
about company logotype.

Methods

Method Description

hasLogo()(index:Number):Boolean Indicates whether the company has logo.

See also
ICompanyLogo Interface
IPresentationInfo Interface
ActionScript 3 and Flex support in iSpring

ispring.as2player.ICompanyLogo Interface

The ICompanyLogo Interface provides the following methods for retrieving company
information.
Properties

Property Type Description

hyperlinkUrl String Returns a web page URL, for


example, the company web site
address, which should be opened
when user clicks the company
logo. Note: An empty string
indicates that no hyperlink is
attached to the company logo.

hyperlinkTarget String Returns the target window name


("_self", "_blank", "_parent",
"_top", or custom window name)
where company logo hyperlink

Page 167
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

should be opened

See also
ICompanyLogo Interface
ActionScript 3 and Flex support in iSpring

ispring.as2player.IPlayer Interface

The IPlayer Interface extends the standard flash.events.IEventDispatcher interface and


exposes the following properties and events:
Properties

Property Type Description

initialized Boolean Returns a Boolean value indicating


whether the player was initialized.
The following properties return an
undefined value until the player
gets initialized:
• presentationInfo
• playbackController
• soundController
• settings

playbackController IPresentationPlaybackController Returns the


IPresentationPlaybackController
interface providing presentation
playback control and navigation
facilities.

soundController ISoundController Returns the ISoundController


interface providing sound volume
control facilities.

presentationInfo IPresentationInfo Returns the IPresentationInfo


interface providing the
presentation content information.

settings Object Returns an Object storing


playback and navigation settings
as well as skin related settings (see
the remarks section)

Page 168
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

This method is mainly used for the


custom skins development. In
most cases you don't need to use it.

Events

Type Description

PlayerEvent.PLAYER_INIT Occurs when the ActionScript player module is


connected with another Flash movie and ready to
receive commands.

Remarks

An object returned by the getSettings() method contains a set of implementation specific


properties. 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 scheme 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

Page 169
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

• 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
IPresentationPlaybackController Interface
PresentationInfo Interface
ISoundController Interface
flash.events.IEventDispatcher Interface
ActionScript 3 and Flex support in iSpring

ispring.as2player.IPresentationInfo Interface

The IPresentationInfo class stores the presentation information and provides the following
properties:
Properties

Property Type Description

title String Presentation title

slides ISlidesCollection Returns the ISlidesCollection


Interface providing information
about presentation slides.

slideWidth Number Presentation slide width in pixels

slideHeight Number Presentation slide height in pixels

presenterInfo IPresenterInfo Returns the IPresenterInfo


Interface providing the
information about presentation
presenter.

frameRate Number Presentation frame rate (number of


frames per second)
Note: when iSpring generated
presentation is loaded by another
Flash movie, it always plays at its

Page 170
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

frame rate.

duration Number Presentation duration in seconds

visibleDuration Number Visible slides duration in seconds

companyInfo ICompanyInfo Returns the ICompanyInfo


Interface providing the company
information.

presenters IPresentersCollection Returns the IPresentersCollection


Interface providing the
information about presentation
presenters.

references IReferencesCollection Returns the IReferencesCollection


Interface providing the
information about presentation
references.

Methods

Method Description

hasCompanyInfo():Boolean Indicates whether the presentation contains the


company information.

hasPresenter():Boolean Indicates whether the presentation contains presenter


information.

hasReferences():Boolean Indicates whether the presentation contains


references

See also
CompanyInfo Interface
PresenterInfo Interface
IPresentersCollection Interface
SlidesCollection Interface
ReferencesCollection Interface
ActionScript 3 and Flex support in iSpring

Page 171
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

ispring.as2player.IPresentationPlaybackController Interface

The IPresentationPlaybackController interface extends the standard


flash.events.IEventDispatcher Interface and provides the following properties, methods and
events for presentation playback and navigation control.
Properties

Property Type Description

playing Boolean Indicates whether the presentation


is playing or not (read only)

currentSlideDuration Number A duration of the currently playing


slide (read only)

currentSlideIndex Number Current slide index (read only)

currentSlidePlaybackPosition Number Returns playback position within


current slide.
Note: playback position is a
number between 0 and 1

currentStepIndex Number Returns current animation step


index

animationStepPause Number Sets a pause between animation


steps. If an undefined value is
passed as pause value, animation
steps will not be played
automatically.

automaticSlideSwitching Boolean Enables or disables automatic


switching to the next slide.
Note: this property affects
automatically switching slides
only.
Returns true if automatic slide
switching has been enabled, false
otherwise.
Note: automatic slide switching is
enabled by default

Page 172
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

currentVisibleSlideIndex Number Current visible slide index (read


only)

nextSlideIndex Number Next slide index (read only)

previousSlideIndex Number Previous slide index (read only)

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 its
playback.
Note: if the autoStart parameter was set to false, slide
playback would not be started after switching

gotoPreviousSlide([autoStart:Boolean = true]):Void Switches to the previous presentation slide and starts


its playback.
Note: if the autoStart parameter was set to false, slide
playback would not be started after switching

gotoLastViewedSlide([autoStart:Boolean = Switches to the previously viewed slide and starts its


true]):Void playback.
Note: if the autoStart parameter was set to false,
slide playback would not be started after switching

gotoSlide(slideIndex:Number, [autoStart:Boolean = Switches to the given slide of the presentation and


true]):Void starts its playback
Notes: Slide index is zero-based.
If the autoStart parameter was set to false, slide
playback would not be started after switching

pauseCurrentSlideAt(position:Number):Void Suspends currently playing slide at the given position


Note: 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

Page 173
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

seek(position:Number):Void Seeks the current slide to the given position. After


this operation slide playback gets suspended until the
endSeek() method or other playback control method
is called
Note: position is a number between 0 and 1

endSeek([resumePlayback:Boolean = Exits from seeking mode and restores playback.


undefined]):Void Note: the resumePlayback parameter allows to start
or pause slide after seeking explicitly

gotoNextStep():Void Plays current slide from the beginning of the next


animation step.
Note: being called at the end of the slide this method
plays presentation from the beginning of the next
slide

gotoPreviousStep():Void Moves slide playback one step back. This method


suspends slide playback at the end of the previous
animation step.
Note: being called on the start slide step this method
causes playback switching to the end of the previous
slide

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


specified animation step

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


specified animation step

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


animations step

gotoVisibleSlide(visibleSlideIndex:Number, Switches to the given slide within visible slides and


[autoStart:Boolean = true]):Void starts its playback.
Notes: Slide index is zero-based.
If the autoStart parameter was set to false, slide
playback would not be started after switching.

gotoFirstSlide([autoStart:Boolean = true]):Void Switches to the first presentation slide and starts its
playback.
Notes: Slide index is zero-based.
If the autoStart parameter was set to false, slide
playback would not be started after switching.

Page 174
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

gotoLastSlide([autoStart:Boolean = true]):Void Switches to the last presentation slide and starts its
playback.
Notes: Slide index is zero-based.
If the autoStart parameter was set to false, slide
playback would not be started after switching.

Events

Type Description

SlidePlaybackEvent.SLIDE_LOADING_COMPLETE Occurs when a slide of the presentation is loaded.

SlidePlaybackEvent.CURRENT_SLIDE_INDEX_CHANGED
Occurs when current slide is changed by another
slide of the presentation.

StepPlaybackEvent.ANIMATION_STEP_CHANGED Occurs when currently playing animation step index


is changed.

PlaybackEvent.START_PLAYBACK Occurs when presentation playback is started.

PlaybackEvent.PAUSE_PLAYBACK Occurs when presentation playback is suspended.

PlaybackEvent.PRESENTATION_PLAYBACK_COMPLETE
Occurs when presentation playback is complete.

PlaybackEvent.SEEKING_COMPLETE Occurs when a seek command execution is


completed.

PlaybackPositionEvent.SLIDE_POSITION_CHANGEDOccurs when the playback position of the currently


playing slide is changed.

AcquireFocusEvent.KEYBOARD_FOCUS_STATE_CHANGED
Occurs when interactive element of the presentation
(e.g. a text field of a Quiz) acquires or loses keyboard
focus.

See also
IPlayer Interface
SlidePlaybackEvent Class
PlaybackEvent Class
StepPlaybackEvent Class

Page 175
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

PlaybackPositionEvent Class
AcquireFocusEvent Class
ActionScript 3 and Flex support in iSpring

ispring.as2player.IPresenterInfo Interface

The IPresenterInfo Interface stores the information about presenter and provides the
following properties:
Properties

Property Type Description

name String Presenter name

title String Presenter title

biographyText String A brief information about


presenter

email String Presenter e-mail address

webSite String Presenter Web site address

index Number Index within presenters collection

Methods

Method Description

hasPhoto():Boolean Indicates whether the presenter has photo.

See also
IPresentationInfo Interface
ActionScript 3 and Flex support in iSpring

ispring.as2player.IPresentersCollection Interface

The IPresentersCollection Interface provides the following methods for retrieving the
presenters information:

Page 176
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Properties

Property Type Description

count Number Number of presenters in the


collection

Methods

Method Description

getPresenter(index:Number):IPresenterInfo Returns IPresenterInfo interface providing the


information about the specified presenter. Note: the
index parameter is an integer value from 0 to
(number of presenters - 1)

See also
IPresenterInfo Interface
IPresentationInfo Interface
ActionScript 3 and Flex support in iSpring

ispring.as2player.IPresenterVideo Interface

The IPresenterVideo interface provides the following methods for presenter video
information retrieving:
Properties

Property Type Description

width Number Width of the presenter video.

height Number Height of the presenter video.

See also
IPresenterInfo Interface
ActionScript 3 and Flex support in iSpring

ispring.as2player.IReferenceInfo Interface

The IReferenceInfo Interface provides the following properties for retrieving reference

Page 177
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

information:
Properties

Property Type Description

title String Reference title

url String Reference URL

target String Target window name where the


reference should be opened

See also
IReferencesCollection Interface
ActionScript 3 and Flex support in iSpring

ispring.as2player.IReferencesCollection Interface

The IReferencesCollection interface provides the following properties and methods for
accessing presentation references:
Properties

Property Type Description

count Number Number of references in the


collection.

Methods

Method Description

getReference(index:Number):IReferenceInfo Returns ReferenceInfo interface providing the


information about the specified reference.
Note: the index parameter is an integer value from 0
to (number of references - 1).

See also
IReferenceInfo Interface
IPresentationInfo Interface

Page 178
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

ActionScript 3 and Flex support in iSpring

iSpring.as2bridge.ISlideInfo Interface

The ISlideInfo Interface provides information about the particular slide of the presentation
such as title, duration, text, etc. It exposes the following properties and methods:
Properties

Property Type Description

loaded Boolean Indicating whether the slide has


been loaded completely.

duration Number Slide duration in seconds.

startTime Number Slide start time within presentation


timeline.

endTime Number Slide end time within presentation


timeline.

level Number Slide level (0 - upper level).

hidden Boolean Indicates whether the slide is


hidden.

index Number Slide index within presentation.

visibleIndex Number Slide index within visible slides.

visibleStartTime Number Slide start time within visible


slides timeline.

visibleEndTime Number Slide end time within visible slides


timeline.

title String Slide title

animationSteps IAnimationSteps Returns the IAnimationSteps


interface providing the information
about slide animation steps

Page 179
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

notesText String Slide notes text

startStepIndex Number Slide start step index within the


presentation

endStepIndex Number Slide end step index within the


presentation

slideText String Slide text in the normalized form


(see the remarks section)

notesTextNormalized String Slide notes text in the normalized


form (see the remarks section)

titleNormalized String Slide title in the normalized form


(see the remarks section)

visibleStartStepIndex Number Slide start step index within visible


slides

visibleEndStepIndex Number Slide end step index within visible


slides

presenterIndex Number Index of presenter associated with


the slide Note: This method
returns an undefined value if no
presenter is associated with the
slide.

resources ISlidesResources Returns the ISlidesResources


interface providing the information
about resources included into the
slide.

Remarks

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

Page 180
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

IAnimationSteps Interface
ISlidesCollection Interface
ActionScript 3 and Flex support in iSpring

iSpring.as2bridge.ISlideResources Interface

The ISlideResources Interface provides information about the particular slide of the
presentation such as title, duration, text, etc. It exposes the following properties and methods:
Properties

Property Type Description

presenterVideo IPresenterVideo Returns the IPresenterVideo


interface providing information
about presenter video.
If there is no presenter video, an
undefined value is returned.

Methods

Method Description

hasPresenterVideo():Boolean Indicate whether the slide has a presenter video.

See also
IPresenterVideo Interface
ISlideInfo Interface
ActionScript 3 and Flex support in iSpring

ispring.as2player.ISlidesCollection Interface

The ISlidesCollection interface represents a collection of presentation slides. It provides the


following properties and methods:
Properties

Property Type Description

slidesCount Number Number of slides in the


presentation

Page 181
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

visibleSlidesCount Number Number of visible slides in the


presentation

Methods

Method Description

getSlideInfo(slideIndex:Number):ISlideInfo Returns SlideInfo Interface providing information


about the specified slide
Note: Slide index is zero-based.

getVisibleSlide(visibleSlideIndex:Number):ISlideInfo Returns SlideInfo Interface providing information


about the specified visible slide
Note: Visible slide index is zero-based.

See also
IPresentationInfo Interface
ISlideInfo Interface
ActionScript 3 and Flex support in iSpring

ispring.as2player.ISoundController Interface

The ISoundController interface provides sound volume control facilities. It extends the
standard flash.events.IEventDispatcher interface and provides the following properties and
events.
Properties

Property Type Description

volume Number Sound volume


Note: sound volume is a number
between 0 and 1

Events

Type Description

SoundEvent.SOUND_VOLUME_CHANGED Occurs when the sound volume is changed

See also

Page 182
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

IPlayer Interface
flash.events.IEventDispatcher Interface
ActionScript 3 and Flex support in iSpring

ispring.as2player.PlaybackEvent Class

The PlaybackEvent Class extends the standard flash.events.Event class and exposes the
following constants and properties:
Constants

Constant Type Value Description

PAUSE_PLAYBACK String pausePlayback Defines the value of the


type property of a
pausePlayback event
object. This type of event
occurs when presentation
playback is suspended.

START_PLAYBACK String startPlayback Defines the value of the


type property of a
startPlayback event
object. This type of event
occurs when presentation
playback is resumed.

SEEKING_COMPLETE String seekingComplete Defines the value of the


type property of the
seekingComplete event
object. This type of event
occurs when the seek
command execution is
completed.

PRESENTATION_PLAYBACK_COMPLETE
String presentationPlaybackComplete
Defines the value of the
type property of the
presentationPlaybackComplete
event object. This type of
event occurs when the
playback of the
presentation is
completed.

PLAYBACK_SUSPENDEDString playbackSuspended Defines the value of the

Page 183
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

type property of the


playbackSuspended
event object. This type of
event occurs when the
presentation playback is
suspended at the
animation step end and
waits for user action.

PLAYBACK_RESUMED String playbackResumed Defines the value of the


type property of the
playbackResumed event
object. This type of event
occurs when the
presentation playback is
resumed on user action.

See also
IPresentationPlaybackController Interface
IPlayer Interface
ActionScript3 and Flex support in iSpring

ispring.as2player.PlaybackPositionEvent Class

The PlaybackPositionEvent Class extends the standard ispring.as2player.PlaybackEvent


class and exposes the following constants and properties:
Constants

Constant Type Value Description

SLIDE_POSITION_CHANGED
String slidePositionChanged Defines the value of the
type property of the
slidePositionChanged
event object. This type of
event occurs when the
playback position of the
currently playing slide is
changed.
A slidePositionChanged
event contains the
following properties:
position.

Page 184
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Properties

Property Type Description

position Number Slide playback position.


The following events contain this
property:
slidePositionChanged

See also
IPresentationPlaybackController Interface
ActionScript3 and Flex support in iSpring

ispring.as2player.PlayerEvent Class

The PlayerEvent Class extends the standard flash.events.Event class and exposes the
following constants and properties:
Constants

Constant Type Value Description

PLAYER_INIT String playerInit Defines the value of the


type property of a
playerInit event object.
This type of event occurs
when player initialization
is completed.

See also
IPlayer Interface
ActionScript3 and Flex support in iSpring

ispring.as2player.PresentationLoader Class

The PresentationLoader Class extends the standard flash.display.Sprite class and exposes
the following methods and events:
Properties

Property Type Description

Page 185
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

content flash.display.DisplayObject Content object which contains the


presentation.

contentLoaderInfo LoaderInfo Content loader info

player IPlayer Presentation player

Methods

Method Description

PresentationLoader() Constructs a new PresentationLoader object which


creates player
and establishes local connection with the iSpring
generated
Flash presentation via ActionScript Connector.

load(request:URLRequest, Loads the iSpring generated Flash presentation


securityDomain:SecurityDomain = null):void specified in request parameter.

unload():void Unloads the iSpring generated Flash presentation and


closes ActionScript Connector.

close():void Closes the presenation loader.

See also
ActionScript 3 and Flex support in iSpring

ispring.as2player.SlidePlaybackEvent Class

The SlidePlaybackEvent Class extends the standard ispring.as2player.PlaybackEvent class


and exposes the following constants and properties:
Constants

Constant Type Value Description

CURRENT_SLIDE_INDEX_CHANGED
String currentSlideIndexChanged Defines the value of the
type property of the
currentSlideIndexChanged

Page 186
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

event object. This type of


event occurs when
current slide is changed
by another slide of the
presentation.
A
currentSlideIndexChanged
event contains the
following properties:
slideIndex.

SLIDE_LOADING_COMPLETE
String slideLoadingComplete Defines the value of the
type property of the
slideLoadingComplete
event object. This type of
event occurs when the
given slide of the
presentation is loaded.
A slideLoadingComplete
event contains the
following properties:
slideIndex.

Properties

Property Type Description

slideIndex Number Slide index.


The following events contain this
property:
currentSlideIndexChanged,
slideLoadingComplete

See also
IPresentationPlaybackController Interface
ActionScript3 and Flex support in iSpring

ispring.as2player.SoundEvent Class

The SoundEvent Class extends the standard flash.events.Event class and exposes the
following constants and properties:
Constants

Page 187
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Constant Type Value Description

SOUND_VOLUME_CHANGED
String soundVolumeChanged Defines the value of the
type property of the
soundVolumeChanged
event object. This type of
event occurs when the
sound volume is
changed.
A soundVolumeChanged
event contains the
following properties:
volume.

Properties

Property Type Description

volume Number Sound volume.


The following events contain this
property:
soundVolumeChanged

See also
IPresentationPlaybackController Interface
ActionScript3 and Flex support in iSpring

ispring.as2player.StepPlaybackEvent Class

The StepPlaybackEvent Class extends the standard ispring.as2player.PlaybackEvent class


and exposes the following constants and properties:
Constants

Constant Type Value Description

ANIMATION_STEP_CHANGED
String animationStepChanged Defines the value of the
type property of the
animationStepChanged
event object. This type of
event occurs when
current slide is changed
by another slide of the

Page 188
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

presentation.
A animationStepChanged
event contains the
following properties:
stepIndex.

Properties

Property Type Description

stepIndex Number Animation step index.


The following events contain this
property:
currentSlideIndexChanged,
slideLoadingComplete

See also
IPresentationPlaybackController Interface
ActionScript3 and Flex support in iSpring

Obsolete ActionScript 3 API

Obsolete ActionScript 3 API

This article describes the way of the iSpring generated presentations communication with
Flash 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 Flash

Page 189
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

9 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 8
or 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 a
LocalConnection 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:

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-way
interaction is needed, each Flash movie must create 2 LocalConnection objects: one
connection 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 1
LocalConnection with a given name on the same PC. So it is recommended to generate
connection name based on some random information such as date. The sending Flash movie
needs a connection name of the receiving Flash movie. This connection name can be passed
as an URL parameter:
var lc:LocalConnection = new LocalConnection();
lc.sayHello = function(name:String):Void
{
trace("Hello, " + name + "!");
}
// generate connection name which is most likely unique
var 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 parameter
childMovie.loadMovie("someMovie.swf?lcid=" + escape(connectionName));

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

Page 190
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 between
ActionScript 3 Flash movie and iSpring generated presentations. Flash9 / Flex application
loads a special bridge SWF module written in ActionScript 2 which loads the presentation.
This bridge module communicates with the presentation using its ActionScript API; from
the other hand the bridge communicates with Flash 9 / Flex application using
LocalConnection. 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 and
iSpring SDK samples. There is also a set of ActionScript 3 classes providing ActionScript 3
API simplifying communication with iSpring presentations.

Page 191
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 occurring


duriong presentation loading and playback

BridgeLoader Loads the presentation using bridge communication


module.

Page 192
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 particular


presentation 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 using
ispring.flex.PresentationContainer class. This class extends the standard
mx.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 or
Standalone Flash player");
return;
}

Page 193
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

// create target sprite


var target:Sprite = new Sprite();
addChild(target);
// load bridge
var 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

Page 194
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

ActionScript 3 Bridge Flash example

Adobe Flex communication demo

Page 195
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Flex example

References

AnimationStep Class
AnimationSteps Class
BridgeEvent Class
BridgeLoader Class
PlaybackController Class
Player Class
PresentationContainer Class
PresentationInfo Class
PresenterInfo Class
ReferenceInfo Class

Page 196
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

ReferencesCollection Class
SlideInfo Class
SlidesCollection Class
SoundController Class
iSpring ActionScript API

iSpring.as3bridge.AnimationStep Class

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

Property Type Description

playTime Number Animation step play time (see the


remarks section)

pauseTime Number Animation step pause time (see the


remarks section)

startTime Number Animation step start time (see the


remarks 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.

Page 197
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Animation step structure

An Animation step starts playing at the Step start time. Animations are playing for the Play
time. Then, at the Pause start time, animations are suspended for the Pause time period till
the Pause end time. Pause time depends on slide timings that were set using "Record
narration" or "Rehearse timings" menu of PowerPoint.
stepStartTime0 = 0
pauseStartTimei = stepStartTimei + playTimei
pauseEndTimei = pauseStartTimei + pauseTimei
stepStartTimei+1 = pauseEndTimei

If the slide has no timings (i.e. user has to click slide background to advance mouse-driven
animations), Pause time and Pause end time are undefined. In this case returned timings are
as follows:
pauseStartTimei = stepStartTimei + playTimei
pauseEndTimei = undefined

Page 198
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

stepStartTimei+1 = pauseStartTimei

See also
AnimationSteps Class
Obsolete ActionScript 3 API

iSpring.as3bridge.AnimationSteps Class

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

Property Type Description

duration Number The total duration of animation


steps in seconds. The duration of
animation steps is equal to the
duration of the slide

stepsCount Number Number of slide animation steps

Methods

Method Description

getStep(index:Number):AnimationStep Returns the AnimationStep Class providing the


information about animation step timings

Remarks
Slide animation timeline consists of one or more animation steps. Animation step is a
sequence of animation effects playing without mouse click requirement.
Slide background, static shapes, and shapes animated before the first mouse driven animation
are 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 playing
at the separate animation step. In other words, the number of animation steps is equal to
number of on-click animations plus 1.
Example

Page 199
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 Class
SlideInfo Class
Obsolete ActionScript 3 API

iSpring.as3bridge.BridgeEvent Class

Page 200
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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

Constant Type Value Description

PAUSE String pause Defines the value of the


type property of a pause
event object. This type of
event occurs when
presentation playback is
suspended.
A pause event contains
the following properties:
playbackController

PLAY String play Defines the value of the


type property of a play
event object. This type of
event occurs when
presentation playback is
resumed.
A play event contains the
following properties:
playbackController

STEP_CHANGE String stepChange Defines the value of the


type property of the
stepChange event
object. This type of event
occurs when currently
playing animation step
index is changed.
A stepChange event
contains the following
properties:
playbackController,
stepIndex

POSITION_CHANGE String positionChange Defines the value of the


type property of the
positionChange event
object. This type of event
occurs when the
playback position of the

Page 201
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

currently playing slide is


changed.
A positionChange event
contains the following
properties:
playbackController,
position

SLIDE_CHANGE String slideChange Defines the value of the


type property of the
slideChange event
object. This type of event
occurs when current slide
is changed by another
slide of the presentation.
A slideChange event
contains the following
properties:
playbackController,
slideIndex

SLIDE_LOAD_COMPLETE
String slideLoadComplete Defines the value of the
type property of the
slideLoadComplete
event object. This type of
event occurs when the
given slide of the
presentation is loaded.
A slideLoadComplete
event contains the
following properties:
playbackController,
slideIndex

PLAYBACK_COMPLETEString playbackComplete Defines the value of the


type property of the
playbackComplete
event object. This type of
event occurs when the
playback of the
presentation is
completed.
A playbackComplete
event contains the
following properties:
playbackController

Page 202
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

BRIDGE_LOADED String bridgeLoaded Defines the value of the


type property of the
bridgeLoaded event
object. This type of event
occurs when the
ActionScirpt bridge
module is loaded and
ready to receive
commands from the
parent Flash movie.
A bridgeLoaded event
contains the following
properties:
succeeded, player

PLAYER_INIT String playerInit Defines the value of the


type property of the
playerInit event object.
This type of event occurs
when player initialization
is completed, just after
the bridgeLoaded event.
A playerInit event
contains the following
properties:
succeeded, player

VOLUME_CHANGE String volumeChange Defines the value of the


type property of the
volumeChange event
object. This type of event
occurs when the sound
volume is changed.
A volumeChange event
contains the following
properties:
soundController, volume

SEEKING_COMPLETE String seekingComplete Defines the value of the


type property of the
seekingComplete event
object. This type of event
occurs when the seek
command execution is
completed.
A seekingComplete event
contains the following

Page 203
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

properties:
playbackController,
position

VOLUME_CHANGING_COMPLETE
String volumeChangingComplete Defines the value of the
type property of the
volumeChangingComplete
event object. This type of
event occurs when the
sound volume property
of the SoundController
object is changed.
A
volumeChangingComplete
event contains the
following properties:
soundController, volume

SLIDE_METADATA_LOAD
String slideMetadataLoad Defines the value of the
type property of the
slideMetadataLoad
event object. This type of
event is generated by
SlideInfo object when its
metadata is loaded.
A slideMetadataLoad
event contains the
following properties:
slideInfo, slideIndex

Properties

Property Type Description

playbackController PlaybackController The PlaybackController class


instance.
The following events contain this
property:
play, pause, stepChange,
positionChange, slideChange,
slideLoadComplete,
playbackComplete,
seekingComplete

slideIndex Number Slide index.

Page 204
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

The following events contain this


property:
slideLoadComplete,
slideMetadataLoad, slideChange

stepIndex Number Animation step index.


The following events contain this
property:
stepChange

position Number Slide playback position.


The following events contain this
property:
positionChange, seekingComplete

succeeded Boolean Indicates whether the bridge or


player was loaded and initialized
successfully.
The following events contain this
property:
bridgeLoaded, playerInit

player Player The Player class instance.


The following events contain this
property:
bridgeLoaded, playerInit

volume Number A sound volume value.


The following events contain this
property:
volumeChange,
volumeChangingComplete

slideInfo SlideInfo A SlideInfo class instance.


The following events contain this
property:
slideMetadataLoad

soundController SoundController A SoundController class instance.


The following events contain this
property:
volumeChange,
volumeChangingComplete

Page 205
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

See also
PlaybackController Class
Player Class
SlideInfo Class
SoundController Class
Obsolete ActionScript 3 API

iSpring.as3bridge.BridgeLoader Class

The BridgeLoader Class extends the standard flash.events.EventDispatcher class and


exposes the following methods and events:
Methods

Method Description

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

loadPresentation(bridgeURL:String, Loads the ActionScript 3 bridge module and the


presentationURL:String, iSpring generated Flash presentation.
commandConnectionName:String = "", Notes: If command or event connection name is
eventConnectionName:String = ""):Player empty, it will be generated using current time stamp.

Events

Type Description

BridgeEvent.PLAYER_INIT Occurs when player initialization is completed, just


after the BridgeEvent.BRIDGE_LOADED event.

See also
BridgeEvent Class
Player Class
flash.events.EventDispatcher Class
flash.display.DisplayObjectContainer Class
Obsolete ActionScript 3 API

iSpring.as3bridge.PlaybackController Class

Page 206
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

The PlaybackController class extends the standard flash.events.EventDispatcher Class and


provides the following properties, methods and events for presentation playback and
navigation control.
Properties

Property Type Description

isPlaying Boolean Indicates whether the presentation


is playing or not (read only)

currentSlideDuration Number A duration of the currently playing


slide (read only)

currentSlideIndex Number Current slide index (read only)

currentSlidePlaybackPosition Number Returns playback position within


current slide.
Note: playback position is a
number between 0 and 1

currentStepIndex Number Returns current animation step


index

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 its
playback.
Note: if the autoStart parameter was set to false, slide
playback would not be started after switching

gotoPreviousSlide([autoStart:Boolean = true]):Void Switches to the previous presentation slide and starts


its playback.
Note: if the autoStart parameter was set to false, slide
playback would not be started after switching

Page 207
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

gotoLastViewedSlide([autoStart:Boolean = Switches to the previously viewed slide and starts its


true]):Void playback.
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 = Switches to the given slide of the presentation and


true]):Void starts its playback
Notes: Slide index is zero-based.
If the autoStart parameter was set to false, slide
playback 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 position


Note: 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. After


this operation slide playback gets suspended until the
endSeek() method or other playback control method
is called
Note: position is a number between 0 and 1

endSeek([resumePlayback:Boolean = Exits from seeking mode and restores playback.


undefined]):Void Note: the resumePlayback parameter allows to start
or pause slide after seeking explicitly

getCurrentStepIndex():Number Returns current animation step index

gotoNextStep():Void Plays current slide from the beginning of the next


animation step.
Note: being called at the end of the slide this method
plays presentation from the beginning of the next
slide

gotoPreviousStep():Void Moves slide playback one step back. This method


suspends slide playback at the end of the previous
animation step.

Page 208
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Note: being called on the start slide step this method


causes playback switching to the end of the previous
slide

setAnimationStepPause(pause:Number):Void This method allows setting a pause between


animation steps. If an undefined value is passed as
pause value, animation steps will not be played
automatically

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


specified animation step

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


specified animation step

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


animations step

enableAutomaticSlideSwitching(enableSwitching:Boolean):Void
Enables or disables automatic switching to the next
slide.
Note: this method affects automatically switching
slides only.

getAutomaticSlideSwitching():Boolean Returns true if automatic slide switching has been


enabled, 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 index


is changed

BridgeEvent.POSITION_CHANGE Occurs when the playback position of the currently


playing slide is changed

Page 209
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

BridgeEvent.SLIDE_CHANGE Occurs when current slide is changed by another


slide 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 is


completed

See also
IPlaybackListener Interface
IPlayer Interface
Flash Presentation ActionScript API Reference

iSpring.as3bridge.Player Class

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

Property Type Description

playbackController PlaybackController Returns the PlaybackController


class providing presentation
playback control and navigation
facilities

soundController SoundController Returns the SoundController class


providing sound volume control
facilities

presentationInfo PresentationInfo Returns the PresentationInfo class


providing the presentation content
information

initialized Boolean Returns a Boolean value indicating


whether the player was initialized.
The following properties return an
undefined value until the player
gets initialized:

Page 210
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

• presentationInfo
• playbackController
• soundController

Events

Type Description

BridgeEvent.BRIDGE_LOADED Occurs when the ActionScript bridge module is


loaded and ready to receive commands from the
parent Flash movie.

See also
PlaybackController Class
PresentationInfo Class
SoundController Class
flash.events.EventDispatcher Class
Obsolete ActionScript 3 API

iSpring.flex.PresentationContainer Class

The PresentationContainer class extends the standard mx.core.UIComponent class and


provides the following properties:
Properties

Property Type Description

bridgeLoader BridgeLoader Returns a BridgeLoader object


providing an ability to load iSpring
generated presentations

Samples
This class can be used in Flex applications to put a presentation container UI component to a
Flex 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"

Page 211
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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


</mc:PresentationContainer>
<!-- the rest UI elements are placed here-->
</mx:Application>

The following code loads the generated presentation into the presentation container (file
main.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 Class
mx.core.UIComponent Class
Obsolete ActionScript 3 API

iSpring.as3bridge.PresentationInfo Class

The PresentationInfo class stores the presentation information and provides the following
properties:
Properties

Property Type Description

hasPresenter Boolean Indicates whether the presentation


contains Presenter information

presenterInfo PresenterInfo Returns the PresenterInfo Class


providing the information about
presentation presenter

slides SlidesCollection Returns the SlidesCollection Class


providing information about
presentation slides

hasReferences Boolean Indicates whether the presentation


contains references

Page 212
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

references ReferencesCollection Returns the ReferencesCollection


Class providing the information
about 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 of


frames per second)
Note: when iSpring generated
presentation is loaded by another
Flash movie, it always plays at its
frame rate.

See also
PresenterInfo Class
SlidesCollection Class
ReferencesCollection Class
Obsolete ActionScript 3 API

iSpring.as3bridge.PresenterInfo Class

The PresenterInfo Class stores the information about presenter and provides the following
properties:
Properties

Property Type Description

name String Presenter name

title String Presenter title

biographyText String A brief information about


presenter

Page 213
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

email String Presenter e-mail address

webSite String Presenter Web site address

See also
PresentationInfo Class
Obsolete ActionScript 3 API

iSpring.as3bridge.ReferenceInfo Class

The ReferenceInfo Class provides the following properties for retrieving reference
information:
Properties

Property Type Description

title String Reference title

url String Reference URL

target String Target window name where the


reference should be opened

See also
ReferencesCollection Class
Obsolete ActionScript 3 API

iSpring.as3bridge.ReferencesCollection Class

The ReferencesCollection class provides the following properties and methods for accessing
presentation references:
Properties

Property Type Description

referencesCount Number Number of references in the


collection

Page 214
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Methods

Method Description

getReference(index:Number):ReferenceInfo Returns ReferenceInfo class providing the


information about the specified reference.
Note: the index parameter is an integer value from 0
to (number of references minus 1)

See also
ReferenceInfo Class
PresentationInfo Class
Obsolete ActionScript 3 API

iSpring.as3bridge.SlideInfo Class

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

Property Type Description

animationSteps AnimationSteps Returns the AnimationSteps class


providing the information about
slide animation steps

metadataLoaded Boolean Indicates whether slide metadata


has been loaded
Note: all slide properties except
startTime property are undefined
until slide metadata is loaded

isLoaded Boolean Indicates whether slide has been


loaded
Note: it is guaranteed that loaded
slide metadata is loaded

title String Slide title

duration Number Slide duration in seconds

Page 215
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

notesText String Slide notes text

startTime Number Slide start time within presentation


timeline

endTime Number Slide end time within presentation


timeline

startStepIndex Number Slide start step index within the


presentation

endStepIndex Number Slide end step index within the


presentation

slideText String Slide text in the normalized form


(see the remarks section)

notesTextNormalized String Slide notes text in the normalized


form (see the remarks section)

titleNormalized String Slide title in the normalized form


(see the remarks section)

Normalized strings are strings having all characters in the lower case with no extra spaces
between words. This simplifies and speeds up full text search implementation.
See also
AnimationSteps Class
SlidesCollection Class
Obsolete ActionScript 3 API
`
iSpring.as3bridge.SlidesCollection Class

The ISlidesCollection interface represents a collection of presentation slides. It provides the


following properties and methods:
Properties

Property Type Description

Page 216
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

slidesCount Number Number of slides in the


presentation

Methods

Method Description

getSlideInfo(slideIndex:Number):SlideInfo Returns SlideInfo Class providing information about


the specified slide
Note: Slide index is zero-based

See also
PresentationInfo Class
SlideInfo Class
Obsolete ActionScript 3 API

iSpring.as3bridge.SoundController Class

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

Property Type Description

volume Number Sound volume


Note: sound volume is a number
between 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 via


volume property of the SoundController object

See also
Player Class

Page 217
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

flash.events.EventDispatcher Class
Obsolete ActionScript 3 API

11.4 Skin Development Reference

11.4.1 Skin development


iSpring provides Flash developers with custom skin development facilities. Creation of a
custom skin is a quite easy task for developers familiar with Flash 7 or 8 and ActionScript
2.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 object
implementing fsplayer.ui.skins.ISkin Interface. Visibility of the passed target MovieClip can
be controlled by the Flash presentation preloader.
When the skin is created, the player is initialized. Player initialization scheme is illustrated in
the following diagram.

Page 218
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

iSpring Player initialization scheme

The following interfaces are used for the development of custom skins. They are located
within fsplayer.ui.skins package.
Name Description

ISkin Provided by all iSpring-compatible skin modules

ISkinListener Implemented by the player core and allows receiving


skin initialization event notifications

ISlideShowWindow Provides the player core with the target MovieClip


object where slides are loaded

Samples

Page 219
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 the
ISkin interface description.
See also
ISkin Interface
ISkin Interface implementation
iSpring presentation structure

11.4.2 fsplayer.ui.skins.ISkin Interface


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

Method Description

initialize(player:IPlayer):Void This method is invoked by the player core to


initialize the skin. The information provided by the
passed player parameter can be used by the skin to
initialize its visual components.
Note: playback control methods of the
IPresentationPlaybackController interface are
inaccessible until the skin gets initialized.
Skins use ISkinListener interface to notify the core at

Page 220
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

the end of the skin initialization process. See


Remarks section for more details.

getSlideShowWindow():ISlideShowWindow Returns the ISlideShowWindow interface providing


the player core with the target MovieClip for
presentation slides loading.

setListener(listener:ISkinListener):Void The player core passes ISkinListener interface that


allows core to receive notifications about skin
initializaiton process.

Remarks

Skin initialization can take some time, especially when the skin loads some extra data from
the Internet. In order to get the initialization notification the player core implements the
ISkinListener 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 skin
function initialize(playerAPI:IPlayer):Void
{
m_player = playerAPI;

Page 221
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

m_skinSettings = m_player.getSettings();
m_playbackController = m_player.getPlaybackController();
m_presentation = m_player.getPresentationInfo();
m_playbackController.addListener(this);
}
// returns slide show window
function getSlideShowWindow():ISlideShowWindow
{
return this;
}
// ISlideShowWindow.getTarget() returns the target MovieClip where slides
will be loaded and displayed by player core
function getTarget():MovieClip
{
if (!m_slideAssetsTargetMovieClip)
{
m_slideAssetsTargetMovieClip = createSlideAssetsTarget();
}
return m_slideAssetsTargetMovieClip;
}
// this method is called by playback core to get notified when the skin is
loaded
function 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 be
overriden by inherited classes
function 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 skin
settings
private function getSkinSettings():Object
{
return m_skinSettings;
}

Page 222
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

// returns the target MovieClip where the skin resides. This method can be
overriden 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 classes
private function createSlideAssetsTarget():MovieClip
{
return getSkinTarget().createEmptyMovieClip("assets",
getSkinTarget().getNextHighestDepth());
}
}

See also
IPlayer Interface
IPresentationPlaybackController Interface
ISkinListener Interface
ISlideShowWindow Interface
Skin development

11.4.3 fsplayer.ui.skins.ISkinListener Interface


The ISkinListener interface is implemented by the player core and allows it to receive the
notification 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 player


core that the skin has been initialized. The skin
parameter is an object which implements the ISkin
interface.

Remarks
Skin initialization can require some time especially if the skin needs to load some
information from the Internet in order to finish the initialization process. Skin notifies the
player core via onSkinInit() method call on the ISkinListener interface. The ISkinListener
Interface 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.

Page 223
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

See also
ISkin Interface
Skin development

11.4.4 fsplayer.ui.skins.ISkinSizeController Interface


The ISkinSizeController interface provides methods for resizing, scaling and self-scaling of
player skin. Advanced, Crystal and Lite skins currently implement support of this interface.
Methods

Method Description

getAutoSize():Boolean Returns true if self-scaling is been enabled for the


skin, false otherwise

setAutoSize(autoSize:Boolean):Void This method allows to set self-scaling property. If


self-scaling is enabled, the skin will occupy entire
Flash player window

getWidth():Number Returns width of the skin in pixels

getHeight():Number Returns height of the skin in pixels

setSize(width:Number, height:Number):Void This method allows to set width and height in pixels
of the window where skin is displayed. Applies to the
skin if self-scaling is disabled

getScaleX():Number Returns X-direction scaling value of the window


where skin is displayed. Applies to the skin if
self-scaling is disabled
Note:The default value is 100%

getScaleY():Number Returns Y-direction scaling value of the window


where skin is displayed. Applies to the skin if
self-scaling is disabled
Note:The default value is 100%

setScale(scaleX:Number, scaleY:Number):Void This method allows to set X and Y scaling of the


window where skin is displayed

Page 224
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

See also
ISkin Interface

11.4.5 fsplayer.ui.skins.ISlideShowWindow Interface


The ISlideShowWindow interface provides the player core with the target MovieClip for
presentation slides loading.
Methods

Method Description

getTarget():MovieClip Returns the MovieClip which will be used by the


player core to load and display slides

Remarks
iSpring generated presentations can be wrapped into one of the existing skins or into a
custom made skin. Each skin provides its unique user interface. Slide loading and playback is
a responsibility of the player core while UI and navigation is a responsibility of skins. The
ISlideShowWindow interface provides playback core with the necessary target MovieClip
for presentation slides loading and display.
See also
ISkin Interface
Skin development

11.5 Flash Slide ActionScript API Reference

11.5.1 Flash Slide ActionScript API Reference


Each Standalone Flash slide created with iSpring contain a small slide controller. This is a
small Flash module which manages synchronous playback of animations and sounds on the
slide. 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 each

Page 225
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

standalone slide. This function returns the slideplayer.api.ISlideController interface


providing an access to the rest interfaces of the generated standalone slide. The Standalone
Slide 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. These
interfaces reside in slideplayer.api package.
Name Description

IAnimationStep provides the information about animation step


timings

IAnimationSteps provides the information about animation steps on the


slide

Page 226
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

IHyperlinksManager Provides slides with ability to handle hyperlinks to


other slides and external web pages

IPlaybackController provides methods for slide playback control

IPlaybackListener Defines a set of methods which are invoked by


playback controller when the corresponding events
occur

ISlideController Provides an access to the slide core

ISoundController Provides sound control facilities

See also
IAnimationStep Interface
IAnimationSteps Interface
IHyperlinksManager Interface
IPlaybackController Interface
IPlaybackListener Interface
ISlideController Interface
ISoundController Interface

11.5.2 slideplayer.api.IAnimationStep Interface


The IAnimationStep Interface provides the information about animation step timings. It
exposes the following methods:
Methods

Method Description

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


section)

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


section)

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


section)

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

Page 227
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

remarks section)

getPauseEndTime():Number Returns 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 Play
time. Then, at the Pause start time, animations are suspended for the Pause time period till
the Pause end time. Pause time depends on slide timings that were set using "Record
narration" or "Rehearse timings" menu of PowerPoint.
stepStartTime0 = 0
pauseStartTimei = stepStartTimei + playTimei

Page 228
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

pauseEndTimei = pauseStartTimei + pauseTimei


stepStartTimei+1 = pauseEndTimei

If the slide has no timings (i.e. user has to click slide background to advance mouse-driven
animations), Pause time and Pause end time are undefined. In this case returned timings are
as follows:
pauseStartTimei = stepStartTimei + playTimei
pauseEndTimei = undefined
stepStartTimei+1 = pauseStartTimei

See also
IAnimationSteps Interface
Flash Slide ActionScript API Reference

11.5.3 slideplayer.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 in


seconds. The duration of animation steps is equal to
the duration of the slide

getStep(index:Number):IAnimationStep Returns the IAnimationStep Interface providing the


information about animation step timings

Remarks
Slide animation timeline consists of one or more animation steps. Animation step is a
sequence of animation effects playing without mouse click requirement.
Slide background, static shapes, and shapes animated before the first mouse driven animation
are 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 are
playing at the separate animation step. In other words, the number of animation steps is equal
to number of on-click animations plus 1.

Page 229
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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
IAnimationStep Interface
Flash Slide ActionScript API Reference

11.5.4 slideplayer.api.IHyperlinksManager Interface

Page 230
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

The IHyperlinksManager Interface provides slides with an ability to switch to another


slides or open external web pages. A standalone slide does not switch to another slide when a
hyperlink is clicked. An external Flash application can use setHyperlinksManager() method
of the ISlideController interface to pass an object implementing the IHyperlinksManager
interface 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 hyperlink


to another slide
An implementation can hide the current slide and
load and show the new one

openURL(url:String, target:String):Void This method is invoked when user clicks a hyperlink


to an external web page or other resource
Note: the simplest way to implement this method is
to call following ActionScript function:
getURL(url, target)

gotoLastViewedSlide():Void This method is invoked when user clicks a hyperlink


to the last viewed slide.
An implementation must hide the current slide and
show the slide that was shown before

endShow():Void This method is invoked when user clicks a hyperlink


that finishes slide show
Typically, an implementation unloads all slides of the
current presentation

Samples
The following example illustrates a typical IHyperlinksManager interface implementation
and shows its usage.
CMyHyperlinksManager.as

import slideplayer.api.*;
class CMyHyperlinksManager implements IHyperlinksManager
{
private var m_viewedSlides:Array;

Page 231
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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");
}
}

Page 232
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 index
function loadSlide(slideIndex:Number):Void
{
// remove hyperlinks manager from the current slide
g_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 via
IHyperlinksManager interface.

Page 233
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

See also
ISlideController Interface
Flash Slide ActionScript API Reference

11.5.5 slideplayer.api.IPlaybackController Interface


The IPlaybackController interface provides methods for slide playback control. This
interface can be obtained by calling getPlaybackController() method on ISlideController
interface.
The IPlaybackController interface exposes the following methods:
Methods

Method Description

Page 234
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

addListener(listener:IPlaybackListener):Void Adds an external object implementing


IPlaybackListener interface; it will be notified about
events during playback; the passed object will receive
slide playback event notifications

removeListener(listener:IPlaybackListener):Void Removes previously added listener object. The


passed object won't receive notifications from the
playback controller any more

isPlaying():Boolean Returns a Boolean value indicating whether the slide


is playing or not

play():Void Resumes slide playback

pause():Void Suspends slide playback

getPosition():Number Returns slide playback position


Note: 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

getCurrentStepIndex():Number Returns current animation step index

gotoNextStep():Void Plays the slide from the beginning of the next


animation step

gotoPreviousStep():Void Moves slide playback one step back. This method


suspends slide playback at the end of the previous
animation step

playFromStep(stepIndex:Number):Void Plays the slide from the beginning of the specified


animation step

pauseAtStepStart(stepIndex:Number):Void Suspends the slide at the beginning of the specified


animation step

pauseAtStepEnd(stepIndex:Number):Void Suspends the slide at the end of specified animations

Page 235
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

step

Samples
The following example illustrates how to obtain and use the IPlaybackController interface to
control 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 loaded
function 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.

Page 236
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

References
IPlaybackListener Interface
ISlideController Interface
Flash Slide ActionScript API Reference

11.5.6 slideplayer.api.IPlaybackListener Interface


There are various events occurring during slide playback. The playback controller notifies
external objects about these events via IPlaybackListener interface. This interface defines a
set of methods which are invoked by playback controller when the corresponding events
occur. These methods are as follows.

Page 237
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 during


playback

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


playback

onSlidePlaybackFinished():Void This method is called when slide playback was


finished.

In order to receive event notifications you need to create a class which implements
IPlaybackListener interface and pass the instance of this class to the addListener method
of the IPlaybackController interface.
See also
IPlaybackController Interface
Flash Slide ActionScript API Reference

11.5.7 slideplayer.api.ISlideController Interface


The ISlideController interface is exposed by each standalone slide. It provides the following
methods.
Methods

Method Description

getPlaybackController():IPlaybackController Returns the IPlaybackController interface providing


slide playback control facilities

getSoundController():ISoundController Returns the ISoundController interface providing


sound volume control facilities

getHyperlinskManager():IHyperlinksManager Returns the IHyperlinksManager interface providing

Page 238
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

hyperlink action handling facilities

setHyperlinksManager(manager:IHyperlinksManager):Void
Sets the new IHyperlinksManager interface which
will 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

getAnimationSteps():IAnimationSteps Returns the IAnimationSteps interface providing


information about animation steps on the slide

Samples
The following example illustrates how to load a flash slide and get its ISlideController
interface.

import slideplayer.api.*;
System.security.allowDomain("*");
// create a movie clip where slide will be loaded
var slideMC1:MovieClip = this.createEmptyMovieClip("slide1", 1);
// load slide with name slide1.swf into slideMC1 movie clip
var 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 slide
is initialized
function onLoadInit(target:MovieClip):Void
{
// now we can get ISlideController interface and access its methods
g_slideController = target.getSlideController();
}
Demo
The following demo illustrates standalone slide loading and playback control via
IPlaybackController interface.

Page 239
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

See also
IAnimationSteps Interface
IHyperlinksManager Interface
IPlaybackController Interface
ISoundController Interface
Flash Slide ActionScript API Reference

11.5.8 slideplayer.api.ISoundController Interface


The ISoundController Interface provides the following methods for sound control.
Methods

Page 240
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

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 on
the slide.

Page 241
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

See also
ISlideController Interface
Flash Slide ActionScript API Reference

12 JavaScript API Reference

12.1 JavaScript support in iSpring


This article describes the way of the iSpring generated presentations communication with

Page 242
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

web page via Java script.


iSpring generated Flash presentations provide JavaScript API. It allows getting presentation
info and controlling presentation playback and navigation using JavaScript.
iSpring JavaScript API

Class name Description

PlaybackController Provides presentation playback and navigation


facilities.

Player Provides an access to the presentation playback core

PresentationInfo Provides an access to the presentation information

PresentationLoader Simplifies process of presentation loading.

PresentersCollection Provides the information about the presentation


presenters.

SlideInfo Provides the information about the particular slide.

SlidesCollection Stores a collection of slides.

SoundController Provides sound control facilities

12.1.1 References
PlaybackController Class
Player Class
PresentationInfo Class
PresentationLoader Class
PresentersCollection Class
SlideInfo Class
SlidesCollection Class
SoundController Class

12.2 fsplayer.api.Player Class


The Player class exposes the following methods:

Page 243
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Methods

Method Description

getPlaybackController() Returns the PlaybackController object providing the


presentation playback control facilities.

getPresentationInfo() Returns the PresentationInfo object providing the


presentation content information.

getSoundController() Returns the SoundController object providing the


sound control facilities

See also
PlaybackController Class
PresentationInfo Class
SoundController Class
JavaScript support in iSpring

12.3 iSpring.as2player.PresentationLoader Class


The PresentationLoader class provide facilities for loading iSpring generated Flash
presentation and exposes the following methods:
Methods

Method Description

load(movieName, contentParent, movieId, width, Creates SWFObject with name specified by


height) movieName and loads the iSpring generated Flash
presentation in it. Flash object is placed in the content
element with id specified by contentParent. Width,
height parameters define dimensions and movieId
defines Id of created SWFObject.

onPlayerInit(player: Object) This method is calls after player was initialized. It


can be overrided.

getMovie() Returns SWFObject which contains iSpring


generated Flash presentation.

Page 244
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

getMovieId() Returns identifier of SWFObject element which


contains iSpring generated Flash presentation.

See also
JavaScript support in iSpring

12.4 fsplayer.api.PlaybackController Class


The PlaybackController class exposes the following constants and methods:
Constants

Constant Type Value Description

PAUSE_PLAYBACK String playbackListener_onPausePlayback


Defines the name of
pause playback event.

START_PLAYBACK String playbackListener_onStartPlayback


Defines the name of start
playback event.

ANIMATION_STEP_CHANGED
String playbackListener_onAnimationStepChanged
Defines the name of
animation step changed
event.

SLIDE_POSITION_CHANGED
String playbackListener_onSlidePositionChanged
Defines the name of slide
position changed event.

CURRENT_SLIDE_INDEX_CHANGED
String playbackListener_onCurrentSlideIndexChanged
Defines the name of
current slide is changed
event.

SLIDE_LOADING_COMPLETE
String playbackListener_onSlideLoadingComplete
Defines the name of slide
loading is completed
event.

PRESENTATION_PLAYBACK_COMPLETE
String playbackListener_onPresentationPlaybackComplete
Defines the name of
presentation playback
completed event.

PLAYBACK_SUSPENDEDString playbackListener_onPlaybackSuspended
Defines the name of
presentation playback

Page 245
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

suspended event.

PLAYBACK_RESUMED String playbackListener_onPlaybackResumed


Defines the name of
presentation playback
resumed event.

Methods

Method Description

play() Starts or resumes presentation playback.

pause() Suspends presentation playback.

gotoSlide(slideIndex, autoStart) Switches to the given slide of the presentation and


starts its playback
Notes: Slide index is zero-based.

isPlaying(slideIndex, autoStart) Indicates whether the presentation is playing or not.

gotoNextSlide(autoStart) Switches to the next presentation slide and starts its


playback. Note: if the autoStart parameter was set to
false, slide playback would not be started after
switching.

gotoPreviousSlide(autoStart) Switches to the previous presentation slide and starts


its playback. Note: if the autoStart parameter was set
to false, slide playback would not be started after
switching.

getCurrentSlideIndex() Returns current slide index.

getCurrentSlidePlaybackPosition() Returns playback position within current slide. Note:


playback position is a number between 0 and 1.

gotoNextStep() Plays current slide from the beginning of the next


animation step. Note: being called at the end of the
slide this method plays presentation from the
beginning of the next slide.

gotoPreviousStep() Moves slide playback one step back. This method


suspends slide playback at the end of the previous

Page 246
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

animation step. Note: being called on the start slide


step this method causes playback switching to the
end of the previous slide.

getCurrentStepIndex() Returns current animation step index.

setPausePlaybackHandler() Sets onPausePlayback() method as handler for


PAUSE_PLAYBACK event.

onPausePlayback() Does nothing. This method can be overridden.

setStartPlaybackHandler() Sets onStartPlayback() method as handler for


START_PLAYBACK event.

onStartPlayback() Does nothing. This method can be overridden.

setAnimationStepChangedHandler() Sets onAnimationStepChanged() method as handler


for ANIMATION_STEP_CHANGED event.

onAnimationStepChanged(stepIndex) Does nothing. This method can be overridden.

setSlidePositionChangedHandler() Set onSlidePositionChanged() method as a handler


of SLIDE_POSITION_CHANGED event.

onSlidePositionChanged(position) Does nothing. This method can be overridden.

setCurrentSlideIndexChangedHandler() Sets onCurrentSlideIndexChanged() method as a


handler of CURRENT_SLIDE_INDEX_CHANGED
event.

onCurrentSlideIndexChanged(slideIndex) Does nothing. This method can be overridden.

setSlideLoadingCompleteHandler() Sets onSlideLoadingComplete() method as a


handler of SLIDE_LOADING_COMPLETE event.

onSlideLoadingComplete(slideIndex) Does nothing. This method can be overridden.

setPresentationPlaybackCompleteHandler() Sets onPresentationPlaybackComplete() method as


a handler of
PRESENTATION_PLAYBACK_COMPLETE
event.

Page 247
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

onPresentationPlaybackComplete() Does nothing. This method can be overridden.

setPlaybackSuspendedHandler() Sets onPlaybackSuspended() method as a handler of


the PLAYBACK_SUSPENDED event.

setPlaybackResumedHandler() Sets onPlaybackResumed() method as a handler of


the PLAYBACK_RESUMED event.

enableAllEventHandlers() Enable all event handlers.

removeAllEventHandlers() Removes all event handlers.

setPlaybackHandler(event) Set playback handler for specified event.


The possible event parameter values are:
fsplayer.api.PlaybackController.PAUSE_PLAYBACK,
fsplayer.api.PlaybackController.START_PLAYBACK,
fsplayer.api.PlaybackController.ANIMATION_STEP_CHANGED,
fsplayer.api.PlaybackController.SLIDE_POSITION_CHANGED,
fsplayer.api.PlaybackController.CURRENT_SLIDE_INDEX_CHANGED
fsplayer.api.PlaybackController.SLIDE_LOADING_COMPLETE,
fsplayer.api.PlaybackController.PRESENTATION_PLAYBACK_COMP
fsplayer.api.PlaybackController.PLAYBACK_SUSPENDED,
fsplayer.api.PlaybackController.PLAYBACK_RESUMED.

removePlaybackHandler(event) Set playback handler for specified event.


The possible event parameter values are:
fsplayer.api.PlaybackController.PAUSE_PLAYBACK,
fsplayer.api.PlaybackController.START_PLAYBACK,
fsplayer.api.PlaybackController.ANIMATION_STEP_CHANGED,
fsplayer.api.PlaybackController.SLIDE_POSITION_CHANGED,
fsplayer.api.PlaybackController.CURRENT_SLIDE_INDEX_CHANGED
fsplayer.api.PlaybackController.SLIDE_LOADING_COMPLETE,
fsplayer.api.PlaybackController.PRESENTATION_PLAYBACK_COMP
fsplayer.api.PlaybackController.PLAYBACK_SUSPENDED,
fsplayer.api.PlaybackController.PLAYBACK_RESUMED.

See also
PlaybackControllerEvents Class
Player Class
JavaScript support in iSpring

Page 248
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

12.5 fsplayer.api.PlaybackControllerEvents Class


The PlaybackControllerEvents class exposes the following properties:
Properties

Property Type Description

PausePlaybackHandlers Object Stores array of event handlers


associated with pause playback
event.

StartPlaybackHandlers Object Stores array of event handlers


associated with start playback
event.

AnimationStepChangedHandlers Object Stores array of event handlers


associated with animation step
changing event.

SlidePositionChangedHandlers Object Stores array of event handlers


associated with slide position
changing event.

CurrentSlideIndexChangedHandlers Object Stores array of event handlers


associated with slide index
changing event.

SlideLoadingCompleteHandlers Object Stores array of event handlers


associated with slide loading is
completed event.

PresentationPlaybackCompleteHandlers
Object Stores array of event handlers
associated with presentation
playback completed event.

PlaybackSuspendedHandlers Object Stores array of event handlers


associated with presentation
playback suspended event.

PlaybackResumedHandlers Object Stores array of event handlers


associated with presentation
playback resumed event.

Page 249
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

See also
PlaybackController Class
JavaScript support in iSpring

12.6 fsplayer.api.PresentationInfo Class


The PresentationInfo class stores the presentation information and provides the following
properties:
Methods

Method Description

getTitle() Returns presentation title.

getDuration() Returns presentation duration in seconds.

getSlides() Returns the SlidesCollection object providing the


presentation content information.

getPresenters() Returns the PresentersCollection object providing the


information about presentation presenters.

See also
PresentersCollection Class
SlidesCollection Class
JavaScript support in iSpring

12.7 fsplayer.api.PresentersCollection Class


The PresentersCollection class stores the information about number of presenters in
presentation:
Methods

Method Description

getCount() Returns number of presenters in the collection.

Page 250
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

See also
PresentationInfo Class
JavaScript support in iSpring

12.8 fsplayer.api.SlideInfo Class


The SlideInfo class provides information about the particular slide of the presentation such
as title, duration, text, etc. It exposes the following methods:
Methods

Method Description

getTitle() Returns slide title.

getDuration() Returns slide duration in seconds.

getStepsCount() Returns number of slide animation steps.

isLoaded() Returns Boolean value indicating whether the slide


has been loaded completely.

See also
PresentationInfo Class
SlidesCollection Class
JavaScript support in iSpring

12.9 fsplayer.api.SlidesCollection Class


The SlidesCollection class stores the information about number of presenters in presentation:
Methods

Method Description

getSlidesCount() Returns number of slides in the presentation.

getSlideInfo(index) Returns SlideInfo class which represents an


individual presentation slide with the specified slide
index.

Page 251
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

Note: Slide index is zero-based.

See also
PresentationInfo Class
JavaScript support in iSpring

12.10 fsplayer.api.SoundController Class


The SoundController class provides sound control facilities and exposes the following
constants and methods:
Constants

Constant Type Value Description

VOLUME_CHANGED String soundListener_onSoundVolumeChanged


Defines the name of the
sound volume changed
event.

Methods

Method Description

getVolume() Returns a numeric value defining current sound


volume.
Volume is a numeric value between 0 (minimal
sound volume) and 1 (maximal sound volume).

setVolume(volume) Changes the sound volume.


The volume parameter defines a new sound volume
value which is a number between 0 (minimal
volume) and 1(maximal volume).

onSoundVolumeChanged(volume) This method is invoked when sound volume is


changed if the
SoundController.VOLUME_CHANGED event
handler is enabled. The default implementation of
this method does nothing, however you can override
it specifying your own handler funciton.

setSoundHandler(event) Enables the specified event handler.


The following event parameter values are:

Page 252
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

fsplayer.api.SoundController.VOLUME_CHANGED

removeSoundHandler(event) Disables the specified event handler.


The following event parameter values are:
fsplayer.api.SoundController.VOLUME_CHANGED

See also
Player Class
JavaScript support in iSpring

13 Support
We are trying to develop our product to the maximum ease of use. But in case you have
problems using iSpring, please first consult the documentation provided with the product and
try to find the competent answers to your questions in the iSpring FAQ base.
If your question remains unanswered, please get in touch with us through online feedback
form. We will be happy to give you our helping hand and to find a quick solution to your
request.
We appreciate any comments, concerns, kudos or critique. Share your opinion on the service
you have received when using our product. Feel free to send us your feedback at support
page on www.ispringsolutions.com. Also now you can post your questions and opinions,
exchange ideas and discuss technical issues on iSpring Community Forum.

Page 253
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

All users of iSpring are entitled to absolutely free and prompt technical support. We stop
providing 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 Technical
Support or Consulting Service and receive prompt and personalized service from the
iSpring 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.

14 iSpring solutions
iSpring Solutions provides a product line for online, desktop and server-side PowerPoint to
Flash conversion. Having years of experience in PowerPoint to Flash conversion area iSpring
engineers implements the latest researches and achievements in iSpring PowerPoint and
Flash technology.
iSpring Online
iSpring Online lets you easily publish presentations online for public or private sharing and
courses online and track viewing and e-learning activities.
register learn more
SlideBoom
SlideBoom online slide hosting portal allows you share presentations online for free or create
your own customized slidelog under PRO account.
register learn more
iSpring SDK
iSpring SDK provides effective server-side PowerPoint to Flash conversion facilities for web

Page 254
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 4.3 Guide

sites and online applications. It is optimized for multitasking processing and produces fast
batch conversion of thousands of PowerPoint presentations to high-quality Flash clips.
download learn more
ActiveSWF SDK
ActiveSWF SDK provides smart components for Flash applications development in C++,
C#, VisualBasic, ASP, PHP for .NET/COM/Win32 platforms.
download learn more

iSpring Custom Solutions


While iSpring Pro and iSpring SDK are designed to cover general customers' needs, a lot of
users would like to have extra features or additional functionality. iSpring Team provides
development services to create custom solutions tailored to the unique requirements of our
customers.
Our creative developers will implement a fully customized application based on the iSpring
Pro or iSpring SDK core. Our project manager will be in touch with you from the conception
through detailed elaboration to high quality result delivery.
Order a custom solution now!

Page 255
Copyright © 2005 iSpring Solutions, Inc. All rights reserved.

S-ar putea să vă placă și