WinBatch 98
User Manual

(c)1998 Mr James A Austin


Summary

WinBatch 98 is designed to act as a Windows 95 based batch file system.  It incorporates basic commands for graphics and sound.  There is a file copying command and a file deleting command which is widely used in batch files in MS DOS.

MS DOS is a trade mark of Microsoft Corp.
Windows 95 is a trade mark of Microsoft Corp.

Documentation and software "WinBatch 98" (c)1998 Mr James A Austin


Contents

				Page
	Summary		2

	Contents		3

	Useful Information		4
		
		.wCP 		4
		
	Commands		5

		echo		5
		beep		6
		run		7
		timer		8
		title		9
		cls			10
		status		11
		pause		12
		fcolour		13
		bcolour		14
		pbcolour		15
		size		16
		font		17
		picture		18
		exit		19
		question		20
		y			21
		n			22
		hide		23
		show		24
		copy		25
		del		26
		showifn		27
		hideifn		28
		playwave		29
		playmidi		30
		cdtrack		31
		stopplay		32
		waiteos		33


Useful Information

.wCP	Using WinBatch 98 to Autoexec A File

When a file is saved as .wCP using the CP save option in the editor the file can autoexec its self.

Example:	"WinBatch 98.exe" example.wCP
[Runs example.wCP with WinBatch 98.exe]

More Info:
The .wCP file use basic encryption.  I don't recommend that this should be used for sensitive data as the encryption code is simple and is hackable. (But not to the basic user.)

Any .wCP file can be set with passwords for editing and running script.

If there is:

No EDITING password and you are opening the .wCP file to edit it you will still be prompted for a password.
(I should imagine that you will know it has no password and will put off other people trying to access it.)

No RUNNING password the script will run without prompting for a password otherwise a password is required.

To set-up passwords go to File -> Preferences on the editing window's menu bar.

Commands

echo.	Displays message in output window.

Example:  echo.Hello
[Prints hello in the output window.]


beep.	Makes machine beep.

Example:  beep.
[Makes beep sound.]


run.	Runs an executable.

Example:  run.c:\windows\explorer.exe
[Runs windows explorer.]


timer.	Waits a set number of seconds.

Example:  timer.2
[Waits 2 seconds.]


title.	Changes output windows title.

Example:  title.My WinBatch File.
[Displays My WinBatch File in window title.]


cls.	Clears output window.

Example:  cls.
[Clears output.]


status.	Changes output windows status bar.

Example:  status.OK
[Displays OK in the status bar.]


pause.	Waits for user to press any key or click screen.

Example:  pause.
[Program waits.]


fcolour.	Changes the output list box test colour.

Only one colour may be used at any one time.

Example:  fcolour.000.000.000
[Make the text colour black. (No red, blue or green.)]

See also bcolour.


bcolour.	Changes the output list box background colour.

Only one colour may be used at any one time.

Example:  bcolour.000.000.000
[Makes the background colour black. (No red, blue or green.)]

See also fcolour.


pbcolour.	Changes the picture windows background colour.

Only one colour may be used at any one time.

Example:  pbcolour.000.000.000
[Makes the background colour black. (No red, blue or green.)]

Notes:

The editor has a menu option that will allow you to select the colour on the screen and put in your script automatically.

Format Info.  RRRGGG.BBB  (000 to 255 red , 000 to 255 green , 000 to 255 blue)



size.	Changes text size in output window.

Example:  size.20
[Uses text size 20.]


font.	Changes text font face.

Example:  font.Tahoma
[Uses font Tahoma.]


picture.	Loads picture.

Example:  picture.c:\windows\clouds.bmp
[Loads clouds.bmp into a window.]


exit.	Exists program.

Example:  exit.
[Program terminates.]


question.	Prompts user for a response.

Example:  question.Load explorer?



See also y. , n.


y.	If user response is yes.

Example:  y.run.c:\windows\explorer.exe
[Checks for yes response and runs windows explorer.]

See also n. , question.


n.	If user response is no.

Example:  n.echo.canceled
[Checks for no response and displays cancelled in the output window.]

See also y. , question.


hide.	Hides output window.

Example:  hide.
[Hides window.]

See also show.


show.	Shows output window.

Example:  show.
[Shows window.]

See also hide.


copy.	Copy a file for source to destination.

Example:  copy.c:\autoexec.bat,c:\autoexec.bak
[Copies the autoexec.bat file to a backup file called autoexec.bak]


del.	Deletes a file.

Example:  del.example.txt
[Deletes file example.txt.  Use this command carefully!!!]

Example 2:

	question.Delete file?
	y.del.example.txt
	n.echo.Not Deleted.

[Ask before deleting] (Script Example 2)

See also copy.


showifn.	Displays the picture's file name used in the picture window.

Example:  showifn.
[Display picture's file name]

See also hideifn.


hideifn.	Displays the picture's file name used in the picture window.

Example:  hideifn.
[Hides picture's file name]

See also showifn.


playwave.	Plays a wave file (.WAV).

Example:  playwave.sound.wav
[Plays sound.wav through your sound card (may crash program if you don't have one)!]

See also playmidi. , cdtrack. , stopplay. , waiteos.


playmidi.	Plays a midi file (.MID).

Example:  playmidi.music.mid
[Plays midi file (see playwave. About NO sound card!)]

See also playwave. , cdtrack. , stopplay. , waiteos.


cdtrack.	Plays a track of a CD (remember to put the CD in).

Example:  cdtrack.1
[Plays a CD track (does not matter whether you have a soundcard or not you do need a CDROM drive!)]

See also playwave. , playmidi. , stopplay. , waiteos.


stopplay.	Stops any sound currently playing.

Example:  stopplay.
[Silence sound output]

See also playwave. , playmidi. , cdtrack. , waiteos.


waiteos.	Pauses until sound has finished.

Example:  waiteos.
[Waits until sound has finish]

Notes:

Press ESC to end (stopping sound as program terminates)

See also playwave. , playmidi. , cdtrack. , stopplay.