KolibriOS & Euphoria

Как запустить Euphoria в среде операционной системы Kolibri.

  Если на вашей машине не установлена операционная система Колибри,
  получите предпочтительную для вас текущую версию системы здесь:
  русская версия
  http://www.kolibrios.org/files/download/last/kolibri_ru.zip
  английская версия
  http://www.kolibrios.org/distro/last/kolibri_en.zip

  Распакуйте полученный zip-файл в отдельном каталоге вашего жесткого диска.
  У меня это каталог F:\-temp-\kolibri.en. После распаковки в этом каталоге
  вы увидите ряд файлов. Важными для работы являются файлы install.bat
  и kolibri.img. Первый - это пакетная программа, запускающая установку
  операционной системы Колибри на дискету, второй - это образ операционной
  системы, которая будет на эту дискету перенесена, включая загрузочный
  сектор дискеты и загрузчик ОС. См. рис.1.
  ОС Колибри полностью помещается на одной дискете.
  
  
  Рис.1. Файлы install.bat (подсвечен), и kolibri.img.
    
  Теперь вставьте в дисковод A: чистую дискету объемом 1.44M и запустите
  программу install.bat. В среде Windows FAR это делается нажатием на
  клавишу Enter на имени программы. См. рис.2.
  
  
  Рис.2. Программа install.bat запущена, установщик вывел свое первое сообщение.
  
  Когда программа установки операционной системы на дискету отработает,
  ее финальное сообщение будет выглядеть, как это показано на рис.3. 
  
  
  Рис.3. Программа установки завершила работу. 
  
  На дискете появился полный набор файлов операционной системы и прикладных
  программ, поставляемых в ее составе. См. рис.4.
  
  
  Рис.4. Файлы ОС Колибри на дискете. Загрузчик операционной системы
  копирует эти файлы с дискеты на небольшой служебный виртуальный диск (RAM-диск),
  организуемый в оперативной памяти машины.
  
  Эта дискета уже вполне готова для того, чтобы с нее запустить
  ОС Колибри при перезагрузке компьтера без участия жесткого диска.
  Однако чтение ОС с дискеты занимает довольно длительное время, что
  не вполне удобно. Поэтому более предпочтительна комбинированная загрузка,
  когда с дискеты считывается только загрузочный сектор и загрузчик,
  а все остальное чтение производится загрузчиком из файла образа системы,
  расположенного в корневом каталоге на диске C: вашей машины.
  Для организации этой комбинированной загрузки просто скопируйте
  файл kolibri.img в корневой каталог диска C:, как это показано
  на рисунках 5, 6 и 7.
  
    
  Рис.5. Готовность к копированию файла образа в корневой каталог диска C:.
  На диске С: видны также установленные файлы образа предыдущих версий,
  переименованные во избежание их перезаписи новой версией.
  
  
  Рис.6. Выдана команда копирования (F5).
  
  
  Рис.7. Копирование завершено, компьютер готов к комбинированной
  (флоппи-диск + жесткий диск) загрузке ОС Колибри.
  В корневом каталоге диска C: видны также файлы dosbox и
  dosbox.conf. Это специальная, перекомпилированная для платформы
  Колибри, версия системы DOSBox, в среде которой будет исполняться
  DOS32 Euphoria.
  
  Чтобы теперь запустить ОС Колибри, необходимо выйти из Windows,
  войти в меню BIOS Setup, выбрать там загрузку с флоппи-диска,
  и перейти к собственно загрузке (дискета у нас оставалась в дисководе).
  BIOS считывает с дискеты загрузочный сектор, далее программу загрузчика,
  а эта программа выводит на экран настроечное меню Колибри, см. рис.8.

  
  Рис.8. Настроечное меню Колибри.
  
  Настроечное меню Колибри позволяет вам выбрать режим работы вашей
  видеоподсистемы (нажатие клавиши [a] открывает пункты подменю),
  режим работы с жестким диском через DMA (клавиша [b]), режим
  работы монитора со специальными установками частоты вертикальной
  развертки (клавиша [c]), и режим дальнейшей работы с образом
  ОС - непосредственно с дискеты или из файла kolibri.img,
  расположенного в корневом каталоге диска C: (клавиша [d]).
  На своей машине я устанавливаю настройки следующим образом:
  [a]  VESA 1.2 1024x768 Bnk
  [b]  off
  [c]  off
  [d]  C:\kolibri.img
  Рекомендую начать именно с таких параметров и вам, если
  ваш монитор поддерживает разрешение 1024x768. Ведь если
  ваша видеоподсистема выполнена по стандарту VESA 3.0, то
  выбор такого ненапряженного режима обеспечит запуск не
  с черным экраном. В противном случае вам прийдется вслепую
  перезапускать вашу машину, отключая питание.
  Конечно, для первых пусков можно выбрать и просто
  стандартные VGA или даже EGA режимы, переходя затем
  к более современным видеорежимам.
    
  Будем считать, что вы уже уверенно запускаете ОС Колибри
  на вашей машине.
  
  Рассмотрим теперь запуск и настройку системы DOSBox.
  
  Эта система не входит в стандартную комплектацию ОС Колибри,
  и пока ОС Колибри не обеспечивает работу в сети Интернет, вам
  прийдется вернуться в Windows, чтобы получить DOSBox здесь:
  
  DOSBox для ОС Колибри
  http://diamondz.land.ru/dosbox.7z
  
  Чтобы распаковать файл dosbox.7z, вам потребуется архиватор
  7-zip:
  
  Архиватор 7-zip
  http://belnet.dl.sourceforge.net/sourceforge/sevenzip/7z442.exe
  http://sourceforge.net/project/downloading.php?groupname=sevenzip&filename=7z442.exe&use_mirror=heanet
  
  Это установщик стабильной версии для Windows.
  Установите 7-zip на свою машину, запустив установщик.
  7-zip - один из наиболее эффективных архиваторов нового
  поколения, он вам пригодится для работы с Колибри, так
  как разработчики Колибри среди своих архивов предлагают
  на выбор архивы и zip, и 7-zip. 
  Распаковав файл dosbox.7z в отдельный каталог, скопируйте
  файлы dosbox и dosbox.conf в корневой каталог диска C:,
  как это уже было видно на рис.7.
  
  Файл dosbox.conf, наряду с заданием конфигурационных
  параметров этого эмулятора DOS, играет и роль файла
  autoexec.bat, который исполняется после старта DOSBox
  и конфигурирует уже эмулируемую DOS.
  На рис.9 показан файл dosbox.conf в процессе его
  редактирования мною во встроенном редакторе менеджера
  FAR.
  
  
  Рис.9. Файл dosbox.conf, последняя секция, исполняющая
  также и роль файла autoexec.bat обычной DOS.
  
  В стандартном файле dosbox.conf мною добавлены строки:
     
  mount c /hd0/1          
  -- монтирование диска /hd0/1 (это первый раздел нулевого физического
  -- диска в терминологии Колибри, под Windows у меня это диск C:)
  -- как диска C: в системе DOSBox
  mount e /hd0/2
  -- монтирование диска /hd0/2 (это второй раздел нулевого физического
  -- диска в терминологии Колибри, под Windows у меня это диск E:)
  -- как диска E: в системе DOSBox
  mount f /hd0/3
  -- монтирование диска /hd0/3 (это третий раздел нулевого физического
  -- диска в терминологии Колибри, под Windows у меня это диск F:)
  -- как диска F: в системе DOSBox
  set EUDIR=c:\euphoria
  -- на диске C: у меня находится каталог euphoria,
  -- эта команда устанавливает стандартную переменную окружения
  -- EUDIR на данный каталог для смонтированного в DOSBox
  -- диска C: Windows
  set PATH=c:\euphoria\bin
  -- аналогичная установка для переменной окружения PATH
  set EUINC=c:\euphoria\incl\ru;c:\euphoria\incl\ed
  -- аналогичная установка для переменной окружения EUINC
  c:
  -- при запуске DOSBox его текущим каталогом является
  -- корневой каталог его служебного диска Z:, данной
  -- командой мы переходим на наш смонтированный диск C: 
  c:\dbr\nc
  -- в каталоге c:\dbr у меня имеется копия системы
  -- Norton Commander v.6.0, я запускаю ее для дальнейшей
  -- работы с ней в среде DOSBox'а.
  
  Конечно, файл dosbox.conf можно никак не модифицировать, а все эти
  перечисленные выше команды выполнять вручную из строки приглашения
  DOSBox после его запуска в среде Колибри.
  
  Итак, запускаем операционную систему Колибри, ее рабочий стол вы
  уже видели в самом начале этого документа.
  Запускаем файловый менеджер kFAR Колибри, см. рис.10.
  
  Рис.10. Работает KFAR, мы находимся в корневом каталоге RAM-диска
  Переходим на диск /hd0/1  -  это диск C: Windows, см. рис.11.
  
  Рис.11. Работает KFAR, мы находимся в корневом каталоге диска hd0/1 (C:).
  Находим здесь файл dosbox - это программа  в исполняемом формате Колибри.
  Нажимаем на этом файле клавишу Enter, запуская DOSBox в среде
  Колибри, который, в свою очередь, запускает Nornon Commander, см.рис.12.
  
  Рис.12. Norton Commander исполняется в среде DOSBox на платформе
  Колибри, на моем диске C: установлены различные версии Euphoria.

  Теперь мы имеем полноценную среду старой доброй DOS под управлением
  Колибри и можем работать в ней с DOS32 Euphoria, которая была у нас
  когда-то раньше установлена под Windows на дисках Windows.
  
  Переход к дальнейшим иллюстрациям.
  

