Paths, Caches & Options
Main paths
In order to simplify resource fetching and relative paths, multiple paths must be carefully set, either via CLI or in the main if needed:
std::string ProjectPath
path from the executable to the current project folder, must be set via CLI:
std::string ProjectDataPath
path prefix for where to fetch data, by default equal to ProjectPath. When loading external data, if the given path is relative it will take this as a referential.
std::string CachePath
Where to store stuff that is generated by slope, like latex images or GIF decomposition. By default in the build file.
std::string ProjectViewsPath
Where to store the persistent quantities like persistant positions or camera views. By default will create a views folder in the ProjectPath (so that it is preserved in a git for instance).
Some other important variables can be set in the main file
Paths to dependencies
The path to the pdflatex, convert and ffmpeg tools are automatically fetched by cmake but you can change them if needed:
std::string PathToPDFLATEX
std::string PathToCONVERT
std::string PathToFFMPEG
Only used by the Video and Webcam primitives. A bare
name is resolved through PATH, so a tool installed after cmake ran is
still found.
std::string PathToFFPROBE
Reads a clip's size, frame rate and duration before playing it.
Screen resolution
All coordinates in slope are expressed in a relative manner wrt to screen size, in order to match your resolution, you can specify it by CLI, or set it via global variables:
size_t ScreenResolutionWidth
size_t ScreenResolutionHeight
Command line
| Flag | Effect |
|---|---|
--project_path <dir> |
the project folder, required |
--data_path <dir> |
where data is fetched from, the project path by default |
--resolution WxH |
window size, 1920x1080 by default |
--export |
render the deck to a PDF and quit, see exporting |
--export_transitions <n> |
the same, sampling n stills through each slide change |
--record |
render the deck to an mp4 and quit, see recording |
--fps <n> |
frame rate of a recording, 30 by default |
--record_dwell <s> |
seconds a settled slide is held while recording, 2 by default |
--check_labels |
report unused, duplicated and defaulted anchor labels at startup |
--rehearse |
start with rehearsal timings on |
--no_slide_numbers |
hide the slide counter |
--auto-suggest |
copy at: <free label> to the clipboard every time the deck is saved, see naming a new item |
--clear_cache |
empty the latex and GIF caches before starting |
--ignore_cache |
rebuild everything without emptying it |
--seed <n> |
fix the random seed |