diff options
| author | Albrecht Schlosser <albrechts.fltk@online.de> | 2024-07-21 22:34:02 +0200 |
|---|---|---|
| committer | Albrecht Schlosser <albrechts.fltk@online.de> | 2024-07-21 22:34:02 +0200 |
| commit | 7f24a0d6d8d27d6901b1c5d40002769c8bfadf15 (patch) | |
| tree | f09aa13ec794cd7f2efb72c77fce768ccb565697 /documentation/src/drawing.dox | |
| parent | 0291b48a7361bbe18a9b8d96697384d9a50e1dc9 (diff) | |
Update docs and screenshot for fl_line_style() (#1016)
As a follow-up to the discussion I used the posted screenshot demo
(thanks to Greg), redesigned it using Fl_Grid, and added it as a
new test program, including Makefiles and CMakeLists.txt.
New file: test/line_style_docs.cxx to create screenshot. Note that the
old test/line_style.cxx is not obsolete, it can be used to test the
line styles interactively.
Docs have been updated in both chapter "Drawing Things" and the
function description.
Also added the new demo to test/demo.menu under "Images for Manual...".
Diffstat (limited to 'documentation/src/drawing.dox')
| -rw-r--r-- | documentation/src/drawing.dox | 33 |
1 files changed, 17 insertions, 16 deletions
diff --git a/documentation/src/drawing.dox b/documentation/src/drawing.dox index 140d73cee..809f9751b 100644 --- a/documentation/src/drawing.dox +++ b/documentation/src/drawing.dox @@ -433,23 +433,16 @@ Please see the documentation for details. \subsection drawing_lines Line Dashes and Thickness -FLTK supports drawing of lines with different styles and -widths. Full functionality is not available under Windows 95, 98, -and Me due to the reduced drawing functionality these operating -systems provide. +FLTK supports drawing of lines with different styles and widths. -void fl_line_style(int style, int width, char* dashes) + void fl_line_style(int style, int width, char* dashes) -\par -Set how to draw lines (the "pen"). If you change this it is your -responsibility to set it back to the default with -\p fl_line_style(0). + \image html fl_line_style.png "fl_line_style() styles" + \image latex fl_line_style.png "fl_line_style() styles" width=12cm \par -\b Note: -Because of how line styles are implemented on Windows systems, you \e must -set the line style \e after setting the drawing color. If you set the -color after the line style you will lose the line style settings! +Set how to draw lines (the "pen"). If you change this it is your +responsibility to set it back to the default with \p fl_line_style(0). \par \p style is a bitmask which is a bitwise-OR of the following @@ -483,10 +476,18 @@ terminated with a zero-length entry. A \p NULL pointer or a zero-length array results in a solid line. Odd array sizes are not supported and result in undefined behavior. +<!-- \par -\b Note: -The dashes array does not work under Windows 95, 98, or Me, since those -operating systems do not support complex line styles. +\b Notes: +--> +\note +- Full functionality is not available under Windows 95, 98, and Me due to + the reduced drawing functionality these operating systems provide. +- Because of how line styles are implemented on Windows systems, you \e must + set the line style \e after setting the drawing color. If you set the + color after the line style you will lose the line style settings! +- The dashes array does not work under Windows 95, 98, or Me, since those + operating systems do not support complex line styles. \subsection drawing_fast Drawing Fast Shapes |