home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Today - The Disc! 1 / CD-ROM_Today_-_The_Disc_1_April-May_1994.iso / utils / vde / vde164cs / 164c-sp.doc next >
Text File  |  1992-10-02  |  33KB  |  687 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11. =================
  12. V D E 1 6 4 C S P
  13. =================
  14.  
  15.  
  16.  
  17.  
  18. Screenplay Macros for Eric Meyer's
  19. Video Display Editor, Version 1.64c
  20.  
  21.  
  22.  
  23.                                 NOTES TO VERSIONS 1.64b AND 1.64c
  24.  
  25. This latest version of the VDE-SP macros for writing and printing screenplays 
  26. has a couple of minor improvements in the macros themselves, particularly in 
  27. those that set different margins. It occasionally happened, when a single line 
  28. of description or dialogue was mistakenly reformed, that it could not be 
  29. reformed correctly by the use of the ESC-0 or ESC-2 macros. The fixes in this 
  30. version work pretty well to eliminate the majority of such cases, although I'm 
  31. not sure they do in all. A similar problem occurred sometimes with the 
  32. reforming of the trailing piece of dialogue after a page break. Again I'm not 
  33. sure whether the fix works in all cases, but it certainly does in most.
  34.  
  35. In addition, I have added some batch files which the curious user can employ 
  36. to test VDE-SP without going to all the trouble of completely installing a 
  37. program. See QUICKSTARTING VDE-SP below.
  38.  
  39. For all of these fixes and innovations I am indebted to Joel Anderson, who 
  40. solved some of the problems and put me on the right track on the others. He 
  41. also thought of the quickstart batch files.
  42.  
  43. Improvements to the macros of v1.64c are largely internal - a number of the 
  44. macros have been shortened, which allows more room for customized character 
  45. name macros - but a feature has been added which lifts the cursor to the 
  46. middle of the screen on the exercise of any macro.
  47.  
  48. In addition I have added a DUMMY character name (type ESC-D to see how it 
  49. works), which makes it easier to add character name macros to VTK (textfiles 
  50. created with VMC) files - just copy the macro for DUMMY and adjust the key and 
  51. name to suit. In my personal batch files I load the relevant VTK file for the 
  52. particular project along with the actual text files so I can easily switch to 
  53. that file, add one or more character names macros, and, by shelling out via 
  54. ALT-R, compile a new VDK file, load it with ALT-U, and continue working.
  55.  
  56. The function key overlay file, VDF, also includes my macros for running 
  57. ShareSpell on the F11 key and calling up a timed and dated notes file on F12. 
  58. These will have to be rewritten to reflect your system's path or they can 
  59. simply be deleted if you have no use for them.
  60.  
  61.  
  62.                                                          NOTES TO VERSION 1.64
  63.  
  64. In VDE 1.64 the 'place mark' commands have been revised to remove confusion 
  65. between them and the ^Z character (1Ah). ^KM (not ^PZ) now sets a place mark. 
  66. ^QM (not ^QZ) goes to a place mark. The mark displays as a highlighted '!.' ^PZ 
  67. now inserts an actual ^Z, as you would expect. Since these were used in some 
  68. of the macros of VDE-SP 1.63, they have had to be changed for v1.64.
  69.  
  70. Also in v1.64 the definition of 'ASCII document' has been 'corrected.' 
  71. Filemode /A is now truly ASCII text, and therefore will NOT interpret control 
  72. codes as printer commands, allowing them to display and print directly. A new 
  73. filemode /D (Document) is now the default; it DOES interpret control codes (as 
  74. /A used to do). Since underlining or italics are often used in screenplays, 
  75. VDE-SP should now be installed with the new 'document' mode as the default.
  76.  
  77. In v1.64 of VINST, the printer driver option for 'Reserve header space?' 
  78. option has been replaced (and thus there is no longer an 'R' option in the 
  79. Print command ^KP). Instead there are two new driver settings, 'Top margin if 
  80. header used' and 'Lines between header and text', which in combination offer 
  81. more flexibility. These should 
  82.  
  83.                                                          NOTES TO VERSION 1.63
  84.  
  85. These screenplay macros have been revised to take counteract a new feature in 
  86. version 1.63 of VDE, which automatically runs whichever macro is assigned to 
  87. ESC-0. In earlier versions of VDE-SP ESC-0 was used to position the cursor to 
  88. write a character's name and change the margins to those for dialogue. Since 
  89. that clearly causes problems if it runs automatically every time you load VDE- 
  90. SP, I have switched ESC-0 with the former ESC-1, which merely resets the 
  91. margins to those used for description and action. Those who have been using 
  92. the macros will probably find it only takes a few minutes of working with the 
  93. new set up to get used to it. 
  94.  
  95.  
  96.                                                                   INTRODUCTION
  97.  
  98. VDE-SP is a set of macro and function key definitions that makes Eric Meyer's 
  99. Video Display Editor into a screenplay processor which writes, formats, pages, 
  100. and prints out screenplays in standard industry format.
  101.  
  102. VDE allows you to define ten macros you invoke by typing the ESCAPE key and 
  103. any one of the ten numeral keys from 1 through 0. VDE-SP uses all ten of them. 
  104. Only the five macros ESC 1, 2, 3, 9, and 10 are used for writing the 
  105. screenplay. ESC 4 through ESC 8 are used afterward, for paging. In addition 
  106. eleven of the 40 function keys have been programmed to be helpful, though they 
  107. aren't strictly necessary.
  108.  
  109. The files produced by VDE-SP are simple ASCII files, nearly WISYWIG (What You 
  110. See Is What You Get), and with no embedded control codes other than occasional 
  111. ^S underline codes. They are compatible with Scriptor (c) and can be imported 
  112. into other MS/DOS (c) word processors such as WordStar (c), Microsoft Word 
  113. (c), or WordPerfect (c).
  114.  
  115.  
  116.                                                           LIMITATION OF VDE-SP
  117.  
  118. VDE-SP does not number shots. If you find that necessary - it usually isn't 
  119. for reading scripts - you either have to do it by hand or run your finished 
  120. VDE-SP files through Scriptor (c).
  121.  
  122.  
  123.                                                     WRITING AND EDITING MACROS
  124.  
  125. Here's what the five writing and editing macros do:
  126.  
  127. ESC 0 sets wide margins for scene description and action at columns 1 and 60 
  128. and reforms the paragraph under the cursor to conform to the new margins.
  129.  
  130. ESC 2 sets narrow margins for dialogue at columns 11 and 44 and reforms the 
  131. text under the cursor.
  132.  
  133. ESC 3 inserts a parenthetical, or "wryly." Type the text you want inside the 
  134. parentheses, delete the space before the close parenthesis, and exit with ^X. 
  135. If there is dialogue text beyond the parenthesis, it will be reformed to the 
  136. dialogue margins.
  137.  
  138. You continue in dialogue with no further command. Pay no attention to the fact 
  139. that the cursor is column 1 - the margins are still set for dialogue.
  140.  
  141. VDE-SP doesn't set special margins for parentheticals. They are positioned at 
  142. the first tabstop, within normal dialogue margins. If your parenthetical is so 
  143. long you have to wrap it with a carriage return to a second line, you can do 
  144. that, but you should consider going back to description margins and writing it 
  145. out as a sentence.
  146.  
  147. ESC 9 spaces down two lines and types CUT TO in the correct position for a 
  148. transition, at the third tabstop. CUT TO is the only transition I ever use - 
  149. to suggest a radical change in time or place. You can use DISSOLVE TO or FADE 
  150. OUT by typing F7 (function key 7) or F8 respectively. These work the same was 
  151. as ESC 0.
  152.  
  153. If you really want to get wild and use something like CHINESE DOLLY TO, do it 
  154. by hand. Just type two carriage returns, three tabs, and type whatever 
  155. transition phrase you like.
  156.  
  157. ESC 1 sets dialogue margins and positions the cursor to the point where you 
  158. type the character's name. As with ESC 9, you may do ESC 1 at the end of a 
  159. block of description or a block of dialogue, the result is the same.
  160.  
  161.  
  162.                                                                  FUNCTION KEYS
  163.  
  164. Eleven function keys have been programmed.
  165.  
  166. F1 puts the line ahead of the cursor into upper case. This allows you to type 
  167. the character's name or a shot line in lower - or in upper and lower - case, 
  168. then upcase it all retrospectively, so to speak, with a single keystroke. It 
  169. makes no difference whether you do this before or after typing the carriage 
  170. return after the character's name or the two carriage returns after the shot 
  171. line.
  172.  
  173. SHIFT F1 reverses the action of F1 in case you made a mistake. It puts the 
  174. entire line into lower case though, so, if you had any capital letters in the 
  175. original line, you will have to go back and replace them by hand.
  176.  
  177. F3 types out INT. and leaves the cursor in position to type the description of 
  178. the location. F4 types out EXT.
  179.  
  180. F5 types - DAY, including the space in front of the dash. F6 types - NIGHT. 
  181. Both of these keys will also capitalize any description you have typed in 
  182. lower case between INT. or EXT. and - DAY or - NIGHT.
  183.  
  184. As described above, F7 inserts DISSOLVE TO and F8 inserts FADE OUT in the 
  185. appropriate place.
  186.  
  187. Function keys 2, 9, and 10 are used only during paging.
  188.  
  189.  
  190.                                                                  PAGING MACROS
  191.  
  192. VDE-SP no longer produces one long file with no page breaks. This new version 
  193. requires a default page length set with VINST, but, before printing it out, 
  194. you have to page it by hand with the help of the ESC 4, 5, 6, 7, and 8 macros.
  195.  
  196. There are four kinds of page breaks in screenplays, each corresponding to one 
  197. of the ESCAPE sequences 4 through 7.
  198.  
  199. The simplest is a break between scenes, which inserts nothing but a header 
  200. line and page number at the top of the trailing page (ESC 4).
  201.  
  202. The most frequently used is a break within a scene, which requires the 
  203. addition of a CONTINUED string at the bottom right of the leading page and 
  204. another at the top left of the trailing page two lines below the header and 
  205. page number line (ESC 5).
  206.  
  207. Most of your page breaks will be one of these two, but occasionally the 
  208. natural place to break the page falls in the middle of a block of description 
  209. or dialogue which is so long that pushing all of it over to the trailing page 
  210. would leave far too much white space at the bottom of the leading page. VDE-SP 
  211. has macros for these cases, one for dividing a long block of description (ESC 
  212. 7), two more for dividing a long speech (ESC 7 and 8).
  213.  
  214. Whether to divide is your decision, but the general rule is to divide if not 
  215. doing so would leave more than five lines of white space in addition to the 
  216. normal minimum bottom margin of two lines.
  217.  
  218. ESC 4 starts a new page between scenes, by embedding a ^L formfeed, and adds a 
  219. header line and page number symbol # at the top of the new page.
  220.  
  221. ESC 5 starts a new page in the middle of a scene by putting in a CONTINUED 
  222. string, embedding a ^L formfeed, reading in your header line, and adding 
  223. another CONTINUED string at the top of the new page.
  224.  
  225. ESC 6 divides a long paragraph of description between sentences, adds 
  226. CONTINUED strings, formfeed, and header, and reforms the text pushed over to 
  227. the new page to the description margins.
  228.  
  229. ESC 7 divides a long speech between sentences, adds CONTINUED strings and 
  230. header, then stops to allow you to type the character's name at the top of the 
  231. trailing part of the speech - in upper or lower case. You must then type ESC 8 
  232. to reposition and reform the trailing part of the speech.
  233.  
  234.  
  235.                                                               RULES FOR PAGING
  236.  
  237. You need only decide which of the four kinds of page break is appropriate and 
  238. type the corresponding ESCAPE sequence. VDE-SP will find the correct place to 
  239. insert the page break and advance the cursor to the next page end. To make 
  240. your decision you need to keep a few simple rules in mind.
  241.  
  242. The macros which make the page breaks automatically advance you to line 1 of 
  243. the next page. In all other circumstances function key 10 advances to line 1 
  244. of the next page, and function key 9 backs up to line 1 of the preceding page. 
  245. Use F10 to find the first page break starting paging at the top of a file.
  246.  
  247. Since all the paging commands automatically advance you to the last line of 
  248. the next page, you will normally need to measure off a page this way only when 
  249. you start a new file. Since the cursor always falls on line 1 of the next 
  250. page, the actual page break will always be made one or more lines above.
  251.  
  252. To find the actual page break, examine the text above the cursor line - line 1 
  253. - to find either one or two blank lines. VDE recognizes a single blank line as 
  254. an appropriate place to insert a page break in a scene, and two blank lines as 
  255. an appropriate place to insert one between scenes.
  256.  
  257. If two blank lines - a break between scenes - are first above the cursor line, 
  258. type ESC 4. Otherwise type ESC 5. In the first instance VDE-SP will make the 
  259. page break at the shot line, which it identifies by the fact that it is 
  260. preceded by two blank lines. In the second case, VDE-SP will make the break at 
  261. the beginning of the description or the dialogue, depending on which is 
  262. closest above the cursor line. It identifies the correct location by the 
  263. single blank line above blocks of description or dialogue.
  264.  
  265. In a small number of cases there will be no blank lines in the first five or 
  266. six lines above the cursor, in which case you may want to divide on the text, 
  267. whether it be description or dialogue. As a rule such breaks are permitted 
  268. only between sentences, and VDE-SP will make them only there.
  269.  
  270. In the case of description there must be a break between sentences at least 
  271. three lines above the cursor line before you can use ESC 6. If there isn't, 
  272. use ESC 4 or 5 and accept a lot of white space at the bottom of the preceding 
  273. page. With dialogue there must be a break between sentences at least four 
  274. lines above the cursor line before you can use ESC 7 and 8. If there isn't, 
  275. use ESC 5.
  276.  
  277. To identify a break between sentences VDE-SP looks for a space preceded by a 
  278. period, question mark, or exclamation point. Anything else - semicolons, 
  279. quotation marks, dashes, commas - won't work.
  280.  
  281. The three and four-line limits are required by the extra (more) and CONTINUED 
  282. strings inserted when you divide long description or dialogue.
  283.  
  284.  
  285.                                                           PAGING FUNCTION KEYS
  286.  
  287. Several function keys have been programmed to assist with paging. If you fear 
  288. you made a mistake, or just want to see what the last page break looks like, 
  289. F9 will return you to it. F10 will then position the cursor to the top of the 
  290. next page. A simple way to check the paging script is to start at the top and 
  291. type F10 repeatedly to step through the script page by page.
  292.  
  293.  
  294.                                                    MAKING A PAGE BREAK BY HAND
  295.  
  296. From time to time there are cases so atypical - a song text, for example - 
  297. that you will have to make the page break by hand. Just move all left over 
  298. text down below line 1 of the next page. Move the cursor to line 1 of the 
  299. next page with F10, then ^KR (to read in a file), then, at the "filename" 
  300. prompt, HEADER, and carriage return. Dress up the damage and type F10 to get 
  301. to the bottom line of the next page.
  302.  
  303.  
  304.                                                                THE HEADER FILE
  305.  
  306. At every page break VDE-SP searches for and reads in a file called HEADER 
  307. which must be available in the directory in which you are working. You make up 
  308. this file yourself before you start paging. If you wish to use VDE's automatic 
  309. header, the HEADER file should be zero-length, but it must be there. To create 
  310. a zero-length file, open a file called Header, type something and save it, 
  311. then delete everything and save it again.) 
  312.  
  313. If you prefer to use custom headers, HEADER should be a simple text file which 
  314. looks like this:
  315.  
  316. Your Title Here - rev. 4.8                             #<
  317. <
  318. <
  319. <-- return cursor to this point before saving file
  320.  
  321. If you want to use VDE automatic numbering feature, the # symbol should be 
  322. embedded in the file with a CTRL-P rather than simply typed.
  323.  
  324. I've put in the left angle brackets to indicate where you would see Hard 
  325. Carriage Returns if you toggled them on with ^OB. So HEADER consists of the 
  326. header line with a number symbol in column 56 (at the fourth and last 
  327. tabstop), plus two blank lines below it.
  328.  
  329. The standard screenplay format used by SCRIPTOR uses a top margin above the 
  330. header of just two lines, and a two-line margin at the bottom of the page. 
  331. Ideally the header line should print on line 3 of your page. My Hewlett- 
  332. Packard LaserJet IIp printer, and, I suppose, other page printers will not 
  333. allow anything to be printed until line 4, and I just have to live with that. 
  334. If your printer allows printing in line 1 you must set VDE's top margin 
  335. default with VINST (VDE Install) to 2.
  336.  
  337. Note that the page number symbol should be embedded - type CTRL-P, then the 
  338. number symbol. This facilitates automatic page numbering with the ^K# command.
  339.  
  340. If this file isn't present in the default directory with your screenplay 
  341. files, VDE-SP will report an I/O (input/output) error at every attempt to make 
  342. a page break. It tries to read the file in, but can't find it. Incidentally, 
  343. you can always make up a HEADER file on the fly - just go to the bottom of 
  344. your file, type out an appropriate header, mark it as a block, and write it to 
  345. the disk as HEADER with the ^KW command, then delete the block.
  346.  
  347. If you need a two-line header VDE-SP will automatically compensate for the 
  348. extra line - or lines.
  349.  
  350. If you need only a single-line header and do not have to deal with A and B 
  351. pages for inserts, you may prefer to use VDE's automatic header feature. If 
  352. so, set your page length to three lines less than normal and make up a zero- 
  353. length HEADER file. Preceding the header text with < will set the text flush 
  354. left:
  355.  
  356.   "<Survive the Savage Sea v3.0" ns
  357.  
  358. Be sure to set the wide, scene description margins before paging, because the 
  359. page number will not appear in column 56 when dialogue margins are set.
  360.  
  361.  
  362.                                                            NUMBERING THE PAGES
  363.  
  364. If you use VDE'S automatic header and page numbering, you can ignore this 
  365. section.
  366.  
  367. Otherwise, when you have finished paging every page will still have a # symbol 
  368. embedded (probably highlighted) where the page number should be. Make sure 
  369. that margins are set wide by typing ESC1, mark the entire file (or that part 
  370. to be printed) as a block, then type the command ^K#. You will be prompted for 
  371. a starting number, 2 if you're still in the first file, since page 1 does not 
  372. carry a header or page number.
  373.  
  374. In the event you want to number the pages manually, return to the top of the 
  375. file with ^OR, turn INSERT mode off with ^V (the INS flag will disappear from 
  376. the status line), and set NUM LOCK on so you can use the keypad to type 
  377. numbers.
  378.  
  379. Type F2 to take you to the first #, which should be on the second page, since 
  380. there is neither header nor page number on page 1. Type 2, then F2 again, type 
  381. 3, F2, 4, F2, 5, and so on.
  382.  
  383. This is slightly cumbersome, but once you get the hang of it you should be 
  384. able to number forty pages in as many seconds, and you retain full control - 
  385. if you have to preserve the numbering of an earlier draft, it's easy to number 
  386. A and B pages where you need them.
  387.  
  388.  
  389.                                                           FINISHING OFF A FILE
  390.  
  391. When you come to the end of any file but the last one you will probably end 
  392. with a page that is less than full length. Cut this last, partial page off and 
  393. paste it into the top of the following file before you page it. This permits 
  394. you to print each file out separately, without having to chain them.
  395.  
  396. Note that a complete screenplay is too long to fit into a single VDE file, 
  397. which will run to about 80K, but should be kept shorter to allow plenty of 
  398. room for cutting and pasting whole scenes and pages. You should break your 
  399. screenplay into three or more files, all of which can be loaded into VDE-SP at 
  400. once, permitting easy cutting and pasting among them. A search or search and 
  401. replace started in one file can be carried on in the following files by the ^L 
  402. (continue search) command, or - new in v1.63 of VDE itself - you can simply 
  403. use the M (Multifile) option to run the operation through all loaded files. 
  404.  
  405. To load your entire screenplay as three separate files, use this command at 
  406. the DOS prompt:
  407.  
  408.    VDE-SP SCRIPTa.SCR,SCRIPTb.SCR,SCRIPTc.SCR;SCRIPT.VDK
  409.  
  410. The three files A, B, and C will be loaded as a ring - use ^N to move to the 
  411. Next file in the ring, ^B to move Back to the preceding file. See the VDE163 
  412. documentation for windowing, cutting and pasting, and other features.
  413.  
  414. The ;SCRIPT.VDK part of the command loads a set of VDE-SP macro keys 
  415. specifically for the project if you choose to install characters' names on the 
  416. alphabetical macro keys.
  417.  
  418.  
  419.                                                 KEEPING TRACK OF WHERE YOU ARE
  420.  
  421. VDE's running page count will give you an approximate figure. It cannot be 
  422. exact because the actual paging changes the line count. The ^KI (information) 
  423. command will show you the length of the file in K, the number of words in it, 
  424. the number of bytes used, and the percentage of the available space used.
  425.  
  426.  
  427.                                                 SETTING PAGE LENGTH WITH VINST
  428.  
  429. The page length should be set with VINST (in the printer driver section) to 
  430. the highest number your printer can print on the page, up to 64 lines. If your 
  431. printer is capable of printing on line 1 of the paper, you set VDE's top 
  432. margin to 2 with VINST. Most page printers do not allow printing on lines 1, 
  433. 2, and 3 of the paper, forcing a 'top margin' of three lines, so you do not 
  434. want to set any additional top margin in your printer driver. Since a sheet of 
  435. paper measures 66 lines, and my LaserJet does not allow printing in the top or 
  436. bottom three, my maximum usual page length is 60 lines, and that's the number 
  437. I set in the printer driver in VDE.
  438.  
  439.  
  440.                                                                   PRINTING OUT
  441.  
  442. To print out, type ^KP and, at the "options" prompt, a carriage return. The 
  443. correct margins and placement on the page will have been installed in the 
  444. printer driver by VINST.
  445.  
  446. I always rename my master files with the ^KN (name) command before paging and 
  447. printing out, from, say, SCRIPTa.SCR to SCRIPTa.PRN, leaving my master files 
  448. unpaged. This makes it considerably easier to rewrite, restructure, and 
  449. repage.
  450.  
  451. This is also the best way to print out the day's work - just mark the new work 
  452. as a block and write it out to a temporary file, then page and print that out 
  453. instead of your whole master file. If you just want a quick and dirty printout 
  454. of a couple of pages and don't care whether they're page or not, mark them as 
  455. a block and type B (for block) at the options prompt. You can also invoke the 
  456. VDE automatic header with "" or "<text>" to give yourself a top margin and 
  457. page numbers. If you include ^T, ^D, or ^F inside the quotes the time, date, 
  458. or filename will be printed in the header.
  459.  
  460.  
  461.                                                           QUICKSTARTING VDE-SP
  462.  
  463. For a limited test of VDE-SP without the bother of fully installing the 
  464. program, you can use one of the three batch files called WRDINSRT.BAT, 
  465. INSERT.BAT, or STRIKOVR.BAT included in this library.
  466.  
  467. You must first copy the VDE.COM you use for your normal word processing into 
  468. the directory with these files. Select the batch file which corresponds to the 
  469. way you have installed VDE.COM to work in Word Insert, Insert, or Strikeover 
  470. mode. Then type at the command line, for example:
  471.  
  472.   WRDINSRT TEST
  473.  
  474. The batch file will temporarily covert your VDE.COM into a VDE-SP.COM and load 
  475. a fresh (empty) file called TEST.A. The temporary installation of VDE.COM will 
  476. be set up for a monochrome monitor (although it should work well enough on a 
  477. color monitor for test purposes) with no VGA or EGA compatibility. None of the 
  478. batch files employs a printer overlay, so, while you can see how the 
  479. pagination macros work on the screen, they are not likely to work correctly 
  480. when you print out.
  481.  
  482.  
  483.                                                              INSTALLING VDE-SP
  484.  
  485. To install VDE-SP make a copy of your installed VDE with the DOS COPY
  486. command:
  487.  
  488.   COPY VDE.COM VDE-SP.COM
  489.  
  490. Then type
  491.  
  492.   VINST VDE-SP
  493.  
  494. At this point you must whether you wish to work principally in INSERT, WORD 
  495. INSERT, or STRIKEOVER mode. VDE16xSP contains three different VDK overlays for 
  496. the macro keys and three different VDF overlays for the function 
  497. keys. They are called INSERT.VD?, WRDINST.VD? and STRIKOVR.VD?.
  498.  
  499. Select M for Macro Key installation, then R to read in one of the three VDK 
  500. overlays. Exit, select F for Function Key installation, and read in the 
  501. equivalent VDF overlay.
  502.  
  503. Exit and select O from the menu for Options, and set
  504.  
  505.   Default insert on: Y
  506.   Left margin column: 1
  507.   Right margin column: 60
  508.   Align new page with screen: N
  509.   Variable tab columns: 16 : 21 : 41: 56 ... and all the rest 0
  510.  
  511. An option new from VDE v1.61 on allows you to determine whether the ^QI, ^QN, 
  512. and ^QL commands, which take you to the top of a new page, also place that 
  513. first line of the new page at the top of the screen. Do not select this option 
  514. for VDE-SP, since, when you are paging, you will want to see a number of lines 
  515. above the new page to decide which kind of page break is required. Therefore, 
  516. 'Align new page with screen' must be set to 'N.'
  517.  
  518. Select P from the menu for Printer and set
  519.  
  520.   Page length: actual printer page length <= 64
  521.   Top margin: 0 or 2, depending on type of printer
  522.   Reserve space for header: N
  523.   Left margin, columns: 18
  524.  
  525. If your printer cannot be adjusted to print at the left edge of the paper - 
  526. many dot matrix and page printers can't - adjust the left margin figure to 
  527. whatever will start printing 1.8 inches from the left edge of the paper. This 
  528. will seem very far over to the right until you bind the script and lose half 
  529. that white space on the left.
  530.  
  531. A very simple printer driver suffices, since the only printer control codes 
  532. used in a screenplay are those to turn underlining or italics on and off. In 
  533. some cases you may want to install different printer initialization strings in 
  534. both of VDE's printer drivers, one to print in fast draft mode, the other to 
  535. print in your highest quality mode for finished copy.
  536.  
  537.  
  538.                                                                       TABSTOPS
  539.  
  540. Four tabstops are set, for the parentheticals position (column 16), the 
  541. character's name (21), transitions (41), and for the page number column (56). 
  542. When you are editing, rather than writing, it's usually easier to get where 
  543. you want to go with tabs than trying to adjust your position for VDE-SP's more 
  544. automated functions.
  545.  
  546.  
  547.                                                          CHARACTER NAME MACROS
  548.  
  549. Many writers like to put the names of their major characters on key macros. 
  550. You can do this by programming the alphabetical keys in VDE itself. If you 
  551. want to follow the pattern I used to program the ESC 0 key, it is:
  552.  
  553.     ^[*I^M^M^Ol11^M^Or44^M^N^I^I^[*W<character's name here>
  554.  
  555. There are several ways to program a key or keys. At the beginning of a 
  556. project, if you know what many of the most used names will be, it's probably 
  557. most efficient to use the macro key installation feature of VINST. When you 
  558. have some names entered, use the (W)rite VDK file command to write 
  559. SCRNPLAY.VDK out to a file in the subdirectory where you will create the 
  560. other SCRNPLAY files. It can then be loaded into VDE-SP - ideally from a 
  561. batch file - whenever you want to work on that project.
  562.  
  563. You can also program an additional character's name on the fly by using VDE's 
  564. ordinary ESC-[ and ESC-] commands, or you can 'record' the macro with ESC-". 
  565. Macros programmed in this way will be lost when you exit VDE unless you 
  566. remember to save them to SCRNPLAY.VDK with the ALT-U command. It's probably 
  567. good practice to use the ALT-U command immediately after creating the macro. 
  568. It only takes a second and avoids the risk of a failure of power or your 
  569. memory before you get a chance to save all the new macros entered in a given 
  570. session with VDE-SP.
  571.  
  572.  
  573.                                                                    BATCH FILES
  574.  
  575. Building VDE-SP into batch files can be particularly efficient. The following 
  576. batch file can be invoked anywhere in the system with a simple two-word 
  577. command to put you into your screenplay, and at the end of it too, where you 
  578. are most likely to be working:
  579.  
  580. rem FILM.BAT (MS/DOS COMMAND.COM)
  581. rem loads all files of current project into
  582. rem VDE-SP
  583. rem
  584. c:
  585. cd \work\film\%1
  586. if exist %1c.scr goto 3_files
  587. if exist %1b.scr goto 2_files
  588. if exist %1a.scr stackey 17 "c"
  589. d:\vde-sp %1a.scr;%1.vdk
  590. goto end
  591. :2_files
  592. stackey ^Q "c"
  593. d:\vde-sp %1a.scr,%12b.scr;%1.vdk
  594. goto end
  595. :3_files
  596. stackey ^Q "c"
  597. d:\vde-sp %1a.scr,%1b.scr,%1c.scr;%1.vdk
  598. :end
  599.  
  600. \WORK\FILM\ is the path in my system to the directory area where all my 
  601. screenplay projects are kept in separate subdirectories named with a 
  602. four-letter mnemonic which I use not only for the subdirectory but for the 
  603. individual files A, B, and C. The full pathname of a file might be
  604.  
  605.   c:\work\film\four\four3.scr
  606.  
  607. In this case, if I typed 'film four' at any DOS prompt, the batch file would 
  608. supply the filename 'four' to the batch file at every point where you see '%1' 
  609. in the commands. The next to last line would be expanded to:
  610.  
  611.   d:\vde-sp foura.scr,fourb.scr,fourc.scr;four.vdk
  612.  
  613. This would load all three files of the screenplay text and the key macro file 
  614. for the 'four' screenplay.
  615.  
  616. Stackey (c) is a shareware program available for downloading as SKEY22.ZIP. It 
  617. supplies keystrokes to the next program to be invoked, in this case VDE-SP, 
  618. and the two codes following the command mean ^Qc - VDE's command to go to the 
  619. end of the file - positioning you at the point where you are most likely to 
  620. want to start work, at the end of the last file, where you most probably left 
  621. off the last time you worked on the project.
  622.  
  623. You can use this batch file by marking it as a block and writing it out to 
  624. \BAT\FILM.BAT - or to any other directory which is on your path. If you don't 
  625. have a \BAT directory on your path, it might be a good idea to create one. If 
  626. you don't have Stackey, either delete those lines or comment them out by 
  627. typing the word 'rem' (remark) in front of them.
  628.  
  629.  
  630.                                                        BATCH FILES FOR HACKERS
  631.  
  632. The same batch file of those using 4DOS as a replacement for MS/DOS 
  633. COMMAND.COM would be:
  634.  
  635. rem FILM.BAT (4DOS)
  636. rem loads all files of current project into
  637. rem VDE-SP
  638. rem
  639. pushd \work\film\%1
  640. if exist %1c.scr goto 3_files
  641. if exist %1b.scr goto 2_files
  642. if exist %1a.scr keystack 17 "c"
  643. d:\vde-sp %1a.scr;%1.vdk
  644. goto end
  645. :2_files
  646. keystack 17 "c"
  647. d:\vde-sp %1a.scr,%1b.scr;%1.vdk
  648. goto end
  649. :3_files
  650. keystack 17 "c"
  651. d:\vde-sp %1a.scr,%1b.scr,%1c.scr;%1.vdk
  652. :end
  653. popd
  654.  
  655.                                                         SCRIPTOR COMPATIBILITY
  656.  
  657. Some writers will also prefer to use Scriptor (c) for paging, scene numbering, 
  658. and printing. VDE's ASCII files are compatible with Scriptor (c).
  659.  
  660.  
  661.                                                           MODIFYING THE MACROS
  662.  
  663. You may eventually want to modify these macros. Evan Slawson has graciously 
  664. permitted me to include his VDE Macro Compiler VMC v1.10 in this package. This 
  665. simple but powerful program allows you to compile macros written out as text 
  666. in an ordinary VDE nondocument file into working overlays which can be loaded 
  667. into VDE or VDE-SP with VINST. Please see Evan's excellent documentation, 
  668. which is also in VDE16SP.ZIP.
  669.  
  670.  
  671.                                                                  LAST THOUGHTS
  672.  
  673. Neither VDE nor the VDE-SP macros nor Evan Slawson's VMC are shareware. All  
  674. have been made available to the community of personal computers users for all 
  675. reasonable purposes, but please do not abuse the privilege. Give credit where 
  676. credit is due, and don't distribute either program as part of a commercial 
  677. package or without its original documentation.
  678.  
  679. If you have problems, comments, or suggestions, contact me on the Writer's 
  680. Guild Bulletin Board (user 161) or on
  681.  
  682. FRED HAINES
  683. Glendale Litera RCPM/QBBS
  684. Sysop Abel Iwaz
  685. CAGLE 818 956-6164
  686.  
  687.