This ZIP archive holds three files
      readme.txt
      encode.c
      decode.c


decode.c is source program that reads a VCRPLUS code
number value you find in the newspaper and calculates
    date_of_the_tv_program
    starting_time_of_the_tv_program
    run_length_of_the_tv_program


encode.c is source program that reads a date, start time,
and run length then turns them into a VCRPLUS code number
like the ones in the newspaper.



There are a few weak spots in these programs.

    1.  They only work for the usual kinds of tv shows,
           a.  Must start on an even half-hour or hour
           b.  Must end on an even half-hour or hour

    2.  They only handle VCRPLUS code values that are 1-6 digits
           long (these are the ones that start and end on
           half-hour or hour boundaries)

    3.  Both programs ask for today's date.  They should
           instead get this from the computer itself but that is
           too much involved with O/S details.

    4.  Integers are used everywhere, even for time_of_day.
           a.  You need to use a 32-bit computer
           b.  So, nine o clock at night, comes out 2100

    5.  The VCRPLUS hardware uses "channel mapping" for
           channel numbers above 19, and for cable tv stations.
           Just decode some VCRPLUS code numbers from each unusual
           channel and get the "mapped channel" numbers.  For
           example in this area the VCRPLUS people have
           mapped cable station ESPN to "channel 22".





Example 1:  encode    nebraska  deleware  newyork
                 This is a (deliberate) error.  You should
                 get back a message telling how to do it right:
            Usage: encode  month  day  year  channel  starting_time  length_in_minutes



Example 2:  decode    newyork  nebraska  deleware
            Usage: decode  todays_month  todays_day  todays_year   Code_value_in_newspaper



Example 3:  encode 1 4 93 5 900 30
                 You have asked for the VCRPLUS code of a tv show
                 on January 4th of 1993, channel number 5, at 9 o clock
                 (in the morning), that lasts for 30 minutes.
                 The program answers back:
                  1   4  93   5  900    30    VCRPLUS_CODE=    19297


Example 4:  decode 1 2 93 19297
                 On January 2nd of 1993 you have asked a question.  You
                 want to know "what show does the VCRPLUS code 19297
                 represent?"  The program answers back
                 Code=  19297     1   4  93   Mapped_channel=  5  Start_time= 0900  Length=  30





Have some fun with this stuff.

Otis.
X-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-X
 Another file downloaded from:                                NIRVANAnet(tm)

 &TOTSE                510/935-5845   Walnut Creek, CA         Taipan Enigma
 Burn This Flag        408/363-9766       San Jose, CA                Zardoz
 realitycheck          415/666-0339  San Francisco, CA    Poindexter Fortran
 Governed Anarchy      510/226-6656        Fremont, CA             Eightball
 New Dork Sublime      805/823-1346      Tehachapi, CA               Biffnix
 Lies Unlimited        801/278-2699 Salt Lake City, UT            Mick Freen
 Atomic Books          410/669-4179      Baltimore, MD               Baywolf
 Sea of Noise          203/886-1441        Norwich, CT             Mr. Noise
 The Dojo              713/997-6351       Pearland, TX               Yojimbo
 Frayed Ends of Sanity 503/965-6747     Cloverdale, OR              Flatline
 The Ether Room        510/228-1146       Martinez, CA Tiny Little Super Guy
 Hacker Heaven         860/456-9266        Lebanon, CT         The Visionary
 The Shaven Yak        510/672-6570        Clayton, CA             Magic Man
 El Observador         408/372-9054        Salinas, CA         El Observador
 Cool Beans!           415/648-7865  San Francisco, CA        G.A. Ellsworth
 DUSK Til Dawn         604/746-5383   Cowichan Bay, BC         Cyber Trollis
 The Great Abyss       510/482-5813        Oakland, CA             Keymaster

                          "Raw Data for Raw Nerves"
X-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-X
