User:Jaberwocky6669

From AutoIt Wiki
Revision as of 23:44, 1 August 2013 by Jaberwocky6669 (talk | contribs) (Working on formatting the list of directives found in the SciTE4AutoIt3 helpfile.)
Jump to navigation Jump to search

Hi. Say hey some time. I feel so lonely on this wiki sometimes. Love me.


This is a list of compiler directives used by AutoIt3Wrapper.exe and their descriptions.

 #AutoIt3Wrapper_testing (Y/N) skip Tidy, Obfuscator and cvsWrapper for speed while testing. Default=N

AutoIt3 Settings

 #AutoIt3Wrapper_UseX64 (Y/N) Use X64 versions for AutoIt3_x64 or AUT2EXE_x64. Default=N
 #AutoIt3Wrapper_Version (B/P) Use Beta or Production for AutoIt3 and AUT2EXE. Default is P
 #AutoIt3Wrapper_Run_Debug_Mode (Y/N) Run Script with console debugging. Default=N
 #AutoIt3Wrapper_Run_SciTE_Minimized (Y/N) Minimize SciTE while script is running. Default=n
 #AutoIt3Wrapper_Run_SciTE_OutputPane_Minimized (Y/N) Toggle SciTE output pane at run time so its not shown. Default=n
 #AutoIt3Wrapper_Autoit3Dir Optionally override the base AutoIt3 install directory.
 #AutoIt3Wrapper_Aut2exe Optionally override the Aut2exe.exe to use for this script
 #AutoIt3Wrapper_AutoIt3 Optionally override the Autoit3.exe to use for this script
 #AutoIt3Wrapper_Add_Constants Add the needed standard constant include files. Will only run one time.

AUT2EXE Settings

 #AutoIt3Wrapper_Icon Filename of the Ico file to use
 #AutoIt3Wrapper_OutFile Target exe/a3x filename.
 #AutoIt3Wrapper_OutFile_Type a3x=small AutoIt3 fileexe=Standalone executable (Default)
 #AutoIt3Wrapper_OutFile_X64 Target exe filename for X64 compile.
 #AutoIt3Wrapper_Compression Compression parameter 0-40=Low 2=normal 4=High. Default=2
 #AutoIt3Wrapper_UseUpx (Y/N) Compress output program.Default=Y
 #AutoIt3Wrapper_UPX_Parameters Override the default setting for UPX.
 #AutoIt3Wrapper_Change2CUI (Y/N) Change output program to CUI in stead of GUI. Default=N
 #AutoIt3Wrapper_Compile_both (Y/N) Compile both X86 and X64 in one run. Default=N

Target Program Resource Info

 #AutoIt3Wrapper_Res_Comment Comment field
 #AutoIt3Wrapper_Res_Description Description field
 #AutoIt3Wrapper_Res_Fileversion File Version
 #AutoIt3Wrapper_Res_FileVersion_AutoIncrement (Y/N/P) AutoIncrement FileVersion After Aut2EXE is finished. default=N P=Prompt, Will ask at compilation time if you want to increase the version number
 #AutoIt3Wrapper_Res_ProductVersion Product Version. Default is the AutoIt3 version used.
 #AutoIt3Wrapper_Res_Language Resource Language code . default 2057=English (United Kingdom)
 #AutoIt3Wrapper_Res_LegalCopyright Copyright field
 #AutoIt3Wrapper_res_requestedExecutionLevel asInvoker, highestAvailable, requireAdministrator or None (remove the trustInfo section). default is the setting from AUT2EXE - asInvoker
 #AutoIt3Wrapper_res_Compatibility Vista,Windows7Both allowed separated by a comma (default=None)
 #AutoIt3Wrapper_Res_SaveSource (Y/N) Save a copy of the script source in the EXE resources. default=N

If #AutoIt3Wrapper_Res_SaveSource=Y the content of script source depends on the #AutoIt3Wrapper_Run_Obfuscator and #obfuscator_parameters directives:

Add Extra Files to The Resources

A maximum of fifteen free form resource fields.The following variables are available:

%AutoItVer% = will be replaced with the version of AutoIt3 %date% = PC date in short date format %longdate% = PC date in long date format %time% = PC timeformat

