Sunteți pe pagina 1din 165

iSpring Presenter Guide

Table of contents
1 iSpring PRESENTER Guide..............................................................................................6
1.1 iSpring PRESENTER Activation.................................................................................. 6
1.1.1 Trial version registration...........................................................................................9
1.2 Trial version limitations.............................................................................................. 10
1.3 Getting started with iSpring PRESENTER................................................................. 12
1.4 Product Features.......................................................................................................... 13
1.4.1 iSpring PRESENTER key features......................................................................... 13
1.4.2 Animation Effects Support......................................................................................14
1.4.3 Slide Transitions Support........................................................................................18
1.5 Publish presentation.....................................................................................................19
1.5.1 Publish to Flash Window........................................................................................ 19
1.5.1.1 Destination options.............................................................................................19
1.5.1.2 Publish Presentation to My Computer................................................................20
1.5.1.3 Publish Presentation to SlideBoom.................................................................... 21
1.5.1.4 Publish Presentation to Web/FTP.......................................................................22
1.5.1.5 Send Presentation via E-Mail............................................................................. 26
1.5.2 Publish to Flash Window - General Tab.................................................................27
1.5.3 Publish to Flash Window - Settings Tab.................................................................30
1.5.4 Publish to Flash Window - Media Tab................................................................... 35
1.5.5 Publish to Flash Window - SCORM Tab............................................................... 37
1.6 iSpring Players.............................................................................................................39
1.7 Presentation management............................................................................................40
1.7.1 Presentation Explorer..............................................................................................40
1.7.1.1 Multilevel Navigation.........................................................................................41

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


iSpring Presenter Guide

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


1.7.1.3 Slide Title........................................................................................................... 42
1.7.1.4 Presenters............................................................................................................42
1.7.1.5 Playback mode....................................................................................................42
1.7.1.6 Slide duration......................................................................................................42
1.7.1.7 Media - Audio.....................................................................................................43
1.7.1.8 Media - Video.....................................................................................................43
1.7.1.9 Media - Quiz.......................................................................................................43
1.7.2 Links....................................................................................................................... 44
1.7.2.1 Links - References Tab.......................................................................................44
1.7.2.2 Links - Web Links.............................................................................................. 47
1.7.3 Presenters................................................................................................................ 49
1.7.3.1 Presenters manager - Presenters Tab.................................................................. 49
1.7.3.2 Presenter manager - Company Tab.................................................................... 52
1.8 Narration......................................................................................................................54
1.8.1 Audio Recording..................................................................................................... 54
1.8.2 Video Recording..................................................................................................... 56
1.8.3 Audio Importing......................................................................................................57
1.8.4 Video Importing......................................................................................................60
1.8.5 Synchronization...................................................................................................... 62
1.9 Insert............................................................................................................................ 63
1.9.1 Insert Flash..............................................................................................................63
1.9.2 Insert quiz................................................................................................................64
1.9.2.1 QuizBuilder........................................................................................................ 64
1.9.2.2 QuizBuilder - Settings........................................................................................ 69
1.9.2.2.1 Main............................................................................................................... 69
1.9.2.2.2 Question Defaults...........................................................................................71
1.9.2.2.3 Feedback........................................................................................................ 73
1.9.2.2.4 Result............................................................................................................. 74

Page 2
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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


