Virtual Hypnotist 5.8
Release Notes
©2003-2009 FollowTheWatch55
http://vhypno.sourceforge.net

Thank you for using Virtual Hypnotist!  This document describes the overall features of Virtual Hypnotist, and also changes since the previous release.  Also, thanks to all the people who helped beta test the 4.0 and 5.0 releases for months, of which this version is based on 

CONTENTS
Legal Info
What is Virtual Hypnotist?
Features
Changes in this release
Installation
User’s Guide and Website
Important Notes

Legal Info
Warning - This software was designed for recreational use only and comes with ABSOLUTELY NO WARRANTY.  The maker(s) of this software are not responsible for anything negative resulting from the use of this software.  This is free software, and you are welcome to redistribute it under certain conditions.  For details, see the file gpl.txt

This program is an interactive rewrite of the Hypnotizer 2000 software, which started in late 2000.
All source code is included.

What is Virtual Hypnotist?
Virtual Hypnotist is a complete open-source all-in-one program designed to simulate hypnosis sessions, and to be used as a general self-help or experimental program.  Please note that this software is not intended to be a replacement for a licensed hypnotist/hypnotherapist.  Instead it is designed to facilitate in self-hypnosis.  Also note that this software doesn’t “magically” control someone’s mind or covertly put them into a trance; it simply uses methods to induce a regular state of hypnosis (heightened suggestibility) in a willing subject.

Features

•	Script maker, for easily editing scripts, and for creating your own, which uses a flexible and unique scripting language.
•	Binaural brainwave synchronizer, for generating sounds that help induce hypnosis (sync brainwaves), and for providing flashing color bars that visually also sync brainwaves.
•	Lots of pre-made scripts, from inductions, deepeners, suggestions, etc.
•	Two subliminal message systems, which add visual subliminal messages in sessions, and even let you display them on your computer screen while you work
•	Hypnotic visual maker, for designing your own hypnotic effects
•	Cool presets that get you started instantly
•	A session logbook that lets you write down successes, notes, ideas, etc.
•	Fully customizable hypnosis sessions
•	Complete speech synthesis; choose from a selection of multiple voices, and even use other SAPI4 or SAPI5-compliant speech engines (only partial SAPI5 support is implemented).
•	Speech recognition that lets you verbally respond to questions and prompts while under hypnosis
•	Easy and powerful scripting language called ISL used for creating and processing scripts
•	Animated characters used as virtual “hypnotists”
•	Pop-up sessions, where the program can hide in the background and “pop up” at a certain time, and start the hypnotic induction
•	Support for video files and flash animations, via Windows Media and Macromedia Flash, and even lots of videos/animations included
•	Speed controls, to slow down and speed up both audio and video
•	HypnoChat and Remote Controller, an AIM-compatible instant messaging system that allows one user of Virtual Hypnotist control another user's program over the Internet with the subject's consent, and even supports group sessions
•	Complete tray icon and popup menu support
•	Text-only sessions that display text on the screen instead of using the speech system.
•	Background and Subliminal modes
•	Support for playing hypnosis audio files, while using Virtual Hypnotist for graphics
•	3D graphics support with the TrueVision3D graphics engine
•	Video and audio volume and rate changing support
•	Session previewing support
•	WAV file output support (SAPI5 only)
•	Script Processor Console which allows a user to operate the script system in an interactive manner
•	Script Converter for converting standard text scripts to the ISL script format
•	Personalized information for use in sessions (name, gender, and preferred trigger)
•	New GrockTunnel visual, which is a remake of the Grock hypnosis program, and supports word lists written for it.
•	Support for loading scripts, images, videos and audio directly from internet URLs
•	Comes with the Virtual Hypnotist User's Guide
•	All source code is included (written in Visual Basic 6)
•	And more 

Changes in this release

Version 5.8 -
-fixed some phrasing in the users guide
-added ColorTunnel preset buttons to the Visual Maker
-new session wizard
-reworked main screen for wizard
-moved info on Hypnotizer 2000 from the main screen to the about screen credits
-made global version string
-URL loader now checks if URLs start with "http://", and fails otherwise, since app only supports web downloading
-added a session load button on the main screen
-added 9.mp3 and hypnoloop.mp3 files

