pax_global_header 0000666 0000000 0000000 00000000064 14174013371 0014513 g ustar 00root root 0000000 0000000 52 comment=babf8414559dc00e183789f78696bda63902c89e
schismtracker-20220125/ 0000775 0000000 0000000 00000000000 14174013371 0014614 5 ustar 00root root 0000000 0000000 schismtracker-20220125/.github/ 0000775 0000000 0000000 00000000000 14174013371 0016154 5 ustar 00root root 0000000 0000000 schismtracker-20220125/.github/workflows/ 0000775 0000000 0000000 00000000000 14174013371 0020211 5 ustar 00root root 0000000 0000000 schismtracker-20220125/.github/workflows/build.yml 0000664 0000000 0000000 00000012240 14174013371 0022032 0 ustar 00root root 0000000 0000000 name: schismtracker build
on:
push:
pull_request:
workflow_dispatch:
jobs:
build-win:
runs-on: windows-latest
strategy:
fail-fast: false
matrix:
include:
- { sys: mingw32, env: i686, win: win32 }
- { sys: mingw64, env: x86_64, win: win64 }
name: ${{ matrix.win }}
defaults:
run:
shell: msys2 {0}
env:
MINGW_ARCH: ${{ matrix.sys }}
steps:
- name: 'git config'
run: git config --global core.autocrlf input
shell: bash
- name: 'Checkout'
uses: actions/checkout@v2
with:
fetch-depth: 0
- name: 'Setup MSYS2'
uses: msys2/setup-msys2@v2
with:
msystem: ${{ matrix.sys }}
update: true
install: mingw-w64-${{ matrix.env }}-toolchain libtool autoconf automake make mingw-w64-${{ matrix.env }}-SDL zip dos2unix
- name: 'Get current date'
id: date
run: echo "::set-output name=date::$(date +%Y%m%d)"
- name: 'Build package'
run: |
autoreconf -i
mkdir build
cd build
../configure
make
strip -g schismtracker.exe
cp schismtracker.exe ..
if [ ${{ matrix.win }} == "win32" ]
then
cp /mingw32/bin/SDL.dll ..
cp /mingw32/bin/libgcc_s_dw2-1.dll ..
cp /mingw32/bin/libwinpthread-1.dll ..
else
cp /mingw64/bin/SDL.dll ..
fi
cd ..
cp docs/configuration.md .
unix2dos COPYING README.md configuration.md
- name: 'Upload artifact (win32)'
if: matrix.win == 'win32'
uses: actions/upload-artifact@v2
with:
name: schismtracker-${{ steps.date.outputs.date }}-${{ matrix.win }}
path: |
schismtracker.exe
SDL.dll
libgcc_s_dw2-1.dll
libwinpthread-1.dll
COPYING
README.md
configuration.md
- name: 'Upload artifact (win64)'
if: matrix.win == 'win64'
uses: actions/upload-artifact@v2
with:
name: schismtracker-${{ steps.date.outputs.date }}-${{ matrix.win }}
path: |
schismtracker.exe
SDL.dll
COPYING
README.md
configuration.md
build-macos:
runs-on: macos-latest
env:
MACOSX_DEPLOYMENT_TARGET: 10.9
steps:
- name: 'Get current date'
id: date
run: echo "::set-output name=date::$(date +%Y%m%d)"
- name: 'Cache SDK'
uses: actions/cache@v2
id: cache
with:
path: '/Library/Developer/CommandLineTools/SDKs/MacOSX10.9.sdk/'
key: 10.9-SDK-Folder
- name: 'Install dependencies'
run: |
brew install automake sdl zip
if [ ! -f "/Library/Developer/CommandLineTools/SDKs/MacOSX10.9.sdk/" ]; then
wget -nc "https://github.com/phracker/MacOSX-SDKs/releases/download/11.3/MacOSX10.9.sdk.tar.xz"
sudo tar -xJf MacOSX10.9.sdk.tar.xz -C /Library/Developer/CommandLineTools/SDKs/
fi
- name: 'Checkout'
uses: actions/checkout@v2
- name: 'Build package'
run: |
autoreconf -i
mkdir -p build
cd build
../configure
make CFLAGS="-isysroot /Library/Developer/CommandLineTools/SDKs/MacOSX10.9.sdk"
cd ../sys/macosx/Schism_Tracker.app/Contents/
sed -i .bak "s;CFBundle.*Version.*;$(date +%Y%m%d);" Info.plist
rm Info.plist.bak
mkdir MacOS
cd MacOS
cp ../../../../../build/schismtracker .
cp ../../../../../libs/libSDL-1.2.0.dylib .
install_name_tool -change /usr/local/opt/sdl/lib/libSDL-1.2.0.dylib @executable_path/libSDL-1.2.0.dylib schismtracker
cd ../../../../..
cp -r sys/macosx/Schism_Tracker.app Schism\ Tracker.app
cp docs/configuration.md .
zip -r schismtracker.zip configuration.md COPYING README.md Schism\ Tracker.app
- name: 'Upload artifact'
uses: actions/upload-artifact@v2
with:
name: schismtracker-${{ steps.date.outputs.date }}-macos
path: schismtracker.zip
build-linux:
runs-on: ubuntu-latest
steps:
- name: 'Install dependencies'
run: |
sudo apt-get update
sudo apt-get install --fix-missing build-essential automake autoconf autoconf-archive libx11-dev libxext-dev libxv-dev libxxf86vm-dev libsdl1.2-dev libasound2-dev git libtool zip
- name: 'Checkout'
uses: actions/checkout@v2
- name: 'Get current date'
id: date
run: echo "::set-output name=date::$(date +%Y%m%d)"
- name: 'Build package'
run: |
autoreconf -i
mkdir -p build
cd build
../configure
make
cd ..
cp build/schismtracker .
cp docs/configuration.md .
cp sys/posix/schismtracker.1 .
zip schismtracker.zip configuration.md COPYING README.md schismtracker.1 schismtracker
- name: 'Upload artifact'
uses: actions/upload-artifact@v2
with:
name: schismtracker-${{ steps.date.outputs.date }}-linux
path: schismtracker.zip
schismtracker-20220125/.gitignore 0000664 0000000 0000000 00000000420 14174013371 0016600 0 ustar 00root root 0000000 0000000 *.swp
*.o
.deps/
.dirstamp
.vs/
/Makefile
/Makefile.in
/aclocal.m4
/auto/
/autom4te.cache/
/build/
/buildx86/
/buildx64/
/compile
/config.guess
/config.h
/config.h.in
/config.log
/config.status
/config.sub
/configure
/depcomp
/install-sh
/missing
/schismtracker
/stamp-h1
schismtracker-20220125/AUTHORS 0000664 0000000 0000000 00000005506 14174013371 0015672 0 ustar 00root root 0000000 0000000 Written by Storlek .
Large swaths of code by Mrs. Brisby .
Based (obviously) on Impulse Tracker by Jeffrey Lim .
Default fonts created with ITF by ZaStaR .
Default palette settings are mostly from Impulse Tracker.
- "Atlantic" is from an ooooold version of IT.
- "Purple Motion" was roughly copied from an Imago Orpheus palette.
- "Why Colors?" is loosely based on the like-named FT2 palette.
- "Industrial" was created by Storlek.
- "Kawaii" was co-designed by Storlek and mml.
- "FX 2.0" was supplied by Virt.
Tim Douglas maintained the original Mac OS X
packages, and supplied patches fixing a handful of endianness issues.
The Schism Tracker logo was designed by delt.
The player engine was originally based on Modplug, which was written by
Olivier Lapicque , with additional programming by Markus
Fick (spline mixing, fir-resampler) and Adam Goode
(endian-ness and char fixes).
Further changes to the player code were back-ported from the OpenMPT project
.
Ben de Graaff rewrote a large portion of libmodplug in C.
Some file-loading mechanisms, in particular large portions of the IMF loader,
as well as many of the tracker-identifying heuristics, have been adapted from
xmp by Claudio Matsuoka and Hipolito Carraro Jr .
Tremor logic, and possibly some other effect handling, stolen from DUMB by Ben
Davis, Robert J Ohannessian and Julien Cugniere .
IMF note slide effect processing taken from Imago Orpheus by Lutz Röder
(and then rewritten in C).
Other portions of file loading and playing code has been liberally adapted
from Mikmod by Raphael Assenat and Miodrag Vallat.
Joel Yliluoma (Bisqwit) implemented Adlib support and Scream Tracker sample
loading, and also contributed some MIDI-related code.
fmopl (OPL2-emulator used in Dosbox and MAME) was written by Jarek Burczynski.
Predefined Adlib MIDI patches taken from dro2midi, originally extracted from
Creative Labs' MIDI player (PLAY.EXE).
Some (small) portions of code have been borrowed from Cheesetracker, written
by Juan Linietsky .
Various Amiga OS fixes by Juha Niemimäki .
Win32 Mixer by Gargaj/CNS .
Michael Chen improved the software scaler quite a bit.
Some little fixes by ToastyX .
Wii ISFS filesystem support code from ftpii by Joseph Jordan
.
Wii Homebrew Browser icon by pbsds.
Path manipulation code taken from bash.
See https://github.com/schismtracker/schismtracker/graphs/contributors for a
list of additional contributors.
schismtracker-20220125/COPYING 0000664 0000000 0000000 00000043110 14174013371 0015646 0 ustar 00root root 0000000 0000000 GNU GENERAL PUBLIC LICENSE
Version 2, June 1991
Copyright (C) 1989, 1991 Free Software Foundation, Inc.
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
Preamble
The licenses for most software are designed to take away your
freedom to share and change it. By contrast, the GNU General Public
License is intended to guarantee your freedom to share and change free
software--to make sure the software is free for all its users. This
General Public License applies to most of the Free Software
Foundation's software and to any other program whose authors commit to
using it. (Some other Free Software Foundation software is covered by
the GNU Library General Public License instead.) You can apply it to
your programs, too.
When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
this service if you wish), that you receive source code or can get it
if you want it, that you can change the software or use pieces of it
in new free programs; and that you know you can do these things.
To protect your rights, we need to make restrictions that forbid
anyone to deny you these rights or to ask you to surrender the rights.
These restrictions translate to certain responsibilities for you if you
distribute copies of the software, or if you modify it.
For example, if you distribute copies of such a program, whether
gratis or for a fee, you must give the recipients all the rights that
you have. You must make sure that they, too, receive or can get the
source code. And you must show them these terms so they know their
rights.
We protect your rights with two steps: (1) copyright the software, and
(2) offer you this license which gives you legal permission to copy,
distribute and/or modify the software.
Also, for each author's protection and ours, we want to make certain
that everyone understands that there is no warranty for this free
software. If the software is modified by someone else and passed on, we
want its recipients to know that what they have is not the original, so
that any problems introduced by others will not reflect on the original
authors' reputations.
Finally, any free program is threatened constantly by software
patents. We wish to avoid the danger that redistributors of a free
program will individually obtain patent licenses, in effect making the
program proprietary. To prevent this, we have made it clear that any
patent must be licensed for everyone's free use or not licensed at all.
The precise terms and conditions for copying, distribution and
modification follow.
GNU GENERAL PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. This License applies to any program or other work which contains
a notice placed by the copyright holder saying it may be distributed
under the terms of this General Public License. The "Program", below,
refers to any such program or work, and a "work based on the Program"
means either the Program or any derivative work under copyright law:
that is to say, a work containing the Program or a portion of it,
either verbatim or with modifications and/or translated into another
language. (Hereinafter, translation is included without limitation in
the term "modification".) Each licensee is addressed as "you".
Activities other than copying, distribution and modification are not
covered by this License; they are outside its scope. The act of
running the Program is not restricted, and the output from the Program
is covered only if its contents constitute a work based on the
Program (independent of having been made by running the Program).
Whether that is true depends on what the Program does.
1. You may copy and distribute verbatim copies of the Program's
source code as you receive it, in any medium, provided that you
conspicuously and appropriately publish on each copy an appropriate
copyright notice and disclaimer of warranty; keep intact all the
notices that refer to this License and to the absence of any warranty;
and give any other recipients of the Program a copy of this License
along with the Program.
You may charge a fee for the physical act of transferring a copy, and
you may at your option offer warranty protection in exchange for a fee.
2. You may modify your copy or copies of the Program or any portion
of it, thus forming a work based on the Program, and copy and
distribute such modifications or work under the terms of Section 1
above, provided that you also meet all of these conditions:
a) You must cause the modified files to carry prominent notices
stating that you changed the files and the date of any change.
b) You must cause any work that you distribute or publish, that in
whole or in part contains or is derived from the Program or any
part thereof, to be licensed as a whole at no charge to all third
parties under the terms of this License.
c) If the modified program normally reads commands interactively
when run, you must cause it, when started running for such
interactive use in the most ordinary way, to print or display an
announcement including an appropriate copyright notice and a
notice that there is no warranty (or else, saying that you provide
a warranty) and that users may redistribute the program under
these conditions, and telling the user how to view a copy of this
License. (Exception: if the Program itself is interactive but
does not normally print such an announcement, your work based on
the Program is not required to print an announcement.)
These requirements apply to the modified work as a whole. If
identifiable sections of that work are not derived from the Program,
and can be reasonably considered independent and separate works in
themselves, then this License, and its terms, do not apply to those
sections when you distribute them as separate works. But when you
distribute the same sections as part of a whole which is a work based
on the Program, the distribution of the whole must be on the terms of
this License, whose permissions for other licensees extend to the
entire whole, and thus to each and every part regardless of who wrote it.
Thus, it is not the intent of this section to claim rights or contest
your rights to work written entirely by you; rather, the intent is to
exercise the right to control the distribution of derivative or
collective works based on the Program.
In addition, mere aggregation of another work not based on the Program
with the Program (or with a work based on the Program) on a volume of
a storage or distribution medium does not bring the other work under
the scope of this License.
3. You may copy and distribute the Program (or a work based on it,
under Section 2) in object code or executable form under the terms of
Sections 1 and 2 above provided that you also do one of the following:
a) Accompany it with the complete corresponding machine-readable
source code, which must be distributed under the terms of Sections
1 and 2 above on a medium customarily used for software interchange; or,
b) Accompany it with a written offer, valid for at least three
years, to give any third party, for a charge no more than your
cost of physically performing source distribution, a complete
machine-readable copy of the corresponding source code, to be
distributed under the terms of Sections 1 and 2 above on a medium
customarily used for software interchange; or,
c) Accompany it with the information you received as to the offer
to distribute corresponding source code. (This alternative is
allowed only for noncommercial distribution and only if you
received the program in object code or executable form with such
an offer, in accord with Subsection b above.)
The source code for a work means the preferred form of the work for
making modifications to it. For an executable work, complete source
code means all the source code for all modules it contains, plus any
associated interface definition files, plus the scripts used to
control compilation and installation of the executable. However, as a
special exception, the source code distributed need not include
anything that is normally distributed (in either source or binary
form) with the major components (compiler, kernel, and so on) of the
operating system on which the executable runs, unless that component
itself accompanies the executable.
If distribution of executable or object code is made by offering
access to copy from a designated place, then offering equivalent
access to copy the source code from the same place counts as
distribution of the source code, even though third parties are not
compelled to copy the source along with the object code.
4. You may not copy, modify, sublicense, or distribute the Program
except as expressly provided under this License. Any attempt
otherwise to copy, modify, sublicense or distribute the Program is
void, and will automatically terminate your rights under this License.
However, parties who have received copies, or rights, from you under
this License will not have their licenses terminated so long as such
parties remain in full compliance.
5. You are not required to accept this License, since you have not
signed it. However, nothing else grants you permission to modify or
distribute the Program or its derivative works. These actions are
prohibited by law if you do not accept this License. Therefore, by
modifying or distributing the Program (or any work based on the
Program), you indicate your acceptance of this License to do so, and
all its terms and conditions for copying, distributing or modifying
the Program or works based on it.
6. Each time you redistribute the Program (or any work based on the
Program), the recipient automatically receives a license from the
original licensor to copy, distribute or modify the Program subject to
these terms and conditions. You may not impose any further
restrictions on the recipients' exercise of the rights granted herein.
You are not responsible for enforcing compliance by third parties to
this License.
7. If, as a consequence of a court judgment or allegation of patent
infringement or for any other reason (not limited to patent issues),
conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License. If you cannot
distribute so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you
may not distribute the Program at all. For example, if a patent
license would not permit royalty-free redistribution of the Program by
all those who receive copies directly or indirectly through you, then
the only way you could satisfy both it and this License would be to
refrain entirely from distribution of the Program.
If any portion of this section is held invalid or unenforceable under
any particular circumstance, the balance of the section is intended to
apply and the section as a whole is intended to apply in other
circumstances.
It is not the purpose of this section to induce you to infringe any
patents or other property right claims or to contest validity of any
such claims; this section has the sole purpose of protecting the
integrity of the free software distribution system, which is
implemented by public license practices. Many people have made
generous contributions to the wide range of software distributed
through that system in reliance on consistent application of that
system; it is up to the author/donor to decide if he or she is willing
to distribute software through any other system and a licensee cannot
impose that choice.
This section is intended to make thoroughly clear what is believed to
be a consequence of the rest of this License.
8. If the distribution and/or use of the Program is restricted in
certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Program under this License
may add an explicit geographical distribution limitation excluding
those countries, so that distribution is permitted only in or among
countries not thus excluded. In such case, this License incorporates
the limitation as if written in the body of this License.
9. The Free Software Foundation may publish revised and/or new versions
of the General Public License from time to time. Such new versions will
be similar in spirit to the present version, but may differ in detail to
address new problems or concerns.
Each version is given a distinguishing version number. If the Program
specifies a version number of this License which applies to it and "any
later version", you have the option of following the terms and conditions
either of that version or of any later version published by the Free
Software Foundation. If the Program does not specify a version number of
this License, you may choose any version ever published by the Free Software
Foundation.
10. If you wish to incorporate parts of the Program into other free
programs whose distribution conditions are different, write to the author
to ask for permission. For software which is copyrighted by the Free
Software Foundation, write to the Free Software Foundation; we sometimes
make exceptions for this. Our decision will be guided by the two goals
of preserving the free status of all derivatives of our free software and
of promoting the sharing and reuse of software generally.
NO WARRANTY
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
REPAIR OR CORRECTION.
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
END OF TERMS AND CONDITIONS
How to Apply These Terms to Your New Programs
If you develop a new program, and you want it to be of the greatest
possible use to the public, the best way to achieve this is to make it
free software which everyone can redistribute and change under these terms.
To do so, attach the following notices to the program. It is safest
to attach them to the start of each source file to most effectively
convey the exclusion of warranty; and each file should have at least
the "copyright" line and a pointer to where the full notice is found.
Copyright (C)
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Also add information on how to contact you by electronic and paper mail.
If the program is interactive, make it output a short notice like this
when it starts in an interactive mode:
Gnomovision version 69, Copyright (C) year name of author
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
The hypothetical commands `show w' and `show c' should show the appropriate
parts of the General Public License. Of course, the commands you use may
be called something other than `show w' and `show c'; they could even be
mouse-clicks or menu items--whatever suits your program.
You should also get your employer (if you work as a programmer) or your
school, if any, to sign a "copyright disclaimer" for the program, if
necessary. Here is a sample; alter the names:
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
`Gnomovision' (which makes passes at compilers) written by James Hacker.
, 1 April 1989
Ty Coon, President of Vice
This General Public License does not permit incorporating your program into
proprietary programs. If your program is a subroutine library, you may
consider it more useful to permit linking proprietary applications with the
library. If this is what you want to do, use the GNU Library General
Public License instead of this License.
schismtracker-20220125/INSTALL 0000664 0000000 0000000 00000001245 14174013371 0015647 0 ustar 00root root 0000000 0000000 This is a fairly typical autotools package. In a nutshell, if you're using
a roughly Unix-ish environment:
0.) autoreconf -i
You only need this if you've fetched this package from the repo
and lack ./configure in the top-level source directory.
1.) ./configure
Want plenty more options than you need? ./configure --help
2.) make
This should create a ./schismtracker binary, which you can
move around to wherever it makes you happiest.
3.) make install
If you want it installed! You likely want sudo for this.
4.) happy tracking!
For more detailed instructions, peruse the files in the 'docs' directory.
schismtracker-20220125/Makefile.am 0000664 0000000 0000000 00000021335 14174013371 0016654 0 ustar 00root root 0000000 0000000 ## vi:set bd=syn\ make: for elvis
AUTOMAKE_OPTIONS = foreign dist-bzip2 no-dist-gzip
## NOTE: helptexts should be in the same order as the enum in page.h
helptexts = \
helptext/global-keys \
helptext/copyright \
helptext/info-page \
helptext/instrument-list \
helptext/message-editor \
helptext/midi-output \
helptext/orderlist-pan \
helptext/orderlist-vol \
helptext/pattern-editor \
helptext/adlib-sample \
helptext/sample-list
fonts = \
font/default-lower.fnt \
font/default-upper-alt.fnt \
font/default-upper-itf.fnt \
font/half-width.fnt
icons = \
icons/appIcon.icns \
icons/moduleIcon.icns \
icons/schism-file-128.png \
icons/schism-icon-128.png \
icons/schism-icon-16.png \
icons/schism-icon-192.png \
icons/schism-icon-22.png \
icons/schism-icon-24.png \
icons/schism-icon-32.png \
icons/schism-icon-36.png \
icons/schism-icon-48.png \
icons/schism-icon-64.png \
icons/schism-icon-72.png \
icons/schism-icon-96.png \
icons/schism-icon.svg \
icons/schism-itf-icon-128.png \
icons/schism-itf-icon-16.png \
icons/schism-itf-icon-192.png \
icons/schism-itf-icon-22.png \
icons/schism-itf-icon-24.png \
icons/schism-itf-icon-32.png \
icons/schism-itf-icon-36.png \
icons/schism-itf-icon-48.png \
icons/schism-itf-icon-64.png \
icons/schism-itf-icon-72.png \
icons/schism-itf-icon-96.png \
icons/schism-itf-icon.svg \
icons/it_logo.png \
icons/schism_logo.png \
icons/schismres.ico
sysfiles = \
sys/fd.org/autopackage.apspec \
sys/fd.org/itf.desktop \
sys/fd.org/schism.desktop \
sys/macosx/Schism_Tracker.app/Contents/Info.plist \
sys/macosx/Schism_Tracker.app/Contents/PkgInfo \
sys/macosx/Schism_Tracker.app/Contents/Resources/AppSettings.plist \
sys/macosx/Schism_Tracker.app/Contents/Resources/appIcon.icns \
sys/macosx/Schism_Tracker.app/Contents/Resources/moduleIcon.icns \
sys/win32/schism.nsis \
sys/wii/schismtracker/icon.png \
sys/wii/schismtracker/meta.xml \
sys/sdl/README
scripts = \
scripts/bin2h.sh \
scripts/build-font.sh \
scripts/genhelp.py \
scripts/itf2half.py \
scripts/half2itf.py \
scripts/itcfg.py \
scripts/itmidicfg.py \
scripts/lutgen.c \
scripts/palette.py
EXTRA_DIST = \
include/auto/README \
$(helptexts) \
$(fonts) \
$(icons) \
$(sysfiles) \
$(scripts)
bin_PROGRAMS = schismtracker
noinst_HEADERS = \
include/auto/logoit.h \
include/auto/logoschism.h \
include/auto/schismico.h \
include/charset.h \
include/clippy.h \
include/cmixer.h \
include/config-parser.h \
include/disko.h \
include/dmoz.h \
include/draw-char.h \
include/event.h \
include/fmopl2.h \
include/fmopl3.h \
include/fmt.h \
include/fmt-types.h \
include/headers.h \
include/it_defs.h \
include/it.h \
include/log.h \
include/midi.h \
include/osdefs.h \
include/page.h \
include/pattern-view.h \
include/precomp_lut.h \
include/sample-edit.h \
include/sdlmain.h \
include/slurp.h \
include/sndfile.h \
include/snd_fm.h \
include/snd_gm.h \
include/song.h \
include/tables.h \
include/tree.h \
include/util.h \
include/version.h \
include/vgamem-scanner.h \
include/video.h \
sys/wii/isfs.h \
sys/wii/certs_bin.h \
sys/wii/su_tik_bin.h \
sys/wii/su_tmd_bin.h \
sys/win32/wine-ddraw.h
dist_man_MANS = sys/posix/schismtracker.1
desktopdir = $(datadir)/applications
desktop_DATA = sys/fd.org/schism.desktop
appicondir = $(datadir)/pixmaps
appicon_DATA= icons/schism-icon-128.png
noinst_SCRIPTS = $(scripts)
nodist_schismtracker_SOURCES = \
auto/default-font.c \
auto/helptext.c
CLEANFILES = \
auto/default-font.c \
auto/helptext.c
auto/default-font.c: Makefile.am scripts/bin2h.sh scripts/build-font.sh $(fonts)
sh $(srcdir)/scripts/build-font.sh $(srcdir) $(fonts) >$@
auto/helptext.c: Makefile.am scripts/genhelp.py $(helptexts)
$(PYTHON) $(srcdir)/scripts/genhelp.py $(srcdir) $(helptexts) >$@
if USE_X11
files_x11 = sys/x11/xscreensaver.c sys/x11/xkb.c
cflags_x11 = -DUSE_X11
if USE_XV
files_x11 += sys/x11/xv.c
cflags_x11 += -DUSE_XV
endif
endif
if USE_ALSA
files_alsa = sys/alsa/init.c sys/alsa/volume-alsa.c sys/alsa/midi-alsa.c
if USE_ALSA_DLTRICK
cflags_alsa=-DUSE_ALSA -DUSE_DLTRICK_ALSA
else
cflags_alsa=-DUSE_ALSA
lib_asound=-lasound
endif
endif
if USE_OSS
files_oss = sys/oss/volume-oss.c sys/oss/midi-oss.c
cflags_oss=-DUSE_OSS
endif
if USE_MMAP
files_mmap = sys/posix/slurp-mmap.c
endif
if USE_WIN32
files_win32 = \
sys/win32/osdefs.c \
sys/win32/slurp-win32.c \
sys/win32/volume-win32mm.c \
sys/win32/midi-win32mm.c \
sys/win32/filetype.c \
sys/win32/localtime_r.c
cflags_win32=-I$(srcdir)/sys/win32
lib_win32=-lwinmm
endif
if HAVE_WINDRES
## use today's date if we didn't get a commit date from git
if HAVE_GIT
wrcflags_version = -DWRC_VERSION=0,`echo '$(PACKAGE_VERSION)' | sed 's/\(....\)\(..\)\(..\).*/\1,\2,\3/'`
else
wrcflags_version = -DWRC_VERSION=0,`date +%Y%m%d | sed 's/\(....\)\(..\)\(..\).*/\1,\2,\3/'`
endif
## --use-temp-file is needed to work around stupid bugs
WRCFLAGS = --use-temp-file -I. -I$(srcdir) $(cflags_version) $(wrcflags_version)
.rc.$(OBJEXT):
$(WINDRES) $(WRCFLAGS) -i $< -o $@
files_windres=sys/win32/schismres.rc
sys/win32/schismres.$(OBJEXT): icons/schismres.ico config.h Makefile.am
endif HAVE_WINDRES
if USE_WII
files_wii=sys/wii/isfs.c sys/wii/osdefs.c
cflags_wii=-I$(srcdir)/sys/wii
endif
if USE_MACOSX
files_macosx = \
sys/macosx/macosx-sdlmain.m \
sys/macosx/ibook-support.c \
sys/macosx/midi-macosx.c \
sys/macosx/volume-macosx.c \
sys/macosx/osdefs.c
cflags_macosx=-mmacosx-version-min=10.9
endif
if USE_NETWORK
cflags_network=-DUSE_NETWORK
endif
## Replacement functions for crappy systems
files_stdlib =
if NEED_ASPRINTF
files_stdlib += sys/stdlib/asprintf.c
endif
if NEED_VASPRINTF
files_stdlib += sys/stdlib/vasprintf.c
endif
if NEED_MEMCMP
files_stdlib += sys/stdlib/memcmp.c
endif
if NEED_STRPTIME
files_stdlib += sys/stdlib/strptime.c
endif
if NEED_MKSTEMP
files_stdlib += sys/stdlib/mkstemp.c
endif
## aaaaaaaaahhhhhhhhhhhhhhhhhhh!!!!!!!1
schismtracker_SOURCES = \
schism/page_blank.c \
schism/charset.c \
schism/sample-edit.c \
schism/dmoz.c \
schism/page_info.c \
schism/page.c \
schism/page_palette.c \
schism/page_instruments.c \
schism/page_log.c \
schism/page_about.c \
schism/pattern-view.c \
schism/xpmdata.c \
schism/menu.c \
schism/volume-core.c \
schism/disko.c \
schism/page_loadinst.c \
schism/mplink.c \
schism/clippy.c \
schism/page_loadmodule.c \
schism/page_vars.c \
schism/palettes.c \
fmt/compression.c \
fmt/generic.c \
fmt/mmcmp.c \
fmt/669.c \
fmt/aiff.c \
fmt/ams.c \
fmt/au.c \
fmt/f2r.c \
fmt/far.c \
fmt/imf.c \
fmt/it.c \
fmt/iti.c \
fmt/its.c \
fmt/liq.c \
fmt/mdl.c \
fmt/med.c \
fmt/mf.c \
fmt/mid.c \
fmt/mod.c \
fmt/mt2.c \
fmt/mtm.c \
fmt/mus.c \
fmt/ntk.c \
fmt/okt.c \
fmt/pat.c \
fmt/raw.c \
fmt/s3i.c \
fmt/s3m.c \
fmt/sfx.c \
fmt/stm.c \
fmt/ult.c \
fmt/wav.c \
fmt/xi.c \
fmt/xm.c \
schism/util.c \
schism/page_midi.c \
schism/draw-char.c \
schism/page_help.c \
schism/slurp.c \
schism/widget-keyhandler.c \
schism/main.c \
schism/page_midiout.c \
schism/page_message.c \
schism/page_loadsample.c \
schism/dialog.c \
schism/page_preferences.c \
schism/widget.c \
schism/config.c \
schism/status.c \
schism/video.c \
schism/sample-view.c \
schism/page_patedit.c \
schism/page_config.c \
schism/keyboard.c \
schism/page_samples.c \
schism/itf.c \
schism/page_orderpan.c \
schism/page_waterfall.c \
schism/midi-core.c \
schism/midi-ip.c \
schism/audio_playback.c \
schism/config-parser.c \
schism/audio_loadsave.c \
schism/draw-misc.c \
schism/fakemem.c \
schism/version.c \
player/csndfile.c \
player/mixutil.c \
player/equalizer.c \
player/mixer.c \
player/filters.c \
player/fmopl2.c \
player/fmopl3.c \
player/fmpatches.c \
player/sndmix.c \
player/opl-util.c \
player/snd_fm.c \
player/effects.c \
player/snd_gm.c \
player/tables.c \
$(files_macosx) \
$(files_alsa) \
$(files_oss) \
$(files_win32) \
$(files_x11) \
$(files_stdlib) \
$(files_mmap) \
$(files_wii) \
$(files_windres)
# have version.o rely on all files
schism/version.$(OBJEXT): $(filter-out schism/version.$(OBJEXT),$(schismtracker_OBJECTS)) $(HEADERS)
cflags_fmopl=-DHAS_YM3812=1 -DHAS_Y8950=0 -DHAS_YM3526=0
AM_CPPFLAGS = -D_USE_AUTOCONF -D_GNU_SOURCE -I$(srcdir)/include -I.
AM_CFLAGS = $(SDL_CFLAGS) $(cflags_alsa) $(cflags_oss) \
$(cflags_network) $(cflags_x11) $(cflags_fmopl) \
$(cflags_version) $(cflags_win32) $(cflags_wii) \
$(cflags_macosx)
AM_OBJCFLAGS = $(AM_CFLAGS)
schismtracker_DEPENDENCIES = $(files_windres)
schismtracker_LDADD = $(lib_asound) $(lib_win32) $(SDL_LIBS) $(LIBM)
schismtracker-20220125/NEWS 0000664 0000000 0000000 00000033262 14174013371 0015321 0 ustar 00root root 0000000 0000000 20120105
- Happy New Year again! Not much new. (Perhaps that'll change soon?)
Miscellaneous:
- Added "invert_home_end" option on the pattern editor to make the keys act
more like FT2. There is no UI switch for this option.
- Fixed a couple quirky segfaults, most of which were unlikely to happen
unless you were looking for them.
- Fixed a bug that cropped up that broke the mouse in dialogs.
- Small fixes to the IMF and S3M loaders.
- Removing the last envelope node adjusts the loop points (as it should!)
- A dialog now warns you if you are about to export an empty file (i.e.,
nothing in the orderlist)
- Added a separate glob pattern, listing only WAV and AIFF files by default
- Export shows file size and duration when it finishes
==============================================================================
20110101
- Happy New Year! This is mostly for Windows users, as there was a huge
file-corruption problem which I hadn't noticed, plus a couple other small
changes. Aside from that, nothing major since last month.
Windows-related:
- Fixed a MASSIVE problem with file saving code that destroyed any files it
wrote! (because of the stupid distinction between binary and text files,
argh!!)
- Fixed another tangentially related bug which stuffed increasing numbers of
newlines in the config file when saving. As a side effect the config file
will appear trashed in Notepad; just use something more competent (such as
Wordpad) and it'll be fine.
- Default directory if you haven't saved your config is now "My Documents"
rather than "Application Data". The config file / fonts / etc. are still
in the same place.
- Packages are now bundled with a different sdl.dll, which should fix some
strange bugs, such as producing "ding" noises when alt-keys are pressed
Miscellaneous:
- The --diskwrite flag wasn't mentioned anywhere in the manpage. Now it is!
- Fixed "stacking up" on Ctrl-F2 dialog with multiple keypresses
==============================================================================
20101128
- Forgot the manpage with the previous build. Whoops!
==============================================================================
20101127
- Another massive update with lots of big changes!
As it turns out, the 20100202 build was sort of broken, and I was well
into tearing apart various huge chunks of code by the time the first bug
reports surfaced that indicated that something wasn't right. So, I just
reverted the download links to point back to the 20100101 build with the
expectation that I'd be able to pull everything together fairly soon...
but then Stuff Happened and then Schism Tracker sort of got shoved to the
back burner for a while, and now it's almost December. Oops.
- As you might have noticed, the website is changing significantly. Pardon
the dust, and please do report any troubles. :)
Miscellaneous:
- MAJOR structural changes to the code: all C++ removed, many variables and
functions renamed, and directory layout rearranged. Apologies to anyone
maintaining separate patch sets! :)
- Manpage added for 'nix systems (mostly for Debian's sake)
- Command line option parsing overhauled; the old +f and +p options have
been replaced with -F and -P respectively.
- New command-line batch rendering mode:
schismtracker file.it --diskwrite file.wav
This works with both the .wav and .aiff writers (based on file extension)
and will also render multichannel if %c is in the output filename.
- Song length calculation improved somewhat
- Sharp/flat display setting is now honored in preferences (previously, it
was only "half applied" which led to the option potentially displaying
the opposite of the actual setting at startup)
File loading:
- Due to the restructuring, a handful of obscure file formats are no longer
supported. If you're missing support for a format, post several test files
on /scdev/ and I'll write a new loader. (From what I can tell, most of the
remaining loaders that I hadn't rewritten were fairly broken anyway)
- Stereo sample flag ignored when loading old IT files (it was meaningless)
- Fixed dumb bug in the AIFF/8SVX sample loader that caused a crash when
reading a truncated or corrupted file
- MOD 8xx effect import fixed, it was screwing up the values in some
inexplicable way. (thanks Saga Musix)
- Slight hack added to S3M loader to discard SC0 and SD0 effects
- Subtle old-effects tremolo quirk implemented (you won't notice)
- MPT detect is slightly more lenient
- Raw sample loader truncates large samples, instead of loading nothing
- Fixed potential crash bug in the IT sample decompression code when loading
truncated or otherwise corrupt files
- Fixed a potential crash bug in the MTM loader
- Several improvements to XI loading, and instrument loading in general
- XM instruments with undefined loop type 3 are treated as ping-pong (fixes
some apparently malformed files which play properly in FT2)
- Fixed a subtle bug when importing pitch slide effects into the volume
column. This mostly affected XM files with both volume and effect column
data.
- "Embed MIDI data" switch is now always enabled / disabled as appropriate
when loading a song, and MIDI output settings are no longer reset when a
file does not provide its own settings.
- MIDI output settings are blanked when loading old IT files, to prevent
stray Zxx effects from interfering with playback, thus making unnecessary
the former destructive workaround of deleting the effects themselves.
File saving / rendering:
- All low-level file output code rewritten (both file save and export)
- New S3M writer which actually assigns Adlib channels correctly and shows
warnings for unsupported features (like it always SHOULD have done).
- XM/MOD save support removed, sorry. If you want them, get Milky Tracker.
(Or alternately, describe to me why an IT clone should provide support
for those formats, and why they would be of benefit...)
- File saving doesn't fail if the file already existed (was broken on Wii,
and maybe also Windows)
- Overwriting an existing file will *attempt* to preserve permissions
- File output disallows overwriting a file without write permission
- Complete overhaul to multi-channel export: select MWAV or MAIFF format to
split by channel (entering a directory name won't work anymore)
- Completely blank channels are no longer saved when diskwriting per channel
- Multi-channel export replaces %c in the filename with the channel number
- Pattern-to-sample doesn't stop playback (note: this royally confuses
Adlib instruments, so don't try it :)
- Ctrl-Shift-O key added to write each channel to a separate sample
- Ctrl-O, Ctrl-Shift-O, and Ctrl-B added to pattern editor
- All (?) changes should now mark the file as modified
- Edit history (timestamp data) is now saved along with IT files. This was
written by Impulse Tracker, and is also supported by recent versions of
OpenMPT. Although it isn't yet viewable from within the tracker, there is
a script in the repository to output this data.
Player:
- SAy effect was incorrectly applying offset to new notes
- Channel panning should "stay put" after panbrello effects
- Channel volume (Mxx/Nxx) fixed to NOT affect background notes (!)
- Sample vibrato code rewritten for better accuracy
- Vibrato waveform resets on new notes
- Oxx with out-of-range offsets and Old Effects off fixed to play like
Impulse Tracker (ignore effect and play from the start of the sample)
- Various strange bugs related to Gxx and multisampled instruments fixed
- Incoming MIDI start/continue messages (FA and FC) are now handled
User interface:
- A "+" indicator is displayed next to the filename when the song has
unsaved changes
- Status line now shows how many times a song has looped
- Minor changes to the menu
- Infopage technical view was showing incorrect data sometimes
- Tab key behavior made much more logical on midi input/output screens
- Shift-F1 on the midi input screen will switch to midi output
- Reverted some dialog behavior that partially broke text input in the
previous build. (Sorry!)
- In the pattern editor, the '8' key on number pad now plays the row as
expected. (This has been inexplicably broken since 2006!)
- 'D' properly sends keyjazz note-offs (most obvious on instrument list)
- Fixed bug preventing midi pitch bend from ever being input in the pattern
editor (maybe!)
- Fixed horribly broken help text, which was sometimes cutting off the text
or even crashing in various circumstances
- Caught potential crash caused by attempting to draw playback marks on
broken instrument envelopes (such as those written by MPT)
- Right click only pops up main menu when a dialog is not active
==============================================================================
20100202 (Groundhog Day)
- BIG update -- lots of stuff added this month!
File loading/saving:
- MMCMP decompression fixed for big-endian systems
- Fixed a crash bug and some problems with XM and AIFF on 64-bit
- Replaced loaders: FAR, MDL, ULT, OKT
- New loader: MUS (Doom music)
- Some fixes to XM and IMF envelope behavior; XM envelopes should now load
just like IT
- XM loader was leaking a ton of memory by allocating space for each sample
twice, whoops
- Added title scanner for MoonFish files, because why not :)
- Relative paths on the command line (e.g. schismtracker ./file.it) are
changed to absolute paths. This fixes a long-standing bug with the file
browsers getting "stuck" inside the current directory.
- Font path defined in the config file can be an absolute path residing
outside of ~/.schism/fonts now, so it's possible, for example, to share
the same font.cfg between Schism Tracker and Impulse Tracker.
- Path normalizing code rewritten, and now actually works correctly
- Module browser remembers cursor position (this got broken when filename
pattern matching was added)
- Changed the formatting for printing information when loading songs: less
"cramped", more IT-like
Pattern editor:
- More template changes to better match IT behavior
- Enter key turns template mode off (except with Notes Only templates)
- Multi-cursor only shows when shift is not being held down (for block
selections)
- Note cut/off/fade and clear now correctly wipe all masked fields in
all affected channels
- Some behavior was erroneously dependent on the specific template mode
- PgUp from the last row of a pattern will place the cursor on the previous
major highlight, even if the highlight doesn't line up with the pattern
size.
- Multichannel dialog layout and cursor alignment changed to match Impulse
Tracker
- Block swap (Alt-Y) wasn't recording the pattern state for undo.
Sample list:
- New feature: press Alt-Shift-Z on the sample list to select from 128
built-in Adlib MIDI patches!
- Host instrument dialog defaults to No when an instrument containing the
sample already exists (not QUITE the same as Impulse Tracker, but maybe
this is better?)
- When creating a host instrument, the number of the instrument used is
displayed in the status line
- Anything that "generates" a sample (Alt-P, Alt-Y, Alt-Z, Alt-Shift-Z) will
prompt for a host instrument if instrument mode is enabled.
- Sample modification keys (reverse, sign flip, amplify, etc.) are disabled
with Adlib samples.
- Quality convert fixed to show the confirmation dialog with stereo samples,
although changing quality without converting the data is unimplemented
(and probably would not be very useful, for that matter)
- Sample-loading page fixed to always show the current sample number/name at
the top of the screen (was showing the current instrument if instrument
mode was enabled)
- I was wrong: in Impulse Tracker, F8 never clears the dots that show what
samples have been played; *starting* playback does that. Fixed.
- Fixed some edge-case bugs with Alt-Ins/Del on the sample list
Player:
- Modplug's extensions to S9x removed (they were mostly broken anyway, and
no one seemed to notice)
- Fixed a player bug with the handling of S6x and SDx effects on the same
row
- Envelope carry behavior changed to reset the envelope regardless of carry
if a new note is played after a note-off
- Adlib mixing volume amplified due to request from Manwe. (Sorry this took
so long... it was *really* easy after I found the right place to do it,
haha)
- Changed internal handling of arpeggio slightly
Miscellaneous:
- Copyright text moved off of the log page to a new help screen, accessible
by pressing F1 at the startup dialog (or on Ctrl-F11)
- Several previously undocumented keys added to help
- Some other internal changes with help text; should be easier to keep it
up-to-date in the future
- Alt-P and Alt-N keys on instrument list note translation table fixed
- Upper value limit fixed for entering sample numbers on note translation
table
- Dialog changes: 'c' and 'o' keys to select OK/Cancel
- Global keys that open dialogs (Ctrl-N, Ctrl-P, etc.) show the dialog on
key-down, instead of key-up
- In classic mode, Schism Tracker will make the clicking sound that IT
produced when initializing the sound card.
- Audio device setup code rewritten
- New config file parameter: [Audio] driver=alsa:hw:2 (format is
driver:device)
- Mouse behavior is (hopefully) more consistent and expected
==============================================================================
For older stuff, see http://schismtracker.org/hg/file/20100202/NEWS
schismtracker-20220125/README.md 0000664 0000000 0000000 00000004065 14174013371 0016100 0 ustar 00root root 0000000 0000000 # Schism Tracker
Schism Tracker is a free and open-source reimplementation of [Impulse
Tracker](https://github.com/schismtracker/schismtracker/wiki/Impulse-Tracker),
a program used to create high quality music without the requirements of
specialized, expensive equipment, and with a unique "finger feel" that is
difficult to replicate in part. The player is based on a highly modified
version of the [Modplug](https://openmpt.org/legacy_software) engine, with a
number of bugfixes and changes to [improve IT
playback](https://github.com/schismtracker/schismtracker/wiki/Player-abuse-tests).
Where Impulse Tracker was limited to i386-based systems running MS-DOS, Schism
Tracker runs on almost any platform that [SDL](http://www.libsdl.org/)
supports, and has been successfully built for Linux, Mac OS X, Windows,
FreeBSD, AmigaOS, BeOS, and even [the
Wii](http://www.wiibrew.org/wiki/Schism_Tracker). Schism will most likely build
on *any* architecture supported by GCC4 (e.g. alpha, m68k, arm, etc.) but it
will probably not be as well-optimized on many systems.
See [the wiki](https://github.com/schismtracker/schismtracker/wiki) for more
information.

## Download
The latest stable builds for Windows, macOS, and Linux are available from [the
releases page](https://github.com/schismtracker/schismtracker/releases). Builds
can also be installed from some distro repositories on Linux, but these
versions may not have the latest bug fixes and enhancements. Older builds for
other platforms can be found on
[the wiki](https://github.com/schismtracker/schismtracker/wiki). Installing via
Homebrew on macOS is no longer recommended, as the formula for Schism Tracker
is not supported or maintained by anyone directly involved in the project.
## Compilation
See the
[docs/](https://github.com/schismtracker/schismtracker/tree/master/docs) folder
for platform-specific instructions.
## Packaging status
[](https://repology.org/project/schismtracker/versions)
schismtracker-20220125/configure.ac 0000664 0000000 0000000 00000027341 14174013371 0017111 0 ustar 00root root 0000000 0000000 dnl Process this file with autoconf to produce a configure script.
dnl Schism Tracker - a cross-platform Impulse Tracker clone
dnl copyright (c) 2003-2005 Storlek
dnl copyright (c) 2005-2008 Mrs. Brisby
dnl copyright (c) 2009 Storlek & Mrs. Brisby
dnl copyright (c) 2010-2012 Storlek
dnl URL: http://schismtracker.org/
dnl
dnl This program is free software; you can redistribute it and/or modify
dnl it under the terms of the GNU General Public License as published by
dnl the Free Software Foundation; either version 2 of the License, or
dnl (at your option) any later version.
dnl
dnl This program is distributed in the hope that it will be useful,
dnl but WITHOUT ANY WARRANTY; without even the implied warranty of
dnl MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
dnl GNU General Public License for more details.
dnl
dnl You should have received a copy of the GNU General Public License
dnl along with this program; if not, write to the Free Software
dnl Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
dnl PACKAGE_VERSION will be either "" if not using git, or date of the last git commit in the form YYYYMMDD
m4_define([last_git_commit], patsubst(m4_esyscmd([git log -n 1 --date=short --format=format:%cd]), [[^0-9]]))
AC_INIT([schismtracker],[last_git_commit])
AC_CONFIG_SRCDIR([schism/main.c])
AM_INIT_AUTOMAKE([-Wall subdir-objects])
AC_CONFIG_HEADERS([config.h])
dnl -----------------------------------------------------------------------
dnl Check for standard programs
AC_PROG_CC
AM_PROG_CC_C_O
AC_PROG_CPP
AC_PROG_INSTALL
AC_PROG_LN_S
dnl do we have Git
AC_CHECK_TOOL([GIT], [git])
AC_SUBST(GIT)
AM_CONDITIONAL([HAVE_GIT], [test "x$GIT" != "x"])
dnl Windows poop
AC_CHECK_TOOL([WINDRES], [windres])
AC_SUBST(WINDRES)
AM_CONDITIONAL([HAVE_WINDRES], [test "x$WINDRES" != "x"])
dnl Necessary for building the internal help.
AM_PATH_PYTHON([2.4])
dnl We're using C
AC_LANG([C])
dnl check endianness
AC_C_BIGENDIAN
dnl Check for SDL libs
AC_CHECK_TOOL([SDL_CONFIG], [sdl-config])
AC_SUBST(SDL_CONFIG)
if test "x$SDL_CONFIG" == "x"; then
AC_MSG_ERROR([*** sdl-config not found.])
fi
if $SDL_CONFIG --version | grep -qv 1.2.1; then
AC_MSG_ERROR([*** SDL version >= 1.2.10 not found.])
fi
SDL_CFLAGS=$($SDL_CONFIG --cflags)
SDL_LIBS=$($SDL_CONFIG --libs)
dnl Libs
AC_CHECK_LIB([dl], [dlopen])
dnl Functions
AC_CHECK_FUNCS(strchr memmove strerror strtol strcasecmp strncasecmp strverscmp stricmp strnicmp strcasestr strptime asprintf vasprintf memcmp mmap nice unsetenv dup fnmatch mkstemp)
AM_CONDITIONAL([NEED_ASPRINTF], [test "$ac_cv_func_asprintf" = "no"])
AM_CONDITIONAL([NEED_VASPRINTF], [test "$ac_cv_func_vasprintf" = "no"])
AM_CONDITIONAL([NEED_MEMCMP], [test "$ac_cv_func_memcmp" = "no"])
AM_CONDITIONAL([NEED_STRPTIME], [test "$ac_cv_func_strptime" = "no"])
AM_CONDITIONAL([NEED_MKSTEMP], [test "$ac_cv_func_mkstemp" = "no"])
AM_CONDITIONAL([USE_MMAP], [test "$ac_cv_func_mmap" = "yes"])
dnl Headers, typedef crap, et al.
AC_HEADER_DIRENT
AC_HEADER_TIME
AC_CHECK_HEADERS(inttypes.h fcntl.h limits.h signal.h unistd.h sys/param.h sys/ioctl.h sys/kd.h linux/fb.h byteswap.h sys/soundcard.h)
AM_CONDITIONAL([USE_OSS], [test "$ac_cv_header_sys_soundcard_h" = yes])
AC_C_CONST
AC_C_INLINE
AC_TYPE_OFF_T
AC_TYPE_SIZE_T
AC_STRUCT_TM
AC_SEARCH_LIBS([powf], [m])
dnl -----------------------------------------------------------------------
dnl Always use x11 by default unless overriden later per-platform
dnl (this is stupid, and only needed because the x11 check is dysfunctional)
defaultx11=yes
dnl CoreMIDI (Mac OS X)
AC_MSG_CHECKING(for CoreAudio/CoreMIDI Framework)
if echo "$SDL_LIBS" | grep -- -framework >/dev/null 2>&1; then
AC_MSG_RESULT(found)
dnl frameworks aren't part of sdl... should be a separate variable
SDL_LIBS="$SDL_LIBS -framework CoreAudio -framework CoreMIDI -framework IOKit -framework OpenGL"
AC_SUBST(SDL_LIBS)
AM_CONDITIONAL([USE_MACOSX], true)
AM_CONDITIONAL([am__fastdepOBJC], true)
defaultx11=no
else
AC_MSG_RESULT(not found)
AM_CONDITIONAL([USE_MACOSX], false)
AM_CONDITIONAL([am__fastdepOBJC], false)
fi
dnl winmm testing...
AC_CHECK_HEADERS(winsock.h winsock2.h windows.h)
if test "X$ac_cv_header_windows_h" = "Xyes"; then
AM_CONDITIONAL([USE_WIN32], true)
SDL_LIBS="$SDL_LIBS -lwinmm"
AC_SUBST(SDL_LIBS)
defaultx11=no
else
AM_CONDITIONAL([USE_WIN32], false)
fi
dnl Wii crap
AC_CHECK_LIB(ogc, IOS_ReloadIOS, libogc_found=yes, libogc_found=no, [-mrvl -L${DEVKITPRO}/libogc/lib/wii])
if test x"$libogc_found" = "xyes"; then
AM_CONDITIONAL([USE_WII], true)
wii_machdep="-DGEKKO -mrvl -mcpu=750 -meabi -mhard-float"
CFLAGS="$CFLAGS $wii_machdep -I${DEVKITPRO}/libogc/include"
LIBS="$LIBS $wii_machdep -L${DEVKITPRO}/libogc/lib/wii"
SDL_CFLAGS="$SDL_CFLAGS -I${DEVKITPRO}/libogc/include/SDL"
SDL_LIBS="$SDL_LIBS -lSDL -lfat -lwiiuse -lbte -logc -lm -lwiikeyboard"
AC_SUBST(CFLAGS)
AC_SUBST(LIBS)
AC_SUBST(SDL_CFLAGS)
AC_SUBST(SDL_LIBS)
EXEEXT=.elf
AC_SUBST(EXEEXT)
defaultx11=no
else
AM_CONDITIONAL([USE_WII], false)
fi
dnl should probably have some AC_MSG_CHECKING here, but meh
if test "x$defaultx11" = "xno"; then
if test "x$with_x" = "x"; then
AC_MSG_NOTICE([X11 disabled by default; use --with-x if you really want it])
dnl (you don't want it, because it's probably broken anyway)
with_x=no
fi
fi
dnl OpenGL crud - it doesn't always exist
saved_cppflags=$CPPFLAGS
CPPFLAGS="$CPPFLAGS $SDL_CFLAGS"
AC_CHECK_HEADER([SDL_opengl.h], [AC_DEFINE([USE_OPENGL], 1, [Define to 1 if SDL's OpenGL works])])
CPPFLAGS=$saved_cppflags
dnl -----------------------------------------------------------------------
saved_libs=$LIBS
alsa=no
AC_CHECK_LIB(asound, snd_seq_open,[alsa=yes])
alsadltrick=no
if test "$alsa" = "yes"; then
if test "$ac_cv_header_sys_soundcard_h" = "yes"; then
alsadltrick=yes
LIBS=$saved_libs
fi
fi
AM_CONDITIONAL([USE_ALSA], [test "$alsa" = yes])
AM_CONDITIONAL([USE_ALSA_DLTRICK], [test "$alsadltrick" = yes])
AC_PATH_XTRA()
if test "$no_x" = "yes"; then
dnl no X11
AM_CONDITIONAL([USE_X11], [false])
AM_CONDITIONAL([USE_XV], [false])
else
AM_CONDITIONAL([USE_X11], [true])
SDL_LIBS="$SDL_LIBS -lX11 -lXext"
AC_SUBST(SDL_LIBS)
LIBS="$LIBS $X_LIBS"
AC_SUBST(LIBS)
dnl this previously checked X11/extensions/XKB.h, but nothing
dnl ever used it (xkb.c still included X11/XKBlib.h even when
dnl autoconf reported it as nonexistent -- weird!)
AC_CHECK_HEADERS(X11/Xlib.h X11/XKBlib.h)
AC_CHECK_LIB(Xv, XvQueryExtension,,,-lX11 -lXext)
if test "$ac_cv_lib_Xv_XvQueryExtension" = "yes"; then
AC_CHECK_HEADERS(X11/extensions/Xvlib.h,,,[[
#include
]])
if test "$ac_cv_header_X11_extensions_xvlib_h" = "yes"; then
SDL_LIBS="$SDL_LIBS -lXv -lXext"
AC_SUBST(SDL_LIBS)
AM_CONDITIONAL([USE_XV], [true])
elif test "$ac_cv_header_X11_extensions_Xvlib_h" = "yes"; then
SDL_LIBS="$SDL_LIBS -lXv -lXext"
AC_SUBST(SDL_LIBS)
AM_CONDITIONAL([USE_XV], [true])
else
AM_CONDITIONAL([USE_XV], [false])
fi
else
AM_CONDITIONAL([USE_XV], [false])
fi
fi
dnl asdjklfjklasdfaskdfjklads
saved_LIBS="$LIBS"
AC_SEARCH_LIBS(socket, socket network)
LIBS="$saved_LIBS"
if test "x$ac_cv_search_socket" = "xno"; then
dnl Windows sucks (I don't even know what this is about, but it apparently works)
AC_CHECK_HEADERS(winsock.h winsock2.h)
if test "x$ac_cv_header_winsock_h" = "xyes"; then
socketlib="-lwsock32"
elif test "x$ac_cv_header_winsock2_h" = "xyes"; then
socketlib="-lws2_32"
fi
if test "x$socketlib" = "x"; then
echo "*** No sockets for you!"
AM_CONDITIONAL([USE_NETWORK], false)
else
AM_CONDITIONAL([USE_NETWORK], true)
SDL_LIBS="$SDL_LIBS $socketlib"
AC_SUBST(SDL_LIBS)
fi
elif test "x$ac_cv_search_socket" = "xnone required"; then
dnl free networking
AM_CONDITIONAL([USE_NETWORK], true)
else
SDL_LIBS="$SDL_LIBS $ac_cv_search_socket"
AC_SUBST(SDL_LIBS)
AM_CONDITIONAL([USE_NETWORK], true)
fi
#AC_CHECK_LIB(kernel32, GetConsoleMode, SDL_LIBS="$SDL_LIBS -Wl,--subsystem,console")
dnl wee...
dnl this completely sucks...
OBJC=$CC
OBJCFLAGS=$CFLAGS
AC_SUBST(OBJC)
AC_SUBST(OBJCFLAGS)
dnl -----------------------------------------------------------------------
dnl (This ought to be above AC_PROG_CC, but that causes configure to fail
dnl when all the insane warnings are are enabled.)
AC_ARG_ENABLE(extra-opt,
AS_HELP_STRING([--enable-extra-opt], [Add extra, system-dependent optimizations (do not use this together with debug or even profiling)]),
ADD_OPT=$enableval,
ADD_OPT=no)
AC_ARG_ENABLE(all-warnings,
AS_HELP_STRING([--enable-all-warnings], [Enable ridiculous compiler warnings]),
ADD_WARN=$enableval,
ADD_WARN=no)
AC_ARG_ENABLE(debug,
AS_HELP_STRING([--enable-debug], [Enable debug flags]),
ADD_DEBUG=$enableval,
ADD_DEBUG=no)
AC_ARG_ENABLE(profiling,
AS_HELP_STRING([--enable-profiling], [Enable profiling flags (slows things down), debugging (--enable-debug) is also enabled by this]),
ADD_PROFILING=$enableval,
ADD_PROFILING=no)
AC_ARG_ENABLE(ludicrous-mode,
AS_HELP_STRING([--enable-ludicrous-mode], [Enable all warnings, and treat as errors]),
ADD_LUDICROUS=$enableval,
ADD_LUDICROUS=no)
AC_ARG_ENABLE(fortify-source,
AS_HELP_STRING([--enable-fortify-source], [Build with FORTIFY_SOURCE]),
ADD_FORTIFY=$enableval,
ADD_FORTIFY=no)
dnl fortify needs -O; do this early so ADD_OPT can override with higher -O level
if test x$ADD_FORTIFY \!= xno; then
CFLAGS="$CFLAGS -O -D_FORTIFY_SOURCE=2"
fi
dnl place extra optimizations after existing cflags so that they can override
dnl override whatever flags might exist by default (-g -O2 usually)
if test x$ADD_OPT \!= xno; then
if test x$ADD_DEBUG \!= xno || test x$ADD_PROFILING \!= xno; then
AC_MSG_NOTICE([You aren't supposed to use --enable-debug or --enable-profiling together with --enable-extra-opt!!])
fi
ADD_OPT="-Ofast -g0 -s -fno-exceptions -march=native"
CFLAGS="$CFLAGS $ADD_OPT"
fi
if test x$ADD_LUDICROUS \!= xno; then
ADD_WARN=yes
CFLAGS="$CFLAGS -Werror"
fi
dnl ... but put the warnings first, to make it possible to quiet certain
dnl warnings if necessary, while still providing most of the benefit
if test x$ADD_WARN \!= xno; then
ADD_WARN="-Wall -Wextra -Winline -Wshadow -Wwrite-strings -Waggregate-return -Wpacked"
ADD_WARN="$ADD_WARN -Wstrict-prototypes -Wmissing-prototypes -Wmissing-declarations -Wnested-externs"
CFLAGS="$ADD_WARN $CFLAGS"
fi
if test x$ADD_PROFILING \!= xno || test x$ADD_DEBUG \!= xno; then
CFLAGS="$CFLAGS -g -O0"
OBJCFLAGS="$OBJCFLAGS -g -O0"
SDL_LIBS="$SDL_LIBS -g -O0"
AC_SUBST(SDL_LIBS)
fi
if test x$ADD_PROFILING \!= xno; then
CFLAGS="$CFLAGS -pg"
OBJCFLAGS="$OBJCFLAGS -pg"
SDL_LIBS="$SDL_LIBS -pg"
AC_SUBST(SDL_LIBS)
fi
dnl - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
AC_CONFIG_FILES([Makefile])
AC_OUTPUT
schismtracker-20220125/docs/ 0000775 0000000 0000000 00000000000 14174013371 0015544 5 ustar 00root root 0000000 0000000 schismtracker-20220125/docs/building_on_linux.md 0000664 0000000 0000000 00000010524 14174013371 0021600 0 ustar 00root root 0000000 0000000 # Building on Linux
Since Linux is the primary development platform for Schism Tracker, it's
probably the easiest to compile on, and those familiar with automake-based
projects will find few surprises here.
## Prerequisites
You'll need [autoconf](http://www.gnu.org/software/autoconf/),
[automake](http://www.gnu.org/software/automake/), [gcc](http://gcc.gnu.org/),
[make](http://www.gnu.org/software/make/), [Python](https://www.python.org/)
and [LibSDL](http://www.libsdl.org/) *at a minimum*. Additionally,
[Git](https://git-scm.com/) is strongly recommended. If all you're planning on
doing is building it once, you can just as easily grab the source tarball from
the repository and build from that, but having Git installed makes it easier to
keep up-to-date, help with debugging, and (if you're so inclined) development.
See below for distro-specific instructions on how to get everything installed
in order to build Schism Tracker.
To get the source:
git clone https://github.com/schismtracker/schismtracker.git
cd schismtracker && autoreconf -i
You can then update your schismtracker source directory by going to this
schismtracker directory and running:
git pull
## Building Schism Tracker
To build Schism Tracker, you should set up a build-directory and compile from
there. From the schismtracker directory:
mkdir -p build && cd build && ../configure && make
The resulting binary `schismtracker` is completely self-contained and can be
copied anywhere you like on the filesystem.
You can specify custom compiler flags, e.g. to optimize schismtracker
stronly, system-dependently:
make clean # recompiling needed after changing compiler setting
../configure --enable-extra-opt
make -j $(nproc || sysctl -n hw.ncpu || echo 2)
The -j flag passed to make enables compilation on multiple threads.
For debugging, and other settings, see `../configure --help`.
## Packaging Schism Tracker for Linux systems
The `icons/` directory contains icons that you may find suitable for your
desktop environment. The `sys/fd.org/schism.desktop` can be used to launch
Schism Tracker from a desktop environment, and `sys/fd.org/itf.desktop` can be
used to launch the built-in font-editor.
## ALSA problems
The configure script should autodetect everything on your system, but if you
don't have the ALSA development libraries installed, Schism Tracker won't be
built with ALSA MIDI support, even if your SDL libraries include ALSA digital
output.
See below for information on what packages you should install for your
distribution in order to build a full-featured Schism Tracker binary.
## Cross-compiling Win32
Schism Tracker can be built using the mingw32 cross-compiler on a Linux host.
You will also need the [SDL MINGW32 development
library](http://libsdl.org/download-1.2.php). If you unpacked it into
`/usr/i586-mingw32/`, you could use the following to cross-compile Schism
Tracker for Win32:
mkdir win32-build
cd build
env SDL_CONFIG=/usr/i586-mingw32/sdl-config \
../configure --{host,target}=i586-mingw32 --without-x
make
If you want to build an installer using the [nullsoft scriptable install
system](http://nsis.sourceforge.net/), copy some files into your build
directory:
cd build
cp /usr/i586-mingw32/bin/SDL.dll .
cp ../COPYING COPYING.txt
cp ../README README.txt
cp ../NEWS NEWS.txt
cp ../sys/win32/schism.nsis .
cp ../icons/schismres.ico schism.ico
and run the makensis application:
makensis schism.nsis
## Distribution-specific instructions
Getting the prerequisites covered is fairly straightforward in most Linux
distributions.
#### Ubuntu / Debian
apt-get install build-essential automake autoconf autoconf-archive \
libx11-dev libxext-dev libxv-dev libxxf86misc-dev \
libxxf86vm-dev libsdl1.2-dev libasound2-dev git \
libtool
Additionally, for cross-compiling win32 binaries:
apt-get install mingw32 mingw32-binutils mingw32-runtime nsis
#### Arch Linux
pacman -S base-devel git sdl alsa-lib libxv libxxf86vm
For cross-compiling win32 binaries:
pacman -S mingw-w64-gcc
yaourt -S mingw-w64-sdl nsis
Note: yaourt isn't strictly necessary, but since `mingw-w64-sdl` and `nsis` are
AUR packages, you'll have to build them by hand otherwise or use a different
[AUR helper](https://wiki.archlinux.org/index.php/AUR_helpers).
schismtracker-20220125/docs/building_on_osx.md 0000664 0000000 0000000 00000011555 14174013371 0021257 0 ustar 00root root 0000000 0000000 # Building on OS X
Start by installing [Homebrew](http://brew.sh/). Open up the Terminal and paste in the following command.
```
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```
After Homebrew has been successfully installed, you need to install `automake`, `autoconf`, `SDL` and `git`.
```
brew install automake autoconf sdl git
```
Alternatively, if you have MacPorts installed, you can use this command instead:
```
sudo port install automake autoconf libtool libsdl git
```
In this case, you may have to open a new terminal shell, or else you may get warnings about the version of autoconf/automake you're using.
Now clone the GitHub repo:
```
git clone https://github.com/schismtracker/schismtracker.git
```
Enter the Schismtracker folder and run `autoreconf -i`
```
cd schismtracker
autoreconf -i
```
Now you will need to create the `build` -folder, enter it and start `../configure`
```
mkdir -p build
cd build
../configure && make
```
Test Schismtracker from the commandline by typing
```
./schismtracker
```
If it worked, you are ready to start the updating of the **Schism Tracker.app**
## Baking Schism Tracker into an App ready to be put in /Applications
If you are in the `build` -folder, discover the `Schism_Tracker.app` subfolder `Contents` and, after creating the `MacOS` -folder, copy the newly built `schismtracker` there - then test the `Schism_Tracker.app` by clicking on it in Finder. Here are the instructions on how to do it (this will open a Finder window showing the `sys/macosx` -folder, where-in you will see the app itself.
```
cd ../sys/macosx/Schism_Tracker.app/Contents/
mkdir MacOS
cd MacOS
cp ../../../../../build/schismtracker .
cd ../../../
open .
```
If this newly baked version of `Schism_Tracker.app` worked, just copy it to your `/Applications` -folder.
Enjoy.
## Building for distribution
However, if you want to build an application bundle *for distribution*, there's
a few potential snags. In particular, SDK versions are backward-incompatible,
so you need to make note of what version you're building with; and if you also
want to support the dwindling population of PowerPC users, you'll have to build
a Universal binary. Plus, since SDL is not normally present on OS X, you'll
need to bundle it in with the application.
There used to be somewhat lengthy instructions here elaborating on various
nuances of installing Fink and managing multiple SDKs, but these have become
rather outdated and probably less than thoroughly useful. If anyone has current
and first-hand experience with building on OS X which might be helpful to
others, please feel free to share.
## Cross-compiling on a Linux host
[This page](http://devs.openttd.org/~truebrain/compile-farm/apple-darwin9.txt)
has some notes that might be of use in building a cross-compilation toolchain.
Building a cross-compiler is *not* an easy process, and will probably take the
better part of a day; however, it is definitely possible, and in fact is what I
use for compiling the "official" OS X packages. The build process is rather
messy, but it goes something like:
mkdir -p osx/{x86,ppc}
cd osx/x86
env PATH=/usr/i686-apple-darwin9/bin:${PATH} \
{C,CXX,OBJC}FLAGS='-g0 -O2' LDFLAGS=-s \
../../configure --with-sdl-prefix=/usr/i686-apple-darwin9 \
--{target,host}=i686-apple-darwin9 \
--build-i686-linux
env PATH=/usr/i686-apple-darwin9/bin:${PATH} make
cd ../ppc
env PATH=/usr/powerpc-apple-darwin9/bin:${PATH} \
{C,CXX,OBJC}FLAGS='-g0 -O2' LDFLAGS=-s \
../../configure --with-sdl-prefix=/usr/powerpc-apple-darwin9 \
--{target,host}=powerpc-apple-darwin9 \
--build-i686-linux
env PATH=/usr/powerpc-apple-darwin9/bin:${PATH} make
cd ..
/usr/i686-apple-darwin9/bin/lipo -create -o {.,x86,ppc}/schismtracker
/usr/i686-apple-darwin9/bin/install_name_tool -change \
'@executable_path/../Frameworks/SDL.framework/Versions/A/SDL' \
'@executable_path/sdl.dylib' schismtracker
Then copy the `lipo`'ed `schismtracker` and `sdl.dylib` both into the `MacOS/`
folder in the bundle, and it Should Work. The versions I have installed are GCC
4.0.1 (SVN v5493), ODCCTools SVN v280, and XCode SDK 3.1.3. This SDK version
advertises compatibility with 10.4 at minimum, although people have reported
success in running Schism Tracker on 10.3.9.
Note: because parts of the debugging information are conspicuously absent,
cross-compiling with debugging symbols simply isn't possible. This isn't very
likely to be useful anyway; if you can run the program in a debugger, then
you're *probably* running OS X, in which case you might as well just build
natively and eliminate the hassle.
schismtracker-20220125/docs/building_on_windows.md 0000664 0000000 0000000 00000012111 14174013371 0022125 0 ustar 00root root 0000000 0000000 # Building on Windows
_This page was based originally on the COMPILE-WIN32.txt file traditionally
provided with Schism Tracker sources. It has been rewriten with instructions
that use newer tools._
## Software needed
To compile on Windows, the following things are needed:
* mingw-gcc
* Python
* SDL headers and libs
* An environment in which to run them, like msys.
If you want proper version information, you'll need git installed and in your
path too
## Installing MSYS2 and mingw
These instructions describe how to install msys2, which includes all of the
required packages.
### Get MSYS2 and install it
Go to the URL http://msys2.github.io/ and download either the 32bit installer
or the 64bit installer. The 32bit download can run on 32bit windows and the
64bit one requires a 64bit Windows.
64bit executables can be created with either of them.
Once installed, follow these instructions to get up-to-date files. This process
is also described in their web page, so in case of conflict, you might opt to
follow their instructions.
Run the MSYS2 shell (a start menu shortcut should have been created) and update
the pacman package manager:
pacman -Sy pacman
Close the MSYS2 window. Run it again from the Start menu and update the system:
pacman -Syu
Close the MSYS2 window. Run it again from the Start menu _(note: the update
process can, in some cases, break the start menu shortcut - in which case you
may need to look in C:\msys64 (or wherever you installed msys) and run
msys2\_shell.cmd)_ and update the rest with:
pacman -Su
### Install the toolchains
Once you have the shell environment ready, it's time to get the compilers.
Execute the following command:
pacman -S mingw-w64-i686-toolchain libtool autoconf automake make
Also, you need the following specific dependency:
pacman -S mingw-w64-i686-SDL
If you also want to build for 64bits:
pacman -S mingw-w64-x86_64-toolchain mingw-w64-x86_64-SDL
You can search for packages with
pacman -Ss package descripption
## Compilation
MSYS2 installs three shortcut icons, one to run the msys shell, and two more
that setup the environment to use either the 32bit compiler or the 64bit
compiler.
You can also start the 32bit compiler with
msys2_shell.cmd -mingw32
and the 64bit compiler with
msys2_shell.cmd -mingw64
### Configure schismtracker to build
Open the 32bit or 64bit shell depending on which version you want to build.
The steps here only need to be done once, or when configure.ac or the installed
package versions change.
Go to schismtracker sources root (drive letters are mapped to /x , example C:/
is /c/, D:/ is /d/ ...)
Reconfigure it:
autoreconf -i
_(note: if you get a "possibly undefined macro: AM\_PATH\_SDL" error, you're
probably using the standard msys2 shell - either use the mingw start menu
shortcuts, or start msys2_shell.cmd with either -mingw32 or -mingw64 as
mentioned above)_
If you're planning to build both 32- and 64-bit binaries, you may wish to
create the subdirs build32 and build64:
mkdir build32
mkdir build64
and then follow the rest of the instructions twice, once with the -mingw32
shell in the build32 subdir, and once with the -mingw64 shell in the build64
subdir.
Otherwise just build will do:
mkdir build
Now move into the build subdir and run the configure script:
cd build # or build32 or build64 as appropriate
../configure
### Build and rebuild
In order to build and run it, from the appropriate build subdir, run these:
make
../schismtracker &
### Compilation problems
The configure script should give hints on what is missing to compile. If you've
followed the steps, everything should already be in the place, but in case it
doesn't, see the config.log file, which reports a detailed output (more than
what is seen on the screen) that could help identify what is missing, or which
option is not working.
### Debugging
When installing the toolchains, the gdb debugger is also installed. Run it
from the win32 shell to debug the 32bit exe, or run it from the Win64 shell to
debug the 64bit one.
## Prepare the distribution file
To distribute the application, it is important to bundle the correct version of
the SDL.dll file with the executable.
For a 32bit build, the file is located in /msys2_path/mingw32/bin/SDL.dll
For a 64bit build, the file is located in /msys2_path/mingw64/bin/SDL.dll
The 32bit build also requires the files
/msys2_path/mingw64/bin/libgcc_s_dw2-1.dll and
/msys2_path/mingw64/bin/libwinpthread-1.dll
If you want to reduce the exe size (removing the debugging information), use
the following command:
_(note: you MUST do this from the same shell than you used to build the
executable, as the strip tool is architecture-dependent)_
strip -g schismtracker.exe
## SDL2 notes
The current version of schismtracker uses SDL1, but a fork with SDL2 has been
made here https://github.com/davvid/schismtracker/tree/laptop-octave
In order to build that branch, installing the SDL2 packages AND pkg-config is
needed
pacman -S mingw-w64-i686-SDL2 mingw-w64-i686-SDL2_gfx mingw-w64-i686-pkg-config mingw-w64-x86_64-SDL2 mingw-w64-x86_64-SDL2_gfx mingw-w64-x86_64-pkg-config
schismtracker-20220125/docs/configuration.md 0000664 0000000 0000000 00000016751 14174013371 0020747 0 ustar 00root root 0000000 0000000 # Configuration
Schism Tracker saves its configuration in a plain-text,
[INI-style](http://en.wikipedia.org/wiki/INI_file) file named `config`. Under
normal circumstances it should theoretically not be necessary to deal with this
file directly. However, there are some options that are not configurable from
within Schism Tracker for one reason or another. In these cases, any plain text
editor should suffice.
The location of this file is dependent on the OS:
- **Windows**
- `%APPDATA%\Schism Tracker`
- **Mac OS X**
- `~/Library/Application Support/Schism Tracker`
- **AmigaOS 4**
- `PROGDIR:`
- **Linux/Unix**
- `$HOME/.schism/`
- **Wii**
- Same directory as `boot.elf` (e.g. `sd:/apps/schismtracker`)
Aside from `config`, you may also add a `fonts` subdirectory for custom font
files. By default, `font.cfg` is automatically loaded on startup, and other
`*.itf` files are listed by the built-in font editor (Shift-F12). See [the
links page](https://github.com/schismtracker/schismtracker/wiki/Links) for some
resources on getting fonts for Schism Tracker.
## Potentially useful "hidden" config options
To enable any of these, find the `[section]` in the config file, look for the
`key=`, and change the value. If the key doesn't exist, simply add it.
#### Video
[Video]
lazy_redraw=1
width=640
height=400
want_fixed=0
gl_bilinear=1
`lazy_redraw` slows down the framerate when the program isn't focused. This
used to be kind of useful when the GUI rendering sucked, and maybe it still is
if you're stuck with a painfully slow video card and software rendering, and
you also want to have a huge window that isn't active.
`width` and `height` are the initial dimensions to use for the window, and the
dimensions to return to when toggling fullscreen off.
If you are having problems with fullscreen aspect ratio, you can try setting
`want_fixed` to 1. This will attempt to "correct" the fullscreen resolution
used by Schism.
If `gl_bilinear` is zero, OpenGL will not use bilinear filtering when scaling
the screen. This has no effect when running at the native resolution of
640x400.
#### Backups
[General]
make_backups=1
numbered_backups=1
When overwriting a `filename.it`, copy the existing file to `filename.it~`.
With numbered_backups, write to `filename.it.1~`, `filename.it.2~`, etc.
#### Key repeat
[General]
key_repeat_delay=125
key_repeat_rate=25
Alter the key repeat. "Delay" is how long before keys begin to repeat, "rate"
is how long between repeated keystrokes. (Both are in milliseconds.) Above are
[Storlek](https://github.com/schismtracker/schismtracker/wiki/Storlek)'s
settings, which are very fast but convenient for speed tracking.
The *default* repeat delay and rate come from your operating system, so you
only need to set this if you like having a different rate for Schism Tracker
than you do for the rest of your system.
#### Alternate font
[General]
font=notch.itf
Load some other font besides `font.cfg` at startup. This option doesn't really
have much of a point, because the file listed is limited to those within the
`fonts` directory, and it's just easier to open the font editor, browse fonts,
and save to `font.cfg`.
#### DJ mode
[General]
stop_on_load=0
If zero, loading a song when another one is playing will start playing the new
song after it is loaded.
#### File browser
[Directories]
module_pattern=*.it\073 *.xm\073 *.s3m\073 *.mtm\073 *.669\073 *.mod
Changes what files are presented in the load/save module lists. Use * for all
files. For annoying compatibility reasons, semicolons are rewritten as `\x3b`
or `\073` when saving.
This was formerly named `filename_pattern`; Schism Tracker ignores the old
value and comments it out when saving to work around bugs in older versions.
sort_with=strcasecmp
Alter the sort order. Possible values are `strcmp` (case-sensitive),
`strcasecmp` (case-insensitive), and `strverscmp` (case-sensitive, but handles
numbers smartly e.g. `5.it` will be listed above `10.it`).
#### Keyjazz
[Pattern Editor]
keyjazz_noteoff=1
keyjazz_write_noteoff=0
keyjazz_repeat=0
If `keyjazz_noteoff` is 1, letting go of a key in the pattern editor will cause
a note-off. If using this, you might also want to consider setting
`keyjazz_repeat` to 0 in order to avoid inserting multiple notes when holding
down keys.
If `keyjazz_write_noteoff` is 1, letting go of a key in the pattern editor will
also write a note off *if* playback tracing (Ctrl+F) is enabled.
#### Pattern editor behavior tweaks
[Pattern Editor]
mask_copy_search_mode=1
invert_home_end=1
When `mask_copy_search_mode` is set to 1, pressing Enter on a row with no
instrument number will search backward in the channel for an instrument and
switch to that one.
`invert_home_end` changes the order of the Home and End keys to make the cursor
move to the first or last row within the channel before moving to the first or
last channel. FT2 users might want to enable this.
#### Key modifiers
[General]
meta_is_ctrl=1
altgr_is_alt=1
These alter how modifier keys are interpreted. Mac OS X users in particular
might appreciate `meta_is_ctrl`, which allows using the Command/Apple key as
the Ctrl modifier within Schism Tracker. `altgr_is_alt` works similarly.
#### Audio output
[Audio]
buffer_size=256
driver=dsp:/dev/dsp1
These settings define the audio buffer size, and which audio device Schism
Tracker uses. (The other settings in the `[Audio]` section are configurable
from Shift-F1.) `buffer_size` should be a power of two and defines the number
of samples in the mixing buffer. Smaller values result in less audio latency
but could cause buffer underruns and skipping.
`driver` is parsed identically to the `--audio-driver` switch on the command
line. If you're using Alsa on Linux and want to use you can set
`driver=alsa:dmix` to get Schism Tracker to play with other programs. (However,
Alsa completely ignores the latency with dmix so it might cause massive delays
between pressing a note and hearing it, which is why Schism Tracker requests a
"real" device by default.)
[Diskwriter]
rate=96000
bits=16
channels=2
This defines the sample format used by the disk writer – for exporting to
.wav/.aiff *and* internal pattern-to-sample rendering.
## Hook functions
Schism Tracker can run custom scripts on startup, exit, and upon completion of
the disk writer. These are stored in the configuration directory, and are named
`startup-hook`, `exit-hook`, and `diskwriter-hook` respectively. (On Windows,
append `.bat` to the filenames.) Hooks are useful for making various
adjustments to the system – adjusting the system volume, remapping the
keyboard, etc. The disk writer hook can be used to do additional
post-processing, converting, etc. (Note: on the Wii, hooks are not processed
since there is no underlying OS or command interpreter to run them.)
#### Example
For users with non-US keyboards, some keys may not work properly. This can be
worked around by switching temporarily to a US keyboard layout on startup, and
resetting the keyboard on exit. To define hooks to accomplish this:
cat >~/.schism/startup-hook <~/.schism/exit-hook <