1.10 ActionScript API References.....................................................................................78
1.10.1 iSpring ActionScript API...................................................................................... 78
1.10.1.1 Presentation conversion modes overview.........................................................78
1.10.1.2 Presentation playback control facilities............................................................ 81
1.10.1.3 Slide playback control facilities........................................................................82
1.10.1.4 Skin development facilities...............................................................................82
1.10.2 iSpring Presentation structure............................................................................... 82
1.10.2.1 Presentation assets............................................................................................ 83
1.10.2.2 Player core module........................................................................................... 83
1.10.2.3 Skin module...................................................................................................... 84
1.10.2.4 References.........................................................................................................85
1.10.3 Flash Presentation ActionScript API.....................................................................85
1.10.3.1 Flash Presentation ActionScript API Reference...............................................85
1.10.3.2 fsplayer.api.CPresentationLoader Class........................................................... 88
1.10.3.3 fsplayer.api.IAnimationStep Interface.............................................................. 89
1.10.3.3.1 Remarks........................................................................................................90
1.10.3.4 fsplayer.api.IAnimationSteps Interface............................................................ 91
1.10.3.5 fsplayer.api.ICompanyInfo Interface................................................................ 92
1.10.3.6 fsplayer.api.ICompanyLogo Interface.............................................................. 93
1.10.3.7 fsplayer.api.ICompanyLogoLoadingListener Interface....................................94
1.10.3.8 fsplayer.api.IPlaybackListener Interface.......................................................... 95
1.10.3.9 fsplayer.api.IPlayer Interface............................................................................ 97
1.10.3.9.1 Remarks........................................................................................................99
1.10.3.10 fsplayer.api.IPlayerListener Interface........................................................... 100
1.10.3.11 fsplayer.api.IPresentationInfo Interface........................................................ 101
1.10.3.12 fsplayer.api.IPresentationPlaybackController Interface................................102
1.10.3.13 fsplayer.api.IPresenterInfo Interface............................................................. 105
1.10.3.14 fsplayer.api.IPresenterPhoto Interface.......................................................... 106

Page 3
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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


1.10.3.15 fsplayer.api.IPresenterPhotoLoadingListener Interface................................106
1.10.3.16 fsplayer.api.IReferenceInfo Interface............................................................107
1.10.3.17 fsplayer.api.IReferencesCollection Interface................................................ 107
1.10.3.18 fsplayer.api.ISlideInfo Interface....................................................................108
1.10.3.18.1 Remarks.................................................................................................... 109
1.10.3.19 fsplayer.api.ISlidesCollection Interface........................................................ 109
1.10.3.20 fsplayer.api.ISlideThumbnail Interface.........................................................109
1.10.3.20.1 Remarks.................................................................................................... 110
1.10.3.21 fsplayer.api.ISlideThumbnailLoadingListener Interface.............................. 110
1.10.3.22 fsplayer.api.ISoundController Interface........................................................111
1.10.3.22.1 Remarks.................................................................................................... 112
1.10.3.23 fsplayer.api.ISoundListener Interface........................................................... 112
1.10.3.24 fsplayer.api.IThumbnailsCollection Interface...............................................113
1.10.3.25 ActionScript 3 and Flex 2 support................................................................ 114
1.10.3.25.1 ActionScript 3 and Flex support in iSpring.............................................. 114
1.10.3.25.2 iSpring.as3bridge.AnimationStep Class................................................... 122
1.10.3.25.3 iSpring.as3bridge.AnimationSteps Class................................................. 124
1.10.3.25.4 iSpring.as3bridge.BridgeEvent Class....................................................... 125
1.10.3.25.5 iSpring.as3bridge.BridgeLoader Class..................................................... 131
1.10.3.25.6 iSpring.as3bridge.PlaybackController Class............................................ 131
1.10.3.25.7 iSpring.as3bridge.Player Class................................................................. 135
1.10.3.25.8 iSpring.flex.PresentationContainer Class................................................. 136
1.10.3.25.9 iSpring.as3bridge.PresentationInfo Class.................................................137
1.10.3.25.10 iSpring.as3bridge.PresenterInfo Class.................................................... 138
1.10.3.25.11 iSpring.as3bridge.ReferenceInfo Class...................................................139
1.10.3.25.12 iSpring.as3bridge.ReferencesCollection Class....................................... 139
1.10.3.25.13 iSpring.as3bridge.SlideInfo Class...........................................................140
1.10.3.25.14 iSpring.as3bridge.SlidesCollection Class............................................... 141

Page 4
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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


