Category : Miscellaneous Language Source Code
Archive   : DEBUT141.ZIP
Filename : SD.DOC

 
Output of file : SD.DOC contained in archive : DEBUT141.ZIP


























S C R E E N D E B U T v1.41

by Willie Robinson
2613 Louis Blvd
Hephzibah Ga 30815
















(C)opyright 1990 Willie Robinson

S C R E E N D E B U T 1.41 Pg 1
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ



Contents



Foreword...............................................Page 2

Disclaimer.............................................Page 2

Shareware Notice.......................................Page 3

Starting Screen Debut..................................Page 4

General Editing Commands...............................Page 4

Editing Commands.......................................Page 5

ANSI Animation Mode....................................Page 10

ANSI System............................................Page 11

Support for GT Power BBSs..............................Page 12

Hammerly's ProBas......................................Page 13

File Handling..........................................Page 14

Block Diagram of Major Functions.......................Page 15

Snap Screen............................................Page 16

Odds and Ends..........................................Page 17

Limitations............................................Page 18

S C R E E N D E B U T 1.41 Pg 2
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ


THANK-YOU


Thank-you to all the people who have contributed so greatly to
the success of this program. Without your support and suggestions
this program would not have achieved the level of performance that
it currently maintains.

A personal thank-you to:

Perry Alexander Steve Moody
Scott Cushman Steve Paye
Tom & Jane Devlin David Philpott
Jack Hazel
Chris Kitchin
Warren Leadbeatter



FOREWORD

Screen Debut is a very powerful screen generator. It's designed as
a tool to ease the development of text screens. It generates code
for screens in many different ways.


¯ ASCII Code


¯ ANSI Code for use with DOS and Telecommunications.


¯ BASIC Code with & without line numbers plus BSAVE.


¯ C Code for Turbo C.


¯ Pascal Code For use with Turbo Pascal.


¯ Compressed Binary Format for use with Snap Screen
and Hammerly's ProBas.



DISCLAIMER: While this program has been extensively tested,
unforeseen snags may arise. The use of this program is at your
own risk!

S C R E E N D E B U T 1.41 Pg 3
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ



SHAREWARE NOTICE



This program is a shareware program, feel free to share it with
your friends. The more you share it, the wider it's distribution
will be. Please help by uploading it to all BBSs!

Under the shareware concept, the user is allowed to try out the
program before purchasing it. If you like the program and feel it
will be of use to you, please register it by sending $10.00 to the
address below. With a $10.00 registration you will receive a free
complimentary copy of Screen Predator (Outside US add $10.00 for
handling plus postage) and the most recent version of Screen Debut.

If you do use the program, help it along with your registration fee.
Your support will help to keep the program alive. Send registrations
to the address below. Please specify 3.5 or 5.25 inch disk. Outside
North America add $10.00 for handling and postage.



Willie Robinson
2613 LOUIS BLVD
HEPHZIBAH GA. 30815




NOTICE: This program is Copyrighted. ALL Rights Reserved. It may
not be modified, disassembled, or sold by second parties without
written consent from the author. Site license information is available.


NOTE TO SHAREWARE DISTRIBUTION OUTLETS: A small fee (Less Than $10.00)
may be charged for copying and providing a disk. This does not negate
the authors request.


NOTE TO SYSOPS: Thank-you for your support of this program!

S C R E E N D E B U T 1.4 Pg 4
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ


STARTING SCREEN DEBUT

From the Dos Prompt:

A>SD YOURFILE (Screens can be loaded from the command line)

Command Line Switches:

/S - Puts the program in Snow Suppression mode. This is only
useful for older CGA chips. If you don't see snow, don't use
this switch. It slows the program down.



GENERAL EDITING COMMANDS

¯ Screen Debut is Mouse supported. All commands use the left button.

¯ The Arrow Keys move the cursor on the screen. The status bar at
the bottom of the screen indicates the cursor's coordinates. To
draw lines, use the F2 Key to toggle between Move Cursor, Single
Border, and Double Border.

¯ The Home, End, Pg Up, Pg Dn, and Tab also move the Cursor on the
screen.

¯ The Back Space key removes character to the left of the Cursor and
moves the Cursor one space to the left. Pulling all Characters to
the right of the cursor one space to the left.

¯ Pressing the "Ins" key will toggle between the insert mode and the
overwrite mode of operation. In the Insert mode the cursor is small.
This allows characters to be inserted. In the Overwrite mode the
cursor is full height. This allows characters to be overwritten.

