home *** CD-ROM | disk | FTP | other *** search
/ Australian Personal Computer 2004 September / APC0409D1.iso / powerkit / homethea / files / DW070.exe / docs / Configuration.txt next >
Encoding:
Text File  |  2004-04-12  |  14.0 KB  |  379 lines
  1. # DigitalWatch - Configuration.txt
  2. #
  3.  
  4. ------------
  5. channels.ini
  6. ------------
  7. Channels in DigitalWatch are orgainised by network and program.
  8. A network contains a group of programs whic are all on the same frequency.
  9. Just list the Program definitions under each Network definition.
  10. See the file in the channels folder for examples.
  11.  
  12. Format:
  13.  
  14. Network_<number>(OSD name, Frequency, Bandwidth (optional), Default Program)
  15.  
  16. eg. Network_1("Seven", 177500, 7, 1)
  17.  
  18.     number          - Choose a unique network number. Must be greater than 0.
  19.                       This number is the keypad number that will be used to
  20.                       select the network.
  21.     OSD Name        - A string that will be displayed on the screen when the
  22.                       network is selected
  23.     Frequency       - If this needs explaining then you shouldn't be tampering
  24.                       in this file.
  25.     Bandwidth       - If this is omitted then it defaults to 7.
  26.     Default Program - the number of a program to use as default for this
  27.                       network.
  28.  
  29. Program_<number>(OSD Name, Program Number, Video PID, Audio PID, PMT PID)
  30.  
  31. eg. Program_2("Nine Digital HD" , 0,  512, A650, 0)
  32.  
  33.     number         - Choose a program number unique for it's network.
  34.     OSD Name       - A string that will be displayed on the screen
  35.                      when the program is selected.
  36.     Program Number - Not used. set it to zero, or whatever you want.
  37.     Video PID      - PID of the video stream
  38.     Audio PID      - PID of the audio stream.
  39.                      If using DVBInput 2 then you must prefix AC3 streams with
  40.                      an A.
  41.     PMT PID        - Not used. set it to zero, or whatever you want.
  42.  
  43.  
  44. Beneath Networks and Programs you can specify Functions that are to run when
  45. they are selected. If you specify a Function for a Network then it will
  46. effect all Programs for that Network, unless a program overrides it.
  47.  
  48. eg.
  49. Network_3("Nine", 191625, 1)
  50.   #lower brightness and saturation. Effects all network nine programs.
  51.   SetColorControls(500, 10000, 0, 8000, 1)
  52.     Program_1("Nine Digital"    , 0,  513,  660, 0)
  53.     Program_2("Nine Digital HD" , 0,  512,  650, 0)
  54.       #use the 5th AudioDecoder (AC3Filter by default) for Nine HD.
  55.       AudioDecoderEntry(5);
  56.     Program_3("Nine Guide"      , 0,  514,  670, 0)
  57.  
  58.  
  59.  
  60. --------
  61. Keys.ini
  62. --------
  63. The keys.ini file associates keycodes with functions.
  64. See the docs\Functions.txt file for details about the functions.
  65.  
  66. Format:
  67.  
  68. [menu]
  69.   Key(keycode, shift, ctrl, alt) = function(params...)
  70.  
  71.     menu     - Only one group, [TV], is used at the moment.
  72.                Once menu's are implemented then you will be able to a group
  73.                for each menu.
  74.     keycode  - The virtual key code number of the key to assign.
  75.                if a key isn't assigned, and keycode is enabled in osd.ini then
  76.                the keycode will be shown on the osd when the key is pressed.
  77.                You can also specify a character inside single quotes eg. 'X'
  78.                if it's a character from a to z then it should be a capital.
  79.     shift    - 0 for shift not pressed
  80.                1 for shift pressed
  81.     ctrl     - 0 for ctrl not pressed
  82.                1 for ctrl pressed
  83.     alt      - 0 for alt not pressed
  84.                1 for alt pressed
  85.     function - any function listed in the docs\Functions.txt
  86.  
  87.   Mouse(event, shift, ctrl, alt) = function(params...)
  88.   
  89.     event - 2 for left double click
  90.             3 for right click
  91.             4 for middle click
  92.             5 for mousewheel scroll up
  93.             6 for mousewheel scroll down
  94.     shift    - 0 for shift not pressed
  95.                1 for shift pressed
  96.     ctrl     - 0 for ctrl not pressed
  97.                1 for ctrl pressed
  98.     alt      - 0 for alt not pressed
  99.                1 for alt pressed
  100.     function - any function listed in the docs\Functions.txt
  101.  
  102.  
  103. -------
  104. OSD.ini
  105. -------
  106.  
  107. I have to rewrite this because the osd changed heaps in this release.
  108. You should be able to pick up the general idea by going through the file.
  109.  
  110. ------------
  111. Settings.ini
  112. ------------
  113.  
  114. CardNumber - If you have multiple cards then you can choose to use the
  115.              second or third card by putting a 2 or 3 here.
  116.              DigitalWatch does not support using two card simultaneously yet.
  117.              You can also specify the use of a different card by executing
  118.              DigitalWatch.exe /card x
  119.              Default: 1
  120.  
  121. DVBInput - Selects which input module to use for providing Video and Audio streams.
  122.            1 - DVBSource -> TS Splitter
  123.            2 - DVBSource -> Mpeg-2 Demultiplexer
  124.            4 - DVBSource -> Mpeg-2 Demultiplexer -> TimeShifting
  125.            When using 2 or 4 any AC3 pids in channels.ini need to be prefixed with an A.
  126.            eg. Program_2("Nine Digital HD", 0, 512, A650, 0)
  127.            Default: 2
  128.  
  129. CaptureFileName - The location and name of a recorded file.
  130.     %Y - Year (4 digit)
  131.     %y - Year (2 digit)
  132.     %m - Month
  133.     %d - Day
  134.     %H - Hour (24 hour)
  135.     %M - Minute
  136.     %s - Second
  137.     %h - Hour (12 hour)
  138.     %A - AM/PM
  139.     %a - a/p
  140.     %W - Day of week (eg. Sunday, Monday, ...)
  141.     %w - Short day of week (eg. Sun, Mon, ...)
  142.     %X - Name of month (eg. January, February, ...)
  143.     %x - Short name of month (eg. Jan, Feb, ...)
  144.  
  145.     %N - Current Network Name
  146.     %P - Current Program Name
  147.     %n - Current Network Number
  148.     %p - Current Program Number
  149.  
  150.     %% - %
  151.  
  152. OSDTimeFormat - The format of the time displayed on the OSD.
  153.                 It uses the same tokens as CaptureFileName
  154.  
  155. TimeShiftFolder - The folder where timeshifting files will be stored
  156.  
  157. TimeShiftBufferMinutes - The number of minutes to buffer for timeshifting
  158.  
  159. AspectRatio - The AR setting isn't for the AR of your output device. It's the
  160.               AR that the source video should be shown at.
  161.               To work out the correct value for here first you need to work
  162.               out if the pixel stretch ratio for your system.
  163.                 (stretch ratio) = (tv or monitor AR) / (video card AR)
  164.                                 = (16/9)             / (800/600)
  165.                                 = 1.33
  166.               then to compensate you need to squash the source by the same
  167.               factor.
  168.                 (DW AR setting) = (source AR. Always 16:9) / (stretch ratio)
  169.                                 = (16/9)                   / (1.33)
  170.                                 = 1.33
  171.                                 = 4/3
  172.               Default: 16:9
  173.  
  174. Zoom - Percentage of window size to scale video.
  175.        Default: 100
  176.  
  177. ZoomMode - if 0, then 100% zoom fits all the video in the window
  178.            if 1, then 100% zoom makes the video the full height of the window
  179.            Default: 0
  180.  
  181. StartFullscreen  - if 0, DigitalWatch starts in windowed mode
  182.                    if 1, DigitalWatch starts in fullscreen mode
  183.  
  184. StartAlwaysOnTop - if 0, DigitalWatch starts with AlwaysOnTop turned off
  185.                    if 1, DigitalWatch starts with AlwaysOnTop turned on
  186.  
  187. StartLastWindowPosition - if 0, then windows default window position
  188.                           if 1, then LastWindow* values used
  189. LastWindowPositionX - X coordinate of upper-left corner of video window
  190. LastWindowPositionY - Y coordinate of upper-left corner of video window
  191. LastWindowWidth     - Width of video area
  192. LastWindowHeight    - Height of video area
  193.  
  194. StoreFullscreenState  - if 0, StartFullscreen is left alone.
  195.                         if 1, StartFullscreen is updated match the fullscreen
  196.                               state when DigitalWatch closes.
  197.  
  198. StoreAlwaysOnTopState - if 0, StartAlwaysOnTop is left alone.
  199.                         if 1, StartAlwaysOnTop is update to match the
  200.                               AlwaysOnTop state when DigitalWatch closes.
  201.  
  202. StoreLastWindowPosition - if 0, LastWindow* values are left alone.
  203.                           if 1, LastWindow* values are updated when
  204.                                 DigitalWatch closes.
  205.  
  206. StartLastChannel - if 0, DigitalWatch does not load a channel when it starts
  207.                    if 1, DigitalWatch loads the channel specified by
  208.                          LastNetwork and LastProgram when it starts.
  209.  
  210. LastNetwork - value matching a Network_* entry in channels.ini
  211.  
  212. LastProgram = value matchins a Program_* entry in channels.ini
  213.  
  214. DefaultVideoDecoder - if 0, uses automatic graph building for video.
  215.                       else, 1 based index of an entry in VideoDecoders.ini
  216.  
  217. DefaultAudioDecoder - if 0, uses automatic graph building for audio.
  218.                       else, 1 based index of an entry in AudioDecoders.ini
  219.  
  220. DefaultBrightness
  221. DefaultContrast
  222. DefaultHue
  223. DefaultSaturation
  224. DefaultGamma
  225.      - color control values for channels without a SetColorControls entry
  226.        in channels.ini
  227.  
  228. DisableScreenSaver - if 0, Screen saver not disabled.
  229.                      if 1, Screen saver disabled.
  230.  
  231. BasePriority - if  2, Realtime
  232.                if  1, High
  233.                if  0, Normal
  234.                if -1, Idle
  235.  
  236. AddToROT -
  237.             if 0, the graph isn't added to the Running Object Table.
  238.             if 1, the graph is added to the Running Object Table.
  239.  
  240. -------------------------------------
  241. VideoDecoders.ini & AudioDecoders.ini
  242. -------------------------------------
  243. See the default VideoDecoders.ini and AudioDecoders.ini for an examples
  244.  
  245. Format:
  246.     [group header]
  247.     eg. [filter group name]
  248.  
  249.     LoadFilter(CLSID, "unique name")
  250.         - loads a directshow filter into the graph and give it a name.
  251.  
  252.     SourcePin("unique name", "Input Pin")
  253.         - Use once to connect the video stream source to the
  254.                      first filter you want to use.
  255.  
  256.     ConnectPins("unique name", "Output Pin", "next name", "Input Pin")
  257.         - Connect the output of one filter to the input of the next
  258.  
  259.     RenderPin("next name", "Output Pin")
  260.         - Renders an output pin of a filter. Not needed if
  261.           you connect up all the filters with ConnectPin.
  262.  
  263.     RenderSourcePin()
  264.         - Renders the source pin of the graph. Try using this
  265.           if you have trouble with SourcePin, ConnectPins, and RenderPin.
  266.  
  267.  
  268. If you want to figure out the these entries for yourself then
  269.     - load up graphedt.exe (from DirectX SDK 9)
  270.     - open up the "graph->insert filters" dialog
  271.     - find and click on the filter you want to use
  272.         (eg. Intervideo Audio Decoder)
  273.     - in the Filter Moniker: box there should be something like
  274.         @device:sw:{083863F1-70DE-11D0-BD40-00A0C911CE86}\{7E2E0DC1-31FD-11D2-9C21-00104B3801F6}
  275.         the bit after the \ is the CLSID to use.
  276.  
  277.     - Now click insert filter then close the dialog.
  278.     - The Input and Output pin names should be shown on the filter.
  279.         Input pin: XForm In
  280.         Output pin: XFrom Out
  281.  
  282.     Now with that information you'll be able to make an entry.
  283.  
  284. [Intervideo Audio Decoder]
  285. LoadFilter ({7E2E0DC1-31FD-11D2-9C21-00104B3801F6}, "Intervideo Audio Decoder")
  286. LoadFilter ({79376820-07D0-11CF-A24D-0020AFD79767}, "Default DirectSound Device")
  287. SourcePin  ("Intervideo Audio Decoder", "XForm In")
  288. ConnectPins("Intervideo Audio Decoder", "XFrom Out", "Default DirectSound Device", "Audio Input pin (rendered)")
  289.  
  290.  
  291.  
  292. ---------------
  293. Resolutions.ini
  294. ---------------
  295. A list of resolution entries.
  296.  
  297. Format:
  298.  
  299.     Resolution_<number>(left, top, width, height, move, size)
  300.  
  301. eg. Resolution_1(10, 100, 704, 408, 1, 1)
  302.  
  303.     number        - Choose a unique number greater than 0.
  304.     left, top     - values used when moving the window
  305.     width, height - values used when resizing the window
  306.     move          - 1 to move the window
  307.                     0 to not move the window
  308.     size          - 1 to resize the window
  309.                     0 to not resize the window
  310.  
  311.  
  312. ---------------
  313. ControlBar.ini
  314. ---------------
  315.  
  316. Format:
  317.  
  318.   Bitmap(filename, x, y, width, height)
  319.     Specifies the file and the region of the file to use.
  320. eg. Bitmap(images\controlbar.bmp, 0, 0, 1004, 47)
  321.  
  322.     filename - image filename relative to DigitalWatch.exe path
  323.     x, y, width, height - region of the bitmap to use for the controlbar
  324.  
  325.   
  326.   Location(left %, top %, width %, height %)
  327.     Defines where the control bar will appear in the window
  328. eg. Location(5, 86, 90, 6)
  329.  
  330.     All these values can include decimal places.
  331.     left % - left edge of the controlbar on the window
  332.              eg. 10 is 1/10th way across the window
  333.     top % - top edge of the controlbar on the window
  334.             eg. 50 is half way down the window
  335.     width % - width of the controlbar on the window
  336.               eg. 80 is 4/5ths the width of the window
  337.     height % - height of the controlbar on the window
  338.                eg. 5 is 1/20th the height of the window
  339.  
  340.   ActivationPerimeter(distance %)
  341. eg. ActivationPerimeter(2.5)
  342.  
  343.     distance % - the distance from the edge of the controlbar that mouse
  344.                  movement will activate the controlbar.
  345.  
  346.   Button(x, y, width, height)
  347.     Denotes an area of the bitmap as a button
  348. eg. Button(491, 1, 46, 46)
  349.  
  350.     x, y - bitmap coordinates relative to x and y from the Bitmap() function
  351.     width, height - the size of the button
  352.  
  353.  
  354.   Click(shift, ctrl, alt) = function
  355.     Specifies what functions to call when a button is clicked
  356. eg. Click(0,0,0) = ZoomIn(10)
  357. eg. Click(1,0,0) = ZoomIn(1)
  358.  
  359.     At least one Click() must be defined for each Button()
  360.  
  361.     shift - 1 for if the shift key is pressed
  362.             0 for if the shift key is not pressed
  363.     ctrl - 1 for if the ctrl key is pressed
  364.            0 for if the ctrl key is not pressed
  365.     alt - 1 for if the alt key is pressed
  366.           0 for if the alt key is not pressed
  367.     function - any function listed in the docs\Functions.txt
  368.  
  369.  
  370.   Highlight(x, y, width, height)
  371.     Specifies the area of the bitmap to display when the mouse is over the
  372.     button. If this omitted then highlighting is done by inverting the
  373.     normal button image.
  374. eg. Highlight(491, 1, 46, 46)
  375.  
  376.     x, y - the upper left corner of the area in the source image
  377.     width, height - the size of the area in the source image
  378.  
  379.