jtv.gif (7126 bytes)
English Russian
About
News
Projects
Files
Notes
Links
Guestroom



  Notes in block

JTV 3.0 (12.6) : Commands and Keys 
TVGuide on RCUChannel parameters Responses
The program JTV (Jaak TV), which author is Jaroslaw Kowalski, (jaak@polbox.com), is intended for review of television channels with the help of BT8x8-chip PCTV-tuners. Despite of defect presence, this program till now remains quite competitive and it is pleasant much. However presence of defects forces to press in a detail of hand-held customization of parameters JTV to use all its possibilities. The version JTV 3.0 wip 12.6, working in the environments Win95/98/ME/NT/2000/XP is most distributed now, and all below ratated to it, until other version is indicated.

JTV (as well as any similar program) is controlled by user through devices of input: the keyboard, mouse or remote control unit (RCU). A feature of JTV is that the binding of JTV commands to keys are born in a separate text file KEYS.TXT, which is easy for editing, but also it is easy and 'to spoil' on imprudence. In this file are included both binding to RCU buttons, and to keys of the keyboard.
The set of keys of the keyboard is standard and, if there is no large desire to alter all under itself, it is possible to use 'standard' bindings, which have got to you in a JTV package. But the set of buttons for concrete RCU can differ from which this file was customized for, that creates some problems. A typical problem caused by such mismatch, is the impossibility of normal handle JTV with RCU, though on a tab 'Diagnostics' in JTVRemote all buttons are displayed correctly.
The JTV author has provided partial solution of this problem and has entered concept of 'common' codes of RCU buttons, which certainly are present and can be defined (and activated through the driver) in anyone's RCU, but their set is limited. That is why, that contents of the file KEYS.TXT can is strong differ in different JTV packages. Therefore all underwritten concerns to package jtv3w126.zip, from the site http://jtvhost.chat.ru and to the file keys.txt from this package.

It was supposed that editing and saving file KEYS.TXT should be possible from within JTV through the item ' Key Bindings...' (Alt-F9) of the main menu JTV, in the given below window of the bindings editor.
As it is visible on this picture, the possibility of binding to the command exists both for keys of the keyboard (Assign...), and buttons of RCU (Remote...). However function of editing is not realized yet. In this window it is possible only viewing already existing keys binding to JTV commands, but editing anything it is impossible: though files of rollback (KEYS0.TXT, KEYS1.TXT...) is serviceable, in the file KEYS.TXT nothing is written.
At the same time, this window is useful for review and control of correctness of the entered manually bindings, and also correctness of writing of JTV commands both review of layout schemes and names of RCU buttons (Remote...).

Rules of command bindings to keys (buttons) are obvious; it is possible to assign to one command some keys and RCU buttons, it is important only that the same key (button) were not assigned to different commands in one group of commands.
For example, as it is visible on a picture, the "T" key is assigned to the command Main.Teletext.Show in group Main.
If assign the same key to the command Main.TVGuide.Show, it will be error, as the command is included into the same group Main, but if assign it to command Teletext.Cycle, all is correct, as the command is included into other group - Teletext. Other assigned keys for these two commands duplicated too.

Thus, and for entering/exiting of the Teletext mode, and for exhaustive use of possible variants of its mapping the same keys (button) are used, that quite conveniently and is logically justified.

However, the entering the mode Teletext with RCU will be possible only in the case that in the RCU driver the "Key_Teletext" button will be defined. Thus it is unimportant, whether there is a button with such name on RCU, there is enough that the name of the button was assigned, at creation of the driver, to any of really available. On RCU AVerMedia TVPhone98 w/VCR, for which given file KEYS.TXT was customized, such button is present.

The names of buttons defined at creation of the concrete RCU driver file are hardwired in it, and they always can be looked on "Diagnostics" tab of the "Configuration" item in the menu JTVRemote, as it is visible on left picture.

In the AVerMedia TVPhone98 w/VCR RCU driver, "Key_Teletext" is defined among other buttons, shown on a picture.
The second names of buttons, given in brackets, there where they are, mirror "common" codes of buttons, which are synonyms, counterparts of the main name. They can be used in the file KEYS.TXT instead of the main names.

The names of "common" codes are hardwired in executable files of the program and can not be changed. To them concern: 0, 1..., 9, Power, Recall, VolumeUp, VolumeDown, ChannelUp, ChannelDown, Left, Right, Enter, Up, Down, NextLinear, PrevLinear. Visually, at mapping the scheme of RCU layout (Remote...), they are designated by graphic characters, which occur on appropriate buttons of the remote.
The scheme of RCU layouts are stored in text .RCU-files in the subdirectory \Remote. They are intended only for visualization of the schemes of RCU layouts and form manually at creation of the appropriate RCU driver. It is meaningful to edit them only in case of creation of the new file of layout on a basis already existing.

