AGI Wiki - User contributions [en]

File:WinAGI 2 3 7.zip

2024-06-09T04:31:04Z

Andrew Korson:

WinAGI

2024-06-09T04:30:18Z

Andrew Korson:

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2024/6/8]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.3.7
| ReleaseDate = [[2024|2024/6/8]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{OpenSRC}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

'''The current version of WinAGI is 2.3.7''': fixed print.at commands because argument count doesn't change in some versions (there is a bug in trace function that uses wrong counts for display only that was mistakenly treated as an actual change in argument count); the import resource function was fixed so the cancel button is no longer ignored; the property window scrollbar was fixed (it would not work in correctly in some situations); fixed a bug in logic compiler that would not handle invalid variable numbers in some situations; modified the text screen editor to only show valid color combinations instead of all combinations; added a check at game load to look for any resource files marked readonly; arguments in said command are now case sensitive; removed 'elseasgoto' decoding option; several other minor bugfixes

'''The current version of WinAGI is 2.3.6''': another minor bugfix in game import function

'''2.3.5:''': fixed bug that caused WinAGI to crash when importing a game; fixed some minor drag/drop issues; clarified in Help file that drag/drop will not work if program is run as administrator

'''2.3.4''': fixed major bug in Game Properties dialog that prevented selecting a folder for new games; global defines files that use LF as end-of-line instead of CRLF will now load properly

'''2.3.3:''' Replace All function modified so logic editors no longer reformat the screen each time a replacement is made - this improves performance when replacing in very large source files; TAB key behaves as expected on Find form; fixed bug in Game About and Game Version property textbox so it correctly adds '\n' codes for CTRL+ENTER; fixed zoom control on picture previews to correctly place the picture when shrinking it small enough to fit inside the preview window; added a new decompile mode that is like VS style, but keeps 'else' and its preceding/following brackets all on one line; when opening a layout file, if the correct filename is not found, WinAGI checks for a file with same name as the WAG file - if found, that file should be renamed to be the correct WAL file, otherwise old file will stay around; in text screen editor, if a copied display command has text with parentheses in it, the parser for pasting the command now works correctly; in text screen editor, loading a screen file that doesn't match current colwidth needs to make sure the colwidth mode matches

'''2.3.2:''' added file drag/drop support for main window; the Find dialog now remembers last ten search terms; added toolbar buttons to the logic editor for indent/outdent; when importing or opening a game, resource errors that don't prevent compiling or running a game are now included as warnings in the warning list; when importing a game, the decompiler will use the gameid found in the game's set.game.id' command, if found; added option to copy picture draw commands to clipboard as readable text; added new readonly mode to words editor that sorts all words alphabetically; the Game Property form now groups the properties into four tabs; with more room on the tabs the properties are now better arranged; many minor enhancements and bugfixes

'''2.3.1:''' Added new text screen editor to help create text screens (for example help pages), and copy the attributes and display commands to put into logics; added new logic syntax option that is compatible with original Sierra syntax; clicking include filenames in logic editor will open them for editing, same as resources; logic compiler will continue compiling even after an error is found so all errors can be detected in a single pass; added new print/display preview mode to picture editor to see how text added by print and display commands will look when added to screen; added new feature to picture editor to show small markers that show where displayed text characters would be aligned; snippets can now include tool tip 'help', similar to AGI commands; game directory is no longer editable on properties page; to move a game to a new directory, close WinAGI and move it manually with file explorer; color palette values (converted from MSDOS 18 bit to Windows 24 bit) were a bit off and have been fixed to be more precise; added support for programming games with the AGI Power Pack; replaced the 'Use txt as extension' setting with 'SourceFileExt' game property to allow for more options; in picture editor, when in pixel-select mode, Shift+MouseDown will drag the picture surface; the example image on the picture editor Load/Configure Background form is now set to the current picture image (based on current draw state); cel count is now a displayed as a readonly property when a loop is selected; snippets get saved automatically when the form is closed; palette data can be saved to any text file; a nagi.ini file is not required; fixed a major bug in the picture editor Add Coordinate function that would add invalid data in relative line commands; pressing view preview shortcut keys (w,a,s,d) no longer crashes WinAGI if a header is selected; fixed a bug in on main form so resizing and splitting works correctly; a lot of other minor bug fixes

'''2.2.6:''' Added a new TODO tracking function: comments in logics can be tagged as 'TODO' and will be tracked in the warning window, which makes it easier to keep track of things that you are deferring for later. Fixed bug in game property window that was not saving the Platform Options value if 'other' platform is selected. Fixed several minor bugs in renumber resource function. Fixed bug when double-clicking a resource in the tree that would not set focus to the newly opened resource. Added a menu option and shortcut to toggle warning window. Fixed a bug in compiler that would raise an error if a negative number was passed as a define constant. Added a notification in picture editor if an image file fails to open when using the configure background image dialog. Fixed a bug in view editor move-selection function that was improperly updating cel data. Resizing of a cel in view editor is now allowed regardless of selected tool. Fixed several other minor bugs

'''2.2.5:''' Fixed renumber function error when trying to check IsRoom property of a nonexistent logic. Template version check function now correctly identifies version and loads template games. Back up files now all use the same format ('oldname_OLD.ext'). Added mouse wheel support for preview window; picture and cel images can now be zoomed in or out using the mouse wheel. Double-clicking on logics and views will open the respective editor with the resource positioned to match the preview resource (logic scrolls to correct line, views open with correct loop/cel). Fixed bug in snippet function to correctly insert snippet text when snippet was not at beginning of a line. The compiler warning for a missing 'return()' command at end of a logic source now works correctly. Added new feature to shrink open editor windows when the warning/error pane gets displayed so the main form work area doesn't require scrolling. The picture editor join command now gets displayed when two adjacent commands that are eligible for joining are selected. Fixed major but in view editor selection move function incorrectly set cel data when the selection is left at starting position. Fixed a bug in the view editor fill tool that incorrectly filled cel border areas. Deleting or cutting a loop in the view editor now correctly updates the preview panel. The preview panel will now display correctly when view editor is first opened. Added a new transparent selection option for copy/cut/move/paste of cel data (the cel's TransColor value is used to hide pixels in the pasted data). Fixed a bug in the WORDS.TOK editor that caused it to fail in older versions of Windows. Added a new export option for WORDS.TOK to create word lists compatible with ScummVM's extended character support.

'''2.2.4:''' Snippet arguments can now be multi-word (spaces allowed). Typing when the snippet list is visible will now select items from the list. Fixed a major bug in the layout editor to correctly read version information (which prevented proper loading of layout files in v2.2.3). Fixed bug in resource renumber function that was causing layout editor to write invalid data to the layout file. Renumbering a logic that is also a room will now let you also renumber the matching room picture resource. Cleaned up the resource number selection form so text is displayed on the form correctly. Added a menu item and shortcut to the layout editor that opens the matching picture resource for editing when a room is selected.

'''2.2.3:''' Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows.

'''2.1.16:''' Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data.

'''2.1.15:''' Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_3_7.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.77 MB]</span>
** for source code, contact the [[Andrew_Korson|WinAGI author]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

WinAGI

2024-03-23T00:46:31Z

Andrew Korson:

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2023/12/13]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.3.6
| ReleaseDate = [[2024|2024/1/23]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

'''The current version of WinAGI is 2.3.6''': another minor bugfix in game import function

'''2.3.5:''': fixed bug that caused WinAGI to crash when importing a game; fixed some minor drag/drop issues; clarified in Help file that drag/drop will not work if program is run as administrator

'''2.3.4''': fixed major bug in Game Properties dialog that prevented selecting a folder for new games; global defines files that use LF as end-of-line instead of CRLF will now load properly

'''2.3.3:''' Replace All function modified so logic editors no longer reformat the screen each time a replacement is made - this improves performance when replacing in very large source files; TAB key behaves as expected on Find form; fixed bug in Game About and Game Version property textbox so it correctly adds '\n' codes for CTRL+ENTER; fixed zoom control on picture previews to correctly place the picture when shrinking it small enough to fit inside the preview window; added a new decompile mode that is like VS style, but keeps 'else' and its preceding/following brackets all on one line; when opening a layout file, if the correct filename is not found, WinAGI checks for a file with same name as the WAG file - if found, that file should be renamed to be the correct WAL file, otherwise old file will stay around; in text screen editor, if a copied display command has text with parentheses in it, the parser for pasting the command now works correctly; in text screen editor, loading a screen file that doesn't match current colwidth needs to make sure the colwidth mode matches

'''2.3.2:''' added file drag/drop support for main window; the Find dialog now remembers last ten search terms; added toolbar buttons to the logic editor for indent/outdent; when importing or opening a game, resource errors that don't prevent compiling or running a game are now included as warnings in the warning list; when importing a game, the decompiler will use the gameid found in the game's set.game.id' command, if found; added option to copy picture draw commands to clipboard as readable text; added new readonly mode to words editor that sorts all words alphabetically; the Game Property form now groups the properties into four tabs; with more room on the tabs the properties are now better arranged; many minor enhancements and bugfixes

'''2.3.1:''' Added new text screen editor to help create text screens (for example help pages), and copy the attributes and display commands to put into logics; added new logic syntax option that is compatible with original Sierra syntax; clicking include filenames in logic editor will open them for editing, same as resources; logic compiler will continue compiling even after an error is found so all errors can be detected in a single pass; added new print/display preview mode to picture editor to see how text added by print and display commands will look when added to screen; added new feature to picture editor to show small markers that show where displayed text characters would be aligned; snippets can now include tool tip 'help', similar to AGI commands; game directory is no longer editable on properties page; to move a game to a new directory, close WinAGI and move it manually with file explorer; color palette values (converted from MSDOS 18 bit to Windows 24 bit) were a bit off and have been fixed to be more precise; added support for programming games with the AGI Power Pack; replaced the 'Use txt as extension' setting with 'SourceFileExt' game property to allow for more options; in picture editor, when in pixel-select mode, Shift+MouseDown will drag the picture surface; the example image on the picture editor Load/Configure Background form is now set to the current picture image (based on current draw state); cel count is now a displayed as a readonly property when a loop is selected; snippets get saved automatically when the form is closed; palette data can be saved to any text file; a nagi.ini file is not required; fixed a major bug in the picture editor Add Coordinate function that would add invalid data in relative line commands; pressing view preview shortcut keys (w,a,s,d) no longer crashes WinAGI if a header is selected; fixed a bug in on main form so resizing and splitting works correctly; a lot of other minor bug fixes

'''2.2.6:''' Added a new TODO tracking function: comments in logics can be tagged as 'TODO' and will be tracked in the warning window, which makes it easier to keep track of things that you are deferring for later. Fixed bug in game property window that was not saving the Platform Options value if 'other' platform is selected. Fixed several minor bugs in renumber resource function. Fixed bug when double-clicking a resource in the tree that would not set focus to the newly opened resource. Added a menu option and shortcut to toggle warning window. Fixed a bug in compiler that would raise an error if a negative number was passed as a define constant. Added a notification in picture editor if an image file fails to open when using the configure background image dialog. Fixed a bug in view editor move-selection function that was improperly updating cel data. Resizing of a cel in view editor is now allowed regardless of selected tool. Fixed several other minor bugs

'''2.2.5:''' Fixed renumber function error when trying to check IsRoom property of a nonexistent logic. Template version check function now correctly identifies version and loads template games. Back up files now all use the same format ('oldname_OLD.ext'). Added mouse wheel support for preview window; picture and cel images can now be zoomed in or out using the mouse wheel. Double-clicking on logics and views will open the respective editor with the resource positioned to match the preview resource (logic scrolls to correct line, views open with correct loop/cel). Fixed bug in snippet function to correctly insert snippet text when snippet was not at beginning of a line. The compiler warning for a missing 'return()' command at end of a logic source now works correctly. Added new feature to shrink open editor windows when the warning/error pane gets displayed so the main form work area doesn't require scrolling. The picture editor join command now gets displayed when two adjacent commands that are eligible for joining are selected. Fixed major but in view editor selection move function incorrectly set cel data when the selection is left at starting position. Fixed a bug in the view editor fill tool that incorrectly filled cel border areas. Deleting or cutting a loop in the view editor now correctly updates the preview panel. The preview panel will now display correctly when view editor is first opened. Added a new transparent selection option for copy/cut/move/paste of cel data (the cel's TransColor value is used to hide pixels in the pasted data). Fixed a bug in the WORDS.TOK editor that caused it to fail in older versions of Windows. Added a new export option for WORDS.TOK to create word lists compatible with ScummVM's extended character support.

'''2.2.4:''' Snippet arguments can now be multi-word (spaces allowed). Typing when the snippet list is visible will now select items from the list. Fixed a major bug in the layout editor to correctly read version information (which prevented proper loading of layout files in v2.2.3). Fixed bug in resource renumber function that was causing layout editor to write invalid data to the layout file. Renumbering a logic that is also a room will now let you also renumber the matching room picture resource. Cleaned up the resource number selection form so text is displayed on the form correctly. Added a menu item and shortcut to the layout editor that opens the matching picture resource for editing when a room is selected.

'''2.2.3:''' Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows.

'''2.1.16:''' Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data.

'''2.1.15:''' Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_3_6.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.53 MB]</span>
** for source code, contact the [[Andrew_Korson|WinAGI author]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

Main Page

2024-02-14T06:26:06Z

Andrew Korson: /* News */

__NOTOC__
=== Welcome to the AGI Programmers Wiki. ===

A Wiki for the AGI Programming Community. '''A'''dventure '''G'''ame '''I'''nterpreter or [[AGI|AGI]] is the game engine created by Sierra On-line. It was succeeded by Sierra's SCI engine. It was used to create such games as [[King's Quest I: The Quest for the Crown|''King's Quest 1'']] to [[King's Quest III: To Heir Is Human|''III'']], [[Space Quest: Chapter I - The Sarien Encounter|''Space Quest I'']] & [[Space Quest II: Vohaul's Revenge|''II'']], [[Police Quest: In Pursuit of the Death Angel|''Police Quest I'']] and [[Leisure Suit Larry In the Land of the Lounge Lizards|''Leisure Suit Larry 1'']]. With the availability of such tools as [[AGI Studio]] and [[WinAGI]], you can create your own games based on the same engine that Sierra used. This Wiki is a knowledgebase and collection of resources for those working with AGI. Additional help can always be found on the [[SCIPF:|SCI Programming Community Message Board]]. For help with Sierra's games, see [[SHP:|The Sierra Help Pages]].

===<br /> News ===

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2023|February 14, 2024]]'''

* [[WinAGI]] version 2.3.6 is now available for download.
</div>
|}
{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|April 19, 2020]]'''

