The TrackImg.tiff Image

"19Jul2" File Coordinates

Introduction

TrakSim is distributed with a text file "TrackImg.txt" containing several sample track specifications, and a coordinating TIFF image file "TrackImg.tiff", which can be used to generate any of several simulated tracks to run your self-driving vehicle code in. The image fragments in the TIFF file are accessed by (zero-based) row & column coordinates of the top-left corner of each fragment, plus the height and width of that fragment in pixels, plus a scale factor pixels-per-meter for determining how bit to draw that image fragment on-screen. This document lists the fragments in the current release, plus the coordinate numbers for each fragment, so that you can re-use the fragments in your own track specifications.

TrackSim can work with an image up to 4000x4000 pixels, but the current release dated "19Jul2" is 1088 x 1024 (tall x wide). The left half (512 pixel columns) is the same as the release last month. The top 256 pixel rows of that are essentially the same as the original release in 2018. Additional image fragments were added primarily to support the first three F-1/10 race tracks (U.Penn, Porto, and Turin). This coordinate list is divided into two sections, the original release, and then the F1/10 race track additions.

The current release contains (mostly in the right half) images to add verisimilitude to the "MSB" tracks, two areas where the 2019 summer program expects to be testing our development car in a variety of credible race configurations.

For more information on the Tagged Image File Format see the Aldus/Microsoft Technical Memorandum dated 8/8/88.
 

Top 256 Pixel Rows
F-1/10 Additions
MSB Additions
Back to front of TrakSim

Top 256 Pixel Rows (left 512)

 
Name
Tall
Wide
Coln
Row
PPM
Rev.Date = "19Jul2"
7
20
60
248
*
1
0o Stop Sign
128
29
1
0
50
 
45o Stop Sign
128
17
32
0
50
 
135o Stop Sign
64
9
50
0
25
 
180o Stop Sign
64
15
60
0
25
 
90o Stop Sign
64
3
76
0
25
 
-90o Stop Sign
64
3
80
0
25
 
(dark traffic light)
255
25
84
0
24
2
Green Traffic Light
255
25
110
0
24
3
Amber Traffic Light
255
25
136
0
24
3
Red Traffic Light
255
25
162
0
24
3
Ped Facing Right
64
23
1
132
25
 
Ped Facing Left
64
23
55
132
25
 
Ped Steps Right
64
29
25
132
25
 
Ped Steps Left
64
29
52
66
25
 
Painted Stop Line
83
99
412
172
32
4
Painted Line (alone)
6
96
413
173
32
5
Yellow Hiway Stripe
8-20
216
192
240
32
6
Oval Luminary
24
56
354
172
*
7
Digit 0
5
3
16
248
4/32
8
Digit 1
5
3
20
248
32
 
Digit 2
5
3
24
248
32
 
Digit 3
5
3
28
248
32
 
Digit 4
5
3
32
248
32
 
Digit 5
5
3
36
248
32
 
Digit 6
5
3
40
248
32
 
Digit 7
5
3
44
248
32
 
Digit 8
5
3
48
248
32
 
Digit 9
5
3
52
248
32
 
Car, Right Front
54
157
190
2
36
9
Car, Left Front
54
157
352
2
36
 
Car, Left Rear
54
157
190
58
36
 
Car, Right Rear
54
157
352
58
36
 
Car, Left Side
54
155
190
114
36
 
Car, Right Side
54
155
352
114
36
 
Car Rear
54
78
190
172
36
 
Car Front
54
78
274
172
36
 
"Servos Active!"
40
80
0
200
*
10
(unused)
28-44
60
352
196
 

Notes

1. The revision date is not intended for display, so no scale factor applies.

2. The dark traffic light can be used for off-center views, where the color of the light is directed and not visible except to vehicles on the street directly in front of it.

3. You can specify a traffic light shorter than 255 by 6 pixels or more, and the shadow will not appear on the street below it.

4. These coordinates include a faint gray outline around the white paint.

5. These coordinates exclude the faint gray outline around the white paint. You can use less width and height for a shorter or narrower line on the street.

