Tutorix Player User Manual

 

Version 2.0 / 01/25/2004

 

Copyright © 2002 – 2004 Mindleads Technology


Contents

 

Copyright 3

Document Conventions 4

Icons 4

Typographic Conventions 4

Preface. 5

Tutorix Player System Requirements 6

Hardware. 6

Software. 6

Install Tutorix. 7

Install from CD-ROM.. 7

Install from Installation File (Download) 7

Installation Process 8

Application of Tutorix. 16

Getting started. 16

General 16

Play Tutorials 17

Printing Tutorials 19

Short Description of Tutorial 20

Extended Tutorial Settings of Tutorix Player 21

Select Agent 21

Define Default Agent 21

Define Tutorial as Foreground Application. 22

Maximize Tutorial Window. 22

Disable Speech Output 22

Disable Sound Effects 22

Disable Animations 23

Synchronize Speech Output with Bubble. 23

Technical Information. 24

Command Line Parameters 24

Required Files 25

Registry Settings 26

Support codes and their Significance. 28

 

Copyright

 

Copyright © 2002 - 2004 Mindleads Technology. All rights reserved.

 

No part of this documentation may be stored in a retrieval system, transmitted or reproduced in any way, except in accordance with the terms of the applicable software license agreement. This documentation contains proprietary information of Mindleads Technology and / or its suppliers.

 

Software products of Mindleads Technology or its sales companies may contain software components of other software producers.

 

Microsoft®, Windows®, NT® are registered trademarks of Microsoft Corporation.

 

Microsoft Agent 2.0 (MS Agent) is a technology of Microsoft Corporation.


Document Conventions

Icons

 

Icon                            Meaning

 

Note

Caution

Hint

 

Typographic Conventions

 

Type Style                  Description

 

Example text

Characters or words cited according to the user interface.

Example text

Symbolizes an exact user input, involving file and folder names, as well as variable or parameter names.

<Example text>

Characterizes a variable user input. Characters or words in pointed brackets are to be replaced in the program by the user through appropriate entries.

 


Preface

 

Today, transfer of knowledge becomes increasingly important. Business processes rapidly change, infrastructures are constantly being modernized – additional knowledge and new skills are needed and must be accessible to employees in the fastest and most efficient manner. Classical schooling or generic training manuals are in today’s economical growing demands barely sufficient. Tutorix sets the pattern for new measures in the area of electronic learning (e-learning), be it to indoctrinate users in new software applications or to make business processes accessible to employees in company wide interactive form.

Tutorix is suitable for continuous studies, as well as initial training for the implementation of new software solutions.

 

What is Tutorix?

 

Tutorix is an innovative and modern tool, which helps you to create interactive self learning units called tutorials and make them available to your employees. Your employees aren’t completely alone: By using a Tutorix compiled learning unit (tutorial), you will be guided through the entire learning process with a simulated intelligent agent. With the tutorials your employees will become familiar with new applications and business processes in the easiest fashion. All workflows may be independently simulated, without actual learning tools being installed on the employees PC, hence only relevant schooling information will be passed on.

 

Tutorix offers various options for the preparation and distribution of know how corporation wide and amends in an ideal way the concept of training of your corporation.

 

A possible use for the Tutorix generated tutorials is the indoctrination of operation of a new software or an appointed work process without the help of a human instructor. For the education of a software product it need not be actually installed by the user of the tutorial, Tutorix makes the surface of a software visible for all users through screenshots.

 

You will find an example of this on the enclosed CD-ROM, on which the operation of Tutorix, with help of a tutorial, can be easily learned. If you have downloaded Tutorix from the internet, you will find additional tutorials for applications of Tutorix under http://www.mindleads.com

 

A tutorial may be sent via email to all users of a PC or it may be made available over the network to a variety of users. The tutorials may be used at work, as well as at home or en route with a laptop. The user could learn at his own pace and repeat the units as often as required. The prerequisite for playback of tutorials is only the installation of the Tutorix Player software on the users computer.


System Requirements

Hardware

 

The following hardware equipment is necessary for installation and use of Tutorix software:

 

