Wiki Swiss Tool

File:Wiki Swiss Tool 1.04.png

Last Updated: August 22nd, 2008

The Wiki Swiss Tool is a stand alone program that provides a number of functions that assist in creating wiki content including cropping images, making icons, template pasting, text formatting and clipboard functions. The tool is intended to remove or minimize repetitive tasks, allowing you to spend more time contributing new content. If you have suggestions, comments, or bug reports, you can post them here. New features will be gladly added on request.

Installing

You do not need to install this program, simply download the zip file, unzip it wherever you like. By default, all image files created will be saved in the Images folder, you can set a different save location for each image type by clicking on the Options tab. To uninstall simply delete the folder (remove your images if you want to keep those). To install an updated version download the new zip and just copy Wiki Swiss Tool.exe to replace the old one, this will preserve any options or templates you may have changed. General templates have been provided, there is a text file for each template so you can change/add templates to suit your needs/tastes.

• Wiki Swiss Tool.zip 1.04 - Updated August 22nd, 2008

User Interface

Each group of functions is accessed by clicking the tab at the top or by pressing the number key for that tab (for example press 2 to access the Live Shot functions). Many times an additional function is accessed by right clicking something. For example the templates provide a secondary template by right clicking. On the expanded clipboard right clicking allows you to set the text (left clicking copies the text that has been stored).

If you don't like having to tab back and forth you can open more than once instance of the program and just leave each one on a particular tab.

Stats Panel

This section is one of the workhorses of this tool, it lets you quickly and simply save the stats panel and icon for an in game item.