How to launch Euphoria in Kolibri OS environment.

  If you do not have the Kolibri OS installed on your machine,
  get please a prefered to you current version of that system here:
  English version
  http://www.kolibrios.org/distro/last/kolibri_en.zip
  Russian version
  http://www.kolibrios.org/files/download/last/kolibri_ru.zip

  Unzip the downloaded zip-file in some separate directory of your hard disk.
  My directory is F:\-temp-\kolibri.en. After unzipping you'll see a few
  files in your dedicated directory. The important for installation files
  are the install.bat and kolibri.img files. The first one is a batch program
  that launch the installation of Kolibri OS to floppy-disk, the second one
  is the image of the operating system, which will be installed to that
  floppy-disk, including the boot sector and the loader of OS. See Fig.1.
  
  To hold Kolibri OS you need just one floppy-disk.
  
  
  Fig.1. The install.bat (highlighted) and kolibri.img files.
  (I use the FAR file manager).
    
  Then put a clean 1.44Mb floppy-disk into A: drive and run the
  install.bat program. In Windows FAR environment, just press the
  Enter key on the name of that program. See Fig.2.
  
  
  Fig.2. The install.bat program is running, installer outputs its
  first message.
  
  After installation is finished you'll see the final message
  of that program, as it is shown on Fig.3.
  
  
  Fig.3. Installation on floppy-disk is finished. 
  
  The full set of operation system files and the application programs,
  which come along with that OS, appeared on your floppy-disk. See Fig.4.
  
  
  Fig.4. The Kolibri OS files on floppy-disk. The loader of OS copies these
  files to small virual service disk (RAM-disk), created in RAM of your
  machine.
  
  This floppy-disk is ready to run the Kolibri OS from it after
  rebooting of your machine without participation of the hard disk.
  But reading of OS from the floppy-disk takes some long time, so
  you'll prefer the combined loading, when floppy-disk serves just
  to run the loader and all remaining reading is done directly from
  the image file by that loader. The image file must be in the root
  directory of drive C: of your machine. To organize that combined
  loading just copy the kolibri.img file to disk C: as it is shown
  on Fig. 5,6 and 7.
  на рисунках 5, 6 и 7.
  
    
  Fig.5. We are ready to copy the image file to root of disk C:.
  You can see the image files of previous versions, renamed to
  avoid the name conflicts.
  
  
  Fig.6. The copy command is issued (F5).
  
  
  Fig.7. Copying is finished, the computer is ready for combined
  (floppy disk  +  hard disk) loading of Kolibri OS.
  You can see the dosbox and dosbox.conf files in root of my disk
  C:. This is a special, recompiled for the Kolibri platform,
  version of the DOSBox system, in which environment we will
  run DOS32 Euphoria.
  
  To run now the Kolibri OS, you'll need exit Windows, enter
  menu of BIOS Setup, choose the booting from floppy-disk,
  and go to loading itself (you already have the floppy in A: drive).
  BIOS reads the boot sector from floppy-disk, then reads and
  runs the loader program and this loader program outputs to
  screen for you the setup menu of Kolibri OS, see Fig.8.

  
  Fig.8. The setup menu of Kolibri OS.
  
  The setup allows you to choose the mode of your videocard
  (pressing of [a] key shows the items of submenu),
  mode of DMA for your hard disk ([b] key), mode of your monitor
  with the special settings of vertical frequency ([c] key),
  and mode of the next loading itself - from floppy-disk or
  from the image file kolibri.img, which you already have
  in root directory of disk C: ([d] key).
  I use the following settings on my machine:
  [a]  VESA 1.2 1024x768 Bnk
  [b]  off
  [c]  off
  [d]  C:\kolibri.img
  
  I recommend to you to begin same as me from these modes, if your
  video system supports 1024x768 resolutin, naturally. Even your
  system can work on VESA 3.0 standard, those above modes are
  something not very hard and you will not get the black screen
  anyway. In opposite cases you'll need to restart your machine
  blindfold, sometimes even switching it off.
  Sure, for the first starts you can choose just the standard
  VGA or even EGA modes, going then to more modern video modes.
    
  Let's count that you launch the Kolibri OS quite surely
  on your machine.
  
  To run Euphoria on Kolibri OS you will need the DOSBox system.
  
  This system doesn't come within the standard package of Kolibri OS,
  and for now, while Kolibri OS doesn't give you the rich Internet
  access, you'll need to return to Windows and get DOSBox here:
  
  DOSBox for Kolibri OS
  http://diamondz.land.ru/dosbox.7z
  
  To unpack the dosbox.7z file, you'll need the 7-zip archiver:
  
  The 7-zip archiver
  http://belnet.dl.sourceforge.net/sourceforge/sevenzip/7z442.exe
  http://sourceforge.net/project/downloading.php?groupname=sevenzip&filename=7z442.exe&use_mirror=heanet
  
  It is the stable version of installer for Windows.
  Set up 7-zip on your machine using that installer.
  7-zip is one of the most effective new generation archivers,
  it will be useful for your work with Kolibri OS - there are
  the 7-zip versions of Kolibri packages on their site.
  
  Unpack the dosbox.7z file in separate directory, then copy
  the dosbox and dosbox.conf files to root directory of disk C:,
  as you could see already on Fig.7.
  
  The dosbox.conf file sets up the configuration parameters
  of DOS emulation, but it has also the very important role
  of the autoexec.bat file, which runs after start of DOSBox
  and configure the emulating DOS.
  On Fig.9, you can see the dosbox.conf file in process of
  editting it by me in built in editor of FAR manager. 
  
  
  Fig.9. The dosbox.conf file, last section, its role of
  the autoexec.bat file of usual DOS.
  
  I've added the foolowing strings into standard dosbox.conf:
     
  mount c /hd0/1          
  -- mounting of disk /hd0/1 (it is the first partition of zero
  -- physical disk in terms of Kolibri, on Windows it is my disk C:)
  -- as disk C: in DOSBox system
  mount e /hd0/2
  -- mounting of disk /hd0/2 (it is the second partition of zero
  -- physical disk in terms of Kolibri, on Windows it is my disk E:)
  -- as disk E: in DOSBox system
  mount f /hd0/3
  -- mounting of disk /hd0/3 (it is the third partition of zero
  -- physical disk in terms of Kolibri, on Windows it is my disk F:)
  -- as disk F: in DOSBox system
  set EUDIR=c:\euphoria
  -- I have the euphoria directory on my disk C:, this command sets
  -- the standard environment variable EUDIR onto this directory
  -- for the mounted in DOSBox disk C: of Windows 
  set PATH=c:\euphoria\bin
  -- same setting for the environment variable PATH 
  set EUINC=c:\euphoria\incl\ru;c:\euphoria\incl\ed
  -- same setting for the environment variable EUINC
  c:
  -- when DOSBox starts, its current directory is root
  -- of its service virtual disk Z:, so we go to our
  -- mounted disk C: 
  c:\dbr\nc
  -- I have a copy of the Norton Commander v.6.0 file manager
  -- in c:\dbr directory, so I run it to work with it under
  -- DOSBox control.
  
  Sure, you can to not change dosbox.conf in any way, and all these
  above commands just to issue by hands from the command line of
  DOSBox after its start in the Kolibri environment.
  
  Well, let's go.
  Run Kolibri OS, its desktop you could see on very top of this
  file.
  Run Kolibri FAR, KFAR, see Fig.10.
  
  Fig.10. KFAR runs, we are in root of RAM disk. 
  Go to disk /hd0/1  -  this is disk C: of Windows, see Fig.11.
  
  Fig.11. KFAR runs, we are in root of hd0/1 (C:) disk. 
  Find in root directory the dosbox file - it is a Kolibri
  executable.
  Press the Enter key on that dosbox, dosbox starts under
  Kolibri control and runs Norton Commander, see Fig.12.
  
  Fig.12. The Norton Commander running, there are the different
  versions of Euphoria on my disk C:.
  Now we have old good DOS environment on Kolibri platform
  and can work here with DOS32 Euphoria, which we had set up
  under Windows on disk of Windows.
  
  See please the screenshots of my machine below.
  
  Good Luck with your machine, Kolibri and Euphoria!
  