¯ The Del key removes characters.

¯ The "`" key is user definable via the ASCII chart. [Alt] I

¯ Full Control key support. [Ctrl] A place ASCII character #1 (a happy
face) at the cursor and so on.

¯ Full Numeric ASCII code support. Hold down the [ALT] key and type
the ASCII code into the NUMERIC key pad. The Character will be
placed at the cursor position.

S C R E E N D E B U T 1.4 Pg 5
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

Editing Commands

The Help screen displays all commands available. These commands are
available from the screen editing environment. This is a sample of the
help screen while in the Non-animated mode.

ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º HELP SCREEN º
º ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ º
º Toggle Line mode w/ [Alt] Z F1 ³ Wipe Screen [Alt] W º
º Toggle Line mode w/o [Alt] Y F2 ³ Free Memory [Alt] = º
º ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ º
º Change Color [Alt] C ³ Load Screen [Alt] L º
º Grab Color [Alt] G ³ Load File [Alt] F º
º Recolor Color [Alt] R ³ Save Screen [Alt] S º
º Recolor Area [Alt] A ³ Change Directory [Alt] D º
º ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ º
º Move Area [Alt] M ³ ANSI Code [Alt] 1 º
º Copy & Move Area [Alt] & ³ BASIC Code [Alt] 2 º
º Paste Area [Alt] P ³ C Code [Alt] 3 º
º Cut Area [Alt] - ³ Pascal Code [Alt] 4 º
º Copy Area [Alt] K ³ ASCII [Alt] 5 º
º ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ º
º Big Fonts [Alt] B ³ Animation On/Off [Alt] O º
º ASCII Chart [Alt] I ³ º
º Line Unions [Alt] U ³ º
º ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ º
º Jump to Shell [Alt] J ³ º
º Exit Program [Alt] X ³ º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ

[Alt] H This key activates the Help screen.

[Alt] T Or F1 toggles between Move Cursor, Single Border, and Double
Border. This is useful for moving the cursor and drawing single
or double lines. This function automatically places line
junctions.

[Alt] Y Or F2. The same as [Alt] T above without auto junctions.


[Alt] C Change Color. Sets the current color attributes. The current
color is indicated by the color of the left half of the Status
Line.

[Alt] G Grab color. Sets the current color attributes of the program
by grabbing the color that exists under the cursor.

S C R E E N D E B U T 1.41 Pg 6
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

[Alt] R Reset Color - Resets a color on the screen. Place the cursor
over the color you wish to reset. Notice that the red selector
arrow visually differentiates this function from the Change Color
function ( ð> versus > ).

[Alt] A Color Area - Recolors a Block (a square) on the screen.
Note: The Block is Re-colored to the current selected color.

[Alt] M Move Area - Place the cursor on a corner of the block to be
moved before entering this command. The block selected may be
of any size.

[Alt] & Copy & Move Area. This function allows a block to be copied
from one position to another.

[Alt] P Paste - Restores a block which was saved with the Cut or
Copy function.

[Alt] - Cut - Cuts a block from the screen, storing it in memory
for later recovery with Paste. Cut is also useful for
erasing all or part of the Screen. The cut area assumes
the current color attributes.

[Alt] K Copy - This function works much like a camera. It copies a
selected area into memory, saving it for later recovery
with Paste. The main purpose of the Cut, Copy, and Paste
functions is to allow the importation of screen snapshots.

[Alt] B Big Fonts - Allows BIG LETTERS to be placed on the screen.
All ASCII characters from 1 to 127 are supported. The
Pointer on the ASCII Chart ([Alt] I) is used to select the
fill characters. To use the ASCII Chart without putting a
character at the current cursor position set the pointer
and press Escape. The fill characters may be of any ASCII
character. The Letters will be of the programs color setting.
The Tab Key works very well for letter spacing. The
characters are based on a 8 x 8 Row/Column matrix. There are
three methods to enter the BIG character.

1) The normal keyboard keys.

2) Use the [Ctrl] letter combination that represents a
control character. (ASCII codes 1 to 30)

S C R E E N D E B U T 1.41 Pg 7
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

3) Hold down the [ALT] Key and type in the ASCII character
number.
Note: This is a tough way to go, but if you don't have a
book with an ASCII chart then use the programs chart
([Alt] I). Start at the top and count from left to right.
The first character is number #1 or [Ctrl] A depending
how you look at it.

