home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / pluginpk.exe / readme.pip < prev    next >
Text File  |  1998-01-27  |  19KB  |  514 lines
  1. OS/2 Plug-in Pack
  2.  
  3.  (C) Copyright IBM Corporation 1995, 1998. All rights reserved.
  4.  
  5.  (C) Copyright Netscape Communications Corporation
  6.      1995, 1998. All rights reserved.
  7.  
  8.  
  9. Welcome to the OS/2 Plug-in Pack. This README file contains the
  10. latest information about installing the Plug-in Pack. 
  11.  
  12. Note: To help you locate information in this README, you can use
  13. the Find option under the Edit menu of the OS/2 System Editor.
  14. You can print the file by dragging it to your printer object or by
  15. using the Print choice on the menu.
  16.  
  17.    CONTENTS
  18.      
  19.  1.0 Hardware and Software Requirements
  20.  2.0 Installation Instructions
  21.  3.0 Function Included In This Release
  22.  4.0 Multimedia Plug-ins
  23.  5.0 Support for Windows 3.1 Plug-ins
  24.  6.0 Plug-in APIs and Toolkit
  25.  7.0 OS/2 Multimedia MPEG support
  26.  8.0 CID Installation
  27.  9.0 Known Problems
  28. 10.0 Service and Support
  29. 11.0 Trademarks
  30.  
  31.  
  32. 1.0 HARDWARE AND SOFTWARE REQUIREMENTS
  33. ==================================================
  34.  
  35.   Hardware Requirements:
  36.  
  37. To install and use the OS/2 Plug-in Pack with Netscape Navigator for
  38. OS/2, your workstation needs to have:
  39.  
  40.      o  3MB free hard disk space (and 2 MB of temporary disk space),
  41.          in addition to the Netscape Navigator for OS/2 requirements
  42.      
  43.   Software Requirement:
  44.  
  45.     o  Netscape Navigator for OS/2 installed
  46.  
  47.       
  48. 2.0 INSTALLATION INSTRUCTIONS
  49. =================================================
  50.  
  51. After you install Netscape Navigator for OS/2, you can
  52. install the Plug-in Pack.
  53.  
  54.   Note: The following installation instructions do not
  55.   install the Plug-in Pack onto the WorkSpace On-Demand product.
  56.  
  57.   1.  To start the installation program, type:
  58.  
  59.            INSTALL
  60.  
  61.   2.  Follow the online instructions.
  62.  
  63.   3.  Restart your system.
  64.  
  65.   Note: The installation can not complete if you are using the
  66.   4OS2 software package. Try double-clicking on the
  67.   INSTALL.EXE located in the folder that represents 
  68.   the directory you want installed.
  69.  
  70.   Note: If you have a previous version of the Plug-in Pack for OS/2
  71.   installed in addition to this current version, you must take some
  72.   additional steps if you uninstall any version, but do not uninstall
  73.   all versions. After uninstalling any version, you must reinstall the
  74.   OS/2 Plug-in Pack version that remains on your system by performing
  75.   a Software Installer "update." Retrieve the version of the Plug-in Pack
  76.   you have installed on your system and begin the install for it. The 
  77.   installation program prompts you with two or more choices. Choose the
  78.   "Update the currently installed product" option.
  79.   
  80. 3.0 FUNCTION INCLUDED IN THIS RELEASE
  81. =================================================
  82.  
  83. This release of the OS/2 Plug-in Pack for Netscape Navigator offers you:
  84.  
  85.      o  Native OS/2 Multimedia Plug-ins
  86.      o  Support for Windows 3.1 Plug-ins
  87.      o  OS/2 Multimedia MPEG support
  88.  
  89.  
  90. 4.0 MULTIMEDIA PLUG-INS
  91. =================================================
  92.  
  93.  The native OS/2 Multimedia Plug-ins in this package provide
  94.  support for multimedia MIME Types and file extensions such
  95.  as .MPEG, .avi, .voc, .aiff, .wav, and .midi.
  96.  
  97.  The Native OS/2 Multimedia Plug-ins provide support for streaming multimedia.
  98.  This means that certain files that support streaming can be played
  99.  while they are downloaded.  A Multimedia Internet Manager program is
  100.  provided to access these files and it can be started from the System setup
  101.  folder after you install the plug-ins. The Multimedia Internet Manager
  102.  stores temporary files in the [d:]\MMOS2\INETTEMP directory.
  103.  
  104.   
  105.   This table describes the media types supported by the OS/2
  106.   Multimedia Plug-ins:
  107.  
  108.     File extension                MIME type        Support in    Support in
  109.                                                    OS/2 Warp 3.0 OS/2 Warp 4
  110.     ============================= ================ ============= ============
  111.    avi with UltiMotion, Indeo
  112.        2.1, 3.1, or 3.2 encoding video/x-msvideo  Yes           Yes
  113.    avi with Cinepak, RLE, or
  114.        Video1 encoding           video/x-msvideo  Yes, Note 1   Yes, Note 1
  115.    mov, qt                       video/quicktime  Yes, Note 2   Yes, Note 2
  116.    mpeg, mpg                     video/mpeg       Yes           Yes
  117.    flc, fli                      video/x-flc,
  118.                                  video/x-fli      Yes           Yes
  119.    wav                           audio/x-wav      Yes           Yes
  120.    au, snd                       audio/basic      Yes, Note 3   Yes
  121.    aiff, aif                     audio/x-aiff     Yes, Note 3   Yes
  122.    voc                           audio/x-voc      Yes, Note 3   Yes
  123.    iff                           audio/x-iff      Yes, Note 3   Yes
  124.    mid, midi                     audio/x-mid      Yes           Yes
  125.  
  126.   Note 1: This media type support requires additional software. One
  127.   example is the AnpoCodec shareware package. Visit
  128.   http://www.shareware.com and search in the OS/2 section for "codec".
  129.  
  130.   Note 2: This media type support requires additional software. One
  131.   example is the QuickMovie package from Practice Corporation available
  132.   at http://www.practice.xo.com.
  133.  
  134.   Note 3: This media type support requires additional software. Ensure
  135.   that you have the Warp Bonus Pack or FixPack 17 installed.
  136.  
  137.   Notes:
  138.  
  139.   o  If you prefer to use helper applications you can
  140.      remove the native OS/2 multimedia plug-ins by renaming
  141.      the following OS/2 Multimedia plug-ins DLLs in the
  142.      plug-ins subdirectory of the install directory:
  143.  
  144.       NPOS2AUD.DLL  - all audio formats except MIDI
  145.       NPOS2MID.DLL  - MIDI audio
  146.       NPOS2VID.DLL  - video
  147.  
  148.       For example, rename NPOS2AUD.DLL to NPOS2AUD.SAV.
  149.  
  150.     o  When files are downloaded using the native OS/2
  151.      Multimedia Plug-ins, they can be retained by the
  152.      system even after you have exited Netscape Navigator.
  153.      This can cause additional disk space to be consumed.
  154.      The Multimedia Internet Manager, in the System
  155.      Settings folder, allows you to remove some or all
  156.      of these files, as well as change the directory
  157.      that contains this multimedia data.
  158.  
  159.  
  160. 5.0 SUPPORT FOR WINDOWS 3.1 PLUG-INS
  161. ====================================================
  162.   
  163.   All versions of OS/2 Warp, OS/2 Warp Server, and OS/2
  164.   Warp Server Advanced Version 4 SMP Feature support 
  165.   the use of Windows 3.1 Plug-ins.  Support for Windows
  166.   3.1 Plug-ins on OS/2 Warp Version 3.0 and OS/2 Warp
  167.   Connect Version 3.0 requires installation of FixPak 26.
  168.  
  169.   If you need to install FixPak 26, remove Netscape Navigator
  170.   for OS/2 from your system and re-install it. This ensures that
  171.   the OS/2 Warp system updates are made in the correct
  172.   sequence.
  173.  
  174.   Some Windows 3.1 Plug-ins require specific installation
  175.   steps:
  176.  
  177.     Shockwave: The Shockwave installer should be run from
  178.                WIN-OS/2 File Manager or from the Program Manager
  179.                Command line. After installation is completed, exit
  180.                Program Manager. 
  181.  
  182.     Sizzler:  Sizzler displays a test window for an extended
  183.                period of time the first time it is used. A Timeout
  184.                message box might display. Press Retry
  185.                until the test window completes its test.
  186.  
  187.   Note: If you prefer not to use the Windows 3.1 Plug-ins
  188.   support, you should rename the file NPPROXY.DLL in the
  189.   plug-ins subdirectory of the install directory to NPPROXY.SAV.
  190.  
  191.  
  192. 6.0 PLUG-IN APIs AND TOOLKIT
  193. ====================================================
  194.  
  195.   Developers who want to develop native OS/2 Plug-ins for
  196.   the Netscape Navigator for OS/2 can use a Plug-in Toolkit
  197.   that includes header files, libraries, and sample code for
  198.   building OS/2 native plug-ins that can be downloaded.
  199.   To download the toolkit, go to the URL:
  200.  
  201.     http://www.internet.ibm.com/browsers/netscape/warp
  202.  
  203.   and select OS/2 Plug-in Developers Kit.
  204.  
  205.  
  206. 7.0 OS/2 MULTIMEDIA MPEG SUPPORT
  207. ============================================================
  208.  
  209.   The new IBM MPEG support includes software MPEG video file
  210.   playback that does not require special MPEG hardware.
  211.  
  212.  
  213. 7.1 Software Requirements
  214. -------------------------
  215.  
  216.   OS/2 Multimedia MPEG Support requires OS/2 Warp Version 3 or
  217.   later.  However, OS/2 Warp Version 3 systems also require the
  218.   OS/2 Warp Multimedia fixes that are available for this installation.
  219.  
  220.  
  221. 7.2 Recommended Hardware Configuration
  222. --------------------------------------
  223.  
  224.   A Pentium hardware configuration is recommended because
  225.   software MPEG is very CPU-intensive.  Software MPEG can be
  226.   used on a computer with a 486 microprocessor, but the video
  227.   quality is minimal.
  228.  
  229.   Software MPEG audio support is available, but performs
  230.   poorly on systems slower than a Pentium 90MHz.
  231.  
  232.   Hardware MPEG audio is supported with IBM MWAVE cards or
  233.   ReelMagic cards.
  234.  
  235.   MPEG hardware is used transparently, if it is available. 
  236.   An updated ReelMagic driver set is provided and
  237.   installable if the hardware configuration includes the
  238.   ReelMagic drivers.  These drivers should not be installed
  239.   unless the hardware exists in the machine where the
  240.   drivers are being installed.  For hardware video support,
  241.   VSDOM1.INI must be installed in the \MMOS2 directory.  Using
  242.   the OS/2 Multimedia MPEG Support installation, select the
  243.   MPEG card installed in the system.
  244.  
  245.   A 2-speed CD-ROM is required to play CD-i or Video CD
  246.   content. This CD-ROM must support long reads.  Some OS/2
  247.   CD-ROM drivers do not support the long reads that CD-i
  248.   requires. CD-i content is not readable through the file
  249.   system. Playing this content requires a dummy file named
  250.   _VIDCDI.MPG.  Playback quality is very jerky for
  251.   polling CD-ROMs.
  252.  
  253.  
  254. 7.3 Installation
  255. ----------------
  256.   
  257.   MPEG support can be selected during the installation of
  258.   the Plug-in Pack. 
  259.   
  260.  
  261. 7.4 Backward Compatibility for MCI applications
  262. -----------------------------------------------
  263.  
  264.   A video MCD is provided for backward compatibility for
  265.   existing applications that utilize the Media Control
  266.   Interface (MCI).  This means the existing media
  267.   player provided with OS/2 Multimedia can be used to
  268.   play MPEG content.
  269.  
  270.  
  271. 7.5 MPEG Limitations
  272. --------------------
  273.  
  274.   o  MPEG-2 Transport streams with buffered play only works
  275.      with 188 byte size buffers.  All others are rejected.
  276.  
  277.   o  Playback from content on slow CD-ROMS (less than 4X)
  278.      results in poor video playback quality.
  279.  
  280.  
  281. 7.6 Configurations With Existing MPEG Hardware Support
  282. ------------------------------------------------------
  283.  
  284.   To configure OS/2 Multimedia MPEG Support to be used as the
  285.   default hardware MPEG device, do the following:
  286.  
  287.   1.  In the Multimedia Setup, on the Association page for the
  288.       existing MPEG hardware, select the MPEG data type and
  289.       remove all current extensions.
  290.   2.  On the OS/2 Multimedia MPEG Support Association page,
  291.       select the MPEG data type and add  the following extensions:
  292.       MPG, CDI, VBS, DAT, M1T, M2T, M2P.
  293.  
  294. 7.7 About Plugins
  295. --------------------
  296.  
  297. The About Plugins section states that you have QuickTime support.
  298. This means that QuickTime is enabled, but QuickTime plugins
  299. are not be supported unless a QuickTime support is installed. 
  300. Companies that provide OS/2 QuickTime support are Practice Corp.
  301. and MainActor.
  302.  
  303. 7.8 Software MPEG Performance
  304. -------------------------------
  305. To decrease software MPEG usage, go to the Multimedia Setup notebook
  306. on the OpenMPEG page and change the synchronization factor to
  307. greater than 40 or to the maximum. This slider is not proportional
  308. in changes. Increasing the synchronization factor decreases
  309. the video quality, but improves CPU performance so that software
  310. MPEG is not taking the maximum out of the CPU. This synchronization
  311. factor has no effect on hardware MPEG.
  312.  
  313.  
  314. 7.9 Multimedia Setup Page
  315. -------------------------
  316.  
  317.   If audio fails to play, try specifying the Software Only
  318.   mode for audio for the OpenMPEG Video device in the
  319.   Multimedia Setup object (in the System Setup folder).
  320.   This change could be necessary for systems containing
  321.   Audiovation sound cards.
  322.  
  323.  
  324. 7.10 Video CD/CD-i Support
  325. --------------------------
  326.  
  327.   Video CD and CD-i content is supported with the Software
  328.   Video CD icon in the Multimedia folder.  Systems with MPEG
  329.   hardware such as a Thinkpad 760 can already have a Video CD
  330.   Player icon.  This allows Video CD to run through the existing
  331.   MPEG device.  If the Software Video CD icon is used on
  332.   systems with MPEG hardware, OS/2 Multimedia MPEG
  333.   Support attempts to play the content using hardware.
  334.   Use the Software Video CD icon if the system has been
  335.   customized with OS/2 Multimedia MPEG Support as the default
  336.   MPEG device.
  337.  
  338.  
  339. 7.11 Future Hardware Support
  340. ----------------------------
  341.  
  342.   OS/2 Multimedia MPEG Support installs hooks for the
  343.   following hardware devices:
  344.  
  345.   o  Thinkpad 760CD MPEG
  346.   o  Thinkpad 760ED MPEG
  347.   o  Sigma Designs ReelMagic
  348.   o  Sigma Designs ReelMagic Pro
  349.   o  Visual Circuits ReelTime
  350.  
  351.   If MPEG hardware is installed later, the VSDOM1.INI file
  352.   must be created by running the MKVSDINI.CMD file in the
  353.   \MMOS2 directory.  For new MPEG hardware not in the preceding
  354.   list, modify the MKVSDINI.CMD file with the appropriate PDD
  355.   and VSD DLL. The PDD and VSD are defined in the
  356.   MMPM2.INI file. Do not include the $ character for the PDD.
  357.  
  358.   In addition, if the DSP requires special loading, use the
  359.   appropriate numbers for the .dsp field to signify the
  360.   following 1 Load DSP Only 2 Load With MPEG Stream Info.
  361.  
  362.  
  363. 8.0  CID INSTALLATION
  364. ================================================
  365.  
  366.   The following response file keyword must be specified to
  367.   allow the OS/2 Plug-in Pack to be installed in a CID environment.
  368.   The possible values for the keyword are TRUE or FALSE:
  369.  
  370.     NAV_PRESENT   - Netscape Navigator for OS/2 has already been
  371.                             installed
  372.  
  373.   Refer to section 9.0 of the Netscape Navigator for OS/2 READ.ME file
  374.   for additional CID installation details.
  375.  
  376.   The following is an example of a response file used
  377.   to install Netscape Navigator for OS/2 Plug-in Pack
  378.   where Netscape Navigator for OS/2 is installed in the
  379.   C:\NETSCAPE directory and Multimedia support is
  380.   installed in the C:\MMOS2 directory:
  381.  
  382.    COMP         = OS/2 Multimedia Plug-Ins for Netscape Navigator  *
  383.    COMP         = 16-bit Plug-In Support for Netscape Navigator    *
  384.    COMP         = OS/2 Multimedia MPEG Support                     *
  385.    FILE         = C:\NETSCAPE         *
  386.    AUX1         = C:\MMOS2            *
  387.    CFGUPDATE    = AUTO                *
  388.    DELETEBACKUP = NO                  *
  389.    OVERWRITE    = YES                 *
  390.    SAVEBACKUP   = NO                  *
  391.    NAV_PRESENT  = TRUE                *
  392.  
  393.  * Indicates a required keyword.  Do not include the
  394.    "*" within the response file.
  395.  
  396.   Notes:
  397.       o  The FILE response file keyword should point to the directory
  398.           where Netscape Navigator for OS/2 was installed.  For
  399.           example:
  400.  
  401.                 FILE = d:\netscape
  402.  
  403.       o  The AUX1 response file keyword should point to the directory
  404.           where OS/2 Multimedia was installed. For example:
  405.  
  406.                 AUX1 = c:\mmos2
  407.  
  408.       o  The value given in the COMP keyword in the response file
  409.           must exactly match the string specified by the NAME
  410.           keyword of the COMPONENT entry of the appropriate .PKG file.
  411.           Refer to approximately lines 77 and 325 in the OS2PIP.PKG
  412.           file, and approximately line 2 in the OS2MPEGC.PKG file for
  413.           the possible component names to specify.
  414.  
  415. 9.0 KNOWN PROBLEMS
  416. =========================
  417.  
  418.  o    Some Windows 3.1 Plug-ins require OLE 2.0. If you do not
  419.       have OLE 2.0 for Win-OS2, you can install any 16-bit
  420.       Windows 3.1 application that ships OLE 2.0 (such as the     
  421.       Netscape Navigator for Windows 3.1).
  422.  
  423.  o    You may experience problems with the Digigami
  424.       install program.  You must have OLE 2.0 installed to use
  425.       the Digigami Plug-ins.
  426.  
  427.  o   The Software MPEG Plug-ins can cause your system to hang
  428.      while attempting to close the movie player. 
  429.  
  430.  o   Sometimes pages that contain plug-ins do not display
  431.      correctly. This happens because the webmaster for the
  432.      server did not add the MIME types correctly to the web
  433.      server software.
  434.  
  435.  o   Some Windows 3.1 Plug-ins do not install under OS/2
  436.      because they check for the version of Netscape Navigator for Windows
  437.      that is  installed. You may need to install Netscape Navigator
  438.      for Windows 3.1 before you install the plug-ins for OS/2.
  439.  
  440.  o   Buffered play is not supported for MPEG-2 and single
  441.      stream MPEG devices.
  442.  
  443.  o   Sliders do not update with OS/2 multimedia applications on
  444.      slower systems.
  445.  
  446.  o   Poor video support for software playback with movies over
  447.      a LAN.
  448.  
  449.  o  Reel Magic Pro and Reel Magic may need a new
  450.     AMPMXMCD.DLL fix which corrects the jerky video problem. 
  451.  
  452.  o  If video problems occur with the OS/2 Multimedia MPEG Support
  453.     installation on OS/2 Warp Version 3 systems with S3 cards,
  454.     try renaming the YUV_LUT8.LUT file.
  455.  
  456.  o  Some content from the Thinkpad CD Sampler has video
  457.     corruption during playback of MPEG-2 Transport streams
  458.     (files with 2_30 in filename).
  459.  
  460.  o  Systems with installed MPEG hardware can hang when
  461.     switching between the existing MPEG device and OS/2
  462.     Multimedia MPEG Support on Warp 4. The workaround is to
  463.     set up the associations (defined in previous section) for
  464.     OS/2 Multimedia MPEG Support to be the default MPEG device.
  465.  
  466.  o  Problems can occur when opening MPEG-2 content with MPEG-1
  467.     only hardware.
  468.  
  469. 10.0  SERVICE AND SUPPORT
  470. ===============================================
  471.  
  472. This Program is provided "AS-IS" and as such, IBM shall not
  473. provide any program services (i.e. corrective code) or
  474. technical support for this Program.
  475.  
  476. 11.0  TRADEMARKS
  477. ================================================
  478.  
  479.   The following terms are trademarks of the IBM Corporation in the
  480.   United States or other countries or both:
  481.   o   IBM
  482.   o   OS/2
  483.   o   ThinkPad
  484.  
  485.   The following terms are trademarks of other companies:
  486.  
  487.     Netscape and Netscape Navigator are trademarks of
  488.     Netscape Communications Corporation.
  489.  
  490.     Microsoft, Windows, Windows NT, and the Windows logo are 
  491.     registered trademarks of Microsoft Corporation.
  492.  
  493.     Java and HotJava are trademarks of Sun Microsystems, Inc.
  494.  
  495.     Digigami is a trademark of CineWEB Corporation.
  496.  
  497.     QuickTime is a trademark of Apple Corporation.
  498.   
  499.     ReelMagic is a trademark of Sigma Designs, Inc.
  500.     
  501.   Other company, product, and service names may be 
  502.   trademarks or service marks of others.
  503.  
  504.   THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
  505.   KIND. IBM AND NETSCAPE DISCLAIMS ALL WARRANTIES, WHETHER
  506.   EXPRESSED OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE
  507.   IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND
  508.   MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS
  509.   DOCUMENT. BY FURNISHING THIS DOCUMENT, NETSCAPE
  510.   COMMUNICATIONS GRANTS NO LICENSES TO ANY PATENTS OR
  511.   COPYRIGHTS.
  512.  
  513.  
  514.