Difference between revisions of "MythGallery"

From MythTV Official Wiki
Jump to: navigation, search
(Compiling)
(cleanup)
Line 1: Line 1:
{| cellpadding=5 cellspacing=5
+
This based on the README file for MythGallery.  It refers specifically to version [[Release_Notes_-_0.17|0.17]], but things haven't changed much between that and version [[Release_Notes_-_0.19|0.19]].
|width=300|__TOC__
+
 
|valign=top|This based on the README file for MythGallery.  It refers specifically to version 0.17, but things haven't changed much between that and version 0.19.
+
The '''MythGallery''' plug-in allows you to view all your photos as well as short movies from your digital camera. Myth Gallery will show your photos as they are organised in your file system.  Myth will generate thumbnails of both folders as well as individual photos.  Many new digital cameras can now take high quality movies typically in [[MPEG-4]] format as well as photos.  Mythgallery can show these as well, provided that you have the video player setting set up to play that media type.  Make sure that you do not have spaces in your directory names or picture names ie "2005 Winter Olympics" should be "2005_Winter_Olympics" or Mythgallery video player will not be able to find the file (this has been fixed in [[Release_Notes_-_0.19|0.19]])
|}
+
 
 
==Build/Configuration Instructions==
 
==Build/Configuration Instructions==
 +
If you have installed MythTV using a [[package manager]] then simply install the MythGallery package.  Otherwise follow these instructions to compile and install the plugin.
 
===Requirements===
 
===Requirements===
#First, you need MythTV to be installed.  At the very least, you need MythTV's database stuff setup properly.  If you don't have that done, don't even bother with this, as it won't work.
+
#At the very least, you need MythTV's database stuff setup properly.  If you don't have that done, don't even bother with this, as it won't work.
#libtiff development package (for loading [http://www.cartesianinc.com/Products/View/TIFF/ TIFF] images)
+
#The libtiff development package (for loading [http://www.cartesianinc.com/Products/View/TIFF/ TIFF] images)
  
 
===Compiling===
 
===Compiling===
Ok, on to compiling.
+
In the main distribution directory configure the package by typing  
#Configure the package by typing <tt>./configure</tt> in the main distribution directory. You can enable OpenGL support using <tt>./configure --enable-opengl</tt> (make sure you have OpenGL support for your graphics card available and enabled if you choose this option. You can check this under X11 using <tt>xdpyinfo</tt> or <tt>glxinfo</tt>. Also ensure that QT has been built with OpenGL support)<br>You can also enable EXIF support using <tt>./configure --enable-exif</tt><br>This requires you have the libexif headers/libraries installed and in your include/lib path when compiling.  An install of the libexif/libexif-devel packages from your favorite package repository usually provides this. Currently, EXIF support only consists of auto-rotating images if the camera sets the orientation tag (My Canon S400 does).
+
<pre>./configure</pre>  
#Next type <tt>qmake mythgallery.pro</tt> then <tt>make</tt> in the main distribution directory.<br>If you get an error on building this, that says something about <tt>mkspecs</tt>, then you don't have the QTDIR environment variable set.  On Debian, this should be set to <tt>/usr/share/qt3</tt>.  On Mandrake, it's <tt>/usr/lib/qt3</tt>.  On Fedora (Core 5 and 6 at least) its <tt>/usr/lib/qt-3.3</tt>.
+
 
You'll need to figure out what it should be on your system, set the variable, and attempt to compile again.If you get any errors about missing references, etc, you most likely don't have one of the required pieces of software installed.
+
You can enable OpenGL support using  
#Follow this by a <tt>make install</tt>. It'll put a <tt>libmythgallery.so</tt> plugin in your <tt>/usr/local/lib/mythtv/plugins</tt> directory.<br>MythGallery will also read the <tt>mysql.txt</tt> settings files used by MythTV, so any changes you made to those will be carried over into this.
+
<pre>./configure --enable-opengl</pre>  
 +
Make sure you have OpenGL support for your graphics card available and enabled if you choose this option. You can check this under X11 using <tt>xdpyinfo</tt> or <tt>glxinfo</tt>. Also ensure that QT has been built with OpenGL support)
 +
 
 +
You can also enable [[EXIF]] support using  
 +
<pre>./configure --enable-exif</pre>
 +
This requires you have the libexif headers/libraries installed and in your include/lib path when compiling.  An install of the libexif/libexif-devel packages from your favorite package repository usually provides this. Currently, [[EXIF]] support only consists of auto-rotating images if the camera sets the orientation tag (My Canon S400 does).
 +
 
 +
Next do
 +
<pre>
 +
$ qmake mythgallery.pro
 +
$ make
 +
</pre>
 +
