=== Plugin Name === Contributors: codeblab Donate link: http://codeblab.com/ Tags: image, zoom, spyglass, looking glass, glass, enlarge Requires at least: 3.0.0 Tested up to: 3.1 Stable tag: 1.0 Glass is plugin that displays a spyglass (looking glass) over images on a WordPres site so users can look at details. == Description == Glass is plugin that displays a spyglass (looking glass) over images on a WordPres site so users can look at details. When the cursor hovers over an image a round frame is displayed on top of it, the frame shows a (round) part of a hires image, creating the illusion of a spyglass. Currently Glass only works on .jpg and .png images. Click behaviour of the image is unalterd, however, double clicking is "hijacked" to display the GLP license and displaying the homepage of Glass. Glass is activated for images directly linked to an image, where the link target is assumed to be a hires version. Glass also is activated for an image with a size suffix (e.g., -100x100.jpg) linked to a page. The URL of the hires version is guessed by removing the size. Guessing the hires ULR allows Glass to work on galleries of thumbnails. Since galleries can contain many thumbnails, Glass can slow down page loading. Therefore the URL guessing can be alterd by specifying a lower resolution, e.g., 800x600. This will make Glass look for a smaller version. The guessing can also be switched off, too. If linking an image is needed but Glass should not be activated, wrap the image in span begin and end tags. Glass, create a spyglass effect for images, a WordPress Plugin. Copyright (C) 2011 Jan-Mark S. Wams (jms@cs.vu.nl) This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . == Installation == 1. Upload glass_v1_0.zip to the `/wp-content/plugins/` directory. 1. Unpack glass_v1_0.zip, optionally remove it after unpacking. 1. Activate the plugin through the 'Plugins' menu in WordPress == Frequently Asked Questions == = How do I activate Glass on an image? = Once activated it will add its spyglass functionality to any image on your blog that is wrapped in a link to an image. The linked image is taken to be the hires version of the displayed image. WordPress will generate such a link if the [File URL] button is selected in the "Add an image" window. = How do I activate Glass on a gallery? = In general it will work by default. Most gallerie implementation generate a set of thumbnail images that link to something, usually not a hires version. Glass makes an attempt to recognize thumbnails by their -100X100 suffix. If a thumbnail is found, Glass guesses the URL of the hires image (by removing the size suffix). = How do I make my gallery page load faster? = Because Glass will load a hires version for every thumbnail in your gallery, load times can go up dramatically. Switch hires guessing for thumnails off is a simple remedy. To do that goto the Glass page in the Settings menu and wipe "Thumb dx dy". An other solution is to set "Thumb dx dy" to a an existing value, e.g., "800","600", this will force Glass to not use the full resolution version of the image. Be very sure that the image with the propper suffix, e.g., -800x600, does exist. = How do I customize the rim color? = There are two ways to customize the rim. The first way is to generate ten right sized images and add them to a new directory on the Glass plugin directory. Than select it as the "Glass Rim Path" on the Glass page in the Settings menu. The second way is to wipe the "Glass Rim Path". This will give a solid colored rim. The color can be set as a 6 digit hex value in "Glass Rim RGB" on the same page. = Why is the solid color rim not properly anti-aliassed? = A lack of propper support of transparancy in Microsoft Internet Explorer version 5,6,7, and 8 will mess up the altialiassing of the rim. I tried to fix this, but after spending more time on this than on the rest, I gave up. Please forgive me. Please try to forgive Microsoft for not getting it right in all those years, causing thousands of frustrated developers to swindle uncountable hours that could have been used to make something usefull. = Are you nuts? Do you know that the iPod has a much better zoom? = Yes, and I do. Just add iPod, iPhone, iPad to the "Glass Exclude Platforms" on the Glass Settings page. = How do I activate Glass only for category 'X'? = Add the categories you want to the "Glass Categories" on the Glass Settings page. Leaving it empty means all categories. To exclude all categories use an non existing category like "NOTONE". = How do I activate Glass only for page 'Y'? = Add the page names you want to the "Glass Pages" on the Glass Settings page. Leaving it empty means all pages. To exclude all pages use an non existing page name like "NONE". == Screenshots == 1. This screen shot shows Glass active on a thumbnail using Opera on OS X. 1. This screen shot shows Glass active on an image of Bob Floyd rendered using Floyd-Steinberg dithering. The image is kind of big 2400x3122, yet an older G3 Mac running Tiger has no trouble processing it in realtime. 1. This screen shot shows a rather large gallery of rather large images in Firefox on OS X. Works like a charm on most any browser/platform combination I trew at it. 1. This screen shot shows Microsoft Internet Explorer version 8 (still widely in use) with a solid rim. Note the black lines on both the inside and outside of the rim. These are Microsofts way of displaying semi-transparent pixels semi-transparently. Note all other browsers on the Windows platform know how to handle this, so does IE v9. == Changelog == = 1.0 = * Moved to version 1.0 when moving to WordPress hosting. = 0.9 = * Home brew version, used to be private until someone talked me into makeing it available. == Upgrade Notice == = 1.0 = Get this version. There is no other stable one yet.