|
21 | 21 | namespace HtmlRenderer |
22 | 22 | { |
23 | 23 | /// <summary> |
24 | | - /// Static class for direct html rendering, intendent for small html fragments.<br/> |
25 | | - /// Prefer using WinForms Html controls: <see cref="HtmlPanel"/> or <see cref="HtmlLabel"/>. |
26 | | - /// For direct non-trivial html rendering consider using <see cref="HtmlContainer"/>. |
| 24 | + /// Standalone static class for simple and direct HTML rendering.<br/> |
| 25 | + /// For WinForms UI prefer using HTML controls: <see cref="HtmlPanel"/> or <see cref="HtmlLabel"/>.<br/> |
| 26 | + /// For low-level control and performance consider using <see cref="HtmlContainer"/>.<br/> |
27 | 27 | /// </summary> |
28 | 28 | /// <remarks> |
29 | | - /// Not suitable for large htmls as each render call will parse the given html string into DOM structure, for large html it |
30 | | - /// can be very expensive.<br/> |
31 | | - /// Consider using <see cref="HtmlContainer"/> for large html or for performance. |
| 29 | + /// <b>GDI vs. GDI+ text rendering</b><br/> |
| 30 | + /// Windows supports two text rendering technologies: GDI and GDI+.<br/> |
| 31 | + /// GDI is older, has better performance and looks better on standard monitors but doesn't support alpha channel for transparency.<br/> |
| 32 | + /// GDI+ is newer, device independent so work better for printers but is slower and looks worse on monitors.<br/> |
| 33 | + /// HtmlRender supports both GDI and GDI+ text rendering to acc |
32 | 34 | /// </remarks> |
33 | 35 | /// <example> |
| 36 | + /// <para> |
| 37 | + /// <b>Simple rendering</b><br/> |
34 | 38 | /// HtmlRender.Render(g, "<![CDATA[<div>Hello <b>World</b></div>]]>");<br/> |
35 | 39 | /// HtmlRender.Render(g, "<![CDATA[<div>Hello <b>World</b></div>]]>", 10, 10, 500, CssData.Parse("body {font-size: 20px}")");<br/> |
| 40 | + /// </para> |
| 41 | + /// <para> |
| 42 | + /// <b>Image rendering</b><br/> |
| 43 | + /// </para> |
36 | 44 | /// </example> |
37 | 45 | public static class HtmlRender |
38 | 46 | { |
39 | 47 | /// <summary> |
40 | 48 | /// Adds a font family to be used in html rendering.<br/> |
41 | | - /// The added font will be used by all rendering function including <see cref="HtmlContainer"/> and all winforms controls. |
| 49 | + /// The added font will be used by all rendering function including <see cref="HtmlContainer"/> and all WinForms controls. |
42 | 50 | /// </summary> |
43 | 51 | /// <remarks> |
44 | 52 | /// The given font family instance must be remain alive while the renderer is in use.<br/> |
|
0 commit comments