Skip to content

Commit

Permalink
Add more steps with images in debug and wintab pages
Browse files Browse the repository at this point in the history
  • Loading branch information
dacap committed May 12, 2020
1 parent f0359ea commit e26b913
Show file tree
Hide file tree
Showing 12 changed files with 81 additions and 5 deletions.
66 changes: 63 additions & 3 deletions debug.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,77 @@
# Debug

In case that you are having some problem running Aseprite, you can
execute it with the `--debug` option in the command line.
execute it with the `-debug` option in the command line.

After running Aseprite, you will see that a
`Aseprite-v1.2-DebugOutput.txt` file (or with a similar name) will
be created in your desktop. You can send us that file at
[[email protected]](mailto:[email protected]) so we can help us
solving your specific problem.

On Steam the `--debug` parameter is added in the launch options:
How to add the `-debug` parameter on:

<a href="http://imgur.com/txXcgzO"><img src="http://i.imgur.com/txXcgzO.gif" title="source: imgur.com" /></a>
* [Windows](#windows)
* [macOS](#macos)
* [Steam](#steam)

<hr>

## Windows

1. You can press the Windows key to open the Start menu and write
`Aseprite`, then expand the actions of Aseprite:

![Aseprite on Start menu](debug/win-1-start-menu.png)

2. In the actions list click "Open file location":

![Expand options](debug/win-2-actions.png)

3. Right-click the Aseprite shortcut and select the "Properties" option:

![Right click properties](debug/win-3-right-click-properties.png)

4. Finally write the `-debug` parameter in "Target" box and press "OK":

![Debug on properties](debug/win-4-debug-option.png)

<hr>

## macOS

1. First you have to close Aseprite, then open the Spotlight Search
pressing ⌘Space or clicking the magnifying glass in the menu bar:

![Open Spotlight](debug/macos-1-open-spotlight.png)

2. In the Spotlight Search write `Terminal` and Enter key to open the
Terminal app:

![Terminal on Spotlight](debug/macos-2-open-terminal.png)

3. In the terminal write the following command and press Enter:

open -a Aseprite --args -debug

<hr>

## Steam

On Steam you can add the `-debug` option in the Aseprite launch options:

1. Right-click Aseprite (or Ctrl+click on macOS) in your Steam library
and open its "Properties":

![Open Aseprite Properties](steam/steam-1-open-properties.png)

2. Click the "Set Launch Options" button:

![Open launch options](steam/steam-2-launch-options.png)

3. Add the `-debug` option and press "OK":

![Add debug option](steam/steam-3-debug-option.png)

---

Expand Down
Binary file added debug/macos-1-open-spotlight.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added debug/macos-2-open-terminal.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added debug/win-1-start-menu.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added debug/win-2-actions.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added debug/win-3-right-click-properties.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added debug/win-4-debug-option.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added steam/steam-1-open-properties.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added steam/steam-2-launch-options.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added steam/steam-3-debug-option.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added steam/steam-3-disable-wintab.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
20 changes: 18 additions & 2 deletions wintab.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,14 +13,30 @@ correctly, you can disable the driver going to *Edit > Preferences > Experimenta
![Don't load the WinTab driver](wintab/disable-wintab.png)

If you cannot even start the program, you can execute Aseprite with
the `--disable-wintab` parameter (available since Aseprite v1.2):
the `-disable-wintab` parameter (available since Aseprite v1.2):

"C:\Program Files\Aseprite\Aseprite.exe" --disable-wintab
"C:\Program Files\Aseprite\Aseprite.exe" -disable-wintab

This will bypass the `WinTab32.dll` loading process. Your stylus might
not work correctly, but at least Aseprite can be executed and used
with your mouse/trackpad.

## Steam

On Steam you can add the `-disable-wintab` option in the Aseprite launch options:

1. Right-click Aseprite in your Steam library and open its "Properties":

![Open Aseprite Properties](steam/steam-1-open-properties.png)

2. Click the "Set Launch Options" button:

![Open launch options](steam/steam-2-launch-options.png)

3. Add the `-disable-wintab` option and press "OK":

![Add disable wintab option](steam/steam-3-disable-wintab.png)

---

**SEE ALSO**
Expand Down

0 comments on commit e26b913

Please sign in to comment.