Skip to content

Commit ae3ef39

Browse files
committed
v0.7.0 readme updates
1 parent c7b52fa commit ae3ef39

File tree

3 files changed

+10
-8
lines changed

3 files changed

+10
-8
lines changed

README.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -37,10 +37,10 @@ You have a couple options:
3737
- Download the executable (made with PyInstaller).
3838

3939
### Command-line interface (CLI)
40-
It's not as configurable as the GUI yet but that's coming soon. For now you can just call the main routine of the `nine_or_null` package, and pass it the full path to the pack as a command-line argument. If you call it without a path, it'll invoke the GUI.
40+
It's not as configurable as the GUI yet but that's coming soon. For now you can just call the main routine of the `nine_or_null` package, and pass it the full path to the pack as a command-line argument. If you call it without a path, it'll invoke the GUI. (Use `-h` for more info about what options are available.)
4141

4242
### Graphical user interface (GUI)
43-
![Screenshot of +9ms or Null v0.2.0](doc/nine-or-null-v0.2.0.png)
43+
![Screenshot of +9ms or Null v0.7.0](doc/nine-or-null-v0.7.0.png)
4444

4545
The intended workflow:
4646
1. Select the path to the pack or simfile you want to check using the directory button in the upper-right corner (or manually enter in the text box next to it).
@@ -50,15 +50,17 @@ The intended workflow:
5050
1. Watch the status bar, results table, and sync fingerprint plots for updates.
5151
- From top to bottom, the plots represent the frequency domain accumulator, the beat digest, and the convolved fingerprint.
5252
- The red line indicates where the maximum kernel response lies, and thus the sync bias of this simfile. The white line is the kernel response for the whole fingerprint vs. local time.
53-
1. Once the status bar indicates the job is "Done!", the number of paradigm-adherent simfiles will appear above the results table.
54-
1. Feel free to "View logs", "View plots", or double-click on individual simfiles in the results table to reload plots in the neighboring pane.
55-
1. In the future, the two arrows above the paradigm counts will allow you to batch adjust the sync bias on simfiles (either from +9ms to null, or vice versa). ***Again, not a millisecond-accurate sync utility! It's only offering to add or subtract 9ms.***
53+
- If split timing is discovered, the "slot" column in the table will also have a value, indicating whether the entry represents the base simfile (*) or a specific chart (SX, CSP, etc.).
54+
1. Once the status bar indicates the job is "Done!", the number of paradigm-adherent simfiles or charts will appear above the results table.
55+
1. Feel free to "View logs", "View plots", or double-click on individual entries in the results table to reload plots in the neighboring pane.
56+
1. Use the two arrows above the paradigm counts to batch adjust the sync bias on simfiles or charts (either from +9ms to null, or vice versa). ***Again, not a millisecond-accurate sync utility! It's only offering to add or subtract 9ms.***
57+
- If you don't want to adjust *all* the matching charts, you can (multi-)select rows in the results table while in GUI mode, and the bias adjustment will only apply to the subset of those that aren't already sync'd to the desired paradigm.
5658

5759
(If your computer starts really chugging during the bias check, bump the "Spectral step" up or the "Spectral window" down - both of these sacrifice a bit of spectrogram precision but the results are still generally good.)
5860

5961
## Future plans
60-
- Batch adjust the sync bias on simfiles (either from +9ms to null, or vice versa)
61-
- Handle split timing properly when it's present
62+
- Code cleanup
63+
- Performance optimization (need to move to MVC model :weary:)
6264
- If a straight vertical line "fit" can identify bias, then a line fit with both local time and beat index dependence could also identify sync drift...hmm...
6365

6466

doc/nine-or-null-v0.7.0.png

163 KB
Loading

nine-or-null/nine_or_null/gui.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ def __init__(self, *args, **kwargs):
2626
label_preceding = wx.StaticText(self,
2727
label=re.sub('\n[ \t]+', '\n', """+9ms or Null? is a StepMania simfile unbiasing utility.
2828
29-
This utility can determine whether the sync bias of a simfile or a pack is +9ms (In The Groove) or null (general StepMania). A future version will also offer to unify it under one of those two options.
29+
This utility can determine whether the sync bias of a simfile or a pack is +9ms (In The Groove) or null (general StepMania), and offers to unify it under one of those two options.
3030
It is not meant to perform a millisecond-perfect sync!
3131
3232
You can read more about the origins of the +9ms sync bias here:"""),

0 commit comments

Comments
 (0)