Difference between revisions of "Stacks"

From JRiverWiki
Jump to: navigation, search
 
(13 intermediate revisions by 4 users not shown)
Line 1: Line 1:
== Stacks ==
+
Stacks are simply groupings of files that can be displayed and manipulated like single files.  For audio files, the grouping might be a lossless file and a lossy version of it.  For images it might be 20 pictures of a cat.
  
Stacks are simply groupings of files that are used as a single fileIn the case of the HH engine the grouping might be a lossless    file and a lossy version of it.  For images it might be 20 pictures of a cat.
+
Each stack has one file that is the top. This is the file that is displayed in the Content Pane and used to represent and manipulate the underlying stack members.
 +
 
 +
== Stack Operations ==
 +
   
 +
Stack operations are available in the right click menu when selecting files in the Content Pane.
 +
 
 +
Stack and Unstack creates and destroys stacks, respectively. The underlying files are not physically affected, just their grouping inside of MC. When creating a stack, the top of stack starts out somewhat randomThe application picks the largest file as the top for non images.  For images it picks the largest dimension file of type jpeg.
 
          
 
          
== Tags ==
+
Expand Stack and Collapse Stack control how the files are displayed.  A collapsed stack only shows the top file, the others are not visible.  An expanded stack shows all files.  When expanded, Set as Top can be used to choose which file to use as the top of stack.
 +
 
 +
Autostack provides various options for automatically grouping a selection of files. When autostacking, the application will ask which file should be set as the top.
 
          
 
          
When a stack top is tagged most of those tags (the ones that made sense to me) are then copied to the stack members.  If a stack top is moved the stack members are moved.  (Provided the stacked files have any commonality.)
+
Search for stack files simply searches on all items in a given stack (or stacks), expands those stacks and runs the search.
 
          
 
          
* Tops
+
== Manipulating Stacks ==
 
          
 
          
Stack tops start out somewhat randomThe application picks the largest file as the top for non images. For images it picks the largest dimension file of type jpeg.
+
When the top of a collapsed stack is tagged, most of those tags are copied to the stack members.   
 +
 
 +
When the top of a collapsed stack is moved, the stack members are moved provided the stacked files have any commonality [ambiguous].
 +
             
 +
When the top of a collapsed stack is deleted, all stack members are deleted. If the stack top of an expanded stack is deleted, the top will be removed and a new top will be selected.
 +
 
 +
To manipulate individual stack members, first expand the stack, or use the ~d=a modifier to show all files in the database. This will show stack members even in collapsed stacks.
 +
   
 +
== Stack Icons ==
 +
 
 +
A stack can be identified by an icon that is available as a column in a Details view or as an overlay in the upper right corner of a Thumbnail view.  
 +
     
 +
If the icon looks like a stack of cards with a black star on top, it is a collapsed stack.
 
          
 
          
* Delete
+
If the icon looks like a single card with a black star, it is the top of an expanded stack.
 
          
 
          
Delete a collapsed stack and all the files are deleted.  Delete a stack top of an expanded stack and the top will be removed and a new top will be picked.
+
If the icon looks like a single card with a grey outline of a star, it is a stack member of an expanded stack.
 
          
 
          
* Right click menu.
+
Stack information is also available in the tooltips.
       
+
 
The right click menu allows one to stack and unstack files. This creates the grouping.
+
== Searching for Stacks ==
       
+
 
Expand Stack and Collapse Stack control how the files are viewed. A collapsed stack only shows the top file. The others are not visible. An expanded stack has all files available.
+
MC use hidden tags to identify and manage stacks. Some good information on these details can be found in the following post:
       
+
 
Search for stack files simply searches on all items in a given stack (or stacks), expands those stacks and runs the search.
+
http://yabb.jriver.com/interact/index.php?topic=55782.0
       
+
 
* Auto Stacking
+
The following expression can be used to find all stacked files in the database:
 +
 
 +
