forked from enlightenment/efl
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 :)
This commit is contained in:
parent
b239098441
commit
2b249423e7
|
@ -5,21 +5,30 @@ interface Efl.Gfx.View {
|
||||||
@property view_size {
|
@property view_size {
|
||||||
[[The dimensions of this object's viewport.
|
[[The dimensions of this object's viewport.
|
||||||
|
|
||||||
FIXME
|
This property represents the size of an image (file on disk,
|
||||||
WRONG DOC!!!
|
vector graphics, GL or 3D scene, ...) view: this is the logical
|
||||||
USELESS API for image files
|
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
|
For scalable scenes (vector graphics, 3D or GL), this means scaling
|
||||||
treated as if it were of the given size. If the given size is
|
the contents of the scene and drawing more pixels as a result; For
|
||||||
smaller than the image, it will be cropped. If it's larger, then
|
pixmaps this means zooming and stretching up or down the backing
|
||||||
the image will be treated as if it were in the upper left corner
|
buffer to fit this view.
|
||||||
of a larger image that is otherwise transparent.
|
|
||||||
|
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 {}
|
set {}
|
||||||
get {}
|
get {}
|
||||||
values {
|
values {
|
||||||
w: int; [[The new width of the image.]]
|
w: int; [[Width of the view.]]
|
||||||
h: int; [[The new height of the image.]]
|
h: int; [[Height of the view.]]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
Loading…
Reference in New Issue