Difference between revisions of "User:Regina/MYDrafts4"

From Apache OpenOffice Wiki
Jump to: navigation, search
Line 54: Line 54:
 
|-
 
|-
 
| <tt>scale( sx [ sy ])</tt>, specifies a scale operation by sx and sy.
 
| <tt>scale( sx [ sy ])</tt>, specifies a scale operation by sx and sy.
| "scale operation" is acceptable, but I suggest give the equivalent matrix here too, to make it uniform.
+
| "scale operation" is acceptable, but I suggest to give the equivalent matrix here too, to make it uniform.
  
 
Suggestion:
 
Suggestion:
Line 60: Line 60:
 
The value <tt>scale( s )</tt> is equivalent to the value <tt>matrix( s 0 0 s 0 0)</tt>. The value <tt>scale( sx sy )</tt> is equivalent to the value <tt>matrix( sx 0 0 sy 0 0)</tt>.
 
The value <tt>scale( s )</tt> is equivalent to the value <tt>matrix( s 0 0 s 0 0)</tt>. The value <tt>scale( sx sy )</tt> is equivalent to the value <tt>matrix( sx 0 0 sy 0 0)</tt>.
 
|-
 
|-
|
+
| <tt>skewX(skew-angle)</tt>, specifies a skew transformation by <rotate-angle> degrees along the x-axis.
|
+
| Typo: "rotate-angle" should be "skew-angle".
 +
 
 +
Here is neither clear between which rays the angle is measured, nor what direction is used.
 +
 
 +
Suggestion:
 +
 
 +
The value <tt>skewX(a)</tt> is equivalent to the value <tt>matrix( 1 0 tan(a) 1 0 0)</tt>.
 +
 
 +
In addition a picture is useful, because the term "shear mapping" is more common than "skew".
 
|}
 
|}

Revision as of 23:32, 8 August 2012

Problems With Angle Definitions in ODF1.2

Coordinate System

There are two common ways to orientate a Cartesian coordinate system

mathematical orientation Bild
screen orientation Bild

Only when the orientation is determined, terms like "clockwise" are unambigious. Such orientation rule is missing in ODF 1.2.

Suggestion:

If a rule refers to a two-dimensional coordinate system, a Cartesian coordinate system in screen orientation (see figure ##) is used. The directions "clockwise", "counter clockwise", and the edge descriptions "left", "top", "right" and "button" are accordingly defined as shown in figures [##] to [##].

clockwise Bild
counter clockwise Bild
left, top, right, bottom Bild

Angles in Attribute draw:transform

These suggestions are all about section 19.228. (Because of the Wiki markup I skipped the characters < and >).

Original Problems and Suggestions
The whole original text is very near to SVG section 7, but a reference is missing.
matrix(a b c d e f), specifies a transformation in the form of a transformation matrix of six values. "The values describe... No problems, but the quotation mark before 'The values' has to be removed.
rotate(rotate-angle), specifies a rotation by rotate-angle degrees about the origin of the shapes coordinate system. The orientation of the rotation is missing. I suggest not to use "clockwise" but to define it by an equivalent matrix.

Suggestion:

The value rotate(a) is equivalent to the value matrix( cos(a) sin(a) −sin(a) cos(a) 0 0).

scale( sx [ sy ]), specifies a scale operation by sx and sy. "scale operation" is acceptable, but I suggest to give the equivalent matrix here too, to make it uniform.

Suggestion:

The value scale( s ) is equivalent to the value matrix( s 0 0 s 0 0). The value scale( sx sy ) is equivalent to the value matrix( sx 0 0 sy 0 0).

skewX(skew-angle), specifies a skew transformation by <rotate-angle> degrees along the x-axis. Typo: "rotate-angle" should be "skew-angle".

Here is neither clear between which rays the angle is measured, nor what direction is used.

Suggestion:

The value skewX(a) is equivalent to the value matrix( 1 0 tan(a) 1 0 0).

In addition a picture is useful, because the term "shear mapping" is more common than "skew".

Personal tools