It is obvious, that it is senseless to define the "Key_Teletext" button for the RCU drive where it really is not present (for example, in RCU FlyVideo 98), better simply to assign, if necessary, one of real-life, for example "Key_Esc", to command Main.Teletext.Show, accordingly having edited the file KEYS.TXT. In the given example string of the file
Main.Teletext.Show,REMOTE:Key_Teletext
can possible to replace on
Main.Teletext.Show,REMOTE:Key_Esc,
Or even to add it to initial:
Main.Teletext.Show,REMOTE:Key_Teletext
Main.Teletext.Show,REMOTE:Key_Esc.

There are common rules of usage and editing of the file of bindings KEYS.TXT.

Concerning concrete implementation of the file, included in a mentioned package, it is possible to tell the following: all very much individually, however common reasons, probably, can be useful. It is obvious, that than more full and more logically fulfilled the binding of commands to keys are made, the more convenient is the program using. On the other hand, everyone has the habitual preference as in structure of the involved keys of the keyboard, and RCU buttons. Write here the complete list of bindings of commands and keys, as it seems, is not meaningful. Everyone can view the file KEYS.TXT either in a text editor, or in the editor of bindings JTV. I shall bring only examples for the best understanding of a question.

Binding to RCU: TVGuide and other...
When I first customized JTV, I was not necessary did any of binding to the keyboard - I practically did not use it. But RCU used. And I was interested only with the following JTV functions: review of telecasts and usage of TVGuide, and accordingly, all commands, connected to it. Having fulfilled correction of binding of standard commands to appropriate buttons of my RCU, I was convinced what using RCU is not absolutely conveniently. In the evening the TV set usually look at the reduced lighting in a room, and as illumination of buttons in RCU is not present, it is necessary to search for them in touch. As it is possible to assign any command to any button, there is a desire all most frequently used functions to have near at hand, i.e. on buttons nearest to the large finger of a hand, when the back RCU side rests on a palm. 2 lower rows of RCU buttons to the touch are easily recognized, 3-rd row - is already more difficult.

AUTOSCAN FREEZE CAPTURE MUTE
RECORD PAUSE STOP PLAY
RED -     VOLUME      + YELLOW
GREEN <    CHANNEL     > CYAN

4 lower rows of RCU buttons for AVerMedia TVPhone98 w/VCR at the left represented.
The buttons RED, YELLOW, GREEN, CYAN concern and are assigned to appropriate commands of group Teletext. However nothing prevents to assign to him commands from other group.

Grope the button MUTE to disable a sound of importunate advertising inconveniently; intuitively correct to search it near to buttons VOLUME. Assign to button RED the function of the button MUTE: Main.LinearMute,REMOTE:Key_Red.

Frequently, there is a desire temporarily tune parameters of the channel: Brightness, Saturation, Contrast. Bind the button YELLOW to command of exhaustive search of parameters of the channel: Main.CycleLinearUp,REMOTE:Key_Yellow. It is possible to tune selected option by buttons VOLUME now.

To control the menu TVGuide, it is very convenient to use buttons GREEN, CYAN and CHANNEL.
Bind to the button CYAN the command of an entrance in the menu and items TVGuide:
Main.TVGuide.Show,REMOTE:Key_Cyan
TVGuide.Details.Show,REMOTE:Key_Cyan
TVGuideChannelList.ShowProgrammeList,REMOTE:Key_Cyan.

Bind to the button GREEN exiting from TVGuide:
TVGuideChannelList.Hide,REMOTE:Key_Green
TVGuide.HideChannelGuide,REMOTE:Key_Green
TVGuide.Details.Hide,REMOTE:Key_Green.

For moving in the menu TVGuide we shall involve buttons CHANNEL:
TVGuideChannelList.Next,REMOTE:Key_ChannelUp
TVGuideChannelList.Prev,REMOTE:Key_ChannelDown
TVGuideDetails.ScrollDown,REMOTE:Key_ChannelUp
TVGuideDetails.ScrollUp,REMOTE:Key_ChannelDown
TVGuideProgrammeList.Next,REMOTE:Key_ChannelUp
TVGuideProgrammeList.Prev,REMOTE:Key_ChannelDown
.

It is convenient also to involve the button GREEN for review of the information about current transmission:
Main.TVGuideQuick.Toggle,REMOTE:Key_Green.

