diff options
| author | Albrecht Schlosser <albrechts.fltk@online.de> | 2022-01-23 01:33:47 +0100 |
|---|---|---|
| committer | Albrecht Schlosser <albrechts.fltk@online.de> | 2022-01-23 18:12:47 +0100 |
| commit | 04ccc8cc46c45b81e6138bec0b48a188c4ffe406 (patch) | |
| tree | 3ad8604f5d433dc6b6c294c28549a58dd57efcbd /README.Pico.txt | |
| parent | b275ff07158e80d1744ddb2f6c51094a87cf079a (diff) | |
Remove experimental platforms Android, Pico, SDL (PR #376)
... as discussed in fltk.coredev: "FLTK 1.4.0 release schedule"
https://groups.google.com/g/fltkcoredev/c/PDbHTRpXVh0/m/JqboexZ_AwAJ
Diffstat (limited to 'README.Pico.txt')
| -rw-r--r-- | README.Pico.txt | 72 |
1 files changed, 0 insertions, 72 deletions
diff --git a/README.Pico.txt b/README.Pico.txt deleted file mode 100644 index a4c836e88..000000000 --- a/README.Pico.txt +++ /dev/null @@ -1,72 +0,0 @@ -This documentation will explain how to quickly port FLTK to a new -platform using the Pico driver system. For now, only the sample -SDL Pico driver on macOS compiles and barely runs. - -> mkdir build -> cd build -> mkdir XcodeSDL -> cd XcodeSDL -> cmake -G Xcode -D OPTION_APPLE_SDL=ON ../.. - -tl;dr - the recent commit should be transparent to all developers on -other platforms. On macOS, the CMake setup adds 'OPTION_APPLE_SDL=ON' -that will run FLTK on top of SDL, which in turn runs on top of the -new "Pico" driver set. - -The greatest help I can get from the core developers is to continue -to refactor the platform specific functionalities into the drivers. - ---- - -OK, long version. I know that I am repeating myself and I don't expect -those of you who "got it" weeks ago to read this again. Writing this -down is also for me to avoid losing track ;-) - -Goal 1: find all the stuff that must still go into drivers -Goal 2: have a base driver for all future porting efforts -Goal 3: make porting fun with early gratification to the coder -Goal 4: extensively document a sample port (SDL), and how to improve it -Goal 5: use SDL as a base library, thereby porting FLTK to iOS and Android - - -This is the start of a new driver, named "Pico". "Pico" is here to -implement what I called the minimal driver. - -"Pico" implements (eventually) a complete set of drivers. The drivers -will be limited in functionality, but they will be good enough to -allow basic UI's with most FLTK widget types. - -If "Pico" compiles without any "USE_PICO" or similar defines, we -have reached goal 1. - -"Pico" will implement all driver functionalities "in good faith", -meaning, in a way that FLTK runs without crashing. Only very very -basic functions are not implemented. A driver that derives from "Pico" -needs only to implement those missing functions, thereby reaching goals -2 and 3. As far as I can tell, those will be: - -- open a single fixed size window -- setting a pixel in a color inside that window -- polling and waiting for PUSH and RELEASE events and their positions - -By implementing these three simple functions in the SDL driver, -"test/hello" and quite a bunch of other tests will run (yes, they -will be slow, but the will work). - -This will give the person who is porting FLTK to their platform a -very early confirmation that their build setup is working and a -very early gratification, reaching goal 3. - -Obviously, SDL is much more powerful, and by the nature of the -virtual functions in the driver system, we can incrementally add -functionality to the SDL driver, and document this incremental -nature, reaching goal 4. - -If we do all this right, we have goal 5. - -If SDL is too big or complex for, say, Android, we can simply start -a new native Android driver set by implementing the three functions -mentioned above, and then go from there. - - -- Matthias |
