Up Up Home Home

BoxStar Profiles

Profiles are preset groups of options which can be referenced from user config files. They are only loaded when referenced with a <profile> tag whereas other types of configuration file are loaded just by virtue of their existence in a certain directory.

The profiles supplied are directfb, dfbmga, ntsc and pal. Their contents are shown below with links to their tag definitions in the reference.

directfb

Configures SDL to use DirectFB.

<?xml version="1.0" standalone="yes"?>
<boxstar>
  <env name="SDL_VIDEODRIVER" value="directfb" />
  <display>
    <fullscreen>1</fullscreen>
  </display>
  <sdl>
    <suspend_for_players>1</suspend_for_players>
  </sdl>
</boxstar>

dfbmga

Includes the directfb profile and sets additional options to use the TV out on a Matrox card's second head.

<?xml version="1.0" standalone="yes"?>
<boxstar>
  <profile>directfb<profile>
  <env name="SDL_DIRECTFB_MGA_CRTC2" value="1" />
  <display>
    <margins left="42" right="42">28</margins>
  </display>
  <mplayer>
      <video_opts>
          <suboption name="-vo dfbmga" sep1=":" sep2=":">fieldparity=top</suboption>
      </video_opts>
  </mplayer>
  <tvnorm>
      <auto>1</auto>
      <mplayer>
          <pal>
              <suboption name="-vo dfbmga" sep1=":" sep2=":">tvnorm=pal</suboption>
          </pal>
          <ntsc>
              <suboption name="-vo dfbmga" sep1=":" sep2=":">tvnorm=ntsc</suboption>
          </ntsc>
      </mplayer>
      <xine>
          <pal>
              <option>--dfb:matrox-tv-standard=pal:mode=720x576</option>
          </pal>
          <ntsc>
              <option>--dfb:matrox-tv-standard=ntsc:mode=720x480</option>
          </ntsc>
      </xine>
  </tvnorm>
</boxstar>

ntsc

Configures the display to use a NTSC TV.

<?xml version="1.0" standalone="yes"?>
<boxstar>
  <display>
    <width>720</width>
    <height>480</height>
    <fullscreen>1</fullscreen>
  </display>
</boxstar>

pal

Configures the display to use a PAL TV.

<?xml version="1.0" standalone="yes"?>
<boxstar>
  <display>
    <width>720</width>
    <height>576</height>
    <fullscreen>1</fullscreen>
  </display>
</boxstar>


Up Up Home Home