-
Notifications
You must be signed in to change notification settings - Fork 2
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Fixes to the Tilemap Editor, introduced ReadMe button
- Loading branch information
Thomas Wolf
committed
Nov 7, 2024
1 parent
decb909
commit 199f1c1
Showing
14 changed files
with
220 additions
and
17 deletions.
There are no files selected for viewing
21 changes: 21 additions & 0 deletions
21
src/GameMecha-TileEditor.package/GMTEEditor.class/class/displayHelp.st
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,21 @@ | ||
| utility | ||
| displayHelp | ||
| "Shows a window with the ReadMe" | ||
|
|
||
| |temp dialog| | ||
|
|
||
| temp := PluggableTextMorphPlus new. | ||
| temp | ||
| setText: GMTEEditor helpMessage; | ||
| extent: RealEstateAgent scaleFactor * (1000 @ 400); | ||
| readOnly: true. | ||
|
|
||
| dialog := DialogWindow new | ||
| title: 'ReadMe'; | ||
| addPaneMorph: temp; | ||
| createCancelButton: 'Close' translated value: false; | ||
| registerKeyboardShortcuts. | ||
|
|
||
| dialog paneMorph extent: temp extent. | ||
| dialog getUserResponse | ||
|
|
137 changes: 137 additions & 0 deletions
137
src/GameMecha-TileEditor.package/GMTEEditor.class/class/helpMessage.st
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,137 @@ | ||
| constants | ||
| helpMessage | ||
|
|
||
| ^ '# GM - TileEditor | ||
| ## Starting the editor | ||
| You can start the editor by running "GMTEEditor new". | ||
| > By running "GMTEEditor register" you can add the editor to the Apps menu. | ||
| ## Menu functions | ||
| ### Import | ||
| #### Importing a tile set | ||
| After providing a tile height in pixels you can select a tile set file that is automatically cut into tiles and loaded into the tile store. | ||
| #### Importing a tilemap | ||
| Import a previously exported tile map to keep working on it. | ||
| ### Export | ||
| #### Export as tilemap | ||
| Export your current progress on the tilemap to a file. | ||
| > Can be reimported to continue working on it. | ||
| #### Export as PNG | ||
| Save the tilemap as a picture. | ||
| ### Open in world | ||
| Opens the current tilemap morph to experiment with its current state. | ||
| ### Toggle grid | ||
| Toggles the visibility of the map grid. | ||
| ### Toggle Background | ||
| Toggles the dynamic filling of the tile maps background with the background tile. | ||
| > The background tile can be selected by right clicking a tile in the tile store. | ||
| ### Reset View | ||
| Reset your view after zooming in/out or moving your view. | ||
| ## Tile Store | ||
| Select a tile by left clicking it. | ||
| Select a background tile by right clicking it. | ||
| ## Tilemap | ||
| Place tiles on the current layer by left clicking. | ||
| Remove tiles on the current layer by right clicking | ||
| > You can place / remove multiple tiles by holding left / right click and dragging your mouse over the desired tiles. | ||
| > You can rotate your currently selected tile by pressing ctrl/alt +r | ||
| Zoom in/out by scrolling. | ||
| Hold shift, left click and drag your mouse to move your view. | ||
| ## Toolbar | ||
| ### Undo/Redo | ||
| Un-/Redo your last action, whether that is a layer action, a drawing/erasing action or resizing the tilemap. | ||
| ### Brushes | ||
| You can choose from a selection from brushes. | ||
| Additionally you can choose a radius which applies to the (default) brush and the line tool. | ||
| #### (default) Brush | ||
| Places tiles where you click and, depending on the radius, around it. | ||
| #### Line Tool | ||
| Click and drag to draw a line between start and end point. | ||
| A larger radius leads to a thicker line. | ||
| #### Fill tool | ||
| Click on a tile to replace all alike connected tiles with a new tile. | ||
| #### Rectangle Tool | ||
| Place a rectangle of tiles by clicking in the upper left corner and dragging to the lower right corner of the desired rectangle. When you release the mouse button the area is filled with your selected tile. | ||
| ## Inspector Tab | ||
| Allows you to adjust the tilemaps attributes. | ||
| ### Grid height / width | ||
| Adjusts the height / width of the tilemap. | ||
| ### Padding | ||
| The distance between the grid and the edge of the tilemap. | ||
| ## Layer Tab | ||
| ### Selecting layers | ||
| Select and deselect layers to manipulate them. | ||
| > You can select multiple layers by shift + clicking. | ||
| > Some layer actions only work if just one layer is selected. | ||
| ### Layer Actions | ||
| #### Add Layer | ||
| Adds a new layer in front of the other layers. | ||
| #### Move up / down | ||
| Moves the currently selected layer up / down by one. | ||
| #### Renaming | ||
| Allows you to choose a custom name for the currently selected layer. | ||
| #### Clearing | ||
| Clears all currently selected layers. | ||
| #### Blending | ||
| Blends all currently selected layers into one. | ||
| #### Deleting | ||
| Deletes all currently selected layers. | ||
| #### Toggling visibility | ||
| Shows / hides all currently selected layers. | ||
| ## Keyboard Shortcuts | ||
| There are keyboard shortcuts for quick access to the editor functions. | ||
| ### Menu Functions | ||
| |Function | Shortcut| | ||
| |-------------------------------|-----------------------------| | ||
| |Import Tilemap|`ctrl/alt + i` | | ||
| |Import Tileset|`ctrl/alt + o` | | ||
| |Export Tilemap|`ctrl/alt + s` | | ||
| |Toggle Grid|`ctrl/alt + g` | | ||
| |Toggle Background|`ctrl/alt + h` | | ||
| ### Layer Functions | ||
| |Function | Shortcut| | ||
| |-------------------------------|-----------------------------| | ||
| |Add Layer|`ctrl/alt + a` | | ||
| |Rename Layer|`ctrl/alt + n` | | ||
| |Clear selected Layers|`ctrl/alt + c` | | ||
| |Blend selected Layers|`ctrl/alt + b` | | ||
| |Delete selected Layers|`ctrl/alt + x` | | ||
| |Toggle visibility of selected Layers|`ctrl/alt + v` | | ||
| ### Tools | ||
| |Function | Shortcut| | ||
| |-------------------------------|-----------------------------| | ||
| |Undo|`ctrl/alt + z` | | ||
| |Redo|`ctrl/alt + y` | | ||
| |Rotate selected Tile|`ctrl/alt + r` | | ||
| |Select (default) brush|`alt + 1` | | ||
| |Select Line Tool|`alt + 2` | | ||
| |Select Fill Tool|`alt + 3` | | ||
| |Select Rectangle Tool|`alt + 4` | | ||
| ## Dev API | ||
| The tilemap offers an API for developement. | ||
| ### toFullScreen | ||
| Automatically rescales your tilemap to fill out the screen. | ||
| ### mapGridOnly | ||
| Reduces the tileMap to the grid and removes the dynamic background frame. | ||
| ### toggleVisualLayer | ||
| Toggles the visibility of the grid. | ||
| ### showVisualLayer / hideVisualLayer | ||
| Shows / hides the grid. | ||
| ### toForeground | ||
| Ensures that the tilemap morph is drawn in front oft the squeak UI. | ||
| ### toFullScreenMode | ||
| Enables fullscreen mode. | ||
| ### toggleBackgroundLayer | ||
| Toggles the dynamic filling of the maps background with the background tile. | ||
| ### deleteTiles: anIndexSet inLayer: aLayer | ||
| Delete the tiles specified by the indices in anIndexSet in the specified layer. | ||
| ### placeTiles: anIndexSet inLayer: aLayer ofClass: aTileClass withImage: anImage | ||
| Place tiles specified by the indices in anIndexSet in the specified layer with a provided image. The argument aTileClass allows to add custom tiles, which inherit from GMTETile. | ||
| ### placeTiles: anIndexSet inLayer: aLayer withImage: anImage | ||
| Place GMTETiles specified by the indices in anIndexSet in the specified layer with a provided image. | ||
| ## Using your tilemap for your game | ||
| The TileEditor offers class-side methods (GMTEEditor) which load your tilemap from a local file path / the Git Asset Browser without starting the TileEditor so you can use it in your game. | ||
| ### GMTEEditor getTileMapFromFilePath: `your local filepath` | ||
| Used to import a tilemap directly from a file. Returns a tilemap from a given local filepath, which should point to a .morph file previously exported from the TileEditor. | ||
| ### GMTEEditor getTileMapFromProjectName: `name of your project in Git Browser` withPath: `your filepath in Git Asset Browser` | ||
| Used to import a tilemap from the Git Asset Browser in Squeak. Returns a tilemap from the projectname and a relative filepath in the Asset Browser, which should point to a .morph file previously exported from the TileEditor.' |
2 changes: 1 addition & 1 deletion
2
src/GameMecha-TileEditor.package/GMTEEditor.class/class/startup.st
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,4 +1,4 @@ | ||
| startup | ||
| utility | ||
| startup | ||
| "Opens the editor with a startup wizard" | ||
|
|
||
|
|
||
10 changes: 5 additions & 5 deletions
10
src/GameMecha-TileEditor.package/GMTEEditor.class/instance/exportAsImage.st
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,9 +1,9 @@ | ||
| menu buttons | ||
| accessing | ||
| exportAsImage | ||
| "Exports the current tile map as a png" | ||
|
|
||
| exportTilemap := self tileMap veryDeepCopy. | ||
| exportTilemap | ||
|
|
||
| self tileMap | ||
| hideHighlightingLayer; | ||
| resetView; | ||
| exportAsImage | ||
| exportAsImage; | ||
| showHighlightingLayer |
13 changes: 8 additions & 5 deletions
13
src/GameMecha-TileEditor.package/GMTEEditor.class/instance/exportAsMorph.st
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,9 +1,12 @@ | ||
| menu buttons | ||
| accessing | ||
| exportAsMorph | ||
| "Saves the current tileMap as a .morph file, which allows for reimporting" | ||
| "Saves the current tileMap as a .morph file (as EditorTileMap), which allows for reimporting" | ||
| | currentModel | | ||
|
|
||
| ((self tileMap veryDeepCopy) | ||
| currentModel := self tileMap model. | ||
| self tileMap | ||
| model: nil; | ||
| resetView | ||
| ) saveOnFile. | ||
| resetView; | ||
| saveOnFile; | ||
| model: currentModel. | ||
| self savedSinceModified: true |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
10 changes: 10 additions & 0 deletions
10
src/GameMecha-TileEditor.package/GMTETileMap.class/class/fromFileName..st
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,10 @@ | ||
| constants | ||
| fromFileName: fullName | ||
| "Imports a TileMap from a .morph file and optionally converts from EditorTileMap to a TileMap" | ||
|
|
||
| | aFileStream tileMap | | ||
| aFileStream := (MultiByteBinaryOrTextStream with: ((FileStream readOnlyFileNamed: fullName) binary contentsOfEntireFile)) binary reset. | ||
| tileMap := aFileStream fileInObjectAndCode. | ||
| (tileMap class = GMTEEditorTileMap) | ||
| ifTrue: [tileMap := GMTETileMap newFromEditableTileMap: tileMap]. | ||
| ^ tileMap |
5 changes: 5 additions & 0 deletions
5
src/GameMecha-TileEditor.package/GMTETileMap.class/instance/atTileCoordinates..st
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,5 @@ | ||
| dev-api | ||
| atTileCoordinates: aPoint | ||
| "Returns the top left corner of a given tile in tile coordinates" | ||
|
|
||
| ^ self correctedTilePositionMap: (self tilePosFromVirtual: aPoint) |
5 changes: 5 additions & 0 deletions
5
src/GameMecha-TileEditor.package/GMTETileMap.class/instance/getTileCoordinatesFrom..st
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,5 @@ | ||
| dev-api | ||
| getTileCoordinatesFrom: aPoint | ||
| "Returns the tile coordinates that correspond to a x-y-position" | ||
|
|
||
| ^ self tilePosFromVirtual: aPoint |
5 changes: 5 additions & 0 deletions
5
src/GameMecha-TileEditor.package/GMTETileMap.class/instance/tileMapSize.st
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,5 @@ | ||
| dev-api | ||
| tileMapSize | ||
| "Returns the size of the TileMap in tiles" | ||
|
|
||
| ^ self tileWidth @ self tileHeight |
5 changes: 5 additions & 0 deletions
5
src/GameMecha-TileEditor.package/GMTETileMap.class/instance/tileSize.st
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,5 @@ | ||
| dev-api | ||
| tileSize | ||
| "Returns the size of a single tile of the tilemap as a point" | ||
|
|
||
| ^ self tileSizeWidth @ self tileSizeHeight |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters