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