View source for WinAGI

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

{{FanAGISoftwareInfobox
| Software = WinAGI Game Development System
| Image = [[Image:WinAGI.png|190px]]<br />
''WinAGI'' Screenshot
| Version = 2.3.6
| ReleaseDate = {{2024S}}-02-12<ref>From the file's creation date</ref>
| Company = {{NAToolCo}}
| DevStatus = {{ActiveDev}}
| Published = {{Published}}
| Developers = {{AndrewKorsonToolDev}}
| Interface = {{GUI}}
| ProgLanguage = {{VB6}}
| OpenSource = {{OpenSRC}}
| Source = {{SourceSW}}[https://github.com/AGKorson/WinAGI-GDS Yes]
| License = {{GPL2}}
| Platform =  {{WinTool}}
| Type = {{FanAGIIDE}}, {{FanAGIDevTool}}
| Engine = {{AGITool}}
| Localization = {{EnglishTool}}
| Website = [[scipf:15.0|AGI Forum]]
}}

<br />
==<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>
<!--
===<br /> Screenshots ===

{| align="center" width="80%"
| align="center"|[[Image:WinAGISS1.png|320px]]
| align="center"|[[Image:WinAGISS2.png|320px]]
|}
-->

== 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>

<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>
</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 /> Requirements ==

<blockquote>
<!-- Add requirements here -->
</blockquote>

==<br /> Version History ==

<blockquote>
<!-- Place version history here -->
</blockquote>

==<br /> Development Status ==

<blockquote>
WinAGI Game Development System is currently under active development.
</blockquote>

==<br /> Options ==

<blockquote>
<!-- Add options here -->
</blockquote>

<div id="DL">
==<br /> Download ==

* [[File:MSI.png|MSI File]] [[File:WinAGI_2_1_12.zip|WinAGI Installer]] &nbsp; <span class="DLInfo"> (MSI file) [9.17 MB]</span>
** [[File:WinAGI_2-1-14source.zip|Source code]]
<!-- ** Source code is available by contacting the developer, [[Andrew Korson]] -->

==<br /> Known Issues ==

* 

==<br /> Credits ==

[[Andrew Korson]]

==<br /> Legal ==

WinAGI Game Development System was distributed with the {{GPL2}}

==<br /> References ==

<references /><!-- Do not edit this section. It is autopopulated by <ref></ref> tags -->

==<br /> Also See ==

* [[:Category:Strings Articles|Strings Articles]]
* [[:Category:Graphics Articles|Graphics Articles]]
* [[Vector Graphics]]
* [[:Category:Vector Graphic Articles|Vector Graphic Articles]]
* [[Raster Graphics]]
* [[:Category:Raster Graphic Articles|Raster Graphics Articles]]
* [[:Category:AGI Resources|AGI Resources]]
* [[Volume File (AGI)|AGI Volume Files]]
* [[AGI DIR File|AGI Directory File]]
* [[Logic Resource (AGI)]]
* [[AGI Specifications: Chapter 4 - The Logic Language|AGI Logic Language Specifications]]
* [[:Category:Logic Resources|Logic Resource Articles]]
* [[AGI Stack Overflow|AGI Stack Overflow Information]]
* [[:Category:Stack Articles|Stack Articles]]
* [[:Category:WORDS.TOK Articles|WORDS.TOK Articles]]
* [[:Category:AGI Picture Resources|AGI Picture Resources]]
* [[:Category:AGI View Resources|AGI View Resources]]
* [[:Category:AGI Sound Resources|AGI Sound Resources]]
* [[:Category:OBJECT File (AGI) Articles|AGI OBJECT File Articles]]
* [[:Category:Scripting|Scripting]]
* [[:Category:AGI IDEs|AGI IDEs]]
* [[:Category:AGI Development Tools|AGI Development Tools]]
* [scipf:15.0|AGI Forum]
&nbsp;
[[Category:References]]
[[Category:AGI References]]
[[Category:Development Tools]]
[[Category:AGI Development Tools]]
[[Category:Technical Info]]
[[Category:AGI Technical Info]]
[[Category:Strings]]
[[Category:AGI Strings]]
[[Category:Scripting]]
[[Category:AGI Scripting]]
[[Category:Graphics Articles]]
[[Category:AGI Graphics Articles]]
[[Category:Vector Graphic Articles]]
[[Category:Raster Graphic Articles]]
[[Category:Resource Articles]]
[[Category:AGI Resource Articles]]
[[Category:Resource Volumes]]
[[Category:AGI Resource Volumes]]
[[Category:AGI Dir File Articles]]
[[Category:Logic Resources]]
[[Category:AGI Logic Resources]]
[[Category:Stack Articles]]
[[Category:AGI Stack Articles]]
[[Category:WORDS.TOK Articles]]
[[Category:Picture Resources]]
[[Category:AGI Picture Resources]]
[[Category:View Resources]]
[[Category:AGI View Resources]]
[[Category:Sound Resources]]
[[Category:AGI Sound Resources]]
[[Category:OBJECT File (AGI) Articles]]