]> git.kernelconcepts.de Git - karo-tx-redboot.git/blob - packages/services/gfx/mw/v2_0/doc/nano-X/html/nano-x-fonts.html
Initial revision
[karo-tx-redboot.git] / packages / services / gfx / mw / v2_0 / doc / nano-X / html / nano-x-fonts.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >fonts</TITLE
5 ><META
6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.33"><LINK
8 REL="HOME"
9 TITLE="Nano-X API Reference Manual"
10 HREF="index.html"><LINK
11 REL="UP"
12 TITLE="libnano-X"
13 HREF="libnano-x.html"><LINK
14 REL="PREVIOUS"
15 TITLE="events"
16 HREF="nano-x-events.html"><LINK
17 REL="NEXT"
18 TITLE="pointer"
19 HREF="nano-x-pointer.html"></HEAD
20 ><BODY
21 BGCOLOR="#FFFFFF"
22 TEXT="#000000"
23 ><DIV
24 CLASS="NAVHEADER"
25 ><TABLE
26 WIDTH="100%"
27 BORDER="0"
28 BGCOLOR="#000000"
29 CELLPADDING="1"
30 CELLSPACING="0"
31 ><TR
32 ><TH
33 COLSPAN="4"
34 ALIGN="center"
35 ><FONT
36 COLOR="#FFFFFF"
37 SIZE="5"
38 >Nano-X API Reference Manual</FONT
39 ></TH
40 ></TR
41 ><TR
42 ><TD
43 WIDTH="25%"
44 BGCOLOR="#C00000"
45 ALIGN="left"
46 ><A
47 HREF="nano-x-events.html"
48 ><FONT
49 COLOR="#FFFFFF"
50 SIZE="3"
51 ><B
52 >&#60;&#60;&#60; Previous Page</B
53 ></FONT
54 ></A
55 ></TD
56 ><TD
57 WIDTH="25%"
58 BGCOLOR="#0000C0"
59 ALIGN="center"
60 ><FONT
61 COLOR="#FFFFFF"
62 SIZE="3"
63 ><B
64 ><A
65 HREF="index.html"
66 ><FONT
67 COLOR="#FFFFFF"
68 SIZE="3"
69 ><B
70 >Home</B
71 ></FONT
72 ></A
73 ></B
74 ></FONT
75 ></TD
76 ><TD
77 WIDTH="25%"
78 BGCOLOR="#00C000"
79 ALIGN="center"
80 ><FONT
81 COLOR="#FFFFFF"
82 SIZE="3"
83 ><B
84 ><A
85 HREF="libnano-x.html"
86 ><FONT
87 COLOR="#FFFFFF"
88 SIZE="3"
89 ><B
90 >Up</B
91 ></FONT
92 ></A
93 ></B
94 ></FONT
95 ></TD
96 ><TD
97 WIDTH="25%"
98 BGCOLOR="#C00000"
99 ALIGN="right"
100 ><A
101 HREF="nano-x-pointer.html"
102 ><FONT
103 COLOR="#FFFFFF"
104 SIZE="3"
105 ><B
106 >Next Page &#62;&#62;&#62;</B
107 ></FONT
108 ></A
109 ></TD
110 ></TR
111 ></TABLE
112 ></DIV
113 ><H1
114 >fonts</H1
115 ><DIV
116 CLASS="REFNAMEDIV"
117 ><A
118 NAME="AEN2120"
119 ></A
120 ><H2
121 >Name</H2
122 >fonts &#8212; </DIV
123 ><DIV
124 CLASS="REFSYNOPSISDIV"
125 ><A
126 NAME="AEN2123"
127 ></A
128 ><H2
129 >Synopsis</H2
130 ><TABLE
131 BORDER="0"
132 BGCOLOR="#D6E8FF"
133 WIDTH="100%"
134 CELLPADDING="6"
135 ><TR
136 ><TD
137 ><PRE
138 CLASS="SYNOPSIS"
139 >&#13;
140
141 <GTKDOCLINK
142 HREF="GR-FONT-ID-CAPS"
143 >GR_FONT_ID</GTKDOCLINK
144 >  <A
145 HREF="nano-x-fonts.html#GRCREATEFONT"
146 >GrCreateFont</A
147 >                    (<GTKDOCLINK
148 HREF="GR-CHAR-CAPS"
149 >GR_CHAR</GTKDOCLINK
150 > *name,
151                                              <GTKDOCLINK
152 HREF="GR-COORD-CAPS"
153 >GR_COORD</GTKDOCLINK
154 > height,
155                                              <GTKDOCLINK
156 HREF="GR-LOGFONT-CAPS"
157 >GR_LOGFONT</GTKDOCLINK
158 > *plogfont);
159 void        <A
160 HREF="nano-x-fonts.html#GRSETFONTSIZE"
161 >GrSetFontSize</A
162 >                   (<GTKDOCLINK
163 HREF="GR-FONT-ID-CAPS"
164 >GR_FONT_ID</GTKDOCLINK
165 > fontid,
166                                              <GTKDOCLINK
167 HREF="GR-COORD-CAPS"
168 >GR_COORD</GTKDOCLINK
169 > size);
170 void        <A
171 HREF="nano-x-fonts.html#GRSETFONTROTATION"
172 >GrSetFontRotation</A
173 >               (<GTKDOCLINK
174 HREF="GR-FONT-ID-CAPS"
175 >GR_FONT_ID</GTKDOCLINK
176 > fontid,
177                                              int tenthsdegrees);
178 void        <A
179 HREF="nano-x-fonts.html#GRSETFONTATTR"
180 >GrSetFontAttr</A
181 >                   (<GTKDOCLINK
182 HREF="GR-FONT-ID-CAPS"
183 >GR_FONT_ID</GTKDOCLINK
184 > fontid,
185                                              int setflags,
186                                              int clrflags);
187 void        <A
188 HREF="nano-x-fonts.html#GRDESTROYFONT"
189 >GrDestroyFont</A
190 >                   (<GTKDOCLINK
191 HREF="GR-FONT-ID-CAPS"
192 >GR_FONT_ID</GTKDOCLINK
193 > fontid);
194 void        <A
195 HREF="nano-x-fonts.html#GRGETFONTINFO"
196 >GrGetFontInfo</A
197 >                   (<GTKDOCLINK
198 HREF="GR-FONT-ID-CAPS"
199 >GR_FONT_ID</GTKDOCLINK
200 > font,
201                                              <GTKDOCLINK
202 HREF="GR-FONT-INFO-CAPS"
203 >GR_FONT_INFO</GTKDOCLINK
204 > *fip);</PRE
205 ></TD
206 ></TR
207 ></TABLE
208 ></DIV
209 ><DIV
210 CLASS="REFSECT1"
211 ><A
212 NAME="AEN2143"
213 ></A
214 ><H2
215 >Description</H2
216 ><P
217 ></P
218 ></DIV
219 ><DIV
220 CLASS="REFSECT1"
221 ><A
222 NAME="AEN2146"
223 ></A
224 ><H2
225 >Details</H2
226 ><DIV
227 CLASS="REFSECT2"
228 ><A
229 NAME="AEN2148"
230 ></A
231 ><H3
232 ><A
233 NAME="GRCREATEFONT"
234 ></A
235 >GrCreateFont ()</H3
236 ><TABLE
237 BORDER="0"
238 BGCOLOR="#D6E8FF"
239 WIDTH="100%"
240 CELLPADDING="6"
241 ><TR
242 ><TD
243 ><PRE
244 CLASS="PROGRAMLISTING"
245 ><GTKDOCLINK
246 HREF="GR-FONT-ID-CAPS"
247 >GR_FONT_ID</GTKDOCLINK
248 >  GrCreateFont                    (<GTKDOCLINK
249 HREF="GR-CHAR-CAPS"
250 >GR_CHAR</GTKDOCLINK
251 > *name,
252                                              <GTKDOCLINK
253 HREF="GR-COORD-CAPS"
254 >GR_COORD</GTKDOCLINK
255 > height,
256                                              <GTKDOCLINK
257 HREF="GR-LOGFONT-CAPS"
258 >GR_LOGFONT</GTKDOCLINK
259 > *plogfont);</PRE
260 ></TD
261 ></TR
262 ></TABLE
263 ><P
264 >Attempts to locate a font with the desired attributes and returns a font
265 ID number which can be used to refer to it. If the plogfont argument is
266 not NULL, the values in that structure will be used to choose a font.
267 Otherwise, if the height is non zero, the built in font with the closest
268 height to that specified will be used. If the height is zero, the built
269 in font with the specified name will be used. If the desired font is not
270 found, the first built in font will be returned as a last resort.</P
271 ><P
272 ></P
273 ><DIV
274 CLASS="INFORMALTABLE"
275 ><P
276 ></P
277 ><TABLE
278 BORDER="0"
279 WIDTH="100%"
280 BGCOLOR="#FFD0D0"
281 CELLSPACING="0"
282 CELLPADDING="4"
283 CLASS="CALSTABLE"
284 ><TR
285 ><TD
286 WIDTH="20%"
287 ALIGN="RIGHT"
288 VALIGN="TOP"
289 ><TT
290 CLASS="PARAMETER"
291 ><I
292 >name</I
293 ></TT
294 >&nbsp;:</TD
295 ><TD
296 WIDTH="80%"
297 ALIGN="LEFT"
298 VALIGN="TOP"
299 > string containing the name of a built in font to look for</TD
300 ></TR
301 ><TR
302 ><TD
303 WIDTH="20%"
304 ALIGN="RIGHT"
305 VALIGN="TOP"
306 ><TT
307 CLASS="PARAMETER"
308 ><I
309 >height</I
310 ></TT
311 >&nbsp;:</TD
312 ><TD
313 WIDTH="80%"
314 ALIGN="LEFT"
315 VALIGN="TOP"
316 > the desired height of the font</TD
317 ></TR
318 ><TR
319 ><TD
320 WIDTH="20%"
321 ALIGN="RIGHT"
322 VALIGN="TOP"
323 ><TT
324 CLASS="PARAMETER"
325 ><I
326 >plogfont</I
327 ></TT
328 >&nbsp;:</TD
329 ><TD
330 WIDTH="80%"
331 ALIGN="LEFT"
332 VALIGN="TOP"
333 > pointer to a LOGFONT structure</TD
334 ></TR
335 ><TR
336 ><TD
337 WIDTH="20%"
338 ALIGN="RIGHT"
339 VALIGN="TOP"
340 ><I
341 CLASS="EMPHASIS"
342 >Returns</I
343 > :</TD
344 ><TD
345 WIDTH="80%"
346 ALIGN="LEFT"
347 VALIGN="TOP"
348 > a font ID number which can be used to refer to the font</TD
349 ></TR
350 ></TABLE
351 ><P
352 ></P
353 ></DIV
354 ></DIV
355 ><HR><DIV
356 CLASS="REFSECT2"
357 ><A
358 NAME="AEN2179"
359 ></A
360 ><H3
361 ><A
362 NAME="GRSETFONTSIZE"
363 ></A
364 >GrSetFontSize ()</H3
365 ><TABLE
366 BORDER="0"
367 BGCOLOR="#D6E8FF"
368 WIDTH="100%"
369 CELLPADDING="6"
370 ><TR
371 ><TD
372 ><PRE
373 CLASS="PROGRAMLISTING"
374 >void        GrSetFontSize                   (<GTKDOCLINK
375 HREF="GR-FONT-ID-CAPS"
376 >GR_FONT_ID</GTKDOCLINK
377 > fontid,
378                                              <GTKDOCLINK
379 HREF="GR-COORD-CAPS"
380 >GR_COORD</GTKDOCLINK
381 > size);</PRE
382 ></TD
383 ></TR
384 ></TABLE
385 ><P
386 >Changes the size of the specified font to the specified size.</P
387 ><P
388 ></P
389 ><DIV
390 CLASS="INFORMALTABLE"
391 ><P
392 ></P
393 ><TABLE
394 BORDER="0"
395 WIDTH="100%"
396 BGCOLOR="#FFD0D0"
397 CELLSPACING="0"
398 CELLPADDING="4"
399 CLASS="CALSTABLE"
400 ><TR
401 ><TD
402 WIDTH="20%"
403 ALIGN="RIGHT"
404 VALIGN="TOP"
405 ><TT
406 CLASS="PARAMETER"
407 ><I
408 >fontid</I
409 ></TT
410 >&nbsp;:</TD
411 ><TD
412 WIDTH="80%"
413 ALIGN="LEFT"
414 VALIGN="TOP"
415 > the ID number of the font to change the size of</TD
416 ></TR
417 ><TR
418 ><TD
419 WIDTH="20%"
420 ALIGN="RIGHT"
421 VALIGN="TOP"
422 ><TT
423 CLASS="PARAMETER"
424 ><I
425 >size</I
426 ></TT
427 >&nbsp;:</TD
428 ><TD
429 WIDTH="80%"
430 ALIGN="LEFT"
431 VALIGN="TOP"
432 >&nbsp;</TD
433 ></TR
434 ></TABLE
435 ><P
436 ></P
437 ></DIV
438 ></DIV
439 ><HR><DIV
440 CLASS="REFSECT2"
441 ><A
442 NAME="AEN2200"
443 ></A
444 ><H3
445 ><A
446 NAME="GRSETFONTROTATION"
447 ></A
448 >GrSetFontRotation ()</H3
449 ><TABLE
450 BORDER="0"
451 BGCOLOR="#D6E8FF"
452 WIDTH="100%"
453 CELLPADDING="6"
454 ><TR
455 ><TD
456 ><PRE
457 CLASS="PROGRAMLISTING"
458 >void        GrSetFontRotation               (<GTKDOCLINK
459 HREF="GR-FONT-ID-CAPS"
460 >GR_FONT_ID</GTKDOCLINK
461 > fontid,
462                                              int tenthsdegrees);</PRE
463 ></TD
464 ></TR
465 ></TABLE
466 ><P
467 >Changes the rotation of the specified font to the specified angle.</P
468 ><P
469 ></P
470 ><DIV
471 CLASS="INFORMALTABLE"
472 ><P
473 ></P
474 ><TABLE
475 BORDER="0"
476 WIDTH="100%"
477 BGCOLOR="#FFD0D0"
478 CELLSPACING="0"
479 CELLPADDING="4"
480 CLASS="CALSTABLE"
481 ><TR
482 ><TD
483 WIDTH="20%"
484 ALIGN="RIGHT"
485 VALIGN="TOP"
486 ><TT
487 CLASS="PARAMETER"
488 ><I
489 >fontid</I
490 ></TT
491 >&nbsp;:</TD
492 ><TD
493 WIDTH="80%"
494 ALIGN="LEFT"
495 VALIGN="TOP"
496 > the ID number of the font to rotate</TD
497 ></TR
498 ><TR
499 ><TD
500 WIDTH="20%"
501 ALIGN="RIGHT"
502 VALIGN="TOP"
503 ><TT
504 CLASS="PARAMETER"
505 ><I
506 >tenthsdegrees</I
507 ></TT
508 >&nbsp;:</TD
509 ><TD
510 WIDTH="80%"
511 ALIGN="LEFT"
512 VALIGN="TOP"
513 >&nbsp;</TD
514 ></TR
515 ></TABLE
516 ><P
517 ></P
518 ></DIV
519 ></DIV
520 ><HR><DIV
521 CLASS="REFSECT2"
522 ><A
523 NAME="AEN2220"
524 ></A
525 ><H3
526 ><A
527 NAME="GRSETFONTATTR"
528 ></A
529 >GrSetFontAttr ()</H3
530 ><TABLE
531 BORDER="0"
532 BGCOLOR="#D6E8FF"
533 WIDTH="100%"
534 CELLPADDING="6"
535 ><TR
536 ><TD
537 ><PRE
538 CLASS="PROGRAMLISTING"
539 >void        GrSetFontAttr                   (<GTKDOCLINK
540 HREF="GR-FONT-ID-CAPS"
541 >GR_FONT_ID</GTKDOCLINK
542 > fontid,
543                                              int setflags,
544                                              int clrflags);</PRE
545 ></TD
546 ></TR
547 ></TABLE
548 ><P
549 >Changes the attributes (GR_TFKERNING, GR_TFANTIALIAS, GR_TFUNDERLINE, etc.)
550 of the specified font according to the set and clear mask arguments.</P
551 ><P
552 ></P
553 ><DIV
554 CLASS="INFORMALTABLE"
555 ><P
556 ></P
557 ><TABLE
558 BORDER="0"
559 WIDTH="100%"
560 BGCOLOR="#FFD0D0"
561 CELLSPACING="0"
562 CELLPADDING="4"
563 CLASS="CALSTABLE"
564 ><TR
565 ><TD
566 WIDTH="20%"
567 ALIGN="RIGHT"
568 VALIGN="TOP"
569 ><TT
570 CLASS="PARAMETER"
571 ><I
572 >fontid</I
573 ></TT
574 >&nbsp;:</TD
575 ><TD
576 WIDTH="80%"
577 ALIGN="LEFT"
578 VALIGN="TOP"
579 > the ID of the font to set the attributes of</TD
580 ></TR
581 ><TR
582 ><TD
583 WIDTH="20%"
584 ALIGN="RIGHT"
585 VALIGN="TOP"
586 ><TT
587 CLASS="PARAMETER"
588 ><I
589 >setflags</I
590 ></TT
591 >&nbsp;:</TD
592 ><TD
593 WIDTH="80%"
594 ALIGN="LEFT"
595 VALIGN="TOP"
596 > mask specifying attribute flags to set</TD
597 ></TR
598 ><TR
599 ><TD
600 WIDTH="20%"
601 ALIGN="RIGHT"
602 VALIGN="TOP"
603 ><TT
604 CLASS="PARAMETER"
605 ><I
606 >clrflags</I
607 ></TT
608 >&nbsp;:</TD
609 ><TD
610 WIDTH="80%"
611 ALIGN="LEFT"
612 VALIGN="TOP"
613 > mask specifying attribute flags to clear</TD
614 ></TR
615 ></TABLE
616 ><P
617 ></P
618 ></DIV
619 ></DIV
620 ><HR><DIV
621 CLASS="REFSECT2"
622 ><A
623 NAME="AEN2244"
624 ></A
625 ><H3
626 ><A
627 NAME="GRDESTROYFONT"
628 ></A
629 >GrDestroyFont ()</H3
630 ><TABLE
631 BORDER="0"
632 BGCOLOR="#D6E8FF"
633 WIDTH="100%"
634 CELLPADDING="6"
635 ><TR
636 ><TD
637 ><PRE
638 CLASS="PROGRAMLISTING"
639 >void        GrDestroyFont                   (<GTKDOCLINK
640 HREF="GR-FONT-ID-CAPS"
641 >GR_FONT_ID</GTKDOCLINK
642 > fontid);</PRE
643 ></TD
644 ></TR
645 ></TABLE
646 ><P
647 >Frees all resources associated with the specified font ID, and if the font
648 is a non built in type and this is the last ID referring to it, unloads the
649 font from memory.</P
650 ><P
651 ></P
652 ><DIV
653 CLASS="INFORMALTABLE"
654 ><P
655 ></P
656 ><TABLE
657 BORDER="0"
658 WIDTH="100%"
659 BGCOLOR="#FFD0D0"
660 CELLSPACING="0"
661 CELLPADDING="4"
662 CLASS="CALSTABLE"
663 ><TR
664 ><TD
665 WIDTH="20%"
666 ALIGN="RIGHT"
667 VALIGN="TOP"
668 ><TT
669 CLASS="PARAMETER"
670 ><I
671 >fontid</I
672 ></TT
673 >&nbsp;:</TD
674 ><TD
675 WIDTH="80%"
676 ALIGN="LEFT"
677 VALIGN="TOP"
678 > the ID of the font to destroy</TD
679 ></TR
680 ></TABLE
681 ><P
682 ></P
683 ></DIV
684 ></DIV
685 ><HR><DIV
686 CLASS="REFSECT2"
687 ><A
688 NAME="AEN2260"
689 ></A
690 ><H3
691 ><A
692 NAME="GRGETFONTINFO"
693 ></A
694 >GrGetFontInfo ()</H3
695 ><TABLE
696 BORDER="0"
697 BGCOLOR="#D6E8FF"
698 WIDTH="100%"
699 CELLPADDING="6"
700 ><TR
701 ><TD
702 ><PRE
703 CLASS="PROGRAMLISTING"
704 >void        GrGetFontInfo                   (<GTKDOCLINK
705 HREF="GR-FONT-ID-CAPS"
706 >GR_FONT_ID</GTKDOCLINK
707 > font,
708                                              <GTKDOCLINK
709 HREF="GR-FONT-INFO-CAPS"
710 >GR_FONT_INFO</GTKDOCLINK
711 > *fip);</PRE
712 ></TD
713 ></TR
714 ></TABLE
715 ><P
716 >Fills in the specified GR_FONT_INFO structure with information regarding
717 the specified font.</P
718 ><P
719 ></P
720 ><DIV
721 CLASS="INFORMALTABLE"
722 ><P
723 ></P
724 ><TABLE
725 BORDER="0"
726 WIDTH="100%"
727 BGCOLOR="#FFD0D0"
728 CELLSPACING="0"
729 CELLPADDING="4"
730 CLASS="CALSTABLE"
731 ><TR
732 ><TD
733 WIDTH="20%"
734 ALIGN="RIGHT"
735 VALIGN="TOP"
736 ><TT
737 CLASS="PARAMETER"
738 ><I
739 >font</I
740 ></TT
741 >&nbsp;:</TD
742 ><TD
743 WIDTH="80%"
744 ALIGN="LEFT"
745 VALIGN="TOP"
746 >&nbsp;</TD
747 ></TR
748 ><TR
749 ><TD
750 WIDTH="20%"
751 ALIGN="RIGHT"
752 VALIGN="TOP"
753 ><TT
754 CLASS="PARAMETER"
755 ><I
756 >fip</I
757 ></TT
758 >&nbsp;:</TD
759 ><TD
760 WIDTH="80%"
761 ALIGN="LEFT"
762 VALIGN="TOP"
763 > pointer to a GR_FONT_INFO structure</TD
764 ></TR
765 ></TABLE
766 ><P
767 ></P
768 ></DIV
769 ></DIV
770 ></DIV
771 ><DIV
772 CLASS="NAVFOOTER"
773 ><BR
774 CLEAR="all"><BR><TABLE
775 WIDTH="100%"
776 BORDER="0"
777 BGCOLOR="#000000"
778 CELLPADDING="1"
779 CELLSPACING="0"
780 ><TR
781 ><TD
782 WIDTH="25%"
783 BGCOLOR="#C00000"
784 ALIGN="left"
785 ><A
786 HREF="nano-x-events.html"
787 ><FONT
788 COLOR="#FFFFFF"
789 SIZE="3"
790 ><B
791 >&#60;&#60;&#60; Previous Page</B
792 ></FONT
793 ></A
794 ></TD
795 ><TD
796 WIDTH="25%"
797 BGCOLOR="#0000C0"
798 ALIGN="center"
799 ><FONT
800 COLOR="#FFFFFF"
801 SIZE="3"
802 ><B
803 ><A
804 HREF="index.html"
805 ><FONT
806 COLOR="#FFFFFF"
807 SIZE="3"
808 ><B
809 >Home</B
810 ></FONT
811 ></A
812 ></B
813 ></FONT
814 ></TD
815 ><TD
816 WIDTH="25%"
817 BGCOLOR="#00C000"
818 ALIGN="center"
819 ><FONT
820 COLOR="#FFFFFF"
821 SIZE="3"
822 ><B
823 ><A
824 HREF="libnano-x.html"
825 ><FONT
826 COLOR="#FFFFFF"
827 SIZE="3"
828 ><B
829 >Up</B
830 ></FONT
831 ></A
832 ></B
833 ></FONT
834 ></TD
835 ><TD
836 WIDTH="25%"
837 BGCOLOR="#C00000"
838 ALIGN="right"
839 ><A
840 HREF="nano-x-pointer.html"
841 ><FONT
842 COLOR="#FFFFFF"
843 SIZE="3"
844 ><B
845 >Next Page &#62;&#62;&#62;</B
846 ></FONT
847 ></A
848 ></TD
849 ></TR
850 ><TR
851 ><TD
852 COLSPAN="2"
853 ALIGN="left"
854 ><FONT
855 COLOR="#FFFFFF"
856 SIZE="3"
857 ><B
858 >events</B
859 ></FONT
860 ></TD
861 ><TD
862 COLSPAN="2"
863 ALIGN="right"
864 ><FONT
865 COLOR="#FFFFFF"
866 SIZE="3"
867 ><B
868 >pointer</B
869 ></FONT
870 ></TD
871 ></TR
872 ></TABLE
873 ></DIV
874 ></BODY
875 ></HTML
876 >