Skip to content

Commit 3b21129

Browse files
author
arch
committed
update ofs docs #5
1 parent b9a5e39 commit 3b21129

File tree

4 files changed

+15
-13
lines changed

4 files changed

+15
-13
lines changed
29.8 KB
Loading
46.5 KB
Loading

docs/app/docs/user-guide/ofs-integration.md

Lines changed: 12 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -4,26 +4,29 @@ We use a lua script to communicate between the Python Funscript Generator and th
44

55
## Installation (Windows)
66

7-
1. Download the **latest** packed Python Funscript Editor from [github release page](https://github.com/michael-mueller-git/Python-Funscript-Editor/releases).
7+
1. Download and install [Open Funscripter](https://github.com/OpenFunscripter/OFS/releases). Please memorize the specified installation path, you will need it later.
8+
<br> ![OFS installation Step 1](./images/ofs_installation_01.jpg)
9+
<br> ![OFS installation Step 2](./images/ofs_installation_02.jpg)
10+
2. Download the **latest** packed Python Funscript Editor from [github release page](https://github.com/michael-mueller-git/Python-Funscript-Editor/releases).
811
<br> ![Funscript Editor Windows Release](./images/ofs_integration_01.jpg)
9-
2. Extract the Archiv.
12+
3. Extract the Archiv.
1013
<br> ![Extract Python Funscript Editor Windows Release](./images/ofs_integration_02.jpg)
11-
3. Download the **latest** `funscript_generator.lua` script from [github release page](https://github.com/michael-mueller-git/Python-Funscript-Editor/releases).
14+
4. Download the **latest** `funscript_generator.lua` script from [github release page](https://github.com/michael-mueller-git/Python-Funscript-Editor/releases).
1215
<br> ![OFS integration Windows Release](./images/ofs_integration_03.jpg)
13-
4. Move the downloaded `funscript_generator.lua` script to `data/lua` in your OFS directory.
16+
5. Move the downloaded `funscript_generator.lua` script to `data/lua` in your OFS directory. The default OFS install path is `C:\Program Files\OpenFunscripter`.
1417
<br> ![Copy the OFS integration script to the lua folder](./images/ofs_integration_04.jpg)
15-
5. Open the `funscript_generator.lua` file and adjust the `Settings.FunscriptGenerator` and `Settings.TmpFile` variable.
18+
6. Open the `funscript_generator.lua` file and adjust the `Settings.FunscriptGenerator` and `Settings.TmpFile` variable.
1619
<br> - **NOTE:** If you copy the path from Windows explorer to the variable in the lua script you have to escape the `\` symbol. This mean you have to put another `\` in front of each `\` so that there are always `\\` pairs. As an alternative, you can use a simple `/` instead of the single `\` Symbole that also work.
1720
<br> - `Settings.FunscriptGenerator`: Point to the extracted Python Funscript Editor program (better double check the complete path string to avoid errors later on).
1821
<br> - `Settings.TmpFile`: Specifies a temporary file location where to store the result (must be a file not a directory!). The file does not have to exist at the moment. The specified file will be generated from the Python Funscript Editor and will be overwritten automatically at the next time the generator is started!
1922
<br> ![Adjust Settings/Variables in the lua Script](./images/ofs_integration_05.jpg)
20-
6. Now launch OFS.
23+
7. Now launch OFS.
2124
<br> ![Start OFS](./images/ofs_integration_06.jpg)
22-
7. Navigate to `View : Special functions : Custom Functions` and select the `funscript_generator.lua` entry. Click on the `funscript_generator.lua` entry to get more options for the script (This may trigger the funscript generator, just ignore it for now). Finally click the now visible Button `Bind Script`.
25+
8. Navigate to `View : Special functions : Custom Functions` and select the `funscript_generator.lua` entry. Click on the `funscript_generator.lua` entry to get more options for the script (This may trigger the funscript generator, just ignore it for now). Finally click the now visible Button `Bind Script`.
2326
<br> ![Enable OFS Integration](./images/ofs_integration_07.jpg)
24-
8. Navigate to `Options : Keys : Dynamic` and insert a shortcut for the funscript generator.
27+
9. Navigate to `Options : Keys : Dynamic` and insert a shortcut for the funscript generator.
2528
<br> ![Assign an Shortcut](./images/ofs_integration_08.jpg)
26-
9. Now you can use the shortcut at any position in the video to start the funscript generator.
29+
10. Now you can use the shortcut at any position in the video to start the funscript generator.
2730

2831
## Troubleshot
2932

funscript_editor/algorithms/funscriptgenerator.py

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -30,8 +30,7 @@
3030
@dataclass
3131
class FunscriptGeneratorParameter:
3232
""" Funscript Generator Parameter Dataclass with default values """
33-
# No default values
34-
video_path: str # no default value
33+
video_path: str
3534
track_men: bool
3635
metric: str
3736
projection: str
@@ -49,15 +48,15 @@ class FunscriptGeneratorParameter:
4948
# General
5049
skip_frames: int = max((0, int(HYPERPARAMETER['skip_frames'])))
5150

52-
# y VR Movement
51+
# VR Movement in y Direction
5352
shift_bottom_points: int = int(HYPERPARAMETER['shift_bottom_points'])
5453
shift_top_points: int = int(HYPERPARAMETER['shift_top_points'])
5554
bottom_points_offset: float = float(HYPERPARAMETER['bottom_points_offset'])
5655
top_points_offset: float = float(HYPERPARAMETER['top_points_offset'])
5756
bottom_threshold: float = float(HYPERPARAMETER['bottom_threshold'])
5857
top_threshold: float = float(HYPERPARAMETER['top_threshold'])
5958

60-
# x-Movement
59+
# All other predicted Movements
6160
shift_min_points: int = int(HYPERPARAMETER['shift_min_points'])
6261
shift_max_points: int = int(HYPERPARAMETER['shift_max_points'])
6362
min_points_offset: float = float(HYPERPARAMETER['min_points_offset'])

0 commit comments

Comments
 (0)