From eb2af8f16918b7b093df7383064a99beb99f7b9e Mon Sep 17 00:00:00 2001 From: AJ Kelly Date: Tue, 23 Mar 2010 03:17:06 -0500 Subject: [PATCH] more theming documentation updates --- .../Noteskin elements Reference.txt | 9 ++++++- Docs/Themerdocs/recommended_practices.txt | 24 ++++++++++++++++++- 2 files changed, 31 insertions(+), 2 deletions(-) diff --git a/Docs/Themerdocs/Noteskin elements Reference.txt b/Docs/Themerdocs/Noteskin elements Reference.txt index 2a80617d5b..519104a5c5 100644 --- a/Docs/Themerdocs/Noteskin elements Reference.txt +++ b/Docs/Themerdocs/Noteskin elements Reference.txt @@ -64,7 +64,7 @@ HandLrRight Left UpLeft Up -UpRigh +UpRight Right --ds3ddx-- @@ -88,4 +88,11 @@ Scratch down --popn-- +--guitar-- (not enabled yet) +Fret1 +Fret2 +Fret3 +Fret4 +Fret5 + --lights (rofl)-- \ No newline at end of file diff --git a/Docs/Themerdocs/recommended_practices.txt b/Docs/Themerdocs/recommended_practices.txt index b67083f836..9a062184e8 100644 --- a/Docs/Themerdocs/recommended_practices.txt +++ b/Docs/Themerdocs/recommended_practices.txt @@ -4,4 +4,26 @@ Recommended Practices when theming for sm-ssc This way, you don't have to deal with the theme switch and all the possible nonsense errors that might come up (due to you having a different amount of song group colors, timer warning states, etc.), and you can quickly switch -themes if you work on many of them at once. \ No newline at end of file +themes if you work on many of them at once. + +2) If you want to create a theme that targets both regular StepMania 4 and +sm-ssc, there are a few precautions to take care of. + +2a) First, decide if you want to develop it on sm-ssc first or SM4 first. It is +usually easier to deal with making the theme in normal SM4 and using _portKit-SM4 +to get the theme running up in sm-ssc. + +If you do decide to make the theme for sm-ssc first, be prepared to fill in a lot +of files that sm-ssc _fallback makes empty for you, as the metrics, graphics, and +BGAnimations from SM4's default theme will be loaded instead of sm-ssc's _fallback. + +2b) sm-ssc's _fallback theme defines a variable, SSC, like so: +[code]SSC = (ProductID() == "sm-ssc");[/code] +This will return true if it's sm-ssc, or false if it's SM4. +You should define this in a file in your theme, so that SM4 will be able to +recognize it. + +With this "SSC guard" in place, you can now wrap things in "if SSC then" +statements if they won't work on SM4. You can also provide alternatives if the +player isn't using sm-ssc, since sometimes SM4 will have an approximation or +alternate way to get the data. \ No newline at end of file