 _____________________  spinal shark collective release information
|            SSC-003  | product    code: SSC-003
|                     | product    type: stepmania theme
| the spinal shark    | target  version: StepMania 5
| collective presents |             (http://code.google.com/p/sm-ssc/)
|                     | 
|  m o o n l i g h t  |       project title: moonlight
|                     | version information ------------------------------------
|   for stepmania 5   |               pulse: i6000
|                     |                date: 20120711 20:32 (UTC-6,CDT)
|_____________________|

================================================================================
[Table of Contents]
1. SSC Introduction
2. moonlight Introduction
3. moonlight Post-Mortem
4. Changelog
5. Notes
6. Theme License
7. Credits
8. Thanks
================================================================================
[1. SSC Introduction]
The spinal shark collective (also known as SSC) is composed of the greatest
StepMania themers on the planet today. In the future, we will branch out to
things that are not StepMania.

We are:
* freem (AJ)	(http://www.ajworld.net/)
* Midiman		(http://midiman.shakesoda.com/)
* shakesoda		(http://shakesoda.com/)
* Deluxe		(http://taikora.com/)
* tweak
* luizsan		(http://luizsan.zxq.net/)

Our combined experience is around 30 years, with freem having themed since 3.9a17
back in 2004, shake and Midi starting back in 2006, tweak since at least 2006
if not earlier, Deluxe with two years (of SM5 experience, and likely a few more
with StepMania 3.9), and luizsan with two years.

Joining us are the SSC Associates:
* D. Trucks		(fka Kita Khyber; Musician/Simfile artist)
* DaisuMaster	(themer, author of Ini->Lua Conversor program)
* K				(Loopmaster)
* Jousway		(King of Noteskins)

If you're looking to take the plunge and can meet up to our high standards,
find one of us somewhere and present a list of credentials as well as any
completed StepMania work (themes/noteskins/etc).

Experience with previous versions of StepMania is a plus.
Experience with StepMania's source code is even better. :)

SSC releases:
[SSC-001] dubaiOne (SM4CVS 20080103)
[SSC-002] Cerulean Skies 2 (SM4CVS 20080103; port to SM5 stalled)
[SSC-003] moonlight (SM5; formerly for SM4 alpha versions, sm-ssc)
[SSC-SM4] sm-ssc (a fork of StepMania, not a theme.)
[SSC-005] Optical (sm-ssc, SM5)
[SSC-M03] Zenith (sm-ssc)
[SSC-ULT] ultralight
--------------------------------------------------------------------------------
SSC in-progress:
[SSC-004] Selling Out Made Simple 2 (SM5)
[SSC-007] Optical 2 (SM5)
[SSC-???] Monolith
[SSC-???] Urban Fragments (former sm-ssc default theme)
[SSC-SOMS3] Selling Out Made Simple 3 (SM5)
--------------------------------------------------------------------------------
freem solo port releases:
[FRM-DDR5]  Dance Dance Revolution 5th Mix (Original theme by PatrickDDRX, SM5)
[FRM-PKTXV] PROJEKTXV:Epsilon (Original theme by k//eternal, SM5)
--------------------------------------------------------------------------------
freem solo ports in-progress:
[FRM-MAX2]  DDRMAX2 and Friends (SM5)
[FRM-UMIX1] DDR Ultramix (SM5)
[FRM-MGD3]  Mungyodance 3 (SM5)

all code and product names subject to change.
================================================================================
[2. moonlight Introduction]

moonlight was previously called dubaiOne. I decided to change the name for
personal reasons, among others*. I touched on this in a post on the StepMania
forums if you are interested in the reasoning behind the change. The new name
was chosen while I was creating a temporary Common window icon.

If you're not familiar with dubaiOne, it is a theme for StepMania 4 that focused
on simplicity and the ability to customize the theme, as well as your StepMania
experience.

moonlight takes this customization to the next level, while also updating
dubaiOne to look and work nice in higher resolutions and non-4:3 aspect ratios,
as well as non-dance gametypes.

* http://www.dmi.ae/DubaiOne/ could also have something to do with it...
================================================================================
[3. moonlight Post-Mortem]
After four years of development on multiple versions of StepMania, I can finally
say that moonlight/dubaiOne has been completed to my vision of "1.0".

It wasn't an easy ride, especially when you consider the fact that I was also
juggling other themes and StepMania (sm-ssc) development responsibilities.

That being said, this theme was meant to be the flagship theme of the SSC, (or
at least my entry in the SSC flagship themes) and I guess that goal has been
accomplished. moonlight has traveled across the world, and some people have even
stolen parts of it for use in their work. I'm still not exactly sure how to
react to that.

Some of the things moonlight/dubaiOne did were impressive for the time, but
theming technology has advanced since 2008. moonlight's code is showing its
age, especially with its dependence on the old theme preferences system.

Theme features that went well:
* Screen Filter
  For the time, being able to change the color of the Screen Filter was a neat
  feature. Most themes after moonlight (some of mine included) only allow for
  changing the alpha of a black filter.
* CustomSpeedMods
  Went so well it's included in the StepMania 5 theme set.
* DVNO easter egg
  Also made its way into StepMania 5, but now people have no choice in the
  matter. DVNO is always four capital letters, printed in gold. At least, in
  the TextBanner on MusicWheelItems it is...

Theme features that did not pan out as well as I expected:
* HDActor, AutoFont
  These two scripts were made to pick between the normal and doubleres
  textures/fonts for display. I'm not sure if I would ever use these two
  features again, as it seems pretty confusing to me now.
* WidescreenHelpers
  This also did not pan out too well. Most of the code in it was not good enough
  for my standards after a couple of years. I had attempted to remove it from
  the StepMania 5 theme set, but it appears some people had actually used it.
* ScreenEvaluationSummary
  I gave up on this when I couldn't get the right number of banners to show.
  This screen can be a pain in the ass most of the time. I don't know how
  anyone else can stand to theme it.
* ScreenHSV
  The concept was nice. The implementation was a very bad hack.
  This was the screen that opened up the possibilities and allowed
  MK2ULTRA/freemTech2 to be created. If I were to make this screen again,
  I would put shared functionality in one file and just call that from the
  specific screens.

The future of moonlight is in a rewrite from scratch for StepMania 5, called
"moonlight midnight". You could consider moonlight midnight a sequel to this
theme, but I would be wary of doing so, as moonlight midnight won't be the same.

No, moonlight midnight is not dubaiTwo.
================================================================================
[4. Changelog]
Every change from the theme's history as "moonlight" is in changelog.txt.
================================================================================
[5. Notes]

==Known Issues==
For some reason, SampleMusicPreviewMode doesn't play nice with SampleMusicLoops
on ScreenSelectMusic. This causes the menu music to re-play from the beginning
every time a section is changed.

This bug is a program-side issue and must be fixed in the source code.

==Custom Speed Mods==
moonlight for SM5 uses CustomSpeedMods v2.3, built into the fallback theme.

CustomSpeedMods reads the speed mods from various text files:

1) Save/MachineProfile/SpeedMods.txt
The machine can store its own speed mods. If you've edited SpeedMods.txt in the
Data folder and still have it, you should move it here instead, since the file
in Data/ is not read from anymore.

2) Save/LocalProfiles/{UID}/SpeedMods.txt [Local Profile]
3) {USB drive}/StepMania 5/SpeedMods.txt
CustomSpeedMods v2.0 and above allows the theme to read speed mods from a
player's profile. This also works from a USB stick.

This is the preferred location to store your speed mods.

The format of SpeedMods.txt is:
0.5x,1x,1.5x,2x,2.5x,3x,4x,8x,C200,C400
and so on.

The SpeedMods.txt file in the Data/ folder is no longer read from.
Please move it to the machine profile directory if you wish to keep it.

==Screen Cover==
For best performance of editing the Screen Cover, press the player's start
button on the player you want to edit the cover of.

If you want to edit Player 1's cover, press P1's start on P1.
If you want to edit Player 2's cover, press P2's start on P2.
This seems to work correctly all the time.
(It has not been tested with recent code, however, so this may or may not be true.)

==Other Game Types==
moonlight has not been extensively tested with other gametypes, though it is
an overall goal of the theme to work with most of the popular gametypes.

moonlight v1.0 does not _actively_ target any other gametype than dance, in order
to make sure the theme's core is working.
Other game modes will be polished in post-v1.0 versions.

Here are some things you should know if you decide to use moonlight with a
gametype other than the default ("dance").

* The Screen Cover option menu may not work completely in some gametypes.
I know this is the case for Pump (trying to find a solution).

* Anything that's not Dance or Pump is currently untested overall.
Pump is the first non-dance type that will be tested.

From there, the other modes I want to support are:
* kb7
* techno
* para

==Online==
The current implementation of StepMania Online has been marked as deprecated by
the StepMania developers. Work on a new online system (a part of StepMania 5
Tournament Edition) has begun.

==Evaluation Summary==
Any errors on this screen are intended, as AJ does not play with Event Mode off.

================================================================================
[6. Theme License]

moonlight is released under AJ's StepMania Theme License.

Copyright © 2008-2012 AJ Kelly and the spinal shark collective.

Terms of the license are as follows:
1) Redistributions of this theme must include this license.

2) moonlight is a StepMania theme for StepMania 5 alpha 2 (or above).
Under this license, you agree not to use it on any version released before
StepMania 5 alpha 2.

This clause should pre-empt any bug reports that may pop up from using
outdated versions. By using this theme on any other version than the one
specified above, you waive your right to notify the creator of any theme bugs
until you upgrade to the suggested version (or later, if existing) of StepMania
as shown above and verify that they still exist using the latest version.

2a) This theme does not work on "StepMania 4" starting with StepMania 4 b1.
This is because StepMania 4 b1 uses an older codebase than StepMania 4 alpha
versions.

2b) This theme _may_ be used on sm-ssc v1.2.5, but it may cause errors if any
new SM5-only Lua bindings are used. I will not be fixing these errors, as I
have moved on to SM5. If you use this theme on sm-ssc, you agree that these
errors become your responsibility (if you care enough). If you don't care, go
upgrade to SM5.

