Screen Shots

From Synfig Studio :: Documentation
Jump to: navigation, search
(created)
 
m (naming: add current naming convention)
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
<!-- Page info -->
 
<!-- Page info -->
 
{{Title|Screen Shots}}
 
{{Title|Screen Shots}}
{{Navigation|Writer_Documentation|Meta:Screen Shots}}
+
{{Navigation|Writer_Documentation|Meta:Synfig Naming Conventions}}
 
<!-- Page info end -->
 
<!-- Page info end -->
  
 
Screen shots for the documentation should be done in a specific way.
 
Screen shots for the documentation should be done in a specific way.
 +
 +
 +
== basics ==
 +
 +
* Use "Clearlooks" with "Tango" icons for the screenshots (Windows/Mac users use "blue-ish" styles, please)
 +
* Use default clear synfig theme
 +
* Png format only
 +
* High quality at canvas: "Low Res" checkbox is off, "Quality" is set to 1
 +
* Let's do smart screenshots! A group panel screenshot with no groups in it is meaningless!
 +
* Do not make image bigger than something like 1000px wide.
 +
 +
== partial vs. full window ==
 +
 +
* Do not use windows decoration / GUI items if they are not needed.
 +
* Usage of post production tools (blur the non subject areas of the screenshot, text annotations etc.) are welcome.
 +
 +
 +
== appearence in text ==
 +
 +
* Images should be shown in full size when possible. Only if the image takes too much space it might be thumbnailed.
 +
* Position: Right align for images if they are near the text - that way they do not interrupt text flow. Center images for "standalone" ones.
 +
 +
 +
== naming ==
 +
 +
* Uploaded images should have a proper name.
 +
* Use generic file notation : image_file_name_current.png. Example ''File:Render_settings_Dialog_current.png'' ‎used in [[Render_dialog]] (to take advantage of the upgrade image system)
 +
* Images have to be categorized to be found easily.
 +
 +
== samples / sifz source ==
 +
 +
* When creating sample files showing the effects of the layer's parameter modifications a sifz file must be provided to make sure the same figure can be rendered again if the window decoration or GUI layout is significantly different.
 +
* Use a meaningful name for the sifz file, if possible use the image file name just with .sifz instead of .png (see above).
 +
 +
 +
== wikimedia specific usage ==
 +
 +
Another advice when you update the screenshots :
 +
 +
You can bust old wiki syntax {{ }}, have more control on positioning the image and give some visual unity of the image by adding a border (frame)
 +
 +
Example :
 +
<nowiki>[[Image:Bounding-box_0.63.06.png|frame|left]] instead of {{l|Image:Bounding-box.png}}</nowiki>
 +
 +
Sometime you will need to use the 'none' placement in place of {center|right|left}, more infos at [http://meta.wikimedia.org/wiki/Help:Images_and_other_uploaded_files#Embedding_internal_files wikimedia/doc/images]
 +
 +
== more... ==
 +
 
We are currently discussing this at the Forum [http://synfig.org/forums/viewtopic.php?f=25&t=1123].
 
We are currently discussing this at the Forum [http://synfig.org/forums/viewtopic.php?f=25&t=1123].
  
As soon as the discussion begins to settle we will add the results here.
 
  
For the time being it's a good idea to at least read the Forum entries and stick to the obvious points.
+
{{Navigation|Writer_Documentation|Meta:Translation}}

Latest revision as of 15:04, 1 July 2015

Navigation Navigation:  <<Writer Documentation>>


Screen shots for the documentation should be done in a specific way.


basics

  • Use "Clearlooks" with "Tango" icons for the screenshots (Windows/Mac users use "blue-ish" styles, please)
  • Use default clear synfig theme
  • Png format only
  • High quality at canvas: "Low Res" checkbox is off, "Quality" is set to 1
  • Let's do smart screenshots! A group panel screenshot with no groups in it is meaningless!
  • Do not make image bigger than something like 1000px wide.

partial vs. full window

  • Do not use windows decoration / GUI items if they are not needed.
  • Usage of post production tools (blur the non subject areas of the screenshot, text annotations etc.) are welcome.


appearence in text

  • Images should be shown in full size when possible. Only if the image takes too much space it might be thumbnailed.
  • Position: Right align for images if they are near the text - that way they do not interrupt text flow. Center images for "standalone" ones.


naming

  • Uploaded images should have a proper name.
  • Use generic file notation : image_file_name_current.png. Example File:Render_settings_Dialog_current.png ‎used in Render_dialog (to take advantage of the upgrade image system)
  • Images have to be categorized to be found easily.

samples / sifz source

  • When creating sample files showing the effects of the layer's parameter modifications a sifz file must be provided to make sure the same figure can be rendered again if the window decoration or GUI layout is significantly different.
  • Use a meaningful name for the sifz file, if possible use the image file name just with .sifz instead of .png (see above).


wikimedia specific usage

Another advice when you update the screenshots :

You can bust old wiki syntax {{ }}, have more control on positioning the image and give some visual unity of the image by adding a border (frame)

Example : [[Image:Bounding-box_0.63.06.png|frame|left]] instead of {{l|Image:Bounding-box.png}}

Sometime you will need to use the 'none' placement in place of {center|right|left}, more infos at wikimedia/doc/images

more...

We are currently discussing this at the Forum [1].


Navigation Navigation:  <<Writer Documentation>>