From Forum Nokia Wiki

This article is archived because it is not considered relevant for third-party developers creating commercial solutions today. The article is believed to be still valid for the original topic scope.

Contents 1 Template widget model: PicViewer 1.1 Supported image feeds 1.2 Widget views 1.3 Scripted elements 1.4 Static styles 1.5 Services and parameters 2 See also

Template widget model: PicViewer

The picviewer script, the picviewer service, and the widget skin are used to create picviewing widgets from RSS containing image links. This section explains how the picviewer script works and how you can create custom skins.

A generic picviewer script uses a server-side service to synchronize feed items every time a client goes online. An online server notifies the client when a new item becomes available, and the script downloads the new item automatically. The script saves synchronized and loaded content on the phone so it can be accessed offline.

The picviewer script works in a very similar way to the syndication script, and both utilize the same backend services.

Supported image feeds

The picviewer script supports various formats of image feeds. When configuring your picviewer service, use the following pictureserviceparam types depending on your feed format:

• normal - Pictures presented as enclosures or as inline HTML <img> tags.
• enclosure - RSS 2.0 feed with images inside enclosures

• flickr - Used with Flickr.com image feeds (Yahoo MediaRSS RSS 2.0 extension).
• slide - Used with Slide.com image feeds.
• smugmug - Used with Smugmug.com image feeds.

Widget views

A picviewer widget consist of 4 views:

• Minimized view "viewIndex"
  Normally displaying the icon of the feed viewed by the widget.
• Minimized view "viewNew"
  Viewed when there are new images on the feed. The widsets framework will automatically place a green plus sign on the bottom right corner of the minimized view when the widget has new images.
• Grid view "viewList"
  Displays a list of the newest images. In this view you can mark all images as read (seen).

• Large image view "viewItem"
  Displays an individual image in full screen. If the original image is larger than the screen size, it is reduced to the screen size.

Scripted elements

• feedItemList
  Creates a 3x3 thumbnail grid.
• feedItem
  Creates a large image view with description text and author text, if available.
• feedTitle
  Creates a Label component containing the parameter title or widgetname as content. Used in minimized views. Deprecated, use <label>${widgetname}</label> to display feed names.
• feedNewCount
  Creates a Label component displaying the number of unseen (or old) images that this feed currently has. Used in minimized views.
• feedNewCountNumber
  Same feedNewCount, but this one displays only the number.

Static styles

The following styles are used by the picviewer widget:

• feedItem
  Item subject (seen) in the grid view.
• feedItemNew
  Item subject (unseen) in the grid view.
• pictureTitle
  Picture title text in the large image view.

Services and parameters

To create a picviewer widget, set up the following services in widget.xml:

<service type="picviewer" id="feed">
  <reference from="feedurlparam" to="feedurl"/>
  <reference from="pictureserviceparam" to="pictureservice"/>
</service>

You also need to set up the following parameters in widget.xml:

<parameters>
  <parameter type="string"
             name="widgetname"
             description="Name of widget"
             editable="false">
    My Picture Widget
  </parameter>
  <parameter type="string"
             name="feedurlparam"
             description="This feed URL"
             editable="true">
    http://api.flickr.com/services/feeds/photos_public.gne?tags=sunsets&format=rss_200
  </parameter>
  <parameter type="string"
             name="show.images"
             description="Show images"
             editable="true"/>
  <parameter type="string"
             name="pictureserviceparam"
             description="picture service provider"
             editable="false">
    flickr
  </parameter>
</parameters>

• pictureserviceparam – Value of this should be the type of your feed as described in Supported RSS.

See also

• Syndication widgets
• PicViewer widgets