git.sur5r.net Git - glabels/blob - web/faq/index.php

   1 <?php include "../common_php.inc"; ?>
   2
   3 <?php gLabelsHeader("FAQ"); ?>
   4
   5 <h1 class="doc">Frequently Asked Questions (FAQ) ...</h1>
   6
   7
   8
   9
  10 <h2>Index</h2>
  11 <div class="faqtoc">
  12 <ul class="faqtoc">
  13
  14   <li class="faqtocline">1. <?a("#S1", "Common Problems.");?></li>
  15
  16   <ul class="faqtoc">
  17
  18     <li class="faqtocline">1.1 <?a("#Q1.1","I cannot edit text.  What's wrong? (2.0.x)");?></li>
  19     <li class="faqtocline">1.2 <?a("#Q1.2","Why don't transparent images print correctly?");?></li>
  20     <li class="faqtocline">1.3 <?a("#Q1.3","How can I instruct glabels to not print blank address lines when doing a document merge?");?></li>
  21
  22   </ul>
  23
  24 </ul>
  25 </div>
  26
  27 <a name="S1"/>
  28 <h2>1. Common Problems.</h2>
  29
  30 <a name="Q1.1"/>
  31 <h3>1.1 I cannot edit text.  What's wrong? (2.0.x)</h3>
  32 <div class="faqanswer">
  33 <p>
  34 This is most likely due to an
  35 <?a("http://bugzilla.gnome.org/show_bug.cgi?id=170031","outstanding bug");?> in
  36 libbonoboui that was introduced in GNOME 2.8.  The symptom is that as soon
  37 as you select a text object, its object property editor apears briefly then
  38 disappears.
  39 </p>
  40 <p>
  41 The workaround for this bug is to resize the glabels window so that it is large
  42 enough to display the text property editor in the sidebar.
  43 Note: it is impossible for glabels to automatically do this since the size
  44 needed will vary with different themes, font sizes, and locales.
  45 </p>
  46 <p>
  47 This problem is fixed in the development branch of glabels (2.1.x) by using
  48 the GtkUIManager instead of libbonoboui to build the user interface.  These
  49 changes are very extensive and require later versions of GNOME, thus are not
  50 suitable for backport into the 2.0.x branch..
  51 </p>
  52 </div>
  53
  54
  55 <a name="Q1.2"/>
  56 <h3>1.2 Why don't transparent images print correctly? (1.92.1 - 2.1.3)</h3>
  57 <div class="faqanswer">
  58 <p>
  59 There is currently a limitation in the postscript back-end of libgnomeprint
  60 that causes images with an alpha channel to be composited in an intermediate
  61 context at 72 DPI.  Unfortunately an image only needs to have an alpha channel
  62 to trigger this behaviour even if the image is completely opaque, therefore
  63 in earlier versions of gLabels (before 1.92.1) all GIF and PNG images would be
  64 printed at 72 DPI.  To work around this problem image compositing was
  65 sacrificed for full resolution rendering beginning with gLabels 1.92.1.
  66 </p>
  67 <p>
  68 If you are compiling gLabels from source and are willing to sacrifice image
  69 quality for image transparency, you can disable the workaround by
  70 compiling glabels with the NO_ALPHA_HACK option:
  71 </p>
  72 <div class="codebox">$ ./configure CPPFLAGS=-DNO_ALPHA_HACK
  73 $ make
  74 ...
  75 </div>
  76 </div>
  77
  78
  79 <a name="Q1.3"/>
  80 <h3>1.3 How can I instruct glabels to not print blank address lines when doing a document merge?</h3>
  81 <div class="faqanswer">
  82 <p>
  83 This feature can be best described by a simple example.  In the following CSV
  84 file, column 5 contains the second address line for each record.  This field is
  85 empty in records 1 and 2, but not in record 3.  (For this feature to work,
  86 the field must be completely empty -- any text, including spaces will
  87 defeat this feature.)
  88 </p>
  89 <div class="codebox">Summers,Joyce,,"1630 Revello Dr",,Sunnydale,CA,95037
  90 McGarret,Steve,O,"404 Piikoi Street",,Honolulu,HI,96813
  91 Kramer,Cosmo,,"Apt 5B","129 W. 81 St.","New York",NY,10024-7207
  92 </div>
  93 <p>
  94 In the following screenshot, a single multiline text object has been
  95 created to format these addresses.  Notice that ${5} representing
  96 the second address line is on a line by itself.  (Any additional text
  97 on this line, including spaces would defeat this feature.)
  98 </p>
  99 <?img("q1.3-screenshot.png","Multi-line address");?>
 100 <p>
 101 Printing this label results in the following output.
 102 </p>
 103 <?img("q1.3-output.png","Output");?>
 104
 105 </div>
 106
 107 <?php gLabelsFooter(); ?>