Screen Shots

From Synfig Studio :: Documentation
Jump to: navigation, search
m (naming: add current naming convention)
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
<!-- Page info -->
 
<!-- Page info -->
 
{{Title|Screen Shots}}
 
{{Title|Screen Shots}}
{{Navigation|Writer_Documentation|Meta:Translation}}
+
{{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:'''
+
 
 +
== basics ==
 +
 
 
* Use "Clearlooks" with "Tango" icons for the screenshots (Windows/Mac users use "blue-ish" styles, please)
 
* Use "Clearlooks" with "Tango" icons for the screenshots (Windows/Mac users use "blue-ish" styles, please)
 +
* Use default clear synfig theme
 
* Png format only
 
* Png format only
* High quality at Canvas: Low Resolution checkbox is off, quality is set to 1  
+
* 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!
 
* 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 ==
  
'''partial vs. full window:'''
 
 
* Do not use windows decoration / GUI items if they are not needed.
 
* 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.
 
* Usage of post production tools (blur the non subject areas of the screenshot, text annotations etc.) are welcome.
  
'''appearence in text:'''
+
 
 +
== appearence in text ==
 +
 
 
* Images should be shown in full size when possible. Only if the image takes too much space it might be thumbnailed.
 
* 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.
 
* 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:'''
+
 
 +
== naming ==
 +
 
 
* Uploaded images should have a proper name.  
 
* 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.
 
* Images have to be categorized to be found easily.
  
'''samples / sifz source:'''
+
== samples / sifz source ==
* When creating sample files showing the effects of the layer's parameter modifications a sifz file must be provided to be sure that the same figure can be rendered again if the window decoration or gui layout is significatively different. Use a meaning name like the screen shot image files (see above).
+
  
 +
* 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].
 +
 +
 +
{{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>>