An Advanced Guide to the Hop⁄Grist⁄Yeast Editor
This section is work in progress, hence why it is not in the Table of Contents
The Basic Format of the Ingredient Editors is as follows:
As depicted below, the Scrolled Listbox contains a list of the possible ingredients, these are selectable. On an item being selected, the Modifications: pane is filled with the data of that ingredient.
After selecting an item from the aforementioned Scrolled Listbox the user can remove that Ingredient from their database by pressing the button labelled Delete. This event is not permanent, and on next launch the Ingredient will reappear. To PERMANENTLY remove the Ingredient from the Database the user must press the Save to Database button found in the Modifications: pane.
After selecting an item from the aforementioned Scrolled Listbox the user can modify that Ingredient by pressing the button labelled Modify. This enables the Text Inputs and the buttons within the Modifications: pane, the use of these buttons can be found here.
This button is rather self explanatory; however, it inherits an interesting feature found within Beer Engine. This feature happens when a user after having selecting an ingredient from the Scrollable Listbox, then presses the New button. This causes the new Ingredient to carry all the features and data from this Ingredient to a brand new Ingredient.
The Cancel Button pretty much does as it says on the tin, it cancels your current edits for your Ingredient.
The Clear Form Button is also rather simple to understand with it wiping the data fields for your Ingredient.
if you are not a programmer this button may have some confusion surrounding it, so I will attempt to split this button into two explanations, the simple one and the advanced explanation!
The simplest way to explain this button is that it temporarily stores your changes. On next launch any changes made will be lost.
Wheeler's Wort Works, uses 3 core dictionaries for the main 3 editors (The Hop/Grist/Yeast Editor). When you press on an item in the Scrolled listbox, the dictionary is queried with the name of the selected Ingredient (i.e. Challenger), all the data for this Ingredient (its definition) is then loaded. When you make changes to the values in the Entries and then press the Done Button, your changed values are loaded into temporary memory (RAM). On closing the application this data is cleared and on next launch the database found on your system is loaded instead.
This means if you make 8 renditions (within the same editor) and then press Save to Database all 8 changes are saved to your Drive.
The Save to Database Button is used to save the in memory copies of the current editors database to your drive so that on launch these values will be pulled
The Comments Entry is used to provide, as it says on the tin, comments about this Ingredient - this can prove to be useful when working with .berfx files so you can specify what you changed about that Ingredient for your recipe.