# Pure C Studio 0.1 ? Atari ST / TT / Falcon

Een zelfstandige GEM-ontwikkelomgeving voor C, met dezelfde editorbasis als
TTBasic en TTMicroPython. Dit is een eerste werkende preview, met gescheiden
broncode en een eigen installatie onder `C:\PCSTUDIO`.

Open `C:\PCSTUDIO\PCSTUDIO.PRG`. De bestaande Pure C-installatie blijft
onder
`C:\PUREC`. De compiler en bibliotheken zitten niet in dit pakket.

## Snel proberen

De Studio opent aanvankelijk `HELLO\HELLO.PCP`: twee C-bestanden en een
header.
Druk F9 om te compileren en linken. Druk F5 om te bouwen en uit te voeren.
Na een consoleprogramma druk je een toets om naar Studio terug te keren.

Open via Ctrl+O het project `GEMDEMO\GEMDEMO.PCP` om een echt GEM-programma
te
bouwen. Dit voorbeeld toont een GEM-melding en keert daarna terug naar
Studio.
Via Bestand/File > New project of Ctrl+N maak je een project onder
`C:\PCSTUDIO\PROJECTS`. De voorbeelden mogen als basis worden gekopieerd.

## Bediening

| Toets | Functie |
|---|---|
| Ctrl+O | Project openen (.PCP) |
| Ctrl+N | Nieuw project |
| Ctrl+S / Ctrl+Shift+S | Bestand / alle geopende bestanden opslaan |
| F7 / Ctrl+F7 | Nieuw bronbestand / bestaand bestand toevoegen |
| F3 | Huidig bestand opnieuw laden (vraagt bij wijzigingen) |
| F9 | Alle C-bestanden compileren en project linken |
| F5 / Shift+F5 | Bouwen en uitvoeren / laatste geslaagde build uitvoeren |
| Ctrl+T / Ctrl+L / Ctrl+P | Projectboom / uitvoer / instellingenpaneel |
| Ctrl+Z / Ctrl+Y / Ctrl+Shift+Z | Undo / redo / redo |
| Ctrl+A / C / X / V | Alles selecteren / kopieren / knippen / plakken |
| Shift+pijlen, Shift+Home/End | Tekst selecteren |
| Tab / Shift+Tab | Inspringen / blok terug laten springen |
| Ctrl+F / Ctrl+H / F6 | Zoeken / vervangen / volgende treffer |
| Ctrl+Up/Down | Door de compileruitvoer bladeren |
| F1 / Help | Toetsenhulp |
| Ctrl+Q | Afsluiten, met controle op niet-opgeslagen werk |

Klik een bestand in de projectboom om het te openen. Elk bestand heeft een
werkversie, cursorpositie en eigen undo/redo-geschiedenis. Slepen en
Shift+klik
selecteren tekst. Enter neemt inspringing over en springt extra in na `{`.
C-keywords, strings, preprocessorregels en blokcommentaar krijgen kleuren.
Op een monochroom scherm blijven tekst en selectie duidelijk zichtbaar.

Zoeken/vervangen werkt op het huidige bestand, met letterlijke tekst en een
optionele hoofdlettercontrole. Replace All is een undo-stap. Het klembord is
intern aan Studio. Maximaal64 stappen per bestand, samen maximaal256KiB.
Geschiedenis blijft bewaard na Save en wordt gewist bij
projectwissel/Reload.

## Bouwen en foutmeldingen

Project > Compiler settings bevat de paden voor PCC.TTP, PLINK.TTP, de
include-map, library-map en extra compileropties. Project > Project settings
bevat de projectnaam, het absolute uitvoerpad en TOS/GEM als doeltype.
De instellingen worden in het .PCP-bestand opgeslagen.

F9 slaat gewijzigde bronbestanden op en bouwt steeds alle `.C`-projectleden.
Headers worden niet afzonderlijk gecompileerd. Studio maakt `PCBUILD.LNK`,
start PCC per bestand en daarna PLINK en toont de uitvoer onder de editor.
De complete uitvoer staat in PCBUILD.LOG; PCTOOL.LOG bevat de laatste
toolaanroep. Het paneel bewaart maximaal160 regels en toont korte
bestandsnamen.
Fouten stoppen de build; waarschuwingen worden getoond. De eerste bronfout
wordt geopend, en een klik op een foutregel opent het bijbehorende bestand.
De compiler geeft gewoonlijk een regelnummer; alleen als een fout ook een
kolomnummer bevat kan Studio die kolom direct aanwijzen.

F5 bouwt opnieuw voor het uitvoeren. Shift+F5 vereist een geslaagde build in
de huidige sessie. Consoleprogramma's gebruiken het volledige scherm; een
GEM-programma kan zelf vensters of dialoogvensters openen. Tijdens
compileren
en linken wacht Studio op de tool. Er is nog geen build-annuleerfunctie.

## Projectformaat

