About SGE Black Hole Mapper

This tool was inspired by the work of SGE player Ace/Starwynd who manually created some black hole map images. His maps proved very useful, but they were difficult to create and to amend. This SGE Black Hole Mapper makes creating and maintaining black hole maps much easier and turns it into a community effort. The goal is to make map creation and maintenance easy, not to be an information destination in itself. Final maps can are made into images and should be posted in the Wiki.

This tool was written by squeemish for all SGE players. Credit goes to Mojo at Seifi.org for the basic clipping technique. Special thanks to walterzorn.com for Mr. Zorn's excellent DHTML JavaScript library for drawing the lines and circles.

At its core this is a set of 9 print-screen images that are dynamically clipped in your browser. The tricky part is getting the image position and clipping exactly correct, because margins and overlaps make every image in the grid clipped and positioned differently. The end product is actually a collection of images with line segments on top for the black hole routes, but it appears to the end user to be a single map image.

If you view the source you are looking at the final resolved product. If you are interested I'm happy to send you the code. This is on an IIS host so most of the code is ASP (vbscript) and it uses javascript heavily for the line segments.

Sample Map

This is a sample map with extra whitespace between the images so the clipping can be seen.


Here is the 6th print-screen image without the dynamic clipping or positioning. Compare to the center-right section of the full map above. This particular cell is first clipped to the size of the map. It is further clipped on the top with overlap_y, (the amount it overlaps with the image above it), on the left with overlap_x, on the right with margin_right (anything beyond the (1,1) to (999,999) map coordinates), and this one has no extra clipping at the bottom.

Internal Numbers and Formulas

Below are the behind-the-scenes numbers. These values are used in various formulas to drive how the images are clipped and stitched together. Some are implemented as constant values, some are variable from map to map, and some are calculated. (Note these are the 2009 numbers, the pre-2009 numbers can be displayed if needed too.)

(constant) Size of the screen (size of the printscreen image): (constant) Number of print screens taken to complete the map: (constant) Where to find the map within the printscreen images: (constant but may change) The amount of overlap from one map's image to the next: (constant but changing) The min map coordinates on the 1st image and the max coordinate from the last image: (constant) The desired final map coordinates (defines basic margin clipping): Other special use parameters:

These are results from intermediate formulas used in the process, presented here mostly for diagnostic purposes.

Update History


Back to the Index Page