1.10.4 Skin Development Reference..............................................................................143
1.10.4.1 Skin development........................................................................................... 143
1.10.4.2 fsplayer.ui.skins.ISkin Interface..................................................................... 145
1.10.4.2.1 Remarks......................................................................................................146
1.10.4.2.2 Samples...................................................................................................... 146
1.10.4.3 fsplayer.ui.skins.ISkinListener Interface........................................................ 148
1.10.4.4 fsplayer.ui.skins.ISlideShowWindow Interface..............................................149
1.10.5 Flash Slide ActionScript API.............................................................................. 149
1.10.5.1 Flash Slide ActionScript API Reference........................................................ 149
1.10.5.2 slideplayer.api.IHyperlinksManager Interface............................................... 151
1.10.5.3 slideplayer.api.IPlaybackController Interface................................................ 154
1.10.5.4 slideplayer.api.IPlaybackListener Interface....................................................157
1.10.5.5 slideplayer.api.ISlideController Interface.......................................................158
1.10.5.6 slideplayer.api.ISoundController Interface.....................................................160
1.11 Support.....................................................................................................................162
1.12 iSpring solutions...................................................................................................... 164

Page 5
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1. iSpring PRESENTER Guide

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

To register and activate your iSpring PRESENTER 4.1:


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

Page 6
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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.

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

Page 7
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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.

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 8
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1.1.1. Trial version registration


To register your free 30-days trial license, 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 9
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1.2. 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 10
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

Page 11
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

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 12
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1.4. Product Features

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


187 of 205 PP 2003/2007 animation effects Embedded Flash movies
All PowerPoint 2003/2007 slide transitions AVI/WMV/MPG/MP4 video clips
Vector representation of standard PPT objects MP3, WAV and WMA audio
"Auto-reverse" and "Rewind at end" options new Background audio for a slide
Slide Masters with interactive elements Background audio for a presentation
Animations by words and letters Sounds for animation effects
Hidden slides support Sounds for slide transitions
Right-to-Left languages Animation and sound synchronization
Custom slideshows new Stop transition sound new
Slide notes styles new

Flash Movie Tuning Features

Appearance & Playback Flash based Player


Multilevel presentation structure 10 Flash player templates new
Solid/Separate/Standalone Flash movie Customizable design, layout & color scheme
Allowing playback in set domain only Presenter video
Flash context menu disabling Live preview before publishing
Looped Flash presentation playback Advanced Glossy Player new
Flash movie autostart control Ink Annotation tools
Flash movie preloader Multilevel navigation
Flash banner skin

Advanced Features

Presentation enhancement Flash movie programmatic control


QuizBuilder ActionScript API updated
Presentation Manager updated All presentation info via ActionScrip API new
Multiple Presenters & Company logos new ActionScript 3 connector integration new
SCORM compliant content Interaction with JavaScript new

Audio & video narrations


Recording audio narrations
Recording video narrations

Page 13
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

Audio, video & presentation sync

Publishing and Delivery Features

Destination Quality and Compression control


All slides/Selected slides "Smart" compression
Possible destinations Compression presets
Local folder at My Computer Audio & Video bitrate control
Sharing at SlideBoom JPEG and PNG image compression
Web site via remote FTP server
E-mail
SCORM compliant LMS
Output formats
Flash file (.SWF)
.EXE file - no Flash Player required
HTML page
ZIP archive

1.4.2. 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 14
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

Page 15
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

Emphasis Effects Motion Paths

Page 16
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

Page 17
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1.4.3. 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 18
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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

1.5. Publish presentation

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

1.5.1.1. Destination options


There are three 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
to a folder on your local computer or network share.
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
Settings - appearance, navigation, size and scale parameters for output Flash movie
Media - compression options for images, audio and video files
SCORM - settings for your learning-course
Should you have any questions about iSpring PRESENTER click the link Ask your 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.

Page 19
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1.5.1.2. Publish Presentation to My Computer


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

To publish presentation on local computer or network share:


1. Type the name for your output Flash movie next to the Presentation Title field.
2. Specify a local folder or a network share to which you want to save the presentation next
to the Destination Folder field:
type the path to the destination folder manually, or
click the "Browse" button on the right of Destination Folder field, browse for the
folder, select it and click Ok.

Page 20
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

1.5.1.3. Publish Presentation to SlideBoom


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

To upload your presentation:


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

Page 21
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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

1.5.1.4. 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 22
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 23
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

Page 24
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 25
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1.5.1.5. Send Presentation via E-Mail


If you want to send your presentation, select Send via E-Mail option. A new e-mail with 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.
Back to Top

Page 26
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1.5.2. Publish to Flash Window - General Tab


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

