Doxygen: make explanation of how PostScript text works always visible.
This commit is contained in:
ManoloFLTK
parent
1280370fc8
commit
4abaeba539
@ -39,30 +39,7 @@ extern "C" {
|
|||||||
*/
|
*/
|
||||||
|
|
||||||
/**
|
/**
|
||||||
\brief PostScript graphical backend.
|
PostScript graphical backend.
|
||||||
|
|
||||||
PostScript text uses vectorial fonts when using the FLTK standard fonts
|
|
||||||
and the latin alphabet or a few other characters listed in the following table.
|
|
||||||
The latin alphabet means all unicode characters between U+0020 and U+017F, or, in other words,
|
|
||||||
the ASCII, Latin-1 Supplement and Latin Extended-A charts.
|
|
||||||
<table>
|
|
||||||
<tr> <th>Char</th><th>Codepoint</th><th>Name</th> <th>Char</th><th>Codepoint</th><th>Name</th> <th>Char</th><th>Codepoint</th><th>Name</th></tr>
|
|
||||||
<tr><td>ƒ</td><td>U+0192</td><td>florin</td><td>‚</td><td>U+201A</td><td>quotesinglbase</td><td>™</td><td>U+2122</td><td>trademark</td></tr>
|
|
||||||
<tr><td>ˆ</td><td>U+02C6</td><td>circumflex</td><td>“</td><td>U+201C</td><td>quotedblleft</td><td>∂</td><td>U+2202</td><td>partialdiff</td></tr>
|
|
||||||
<tr><td>ˇ</td><td>U+02C7</td><td>caron</td><td>”</td><td>U+201D</td><td>quotedblright</td><td>Δ</td><td>U+2206</td><td>Delta</td></tr>
|
|
||||||
<tr><td>˘</td><td>U+02D8</td><td>breve</td><td>„</td><td>U+201E</td><td>quotedblbase</td><td>∑</td><td>U+2211</td><td>summation</td></tr>
|
|
||||||
<tr><td>˙</td><td>U+02D9</td><td>dotaccent</td><td>†</td><td>U+2020</td><td>dagger</td><td>√</td><td>U+221A</td><td>radical</td></tr>
|
|
||||||
<tr><td>˚</td><td>U+02DA</td><td>ring</td><td>‡</td><td>U+2021</td><td>daggerdbl</td><td>∞</td><td>U+221E</td><td>infinity</td></tr>
|
|
||||||
<tr><td>˛</td><td>U+02DB</td><td>ogonek</td><td>•</td><td>U+2022</td><td>bullet</td><td>≠</td><td>U+2260</td><td>notequal</td></tr>
|
|
||||||
<tr><td>˜</td><td>U+02DC</td><td>tilde</td><td>…</td><td>U+2026</td><td>ellipsis</td><td>≤</td><td>U+2264</td><td>lessequal</td></tr>
|
|
||||||
<tr><td>˝</td><td>U+02DD</td><td>hungarumlaut</td><td>‰</td><td>U+2030</td><td>perthousand</td><td>≥</td><td>U+2265</td><td>greaterequal</td></tr>
|
|
||||||
<tr><td>–</td><td>U+2013</td><td>endash</td><td>‹</td><td>U+2039</td><td>guilsinglleft</td><td>◊</td><td>U+25CA</td><td>lozenge</td></tr>
|
|
||||||
<tr><td>—</td><td>U+2014</td><td>emdash</td><td>›</td><td>U+203A</td><td>guilsinglright</td><td>fi</td><td>U+FB01</td><td>fi</td></tr>
|
|
||||||
<tr><td>‘</td><td>U+2018</td><td>quoteleft</td><td>/</td><td>U+2044</td><td>fraction</td><td>fl</td><td>U+FB02</td><td>fl</td></tr>
|
|
||||||
<tr><td>’</td><td>U+2019</td><td>quoteright</td><td>€</td><td>U+20AC</td><td>Euro</td><td></td><td>U+F8FF</td><td>apple (Mac OS only)</td></tr>
|
|
||||||
</table>
|
|
||||||
<br> All other unicode characters or all other fonts (FL_FREE_FONT and above) are output as a bitmap.
|
|
||||||
<br> FLTK standard fonts are output using the corresponding PostScript standard fonts.
|
|
||||||
*/
|
*/
|
||||||
class FL_EXPORT Fl_PostScript_Graphics_Driver : public Fl_Graphics_Driver {
|
class FL_EXPORT Fl_PostScript_Graphics_Driver : public Fl_Graphics_Driver {
|
||||||
private:
|
private:
|
||||||
@ -240,6 +217,30 @@ public:
|
|||||||
To send graphical output to a PostScript file.
|
To send graphical output to a PostScript file.
|
||||||
This class is used exactly as the Fl_Printer class except for the begin_job() call,
|
This class is used exactly as the Fl_Printer class except for the begin_job() call,
|
||||||
two variants of which are usable and allow to specify what page format and layout are desired.
|
two variants of which are usable and allow to specify what page format and layout are desired.
|
||||||
|
|
||||||
|
PostScript text uses vectorial fonts when using the FLTK standard fonts
|
||||||
|
and the latin alphabet or a few other characters listed in the following table.
|
||||||
|
The latin alphabet means all unicode characters between U+0020 and U+017F, or, in other words,
|
||||||
|
the ASCII, Latin-1 Supplement and Latin Extended-A charts.
|
||||||
|
<table>
|
||||||
|
<tr> <th>Char</th><th>Codepoint</th><th>Name</th> <th>Char</th><th>Codepoint</th><th>Name</th> <th>Char</th><th>Codepoint</th><th>Name</th></tr>
|
||||||
|
<tr><td>ƒ</td><td>U+0192</td><td>florin</td><td>‚</td><td>U+201A</td><td>quotesinglbase</td><td>™</td><td>U+2122</td><td>trademark</td></tr>
|
||||||
|
<tr><td>ˆ</td><td>U+02C6</td><td>circumflex</td><td>“</td><td>U+201C</td><td>quotedblleft</td><td>∂</td><td>U+2202</td><td>partialdiff</td></tr>
|
||||||
|
<tr><td>ˇ</td><td>U+02C7</td><td>caron</td><td>”</td><td>U+201D</td><td>quotedblright</td><td>Δ</td><td>U+2206</td><td>Delta</td></tr>
|
||||||
|
<tr><td>˘</td><td>U+02D8</td><td>breve</td><td>„</td><td>U+201E</td><td>quotedblbase</td><td>∑</td><td>U+2211</td><td>summation</td></tr>
|
||||||
|
<tr><td>˙</td><td>U+02D9</td><td>dotaccent</td><td>†</td><td>U+2020</td><td>dagger</td><td>√</td><td>U+221A</td><td>radical</td></tr>
|
||||||
|
<tr><td>˚</td><td>U+02DA</td><td>ring</td><td>‡</td><td>U+2021</td><td>daggerdbl</td><td>∞</td><td>U+221E</td><td>infinity</td></tr>
|
||||||
|
<tr><td>˛</td><td>U+02DB</td><td>ogonek</td><td>•</td><td>U+2022</td><td>bullet</td><td>≠</td><td>U+2260</td><td>notequal</td></tr>
|
||||||
|
<tr><td>˜</td><td>U+02DC</td><td>tilde</td><td>…</td><td>U+2026</td><td>ellipsis</td><td>≤</td><td>U+2264</td><td>lessequal</td></tr>
|
||||||
|
<tr><td>˝</td><td>U+02DD</td><td>hungarumlaut</td><td>‰</td><td>U+2030</td><td>perthousand</td><td>≥</td><td>U+2265</td><td>greaterequal</td></tr>
|
||||||
|
<tr><td>–</td><td>U+2013</td><td>endash</td><td>‹</td><td>U+2039</td><td>guilsinglleft</td><td>◊</td><td>U+25CA</td><td>lozenge</td></tr>
|
||||||
|
<tr><td>—</td><td>U+2014</td><td>emdash</td><td>›</td><td>U+203A</td><td>guilsinglright</td><td>fi</td><td>U+FB01</td><td>fi</td></tr>
|
||||||
|
<tr><td>‘</td><td>U+2018</td><td>quoteleft</td><td>/</td><td>U+2044</td><td>fraction</td><td>fl</td><td>U+FB02</td><td>fl</td></tr>
|
||||||
|
<tr><td>’</td><td>U+2019</td><td>quoteright</td><td>€</td><td>U+20AC</td><td>Euro</td><td></td><td>U+F8FF</td><td>apple (Mac OS only)</td></tr>
|
||||||
|
</table>
|
||||||
|
<br> All other unicode characters or all other fonts (FL_FREE_FONT and above) are output as a bitmap.
|
||||||
|
<br> FLTK standard fonts are output using the corresponding PostScript standard fonts.
|
||||||
|
|
||||||
*/
|
*/
|
||||||
class FL_EXPORT Fl_PostScript_File_Device : public Fl_Paged_Device {
|
class FL_EXPORT Fl_PostScript_File_Device : public Fl_Paged_Device {
|
||||||
protected:
|
protected:
|
||||||
|
|||||||
@ -62,21 +62,23 @@
|
|||||||
<b>Platform specifics</b>
|
<b>Platform specifics</b>
|
||||||
<ul>
|
<ul>
|
||||||
<li>Unix/Linux platforms:
|
<li>Unix/Linux platforms:
|
||||||
Unless it has been previously changed, the default paper size is A4.
|
<ul><li>FLTK expresses all graphics data using (Level 2) PostScript and sends that to the selected printer.
|
||||||
|
See class Fl_PostScript_File_Device for a description of how text appears in print.
|
||||||
|
<li>Unless it has been previously changed, the default paper size is A4.
|
||||||
To change that, press the "Properties" button of the "Print" dialog window
|
To change that, press the "Properties" button of the "Print" dialog window
|
||||||
opened by an Fl_Printer::begin_job() call. This opens a "Printer Properties" window where it's
|
opened by an Fl_Printer::begin_job() call. This opens a "Printer Properties" window where it's
|
||||||
possible to select the adequate paper size. Finally press the "Save" button therein to assign
|
possible to select the adequate paper size. Finally press the "Save" button therein to assign
|
||||||
the chosen paper size to the chosen printer for this and all further print operations.
|
the chosen paper size to the chosen printer for this and all further print operations.
|
||||||
<br>Class Fl_RGB_Image prints but loses its transparency if it has one.
|
<li>Class Fl_RGB_Image prints but loses its transparency if it has one.
|
||||||
See class Fl_PostScript_Graphics_Driver for a description of how UTF-8 strings appear in print.
|
<li>Use the static public attributes of this class to set the print dialog to other languages
|
||||||
Use the static public attributes of this class to set the print dialog to other languages
|
|
||||||
than English. For example, the "Printer:" dialog item Fl_Printer::dialog_printer can be set to French with:
|
than English. For example, the "Printer:" dialog item Fl_Printer::dialog_printer can be set to French with:
|
||||||
\code
|
\code
|
||||||
Fl_Printer::dialog_printer = "Imprimante:";
|
Fl_Printer::dialog_printer = "Imprimante:";
|
||||||
\endcode
|
\endcode
|
||||||
before creation of the Fl_Printer object.
|
before creation of the Fl_Printer object.
|
||||||
Use Fl_PostScript_File_Device::file_chooser_title to customize the title of the file chooser dialog that opens
|
<li>Use Fl_PostScript_File_Device::file_chooser_title to customize the title of the file chooser dialog that opens
|
||||||
when using the "Print To File" option of the print dialog.
|
when using the "Print To File" option of the print dialog.
|
||||||
|
</ul>
|
||||||
<li>Windows platform: Transparent Fl_RGB_Image 's don't print with exact transparency on most printers
|
<li>Windows platform: Transparent Fl_RGB_Image 's don't print with exact transparency on most printers
|
||||||
(a workaround is to use print_window_part() ).
|
(a workaround is to use print_window_part() ).
|
||||||
Fl_RGB_Image 's don't rotate() well.
|
Fl_RGB_Image 's don't rotate() well.
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user