home *** CD-ROM | disk | FTP | other *** search
/ VRML Tools for 3D Cyberspace / VRML_Tools_For_3D_Cyberspace.iso / hsb_beta / manual.txt < prev    next >
Text File  |  1996-07-01  |  41KB  |  943 lines

  1.                   HOME SPACE BUILDER 1.0 (tm)
  2.                   ===========================   
  3.  
  4.                        Restricted Beta2 Version
  5.                        ==================
  6.  
  7.  
  8. Home Space Builder 1.0 is the first inexpensive and powerful 3D+W3 
  9. authoring tool for middle- and low-end computers. It brings  rich 
  10. content and easy-to-create 3D metaphor of Home Space to millions of  
  11. World Wide Web builders. Home Space Builder 1.0 conforms with 
  12. VRML 1.0 (Virtual Reality Modeling Language) standard. We foresee 
  13. the following principal uses of our product:
  14.     - 3D Home Page Builder: design 3D Home Pages  viewable by any 
  15.       VRML browser,
  16.     - 3D Personal Web Organizer: create your own unique views of  
  17.       Web Village, and of Web Life within a natural and convenient  
  18.       3D paradigm,
  19.     - 3D Personal Desktop Organizer: create your own 3D Program 
  20.       Manager, 3D On-Line Help, arrange files and documents within 
  21.       your 3D Home Space, 
  22.     - General: design your own Home Spaces for fun, education, 
  23.       presentation, and other  purposes. 
  24.  
  25.  
  26. ABOUT THIS VERSION
  27. ------------------------
  28.  
  29. This is a restricted version of Home Space Builder 1.0 Beta2. It enables you to learn and 
  30. perform all loading, viewing, and building operations, but does not allow you to save home 
  31. spaces, though you can learn how to save MUS and WRL files.
  32.  
  33. You can purchase full version of Home Space Builder 1.0 Beta2 following links at 
  34. ParaGraph's Web site
  35.  
  36. http://www.paragraph.com/whatsnew/homespce.htm 
  37.  
  38.  
  39. ABOUT THIS MANUAL, AND THE ON-LINE HELP
  40. =======================================
  41. This manual describes the features of Beta2 version which can 
  42. be ordered at ParaGraph InternationalÆs Web Site  
  43. http://www.paragraph.com/whatsnew/homespce.htm starting July 
  44. 20. Beta2 Version is supplied with comprehensive On-line Help. All 
  45. versions of Home Space Builder also contain ôon-the-fly helpö. Help 
  46. string on a certain screen element appears in the bottom row of one of  
  47. the on-screen windows when you position cursor over the element. 
  48.  
  49.  
  50. HARDWARE REQUIREMENTS
  51. =====================
  52. Home Space Builder 1.0 requires at least 386/33, 4MB RAM, color 
  53. monitor with  256 colors or more. To achieve better rendering 
  54. performance, you will need 486/33 or higher, 8 MB RAM.
  55.  
  56. Program files (.EXE, .DLL) take about 1.5 MB of disk space. 
  57.  
  58. Home Space Builder 1.0 runs on Windows 3.1 and later versions, 
  59. Windows NT, Windows 95.
  60.  
  61.  
  62.  
  63. MUS and WRL FILES
  64. =================
  65. You are building your home spaces in the internal format of Home 
  66. Space Builder and save them as .MUS files. As soon as your job is 
  67. completed, you can export home space into VRML format and save it 
  68. as .WRL file. Any consistent VRML browser should be able to load 
  69. this .WRL home space from your 3D Web Site, and to view the scene.  
  70. Please, notice that export VRML format will loose many multimedia 
  71. and attachment features of Home Space Builder which are not 
  72. supported in the current VRML standard. As soon as these features 
  73. appear in the standard, we would include them in the export function.  
  74.  
  75.  
  76. ADVANCED FEATURES OF BETA2 VERSION 
  77. ==================================
  78. We included in Beta2 of Home Space Builder many new multimedia, 
  79. embedding, and other features:
  80.  
  81.     - Drawing Walls and Faces,
  82.     - Applying textures with transparent colors,
  83.     - Sound attachments, and Sound Recording,
  84.     - Attaching and Playing Movies,
  85.     - Creating and replaying Walking Shows,
  86.     - Making extended  attachments (including embedded home spaces, 
  87.       executable modules), Multifunction attachments
  88.  
  89. We also supply Beta2 with extended set of  textures, pictures, and 
  90. sample home spaces. An important improvement made in Beta2 is the 
  91. Save as VRML function which is now in strict conformance with 
  92. VRML 1.0 Final SPEC. 
  93.  
  94. Many people who tried our free Beta1 version asked the same 
  95. question, ôWhat about shapes?ö  This will come soon. The idea behind 
  96. our product  is ôlet us first build home spaces, and then settle themö.  
  97. Each of home spaces you create with Home Space Builder 1.0 will  be  
  98. ready to receive visitors. 
  99.  
  100.  
  101. INSTALLATION
  102. ============
  103.  
  104. Program modules, and Manual:
  105. ----------------------------
  106. Copy a directory HSB and all its content to your hard disk.
  107. This includes the following files:
  108.  
  109. MANUAL.TXT - This file in the plain text format
  110. HSB.EXE      - Home Space Builder 1.0 program
  111. HSBHELP.HLP - On-line help
  112. ACCUSOFT.DLL - DLL file 
  113. CTL3D.DLL    - DLL file 
  114. HTTPC16.DLL  - DLL file 
  115. NS16.DLL     - DLL file 
  116. TREGION.DLL  - DLL file 
  117. LICENSE.TXT - License Agreement
  118.  
  119.  
  120. Sample Home Spaces:
  121. ------------------------
  122. They are located in subdirectories of the directory HSBDEMO on CD-ROM. 
  123. You can either load these samples from CD-ROM or copy them to your hard disk and 
  124. load them from that disk. 
  125.  
  126.  
  127. WHAT YOU SEE ON YOUR  SCREEN, and HOW IT WORKS
  128. ==============================================
  129. User Interface to Home Space Builder 1.0 is very simple. It includes 
  130. the following  six windows:
  131.    - VIEWER WINDOW (also, MAIN WINDOW  or  3D WINDOW)
  132.    - PLANE WALKER WINDOW (also, PLANE BUILDER WINDOW) with HEIGHT SCALE 
  133.      and CAMERA
  134.    - WALKER TOOLBOX
  135.    - BUILDER TOOLBOX
  136.    - CHOOSER WINDOW (COLOR, PICTURE & WALLPAPER TOOLBAR)
  137.    - IMAGE WINDOW
  138.  
  139. Here is what are these windows about:
  140.    - navigate through your 3D scene in the VIEWER WINDOW using  
  141.      the WALKER TOOLBOX buttons; sometimes, you also use the 
  142.      CAMERA to adjust viewpoint and view direction, 
  143.    - you can speed up navigation, jump to any place in the scene, and go 
  144.      through the walls moving PINOCCHIO button in the PLANE WALKER window,
  145.    - build home spaces on the PLANE WALKER window using  the 
  146.      BUILDER TOOLBOX buttons, and adjusting height with the laths of  
  147.      HEIGHT SCALE,
  148.    - paint walls, applying textures, hanging pictures in the VIEWER 
  149.      window; select textures, pictures, and palette in the CHOOSER 
  150.      window,
  151.    - move, resize, delete, zoom pictures in the VIEWER window by 
  152.      using additional buttons from the WALKER TOOLBOX. 
  153.    - edit your pictures in the IMAGE window
  154.  
  155.  
  156. MASTER MODE and GUEST MODE
  157. ==========================
  158. In the GUEST MODE, you can only view and navigate home spaces. 
  159. Therefore, the BUILDER TOOLBOX, and the CHOOSER window do 
  160. not appear on the screen. You can activate them either from the 
  161. WALKER TOOLBOX or by setting  MASTER MODE in the menu. 
  162.  
  163.  
  164. MORE ABOUT NAVIGATING/VIEWING HOME SPACES 
  165. =========================================
  166. The four upper rows in  the WALKER TOOLBOX  provide you with 
  167. 15 self-explanatory navigating/viewing buttons:
  168.     - the six arrows allow you move forward/backward/left/right, and 
  169.       turn left/right, 
  170.     - three little fellows help you move up/down, and return to normal 
  171.       height position,
  172.     - small cameras let you tilt view axis, and return to horizontal view, 
  173.       squares allow you to change view focus (tele/wide/normal),
  174.  
  175. When you press any of these buttons, the PINOCCHIO button and the 
  176. CAMERA in the PLANE WALKER window follow your actions. PINOCCHIO and 
  177. CAMERA give you an alternative way to  navigate 
  178. and view:
  179.     - dragging PINOCCHIO by the end of his nose is a fast-moving 
  180.       substitute for all arrow keys; 
  181.     - moving CAMERA up and down, and tilting it by the handle are 
  182.       the substitutes for little fellows and small cameras; 
  183.     - pressing and holding Tele and Wide buttons gives the same effect 
  184.       as pressing squares. 
  185.  
  186. The difference is that the restless PINOCCHIO can go through the 
  187. walls and jump. Click anywhere on the PLANE WALKER WINDOW, and 
  188. PINOCCHIO will appear right there, quickly changing your viewpoint. 
  189. The WALKER TOOLBOX BUTTONS can do none of these.
  190.  
  191. You can also use keyboard to navigate in the VIEWER WINDOW:
  192.  
  193. 7 , Home                  - rotates left;
  194. 9 , Page Up               - rotates right;
  195.  
  196. 8 , Up Arrow              - moves camera forward;
  197. 5 , 2, Down Arrow         - moves camera back; 
  198. 4 , Left Arrow            - moves camera left;
  199. 6 , Right Arrow           - moves camera right;
  200.  
  201. + (Keypad Plus)           - moves camera up;
  202. -  (Keypad Minus)         - moves camera down;
  203.  
  204. Insert                    -  tilts the camera up;
  205. Delete                    -  tilts the camera down;
  206.  
  207. Press Ctrl with any of these keys to double speed of the corresponding 
  208. motion.
  209.  
  210.  
  211. BUILDING HOME SPACES
  212. ====================
  213. Building home spaces  is similar to sculpture work when you take a 
  214. piece of material and cut off all unnecessary parts. There are three 
  215. buttons on the BUILDER TOOLBOX that allow you create shapes. 
  216. One is ADD BOX TOOL, another is  REMOVE BOX TOOL, the last one is 
  217. DRAW WALLS TOOL. When ADDING a box, you place it into space which 
  218. is virtually unlimited in height and width, whereas its height range 
  219. is bounded by current Lower/Upper Height Level settings of the 
  220. HEIGHT SCALE. The box is solid and transparent from inside, and the 
  221. only non-transparent sides are those which contact the outside space. 
  222. So far, if you  create a box from scratch without prior adjustment of 
  223. its height, the box will only have the outer surfaces of the walls - 
  224. no floor, no ceiling. Moreover, if you drag PINOCCHIO into box, you 
  225. would only see the empty space all around. REMOVING a box, you create 
  226. inner walls inside the previously built construction. To make the floor 
  227. and the ceiling in a building, donÆt forget to adjust height laths 
  228. before you remove a box so that the removed box will be within the 
  229. added box. After the walls are ready, you can cut doors and windows 
  230. by adjusting the height laths and removing boxes from the existing 
  231. home space. Alternatively, you can draw walls by first pressing 
  232. the DRAW WALLS TOOL and then drawing walls of in the PLANE BUILDER WINDOW 
  233. keeping the Left Mouse Button pressed. To complete drawing, click the 
  234. PINOCCHIO button on the BUILDER TOOLBOX. Drawing Faces is a new feature 
  235. which is for now not fully implemented. You can access the Draw Face 
  236. feature from the Menu associated with upper left square button in the 
  237. PLANE BUILDER WINDOW. The difference between walls and faces is that 
  238. (a) a wall is always parallel to a coordinate axis, whereas a 
  239. face can have any direction, (b) a wall is solid and visible from both 
  240. sides, whereas a face is one-sided: it is visible when the triangle 
  241. camera-->starting-point-of-a-face-->ending-point-of-a-face has a clockwise 
  242. orientation. 
  243.  
  244.  
  245. Coordinates
  246. -----------
  247. All the three dimensions: x and y on the PLANE WALKER, and z on the 
  248. HEIGHT SCALE, are measured in the same units. You can think of this 
  249. unit as a meter, foot, whatever. Tile size on the wallpapers is 
  250. measured by the same unit. When you drag the mouse cursor along the 
  251. PLANE WALKER , you can see its coordinates. When drawing a box, you 
  252. can see the x, y coordinates of the current mouse position and the 
  253. current size of the box. 
  254.  
  255.  
  256. How To Add/Remove A Box   
  257. -----------------------
  258. In  order  to  set  vertical size/position of the box, drag upper/lower 
  259. laths on the HEIGHT SCALE. When one of the ADD/REMOVE BOX buttons is 
  260. pressed, click in any place within the PLANE WALKER WINDOW to select 
  261. the upper left corner of the box, and draw a dashed rectangle keeping 
  262. the Left Mouse Button pressed. As soon as you  release the 
  263. Left Mouse Button, the plane size of the box is set. Press Left Button 
  264. once more to fix the box on the plane (the bounding line becomes solid). 
  265. Please, donÆt forget to click the PINOCCHIO button on the BUILDER TOOLBOX 
  266. as soon as you finished adding/removing boxes: otherwise, you remain 
  267. in the ADD/REMOVE mode and are expected to continue drawing operations. 
  268. If you want to undo the job before you fixed the box, just press the 
  269. PINOCCHIO button on the BUILDER TOOLBOX. If you have already fixed the 
  270. box, use the Undo button on this toolbox.
  271.  
  272.  
  273. How To Build A Multi-Level  Construction 
  274. ----------------------------------------
  275.  In order to make two neighboring levels strictly adjacent, click a wall 
  276. of the already built level. You will see the TOP LEVEL MARK of this 
  277. wall on the HEIGHT SCALE. Move the laths of the height scale so 
  278. that the bottom lath fits this mark, and then start building the upper 
  279. level. 
  280.  
  281. When you build a multi-level home space, its plan may well become 
  282. very complicated. There is an important feature that lets you simplify 
  283. the plan. If you click the SET button on the BUILDER TOOLBOX, 
  284. change the Lower/Upper Height Level settings, and choose the Show 
  285. Only Current Level option, you will only see the plan of the vertical 
  286. layer of your building in the PLANE WALKER window. 
  287.  
  288.  
  289. How To Increase Available Height Of The Building
  290. -----------------------------------------------------
  291. Click the SET button on the BUILDER TOOLBOX, and change the 
  292. Upper Height Level.
  293.  
  294.  
  295. Pictures, Colors, and Wallpapers
  296. -----------------------------------
  297. It is difficult to build a really beautiful home space without painting, 
  298. papering, and hanging pictures on the walls. In Home Space Builder 
  299. 1.0, itÆs easy to perform each of these actions: 
  300.     - click one of the Picture, Color, Wallpaper buttons in the 
  301.       CHOOSER WINDOW, 
  302.     - select the needed item,
  303.     - drag and drop it on the surface. 
  304.  
  305. Notice that you can apply Wallpapers to any surface (walls, floor, 
  306. ceiling, lids, whatever), but you can hang pictures only on vertical 
  307. surfaces. 
  308.  
  309. To load pictures or wallpapers from a different location, click the 
  310. desired itemÆs button (Picture, Wallpaper), press the Select Directory 
  311. button at the right of the CHOOSER window and choose the needed 
  312. directory with images.
  313.  
  314.  
  315.  
  316. Image File Formats
  317. ------------------
  318. Currently, Home Space Builder 1.0 supports the following popular 
  319. image formats both for pictures and wallpapers (listed alphabetically 
  320. by extensions): .BMP, .DCX, .DIB, .EPS, .GIF, .JPG , .PCT, .PCX, 
  321. .RLE, .TGA, .WMF, .WPG
  322.  
  323.  
  324. Handling Pictures
  325. -------------------
  326. Four additional buttons on the WALKER TOOLBOX are helpful to 
  327. handle pictures:
  328.     - to move/resize a picture, press the Double-ended Arrow button, 
  329.       target the Two-arrow Picture cursor on the picture, and perform 
  330.       the needed action: 
  331.     - to move a picture, hook it with straight arrow near the down left 
  332.       corner; 
  333.     - to resize a picture, hook it with the tilted arrow near the upper 
  334.       right corner. 
  335.       Note that pictures, unlike wallpapers, can only be resized 
  336.       proportionally. 
  337.     - to delete a picture, press the Crossed Picture button and then click 
  338.       on the picture, 
  339.     - to look closer on a particular picture, press the Target button 
  340.       either on the WALKER TOOLBOX or on the VIEWER WINDOW Menu Bar, 
  341.       and click on the picture, 
  342.     - to get a full-screen image of a picture, press a Magnifier Button 
  343.       either on the WALKER TOOLBOX or on the VIEWER WINDOW Menu Bar, 
  344.       and click on the picture. The image will be loaded into the 
  345.       IMAGE WINDOW. You can then make some manipulations with an 
  346.       image (zoom/unzoom, change brightness, contrast, and gamma-factor, 
  347.       and save the updated image), and have to close the IMAGE WINDOW  
  348.       to return to home space.
  349.  
  350. The difference between the same buttons on the WALKER TOOLBOX and on 
  351. the VIEWER WINDOW Menu Bar is that the former set a mode which will 
  352. perform the action as soon as the tool is selected, while the latter 
  353. perform a one-time operation after the picture is selected.
  354.  
  355. To reset any of the above modes, press the Tilted Arrow button on the 
  356. WALKER TOOLBOX. 
  357.  
  358.  
  359. Handling Wallpapers
  360. -----------------------
  361. Before you apply a wallpaper to a surface, you can adjust the tile size 
  362. and the wallpaper offset . Click on the Details button (ôDö on the 
  363. CHOOSER TOOLBAR), and type in the desired figures. If the tile size 
  364. is greater than the wall, you will see only part of the enlarged 
  365. wallpaper. If the Tile checkbox is not marked, tile size does not apply, 
  366. and the whole wall is covered by a single tile, with its size transformed  
  367. to fit the wall.  
  368.  
  369. In the current version, ôthe parts remember the wholeö. So, if you 
  370. create a box (ADD BOX  TOOL), cut it into two disjoint pieces 
  371. (REMOVE 3D BOX MODE), and then apply a wallpaper to any part 
  372. of  an outer wall (cut into pieces), you will see that the other part is 
  373. also covered  by the same wallpaper. 
  374.  
  375. If you want to make a moving wallpaper: 
  376.      - select  the Details menu,
  377.      - select the Slide Direction checkbox,
  378.      - click any point on the Crossed Circle that will appear to the 
  379.        right to indicate the slide direction. 
  380.  
  381. After you apply the wallpaper, it will be moving. You can stop it by 
  382. pressing the Undo button or by unselecting the Slide Direction 
  383. checkbox. 
  384.  
  385.  
  386. How To Create And Use Albums
  387. ----------------------------------
  388. Hang several pictures one above another on a wall (when moving the 
  389. Hang Picture cursor, center the small cross-like target on the 
  390. successfully hung up pictures). To leaf through the album, click the 
  391. Leaf Through Selected Album button on the VIEWER WINDOW 
  392. Menu Bar or select the Leaf Through Album tool on the WALKER 
  393. TOOLBOX and click the desired album. Selecting the Leaf Through 
  394. Album tool on the WALKER TOOLBOX and double clicking the 
  395. picture, you involve automatic sequencing. To regulate the sequencing 
  396. frequency, click the Picture Attach Editor button and type in the 
  397. desired Exposure Time. Please, notice that the time is measured in 
  398. relative units depending on the performance of your computer: so you 
  399. will need experimenting to set the proper value. To stop automatic 
  400. sequencing, repeat double click on the album. 
  401.  
  402.  
  403. How To Create And Use Movies
  404. ----------------------------------
  405. Movie is a sequence of two or more 2D image files in the same 
  406. directory that have file names with the same prefix followed by a 
  407. sequence number. For example, Home Space Builder interprets the 
  408. following image files as eleven frames of a movie:
  409.    myflik01.gif   myflik02.gif   myflik03.gif   myflik04.gif   
  410. myflik05.gif   myflik06.gif
  411.    myflik07.gif   myflik08.gif   myflik09.gif   myflik10.gif   
  412. myflik11.gif
  413.  
  414. To put movie on a surface of  a home space click the Movie button in 
  415. the CHOOSER WINDOW.
  416. All movies present in the current directory will be displayed in the 
  417. CHOOSER WINDOW in the order of their frames. Pasting, deleting, 
  418. dragging along walls and resizing movies are similar to the same 
  419. Picture operations.  When placed on the wall, it immediately begins 
  420. rolling. The movie can be stopped by pressing the Show Next Album 
  421. Picture button on the WALKER TOOLBOX and making a double 
  422. click on the movieÆs frame in the VIEWER WINDOW. Double click 
  423. again to restart the movie. To roll movie in the reverse direction, 
  424. double click on the frame with the Tab key pressed. Repeating double 
  425. clicks, you subsequently roll the movie in the direct/reverse direction. 
  426.  
  427.  
  428. ATTACHMENTS
  429. ===========
  430. To any picture, album or movie, you can attach Text, Sound Clip, 
  431. Function or List of Functions (Multifunction). You make all 
  432. attachments in the Picture/Album/Movie Attach Editor Window, 
  433. which is activated by pressing Picture Attach Editor button on the 
  434. VIEWER WINDOW Menu Bar. When a picture (album, movie) has 
  435. attachments, cursor over the picture turns into a finger. You can 
  436. double-click on a picture to execute attached function (or list of 
  437. functions). With an Album, you can attach text, sound, and functions 
  438. both to the whole album (default) and to each Picture. To switch 
  439. between these options, select the appropriate radio button Album 
  440. Attach Editor or Picture Attach Editor at the top of Album Attach 
  441. Editor Window. By default, when cursor is over an Album, a text 
  442. attached to the whole Album is displayed in the Info row at the bottom 
  443. of the VIEWER WINDOW, and Album functions are performed. To 
  444. see the text attached to a picture, and to execute functions individually 
  445. attached to a Picture, press the Tab key, and click on the picture. 
  446.  
  447. In what follows, we briefly describe all attachments and functions. 
  448.  
  449.  
  450. How To Attach Text
  451. ------------------
  452. Click on the picture and press the Picture Attach Editor button on the 
  453. VIEWER WINDOW Menu Bar. Enter the text into the upper left area 
  454. of the Picture Attach Editor Window (the text can have multiple rows).
  455.  
  456. How To View Attached Text
  457. -------------------------
  458. When you drag the mouse cursor over a picture, you see the first row 
  459. of the attached text in the Info bar under the VIEWER window. To see 
  460. the whole text in a special window,  point the mouse cursor on a 
  461. picture and click the Right Mouse button.
  462.  
  463. How To Attach, Play, And Record Sound Clips
  464. -------------------------------------------
  465. Sound Clip is a Windows .WAV file. You can attach .WAV files to a 
  466. picture, albums, and movie.  To attach a .WAV file click one of the 
  467. above objects to select it and then click the Picture Attach Editor 
  468. button in the VIEWER WINDOW Menu Bar. You can either select 
  469. prepared sound fragment pressing  the Browse button in the Picture 
  470. Attach Editor Window or immediately record any sound 
  471. accompaniment pressing the Record/Stop buttons. Duration of the 
  472. recorded fragment should not exceed 30 seconds (follow the recording 
  473. time indicator). Press the Play button to listen to the attached 
  474. fragment. You can repeat recording, in which case previous fragment 
  475. is automatically deleted. To enable playing attached .WAV files, select 
  476. the object and click the Play Sound button  in the VIEWER WINDOW 
  477. Menu Bar. In Master Mode, you can also press the Play Sound button 
  478. on the WALKER TOOLBOX.  In this mode, cursor in the left corner 
  479. of the Info bar in the VIEWER WINDOW indicates sound 
  480. attachments for pictures. To play sound attachment, click on the 
  481. picture.
  482.  
  483. How To Select and Play Background Music
  484. ---------------------------------------
  485. MIDI (Musical Instrument Digital Interface) is a standard for 
  486. electrically connecting instruments to a computer, and for storing 
  487. music in computer files. A MIDI sound sequence is a list of two or 
  488. more MIDI files that are played in order. To create MIDI-file list, 
  489. choose the Midi Player item in the VIEWER WINDOW Menu. Set the 
  490. required directory in the Select MIDI File Dialog Box, and 
  491. subsequently select and Add .MID  files to the Play List. To delete a 
  492. file from the list, select it in the Play List column and press the 
  493. Remove button. To delete all files (to clear up the list), press the Clear 
  494. button. To each home space, a single Play List can be connected; it is 
  495. saved together with the home space and is automatically replayed after 
  496. you loaded  .MUS  file. To start playing a Play List which consists of a 
  497. single MIDI-file, press the Start List button in the Select MIDI File 
  498. Dialog Box. To stop playing, select the Midi Player option in the 
  499. VIEWER WINDOW Menu and press the Stop button in the Select 
  500. MIDI File Dialog Box. You can pre-play MIDI-files pressing the Play 
  501. button in this window.
  502.  
  503. The following is a brief description of all Functions that can be 
  504. attached to a picture, album, and movie.
  505.  
  506. None
  507. ----
  508. Deletes all functions attached to a picture
  509.  
  510. Conditional Exit               
  511. ----------------
  512. HSB quits with prompt.
  513.  
  514. Unconditional Exit
  515. ------------------
  516. HSB quits without prompt.
  517.  
  518. Load 3D Space File           
  519. ------------------
  520. When this function is executed, HSB closes the currently open 3D 
  521. Space and opens another 3D Space. When you select this function in 
  522. the Picture Attach Editor Window,  you are required  to browse MUS 
  523. files and select desired 3D Space that will be loaded when the function 
  524. is executed. Full path to this file is then displayed in the Parameter 
  525. row of  the Picture Attach Editor Window. 
  526. This function gives you unlimited opportunities to link Home Spaces 
  527. together on your computer or on a local network. 
  528. There are several additional options you can use when loading new 3D 
  529. Space from inside the existing 3D Space: 
  530.     - You can open new 3D Space in the Default Mode (as defined in 
  531.       the Settings, see below), in the Master Mode or in the Guest Mode
  532.     - You can Enable Walking Show associated with a new 3D Space, 
  533.       and if enabled, you can Cycle Walking Show
  534.     - You can prohibit resizing of current VIEWER WINDOW
  535.     - You can disable HSB Title associated with a new 3D Space
  536.     - You can disable the following windows for a new 3D Space: 
  537.       PLANE WALKER/BUILDER, CHOOSER, WALKER TOOLBOX
  538. To involve these options, check the Advanced Options box in the 
  539. Select 3D Space File Window when attaching the function to a 
  540. Picture, Album or Movie.
  541.  
  542.  
  543. Load Any Program           
  544. ----------------
  545. HSB starts the specified program with any parameters entered in the 
  546. Parameters row. When you select this function in the Picture Attach 
  547. Editor Window,  you are required  to browse EXE;  PIF; COM;  BAT 
  548. files and select needed executable module which will be launched  
  549. when the function is executed. You can pass parameters to the 
  550. executable module by typing them  in the Parameter row of  the 
  551. Picture Attach Editor Window. 
  552. This function enables you to design your Home Space as a  3D 
  553. Program Manager.
  554.  
  555. Create New 3D Space
  556. -------------------
  557. HSB opens new 3D Space as if the New button on the BUILDER 
  558. TOOLBOX was pressed.
  559.  
  560. Activate ôOpen 3D Spaceö Dialog
  561. ------------------------------------
  562. HSB opens the same dialog box as is invoked by choosing the Open 
  563. 3D Space item in the menu, and offers you to select a Home Space that 
  564. will then be loaded instead of current Home Space.
  565.  
  566. Activate ôSave 3D Spaceö Dialog
  567. -----------------------------------
  568. HSB opens the same dialog box as is invoked by choosing the Save 3D 
  569. Space item in the menu, and offers you the same actions. 
  570.  
  571.  
  572. Activate ôCopy Allö Dialog
  573. --------------------------
  574. HSB opens the same dialog box as is invoked by choosing the Copy 
  575. All item in the menu, and offers you the same actions. 
  576.  
  577. Switch to ôMasterö Mode
  578. -----------------------
  579. Switches current HSB mode to the Master Mode.
  580.  
  581. Switch to ôGuestö Mode
  582. ----------------------
  583. Switches current HSB mode to the Guest  Mode.
  584.  
  585. Activate Image Window
  586. ---------------------
  587. HSB opens the IMAGE WINDOW and loads into it a picture to which 
  588. the function is attached or  the currently  displayed picture of the 
  589. album or frame of the movie. 
  590.  
  591. The next four functions are self-explanatory:
  592.  
  593. Play Attached Sound
  594. -------------------
  595. Stop Playing Sound
  596. ------------------
  597. Start Playing MIDI List
  598. -----------------------
  599. Stop Playing MIDI List
  600. ----------------------
  601.  
  602. Play .AVI or .FLI files
  603. -----------------------
  604. HSB starts playing one of the standard Windows movie files (.AVI or 
  605. .FLI). When you select this function in the Picture Attach Editor 
  606. Window,  you are required  to browse AVI; FLI files and select the 
  607. needed one (its name with full path will be displayed in the Parameter 
  608. row). Unlike the ônativeö HSB movies, these files are replayed in a 
  609. separate on-screen window.
  610.  
  611. Link to Universal Resource Locator
  612. ----------------------------------
  613. HSB opens the Select URL Dialog Box, allowing you to type in or 
  614. paste URL Name which appears in the Parameter row. 
  615.  
  616. How to Link To URLs
  617. -------------------
  618. Home Space Builder 1.0 is neither a VRML nor a HTML browser, but 
  619. it can communicate with HTML browser Netscape 1.1. When you 
  620. double click on a picture with the attached URL (as always, there is a 
  621. ôfinger cursorö indicating that the picture has an attached URL), this 
  622. URL is transferred to Netscape 1.1.  If  the URL is correct, Netscape 
  623. loads the resource. We do not guarantee proper communication with 
  624. any other HTML browser. Please, remember: when running Home 
  625. Space Builder with Windows NT, Netscape 1.1 must be open when 
  626. you are linking to an attached URL. 
  627. This feature gives you unlimited opportunities to create your own 
  628. views of  WWW within a convenient 3D environments. A simple 
  629. example of  home space serving as Personal Web Organizer is shown 
  630. in our sample file WEBORG1.MUS.
  631.  
  632.  
  633. Multifunction
  634. -------------
  635. The Multifunction attachment is an indispensable feature to create 
  636. Walking Shows (see below). When Selecting the Multifunction item in 
  637. the Picture Attach Editor Window, HSB displays the Multifunction 
  638. Editor Dialog Box. You form and/or modify the list of attached 
  639. functions. using the Add Function To Selected List, Delete, Clear All, 
  640. Up and Down  buttons. To play the whole list of functions in their 
  641. order, double click on the picture. 
  642. You can use several additional functions in the Multifunction Editor 
  643. Dialog Box (all of them are self-explanatory): Stop Movie, 
  644. Reverse Movie, Show Next Album Picture, List 
  645. Through Album, Show Last Album Picture, Show 
  646. Album As Movie, Multifunction: Stop Executing, 
  647. Multifunction: Wait The End Of  Played Sound.
  648.  
  649.  
  650. Delay Executing Of The Function Queue
  651. -------------------------------------
  652. HSB displays the Select Delay Window so you can define the Execute 
  653. Deferment in seconds. When Multifunction Attachment is replayed, 
  654. this function suspends execution of the list. 
  655.  
  656.  
  657.  
  658. WALKING SHOWS
  659. =============
  660. As soon as your Home Space is ready, you might want to demonstrate 
  661. it in some special way. This is possible with Walking Show feature, 
  662. enabling  you to record and replay sequences of ôwalkingö actions 
  663. within a Home Space. These actions include:                
  664.      - Navigation with WALKER TOOLBOX buttons and  the 
  665.        corresponding keyboard keys (navigation with PINOCCHIO, 
  666.        CAMERA, and any operation with HEIGHT SCALE, as well as any 
  667.        building and decorating operations will NOT effect walking 
  668.        show and can cause errors)
  669.      - Selecting pictures, activating IMAGE WINDOW, executing 
  670.        attached functions and lists of  functions (Target button 
  671.        for close view is disabled during Walking Show)
  672.      - Playing attached sound
  673. To start recording Walking Show, press the Footprints button on the 
  674. WALKER TOOLBOX. Perform all needed actions and press the Footprints 
  675. button to stop recording. All actions are automatically saved 
  676. to the file with the same name as current Home Space and extension 
  677. .WLK. To start Walking Show, choose the Walking Show item in the 
  678. menu. Alternatively, you can launch Walking show when loading a 
  679. Home Space by checking the Enable Walking Show box in the Open 
  680. 3D Space Dialog Window. Once you check this box, you can 
  681. additionally check the Cycle Walking Mode box to make Walking 
  682. Show repeat. To stop Walking Show,  press any navigation key on the 
  683. WALKER TOOLBOX (it is also canceled by any Load and Save 
  684. operation). 
  685.  
  686.  
  687.  
  688. LOADING AND SAVING FILES
  689. ========================
  690.  
  691. Loading Files
  692. -------------
  693. Home Space Builder 1.0 (Beta2) can load only .MUS files (not .WRL 
  694. files!). Select the Open 3D Space item in the VIEWER WINDOW 
  695. Menu Bar, and select the desired file. To start building home space 
  696. from the scratch, press the New 3D Space button. Two additional 
  697. checkboxes, Enable Walking Show, and Cycle Walking Mode in the 
  698. Open 3D Space Dialog Window let you launch and repeat Walking 
  699. Show immediately after loading a Home Space file. You can preview 
  700. accompanying text and title for the Home Space  pressing the 3D 
  701. Space Info button in the Open 3D Space File Window when loading 
  702. Home Space. 
  703.  
  704.  
  705. Saving Files
  706. ------------
  707. There are two modes to save home spaces: the Copy All  mode, and 
  708. the Save 3D Space mode. When designing your own home space, you 
  709. probably use lots of pictures and textures located somewhere on your 
  710. computer and also, maybe, on a network. If you assume that all this 
  711. will be available next time you load the museum, simply select the 
  712. Save Museum item and indicate the directory and filename for the 
  713. destination .MUS file. All textures  and pictures will acquire absolute 
  714. references (paths) to the existing files. Thus saved home space is 
  715. actually your local copy: you cannot expect that it will be portable to 
  716. any other computer. If you want to make a portable copy, select the 
  717. Copy All item and perform the same operation. All pictures and 
  718. textures will be copied to the destination directory of your .MUS file 
  719. (you can see ôprogressö windows), and all references to picture/texture 
  720. files will be relative to this directory (no paths will be indicated in the 
  721. .MUS file). 
  722.  
  723. In any case, you have to select the desired file format before saving 
  724. your home space.
  725.  
  726.  
  727. File Formats
  728. -------------
  729. Home spaces can be saved in three formats:
  730.     - .MUS files (the only files that can be loaded by Home Space 
  731.       Builder 1.0), 
  732.     - .WRL files (can be loaded by any VRML browser compliant with 
  733.       the VRML 1.0 final SPEC), 
  734.     - .D96 files (export to the advanced ParaGraphÆs file format; you 
  735.       will need this conversion for future products in the Home Space 
  736.       product line). 
  737.  
  738.  
  739. NOTE.  Some VRML browsers process Carriage-Return Line-Feed sequence incorrectly. 
  740. To change this sequence for Line-Feed symbol only, you can run the program 
  741. CRLF2LF.EXE which is included in the package. In the command line or with Microsoft 
  742. Windows Run, enter
  743.  
  744. CRLF2LF.EXE  <Input .WRL file> <Output .WRL file>
  745.  
  746. All CRLF sequences in the  <Output .WRL file> will be changed for LF symbols.
  747.  
  748.  
  749. Save Options
  750. ---------------
  751. You can use extended authentication features of HSB by saving MUS 
  752. file in a Read Only mode, and  in a Guest Only mode. When you load 
  753. a file that was formerly saved in the Read Only mode, you can switch 
  754. to the Master Mode and change the scene, but in case such changes 
  755. were made, you cannot repeatedly save this file under the same name. 
  756. The Guest Only mode completely protects your Home Space from 
  757. updating. When a file saved in this mode is repeatedly loaded, both the 
  758. Master Mode item and the Save 3D Space item in the menu are 
  759. disabled. 
  760.  
  761. You can change the Title picture, and assign an accompanying text to 
  762. a Home Space by checking the Advanced Save 3D Space Options box 
  763. in the Save 3D Space File Window. To preview accompanying text, 
  764. and title, press the 3D Space Info button in the Open 3D Space File 
  765. Window when loading a Home Space. 
  766.  
  767. If you save a Home Space using the Copy All operation, it is possible 
  768. to copy executable files, and Help file to the destination directory. To 
  769. do this, check the Copy Executable HSB Files box in the Select 
  770. Destination Path Window. 
  771.  
  772. When saving WRL file, you can edit file names for textures in order to match 
  773. specific requirements of diverse VRML browsers. To do this, press the Alias Editor
  774. button in the Save 3D Space File window. You can then select needed texture file
  775. names in the Texture File Names listbox, and supply all of them with a prefix you 
  776. type or paste into the Alias Prefix row. The three options: Full, Absolute, Relative vary
  777. the way texture file names in the listbox are added to the Alias Prefix. With Full, the
  778. filenames will be appended to a prefix without changes. With Absolute, drive name, 
  779. if present in the listbox, will be suppressed. With Relative, the whole path will be 
  780. suppressed, and only the texture file mane will be appended to a prefix. In addition,
  781. you can manually edit actual texture file names in the Alias row.
  782.  
  783.  
  784. SETTINGS
  785. ========
  786. To change HSB settings, choose the Settings item in the menu. There 
  787. are six groups of  settings in the HSB Settings Window:
  788.     
  789. Default Search Directories
  790. --------------------------
  791. You can set default directories to search Textures (pictures and 
  792. wallpapers), Sound, and MIDI files. 
  793.  
  794. Default HSB Title
  795. -----------------
  796. Allows you to change the Title picture and to restore the Default Title. 
  797.  
  798. Fast HSB Images
  799. ---------------
  800. Sets Fast Image Convert mode and/or Fast  Chooser Preview Of Images 
  801. mode. With Fast Image Convert mode, image files are converted into 
  802. internal HSB format. This essentially speeds up loading and 
  803. previewing image files, but requires additional disk space. Fast  
  804. Chooser Preview Of Images mode speeds up previewing image files in 
  805. the CHOOSER WINDOW.
  806.  
  807. HSB Desktop Color 
  808. -----------------
  809. Sets new color and restores default color for HSB desktop. 
  810.  
  811. ôOpen 3D Spaceö Window Settings
  812. -------------------------------
  813. Determines whether PLANE BUILDER/WALKER WINDOW, and CHOOSER WINDOW 
  814. are present on the desktop after a Home Space is loaded. 
  815.  
  816. Desktop Settings
  817. ----------------
  818. The Enable Searching Message checkbox determines whether the 
  819. lower on-screen bar with file names appears when you are loading a 
  820. 3D Space. The Enable Desktop checkbox determines whether HSB 
  821. windows pop-up on the top of  the HSB desktop or on the top of  
  822. Windows desktop. 
  823.  
  824.  
  825.  
  826. HOT KEYS, and ACCELERATORS
  827. ==========================
  828.  
  829. Tab
  830. ---
  831.    - Displays the Text attached to a Picture when cursor is over an 
  832.      Album.
  833.    - Executes a Function (Multifunction) attached to a Picture when 
  834.      cursor is over an Album.
  835.  
  836.  
  837. Ctrl-Left Mouse Button
  838. ----------------------
  839. Copies a Wallpaper, Picture, Album,  or movie into the Basket (a 
  840. clipboard).
  841.  
  842. Shift-Left Mouse Button
  843. -----------------------
  844. Pastes a Wallpaper, Picture, Album,  or movie from the Basket 
  845. (clipboard) to the wall.
  846.  
  847. Ctrl-Shift-Left Mouse Button
  848. ----------------------------
  849. Pastes a Wallpaper, Picture, Album,  or movie from the Basket 
  850. (clipboard) to the wall, and then copies it into the Basket.
  851.  
  852. Alt-X           
  853. -----
  854. Quits HSB.
  855.  
  856. Alt-A,  Alt-Enter    
  857. -----------------
  858. Activates  the Picture Attach Editor Window with the selected picture, 
  859. album or movie.
  860.  
  861. Alt-S           
  862. -----
  863. Plays the attached Sound Clip.
  864.  
  865. Alt-L           
  866. -----
  867. Displays next picture in the selected album.
  868.  
  869. Alt-I          
  870. -----
  871. Opens IMAGE WINDOW with the selected  picture.
  872.  
  873. Alt-V            
  874. -----
  875. Positions camera directly in front of the selected  picture, album or 
  876. movie.
  877.  
  878. Alt-R            
  879. -----
  880. Executes function or list of functions attached to the selected picture, 
  881. album or movie.
  882.  
  883. Alt-M           
  884. -----
  885. Displays the menu. 
  886.  
  887. Backspace 
  888. ---------
  889. Undoes  previous action. 
  890.  
  891.  
  892. A FEW MORE TIPS
  893. ===============
  894. Here are some additional options that could be helpful for designers of 
  895. home spaces.
  896.  
  897.  
  898. Arranging On-Screen Windows
  899. ---------------------------
  900. When building a home space, it is often convenient to have the 
  901. VIEWER window sufficiently big. In this case, it can cover partially or 
  902. completely any of the remaining windows, except for the WALKER 
  903. TOOLBOX which will always pop-up. In order to quickly access to 
  904. other windows, you donÆt need to move/resize the VIEWER window.  
  905. Just activate these windows using two additional buttons on the 
  906. WALKER TOOLBOX: an Excavator button brings the PLANE 
  907. WALKER with HEIGHT SCALE and CAMERA, and the BUILDER 
  908. TOOLBOX on the top, and the neighbor Drawer  button does the same 
  909. for the CHOOSER window.
  910.  
  911.  
  912. Disabling The BUILDER TOOLBOX
  913. -----------------------------
  914. Some designers would like to divide their job into steps: first build the 
  915. home space itself, and then perform all painting, wallpaper, picture 
  916. and attachment operations. In this case, it is convenient to disable the 
  917. BUILDER TOOLBOX which is unnecessary for the second step. To do 
  918. this, just press the Walking Little Fellow button on the WALKER 
  919. TOOLBOX. The BUILDER TOOLBOX will be disabled, and you can 
  920. more efficiently use the PINOCCHIO button to move through the plan 
  921. and choose the walls you wish to furnish. 
  922.  
  923.  
  924. Hiding/Unhiding Windows
  925. -----------------------
  926. You can hide/unhide the HEIGHT SCALE and the CAMERA 
  927. windows by repeatedly pressing Height Scale and Camera buttons on 
  928. the BUILDER TOOLBOX.
  929.  
  930.  
  931. TRADEMARKS
  932. ==========
  933. Microsoft Word, and Microsoft Windows are trademarks of Microsoft, 
  934. Inc.
  935. WebSpace is a trademark of Silicon Graphics, Inc.
  936. Home Space and Home Space Builder are trademarks of ParaGraph 
  937. International. 
  938.  
  939.  
  940.          HAVE FUN WITH HOME SPACE BUILDER 1.0 !
  941.  
  942. Please, send your comments to hsbbeta2@paragraph.com (Subject: HSB)
  943.