General

Presentation Title A title for your Flash presentation which will


display in Player.

Destionation A local folder, SlideBoom portal, FTP Address or


e-mail depending on where you want to store
your Flash presentation.

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

Page 27
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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.

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

Page 28
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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 provides basic navigation options to control
Flash presentation playback.
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.
Navigation + Marker provides you with basic
navigation elements and Marker tool with

Page 29
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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 new
Advanced Matte Skin updated
Crystal Skin
Classic Skin
Navigation panel
Navigation + Marker.

Customize You can customize the Advanced Glossy,


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

1.5.3. Publish to Flash Window - Settings Tab


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

Page 30
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

Settings | Flash movie

Size Width and height of output Flash presentation.

Scale The number for the 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.
Settings | Flash movie

Flash Movie Frame rate The number of Flash frames per second. Small
values are not recommended because this can
cause flickering when playing animations.

Page 31
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

Background color You can set a background color and your


changes will apply to the whole presentation.
Double click on the current color next to this
option will open a standard window where you
can select a 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 your
end viewers to print your 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.

Allow playback in the following domains only 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.

Enable interaction with JavaScript If the 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 used.

Settings | Playback and Navigation

Add Preloader This option adds a preloader to Flash

Page 32
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

presentation which shows a progress of the


Flash presentation loading.

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

Change all slides automatically If this option is checked slides in 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:
Page Up: transition to the previous slide
Page Down: advance to the next slide
Left: rewind
Right: fast forward
Up: increase volume
Down: decrease volume
Space: play/pause
Home: restart current slide
End: stop at the end of the current slide
Ctrl+Home: move to the first slide
Ctrl+End: move to the last slide
Backspace: return to the last viewed slide
Enter: move to the next animation step
Shift+Enter: return to the previous animation
step

Looped playback If selected, your presentation will automatically


start from the beginning after the last slide is

Page 33
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

completed. This feature is essential for creation


of Flash banners and trade shows.

Page 34
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1.5.4. 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 35
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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.

Detach media content

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

Embedded Flash movies If you check this option, your presentation and
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

Page 36
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

separate file and your Flash presentation will


load faster.

1.5.5. Publish to Flash Window - SCORM Tab


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

LMS Settings | Version

Version Select SCORM version for you training course.


Learn more about SCORM version features and
differences from Wikipedia.

Page 37
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

LMS Settings | Information

Course title The name for your training course.

Lesson title The name for your lesson.

Description Type here the brief description of your training


course.

Keywords Specify keywords for your LMS. They will help


people to find your training course by this
keywords.

LMS Settings | Options

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

Duration The time allocated to the lesson. It is implied


that during the time set students would learn the
lesson well.

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

Page 38
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1.6. iSpring Players


iSpring PRESENTER can wrap output presentation into Flash based Player. Current version
includes 9 different players, 5 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. You can find detailed description of how you can customize the player creating
unique appearance and keeping handy navigation of your Flash presentation.
Advanced Glossy nuw
Advanced Matte updated
Crystal Player
Classic Player
Navigation panel
Navigation + Marker
The other Banner, Lite and None players are not customizable. Navigation + Notes player
can only adjoin left or right side of the presentation.

Page 39
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1.7. Presentation management

1.7.1. 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 40
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

1.7.1.2. Hidden Slides


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

Page 41
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

slides hyperlinks or action buttons.

1.7.1.3. Slide Title


Titles of slides are shown in the Outline tab of Advanced, Crystal and Classic Players. 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.

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

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

1.7.1.6. Slide duration


You can set timing for automatic advance on the right of changing mode icon.
Note: Slide advance time also depends on "Minimal slide duration" that can be managed 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.
Note: the option to insert quizzes and videos into a slide is available only in iSpring Presenter
Master Edition.
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
Presenter.

Page 42
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1.7.1.7. Media - Audio


iSpring Presentation Explorer lets you import audio narration to the selected slide.
To add an audio:
1. Click the Import audio narration icon to launch the Windows Explorer.
2. Choose the audio you would like to insert. iSpring Presenter supports .MP3, .WMA and
.WAV audio file formats.
Selected audio track starts playback automatically. To disable this option uncheck 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.
1.7.1.8. Media - Video
iSpring Presentation Explorer lets you import video narration to the selected slide.
To insert video to the selected slide click the Import video narration icon and choose 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.

