5/17/2023 0 Comments Renoise commands![]() ![]() If not specified, the default value is the %ComSpec% environment variable (normally cmd.exe) with the parameters "/U" for Unicode pipe output and "/C" to close the Command Prompt window and exit the cmd.exe shell when finished. Options General measure optionsĪll general measure options are valid. These can be used to take different skin actions depending on the numeric return value. If the program finishes without error, the number value of the measure will be 1, meaning "success". If an error occurs, the number value of the measure will indicate the type of error that has occurred. While the command is running, the number value of the measure will be 0. ![]() Before the command has first run, the number value of the measure will be -1. You can get the number value of the measure by using Section Variables (e.g. The number value of the measure will indicate if the command finished with or without any errors. In effect, what you would see if you manually ran the command in a cmd.exe Command Prompt window will become the string value of the measure. The string value of the measure will be any output that the program writes to STDOUT. ![]() The plugin will monitor the program defined in the Program option, and when it ends, when the executable terminates, any string output the program did to STDOUT (Standard Out) will be captured and set as the string value of the plugin measure. Command-line programs by their nature always run in a cmd.exe Command Prompt window. In most cases, the purpose of the plugin is to execute a Command Line Interface (CLI) program that takes some action or returns some value. What the plugin does when triggered with is to execute what is defined in the measure's Program option, appending any program parameters defined in the Parameter option. The plugin can be set with a "timeout" value, which will automatically end the external command or program when the timeout value is reached.The plugin can detect that a command caused a set of "error" return codes, and the skin can take some action based on success or failure of the command and the type of error.The plugin can detect that a command is "finished", and your skin can in effect wait for the command to be done before taking some action and using any returned value.Any output of the command to STDOUT (the "Standard Out" string output of a program in a cmd.exe Command Prompt window) can be captured, either directly, as the the value of the plugin measure, or piped to a text file for additional processing as needed.The command can be run with a hidden initial state, to eliminate the cmd.exe (DOS) Command Prompt window that is created when an external command-line command or program is executed normally from Rainmeter.There are several important differences between this and just executing a command with something like: Executes an external command or program in Windows, allowing the skin to obtain and use any output from the program. ![]()
0 Comments
Leave a Reply. |