Skip to content

Filter View

Jump to bottom Edit New page
k3b edited this page Aug 3, 2020 · 28 revisions

The Filter-View of the android app "A Photo Manager" is used to find a set of photos by search criteria. A virtual album file '*.album' can store the data of a filter.

You can reach the Filter-View via

Note: While Extended App Pinning is active potentially harmfull operations (i.e. this filter view) are not available

You can search by zero, one ore more criteria:

  • Find searchtext: any photo that contains searchtext in path, filename, title, description or tag will be shown.
    • You can enter sub-expressons seperated by a blank " " (new in verson 0.7.0, #113)
      • Example if you enter Find="crete friday" you may find a photo that has tag="crete" and description="We arrived friday evening" (which contains "friday). "crete" and "friday" are sub-expressions seperated by " ".
  • Path name: a combination of folders and photo file name
    • you can pick a folder with the "..." button.
    • you can enter a search pattern using the % as wildcard.
    • Example: searching for path "%kreta%" include these files
      • /mnt/extsd/media/photos/Urlaub/0709Kreta/Ausfluee/AgiosNicolaus/07Kr043.jpg
      • /mnt/extsd/media/photos/Maps/Kreta.jpg
  • Date when the photo was taken. The first field is from-date the second field is to-date
    • you can pick a date range through the Date picker with the "..." button.
    • you can enter a start-date and/or a end-date in the format yyyy-mm-dd .
    • Example:
      • searching for date "2007-01-01" and "" will show photos taken since 2007.
      • searching for date "" and "2008-01-01" will show photos taken before jan 1st 2008.
      • searching for date "2007-01-01" and "2008-01-01" will show photos taken in 2007.
  • [ ] public images and/or [ ] private Images
    • Public images are visible in any Gallery-app/Photo-Picker that use the android-system-media-database.
    • Private images are only visible in "A Photo Manager" if the in private images are enabled in the filter.
      • technically private images are filename.jpg files renamed to filename.jpg-p that get an additional TAG "PRIVATE".
    • In the edit photo properties (exif) you can make a public image private (and vice versa) by selecting Public or Private (new in version 0.6.3).
    • "Public" or "Private" can be stored in Virtual Album/Bookmark-filter-files and ".apm"-AutoProcessingRule-Files
    • See also #100
  • Tags
    • [ ] With no Tags: if checked Images with no Tags are shown
    • +Tags Images that contain all these Tags are shown (logical AND)
    • -Tags Images that contain one of these Tags are not shown (logical AND-NOT)
    • you can pick tags with the "..." button.
      • tags marked with correspond to +Tags
      • tags marked with correspond to -Tags
    • Example: if you mark the tags peter, *harbour", night with and the tag "winter" with then you will get all pictures of peter at a *harbour" at night that are not related to "winter".
  • Rating: 5=best .. 1=worst or 0/null unknown
    • Example: if you select 2 stars then only images with 2 or more stars are shown
  • GEO
    • With no GEO info: When checked
      • only photos without GEO-infos are visible
      • input fields for latitude/longitude are hidden.
    • GEO Area where the photo was taken as Lat(itude north) and Lon(gitude east). The first field is from the second field is to .
      • you can pick a GEO area through the Geographic-Map with the "..." button.
      • you can enter a start and/or a end valus in decimal degrees format.
      • negative values indicate latitude south or longitude "west".
  • Last Modified when the photo was last modified (i.e. exif data was changed)
  • Below Last-Modified you may see additional SQL-WHERE if you have loaded a virtual album file '*.album' that contain non standard SQL. (since 0.7.6)
  • or "Ok" button takes the current filter and updates the caller:
  • or "Cancel" button or the back button closes the picker without affecting Gallery-View.
  • or "Delete/Clear Filter" sets all filter fields to empty which means "no filter".

Note: When you tab the history button at the end of an edit field you get a popup where you can select one of the 10 previous values.

Menu commands

-

Technical Details:

A virtual album file '*.album' is technically a texfile that contains the database SQL representation of a filter (aka SQL-Where).

Each field in the Filter-View corresponds to a field of EXTRA de.k3b.extra.FILTER of the Intent API.

SQL-Where expressions that cannot be translated to Find, Path, Date, Tags, Rating, GEO or Last-Modified will be displayed below Last-Modified. (since 0.7.6)

If you wand to add non standard SQL to a virtual album you have to use a text editor.

If you clear the filter the non standard SQL-Where will also be cleared.

See also

---
available on upToDown store available on F-Droid app store
Downloads
DISCLAIMER Be cautious if you download "A Photo Manager" where the apk size is bigger than 1.5 Megabytes:

English:

Other languages:

Clone this wiki locally