Pvii Image Gallery Magic 2 (Igm2) : Al Sparber and Gerry Jacobsen, Co-Founders
Pvii Image Gallery Magic 2 (Igm2) : Al Sparber and Gerry Jacobsen, Co-Founders
Image Gallery Magic 2 can literally bring your images to life with smooth cross-fading, snappy
glides, or elegant Ken Burns style pan and zoom effects for modern browsers. IGM 2 utilizes
HTML5, CSS level 3 and advanced PVII DOM Scripting to deliver a broadcast-quality gallery
presentation that does your images proud.
We hope you enjoy using Image Gallery Magic 2 as much as we enjoyed creating it!
Contents
Thumbnails .................................................................................................................................................. 9
Caption ......................................................................................................................................................... 9
Description .................................................................................................................................................. 9
Animation................................................................................................................................................... 10
Images List................................................................................................................................................. 11
Through the Viewport... How Ken Burns Zooming and Panning work ........................................................... 15
Toolbar........................................................................................................................................................ 18
Paginator .................................................................................................................................................... 18
My Images are zoomed so large they look distorted... What can I do? ............................................................ 20
Full-Screen Mode.............................................................................................................................................. 20
3. Selection/Action Buttons.................................................................................................................. 26
Look for the extension installer file p7_IGM2_220.mxp or p7_IGM2_220_upg.mxp in the root of the zip
archive you downloaded. Double-click the file to install the extension. Dreamweaver's Extension
Manager will open and you will be prompted to complete the installation. Once the installation is
complete, you’ll need to restart Dreamweaver.
OS X users: If, upon double-clicking the installer, Extension Manager does not properly launch, you have a file association issue. To remedy
the problem locate the installer file from inside a Finder window and double-click it.
Site Name
This is the name that appears in the Files panel and in the Manage Sites dialog box.
Asset Folders
When you create a gallery, the system creates an assets folder named p7igm2 at the same level as
the page that contains your gallery. This folder will contain the relevant CSS files, script, and the
loading image. When you publish your site, make sure you upload the entire p7igm2 folder, as well
as the folders that contain your gallery images. The system will also create a fireworks folder,
which contains a special Fireworks file, IGM-controls.png, which you can use if you would like to
edit the toolbar control images.
When you first launch the IGM2 user interface, it will open in:
Let's walk through the interface from top to bottom and get acclimated.
Thumbnails
Choose None, Above Image or Below Image. Enable Scrolling determines how the thumbnails
display. If checked, this option will display the thumbnails in a single horizontal scrolling row.
Scrolling Duration sets the scrolling speed. Increasing the duration value will slow the scrolling
speed. If you deselect Enable Scrolling your thumbnails will display without scrolling controls in a
matrix composed of as many rows necessary to display all of your thumbnails.
Note: If you create your gallery with thumbnails and subsequently set thumbnail display to None, your thumbnails will be removed
from your markup. If you later decide you want to show thumbnails, you can use the Thumbnail Path box or re-import your
images.
Caption
Choose None, Overlay Top or Overlay Bottom. For Animation, choose None, Slide, or Fade. If you
choose an animation, set its Duration. The higher the duration value, the slower the animation will
run. The duration is set in milliseconds (ms). 1000 ms = 1 second.
Description
Choose None, Overlay Top or Overlay Bottom. For Animation, choose None, Slide, or Fade. If you
choose an animation, set its Duration. The higher the duration value, the slower the animation will
run. The duration is set in milliseconds (ms). 1000 ms = 1 second.
Animation
Select an animation mode for your gallery by choosing one of the following:
None
Cross Fade
Slide in From Left
Slide in From Right
Slide in From Top
Slide in From Bottom
Random Slide (a combination of the 4 slide methods)
Ken Burns Style (Pan and Zoom)
The Ken Burns effect runs in modern browsers only. Older browsers are automatically switched to the Auto Fit Fade
animation
Auto Fit Fade (Images are zoomed until they fit the entire viewport)
Duration
The higher the duration value, the slower the animation will run. The duration is set in milliseconds
(ms). 1000 ms = 1 second.
Images List
The Images list is, of course, a list of the images that make up your gallery. The above screen
capture shows the images list after images have been added. Across the top of the list are 5 action
buttons:
Add: Use this button to add images to your gallery, one at a time. When you click the Add button
(or when you open the interface the first time), a new entry will show up in the list labeled as New
Image. This is a placeholder. Select the placeholder image and then enter a path to the image in the
Image Path box. You can also use the Browse button to the right of the Image Path box to browse
to your image in a dialog box. If you are using thumbnails, enter a path to the thumbnail image in
the Thumbnail Path box. Note that if Thumbnails were set to None, the Thumbnail Path box will be
grayed out (inactive).
Delete: Select an image in the list and click the Delete button to remove that image.
Up: Select an image in the list and click the Up button to move the image up in the list. The image
will move up one row per click until it reaches the top row.
Down: Select an image in the list and click the Down button to move the image down in the list.
The image will move down one row per click until it reaches the bottom row.
Import: Use the Import button to import images from existing folders.
Image-Specific Settings
Below the Images list and above the Options section, you will find several key image-specific
settings. The settings in this section will apply only to the selected image in the Images list.
Image Path
When you click the Add button (or when you open the interface the first time), a new entry will
show up in the Images list labeled "New Image". This is a placeholder. Select the placeholder image
and then enter a path to the image in the Image Path box. You can also use the Browse button to
the right of the Image Path box to browse to your image in a dialog box. Note that if you choose to
import your images, the image path will be filled in automatically as part of the import process.
Thumbnail Path
If you are using thumbnails, enter a path to the thumbnail image in the Thumbnail Path box. You
can also use the Browse button to the right of the box to browse to your thumbnail image in a
dialog box. Note that if Thumbnails were set to None, the Thumbnail Path box will be grayed out
(inactive). Note that if you choose to import your images, the image path will be filled in
automatically as part of the import process.
Caption
This box will become active if you've chosen to show a Caption. By default, the system will use the
image file name to pre-supply a caption for you. You can edit the pre-supplied caption as you
wish. Note that the Caption element supports plain text only. You cannot enter HTML markup in the
Caption box. You can add captions for some or all of your images. If you do not want a caption to
show for a particular image, simply make the Caption box blank.
Description
If you opted to show a Description, this box will be active. There is no pre-supplied value for
Description. You can add a description for one or all of your images. The Description box can be
left blank if you do not wish a description to appear for a particular image. The Description box
supports HTML markup. This allows you to include paragraphs, links, or even images. If you are not
adept at writing markup in real time, simply create a blank page in Dreamweaver and add what you
want to that page. Switch to Code View and copy the markup, which would be all code between (but
not including) the opening and closing body tags:
<body>
here is your markup to copy
</body>
Note: When entering plain text the system will automatically convert any line breaks to a <br> tag so that the
line break will be viewable in the actual presentation. If the system detects actual markup that you have
entered, then it will ignore line breaks and simply render the description content according to the markup you
have included.
Zoom
Sets a starting and ending zoom value. Zoom values cannot be less than 1. Zoom values are based
on an image's size after it has been adjusted to fit the viewport.
Duration
The duration defines the length of time (in seconds) that the Ken Burns animation will run. In many
cases, you would want to set the Ken Burns duration to a value equal to or greater than the Pause
setting between images.
Let's consider a scenario where your gallery is 800 pixels wide and your images are each 1600
pixels wide by 900 pixels tall. The system will zoom your first image until it fits within the
viewport. The new height and width will be consistent with the image's natural aspect ratio. The
scaling is perfectly proportional. Your 1600x900 image will be proportionally scaled until its width
is the same width as the viewport, which happens to be 800 pixels in this case. When the image's
width reaches 800 pixels, its height will be 450 pixels. The system will then set the viewport height
to 450. All subsequent images will be scaled proportionally until their height is at least 450px and
their width at least 800px. This is why it is usually better to use images that are the same size.
Additional Options
Additional general options appear in the second screen. Click the Next: General Gallery Options
button to access the second screen.
General Options
Gallery Height - Auto or Fixed (see below)
Page Startup: Start with Image - Which image in the list appears first
Random - Shuffle all images into a random order
When using the Ken Burns or Auto Fit Fade animations, the viewport will neither grow nor shrink.
Your images will be scaled up or down to fit the viewport, whose height will be calculated by the
IGM2 system based on the height of the first image.
Fixed Height
Fixed height can be handy if you must restrict your gallery to a tight vertical space within your
design or if your images are small and you do not want them to be scaled up. When you use the
Cross Fade or Slide animations, along with fixed height, images are scaled down if the viewport is
smaller than the image's actual size. If the viewport is larger than an image's natural size, the
image is centered both horizontally and vertically inside the viewport.
When using the Ken Burns or Auto Fit Fade animations with Fixed Height set, your images will be
scaled up or down to fit the viewport.
Toolbar
Toolbar Position - Above Image, Below Image, or None
Controls to Include on Toolbar: First, Previous, Pause/Play, Next, Last, Fullscreen Mode. Choose any
combination you want.
Full Screen Mode Note: The way in which your images display in fullscreen mode is dependent on the animation
method you choose. If using the Cross-Fade or Slide animations, your full-screen presentation will show your
gallery in a fixed-height type of display, with the height being the full height of the browser window. Images,
therefore, will never be zoomed larger than their natural size. If you select the Ken Burns or Full-Fit Cross Fade
animations, your images will scale to fill the entire available space of the window.
Paginator
Paginator Position - Above Image, Below Image, Overlaid Top, Overlaid Bottom, None
Style Theme
IGM2 comes with a variety of pre-defined CSS style themes. A preview of the selected Style Theme
is displayed to the right of the Style Theme select list. This Preview will change whenever you select
a different Style Theme.
In Modify Mode you can add or import images, delete images, re-order images, or change any
options.
Will it fit?
Your IGM2 gallery will always fit—perfectly. No matter what size your images are, the IGM2 system
will scale them to fit the area that your gallery occupies.
1. Add a wrapper DIV around your gallery and set its width to a value that is no greater than
the natural width of your images.
2. Switch from Auto Height to Fixed Height. The height you set will determine the viewport size
and your images will be scaled down to fit, if necessary. In Fixed Height mode, your images
will never be zoomed larger.
3. Edit or re-process your images to a larger size. Remember, your images can be much larger
than your layout and IGM2 will always ensure that they fit. So pick a size where your images
will always be wider than the rendered width of your gallery.
Full-Screen Mode
If you opt to show the Full-Screen icon on your toolbar, your users will be able to easily switch
between the in-page gallery and a Full-Screen presentation that hides all page content except for
the gallery. Users can exit Full-Screen mode by clicking the icon or pressing the ESC (Escape) key
on their keyboard. When in Full-Screen mode galleries set to Cross-Fade, or any of the Slide
animations, will display in Fixed Height mode, with height determined by the height of the browser
window. Images will be horizontally and vertically centered within the viewport at their natural
aspect ratios, based upon the available window height. On the other hand, if you select Ken Burns
or Full-Fit Cross Fade animation modes, your images will be scaled to fit the entire window.
The Toolbar and Paginator icons are background images. We did include a Fireworks folder with an
editable document if you would like to customize the icons. We really do not recommend doing so,
but if you tackle the task make sure you do not change the dimensions of the images.
We are known for our customer support, so please do not hesitate to ask for assistance if you feel
you need help with a CSS edit.
Browse to the folder where your full-size images are and select any image. Then click OK.
All the images in that folder will appear in the Full Size Images column:
All the images in that folder will appear in the Thumbnail Images column:
In many cases, the internal logic used by the IGM2 Import utility will establish matching criteria
automatically. In the above example, the thumbnail image names are appended with a suffix of
_thumb and IGM2 was able to figure out the mapping. Note that the Full Size Image and Thumbnail
Image Previews match.
3. Selection/Action Buttons
You need to select one, several, or all of the images in the listing. You can CTRL Click to select (or
deselect) images individually or Shift Click to select a group of images. If you want to select all of
the images in the listing you can click the Select All button.
To assign (or re-assign) thumbnails individually to a full-size image, click the Assign Individual
Thumbnail Image button. A browse dialog will open to help you locate your image and select it.
To remove images from the listing, click the Remove Image(s) from Listing button. All images
selected at the time you click the button will be removed from the listing.
Browse to the folder containing your images. Click the Add button to add one image at a time or
the Add All button to add all images in the folder to the batch process.
Click Next.
In the Batch options column, select Scale and click the Add button to add it to the Include in batch
column.
In the Scale section, choose Scale to Fit Area. Enter a Max width and Max height value. We used
1200 pixels. You can set it to whatever you need to. This means the image will scale within its
natural aspect ratio with 1200 pixels the upper boundary for both width and height.
Check the Only scale documents currently larger than target size option to prevent Fireworks from
up-sizing any images that are already at least 1200 pixels wide or tall.
For Batch output, you can choose the Same location as original file, which will overwrite your
originals. You can also choose a Custom location, in which case you will be presented with a folder
dialog allowing you to browse to a folder within your defined site or create a new folder within your
defined site. When you create a Custom location, your original files are neither overwritten nor
moved.
Browse to the folder containing your final full-size images. Click the Add button to add one image
at a time or the Add All button to add all images in the folder to the batch process.
Click Next.
In the Batch options column, select Scale and click the Add button to add it to the Include in batch
column.
In the Scale section, choose Scale to Fit Area. Enter a Max width and Max height value. We used 120
pixels. You can set it to whatever you need to. This means the image will scale within its natural
aspect ratio with 120 pixels the upper boundary for both width and height.
In the Batch options column, select Rename and click the Add button to add it to the Include in
batch column.
Choose Custom location and when the folder dialog opens, create a new folder called thumbs
inside the folder where you saved your full-size images.
The full-size images folder (pvii-testing) now has a sub-folder called thumbs, which contain the
newly processed thumbnail images.
After batch processing images you are ready to use the IGM2 Import facility to quickly get your
gallery up and running.
With the IGM1 image selected, open the IGM2 interface. A special convert window will appear:
The IGM2 interface will then open and all your images from your old gallery will be there, along
with any captions or descriptions you may have had.
The IGM2 converted gallery will use the same images, from the same folders that your IGM1 gallery
used. You can now customize the new IGM2 gallery by setting any options you want to in the UI.
Anchor Method
The system will look for #igm plus an image reference after the anchor. The anchor
index.htm#igm1_4 will trigger image 4 in the first IGM2 Widget on the page. When used in a Web
address, the entire link would look like this:
http://www.projectseven.com/galleries/igm2/examples/demo-01.htm#igm1_4
http://www.projectseven.com/galleries/igm2/examples/demo-01.htm?igm=1_4
You can then give out the link so people can go directly to your specific image.
To access the command, open the page that contains your gallery and choose:
Commands > Studio VII > Image Gallery Magic 2 by PVII > Remove Image Gallery Magic 2
Select the gallery you want to remove by choosing its ID from the Image Gallery drop-down list.
Tip: If you are unsure about which gallery relates to which ID, click the Cancel button and switch to Code View. In Code
View, locate all DIV tags with IDs that begin with p7IGM, like this one: <div id="p7IGM_1" class="p7IGM01">
P7_IGMctrl('p7IGM_1','play')
1. The first argument is the ID of the Image Gallery Magic 2 root div.
2. The second argument is the control action you wish to apply.
The HTML markup for a typical text link with a control action applied would look like this:
The Interface
The Image Gallery Magic 2 -Control Actions interface allows you to select an action to apply.
Tip: If you are unsure about which widget relates to which ID, click the Cancel button and switch to Code
View. In Code View, locate all DIV tags with IDs that begin with p7IGM, like this one:
<div id="p7IGM_1" class="p7IGM01">
Action
Select the action you want to apply.
Image Number
This box is active only when the Open Image Number action is selected. Enter the number of the
image you wish to display.
Getting help
PVII quality does not end with your purchase - it continues with the best customer support in the
business.
PVII Communities
PVII maintains separate and distinct Web Forum and Newsgroup communities. We do this to ensure
you always have access via your preferred medium and device.
1. Mozilla Thunderbird
2. Windows Live Mail
3. Windows Mail/Outlook Express
4. Opera Mail
5. Entourage
Server: forums.projectseven.com
If you have another newsgroup-capable program that you are using, please see its documentation
to learn how to add a new newsgroup account.
Note: PVII newsgroups are private and have nothing to do with Usenet feeds that may be provided by your ISP. That is, you will not
find our newsgroups in a list of newsgroups distributed by your internet service provider. You must set up our news server as a
new account.
E-Mail:
support@projectseven.com
Phones:
330-650-3675
336-374-4611
Snail mail
Project Seven Development
339 Cristi Lane
Dobson, NC 27017