6. There are eight pixels of line width starting row 240, but you can specify its position more precisely by including up to 12 additional (blank) pixels above (or below) the image in the file. You can also make the line narrower by starting on a later row or specifying less height.

7. These coordinates include a faint gray outline around the white lamp globe. You can make your luminary smaller by starting later (row and/or column) and/or making the height and width less, but your reduced rectangle will not be displayed as oval. Distant luminaries tend to lose pixels and show as non-oval anyway.

8. Used as paint in high-resolution (32ppm, option +4) mode, these numerals can be used to number key coordinates on the close-up map display. They could also be used in low-resolution and display much larger.

9. I scraped images for the front, rear, and two sides from the internet, then wrote a program to merge these into the four 45o views, with some manual fixups where the perspective didn't come out right. They look a little clunky, but workable.

10. There is a mode in TrakSim which lets you calibrate the servo range for steering and speed. I added this warning to let users know that their self-driving code had been overridden. If you don't use that mode, you could recycle this space in the image file for other purposes. Actually, you can do that with any of the image fragments in the file that you are not using.
 

F-1/10 Additions

 
Name
Tall
Wide
Coln
Row
PPM
Notes
Rev.Date = "19Jul2"
7
20
60
248
*
 
Plain tube wall, no ends
54
8-160
301
258
32/24
11
Left tube end, side view
54
64+
172
258
32
12
Right tube end, side view
54
+64
...430
258
32
12
Left tube end, angle view
54
92/64
76/120
258
32
13
Right tube end, angle view
54
92/64
176/162
258
32
12
Tube wall end cap (C)
54
73
16
258
32
13
Tube wall end cap (L)
54
64
32
258
32
13
Tube wall end cap (R)
54
64
10
258
32
13
Goal side post
164
72
420
321
32
14
Goal cross-bar
8
304
16
480
22
14
Porto windowed wall
263
74
2
636
22
14
Porto spects & curtains
144
470
2
490
13
Porto spectators
200
360
80
636
30
15
Turin houses card
54
200
200
324
32
16
Refreshment Table
35
62
133
320
8
17
Baseboard wall swatch
34
10
1
432
12
18
Montreal baseboard strip
77
10
501
488
77
 
Gray wall swatch
66
10
501
316
*
 
Plain cardboard wall
101
8
502
385
*
18
Brown floor stripe
10
452
16
466
4
19
Fire extinguisher
90/135
13
476
488
8
20
Guy standing in track
115
44
1
316
8
 
Vertical meter stick
50
5
448
848
50
21
12" orange traffic cone
43
35
410
856
16
21
U.Penn Logo
74
84
380
150
32
 
U.Penn Logo back paint
96
96
360
48
4
 
Other car
60
104
240
400
40
 
Diagonal start line 
64
64
348
384
4
 
Turin door 
100
40
432
640
5
 
Turin ashcan 
40
20
456
859
6
 
Porto floor tile 
96
96
412
744
16
 
MSB rug tile 
32
80
296
864
8
 
(unused) 
64
216
80
836
   
Name
Tall
Wide
Coln
Row
PPM
Notes

Notes

11. Instead of lines demarking the track boundaries, the F-1/10 race tracks use flexible dryer-vent tubing stacked two-high. I captured some images from the Turin race videos and built sanitized images of the tubing here. There are essentially three views: the end-cap, the same end viewed at an angle, and the plain side view. Because the image walls in TrackSim fill whole 2m grid cells, the end view is actually wider than in real life. I deemed this to be an acceptable deviation because when your car is driving properly, it won't be looking at these end-caps straight on. Almost everything else is taken from a segment in the middle of the side-view image (excluding the end caps) and repeated.

Compared to nearby standing people in the video, the Turin track seems to have used 6" (15cm) tubing, whereas the U.Penn and Porto tracks used 4" (10cm) tubing. This is easily achieved by adjusting the scale factor, the larger scale factor representing the smaller tubing.

12. You can spread the tube-wall end over several grids, and adjust the width of the image fragment used for it to match, because repeating the image fragment doesn't make sense when one end has a fold-over. Left ends have a well-defined starting point, but right ends may take some fiddling with the width and horizontal image coordinate to get it to come out right. The (minimum) widths shown are at the 32ppm resolution to cover one grid cell (2m = 64 pixels); for other wall heights (like 24ppm) you would reduce or increase the width proportionately. Note that the angled views are also specified for the 45o diagonal, which is 2 meters times the square root of 2.

