Free Vision: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		## Contents
2	2
3	3		* 1 Overview
4	4		* 2 To do list
5	5		* 3 Unicode version
6	6		* 4 Turbo Vision
7	7		* 4.1 Turbo Vision code bases
8	8		* 4.1.1 C++
9	9		* 4.1.2 Pascal
10	10		* 5 Problems on macOS
11	11		* 6 Tutorial
12	12
13	13		## Overview
14	14
15	15		Free Vision is an application framework that allows you to design user friendly text mode applications. It is designed to be API-compatible with Borland's Turbo Vision framework.
16	16
17	17		Free Vision implements a full windowing system, where each window can be updated, moved and operated independently from other windows. It is implemented on top of the [[video unit\|video]], [keyboard](</index.php?title=keyboard_unit&action=edit&redlink=1> "keyboard unit \(page does not exist\)") and [mouse](</index.php?title=mouse_unit&action=edit&redlink=1> "mouse unit \(page does not exist\)") units and Free Vision applications can therefore run on most FPC platforms using the _write once, compile anywhere_ principle.
18	18
19	19		The [[Textmode IDE\|Free Pascal IDE]] uses Free Vision for its user interface. [[Textmode IDE development]] lists a simple object chart of IDE + FV objects.
20	20
21	21		Free Vision is not 100% complete:
22	22
23	23		* the colorsel unit is missing, and the support to use it (palette support) might not be complete and/or debugged since the TV->FV transition in +/- 2000.
24	24
25	25		Availability:
26	26
27	27		* Debian Linux: => install the package: [fp-units-fv](<http://packages.debian.org/hu/stable/fp-units-fv>)
28	28		* Other distributions/OSes: Free Vision is included with the FPC source package.
29	29
30	30		## To do list
31	31
32	32		These items were written on a separate page, last edited May 2008:
33	33
34	34		* getting it fully up to speed and compatible with TV
35	35		* endianness and 64-bit clean work.
36	36		* filepaths to ansistring ? TP compat less of a problem nowadays. (copy to separate version if necessary?)
37	37
38	38		## Unicode version
39	39
40	40		Original Turbo Vision stored screen characters in 1-byte cells allowing only single byte code pages to be used (like 437, 866, 1251 etc), also did Free Vision. This is a serious limiting factor for use of Free Vision on modern systems. An [issue about Unicode support](<https://gitlab.com/freepascal.org/fpc/source/-/issues/21373>) presents in FPC bug tracker for a long time.
41	41
42	42		As of February, 2022, adoption of Free Vision to Unicode has been merged into the FPC main branch. This branch has already been tested on Linux and Windows and considered stable at least on these two platforms.
43	43
44	44		It requires FPC 3.1.1 or later, because it uses [[management operators]]. It uses them to store Unicode character cells in the enhanced video unit buffer. Each "character" on the screen is actually a unicode string, because it can contain several unicode code points, e.g. combining characters, etc. Management operators was used to avoid extra overhead of the unicode string (an extra heap block + reference count, etc) when a character cell is only a single unicode code point, which improves performance a lot with commonly used characters, such as ASCII, Cyrillic, etc, while still supporting languages with combining characters.
45	45
46	46		[Instruction](<https://github.com/elfmz/far2l/issues/1255#issuecomment-1042898940>) on how to build Free Vision Unicode test app from sources on recent Ubuntu.
47	47
48	48		Supported features:
49	49
50	50		1\. non-BMP characters
51	51
52	52		2\. East Asian (wide) character support
53	53
54	54		3\. combining characters
55	55
56	56		4\. fallback to legacy non-Unicode KVM drivers for operating systems that don't support Unicode
57	57
58	58		5\. backward compatibility FV units that use legacy codepages. All the unicode-enabled FV units have a 'U' prefix, i.e. 'UDrivers', 'UDialogs', 'UApp', etc. A lot of code sharing between the two sets of units (unicode and legacy) is achieved by using include files and ifdefs.
59	59
60	60		6\. unlimited string length in the new Unicode FV units (they're based on the UnicodeString type, which is UTF-16 and unlimited length). Legacy units still have shortstring limitations in certain places.
61	61
62	62		Things not planned to be implemented for now (maybe later, after merging the branch):
63	63
64	64		1\. bidirectional text & right-to-left language support
65	65
66	66		2\. Arabic shaping
67	67
68	68		Reason: author is entirely unfamiliar with right-to-left languages and also support in consoles is still rare and not very well standardized. However, the gnome-terminal now supports them, and the authors have proposed a [spec](<https://terminal-wg.pages.freedesktop.org/bidi/implementations.html>) for it, which hopefully may be adopted by other terminals also, so it should be possible to implement support for terminals that follow this spec. Any help, from people who know a right-to-left language, or have experience in implementing bidi text support is welcome.
69	69
70	70		Remaining things to be done:
71	71
72	72		1\. Support the new Windows 10 console that supports non-BMP characters
73	73
74	74		2\. Port and test any remaining FV units and controls (most of them are probably ported, but the author might have left some unit out - look for FV units that don't have any Unicode versions with the 'U' prefix)
75	75
76	76		3\. Port and test other platforms, besides Windows and Linux
77	77
78	78		4\. [Port](<https://gitlab.com/freepascal.org/fpc/source/-/issues/40674>) the IDE to the new Unicode FV
79	79
80	80		5\. (not very important) Implement better handling of emoji width (e.g. currently the infamous U+1F4A9 character (💩) is double width, but is currently treated as single width, which results in broken rendering, so these kind of things should be handled properly in the EastAsianWidth unit)
81	81
82	82		## Turbo Vision
83	83
84	84		The Turbo Vision framework originates from Borland, and was delivered with the later incarnations on the Turbo range of compilers. There were two versions, a C++ one, and a Pascal one. The C++ was open sourced (PD) at some point, the Pascal didn't follow, which prompted FPC to search for an alternative.
85	85
86	86		This was found in the shape of Free Vision, which (afaik) was a backport of the PD C++ code back to Pascal by Leon de Boer for use in graphics mode. As far as I can remember, Pierre and Peter backported the code back to textmode (coordinate system change that affected a lot of code!), ported missing parts, improved compatibility, and hooked it into the Textmode IDE. Note that the sf.net TVISION page falsely states that FPC uses Pascal sources donated by Borland, however it seems that nobody reacts to mails there.
87	87
88	88		### Turbo Vision code bases
89	89
90	90		There are currently a handful of Turbo Vision based codebases, all open source ones derived from the C++ version released by Borland.
91	91
92	92		#### C++
93	93
94	94		* The C++ version as released by Borland (Public Domain). Unfortunately after all the mergers of Borland, the FTP server it was on is dead.
95	95		* Possibly non free versions as delivered with Turbo C++ (and Object Vision?).
96	96		* The SF.net C++ version, but it is GPL (a GPL library, which severely hampers usage).
97	97		* Another alternative is an older C++ Turbo Vision version (BSD license) at [this homepage](<http://www.sigala.it/sergio/tvision/>).
98	98		* There is also a modern alternative with support for C++17, UTF-8, etc., at this [GitHub repository](<https://github.com/magiblot/tvision>). This one is MIT licensed.
99	99
100	100		#### Pascal
101	101
102	102		* The commercial versions packaged with Turbo Pascal compilers. These are still not open source in any form.
103	103		* The (AFAIK heavily modified) Borland Pascal 7 version that was used for Virtual Pascal (not open).
104	104		* Free Vision (LGPL license with linking exception). See above for details. Based on the C++ version.
105	105		* Free Vision [adopted for UTF-8](<https://github.com/unxed/fv_utf8>).
106	106		* Free Vision [Unicode adoption branch](<https://gitlab.com/freepascal.org/fpc/source/-/issues/21373#note_833019965>).
107	107
108	108		## Problems on macOS
109	109
110	110		User wrote: Unable to close Free Vision program on macOS, when Alt+X keyboard shortcut is pressed.
111	111
112	112		FPC developer Jonas Maebe replied:
113	113
114	114		Under native macOS programs, by default Option+key ("Option" is the name of the "Alt" key on macOS) is a way to enter a special character; Option/Alt is not mapped to Meta like on most other Unix platforms. If you want to map Option to Meta in Terminal, go to "Preferences -> Profiles -> Keyboard" and tick the "Use Option as Meta key" checkbox at the bottom.
115	115
116	116		## Tutorial
117	117
118	118		German (Deutsches) tutorial to Free Vision: [GitHub repo](<https://github.com/sechshelme/Lazarus-FreeVision-Tutorial>).
119	119
120	120		The documentation of the individual components is available directly in the sources.
121	121
122	122		---
123		-	From the Free Pascal wiki, page "FVISION", as the Internet Archive kept it on 2025-12-20. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).
	123	+	From the Free Pascal wiki, page "FVISION", as the Internet Archive kept it on 2025-12-20, last changed on 2024-08-22. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history