Minimum:

 

  • Pentium or similar Processor 200 MHz
  • 32 MB of RAM for Windows 95/98/ME
  • 64 MB  of RAM for Windows NT/2000/XP
  • 30 MB free disk space for installation
  • 80 MB free disk space for the use of Tutorix Player
  • CD-ROM drive, if you install Tutorix by CD-ROM
  • Display resolution of 800 x 600 pixels, 256 colors

 

Recommended:

 

  • Pentium or similar Processor >500 MHZ
  • 64 MB of RAM for Windows 95/98/ME
  • 128 MB of RAM for Windows NT/2000/XP
  • 40 MB free disk space for installation
  • > 1 GB free disk space for the use of Tutorix Player
  • Soundcard for speech output
  • CD-ROM drive, if you install Tutorix by CD-ROM
  • Display resolution of 1024 x 768 pixels, 65536 colors

 

 

Software

 

Tutorix runs on following operating systems:

 

  • Microsoft Windows 95 B or higher (OSR-2 Release)
  • Microsoft Windows 98
  • Microsoft Windows 98 Second Edition
  • Microsoft Windows Millenium Edition (Windows ME)
  • Microsoft Windows NT 4.0 (SP6 or higher required)
  • Microsoft Windows 2000
  • Microsoft Windows XP
  • Microsoft Windows 2003 Server

 

 

 

Windows NT4 / 2000 / XP / 2003 require computer administrator rights for installation.


Install Tutorix

 

In general, the installation process runs without interruption. Depending upon the version of your operating system, it may be necessary to update some system components. The installation program automatically detects the required system components and downloads them from the internet if necessary. If you do not have access to the internet, please contact the support team of Mindleads Technology.

Install from CD-ROM

  • Close all windows and/or programs. Insert the Tutorix Player CD-ROM.

 

  • Wait until the Tutorix installation software starts. Depending upon your hardware equipment this process can take from a few seconds up to one minute.

 

Install from Installation File (Download)

 

  • Double click the file TutorixPlayer20EN.exe.

 

  • Wait until the Tutorix installation software starts. Depending upon your hardware equipment, this process can take from a few seconds up to one minute.

 

 

 

 

 

 

 

 

 

 

 

The installation software is able to detect previous versions of Tutorix. Upon detecting an existing installation of an older version, an update will be initiated.

 

Before a new installation can be done, you must quit Tutorix software. If Tutorix Editor or Tutorix Player is running on your system, close both programs before you continue with a new installation.

 


Installation Process

 

1.     The window below appears. Click Next to start the installation process.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 



2.     Carefully read the license agreement and select I accept the terms in the license agreement if you agree to the license conditions.

 

Click Next to continue.

 

 

 

 

 



3.     Enter your full name and organization in the text boxes User Name and Organization.

 

In general, Tutorix software is installed for all users. Choose Only for me if you want to install Tutorix only for the currently logged on user. This provides program icons in the start menu that are not visible for other users.

 

Click Next to continue.

 

 

 

 

 



4.     You can change the directory in which Tutorix Player will be installed. The setup program suggests to install Tutorix Player in your default program files folder.

 

In order to install Tutorix in a different directory, select Custom and enter the path you prefer in the next appearing window.

 

The installation software installs MS agent components on your system. These are required for the correct function of Tutorix. Deselect the checkbox under Install MS agent components if you are sure that they are already installed on your system.

 

Click Next  to continue.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 



5.     Select the desired languages which you want to use for speech output. You can install any of the following languages:

 

·        english (will be installed as default)

·        german

·        french

·        italian

·        spanish

·        dutch

·        portuguese

 

Click Next to continue.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 


It may occur, that you will be asked during installation to reboot the system. Click NO on all appearing ‘Restart Windows’ dialogues.


6.     Select the agent which you want to install on your system. The ‘Genie’ Agent will be installed on your system as default. The following agents are available for selection:

 

 

 

 

 

 

 

 

 

 

 

 


Click Next to continue.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 