3) Under this license, you agree to not claim the theme as your own or
use parts of it without permission. Please contact me if you wish to use any
non-trivial Lua code from this theme in your own themes.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

March 2011 License Addendum
___________________________
Again, the license above says that you may not use parts of this theme without
permission. Despite this license, the people developing the Jewish dance game
Step It Up have ignored this. Unless you are a member of the spinal shark
collective (and you probably aren't), you need to ASK ME before using any of
the graphics from this theme.

The best way to get in touch with me is via the SSC/KKI Twitter: @ssc_kki

March 2012 License Addendum
___________________________
It's funny when you go around telling other people to take down derivatives of
your work when the people who make the theme don't respect the above license.

Have you seen BGAnimations/ScreenSelectMusic decorations/moonIcons.lua?
It's some code I wrote a while ago. However, I see the same file (with some
slight modifications) in Cyberia Style 7 (as "OptionIconsSel.lua").

I do not recall being contacted for the use of my code in their theme,
nor was moonlight mentioned in the credits.

Solutions to this problem are being accepted. The person responsible for
stealing my code should try to contact me via one of the following methods:
* Twitter - @ssc_kki
* IRC - irc.badnik.net #sm-ssc

Thank you for your time, and remember:
if you want to use any non-trivial code from this theme in your own theme, you
need to contact me first.