in the main distribution directory. If you get an error on building this, that says something about <tt>mkspecs</tt>, then you don't have the QTDIR environment variable set.  On Debian, this should be set to <tt>/usr/share/qt3</tt>.  On Mandrake, it's <tt>/usr/lib/qt3</tt>.  On Fedora (Core 5 and 6 at least) its <tt>/usr/lib/qt-3.3</tt>.
 +
You'll need to figure out what it should be on your system, set the variable, and attempt to compile again. If you get any errors about missing references, etc, you most likely don't have one of the required pieces of software installed.
 +
 
 +
Follow this by a  
 +
<pre># make install</pre>   
 +
which puts the <tt>libmythgallery.so</tt> plugin in the <tt>/usr/local/lib/mythtv/plugins</tt> directory.
 +
 
 +
MythGallery will also read the <tt>mysql.txt</tt> settings files used by MythTV, so any changes you made to those will be carried over into this.
  
 
===Configuration===
 
===Configuration===
Line 19: Line 39:
  
 
==Usage==
 
==Usage==
This should be really simple to use -- just browse around with the arrow keys and select images/directories to view with the space/enter keys. Escape backs out a level, and hitting 'p' while viewing a single image or while an image icon is highlighted will start a slideshow playback of all images in that directory.  Image rotation can be done by pressing the [ and ] keys. To toggle activating the menu on the left in the thumbnail view use the 'm' key.
+
Its a good idea to organise the top level screen as a collection of folders only. You can have subfolders within folders also.
 +
 
 +
This should be really simple to use -- You select the folder you want by using the [[Image:RemoteUp.png]] [[Image:RemoteDown.png]] [[Image:RemoteRight.png]] [[Image:RemoteLeft.png]].
 +
 
 +
Press [[Image:RemoteSelect.png]] to view photos within the desired directory.You will then see the individual photos themselves.
 +
 
 +
Press [[Image:RemoteSelect.png]] to view just that photo.
 +
 
 +
Press [[Image:RemoteInfo.png]] to get information on that photo.
 +
 
 +
While viewing photos you can use the [[Image:RemoteUp.png]] [[Image:RemoteDown.png]] buttons to jump forwards and backwards between photos.
 +
 
 +
Press [[Image:RemoteExit.png]] to exit photo viewing.
 +
 
 +
Pitting 'p' while viewing a single image or while an image icon is highlighted will start a slide show playback of all images in that directory.  Image rotation can be done by pressing the [ and ] keys.
 +
 
 +
Press [[Image:RemoteMenu.png]] to highlight the On Screen Menu.
 +
 
 +
The [[Image:RemoteUp.png]] [[Image:RemoteDown.png]] buttons will move up and down the On Screen Menu.
 +
 
 +
The Settings Option brings up the Myth Gallery Settings screen where you can change the slide show transition parameters.  Check the use OpenGL transitions and you can now choose some of the funky transitions available.
  
 
===Default Keys===
 
===Default Keys===
 
 
====Thumbnail View Keys====
 
====Thumbnail View Keys====
 