Due to legal license reasons, only four agents are covered in the software. You may install at any time agents from third party vendors and utilize them with Tutorix.


7.     The installation software creates program icons on your desktop. However, if you don’t wish to have them, clear the checkbox under Create program icons on desktop.

 

Click on Install, to begin with copying data files. Installation may take several minutes.

 

If the installation program points to a running program, try to close it.

 

 

 



8.     Wait until installation has finished and click on Finish.

 

You now have the choice to start the Tutorix program. In this case select the checkbox Launch Tutorix Player and click on Finish.

 

 

 

 



Application of Tutorix

Getting started

 

Before you start recording a tutorial, you should make yourself familiar with the functions of the toolbar icons. They will ease your work with Tutorix Player, since they can be called directly.

 

 

Icons        Description

 


Open. Opens existing tutorials (.tux file).

Close. Closes opened tutorials.

Print. Prints an opened tutorial from the standard printer of the system.

Play Current Step. Plays the selected step in the Steplist.

Plays the first step of a tutorial.

Plays the previous step.

Plays the next step.

Plays the last step of a tutorial.

 

General

 

When playing tutorials with Tutorix Player, the agent verifies if the instruction issued is executed correctly. If correct, the agent displays the Success Animation and moves to the next step.

 

If instructions are not executed correctly, the agent displays the Failure Animation. The user is also informed with a bubble and language output. The user can then attempt to execute the instructions correctly. If the instructions are forgotten, click on the icon ‘Play current Step’ : The agent will advise which mouse or keyboard actions must be executed.


Play Tutorials

 

To open a tutorial, click either the icon  (Open) or select in the Menu under File the menu item Open Tutorial:

 

 

Once you have opened an existing Tutorix tutorial-file (.tux), the first step is played automatically.

 

The various steps of the tutorial are illustrated in a step tree (see figure below). Over the 1. Step the title of the tutorial (.tux file) is shown.

 

 

The individual steps are labeled as 1. Step, 2. Step etc. by default, though they can be customized during the creation of the tutorial.


 

The individual steps are characterized by a symbol, for example a figure of a mouse  is displayed if in the relevant step a mouse action is stipulated, and the illustration of a keyboard  if in the relevant step a keyboard action is required.

 

Example: Under the red arrow of 4. Step a mouse is shown; therefor a mouse action is anticipated. In contrast, under the red arrow of 3. Step a keyboard is shown; therefor a keyboard action is required.

 

To play the current step of the tutorial, click on the  icon or select in the Menu under Navigation the menu item Play Selected Step.

 

To play the next step, click the  icon or select in the Menu under Navigation the menu item Play next Step.

 

To play the previous step, click the  icon or select in the Menu under Navigation the menu item Play previous Step.

 

To play the last step, click the  icon or select in the Menu under Navigation the menu item Play last Step.

 

To play the first step of the tutorial, click on the  icon or select in the Menu under Navigation the menu item Play first Step.

 

If the stipulated action is executed correctly, the agent displays the ‘Success Animation’ and moves to the next step. If the stipulated action is not executed correctly, the agent displays the ‘Failure Animation’ and gives the appropriate instructions.

 

You may execute the stipulated actions or if you have forgotten the action, click on the  icon. The agent will inform you again which mouse or keyboard interactions are required.

 

To close an opened tutorial (.tux file), use the tutorial window Close   icon or select in the Menu File the menu item Close.

 

 

 


Printing Tutorials

 

You have the possibility to print your tutorials, by clicking the  (Print) icon in the Tutorix Player toolbar. All steps of the tutorial are printed on the standard printer of your system.

 

The printout of every step of the tutorial comprises the following information:

 

·        Under the Title you see the title of the respective step. If the individual steps of the tutorial are not named specifically, the steps are labeled as1. Step, 2. Step etc. on the print out.

 

·        Under Balloon Text the instructions of the agent are shown.

 

·        Under the title Screenshot the screenshot of the current step is printed.

 

·        When creating a tutorial, if step task description was entered, it appears under the title Description on the print out.

 

