JudoTimer Display Layout Customization

You can use text file to customize the JudoTimer display layout. Two example files are provided in JudoShiai/etc directory: timer-custom.txt and timer-tv-logo.txt.Note! The files will be overwritten when you install a new JudoShiai version. Take copies and edit those.

The file consists of text lines. Each line describes one label (letter, text, number) or special data. Label lines have 14 values (columns) separated by spaces. Lines beginning with a hash mark (#) are comments. Number of special data line values depend on the data.

X and Y coordinates can have values 0.0 – 1.0. Upper left corner has coordinates 0.0, 0.0, upper right is 1.0, 0.0, lower right is 1.0, 1.0.

Width and height can have values 0.0 – 1.0. 1.0 means the full width or height of the window.

Colors can have values 0.0 – 1.0 (black to full intensity). Many times negative red color means transparency. Note! Transparency is fully supported in Linux only. Also transparency depends on the display adapter.

Meanings of the label line columns are described in the following table:

Window layout. This useful for TV logos. Some window managers ignore requests for initial window positions so x and y values may have no impact.

2

X position in pixels (0 – screen width).

3

Y position (0 – screen height).

4

JudoTimer window width in pixels.

5

JudoTimer window height.

105

Background picture. Picture will fill transparent areas.

2

Path to a PNG picture, for example C:\Pictures\logo.png. If picture is relative to the JudoShiai installation directory you can use two dots for the JudoShiai directory. For example timer-tv-logo.txt is here:

Example

We want to make a layout for video streamer (see Appendix Video Stream Setup). JudoTimer will run in slave mode, but it should look different than the master clock. We need only competitors' names, scores and clocks. It would be nice to have a fancy looking background. It is not necessary to show both clocks if there is no osaekomi. To save space the clocks should be overlapping. Also shidos should be hidden if there is none.

There are some text, but it could be for example a logo. There are white and blue backgrounds for names and scores. Dark gray background is for osaekomi clock. Note that white areas are actually transparent.

Next we edit the timer-tv-logo.txt file so that the names, scores, and clocks are positioned and sized properly. All the label backgrounds except the shiai clock are transparent to show the nice background picture. Shiai clock background must be opaque to cover the osaekomi clock totally. When osaekomi starts shiai clock is not drawn any more and the grey background appears.