[Alt] I ASCII Chart - Characters not supported by the Keyboard are
available on the ASCII chart. The selected character will be
placed at the cursors current location.
The pointer on the chart also defines the "`" key and fill
characters for the Big Font operation.

Caution: Some ASCII characters, control codes, cause
unpredictable results when used in conjunction with programming
languages.

[Alt] U The F6 key selects Box Junctions.

[Alt] J Jump to the DOS shell - The "[Alt] J" key exits to the DOS
shell. This means the program stays in the computer's memory
while work is being done at the DOS level.
Note: Set the DOS Path so COMMAND.COM can be found. As an
alternative, place COMMAND.COM in the current directory.

[Alt] X Exit the program

[Alt] W Wipe Screen - Clears the current screen and animation buffer.
to a grey foreground on a black background. Use the Recolor
function to change the foreground and background colors if
desired.


[Alt] = Free Memory - Displays the amount of free memory left in the
computer.

[Alt] L Load Screen - Loads Screen Debut compressed binary files.
These files have the ".SD" and ".SDA" extension.

[Alt] F Load File - Loads raw files. Screen Debut directs these files
through the BIOS, therefore the ANSI Device Driver must be
installed. Files are loaded in line by line. Hit any key
to stop the loading process.

[Alt] S Save Screen - The "[Alt] S" key saves the screen in Screen
Debut's compressed binary format .
Caution: Do not keep more than 110 .SD files in one DOS
directory. Use sub-directories to surpase this limitation.

[Alt] D Change Directory

S C R E E N D E B U T 1.41 Pg 8
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

[Alt] 1 ANSI Code - Screen Debut use three separate algorithms to
code ANSI screens. The first two code the Static
(Non-Animated) Screen. It uses Auto-Sizing to adjust the size of
the coded screen. Auto Sizing first determines the existence and
size of the drawing by scanning the screen from bottom (Row 24)
to top. Then it scans from right to left to determine the right
edge of the drawing. It does this by searching for characters
that are not blank spaces (ASCII character 32) of the default
color white on black. Once it has determined that a drawing does
exist on the screen and it's size, it codes it. See the section
on "Support for GT power BBSs" for a discussion on the code
parameter window.

The Third algorithm codes the Soft (Animated) Screen. It
first checks to see if an animated drawing exists. If there
is anything in the animation buffer (memory area) it codes
it. The code produced here is sensitive to screen placement.
It uses the screens Row and Column coordinates to place each
character. Furthermore, the cursors resting position
(position of the cursor when the ALT A command was used)
will be recorded into the ANSI code.

[Alt] 2 BASIC Code - Screen Debut codes the top 24 rows of the
screen in Basic, with or without line numbers. Use
Basic's "MERGE" command to place the code built by Debut
into your program. Basic screen files end with the .BAS
extension. Use Basic's "RENUM" command to renumber the line
numbers if needed.

BSAVE

Load BSAVE files from Basic with the use of the "BLOAD"
command. An example has been provided in the file "BLOAD.BAS".
Note: The BSAVE files made by this program haven't been
successful on Tandy computers. (?)

[Alt] 3 C Code - The C code is built from the top 24 rows of the screen.
The code is compatible with Turbo C. C screen files end with the
".C" extension.

[Alt] 4 Pascal Code - Originally Screen Debut was built as a Pascal
screen code generator. The Pascal code generated by it is
compatible with Turbo Pascal. Due to the use of the "CheckSnow"
variable the screens are very fast. The code can be produced
as either a procedure or as a unit. See your Language manual
to include the screens into your program. Pascal coded screens
end with the extension ".PAS".

[Alt] 5 ASCII - Turns the screen into ASCII text.

S C R E E N D E B U T 1.41 Pg 9
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

[Alt] O Animation On/Off - Screen Debut allows for Animated and Non-
Animated ANSI screens. To enter or exit the ANSI Animation mode
of operation press the "[Alt] O" key. Once you have pressed it
you will notice a change at the bottom status line of the
screen. In the Animation Mode of operation, a frame counter will
appear on the Statue Line.
For information on Animation mode see the section on Animation
editing commands. A small blinking box on the right of the
status line indicates the screen is Animated.

Note: Some of the editing commands available in the non-animation
Mode are not available in animation mode.

