jpeg pushed a commit to branch master.

http://git.enlightenment.org/core/efl.git/commit/?id=2b249423e7bfa422256c6828763029065ebf232b

commit 2b249423e7bfa422256c6828763029065ebf232b
Author: Jean-Philippe Andre <jp.an...@samsung.com>
Date:   Tue Mar 15 11:27:15 2016 +0900

    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 :)
---
 src/lib/efl/interfaces/efl_gfx_view.eo | 29 +++++++++++++++++++----------
 1 file 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 9e658cb..47a1d18 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.]]
          }
       }
    }

-- 


Reply via email to