Dit eigen tekstformaat gebruikt `.PCP`; het is geen Pure C `.PRJ`-importer.
Relatieve FILE- en OUTPUT-paden worden vanuit de projectmap opgelost.
Bijvoorbeeld:

```ini
PUREC_STUDIO 1
NAME=Mijn C-project
OUTPUT=MAIN.TOS
TYPE=TOS
FILE=MAIN.C
FILE=UTIL.C
FILE=UTIL.H
```

Optionele velden: COMPILER, LINKER, INCLUDE, LIBDIR, FLAGS en maximaal8 LIB-
regels. Standaardpaden zijn `C:\PUREC`, FLAGS is `-P`. Extra LIB-paden
worden
vanuit LIBDIR opgelost. Bij GEM wordt PCGEMLIB automatisch gelinkt. PCSTART,
PCFLTLIB, PCSTDLIB en PCTOSLIB worden automatisch gebruikt.

## Grenzen van deze preview

- Minimaal640x400 en4MiB RAM; getest met echte Pure C-tools in Hatari.
  ST High, TT Medium en Falcon VGA passen binnen deze schermgrens.
- Maximaal8 projectbestanden, elk512 regels van maximaal159 tekens. Te grote
  bronnen worden geweigerd en niet stilzwijgend afgekapt. Tabs worden in de
  editor naar4-spatieposities uitgebreid.
- Atari8.3-bestandsnamen en paden zonder spaties voor de compiler. De TOS-
  commandoregel is maximaal126 bytes; te lange opdrachten worden gemeld.
- Bronbestanden worden als Atari-tekst met CRLF opgeslagen. Bewaar bij
externe
  C-bestanden ook headers met CRLF; de Pure C-preprocessor verwacht die
vorm.
  Open zo nodig een header en druk Ctrl+S om de regelafbrekingen te
normaliseren.
- Opslaan gebruikt een tijdelijk bestand en bewaart de vorige versie als
  bijvoorbeeld MAIN.CBK, UTIL.HBK of PROJECT.PBK. Eigen bronbestanden worden
  niet verwijderd als je ze uit het project haalt.
- Geen broncodedebugger, breakpoints, autocomplete, RSC-resource-editor,
  incrementele make of automatische import van bestaande .PRJ-bestanden.
- Geen FPU vereist voor Studio of de standaardvoorbeelden. Een eigen
programma
  kan natuurlijk specifieke processor- of bibliotheekinstellingen vereisen.
- De bestaande preview is op fysieke hardware getest; de nieuwe
formulierontwerper voorlopig alleen in Hatari. De preview vervangt Pure C
PC.PRG niet.

## Bronnen en bouwen

`src/PCORE.C` beheert projecten, bestanden, linker-invoer, diagnostiek en C-
kleuring. `src/STUDIO.C` bevat de GEM-vensters, editor en toolaanroepen.
EDITCORE.H en EDITUI.H komen uit de gedeelde editorbasis in `../editor`.
De bronbomen van BASIC, Python en C blijven afzonderlijk.

Vanaf de Mac-workspace: `python3 purec-studio/tools/build.py`. Dit gebruikt
Pure C op een aparte Hatari-buildschijf. `sh purec-studio/tools/test.sh`
test
de portable code met ASan/UBSan. `tools/check_gui.py` test de echte Studio
en
compiler in Hatari; geef `st` mee voor ST High met4MiB.

Licentie: GPLv3, zie LICENSE. Pure C en de Atari-ROMs worden niet
meegeleverd.

Je kunt ook vanuit de oorspronkelijke Pure C IDE bouwen: kopieer de
bestanden
uit src/ plus atari/PCSTUDIO.PRJ naar een eigen bouwmap en open dat .PRJ-
bestand.
De source-ZIP bevat ook een map ATARI-SOURCES met alle C-bronnen/headers en
projectbestanden al in CRLF, gereed om naar een Atari-bouwmap te kopieren.
BUILD.LNK gebruikt voor de
commandoregelbouw vaste paden onder C:\PCSTUDIO en een stack van64KiB.

## Visuele formulieren ? 16 november 2026

File > New Form project maakt een zelfstandig GEM-project. Ctrl+D/F8 of
View > Form designer opent de gedeelde visuele ontwerper. Zeven
controlsoorten,
plaatsen/slepen/vergroten, eigenschappen en eventcode; F4 opent een handler,
F2 past toe en slaat op, F5 bouwt en draait. Het voorbeeld FORMS/FORMS.PCP
toont alle controls. FORMRT.H wordt naast de bron gekopieerd en gebruikt
alleen
Pure C en de standaard GEM/TOS-libraries. De eigen eventcode blijft
behouden.
Zie [bediening en grenzen](../shared/forms/README.md). De actuele previewset
staat in `../dist/2026-11-16-forms/`; fysieke hardware is voor deze
toevoeging
nog niet opnieuw getest.