13. In order to mitigate the bloated look of track boundary walls two (park) meters (10" = 25cm actual) wide when seen from the end, I replaced some of that width with empty space, which you can select by choosing a different starting column on the same image fragment. If you were watching it as your car moved from one side to the other, you'd see the end cap jump in the opposite direction, but TrakSim cars cannot look sideways while moving forward, so the effect is never actually seen. In any case these end-caps are only used for hair-pin turns, which so far have been limited to the Turin track.

14. The Porto track set up the finish line as a horizontal bar across the track, held up by two posts placed just in front of the tubing wall. I simulated this effect by making a one-grid stretch of the wall taller to include the post, and then making the crossbar into a luminary that doesn't actually give off any light, and that is visible only straight-on from the track. The spacing isn't perfect, but close enough to serve as a landmark for a driving program memorizing the track.

15. The Porto race was held in a very ornate European building with windows and balconies overlooking what appeared to be a covered patio. From the videos I made up a composite frame of a wall consisting of one lower alcove with the balcony and windows in that vertical segment, then repeated it all around the track area. Other scenery was then constructed as walls in front of that.

16. In addition to the tubing walls, the Turin track used as track boundaries, either singly or in a run, cards about 2 meters long by a half-meter tall, pre-printed with commercial-art houses along a street over a white background. I approximated the drawing and added a slight off-white cast to the sky so it would not be transparent. Because TrakSim tries to put a shorter wall in front of a taller when they both render at the same raster base, I also did some overlapping tube-walls from the Porto goal-post segment (but omitting the post) so it would be (transparently) taller than the cardboard, and therefore render behind the cardboard, as appears in the video.

17. The room used for the Turin track had some tables set up at one end, apparently for refreshments. Different videos showed the tables in slightly different configurations, so I picked one. They were always behind the houses cards at that end, so my screen capture got only the upper strip of view, which I manually extended downward to halfway, then left the bottom half blank.

18. I made a separate wall to represent the baseboard using a square swatch about the right color, then adjusting the scale factor to get the wall height correct. I also included blank space above the swatch to make the wall computer as taller, so it would come behind the houses card where they overlap. The F-1/10 rules webinar suggested flattened out cardboard as an alternate wall material, so I included a strip of uncolored cardboard that can be sized and repeated for that purpose.

19. Low-resolution brown stripes on floor as in Turin.

20. The image is only 44 pixels tall in the file, but by including different amounts of blank space below it, I could make the same fire extinguisher image display waist-high on one side of the Turin room (as an artifact), and shoulder-high on the other (as a wall segment with different views).

21. Sometimes I needed to verify the scale factor on an artifact, so I created this precisely measured meter stick to put next to it in the scene. When I was testing hardware mobility, I bought a 12" traffic cone (that would be 2.5 park meters) to give an unmistakable landmark for the software to look for. Then I needed to make sure the simulator worked the same, so here's its image.
 

MSB Additions

 
Name
Tall
Wide
Coln
Row
PPM
Notes
Rev.Date = "19Jul2"
7
20
60
248
*
 
MSB garage view eastward
158
500
512
2
4
22
MSB garage door
224
480
512
162
12
22
carpeted room view west 
126
458
512
386
9
22
carpeted room south wall
155
458
512
529
6
22
north garage wall w/BB hoop
222
215
512
688
12
22
MSB garage view westward
168
400
512
912
10
22
carpeted room east door view
178
246
728
688
11
22
MSB garage post
400
38
974
386
16
 
wall monitor in carpeted room
90
96
920
868
7
 
ceiling fan in carpeted room
34
164
734
870
11
 
MSB rug tile 
128
72
432
902
16
22
concrete paving in garage
80
320
2
902
4
 
"cardboard" for box
32
40
384
902
16

Notes

22. These are actual photographs (slightly Photoshopped).
 

Tom Pittman
Rev. 2019 July 4