An example:

 #AutoIt3Wrapper_Res_Field=AutoIt Version|%AutoItVer%
 #AutoIt3Wrapper_Res_Field Free format fieldname|fieldvalue
 #AutoIt3Wrapper_Res_Field Free format fieldname|fieldvalue
 #AutoIt3Wrapper_Res_Field Free format fieldname|fieldvalue

Add extra ICO files to the resources which can be used with TraySetIcon(@ScriptFullPath, 5) etc

list of filename of the Ico files to be added, First one will have number 5, then 6 ..etc

 #AutoIt3Wrapper_Res_Icon_AddFilename[,LanguageCode] of ICO to be added.
 #AutoIt3Wrapper_Res_File_AddFilename[,Section [,ResName[,LanguageCode]]] to be added.

Tidy Settings

 #AutoIt3Wrapper_Run_Tidy (Y/N) Run Tidy before compilation. default=N
 #AutoIt3Wrapper_Tidy_Stop_OnError (Y/N) Continue when only Warnings. default=Y
 #Tidy_Parameters Tidy Parameters...see SciTE4AutoIt3 Helpfile for options

Obfuscator

 #AutoIt3Wrapper_Run_Obfuscator (Y/N) Run Obfuscator before compilation. default=N
 #obfuscator_parameters=

If #AutoIt3Wrapper_Run_Obfuscator=Y then If #obfuscator_parameters=/STRIPONLY then script source is stripped and includes are stripped. If #obfuscator_parameters=/STRIPONLYINCLUDES then script source is skipped and the includes are stripped. with any other parameters, the SaveSource directive is ignored as obfuscation is intended to protect the source.

If #AutoIt3Wrapper_Run_Obfuscator=N or is not set then script source is original script only.

Autoit3Wrapper indicates the SaveSource action taken in the SciTE console during compilation See SciTE4AutoIt3 Helpfile for more detail on Obfuscator parameters

AU3Check Settings

 #AutoIt3Wrapper_Run_AU3Check (Y/N) Run au3check before compilation. Default=Y
 #AutoIt3Wrapper_AU3Check_Parameters Au3Check parameters
 #AutoIt3Wrapper_AU3Check_Stop_OnWarning (Y/N) N=Continue on Warnings.(Default) Y=Always stop on Warnings
 #AutoIt3Wrapper_PlugIn_Funcs Define PlugIn function names separated by a Comma to avoid AU3Check errors

Versioning Settings

 #AutoIt3Wrapper_Versioning (Y/N/V) Run Versioning to update the script source. default=N V=only run when fileversion is increased by   #AutoIt3Wrapper_Res_FileVersion_AutoIncrement.
 #AutoIt3Wrapper_Versioning_Parameters/NoPrompt: Will skip the Comments prompt /Comments: Text to added in the Comments. It can also contain the below variables.

Run BEFORE And AFTER Definitions

The following directives can contain: these variables %in% , %out%, %outx64%, %icon% which will be replaced by the fullpath\filename. %scriptdir% same as @ScriptDir and %scriptfile% = filename without extension. %fileversion% is the information from the #AutoIt3Wrapper_Res_Fileversion directive %scitedir% will be replaced by the SciTE program directory %autoitdir% will be replaced by the AutoIt3 program directory

 #AutoIt3Wrapper_Run_Before process to run before compilation - you can have multiple records that will be processed in sequence
 #AutoIt3Wrapper_Run_After process to run After compilation - you can have multiple records that will be processed in sequence

Conditional Directives

Optional use this format for the supported directives to have seperate directive values for Run and Compile. The GUI isn't available when this format is used.

 #AutoIt3Wrapper_If_Run
 #AutoIt3Wrapper_Run_AU3Check=y
 #AutoIt3Wrapper_Jump_To_First_Error=y
 #AutoIt3Wrapper_AU3Check_Parameters=-q -d -w 1 -w 2 -w 3 -w 4 -w 5 -w 6
 #AutoIt3Wrapper_AU3Check_Stop_OnWarning=n
 #AutoIt3Wrapper_Run_Tidy=n
 #Tidy_Parameters=
 #AutoIt3Wrapper_Tidy_Stop_onerror=n
 #AutoIt3Wrapper_If_Compile
 #AutoIt3Wrapper_Run_AU3Check=y
 #AutoIt3Wrapper_Jump_To_First_Error=y
 #AutoIt3Wrapper_AU3Check_Parameters=-q -d -w 1 -w 2 -w 3 -w 4 -w 5 -w 6
 #AutoIt3Wrapper_AU3Check_Stop_OnWarning=y
 #AutoIt3Wrapper_Run_Tidy=y
 #Tidy_Parameters=/gd /nsdp
 #AutoIt3Wrapper_Tidy_Stop_onerror=y
 #AutoIt3Wrapper_EndIf

