Schreibfehler, andere offensichtliche Fehler in der PB-Hilfe

[Nino]

Hinweis: Dies kann in einigen seltenen Fällen zu "unerwarteten" Ergebnissen führen, wenn die Zuweisung ("assignement") vor der Neigung ("affection") modifiziert wird.

Diese Passage ergibt keinen Sinn, u.a. weil das englische Wort "affection" Zuneigung, Liebe, Zärtlichkeit, Gunst bedeutet und in diesen Zusammenhang so gar nicht hineinpasst. Der entspr. Text in der englischen Hilfe ist genau so falsch.

(Für eine "offizielle" Information sollte Fred auf Französisch gefragt werden, da sein Englisch nicht gut ist -- oder Freak auf Deutsch bzw. Englisch. Allerdings weiß man als PureBasic-Programmierer ja, wie diese Operatoren-Kurzform funktioniert, so dass man es nur richtig zu formulieren braucht.)

Hinweis: Dies kann in speziellen Fällen zu unerwarteten Ergebnissen führen, wenn sich der Wert einer Variablen schon vor der expliziten Zuweisung ändert.

[Nino]

Variablen Definition

Um eine Variable in PureBasic zu definieren, geben Sie ihren Namen ein oder den Typ, den die Variable annehmen soll. Standardmäßig, wenn kein Typ angegeben wird, wird der Datentyp ein Integer sein. Variablen müssen nicht ausdrücklich deklariert werden, sie können auch als Variablen "on-the-fly" benutzt werden. Das Define Schlüsselwort kann benutzt werden, um eine ganze Reihe von Variablen zu definieren. Wenn Sie der Variable keinen Anfangswert zuweisen, wird ihr Wert 0 sein.

• In der Überschrift fehlt ein Bindestrich.
• Man kann nicht den Namen oder den Typ einer Variablen angeben. Den Namen muss man in jedem Fall immer angeben, nur die Angabe des Typs ist optional.
• Variablen [...] können [...] als Variablen [...] benutzt werden. Das muss wohl nicht extra geschrieben werden.
• Nur numerische Variablen denen kein Anfangswert zugewiesen wurde, haben den Wert 0. String-Variablen hingegen haben in dem Fall den Wert "".

Mein Vorschlag:

Variablen-Definition

Um eine Variable in PureBasic zu definieren, geben Sie ihren Namen ein und optional auch den Typ, den die Variable annehmen soll. Standardmäßig, wenn kein Typ angegeben wird, wird der Datentyp ein Integer sein. Variablen müssen nicht ausdrücklich deklariert werden, sie können auch "on-the-fly" benutzt werden. Das Define Schlüsselwort kann benutzt werden, um eine ganze Reihe von Variablen zu definieren. Wenn Sie einer numerischen Variablen keinen Anfangswert zuweisen, wird ihr Wert 0 sein; bei einer String-Variablen ist es der Wert "".

[jacdelad]

Der Abschnitt über die die Dialog-Library ist zum Teil falsch übersetzt worden und außerdem in meinen Augen ungünstig aufgebaut bzw. fehlen entscheidende Informationen. Aber der Reihe nach:

Die ganze Syntax wird beim Befehl "OpenXMLDialog" erklärt. Das finde ich unpassend, es sollte dafür einen eigenen Abschnitt geben.

Das Folgende bezieht sich auf die Syntaxerklärung in "OpenXMLDialog".
- Es wurde ein bisschen zu viel übersetzt: Bei den Gadget "option" bzw. "spin" wurden die englischen Schlüsselwörter übersetzt ("group" wurde zu "Gruppe" und "value" wurde zu "Wert"). Natürlich funktionieren die nicht auf deutsch. Bei "scrollarea" wurde das Schlüsselwort korrekt nicht übersetzt.
- Es wird nicht explizit erwähnt, dass im Tag "id" keine Variablen angegeben werden können. Das empfinde ich als ungünstig (aber es kann auch sein, dass ich mich da einfach schwer tu). Im Endeffekt kann dort eine Konstante oder eben #PB_Any angegeben werden; sprich alles was für den ersten Paramater bei jeder Gadgeterstellung auch geht.

Unabhängig von der Hilfe fänd ich eine Erweiterung der Bibliothek gut (das hatte ich schon mal im englischen Forum angesprochen): Checkboxen/OptionGadgets standardmäßig anhaken, "font" als tag...

Es kommt mir ein bisschen so vor, als wäre diese Bibliothek ein Stiefkind, was keiner nutzt. Das theoretische Potenzial ist dabei eigentlich enorm.

[HeX0R]

