Skip to content

Latest commit

 

History

History
50 lines (40 loc) · 3.46 KB

contributing.md

File metadata and controls

50 lines (40 loc) · 3.46 KB

Reporting bugs

Please report bugs in the issues page of this repository. Do not report bugs in the Cura repository; they will be closed there.

When reporting a bug, it helps to provide the following information:

  • The version of SettingsGuide you're using.
  • Cura's log file (see Cura's readme for instructions on where to find that).

Requesting features

Feature requests are also welcome in the issues page.

I intend to write descriptions for every setting in Cura, but this is a lot of work. If you'd like to request priority for certain settings, feel free to ask.

Submitting pull requests

Pull requests to the main code (QML, Python) are subject to the following requirements:

  • It does not slow down behaviour significantly.
  • The code style is similar to the rest of the code in this repository.
  • Your code will be licensed under AGPL 3.0 like the rest of the code in this repository.

Pull requests to add descriptions for settings or improve current descriptions are also welcome. In general, articles about settings should hold the following format:

  1. First an explanation of what the setting does directly.
  2. Some pictures with examples, if applicable.
  3. Some more technical details of what the setting does.
  4. The effects of the setting on your print.
  5. Warnings of common mistakes made with this setting or other things that the user should watch out for, if applicable.

This is not set in stone. For some articles (in particular drop-down settings) it makes sense to have a different format.

When taking screenshots of the g-code, these are some instructions to ensure a consistent look throughout the plug-in.

  • Before making a screenshot, remove the build plate shader so that the grid doesn't show up in your screenshot.
  • Use the light theme of Cura when taking the screenshot.
  • Don't use the compatibility mode of layer view.

In an effort to keep the download size of the plug-in manageable, care needs to be taken with .png images.

  1. Reduce your image to 256 colours. You can use dithering if you think it looks better, but quite often it doesn't look better.
  2. Download OptiPNG.
  3. Optimize your image by entering this in a terminal: optipng -o7 -strip all my_image.png

Animated images are even more prone to having large file sizes. The following steps should guide you to produce space-efficient animations:

  1. Use a smaller resolution, by zooming out in Cura rather than by scaling the pictures down after taking the screenshots.
  2. See if you can reduce the colour depth to 64 or 32 colours without introducing a significant amount of dithering or losing visual detail.
  3. If you have an animation that requires smooth motion, use at most 5fps. If you have an animation that just shows several stages or layers, limit your image to one frame per stage or layer.
  4. Don't create animations of more than 5 seconds.
  5. Download FlexiGIF.
  6. Optimize your image by entering this in a terminal: flexigif my_image.gif my_image_opt.gif.
  7. Delete the old image and rename the new my_image_opt.gif to have the original file name.

It is up to the discretion of the package maintainer to decide whether images are too big or not. A major factor in this decision is whether the image is any bigger than strictly necessary.