Difference between revisions of "User:Jholsenback"
Jholsenback (talk | contribs) |
Jholsenback (talk | contribs) |
||
Line 110: | Line 110: | ||
This outlines the steps to add a new keyword to the documentation. In this case <code>deprecated</code> | This outlines the steps to add a new keyword to the documentation. In this case <code>deprecated</code> | ||
− | :* first determine where the [[ | + | :* first determine where the [[Reference:Declare_and_Local_Directives#Deprecation_Support|descriptive passage]] goes then add it |
− | :* update the [[ | + | :* update the [[Reference:Declare_and_Local_Directives#Declaring_identifiers|syntax diagram]] in the appropriate places |
− | :* update the [[ | + | :* update the [[Reference:Keywords|Identifiers and Keywords]] list |
− | + | :* document any other [[Reference:Glass_old.inc|place(s)]] that it's used | |
− | :* document any other [[ | ||
:* add a table of contents [[Documentation:Reference Table of Contents#Scene Description Language|entry]] | :* add a table of contents [[Documentation:Reference Table of Contents#Scene Description Language|entry]] | ||
Revision as of 15:50, 4 May 2016
Organization
Basically, I've been using this area as a scratch pad of sorts. Old pages that I didn't want to loose track of are listed here for easy access.
Scratch Pad
Syntax Diagram Examples
This is an example of the proposed format that's going to replace the pre-formatted text blocks which are currently being used, in the reference section narrative. Since there are some differences in the presentation of this construct in html and on this documentation Wiki, here's what you'll need to know.
- The syntax diagram is now inside a div tag instead of pre tag.
- The dt and dd elements of the list require that their ending tags be enclosed in the comments notation.
- The first dt element that precedes the wiki link is required to properly align the link in the box.
- Use underscores instead if spaces in the page address of the wiki link. The wiki parses to the first space to get the page address.
- Please pick up the leading tabs when using copy and paste to maintain source readability when it's converted to html.
- No edits or comments on this copy, go here instead.
- Go to documentation Wiki
- CAMERA:
camera {
[CAMERA_ITEMS...]}
- CAMERA_ITEMS:
- CAMERA_TYPE | CAMERA_VECTOR | CAMERA_MODIFIER | CAMERA_IDENTIFIER
Reference Section Reorganization
Starting a new sub-section for notes ...
Image Layout Templates
- single image narrative on the right with captions
As suggested previously, the scattering color and extinction values were adjusted until the image looked good. In this kind of scene usually very small values are needed. Note how the container box is quite smaller than the room itself. Container boxes should always be sized as minimally as possible. If the box were as big as the room much higher values for |
|
- same as above only mirrored
As suggested previously, the scattering color and extinction values were adjusted until the image looked good. In this kind of scene usually very small values are needed. Note how the container box is quite smaller than the room itself. Container boxes should always be sized as minimally as possible. If the box were as big as the room much higher values for |
|
- panel of 3 with a border and captions
Keyword Addition Example
This outlines the steps to add a new keyword to the documentation. In this case deprecated
- first determine where the descriptive passage goes then add it
- update the syntax diagram in the appropriate places
- update the Identifiers and Keywords list
- document any other place(s) that it's used
- add a table of contents entry
NEW Template Test Area
- Template:New.3.7.1 The
tau
constant can be used as shorthand for(2*pi)
. - [CHANGED in 3.7.0] The
ambient
value has no effect in radiosity scenes anymore; useemission
instead.