* [[Chris Cromer]] has released version 1.3.2 of the [[QT AGI Studio]] project. This update adds windows builds, a debian package, and fixes long time bugs in the view and picture editor.
</div>
|}

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|May 10, 2019]]'''

* [[Chris Cromer]] has forked the [[QT AGI Studio]] project and updated the code, it now compiles under GCC 7 and has a working 64 bit Linux binary.
</div>
|}
<blockquote class="offset">'''''[[Older News]]'''''</blockquote>

===<br /> Getting started ===

New here? Please take the time to visit the [[Community Portal]], which contains useful links for AGI and the AGI Wiki. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute. See [[#How to Contribute|How to Contribute]] below after you have received an account. 

===<br /> Links ===

Links for additional help and resources for help for your AGI needs.

[https://www.agifans.com/ www.agifans.com/] Lance Ewing's AGI site<br />

[http://sciprogramming.com SCI Programming.com http://sciprogramming.com]
: [http://sciprogramming.com/community/ AGI Programming Message Boards on SCIProgramming.com] http://sciprogramming.com/community/
: [http://sciprogramming.com/scitools.php AGI Tools on SCI Programming.com] http://sciprogramming.com/scitools.php
: [http://sciprogramming.com/fangames.php AGI fan games] http://sciprogramming.com/fangames.php
[http://agi.sierrahelp.com/Tools/ AGI Tools on the Sierra Help Pages] http://agi.sierrahelp.com/Tools/<br>

===<br /> How to Contribute ===

No registration is required to use this Wiki. Anyone can view the various topics and guides on the AGI Wiki. However, to add or edit pages, you must be [[Special:Userlogin|logged in]]. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute.

<blockquote>
====<br /> Notes for Editors: ====

Please familiarize yourself with [[Help:Contents | MediaWiki formatting]] before adding or editing pages. See the [[Notes_for_Editors|Notes for Editors]] page for AGI Wiki standards and news.
</blockquote>

 

[[Category:Wiki Help]]
[[Category:Wiki News]]

WinAGI

2024-02-14T06:25:27Z

Andrew Korson: /* Description */

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2023/12/13]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.3.5
| ReleaseDate = [[2024|2024/1/23]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

'''The current version of WinAGI is 2.3.6''': another minor bugfix in game import function

'''2.3.5:''': fixed bug that caused WinAGI to crash when importing a game; fixed some minor drag/drop issues; clarified in Help file that drag/drop will not work if program is run as administrator

'''2.3.4''': fixed major bug in Game Properties dialog that prevented selecting a folder for new games; global defines files that use LF as end-of-line instead of CRLF will now load properly

'''2.3.3:''' Replace All function modified so logic editors no longer reformat the screen each time a replacement is made - this improves performance when replacing in very large source files; TAB key behaves as expected on Find form; fixed bug in Game About and Game Version property textbox so it correctly adds '\n' codes for CTRL+ENTER; fixed zoom control on picture previews to correctly place the picture when shrinking it small enough to fit inside the preview window; added a new decompile mode that is like VS style, but keeps 'else' and its preceding/following brackets all on one line; when opening a layout file, if the correct filename is not found, WinAGI checks for a file with same name as the WAG file - if found, that file should be renamed to be the correct WAL file, otherwise old file will stay around; in text screen editor, if a copied display command has text with parentheses in it, the parser for pasting the command now works correctly; in text screen editor, loading a screen file that doesn't match current colwidth needs to make sure the colwidth mode matches

'''2.3.2:''' added file drag/drop support for main window; the Find dialog now remembers last ten search terms; added toolbar buttons to the logic editor for indent/outdent; when importing or opening a game, resource errors that don't prevent compiling or running a game are now included as warnings in the warning list; when importing a game, the decompiler will use the gameid found in the game's set.game.id' command, if found; added option to copy picture draw commands to clipboard as readable text; added new readonly mode to words editor that sorts all words alphabetically; the Game Property form now groups the properties into four tabs; with more room on the tabs the properties are now better arranged; many minor enhancements and bugfixes

'''2.3.1:''' Added new text screen editor to help create text screens (for example help pages), and copy the attributes and display commands to put into logics; added new logic syntax option that is compatible with original Sierra syntax; clicking include filenames in logic editor will open them for editing, same as resources; logic compiler will continue compiling even after an error is found so all errors can be detected in a single pass; added new print/display preview mode to picture editor to see how text added by print and display commands will look when added to screen; added new feature to picture editor to show small markers that show where displayed text characters would be aligned; snippets can now include tool tip 'help', similar to AGI commands; game directory is no longer editable on properties page; to move a game to a new directory, close WinAGI and move it manually with file explorer; color palette values (converted from MSDOS 18 bit to Windows 24 bit) were a bit off and have been fixed to be more precise; added support for programming games with the AGI Power Pack; replaced the 'Use txt as extension' setting with 'SourceFileExt' game property to allow for more options; in picture editor, when in pixel-select mode, Shift+MouseDown will drag the picture surface; the example image on the picture editor Load/Configure Background form is now set to the current picture image (based on current draw state); cel count is now a displayed as a readonly property when a loop is selected; snippets get saved automatically when the form is closed; palette data can be saved to any text file; a nagi.ini file is not required; fixed a major bug in the picture editor Add Coordinate function that would add invalid data in relative line commands; pressing view preview shortcut keys (w,a,s,d) no longer crashes WinAGI if a header is selected; fixed a bug in on main form so resizing and splitting works correctly; a lot of other minor bug fixes

'''2.2.6:''' Added a new TODO tracking function: comments in logics can be tagged as 'TODO' and will be tracked in the warning window, which makes it easier to keep track of things that you are deferring for later. Fixed bug in game property window that was not saving the Platform Options value if 'other' platform is selected. Fixed several minor bugs in renumber resource function. Fixed bug when double-clicking a resource in the tree that would not set focus to the newly opened resource. Added a menu option and shortcut to toggle warning window. Fixed a bug in compiler that would raise an error if a negative number was passed as a define constant. Added a notification in picture editor if an image file fails to open when using the configure background image dialog. Fixed a bug in view editor move-selection function that was improperly updating cel data. Resizing of a cel in view editor is now allowed regardless of selected tool. Fixed several other minor bugs

'''2.2.5:''' Fixed renumber function error when trying to check IsRoom property of a nonexistent logic. Template version check function now correctly identifies version and loads template games. Back up files now all use the same format ('oldname_OLD.ext'). Added mouse wheel support for preview window; picture and cel images can now be zoomed in or out using the mouse wheel. Double-clicking on logics and views will open the respective editor with the resource positioned to match the preview resource (logic scrolls to correct line, views open with correct loop/cel). Fixed bug in snippet function to correctly insert snippet text when snippet was not at beginning of a line. The compiler warning for a missing 'return()' command at end of a logic source now works correctly. Added new feature to shrink open editor windows when the warning/error pane gets displayed so the main form work area doesn't require scrolling. The picture editor join command now gets displayed when two adjacent commands that are eligible for joining are selected. Fixed major but in view editor selection move function incorrectly set cel data when the selection is left at starting position. Fixed a bug in the view editor fill tool that incorrectly filled cel border areas. Deleting or cutting a loop in the view editor now correctly updates the preview panel. The preview panel will now display correctly when view editor is first opened. Added a new transparent selection option for copy/cut/move/paste of cel data (the cel's TransColor value is used to hide pixels in the pasted data). Fixed a bug in the WORDS.TOK editor that caused it to fail in older versions of Windows. Added a new export option for WORDS.TOK to create word lists compatible with ScummVM's extended character support.

'''2.2.4:''' Snippet arguments can now be multi-word (spaces allowed). Typing when the snippet list is visible will now select items from the list. Fixed a major bug in the layout editor to correctly read version information (which prevented proper loading of layout files in v2.2.3). Fixed bug in resource renumber function that was causing layout editor to write invalid data to the layout file. Renumbering a logic that is also a room will now let you also renumber the matching room picture resource. Cleaned up the resource number selection form so text is displayed on the form correctly. Added a menu item and shortcut to the layout editor that opens the matching picture resource for editing when a room is selected.

'''2.2.3:''' Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows.

'''2.1.16:''' Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data.

'''2.1.15:''' Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_3_6.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.53 MB]</span>
** for source code, contact the [[Andrew_Korson|WinAGI author]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

WinAGI

2024-02-14T06:18:57Z

Andrew Korson: /* Download */

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2023/12/13]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.3.5
| ReleaseDate = [[2024|2024/1/23]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

'''The current version of WinAGI is 2.3.5''': fixed major bug in '''The current version of WinAGI is 2.3.4''': fixed major bug in Game Properties dialog that prevented selecting a folder for new games; global defines files that use LF as end-of-line instead of CRLF will now load properly

'''2.3.4:''': fixed bug that caused WinAGI to crash when importing a game

'''2.3.3:''' Replace All function modified so logic editors no longer reformat the screen each time a replacement is made - this improves performance when replacing in very large source files; TAB key behaves as expected on Find form; fixed bug in Game About and Game Version property textbox so it correctly adds '\n' codes for CTRL+ENTER; fixed zoom control on picture previews to correctly place the picture when shrinking it small enough to fit inside the preview window; added a new decompile mode that is like VS style, but keeps 'else' and its preceding/following brackets all on one line; when opening a layout file, if the correct filename is not found, WinAGI checks for a file with same name as the WAG file - if found, that file should be renamed to be the correct WAL file, otherwise old file will stay around; in text screen editor, if a copied display command has text with parentheses in it, the parser for pasting the command now works correctly; in text screen editor, loading a screen file that doesn't match current colwidth needs to make sure the colwidth mode matches

'''2.3.2:''' added file drag/drop support for main window; the Find dialog now remembers last ten search terms; added toolbar buttons to the logic editor for indent/outdent; when importing or opening a game, resource errors that don't prevent compiling or running a game are now included as warnings in the warning list; when importing a game, the decompiler will use the gameid found in the game's set.game.id' command, if found; added option to copy picture draw commands to clipboard as readable text; added new readonly mode to words editor that sorts all words alphabetically; the Game Property form now groups the properties into four tabs; with more room on the tabs the properties are now better arranged; many minor enhancements and bugfixes

'''2.3.1:''' Added new text screen editor to help create text screens (for example help pages), and copy the attributes and display commands to put into logics; added new logic syntax option that is compatible with original Sierra syntax; clicking include filenames in logic editor will open them for editing, same as resources; logic compiler will continue compiling even after an error is found so all errors can be detected in a single pass; added new print/display preview mode to picture editor to see how text added by print and display commands will look when added to screen; added new feature to picture editor to show small markers that show where displayed text characters would be aligned; snippets can now include tool tip 'help', similar to AGI commands; game directory is no longer editable on properties page; to move a game to a new directory, close WinAGI and move it manually with file explorer; color palette values (converted from MSDOS 18 bit to Windows 24 bit) were a bit off and have been fixed to be more precise; added support for programming games with the AGI Power Pack; replaced the 'Use txt as extension' setting with 'SourceFileExt' game property to allow for more options; in picture editor, when in pixel-select mode, Shift+MouseDown will drag the picture surface; the example image on the picture editor Load/Configure Background form is now set to the current picture image (based on current draw state); cel count is now a displayed as a readonly property when a loop is selected; snippets get saved automatically when the form is closed; palette data can be saved to any text file; a nagi.ini file is not required; fixed a major bug in the picture editor Add Coordinate function that would add invalid data in relative line commands; pressing view preview shortcut keys (w,a,s,d) no longer crashes WinAGI if a header is selected; fixed a bug in on main form so resizing and splitting works correctly; a lot of other minor bug fixes

'''2.2.6:''' Added a new TODO tracking function: comments in logics can be tagged as 'TODO' and will be tracked in the warning window, which makes it easier to keep track of things that you are deferring for later. Fixed bug in game property window that was not saving the Platform Options value if 'other' platform is selected. Fixed several minor bugs in renumber resource function. Fixed bug when double-clicking a resource in the tree that would not set focus to the newly opened resource. Added a menu option and shortcut to toggle warning window. Fixed a bug in compiler that would raise an error if a negative number was passed as a define constant. Added a notification in picture editor if an image file fails to open when using the configure background image dialog. Fixed a bug in view editor move-selection function that was improperly updating cel data. Resizing of a cel in view editor is now allowed regardless of selected tool. Fixed several other minor bugs

'''2.2.5:''' Fixed renumber function error when trying to check IsRoom property of a nonexistent logic. Template version check function now correctly identifies version and loads template games. Back up files now all use the same format ('oldname_OLD.ext'). Added mouse wheel support for preview window; picture and cel images can now be zoomed in or out using the mouse wheel. Double-clicking on logics and views will open the respective editor with the resource positioned to match the preview resource (logic scrolls to correct line, views open with correct loop/cel). Fixed bug in snippet function to correctly insert snippet text when snippet was not at beginning of a line. The compiler warning for a missing 'return()' command at end of a logic source now works correctly. Added new feature to shrink open editor windows when the warning/error pane gets displayed so the main form work area doesn't require scrolling. The picture editor join command now gets displayed when two adjacent commands that are eligible for joining are selected. Fixed major but in view editor selection move function incorrectly set cel data when the selection is left at starting position. Fixed a bug in the view editor fill tool that incorrectly filled cel border areas. Deleting or cutting a loop in the view editor now correctly updates the preview panel. The preview panel will now display correctly when view editor is first opened. Added a new transparent selection option for copy/cut/move/paste of cel data (the cel's TransColor value is used to hide pixels in the pasted data). Fixed a bug in the WORDS.TOK editor that caused it to fail in older versions of Windows. Added a new export option for WORDS.TOK to create word lists compatible with ScummVM's extended character support.

'''2.2.4:''' Snippet arguments can now be multi-word (spaces allowed). Typing when the snippet list is visible will now select items from the list. Fixed a major bug in the layout editor to correctly read version information (which prevented proper loading of layout files in v2.2.3). Fixed bug in resource renumber function that was causing layout editor to write invalid data to the layout file. Renumbering a logic that is also a room will now let you also renumber the matching room picture resource. Cleaned up the resource number selection form so text is displayed on the form correctly. Added a menu item and shortcut to the layout editor that opens the matching picture resource for editing when a room is selected.

'''2.2.3:''' Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows.

'''2.1.16:''' Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data.

'''2.1.15:''' Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_3_6.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.53 MB]</span>
** for source code, contact the [[Andrew_Korson|WinAGI author]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

File:WinAGI 2 3 6.zip

2024-02-14T06:18:25Z

Andrew Korson:

File:WinAGI 2 3 5.zip

2024-01-24T07:48:26Z

Andrew Korson:

WinAGI

2024-01-24T07:47:28Z

Andrew Korson:

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2023/12/13]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.3.5
| ReleaseDate = [[2024|2024/1/23]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

'''The current version of WinAGI is 2.3.5''': fixed major bug in '''The current version of WinAGI is 2.3.4''': fixed major bug in Game Properties dialog that prevented selecting a folder for new games; global defines files that use LF as end-of-line instead of CRLF will now load properly

'''2.3.4:''': fixed bug that caused WinAGI to crash when importing a game

'''2.3.3:''' Replace All function modified so logic editors no longer reformat the screen each time a replacement is made - this improves performance when replacing in very large source files; TAB key behaves as expected on Find form; fixed bug in Game About and Game Version property textbox so it correctly adds '\n' codes for CTRL+ENTER; fixed zoom control on picture previews to correctly place the picture when shrinking it small enough to fit inside the preview window; added a new decompile mode that is like VS style, but keeps 'else' and its preceding/following brackets all on one line; when opening a layout file, if the correct filename is not found, WinAGI checks for a file with same name as the WAG file - if found, that file should be renamed to be the correct WAL file, otherwise old file will stay around; in text screen editor, if a copied display command has text with parentheses in it, the parser for pasting the command now works correctly; in text screen editor, loading a screen file that doesn't match current colwidth needs to make sure the colwidth mode matches

'''2.3.2:''' added file drag/drop support for main window; the Find dialog now remembers last ten search terms; added toolbar buttons to the logic editor for indent/outdent; when importing or opening a game, resource errors that don't prevent compiling or running a game are now included as warnings in the warning list; when importing a game, the decompiler will use the gameid found in the game's set.game.id' command, if found; added option to copy picture draw commands to clipboard as readable text; added new readonly mode to words editor that sorts all words alphabetically; the Game Property form now groups the properties into four tabs; with more room on the tabs the properties are now better arranged; many minor enhancements and bugfixes

'''2.3.1:''' Added new text screen editor to help create text screens (for example help pages), and copy the attributes and display commands to put into logics; added new logic syntax option that is compatible with original Sierra syntax; clicking include filenames in logic editor will open them for editing, same as resources; logic compiler will continue compiling even after an error is found so all errors can be detected in a single pass; added new print/display preview mode to picture editor to see how text added by print and display commands will look when added to screen; added new feature to picture editor to show small markers that show where displayed text characters would be aligned; snippets can now include tool tip 'help', similar to AGI commands; game directory is no longer editable on properties page; to move a game to a new directory, close WinAGI and move it manually with file explorer; color palette values (converted from MSDOS 18 bit to Windows 24 bit) were a bit off and have been fixed to be more precise; added support for programming games with the AGI Power Pack; replaced the 'Use txt as extension' setting with 'SourceFileExt' game property to allow for more options; in picture editor, when in pixel-select mode, Shift+MouseDown will drag the picture surface; the example image on the picture editor Load/Configure Background form is now set to the current picture image (based on current draw state); cel count is now a displayed as a readonly property when a loop is selected; snippets get saved automatically when the form is closed; palette data can be saved to any text file; a nagi.ini file is not required; fixed a major bug in the picture editor Add Coordinate function that would add invalid data in relative line commands; pressing view preview shortcut keys (w,a,s,d) no longer crashes WinAGI if a header is selected; fixed a bug in on main form so resizing and splitting works correctly; a lot of other minor bug fixes

'''2.2.6:''' Added a new TODO tracking function: comments in logics can be tagged as 'TODO' and will be tracked in the warning window, which makes it easier to keep track of things that you are deferring for later. Fixed bug in game property window that was not saving the Platform Options value if 'other' platform is selected. Fixed several minor bugs in renumber resource function. Fixed bug when double-clicking a resource in the tree that would not set focus to the newly opened resource. Added a menu option and shortcut to toggle warning window. Fixed a bug in compiler that would raise an error if a negative number was passed as a define constant. Added a notification in picture editor if an image file fails to open when using the configure background image dialog. Fixed a bug in view editor move-selection function that was improperly updating cel data. Resizing of a cel in view editor is now allowed regardless of selected tool. Fixed several other minor bugs

'''2.2.5:''' Fixed renumber function error when trying to check IsRoom property of a nonexistent logic. Template version check function now correctly identifies version and loads template games. Back up files now all use the same format ('oldname_OLD.ext'). Added mouse wheel support for preview window; picture and cel images can now be zoomed in or out using the mouse wheel. Double-clicking on logics and views will open the respective editor with the resource positioned to match the preview resource (logic scrolls to correct line, views open with correct loop/cel). Fixed bug in snippet function to correctly insert snippet text when snippet was not at beginning of a line. The compiler warning for a missing 'return()' command at end of a logic source now works correctly. Added new feature to shrink open editor windows when the warning/error pane gets displayed so the main form work area doesn't require scrolling. The picture editor join command now gets displayed when two adjacent commands that are eligible for joining are selected. Fixed major but in view editor selection move function incorrectly set cel data when the selection is left at starting position. Fixed a bug in the view editor fill tool that incorrectly filled cel border areas. Deleting or cutting a loop in the view editor now correctly updates the preview panel. The preview panel will now display correctly when view editor is first opened. Added a new transparent selection option for copy/cut/move/paste of cel data (the cel's TransColor value is used to hide pixels in the pasted data). Fixed a bug in the WORDS.TOK editor that caused it to fail in older versions of Windows. Added a new export option for WORDS.TOK to create word lists compatible with ScummVM's extended character support.

'''2.2.4:''' Snippet arguments can now be multi-word (spaces allowed). Typing when the snippet list is visible will now select items from the list. Fixed a major bug in the layout editor to correctly read version information (which prevented proper loading of layout files in v2.2.3). Fixed bug in resource renumber function that was causing layout editor to write invalid data to the layout file. Renumbering a logic that is also a room will now let you also renumber the matching room picture resource. Cleaned up the resource number selection form so text is displayed on the form correctly. Added a menu item and shortcut to the layout editor that opens the matching picture resource for editing when a room is selected.

'''2.2.3:''' Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows.

'''2.1.16:''' Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data.

'''2.1.15:''' Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_3_5.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.53 MB]</span>
** for source code, contact the [[Andrew_Korson|WinAGI author]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

WinAGI

2024-01-13T03:58:32Z

Andrew Korson:

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2023/12/13]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.3.4
| ReleaseDate = [[2024|2024/1/12]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

'''The current version of WinAGI is 2.3.4''': fixed major bug in Game Properties dialog that prevented selecting a folder for new games; global defines files that use LF as end-of-line instead of CRLF will now load properly

'''2.3.3''': Replace All function modified so logic editors no longer reformat the screen each time a replacement is made - this improves performance when replacing in very large source files; TAB key behaves as expected on Find form; fixed bug in Game About and Game Version property textbox so it correctly adds '\n' codes for CTRL+ENTER; fixed zoom control on picture previews to correctly place the picture when shrinking it small enough to fit inside the preview window; added a new decompile mode that is like VS style, but keeps 'else' and its preceding/following brackets all on one line; when opening a layout file, if the correct filename is not found, WinAGI checks for a file with same name as the WAG file - if found, that file should be renamed to be the correct WAL file, otherwise old file will stay around; in text screen editor, if a copied display command has text with parentheses in it, the parser for pasting the command now works correctly; in text screen editor, loading a screen file that doesn't match current colwidth needs to make sure the colwidth mode matches

'''2.3.2:''' added file drag/drop support for main window; the Find dialog now remembers last ten search terms; added toolbar buttons to the logic editor for indent/outdent; when importing or opening a game, resource errors that don't prevent compiling or running a game are now included as warnings in the warning list; when importing a game, the decompiler will use the gameid found in the game's set.game.id' command, if found; added option to copy picture draw commands to clipboard as readable text; added new readonly mode to words editor that sorts all words alphabetically; the Game Property form now groups the properties into four tabs; with more room on the tabs the properties are now better arranged; many minor enhancements and bugfixes

'''2.3.1:''' Added new text screen editor to help create text screens (for example help pages), and copy the attributes and display commands to put into logics; added new logic syntax option that is compatible with original Sierra syntax; clicking include filenames in logic editor will open them for editing, same as resources; logic compiler will continue compiling even after an error is found so all errors can be detected in a single pass; added new print/display preview mode to picture editor to see how text added by print and display commands will look when added to screen; added new feature to picture editor to show small markers that show where displayed text characters would be aligned; snippets can now include tool tip 'help', similar to AGI commands; game directory is no longer editable on properties page; to move a game to a new directory, close WinAGI and move it manually with file explorer; color palette values (converted from MSDOS 18 bit to Windows 24 bit) were a bit off and have been fixed to be more precise; added support for programming games with the AGI Power Pack; replaced the 'Use txt as extension' setting with 'SourceFileExt' game property to allow for more options; in picture editor, when in pixel-select mode, Shift+MouseDown will drag the picture surface; the example image on the picture editor Load/Configure Background form is now set to the current picture image (based on current draw state); cel count is now a displayed as a readonly property when a loop is selected; snippets get saved automatically when the form is closed; palette data can be saved to any text file; a nagi.ini file is not required; fixed a major bug in the picture editor Add Coordinate function that would add invalid data in relative line commands; pressing view preview shortcut keys (w,a,s,d) no longer crashes WinAGI if a header is selected; fixed a bug in on main form so resizing and splitting works correctly; a lot of other minor bug fixes

'''2.2.6:''' Added a new TODO tracking function: comments in logics can be tagged as 'TODO' and will be tracked in the warning window, which makes it easier to keep track of things that you are deferring for later. Fixed bug in game property window that was not saving the Platform Options value if 'other' platform is selected. Fixed several minor bugs in renumber resource function. Fixed bug when double-clicking a resource in the tree that would not set focus to the newly opened resource. Added a menu option and shortcut to toggle warning window. Fixed a bug in compiler that would raise an error if a negative number was passed as a define constant. Added a notification in picture editor if an image file fails to open when using the configure background image dialog. Fixed a bug in view editor move-selection function that was improperly updating cel data. Resizing of a cel in view editor is now allowed regardless of selected tool. Fixed several other minor bugs

'''2.2.5:''' Fixed renumber function error when trying to check IsRoom property of a nonexistent logic. Template version check function now correctly identifies version and loads template games. Back up files now all use the same format ('oldname_OLD.ext'). Added mouse wheel support for preview window; picture and cel images can now be zoomed in or out using the mouse wheel. Double-clicking on logics and views will open the respective editor with the resource positioned to match the preview resource (logic scrolls to correct line, views open with correct loop/cel). Fixed bug in snippet function to correctly insert snippet text when snippet was not at beginning of a line. The compiler warning for a missing 'return()' command at end of a logic source now works correctly. Added new feature to shrink open editor windows when the warning/error pane gets displayed so the main form work area doesn't require scrolling. The picture editor join command now gets displayed when two adjacent commands that are eligible for joining are selected. Fixed major but in view editor selection move function incorrectly set cel data when the selection is left at starting position. Fixed a bug in the view editor fill tool that incorrectly filled cel border areas. Deleting or cutting a loop in the view editor now correctly updates the preview panel. The preview panel will now display correctly when view editor is first opened. Added a new transparent selection option for copy/cut/move/paste of cel data (the cel's TransColor value is used to hide pixels in the pasted data). Fixed a bug in the WORDS.TOK editor that caused it to fail in older versions of Windows. Added a new export option for WORDS.TOK to create word lists compatible with ScummVM's extended character support.

'''2.2.4:''' Snippet arguments can now be multi-word (spaces allowed). Typing when the snippet list is visible will now select items from the list. Fixed a major bug in the layout editor to correctly read version information (which prevented proper loading of layout files in v2.2.3). Fixed bug in resource renumber function that was causing layout editor to write invalid data to the layout file. Renumbering a logic that is also a room will now let you also renumber the matching room picture resource. Cleaned up the resource number selection form so text is displayed on the form correctly. Added a menu item and shortcut to the layout editor that opens the matching picture resource for editing when a room is selected.

'''2.2.3:''' Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows.

'''2.1.16:''' Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data.

'''2.1.15:''' Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_3_4.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.53 MB]</span>
** [[File:WinAGI_2-1-14source.zip|Source code]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

File:WinAGI 2 3 4.zip

2024-01-13T03:55:23Z

Andrew Korson:

File:WinAGI 2 3 3.zip

2023-12-14T02:07:35Z

Andrew Korson:

WinAGI

2023-12-14T02:00:17Z

Andrew Korson:

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2023/12/13]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.3.3
| ReleaseDate = [[2023|2023/12/13]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

'''The current version of WinAGI is 2.3.3''': Replace All function modified so logic editors no longer reformat the screen each time a replacement is made - this improves performance when replacing in very large source files; TAB key behaves as expected on Find form; fixed bug in Game About and Game Version property textbox so it correctly adds '\n' codes for CTRL+ENTER; fixed zoom control on picture previews to correctly place the picture when shrinking it small enough to fit inside the preview window; added a new decompile mode that is like VS style, but keeps 'else' and its preceding/following brackets all on one line; when opening a layout file, if the correct filename is not found, WinAGI checks for a file with same name as the WAG file - if found, that file should be renamed to be the correct WAL file, otherwise old file will stay around; in text screen editor, if a copied display command has text with parentheses in it, the parser for pasting the command now works correctly; in text screen editor, loading a screen file that doesn't match current colwidth needs to make sure the colwidth mode matches

'''WinAGI is 2.3.2:''' added file drag/drop support for main window; the Find dialog now remembers last ten search terms; added toolbar buttons to the logic editor for indent/outdent; when importing or opening a game, resource errors that don't prevent compiling or running a game are now included as warnings in the warning list; when importing a game, the decompiler will use the gameid found in the game's set.game.id' command, if found; added option to copy picture draw commands to clipboard as readable text; added new readonly mode to words editor that sorts all words alphabetically; the Game Property form now groups the properties into four tabs; with more room on the tabs the properties are now better arranged; many minor enhancements and bugfixes

'''2.3.1:''' Added new text screen editor to help create text screens (for example help pages), and copy the attributes and display commands to put into logics; added new logic syntax option that is compatible with original Sierra syntax; clicking include filenames in logic editor will open them for editing, same as resources; logic compiler will continue compiling even after an error is found so all errors can be detected in a single pass; added new print/display preview mode to picture editor to see how text added by print and display commands will look when added to screen; added new feature to picture editor to show small markers that show where displayed text characters would be aligned; snippets can now include tool tip 'help', similar to AGI commands; game directory is no longer editable on properties page; to move a game to a new directory, close WinAGI and move it manually with file explorer; color palette values (converted from MSDOS 18 bit to Windows 24 bit) were a bit off and have been fixed to be more precise; added support for programming games with the AGI Power Pack; replaced the 'Use txt as extension' setting with 'SourceFileExt' game property to allow for more options; in picture editor, when in pixel-select mode, Shift+MouseDown will drag the picture surface; the example image on the picture editor Load/Configure Background form is now set to the current picture image (based on current draw state); cel count is now a displayed as a readonly property when a loop is selected; snippets get saved automatically when the form is closed; palette data can be saved to any text file; a nagi.ini file is not required; fixed a major bug in the picture editor Add Coordinate function that would add invalid data in relative line commands; pressing view preview shortcut keys (w,a,s,d) no longer crashes WinAGI if a header is selected; fixed a bug in on main form so resizing and splitting works correctly; a lot of other minor bug fixes

'''2.2.6:''' Added a new TODO tracking function: comments in logics can be tagged as 'TODO' and will be tracked in the warning window, which makes it easier to keep track of things that you are deferring for later. Fixed bug in game property window that was not saving the Platform Options value if 'other' platform is selected. Fixed several minor bugs in renumber resource function. Fixed bug when double-clicking a resource in the tree that would not set focus to the newly opened resource. Added a menu option and shortcut to toggle warning window. Fixed a bug in compiler that would raise an error if a negative number was passed as a define constant. Added a notification in picture editor if an image file fails to open when using the configure background image dialog. Fixed a bug in view editor move-selection function that was improperly updating cel data. Resizing of a cel in view editor is now allowed regardless of selected tool. Fixed several other minor bugs

'''2.2.5:''' Fixed renumber function error when trying to check IsRoom property of a nonexistent logic. Template version check function now correctly identifies version and loads template games. Back up files now all use the same format ('oldname_OLD.ext'). Added mouse wheel support for preview window; picture and cel images can now be zoomed in or out using the mouse wheel. Double-clicking on logics and views will open the respective editor with the resource positioned to match the preview resource (logic scrolls to correct line, views open with correct loop/cel). Fixed bug in snippet function to correctly insert snippet text when snippet was not at beginning of a line. The compiler warning for a missing 'return()' command at end of a logic source now works correctly. Added new feature to shrink open editor windows when the warning/error pane gets displayed so the main form work area doesn't require scrolling. The picture editor join command now gets displayed when two adjacent commands that are eligible for joining are selected. Fixed major but in view editor selection move function incorrectly set cel data when the selection is left at starting position. Fixed a bug in the view editor fill tool that incorrectly filled cel border areas. Deleting or cutting a loop in the view editor now correctly updates the preview panel. The preview panel will now display correctly when view editor is first opened. Added a new transparent selection option for copy/cut/move/paste of cel data (the cel's TransColor value is used to hide pixels in the pasted data). Fixed a bug in the WORDS.TOK editor that caused it to fail in older versions of Windows. Added a new export option for WORDS.TOK to create word lists compatible with ScummVM's extended character support.

'''2.2.4:''' Snippet arguments can now be multi-word (spaces allowed). Typing when the snippet list is visible will now select items from the list. Fixed a major bug in the layout editor to correctly read version information (which prevented proper loading of layout files in v2.2.3). Fixed bug in resource renumber function that was causing layout editor to write invalid data to the layout file. Renumbering a logic that is also a room will now let you also renumber the matching room picture resource. Cleaned up the resource number selection form so text is displayed on the form correctly. Added a menu item and shortcut to the layout editor that opens the matching picture resource for editing when a room is selected.

'''2.2.3:''' Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows.

'''2.1.16:''' Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data.

'''2.1.15:''' Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_3_3.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.53 MB]</span>
** [[File:WinAGI_2-1-14source.zip|Source code]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

Main Page

2023-11-04T16:33:45Z

Andrew Korson: /* News */

__NOTOC__
=== Welcome to the AGI Programmers Wiki. ===

A Wiki for the AGI Programming Community. '''A'''dventure '''G'''ame '''I'''nterpreter or [[AGI|AGI]] is the game engine created by Sierra On-line. It was succeeded by Sierra's SCI engine. It was used to create such games as [[King's Quest I: The Quest for the Crown|''King's Quest 1'']] to [[King's Quest III: To Heir Is Human|''III'']], [[Space Quest: Chapter I - The Sarien Encounter|''Space Quest I'']] & [[Space Quest II: Vohaul's Revenge|''II'']], [[Police Quest: In Pursuit of the Death Angel|''Police Quest I'']] and [[Leisure Suit Larry In the Land of the Lounge Lizards|''Leisure Suit Larry 1'']]. With the availability of such tools as [[AGI Studio]] and [[WinAGI]], you can create your own games based on the same engine that Sierra used. This Wiki is a knowledgebase and collection of resources for those working with AGI. Additional help can always be found on the [[SCIPF:|SCI Programming Community Message Board]]. For help with Sierra's games, see [[SHP:|The Sierra Help Pages]].

===<br /> News ===

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2023|November 4, 2023]]'''

