Click above to get retro games delivered to your door ever month!

  CAPTURE

  .  Summary

  capture(str <filename>);

  .  Description

  The capture function is used to open, close, pause, and unpause the
  Telix capture file. Depending on what the string variable <filename>
  contains, different actions will take place.

  If <filename> contains a valid filename (which can include a path),
  Telix opens and starts capturing data to that file.

  If <filename> is "*CLOSE*", and the capture file is currently open,
  it is closed.

  If <filename> is "*PAUSE*", and the capture file is currently open,
  it is paused.

  if <filename> is "*UNPAUSE*", and the capture file is currently open
  and paused, it is unpaused.

  If <filename> is an empty string (""), Telix takes the same action
  as if the user had pressed Alt-L while in terminal mode (which will
  depend on whether the capture file is currently open or closed).

  .  Return Value

  A value of -1 is returned if there is a problem performing the indi-
  cated function, otherwise a non-zero (TRUE) value is returned.

  .  Example

  if (capture("TELIX.CAP") == -1)
   prints("Error opening capture file!");