PlugLab Help

General Info Setup and Help Example Create Complete Source

To configure the plugin run the AutoHelp.cmd and follow the prompts.

The plugin enables 1x1-Script Support on CD (for *.1x1 program starter scripts using PeFuncs.exe )

PeFuncs.exe is a commandline utility primarely intended to start a program on CD.

The commandline starter script that is normally used to copy the files to the ramdrive and then starts the program there is replaced by a "1x1-script" with the "macro-routine":

%StartProgram_MacroOnRamDrive%

See the full details and the various steps covered by that macro under "Example Scripts" in the PeFuncs.exe help GUI (see screenShot).

The 1x1-script is run hidden (no "dos-box") and the user has a full progress GUI and professional prompts

(see example below for the 2xExplorer plugin).

The 1x1 start script shows the icon of the program it starts.

XPE-shortcuts pointing to it also show that icon.

Aside from this core usage, PeFuncs.exe also has a variety of routines to cover virtually all possible advanced and complex starter script scenarious including:
UpperFilters, RunScanner, downloading defs, INI, registry etc. and all variables for localisation tasks.

1x1-scripts are commandline scripts with the extension 1x1.
%SystemRoot%\system32\PeFuncs.exe is associated with 1x1-scripts and when a 1x1-script is started, the file association starts PeFuncs.exe which then copies the script to temp, renames it to CMD and runs it hidden.

1x1 support on CD
... is enabled by the plugin "1x1Support_On_CD.inf"

1x1 support on your host system
... is recommended for plugin authors so that you can test your 1x1 scripts.
Enable or uninstall 1x1 support from the menu that you see when you manually start PeFuncs.exe.

Note: the normal caution that applies to all commandline scripts that are designed to be run on CD and are tested on a real system also applies to 1x1 scripts.

General Info Setup and Help Example Create Complete Source

Help and setup GUI of PeFuncs.exe

General Info Setup and Help Example Create Complete Source

Example 1x1-Script for the plugin "2xExplorer"

2xExplorer.1x1 Example script

:: 1x1Script Concept and PeFuncs.exe: 2007 Siegfried Benthin
@echo off&title=%~f0&if exist "%temp%\TempLab.cmd" call "%temp%\TempLab.cmd"&del "%temp%\TempLab.cmd"&%init%
:: **********************************************

%StartProgram_MacroOnRamDrive%

%GUI_ExitAll%
goto :EOF

:: ===============================

[Shell]
IconFile="%SystemDrive%\programs\2xExplorer\2xExplorer.exe,0"

[Parse_As_Vars_Into_The_Script]
GUIshow=yes
GUI_HideWhenActive=2xExplorer
Program_Name=2xExplorer

Transfer the files to the ramdrive and start the program:

While the program is running, the starter GUI is hidden.

When the program is closed, the starter GUI un-hides for the closing routines.

General Info Setup and Help Example Create Complete Source

How to create a complete source for PeFuncs.exe

PeFuncs.exe is freeware and may be used without any restrictions (see the PlugLab license).

It is compiled with autoit v3.2.2.0

NOTE:

if you create your own modified version of PeFuncs.exe and publish plugins using it, you have to keep in mind that only one version of PeFuncs.exe will be on the recoveryCD of users (System32) and then used for all plugins in the setup. To maintain compatibility please publish your ideas and/or your modified version in the forum so I can incorporate improvements into the general release of this plugin.

PeFuncs.exe topic in the 911CD Forum

To create a full source:

run a copy of PeFuncs.exe in a subdirectory of your folder "plugin" (e.g. <PEbuilderRoot>\plugin\TestPeFuncsEXE).

This will create the following items: