User Tools

Site Tools


manage_cartridges

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

manage_cartridges [2012/07/09 23:54] (current)
Line 1: Line 1:
 +====== Manage Cartridges ======
 +
 +This screen is used to create, delete, compile and load cartridges for editing. Options are selectively enabled or disabled based on their availability at any given time.
 +
 +{{:​manage_screen.png}}
 +
 +===== Select Cartridge =====
 +
 +This field, which only has the option of "​Choose"​ until you've created some cartridges, is used to determine which cartridge the "​Operation"​ will be performed on. If you're creating a new cartridge, this option should not have anything selected (or say "​Choose"​ if it is your first cartridge).
 +
 +===== Operation =====
 +
 +This field determines what you want to do with the cartridge you selected in the [[#Select Cartridge]] field.
 +
 +  * Create - Create a new blank cartridge. Only available if the select field has no selection or "​Choose"​ is selected.
 +  * Edit - Load the [[edit cartridge]] screen with the selected cartridge.
 +  * Compile Cartridge - Compile the selected cartridge and download the [[GWC File]].
 +  * Copy - Create a new cartridge as an identical copy of the selected cartridge.
 +  * Write GWZ File - Create and download the cartridge as a [[GWZ File]].
 +  * Write Lua File - Create and download the source code as a [[Lua File]].
 +  * Delete - Remove the selected cartridge from earwigo. If you don't have a backup, this cartridge will be gone forever.
 +  * Upload Media - Allows you to [[upload media]] for the cartridge.
 +  * Import GWZ File - Upload a GWZ File from you computer and import it into earwigo. Only available if the select field has no selection or "​Choose"​ is selected.
 +  * Import Lua File - Upload the source code from a Lua File and import it into earwigo. Only available if the select field has no selection or "​Choose"​ is selected.
 +  * Backup - Download a backup of your cartridge to be stored on your local computer. This file should not be modified while on your computer as it will not be able to be restored.
 +  * Restore - Upload a previously downloaded Backup file and re-import it to earwigo.
 +  * Fix Errors - 
 +
 +===== New Name =====
 +
 +Available only if either "​Create",​ "​Copy",​ "​Import GWZ File" or "​Import Lua File" are selected as the [[#​operation]].
 +
 +===== Cartridge language version (0-n) =====
 +
 +Available only if either "​Compile",​ "Write GWZ File" or "Write Lua File" are selected as the [[#​operation]]. Allows you to choose which language you'd like your cartridge to be compiled in. See also [[Compiling Multiple Languages]].
 +
 +===== Relocation options =====
 +
 +
 +Available only if either "​Compile",​ "Write GWZ File" or "Write Lua File" are selected as the [[#​operation]]. Allows you to offset all waypoints to a new center location. Also can be used to create a Play Anywhere cartridge.
 +
 +===== Include author script =====
 +
 +Available only if either "​Compile",​ "Write GWZ File" or "Write Lua File" are selected as the [[#​operation]].
 +
 +===== Target device =====
 +
 +Available only if either "​Compile",​ "Write GWZ File" or "Write Lua File" are selected as the [[#​operation]]. Specify what device the file should be optimized for.
 +
 +===== Select file to upload =====
 +
 +Available only if either "​Upload Media",​ "​Import GWZ File", "​Import Lua File" or "​Restore"​ are selected as the [[#​operation]].
 +
 +===== A note on uploading files =====
 +
 +The upload options (GWZ, Lua) are intended to help people migrate from the Groundspeak builder (GWB) to Earwigo. ​ The Lua upload takes a Lua file which has been output by GWB and creates a new Earwigo cartridge. ​ The GWZ upload does the same (assuming that there is exactly one Lua file in the GWZ zipped archive), then adds the media resources from the other JPG/MP3/etc files to the Earwigo cartridge.
 +
 +Note that the Lua file import process is not a general-purpose Lua file reader. ​ If you have made any edits to your cartridge'​s Lua file since it was last saved by GWB, you can expect these to be lost during the upload process. ​ Notably, any functions which you have added will be lost unless they are in the "​Author functions"​ section, and any complex statements which GWB can't handle, will also cause problems for Earwigo (which will typically ignore any statement whose syntax it doesn'​t recognise).
  
manage_cartridges.txt ยท Last modified: 2012/07/09 23:54 (external edit)