vcs.maemo.org Git - mdictionary/blob - www/screenshots_list_guide

   1 Copyright (C) 2007 ComArch S.A
   2
   3         author          : Dariusz Wiechecki
   4         contact         : dariusz (dot) wiechecki (at) comarch (dot) com
   5         date            : 11/7/2007
   6         version         : 0.1
   7
   8                       WhiteStork Screenshots List
   9
  10 Abstract
  11         This document describe what screenshots are needed for each version of
  12 WhiteStork. Furthemore, there are presented tools that can be used to take
  13 screenshots on maemo platform in this document.
  14
  15 1. Introduction
  16
  17
  18 2. Tools
  19         There are few applications and tools that can be used for taking
  20 screenshots on maemo platform based system. Some are listed here.
  21
  22    2.1 osso-screenshot-tool
  23         It is the best method to make a screenshots, but only when You have got
  24 access to the devica through SSH. Executing command:
  25 osso-screenshot-tool file.png
  26 will result in taking immediately screenshots and putting it into file.png. So
  27 it is possible to give a file particular, specyfic name and place it in any
  28 directory You want. When there is no SSH access it will need XTerminal installed
  29 on the system and make it harder to specify a name. To download tool go to page:
  30 http://repository.maemo.org/pool/maemo/ossw/o/osso-screenshot-tool (11/7/2007)
  31 or google for phrase "osso-screenshot-tool".
  32
  33    2.2 HM Shot Tool
  34         On page http://inz.fi/blog/2007/06/21/screenshooting-made-easy-ish/ You
  35 will find out more about this tool. There is a big disadvantage of MH Shot Tool
  36 - it does not support (11/7/2007) delayed screenshot.
  37
  38    2.3 Maemo Screengrabber
  39         Go to http://tuomas.kulve.fi/blog/2007/01/17/maemo-screen-grabber/ or to
  40 http://maemo.org/downloads/product/OS2007/maemo-screengrabber/ for
  41 more information. It is wrapper for osso-screenshot-tool that allow you to
  42 take a screenshot by activating menu position in task navigator. It will wait
  43 for 5 seconds and take a screenshot, placing it in Image folder.
  44
  45    2.4 load-applet-run
  46         This tool can be downloaded from
  47 https://garage.maemo.org/projects/load-applet/. After instaling load-applet, You
  48 should place it in status bar. It allows for delayed screenshots, but there is
  49 no option to change defualt folder for images (Images).
  50
  51    2.5 Using VNC
  52         It is possible to install VNC Server on the device
  53 (http://mike.saunby.googlepages.com/x11vncfornokia7702). If server is running it
  54 is easy to connect to it from Your host computer and take a screenshots directly
  55 from Gnome/KDE/Ms Windows system.
  56
  57    2.6 Scratchbox
  58         If application is able to run on scratchbox, screenshots could be taken
  59 from it. This method is not recomended as far as sometimes applications looks
  60 different on scratchbox and on device. Furthemore scratchbox does not have all
  61 functionalities that is accessible on maemo platform, so not always there will
  62 be option to show all application's functions. At last, but not at least,
  63 screenshots taken on real device looks muche better than ones taken on
  64 scratchbox.
  65
  66 3. Screenshots List
  67         For each version of WhiteStork there could be different functionalities,
  68 so it is needed to distinguish them (versions) in screenshots list. Newer
  69 version has always all screenshots from the previous one (unless there is
  70 straightforward specified that some screenshots are not actual in new version)
  71 plus some new, presenting functions and GUI parts tha were not present in old
  72 version. Furthemore, from time to time it is helpfull to put complete list of
  73 screenshots for particular version, to prevent the user from browsing whole
  74 document and assemble full screenshots list from many versions - such a list
  75 is titled: "WhiteStork [COMPLETE LIST] (version x.y.z)"
  76
  77    3.1 WhiteStork [COMPLETE LIST] (version 1.1.0)
  78         3.1.1 [ Installing ]
  79            3.1.1.1
  80            3.1.1.2
  81            3.1.1.3
  82            3.1.1.4
  83            3.1.1.5
  84            3.1.1.6
  85            3.1.1.7
  86            3.1.1.8
  87            3.1.1.9
  88            3.1.1.10
  89            3.1.1.11
  90            3.1.1.12
  91            3.1.1.13
  92            3.1.1.14
  93            3.1.1.15
  94            3.1.1.16
  95            3.1.1.17
  96            3.1.1.18
  97            3.1.1.19
  98            3.1.1.20
  99         3.1.2 [ Platform Integration ]
 100         3.1.3 [ Main View ]
 101         3.1.4 [ Application Menu ]
 102         3.1.5 [ Context-Sensitive Menu (CSM) ]
 103         3.1.6 [ Dictionaries Managing ]
 104         3.1.7 [ About and License Dialog ]
 105
 106    3.2 WhiteStork (2.0.0 - not available yet!)
 107
 108 4. Final Word
 109
 110 5. Additional informations
 111
 112    5.1 Creating thumbnails from image set
 113         You will need to have a convert command in order to be able to use this
 114 method. It is available with package imagemagick (in Ubuntu distro:
 115  sudo apt-get install imagemagick).
 116         With convert You can execute below script in directory with all images
 117 You want to thumbnail:
 118
 119 for f in *.png
 120 do
 121   fn="thumbnails/${f%%.png}_thumb.png"
 122   echo "converting: $f -> $fn"
 123   convert -scale 120x50 ${f} ${fn}
 124 done
 125
 126         Of course You can change scale, files extension, target directory or
 127 name.
 128
 129    5.2 Creating web page gallery with screenshots
 130 for f in *.png
 131 do
 132   fn="thumbnails/${f%%.png}_thumb.png"
 133   echo "<a href=screen/OS2008/${f} target=_blank><img src=screen/OS2008/${fn} /></a>"
 134 done
 135
 136 5. Note
 137    5.1 Generating list of numbers:
 138         for n in `seq 1 20`; do echo -e "3.1.1.$n"; done;