[EN] [PL]

DOSSap

DOSSap is SAP file player for DOS based on ASAP library.

Download

https://sourceforge.net/projects/dossap/files/

Screen shots

Screen 1 Screen 2 Screen 3

Source code

The source code of DOSSap comes from 2003 (with a few patches). The code is ugly and needs refactoring/rewriting.

Compile

Requirements

SAP libraries

DOSSap can be compiled with different SAP libraries.

ASAP
ASAP is default library for DOSSap.
  1. Put asap.c and asap.h (from ASAP source code) in ASAP directory
  2. Run: make
libSAP 2.0

LibSAP is an orginal SAP player engine created by Adam Bienias.

Because there is no licence file with libSAP 2.0 soure code and licence file to 1.54 version is not compatible with GNU GPL so DOSSap with libSAP can be compiled only for personal use and cannot be distibuated in binary form.

The source code of libSAP 2.0 can by found with the use of Internet Archive.

  1. Put pokey0.cpp, pokey1.cpp, pokeyNamespace.h (pokeyN~1.h), sapCpu.cpp, sapEngine.cpp (sapEng~1.cpp), sapGlobals.h (sapGlo~1.h), sapLib.h and sapPokey.cpp in SAPLIB directory
  2. In SAPLIB directory run: patch.bat
  3. Run: make LIB=saplib
ASAP and libSAP

  1. Make steps from ASAP and libSAP sections
  2. Run: make LIB=both

User interface

DOSSap can be compiled with English or Polish user interface.

To compile DOSSap with Polish user interface run make with LANG=pl parameter.

Usage

ds [options] [file.sap]

options

-8, --8bit
Force 8 bit mode
-a, --adr=
Force address for SB
-i, --irq=
Force IRQ for SB
-d, --dma=
Force DMA for SB
-dh, --dmah=
Force HDMA for SB
--help
Display help

Keyboard shortcuts

esc, q
Exit
f
File selector
>
Next song
<
Previous song
s
Stop
space, p
Pause
+
Increase volume
-
Decrease volume
e
Next effect
b
Effect off
l
Change language
h
Help
c
Change SAP library [for dual library compilation]

Links