Иллюстрации, Illustrations

Fig.13. It is my catalog of bilingual Euphoria 2.5.
Рис.13. Это мой саталог двуязычной Euphoria 2.5.

Fig.14. The official 2.5 interpreter crashes on Kolibri DOSBox.
Рис.14. Официальная версия 2.5 интерпретатора здесь не работает.

Fig.15. Let's try the bilingual interpreter 2.5...
Рис.15. Давайте попробуем двуязычный интерпретатор 2.5...

Fig.16. It works in Russian mode...
Рис.16. Он работает в русском режиме...

Fig.17. It works in Russian mode... and in English mode too.
Рис.17. Он работает в русском режиме... и в английском тоже.

Fig.18. Let's try the new official version, 3.1.1.
Рис.18. Давайте попробуем новую официальную версию, 3.1.1.

Fig.19. It works OK! All tests below were with the official 3.1.1.
Рис.19. Она работает! Все последующие тесты были с официальной 3.1.1.

Fig.20. The mouse bug!
Рис.20. Ошибка мыши!

Fig.21. The "Hello World!" program (with syntax error).
Рис.21. Программа "Hello World!" (с синтаксической ошибкой).

Fig.22. The error message of "Hello World!" program about syntax error.
Рис.22. Сообщение о синтаксической ошибке программы "Hello World!".

Fig.23. The syntax error corrected, normal output.
Рис.23. Синтаксическая ошибка истправлена, нормальный вывод.

Fig.24. The Euphoria sanity test.
Рис.24. Тест исправности Euphoria.

Fig.25. The multitasking works.
Рис.25. Работает многозадачность.

Fig.26. The program using multitasking finished.
Рис.26. Завершена программа, использующая многозадачность.

Fig.27. E program.
Рис.27. Программа E.

Fig.28. E program.
Рис.28. Программа E.


Fig.29. Polygons.
Рис.29. Полигоны.


Fig.30. Screensaver.
Рис.30. Заставка.


Fig.31. 3-D plotting.
Рис.31. 3-х мерный рисунок.


Fig.32. Fractals.
Рис.32. Фракталы.


Fig.33. Kfm file manager.
Рис.33. Файловый менеджер Kfm.


Fig.34. TTFonts by Colin Taylor.
Рис.34. Шрифты TTF Колина Тэйлора.


Fig.35. The Language War game.
Рис.35. Игра Language War.

  
  Good Luck!
  Удачи!
  
  -- 15.10.2007   ---   kinz@peterlink.ru
   
Some Kolibri / Menuet links

01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
-------------------------------------------------------------------------------