2013 Version


©1999-2013 Jonathan Bennett & AutoIt Team
AutoIt v3 Homepage


Introduction

AutoIt v3 is a freeware BASIC-like scripting language designed for automating the Windows GUI and general scripting. It uses a combination of simulated keystrokes, mouse movement and window/control manipulation in order to automate tasks in a way not possible or reliable with other languages (e.g. VBScript and SendKeys). AutoIt is also very small, self-contained and will run on all versions of Windows out-of-the-box with no annoying "runtimes" required!

AutoIt was initially designed for PC "roll out" situations to reliably automate and configure thousands of PCs. Over time it has become a powerful language that supports complex expressions, user functions, loops and everything else that veteran scripters would expect.

Features:

  • Easy to learn BASIC-like syntax
  • Simulate keystrokes and mouse movements
  • Manipulate windows and processes
  • Interact with all standard windows controls
  • Scripts can be compiled into standalone executables
  • Create Graphical User Interfaces (GUIs)
  • COM support
  • Regular expressions
  • Directly call external DLL and Windows API functions
  • Scriptable RunAs functions
  • Detailed helpfile and large community-based support forums
  • Compatible with Windows XP / Server 2003 / Vista / Server 2008 / 7 / 8
  • Unicode and x64 support
  • Digitally signed for peace of mind
  • Works with Windows User Account Control (UAC)

AutoIt has been designed to be as small as possible and stand-alone with no external .dll files or registry entries required making it safe to use on Servers. Scripts can be compiled into stand-alone executables with Aut2Exe.

Also supplied is a combined COM and DLL version of AutoIt called AutoItX that allows you to add the unique features of AutoIt to your own favorite scripting or programming languages!

Best of all, AutoIt continues to be free - but if you want to support the time, money and effort spent on the project and web hosting then you may donate at the AutoIt homepage.

Features in Detail

Basic-like Syntax and Rich Function Set

AutoIt has a BASIC-like syntax which means that most people who have ever written a script or used a high-level language should be able to pick it up easily.

Although it started life as a simple automation tool, AutoIt now has functions and features that allow it to be used as a general purpose scripting language (with awesome automation as well of course!). Language features include:

The usual high-level elements for functions, loops and expression parsing A staggering amount of string handling functions and a Perl compatible regular expression engine (using the PCRE library). COM support Call Win32 and third-party DLL APIs

Built-in Editor with Syntax Highlighting

AutoIt comes with a customized "lite" version of SciTE that makes editing scripts easy. Users can also download a complete version of SciTE that includes additional tools to make things even easier.

Standalone and Small

AutoIt is a very small and standalone application with no reliance on massive runtimes such as .NET or VB. All you need to run AutoIt scripts are the main AutoIt executable (AutoIt3.exe) and the script. Scripts can also be encoded into standalone executables with the built-in script compiler Aut2Exe.

International and 64-bit Support

AutoIt is fully Unicode aware and also includes x64 versions of all the main components! How many other free scripting languages can you say that about?

Key and Mouse Simulation

Much time has been spent optimizing the keystroke and mouse simulation functions to be as accurate as possible on all versions of Windows. All the mouse and keyboard routines are highly configurable both in terms of simulation "speed" and functionality.

Window Management

You can expect to move, hide, show, resize, activate, close and pretty much do what you want with windows. Windows can be referenced by title, text on the window, size, position, class and even internal Win32 API handles.

Controls

Directly get information on and interact with edit boxes, check boxes, list boxes, combos, buttons, status bars without the risk of keystrokes getting lost. Even work with controls in windows that aren't active!

Graphical User Interfaces (GUIs)

AutoIt v3 will also allow you to create some complex GUIs - just like those below!

GUI Example 1 GUI Example 2

And much, much more...