1.7.1.9. Media - Quiz

Page 43
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

iSpring Presentation Explorer lets insert quizzes into PowerPoint slides via quiz editing
buttons. Please refer to QuizBuilder documentation to learn more about QuizBuilder
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.

1.7.2. Links

1.7.2.1. 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:

Page 44
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1. Click the Links button on the iSpring toolbar.


2. Presentation Links window will launch. All references added to a presentation are
accessible in the References tab.

To open a selected reference in a new browser window, check the box New Window. 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

Page 45
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1. Click Links on iSpring toolbar, Presentation Links window will open.


2. Click the Add Web Reference button at the bottom of the window opened.

3. Enter a Title for a web link. It will display in the Reference screen of the player.
4. Enter a web address of the web page, blog or other web resource. The URL field is
prefilled with "http//:", please don#t omit this part of URL in your link.
5. Check "Open in new browser" window option to if you want to open each web
reference in a new browser window.
6. When you finished with your settings, click Ok to save a reference. To exit without
saving changes, click Cancel.
To add a File Attachment
1. Click Links on iSpring toolbar, Presentation Links window will launch.
2. Click the Add File Attachment button at the bottom of the window opened.
3. The Explorer window is automatically launched. Find and select the file you want to add
and click Open.

Page 46
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

4. Add File Attachment window will be opened and prefilled with descriptions of the file
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.

1.7.2.2. 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 47
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 48
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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.

1.7.3. Presenters

1.7.3.1. Presenters manager - Presenters Tab


Presenters Tab allows you to add, edit or delete presenters and set up a default presenter 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
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.

Page 49
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

Page 50
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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.

You can enter the following info about presenter:


Presenter info

Name The first and the last name of the presenter.

Page 51
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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.

1.7.3.2. 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 52
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

To add info about your company:

Page 53
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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.

1.8. Narration

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

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

Page 54
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

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

Page 55
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

1.8.2. 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:
1. Click Record Video to in the Narration area in your iSpring toolbar to launch Narration
Record Video window

Page 56
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

Right arrow button Click to go to the next slide

1.8.3. Audio Importing


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

Page 57
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

Page 58
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 59
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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.

1.8.4. 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 60
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 61
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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.

1.8.5. 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 62
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

narration window.

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

Drop-down list Choose the slide you want to synchronize

Start sync/ 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

1.9. Insert

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

Page 63
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

1.9.2. Insert quiz

1.9.2.1. QuizBuilder

Page 64
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 65
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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.

Fill in the Blank A student should enter an answer


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

Page 66
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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.

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

Page 67
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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


Select the question in the QuizBuilder window.
Click Add Image/Add Audio button and browse for a picture/an audio file
To remove added image/audio:
Select the question in the QuizBuilder window.
Click Delete to remove existing image/audio.

ANSWER area

Answer

Add Click to add an extra answer

Delete Click to remove the answer

Page 68
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

Move Up Click to move the answer up

Move Down Click to move the answer down

OPTIONS area

Options

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

Attempts Specify the number of attempts possible

Points Specify the number of points given for a 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 QuizBuilder is easy to customize. It is featuring various settings options as managing


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

1.9.2.2. QuizBuilder - Settings

Main

Page 69
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 70
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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

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 71
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 72
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 73
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 74
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

Result

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

Allow user to email result Tick this checkbox to allow quiz results emailing
NOTE: If this option is ticked, an authorization is
asked when starting the quiz

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

Page 75
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

Display user score Tick this checkbox to allow the display of the quiz
takers 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)

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 76
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

Player Customization

Color Color iSpring QuizBuilder 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 77
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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

1.10. ActionScript API References

1.10.1. iSpring ActionScript API


iSpring products provide PowerPoint to Flash conversion facilities on the highest level.
Moreover, Flash content created with iSpring Presenter and iSpring SDK 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

1.10.1.1. Presentation conversion modes overview


