Changes between Version 53 and Version 54 of squeak_faq

Timestamp:

04/03/2019 04:54:15 PM (5 years ago)

Author:

patrick.rein

Comment:

--

squeak_faq

@@ -5 +5 @@
 
 == Dokumentation ==
-
 
 
@@ -39 +38 @@
 [https://www.hpi.uni-potsdam.de/hirschfeld/trac/SqueakCommunityProjects/wiki/squeak_screencasts Screencasts] über Squeak gibt es ebenfalls.
 
+
+
+
+
+
+
+
 == Grafik und Morphic ==
 
@@ -92 +98 @@
 
 Werft einen Blick auf die Methode `Morph>>lock`.
+
+=== Wie können Formen/Bilder skaliert werden? ===
+
+{{{ImageMorph}}}s lassen sich zwar nicht skalieren, jedoch {{{Form}}}s. Hierfür würde man die folgenden Methoden verwenden:
+{{{
+Form >> #scaledToSize:
+Form >> #scaledToSize:smoothing:
+Form >> #scaledIntoFormOfSize:
+Form >> #scaledIntoFormOfSize:smoothing:
+Form >> #magnifyBy:
+}}}
+
+Damit kann, verzerrt oder die Größe von Forms geändert werden:
+{{{
+(ActiveWorld imageForm scaledToSize: 64@64 smoothing: 8)
+asMorph openInHand.
+
+(ActiveWorld imageForm scaledIntoFormOfSize: 64@64 smoothing 8)
+asMorph openInHand.
+ 
+(ActiveWorld imageForm magnifyBy: (64@64) / ActiveWorld extent)
+asMorph openInHand.
+}}}
+
+=== Wie können Imagemorphs skaliert werden? ===
+
+{{{
+form := ImageMorph defaultForm.
+form := form
+        magnify: form boundingBox
+        by: 2@7
+        smoothing: 2.
+form asMorph openInWorld.
+}}}
+
+=== Warum habe ich Lücken zwischen meinen ThumbnailImageMorphs?
+
+Wenn ThumbnailImageMorphs in einem Schachbrettmuster angeordnet werden, dann kann Folgendes passieren:
+1.) Layouting
+Das Layouting versucht anhand der Spezifikation die zum Beispiel durch die Frames gegeben wurden die Morphs passend zu positionieren und zu skalieren. Dabei kommen manchmal auch Gleitkommazahlen für die konkreten Bounds der einzelnen Morphs heraus. Da am Ende alles auf Pixel abgebildet wird werden diese Werte aber auf Ganzahlen gerundet. Das ist erst einmal nicht weiter schlimm, da damit eure Spezifikation bis auf einen kleinen Fehler eingehalten wird. Der Fehler ist auch nicht für jede Zelle wieder plötzlich neu sondern zum Beispiel alternierend zwischen Reihen.
+
+2.) Anpassen der Morphs
+Für normale Morphs ist ersichtlich, dass alles bündig liegt. Das liegt daran, dass die Morphs die neue Größe die vom Layout vorgegeben wurde einfach akzeptieren und sich so zeichnen. Die ThumbnailImageMorphs sind eigentlich für eben genau das gedacht: Thumbnails. Darum versuchen sie so lange wie möglich ihr Seitenverhältnis beizubehalten (bis zu einem Verhältnis von 3), dann wird doch gestaucht. Das führt dazu, dass ihr, wenn ihr zwei verschieden hohe Reihen habt, die ThumbnailImageMorphs in diesen Reihen auch unterschiedliche Breiten haben werden.
+
+
+=== Ein Morph hat einen Rahmen, weil er KeyboardFocus hat; wie bekomme ich diesen weg? ===
+
+Hierfür gibt es die Morphic Property indicateKeyboardFocus.
+Mann kann diesen entfernen entweder mit
+{{{
+aMorph setProperty: #indicateKeyboardFocus toValue: #never
+}}}
+setzen, oder die Nachricht {{{indicateKeyboardFocus}}}
+in der benutzerdefinierten Morphklasse muss überschrieben werden (diese muss dann false
+zurückgeben).
+
+=== Wie kann ich Text in einem Textmorph zentrieren? ===
+{{{
+TextMorph new
+        contents: 'Hallo';
+        wrapFlag: true;
+        width: 300;
+        centered;
+        lock;
+        openInWorld.
+}}}     
+
+
+
+=== Wie passt man die Schrft in einem Textmoph an? === 
+
+{{{
+"String + TextAttribute = Text"
+text := 'Hello, World' asText.
+text addAttribute: TextEmphasis bold.
+text addAttribute: TextEmphasis bold from: 1 to: 5.
+text asMorph openInHand.
+
+"... bold, italic, colorful, fonts, ..."
+TextAttribute browseHierarchy.
+
+"Fonts"
+FontImporterTool open. "Install new fonts into Squeak."
+StrikeFont actualFamilyNames. "Browse and explore"
+TextStyle fontSizeSummary. "Browse and explore"
+
+"Fonts are queriesd by family name, point size, and emphasis code"
+font := StrikeFont familyName: 'Bitmap DejaVu Sans' pointSize: 17.
+font := StrikeFont familyName: 'Bitmap DejaVu Sans' pointSize: 17 emphasized: TextEmphasis italic emphasisCode.
+
+"Note: While emphasis (bold, italic, underlined) can be *in* the font, color is only attached to fonts via text attributes to be used in font-rendering code."
+
+"Change/override the font for all characters in the text."
+text addAttribute: (TextFontReference toFont: font).
+
+"Configure text (attributes) through text morphs. Not really recommended."
+tm := TextMorph new.
+tm contents: 'Hello, World!'.
+tm beAllFont: (StrikeFont familyName: 'Bitmap DejaVu Sans' pointSize: 17).
+tm openInHand.
+}}}
+
+=== Wie finde ich die Schriftgröße, sodass ein Morph ohne Zeilenumbruch befüllt wird? ===
+{{{
+TextMorph beAllFont: aFontFamily scaledToWidth: targetWidth
+| font |
+(Interval from: 200 to: 1 by: -1) detect: [:pointSize |
+  font := TTCFont familyName: aFontFamily pointSize: pointSize emphasis: (text emphasisAt: 0).
+  (font widthOfString: text) <= targetWidth].
+self beAllFont: font
+}}}
+Wenn das obige zu langsam ist, kann auch {{{#findBinary:}}} verwendet werden für ein laufzeitoptimierte Variante.
 
 
@@ -135 +253 @@
 
 Wenn ihr das Spiel auf dem XO in Vollbild laufen lassen wollt, dann solltet ihr eine etwas höhere Auflösung einplanen. Der XO-1 hat eine Auflösung von 1200x900 [http://laptop.org/en/laptop/hardware/specs.shtml XO Specs]
+
+
+
+=== Wie ist es möglich die Größe eines Morphs auf die Größe der World zu setzen (selbst wenn diese sich ändert)? ===
+
+Es gibt aktuell keine Benachrichtigung, wenn sich die Fläche des von Squeak bemalten Bereichs verändert. Morphic's Hauptschleife schaut in jedem Durchlauf explizit nach und passt gegebenenfalls die Dimension der Welt (also: Instanz von PasteUpMorph) an. Siehe {{{WorldState >> #doOneCycleNowFor:}}} und {{{DisplayScreen class >> checkForNewScreenSize}}}. Im Endeffekt landet das in {{{Project >> #displaySizeChanged}}} beziehungsweise {{{PasteUpMorph >> #restoreMorphicDisplay}}}. Allerdings gibt es keinen Weg für euer ein Spiel, dies elegant einzubinden.
+
+Daher sollte der Morph steppen und in jedem {{{#step}}} wird die Größe neu gesetzt:
+{{{
+step
+  self isInWorld ifTrue: [
+    self extent: self world extent]
+}}}
+beziehungsweise
+{{{
+step
+  self owner ifNotNil: [:owner |
+    self extent: owner extent]
+}}}
+
+Das ist kein spürbarer Mehraufwand zur Laufzeit, wie ihr in {{{Morph >> #extent:}}} nachschauen könnt.
+
+Das allgemeine Konzept, seine eigene Größe automatisch an den Owner anzupassen -- also LayoutPolicy -- wird hier nicht benutzt. PasteUpMorph's haben keine LayoutPolicy.
+
 
 
@@ -267 +409 @@
 
 
+
+
+
+
+
+
+== Smalltalk als Programmiersprache ==
+
+=== Was ist der Unterschied zwischen Arrays und literal Arrays? ===
+
+Mit den geschweiften Klammern ist die allgemeinere Art ein Array zu erzeugen. In den Klammern stehen durch Punkte getrennt Statements, also wirklich Code-Teile. Das können direkt Zahlen/Strings/etc sein, aber auch tatsächlich Logik.
+
+Array - {{{ {1. 2. 3} }}}
+
+
+zum Beispiel würde
+
+{{{
+{ 1 + 1. 1 + 2.}
+}}}
+
+zu einem Array mit 2 und 3 drin führen.
+
+Weil es sich um Code handelt, der ausgeführt werden muss, steht der Inhalt des Arrays erst zur Laufzeit (also wenn der Code ausgeführt wird) fest. Der Code kann deswegen auch andere Objekte enthalten, welche erst zur Laufzeit feststehen, wie Variablen.
+
+
+Zum Beispiel führt
+
+{{{
+myNumber := 41.
+{ 'foo'. 1 + myNumber}
+}}}
+
+zu einem Array mit 'foo' und 42.
+
+
+Bei literal Arrays kann kein Code übergeben werden, sondern nur Literale. Dadurch steht der Inhalt immer fest, nicht erst zur Laufzeit. Die Werte werden durch Leerzeichen getrennt und werden auch leicht anders erzeugt:
+
+{{{
+#(1 2 3)
+}}}
+
+Wenn "Text" drin steht ohne als String ('a') oder Symbol (#a) markiert zu sein, wird er automatisch zu Symbolen umgewandelt. So wird
+{{{
+#(hallo welt 42)
+}}}
+
+zu einem Array mit #hallo #welt und 42. Wie Code wird es nicht ausgewertet und Variablen können deshalb auch nicht hineingegeben werden. Deshalb führt
+{{{
+myNumber := 41.
+#( 1 + myNumber)
+}}}
+zu einem Array mit 1 und #+ und #myNumber
+
+
+
+
+
+
 == Image ==
+
+=== Wie fügt man eine Method zu einer Klasse hinzu? ===
+
+Hierfür muss zuerst mit dem Browser in die Klasse navigiert werden, in der eine neue Methode erstellt werden soll. Hat diese Klasse bereits Methoden, wird eine neue Methode angelegt, indem man den Methodennamen ändert und dann speichert. Das ist am Anfang etwas ungewöhnlich aber spart einen extra Button. Noch einfach ist es alles zu markieren (ctrl+a) und dann einfach mit dem schreiben der Methode anzufangen.
+
+Hat die Klasse noch keine Methoden ist beim Auswählen des Klassenamens ein Methodentemplate zusehen. Dieses muss dann nur noch ausgefüllt werden.
+
+
 
 === Wie erreiche ich Nebenläufigkeit in Squeak? ===
@@ -381 +590 @@
 
 
-=== Wie können mehrere Schritte rückgängig gemacht werden? ===
-
-In den Einstellungen findet sich die Option "multipleTextUndo". Aktiviert diese und ihr könnt mehrere Schritte rückgängig machen. Mittels Strg + Z bzw cmd + Z könnt ihr die letzte Änderung rückgängig machen. Mehrmals zurück geht lediglich über Squeaks changes. Klickt dazu im Browser auf versions und wählt eure letzte Änderung aus.
+=== Welche Keyboard shortcuts gibt es in Squeak? Kann ich selbst welche hinzufügen? ===
+
+Im Editor und den Unterklassen (vor allem TextEditor) in den initialize* Methoden findet man verschiedene Tabellen um Shortcuts anzupassen. Da diese Tabellen als Zustand auf Klassenseite gehalten werden muss dann die #initialize Methode der Klasse (also z.B. TextEditor initialize) noch einmal aufrufen werden.
+
+Allgemein natürlich der Hinweis auf Help > Keyboard Shortcuts für eine allgemeine Übersicht.
 
 
@@ -479 +690 @@
  
 [[Image(profiler.jpg)]]
+
+=== Gibt es ein Tool in Squeak, das einem hilft besseren Code zu schreiben? ===
+
+Wie für viele Programmiersprachen gibt auch in Squeak einen sogenannten Linter, der dabei unterstützen soll schönen Code zu schreiben. Dieser analysiert euren Code und weist auf "unsaubere" Abschnitte hin. Solche Stellen können sowohl mögliche Fehlerquellen sein, als auch Codeabschnitte, die nicht Idiomen entsprechen.
+
+SWALint, wie das Tool heißt, wurde über Jahre in SWT Vorlesungen entwickelt und refactored. Ihr findet es im Apps Menü. Eine genauere Erklärung bietet der folgende Screencast (wenn auch für eine etwas ältere Version): https://www.hpi.uni-potsdam.de/hirschfeld/trac/SqueakCommunityProjects/wiki/squeak_screencasts#SwaLintstaticcodeanalysisandmetrics).
+
+(Die SwaLint-Tests sind sehr umfangreich und nicht alle immer ein hundertprozentiger Indikator für ein Problem. Ihr könnt sie gerne auch ausführen, um noch Hinweise auf potentielle Probleme zu finden, alle diese Tests zu bestehen sollte aber kein Ziel für euch sein.)
+
 
 === Ich habe meine WorldMainDockingBar kaputt gemacht. Wie kann ich sie zurücksetzen? ===