On 07/10/2011 13:02, Yegor Kozlov wrote:
Something to improve for 3.8-FINAL. You are very much welcome to post
the corrected javadoc for ClientAnchor:)
I wrote a blog (which noone reads :-) ) on it:
http://www.spudsoft.co.uk/?p=439
You are welcome to take anything from there if you want (including the
diagram).
However as a specific proposal for alternate text for the javadoc how
about this for the class description (I think the units should be
explained there):
A client anchor is attached to an excel worksheet. It anchors against a
top-left and bottom-right cell, with delta distances into those cells.
Note that XSSF and HSSF have completely different coordinate systems for
the delta values.For HSSF the delta values are fractional, with 256
(0-255) vertical (Dy) units and 1024 (0-1023) horizontal (Dx) units per
cell.For XSSF the delta values are absolute and are measured in EMUs
(there are 36,000 EMUs per millimetre, 914,400 EMUs per inch and 12,700
EMUs per point).
You could, of course, put the explanation of the units into the DX/Y
getters/setters too.
Hope this is of some benefit.
Jim
