Omni Systems, Inc.   Mif2Go User's Guide, Version 55


18.7.3.2.3 Providing scaled thumbnails

When you use scaled thumbnails, the name of each thumbnail is the same as the name of the full-size graphic. To provide thumbnails scaled by the browser at run time from your original graphics, specify the following option:

[Graphics]

ExtrGraphThumbnail=Scaled

When ExtrGraphThumbnail=Scaled, Mif2Go uses the original image, applying scaling factors that you can specify:

[Graphics]

; ExtrGraphHigh = size in pixels for height of thumbnail

;  display of graphic when ExtrGraphThumbnail=Scaled

;  default 96 pixels (one inch)

ExtrGraphHigh=96

; ExtrGraphWide = size in pixels for width of thumbnail

;  display of graphic when ExtrGraphThumbnail=Scaled

;  default 96 pixels (one inch)

ExtrGraphWide=96

; ExtrGraphClass = name of CSS class to use in predefined

;  <$_extrthumb> macro

;ExtrGraphClass=thumbnail

; ExtrGraphTarget = target attribute for window used by <$_extrthumb>

ExtrGraphTarget=_blank

For the thumbnail, ExtrGraph* settings override any [Graph*] settings for width and height values. The ExtrGraph* settings do not conflict with (for example) a user-defined <$ExtrGraphHigh> macro, nor with predefined macro variable <$$_extrgraphhigh> or <$$_extrgraphwide>; all are in different Mif2Go internal namespaces.

Preserve aspect ratio

If you want to use a reduced size for thumbnails, but not all images have the same aspect ratio, set only one of ExtrGraphHigh or ExtrGraphWide to the number of pixels you want, and set the other to 0 (zero).

Preserve image size

If you want the thumbnail to be the size of the original image as it appears in FrameMaker, instead of specifying width and height values, set the following option:

[Graphics]

; OrigSizedThumbnail = No (default)

;  or Yes (use original Frame size for it)

OrigSizedThumbnail=Yes

When OrigSizedThumbnail=Yes, the size specified for the image in FrameMaker is used for the thumbnail instead of any size values specified with ExtrGraphHigh or ExtrGraphWide. This can be a reasonable way to present screenshots when you do not want the thumbnail to be any smaller, but you want users to have a way to make the screenshot legible. For a simpler way to accomplish the same objective, without using extracts, see §23.5.2 Replacing or surrounding a graphic with macro code.

Predefined macro <$_extrthumb>

For convenience you can use built-in macro <$_extrthumb>, which is defined as follows:

<p class="<$$_extrgraphclass>"><a href="<$$_extrfile>">

 target="<$$_extrgraphtarget>"><img src="<$$_extrgraph>" \

<$_if ($$_extrgraphhigh > 0)> height="<$$_extrgraphhigh>"<$_endif>\

<$_if ($$_extrgraphwide > 0)> width="<$$_extrgraphwide>"<$_endif>\

 alt="<$$_extrtitle>" /></a></p>

Using this macro, the settings you need for scaled thumbnails can be reduced to the following:

[Graphics]

ExtrGraphThumbnail=Scaled

[ExtrReplace]

*=<$_extrthumb>