It would be a shame if I had to resort to dirtier tactics.

June 2012 License Addendum
__________________________
You may have noticed that some of the Lua files have a modified copy of the
theme license. This modified copy relates to the code being used in other
themes. It's more informative than the generic copyright claims that were
previously in place.

================================================================================
[7. Credits]

==Theme Coding==
AJ
NAKET Coder (Scripts/02 HSV.lua was originally from NAKET Coder Revolution X)

==Theme Graphics==
mostly AJ, with exceptions below.

==Theme Music==
Los Amigos Invisibles - Comodón Johnson (from The Venezuelan Zinga Son Vol.1)
Visit http://beta.amigosinvisibles.com/ and buy every album. Seriously.
This may be changed/removed in later versions. Save the files while you can.

==Theme Sounds==
Renard helped out a lot here.
Toasty sounds were ripped from various places.

==Background Images==
Tokyo Dome by Fg2.
Source: http://en.wikipedia.org/wiki/File:TokyoDome8946.jpg

"I took the photo and release all my rights in this file to the public domain."
This image is currently temporary. It may be changed/removed in later versions.
I have edited this image slightly. See if you can spot the reference to one of
my favorite video games. :)

==Typefaces==
(that is, any typefaces that aren't taken from the default theme via redirs)

* Blaster by dustBUST
* Frutiger by Adrian Frutiger

Sadly, I don't remember what the font I used for Japanese was. I will probably
go back and replace it with something from http://en.wikipedia.org/wiki/Free_software_Unicode_typefaces
when the need occurs.
================================================================================
[8. Thanks]
(I'm probably missing some people in this section, but that's typical.)

Midiman, shakesoda, Deluxe, luizsan, tweak
-========================================-
The other members of SSC hold it down like no other.
If only shake and Midi would release complete themes more often. :(

Seriously, I always enjoy working with these guys on everything.

D. Trucks
-=======-
The super musician who isn't afraid of hitting people with light tubes.

Renard
-====-
You are still badass. :)

Other StepMania Themers
Past, Present, and Future
-=======================-
The more people there are theming and taking it seriously, the better. :)

I'd like to give shout-outs to the following themers (in no particular order):
* NAKET Coder
* Lightning
* SFKhoa
* k//eternal
* Koizumi
* Katze
* Daisuke Master
* Skudd
* GRIM
* Takuya
* PROPELA
* Frieza
* Dreamwoods
* PatrickDDRX
* hanubeki
* waiei
* aaxreela
------------------------
Then there are those who have moved on to greater things:
* zhek
* Mig (SPiGuMuS)
* yanathin (BeMaNiRuler)
* Sestren NK
* djelyte
------------------------
And those who I'm not sure where they are:
* Tamagokun

The following communities
-=======================-
#noturkeyslams, Official SM Forums, BoXoRRoXoRs

all sm-ssc users
-==============-
For experiencing the future of StepMania before everyone else.

================================================================================
moonlight is Copyright ©2008-2012 AJ Kelly and the spinal shark collective.
Don't even try to pass off any part of this theme/the entire theme as your own.

ssc creates the future of stepmania <<< http://ssc.ajworld.net

p.s. spinal shark (creator of emit and SSC namesake) did not make this theme. kthx :)