diff options
author | Jean-Philippe Andre <jp.andre@samsung.com> | 2016-03-15 11:27:15 +0900 |
---|---|---|
committer | Jean-Philippe Andre <jp.andre@samsung.com> | 2016-03-15 11:27:15 +0900 |
commit | 2b249423e7bfa422256c6828763029065ebf232b (patch) | |
tree | 6d76b78544cc366d8d8b03c6b7d63f6f20155009 | |
parent | b23909844160196b654c13fbd7c20320e359c508 (diff) | |
download | efl-2b249423e7bfa422256c6828763029065ebf232b.tar.gz |
Efl.Gfx.View: Try to document view_size
This is not easy as the view size might have different meanings.
Also, it's just not quite clear in my mind what it is :)
-rw-r--r-- | src/lib/efl/interfaces/efl_gfx_view.eo | 29 |
1 files changed, 19 insertions, 10 deletions
diff --git a/src/lib/efl/interfaces/efl_gfx_view.eo b/src/lib/efl/interfaces/efl_gfx_view.eo index 9e658cbe5a..47a1d18b33 100644 --- a/src/lib/efl/interfaces/efl_gfx_view.eo +++ b/src/lib/efl/interfaces/efl_gfx_view.eo @@ -5,21 +5,30 @@ interface Efl.Gfx.View { @property view_size { [[The dimensions of this object's viewport. - FIXME - WRONG DOC!!! - USELESS API for image files + This property represents the size of an image (file on disk, + vector graphics, GL or 3D scene, ...) view: this is the logical + size of a view, not the number of pixels in the buffer, nor its + visible size on the window. - This property will scale down or crop the image so that it is - treated as if it were of the given size. If the given size is - smaller than the image, it will be cropped. If it's larger, then - the image will be treated as if it were in the upper left corner - of a larger image that is otherwise transparent. + For scalable scenes (vector graphics, 3D or GL), this means scaling + the contents of the scene and drawing more pixels as a result; For + pixmaps this means zooming and stretching up or down the backing + buffer to fit this view. + + In most cases the view should have the same dimensions as the + object on the canvas, for best quality. + + @.view_size.set may not be implemented. If it is, it might trigger + a complete recalculation of the scene, or reload of the pixel data. + + Refer to each implementing class specific documentation for more + details. ]] set {} get {} values { - w: int; [[The new width of the image.]] - h: int; [[The new height of the image.]] + w: int; [[Width of the view.]] + h: int; [[Height of the view.]] } } } |