{|border=1 cellspacing=1 cellpadding=5
 
{|border=1 cellspacing=1 cellpadding=5
Line 104: Line 143:
 
When <tt>import</tt> is pressed in the menu each item in the import directory search path will be examined.  If the item is a directory, its contents will be recursively copied to a new directory whose name is the current date and time.  Using this method, removable devices can be put in the search path if they use an automount system (see the Linux documentation for info on how to use automount systems).  If the item is an executable file, it will be executed with 1 argument consisting of the name of the new subdirectory.  This way, import from a removable device can be accomplished without the use of an automount system.
 
When <tt>import</tt> is pressed in the menu each item in the import directory search path will be examined.  If the item is a directory, its contents will be recursively copied to a new directory whose name is the current date and time.  Using this method, removable devices can be put in the search path if they use an automount system (see the Linux documentation for info on how to use automount systems).  If the item is an executable file, it will be executed with 1 argument consisting of the name of the new subdirectory.  This way, import from a removable device can be accomplished without the use of an automount system.
  
==Further Information==
+
==Screenshots==
Feel free to subscribe to the [[Mailing List]] to ask questions.  Make sure you follow the guidelines in [[Mailing List etiquette]]!
 
 
 
==Gallery==
 
 
 
 
<gallery>
 
<gallery>
Image:GalleryMain.jpg
+
Image:GalleryMain.jpg|Top Level
Image:GalleryPics.jpg
+
Image:GalleryPics.jpg|Gallery Directory
 +
Image:GalleryTransition.jpg|OpenGl Transition
 +
Image:GalleryInfo.jpg|Picture Info
 
</gallery>
 
</gallery>
  
 
[[Category:Plugins]]
 
[[Category:Plugins]]
 
{{stub}}
 
{{stub}}

Revision as of 21:31, 10 March 2007

This based on the README file for MythGallery. It refers specifically to version 0.17, but things haven't changed much between that and version 0.19.

The MythGallery plug-in allows you to view all your photos as well as short movies from your digital camera. Myth Gallery will show your photos as they are organised in your file system. Myth will generate thumbnails of both folders as well as individual photos. Many new digital cameras can now take high quality movies typically in MPEG-4 format as well as photos. Mythgallery can show these as well, provided that you have the video player setting set up to play that media type. Make sure that you do not have spaces in your directory names or picture names ie "2005 Winter Olympics" should be "2005_Winter_Olympics" or Mythgallery video player will not be able to find the file (this has been fixed in 0.19)

Build/Configuration Instructions

If you have installed MythTV using a package manager then simply install the MythGallery package. Otherwise follow these instructions to compile and install the plugin.

Requirements

  1. At the very least, you need MythTV's database stuff setup properly. If you don't have that done, don't even bother with this, as it won't work.
  2. The libtiff development package (for loading TIFF images)

Compiling

In the main distribution directory configure the package by typing

./configure

You can enable OpenGL support using

./configure --enable-opengl

Make sure you have OpenGL support for your graphics card available and enabled if you choose this option. You can check this under X11 using xdpyinfo or glxinfo. Also ensure that QT has been built with OpenGL support)

You can also enable EXIF support using

./configure --enable-exif

This requires you have the libexif headers/libraries installed and in your include/lib path when compiling. An install of the libexif/libexif-devel packages from your favorite package repository usually provides this. Currently, EXIF support only consists of auto-rotating images if the camera sets the orientation tag (My Canon S400 does).

Next do

$ qmake mythgallery.pro
$ make

in the main distribution directory. If you get an error on building this, that says something about mkspecs, then you don't have the QTDIR environment variable set. On Debian, this should be set to /usr/share/qt3. On Mandrake, it's /usr/lib/qt3. On Fedora (Core 5 and 6 at least) its /usr/lib/qt-3.3. You'll need to figure out what it should be on your system, set the variable, and attempt to compile again. If you get any errors about missing references, etc, you most likely don't have one of the required pieces of software installed.

Follow this by a

# make install

which puts the libmythgallery.so plugin in the /usr/local/lib/mythtv/plugins directory.

MythGallery will also read the mysql.txt settings files used by MythTV, so any changes you made to those will be carried over into this.

Configuration

After compiling and installing, you will need to enter the setup menu from mythfrontend to configure mythgallery. Change the directory parameter to where you're storing your pictures.

Usage

Its a good idea to organise the top level screen as a collection of folders only. You can have subfolders within folders also.

This should be really simple to use -- You select the folder you want by using the RemoteUp.png RemoteDown.png RemoteRight.png RemoteLeft.png.

Press RemoteSelect.png to view photos within the desired directory.You will then see the individual photos themselves.

Press RemoteSelect.png to view just that photo.

Press RemoteInfo.png to get information on that photo.

While viewing photos you can use the RemoteUp.png RemoteDown.png buttons to jump forwards and backwards between photos.

Press RemoteExit.png to exit photo viewing.

Pitting 'p' while viewing a single image or while an image icon is highlighted will start a slide show playback of all images in that directory. Image rotation can be done by pressing the [ and ] keys.

Press RemoteMenu.png to highlight the On Screen Menu.

The RemoteUp.png RemoteDown.png buttons will move up and down the On Screen Menu.

The Settings Option brings up the Myth Gallery Settings screen where you can change the slide show transition parameters. Check the use OpenGL transitions and you can now choose some of the funky transitions available.

Default Keys

Thumbnail View Keys

Key Function
M Toggle the menu
P Start SlideShow
D Delete image
Home Go to the first image in thumbnail view
End Go to the last image in thumbnail view
Enter/SpaceBar Open a Directory/View an image
Left,Right,Up,Down Navigate through images/directories

Image View Keys

Key Function
P Start/Stop SlideShow
D Delete image
],3 Rotate image right 90 degrees
[,1 Rotate image left 90 degrees
7 Zoom out of image
9 Zoom into image
2 Scroll image up
4 Scroll image left
6 Scroll image right
8 Scroll image down
5 Recenter image
0 Full-size (un-zoom) image
PageUp Go to the upper-left corner of the image
PageDn Go to the lower-right corner of the image
I Toggle Showing Information about Image

Importing Pictures

When import is pressed in the menu each item in the import directory search path will be examined. If the item is a directory, its contents will be recursively copied to a new directory whose name is the current date and time. Using this method, removable devices can be put in the search path if they use an automount system (see the Linux documentation for info on how to use automount systems). If the item is an executable file, it will be executed with 1 argument consisting of the name of the new subdirectory. This way, import from a removable device can be accomplished without the use of an automount system.

Screenshots