* [[WinAGI]] version 2.3.2 is now available for download.
</div>
|}
{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|April 19, 2020]]'''

* [[Chris Cromer]] has released version 1.3.2 of the [[QT AGI Studio]] project. This update adds windows builds, a debian package, and fixes long time bugs in the view and picture editor.
</div>
|}

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|May 10, 2019]]'''

* [[Chris Cromer]] has forked the [[QT AGI Studio]] project and updated the code, it now compiles under GCC 7 and has a working 64 bit Linux binary.
</div>
|}
<blockquote class="offset">'''''[[Older News]]'''''</blockquote>

===<br /> Getting started ===

New here? Please take the time to visit the [[Community Portal]], which contains useful links for AGI and the AGI Wiki. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute. See [[#How to Contribute|How to Contribute]] below after you have received an account. 

===<br /> Links ===

Links for additional help and resources for help for your AGI needs.

[https://www.agifans.com/ www.agifans.com/] Lance Ewing's AGI site<br />

[http://sciprogramming.com SCI Programming.com http://sciprogramming.com]
: [http://sciprogramming.com/community/ AGI Programming Message Boards on SCIProgramming.com] http://sciprogramming.com/community/
: [http://sciprogramming.com/scitools.php AGI Tools on SCI Programming.com] http://sciprogramming.com/scitools.php
: [http://sciprogramming.com/fangames.php AGI fan games] http://sciprogramming.com/fangames.php
[http://agi.sierrahelp.com/Tools/ AGI Tools on the Sierra Help Pages] http://agi.sierrahelp.com/Tools/<br>

===<br /> How to Contribute ===

No registration is required to use this Wiki. Anyone can view the various topics and guides on the AGI Wiki. However, to add or edit pages, you must be [[Special:Userlogin|logged in]]. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute.

<blockquote>
====<br /> Notes for Editors: ====

Please familiarize yourself with [[Help:Contents | MediaWiki formatting]] before adding or editing pages. See the [[Notes_for_Editors|Notes for Editors]] page for AGI Wiki standards and news.
</blockquote>

 

[[Category:Wiki Help]]
[[Category:Wiki News]]

WinAGI

2023-11-04T16:32:56Z

Andrew Korson: release v2.3.2

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2023/11/04]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.3.2
| ReleaseDate = [[2023|2023/11/04]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

'''The current version of WinAGI is 2.3.2''' added file drag/drop support for main window; the Find dialog now remembers last ten search terms; added toolbar buttons to the logic editor for indent/outdent; when importing or opening a game, resource errors that don't prevent compiling or running a game are now included as warnings in the warning list; when importing a game, the decompiler will use the gameid found in the game's set.game.id' command, if found; added option to copy picture draw commands to clipboard as readable text; added new readonly mode to words editor that sorts all words alphabetically; the Game Property form now groups the properties into four tabs; with more room on the tabs the properties are now better arranged; many minor enhancements and bugfixes

'''2.3.1:''' Added new text screen editor to help create text screens (for example help pages), and copy the attributes and display commands to put into logics; added new logic syntax option that is compatible with original Sierra syntax; clicking include filenames in logic editor will open them for editing, same as resources; logic compiler will continue compiling even after an error is found so all errors can be detected in a single pass; added new print/display preview mode to picture editor to see how text added by print and display commands will look when added to screen; added new feature to picture editor to show small markers that show where displayed text characters would be aligned; snippets can now include tool tip 'help', similar to AGI commands; game directory is no longer editable on properties page; to move a game to a new directory, close WinAGI and move it manually with file explorer; color palette values (converted from MSDOS 18 bit to Windows 24 bit) were a bit off and have been fixed to be more precise; added support for programming games with the AGI Power Pack; replaced the 'Use txt as extension' setting with 'SourceFileExt' game property to allow for more options; in picture editor, when in pixel-select mode, Shift+MouseDown will drag the picture surface; the example image on the picture editor Load/Configure Background form is now set to the current picture image (based on current draw state); cel count is now a displayed as a readonly property when a loop is selected; snippets get saved automatically when the form is closed; palette data can be saved to any text file; a nagi.ini file is not required; fixed a major bug in the picture editor Add Coordinate function that would add invalid data in relative line commands; pressing view preview shortcut keys (w,a,s,d) no longer crashes WinAGI if a header is selected; fixed a bug in on main form so resizing and splitting works correctly; a lot of other minor bug fixes

'''2.2.6:''' Added a new TODO tracking function: comments in logics can be tagged as 'TODO' and will be tracked in the warning window, which makes it easier to keep track of things that you are deferring for later. Fixed bug in game property window that was not saving the Platform Options value if 'other' platform is selected. Fixed several minor bugs in renumber resource function. Fixed bug when double-clicking a resource in the tree that would not set focus to the newly opened resource. Added a menu option and shortcut to toggle warning window. Fixed a bug in compiler that would raise an error if a negative number was passed as a define constant. Added a notification in picture editor if an image file fails to open when using the configure background image dialog. Fixed a bug in view editor move-selection function that was improperly updating cel data. Resizing of a cel in view editor is now allowed regardless of selected tool. Fixed several other minor bugs

'''2.2.5:''' Fixed renumber function error when trying to check IsRoom property of a nonexistent logic. Template version check function now correctly identifies version and loads template games. Back up files now all use the same format ('oldname_OLD.ext'). Added mouse wheel support for preview window; picture and cel images can now be zoomed in or out using the mouse wheel. Double-clicking on logics and views will open the respective editor with the resource positioned to match the preview resource (logic scrolls to correct line, views open with correct loop/cel). Fixed bug in snippet function to correctly insert snippet text when snippet was not at beginning of a line. The compiler warning for a missing 'return()' command at end of a logic source now works correctly. Added new feature to shrink open editor windows when the warning/error pane gets displayed so the main form work area doesn't require scrolling. The picture editor join command now gets displayed when two adjacent commands that are eligible for joining are selected. Fixed major but in view editor selection move function incorrectly set cel data when the selection is left at starting position. Fixed a bug in the view editor fill tool that incorrectly filled cel border areas. Deleting or cutting a loop in the view editor now correctly updates the preview panel. The preview panel will now display correctly when view editor is first opened. Added a new transparent selection option for copy/cut/move/paste of cel data (the cel's TransColor value is used to hide pixels in the pasted data). Fixed a bug in the WORDS.TOK editor that caused it to fail in older versions of Windows. Added a new export option for WORDS.TOK to create word lists compatible with ScummVM's extended character support.

'''2.2.4:''' Snippet arguments can now be multi-word (spaces allowed). Typing when the snippet list is visible will now select items from the list. Fixed a major bug in the layout editor to correctly read version information (which prevented proper loading of layout files in v2.2.3). Fixed bug in resource renumber function that was causing layout editor to write invalid data to the layout file. Renumbering a logic that is also a room will now let you also renumber the matching room picture resource. Cleaned up the resource number selection form so text is displayed on the form correctly. Added a menu item and shortcut to the layout editor that opens the matching picture resource for editing when a room is selected.

'''2.2.3:''' Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows.

'''2.1.16:''' Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data.

'''2.1.15:''' Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_3_2.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.43 MB]</span>
** [[File:WinAGI_2-1-14source.zip|Source code]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

WinAGI

2023-11-04T16:26:11Z

Andrew Korson: /* Download */

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2023/05/12]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.3.1
| ReleaseDate = [[2023|2023/05/12]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

'''The current version of WinAGI is 2.3.1''' Added new text screen editor to help create text screens (for example help pages), and copy the attributes and display commands to put into logics; added new logic syntax option that is compatible with original Sierra syntax; clicking include filenames in logic editor will open them for editing, same as resources; logic compiler will continue compiling even after an error is found so all errors can be detected in a single pass; added new print/display preview mode to picture editor to see how text added by print and display commands will look when added to screen; added new feature to picture editor to show small markers that show where displayed text characters would be aligned; snippets can now include tool tip 'help', similar to AGI commands; game directory is no longer editable on properties page; to move a game to a new directory, close WinAGI and move it manually with file explorer; color palette values (converted from MSDOS 18 bit to Windows 24 bit) were a bit off and have been fixed to be more precise; added support for programming games with the AGI Power Pack; replaced the 'Use txt as extension' setting with 'SourceFileExt' game property to allow for more options; in picture editor, when in pixel-select mode, Shift+MouseDown will drag the picture surface; the example image on the picture editor Load/Configure Background form is now set to the current picture image (based on current draw state); cel count is now a displayed as a readonly property when a loop is selected; snippets get saved automatically when the form is closed; palette data can be saved to any text file; a nagi.ini file is not required; fixed a major bug in the picture editor Add Coordinate function that would add invalid data in relative line commands; pressing view preview shortcut keys (w,a,s,d) no longer crashes WinAGI if a header is selected; fixed a bug in on main form so resizing and splitting works correctly; a lot of other minor bug fixes

'''2.2.6:''' Added a new TODO tracking function: comments in logics can be tagged as 'TODO' and will be tracked in the warning window, which makes it easier to keep track of things that you are deferring for later. Fixed bug in game property window that was not saving the Platform Options value if 'other' platform is selected. Fixed several minor bugs in renumber resource function. Fixed bug when double-clicking a resource in the tree that would not set focus to the newly opened resource. Added a menu option and shortcut to toggle warning window. Fixed a bug in compiler that would raise an error if a negative number was passed as a define constant. Added a notification in picture editor if an image file fails to open when using the configure background image dialog. Fixed a bug in view editor move-selection function that was improperly updating cel data. Resizing of a cel in view editor is now allowed regardless of selected tool. Fixed several other minor bugs

'''2.2.5:''' Fixed renumber function error when trying to check IsRoom property of a nonexistent logic. Template version check function now correctly identifies version and loads template games. Back up files now all use the same format ('oldname_OLD.ext'). Added mouse wheel support for preview window; picture and cel images can now be zoomed in or out using the mouse wheel. Double-clicking on logics and views will open the respective editor with the resource positioned to match the preview resource (logic scrolls to correct line, views open with correct loop/cel). Fixed bug in snippet function to correctly insert snippet text when snippet was not at beginning of a line. The compiler warning for a missing 'return()' command at end of a logic source now works correctly. Added new feature to shrink open editor windows when the warning/error pane gets displayed so the main form work area doesn't require scrolling. The picture editor join command now gets displayed when two adjacent commands that are eligible for joining are selected. Fixed major but in view editor selection move function incorrectly set cel data when the selection is left at starting position. Fixed a bug in the view editor fill tool that incorrectly filled cel border areas. Deleting or cutting a loop in the view editor now correctly updates the preview panel. The preview panel will now display correctly when view editor is first opened. Added a new transparent selection option for copy/cut/move/paste of cel data (the cel's TransColor value is used to hide pixels in the pasted data). Fixed a bug in the WORDS.TOK editor that caused it to fail in older versions of Windows. Added a new export option for WORDS.TOK to create word lists compatible with ScummVM's extended character support.

'''2.2.4:''' Snippet arguments can now be multi-word (spaces allowed). Typing when the snippet list is visible will now select items from the list. Fixed a major bug in the layout editor to correctly read version information (which prevented proper loading of layout files in v2.2.3). Fixed bug in resource renumber function that was causing layout editor to write invalid data to the layout file. Renumbering a logic that is also a room will now let you also renumber the matching room picture resource. Cleaned up the resource number selection form so text is displayed on the form correctly. Added a menu item and shortcut to the layout editor that opens the matching picture resource for editing when a room is selected.

'''2.2.3:''' Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows.

'''2.1.16:''' Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data.

'''2.1.15:''' Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_3_2.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.43 MB]</span>
** [[File:WinAGI_2-1-14source.zip|Source code]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

File:WinAGI 2 3 2.zip

2023-11-04T16:24:50Z

Andrew Korson:

Main Page

2023-05-12T16:59:59Z

Andrew Korson: /* News */

__NOTOC__
=== Welcome to the AGI Programmers Wiki. ===

A Wiki for the AGI Programming Community. '''A'''dventure '''G'''ame '''I'''nterpreter or [[AGI|AGI]] is the game engine created by Sierra On-line. It was succeeded by Sierra's SCI engine. It was used to create such games as [[King's Quest I: The Quest for the Crown|''King's Quest 1'']] to [[King's Quest III: To Heir Is Human|''III'']], [[Space Quest: Chapter I - The Sarien Encounter|''Space Quest I'']] & [[Space Quest II: Vohaul's Revenge|''II'']], [[Police Quest: In Pursuit of the Death Angel|''Police Quest I'']] and [[Leisure Suit Larry In the Land of the Lounge Lizards|''Leisure Suit Larry 1'']]. With the availability of such tools as [[AGI Studio]] and [[WinAGI]], you can create your own games based on the same engine that Sierra used. This Wiki is a knowledgebase and collection of resources for those working with AGI. Additional help can always be found on the [[SCIPF:|SCI Programming Community Message Board]]. For help with Sierra's games, see [[SHP:|The Sierra Help Pages]].

===<br /> News ===

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2023|May 12, 2023]]'''

* [[WinAGI]] version 2.3.1 is now available for download.
</div>
|}
{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|April 19, 2020]]'''

* [[Chris Cromer]] has released version 1.3.2 of the [[QT AGI Studio]] project. This update adds windows builds, a debian package, and fixes long time bugs in the view and picture editor.
</div>
|}

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|May 10, 2019]]'''

* [[Chris Cromer]] has forked the [[QT AGI Studio]] project and updated the code, it now compiles under GCC 7 and has a working 64 bit Linux binary.
</div>
|}
<blockquote class="offset">'''''[[Older News]]'''''</blockquote>

===<br /> Getting started ===

New here? Please take the time to visit the [[Community Portal]], which contains useful links for AGI and the AGI Wiki. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute. See [[#How to Contribute|How to Contribute]] below after you have received an account. 

===<br /> Links ===

Links for additional help and resources for help for your AGI needs.

[https://www.agifans.com/ www.agifans.com/] Lance Ewing's AGI site<br />

[http://sciprogramming.com SCI Programming.com http://sciprogramming.com]
: [http://sciprogramming.com/community/ AGI Programming Message Boards on SCIProgramming.com] http://sciprogramming.com/community/
: [http://sciprogramming.com/scitools.php AGI Tools on SCI Programming.com] http://sciprogramming.com/scitools.php
: [http://sciprogramming.com/fangames.php AGI fan games] http://sciprogramming.com/fangames.php
[http://agi.sierrahelp.com/Tools/ AGI Tools on the Sierra Help Pages] http://agi.sierrahelp.com/Tools/<br>

===<br /> How to Contribute ===

No registration is required to use this Wiki. Anyone can view the various topics and guides on the AGI Wiki. However, to add or edit pages, you must be [[Special:Userlogin|logged in]]. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute.

<blockquote>
====<br /> Notes for Editors: ====

Please familiarize yourself with [[Help:Contents | MediaWiki formatting]] before adding or editing pages. See the [[Notes_for_Editors|Notes for Editors]] page for AGI Wiki standards and news.
</blockquote>

 

[[Category:Wiki Help]]
[[Category:Wiki News]]

WinAGI

2023-05-12T16:58:20Z

Andrew Korson:

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2023/05/12]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.3.1
| ReleaseDate = [[2023|2022/05/12]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

'''The current version of WinAGI is 2.3.1''' Added new text screen editor to help create text screens (for example help pages), and copy the attributes and display commands to put into logics; added new logic syntax option that is compatible with original Sierra syntax; clicking include filenames in logic editor will open them for editing, same as resources; logic compiler will continue compiling even after an error is found so all errors can be detected in a single pass; added new print/display preview mode to picture editor to see how text added by print and display commands will look when added to screen; added new feature to picture editor to show small markers that show where displayed text characters would be aligned; snippets can now include tool tip 'help', similar to AGI commands; game directory is no longer editable on properties page; to move a game to a new directory, close WinAGI and move it manually with file explorer; color palette values (converted from MSDOS 18 bit to Windows 24 bit) were a bit off and have been fixed to be more precise; added support for programming games with the AGI Power Pack; replaced the 'Use txt as extension' setting with 'SourceFileExt' game property to allow for more options; in picture editor, when in pixel-select mode, Shift+MouseDown will drag the picture surface; the example image on the picture editor Load/Configure Background form is now set to the current picture image (based on current draw state); cel count is now a displayed as a readonly property when a loop is selected; snippets get saved automatically when the form is closed; palette data can be saved to any text file; a nagi.ini file is not required; fixed a major bug in the picture editor Add Coordinate function that would add invalid data in relative line commands; pressing view preview shortcut keys (w,a,s,d) no longer crashes WinAGI if a header is selected; fixed a bug in on main form so resizing and splitting works correctly; a lot of other minor bug fixes

'''2.2.6:''' Added a new TODO tracking function: comments in logics can be tagged as 'TODO' and will be tracked in the warning window, which makes it easier to keep track of things that you are deferring for later. Fixed bug in game property window that was not saving the Platform Options value if 'other' platform is selected. Fixed several minor bugs in renumber resource function. Fixed bug when double-clicking a resource in the tree that would not set focus to the newly opened resource. Added a menu option and shortcut to toggle warning window. Fixed a bug in compiler that would raise an error if a negative number was passed as a define constant. Added a notification in picture editor if an image file fails to open when using the configure background image dialog. Fixed a bug in view editor move-selection function that was improperly updating cel data. Resizing of a cel in view editor is now allowed regardless of selected tool. Fixed several other minor bugs

'''2.2.5:''' Fixed renumber function error when trying to check IsRoom property of a nonexistent logic. Template version check function now correctly identifies version and loads template games. Back up files now all use the same format ('oldname_OLD.ext'). Added mouse wheel support for preview window; picture and cel images can now be zoomed in or out using the mouse wheel. Double-clicking on logics and views will open the respective editor with the resource positioned to match the preview resource (logic scrolls to correct line, views open with correct loop/cel). Fixed bug in snippet function to correctly insert snippet text when snippet was not at beginning of a line. The compiler warning for a missing 'return()' command at end of a logic source now works correctly. Added new feature to shrink open editor windows when the warning/error pane gets displayed so the main form work area doesn't require scrolling. The picture editor join command now gets displayed when two adjacent commands that are eligible for joining are selected. Fixed major but in view editor selection move function incorrectly set cel data when the selection is left at starting position. Fixed a bug in the view editor fill tool that incorrectly filled cel border areas. Deleting or cutting a loop in the view editor now correctly updates the preview panel. The preview panel will now display correctly when view editor is first opened. Added a new transparent selection option for copy/cut/move/paste of cel data (the cel's TransColor value is used to hide pixels in the pasted data). Fixed a bug in the WORDS.TOK editor that caused it to fail in older versions of Windows. Added a new export option for WORDS.TOK to create word lists compatible with ScummVM's extended character support.

'''2.2.4:''' Snippet arguments can now be multi-word (spaces allowed). Typing when the snippet list is visible will now select items from the list. Fixed a major bug in the layout editor to correctly read version information (which prevented proper loading of layout files in v2.2.3). Fixed bug in resource renumber function that was causing layout editor to write invalid data to the layout file. Renumbering a logic that is also a room will now let you also renumber the matching room picture resource. Cleaned up the resource number selection form so text is displayed on the form correctly. Added a menu item and shortcut to the layout editor that opens the matching picture resource for editing when a room is selected.

'''2.2.3:''' Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows.

'''2.1.16:''' Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data.

'''2.1.15:''' Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_3_1.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.43 MB]</span>
** [[File:WinAGI_2-1-14source.zip|Source code]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

WinAGI

2023-05-12T16:57:34Z

Andrew Korson:

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2022/02/14]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.3.1
| ReleaseDate = [[2023|2022/05/12]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

'''The current version of WinAGI is 2.3.1''' Added new text screen editor to help create text screens (for example help pages), and copy the attributes and display commands to put into logics; added new logic syntax option that is compatible with original Sierra syntax; clicking include filenames in logic editor will open them for editing, same as resources; logic compiler will continue compiling even after an error is found so all errors can be detected in a single pass; added new print/display preview mode to picture editor to see how text added by print and display commands will look when added to screen; added new feature to picture editor to show small markers that show where displayed text characters would be aligned; snippets can now include tool tip 'help', similar to AGI commands; game directory is no longer editable on properties page; to move a game to a new directory, close WinAGI and move it manually with file explorer; color palette values (converted from MSDOS 18 bit to Windows 24 bit) were a bit off and have been fixed to be more precise; added support for programming games with the AGI Power Pack; replaced the 'Use txt as extension' setting with 'SourceFileExt' game property to allow for more options; in picture editor, when in pixel-select mode, Shift+MouseDown will drag the picture surface; the example image on the picture editor Load/Configure Background form is now set to the current picture image (based on current draw state); cel count is now a displayed as a readonly property when a loop is selected; snippets get saved automatically when the form is closed; palette data can be saved to any text file; a nagi.ini file is not required; fixed a major bug in the picture editor Add Coordinate function that would add invalid data in relative line commands; pressing view preview shortcut keys (w,a,s,d) no longer crashes WinAGI if a header is selected; fixed a bug in on main form so resizing and splitting works correctly; a lot of other minor bug fixes

'''2.2.6:''' Added a new TODO tracking function: comments in logics can be tagged as 'TODO' and will be tracked in the warning window, which makes it easier to keep track of things that you are deferring for later. Fixed bug in game property window that was not saving the Platform Options value if 'other' platform is selected. Fixed several minor bugs in renumber resource function. Fixed bug when double-clicking a resource in the tree that would not set focus to the newly opened resource. Added a menu option and shortcut to toggle warning window. Fixed a bug in compiler that would raise an error if a negative number was passed as a define constant. Added a notification in picture editor if an image file fails to open when using the configure background image dialog. Fixed a bug in view editor move-selection function that was improperly updating cel data. Resizing of a cel in view editor is now allowed regardless of selected tool. Fixed several other minor bugs

'''2.2.5:''' Fixed renumber function error when trying to check IsRoom property of a nonexistent logic. Template version check function now correctly identifies version and loads template games. Back up files now all use the same format ('oldname_OLD.ext'). Added mouse wheel support for preview window; picture and cel images can now be zoomed in or out using the mouse wheel. Double-clicking on logics and views will open the respective editor with the resource positioned to match the preview resource (logic scrolls to correct line, views open with correct loop/cel). Fixed bug in snippet function to correctly insert snippet text when snippet was not at beginning of a line. The compiler warning for a missing 'return()' command at end of a logic source now works correctly. Added new feature to shrink open editor windows when the warning/error pane gets displayed so the main form work area doesn't require scrolling. The picture editor join command now gets displayed when two adjacent commands that are eligible for joining are selected. Fixed major but in view editor selection move function incorrectly set cel data when the selection is left at starting position. Fixed a bug in the view editor fill tool that incorrectly filled cel border areas. Deleting or cutting a loop in the view editor now correctly updates the preview panel. The preview panel will now display correctly when view editor is first opened. Added a new transparent selection option for copy/cut/move/paste of cel data (the cel's TransColor value is used to hide pixels in the pasted data). Fixed a bug in the WORDS.TOK editor that caused it to fail in older versions of Windows. Added a new export option for WORDS.TOK to create word lists compatible with ScummVM's extended character support.

'''2.2.4:''' Snippet arguments can now be multi-word (spaces allowed). Typing when the snippet list is visible will now select items from the list. Fixed a major bug in the layout editor to correctly read version information (which prevented proper loading of layout files in v2.2.3). Fixed bug in resource renumber function that was causing layout editor to write invalid data to the layout file. Renumbering a logic that is also a room will now let you also renumber the matching room picture resource. Cleaned up the resource number selection form so text is displayed on the form correctly. Added a menu item and shortcut to the layout editor that opens the matching picture resource for editing when a room is selected.

'''2.2.3:''' Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows.

'''2.1.16:''' Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data.

'''2.1.15:''' Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_3_1.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.43 MB]</span>
** [[File:WinAGI_2-1-14source.zip|Source code]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

WinAGI

2023-05-12T15:47:27Z

Andrew Korson: /* Download */

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2022/02/14]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.2.6
| ReleaseDate = [[2022|2022/10/09]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

'''The current version of WinAGI is 2.2.6''' - Added a new TODO tracking function: comments in logics can be tagged as 'TODO' and will be tracked in the warning window, which makes it easier to keep track of things that you are deferring for later. Fixed bug in game property window that was not saving the Platform Options value if 'other' platform is selected. Fixed several minor bugs in renumber resource function. Fixed bug when double-clicking a resource in the tree that would not set focus to the newly opened resource. Added a menu option and shortcut to toggle warning window. Fixed a bug in compiler that would raise an error if a negative number was passed as a define constant. Added a notification in picture editor if an image file fails to open when using the configure background image dialog. Fixed a bug in view editor move-selection function that was improperly updating cel data. Resizing of a cel in view editor is now allowed regardless of selected tool. Fixed several other minor bugs

'''2.2.5:''' - Fixed renumber function error when trying to check IsRoom property of a nonexistent logic. Template version check function now correctly identifies version and loads template games. Back up files now all use the same format ('oldname_OLD.ext'). Added mouse wheel support for preview window; picture and cel images can now be zoomed in or out using the mouse wheel. Double-clicking on logics and views will open the respective editor with the resource positioned to match the preview resource (logic scrolls to correct line, views open with correct loop/cel). Fixed bug in snippet function to correctly insert snippet text when snippet was not at beginning of a line. The compiler warning for a missing 'return()' command at end of a logic source now works correctly. Added new feature to shrink open editor windows when the warning/error pane gets displayed so the main form work area doesn't require scrolling. The picture editor join command now gets displayed when two adjacent commands that are eligible for joining are selected. Fixed major but in view editor selection move function incorrectly set cel data when the selection is left at starting position. Fixed a bug in the view editor fill tool that incorrectly filled cel border areas. Deleting or cutting a loop in the view editor now correctly updates the preview panel. The preview panel will now display correctly when view editor is first opened. Added a new transparent selection option for copy/cut/move/paste of cel data (the cel's TransColor value is used to hide pixels in the pasted data). Fixed a bug in the WORDS.TOK editor that caused it to fail in older versions of Windows. Added a new export option for WORDS.TOK to create word lists compatible with ScummVM's extended character support.

'''2.2.4:''' Snippet arguments can now be multi-word (spaces allowed). Typing when the snippet list is visible will now select items from the list. Fixed a major bug in the layout editor to correctly read version information (which prevented proper loading of layout files in v2.2.3). Fixed bug in resource renumber function that was causing layout editor to write invalid data to the layout file. Renumbering a logic that is also a room will now let you also renumber the matching room picture resource. Cleaned up the resource number selection form so text is displayed on the form correctly. Added a menu item and shortcut to the layout editor that opens the matching picture resource for editing when a room is selected.

'''2.2.3:''' Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows.

'''2.1.16:''' Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data.

'''2.1.15:''' Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_3_1.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.43 MB]</span>
** [[File:WinAGI_2-1-14source.zip|Source code]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

File:WinAGI 2 3 1.zip

2023-05-12T15:46:20Z

Andrew Korson:

WinAGI

2022-10-10T02:39:28Z

Andrew Korson:

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2022/02/14]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.2.6
| ReleaseDate = [[2022|2022/10/09]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

'''The current version of WinAGI is 2.2.6''' - Added a new TODO tracking function: comments in logics can be tagged as 'TODO' and will be tracked in the warning window, which makes it easier to keep track of things that you are deferring for later. Fixed bug in game property window that was not saving the Platform Options value if 'other' platform is selected. Fixed several minor bugs in renumber resource function. Fixed bug when double-clicking a resource in the tree that would not set focus to the newly opened resource. Added a menu option and shortcut to toggle warning window. Fixed a bug in compiler that would raise an error if a negative number was passed as a define constant. Added a notification in picture editor if an image file fails to open when using the configure background image dialog. Fixed a bug in view editor move-selection function that was improperly updating cel data. Resizing of a cel in view editor is now allowed regardless of selected tool. Fixed several other minor bugs

'''2.2.5:''' - Fixed renumber function error when trying to check IsRoom property of a nonexistent logic. Template version check function now correctly identifies version and loads template games. Back up files now all use the same format ('oldname_OLD.ext'). Added mouse wheel support for preview window; picture and cel images can now be zoomed in or out using the mouse wheel. Double-clicking on logics and views will open the respective editor with the resource positioned to match the preview resource (logic scrolls to correct line, views open with correct loop/cel). Fixed bug in snippet function to correctly insert snippet text when snippet was not at beginning of a line. The compiler warning for a missing 'return()' command at end of a logic source now works correctly. Added new feature to shrink open editor windows when the warning/error pane gets displayed so the main form work area doesn't require scrolling. The picture editor join command now gets displayed when two adjacent commands that are eligible for joining are selected. Fixed major but in view editor selection move function incorrectly set cel data when the selection is left at starting position. Fixed a bug in the view editor fill tool that incorrectly filled cel border areas. Deleting or cutting a loop in the view editor now correctly updates the preview panel. The preview panel will now display correctly when view editor is first opened. Added a new transparent selection option for copy/cut/move/paste of cel data (the cel's TransColor value is used to hide pixels in the pasted data). Fixed a bug in the WORDS.TOK editor that caused it to fail in older versions of Windows. Added a new export option for WORDS.TOK to create word lists compatible with ScummVM's extended character support.

'''2.2.4:''' Snippet arguments can now be multi-word (spaces allowed). Typing when the snippet list is visible will now select items from the list. Fixed a major bug in the layout editor to correctly read version information (which prevented proper loading of layout files in v2.2.3). Fixed bug in resource renumber function that was causing layout editor to write invalid data to the layout file. Renumbering a logic that is also a room will now let you also renumber the matching room picture resource. Cleaned up the resource number selection form so text is displayed on the form correctly. Added a menu item and shortcut to the layout editor that opens the matching picture resource for editing when a room is selected.

'''2.2.3:''' Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows.

'''2.1.16:''' Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data.

'''2.1.15:''' Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_2_6.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.26 MB]</span>
** [[File:WinAGI_2-1-14source.zip|Source code]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

File:WinAGI 2 2 6.zip

2022-10-10T02:30:25Z

Andrew Korson:

Main Page

2022-10-10T02:26:55Z

Andrew Korson: /* News */

__NOTOC__
=== Welcome to the AGI Programmers Wiki. ===

A Wiki for the AGI Programming Community. '''A'''dventure '''G'''ame '''I'''nterpreter or [[AGI|AGI]] is the game engine created by Sierra On-line. It was succeeded by Sierra's SCI engine. It was used to create such games as [[King's Quest I: The Quest for the Crown|''King's Quest 1'']] to [[King's Quest III: To Heir Is Human|''III'']], [[Space Quest: Chapter I - The Sarien Encounter|''Space Quest I'']] & [[Space Quest II: Vohaul's Revenge|''II'']], [[Police Quest: In Pursuit of the Death Angel|''Police Quest I'']] and [[Leisure Suit Larry In the Land of the Lounge Lizards|''Leisure Suit Larry 1'']]. With the availability of such tools as [[AGI Studio]] and [[WinAGI]], you can create your own games based on the same engine that Sierra used. This Wiki is a knowledgebase and collection of resources for those working with AGI. Additional help can always be found on the [[SCIPF:|SCI Programming Community Message Board]]. For help with Sierra's games, see [[SHP:|The Sierra Help Pages]].

===<br /> News ===

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2022|October 9, 2022]]'''

* [[WinAGI]] version 2.2.6 is now available for download. Adds a new 'TODO' feature as well as several bug fixes.
</div>
|}
{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|April 19, 2020]]'''

* [[Chris Cromer]] has released version 1.3.2 of the [[QT AGI Studio]] project. This update adds windows builds, a debian package, and fixes long time bugs in the view and picture editor.
</div>
|}

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|May 10, 2019]]'''