isequal([Stack Top],-1) ~d=a
  
Auto stacking by name is the only currently available option.  It simply looks for matches on the "name" field and bundles the files together.
+
== Stacks in Images ==
       
 
Additional auto stacking options to be added.
 
       
 
* Stacks in Images
 
  
 
In the world of photos the stacks are pretty much user driven.  (Although I would like to swap the existing RAW file cache out for one based on stacks.)
 
In the world of photos the stacks are pretty much user driven.  (Although I would like to swap the existing RAW file cache out for one based on stacks.)
Line 37: Line 55:
 
Another example would be a single image with several purposed files underneath it.  For instance one could be a representative jpeg with the RAW source file, a file sized for the web and another sized and sharpened for print.  In general use one would only want to see the jpeg but if a sale was made the image sized and sharpened for print could be found quickly via a right click->Stacks->Search for stack files.
 
Another example would be a single image with several purposed files underneath it.  For instance one could be a representative jpeg with the RAW source file, a file sized for the web and another sized and sharpened for print.  In general use one would only want to see the jpeg but if a sale was made the image sized and sharpened for print could be found quickly via a right click->Stacks->Search for stack files.
  
* Stacks as Cache
+
== Stacks as Cache ==
  
Currently only available for the handheld conversions.  When enabled in handheld options MC does several things.
+
Currently only available for the handheld conversions.  When enabled under MC's Handheld options (select '''Cache converted file (via a stack)''' under '''Options->Handheld->Conversion->Conversion Cache'''), MC does several things.
  
If MC needs to convert a file we look through the files stack for a file of the requested type.  (MP3, WMA, etc.)
+
If MC needs to convert a file, the files stack is searched for a file of the requested type.  (MP3, WMA, etc.)
  
If the file is found under the stack location we use that first.  Otherwise we use any available stack file of the appropriate type.
+
If the file is found under the stack location, it is used.  Otherwise MC uses any available stack file of the appropriate type.
  
If no stack file is available we look to see if the file already exists where the conversion engine would put it.
+
If no stack file is available, MC searches for the file where the conversion engine would put it.  If found there, it is used and stacked with the original file (unless, of course, it already is in a stack).
  
If we find one we use it and stack it with the orignal file. (Unless, of course, it already is in a stack.)
+
If not found there, MC will convert the file, copy it to the stack location directory, and stack it with the original file.
  
If we do not then we convert the file, copy it to the stack location directory and stack it with the original file.
+
== Cache features planned ==
       
 
* Cache features to be added (no guarantees) ...
 
 
          
 
          
 
Size warning.  Stacking revisions can use a lot of storage.  Best to warn on selection.
 
Size warning.  Stacking revisions can use a lot of storage.  Best to warn on selection.
Line 60: Line 76:
 
          
 
          
 
The stacks need to be utilized by other pieces of the app.  Library server, etc.
 
The stacks need to be utilized by other pieces of the app.  Library server, etc.
               
 
* Stacks in the view
 
  
Right now the only visual indicator that a file is part of a stack is an overlay that appears in the upper right of the thumbnail in Thumbnails view.
+
== More ==
       
+
* [http://yabb.jriver.com/interact/index.php?topic=55782.0 More details on stacks]
* The images ...
+
 
       
+
[[Category:Frequently Asked Questions]]
If the image looks like a stack of cards with a black star on top it is a collapsed stack.
+
[[Category:Features]]
       
+
[[Category:Libraries]]
If the image looks like a single card with a black star it is the top of an expanded stack.
 
       
 
If the image looks like a single card with a grey outline of a star it is a stack member of an expanded stack.
 
       
 
Some minor stack information is included in the tooltips.
 
       
 
* Features to be added ...
 
       
 
Enable/disable the stack indicator overlay. Sometimes you just don't care if it is a stack.
 
               
 
Better overlays.
 
               
 
Support for details view.  (Probably make an available column.)
 
[[Category: Frequently Asked Questions]]
 

Latest revision as of 08:55, 24 February 2015

Stacks are simply groupings of files that can be displayed and manipulated like single files. For audio files, the grouping might be a lossless file and a lossy version of it. For images it might be 20 pictures of a cat.

Each stack has one file that is the top. This is the file that is displayed in the Content Pane and used to represent and manipulate the underlying stack members.

Stack Operations

Stack operations are available in the right click menu when selecting files in the Content Pane.

Stack and Unstack creates and destroys stacks, respectively. The underlying files are not physically affected, just their grouping inside of MC. When creating a stack, the top of stack starts out somewhat random. The application picks the largest file as the top for non images. For images it picks the largest dimension file of type jpeg.

Expand Stack and Collapse Stack control how the files are displayed. A collapsed stack only shows the top file, the others are not visible. An expanded stack shows all files. When expanded, Set as Top can be used to choose which file to use as the top of stack.

Autostack provides various options for automatically grouping a selection of files. When autostacking, the application will ask which file should be set as the top.

Search for stack files simply searches on all items in a given stack (or stacks), expands those stacks and runs the search.

Manipulating Stacks

When the top of a collapsed stack is tagged, most of those tags are copied to the stack members.

When the top of a collapsed stack is moved, the stack members are moved provided the stacked files have any commonality [ambiguous].

When the top of a collapsed stack is deleted, all stack members are deleted. If the stack top of an expanded stack is deleted, the top will be removed and a new top will be selected.

To manipulate individual stack members, first expand the stack, or use the ~d=a modifier to show all files in the database. This will show stack members even in collapsed stacks.

Stack Icons

A stack can be identified by an icon that is available as a column in a Details view or as an overlay in the upper right corner of a Thumbnail view.

If the icon looks like a stack of cards with a black star on top, it is a collapsed stack.

If the icon looks like a single card with a black star, it is the top of an expanded stack.

If the icon looks like a single card with a grey outline of a star, it is a stack member of an expanded stack.

Stack information is also available in the tooltips.

Searching for Stacks

MC use hidden tags to identify and manage stacks. Some good information on these details can be found in the following post:

http://yabb.jriver.com/interact/index.php?topic=55782.0

The following expression can be used to find all stacked files in the database:

isequal([Stack Top],-1) ~d=a

Stacks in Images

In the world of photos the stacks are pretty much user driven. (Although I would like to swap the existing RAW file cache out for one based on stacks.)

Stacks are intended to be used to hide versions of files that one would normally not be interested in seeing. So one might put a jpeg as the top of a stack and have the RAW image file that it came from as a hidden stack member.

Another example would be a single image with several purposed files underneath it. For instance one could be a representative jpeg with the RAW source file, a file sized for the web and another sized and sharpened for print. In general use one would only want to see the jpeg but if a sale was made the image sized and sharpened for print could be found quickly via a right click->Stacks->Search for stack files.

Stacks as Cache

Currently only available for the handheld conversions. When enabled under MC's Handheld options (select Cache converted file (via a stack) under Options->Handheld->Conversion->Conversion Cache), MC does several things.

If MC needs to convert a file, the files stack is searched for a file of the requested type. (MP3, WMA, etc.)

If the file is found under the stack location, it is used. Otherwise MC uses any available stack file of the appropriate type.

If no stack file is available, MC searches for the file where the conversion engine would put it. If found there, it is used and stacked with the original file (unless, of course, it already is in a stack).

If not found there, MC will convert the file, copy it to the stack location directory, and stack it with the original file.

Cache features planned

Size warning. Stacking revisions can use a lot of storage. Best to warn on selection.

Cache creation. The old system allowed one to pre build the conversion cache. This functionality will be added.

Cache deletion. We should also be able to delete entries created by the HH conversion engine. These files are tagged in the [stack tag] field.

The stacks need to be utilized by other pieces of the app. Library server, etc.

More