Installation
1. To install Virtual Hypnotist, first download it off the website (the file vhypno58.exe) and also any of the optional components.

2. Run the vhypno58.exe file.  That will install Virtual Hypnotist.
3. If you haven’t already installed the speech system (which is optional), extract speechsystem.zip, and run each of the programs inside it (these are from the Microsoft SAPI4 SDK and Website).  If you want SAPI5 support, you can download it from the website also.
4. Make sure you have Macromedia Flash and Windows Media Player installed.
5. If you want to have more characters, videos, and audio files, download the expansion pack available on the website.
6. If you want 3D graphics support, download the TrueVision3D graphics engine from the website.
7. Run the program, and enjoy!

User’s Guide and Website
The complete Virtual Hypnotist User’s Guide is available inside the Virtual Hypnotist application (by clicking the Help button), and is also available at the official website, http://vhypno.sourceforge.net

Important Notes

-Note that Windows 98 cannot play multiple audio streams in Virtual Hypnotist.  This means you can only have one sound playing at once: either synthesized speech, background music, or brainwaves.

1. Script Files
See the User’s Guide for more information on how scripts work, and how to make your own.

2. Included video files
The video files packaged along with this program are in MPEG 1
video-only format (no audio), GIF format, Divx, and Macromedia Flash.

3. Microsoft Windows Media Player version 6+ is required for this program
   to function properly. Also, the speech synthesizer software (located
   on the website) must be installed also.  Lastly, Macromedia
   Flash 6+ is required for the flash files to work.

Updates and info are located at http://vhypno.sourceforge.net

-----------------
Command line options:

vh.exe {parameters}
parameters are:
/load=[filename] (automatically loads specified file in sessions directory)
/preset=[preset #] (automatically loads specified preset number; preset numbers are below)
/go (automatically starts session)
/nosubwindow (turns off subliminals control panel, which is displayed in subliminal-only mode)
/exit (exits program when session ends, without returning to main menu)
/notrayicon (makes sure the tray icon doesn’t appear, if the user has enabled it)
/menuoff (disables main popup menu in induction screen)

So, to automatically load the Hypnotherapist (#1) preset, have it run automatically,
and exit when finished, you would run the program like this:

vh.exe /preset=1 /go /exit

To load the file "test.hyp" on startup, type this:

vh.exe /load=test.hyp

----------------
To exit the program, press ESC
Voice input is shown on the top right of the session screen

Preset Numbers

1. Hypnotherapist
2. Hypnotherapist 2
3. Swinging Watch
4. Pendant
5. Kaleidoscope
6. Deep Sleep
7. Feature Test
8. Brainwash (recreational)
9. Reinduction (professional)
10. Brainwash II (recreational)
11. Trigger Induction (professional)
12. Obey (recreational)
13. Hand Drop (professional)
14. Cartoonish (recreational)
15. Number Press (professional)
16. Eyes (recreational)
17. Success Loop (professional)

Remote Commands

Remote commands are sent over the instant messenger in this format:

vhcmd command /vhcmd

They can be typed by hand, or sent by the VH application.  All commands are ignored by the client machine until:
1.	The client user chooses to accept remote commands
2.	The server (controller) user sends the Start command to the client after the user chooses to accept commands

So, once the user chooses to accept commands, the start command can be sent by typing this:

vhcmd <start> /vhcmd

Once that is sent, any other commands can be sent to the client, and the client will process them.  Currently the client will only pop up a message box saying what command was sent; it will not send the command to the VH script processor yet, since that portion is not functional.

Then to have the client stop accepting commands (to stop the session), you would send this:

vhcmd <stop> /vhcmd

Script Processor internal error codes

1000 – Syntax Error
1001 – Invalid Section Number
1002 – Invalid variable number
1003 – Command not allowed in interactive mode
1004 – Nested IF statements are not supported yet
1005 - Variable contains non-numeric value
1006 – Invalid value
1007 – Session in background
1008 – Character disabled
1009 – Video disabled
1010 – Custom visuals disabled
1011 – Background audio disabled
1012 – Custom audio disabled
1013 – Brainwave generator disabled
1014 – Recursion limit reached