DANCE WITH INTENSITY (OpenITG/NotITG Version) v1.6.8
Original Game © SimWolf, 2003 (Donation-Ware) / NotITG Version - Jose_Varela, 2017-2018 (Open Source)

1. USING AND CONFIGURING DWI
    
   • Basic Operation
   • User Profiles
   • Special Features
    
2. LIMITATIONS
3. VERSION HISTORY
4. FUTURE DEVELOPMENT AND THANKS

1. USING AND CONFIGURING DWI

BASIC OPERATION

When you first run DWI, please consider the following:

• If you changed to the theme via the Theme Switcher, YOU WILL GET A CRASH UPON EXITING THE PROFILE SCREEN. I haven't been able to find the reason why, but i can conclude that the problem is beyond my reach from the theme, as it is something with the engine itself.
• Upon entering the Profile screen for the first time, your game will likely freeze for around 4-5 seconds, depending on how many players joined. This is because of the initial write of the neccesary data for DWI Profiles to work. (This will also happen when entering Nonstop Mode.)

USER PROFILES

DWI(OITG/NITG 0.9) introduced 'user profiles' - a way that both players can play DWI on the same machine and keep their own individual records.

When you use a profile, DWI will create profile information in the Machine Profile to keep track of your individual achievements.

When you get a high score, it will be saved to your own profile's records ("New Personal Best"), and, if you beat the overall high score, it will also be saved to the system records ("It's a New Record!"), with your username registered with it.

Using a user-profile also lets you track some other statistics, such as overall high scores and combos for each mode.

If you wish to change the image and name of a profile, do the following:

   Dance With Intensity/Graphics/ProfileIcon/
   |  - userP1.png
   |  - userP2.png

   These two can be in different image formats that are supported in OITG. (PNG, JPG, GIF, BMP)
   THEY MUST BE RENAMED WITH THE SAME NAME (userP1/userP2) otherwise the game will crash/not load the images.

   Dance With Intensity/Scripts/Profile Information.lua
   

   local ProfileNames = {
   -- Profile Names that will appear in Select Music and the Options Menu
   -- If you change the names while the game is open, PLEASE DO F3+R TO RELOAD THE THEME.
   -- Otherwise, it won't update until you restart the game, or you do that.

   -- Player 1
   "Player 1",

   -- Player 2
   "Player 2",
}


   You can just edit the names that are in there, so they will load with another name instead.
   Here is an example of a Profile Setup completed.
   

   local ProfileNames = {
   -- Profile Names that will appear in Select Music and the Options Menu
   -- If you change the names while the game is open, PLEASE DO F3+R TO RELOAD THE THEME.
   -- Otherwise, it won't update until you restart the game, or you do that.

   -- Player 1
   "Jose_Varela",

   -- Player 2
   "Teknia",
}

SPECIAL FEATURES

Inside the DWI Settings, you will find special settings to adjust DWI to your preffered way.

• Announcer
  Enables or disables the announcer.
• Beat number display
  Shows a beat display during gameplay. This can be useful for timing stuff / reference on step placement.
• Receptor Placement
  Change the vertical placement of the playfield during gameplay. In DWI, is a little higher than ITG's original arrow placement, which is why this option was implemented.
• Score System
  Change the score that will be displayed during gameplay. It can be the number scoring of DWI, or the percentage scoring of ITG.
• Random Company Name
  Change the name of the company shown on the New Songs Screen. This feature will mostly likely be removed eventually.
• Demonstration
  Enable or disable the demonstration.
       (Starts after being idle for 60 seconds.)
• Score Type in Profile
  ( Suggested by LDani2000 )
  Change the score that will be shown at the profile screen. This being two choices, the highest score achieved on a single chart, or on a entire session.
• Summary Score in Select Music
  Show a small summary screen in Select Music that shows the Average and Total Score including on the player's Profile Icon. If disabled, the Option Icons will be shown instead.

2. LIMITATIONS

The theme will have some limitations to keep in mind, due to OITG's code not allowing it/ making it impossible.

• Profiles in OpenITG are really broken, so i had to make the profiles be managed by the Machine Profile instead.
• Scrolling on the profile menu is not existant, because it could only work in NotITG, because it has the StepPress Command.
• Records Menu cannot be recreated. It just simply can't. There's no available commands that can make it possible. So, the OITG's scrolling record listing should be enough.

3. VERSION HISTORY

Version 1.6.8 - System Mess-ups

| Added some GNU license stuff on some files.
   This is to comply with the regulations for the GNU General Public License.

| Code Cleanup again.

| Added Online checks if characters are used
| Recreated banner reloading animation
| Cleaning on Utilities file
| Fixed InitializeProfile()
| Removed ScreenStage files
   Because we don't even use that screen anymore.