* [[Chris Cromer]] has forked the [[QT AGI Studio]] project and updated the code, it now compiles under GCC 7 and has a working 64 bit Linux binary.
</div>
|}
<blockquote class="offset">'''''[[Older News]]'''''</blockquote>

===<br /> Getting started ===

New here? Please take the time to visit the [[Community Portal]], which contains useful links for AGI and the AGI Wiki. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute. See [[#How to Contribute|How to Contribute]] below after you have received an account. 

===<br /> Links ===

Links for additional help and resources for help for your AGI needs.

[http://sciprogramming.com SCI Programming.com] http://sciprogramming.com
: [http://sciprogramming.com/community/ AGI Programming Message Boards on SCIProgramming.com] http://sciprogramming.com/community/
: [http://sciprogramming.com/scitools.php AGI Tools on SCI Programming.com] http://sciprogramming.com/scitools.php
: [http://sciprogramming.com/fangames.php AGI fan games] http://sciprogramming.com/fangames.php
[http://www.agi.sierrahelp.com/Tools/AGITools.html AGI Tools on the Sierra Help Pages] http://www.agi.sierrahelp.com/Tools/AGITools.html<br>

===<br /> How to Contribute ===

No registration is required to use this Wiki. Anyone can view the various topics and guides on the AGI Wiki. However, to add or edit pages, you must be [[Special:Userlogin|logged in]]. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute.

<blockquote>
====<br /> Notes for Editors: ====

Please familiarize yourself with [[Help:Contents | MediaWiki formatting]] before adding or editing pages. See the [[Notes_for_Editors|Notes for Editors]] page for AGI Wiki standards and news.
</blockquote>

 

[[Category:Wiki Help]]
[[Category:Wiki News]]

WinAGI

2022-08-30T03:31:35Z

Andrew Korson:

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2022/02/14]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.2.5
| ReleaseDate = [[2022|2022/08/29]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

'''The current version of WinAGI is 2.2.5:''' - Fixed renumber function error when trying to check IsRoom property of a nonexistent logic. Template version check function now correctly identifies version and loads template games. Back up files now all use the same format ('oldname_OLD.ext'). Added mouse wheel support for preview window; picture and cel images can now be zoomed in or out using the mouse wheel. Double-clicking on logics and views will open the respective editor with the resource positioned to match the preview resource (logic scrolls to correct line, views open with correct loop/cel). Fixed bug in snippet function to correctly insert snippet text when snippet was not at beginning of a line. The compiler warning for a missing 'return()' command at end of a logic source now works correctly. Added new feature to shrink open editor windows when the warning/error pane gets displayed so the main form work area doesn't require scrolling. The picture editor join command now gets displayed when two adjacent commands that are eligible for joining are selected. Fixed major but in view editor selection move function incorrectly set cel data when the selection is left at starting position. Fixed a bug in the view editor fill tool that incorrectly filled cel border areas. Deleting or cutting a loop in the view editor now correctly updates the preview panel. The preview panel will now display correctly when view editor is first opened. Added a new transparent selection option for copy/cut/move/paste of cel data (the cel's TransColor value is used to hide pixels in the pasted data). Fixed a bug in the WORDS.TOK editor that caused it to fail in older versions of Windows. Added a new export option for WORDS.TOK to create word lists compatible with ScummVM's extended character support.

'''2.2.4:''' Snippet arguments can now be multi-word (spaces allowed). Typing when the snippet list is visible will now select items from the list. Fixed a major bug in the layout editor to correctly read version information (which prevented proper loading of layout files in v2.2.3). Fixed bug in resource renumber function that was causing layout editor to write invalid data to the layout file. Renumbering a logic that is also a room will now let you also renumber the matching room picture resource. Cleaned up the resource number selection form so text is displayed on the form correctly. Added a menu item and shortcut to the layout editor that opens the matching picture resource for editing when a room is selected.

'''2.2.3:''' Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows.

'''2.1.16:''' Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data.

'''2.1.15:''' Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_2_5.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.24 MB]</span>
** [[File:WinAGI_2-1-14source.zip|Source code]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

WinAGI

2022-08-30T03:30:08Z

Andrew Korson:

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2022/02/14]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.2.5
| ReleaseDate = [[2022|2022/09/29]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

'''The current version of WinAGI is 2.2.5: - Fixed renumber function error when trying to check IsRoom property of a nonexistent logic. Template version check function now correctly identifies version and loads template games. Back up files now all use the same format ('oldname_OLD.ext'). Added mouse wheel support for preview window; picture and cel images can now be zoomed in or out using the mouse wheel. Double-clicking on logics and views will open the respective editor with the resource positioned to match the preview resource (logic scrolls to correct line, views open with correct loop/cel). Fixed bug in snippet function to correctly insert snippet text when snippet was not at beginning of a line. The compiler warning for a missing 'return()' command at end of a logic source now works correctly. Added new feature to shrink open editor windows when the warning/error pane gets displayed so the main form work area doesn't require scrolling. The picture editor join command now gets displayed when two adjacent commands that are eligible for joining are selected. Fixed major but in view editor selection move function incorrectly set cel data when the selection is left at starting position. Fixed a bug in the view editor fill tool that incorrectly filled cel border areas. Deleting or cutting a loop in the view editor now correctly updates the preview panel. The preview panel will now display correctly when view editor is first opened. Added a new transparent selection option for copy/cut/move/paste of cel data (the cel's TransColor value is used to hide pixels in the pasted data). Fixed a bug in the WORDS.TOK editor that caused it to fail in older versions of Windows. Added a new export option for WORDS.TOK to create word lists compatible with ScummVM's extended character support.

2.2.4:''' Snippet arguments can now be multi-word (spaces allowed). Typing when the snippet list is visible will now select items from the list. Fixed a major bug in the layout editor to correctly read version information (which prevented proper loading of layout files in v2.2.3). Fixed bug in resource renumber function that was causing layout editor to write invalid data to the layout file. Renumbering a logic that is also a room will now let you also renumber the matching room picture resource. Cleaned up the resource number selection form so text is displayed on the form correctly. Added a menu item and shortcut to the layout editor that opens the matching picture resource for editing when a room is selected.

'''2.2.3:''' Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows.

'''2.1.16:''' Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data.

'''2.1.15:''' Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_2_5.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.24 MB]</span>
** [[File:WinAGI_2-1-14source.zip|Source code]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

File:WinAGI 2 2 5.zip

2022-08-30T03:23:36Z

Andrew Korson:

Main Page

2022-08-30T03:22:41Z

Andrew Korson: /* News */

__NOTOC__
=== Welcome to the AGI Programmers Wiki. ===

A Wiki for the AGI Programming Community. '''A'''dventure '''G'''ame '''I'''nterpreter or [[AGI|AGI]] is the game engine created by Sierra On-line. It was succeeded by Sierra's SCI engine. It was used to create such games as [[King's Quest I: The Quest for the Crown|''King's Quest 1'']] to [[King's Quest III: To Heir Is Human|''III'']], [[Space Quest: Chapter I - The Sarien Encounter|''Space Quest I'']] & [[Space Quest II: Vohaul's Revenge|''II'']], [[Police Quest: In Pursuit of the Death Angel|''Police Quest I'']] and [[Leisure Suit Larry In the Land of the Lounge Lizards|''Leisure Suit Larry 1'']]. With the availability of such tools as [[AGI Studio]] and [[WinAGI]], you can create your own games based on the same engine that Sierra used. This Wiki is a knowledgebase and collection of resources for those working with AGI. Additional help can always be found on the [[SCIPF:|SCI Programming Community Message Board]]. For help with Sierra's games, see [[SHP:|The Sierra Help Pages]].

===<br /> News ===

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2022|August 29, 2022]]'''

* [[WinAGI]] version 2.2.5 is now available for download. A few enhancements as well as multiple bug fixes.
</div>
|}
{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|April 19, 2020]]'''

* [[Chris Cromer]] has released version 1.3.2 of the [[QT AGI Studio]] project. This update adds windows builds, a debian package, and fixes long time bugs in the view and picture editor.
</div>
|}

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|May 10, 2019]]'''

* [[Chris Cromer]] has forked the [[QT AGI Studio]] project and updated the code, it now compiles under GCC 7 and has a working 64 bit Linux binary.
</div>
|}
<blockquote class="offset">'''''[[Older News]]'''''</blockquote>

===<br /> Getting started ===

New here? Please take the time to visit the [[Community Portal]], which contains useful links for AGI and the AGI Wiki. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute. See [[#How to Contribute|How to Contribute]] below after you have received an account. 

===<br /> Links ===

Links for additional help and resources for help for your AGI needs.

[http://sciprogramming.com SCI Programming.com] http://sciprogramming.com
: [http://sciprogramming.com/community/ AGI Programming Message Boards on SCIProgramming.com] http://sciprogramming.com/community/
: [http://sciprogramming.com/scitools.php AGI Tools on SCI Programming.com] http://sciprogramming.com/scitools.php
: [http://sciprogramming.com/fangames.php AGI fan games] http://sciprogramming.com/fangames.php
[http://www.agi.sierrahelp.com/Tools/AGITools.html AGI Tools on the Sierra Help Pages] http://www.agi.sierrahelp.com/Tools/AGITools.html<br>

===<br /> How to Contribute ===

No registration is required to use this Wiki. Anyone can view the various topics and guides on the AGI Wiki. However, to add or edit pages, you must be [[Special:Userlogin|logged in]]. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute.

<blockquote>
====<br /> Notes for Editors: ====

Please familiarize yourself with [[Help:Contents | MediaWiki formatting]] before adding or editing pages. See the [[Notes_for_Editors|Notes for Editors]] page for AGI Wiki standards and news.
</blockquote>

 

[[Category:Wiki Help]]
[[Category:Wiki News]]

Main Page

2022-07-26T01:42:30Z

Andrew Korson: /* News */

__NOTOC__
=== Welcome to the AGI Programmers Wiki. ===

A Wiki for the AGI Programming Community. '''A'''dventure '''G'''ame '''I'''nterpreter or [[AGI|AGI]] is the game engine created by Sierra On-line. It was succeeded by Sierra's SCI engine. It was used to create such games as [[King's Quest I: The Quest for the Crown|''King's Quest 1'']] to [[King's Quest III: To Heir Is Human|''III'']], [[Space Quest: Chapter I - The Sarien Encounter|''Space Quest I'']] & [[Space Quest II: Vohaul's Revenge|''II'']], [[Police Quest: In Pursuit of the Death Angel|''Police Quest I'']] and [[Leisure Suit Larry In the Land of the Lounge Lizards|''Leisure Suit Larry 1'']]. With the availability of such tools as [[AGI Studio]] and [[WinAGI]], you can create your own games based on the same engine that Sierra used. This Wiki is a knowledgebase and collection of resources for those working with AGI. Additional help can always be found on the [[SCIPF:|SCI Programming Community Message Board]]. For help with Sierra's games, see [[SHP:|The Sierra Help Pages]].

===<br /> News ===

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2022|July 25, 2022]]'''

* [[WinAGI]] version 2.2.4 is now available for download. A few enhancements as well as multiple bug fixes.
</div>
|}
{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|April 19, 2020]]'''

* [[Chris Cromer]] has released version 1.3.2 of the [[QT AGI Studio]] project. This update adds windows builds, a debian package, and fixes long time bugs in the view and picture editor.
</div>
|}

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|May 10, 2019]]'''