If you wish to print the tutorial (.tux file) on another printer, click in the Menu on File and select the menu item Print. You have the possibility to use any of your computers printers for the print out of the tutorial.

 

 

All individual steps of the tutorial can also be printed individually. Select the desired step of the tutorial, click in the Menu on File and select the menu item Print Selected Step (printing of the current step).

 

 


Short Description of Tutorial

 

The short description of the tutorial gives an overview of the title, agent, language, author and creation or modification date of the tutorial. To open the short description of a tutorial, select in the Menu File the menu item Tutorial Properties.

 

 

The figure below shows the properties window (Properties) of the current tutorial.

 

 

Under title, the name of the current tutorial file (.tux) is shown. In the field Author, the name of the developer of the tutorial is shown.

 

The section Theme is a short description of the tutorial, while under Comment; possible comments of the author are shown.

 


Extended Tutorial Settings of Tutorix Player

Select Agent

 

You have the possibility to replace the defined agent with an agent of your choice. Select in the list under Agent character an alternate agent.

 

 

Define Default Agent

 

You can define your favorite agent as the default agent by selecting in the Menu under Options the menu item Set Character as default.

 

 

 

To exercise this function thoroughly, you must have all four standard agents installed on your system. You may install missing agents at any time by inserting the Tutorix CD-ROM and executing the installation file.

 


Define Tutorial as Foreground Application

 

You may define the tutorial window as a foreground application, thus preventing other applications from placing themselves over the tutorial window. Select in the Menu under Options the menu item Always on Top. The window of Tutorix Player appears always foremost.

 

 

Maximize Tutorial Window

 

To utilize for the active tutorial the whole area of the screen, select in the Menu Options the menu item Maximize Tutorial Window. The tutorial window is adjusted to the maximum available size.

 

 

Disable Speech Output

 

You may disable the speech output by selecting in the Menu under Options the menu item Disable Speech Output. The speech output of the agent is disabled and the instructions only appear in the bubble.

 

 

Disable Sound Effects

 

The sound effects of the agent may be disabled in the Menu under Options through the menu item Disable Sound Effects. This function has no influence on the speech output of the agent.

 

 


Disable Animations

 

The animations that the agent executes when changing positions can be disabled. This has no influence on the gesture animations. Select in the Menu under Options the menu item Disable Moving Animations. The tutorial will flow considerably faster.

 

 

Synchronize Speech Output with Bubble

 

Synchronize the speech output of the agent with the appearance of the text in the bubble, select in the Menu under Options the menu item Auto Pace Balloon Speech.

 

 


Technical Information

Command Line Parameters

 

The following command line parameters are available for Tutorix Player:

 

/l <.tux File>             opens a tutorial and plays the first step.

/p <.tux File>            prints a tutorial on the standard-printer of the system.

/?                           command line help dialog

 

Example:

 

"C:\Program Files\Mindleads Technology\Tutorix\TutorixPlayer.exe" /l c:\Files\Tutorials\Tutorial1.tux

 

 

 

If the quoted file path contains space characters, the path must be denoted in quotes <"Path">.


Required Files

 

Files that are required for starting and utilizing Tutorix Player:

 

 

File Name

Path

Version

Agentctl.dll

<C>:\system\Msagent

2.00.0.2115

Asycfilt.dll

<C>:\system\system32

3.50.5007

Comcat.dll

<C>:\system\system32

4.71

Comdlg32.ocx

<C>:\system\system32

6.00.8418

Imagehlp.dll

<C>:\system\system32

4.00

Mscomct2.ocx

<C>:\system\system32

6.00.8804

Mscomctl.ocx

<C>:\system\system32

6.00.8862

Msderun.dll

<C>:\system\system32

6.00.8804

Msvbvm60.dll

<C>:\system\system32

6.00.8964

Oleaut32.dll

<C>:\system\system32

3.50.5007

Ole32pro.dll

<C>:\system\system32

5.0.5007

Riched32.dll

<Tutorix program path>

4.00.993.4

Richtx32.ocx

<C>:\system\system32

6.00.8804

Shlwapi.dll

<C>:\system\system32

6.00.2462.0000

