Commit Graph

65 Commits

Author SHA1 Message Date
Matthias Melcher
fd791a068e
Separate FLUID user documentation, screen shot automation (#936)
* CMake integration, no autotiools
* alignment panel is now correctly renamed to setting panel
* source view is now correctly renamed to code view
* Merge FLTK FLUID docs into FLUID user manual.
* Add two simple entry tutorials
* Remove FLUID chapter form FLTK docs.
* GitHub action to generate HTML and PDF docs and
  make the available as artefacts
2024-04-17 17:51:32 +02:00
ManoloFLTK
bc5d7e77aa Remove typos in the documentation of fl_x11_use_display() 2023-12-19 19:36:07 +01:00
ManoloFLTK
96bacd3f9d Procedure to instruct FLTK to use given X11 connexion (#149) 2023-12-19 15:48:26 +01:00
ManoloFLTK
f38d1cf424 Documentation: fix outdated statements of quantities being expressed in pixels 2023-12-12 10:08:08 +01:00
ManoloFLTK
fe0298e9e6 Doc: describe fl_disable_wayland in "Operating System Issues" section 2023-11-15 15:58:28 +01:00
ManoloFLTK
d9fa2c6082 Wayland.dox: add info about the xdg decoration protocol
Also, use KWin to name the KDE desktop's Wayland compositor.
2023-07-28 15:27:38 +02:00
ManoloFLTK
caaa11a96f Standardize API to "graphics context" across platforms
Rename fl_wl_cairo() to fl_wl_gc()
Add function cairo_t* fl_cairo_gc() under OPTION_USE_CAIRO
2023-04-13 10:02:40 +02:00
ManoloFLTK
1a8d6662ce osissues.dox: add "The Wayland/X11 hybrid library" 2023-03-21 10:43:53 +01:00
ManoloFLTK
8178d95eb6 Add documentation of 0S-specific fl_mac_gc() 2023-03-20 11:09:58 +01:00
ManoloFLTK
f3e21ddad2 Fix for "Rename Fl_X* Fl_Window::i private class member" (#223) 2023-01-13 21:16:17 +01:00
ManoloFLTK
eb2572deaf Add new Wayland-specific fl_wl_compositor() function 2022-12-09 17:06:35 +01:00
ManoloFLTK
e9719e5416 Update window icon-related doc in platform-specific section. 2022-10-06 15:07:39 +02:00
ManoloFLTK
c720aae515 Make hybrid Wayland/X11 platform. 2022-08-29 12:15:32 +02:00
ManoloFLTK
20c50312fc Cleaner declaration of public function fl_wl_cairo(). 2022-05-09 09:41:50 +02:00
ManoloFLTK
158d39df37 Correct typos in doc. 2022-05-03 08:51:40 +02:00
ManoloFLTK
c1d0783df9 Document how to set window icons under Wayland - cont'd. 2022-04-15 11:05:19 +02:00
ManoloFLTK
5234e1ab38 Document how to set window icons under Wayland. 2022-04-15 10:48:37 +02:00
ManoloFLTK
2d71a95b5d Wayland: replace global fl_display by function struct wl_display *fl_wl_display(). 2022-03-23 11:37:25 +01:00
ManoloFLTK
9d869d73c1 Begin documenting the Wayland platform, new in FLTK version 1.4 2022-03-10 15:05:26 +01:00
ManoloFLTK
638ad499d0 Documentation: discuss HighDPI support under Windows and app manifests. 2021-12-12 15:48:08 +01:00
Albrecht Schlosser
a03ab3b498 Clarify offscreen drawing documentation
... and rename drawing chapters (sections + subsections) according
to our documentation conventions (prefix "drawing_").

documentation/make_pdf: fix copyright year.
2020-11-08 15:43:34 +01:00
Albrecht Schlosser
f09e17c3c5 Remove $Id$ tags, update URL's, and more
- remove obsolete svn '$Id$' tags from all source files
- update .fl files and generated files accordingly
- replace 'http://www.fltk.org' URL's with 'https://...'
- replace bug report URL 'str.php' with 'bugs.php'
- remove trailing whitespace
- fix other whitespace errors flagged by Git
- add and/or fix missing or wrong standard headers
- convert tabs to spaces in all source files

The only relevant code changes are in the fluid/ folder where
some .fl files and other source files were used to generate
the '$Id' headers and footers.
2020-07-06 20:28:20 +02:00
Albrecht Schlosser
09352ddab0 Update documentation, fix typos 2020-03-26 14:21:33 +01:00
ManoloFLTK
89449280dc Doc: more details about initialisation of display scale factors. 2020-03-26 06:29:25 +01:00
Albrecht Schlosser
3f1f871585 Drop 1.0 compatibility; document 1.4 migration
The FLTK 1.0 compatibility support by defining macro 'FLTK_1_0_COMPAT'
did no longer work since FLTK 1.3.x and nobody complained. Hence we
can safely remove this "feature".

Documentation changes:

 - Drop chapter 'Migrating Code from FLTK 1.0 to 1.1'
 - Drop chapter 'Migrating Code from FLTK 1.1 to 1.3'
 - Add  chapter 'Migrating Code from FLTK 1.3 to 1.4'

The removed chapters are still available in FLTK 1.3 docs.
2020-01-08 18:41:50 +01:00
ManoloFLTK
f55729ed32 Doxygen: describe better support for OpenGL on HighDPI displays. 2019-04-12 18:47:42 +02:00
Manolo Gouy
a0863e393a Document that fl_mac_set_about() is deprecated, MacOS-specific and replaced by cross-platform Fl_Sys_Menu_Bar::about().
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.4@12685 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2018-02-22 17:04:37 +00:00
Manolo Gouy
06b925964d Remove Fl::run_also_windowless() and FL::wait_also_windowless() from planned public FLTK 1.4 API.
These were introduced at r12647, that is, during development of the 1.4 API.
These functions provided windowless support only on the MacOS platform,
where this can be obtained without those functions.
Windowless support on other platforms would require changing the event 
loop. There's no evidence from STR's there's a demand for windowless mode
on other platforms.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.4@12680 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2018-02-20 09:08:38 +00:00
Albrecht Schlosser
52ae3582a2 Replace "WIN32" with "_WIN32" or "Windows".
Replace compiler/preprocessor/platform macro "WIN32" with "_WIN32".
Replace "WIN32" in text and documentation with "Windows".
Replace "MSWindows" with "Windows".

To do: README.Windows.txt (and maybe other documentation as well)
needs updates.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.4@12655 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2018-02-09 14:39:42 +00:00
Manolo Gouy
90630409cb Beef up documentation of how FLTK handles cmd-Q/Quit xxx events under MacOS.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.4@12648 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2018-02-06 17:56:47 +00:00
Albrecht Schlosser
cc595ce4ed Replace FL/x.H with FL/platform.H - step 1.
This first step replaces FL/x.H with FL/platform.H but keeps a small
FL/x.H that #include's FL/platform.H for backwards compatibility.
Documentation sources in documentation/src/*.dox have been fixed,
but references in other source files need to be fixed in another step.
Dependencies have been adjusted.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.4@12640 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2018-01-31 17:46:48 +00:00
Manolo Gouy
9c6add4943 Fix typo
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.4@12174 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2017-02-19 15:37:46 +00:00
Manolo Gouy
22af09dae7 Mac OS: support for high resolution OpenGL windows.
Methods Fl::event_x_pixel() and Fl::event_y_pixel() committed at r.10941
are removed. Instead method Fl_Gl_Window::pixels_per_unit() is added.

The documentation explains in more detail how to write cross-platform
FLTK code supporting high resolution OpenGL windows on retina displays.

The examples/OpenGL3test.cxx app exercises Fl_Gl_Window::pixels_per_unit().

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@10945 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2015-12-02 09:59:37 +00:00
Manolo Gouy
1a6790b219 Added documentation about the new support for high resolution OpenGL graphics
on Apple retina displays.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@10503 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2014-12-20 16:52:48 +00:00
Manolo Gouy
84af5805df Removed statement that became incorrect with true Mac OS X subwindows.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@10479 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2014-12-09 11:15:12 +00:00
Greg Ercolano
d892e05d8a Doc mods regarding the OS issue of Ctrl-Click simulation of Right-Click
on Mac OSX, as per recommendations from the forum posts on fltk.coredev
Subject: [RFC] Right click emulation for one button mouse on Mac
where both Manolo and Albrecht suggest documentation mods to reflect the issue.



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@10439 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2014-11-07 19:13:08 +00:00
Pierre Ossman
f7e88141c3 Catch WM_QUIT and convert it to SIGTERM. This gives Windows
applications a convenient way to request termination, rather
than forcing it. And it does so in a way that mimics UNIX's
way, allowing code reuse.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@10030 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2013-12-13 10:26:03 +00:00
Manolo Gouy
cd56917312 Documented in the OS issues section how to add an application icon for the Mac platform.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@9936 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2013-06-21 09:03:15 +00:00
Manolo Gouy
834c714f26 Mac OS: added support for internationalization of the application menu.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@9809 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2013-01-25 16:28:49 +00:00
Manolo Gouy
00ed897277 Documented the fl_open() utility function.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@9704 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2012-10-19 11:23:51 +00:00
Manolo Gouy
406bafecc6 Documented the fl_fopen() utility function.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@9702 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2012-10-19 09:23:05 +00:00
Manolo Gouy
d7a17442fd Added the name of the type of the fl_gc global variable under Mac OS.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@9036 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2011-09-14 15:19:20 +00:00
Greg Ercolano
7d8c00cc09 Backing out r9025; the correct info is at the top of the document
(to use <FL/x.H> instead of define FL_INTERNALS).



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@9028 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2011-09-02 21:01:28 +00:00
Greg Ercolano
e758e6aac2 Mention the need for #define FL_INTERNALS for fl_xid().
(STR #2696, http://fltk.org/newsgroups.php?gfltk.development+v:12524)



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@9025 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2011-09-01 20:14:26 +00:00
Albrecht Schlosser
86e58bc0d8 Fixed "Index" link on documentation pages.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@8651 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2011-05-11 15:49:30 +00:00
Albrecht Schlosser
885c5fe16d Fixed documentation typo.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@8550 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2011-03-31 16:06:59 +00:00
Manolo Gouy
816fc3b971 Mac OS only: added class Fl_Mac_App_Menu to support localization
of the application menu. Added corresponding Doxygen doc.

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@8357 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2011-02-01 21:31:57 +00:00
Albrecht Schlosser
96c410dceb Hiding the Fl_X class under WIN32 (STR #2522).
Applied Manolo's patch, modified to use FL_INTERNALS for
explicit request in user code to expose class Fl_X.
Also changed X11 and Mac OS to use FL_INTERNALS.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@8289 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2011-01-17 23:52:32 +00:00
Manolo Gouy
728b46535b Document that hidden class Fl_X is accessible only if FL_LIBRARY is #define'd.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@8276 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2011-01-13 22:32:38 +00:00
Matthias Melcher
cf95f8d261 Some minor doc changes to avoid doxygen warning.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@8184 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2011-01-04 18:28:01 +00:00