iSpring can convert PowerPoint presentations into one of the three following formats:
1. A Solid Flash Presentation. This is one solid Flash file containing player core, skin,
preloader and presentation resources. Solid Flash presentation is the most compact 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

Page 78
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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.

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 79
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 80
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

Standalone Slide Structure

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

1.10.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.
Flash Presentation ActionScript API Reference

Page 81
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

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

1.10.2. iSpring Presentation structure


Each iSpring generated Flash presentation consists of the following parts.
Presentation assets
Player core module
Skin module
iSpring presentation structure is shown in the following diagram.

Page 82
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1.10.2.1. Presentation assets

Presentation assets are various multimedia resources containing within the presentation.
When a presentation is a solid Flash movie file, all resources are stored within this 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.

1.10.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 83
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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.

1.10.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 84
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1.10.2.4. References
IPlayer Interface
ISkin Interface
Skin development
Flash Presentation ActionScript API Reference

1.10.3. Flash Presentation ActionScript API

1.10.3.1. Flash Presentation ActionScript API Reference


Solid and compound Flash presentations generated with iSpring contain the player 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.

Page 85
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

Flash Presentation ActionScript API diagram

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

CPresentationLoader Simplifies Flash presentation loading and provides


access to its IPlayer interface.

IAnimationStep Provides the information about animation step timing

IAnimationSteps Stores a collection of the slide animation steps

ICompanyInfo Provides the information about company

Page 86
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

ICompanyLogo Provides the information about company logotype

ICompanyLogoLoadingListener Receives company logo loading event notifications

IPlaybackListener Receives presentation playback event notifications

IPlayer Provides an access to the presentation playback core

IPlayerListener Receives player initialization event notifications

IPresentationInfo Provides an access to the presentation information

IPresentationPlaybackController Provides presentation navigation and 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

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

Page 87
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

IThumbnailsCollection Stores a collection of thumbnails

See also
iSpring presentation structure
iSpring ActionScript API

1.10.3.2. 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 88
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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

1.10.3.3. 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 89
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 90
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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

1.10.3.4. fsplayer.api.IAnimationSteps Interface


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

Method Description

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

getDuration():Number Returns the total duration of animation steps 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 91
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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

1.10.3.5. fsplayer.api.ICompanyInfo Interface

Page 92
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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

1.10.3.6. 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 93
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

ICompanyInfo Interface
ICompanyLogoLoadingListener Interface
Flash Presentation ActionScript API Reference

1.10.3.7. 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 94
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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

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

Page 95
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

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);
}
function onPresentationPlaybackComplete():Void
{
trace("Presentation playback has been completed");
}
function onAnimationStepChanged(stepIndex:Number):Void
{
trace("Animation step index has been changed to " + stepIndex);

Page 96
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

}
}

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);
}

See also
IPresentationPlaybackController Interface
Flash Presentation ActionScript API Reference

1.10.3.9. fsplayer.api.IPlayer Interface

Page 97
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

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.

Page 98
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

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 cheme settings:


primaryColor (String) - this property is obsolete and must not be used in new skins
appearance (Object) - appearance settings:
fullScreen (String) - determines whether player window is opened full screen ("1") or
not
playback (Object) - playback settings:
autoStart (String) - determines whether the player starts presentation playback
automatically ("1" or undefined) or not
webLinks (Object) - the set of external web links related to the presentation:
slideAreaLink (Object) - web link related to the slide area
href (String) - web page reference, e.g. "http://www.ispringsolutions.com"
target (String) - target window, e.g. "_self", "_blank", "_parent" or custom
window name
presentationEndLink (Object) - web link related to the presentation finish event
href (String) - web page reference, e.g. "http://www.ispringsolutions.com
target (String) - target window, e.g. "_self", "_blank", "_parent" or custom
window name

See also
IPlayerListener Interface

Page 99
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

IPresentationPlaybackController Interface
ISoundController Interface
IPresentationInfo Interface
ISkin Interface
Flash Presentation ActionScript API Reference

1.10.3.10. fsplayer.api.IPlayerListener Interface


The IPlayerListener interface is used to receive the notification that the player has 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
}
// ...
}

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

Page 100
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

1.10.3.11. fsplayer.api.IPresentationInfo Interface


