IBM CD Showcase

home *** CD-ROM | disk | FTP | other *** search

/ IBM CD Showcase / OS2_CD_ROM.iso / smce0001 / builder / readme.doc < prev next >

Wrap

Text File | 1994-02-02 | 15.5 KB | 368 lines

README for Ultimedia* Builder/2 Release 1.0.1 5871-AAA (c) Copyright IBM Corp. 1993 INTRODUCTION ____________ This README contains information related to Ultimedia Builder/2. This file contains helpful hints found in our testing as well as updated information that did not make our printed publications. Information is in the following order: o Installation notes o Builder/2 notes o Perfect Image/2 notes o Workplace/2 notes NOTE: If you are viewing this file with a program that uses proportional fonts, you may wish to change to a monospaced font, for the best readability. INSTALLATION NOTES __________________ Installation Verification _________________________ After Ultimedia Builder/2 files are installed and the system has been rebooted to enable CONFIG.SYS changes, you can load a story into the Builder program and the Builder runtime to verify the installation. The test can run either from a command line or by dragging objects onto program icons. The test uses an Installation Verification Program called IVP._ST. (You can use the Drives folder for locating the IVP._ST story file. Look on the drive and directory where you installed Builder/2; there will be a subdirectory named "INSTALL". Inside that directory is the IVP._ST story.) Builder/2 program verification: Drag and Drop: Drop the IVP._ST icon onto the Builder/2 program icon. Command Line: Type: UB <your drive>:\<your directory>\INSTALL\IVP._ST (For example, Type: UB C:\BUILDER\INSTALL\IVP._ST ) Click on the play button in the play menu at the top of the Builder/2 window. You should see a large black window which dissolves into an island. After the IVP image has been displayed, hit any key to exit the story. Double click on the system icon to exit Builder/2. Builder/2 Runtime verification: Drag and Drop: Drop the IVP._ST icon onto the AVA/2 program icon Command Line: Type: TELLPM <your drive>:\<your directory>\INSTALL\IVP (For example, Type: TELLPM C:\BUILDER\INSTALL\IVP ) You should see a large black window which dissolves into an island. After the IVP image has been displayed, hit any key to exit the story. Sharing Font Files with Ultimedia* Perfect Image/2 _________________________________________________ Font files for Text Plane Support are provided with both Ultimedia Builder/2 and Ultimedia Perfect Image/2. If both products are installed on the same machine, it is possible to have both products share a single set of fonts to save disk space. Install the fonts with only one of the products; do not install them with the second. The first product will create a CONFIG.SYS variable called UMPATH which names the directories where the fonts are installed. (UMPATH is used for other reasons as well, and is modified whether the fonts are installed or not). The CONFIG.SYS entry will be similar to: SET UMPATH=C:\BUILDER\DATA or SET UMPATH=C:\PIMAGE\DATA Both products can use the same fonts as long as the UMPATH variable contains the correct path. Installing AVC Font Files for use with Ultimedia* Builder/2 ___________________________________________________________ If you will be playing AVC stories under Builder/2 and your stories show images containing text fields in an AVC font, it is RECOMMENDED that you copy the fonts included with AVC (files with the extension '_FN') into the same directory that contains the fonts included with Builder/2 (x:\BUILDER\DATA, where x is the drive that you installed Builder/2 on). The Builder/2 fonts and the AVC fonts are 100% compatible. Failing to do this may cause an undesireable performance degradation during story playback for the following reason: When the story is being played a text field on an image that uses a font that cannot be found is dynamically replaced with one of the available fonts. This dynamic replacement can prove very time-consuming if the image contains a large number of text fields. Installing shared I/O procedures ________________________________ There are new I/O procedures included with Builder/2 R1.0.1 which are used to support various image types. They are shared with the Ultimedia Tool Series products Perfect Image/2 R1.0 and Workplace/2 R1.0 for OS/2 R1.0. After installing Builder/2 R1.0.1 the new I/O procedures are stored in a new directory off of the root called UTIOPROC. This new directory is added to the front of the LIBPATH statement in CONFIG.SYS at installation. By doing this, Perfect Image/2 and Workplace/2 for OS/2 now access the new DLLs in UTIOPROC instead of the I/O procedure modules included with their respective packages. If you are installing all the packages or Builder/2 R1.0.1 and at least one of the R1.0 products on your system, you should install Builder/2 R1.0.1 LAST. This will ensure that the UTIOPROC directory ends up at the front of the LIBPATH statement. Failing to do this will cause the older I/O procedures from one of the other R1.0 packages to be used instead of the new ones, consequently disabling some of the new image support included with Builder/2 R1.0.1. Once Builder/2 R1.0.1 has been installed and you subsequently purchase and install one or more of the R1.0 packages, you should do the following: manually edit CONFIG.SYS and move the UTIOPROC to the front of the LIBPATH statement. Additionally, you may want to run the MMIONINI program (see below) to verify that all applicable I/O procedures have been registered (that is, are checked). The MMIOINI program ___________________ The MMIOINI program can be used to register and de-register I/O procedures. This process makes the I/O procedures known to MMPM/2 and thereby makes the I/O functions available to application programs. Builder/2, Perfect Image/2 and Workplace/2 use these procedures through MMPM/2 for image, audio, and video file support. To run MMIOINI: Icon: 1. Open the Drives folder 2. Open the drive where you installed the product 3. Open the product folder (default name: BUILDER) 4. Open the INSTALL folder 5. Double-click on the MMIOINI.EXE icon Command line: 1. Change to the product directory (default name: BUILDER) 2. Change to the INSTALL directory 3. Type: MMIOINI.EXE The MMIO Procs Install/Remove screen appears. To register a procedure, click on the checkbox next to it. A check will appear. To de-register a procedure, click on the checkbox next to it, and the check mark will disappear. BUILDER/2 NOTES _______________ 1. In some cases, Builder/2 generates not one, but several AVA/2 statements when a frame is created using the graphical interface. This is true, for example, when a video frame is created. The generated AVA/2 statements are enclosed between special statements that the graphical interface requires to mark a multiline set of associated statements. The AVA/2 statements are preceded by a "%FRAME" statement, and are followed by a "%ENDFRAME" statement. Though not recommended, Builder/2 allows you to add AVA/2 statements of your own within the frame when in TEXT mode. However, if you regenerate that same sequence using the Builder/2 definition dialogs, the new statements will replace all statements between the %FRAME/%ENDFRAME statements causing the user-added statements to be lost. 2. When in the text view of Builder/2 double-clicking on a text line within a set of statements that were generated via the graphical view (for example, video or an animation sequence) will NOT open the definition dialog. 3. If you use the text view of Builder/2 to change any AVA/2 statements which are a part of an animation sequence that was generated from the graphical view, the changes will NOT take effect unless you 1) return to graphical view, 2) double click on the animation frame to bring up the animation dialog and, 3) click on OK to end it. 4. A Multimedia Presentation Manager/2* (MMPM/2) Corrective Service Diskette (CSD) is available that corrects various video problems which may be encountered when playing video files in Builder/2. It is RECOMMENDED that you acquire and install this MMPM/2 CSD. Installing this CSD does, however, have a side affect: see item #5 below. To acquire this MMPM/2 CSD call IBM OS/2 service at 1-800-992-4777. This CSD is also included with the IBM Video In/2* product. 5. If you have installed the Multimedia Presentation Manager/2* (MMPM/2) Corrective Service Diskette (CSD) mentioned in item #4 above, do not use the "Step by frame" option from the Builder/2 video definition dialog. Your system may hang while attempting to step by frame. The same applies to the AVA/2 VSTEP statement. If your application needs to step video by frame, you should reinstall MMPM/2 without the CSD. 6. Builder/2 R1.0.1 was enhanced to support files with fully-qualified names up to 137 characters long. However, the audio I/O procedure module that supports AVC-type audio files (AVCAPROC.DLL) currently included with Multimedia Presentation Manager/2* (MMPM/2) is only capable of handling a fully-qualified name up to 64 characters maximum. This I/O procedure has been corrected, but is not yet generally available. It is to be included with the next scheduled Corrective Service Disk (CSD) for MMPM/2. Until that time care should be taken when using AVC-type audio files in Builder/2. Audio file names that exceed the 64 character limit may cause your system to hang when playing your Builder/2 story. 7. While the audio browser included with Builder/2 R1.0.1 typically previews (plays) audio files with no difficulty, there is a condition that may cause Builder/2 to hang: repeatedly playing a short audio segment on a minimum configuration system (386 25-Mhz). Should this situation occur, do the following: - Press Ctrl+Esc to bring up the Window List - Select the INDENTED line that says: Ultimedia Builder/2 - storyname where storyname is the name of the story you are editing - Press mouse button 2 to get the popup menu - Select Close. If you have made other changes to the story you will be prompted to Save or Discard the story. Builder/2 can then be restarted. 8. Builder/2 R1.0.1 supports the usage of Windows bitmaps in a story by using an I/O procedure included with Multimedia Presentation Manager/2* (MMPM/2). This I/O procedure is unable to process certain bitmap images. This defect will be corrected. 9. Several of the folders in the Builder 1.0.1 Samples folder contain icons which refer to files which can be located either on the CD or on a hard drive, depending on the installation options chosen. If the system is booted when the CD is not in the CD-ROM drive, icons which represent files which are on the CD will be changed to indicate the files are not available. (The icon is two small squares linked with a broken line.) To re-enable access to these files, just re-boot with the CD in the drive. PERFECT IMAGE/2 NOTES _____________________ The following applies if you have Perfect Image/2 on the same machine as Builder/2: 1. The new I/O procedures included with Builder/2 R1.0.1 have added support for reading 1 bit and 4 bit images. In order to read 1 bit and 4 bit images with Perfect Image/2 R1.0, two modules (UTISIO.DLL and UTISSY.DLL) must be copied to where Perfect Image/2 is installed as follows: Copy the new modules to your system: copy e:\pimage\dll\*.dll c:\yourpi\dll where e is your CD-rom drive with the Builder/2 R1.0.1 CD inserted, c is the drive you have Perfect Image/2 installed on, and yourpi is the name of the directory where you installed Perfect Image/2. If you are installing Builder/2 from diskettes, these modules are available on diskette (9). Insert this diskette in drive a: and copy a:\pimage\dll\*.dll c:\yourpi\dll NOTE: If these two files are not copied and the new I/O procedures are installed, Perfect Image/2 will not support 1 and 4 bit images, and TIFF FAX support will be lost. WORKPLACE/2 NOTES _________________ The following applies if you have Workplace/2 on the same machine as Builder/2: 1. In Builder/2 you are allowed to browse (preview) images, audio, story, and video files. The modules that support each of the browsers have been enhanced and/or corrected and are included with Builder/2. However, corresponding modules exist in the Workplace/2 R1.0 package. We have included those Workplace/2 modules on the Builder/2 CD. If you have purchased and installed Workplace/2 R1.0 on your system and would *like* (NOT REQUIRED) to update to these new modules, follow the instructions below: A. Open an OS/2 window B. Deregister the Workplace/2 data file class by keying the following EXACTLY AS SHOWN as the requests are case-sensitive: e:\workplac\bin\reg -d LTDataFile e:\workplac\bin\repl WPDataFile WPDataFile anything where e is your CD-rom drive with the Builder/2 R1.0.1 CD inserted. C. Shut down and re-boot your system to unlock the necessary DLLs. D. Copy the new modules to your system: copy e:\workplac\dll\*.dll c:\yourwork\dll where e is your CD-rom drive with the Builder/2 R1.0.1 CD inserted, c is the drive you have Workplace/2 installed on, and yourwork is the name of the directory where you installed Workplace/2. If you are installing Builder/2 from diskettes, these modules are available on diskette (9). Insert this diskette in drive a: and copy a:\workplac\dll\*.dll c:\yourwork\dll E. Register the Workplace/2 data file class by keying the following EXACTLY AS SHOWN (except where noted) as the requests are case- sensitive: e:\workplac\bin\reg LTDataFile "c:\yourwork\dll\utltdata.dll" e:\workplac\bin\repl WPDataFile LTDataFile where e is your CD-rom drive with the Builder/2 R1.0.1 CD inserted, c is the drive you have Workplace/2 installed on, and yourwork is the the name of the directory where you installed Workplace/2. F. Shut down and re-boot your system. TRADEMARK INFORMATION _____________________ Terms which have been marked with an asterisk (*) in this document are trademarks of the IBM Corporation as follows: AVA/2, Builder/2, Multimedia Presentation Manager/2, OS/2, Perfect Image/2, Ultimedia, Video In/2 and Workplace/2.