Stdole2.tlb

<C>:\system\system32

3.50.5007

TutorixPlayer.exe

< Tutorix program path >

<current>

TuxDecompr32.dll

< Tutorix program path >

5.41

Vb5db.dll

<C>:\system\system32

6.00.8169

 


 Registry Settings

 

Key: [HKEY_LOCAL_MACHINE\SOFTWARE\Tutorix\AgentPath]

 

Format:          \<Path>”

Default:        \msagent”

Type:            String

 

Normally the MS Agent software is installed in the subdirectory ‘msagent’ of the Windows system folder.To install in a different location, alter this registry entry.

 

The defined path must be a subdirectory of the Windows system folder (for example ‘C:\windows’).


Key: [HKEY_LOCAL_MACHINE\SOFTWARE\Tutorix\Characters\<Agent>]

 

Format:          <Name of Agent>”

Default:          Al”, Value 5

“Athena, Value 36

“Charlie, Value 25

“Check, Value 5

“Claude, Value 5

“Gar, Value 24

“Genie, Value 45

“Hanz, Value 25

Merlin, Value 20

“Oscar, Value 15

“Ozzar, Value 10

“Plany, Value 14

“Robby, Value 50

“Santa, Value 10

“Wartnose, Value 45

Type:             String

 

According to size and form of the agent, the movement of the hand may not point to the same position. The following illustration depicts this:

 

 

 

 

 

 

 

 

 

 


The agents are preset so they point automatically to the correct position. According to the agent, corrections necessary are calculated by Tutorix automatically. This is ‘y-Axis Offsetting’.

 

In the list above you will see the agents stored in the registry database. The four agents distributed with the Tutorix software (Robby, Peedy, Merlin and Genie), are already configured optimally. If you have installed agents from a third party vendor, you must record an entry in the registry database for the desired agent. In the list above, settings for some third party vendors agents are displyed.

 

If an agent from a third party vendor does not point to the right position and the name of the agent is not yet recorded in the registry database, you could relate this to an existing registry entry. The maximum value is 100 pixels. The offset will be made on the y-Axis relative to the boundary above, i.e. if you change an existing agent from the setting 10 to 20, Tutorix will move the agent upon the next start 10 pixels further down.

 


Support codes and their Significance

 

Note: To obtain technical support for Tutorix, select in the Menu Help item Online Support. You require a connection to the internet to make use of this function.

Support code:           Tx600

Reason:          Registry entry 'DefAgent' not found.

Solution:        Ensure that the registry key [HKEY_LOCAL_MACHINE \SOFTWARE\ Tutorix\AgentPath] exists. Start Tutorix Player installation file TutorixPlayer20EN.exe and select Repair.

Support code:           Tx601

Reason:          The selected assistant was unable to load. The relevant .acs file may be damaged.

Solution:        Start the Tutorix Player installation file TutorixPlayer20EN.exe, select the menu item Repair. Reinstall the assistant. If it is an assistant of a third party vendor, reinstall it.

Support code:           Tx602

Reason:          The speech engine ‘American English TTS’ was unable to load.

Solution:        Start the Tutorix Player installation file TutorixPlayer20EN.exe, select the menu item Remove. Start a new installation of Tutorix. Ensure that the ‘L&H TruVoice American English TTS Engine’ is correctly installed.

Support code:           Tx603

Reason:          The selected assistant was unable to load. The relevant .acs file may be damaged.

Solution:        Start the installation file TutorixPlayer20EN.exe, select the menu item Repair. Reinstall the assistant. If it is an assistant of a third party vendor, reinstall it.

Support code:           Tx604

Reason:          A screenshot file seems to be damaged.

Solution:        Contact the Mindleads Technology support team.

Support code:           Tx605

Reason:          Another application monopolizes the temporary folder of Tutorix.

Solution:        Close all programs that could use the temporary folder. Close ‘Windows Explorer’.

Support code:           Tx606

Reason:          The interaction control was not compiled correctly.

Solution:        Check all settings in your tutorial. Pay special attention to the bubble and interaction settings.


