Skip to content

Screenshots

gabry edited this page Feb 3, 2022 · 4 revisions

Before taking a screenshot

  • Resize the window to be as small as possible (avoid large empty areas). Images wider than ~900px or so will be scaled down even on a widescreen monitor when displayed in the Help Center.
    • GitHub Preview displays them slightly wider however, up to ~1000px.
  • Keep it simple. Close unrelated tabs, etc.
  • Take care to capture the entire window or other relevant part of the screen, making sure no elements are cut. The image can be more precisely cropped later, if needed.

Windows 10

  • PrtSc to copy fullscreen to clipboard. Paste in an image editor.
  • Windows + PrtSc to save fullscreen to Pictures > Screenshots.
  • Alt + Windows + PrtSc to save a window screenshot to the Videos/Captures folder.

macOS

  • CMD + Ctrl + 3 for fullscreen screenshot
  • CMD + Ctrl + 4 for select area.
    • In this mode, press Space to take a window screenshot.

Editing screenshots

Style guide

In case you need to highlight a specific button or areas on the screen:

  • If the screenshot is borderless with a light color, additional contract is needed. Increase the canvas width by 200 px and height by 100 px (total, not for each side), then add background color (see color codes below).
  • Highlight using a 2px or 4px orange rectangle (see color codes below).
  • If the highlighting is hard to discern, add a white overlay outside the highlighted box. 60% opacity is standard, but it may need to be adapted depending on the background.
Color RGB HEX
Background (210, 248, 246) #d2f8f6
Highlight (230, 126, 34) #e67e22

Example

Here is a screenshot of the IDE taken with CMD + Ctrl + 4 on macOS, and pressing Space to capture the window.

We can highlight the Serial Monitor button with a 2 px border:

The width is quite small for the resolution, let’s make it 4 px.

Still, since it’s far out in the corner, we can direct the eyes a bit more by adding an overlay.

Now the screenshot is quite bright, to create some contrast on a white page we’ll add the colored background:

Done!

Clone this wiki locally