The IPresentationInfo Interface provides the following methods about the presentation:
Methods

Method Description

getTitle():String Returns presentation title

getSlides():ISlidesCollection Returns ISlidesCollection interface 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

Page 101
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

hasReferences():Boolean Indicates whether the presentation contains


references

getReferences():IReferencesCollection Returns the IReferencesCollection interface


providing the information about presentation
references

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

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

Page 102
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

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

Page 103
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

Page 104
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

See also
IPlaybackListener Interface
IPlayer Interface
Flash Presentation ActionScript API Reference

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

See also
IPresentationInfo Interface
IPresenterPhoto Interface

Page 105
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

Flash Presentation ActionScript API Reference

1.10.3.14. fsplayer.api.IPresenterPhoto Interface


The IPresenterPhoto interface allows to load presenter photo.
Methods

Method Description

load(target:MovieClip, 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

1.10.3.15. fsplayer.api.IPresenterPhotoLoadingListener Interface


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

Page 106
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

See also
IPresenterPhoto Interface
Flash Presentation ActionScript API Reference

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

1.10.3.17. fsplayer.api.IReferencesCollection Interface


The IReferencesCollection Interface provides the following methods for retrieving the
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

Page 107
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

IReferenceInfo Interface
IPresentationInfo Interface
Flash Presentation ActionScript API Reference

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

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)

Page 108
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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


remarks section)

Remarks

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

1.10.3.19. 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
index.
Note: Slide index is zero-based

See also
IPresentationInfo Interface
ISlideInfo Interface
Flash Presentation ActionScript API Reference

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

Page 109
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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,
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

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

Page 110
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

1.10.3.22. fsplayer.api.ISoundController Interface


The ISoundController Interface provides the following methods for sound control.
Methods

Method Description

addListener(listener:ISoundListener):Void Adds an external object 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

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


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

Page 111
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

1.10.3.23. fsplayer.api.ISoundListener Interface


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

Method Description

Page 112
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

1.10.3.24. 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
The IThumbnailsCollection interface is mainly used for the development of custom skins
supporting thumbnails.
See also

Page 113
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

ISlideThumbnail Interface
IPresentationInfo Interface
Flash Presentation ActionScript API Reference

1.10.3.25. ActionScript 3 and Flex 2 support

ActionScript 3 and Flex support in iSpring

This article describes the way of the iSpring generated presentations communication 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 + "!");
}
lc.connect("connectionName");

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

Page 114
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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");

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.

Page 115
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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 116
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 117
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 118
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 119
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

ActionScript 3 example

Adobe Flex communication demo

Page 120
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

Flex example

References

AnimationStep Class
AnimationSteps Class
BridgeEvent Class
BridgeLoader Class
PlaybackController Class
Player Class
PresentationContainer Class

Page 121
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

PresentationInfo Class
PresenterInfo Class
ReferenceInfo Class
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 122
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 123
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

stepStartTimei+1 = pauseStartTimei

See also
AnimationSteps Class
ActionScript 3 and Flex support in iSpring

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
There are 4 animation effects in the following slide. They are represented by 3 animation

Page 124
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

iSpring.as3bridge.BridgeEvent Class

Page 125
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 126
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 127
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 128
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 129
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 130
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

See also
PlaybackController Class
Player Class
SlideInfo Class
SoundController Class
ActionScript3 and Flex support in iSpring

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

iSpring.as3bridge.PlaybackController Class

Page 131
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 132
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 133
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 134
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 135
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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
ActionScript 3 and Flex support in iSpring

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"
height="524" x="10" y="36">

Page 136
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

</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
ActionScript 3 and Flex support in iSpring

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

references ReferencesCollection Returns the ReferencesCollection

Page 137
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

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

email String Presenter e-mail address

Page 138
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

webSite String Presenter Web site address

See also
PresentationInfo Class
ActionScript 3 and Flex support in iSpring

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

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

Methods

Method Description

Page 139
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

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

notesText String Slide notes text

startTime Number Slide start time within presentation


timeline

Page 140
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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)

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
AnimationSteps Class
SlidesCollection Class
ActionScript 3 and Flex support in iSpring