| Background now applies to screen borders
| Exiting from Skin Selection reloads the whole theme
| Removed Combo coloring functions
| Cleaned up AudioPlay commands
| Removed Forced Beginner mods
| Disabled Bonus area in Nonstop Evaluation
| Remade CourseTimer commands for Nonstop Mode
| Fixed fade cutout from Song Finished
| Fixed Stage Labeling for Non-Event mode usage in Gameplay
| Fixed fade cutout from Gameplay
| Fixed fade cutout from Evaluation Stage
| Removed MaxCombo from Nonstop

Version 1.6.0 - Extra Goodies

   Ok, i lied a little bit about ending development.

| Online mode!
   To access, go to Options/Network Options and login to your favorite server!
   ( This feature does not work in NITG. That one has internet completely removed. Which is why you don't see the option when using NITG. )

| Improvements on Next Course Song fading
| Added functionalty for Banner loading in SMO Select Music
| More Code improvements.
   Thanks to Jousway for a ton of tips!

| Profile command for loading and saving now exists! ( Profile() & SaveProfiles() )
| Added complete Special thanks to the repo's README.
| Fixed a bug that crashed Gameplay due to the new code structure.
| Fixed a bug that prevented players from accesing the main menu when opening the game.
| Stats Info is now on a new location.
   And also is more exact to they way DWI showcases data, by only showing FPS info.

Version 1.5.0 - The Final Release

| EVERY SINGLE CODE HAS BEEN MODIFIED.
   To provide a more clean experience.
   
| IMPROVED SELECTMUSIC SCRIPT
   This took a fuckton of work, but i'm in love of what i've made. It's just so c l e a n 

| Finally fixed the combo label's position.
| Slightly changed the animation speed for the judgment.
   This is another attempt to try to match with the original game's animation.
   I think I nailed it this time.

| Added check for the Radar.
   This is here for a reason.
   Some machines have a weird bug with the Radar, that shows up as rotated squares rather than an actual pentagon.
   This is because of SmoothLines. It is required to be enabled in order to make the radar function correctly.
   If it's not on, then warn about it, so the player can re-enable it, if his/her machine supports it anyway.

| Fixed position of EXIT text on Player Options
| Random Pulling from Credits to Demo mode was fixed
   I really have no idea what caused it, but it's fixed now.

| Fixed Skin Selector Screen
   It switched the theme... but it stayed on the same screen. causing a "!() = ScreenName" panic attack.

| AutoGen icon is now functional.
| Recreated Music format from credits sequence
   Unfortunately, i cannot recreate the audio fade. Not even with the Dim command.

| Decided to match the speed of the BG's in the credits sequence to the credits text.
| Added silence when pressing start in the evaluation screen.
| Options Menu has been completely remade.
   New screens include: DWISystemOptions, DWISoundOptions, BackgroundOptions, DWISkinSelect

| System Options is now in the Options Menu (This one includes the Judgment Window Preview)
| Included a more exact Background Options to match the original game's screen.
| Replaced descriptions, names and labels from the original DWI to the theme.
| Fixed many OptionIcons in the Evaluation Screen that were wrongly being activated.
   The special case being the 5x mod, which activated whenever a 5x was found on the playermods string.
   (A.k.a 1.5x, 0.25x, 0.5x, 0.75x were hidden by the 5x.)
   
| Recreated the short time allowed to access settings.
   You'll have to quickly press the enter key twice to access the player options.
   DWI was really agressive with the Access options time.

| Editor Mode
   It is a little similar to SM's regular editor, with a few tweaks.
      - Information is now on the left, and help on the right.
      - Theme Build is displayed on the editor.
      - Score display is hidden when previewing a song.

   In order to access it, you need to press L,D,U,R on the title screen.

| ROULETTE Text now does a rainbow animation
| Fixed the Double "On" Command bug that ocurred on the Credits sequence.
| Added a Judgment Window Preview
   It detects the current timings that are on your Judge difficulty and shows it on a line.
| Difficulty can now be changed by pressing UP or DOWN once.
| Cleanup on DWICredits and EvaluationStage's Code.
| Animations on Menus are now more like DWI's static placement.
| Remade some animations to redirs because some were the same.
| Fixed Debug Text Tween.
   It crashes because it cannot look for a lua because the lua loads after the .INI gets loaded.
   And thus, the DebugTween command doesn't exist yet, causing the crash.
| The Random Company feature is now gone, as there's was no reason to have it in the first place.
   And also the fact that it was implemented simply as a joke.

And with this update, I can call this theme Feature-Complete. No more features need to be added.
Bug fixes will still be provided if bugs are found; Which I believe there shouldn't be any by this
point, as i checked every single little thing for this update to be the most stable update of them all.

But please, if you find any bugs, please let me know via the Repo's issue tracker.

Thanks for the ride, it's been fun. Stay cool.
- Jose_Varela


Version 1.4.5

| Repaired Underlay and Overlay for Battle Mode
| Remade Debug Text Tween
| Remade ScreenSelectMaster Commands
| Created Feature to Delete Profile Data
   This will delete Dance AND Nonstop Data.

Version 1.4.0

| Added Message on Profile Check if a Memory Card is detected.
| Changed Banner for Mode Selection in Music Wheel
| PlayerMods Reset was removed.
| Mode Select in Mode Wheel will only appear for 2 players.
| Battle mode in gameplay now functional.
| Created Evaluation screen for Battle Mode Results.
| Repaired the Sort Order font from Music Wheel.
| Replaced Mode Selection with Fallback Banner.

Version 1.3.89

| Added Battle Mode Icon
| Changed and added stuff to the utilities file.
| Added Fallback BG for areas that have nothing. (It's called dwi2-fallback.png)
| Evaluation system completely changed in favor of a more flexible system without having to make so many if statements.
| Changed position of Song Score a little bit as it was really close to the total score
| Remade Music Wheel Graphics to better fit 16:9 screens.
| Battle Mode can only be accessed if two human players are active.
   
   Also i started working on the editor, so stay tuned for that. :)

Version 1.3.5

| Fixed Overlapping of Characters with 3D Noteskins.
| Added Message on Profile Check if a Memory Card is detected.
| Fixed some cropping of the overlay in Gameplay.

Version 1.3.0

| Fixed Option Icons
| Moved Profile Info Quads to separate XML
| Removed Fake Bonus Frame information from Scores Evaluation Stage, as the actual bonus frame now works.
| Correctly Cropped parts of Gameplay so textures didn't overlap when zooming out of the screen.
| Managed to make Debug text display the Correct Font
| Deletion of Unecessary files
| Added Version Date 
| Added Character Support
   ( This feature will unfortunatelly not work in NotITG V3, but it will still work in NotITG V2, and OpenITG. )

Version 1.2.25

| Fix on the Marathon Label in MusicWheel

Version 1.2.2

| Added Notifier Icons to Music Wheel
| Added Functional Bonus Frame in Evaluation
| Code Opimizations
| Working BPM Label
| Added Correct LyricDisplay font

Version 1.1.0

| Added Highest Total Sesion Score to ScreenProfileCheck
| Fixed Music Wheel In Nonstop Mode
| Removed Messy "Ready" Code in Gameplay
| Changed Grade Ratings and Fixed AAA Check
| Created IsUsingWideScreen()
| Created Newer Instructions for prople who want to get into theming
| Replaced PREFSMAN Commands regarding Resolution to use IsUsingWideScreen()
| Remade Song Wheel
| Recreated BPM Display
| Recreated OptionRowIcons


Version 1.0.0

( First Public Release )
| Added Support for OpenITG
| Remade Menu Timer for Music Wheel

Version 0.9.9 | Pre-Release

( Final Pre-Release Update )
| Fixes in Profile Check and Metrics.ini
| Added SongNamePosition()

Version 0.9.55 | Pre-Release

| Removed Test Elements from Theme for Public First Relase

Version 0.9.5 | Pre-Release

| Completed Profile Support
| Completed Nonstop Mode
| Created Save Function to Profile
| Audio Fixes

Version 0.8.2

| Fixed in Noteskins
| Added TopCap to DWIDance to ensure Compatibility

Version 0.7.0

| Fixes in Solo Receptors
| Added Song Info for Stepfiles Without Banners

Version 0.6.95

| Completed (?) Solo Support to DWIDance, DWIClassic, DWISolo and Theme

Version 0.6.9

| Remade Score Handler System from the ground up

Version 0.6.85

| Updated Metrics.ini to repair more things.

Version 0.6.8

| Changed TitleMusicRedirect()'s Script

Version 0.6.75

| Added DWIDance
| Added Solo Support to Noteskins
| Added Solo support to Theme

Version 0.6.7

| Added DWIClassic and DWISolo Noteskins

Version 0.6.65

| Added color graphics from DWI
| Hold Judgment doesn't rotate anymore
| Height of Scroll bar in Select Music fixed

Version 0.6.6

| Added Danger Graphic

Version 0.6.55

| Created Functions to help code organization
   | ▼ StageNumberAdded()
   | ▼ StageNumber()
   | ▼ AnnouncerAudio()
   | ▼ DangerSize()


Version 0.6.5

| Massive Code And Lua Optimization
   | ▼ Evaluation
   | ▼ Gameplay
   | ▼ OptionsMenu
   | ▼ SelectMusic

| Created Low Health animations

Version 0.6.45

| Enhanced Load time and Bar in DWIIntro

Version 0.6.4

| Fixed P2 Only Crash in Normal Evaluation

Version 0.6.35

| Improved Load Screen
| Fixed Difficulty Icons

Version 0.6.3

| Recreated Fade Animation in Credits Text

Version 0.6.25

| Changed Position on Combo
| Applied HurryTweening to Difficulty Tick system to avoid Message Overflow
| Added Mod Text as a Text Layer, hiding the Engine Controled Layer.

Version 0.6.2

| Added function for SOUND ( AudioPlay() )
| Massive Code Optimization on these files:
   | ▼ Metrics.ini
   | ▼ ScreenTitleMenu
   | ▼ ScreenSummarySingle
   | ▼ ScreenSummaryDouble
   | ▼ ScreenSelectStyle
   | ▼ ScreenSelectStyleNonstop
   | ▼ ScreenSelectMusic
   | ▼ ScreenRecords
   | ▼ ScreenNewSongs
   | ▼ ScreenGameplay
   | ▼ ScreenEvaluationSummary
   | ▼ ScreenDWIIntro
   | ▼ ScreenDWICredits
   | ▼ OptionIcons

Version 0.6.0

| Cleaned Utilities for Public Beta release

Version 0.5.0

| Added Tween Animations for Gameplay Elements:
   | ▼ Combo ( ComboTween() )
   | ▼ Judgment ( JudgmentTween() )
   | ▼ Hold Result ( HoldTween() )

Version 0.4.0

| Readded Extra Commands in Utilities:
   | ▼ DWIToggleDemonstration()
   | ▼ DWI_StrSplit()

Version 0.3.0

| Fixed and added new things on:
   | ▼ ScreenDWICredits
      | Implemented BG's that show in the credits sequence

   | ▼ ScreenDWIIntro
      | Added Working progress bar for the BootUp Animation Sequence

   | ▼ ScreenEvaluationStage
      | Added Stage Number
      | Added Profile Name to Profile Images
      | Added Percentage Scoring to results

   | ▼ ScreenNewSongs
      | Implemented the RandomCompanyName Script

   | ▼ ScreenSelectMusic
      | Changed positioning of Percentage score when the other player isn't enabled.

Version 0.2.5

| Added Missing Graphic on BootUp Loading Screen

Version 0.2.0

| Completed Credits Screen
| Created Loading Screen for Bootup
| Created Toggle for Demonstration

Version 0.1.0

| Code Optimizations on:
   | ▼ ScreenDWICredits background
   | ▼ ScreenEvaluationStage background
   | ▼ ScreenOptions background

Version 0.0.57

| Fixed Profile Names, came with the ones from testing.

Version 0.0.56

| Added Difficulty Icons in Player Options. (Now Deprecated)

Version 0.0.55 

| Created Profile Support
| Fixed Percentage Overflow in Select Music

Version 0.0.5

| Added GitHub Banner

Version 0.0.5

| Added Main files from the theme for Beta Testing

4. FUTURE DEVELOPMENT AND THANKS

So, about future development... I'm defintly going to continue to develop this theme, to try to add new features and improve code constantly. It kinda has become a little gag in the UKSRT community at this point.

I would like to thank the following people for helping me, assisting, pointing out bugs, and fixing stuff that i just didn't knew how it worked.

• TaroNuke - Help with the PlayerMod String.

  Thanks to him, i was able to make the PlayerMods string be a Text Layer controled by the Overlay, and not by the engine, allowing it to be hidden by just doing SCREENMAN:GetTopScreen():GetChild('Overlay'):hidden(1) for Mod songs.

• CosmicLAER - Suggestions with the Narrator

  She suggested some useful stuff for the narrator feature in DWI, so i added a feature to Actually disable the narrator if it becomes annoying.
  In the original DWI, there was a option to "Disable" the announcer, but it didn't disable all of it.

• LDanii2000 - Help with the DWI Noteskins

  Thanks to him, for pointing it out, (and even fixing it for me without telling me), he fixed a little error with DWIDance that prevented Solo play, which was something with the holds.

• Sora - Help with Lua commands

  Also to him, THANK YOU SO MUCH for making the OITG/NITG Lua API page. I pretty much use it all the time when making all kinds of stuff for OpenITG/NotITG.

• BrotherMojo - Help with Lua commands

  He helped with the WideScreen command. Pretty much also starting the "we don't need floors" gag from the same lua function.

• MadkaT - Help with 16:9 Textures, Lua Optimizations

  He helped me with this theme, since the very beginning, and also when i released the first public beta. Without him, I wouldn't have known some commands, and some of the 16:9 textures, as he was making a SM5 version of the theme at the same time as i did!

• HowTo Step?, Kirby5464 and Crazybozo7 for testing the theme and pointing out bugs.

Enjoy, and thanks for playin'. Stay cool.
- Jose_Varela.