summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorJean-Philippe Andre <jp.andre@samsung.com>2016-03-15 11:27:15 +0900
committerJean-Philippe Andre <jp.andre@samsung.com>2016-03-15 11:27:15 +0900
commit2b249423e7bfa422256c6828763029065ebf232b (patch)
tree6d76b78544cc366d8d8b03c6b7d63f6f20155009 /src
parentb23909844160196b654c13fbd7c20320e359c508 (diff)
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 :)
Diffstat (limited to 'src')
-rw-r--r--src/lib/efl/interfaces/efl_gfx_view.eo29
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 {
5 @property view_size { 5 @property view_size {
6 [[The dimensions of this object's viewport. 6 [[The dimensions of this object's viewport.
7 7
8 FIXME 8 This property represents the size of an image (file on disk,
9 WRONG DOC!!! 9 vector graphics, GL or 3D scene, ...) view: this is the logical
10 USELESS API for image files 10 size of a view, not the number of pixels in the buffer, nor its
11 visible size on the window.
11 12
12 This property will scale down or crop the image so that it is 13 For scalable scenes (vector graphics, 3D or GL), this means scaling
13 treated as if it were of the given size. If the given size is 14 the contents of the scene and drawing more pixels as a result; For
14 smaller than the image, it will be cropped. If it's larger, then 15 pixmaps this means zooming and stretching up or down the backing
15 the image will be treated as if it were in the upper left corner 16 buffer to fit this view.
16 of a larger image that is otherwise transparent. 17
18 In most cases the view should have the same dimensions as the
19 object on the canvas, for best quality.
20
21 @.view_size.set may not be implemented. If it is, it might trigger
22 a complete recalculation of the scene, or reload of the pixel data.
23
24 Refer to each implementing class specific documentation for more
25 details.
17 ]] 26 ]]
18 set {} 27 set {}
19 get {} 28 get {}
20 values { 29 values {
21 w: int; [[The new width of the image.]] 30 w: int; [[Width of the view.]]
22 h: int; [[The new height of the image.]] 31 h: int; [[Height of the view.]]
23 } 32 }
24 } 33 }
25 } 34 }