
** Cinema/2 (c)1998-2001 Carsten Tenbrink

INTRODUCTION
============

  This program is being developed for the display of various Video images.
  At this time Cinema/2 is in the early stage of development and is only 
  intended to be a TV-Video application for the Hauppage TV-cards


   Functions :

        - full screen mode (only with SDD video drivers)

        - Hide Titlebar
        - Hide Frame
        - float on Top

       - aspect ratio, retains image ratio when resizing window

       - display of current TV channel in title bar

       - keyboard selection of TV channel

       - F-keys used to adjust brightness, contrast etc

       - menu popup with Mouse RB

       - Notebook for TV-Channel preferences

       - program close saves settings

       - new support for Plugins is anticipated in release 1.0.0
          (so until these new hooks are released, bear with me)

       - selection of Regional settings on Program initialisation, followed 
          by Auto Scan for channels


   New Since Version 0.2.5

       - adjustment of other Regional Files for different channels is now possible
          (alternative frequencies)

       - fixed image corruption with some window sizes

       - english is now included as an alternative language
         (Properties->Info->National Language Support)
         anyone willing to translate Cinema into their native language is  
         encouraged to contact me, your help is appreciated!


 Known Limitations :

       - only one Plugin can be loaded, hard coded (at this time)

       - no global settings for brightness etc

       - full screen mode only functions with SDD drivers

       - at this time there is no volume control

 future enhancements :

       - Online Help

       - Loading of different Plugins, via open hooks

       - improved fine tuning features

       - improved detection of driver versions

       - GUI interface for Station, Contrast, brightness etc
          (at the moment there is only a partial implementation)

       - global settings for preferences such as brightness etc

       - use of the MMInterface for displaying Video file, and eventually 
          a Video Recording functions

       - and... anything else that sticks me as neat

INSTALLATION
============

   Requirements :

        - OS/2 Warp4

       - Multi Media Support Installed

       - Hauppauge TV-Card Installed 

       - WCAST 1.021W (or later) driver installed (latest version recommended)

       - Install to an EA aware partition (HPFS)

   Installation:

       - unzip the Cinema/2 package in a directory of your choice

       - run INSTALL.CMD from the installation directory 
          This will install a program object on your desktop

       - NO changes will be made to your config.sys or system INI files!


OPERATION
=========

  When first started, or if 'cinema.ini. cannot be found, the 
   "Tuner Region Selection" dialog will start

  This will allow the selection of your country and cabel/antenna, which
  will automatically load the appropriate Regional File
  Select 'ACCEPT' and the Preferences Notebook will appear, and an 
  automatic scan for channels will take place. When the scan has completed
  additional channels can be added manually

  If you make changes to the channel preferences, you MUST select 
  'SAVE STATION' for them to be retained

  Further channels can be set up, or existing channels adjusted, using
  the appropriate buttons

  NOTE :

  Channel 0 must have a station entry 


  The channels can be selected using either the number keys 0-9, or with
   the move up/move down buttons, or by pointing with mouse in the list.

  Brightness, contrast etc can be adjusted using the F-keys.
   The preferences are specific to that channel, and are saved automatically

  On application close, all preferences are saved to the program specific INI


  Keys :

       F3        Brightness -
       F4        Brightness +

       F5        Contrast -
       F6        Contrast +

       F7        Colour -
       F8        Colour +
 
       F9        Tint -
       F10       Tint +
 
       Number Keys 0-9              Station 0-9
       CTRL + Number Key 0-9        Station 10-19
       ALTL + Number Key 0-9        Station 20-29

       PgUp/PgDn                    Station +/-
       Arrow Up/Dn                  Station +/-

  Mouse Buttons
       right mouse button            Popup Menu
         in addition if the right mouse button is held down
         when the pointer is in the window, the window can be
         dragged around the desktop. This feature can be disabled
         by selecting 
                Properties->display->lock window position->enable


       double click left mouse button   Window frame and Titel bar on/off

       Click BOTH mouse buttons        Mute on/off
 
       With a functional scroll mouse, stations can be selected by scrolling

  Full Screen Mode :
       In Properties->Display full screen mode can be adjusted.
       Standard is a full screen covering the complete desktop 
       The selections 'Switch desktop reolution' and 'MGL Fullscreen' should
       only be used in conjunction with SDD video drivers. Otherwise system
       hangs and possible data loss may occure. This behaviour cannot be 
       corrected at this time.

  NOTE :
       Due to programming differences, the regional file in the notebook for
       a channel will not be correctly read when an old 'cinema.ini' file is
       used. This will have no effect upon operation.       

LEGALITIES
==========

  This Cinema is currently FreeWare. You can use and distribute
  freely. This program is currently in ALPHA test.
  USE THIS PROGRAM AT YOUR OWN RISK!
   
WARRANTY
    I don't take any responsibillity for damage, problems etc resulting from 
    use of this program whether caused directly or indirectly.
    I also don't give any warranty for bug-free operation, fitness for a 
    particular purpose or the appropriate behaviour of the program.

    THE SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
    IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
    WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
    PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
    PROGRAM IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU
    ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

COPYRIGHT
    Cinema/2 - Copyright   (c)1998-2001 Carsten Tenbrink. All rights reserved.

    All trademarks mentioned anywhere around her are property of their
    owners.

BUGS
    As Daniela Egbert so succintly puts it...

    If its good, I am responsible.
    If its bad, its all your fault......<g>

    Suggestions and bug-reports are always welcome. Well ... bug-reports
    are perhaps not *that* welcome ... ;)

    EMail:  Cinema@CTLab.de