1. While in game (windowed or fullscreen), press ALT + PRT SCR (both at the same time). This captures an image to the clipboard of just AC (if you don't press ALT the capture will be of your entire desktop).
2. Click the Panel tab or press 1 (if not already in Panel mode), then left click the button marked with the pixel height of the panel you wish to capture. If you're uncertain how high the panel is, you can right click any of the buttons for a preview.
3. Alternatively you can use in game screen shots, though the quality will generally be lower (more artifacts). Be sure to check the Full Screen option (in the Options section), and just drag and drop the .jpg file (screen shots are saved by default to the Asheron's Call folder in My Documents) onto one of the buttons on the left side. For example to extract an icon and a panel 300 pixels high, drop the file onto the button marked 300.
4. An input dialog will open asking you to name the file. Type the name and press enter/return or click OK. In the Options section you can specify a prefix, a suffix, and what type of file to save as (bmp, gif, jpg, or png). You can also specify the quality of compression for jpgs, ranging from 1 to 100% (75-90% provides a good compromise between size and image quality). By default there is no suffix or prefix for stats panel images and they are saved as jpgs at 75%.
5. There is a check box labeled Icon in the upper left corner, if checked the icon will be extracted from the image and saved as well. By default icons have "Icon" as a suffix and are saved as pngs, unless changed in the Options section. For panels without an icon, such as for creatures, simply uncheck the Icon box and no file will be saved.
6. If you don't see the size you want on any of the buttons, hold SHIFT and right click one of the buttons (any). It will ask you the height of your panel. Now left click the newly captioned button again for the new size. If you regularly use sizes not listed, you can permanently change the buttons.

Note: for users of an OS other than Windows XP, you may need to adjust the icon location if using windowed mode.

Live Shots

This section allows you to quickly crop an image of a particular size. This is most commonly used in gathering in game captures of items, creatures, and locations.

1. While in game (windowed or fullscreen), press ALT + PRT SCR (both at the same time). This captures an image to the clipboard of just AC (if you don't press ALT the capture will be of your entire desktop).
2. Click on the Live tab or press 2 (if not already in Live mode), then press the button on the left that has the dimensions you want for your image. For example, if it is a creature, press the button marked 300 400. If it is of an item or NPC, press the button marked 200 300.
3. Alternatively you can use in game screen shots, though the quality will generally be lower (more artifacts). Be sure to check the Full Screen option (in the Options section), and just drag and drop the .jpg file (screenshots are saved by default to the Asheron's Call folder in My Documents) onto one of the buttons on the left side. For example to crop an image 300x400pixels, drop the file onto the button marked 300 400.
4. The screen capture will appear, if you move the mouse across the image you will see a dotted line box that is the size the cropped image will be. Center the box over your target then left click.
5. An input dialog will open asking you for the name of the file. Type the name and press enter. In the Options section you can specify a prefix, a suffix, and what type of file to save as (bmp, gif, jpg, or png). You can also specify the quality of compression for jpgs, ranging from 1 to 100% (90% provides a good compromise between size and image quality). By default the suffix "Live" is added to the name you entered.
6. If you don't see the size you want on any of the buttons, hold SHIFT and right click one of the buttons (any). It will ask you the width and height of your custom crop. Now left click the newly captioned button again for the new crop size. If you regularly use sizes not listed, you can permanently change the buttons.

Template Text

Accessed by pressing the Text tab or pressing 3, this is a simple but very useful function. The wiki code for templates is stored in individual text files in the Templates folder. When pressed each button will copy the text for that template onto the clipboard. Then just paste the text into the Wiki Edit box then fill in the details (right click then paste, or CTL + V). Some buttons have an alternate template if you right click the button instead of left clicking. For example, left clicking the Creature button gives you the standard horizontal template. Right click and the vertical template is given. Or left click NPC for quest and crafter NPCs, and right click for shopkeepers.

Because all templates are stored as text files in the Templates folder you can readily change any of them to better suit your needs. If you make a change, click the Reload button in the lower right corner to load the changes (the template files are normally loaded when the program starts). You can also add or remove templates by indicating the name to display on the button and the file name in the settings file.

Format Text

Accessed by pressing the Text tab or pressing 3, this tool allows you to format text by adding wiki formatting to whatever is currently in the Clipboard. Right clicking for some will have an alternate formatting operation.

1. Copy the base text (right click then copy, or CTL + C).
2. Left click the button for the formatting operation you need:

• Dialog - This will add font coloring and breaks to in game dialog. This may be fixed in a future version but currently it only works for speech (darkgoldenrod) and interactions (green). If you want a different color, you can still use this to add the wiki code, then just change the color. Also, you may need to copy the text into a wiki text box first, then recopy it and then click the Dialog format button. Right clicking will format with cornflower blue (magic).
• Spells - After you've written the spells for an item, copy them and this will format them into a bullet list and add the descriptions for you to add to the Spell Descriptions section. New or unique spells may need to be added by typing them in, but most common spells will be described. If you think a spell should be added, list the name and description here (currently about 70% of spells are in). Right click places all comma delimited items into Wiki link brackets (if a single item places that item in brackets). For example copying "Brilliance, Concentration" then right clicking Spells gives "[[Brilliance]], [[Concentration]]" and can be used in a variety of contexts.
• Image - This will format a name to be displayed as an image link, useful for adding a panel to a talk page. For example, "Golden Key" becomes "[[Image:Golden Key.jpg]]". Right click for the alternate, an icon link. For example, "Golden Key" becomes "[[Image:Golden Key Icon.png]] [[Golden Key]]".
• Redirect - This just adds redirect code, and is useful in making icon pages. For example if you copy the text "Swamp Stone" then click Redirect, you will now have "#Redirect [[Swamp Stone]]". Right click for the alternate, a category tag format ([[Category:Text]]).

Expanded Clipboard

Accessed by pressing the Text tab or pressing 3. Sometimes it's useful to have several chunks of text or images available for pasting. To set a chunk of text or an image, copy the text/image then right click on any of the eight buttons, click Yes or hit return to set the text/image. The first few letters of the copied text will now caption the button or a snippet from the middle of the image will be shown to help you remember which button is which. Now anytime you left click that button, it will copy the original text/image onto the clipboard, ready to be pasted.

Icon Merge

Accessed by pressing the Merge tab or pressing 4. Most people won't need these functions, but this section allows you to create new icons or reproduce icons from in game (this is ideal for items that are either very hard to obtain, or no longer available). This section is still being actively developed, so UI interactions may change in future versions.

Several backgrounds are already shown, drag and drop an image file onto a background to create a new icon. Pure white areas will be transparent when they are combined. Use the drop down box at the bottom to add edge effects.

The gray boxes in the middle can be used to combine more than two images. First drag and drop one of the backdrops onto a gray middle box (if you have a new background image you've created, drag the file onto it). Then add as many more images as desired. Double click when done to get a save dialog. Use the edge effects dialog to add effects during any of the image adds (switch back to None when no effect is wanted). Remember that any pure white areas will be transparent, if you have a pure white area that you want to show up, replace it with near white (eg RGB 254,254,254). Note that dragging and dropping a background tile (any of the nongray tiles) will replace the image, hold shift while dragging and dropping if you want to combine or merge them.

Tools

Accessed by pressing the Tools tab or pressing 5.

Buffed Armor

This a buffed armor calculator that is useful for calculating the protection words (average, excellent, etc) and buffed values for a piece of armor or a shield. Begin by entering the AL in the top box, use tab to jump to the next box and enter the impenetrability value (for example 220 for Brogard's Defiance), then the base values for the seven damage types. Click the Wiki Code button for pastable text to replace that section in the Armor or Shield template. (The first armor value line will need to be changed manually since it is repeated and there is unrelated information on the lines in between.) This just saves some typing time and is useful if you don't have the item to wield or cannot meet the reqs to wield.

Level XP

This is just a simple calculator that lets you see what percent an xp reward is for a particular level. (You can also quickly find out the xp required for a particular level). Adjust the level using the up and down arrows or by replacing the text number with a new one. The top left box is the xp reward, which you can change, the lower left box is the amount of xp for that level. The percent calculation will automatically adjust whenever the reward or level values change. (The arrows make it easier to step through levels to try to guess where the level might max, when you find a nice round %).

Spawn Maps

New Feature - (version 1.05)

A Spawn Map is a png image that is transparent except for red pixels showing locations where a particular spawn has been reported via Mob Tracker. This image is overlaid on a base map of Dereth that is shared across all spawn maps.

The first time you create a new spawn map or update an old spawn map there are a number of steps to take: First Time

1. The Viewer utility is located in the Mob Viewer plugin folder if you have it installed or download it, MobSpawnViewer.exe.
2. Run the Viewer and set the zoom level to 50. Press ALT + PRT SCN to get a screen shot of just the program window. Paste this image into an image editor and save it as a bitmap named "Spawn Map Comparison.bmp" and place it in the same location (folder) as Wiki Swiss Tool.exe. The reason you create your own comparison map is the window borders will vary by OS and the Viewer may change its map if new land masses are added. It's also a large file and must be lossless.
3. Open the bitmap comparison file and find the coordinates of the first pixel of the map itself, e.g., in Windows XP the coordinates are probably 4, 58.
4. Open "Wiki Swiss Tool.ini" (located in the same folder where you saved the comparison file) with a text editor and in the [[SpawnMap]] section change the values for X and Y to the coordinates you observed in your own comparison bitmap. Save and close.

Create Spawn Map

1. Click "Get List" and wait for it to load then select the creature from the drop down list.
2. A highly detailed spawn map will appear, press ALT + PRT SCRN to capture a screen shot of the program to the clipboard.
3. In Wiki Swiss Tool go to the Tools tab and press "Create Spawn Map" and a preview of the map will appear below the button. If there are no red dots anywhere except perhaps along the very left edge or in the middle (the Inner Sea) it means that the creature only spawns in dungeons and you may not want to make a spawn map for this creature.
4. A dialog will open asking for the name of the creature. If doing a lot of these, you can tab back to the Viewer window and press CTRL + C to copy the name, then tab back to the Swiss Tool and CTRL + V to paste. Use the exact name of the creature as it appears in game. This will save a png file in the same location as your panel (stats) images are saved. The resulting image is a filtered version that is smaller and the graduated spawn indications (more intense = more reports) are converted to an ungraduated display that is more visible at small resolutions and allows low spawn creatures like rare spawns to be clearly visible.
5. Once the file is saved you'll need to convert all white pixels to transparent pixels. You can use the free program GIMP, Layer>>Transparency>>Color to Alpha, click the color bar if it's not already white and change HTML notation to "ffffff" and OK, click OK, save the file and then upload it to the Wiki, tag it with [[Category:Spawn Map]].
6. You can now use the map on a page. For example if you had made a map for Dual Fragments, place {{Spawn Map|Dual Fragment}} on the page. Note that if no image exists the Image link will display as red text on top of the base map.

Text Cache

New Feature - (version 1.05)

When accessing old sites or potentially dodgy sites in researching and trying to find old AC content that is no longer online, it can be helpful to use Google's text cache that loads only text from Google's servers (the cache links from a Google search will also try retrieving image files from the original site). You can right click the cache link and select Copy Link Location, then click the Text Cache button on the Tools tab and it will convert the link to a text only link that you can paste into your browser's URLbar.

Options

Accessed by pressing the Options tab or pressing 6.

• Autoname - When checked saving files no longer asks for a name, it automatically generates a time stamp name and saves the file. This is mainly useful when you are capturing a lot of shots quickly while in game and you don't want to have to stop to name them. You can then go back later and name them. Note that you can also use the Expanded clipboard to temporarily store up to 8 screenshots (right click to store something, left click to recopy the stored item).
• Autocopy File Name - When checked this will automatically copy the file name to the clipboard anytime an image is saved. This is primarily useful in saving a little time when uploading images (at least in Firefox typing part of the file name will bring up a list of files in the upload browse dialog, now you can just hit CTL + V instead of searching through the list for the file you just saved.
• Icon Position - For users of an OS other than Windows XP, you may need to adjust the icon location if using windowed mode. This is because the window borders vary slightly from OS to OS and this causes the icon to be in a slightly different location as well. You can easily customize this location by going to the Options section, make sure Windowed Mode is checked. Capture a sample screen shot (ALT + PRT SCR) while in game. Then press the button marked "Train Icon Location." The upper right corner of the screen shot will appear, move the mouse over the image and move the red box until it is exactly covering the icon (a preview window in the lower left corner will show a zoomed view that makes it easier to line up the edges precisely.) Once the red box is exactly covering the icon, left click once. Now the icon should extract correctly whenever using windowed mode. (Whenever using full screen shots, or AC created screenshots, be sure to check Full Screen instead of Windowed).
• Image Settings - You can specify the type, prefix, suffix, and save location for each of the three image types, icons, stats panels, and live shots. GIF support will likely be added in the next release. JPG quality can be specified (from 1 to 100%). The higher the number, the larger the file and the less compression used (fewer visible artifacts). If default path is checked, the images will be saved to the Images folder in the same location as this program. If unchecked images will be saved to the custom path you put (make sure the location is valid).

Settings File

Application settings are saved to a text editable file named Wiki Swiss Tool.ini, located in the same location as the exe. There are a number of settings you may find useful to manually edit.

Each button in the templates section is configured here, you can specify a name, back color (6 digit Hex in RGB format, see here for more info).

The path should either be a valid path to the file, for example "C:\Temp\Template.txt". Or if you store your templates in the default location, the folder named Templates located where the program is at, put the word "Default" then the name of the file. For example, "Default Template.txt".

Although you can reconfigure dimension buttons while in use (SHIFT + Right Click on a button), you can permanently change a dimension in the settings file. For example, if you don't like the 120 pixel height of the first button and want it to be 140 pixels high instead, in the [StatsPanelDimensions] section change 1=120 to 1=140.

Change Log

Version 1.01

• 2008-06-29
• Initial Release

Version 1.02

• 2008-07-17

Fixed:

• Dialog now opens properly for custom size on Panel.
• Able to copy multiline dialog text and lines break correctly (no longer need to paste in edit box and recopy first).
• When in windowed mode, if icon from ID panel doesn't match up correctly (for example with Vista), now able to customize the icon location in the Options section.
• Edge effects now work correctly for multiple image icon construction.

Added:

• Able to drag and drop in game AC screen captures (found in Asheron's Call folder in My Documents, for example ScreenShot00003.jpg). Can extract a stats panel and icon or crop a live shot. Drop file onto the button you'd normally press. For example, if you are going to crop a 200x300 live shot, open the Live section and drop your jpg file onto the 200 300 button and the screen shot will appear with the crop box ready to go at 200x300 pixels.
• The expanded clipboard now supports images as well as text. A small snippet from the middle of the image will appear on the button.
• A percent of level calculator added. Located in the Options section. Allows a quick percent of level calculation given level and xp reward.
• Option to automatically copy the file name onto the clipboard after saving a file (making it easier to find the file in the upload browse dialog).
• More spells to the descriptions formatting, many more need to be added though.
• Right clicking Redirect format button now formats with [[Category:Text]].

Version 1.03

• 2008-07-17

Fixed:

• Corrected minor bug with new windowed/fullscreen selection section.

Version 1.04

• 2008-8-22

Fixed:

• Composite icons now correctly save as 32x32 instead of 480x480.

Added:

• Tools tab added for misc functions and calculators (more to be added in the future). The tools tab is now hotkey 5, and Options has been moved to 6.
• Backgrounds for spell icons added for I to VII and self icon.
• Many more spell descriptions added, including most I to VI spells, self other and vuln.
• When using composite icon squares (gray squares in the middle of the Merge tab), dragging and dropping other background tiles would always replace the image before, now holding the SHIFT key while doing so will merge (combine the two). Currently the only image this would be useful for is the Self Icon. Files dropped will always merge.
• Right clicking the Spells button in the Format Text section on the Text tab now places all comma delimited items into Wiki link brackets (if a single item places that item in brackets). For example copying "Brilliance, Concentration" then right clicking Spells gives "[[Brilliance]], [[Concentration]]" and can be used in a variety of contexts.
• A buffed armor calculator added to Tools tab. Useful for calculating the protection words (average, excellent, etc) and buffed values. Begin by entering the AL in the top box, use tab to jump to the next box and enter the impenetrability value (for example 220 for Brogard's Defiance), then the base values for the seven damage types. Click the Wiki Code button for pastable text to replace that section in the Armor or Shield template. (The first armor value line will need to be changed manually since it is repeated and there is unrelated information on the lines in between.) This just saves some typing time and is useful if you don't have the item to wield or cannot meet the reqs to wield.
• The rounding of the % of level xp on the Tools tab changed from one decimal place to two in order to give greater confidence when looking for max out levels.

Version 1.05

• 2009-01-??

Fixed:

• Autoname file option only worked for the Stats panel, now works for the Live panel also.
• Option added to not save stats panel (so you can save only the icon if desired).
• Autocopy File Name will now be disabled anytime Autoname is turned on to allow multiple operations with the same image.
• Right clicking any Live Shot button now previews the same as right clicking a Panel button (enters free crop mode).

Added:

• Updated several templates and added new templates.
• Advanced templates (question marks mostly replaced with blanks, common entries added-remove ones that don't apply) available for download to replace standard templates.
• Level VIII spell icon added to merge section.
• Most level VIII spell descriptions and missing cantrip and I to VII spells added to spell descriptions function.
• Alternate template names now appear in popup tool tips when mouse hovers over a template button.
• A Free Crop button on the Live panel that allows you to crop an arbitrarily sized image (click Free Crop button at bottom, click on image where a corner of the crop should be, hold button and drag cursor to the desired size of the crop area, release mouse button to complete crop).
• Option to save the clipboard contents on exiting the program, these items will be reloaded the next time the program is run. This is useful if you often load the same items into the expanded clipboard, or if you need to stop working for a while and want to resume where you left off.
• Replaced the Reload button on the templates section of Text with a multi-use button. Use the drop down menu to select any of a number of less frequently used templates, including the Reload function. Select the desired template from the list, now the button above the menu will act as that template.
• A filter tool that creates a transparent png Spawn Map for new creatures or to update an existing spawn map.
• A text cache tool that converts a google cache link to a text only cache link. This is sometimes useful in looking at older sites that may have changed hands etc and be dodgy. This avoids loading any images from 3rd sites and just loads text from google servers.
• A formatting tool that converts one or more sets of coordinates into a Template:Map Point map.