* [[Chris Cromer]] has forked the [[QT AGI Studio]] project and updated the code, it now compiles under GCC 7 and has a working 64 bit Linux binary.
</div>
|}
<blockquote class="offset">'''''[[Older News]]'''''</blockquote>

===<br /> Getting started ===

New here? Please take the time to visit the [[Community Portal]], which contains useful links for AGI and the AGI Wiki. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute. See [[#How to Contribute|How to Contribute]] below after you have received an account. 

===<br /> Links ===

Links for additional help and resources for help for your AGI needs.

[http://sciprogramming.com SCI Programming.com] http://sciprogramming.com
: [http://sciprogramming.com/community/ AGI Programming Message Boards on SCIProgramming.com] http://sciprogramming.com/community/
: [http://sciprogramming.com/scitools.php AGI Tools on SCI Programming.com] http://sciprogramming.com/scitools.php
: [http://sciprogramming.com/fangames.php AGI fan games] http://sciprogramming.com/fangames.php
[http://www.agi.sierrahelp.com/Tools/AGITools.html AGI Tools on the Sierra Help Pages] http://www.agi.sierrahelp.com/Tools/AGITools.html<br>

===<br /> How to Contribute ===

No registration is required to use this Wiki. Anyone can view the various topics and guides on the AGI Wiki. However, to add or edit pages, you must be [[Special:Userlogin|logged in]]. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute.

<blockquote>
====<br /> Notes for Editors: ====

Please familiarize yourself with [[Help:Contents | MediaWiki formatting]] before adding or editing pages. See the [[Notes_for_Editors|Notes for Editors]] page for AGI Wiki standards and news.
</blockquote>

 

[[Category:Wiki Help]]
[[Category:Wiki News]]

WinAGI

2022-07-26T01:41:44Z

Andrew Korson:

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2022/02/14]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.2.4
| ReleaseDate = [[2022|2022/07/22]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

'''The current version of WinAGI is 2.2.4:''' Snippet arguments can now be multi-word (spaces allowed). Typing when the snippet list is visible will now select items from the list. Fixed a major bug in the layout editor to correctly read version information (which prevented proper loading of layout files in v2.2.3). Fixed bug in resource renumber function that was causing layout editor to write invalid data to the layout file. Renumbering a logic that is also a room will now let you also renumber the matching room picture resource. Cleaned up the resource number selection form so text is displayed on the form correctly. Added a menu item and shortcut to the layout editor that opens the matching picture resource for editing when a room is selected.

'''2.2.3:''' Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows.

'''2.1.16:''' Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data.

'''2.1.15:''' Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_2_4.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.24 MB]</span>
** [[File:WinAGI_2-1-14source.zip|Source code]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

WinAGI

2022-07-26T01:22:06Z

Andrew Korson: /* Download */

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2022/02/14]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.2.3
| ReleaseDate = [[2022|2022/06/04]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

The current version of WinAGI is 2.2.3: Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows. Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data. Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_2_4.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.24 MB]</span>
** [[File:WinAGI_2-1-14source.zip|Source code]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

File:WinAGI 2 2 4.zip

2022-07-26T01:20:52Z

Andrew Korson:

File:WinAGI 2 2 3.zip

2022-06-04T22:38:25Z

Andrew Korson:

WinAGI

2022-06-04T22:35:55Z

Andrew Korson:

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2022|2022/02/14]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.2.3
| ReleaseDate = [[2022|2022/06/04]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

The current version of WinAGI is 2.2.3: Support for international MSDOS codepages. Enter key on Find Form sends a 'Find button click' event instead of adding CR to search term. New option to set default cycling status of loop previews when opening a view in the editor. Fixed problem with WORDS.TOK editor that caused WinAGI to hang up on older versions of Windows. Importing games with directory and resource errors will now load all other content correctly and provide feedback (warnings) about the invalid data. Decode logic now has two code styles to choose from (affects how if statements are structured). Renumbering now marks logics as uncompiled, and updates tooltips. Fixes a minor bug in compiler that would improperly concatenate strings in very specific situations. Cursor now gets restored correctly after compiler error. The splitter in View editor now works correctly (it used to have a border that would show the split icon, but not react to mouse movement). Resource tooltips now get refreshed when one game closes and another is opened. WORDS.TOK editor now correctly saves an imported wordlist. Fixed a bug in exporting view loops as gifs that was incorrectly setting cel values. Hiding the resource tree panel will now also hide the preview window. Fixed bugs in View editor and sound editor so imported resources will save correctly. Fixed bug in compiler that would ignore a single quote instead of raising an error. Fixed the statusbar flicker problem when previewing pictures. Message cleanup tool improved to better handle non-standard placement of message declarations. Fixed the block-uncomment feature (it would skip lines in certain situations). Fixed a major bug in the richtext editor control undo/redo functions. The compile toolbar button is now disabled when editing a logic not in-game. Console updated; allows export/import(add) of individual resources. Fixed minor bug in the remove resource function, so checkboxes in the message boxes remain unchecked by default. Fixed a bug in the NewView and NewSound functions so they get initialized correctly when not immediately added to a game. The caption for logics that are not in-game now show filename like other resource types. Changing the gameid, aboutmsg, versionmsg define values now updates affected logics as uncompiled. Many updates, corrections, additions to help file. Compile option on treelist context menu works correctly now. Saving a logic now correctly updates the form caption. Undo/redo now set logic editor dirty status. The GameAbout and GameVersion properties now correctly display new line characters. Logic search function now works with extended characters. Added CTRL+DblClick to open a resource ID from within a logic editor. Files ending 'wag' with extra characters at the end (for example, *.wagx) no longer confuse the open/import game functions. Fixed major issue with 'new game from template' so copied files and directories get correctly renamed. New 'pointer' syntax option added to make indirect coding easier to manage. Max scale factors for view and picture editors increased (makes editing a lot easier on larger monitors). #define values that have a trailing semicolon now throw an error, instead of assuming the value is a string. The 'edit coordinate' form now shows centered in the main window. Fixed bug in picture editor that would show the priority frame over the palette in some resizing situations. Syncing menus with active form/control appears to be fixed for good this time.</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* Hovering over defined words will show the variable/flag/string value assigned to the define
* Easily change comment status for multiple lines of text using the block/unblock comment feature
* Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* Priority lines can be adjusted to match [[set.pri.base]] command options
* Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

Changes made to global defines automatically update all affected logic scripts

Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_2_3.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.24 MB]</span>
** [[File:WinAGI_2-1-14source.zip|Source code]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

Main Page

2022-06-04T22:29:54Z

Andrew Korson: /* News */

__NOTOC__
=== Welcome to the AGI Programmers Wiki. ===

A Wiki for the AGI Programming Community. '''A'''dventure '''G'''ame '''I'''nterpreter or [[AGI|AGI]] is the game engine created by Sierra On-line. It was succeeded by Sierra's SCI engine. It was used to create such games as [[King's Quest I: The Quest for the Crown|''King's Quest 1'']] to [[King's Quest III: To Heir Is Human|''III'']], [[Space Quest: Chapter I - The Sarien Encounter|''Space Quest I'']] & [[Space Quest II: Vohaul's Revenge|''II'']], [[Police Quest: In Pursuit of the Death Angel|''Police Quest I'']] and [[Leisure Suit Larry In the Land of the Lounge Lizards|''Leisure Suit Larry 1'']]. With the availability of such tools as [[AGI Studio]] and [[WinAGI]], you can create your own games based on the same engine that Sierra used. This Wiki is a knowledgebase and collection of resources for those working with AGI. Additional help can always be found on the [[SCIPF:|SCI Programming Community Message Board]]. For help with Sierra's games, see [[SHP:|The Sierra Help Pages]].

===<br /> News ===

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2022|June 4, 2022]]'''

* [[WinAGI]] version 2.2.3 is now available for download. A few enhancements as well as multiple bug fixes.
</div>
|}
{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|April 19, 2020]]'''

* [[Chris Cromer]] has released version 1.3.2 of the [[QT AGI Studio]] project. This update adds windows builds, a debian package, and fixes long time bugs in the view and picture editor.
</div>
|}

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|May 10, 2019]]'''

* [[Chris Cromer]] has forked the [[QT AGI Studio]] project and updated the code, it now compiles under GCC 7 and has a working 64 bit Linux binary.
</div>
|}
<blockquote class="offset">'''''[[Older News]]'''''</blockquote>

===<br /> Getting started ===

New here? Please take the time to visit the [[Community Portal]], which contains useful links for AGI and the AGI Wiki. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute. See [[#How to Contribute|How to Contribute]] below after you have received an account. 

===<br /> Links ===

Links for additional help and resources for help for your AGI needs.

[http://sciprogramming.com SCI Programming.com] http://sciprogramming.com
: [http://sciprogramming.com/community/ AGI Programming Message Boards on SCIProgramming.com] http://sciprogramming.com/community/
: [http://sciprogramming.com/scitools.php AGI Tools on SCI Programming.com] http://sciprogramming.com/scitools.php
: [http://sciprogramming.com/fangames.php AGI fan games] http://sciprogramming.com/fangames.php
[http://www.agi.sierrahelp.com/Tools/AGITools.html AGI Tools on the Sierra Help Pages] http://www.agi.sierrahelp.com/Tools/AGITools.html<br>

===<br /> How to Contribute ===

No registration is required to use this Wiki. Anyone can view the various topics and guides on the AGI Wiki. However, to add or edit pages, you must be [[Special:Userlogin|logged in]]. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute.

<blockquote>
====<br /> Notes for Editors: ====

Please familiarize yourself with [[Help:Contents | MediaWiki formatting]] before adding or editing pages. See the [[Notes_for_Editors|Notes for Editors]] page for AGI Wiki standards and news.
</blockquote>

 

[[Category:Wiki Help]]
[[Category:Wiki News]]

WinAGI

2022-03-16T02:45:38Z

Andrew Korson:

WinAGI

2022-03-16T02:44:49Z

Andrew Korson: /* Description */

WinAGI

2022-03-16T02:43:14Z

Andrew Korson: /* Download */

File:WinAGI 2 1 16.zip

2022-03-16T02:42:19Z

Andrew Korson:

Main Page

2022-03-16T02:38:31Z

Andrew Korson: /* News */

__NOTOC__
=== Welcome to the AGI Programmers Wiki. ===

A Wiki for the AGI Programming Community. '''A'''dventure '''G'''ame '''I'''nterpreter or [[AGI|AGI]] is the game engine created by Sierra On-line. It was succeeded by Sierra's SCI engine. It was used to create such games as [[King's Quest I: The Quest for the Crown|''King's Quest 1'']] to [[King's Quest III: To Heir Is Human|''III'']], [[Space Quest: Chapter I - The Sarien Encounter|''Space Quest I'']] & [[Space Quest II: Vohaul's Revenge|''II'']], [[Police Quest: In Pursuit of the Death Angel|''Police Quest I'']] and [[Leisure Suit Larry In the Land of the Lounge Lizards|''Leisure Suit Larry 1'']]. With the availability of such tools as [[AGI Studio]] and [[WinAGI]], you can create your own games based on the same engine that Sierra used. This Wiki is a knowledgebase and collection of resources for those working with AGI. Additional help can always be found on the [[SCIPF:|SCI Programming Community Message Board]]. For help with Sierra's games, see [[SHP:|The Sierra Help Pages]].

===<br /> News ===

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2022|March 15, 2022]]'''

* [[WinAGI]] version 2.1.16 is now available for download. A few enhancements as well as multiple bug fixes.
</div>
|}
{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|April 19, 2020]]'''

* [[Chris Cromer]] has released version 1.3.2 of the [[QT AGI Studio]] project. This update adds windows builds, a debian package, and fixes long time bugs in the view and picture editor.
</div>
|}

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|May 10, 2019]]'''

