Help.tbl

From FreeSpace Wiki
Revision as of 15:58, 30 July 2007 by Wanderer (talk | contribs) (added version info)
Jump to: navigation, search

Revision information..

3.6.x branch: 2.11.2.1
3.7 branch: 2.13


Help table is a file meant for defining the help texts that can be prompted for example in the mainhall and other such screens by pressing F1.

Format

  • Table consists of several sections that are each defining their respective screens ingame. Every section starts with the name of the screen preceded with $ (Example: $ship) and ends with $end
    • Sections:
      • $ship
      • $weapon
      • $briefing
      • $main
      • $barracks
      • $control
      • $debrief
      • $multicreate
      • $multistart
      • $multijoin
      • $main2
      • $hotkey
      • $campaign
      • $simulator
      • $tech
      • $command


Sections

  • Sections consist of various drawing objects
  • Text, lines or brackets (left or right)


+pline

  • Draws lines on the help screen.
  • Can be used to draw several connected lines
  • Is defined with an array of values
  • First value defined the number of lines that are connected
    • 2 = straight line
    • 4 = 2 lines
    • 6 = 3 lines
  • Other values are used to define the coordinate locations on screen separately for both 640 x 480 and 1024 x 768 resolutions. Coordinates are marked as x1, y1, x2, y2, x3, y3 etc.
    • First for 640 x 480 resolution followed with another array for 1024 x 768 resolution.
    • Example: +pline 4 170 320 120 320 100 340 60 340 272 512 192 512 160 544 96 544


+left_bracket

  • Draws bracket opening to left on the help screen
  • Is defined with two pair of numerical values
  • Location is defined with four values, first x and y coordinates for 640 x 480 followed by x and y for the 1024 x 768.
    • Example: +left_bracket 257 325 358 517


+right_bracket

  • Draws bracket opening to right on the help screen
  • Is defined with two pair of numerical values
  • Location is defined with four values, first x and y coordinates for 640 x 480 followed by x and y for the 1024 x 768.
    • Example: +right_bracket 257 325 358 517


+text

  • Draws text on screen
  • Is defined with two pair of numerical values followed by a string
  • Location is defined with four values, first x and y coordinates for 640 x 480 followed by x and y for the 1024 x 768.
  • Text string is placed within brackets
    • XSTR("text", -1)
    • Example: +text 25 280 40 448 XSTR("Choose your ship type.", -1)


Sample

$ship
+text 25 280 40 448 XSTR("Choose your ship type.", -1)

+text 175 304 276 496 XSTR("Choose a new ship type by dragging", -1)
+text 175 317 276 509 XSTR("its icon over one of the available", -1)
+text 175 330 276 522 XSTR("wing slots.", -1)
+pline 4  170 320 120 320 100 340 60 340  272 512 192 512 160 544 96 544
+left_bracket 169 312 270 504
+pline 6  259 335 280 335 300 355 300 377 280 397 183 397  361 527 448 527 480 559 480 603 448 635 293 635
+right_bracket 257 325 358 517

+text 337 370 565 592 XSTR("Revert to the original", -1)
+text 337 383 565 605 XSTR("ship distribution.", -1)
+pline 2  502 374 570 374  730 596 912 596
+right_bracket 499 365 727 587

+text 400 150 636 265 XSTR("When finished outfitting", -1)
+text 400 163 636 278 XSTR("all available wings,", -1)
+text 400 176 636 291 XSTR("you can go to the", -1)
+text 400 189 636 304 XSTR("weapons loadout screen", -1)
+text 400 202 636 317 XSTR("or enter the mission.", -1)
+pline 6  162 43 330 43 350 63 350 173 370 193 395 193  259 69 528 69 560 101 560 277 592 309 632 309
+left_bracket 394 184 630 299
+pline 4  554 206 588 206 608 226 608 424  790 321 941 321 973 353 973 678
+right_bracket 552 197 788 312
$end