[Bf-docboard] less graphics

Stefano Selleri bf-docboard@blender.org
Thu, 2 Jan 2003 09:46:11 +0100


This is a very nice and much more complete
proposal that the one in the Style guide :)

> > 1. A set of graphics standards would be set up. This would include
> > conventions for size and content, i.e.: 300x200 pixel JPG at 50%
> > compression for the Web-based and other online documentation; 300x200
> > pixel JPG at 90% compression for a high-res PDF; and  2"x1.5" 300dpi
> > CMYK EPS for the print version. The image would contain only the 3D pane
> > for examples, or the button pane for settings.

For 3D pane and Buttons I'd rather push for PNG, not JPG, after all they
are usually low color number images, which would benefit
from a lossless compression.

Of course renderings is another matter, but you won't make 300x200 pixel
renderings, do you?

> > 2. Any screenshots would be done as large as possible, and any
> > renderings would be done to take into account finished output size, for
> > example, 1200x1200 for an image that would go on the printed page at a
> > finished size of 4"x4"

Yes, but this will make Doc CVS veeery big ;) .

> > 3. Someone (an individual or team of individuals) would collect the
> > images, process them according to the standards, and output them in two
> > or three versions with identical content, one for Web, one for print,
> > and one for a high-res PDF. These images would then be returned to the
> > source tree for inclusion in their respective products.
>
> Better yet, why not ask authors to include .blend files instead of
> graphics? We could automate the rendering of the graphics during the
> make process of the documentation and generate the graphics up to any
> resolution that we like! It may take a bit of figuring out how to
> indicate cutouts and such, but I think it is doable.

I think this is a great idea if you then make the .blend file
available as a link within the documentation, so that
reader can experiment, it is also usefull since it allows you
to re-create all images at a different size/resolution if the need arises,
but I would still ask the authors for images.

Stefano