touch-packages team mailing list archive

[Michi Henning <michi.henning@xxxxxxxxxxxxx>]

Thanks for that David! I spotted a few minor errors and omissions. Could
you look at these please?

In "How to use it":

image://thumbnailer/<file path>"

should be

image://thumbnailer/<file URI>


Also, on the same line, the comment "local videos and pictures" really should be "local videos, audio files, or pictures"

image://albumart/album=Blur:+The+Best+Of&artist=Blur"

It looks like the "+" signs should be "%20"? (This also appears in the
URI after this one.)


The "Cosmos Laundromat" and "Cry Me A River" URIs should have %20 instead of spaces.


It might be nice to add an example that same box that shows how to extract a thumbnail from an image file (just to make it clear that this can be done too).


It would be good to mention the media.getArtUri() method, which creates a thumbnailer URI. Otherwise, people are likely to cobble the URIs together by hand and get it wrong half the time...

I think the page needs some explanation of semantics. Specifically:

The thumbnailer always preserves aspect ratio.

Returned thumbnails may be smaller than what was asked for because the
thumbnailer never up-scales. If the original artwork is smaller than
what was asked for, the largest possible thumbnail will be returned.
Thumbnails are never larger than 1920 pixels in the larger dimension
(even if the original artwork is larger).

Requests with either dimension < 0 are invalid and return an error.

Requests for (0,0) mean "as large as possible" (subject to the 1920
pixel limit).

Requests for (x,0) or (0,y) mean the same as (x,x) and (y,y),
respectively.

-- 
You received this bug notification because you are a member of Ubuntu
Touch seeded packages, which is subscribed to thumbnailer in Ubuntu.
https://bugs.launchpad.net/bugs/1474035

Title:
  Missing docs in ubuntu website

Status in Ubuntu Developer Portal:
  New
Status in thumbnailer package in Ubuntu:
  Triaged

Bug description:
  There are no docs for the thumbnailer's QML plugin in
  https://developer.ubuntu.com/api/qml/current/

To manage notifications about this bug go to:
https://bugs.launchpad.net/developer-ubuntu-com/+bug/1474035/+subscriptions