From BlenderWiki

Jump to: navigation, search

Elubie

Preview and Image Browser Documentation

Release Notes

Overview:

The old image browser has been renewed to work mostly like the filebrowser now. The goal was to provide better stability and performance and to enable image and filebrowser to be merged in the future. The imagebrowser not only allows to browse for images in your filesystem, but can also show previews of materials, textures, world, lamp and image datablocks. Like the filebrowser, the new image browser is called in mainly three different modes: file browsing, append/link and databrowse. When browsing for external files thumbnails for movies are also loaded, provided the movie type (codec) can be handled. Currently the frame half-way through the movie is displayed.

The new image browser with the bookmarks area.

Invoking the Image browser:

File browsing with the image browser is invoked by CTRL+click on the load button for images. This has been activated for:

  • 'Load Image' in the texture buttons
  • in the scene buttons for loading the backbuffer image
  • when loading *images in the compositor
  • when loading background image.

Loading an image in UV/Image editor works with CTRL-click on the 'Open' menu item. Loading images with image browser in sequencer doesn't work yet.

Appending/Linking with the image browser works from the main file menu. It can also be invoked with the hotkey CtrlF1.

Linking a material with the image browser

Data Browse is activated with CtrlF4 for the current .blend file. Once the image browser is open, you can then navigate to the materials, textures etc. to see the previews. In the case that there are too many materials or textures in the .blend file, databrowse will also be invoked from the materials or texture popup menu. In this case you can invoke the image browser with Control+click on the 'Databrowse' menu item.

Creation of Preview Images

The preview images of material, texture, image, world and lamp datablocks are created on demand, when they are displayed in the image/preview browser. They will be stored within the .blend file as small (currently 96x96) bitmaps. Since this increases the size of your .blend file, it has been made a user setting, which can be found in the Info window under 'Auto Save'. To avoid resetting this option when reloading a .blend file, save this into your user preferences .B.blend file with CTRL+UKEY, since this setting is not saved with the .blend file.

Thumbnail Caching

The thumbnails of external images follow the same rules as 'The Gimp', gtk, Gnome/Nautilus and KDE. The specification can be found here: http://jens.triq.net/thumbnail-spec/

This means that they are shared among those applications and don't create any extra overhead on Linux. On Windows they are shared with The Gimp.

On Linux they are stored inside the '.thumbnails' folder in your home directory, on Windows they are stored in the 'C:\Documents and Settings\.thumbnails' folder.


Working with the Image Browser

As mentioned before the image browser now works mostly like the file browser, although not all functionality has been ported yet.

Working Hotkeys/ Mouse actions (like in file browser)

  • Pageup/Pagedown - scroll one row up/down
  • ↖ Home - move to start of directory list
  • ⇥ End - move to end of directory list
  • Esc- cancel image browser
  • . - reload directory
  • A - select all files/datablocks
  • P - step up to parent path
  • MMB Template-MMB.png - make file active and do action
  • LMB Template-LMB.png - step down into folder/ select file or datablock
  • RMB Template-RMB.png - activate file or datablock
  • Wheel Template-MW.png - Scrolling

New Hotkeys:

  • B - loads image and shows large preview in popup panel.
  • X - (in bookmark area) delete bookmark.

Bookmark management

Toggle the bookmark area on of with the favourites button Rl imgbrowser14.jpg in the header. To add the current directory as a bookmark, press the Rl imgbrowser15.jpg bookmark button next to the bookmark folder popup button. To remove a directory from the bookmarks, press the X key with the mouse over the bookmark in the bookmark area.

File Filters

The imagebrowser header contains buttons for filtering the different file types. The the filter button Rl imgbrowser05.jpg switches on filtering and then you can select which files you want to see. Press the toggle buttons for any file type you want to see. Multiple selections are possible.

Filtering .blend and .py files
Filtering image files

The file types that can be chosen are:

  • Rl imgbrowser06.jpg Image Files
  • Rl imgbrowser07.jpg Blender Files
  • Rl imgbrowser08.jpg Movie Files
  • Rl imgbrowser09.jpg Python Files
  • Rl imgbrowser10.jpg Font Files
  • Rl imgbrowser11.jpg Sound Files
  • Rl imgbrowser12.jpg Text Files
  • Rl imgbrowser13.jpg Show/Hide Folders

Future Work:

  • Add previews for further datablocks (meshes, curves,...).
  • Merge image browser and file browser
  • Allow choosing of material/texture from image/preview browser
  • zoom in/out for larger/smaller previews

Credits

Samir Bharadwaj for the icon images. Falgor for the bookmark icon