mriale / PyDPainter

A usable pixel art paint program written in Python
GNU General Public License v3.0
549 stars 26 forks source link

Add quick reference card with keyboard shortcuts #18

Open mriale opened 1 year ago

Sleuthgame commented 1 year ago

Need help for that ? I was used to and familiar with the program. I found some reference (old Dpaint manuals :-).

mriale commented 1 year ago

@Sleuthgame Sure, I could use help with this. I was thinking something like the quick reference card for DPaint III: https://retro-commodore.eu/files/downloads/amigamanuals-xiik.net/Applications/Deluxe%20Paint%20III%20-%20Quick%20Reference-ENG.pdf

One page might be all that is needed. Thanks!

Sleuthgame commented 1 year ago

Well done! I had this document with my original version of DPaint. I remember it very well.

We'll start by checking all the shortcuts here and I'll use Affinity Publisher to produce a document like this in PDF and images. Is that okay?

mriale commented 1 year ago

@Sleuthgame Sure, that's fine as long as it ends up as a PDF and images. Thanks!

Sleuthgame commented 1 year ago

You're welcome. Let's use your reference. DPaint 3 ENG. I test all toolbox keys and there fine (I'm French, I have AZERTY keyboard). 👍

Brush shortcuts (page 3) : All but one is fine on my side. =+ bigger is fine :) But smaller ? I can't locate where the - minus key is ? Don't works either on numpad or on regular keyboard. Where is it on your side ?

Sleuthgame commented 1 year ago

Can't locate Cycle through colors in a selected cycle range. I carefully select one of the 2 colors ranges available by defaut. Does not change the current first color. Check TOOLBOX COMMANDS Page 2. Cycle through colors in a selected cycle range [,]

(It's not ~ wich is located in the TAB key nowadays and work fine to cycle color. Thanks for that, btw, my favorite fx !)

mriale commented 1 year ago

Hmmm, these keys are not as convenient for AZERTY: image So on US keyboards, the + and - keys are next to each other and the [ and ] keys are also close.

So if you hit Shift-6 (should be minus on AZERTY) does it shrink the brush?

The [ and ] keys go one color back or one color forward in the palette. Do Alt Gr-5 and Alt Gr-° work for you?

Sleuthgame commented 1 year ago

So if you hit Shift-6 (should be minus on AZERTY) does it shrink the brush?

Sorry, no. Maybe try to use + and - on the numpad as a backup ? It make sense and I remember it works on Amiga too. (but maybe only DPaint V or Brilliance 2). And one dot brush "." on numpad is already working.

The [ and ] keys go one color back or one color forward in the palette. Do Alt Gr-5 and Alt Gr-° work for you?

Oh, I remember that now. No, it does not work. sorry.

Sleuthgame commented 1 year ago

DSC00755-1024x529

So on US keyboards, the + and - keys are next to each other and the [ and ] keys are also close.

On a real Amiga keyboard [ and ] keys are close too on the numeric pad. If I remember right, we use + and - there too. But what you can do is shrinking with = ++ and = are on the same key, both Amiga and PC keyboards.

mriale commented 1 year ago

@Sleuthgame I looked at the code and it has references to the actual keys instead of the letter or symbol it produces. It won't take me long to replace those. I hope to put that into the upcoming release.

Sleuthgame commented 1 year ago

Well done. It's working in 1.0.7 on both keys.

Sleuthgame commented 1 year ago

It was quite hard! I never realized how much the interface has its own logic, far from the systematic guidelines of today. IE: free area fill has no right click settings. It share the same Fill settings than other filling tools.

hotkeys-toolbox

Any feedback ?

Sleuthgame commented 1 year ago

I need a page 2 for Special keys and brush keys (mode etc.)

mriale commented 1 year ago

@Sleuthgame That looks great! Yeah, the user interface is not as consistent as standard GUIs are today, but it also packed in much more functionality into a limited space. However, it makes it a little hard to document for new people to understand. Your document will go a long way to help people wrap their brains around this.

Some edits:

Anyway, great job with this! If you want to do another page with draw modes and other keys that's fine, but this is a whole lot more than what we had before: nothing. :smile:

Sleuthgame commented 1 year ago

thanks !

Some edits:

  • Change PyeDpainter at the top of the page to PyDPainter. 😄

OMG. Where is my head?

  • Where it says "space settings" make sure it says "spacing settings". Sure.

  • I'm not sure how you indicate that LC on the color swatch is pick color and that RC on the color swatch is the palette requestor. Or maybe you just leave it the way it is.

wow! I just learned something. I didn't even know this existed. I'll make this clearer.

Anyway, great job with this! If you want to do another page with draw modes and other keys that's fine, but this is a whole lot more than what we had before: nothing. 😄

Yes, the other pages are just lists, it will be easier. But I'd still like to make the MODEs visually explicit.

Sleuthgame commented 1 year ago

This is corrected.

hotkeys-toolbox
mriale commented 1 year ago

@Sleuthgame Update curve to q key. Sorry I didn't catch that one!

Sleuthgame commented 1 year ago

Ok. I'am re-opening this. I'm on my way for doc page 2 (brush transformation) and 3 (Mode). brush-tuto

Sleuthgame commented 1 year ago
MetinSeven commented 1 year ago

Ok. I'am re-opening this. I'm on my way for doc page 2 (brush transformation) and 3 (Mode). brush-tuto

This is a great visual reference for people who are not or not-so familiar with DPaint, thanks! 👍

mriale commented 1 year ago

@Sleuthgame Lightly edited and added your files into project: https://github.com/mriale/PyDPainter/blob/develop/docs/menus/src/brush.md

This is an amazing reference! Thanks so much!

Sleuthgame commented 1 year ago

Your're welcome. I will try to recreate this as a page 2 for the PDF reference now. Don't close.