?lib g_lib

The library that contains the cellviews to generate thumbnails for.

?cell g_cell

The cell that contains the cellviews to generate thumbnails for.

?view g_view

The cellview to generate a thumbnail for.

?sizes g_sizes

The size of the thumbnails to be generated. The g_sizes argument can be an integer, an integer pair, or a list of integers or integer pairs. Single integers are interpreted as both the width and height. To generate a 64x64 thumbnail, specify a size of either 64 or 64 64 as both are considered the same. If no size is supplied, then either all existing thumbnail resolutions gets updated, or a new thumbnail is created at the default resolution (currently 128x128).

?output g_output

Enter a symbol indicating where output should display. For example, the default 'progressbar uses the embedded CIW progress bar.

?verbose g_verbose

Set to print the name of the file which was saved to the CIW.

Default value: nil

?exportArgs g_exportArgs

Set to allow arguments to be passed to the underlying hiExportImage function, consequently allowing further customization of the generated thumbnails.

exportArgs takes a list of pairs (an association table), which are passed to hiExportImage. For any argument that you want to pass to the export image, via thumbnails, simply add the keyword and the argument into the list. For example, to generate grayscale thumbnails with a white background:

hiGenerateThumbnails(?lib mylib ?cell mycell ?view myview ?exportArgs list(list('colorType 'monochrome) list('bgColor "white") list('fgColor "black"))

?filePath t_filePath

Set to allow the location of the generated thumbnail to be customized.

filePath provides for a wide range of control over where a thumbnail file is generated:

• For a simple string like "myDir", thumbnails gets generated hierarchically under that directory, for example: myDir/lib/cell/view/thumbnail_128x128.png.
• If the string contains a '/', the thumbnail code creates the directory if necessary.
• printf-style formatting strings can be used in the string. Currently supported are: %L (lib), %C (cell), %V (view), %W (width) and %H (height).
  
  These are all expanded at the time the thumbnail is generated.
• The above features therefore allow the filename to be highly customized, such as:

?filePath "%L/%C/%V/%Wx%H/thumbnail.png", eg. "overview/follower/layout/128x128/thumbnail.png"

?filePath "%L_%C_%V-%Wx%H.png", eg. "overview_follower_layout-128x128.png"

?filePath "myThumbs/lib_%L/cell_%C/view_%V", eg. "myThumbs/lib_overview/cell_follower/view_layout/thumbnail_128x128.png

thumbnails

Number of thumbnails successfully generated.

nil

Command failed.