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