home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / vdoedit / vde265sp.lbr / VDE265SP.DZC / VDE265SP.DOC
Text File  |  1988-05-07  |  32KB  |  790 lines

  1.  
  2.  
  3.  
  4.  
  5. ============
  6. VDE264SP.DOC
  7. ============
  8.  
  9.  
  10.  
  11.  
  12. The Screenplay Version of 
  13. Video Display Editor
  14.  
  15.  
  16.  
  17.  
  18. This documentation on the screenplay version of Eric Meyer's 
  19. Video Display Editor is for both for the latest version of the 
  20. CP/M program (v2.65 as of this writing), and the MS/DOS program 
  21. as well (now v1.2).  This modification will not work with 
  22. versions earlier than v2.63. If you prefer VDE v2.63, get 
  23. VDE263SP.LBR.
  24.  
  25. To create a working version of VDE-SP.COM (CP/M) or VDE-SP.EXE 
  26. (MS/DOS) you need the basic VDE libraries, VDE264.LBR or 
  27. VDE12.ARC, for the basic VDE program and the detailed 
  28. documentation, which isn't duplicated here. VDE-SP is much the 
  29. same program in CP/M and MS/DOS, so the discussion applies to 
  30. both.
  31.  
  32. If you wish to modify any of these macro definitions, a program I 
  33. have released recently, VDKCOM v1.2, will enormously simplify the 
  34. process, allowing you to use VDE's full-screen editing on a text 
  35. file of the macros rather than VINST's backspace-only line 
  36. editing.
  37.  
  38.  
  39.                    NEW FEATURES IN THIS VERSION AND VERSION V2.64
  40.  
  41. Eric Meyer has added many new features to his high speed 
  42. miniature word processor VDE since I first began adapting it to 
  43. the special task of screenwriting. Since my adaptation for VDE 
  44. v2.63, I've further automated the paginating functions, 
  45. simplifying them for the user, and made some other small 
  46. enhancements. A bug in v2.64 added one two many blank lines in 
  47. the ESC-5 pagination function. That is now corrected. In 
  48. addition, I've expanded the ESC-1 and ESC-2 margin setting 
  49. functions so that they not only reset the margins, if there is 
  50. text on the line where the command is issued, the remainder of 
  51. the paragraph will be reformatted to the new margins and the 
  52. cursor returned to its original locations.
  53.  
  54. These are the new features of v2.64:
  55.  
  56. 1) The ESC-3, ESC-9, and ESC-0 commands all start from the end of 
  57. the preceding material rather than from the line on which they 
  58. will appear. If you don't like this feature, just revise the 
  59. appropriate key macros to remove the preceding carriage returns.
  60.  
  61. 2) It is no longer necessary to measure off each page when 
  62. paginating. You must measure off the first page with three CTRL-C 
  63. commands, but after that the cursor repositions itself for the 
  64. next page break automatically. Whenever you want to, though, you 
  65. may return to the last embedded CTRL-L page break - use a CTRL-Qb 
  66. command, put the cursor on it, and measure off three CTRL-C's to 
  67. the next page break position.
  68.  
  69. 3) Page headers are now added during, rather than after, 
  70. paginating. Compose the header you want in a separate file called 
  71. HEADER, and the paginating macros will read it in automatically. 
  72. This lets you have more than five lines in the header. VDE- SP 
  73. will now automatically adjust for six or more.
  74.  
  75. NOTE: Version 2.64 introduces a top margin feature for the first 
  76. time, but leave it set to 0 and control all spacing at the top of 
  77. the page with your HEADER file.
  78.  
  79. 4) Parentheticals are handled differently. When you type ESC-3 at 
  80. the point where you want to insert a parenthetical, a blank line 
  81. is forced, the text after the parenthetical is reformed to the 
  82. dialogue margins, and () is printed to the file. The cursor is 
  83. left under the ), and, since you are in insert mode, you need 
  84. only type the text. When you've finished, just exit with a CTRL-X 
  85. or any other cursor movement. No special parenthetical margins 
  86. are set. The parenthetical is aligned to a tabstop on the left. 
  87. If the line is too long, wrap it manually with a carriage return.
  88.  
  89. NOTE: This feature doesn't function well at the very end of the 
  90. file where you are likely to be working. If you add a few 
  91. carriage returns before the point where you are working, so you 
  92. push them along as you type, it will work properly. Use ^OD to 
  93. toggle the display of hard carriage returns on and off.
  94.  
  95.  
  96.                                                      INTRODUCTION
  97.  
  98. VDE-SP is nothing but a special set of VDE macro definitions 
  99. which are incorporated into VDE with VINST and the VDE-SP.VDK 
  100. file in this library. To make them work properly several options 
  101. have to be set in the options menu of VINST, but there is no 
  102. modification to the basic word processor at all.
  103.  
  104. If you don't mind traveling light, learning a few simple rules 
  105. for formatting, and doing some of the work yourself, VDE-SP can 
  106. be used without recourse to any other program whatsoever to 
  107. produce a screenplay in standard Hollywood format.
  108.  
  109. You can write your text with full wordwrap and a screen display 
  110. that exactly matches the printed page, then paginate and or print 
  111. out selected scenes or the whole screenplay - directly from your 
  112. computer's memory, without ever leaving VDE-SP.
  113.  
  114. One thing VDE-SP doesn't do is number and renumber scenes. 
  115. SCRIPTOR's ability to strip page breaks and scene numbers out of 
  116. a thoroughly rewritten script is still a great advantage which 
  117. VDE-SP can't match, although the separate program SPSTRP, which 
  118. I've included here, comes pretty close, and is even somewhat 
  119. faster than SCRIPTOR.
  120.  
  121. SCRIPTOR remains the only program I know of that is really good 
  122. at numbering scenes. I can paginate a script with VDE-SP as fast 
  123. as SCRIPTOR can, if not faster, but SCRIPTOR's ability to number, 
  124. strip, and renumber scenes will be difficult to match.
  125.  
  126. An advantage of VDE-SP is its very small size. Although I use it 
  127. on a hard disk, I developed it on a floppy-based system, and I 
  128. found I could keep a spelling checker with its outsized 
  129. dictionary, Z3KEY, and a host of other utilities on the disk with 
  130. VDE-SP, and another copy of VDE-SP on my SCRIPTOR disk.
  131.  
  132. The greatest advantage of VDE-SP, however, is speed. The whole of 
  133. VDE-SP is loaded into memory when you begin work, so there is no 
  134. chaining in and out of overlays, and the whole of your screenplay 
  135. file is in memory along with it, which means that you can work 
  136. for hours on a file without pausing for disk I/O until you save 
  137. your work to disk. Most word processing functions seem virtually 
  138. instantaneous.
  139.  
  140.  
  141.                                                   GETTING STARTED
  142.  
  143. To make VDE-SP, configure VDE for your terminal and printer. Then 
  144. make a copy of it and call it VDE-SP.COM. If you are installing 
  145. the CP/M version, use VINST on this again to install the 
  146. screenplay function key codes in VDE263SP.VDK, like this
  147.  
  148.     A0>vinst263 vde-sp vde-sp.vdk
  149.  
  150. If you are installing the MS/DOS version, do
  151.  
  152.      A>vinst11 vde-sp.exe 
  153.  
  154. and, when you open the K(eys) menu, select the R option to read 
  155. in the VDE-SP.VDK file.
  156.  
  157. Now open the Options menu in VINST. The critical options to set 
  158. are these:
  159.  
  160. Default file mode (W/A/N):  A :      
  161.  
  162. Left margin col:  1 :                
  163. Right margin col:  60 :              
  164. Page length:  0 :                    
  165.  
  166. Variable tab columns:
  167. 16 :...  21 :...  41 :...  56 :...
  168. 0 :...  0 :...  0 :...  0 :...   
  169.                                      
  170. It is very important to set the variable tab columns properly, as 
  171. all the key macros for formatting the screenplay use them. You 
  172. can also work in the default file mode W (for WordStar- 
  173. compatible), but the pagination stripping program SPSTRP will NOT 
  174. work on files created that way.
  175.  
  176. Further, in the Printer installation division of VINST you will 
  177. want to set top margin to 0 and page length to 0. This too is 
  178. important for the pagination functions to work correcty.
  179.  
  180. If you open the macro keys menu in VINST, you'll see something 
  181. that looks like this:
  182.  
  183. MACRO KEYS:  (009D bytes free)
  184. <0><Q>^V^Ol11^M^Or44^M^M^M^I^I
  185. <1><Q>^Ol1^M^Or60^M^[b^B^Qb^[u
  186. <2><Q>^Ol11^M^Or44^M^[~ 0^T^[0^[b^B^Qb^[u
  187. <3><Q>^V^Ol11^M^Or44^M^[=^M0^[~ <^[= <^D^[0^M^I(^[b)^M^G^B^Qb^[u
  188. <4><Q>^V^Ol1^M^Or60^M^[=^M>^P^L^[b^[rheader^M^Qs^C^C^C
  189. <5><Q>^V^Ol1^M^Or60^M^N^N^N^I^I^ICONTINUED^X^P^L^[bCONTINUED^Qb
  190.       ^[rheader^M^Qs^C^C^C
  191. <6><Q>^V^Ol1^M^Or60^M^N^N^N^N^N^X^X^I^I^ICONTINUED^X^P^L
  192.       ^[bCONTINUED^X^X^B^Qb^[rheader^M^Qs^C^C^C
  193. <7><Q>^V^Ol1^M^Or60^M^N^N^N^N^N^N^N^X^I^I(more)^X^X^I^I^I
  194.       CONTINUED^X^P^L^[bCONTINUED^X^X^Ol11^M^Or44^M^I^I
  195. <8><Q> (cont.)^M^[~^M0^G^[0^B^Ol1^M^Or60^M^Qb^Krheader^M^Qs^C^C^C
  196. <9><Q>^V^Ol1^M^Or60^M^M^M^I^I^I
  197.  
  198. I've wrapped the key strings to keep them from running off the 
  199. page, but otherwise this is the way VINST shows you the coding of 
  200. the macros.
  201.  
  202.  
  203.                                              PRINTER INSTALLATION
  204.  
  205. The only thing left to be done is to install a printer 
  206. initialization string which gives you the standard screenplay 
  207. page offset of 18 columns (printing starts in column 19.) This 
  208. appears to be offset way too far over to the right, but it will 
  209. look right when the script is fastened down the left side with 
  210. the customary brass paper fasteners (1-1/4" shank, with brass 
  211. washers).
  212.  
  213. If you have an inexpensive daisywheel printer which uses the 
  214. Diablo 1610 command set - many do, including Brother, Dynax, 
  215. Comrex, and Morrow models - you can install the printer with the 
  216. DIABLOSP.VDP file in this library.
  217.  
  218.     A0>vinst vde-sp diablosp.vdp
  219.  
  220. If you have a printer which is not Diablo 1610-compatible, use 
  221. VINST to install a printer initialization string which sets your 
  222. printer to 10 pitch and a page offset of 18 columns (printing 
  223. starts in column 19).
  224.  
  225. For those who can use the DIABLOSP.VDP included here, it not only 
  226. sets the 18-column page offset, it also implements the toggles 
  227. and switches. The CTRL-D toggle produces boldface, the CTRL-S 
  228. underlining, the CTRL-Y alternate ribbon, as in WordStar. Of 
  229. these, only underlining would be used in a screenplay. The CTRL- 
  230. T toggle has not been implemented.
  231.  
  232. The switches are CTRL-Q, CTRL-W, CTRL-E, and CTRL-R. The CTRL-W 
  233. produces 12 pitch type, CTRL-E 15 pitch, and CTRL-R sets 
  234. proportional spacing. None of these should be used for 
  235. screenplays, however, since they are always typed in 10 pitch. 
  236. The CTRL-Q resets to the settings of the printer's front panel 
  237. switch.
  238.  
  239. The core of the VDE-SP system, however, is the programmed macro 
  240. keys.
  241.  
  242.  
  243.                                                 VDE-SP MACRO KEYS
  244.  
  245. Function keys are simulated by VDE with ESC-n sequences. Just 
  246. type ESCAPE and a number key from 0 to 9.
  247.  
  248. ESC-1
  249.  
  250. sets scene description margins at 1 and 60, reformats the text 
  251. at the cursor accordingly, and returns the cursor to its original 
  252. position.
  253.  
  254. ESC-2
  255.  
  256. sets dialogue margins at 11 and 44, reformats the text at the 
  257. cursor accordingly, and returns the cursor to its original 
  258. position.
  259.  
  260. ESC-3
  261.  
  262. inserts parentheses on a blank line following the point of 
  263. insertion, leaving the cursor on the right parenthesis. Type the 
  264. desired text and exit with CTRL-X or any other cursor movement. 
  265. If the parenthetical is inserted in existing text, the trailing 
  266. text will be reformed to the dialogue margins. This may not work 
  267. if you are the very end of your file - on the cutting edge, so to 
  268. speak - and you are not pushing any carriage returns ahead of the 
  269. cursor. Add a few extraneous carriage returns and the feature 
  270. will work properly.
  271.  
  272. No parenthetical margin is set, so, if your text is long, you'll 
  273. have to wrap the line yourself with a carriage return.
  274.  
  275. ESC-4
  276.  
  277. inserts a simple page break between scenes.
  278.  
  279. ESC-5
  280.  
  281. inserts a page break in the middle of a scene, with CONTINUED 
  282. at the bottom right of the leading page, CONTINUED at top left 
  283. of following page. A custom header is added to the top of the 
  284. trailing page, with the page number position is indicated by the 
  285. symbol #.
  286.  
  287. ESC-6
  288.  
  289. inserts a page break with CONTINUED strings in the middle of 
  290. long description.
  291.  
  292. ESC-7
  293.  
  294. inserts a page break in middle of long dialogue, with a "(more)" 
  295. string centered below the last line and CONTINUED strings. You 
  296. retype the speaker's name, then type ESC-8 to complete the 
  297. sequence.
  298.  
  299. ESC-8
  300.  
  301. after the duplicate name string above the second part of divided 
  302. dialogue, writes "(cont.)" after the character's name and reforms 
  303. the ensuing dialogue.
  304.  
  305. ESC-9
  306.  
  307. sets scene description margins and positions the cursor for 
  308. typing transitions such as FADE OUT, CUT TO, DISSOLVE TO, CHINESE 
  309. DOLLY SHOT, and so on.
  310.  
  311. ESC-0
  312.  
  313. sets dialogue margins and positions the cursor for typing the 
  314. character's name.
  315.  
  316.  
  317.                                              WRITING A SCREENPLAY
  318.  
  319. To write a screenplay, you need only five keys, the ESC-1 through 
  320. ESC-3 keys, and the ESC-9 and ESC-0 keys. The remaining keys are 
  321. used only later, for pagination.
  322.  
  323. When you start a passage of dialogue, the ESC-0 key positions the 
  324. cursor where you want to write the speaker's name in caps and 
  325. sets the dialogue margins as well.
  326.  
  327. When you want to write a new shot line or a block of description 
  328. which belongs in the full margins, just type ESC-1. When you come 
  329. to the end of a shot that requires a transitional phrase - CUT 
  330. TO, CROSS FADE TO, or what have you - typing ESC-9 positions the 
  331. cursor for that.
  332.  
  333. ESC-2 is used to reset dialogue margins - but without positioning 
  334. the cursor to enter a character's name, and ESC-3 inserts a 
  335. parenthetical interjection in dialogue.
  336.  
  337. ESC-1, ESC-2, and ESC-3 set wide, narrow, and narrowest margins 
  338. respectively. ESC-9 positions the cursor for transitions and sets 
  339. the wide scene margins, and ESC-0 positions the cursor for a 
  340. character's name and sets the narrow dialogue margins.
  341.  
  342. ESC-4 through ESC-8 are used to set page breaks.
  343.  
  344.  
  345.                                               SETTING PAGE BREAKS
  346.  
  347. VDE-SP produces a long unpaged file. You can paginate whenever 
  348. you please, as you go along, at the end of the day, or after 
  349. you've finished a substantial body of work.
  350.  
  351. Paginate by measuring off the maximum allowable length of the 
  352. first page, then inspecting the text at that point to find the 
  353. appropriate place to set the page break. Typing three CTRL-C's 
  354. measures off the maximum page length, but you only have to do 
  355. this at the very top of each file, or if you interrupt pagination 
  356. and start over again in the middle, in which case you measure off 
  357. three CTRL-C's from the last ^L form feed. Normally the page 
  358. break keys measure the distance to the next page break 
  359. automatically.
  360.  
  361. To start locating page breaks, go to the top of the file, put the 
  362. cursor in top left corner of the screen and and strike CTRL-C 
  363. three times. This advances the cursor to the last line on the 
  364. first page where you can insert a page break. Now you have to 
  365. learn some simple rules about how to find the actual place you 
  366. want to put the break.
  367.  
  368. There are only four cases to consider,
  369.  
  370. 1) a clean break between scenes,
  371.  
  372. 2) a break in the middle of a scene, which requires a CONTINUED 
  373. at the bottom right of the leading page and another CONTINUED at 
  374. the top left of the following page,
  375.  
  376. 3) a break in the middle of a long block of description, which 
  377. also requires CONTINUED's, and
  378.  
  379. 4) a break in the middle of a long piece of dialogue, which is 
  380. the most complicated, since it requires - in addition to the 
  381. usual CONTINUED strings - several extra strings and the retyping 
  382. of the character's name at the head of the detached dialogue 
  383. carried over to the following page.
  384.  
  385. The vast majority of breaks will be of types 1 or 2. Breaks of 
  386. types 3 and 4 are relatively rare.
  387.  
  388. The first two kinds of page breaks (ESC-4 and ESC-5) are made at 
  389. three positions in the text,
  390.  
  391. 1) on a shot line or either of the two blank lines above it, 
  392.  
  393. 2) on the line where the character's name appears, or 
  394.  
  395. 3) at the first line of a block of scene or action description 
  396. which is not preceded by a shot line.
  397.  
  398. In the example below, the symbol @ indicates appropriate cursor 
  399. positions for page breaks:
  400.  
  401.  
  402.    @
  403.    @
  404.    @ INT. THE OLD SHACK - DAY
  405.  
  406.      Here is a bit of scene description... which goes on for as 
  407.      long as you like.
  408.  
  409.    @                      CHARACTER'S NAME   
  410.                This is the character's dialogue,
  411.                and it too could go on for a 
  412.                while...
  413.  
  414.    @ And suppose this text is the start of a new block of 
  415.      description, with no shot line as a header...
  416.  
  417.  
  418. The break at the first three @ symbols would be an ESC-4 (between 
  419. scenes) break, and the other two ESC-5 (inside a scene) breaks.
  420.  
  421.  
  422.                                                  PAGE BREAK RULES
  423.  
  424. There are four rules for inserting page breaks:
  425.  
  426. 1) If the cursor is between scenes, that is, on the shot line or 
  427. on either of the two blank lines above it, type ESC-4. If the 
  428. cursor lands a few lines below the desired break, just move the 
  429. cursor up to an appropriate position before typing ESC-4.
  430.  
  431. For the other three breaks, remember that you rarely want to move 
  432. up more than five lines to make your break, although you may have 
  433. to in special circumstances. All breaks in descriptive text and 
  434. especially in dialogue are made between sentences. Many typists 
  435. do not like to leave a single line at the bottom of the leading 
  436. page, although that's better than leaving too much white space.
  437.  
  438. 2) If the cursor is inside a scene, move the cursor up to the 
  439. line on which a character's name appears or to the first line of 
  440. a block of scene description. Type ESC-5.
  441.  
  442. 3) If the cursor lands in a block of description so long you 
  443. would have to move the cursor up more than five lines to find a 
  444. natural break, you will want to divide the block of description. 
  445. Move the cursor up at least TWO lines, put it on the first letter 
  446. of a new sentence, and type ESC-6.
  447.  
  448. 4) If the cursor lands in a block of dialogue so long you would 
  449. have to move the cursor up more than five lines to find a natural 
  450. break, divide the dialogue between sentences. Move the cursor up 
  451. at least THREE lines, then put it on the first letter of a new 
  452. sentence and type ESC-7.
  453.  
  454. VDE-SP will divide the dialogue, then pause to allow you to 
  455. retype the speaker's name above the trailing part of the 
  456. dialogue. To finish the page break, type ESC-8 immediately after 
  457. the character's name (adding neither a space nor any other 
  458. character), which will add the "(cont.)" string, reform the 
  459. trailing dialogue, and measure off the distance to the next page 
  460. break.
  461.  
  462. This is all you have to know. To recapitulate, you may make an 
  463. ESC-4 (between scenes) break on the shot line or on either of the 
  464. two blank lines above it. You may make an ESC-5 break on the line 
  465. on which the cursor falls or above it, normally on a line with 
  466. the character's name or on the first line of a block of 
  467. description not preceded by a shot line. You must move the cursor 
  468. up at least two lines for an ESC-6 (divide description) break, 
  469. and at least three lines for an ESC-7 (divide dialogue) break. 
  470. Description and dialogue may only be divided between sentences. 
  471. Try to avoid moving the cursor up more than five lines.
  472.  
  473. For purely aesthetic reasons you might also wish to avoid putting 
  474. a break anywhere that would leave a single line of text as the 
  475. last line of the page.
  476.  
  477. Most of this is trivial if not downright silly, as the only thing 
  478. that really counts is the action and the dialogue, but you won't 
  479. be taken seriously if your screenplay doesn't look pretty much 
  480. like the standard. There is some sense to keeping the standard 
  481. margins and spacings too, as a lot of people make judgments about 
  482. how long a scene or group of scenes or your whole screenplay is 
  483. by the size of it on the pages. So take a minute to get the rules 
  484. down. You'll find that you don't even have to think about them 
  485. after you've paginated twenty or thirty pages.
  486.  
  487.  
  488.                                                     PAGE HEADERS
  489.  
  490. A new feature of this version of VDE-SP is somewhat greater 
  491. flexibility with headers. You need prepare the header only once, 
  492. as a special file called HEADER, and VDE-SP will read it in at 
  493. every page break.
  494.  
  495. The HEADER file is an ordinary text file which you can make up or 
  496. edit with VDE-SP or any other editor. It has this structure:
  497.  
  498. <
  499. <
  500. Your header text goes here                             #<
  501. <
  502. <
  503. <
  504.  
  505. The < symbol indicates where the hard carriage returns are. The 
  506. last of those carriage returns should be the last byte in the 
  507. file - do several CTRL-T's to remove any tail. If you want to add 
  508. a second (or even a third) line, you may.
  509.  
  510. <
  511. <
  512. Your header text goes here                             #<
  513. [revised 5-13-88]<
  514. <
  515. <
  516. <
  517.  
  518. VDE-SP will automatically compensate for the number of lines in 
  519. your header. You need only make sure that there are no more than 
  520. the two blank lines at the top and bottom, plus a "third" 
  521. carriage return to reposition the cursor in column 1.
  522.  
  523.  
  524.                                                      PAGE NUMBERS
  525.  
  526. When you've finished inserting page breaks you will have a number 
  527. symbol # at the position where the page numbers go in column 56. 
  528. To insert the actual numbers, just the quick find feature of VDE 
  529. as you would in WordStar.
  530.  
  531. 1) Switch INSERT mode off with a CTRL-V,
  532.  
  533. 2) do a ^Q^F and answer the prompt with "#".
  534.  
  535. 3) When the cursor lands on the first "#" type "2" (no page 
  536. number on the first page),
  537.  
  538. 4) do a ^L to continue the search, type "3", another ^L, type 
  539. "4", and so on.
  540.  
  541. Naturally you have a lot of control here. If you need to make A, 
  542. B, C pages with the same page number for insertions, feel free.
  543.  
  544. On the first page of script, it is customary to center the title 
  545. of the script (in addition to the separate title page) on line 13 
  546. of page 1, which otherwise has no header. The first shot line is 
  547. then positioned three or four lines below that.
  548.  
  549.  
  550.                                            FINISHING OFF THE FILE
  551.  
  552. When you have finished paginating each file you will probably 
  553. have a partial page at the end, although you want each file to 
  554. end at the bottom of the last full page. Snip off the last 
  555. partial page this way:
  556.  
  557. 1) Position the cursor immediately after last ^L in the file (you 
  558. will probably be able to jump return to it with a CTRL-Qb) and
  559. mark the last partial page as a block.
  560.  
  561. 2) Write the block out to a new file with ^KW or ESC-W,
  562.  
  563. 3) then delete it with ^KY or ESC-D.
  564.  
  565. 4) Save the file with ESC-S.
  566.  
  567. 5) Then use ESC-L to load the next screenplay file.
  568.  
  569. 6) With the cursor at the top of the new file, read in the 
  570. partial page cut from the preceding file with the ^KR or ESC-R 
  571. command.
  572.  
  573. If you finish every file with a whole page you don't need to 
  574. chain files when you print out.
  575.  
  576. You will want to keep each file down to about twenty to thirty 
  577. pages, and make five or six of them for a standard length 120- 
  578. page screenplay. VDE-SP, as I've organized it, doesn't make 
  579. backup files, but your spelling checker may, and they can choke 
  580. your disk pretty fast, so it's a good idea to erase them as they 
  581. appear.
  582.  
  583. If you don't make backup files, you can easily write your entire 
  584. screenplay on a single double-sided double-density disk, and you 
  585. should always back up your whole working disk at least once a day 
  586. to a backup disk anyway. Having a dozen backup files on your 
  587. working disk doesn't help much after the dog has eaten the disk.
  588.  
  589. Since VDE-SP doesn't paginate automatically, keep track of how 
  590. long the file is by watching the line count. I usually look for a 
  591. place to close off a file when I get to about 1400-1600 lines. 
  592. VDE-SP will accept a great many more than that, but I like to 
  593. leave plenty of room for later rewriting.
  594.  
  595. Remember that paginating and putting headers on your pages will 
  596. add a few bytes and quite a few lines to the file.
  597.  
  598.  
  599.                                                      PRINTING OUT
  600.  
  601. Print out your screenplay files with VDE-SP's printing command, 
  602. ESC-P, from within the file itself. If you wish to use another 
  603. printing program, anything that will print out an exact image of 
  604. your page with a page offset of 18 columns will do.
  605.  
  606. SLMT v1.0, which sets a left margin and standard 8-column 
  607. tabstops on Diablo 1610-type printers, is included in the CP/M 
  608. version of this library. Typing SLMT with any or no argument 
  609. prints a help screen giving the syntax, which is SLMT n, where n 
  610. is any column number from 1 to 255 (a little wider than most of 
  611. our printers will allow, actually). SLMT 1 resets the left margin 
  612. to the default. Since there's no column 1 on the printer, SLMT 0 
  613. does the same thing, sets the margin in column 1.
  614.  
  615. If you use the DIABLOSP.VDP overlay to install VDE-SP, you have a 
  616. built-in page offset which allows you to print straight from 
  617. memory. If you wish to print out only a page or a scene or two, 
  618. mark the passage as a block, use ESC-P to print out, and type B, 
  619. for "block," at the prompt for "options."
  620.  
  621. Note that the normal option of printing a page or several pages 
  622. is not available in VDE-SP because the page length is set at 0. 
  623. Marking the pages you want as a block and using the B option 
  624. works just as well, however.
  625.  
  626.  
  627.                                                SOME GENERAL RULES
  628.  
  629. Leave one or two blank lines between all scenes, one blank line 
  630. between the shot line (EXT. OLD FARMHOUSE - NIGHT) and the 
  631. following block of description, and one line between description 
  632. or dialogue and the character's name on the ensuing dialogue. No 
  633. line between the character's name and his dialogue. Sometimes a 
  634. period is put after the page number. To see what a properly 
  635. formatted page looks like, print out the sample page included 
  636. with in library. Load it into VDE-SP and print out with CTRL-P, 
  637. ignoring options (type a carriage return at the options prompt).
  638.  
  639.  
  640.                                              STRIPPING PAGINATION
  641.  
  642. The CP/M version of this library includes a program called SPSTRP 
  643. which strips the pagination from the ASCII files created with VDE- 
  644. SP. This is helpful when rewriting - it's usually better to strip 
  645. your files completely and start all over with fresh, unpaginated 
  646. files. Pagination goes so quickly with VDE-SP that starting over 
  647. again is not all that onerous.
  648.  
  649. To use SPSTRP invoke it at the system command prompt and you will 
  650. be prompted for a file name to strip. When that file has been 
  651. stripped, you will be prompted for another file name. You can 
  652. quit with a carriage return.
  653.  
  654. SPSTRP does not perfectly reform the broken dialogue it has 
  655. rejoined, so you have to reform those joints with CTRL-B when you 
  656. come to them. It doesn't rejoin broken scene description at all, 
  657. leaving a blank line between two otherwise properly formed 
  658. paragraphs. SPSTRP does not make backup copies, so make sure you 
  659. don't use it on your only copy of your screenplay.
  660.  
  661. WARNING: Do not use SPSTRP on WordStar format files! If you have 
  662. to use VDE-SP in W mode for WordStar compatibility, save copies 
  663. of the files in ASCII mode before running SPSTRP on them. SPSTRP 
  664. works on a line by line basis, and it recognizes lines by the 
  665. presence of carriage returns. WordStar format files have carriage 
  666. returns only at the ends of whole paragraphs.
  667.  
  668. If you don't have SPSTRP or don't want to use it, a simple 
  669. technique is to rename the file you paginate with the ^KN (or ESC- 
  670. N) command, from FILM.C to FILM.PRN, for example. Paginate and 
  671. print out FILM.PRN, but reload FILM.C when you want to rewrite. I 
  672. tend to rewrite, repaginate, and reprint every day when I'm 
  673. working on a script, and I find this the most efficient method, 
  674. since I never have to strip the pagination from my source files.
  675.  
  676.  
  677.                                ADDITIONAL KEY MACRO PROGRAMS
  678.  
  679. You may be able to continue to use other key macro programs like 
  680. SMARTKEY, XTRAKEY, QUICKKEY, and my own favorite, Z3KEY, the Z 
  681. System Resident Command Package program, although VDE reputedly 
  682. does not cope with such RSX's - programs which load into high 
  683. memory and trap character inputs in order to translate them. 
  684. You'll have to experiment with your program. I use Z3KEY partly 
  685. because, as an RCP, it loads into a special buffer which does not 
  686. affect the available TPA (Transient Program Area).
  687.  
  688. The main reason we all started using such programs was to be able 
  689. to change margins quickly, but, since VDE-SP does that by itself, 
  690. there's no longer much need for them if you're a good typist.
  691.  
  692. If you do want to use such programs, here's the way I set up my 
  693. definition file for compilation with Z3KEY. The code to the left 
  694. of the equals sign distinguishes the function key on my Wyse 50 
  695. terminal. The code to the right could be adapted to your key 
  696. redefinition program.
  697.  
  698. ;
  699. ;  Video Display Editor - Screenplay
  700. ;
  701. ;            VDE-SP.DEF
  702. ;
  703. ;--------do not change defaults
  704. ;
  705. ATTENTION=^]
  706. LEADIN=^A
  707. DELAY=1000
  708. EXPANSION=2
  709. FILE=VDE-SP
  710. CASE=ON
  711. ;
  712. ;---------overwrite names here
  713. ;
  714. ^AA^M=^M^M^I^IALPHA^M
  715. ^AB^M=^M^M^I^IBRAVO^M
  716. ^AC^M=^M^M^I^ICOCOA^M
  717. ^AD^M=^M^M^I^IDELTA^M
  718. ^AE^M=^M^M^I^IECHO^M
  719. ^AF^M=^M^M^I^IFOXTROT^M
  720. ^AG^M=^M^M^I^IGOLF^M
  721. ^AH^M=^M^M^I^IHOTEL^M
  722. ^AI^M=^M^M^I^IINDIA^M
  723. ^AJ^M=^M^M^I^IJULIET^M
  724. ^AK^M=^M^M^I^IKILO^M
  725. ^AL^M=^M^M^I^ILOVE^M
  726. ^AM^M=^M^M^I^IMIKE^M
  727. ^AN^M=^M^M^I^INOVEMBER^M
  728. ^AO^M=^M^M^I^IOSCAR^M
  729. ^AP^M=^M^M^I^IPAPA^M
  730. ^AQ^M=^M^M^I^IQUEBEC^M
  731. ^AR^M=^M^M^I^IROMEO^M
  732. ^AS^M=^M^M^I^ISIERRA^M
  733. ^AT^M=^M^M^I^ITANGO^M
  734. ^AU^M=^M^M^I^IUNIFORM^M
  735. ^AV^M=^M^M^I^IVICTOR^M
  736. ^AW^M=^M^M^I^IWHISKEY^M
  737. ^AX^M=^M^M^I^IX-RAY^M
  738. ^AY^M=^M^M^I^IYANKEE^M
  739. ^AZ^M=^M^M^I^IZULU^M
  740. ;
  741. ;----------end
  742.  
  743.  
  744.                                        USING VDE-SP WITH SCRIPTOR
  745.  
  746. If you intend to use SCRIPTOR with VDE-SP - still just about 
  747. indispensable if you have to number scenes - create a format with 
  748. the following parameters:
  749.  
  750. scene margins:           1:60
  751. dialogue margins:    11:44
  752. parenthetical margins:  16:36
  753. name column:             21
  754. transitions column:       41
  755. page number column:       55
  756. continued strings:  CONTINUED
  757. bottom margin:            2
  758. max white space:            5
  759. wrap tolerance:            0
  760. page offset:           18
  761. WordStar mode             yes
  762.  
  763. If for any reason you need to covert your screenplay files to 
  764. WordStar-compatible files, you need only give the VDE command ^KN 
  765. (or ESC-N) and answer the "filename?" prompt with "[w" and save 
  766. the file to disk. The resulting file should be very nearly 
  767. completely compatible with WordStar. All other word processors 
  768. are able to process the ASCII-type files produced by VDE- SP.
  769.  
  770. If you need to keep files in both ASCII and WS form, it's 
  771. possible to use VINST to designate automatically the operation 
  772. mode for certain file extensions, say N for files with an ASC 
  773. extension, W for those with a WP extension.
  774.  
  775.  
  776.                                                    FINAL THOUGHTS
  777.  
  778. VDE-SP is a very simple, very small word processor, but it does 
  779. everything that really needs to be done quickly and efficiently. 
  780. Sometimes in the computers, as elsewhere, less is more. If you 
  781. like speed and simplicity, you may find VDE-SP more useful than 
  782. much larger and more complicated programs that waste your time by 
  783. trying to do your thinking for you.
  784.  
  785. If you have any suggestions or comments on the program or the 
  786. documentation, please leave me a message at LITTERA MAGAZINE, 
  787. Fred Haines, GLENDALE LITTERA RCPM/QBBS, 818/956-6164, or write 
  788. to me at 733 North King's Road  Apt 331, Los Angeles CA 90069.
  789.  
  790.