* [[Chris Cromer]] has forked the [[QT AGI Studio]] project and updated the code, it now compiles under GCC 7 and has a working 64 bit Linux binary.
</div>
|}
<blockquote class="offset">'''''[[Older News]]'''''</blockquote>

===<br /> Getting started ===

New here? Please take the time to visit the [[Community Portal]], which contains useful links for AGI and the AGI Wiki. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute. See [[#How to Contribute|How to Contribute]] below after you have received an account. 

===<br /> Links ===

Links for additional help and resources for help for your AGI needs.

[http://sciprogramming.com SCI Programming.com] http://sciprogramming.com
: [http://sciprogramming.com/community/ AGI Programming Message Boards on SCIProgramming.com] http://sciprogramming.com/community/
: [http://sciprogramming.com/scitools.php AGI Tools on SCI Programming.com] http://sciprogramming.com/scitools.php
: [http://sciprogramming.com/fangames.php AGI fan games] http://sciprogramming.com/fangames.php
[http://www.agi.sierrahelp.com/Tools/AGITools.html AGI Tools on the Sierra Help Pages] http://www.agi.sierrahelp.com/Tools/AGITools.html<br>

===<br /> How to Contribute ===

No registration is required to use this Wiki. Anyone can view the various topics and guides on the AGI Wiki. However, to add or edit pages, you must be [[Special:Userlogin|logged in]]. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute.

<blockquote>
====<br /> Notes for Editors: ====

Please familiarize yourself with [[Help:Contents | MediaWiki formatting]] before adding or editing pages. See the [[Notes_for_Editors|Notes for Editors]] page for AGI Wiki standards and news.
</blockquote>

 

[[Category:Wiki Help]]
[[Category:Wiki News]]

Main Page

2022-02-15T06:46:06Z

Andrew Korson: /* News */

__NOTOC__
=== Welcome to the AGI Programmers Wiki. ===

A Wiki for the AGI Programming Community. '''A'''dventure '''G'''ame '''I'''nterpreter or [[AGI|AGI]] is the game engine created by Sierra On-line. It was succeeded by Sierra's SCI engine. It was used to create such games as [[King's Quest I: The Quest for the Crown|''King's Quest 1'']] to [[King's Quest III: To Heir Is Human|''III'']], [[Space Quest: Chapter I - The Sarien Encounter|''Space Quest I'']] & [[Space Quest II: Vohaul's Revenge|''II'']], [[Police Quest: In Pursuit of the Death Angel|''Police Quest I'']] and [[Leisure Suit Larry In the Land of the Lounge Lizards|''Leisure Suit Larry 1'']]. With the availability of such tools as [[AGI Studio]] and [[WinAGI]], you can create your own games based on the same engine that Sierra used. This Wiki is a knowledgebase and collection of resources for those working with AGI. Additional help can always be found on the [[SCIPF:|SCI Programming Community Message Board]]. For help with Sierra's games, see [[SHP:|The Sierra Help Pages]].

===<br /> News ===

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2022|February 14, 2022]]'''

* [[WinAGI]] version 2.1.15 is now available for download. A few enhancements as well as multiple bug fixes.
</div>
|}
{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|April 19, 2020]]'''

* [[Chris Cromer]] has released version 1.3.2 of the [[QT AGI Studio]] project. This update adds windows builds, a debian package, and fixes long time bugs in the view and picture editor.
</div>
|}

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|May 10, 2019]]'''

* [[Chris Cromer]] has forked the [[QT AGI Studio]] project and updated the code, it now compiles under GCC 7 and has a working 64 bit Linux binary.
</div>
|}

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2019|March 16, 2019]]'''

* [[User:Andrew Korson|Andrew Korson]] has released a new version of [[WinAGI]], Version 1.2.3. This version incorporates many new features and enhancements that make it even easier to create classic AGI games.
</div>
|}

{| width="100%" cellspacing="20"
|-
| style="border: 1px solid #04BF05; background-color: #F0FFF0" width="50%" valign="top" | <div style="padding: .4em .9em .9em">
'''[[2010|December 13, 2010]]'''

* [[Lance Ewing]] has released a new version of his old DOS [[PicEdit]]. It has been developed in Java for cross platform support.
</div>
|}

===<br /> Getting started ===

New here? Please take the time to visit the [[Community Portal]], which contains useful links for AGI and the AGI Wiki. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute. See [[#How to Contribute|How to Contribute]] below after you have received an account. 

===<br /> Links ===

Links for additional help and resources for help for your AGI needs.

[http://sciprogramming.com SCI Programming.com] http://sciprogramming.com
: [http://sciprogramming.com/community/ AGI Programming Message Boards on SCIProgramming.com] http://sciprogramming.com/community/
: [http://sciprogramming.com/scitools.php AGI Tools on SCI Programming.com] http://sciprogramming.com/scitools.php
: [http://sciprogramming.com/fangames.php AGI fan games] http://sciprogramming.com/fangames.php
[http://www.agi.sierrahelp.com/Tools/AGITools.html AGI Tools on the Sierra Help Pages] http://www.agi.sierrahelp.com/Tools/AGITools.html<br>

===<br /> How to Contribute ===

No registration is required to use this Wiki. Anyone can view the various topics and guides on the AGI Wiki. However, to add or edit pages, you must be [[Special:Userlogin|logged in]]. If you are not registered, you may request an account editing privileges. Contact Collector on the [[SCIPF:|SCI Programming Community Message Board]] or [[SHPF:|The Sierra Help Pages Forums]] if you wish to contribute.

<blockquote>
====<br /> Notes for Editors: ====

Please familiarize yourself with [[Help:Contents | MediaWiki formatting]] before adding or editing pages. See the [[Notes_for_Editors|Notes for Editors]] page for AGI Wiki standards and news.
</blockquote>

 

[[Category:Wiki Help]]

CG

2022-02-15T06:42:25Z

Andrew Korson:

<div align="center" style="font-size: 22pt">CG- The AGI Game Compiler</div>
<div align="center">Version <br />
''Author: ''<br />
</div>

{{AGISoftwareInfobox
| Software = CG
| image = 
| Version =
| ReleaseDate =
| Company = {{SierraTool}}
| Published = {{Unpublished}}
| Developers =
| ProgLanguage = {{C}}
| OpenSource = {{ClosedSW}}
| License = {{NoLicense}}
| Source = {{NoSourceSW}}
| Platform = {{DOSTool}}
| Type = {{AGICompiler}}, {{InhouseTool}}, {{AGIDevTool}}, {{DevTool}}
| Localization = {{EnglishTool}}
| Website = {{SierraURL}}
}}

<br />
==<br /><br /> Description ==

<blockquote>
CG was Sierra's in-house AGI Game Compiler.

'''General compiler behavior:'''
In general, CG.EXE is intentionally designed to allow for changes/additions to the action and test commands without needing to rebuild the compiler itself. The compiler only manages the syntax used to access the commands; the commands themselves all need to be declared for the compiler every time it is run. The compiler only has a small number of keywords that are hard coded in the program. Because of this, the compiler was able compile all versions of AGI source code, without needing to update the compiler every time the AGI interpreter was changed.

The compiler processes each source file separately. The sequence of actions is
*parse input file name, build output file name
*reset compiler parameters
*open source file and assign to buffer space
*create output file (overwriting any existing file) and assign to buffer space
*initialize the hash table, adding predefined symbols
*allocate space for output, and for AGI messages
*compile the source (errors are displayed as they are encountered)
*close the output file
*display results, including total number of errors encountered
*repeat for next source file

The compiler uses a single pass when compiling source (the term 'preprocessor' is used occasionally throughout this article to describe some aspects of the compiler, but keep in mind that unlike more modern compilers, all input is compiled linearly, in a single pass; so all declarations and defines need to be listed BEFORE they show up in source code).

The compiler converts all text fields (symbols) it encounters into a hash value (by summing the ascii values of all characters in the symbol, and then returning that value MOD 203). This value is then compared against entries in the compiler's symbol hash table to determine what it represents. If more than one symbol has the same hash value, the compiler creates linked lists for each hash value to avoid conflicts. If the number of symbols is too large such that all memory is used up to hold them, the compiler will throw an error and quit. For obvious reasons, no duplicate symbols are allowed; if a duplicate is detected, the compiler throws an error. Symbols are case sensitive.

On startup, the following symbols are added to the hash table: %include, %tokens, %test, %action, %flag, %var, %object, %define, %message, %view, #include, #tokens, #test, #action, #flag, #var, #object, #define, #message, #view, goto, if, else, FLAG, OBJECT, MSG, WORD, NUM, MSGNUM, VIEW, VAR, ANY, WORDLIST. These can be broken down into three groups:

===Preprocessor symbols:===
The symbols starting with '%' or '#' are compiler commands that add symbols to the hash table which tell the compiler how to handle other symbols it will encounter later. Note that there are two versions of each, with either the '#' or '%' character to start. There is no difference between them; the compiler just offers the flexibility to use either format.<br />

'''%include:''' This symbol is used to include another source or header file. Syntax is:<br />

<code>%include "filename.ext"</code>

The filename must be enclosed in double-quotes. It can include path information, but not wildcards. Included files can be nested, but there is a limit of 5 layers of nesting. More than that will cause an error.<br />
<br />⁪⁫⁬⁭⁮⁯⁯
'''%tokens:''' This symbol is used to load the WORDS.TOK file. Syntax is:<br />

<code>%tokens "WORDS.TOK"</code>

The filename doesn't have to be WORDS.TOK, but it must be a valid AGI word file. It must be enclosed in double-quotes. It can include path information, but not wildcards. If you do not assign a WORDS.TOK file with the %tokens command, the compiler will enter an infinite loop if it tries process a 'said' command.<br />
<br />
⁪⁫⁬⁭⁮⁯⁯
'''%test/%action:''' These symbols are used to declare AGI command symbols. None of the AGI commands are hard coded into the compiler; they must be declared at the beginning of the source code, typically in a header file that is included with the %include command. Syntax is:<br />

<code>%test testname([arg1, arg2, ...]) cmdnum</code><br />
<code>%action actionname([arg1, arg2, ...]) cmdnum</code>

The names of commands are well established by precedent (and by example from released original game code), but you can assign any name you want for any command. The arguments must be enclosed in parentheses, separated by commas. If no arguments, empty parentheses must be included. Arguments must be one of the pre-defined argument types (see below). The number of the command (the byte value that goes into the compiled logic) must follow the command declaration. It is imperative that the arguments assigned match exactly with the AGI command associated with the byte command number; the compiler will happily create code that has any combination of command byte values and arguments, but if they don't match what the interpreter expects, the code won't run.‌‍<br />‎
‏<br />‪‫‬⁪⁫⁬⁭⁮⁯⁯
'''%flag/%var/%object/%view:''' Flags, variables, screen objects and views can be assigned symbols using the respective designated preprocessor command. Note that there isn't a symbol command for numbers; the compiler doesn't convert numbers into a symbol. Syntax is:<br />

<code>%flag flagname flagnum</code><br />
<code>%var variablename varnum</code><br />
<code>%object objname objnum</code><br />
<code>%view viewname viewnum</code>

These symbol types correspond to the expected argument types that are used in command declarations. For example, if a command is declared with %action as '%action assignn(VAR, NUM)', a symbol of type %var must be passed as the first argument, and a number must be passed as the second argument. Note that these types are completely arbitrary, meaning as long as the command declaration matches the argument type passed in source code, the compiler won't have any problem. For example:<br />

<code>%action assignv(VIEW, OBJECT) 3</code><br />
<code>%view a_view 5</code><br />
<code>%object an_object 10</code><br />
<code>assignv(a_view, an_object);</code>

will compile, and when run in AGI it would assign variable 10 to variable 5. Of course, there is little practical value in using constructs such as this.<br />

The OBJECT argument type is also used in most original Sierra game source for both screen objects and inventory objects. Care must be taken by the programmer to keep them straight, because the compiler won't do it for you.<br />‎
‏<br />‪⁪⁫⁬⁭⁮⁯⁯
'''%define:''' The generic define command allows you to assign a symbol to a number, text, or another symbol. Syntax is:<br />

<code>%define define_name define_value</code>

Because the define value can be another symbol, you can do things like:<br />

<code>%var v0 0</code><br />
<code>%define currentroom v0</code>

or <br />

<code>%var v200 200</code><br />
<code>%define lvar1 v200</code><br />
<code>%define counter lvar1</code><br />
<code>addn(counter, 1); [ same as addn(lvar1, 1) or addn(v200, 1)</code>

Symbols can be nested in this manner as deep as you want. As long as each symbol is defined before it is referenced, the compiler will continue substituting define values until it reaches a non-text symbol type (var, num, flag, msgnum, etc.)<br />
⁪⁫⁬⁭⁮⁯⁯<br />
'''%message:''' message symbol declarations are a bit different from other symbol declarations. Syntax is:<br />

<code>%message msgnum "message text"</code>

Note that the number precedes the text value, unlike other symbols, where the number is last. The message text must be included in quotes. It cannot be split, i.e. the compiler will not automatically concatenate multi-line strings. The message text can be a symbol that was previously %defined to be a string value. For example<br />

<code>%define aboutmsg "AGI Game, by Author"</code><br />
<code>%message 1 aboutmsg</code>

will compile with no errors.<br />
‏‪‫‬⁪⁫⁬⁭⁮⁯⁯
===Keywords:===
There are only three key words that the compiler recognizes - 'if', 'else' and 'goto'. The syntax for 'if' and 'else' used by the compiler is identical to the AGI 'canon' syntax. 'if' statements must be in parentheses, curly brackets separate code blocks, etc. The 'and' and 'or' features are the same ('&&' and '||' as operators, and 'or'ed tests must be in parentheses). The exclamation point '!' is used for negation of test commands.

The goto command does not use parentheses. Using parentheses will cause an error. The syntax is:<br />
<code>goto label</code>
Labels are defined with a colon followed by the label name, with no space between them. If there is a space between them, the compiler will create a label using a null string (""), and the following text will be interpreted by the compiler as the next command symbol.
‏‪‫‬⁪⁫⁬⁭⁮⁯⁯
===Argument types:===
Arguments used in action and test commands must be designated as one of ten different argument types. When declaring a command, the compiler expects a symbol with a type that matches the argument type, and it must be one of the predefined argument types for each argument. They are case sensitive, so 'var' is not the same as 'VAR'. With the exception of numbers and vocabulary words (from WORDS.TOK), all arguments must be passed as a symbol that was previously declared using the appropriate 'preproccessor' command. For example, if an argument is of type FLAG, you must pass a symbol declared with the '%flag' command.
<blockquote>
*'''FLAG:''' Use this argument type when you want a command to use a flag argument.
*'''OBJECT:''' Use this argument type when you want a command to use a screen object argument.
*'''MSG:''' This argument type is not used by CG.EXE or AGI; it appears to be a legacy type that no longer works. The internal value assigned to it will actually create an error if you try to use this argument type in a command declaration.
*'''WORD:''' This is another legacy argument type. If used, the compiler will expect a single word from the WORDS.TOK file. There are no AGI commands that take a single word as an argument. (Earlier versions of AGI did use a 'said' command that took a single word as an argument.)
*'''NUM:''' Use this argument type when you want a command to use a numeric argument value.
*'''MSGNUM:''' Use this argument type when you want a command to use a message number as an argument value. The message must be properly declared with %message before it is used in a command.
*'''VIEW:''' Use this argument type when you want a command to use a view argument.
*'''VAR:''' Use this argument type when you want a command to use a variable argument.
*'''ANY:''' This argument type should not be used in command declarations. It is an internal type that is used when the compiler is handling shorthand syntax such as 'v0 = v1;'. Technically, you could use this in a command declaration, in which case, any valid symbol would be compiled. But using strict argument typing helps prevent bugs by forcing the game programmer to use correct argument types.
*'''WORDLIST:''' This argument type is only used by the 'said' command. It acts as a placeholder for one or more words from the WORDS.TOK file. Its placement at the end of the list suggests it was added after the 'said' command was changed from having a single word argument to a variable number of arguments. Unlike modern AGI compilers (WinAGI and AGIStudio for example), argument values are not passed as double-quoted strings; instead, they are passed quote free, and the dollar sign ($) is used in place of spaces. For example, if your word in WORDS.TOK is 'save game', it would look like this in a 'said' command:
<code>said(save$game)</code>
</blockquote>

===Shorthand Syntax:===
The compiler provides limited support for shorthand syntax in lieu of command names. But instead of just recognizing the shorthand command and directly adding the appropriate byte code, the compiler actually inserts the matching command symbol into the data stream, as if it had been typed in the source code and then compiles that symbol. This means the declarations of shorthand commands must exactly match the internal spelling. For example, you can't create a custom action command for the assignn function (byte code 3); you must declare it as 'assignn'. (You could create a #define value to assign another different command text value to assignn though.) The supported shorthand commands are:
*'++' and '--' can be used as shorthand for increment/decrement. The operators must precede the variable being modified. So <br />
<code>++variable1; [ OK</code>
will compile, but <br />
<code>variable1++; [ syntax error </code>
will throw an error.
*assignn/assignv, addn/addv and subn/subv can be replaced with 'v# = #/v#', 'v# += ##/v#' and 'v# -= ##/v#'. For addition and subtraction, you can't use the longer notation 'v# = v# + ##'. For example:<br />
<code>v1 = v2; [ OK, same as assignv(v1, v2);</code><br />
<code>v1 += 1; [ OK, same as addn(v1, 1);</code><br />
<code>v1 -= v3; [ OK same as subv(v1, v3);</code><br />
<code>v1 = v1 + 2; [ NOT OK, syntax error</code>
*left and right indirection can be replaced with '@v# = #/v#' and 'v# = @v#'. Note this is different from modern compilers that use the asterisk/star character (*). For example:
<code>@v1 = 1; [ OK, same as lindirectn(v1, 1);</code><br />
<code>@v2 = v3; [ OK, same as lindirectv(v2, v3);</code><br />
<code>v4 = @v5; [ OK, same as rindirect(v4, v5);</code><br />
<code>*v1 = 1; [ NOT OK, wrong indirect symbol</code>
*for test commands, '==', '>', and '<', can be used in place of equaln/equalv, greatern/greaterv and lessn/lessv. '!=', '>=' and '<=' can be used in place of the negated versions of these commands.
*flags can be tested by their name; i.e. 'if(flag1)' will compile as if it were 'if(isset(flag1)'.
*variables can also be tested by name; 'if(var1)' will compile as if it were 'if(greatern(var1, 0)'

===Miscellaneous Syntax Information:===
Commas and semi-colons are completely interchangeable. You can use either to separate arguments in a command, or to mark the end of a line.

The compiler does not require the end of line marker. Commands can be separated by one or more spaces, a line feed (not a carriage return), a semi-colon, or a comma. Line feeds (ascii value 10) but not carriage returns (ascii value 13) mark new lines. Carriage returns are completely ignored.For example:<br />
<code>assignn(v1, 1); [ OK</code><br />
<code>assignn(v2; 2) ,, assignn(v3;3) [ OK</code><br />
<code>assignn</code><br />
<code>(</code><br />
<code>v1</code><br />
<code>,</code><br />
<code>) [ OK; same as first line</code>

For numeric arguments, the compiler does not enforce unsigned byte values. If a number value is greater than 255, the compiler uses number MOD 256. Negative numbers will also compile without error; the compiler converts them to 2s-complement (and will also MOD it if result is > 8 bits).

The only supported comment tag is the open square bracket ([). Double-slash (//) is not supported by the compiler, nor are block comments.

A 'return' command (byte code 0) is automatically added by the compiler. If the source code also ends with a 'return' command, the resulting compiled logic will in fact end with two return byte codes.
</blockquote>

==<br /> Version History ==

<blockquote>
Version 3.14:
*Original File Date/Time: August 1, 1986 (10:29:58 AM)
*CRC32: 022E711B
*MD5: A70C533DCBDAA58491DD09A10AC1F251
*SHA-1: 4700B789548A53FBE3600ADDB55E4B1C492436E0
</blockquote>

==<br /> Usage ==

<blockquote>
<code>cg room [room...] [-o output_directory] [-b buffer_size]</code>
*'''-o''': Sets the output directory (where the compiled logic files will be saved). The default is the current directory. The output directory can be any legal MSDOS directory name, including relative paths. If the path is not valid, the compiler will quit with an error. If the argument following the -o switch is missing, the current directory is used. If the argument is a valid directory name, but does not exist, the compiler will run, but will raise an error at the end when it can't write the output files.
*'''-b''': Adjusts buffer size. The default is 1000h (4K). If the argument following the -b switch is non-numeric or missing, a value of zero is used, which will cause the compiler to fail immediately. A larger value means disk writes are minimized, but it will also take up more memory.
*'''-v''': Sets 'verbose' mode. This switch does not take an argument. When used, it causes the output to display additional information, including the number of symbols and messages found in the source file, and information on the symbol hash table.

Arguments (command switches and source files) can be in any order. Each argument, including source code files ('room') must be separated by one or more spaces. Filenames have to be valid MSDOS filenames (no long-filenames) and can include path info and wildcard characters ('?' and '*').

If no arguments are passed, the usage information is displayed. If no source files are passed (only one or more command switch) the program switches to console mode, and source files can then be typed in separately. Pressing ENTER adds a file to the list, pressing CTRL+Z and then ENTER sends that list to the program, which are then processed.

Source filenames without an extension are assumed to have the '.cg' extension. If specified, any extension will work just fine. You can also pass a list of files by preceding the file that has the list with the '@' symbol; i.e. 'cg @roomlist.txt' will open the file 'roomlist.txt' and read each line as an input source file name. You can also specify DOS environment variables 'HEAD' and 'TAIL', which are added to the beginning and end of the file list passed on the command line.

Source filename (not extension) must include a number, or the compiler will throw an error. The output file for a source is always the sourcefile truncated at the first number, with the number as the extension. For example, 'logic1.cg' output is 'logic.1', 'log2a3.txt' becomes 'log.2', etc.

The maximum number of source files (including those specified by name, by wildcard and in file lists) is 200, which seems odd since AGI allows up to 256 logics in a game.</blockquote>

== References ==

https://sciprogramming.com/community/index.php?topic=2034.0

== Also See ==

*

[[Category:Technical Info]]

WinAGI

2022-02-15T04:33:41Z

Andrew Korson:

File:WinAGI 2 1 15.zip

2022-02-15T04:11:56Z

Andrew Korson: Install file for WinAGI version 2.1.15

Install file for WinAGI version 2.1.15

WinAGI

2021-12-26T20:15:24Z

Andrew Korson: /* Download */

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2021|2021/04/03]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| image = [[Image:winagi.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.1.12
| ReleaseDate = [[2021|2021/04/03]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

The current version of WinAGI is 2.1.12: - Adds a new executable file that runs in windowless console mode. Fixes bug in settings functions that would not save MsgByNumber value. Adds menu item and toolbar button to show character map dialog on logic and text editors. Modifies error messages when read-only files are encountered so it is more clear to user. Adds command line switches to compile games without running the user interface. Allows use of lower case letters in the GameID property. Fixes bug in words editor when a file with no group zero words is opened. Fixes a bug in view editor when a view with a bad description pointer is opened. Fixes unhandled error in global editor that crashes program if entire row is selected when switching to a different window. Fixes bug in global editor that would clear clipboard when an entire row is copied. Fixes bug in settings form that does not show comment bold status in the preview window. Adds option to decompile message arguments as markers (m1, m2, etc) instead of literal strings. Fixes the broken line tool in Picture Editor. Adds a listbox option to display resources, navigation buttons to make browsing through resources easier, support for code snippets, improvements to rich text editor, layout editor, and many more minor enhancements and bug fixes. It also includes playback and export of Apple IIgs sounds (but not editing - yet).
</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. '''NEW!!''' Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* '''NEW!!''' Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* '''NEW!!''' Hovering over defined words will show the variable/flag/string value assigned to the define
* '''NEW!!''' Easily change comment status for multiple lines of text using the block/unblock comment feature
* '''NEW!!''' Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* '''NEW!!''' Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* '''NEW!!''' Priority lines can be adjusted to match [[set.pri.base]] command options
* '''NEW!!''' Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* '''NEW!!''' Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* '''NEW!!''' Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* '''NEW!!''' A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

'''NEW!!''' Changes made to global defines automatically update all affected logic scripts

'''NEW!!''' Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command, and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_1_12.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.17 MB]</span>
** [[File:WinAGI_2-1-14source.zip|Source code]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

File:WinAGI 2-1-14source.zip

2021-12-26T20:03:58Z

Andrew Korson:

User:Andrew Korson

2021-04-04T08:24:06Z

Andrew Korson: /* Games by Andrew Korson */

{{Stub}}
{{DesignerInfobox
| Portrait = [[Image:AndrewKorson.png|150px]]
| Name = Andrew Korson
}}

==<br /> A.K.A. ==

* AGKorson

==<br /> About ==

<blockquote>
Author of WinAGI
</blockquote>

==<br /> Home Page ==

* [mailto:agkorson@charter.net agkorson@charter.net]

==<br /> Games by Andrew Korson ==

<blockquote>
{| class="wikitable sortable" 
! width="350" | Title !! width="30" | Year !! width="450" | Credits
|- valign="top"
| [[WinAGI]] || align="center" | [[2021|2019/04/03]] || Developer
|}
</blockquote>

==<br /> References ==

<references />

==<br /> See Also ==

* [[:Category:Releases by Andrew Korson|Releases by Andrew Korson]]
* [[:Category:Fan AGI Software Developers|Category:Fan AGI Software Developers]]

WinAGI

2021-04-04T08:22:46Z

Andrew Korson:

<div align="center"><span style="font-size: 22pt">WinAGI Game Development System</span><br />
''Author: [[Andrew Korson]]''<br />
[[2021|2021/04/03]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| image = [[Image:winagi.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.1.12
| ReleaseDate = [[2021|2021/04/03]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

The current version of WinAGI is 2.1.12: - Adds a new executable file that runs in windowless console mode. Fixes bug in settings functions that would not save MsgByNumber value. Adds menu item and toolbar button to show character map dialog on logic and text editors. Modifies error messages when read-only files are encountered so it is more clear to user. Adds command line switches to compile games without running the user interface. Allows use of lower case letters in the GameID property. Fixes bug in words editor when a file with no group zero words is opened. Fixes a bug in view editor when a view with a bad description pointer is opened. Fixes unhandled error in global editor that crashes program if entire row is selected when switching to a different window. Fixes bug in global editor that would clear clipboard when an entire row is copied. Fixes bug in settings form that does not show comment bold status in the preview window. Adds option to decompile message arguments as markers (m1, m2, etc) instead of literal strings. Fixes the broken line tool in Picture Editor. Adds a listbox option to display resources, navigation buttons to make browsing through resources easier, support for code snippets, improvements to rich text editor, layout editor, and many more minor enhancements and bug fixes. It also includes playback and export of Apple IIgs sounds (but not editing - yet).
</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. '''NEW!!''' Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* '''NEW!!''' Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* '''NEW!!''' Hovering over defined words will show the variable/flag/string value assigned to the define
* '''NEW!!''' Easily change comment status for multiple lines of text using the block/unblock comment feature
* '''NEW!!''' Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* '''NEW!!''' Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* '''NEW!!''' Priority lines can be adjusted to match [[set.pri.base]] command options
* '''NEW!!''' Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* '''NEW!!''' Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* '''NEW!!''' Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* '''NEW!!''' A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

'''NEW!!''' Changes made to global defines automatically update all affected logic scripts

'''NEW!!''' Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command, and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_1_12.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.17 MB]</span>
** Source code is available by contacting the developer, [[Andrew Korson]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]

WinAGI

2021-04-04T08:21:49Z

Andrew Korson:

<div align="center"><span style="font-size: 22pt">WinAGI</span><br />
''Author: [[Andrew Korson]]''<br />
[[2019|2021/04/03]]</div>

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| image = [[Image:winagi.png|thumb|center|<div align="center">''WinAGI Screenshot''</div>]]
| Version = 2.1.12
| ReleaseDate = [[2021|2021/04/03]]
| Company = N/A
| Published = {{Published}}
| Developers = {{AndrewKorson}}
| ProgLanguage = {{VB6}}
| OpenSource = {{Open}}
| License = {{GPL}}
| Source = {{SourceSW}}
| Platform = {{WinTool}}
| Type = {{AGIIDE}}, {{AGIDevTool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

==<br /> Description ==

<blockquote>
WinAGI is a full featured game development system, that includes editors that provide full control over of all resources in an AGI game. It includes many new integrated tools to assist in game design and development, allowing you to create new AGI games more efficiently and with less effort.

The WinAGI Game Development System was created by [[User:Andrew Korson|Andrew Korson]]. It may be distributed under the terms of the GNU General Public License.

The current version of WinAGI is 2.1.12: - Adds a new executable file that runs in windowless console mode. Fixes bug in settings functions that would not save MsgByNumber value. Adds menu item and toolbar button to show character map dialog on logic and text editors. Modifies error messages when read-only files are encountered so it is more clear to user. Adds command line switches to compile games without running the user interface. Allows use of lower case letters in the GameID property. Fixes bug in words editor when a file with no group zero words is opened. Fixes a bug in view editor when a view with a bad description pointer is opened. Fixes unhandled error in global editor that crashes program if entire row is selected when switching to a different window. Fixes bug in global editor that would clear clipboard when an entire row is copied. Fixes bug in settings form that does not show comment bold status in the preview window. Adds option to decompile message arguments as markers (m1, m2, etc) instead of literal strings. Fixes the broken line tool in Picture Editor. Adds a listbox option to display resources, navigation buttons to make browsing through resources easier, support for code snippets, improvements to rich text editor, layout editor, and many more minor enhancements and bug fixes. It also includes playback and export of Apple IIgs sounds (but not editing - yet).
</blockquote>


== Features ==

<blockquote>
Most of WinAGI's features are customizable via the Settings command, allowing users to configure the design environment to suit individual preferences. Users can use menus, keyboard shortcuts or toolbars for most actions, depending on preferred input method.

WinAGI provides many enhancements to your AGI game to assist in development. These enhancements won't be part of the final game, but make the design process go much more quickly:

* Resource List: A tree-based layout of your game, with easy access to key properties for your game, and individual resources
* Resource IDs: Each resource can be given an ID to help identify it in logics. This improves readability. '''NEW!!''' Changes to Resource IDs automatically updates all relevant logic scripts
* Preview Window: All resources can be previewed
* Import/Export: WinAGI allows you to import and export all resource types, and support several format types for each resource type.
* Printing: All resources can be printed from within WinAGI.
* Compiler: WinAGI includes a robust game compiler that allows you to do a full game compile; compile to a new directory; rebuild volume files to reduce slack space, and compile only those logics which have had their source code changed
* New games can be created from templates or from scratch
* '''NEW!!''' Seamlessly integrate game engines, including [[ScummVM]], [[NAGI]] and [http://dosbox.com DOSBox] (with original DOS files) to easily test games during development
</blockquote>

== Resource Editors ==

<blockquote>
WinAGI includes highly capable editors for all AGI resource types. Every editor includes multiple levels of Undo.

=== Logic Editor ===

Features of the Logic Editor:

* '''A rich text editor with customizable syntax highlighting'''
* AutoText complete feature for AGI commands
* Easily insert defines and reserved words by using the List Defines command
* Supports the 'official' AGI syntax
* Includes a tool to 'clean up' the message section, eliminating clutter and wasted space in compiled logics for unused messages
* '''NEW!!''' Hovering over defined words will show the variable/flag/string value assigned to the define
* '''NEW!!''' Easily change comment status for multiple lines of text using the block/unblock comment feature
* '''NEW!!''' Use the embedded character map tool to easily add extended characters to message text

=== Picture Editor ===

Features of the Picture Editor

* Toolbar for easy access to common actions
* Drawing tools for all standard picture draw commands
* New tools for drawing circles, rectangles, trapezoids
* '''Test mode that allows you to use any view to validate how the view interacts with the picture'''
* Cut, copy and paste feature alllowing easy control over multiple drawing commands
* drag-an-drop movement control over individual coordinates as well as selections of commands
* Vertical and horizontal flipping of drawing commands
* Split and Join feature allowing much finer control of the drawing action
* Work in split screen mode, or toggle between visual and priority screens
* Load background images to allow tracing of existing graphics images
* '''NEW!!''' Transparency setting allows background to be visible while drawing over it
* Show or hide priority lines to help manage picture priority
* '''NEW!!''' Priority lines can be adjusted to match [[set.pri.base]] command options
* '''NEW!!''' Export pictures (or priority screen) as bitmap, jpeg or tiff image, individually or in bulk
* '''NEW!!''' Individual coordinates can be manually edited to fine tune coordinate position
* Multi-level Undo capability

=== Sound Editor ===

Features of the Sound Editor:

* Toolbar for easy access to common actions
* '''Staff based graphical design window'''
* '''NEW!!''' Option to display graphical window for only the currently active track
* Easy manipulation and complete control of each note property via propery window
* Preview sounds as MIDI output
* Choice of MIDI instruments when previewing sounds
* Import and export sounds as Nick Sonneveld's sound script formatted files
* Export sounds as MIDI files
* Multi-level Undo capability

=== View Editor ===

Features of the View Editor:

* Toolbar for easy access to common actions
* Common pixel based editing tools; pencil, line, box, solid box, eraser
* Selection tool to easily cut, copy, paste move cel data
* '''Clipboard support to allow pasting of cel data, entire cels and entire loops among different views'''
* '''NEW!!''' A preview window is included in the editor to show effect of changes to cels in real time
* Multi-level Undo capability

=== OBJECT Editor ===

Features of the OBJECT Editor:

* A search-in-logic feature to easily find instances of an inventory object in your game logics
* '''Ability to edit the Maximum Screen Objects value for your game, instead of being stuck with the default of 16'''
* Automatic detection of duplicate items
* Multi-level Undo capability

=== WORDS.TOK Editor ===

Features of the WORDS.TOK Editor:

* A toolbar for easy access to common actions
* Undo command
* '''A search-in-logic feature to easily find instances of a word in your game logics'''
* Drag-and-drop functionality to add words to logics
</blockquote>

== WinAGI Tools ==

<blockquote>
Besides the editors for all resource types, WinAGI includes some additional tools to assist in game design.

=== Layout Editor ===

To assist in overall game design, WinAGI includes an graphical based Layout Editor. With this editor, you can set the overall design of your game by adding rooms and the exit conditions (i.e. new.room commands based on edge codes or other conditions). The layout editor is integrated with the Logic Editor, meaning that as you add, remove, edit various exits, WinAGI will automatically insert the correct code to move ego from room to room. The Help file provides detailed instructions on how to use the layout editor.

=== Menu Editor ===

Instead of manually creating menus, WinAGI offers a Menu Editor that allows you to design your menu in a graphic environment. You can see exactly how the menu will look while you are editing it. Once you have created your menu, WinAGI will automatically create the code and insert it into your logic source file.

=== Global Defines ===

WinAGI offers an alternative to the traditional #include file to manage defined names. The Global Defines editor provides a table based editor to easily manage your list of defines. Names defined in the Global Defines list are available to all logics.
In addition, the names for reserved variables, flags and numerical constants are built in to WinAGI's compiler, and don't need to be explicitly defined for each logic.

'''NEW!!''' Changes made to global defines automatically update all affected logic scripts

'''NEW!!''' Reserved defines can be easily edited for individual preference

=== Custom Tools ===

WinAGI provides a custom Tool menu that allows you to easily launch other programs or utilities, link to web pages, or to documents, such as text files, etc.
</blockquote>

== Compatibility with AGI Studio ==

<blockquote>
WinAGI can read AGI games that have been created with [[AGI Studio|AGI Studio]]. However, certain features of WinAGI are not supported by AGI Studio, namely:

* resource IDs (which affects resource file names)
* WinAGI project properties, including layout information and other game level properties
* built-in reserved define names and use of the global defines tool (in lieu of creating separate define.txt for every game)
</blockquote>

== Help File ==

<blockquote>
The WinAGI help file provides documentation for all features available in the development system.

It also includes a detailed, up to date AGI reference section that explains all aspects of AGI.

For help with programming, a detailed logic command reference is also supplied that fully describes every single AGI command, and includes programming notes and examples.
</blockquote>

==<br /> Download ==

* [[File:MSI.png]] [[File:WinAGI_2_1_12.zip|WinAGI Installer]]   <span class="DLInfo"> (MSI file) [9.17 MB]</span>
** Source code is available by contacting the developer, [[Andrew Korson]]

==<br /> References ==

<references />

==<br /> Also See ==

* [[:Category:AGI Tools|AGI Tools]]