Dass es alles in OpenXMLDialog() versteckt ist, finde ich jetzt nicht so schlimm, hat man es einmal gefunden, weiss man es.
Aber Deine anderen Punkte sind richtig, außerdem:

• Es steht nirgends, dass die group beim Optiongadget nur numerische Werte enthalten darf (bin daran selbst mal verzweifelt)
• Das margin Attribut kann noch bei sehr viel mehr Containern benutzt werden als die Hilfe suggeriert (Windows z.B. auch, sehr nützlich)
• Das "item" Attribut, das beim Tree steht habe ich noch nie erfolgreich einbauen können.

#PB_Any bei den id's kannst Du übrigens auch weglassen.
Die XML steht ja für sich, also kannst Du als ID dort keine (Runtime!) Variable angeben.
Runtime Konstanten aber schon.
Wenn Du es flexibler haben möchtest, nimm die name-Attribute und lass id weg.
Nur so kannst Du auch ein und dasselbe Dialogfenster z.B. mehrmals öffnen, ids müssen über alle Dialogelemente einmalig sein, die name-Attribute sind fensterabhängig.

[jacdelad]

Umlaute werden in der Hilfe von 6.01 nicht richtig dargestellt, ist das bei euch auch so?

[Macros]

Hier funktioniert es.

Systeme: Windows 10 22H2 und Kubuntu Linux.

[Diogenes]

Die Umstellung der Standard-Bibliothek von directx11 auf opengl sollte wesentlich deutlicher kommuniziert werden.
Die Unterschiede sollten in der Hilfe herausgearbeitet werden. Ich hatte am Anfang sehr große Probleme,
die ich mir nicht erklären konnte. Ich hatte dazu einen Thread in den Anfängerfragen eröffnet.
Erst dort hat man mir dankenswerterweise mitgeteilt, daß die Standardbibliothek umgestellt worden ist.
Ich kann mittlerweile damit umgehen, bzw es durch Trial and Error herausknobeln oder im Zweifel auf directx11 zurückgehen.

Welche Unterschiede aber genau bestehen, verstehe ich noch nicht.
Insbesondere die unterschiedliche Handhabung der Videobuffer =>FlipBuffers()
Die Hilfescripts sind auf directx11 ausgerichtet, so daß sie u.U unter opengl nicht funktionieren.
Zum Beispiel die Hilfe zu => KeyboardPushed(KeyID) unter opengl blitzt das Fenster nur kurz auf um dann zu verschwinden.
der Compiler meldet dann, die Programmausführung sei abgeschlossen.
Erst nach Umstellung auf directx11 passiert das, was die Routine bezweckt.
viele Grüße

Nachtrag: im Hilfe-Beitrag zu Pure Basic - Keyboard steht: "Es wird die DirectX Technologie benutzt." Bedeutet das, dass
alles was mit Examinekeyboard() zusammenhängt anders gehandhabt werden muss.
Nach einem ersten Test scheint Examinekeyboard() weiter zu funktionieren.

[TheCube]

Von mir keine Fehler, eher Ergänzungen:

CreatePack() und CompressMemory() :
Defaultwert bei Nichtangabe des optionalen Level-Parameter der PB-Hilfe hinzufügen. (Rein experimentell habe ich Default-Level 6 ermittelt ...)

OpenSerialPort() :

Bauds: Bestimmt die Geschwindigkeit der seriellen Verbindung und kann einer der folgenden Werte sein:
50, 75, 110, 150, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, 38400, 57600 or 115200

Sollte überarbeitet werden, Purebasic kann alles was der COM-Port (heute oft ein USB-COM-Chip) auch unterstützt, z.B. 500000 oder 921600

EingabePufferGröße Definiert die Größe des Eingabepuffers, in Bytes.
AusgabePufferGröße Definiert die Größe des Ausgabepuffers, in Bytes.

Ein Hinweis, dass dies nur PB-interne Puffer sind und *nicht* die Puffer des Betriebssystems (kommen dazu), wäre ggf. angebracht.

[margro]

Umlaute werden in der Hilfe von 6.01 nicht richtig dargestellt, ist das bei euch auch so?

Bei mir ist es auch so, aber erst ab Windows 11.
Ich habe selbst nach einer Lösung gesucht und bin nur auf diese gestoßen:
In den Kopfbereich aller HTML-Dateien müsste folgender String eingefügt werden:

<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">

Vielleicht hat André ja irgendwann mal Langeweile.

[margro]

Will noch hinzufügen, dass ich testhalber einer HTML-Seite aus der Hilfe extrahiert und die Zeile wie oben eingebaut habe. Dann habe ich diese HTML-Seite auf das Hilfefenster gezogen, und siehe da: es hat funktioniert. Ohne diese Zeile wurden die Umlaute nicht richtig angezeigt.