iSpring.as3bridge.SlidesCollection Class

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 141
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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

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
flash.events.EventDispatcher Class
ActionScript 3 and Flex support in iSpring

Page 142
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

1.10.4. Skin Development Reference

1.10.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 143
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 144
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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

1.10.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 145
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 146
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 147
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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

1.10.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 148
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

See also
ISkin Interface
Skin development

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

1.10.5. Flash Slide ActionScript API

1.10.5.1. Flash Slide ActionScript API Reference


Each Standalone Flash slide created with iSpring contain a small slide controller. This is 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

Page 149
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

This API is accessible via the getSlideController() function on the root MovieClip of each
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

IHyperlinksManager Provides slides with ability to handle hyperlinks to


other slides and external web pages

IPlaybackController

Page 150
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

IPlaybackListener

ISlideController Provides an access to the slide core

ISoundController

See also
IHyperlinksManager Interface
IPlaybackController Interface
IPlaybackListener Interface
ISlideController Interface
ISoundController Interface

1.10.5.2. slideplayer.api.IHyperlinksManager Interface


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

Page 151
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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;
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());

Page 152
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

} while ((lastViewedSlide == curSlide) &&


(m_viewedSlides.length != 0));
if (lastViewedSlide != curSlide)
{
gotoSlide(lastViewedSlide);
}
else
{
m_viewedSlides.push(curSlide);
}
}
}
function endShow():Void
{
fscommand("quit", "true");
}
}

CMyHyperlinksManager class usage example:

import slideplayer.api.*;
System.security.allowDomain("*");
var rootMC:MovieClip = this;
var slidesMC:MovieClip = rootMC.createEmptyMovieClip("slidesMC", 2);
var slideMC1:MovieClip = slidesMC.createEmptyMovieClip("slide1", 1);
var g_slideController:ISlideController;
var g_hyperlinksManager:CMyHyperlinksManager = new CMyHyperlinksManager();
g_hyperlinksManager.loadSlide = function(slideIndex:Number):Void
{
loadSlide(slideIndex);
}
g_hyperlinksManager.gotoSlide(0);
// loads slide with the specified slide 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();

Page 153
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

slideController.setHyperlinksManager(g_hyperlinksManager);
}

Demo
The following demo illustrates hyperlinks and action buttons handling via
IHyperlinksManager interface.

See also
ISlideController Interface
Flash Slide ActionScript API Reference

1.10.5.3. slideplayer.api.IPlaybackController Interface


The IPlaybackController interface provides methods for slide playback control. This

Page 154
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

interface can be obtained by calling getPlaybackController() method on ISlideController


interface.
The IPlaybackController interface exposes the following methods:
Methods

Method Description

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

Page 155
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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


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 156
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

References
IPlaybackListener Interface
ISlideController Interface
Flash Slide ActionScript API Reference

1.10.5.4. 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 157
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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

1.10.5.5. 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 158
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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

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 159
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

See also
IHyperlinksManager Interface
IPlaybackController Interface
ISoundController Interface
Flash Slide ActionScript API Reference

1.10.5.6. slideplayer.api.ISoundController Interface


The ISoundController Interface provides the following methods for sound control.
Methods

Page 160
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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 161
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

See also
ISlideController Interface
Flash Slide ActionScript API Reference

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

Page 162
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

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 163
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter 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.

1.12. iSpring solutions


iSpring Solutions provides a product line for desktop and server-side PowerPoint to Flash
conversion. We have years of experience in PowerPoint to Flash conversion area. iSpring
products implement our latest researches and achievements in PowerPoint and Flash
technology.

iSpring SDK
iSpring SDK provides effective server-side
PowerPoint to Flash conversion facilities for web
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 |

purchase | learn more...

ActiveSWF SDK

Page 164
Copyright 2005-2009 iSpring Solutions, Inc. All rights reserved.
iSpring Presenter Guide

ActiveSWF SDK provides smart components for


Flash applications development in C++, C#,
VisualBasic, ASP, PHP for .NET/COM/Win32
platforms.

download |

purchase | 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!

If you are interested in a custom solution or need more information about the products and
service, visit iSpring web site and feel free to e-mail us to

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

S-ar putea să vă placă și