Scripting - Chapter 11: List of Functions
Contents
- 1 Legend of colour for the arguments
- 2 Start and stop the graphical interface
- 3 PlayOnLinux graphical interface
- 3.1 POL_SetupWindow_presentation
- 3.2 POL_SetupWindow_free_presentation
- 3.3 POL_SetupWindow_message
- 3.4 check_one - POL_SetupWindow_missing
- 3.5 POL_SetupWindow_file
- 3.6 POL_SetupWindow_licence
- 3.7 POL_SetupWindow_pulsebar - POL_SetupWindow_pulse - POL_SetupWindow_set_text
- 3.8 POL_SetupWindow_wait
- 3.9 POL_SetupWindow_textbox
- 3.10 POL_SetupWindow_textbox_multiline
- 3.11 POL_SetupWindow_browse
- 3.12 POL_SetupWindow_question
- 3.13 POL_SetupWindow_menu
- 3.14 POL_SetupWindow_menu_num
- 3.15 POL_SetupWindow_menu_list
- 3.16 POL_SetupWindow_checkbox_list
- 3.17 POL_SetupWindow_cdrom
- 3.18 POL_SetupWindow_check_cdrom
- 3.19 POL_SetupWindow_InstallMethod
- 4 POL_RequiredVersion (4.0.15+)
- 5 POL_Shortcut
- 6 POL_Shortcut_InsertBeforeWine
- 7 POL_Shortcut_Document
- 8 POL_Browser
- 9 POL_Download
- 10 POL_Download_Resource
- 11 POL_System_TmpCreate
- 12 POL_System_TmpDelete
- 13 POL_System_SetArch
- 14 POL_Call
- 15 Wine-related functions
- 15.1 POL_Wine_SelectPrefix
- 15.2 POL_Wine_PrefixExists
- 15.3 POL_Wine_PrefixCreate
- 15.4 POL_Wine
- 15.5 POL_SetupWindow_VMS
- 15.6 Set_OS
- 15.7 Set_Managed
- 15.8 Set_SoundDriver
- 15.9 POL_Wine_Direct3D
- 15.10 POL_Wine_X11Drv
- 15.11 POL_Wine_DirectSound
- 15.12 POL_Wine_DirectInput
- 15.13 POL_Wine_GetRegValue
- 15.14 Set_Desktop
- 15.15 Set_WineWindowTitle
- 15.16 POL_Wine_InstallFonts
- 15.17 POL_Wine_SetVideoDriver
- 15.18 POL_Wine_OverrideDLL
- 15.19 POL_Wine_OverrideDLL_App
- 15.20 POL_Wine_WaitBefore
- 15.21 POL_Wine_WaitExit
- 15.22 POL_Wine_reboot
- 16 Debugging commands
Legend of colour for the arguments
- Colours not currently showing up right now. They will be added soon.
Red: Required argument.
Orange : Required argument if further arguments are present, but can be left empty ("").
Blue : Optional argument, but in some cases required.
Green : Optional argument.
Start and stop the graphical interface
POL_GetSetupImages
Arguments:
- URL of top image.
- URL of left image.
- Name of the directory where to store the images (often $TITLE).
Description:
Download top and left images of the script from the PlayOnLinux site.
Prerequisite:
Must be used before POL_SetupWindow_Init.
Example:
POL_GetSetupImages "http://files.playonlinux.com/resources/setups/AC2/top.jpg" "http://files.playonlinux.com/resources/setups/AC2/left.jpg" "$TITLE"
POL_SetupWindow_Init
Description:
Opens the installation wizard window.
Example:
POL_SetupWindow_Init
POL_SetupWindow_Close
Description:
Closes the installation wizard window.
Example:
POL_SetupWindow_Close
PlayOnLinux graphical interface
POL_SetupWindow_presentation
Arguments:
- Software name (often $TITLE).
- Software publisher.
- Site of the publisher.
- Script author.
- Prefix name (usually $PREFIX).
Description:
Present the software.
Example:
POL_SetupWindow_presentation "$TITLE" "Mozilla" "http://www.mozilla.com" "SuperPlumus and NSLW" "$PREFIX"
POL_SetupWindow_free_presentation
Arguments:
- Software name (often $TITLE).
- Message.
Description:
Present the software with more freedom than POL_SetupWindow_presentation.
Example:
POL_SetupWindow_free_presentation "$TITLE" "Welcome to Mozilla Firefox installation wizard."
POL_SetupWindow_message
Arguments:
- Message.
- Title (often $TITLE).
Description:
Display a message.
Example:
POL_SetupWindow_message "Hello world!" "$TITLE"
check_one - POL_SetupWindow_missing
Arguments for check_one:
- Program that must be present.
- Package that contains this program.
Description:
Check the availability of one or more programs required by the script.
Call check_one as many times as needed (once per program), then use POL_SetupWindow_missing.
Example:
check_one "p7zip" "p7zip" POL_SetupWindow_missing
POL_SetupWindow_file
Arguments:
- Message.
- Title (often $TITLE).
- File to display.
Description:
Display the content of a file.
Example:
POL_SetupWindow_file "Changelog" "$TITLE" "$POL_System_TmpDir/changelog.txt"
POL_SetupWindow_licence
Arguments:
- Message.
- Title (often $TITLE).
- File to display.
Description:
Similar to the command POL_SetupWindow_file, but adds an "I agree" checkbox.
Useful for displaying licenses.
Example:
POL_SetupWindow_licence "Licence:" "$TITLE" "$POL_System_TmpDir/licence.txt"
POL_SetupWindow_pulsebar - POL_SetupWindow_pulse - POL_SetupWindow_set_text
Arguments for POL_SetupWindow_pulsebar:
- Message.
- Title (often $TITLE).
Arguments for POL_SetupWindow_pulse:
- Percentage.
Arguments for POL_SetupWindow_set_text:
- Current text.
Description:
Display a progression bar, from 0 to 100%.
POL_SetupWindow_pulsebar display the progression bar.
POL_SetupWindow_pulse changes the progression value, from 0 to 100%.
POL_SetupWindow_set_text modifies the current message (different from POL_SetupWindow_pulsebar message).
Useful for displaying licenses.
Example:
POL_SetupWindow_pulsebar "Installing patchs 1 to 5." "$TITLE" POL_SetupWindow_set_text "Installation of patch 1 in progress" POL_Wine "$POL_System_TmpDir/patch1.exe" POL_SetupWindow_pulse "20" # meaning 20% POL_SetupWindow_set_text "Installation of patch 2 in progress" POL_Wine "$POL_System_TmpDir/patch2.exe" POL_SetupWindow_pulse "40" POL_SetupWindow_set_text "Installation of patch 3 in progress" POL_Wine "$POL_System_TmpDir/patch3.exe" POL_SetupWindow_pulse "60" POL_SetupWindow_set_text "Installation of patch 4 in progress" POL_Wine "$POL_System_TmpDir/patch4.exe" POL_SetupWindow_pulse "80" POL_SetupWindow_set_text "Installation of patch 5 in progress" POL_Wine "$POL_System_TmpDir/patch5.exe" POL_SetupWindow_pulse "100"
POL_SetupWindow_wait
Arguments:
- Message.
- Title (often $TITLE).
Description:
Display an indeterminate progress bar.
Example:
POL_SetupWindow_wait "Please wait" "$TITLE"
POL_SetupWindow_textbox
Arguments:
- Message.
- Title (often $TITLE).
- Default value.
Description:
Display some window asking the user to type in something.
Return:
What the user typed is returned in the $APP_ANSWER variable.
Example:
POL_SetupWindow_textbox "Votre pseudo :" "$TITLE"
POL_SetupWindow_textbox_multiline
Arguments:
- Message.
- Title (often $TITLE).
- Default value.
Description:
Similar to POL_SetupWindow_textbox, but typing happens on several lines.
Return:
What the user typed is returned in the $APP_ANSWER variable.
Example:
POL_SetupWindow_textbox_multiline "Enter a description for the program" "$TITLE"
POL_SetupWindow_browse
Arguments:
- Message.
- Title (often $TITLE).
- Default value.
Description:
Ask the user to select a file.
Return:
The path of the file selected by the user is returned in the $APP_ANSWER variable.
Example:
POL_SetupWindow_browse "Please select the program." "$TITLE"
POL_SetupWindow_question
Arguments:
- Message.
- Title (often $TITLE).
Description:
Ask a question to the user (that can be answered by Yes or No).
Return:
Answer is returned in the $APP_ANSWER variable (TRUE for Yes, FALSE for No).
Example:
POL_SetupWindow_question "Message" "Title"
Arguments:
- Message.
- Title (often $TITLE).
- Available choices.
- Separator character (often ~ or -).
Description:
Display a menu to the user, asking him to select one entry among the choices provided.
Return:
The choice selected by the user is returned in the $APP_ANSWER variable.
Example:
POL_SetupWindow_menu "What's your favorite color?" "$TITLE" "Red~Green~Blue" "~"
Arguments:
- Message.
- Title (often $TITLE).
- Available choices.
- Separator character (often ~ or -).
Description:
Similar to the command POL_SetupWindow_menu except that instead of returning the name of the selected choice (Red for example), it returns the position of the selected choice in the list, as a number (0 being the 1st choice).
Return:
The choice selected by the user is returned in the $APP_ANSWER variable.
Example:
POL_SetupWindow_menu_num "What's your favorite color?" "$TITLE" "Red~Green~Blue" "~"
$APP_ANSWER will contain 0 if the user selected Red, 1 for Green, or 2 for Blue.
Arguments:
- Message.
- Title (often $TITLE).
- Available choices.
- Separator character (often ~ or -).
- Default choice.
Description:
Similar to the command POL_SetupWindow_menu but displays a drop-down list.
Return:
The choice selected by the user is returned in the $APP_ANSWER variable.
Example:
POL_SetupWindow_menu_list "What's your favorite color?" "$TITLE" "Red~Green~Blue" "~"
POL_SetupWindow_checkbox_list
Arguments:
- Message.
- Title (often $TITLE).
- Available choices.
- Separator character (often ~ or -).
Description:
Show a list of options and checkboxen to the user, asking him to select the option(s) he wants.
Return:
The option(s) selected by the user are returned in the $APP_ANSWER variable.
Example:
POL_SetupWindow_checkbox_list "What are your favorite colors?" "$TITLE" "Red~Green~Blue" "~" if [ "$(echo $APP_ANSWER | grep -o "Red")" != "" ] then # Red was selected fi if [ "$(echo $APP_ANSWER | grep -o "Green")" != "" ] then # Green was selected fi if [ "$(echo $APP_ANSWER | grep -o "Blue")" != "" ] then # Blue was selected fi
POL_SetupWindow_cdrom
Description:
Ask the user to select a loaded CD/DVD.
Return:
The path to the drive selected by the user is returned in the $CDROM variable.
Example:
POL_SetupWindow_cdrom
POL_SetupWindow_check_cdrom
Arguments:
- 1, 2, etc. List of files that should be present.
Description:
Check, in order, if the files specified exist on the CD/DVD. If one is found, $CDROM_SETUP is set to the file path, and the script continues;
Otherwise, execute POL_SetupWindow_cdrom again.
Return:
Should be used right after POL_SetupWindow_cdrom.
Example:
POL_SetupWindow_check_cdrom "Data/32_icon.ico"
POL_SetupWindow_InstallMethod
Arguments:
- Comma separated list of installation methods available.
Description:
Ask the user want installation method he wants, among the available choices.
Available installation methods:
LOCAL, CD, DVD, DOWNLOAD, STEAM, STEAM_DEMO.
Return:
The choice selected by the user is returned in the $INSTALL_METHOD variable.
Example:
POL_SetupWindow_InstallMethod "LOCAL,CD,STEAM"
POL_RequiredVersion (4.0.15+)
Arguments:
- Minimum version.
Description:
Checks that the user is running a version of PlayOnLinux/PlayOnMac that is at least equal to the version provided as argument; If not, stops the script execution while alerting the user that (s)he needs to upgrade to run the script.
This is very useful to put near the top of scripts that use statements of features that only appeared in a relatively version of PlayOnLinux/PlayOnMac.
Remarks:
- The sweet spot to place POL_RequiredVersion is between POL_SetupWindow_Init (the interface must be ready to display a user warning) and POL_Debug_Init (so that the usage of an old version of PlayOnLinux/PlayOnMac does not trigger all the embedded debugger/bug reporting workflow);
- While POL_RequiredVersion can display warnings on its own, it itself only appeared in PlayOnLinux 4.0.15, and PlayOnLinux 4.0.14 is still the default in some distributions; So for the time being, it is recommended to complement it with a check that the statement itself exists, as shown in the example below.
Prerequisite:
The command POL_SetupWindow_Init must have been used beforehand.
Example:
POL_RequiredVersion 4.0.18 || POL_Debug_Fatal "$TITLE won't work with $APPLICATION_TITLE $VERSION\nPlease update"
POL_Shortcut
Arguments:
- Executable filename.
- Launcher name (often $TITLE).
- Optional name of the icon to download from PlayOnLinux website.
- Optional executable arguments.
- Optional list of categories the program belongs to
Description:
Create a launcher in PlayOnLinux. If some path is specified before the executable filename, it will be interpreted relative to the "drive_c" subdirectory of the prefix. Note that Wine, like Windows, translates the name of the "Program Files" directory according to the user locale, so you should always use the special variable $PROGRAMFILES instead of its name in your own locale.
If no path is specified (recommended), the executable filename is looked up using a case insensitive glob search, so you can use wildcards as needed; On the other hand if the program filename contains special characters they may require quoting to avoid being interpreted as wildcards.
PlayOnLinux can also create entries in system menus, but only if category(ies) is(are) provided. The list of valid categories can be found on freedesktop.org site (see main and additional categories). More than one category can be provided, but in all cases each category must be terminated by a semicolon (;).
Prerequisite:
The command POL_Wine_SelectPrefix must have been used beforehand.
Example:
POL_Shortcut "firefox.exe" "$TITLE"
POL_Shortcut_InsertBeforeWine
Arguments:
- Launcher name (often $TITLE).
- Command to add.
Description:
Allows to run an extra command each time a program will be about to start.
Example:
POL_Shortcut_InsertBeforeWine "Jedi Knight II" "export __GL_ExtensionStringVersion=17700"
POL_Shortcut_Document
Arguments:
- Launcher name (often $TITLE).
- Path to some documentation file
Description:
Link some documentation file to an existing PlayOnLinux shortcut; The documentation will be available using Right-click on shortcut > Read the manual.
Document file is looked up using the same rules POL_Shortcut uses to find executables.
Prerequisite:
The command POL_Wine_SelectPrefix must have been used beforehand.
Example:
POL_Shortcut_Document "$TITLE" "README.txt"
POL_Browser
Arguments:
- URL to open.
Description:
Opens a URL in the user's default Internet browser.
Example:
POL_Browser "http://www.playonlinux.com"
POL_Download
Arguments:
- URL to download.
- (Optional) Expected MD5 digest of the downloaded file
Description:
Download a URL to a local file. The file will be created in the current directory, named after the last component of the URL.
If an expected MD5 digest is provided (recommended), the downloaded file will then be run thru the MD5 digest algorithm, and the result compared to the expected value. If they differ, it will be assumed the download broke and the user will be asked if (s)he wants the download to be reattempted.
This is a very effective way to ensure that the downloaded content is the expected one, however some URLs lead to resources that are very often updated, in which case providing an up-to-date MD5 digest can be impractical.
Example:
POL_Download "http://repository.playonlinux.com/divers/QuickTime.qtp" "417f9bf5ec52d3bfa5826b4905658dac"
POL_Download_Resource
Arguments:
- URL to download.
- Expected MD5 digest of the downloaded file
- (Optional) Subfolder to download the file to
Description:
Download a URL to the local file cache, if not already present. The file will be created in $POL_USER_ROOT/ressources directory (unless some subfolder is provided, in which case it will be created under $POL_USER_ROOT/ressources/<subfolder>, creating the subfolder if needed), and named after the last component of the URL.
Contrary to POL_Download, the MD5 digest is mandatory for POL_Download_Resource, as it will not only be used to validate the download (see POL_Download), but is also used, if some file already exists in the cache, to check that it has the expected content.
Beware that files stored in the cache will potentially stay there for a very long time, since PlayOnLinux never does any kind of cache cleanup, based on time or size; So you should only use POL_Download_Resource for files that are likely to be reused, possibly because they're necessary for several install scripts.
Example:
POL_Download_Resource "http://downloads.sourceforge.net/ffdshow-tryout/ffdshow_beta7_rev3154_20091209.exe" "c3f75f29521f749f9c9fc5489544cb04"
POL_System_TmpCreate
Arguments:
- Name of the temporary directory (often $PREFIX).
Description:
Creates the temporary directory dedicated to the script.
Return:
$POL_System_TmpDir will contain the path of the created temporary directory.
Example:
POL_System_TmpCreate "$PREFIX"
POL_System_TmpDelete
Description:
Removes the script's temporary directory.
Example:
POL_System_TmpDelete
POL_System_SetArch
Arguments:
- Supported architectures (see below).
Description:
Set the (Wine) architectures supported by the script.
Allowed values:
auto: Use the version of Wine matching the system architecture (Wine x86 on x86 and Wine x64 on amd64)
x86: Use the x86 version of Wine for installation (useful if the program doesn't work well with the x64 version)
amd64: Use the x64 version of Wine for installation (if the system architecture is x86, the script stops).
Example:
POL_System_SetArch "auto"
POL_Call
Arguments:
- Function name.
- 2, 3, etc.: Function arguments, if necessary (very few functions take arguments).
Description:
Download and execute a script from the Functions category (the list of functions and their basic information for each can be found here: Components and Functions).
Prerequisite:
For most functions, the commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
POL_Call POL_Install_vcrun6
POL_Wine_SelectPrefix
Arguments:
- Prefix name (often $PREFIX).
Description:
Select the prefix that will be used by Wine (mandatory, even if the prefix hasn't been created yet).
Example:
POL_Wine_SelectPrefix "$PREFIX"
POL_Wine_PrefixExists
Arguments:
- Prefix name (often $PREFIX).
Description:
Check if a prefix exists (useful for game extensions and patches).
Return:
The function displays True if the prefix exists, and False otherwise.
Example:
if [ "$(POL_Wine_PrefixExists "$PREFIX")" = "False" ] then # The préfixe doesn't exist fi
POL_Wine_PrefixCreate
Arguments:
- Wine version.
Description:
Creates or updates a prefix. It is possible to use a version of Wine different from the one installed system wide on user's computer, by specifying this version as first argument.
Prerequisite:
The command POL_Wine_SelectPrefix must have been used beforehand.
Example:
POL_Wine_PrefixCreate "1.3.4"
POL_Wine
Arguments:
- Program pathname.
- 2, 3, etc.: program arguments, if any.
Description:
This command will run the given program; It works exactly like the "wine" command, but uses the Wine versions management and logging facilities of PlayOnLinux.
While most programs started that way will behave synchronously (in other words, will block the script until they're finished), some don't and the POL_Command will need to be followed by a POL_Wine_WaitExit command to prevent the rest of the script from being executed before the program has finished.
See POL_Wine_WaitBefore and POL_Wine_WaitExit.
Note: Using start /unix before the program name can fix issues of access and installation paths with several CD/DVD. However, the use of start /unix makes POL_Wine asynchronous, and since asynchronous programs are not automatically killed if the script is aborted from PlayOnLinux side, it should only be used when necessary.
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
POL_SetupWindow_VMS
Arguments:
- Minimum amount of RAM required, in MB.
Description:
Ask the user how much (dedicated) RAM his videocard has.
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
POL_SetupWindow_VMS "128"
Set_OS
Arguments:
- Windows version to emulate.
- Service pack.
Description:
Modifies the Windows version emulated by Wine.
Default value: winxp (Windows XP).
Allowed values:
Windows versions: win7, vista, win2003, winxp, win2k, winnt, winme, nt40, win98, win95, win31.
Services packs: sp1, sp2, sp3.
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
Set_OS "win2k"
Set_Managed
Arguments:
- On/Off.
Description:
Set if the window manager will be allowed to manage Wine windows.
Default value: On.
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
Set_Managed "Off"
Set_SoundDriver
Arguments:
- alsa/oss/esd.
Description:
Set the audio driver Wine will use.
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
Set_SoundDriver "alsa"
POL_Wine_Direct3D
Arguments:
- Setting to create/modify.
- New setting value.
Description:
Creates or modifies a registry setting below key [HKEY_CURRENT_USER\Software\Wine\Direct3D].
Allowed values:
See WineHQ's Wiki.
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
POL_Wine_Direct3D "UseGLSL" "disabled"
POL_Wine_X11Drv
Arguments:
- Setting to create/modify.
- New setting value.
Description:
Creates or modifies a registry setting below key [HKEY_CURRENT_USER\Software\Wine\X11 Driver].
Allowed values:
See WineHQ's Wiki.
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
POL_Wine_X11Drv "DXGrab" "Y"
POL_Wine_DirectSound
Arguments:
- Setting to create/modify.
- New setting value.
Description:
Creates or modifies a registry setting below key [HKEY_CURRENT_USER\Software\Wine\DirectSound].
Allowed values:
See WineHQ's Wiki.
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
POL_Wine_DirectSound "HardwareAcceleration" "Emulation"
POL_Wine_DirectInput
Arguments:
- Setting to create/modify.
- New setting value.
Description:
Creates or modifies a registry setting below key [HKEY_CURRENT_USER\Software\Wine\DirectInput].
Allowed values:
See WineHQ's Wiki.
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
POL_Wine_DirectInput "MouseWarpOverride" "force"
POL_Wine_GetRegValue
Arguments:
- Setting to read (the key is not required).
Description:
This function returns the value of a setting from the registry.
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Return:
The function displays the value of the specified setting.
Example:
VALUE="$(POL_Wine_GetRegValue "MouseWarpOverride")"
Set_Desktop
Arguments:
- On/Off.
- Virtual desktop width (if it is enabled).
- Virtual desktop height (if it is enabled).
Description:
Sets the Wine virtual desktop settings.
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
Set_Desktop "On" "1024" "768"
Set_WineWindowTitle
Arguments:
- Virtual desktop name.
Description:
Set the title of the virtual desktop window (purely aesthetic effect).
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
Set_WineWindowTitle "$TITLE"
POL_Wine_InstallFonts
Description:
This command installs standard (but not installed by default) fonts into the prefix.
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
POL_Wine_InstallFonts
POL_Wine_SetVideoDriver
Description:
Set correct video driver (when Wine fails to do it properly).
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
POL_Wine_SetVideoDriver
POL_Wine_OverrideDLL
Arguments:
- Mode of override.
- 3, 4, etc.: DLL names (without .dll suffix).
Description:
Set the override mode for one or more dynamic library(ies).
Allowed override modes:
native, builtin, native,builtin, builtin,native, or empty value ("") to disable the DLL(s).
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
POL_Wine_OverrideDLL "native" "msvcrt" POL_Wine_OverrideDLL "" "msvcrt" # To disable the DLL
POL_Wine_OverrideDLL_App
Arguments:
- Executable name.
- Mode of override.
- 3, 4, etc.: DLL names (without .dll suffix).
Description:
Set the override mode for one or more dynamic library(ies), but only for a specific program.
Allowed override modes:
native, builtin, native,builtin, builtin,native, or empty value ("") to disable the DLL(s).
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
POL_Wine_OverrideDLL_App "firefox.exe" "native" "msvcrt" POL_Wine_OverrideDLL_App "firefox.exe" "" "msvcrt" # To disable the DLL
POL_Wine_WaitBefore
Arguments:
- Program name.
Description:
Placed before a POL_Wine command that starts a program synchronously (ie a "blocking" POL_Wine command), it will display a standard wait message while it runs.
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
POL_Wine_WaitBefore "$TITLE"
POL_Wine_WaitExit
Arguments:
- Program name.
Description:
Placed after a POL_Wine command that starts a program asynchronously (ie a "non-blocking" POL_Wine command), it will display a standard wait message while it runs and wait for its completion.
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
POL_Wine_WaitExit "$TITLE"
POL_Wine_reboot
Description:
Emulate a Windows reboot.
Prerequisite:
The commands POL_Wine_SelectPrefix and POL_Wine_PrefixCreate must have been used beforehand.
Example:
POL_Wine_reboot
Debugging commands
POL_Debug_Init
Description:
Start debugging system.
Example:
POL_Debug_Init
POL_Debug_Message
Arguments:
- Message.
Description:
Write a message to the installation log (not shown to the user).
Prerequisite:
The command POL_Debug_Init must have been used beforehand.
Example:
POL_Debug_Message "Modifying config.cfg file."
POL_Debug_Warning
Arguments:
- Message.
Description:
Write a warning message to the installation log (not shown to the user).
Prerequisite:
The command POL_Debug_Init must have been used beforehand.
Example:
POL_Debug_Warning "File config.cfg did not exist, creating one."
POL_Debug_Error
Arguments:
- Message.
Description:
Write an error message to the installation log (not shown to the user).
Prerequisite:
The command POL_Debug_Init must have been used beforehand.
Example:
POL_Debug_Error "Error while modifying config.cfg file"
POL_Debug_Fatal
Arguments:
- Message.
Description:
Raises a fatal error (the script is immediately aborted).
Prerequisite:
The command POL_Debug_Init must have been used beforehand.
Example:
POL_Debug_Fatal "Error while modifying config.cfg file"
Previous: Chapter 10: Script Translation