S C R E E N D E B U T 1.41 Pg 10
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

ANSI Animation Mode commands

The editing functions available are listed on the Help screen. Many of
the commands listed here duplicate the editing commands while in the
non-animation mode. Listed after the menu are the commands that deviate
in operation when in the non-animated mode.


ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º Animator Menu HELP SCREEN º
º ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ º
º Toggle Line mode w/ [Alt] T F1 ³ Wipe Screen [Alt] W º
º Toggle Line mode w/o [Alt] Y F2 ³ Free Memory [Alt] = º
º ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ º
º Change Color [Alt] C ³ º
º Grab Color [Alt] G ³ º
º ³ º
º ³ º
º ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ º
º ³ º
º ³ º
º ³ º
º ³ º
º Copy Area [Alt] K ³ º
º ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ º
º ³ Animation On/Off [Alt] O º
º ASCII Chart [Alt] I ³ Step Forward [Alt] 0 º
º Line Unions [Alt] U ³ Step Back [Alt] 9 º
º ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ º
º Jump to Shell [Alt] J ³ View Data [Alt] V º
º ³ Animation Replay [Alt] R º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ

[Alt] K Copy - Copy a block from the non-animated screen into the
animation buffer.

[Alt] W Wipe Screen - Clears the animated portion of the screen.

[Alt] 0 Step Forward - Steps the program one step forward.

[Alt] 9 Step Back - Steps the program one frame back.

S C R E E N D E B U T 1.41 Pg 11
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

[Alt] V Selects the "Data View" Option. This option pulls up a window
that contains information contained within the animation frames.
The options available are:

Up/Down Arrow - Scrolls data

Left/Right Arrow - Sets Replay Delay time in micro-seconds.
This is the Animation display delay.

Ins - Depressing the insert key insert a +/- character into
the frame selected by the red arrow.

Del - Cuts the character selected by the red arrow.

[Alt] R Animation Replay - The animator to reset to frame 1 then
it replays the animation. To stop the animator press any
key. Animation speed is set using the [Alt] V function.
See the instructions on the [Alt] V key for an explanation
on how this works.




ANSI SYSTEM SET-UP


ANSI Screens use the ANSI.SYS file that comes with DOS. Make sure
your CONFIG.SYS file contains the following.

DEVICE = ANSI.SYS

It should be in the root directory on the hard disk or on the boot
up disk. If it doesn't exist it can be created with a word
processor, or the DOS COPY CON command. (SEE YOUR DOS MANUAL).

Now your ready to use the ANSI screens built by Screen Debut.
ANSI screens have the extension ".ANS". Use the DOS "TYPE" command
to post the screen to your monitor. Example:

A>TYPE YOURFILE.ANS

NOTE: An alternative to the ANSI.SYS is to use Snap Screen.
(See Snap Screen in the Index)

S C R E E N D E B U T 1.4 Pg 12
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ


SUPPORT FOR GT Power BBSs

GT Power BBSs allow uploading of ANSI Code into the message areas
using the ASCII protocol for uploading. Screen Debut supports these
message areas in the following ways.

This example of the ANSI code parameter window appears every time
the Build ANSI code procedure is invoked.

ÖÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
º º
º Code Style Compact º
º Code Width ñ 72 º
º Clear Screen Yes º
º BBS Control Code ^E º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º Enter ³ Esc º
ÓÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĽ

1) Code Style

Code style selects the coding routine which will code the non-
animated screen. There are two flavors, Regular and Compact.
Regular code is special geared to scroll the screen as it appears.
Compact code on the other hand uses a different coding strategy. It
will minimize the number of lines of code. Ideal for fairly complex
screens which will be used in a BBS message base.

2) Code Width

Use a width of 72 for message base work otherwise open it up to
250. For fine tuning use the "+" or "-" keys. "Note that these widths
are only approximations". The actual code width may be wider under
some circumstances.

3) Clear Screen

Controls whether or not the code to clear the screen is to be
used.

4) Control Code Support

GT BBSs use the "^E" and "^R" characters to control the "More Y/n?".
The "More" prompt is not always desirable. To add a "^E" or "^R" to
the beginning of a file, set ANSI Code parameter window's "BBS
Control Code". A "^E" will give one "More Y/n?" then allow the file
to run uninterrupted . A "^R" will allow a file to run it's entire
length without a "More Y/n?"