As the buttons GREEN and CYAN are already involved in groups TVGuideDetails and TVGuideProgrammeList, the switching on the selected channel from within TVGuide can be hung up on the button YELLOW, which is not involved in these groups: TVGuideDetails.SwitchToChannel,REMOTE:Key_Yellow
TVGuideProgrammeList.SwitchToChannel,REMOTE:Key_Yellow
.

Naturally, someone cannot like the offered layout - create own.

Channel parameters customization
Usually I agree with common values of parameters Brightness, Saturation, Contrast etc. for all channels and it is not necessary an individual, separate customization for each channel to me. However in link with questions in this occasion, it was decided to clear up this too. The initial information I have found on http://welcome.to/jtvrus/ and after own experiences has determined the most convenient order of operations.

In order to information of channel parameters customizations has been written in appropriate section of the file CHANNELS.CHL, it is necessary to fulfil the following operations:

1. Select the required parameter (Brightness, Saturation, Contrast etc.), when viewing the necessary channel, by keys "HOME/END" on the keyboard. In the JTV window must be displayed the name of the parameter (green colour) and current level (bar of green colour) for a selected option. Expose the level of the parameter approximately on middle (50 %) - with keys "-/+" of the digital panel (it is desirable - but not necessarily).

2. Enable the mode of correction by the "A" key on the keyboard. In the JTV window the name (yellow colour) for a selected option now is displayed only. The level of the parameter is not displayed, as not it will vary, but coefficient of correction of the parameter.

3. By keys "-/+" expose, being oriented on a picture, new necessary value of the parameter, adhered to its current level. In further all values of the parameter for its any level will be counted in view of the installed coefficient. The closest analogy - gamma-correction of the videoadapter. Approximately so.

4. Disable the mode of correction by the "A" key on the keyboard. On the screen are again displayed the name and level of green colour for a selected option.

5. After exit from JTV, if all is made correctly, it is possible to see the saved changes in the file CHANNELS.CHL, similar following:
[Channel1]
Name=OPT
Frequency=4975
Enabled=1
TVStandard=2
fMaster=0.030000
fTVVolume=0.100000
fBrightness=-0.300000
fSaturation=0.020000
fHue=0.020000

During clearing up this question, it seemed, that it would be more convenient to use the separate keys for regulation of each parameters and bind the mode of correction on the digital panel and on RCU. In result the file KEYS.TXT was supplemented by the following strings:

Main.ToggleLinearCorrectionMode,Insert
Main.ToggleLinearCorrectionMode,REMOTE:Key_Play
Main.BrightnessReset,B
Main.BrightnessUp,Shift+B
Main.BrightnessDown,Ctrl+B
Main.ContrastReset,C
Main.ContrastUp,Shift+C
Main.ContrastDown,Ctrl+C
Main.SaturationReset,S
Main.SaturationUp,Shift+S
Main.SaturationDown,Ctrl+S
Main.HueReset,H
Main.HueUp,Shift+H
Main.HueDown,Ctrl+H
Main.CDVolumeMute,D
Main.CDVolumeUp,Shift+D
Main.CDVolumeDown,Ctrl+D
Main.WaveVolumeMute,W
Main.WaveVolumeUp,Shift+W
Main.WaveVolumeDown,Ctrl+W
Main.TVVolumeMute,V
Main.TVVolumeUp,Shift+V
Main.TVVolumeDown,Ctrl+V
Main.MasterVolumeMute,M
Main.MasterVolumeUp,Shift+M
Main.MasterVolumeDown,Ctrl+M

After these changes it is possible, in addition, to use in the described above items:

  • "C", "S", "B", "H" keys - for installation of 50% level for Contrast, Saturation, Brightness and Hue
  • Keys Shift/Ctrl + values, mentioned above for increase/decrease, of the appropriate parameter.
  • The "Ins" key and button PLAY on RCU for enabling/disabling correction mode.

Besides, by analogy, it is possible to use keys D, V, M, W for turning on/off sound of appropriate mixer channel, and in a combination with Shift/Ctrl - to increase/reduce volume of a sound.

That is all for brief description both operating procedure with commands and keys in JTV.

01/06/2002 © Ivan Kolin, ivkolin@mailru.com . Updated 02/12/2002


If you have taken advantage of this information, also have received result or not, or have additions and specifications which can help anothers, please, mail about it to the address <jtvhost@mailru.com> or write in guestbook of this site. Your responses will be located here. Do not forget to point your hardware configuration: Processor / Motherboard / Videocard / TV-card / OS version / TV-software.

Responses ...


 Copyright ©  2000-2002,   Ivan Kolin   ivkolin@mail.ru Íàâåðõ