Difference between revisions of "Notes2 Design NoteAnchor"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Moved "NoteAnchor" from the Notes2 wiki page to this page.)
(Added proposal from (rather old) proposal document Proposal "Simple Brackets (Note Anchor Area)")
Line 23: Line 23:
  
 
=== Proposal "Simple Brackets (Note Anchor Area)" ===
 
=== Proposal "Simple Brackets (Note Anchor Area)" ===
tbd
+
 
 +
{| class="prettytable" border="0"
 +
| [[Image:Notes2 DesignProposal AnchorBracket TextExample.png|thumb|center]]
 +
| The Note Anchor Area is marked up by two brackets with a corresponding text background color between them.
 +
|}
 +
 
 +
'''Advantages:'''
 +
* Unobtrusive design (only few text overlay)
 +
* Brackets are often used by users to comment things.
 +
 
 +
'''Disadvantages:'''
 +
* Background color of document text can not be shown
 +
 
 +
 
 +
'''Detailed specification:'''
 +
* The drawing at the bottom shows a region of a horizontal text line:
 +
** The ascender line (line n) marks the highest ascender of the anchor text
 +
** The descender line marks the lowest descender of the anchor text
 +
** The ascender line (line n+1) marks the highest ascender line of the text in the whole subsequent text line
 +
** g is the height between descender line and ascender line (line n+1) and therefore the visible gap between text line n and text line n+1.
 +
 
 +
* Anchor area:
 +
** The anchor area is drawn between text background color and text (if viewed as a kind of stack).
 +
** a is the height between ascender line and descender line
 +
** b is the length between “first character of anchor text begins” and “last character in anchor text ends”. (Maybe we need here a special handling if b < 2e-2d.)
 +
 
 +
* Anchor brackets:
 +
** In general, the lines for the anchor brackets stay behind the text.
 +
** e = 1/4 a
 +
** c = 1/3 e (but at least 1 screen pixel)
 +
** d = c (but at least 1 screen pixel)
 +
** f = 1/4 a
 +
** x = c
 +
** y = 2 x
 +
** z = 1.5 d
 +
 
 +
* Example (rounded): If a = 12 screen pixels, then: e = 3 screen pixels, c = 1 screen pixel, d = 1 screen pixel, f=3 screen pixels, x = 1 screen pixel, y = 2 screen pixels, z = 2 screen pixels
 +
 
 +
[[Image:Notes2 DesignProposal AnchorBracket Dimensions.png|305px|thumb|center]]
  
 
=== Proposal "Boxes (Note Anchor Area)" ===
 
=== Proposal "Boxes (Note Anchor Area)" ===

Revision as of 22:06, 21 January 2008

< Back to the Notes2 main page

Summary

The Note Anchor is the element which marks the reference position of the Note Data in the Document.

Rationale

For improved clearness, the Notes Data is not displayed inside the Document. Consequently, an Anchor is necessary to indicate the reference position.

Assumptions

tbd

Proposed Designs

Proposal "Triangle (Note Anchor Point)"

tbd

Proposal "Double Arrow (Note Anchor Point)"

tbd

Proposal "Simple Brackets (Note Anchor Area)"

Notes2 DesignProposal AnchorBracket TextExample.png
The Note Anchor Area is marked up by two brackets with a corresponding text background color between them.

Advantages:

  • Unobtrusive design (only few text overlay)
  • Brackets are often used by users to comment things.

Disadvantages:

  • Background color of document text can not be shown


Detailed specification:

  • The drawing at the bottom shows a region of a horizontal text line:
    • The ascender line (line n) marks the highest ascender of the anchor text
    • The descender line marks the lowest descender of the anchor text
    • The ascender line (line n+1) marks the highest ascender line of the text in the whole subsequent text line
    • g is the height between descender line and ascender line (line n+1) and therefore the visible gap between text line n and text line n+1.
  • Anchor area:
    • The anchor area is drawn between text background color and text (if viewed as a kind of stack).
    • a is the height between ascender line and descender line
    • b is the length between “first character of anchor text begins” and “last character in anchor text ends”. (Maybe we need here a special handling if b < 2e-2d.)
  • Anchor brackets:
    • In general, the lines for the anchor brackets stay behind the text.
    • e = 1/4 a
    • c = 1/3 e (but at least 1 screen pixel)
    • d = c (but at least 1 screen pixel)
    • f = 1/4 a
    • x = c
    • y = 2 x
    • z = 1.5 d
  • Example (rounded): If a = 12 screen pixels, then: e = 3 screen pixels, c = 1 screen pixel, d = 1 screen pixel, f=3 screen pixels, x = 1 screen pixel, y = 2 screen pixels, z = 2 screen pixels
Notes2 DesignProposal AnchorBracket Dimensions.png

Proposal "Boxes (Note Anchor Area)"

tbd

Proposal "Resizing (Note Anchor Area)"

This proposal extends the proposal "Boxes".

The proposal includes some ideas how to make the Note Anchor Area resizable after it's inital creation. Due to the fact that this (at least cool) feature is not planned in the near future, it will not be discussed in depth. At this point it is important to get an idea how this could look like.

Some ideas for the visualization of Anchor Area
The image shows some ideas for the visualization of Note Anchor Areas. It contains:
  • a group of Note Anchor Areas next to each other
  • a very small Note Anchor Selection of one character
  • some grips to resize the Note Anchor Areas by using the mouse
  • a Note Anchor Area which was created by block selected text

Selected Design

  • The selected design for the Note Anchor Point is "Double Arrow".
  • The selected design for the Note Anchor Areas is "Boxes".

Implementation

At the moment it is not possible to draw elements behind the text. The graphical Note elements in the Writer document window can only be displayed on top of the document. Therefore the background can not be implemented until Writer provides this capability.

Code Changes

tbd

Outstanding Issues

tbd

Personal tools