S C R E E N D E B U T 1.41 Pg 13
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ



Screen Debut Files with HAMMERLY'S PROBAS



The Compressed Binary files with the .SD file extension are
compatible with Hammerly's ProBas. Here's the code segment
needed to load and post the screens.


DIM SCR%(2000) '--- Dimension Array
DIM CSCR%(2000)

'-/OPEN SCREEN FILE TO BE READ IN FROM DISK/------------------
CALL FOPEN("YOURFILE.SD", 0, 0, HANDLE%, ECODE%)
IF ECODE% THEN PRINT "ERROR"

'-/Get file size/---------------------------------------------
CALL FSIZE(HANDLE%, BYTES&)
BYTES% = CINT(BYTES&) '--- Put Long integer into short

'-/Read Data in file/-----------------------------------------
CSEG% = VARSEG(CSCR%(1)) '--- Set Pointers
COFS% = VARPTR(CSCR%(1))
CALL DFREAD(HANDLE%, CSEG%, COFS%, BYTES%, BYTESREAD%, ECODE%)
IF ECODE% THEN PRINT "ERROR"

'-/Close File/------------------------------------------------
CALL FCLOSE(HANDLE%)

'-/UnCrunch Screen Data(Decompress)/--------------------------
DSEG% = VARSEG(SCR%(1)) '--- Reset pointers
DOFS% = VARPTR(SCR%(1))
CSEG% = VARSEG(CSCR%(1))
COFS% = VARPTR(CSCR%(1))
CALL UNSCRUNCH(DSEG%, DOFS%, CSEG%, COFS%)

'-/Put Data to the Screen/------------------------------------
DSEG% = VARSEG(SCR%(1)) '--- Reset Pointers
DOFS% = VARPTR(SCR%(1))
CALL DSCRREST(DSEG%, DOFS%, 0, SNOW%)

S C R E E N D E B U T 1.4 Pg 14
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ


File Handling



When doing a "Load Screen" function ([Alt] L), Screen Debut looks for
the files with the ".SD" extension. When a file is selected from the
menu it checks to see if it is has an animated counterpart. The
animated files are the files with the extension ".SDA". If one exists,
it loads it along with the ".SD" file. It is assumed that a ".SDA"
file will not exist without a ".SD" file. When saving a file from one
of the build code functions the ".SD" file, the ".SDA" file (If
appropriate), and the code file are all saved. If the .SD file exists,
Screen Debut will challenge the user with "*.SD EXISTS OVERWRITE ?".
Select "No" to write the code to the disk without overwriting the
*.SD file. Hit Escape to abort the procedure entirely. Debut guards
the ".SD" files because they represent your work. The coded screens
are of no concern to it, it will overwrite them without notification.



File Extensions



.SD...........Debut's Compressed Binary File

.SDA..........Debut's Animated Screens

.ANS..........ANSI Coded Screens

.ASC..........ASCII Files

.BAS..........Basic Coded Screens & BSAVE

.C............C Language Coded Screens

.PAS..........Pascal Coded Screens


Screen Debut also has the ability to load raw text and ANSI files
directly. For proper ANSI support of the "Load File" ([Alt] F) function
the ANSI Driver must be installed.

S C R E E N D E B U T 1.4 Pg 15
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ





Major Function Areas








A>SD >ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
ÚÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄ¿
³ OPENING SCREEN ³
ÀÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÙ
ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ³ ³ ³ ÚÄÄÄ´ Build ALT ³
³ ³ ³ ³ ³ ³ ASCII 5 ³
³ ³ ³ ³ ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ A A ³ ³ ³ ÃÄÄÄ´ Build ALT ³
³ N N ³ ³ ³ ³ ³ ANSI 1 ³
³ S I ³ ³ Main ³ ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ I M ÃÄÄÄÄÄÄÄ´ Editor ÃÄÄÄÅÄÄÄ´ Build ALT ³
³ A ³ ³ ³ ³ ³ Basic 2 ³
³ T ³ ³ ³ ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ O ³ ³ ³ ÃÄÄÄ´ Build ALT ³
³ R ³ ³ ³ ³ ³ C Lang. 3 ³
³ ³ ³ ³ ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ ³ ³ ³ ÀÄÄÄ´ Build ALT ³
³ [Alt] O ³ ³ ³ ³ Pascal 4 ³
ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
³
³ ([Alt] X Key to DOS )
A> <ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

