qDSed V0.4 docs by QRT 071015
QRTs DS editor
(only reader abilities in this version)

home qland.de
mail qrt@qland.de

--------------------------------------------
preface
--------------------------------------------

installation on cards
- root   qDSed.nds
- font   sys.qds, txt.qds, prefs.qds
         your trueType fonts
- text   doc.txt
         your ascii texts

installation on emulators
-> see emulators

cards
- qDSed is tested on SuperCard SD and
  SuperCard One, please give me reports
  about other systems and cards
- FAT support for NDS in devkitPro seems not
  to work correct with all cards, so it might
  happen that qDSed cannot store its prefs or
  cached fonts correctly, especially older,
  cheaper or slower SD cards often show these
  problems, if you're experiencing strange
  behavior, crashes or garbage in your texts,
  especially when using big sized fonts, try
  an other card, also patching qDSed with the
  appropriate DLDI file might solve the
  problem

emulators
- works on 'DeSmuME 0.7.2' but only FAT
  reading is implemented in this emulator
  version, so prefs and cached fonts cannot
  be written, at second this emu has a problem
  with sub directories, so all fonts and files
  must be in the same place as qDSed.nds
- double taps for file or font selection are
  not recognized correctly in 'DeSmuME', you may
  not mouse-click twice at the same place,
  second click near the first click instead

- 'ideas 1019' with 'R4 revolution' DLDI
  works well too, only double taps are not
  detected, I don't know why yet

- all other emulators seem to lack FAT support,
  qDSed will not find his fonts and exits
  with a fatal error

fonts
- tested well with trueType fonts
- after successfully loading a font
  the status field shows something like
  OK name.tft (123) [8 9 10 11 12]
  () shows the number of glyphs in font
  [] holds the available bitmap strikes =
  monochrome versions of the font in certain sizes
- monochrome font rendering looks patchy with
  some bitmap strikes, example 'couriernew'
  strikes smaller than 9 pixel, despite of it
  'lucidacon' looks good on this sizes,
  reasons unknown

--------------------------------------------
usage
--------------------------------------------

!!! double taps on emulators !!!
  -> see emulators

flip screens
- left shoulder button

scrollbars
- tap in lower right corner of text or
  control screen for scrollbars
- drag slider to navigate text
- tap up- or downside the slider to move
  page wise

load text
- tap load button
- double tap file name to load
- double tap free space or headline or press
  left shoulder button to exit without loading

change font
- tap font button
- double tap font name to load
- double tap free space or headline or press
  left shoulder button to exit without loading
- set font parameters with controls
- tap render button & wait

exit
- stores settings on card
  (crashes emulators)

pen
- use pen to scroll vertical or horizontal
- tapping on control elements shows their
  function, some of them will change their
  step size

controls
- virtual screen width
  256...2000 pixel (step 100/500)
- W for word wrap
- L for line combine (experimental)
- font rendering
  MON = mono chrome
  AAN = normal anti aliased grey
  AA2 = tight anti aliased grey
- font height
  4...60 pixel (step 1/10)
- horizontal spacing
  -30%...+100% (step 1/10)
- vertical spacing
  -50%...+100% (step 1/10)
- step sizes are changed by tapping
  on corresponding fields

status field
- tapping the status field switches between
  four lines for long messages

low buffer warning
- partly rendered text pages may occur
  if this warning is shown
- to avoid it reduce screen width,
  switch off line combine or word wrap or
  increase font size

--------------------------------------------
filesize shares
--------------------------------------------

- FreeType   200 k
- rebootlib   30 k
- qDSEd code  40 k

--------------------------------------------
thanks
--------------------------------------------

- FreeType project at Sourceforge.net
- Rick Wong (Lick) for rebootlib 1.1
- Michael Chisholm for load.bin
- Simon for testing

--------------------------------------------
history
--------------------------------------------

V0.4
- viewer for ascii text or source code
- quick changing for three texts
- trueType font format support (ttf)
- quick start with cached system- & textfont
- max file- & fontfilename len 64 chars
- max path + filenamelen 256 chars
- max text filesize 2 GB
- fixed tab size 4 spaces