Support code:           Tx607

Reason:          By attempting to open the selected tutorial an error has occurred.

Solution:        The selected .tux file may be damaged.

Support code:           Tx608

Reason:          An error has occurred during initialization of the tutorial. The file could be damaged.

Solution:        If this is a newly recorded tutorial, compile it again.

Support code:           Tx609

Reason:          An error has occurred during initialization of the tutorial. The file could be damaged.

Solution:        If this is a newly recorded tutorial, compile it again.

Support code:           Tx610

Reason:          The speech output default file could not be initialized.

Solution:        Start the Tutorix Player installation file TutorixPlayer20EN.exe, select the menu item Repair. Reattempt after restarting your system.

Support code:           Tx611

Reason:          The selected file may be invalid or damaged.

Solution:        Select a valid tutorial file.

Support code:           Tx612

Reason:          The file passed as a parameter, was not located.

Solution:        Ensure that the file exists in the specified path. If it is a networking resource, confirm the UNC path is quoted correctly. Example:

 

TutorixPlayer.exe /l \\server\share\folder\file.tux

Support code:           Tx613

Reason:          An attempt was made to start Tutorix twice.

Solution:        Only one instance of Tutorix should be started.

Support code:           Tx614

Reason:          In the program path of Tutorix (usually [C:\Program Files\Mindleads Technology\Tutorix\]) the file 'TuxDecompr32.dll' was not located or it is damaged.

Solution:        Start the Tutorix Player installation file TutorixPlayer20EN.exe and select the menu item Repair. The missing file is automatically copied if required.


Support code:           Tx615

Reason:          The temporary folder was not located.

Solution:        Ensure that the environment variable is correct. Do the following: [Start/Settings/Control Panel/System/Environment], customize the variables ‘TEMP’ and ‘TMP’ accordingly.

Support code:           Tx616

Reason:          Another application has attempted to use the temporary Tutorix folder.

Solution:          Close programs that display the contents of the temporary folder, i.e. ‘Windows Explorer’.

Support code:           Tx617

Reason:          There is insufficient disk space.

Solution:        To start Tutorix, a minimum of 80MB free disk space is required. Delete unneeded files.

Support code:           Tx618

Reason:          The Microsoft agent is not installed correctly. The file ‘Agt0409.dll’ was not located in the MS agent path.

Solution:        Start the Tutorix Player installation file TutorixPlayer20EN.exe, select the menu item Repair. Ensure that in the agent path [C:\<windows- directory>\msagent\intl\] the file ‘Agt0409.dll’ exists.

Support code:           Tx619

Reason:          The screen resolution is outside of Tutorix valid range.

Solution:        The screen resolution must be a minimum of 800 x 600 pixels and may not exceed 1600 x 1200 pixels.

Restart Tutorix and click ‘Yes’, if Tutorix requests that you adjust the screen resolution.

Support code:           Tx620

Reason:          The registry database defined Agent folder could not be located.

Solution:        Start the Tutorix Player installation file TutorixPlayer20EN.exe, select the menu item Repair. Verify the registry key [HKEY_LOCAL_MACHINE\SOFTWARE\ Tutorix\AgentPath] points to an existing folder. Normally it is <windows dir>\msagent.

Support code:           Tx621

Reason:          The registry database defined Agent folder could not be located.

Solution:        Attempt a new installation of Tutorix. Verify if the registry key [HKEY_LOCAL_MACHINE\ SOFTWARE\Tutorix\ AgentPath] points to an existing folder. Normally it is <windows dir>\msagent.


Support code:           Tx622

Reason:          The standard defined agent was unable to load. The appropriate .acs file was not found.

Solution:        Start the Tutorix Player installation file TutorixPlayer20EN.exe, select the menu item Repair. If it is an assistant of a third party vendor, reinstall it.

Support code:           Tx624

Reason:          The standard defined agent was unable to load. The appropriate .acs file may be damaged.

Solution:        Start the Tutorix Player installation file TutorixPlayer20EN.exe, select the menu item Repair. If it is an assistant of a third party vendor, reinstall it.