S C R E E N D E B U T 1.41 Pg 16
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ





SNAP SCREEN




Snap Screen posts to the screen, Screen Debut files. It's primarily
intended for use with batch files. It's advantage over ANSI is that
it posts screens very fast. It can reach across a directory or even
a drive and post a screen in the blink of an eye. All screens can be
kept in one directory for easy maintenance. It also has the ability
to post screens in a dramatic split screen way.
The advantages of using Snap Screen over ".COM" screens are.
1) Saves Space - It reads Screen Debuts compressed binary files which
are typical about 800 Bytes in size. A typical ".COM" screen that
carries no video assistance takes over 4000 bytes of disk space!
2) Monitor Support - Snap Screen checks for the type of monitor (color
or monochrome) and then loads the screen correctly. It also sets the
DOS prompt to the position you indicate.
3) Dramatic split screen displays - optional
4) Ease of Maintenance - All screens can be kept in the directory with
Screen Debut for easy modification and still used with batch files
that are located elsewhere.


Here's how it works:

A>SNAPSCRN YOURFILE.SD 20 1

^ ^ ^
³ ³ ÀÄÄÄ(NON Zero = Split Screen, 0 = Normal)
³ ³
³ ÀÄÄÄÄÄ(UP/DOWN Location of the A> (1 - 24))
³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄ(File made with Screen Debut )
(The extension .SD is not necessary )

S C R E E N D E B U T 1.4 Pg 17
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ



ODDS & ENDS



When developing a screen it is very important to pay attention to
the hidden color attributes. Changing color attributes for no reason
adds unnecessary extra code.


PROGRAM ERRORS



To the best of my knowledge the program is free, however there's the
human element. If you find an error, please let me know so I can
correct it.


ANTICIPATED ERRORS



Hardware versus Software type errors have been anticipated. An
example of this type of error is writing to a drive while the drive
door is open. In the event of an anticipated error the program will
try to recover itself. It will beep, give an error message for
approximately five seconds, then revert to where it was before the
error occurred. The only action required on your part is to heed the
error message.



MEMORY ALLOCATION



[ALT] = : This function checks the amount of unused memory. Without
enough free memory, Screen Debut will crash. In fact, this is the
only time it's been known to crash. Adding TSR's improperly from the
DOS shell causes a memory allocation problem. Don't load Screen
Predator from the DOS shell! If you suspect the program is running
out of memory check it by pushing "[ALT] =" while in the Main Editing
environment. Storage of all the large data arrays takes place in the
Far Memory. Insure that there's plenty of free memory here, as it is
allocated on the fly. (30KB plus)

S C R E E N D E B U T 1.41 Pg 18
ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ

Limitations

The program will code up to 999 lines of code.

Line 25 has been left off coded screens. Because, when the last
character of line 25 is written it causes the cursor to move to
line 26. This causes the screen to scroll.

The ANSI Animator can handle up to 6000 frames. The equivalent
of three full screens.

Inquires

Please direct inquires to the fore mentioned address or via the GT
Network to NET NODE 081/001 (Jack's Board of Augusta Georgia). Open
questions concerning ANSI may be directed thru the "International
ANSI Conference" or the "OZ ANSI Conference" also in the GT net.
Thanks for taking the time to look this program over!

Sincerely,
ÉÍÍÍÍÍÍÍÍÍ»
º³ ³ù³³ùÚĽ
º³³³³³³³ÃÄ
ºÀÁÙÀÁÁÙÀÄ·
ÈÍÍÍÍÍÍÍÍͼ

Willie Robinson

-------------------------- TRADEMARKS ----------------------------

TURBO C & TURBO Pascal are trademarks of Borland International.

Tandy is a trademark of the Tandy Corporation.

ProBas is a trademark of Hammerly Computer Services.

GT Power is a product of P & M Software Co.



  3 Responses to “Category : Miscellaneous Language Source Code
Archive   : DEBUT141.ZIP
Filename : SD.DOC

  1. Very nice! Thank you for this wonderful archive. I wonder why I found it only now. Long live the BBS file archives!

  2. This is so awesome! 😀 I’d be cool if you could download an entire archive of this at once, though.

  3. But one thing that puzzles me is the “mtswslnkmcjklsdlsbdmMICROSOFT” string. There is an article about it here. It is definitely worth a read: http://www.os2museum.com/wp/mtswslnk/