examples.doc

Trolltech公司发布的基于C++图形开发环境

/****************************************************************************
** $Id: qt/extensions/nsplugin/doc/examples.doc   2.3.10   edited 2005-01-24 $
**
** Documentation for the examples
**
** Copyright (C) 1995-1997 by Trolltech AS.  All rights reserved.
**
*****************************************************************************/

#if defined(DEBUG)
static char ident[] = "$Id: qt/extensions/nsplugin/doc/examples.doc   2.3.10   edited 2005-01-24 $";
#endif


/*! \example grapher/grapher.cpp

  <h1 align=center>Grapher Plugin</h1>
  <p>
  This example graphs data from a simple text file.  It
  demonstrates the use of the QNPInstance::writeReady()
  and QNPInstance::write() functions.
  <p>
  To build the example, you must first build the
  <a href=nsplugin.html>Qt Netscape Plugin Extension</a> library.
  Then type <tt>make</tt> in <tt>extensions/nsplugin/examples/grapher/</tt>
  and copy the resulting <tt>grapher.so</tt> or <tt>npgrapher.dll</tt>
  to the Plugins directory of your WWW browser.
  <p>
  <EMBED ALIGN=LEFT WIDTH=49% HEIGHT=300 SRC=graph.g1n
    graphstyle=pie fontfamily=times fontsize=18>
  <p>
  The text file it accepts as input has a title line, then
  a sequence of lines with a number, then a string.  The
  plugin displays a pie chart of the numbers, each segment
  labelled by the associated string.  The user can select
  a bar chart view of the same data by selecting from the
  menu that appears when they point at the plugin.
  <p>
  The HTML tag used to embed the graph is:
<small>
<pre>
  &lt;EMBED
    SRC=graph.g1n
    ALIGN=LEFT
    WIDTH=49% HEIGHT=300
    graphstyle=pie fontfamily=times
    fontsize=18&gt;
</pre>
</small>
  Note that some HTML arguments (which we have capitalized here)
  are interpreted by the browser, while others are used by the
  plugin.

<br clear>
With the simplicity and cross-platform nature of Qt-based plugins,
pages like <a href="http://www.netcraft.com/survey/">Netcraft's
Server Graphs</a> can be provided much more efficiently for both
the service provider and consumer.  Data need not be converted
to an image at the server.

<br clear>
*/
/*! \page graph.g1n
num label
10 A
24 B
12 C
7 D
34 E
15 F
19 G
*/

/*! \example qtimage/qtimage.cpp

  <h1 align=center>Display Images in Qt-supported Formats</h1>
  <p>
  This example displays images which are in any format
  supported by Qt.  Combining this with the Qt ImageIO
  Extension adds PNG image support to your browser.
  It demonstrates the use of the QNPInstance::streamAsFile()
  function.
  <p>
  To build the example, you must first build the
  <a href=nsplugin.html>Qt Netscape Plugin Extension</a> library.
  Then type <tt>make</tt> in <tt>extensions/nsplugin/examples/qtimage/</tt>
  and copy the resulting <tt>qtimage.so</tt> or <tt>npqtimage.dll</tt>
  to the Plugins directory of your WWW browser.
  <p>
<table>
<tr>
<td valign=top><EMBED src=pnglogo.png WIDTH=256 HEIGHT=192>
<td valign=top>
  This plugin displays a <a href=http://www.cdrom.com/pub/png/>PNG format</a> image.
  <p>
  New image format can be supported by
  adding new image I/O handlers to the Qt library
  (see QImage::defineIOHandler), thus providing the functionality in both
  applications and WWW plugins from the same code.
</table>
  <p>
This plugin supports transparency and scaling of the image, just like
GIFs in most WWW browsers.

<br>
<EMBED align=middle src=test.png WIDTH=182 HEIGHT=138>
<EMBED align=middle src=test.png WIDTH=137 HEIGHT=104>
<EMBED align=middle src=test.png WIDTH=91 HEIGHT=69>
<EMBED align=middle src=test.png WIDTH=46 HEIGHT=35>
*/

/*! \base64 test.png
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