Eagle Principle Windows
This part of Eagle configuration is significant in that often reflects the visual appearance and performance of many parts of the Eagle application. This area is constantly evolving and variables which are currently valid or versions specific may not have relevance in an earlier or later version, in such cases if you include these variables in the configuration file these variables will simply be set as standard without any "special" significance in that version.
This section deals with the main Eagle windows appearance and behaviourial operation, please refer also to the GUI settings and Display and Operational settings for details of GUI, graphics and procedural variables.
Eagle run mode
|
|
ALPHA_MODE |
|
Values |
YES | unset |
|
Description |
Enables Eagle to operate in Alpha Mode (without graphics). Running Eagle non graphic mode is typically used for batch macro processing, file conversions, plotting and so forth. |
|
Default |
|
|
Example |
ALPHA_MODE=YES |
Eagle Root Container Window
Root Window Appearance
|
|
ROOT_START_MAXIMIZED |
|
Values |
yes | no |
|
Description |
Switch to allow maximising of the Eagle root window to available screen size on startup |
|
Default |
no |
|
Example |
ROOT_START_MAXIMIZED |
|
|
EAORIGX |
|
Values |
a number |
|
Description |
Sets the origin x position of the ROOT window defining the X position at which it will appear |
|
Default |
101 |
|
Example |
EAORIGX=101 |
|
|
EAORIGY |
|
Values |
a number |
|
Description |
Sets the origin y position of the ROOT window defining the Y position at which it will appear |
|
Default |
1 |
|
Example |
EAORIGY=1 |
|
|
EAWIDTH |
|
Values |
a number |
|
Description |
Sets the initial width in pixels of ROOT window |
|
Default |
1000 |
|
Example |
EAWIDTH=1280 |
|
|
EAHEIGHT |
|
Values |
a number |
|
Description |
Sets the initial height in pixels of ROOT window |
|
Default |
800 |
|
Example |
EAWIDTH=768 |
|
|
TITLE |
|
Values |
a string |
|
Description |
Text to be displayed in the Eagle root window title bar. Note this variable MUST currently be place in the [config] section of the configuration file |
|
Default |
Eagle |
|
Example |
TITLE=My EagleApplication |
|
|
ROOT_BACKGROUND_COLOR |
|
Values |
a value in the range #000000 to #FFFFFF |
|
Description |
Change the background color on the main root window. The color is specified using a # followed by three hexadecimal values (one for red, one for green and one for blue). |
|
Default |
#000000 |
|
Example |
ROOT_BACKGROUND_COLOR=#777710 |
|
|
ROOT_CAPTION_ICON |
|
Values |
a filename (and path if not in the current directory) |
|
Description |
Define the icon for the main ROOT window. Unset renders the icon from Eagle executable. |
|
Default |
Eagle.ico |
|
Example |
ROOT_CAPTION_ICON=EagleX4.ico |
|
|
ROOT_THEME |
|
Values |
OFFICE2000 | OFFICEXP | OFFICE2003 | OFFICE2003NOTHEMES | STUDIO2005 | STUDIO2008 | NATIVEXP | OFFICE2007_R1 | OFFICE2007_R2_LUNABLUE | OFFICE2007_R2_OBSIDIAN | OFFICE2007_R2_SILVER | OFFICE2007_R3_LUNABLUE | OFFICE2007_R3_OBSIDIAN | OFFICE2007_R3_SILVER |
|
Description |
Define the theme schema for Eagle at startup. Related also to the THEME command. |
|
Default |
OFFICE_2007_R2_LUNABLUE |
|
Example |
ROOT_THEME=NATIVEXP |
Root Window Furniture
|
|
ROOT_CLOSE_ENABLED |
|
Values |
yes | no |
|
Description |
Switch to enable or disable the CLOSE button on the ROOT window. When the entry is set to YES the Close callback is available. If you have set this variable to yes you must have an equivalent ROOT_CLOSE_ACTION set to perform the desired close action. |
|
Default |
yes |
|
Example |
ROOT_CLOSE_ENABLED=yes |
|
|
ROOT_MAXIMIZEBOX_ENABLED |
|
Values |
yes | no |
|
Description |
Switch to enable or disable (grey out) the MAXIMIZE button on the ROOT window. |
|
Default |
no |
|
Example |
ROOT_MAXIMIZEBOX_ENABLED=yes |
|
|
ROOT_MINIMIZEBOX_ENABLED |
|
Values |
yes | no |
|
Description |
Switch to enable or disable the MINIMIZE button on the ROOT window. |
|
Default |
no |
|
Example |
ROOT_MINIMIZEBOX_ENABLED=yes |
|
|
ROOT_RESIZE_ENABLED |
|
Values |
yes | no |
|
Description |
Switch to enable or disable the MINIMIZE button on the ROOT window. When the entry is set to YES the Resize callback is available. If you have set this variable to yes you must have an equivalent ROOT_SIZE_ACTION (previously ROOT_WMSIZE_ACTION) set to perform the desired close action. |
|
Default |
no |
|
Example |
ROOT_RESIZE_ENABLED=yes |
Root Window Actions
|
|
ROOT_SIZE_ACTION |
|
Values |
filename (with complete path if the file is not stored in the current directory) |
|
Description |
Action to execute when ROOT window is resized. This variable sets a user defined macro to be executed whenever the main Eagle frame window is resized or restored. This entry call points to a macro, which could for example tell the size of the window. The variable ROOT_WMSIZE_ACTION performed a similar task in previous versions. |
|
Default |
no action |
|
Example |
ROOT_SIZE_ACTION=C:\Users\MacroVision\Eagle14\rootsize.cmd |
|
|
ROOT_CLOSE_ACTION |
|
Values |
filename (with complete path if the file is not stored in the current directory) |
|
Description |
Action to execute when ROOT window is closed. When the Eagle root window is closed and this entry is set to point to a macro, then Eagle executes this macro. This facility has been introduced to allow an application to perform application specific actions before the Eagle window is closed an event that ends the application and Eagle itself. The variable ROOT_WMCLOSE_ACTION performed a similar task in previous versions. |
|
Default |
no action |
|
Example |
ROOT_CLOSE_ACTION=C:\Users\MacroVision\Eagle14\rootclose.cmd |
Eagle Document GWindows
When we speak of gwindow settings traditionally this referred only to the 3D graphic window which started within the Eagle root window. Classic Eagle versions had the graphics window implemented with similar settings to the root window . The introduction of a true multi-windowed environment document window means the single graphic windows diminishes in favour of multiple GWINDOW environment. This section included all the relevant configuration settings of the Gwindow which may or may not have relevance to a particular version or the mode (MDI, TDI, TMDI, SDI) in which that version is run.
|
|
DEFAULT_GWINDOW |
|
Values |
yes | no |
|
Description |
Define if the first GWINDOW is automatically created at startup. |
|
Default |
no |
|
Example |
DEFAULT_GWINDOW=yes |
|
|
EAGLE_DOCUMENT_ICON |
|
Values |
filename (with complete path if the file is not stored in the current directory) |
|
Description |
Set the Icon for the Eagle Document windows (GWINDOWS) where the file must be an "ico" file. Unset will use default icon. |
|
Default |
no icon |
|
Example |
EAGLE_DOCUMENT_ICON=C:\Users\MacroVision\Eagle14\eagle_grey_doc.ico |
|
|
GWINDOW_CLOSE_MACRO |
|
Values |
filename (with complete path if the file is not stored in the current directory) |
|
Description |
Macro to execute when GWINDOW window is closed |
|
Default |
no action |
|
Example |
GWINDOW_CLOSE_MACRO=C:\Users\MacroVision\Eagle14\gwclose.cmd |
|
|
GWINDOW_GET_FOCUS |
|
Values |
filename (with complete path if the file is not stored in the current directory) |
|
Description |
Macro to execute when focus is gained to a GWINDOW |
|
Default |
no action |
|
Example |
GWINDOW_GET_FOCUS=C:\Users\MacroVision\Eagle14\getfocus.cmd |
|
|
GWINDOW_ICONIZED_MACRO |
|
Values |
filename (with complete path if the file is not stored in the current directory) |
|
Description |
Macro to execute when GWINDOW window is iconized (minimized) |
|
Default |
no action |
|
Example |
GWINDOW_ICONIZED_MACRO=C:\Users\MacroVision\Eagle14\gwminimize.cmd |
|
|
GWINDOW_INITIAL_MAXIMIZED |
|
Values |
yes | no |
|
Description |
Define if the initial state of the Graphic Window should be maximized or not. Setting as yes means the GWINDOW will be created maximized. |
|
Default |
no |
|
Example |
GWINDOW_INITIAL_MAXIMIZED=yes |
|
|
GWINDOW_LOOSE_FOCUS |
|
Values |
filename (with complete path if the file is not stored in the current directory) |
|
Description |
Action to execute when focus is lost from a GWINDOW |
|
Default |
no action |
|
Example |
GWINDOW_LOOSE_FOCUS=C:\Users\MacroVision\Eagle14\loosefocus.cmd |
|
|
GWINDOW_MAXIMIZED_MACRO |
|
Values |
filename (with complete path if the file is not stored in the current directory) |
|
Description |
Action to execute when a GWINDOW is maximized |
|
Default |
no action |
|
Example |
GWINDOW_MAXIMIZED_MACRO=C:\Users\MacroVision\Eagle14\gwmaximize.cmd |
|
|
GWINDOW_RESTORED_MACRO |
|
Values |
filename (with complete path if the file is not stored in the current directory) |
|
Description |
Action to execute when a GWINDOW is restored |
|
Default |
no action |
|
Example |
GWINDOW_MAXIMIZED_MACRO=C:\Users\MacroVision\Eagle14\gwrestore.cmd |
Eagle in a tabbed document mode REFER GUI SETTINGS FOR DOCUMENT TAB
Message Window Settings
The message window also known as the DIALOGUE is the window in which Eagle and Eagle application messages are displayed by default. This Window has undergone several transformation to the point where it is now a rich text control which can be fully customised. This transformation continues to evolve and in future versions this window will be referred to exclusively as the Message window with the term Dialogue depreciated.
(**) When the message window close button is selected a DIALOG OFF command is triggered.
(***) The help option of the context menu executes a programmed HELP command.
|
|
MESSAGE_BACKGROUND_COLOR |
|
Values |
a value in the range #000000 to #FFFFFF |
|
Description |
Set color for background color used in the MESSAGE bar. There color is an rgb hexadecimal values within the range #000000 to #FFFFFF |
|
Default |
#000000 |
|
Example |
MESSAGE_BACKGROUND_COLOR=#335500 |
|
|
MESSAGE_CONTEXT_MENU |
|
Values |
a menu file .men |
|
Description |
Set a customized popup menu for the message area using a standard Eagle .men file as the input. |
|
Default |
default popup |
|
Example |
MESSAGE_CONTEXT_MENU_COLOR=myfile.men |
|
|
MESSAGE_LINES |
|
Values |
a menu file .men |
|
Description |
Sets the number of lines in the dialogue (message) window at startup of Eagle. This may also be controlled by the DIALOGUE command. The variable DIALOGLINES performed a similar task in previous versions. |
|
Default |
10 |
|
Example |
MESSAGE_LINES=8 |
|
|
MESSAGE_READONLY |
|
Values |
yes | no |
|
Description |
Defines if the richtext message window can have user written entries or not. |
|
Default |
no |
|
Example |
MESSAGE_READONLY=yes |
|
|
MESSAGE_TEXT_COLOR |
|
Values |
a value in the range #000000 to #FFFFFF |
|
Description |
Set color for font used in the MESSAGE bar. There color is an rgb hexadecimal values within the range #000000 to #FFFFFF |
|
Default |
#FFFFFF |
|
Example |
MESSAGE_TEXT_COLOR=#000099 |
|
|
MESSAGE_TITLE |
|
Values |
a string |
|
Description |
Define the title to be displayed on the caption of the message bar. Only shown if MESSAGE_WINDOW_TITLE=yes and MESSAGE_WINDOW_TYPE is TOP or LEFT |
|
Default |
none |
|
Example |
MESSAGE_TITLE=MyEagleMessages |
|
|
MESSAGE_WINDOW_FIXED |
|
Values |
yes | no |
|
Description |
Enable or disable the docking and undocking of the message window |
|
Default |
no |
|
Example |
MESSAGE_WINDOW_FIXED=yes |
|
|
MESSAGE_WINDOW_FONT_NAME |
|
Values |
name of font |
|
Description |
Set font used in the rich text MESSAGE window |
|
Default |
Courier |
|
Example |
MESSAGE_WINDOW_FONT_NAME="Calibri" |
|
|
MESSAGE_WINDOW_FONT_SIZE |
|
Values |
name of font |
|
Description |
Set font size used in the rich text MESSAGE window |
|
Default |
10 |
|
Example |
MESSAGE_WINDOW_FONT_SIZE=12 |
|
|
MESSAGE_WINDOW_TITLE |
|
Values |
yes | no |
|
Description |
Defines whether or not to use the defined Eagle message window caption or title bar |
|
Default |
no |
|
Example |
MESSAGE_WINDOW_TITLE=yes |
|
|
MESSAGE_WINDOW_TYPE |
|
Values |
NOSIZE | FIXED | LEFT | TOP |
|
Description |
Defines whether or not to use the defined Eagle message window caption or title bar |
|
Default |
NOSIZE |
|
Example |
MESSAGE_WINDOW_TYPE=top |
|
Variable |
Settings and Description |
|
DIALINES_BUFFER changed to MESSAGE_BUFFER_SIZE |
Description : Set the number of lines to be buffered from the dialogue (message) window.Options : DIALINES_BUFFER=<n> e.g. DIALINES_BUFFER=800 The default number of lines is 512. |
Eagle Command Window Settings
|
|
COMMAND_TITLE |
|
Values |
a string |
|
Description |
Title text to display in the command window. |
|
Default |
no title |
|
Example |
COMMAND_TITLE="Command" |
|
|
COMMAND_WINDOW_TITLE |
|
Values |
yes | no |
|
Description |
Defines whether or not to use the defined Eagle command window caption or title bar |
|
Default |
no |
|
Example |
COMMAND_WINDOW_TITLE=yes |
|
|
COMMAND_BACKGROUND_COLOR |
|
Values |
an rgb valuefrom the range f#000000 to #FFFFFF |
|
Description |
Description : Set color used in the COMMAND window background where rgb are hexadecimal values within the range #000000 to #FFFFFF |
|
Default |
#000000 |
|
Example |
COMMAND_BACKGROUND_COLOR=#335500 |
|
|
COMMAND_WINDOW_FONT_NAME |
|
Values |
name of font |
|
Description |
Set font used in the command window |
|
Default |
Courier |
|
Example |
MESSAGE_WINDOW_FONT_NAME="Calibri" |
|
|
COMMAND_WINDOW_FONT_SIZE |
|
Values |
name of font |
|
Description |
Set font size used in the COMMAND window |
|
Default |
10 |
|
Example |
MESSAGE_WINDOW_FONT_SIZE=12 |
|
|
COMMAND_TEXT_COLOR |
|
Values |
an rgb value from the range #000000 to #FFFFFF |
|
Description |
Set color used for the COMMAND window font where rgb are hexadecimal values within the range #000000 to #FFFFFF |
|
Default |
#FFFFFF |
|
Example |
COMMAND_TEXT_COLOR=#E6E6FA |
|
|
HISTORY_BUTTON_ICON |
|
Values |
an ico file (complete with path if file is not stored in the current directory) |
|
Description |
Define the icon for the Command bar History button |
|
Default |
no icon |
|
Example |
HISTORY_BUTTON_ICON=C:\Users\Macrovision\Eagle\history.ico |
|
|
HISTORY_ASCENDING |
|
Values |
an ico file (complete with path if file is not stored in the current directory) |
|
Description |
Define the order of viewing of the history list of command instructions executed within Eagle. When set to YES the list will be ascending (last command executed placed on the top of the list and scroll bar at the top) alternatively when set to NO (last command executed remains at the bottom with the scroll bar at the bottom). |
|
Default |
no |
|
Example |
HISTORY_ASCENDING=yes |
|
|
HISTORY_DUPLICATES |
|
Values |
yes | no |
|
Description |
Enable duplication of commands in the history dialog list |
|
Default |
no |
|
Example |
HISTORY_DUPLICATES=yes |
Eagle Splash Window Settings
|
|
SPLASH_WINDOW_ENABLE |
|
Values |
yes | no |
|
Description |
Enable the launching of the Splash Screen Dialog |
|
Default |
yes |
|
Example |
SPLASH_WINDOW_ENABLE=no |
|
|
SPLASH_WINDOW_BITMAP |
|
Values |
filename (with complete path if file is not in current directory) |
|
Description |
Sets the image to use as the background for the Splash window 300x400px |
|
Default |
Default internal bitmap |
|
Example |
SPLASH_WINDOW_ENABLE=c:\users\Appl\splash.bmp |
|
|
SPLASH_WINDOW_FONT_BOLD |
|
Values |
yes | no |
|
Description |
Apply the "bold" style to text displayed in splash messages |
|
Default |
no |
|
Example |
SPLASH_WINDOW_FONT_BOLD=yes |
|
|
SPLASH_WINDOW_FONT_ITALIC |
|
Values |
yes | no |
|
Description |
Apply the "italic" style to text displayed in splash messages |
|
Default |
no |
|
Example |
SPLASH_WINDOW_FONT_ITALIC=yes |
|
|
SPLASH_WINDOW_FONT_NAME |
|
Values |
name of font |
|
Description |
Set the name of the font to use in splash window messages |
|
Default |
Default font set for current application |
|
Example |
SPLASH_WINDOW_FONT_NAME="Calibri" |
|
|
SPLASH_WINDOW_FONT_SIZE |
|
Values |
the font size |
|
Description |
Set the size of the font to use in splash window messages |
|
Default |
Default font size for current application |
|
Example |
SPLASH_WINDOW_FONT_SIZE=12" |
|
|
SPLASH_WINDOW_FONT_UNDERLINED |
|
Values |
yes | no |
|
Description |
Apply the "underlined" style to text displayed in splash messages |
|
Default |
no |
|
Example |
SPLASH_WINDOW_FONT_UNDERLINED=yes |
|
|
SPLASH_WINDOW_SLEEP |
|
Values |
a number |
|
Description |
Set the amount of time (in milliseconds) to show the message in the splash window |
|
Default |
0 |
|
Example |
SPLASH_WINDOW_SLEEP=10 |
|
|
SPLASH_WINDOW_TEXT_COLOR |
|
Values |
an rgb value from the range #000000 to #FFFFFF |
|
Description |
Set color used for the COMMAND window font where rgb are hexadecimal values within the range #000000 to #FFFFFF |
|
Default |
#000000 |
|
Example |
SPLASH_WINDOW_TEXT_COLOR=#777710 |
Standard AE Legacy Settings
|
GMAXIMIZE
|
Description : Switch on or off maximising of the Eagle AE graphic window to available root window size. In EagleEye the graphics window is attached to the root frame window or may be free form in the multi-windowed environment. (Eagle AE ) Has no effect in EagleEye. |
|
BOTTOM_OFFSET |
Description : Sets the Eagle AE graphic window bottom offset in pixels from the root frame Options : BOTTOM_OFFSET=<n> e.g. BOTTOM_OFFSET=20
Description : Sets the Eagle AE graphic window left offset position in pixels from the root frame Options : LEFT_OFFSET=<n> e.g. BOTTOM_OFFSET=20
Description : Sets the Eagle AE graphic window right offset position in pixels from the root frame Options : RIGHT_OFFSET=<n> e.g. BOTTOM_OFFSET=20
Description : Sets the Eagle AE graphic window top offset position in pixels from the root frame Options : TOP_OFFSET=<n> e.g. BOTTOM_OFFSET=20
These variables all define the placement of the Eagle AE Classic version graphics window within the Eagle root window provided the GMAXIMIZE variable is set to off. In EagleEye the graphics windows are attached to the Eagle frame window and therefore the settings have no meaning. |
|
GRAFIX_RESIZE_ENABLED |
Description : Define if Eagle AE graphic window “resizing” is enabled or grayed out, no interactive resize possible. The Eagle AE Classic Graphics window has no maximize or minimize buttons. When this variable is set to no it ensures that resizing of the graphic window is not enabled. The resize cursor may appear to the user but no resize will be possible. The default is yes to be compatible with previous versions. |
|
GRAFIX_MAXIMIZEBOX_ENABLED |
Description : Define if Eagle AE graphic window “minimize” button is enabled or grayed out, unselectable. Only valid on the Eagle AE Classic single graphic window version where a maximize button is not present by default. |
|
GWIND_TITLE |
Description : (Eagle AE) When set to YES or NO defines whether or not to use the to Eagle graphic window caption or title bar. Removing the title bar allows development presentation of pre-view type applications. |