forked from enlightenment/efl
evas_image: finish doc conversion
This commit is contained in:
parent
11101af3bb
commit
d737233dd5
|
@ -561,237 +561,204 @@ class Evas.Image (Evas.Object, Efl.File, Efl.Image, Efl.Gfx.Fill, Efl.Gfx.View,
|
||||||
}
|
}
|
||||||
@property stride {
|
@property stride {
|
||||||
get {
|
get {
|
||||||
/*@
|
[[Retrieves the row stride of the given image object.
|
||||||
Retrieves the row stride of the given image object.
|
|
||||||
|
|
||||||
@return The stride of the image (<b>in bytes</b>).
|
The row stride is the number of bytes between the start of a
|
||||||
|
row and the start of the next row for image data.
|
||||||
The row stride is the number of bytes between the start of a row
|
]]
|
||||||
and the start of the next row for image data. */
|
return: int @warn_unused; [[The stride of the image (in bytes).]]
|
||||||
return: int @warn_unused;
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@property animated_loop_type {
|
@property animated_loop_type {
|
||||||
get {
|
get {
|
||||||
/*@
|
[[Get the kind of looping the image object does.
|
||||||
Get the kind of looping the image object does.
|
|
||||||
|
|
||||||
@return Loop type of the image object
|
This returns the kind of looping the image object wants to do.
|
||||||
|
|
||||||
This returns the kind of looping the image object wants to do.
|
If it returns EVAS_IMAGE_ANIMATED_HINT_LOOP, you should display
|
||||||
|
frames in a sequence like: 1->2->3->1->2->3->1...
|
||||||
|
|
||||||
If it returns EVAS_IMAGE_ANIMATED_HINT_LOOP, you should display frames in a sequence like:
|
If it returns EVAS_IMAGE_ANIMATED_HINT_PINGPONG, it is better
|
||||||
1->2->3->1->2->3->1...
|
to display frames in a sequence like: 1->2->3->2->1->2->3->1...
|
||||||
If it returns EVAS_IMAGE_ANIMATED_HINT_PINGPONG, it is better to
|
|
||||||
display frames in a sequence like: 1->2->3->2->1->2->3->1...
|
|
||||||
|
|
||||||
The default type is EVAS_IMAGE_ANIMATED_HINT_LOOP.
|
The default type is EVAS_IMAGE_ANIMATED_HINT_LOOP.
|
||||||
|
|
||||||
@see evas_object_image_animated_get()
|
See also \@ref evas_object_image_animated_get,
|
||||||
@see evas_object_image_animated_frame_count_get()
|
@.animated_frame_count.get, @.animated_loop_type.get,
|
||||||
@see evas_object_image_animated_loop_type_get()
|
@.animated_loop_count.get, @.animated_frame_duration_get.
|
||||||
@see evas_object_image_animated_loop_count_get()
|
|
||||||
@see evas_object_image_animated_frame_duration_get()
|
@since 1.1
|
||||||
@see evas_object_image_animated_frame_set()
|
]]
|
||||||
@since 1.1 */
|
return: Evas_Image_Animated_Loop_Hint; [[Loop type of the image object.]]
|
||||||
return: Evas_Image_Animated_Loop_Hint;
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@property animated_loop_count {
|
@property animated_loop_count {
|
||||||
get {
|
get {
|
||||||
/*@
|
[[Get the number times the animation of the object loops.
|
||||||
Get the number times the animation of the object loops.
|
|
||||||
|
|
||||||
@return The number of loop of an animated image object
|
This returns loop count of image. The loop count is the number
|
||||||
|
of times the animation will play fully from first to last frame
|
||||||
|
until the animation should stop (at the final frame).
|
||||||
|
|
||||||
This returns loop count of image. The loop count is the number of times
|
If 0 is returned, then looping should happen indefinitely
|
||||||
the animation will play fully from first to last frame until the animation
|
(no limit to the number of times it loops).
|
||||||
should stop (at the final frame).
|
|
||||||
|
|
||||||
If 0 is returned, then looping should happen indefinitely (no limit to
|
See also \@ref evas_object_image_animated_get,
|
||||||
the number of times it loops).
|
@.animated_frame_count.get, @.animated_loop_type.get,
|
||||||
|
@.animated_loop_count.get, @.animated_frame_duration_get.
|
||||||
|
|
||||||
@see evas_object_image_animated_get()
|
@since 1.1
|
||||||
@see evas_object_image_animated_frame_count_get()
|
]]
|
||||||
@see evas_object_image_animated_loop_type_get()
|
return: int; [[The number of loop of an animated image object.]]
|
||||||
@see evas_object_image_animated_loop_count_get()
|
|
||||||
@see evas_object_image_animated_frame_duration_get()
|
|
||||||
@see evas_object_image_animated_frame_set()
|
|
||||||
@since 1.1 */
|
|
||||||
return: int;
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@property scene {
|
@property scene {
|
||||||
set {
|
set {
|
||||||
/*@
|
[[Set the 3D scene of a given image of the canvas.
|
||||||
Set the 3D scene of a given image of the canvas.
|
|
||||||
|
|
||||||
This function sets a 3d scene of a given canvas image.
|
This function sets a 3d scene of a given canvas image.
|
||||||
|
|
||||||
@see evas_object_image_scene_set
|
@since 1.10
|
||||||
@since 1.10 */
|
]]
|
||||||
legacy: null;
|
legacy: null;
|
||||||
}
|
}
|
||||||
get {
|
get {
|
||||||
/*@
|
[[Get the 3D scene of a given image of the canvas.
|
||||||
Get the 3D scene of a given image of the canvas.
|
|
||||||
|
|
||||||
@return The 3d scene of the given canvas image.
|
This function returns the 3d scene of a given canvas image.
|
||||||
|
|
||||||
This function returns the 3d scene of a given canvas image.
|
@since 1.10
|
||||||
|
]]
|
||||||
@see evas_object_image_scene_get
|
legacy: null;
|
||||||
@since 1.10 */
|
|
||||||
legacy: null;
|
|
||||||
}
|
}
|
||||||
values {
|
values {
|
||||||
scene: Evas.Canvas3D.Scene *; /*@ 3D scene on an image object. */
|
scene: Evas.Canvas3D.Scene *; [[3D scene on an image object.]]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@property orient {
|
@property orient {
|
||||||
set {
|
set {
|
||||||
/*@
|
[[Set the image orientation.
|
||||||
Set the image orientation.
|
|
||||||
|
|
||||||
This function allows to rotate or flip the image.
|
This function allows to rotate or flip the image.
|
||||||
|
|
||||||
@see evas_object_image_orient_get()
|
@since 1.14
|
||||||
@see @ref Evas_Image_Orient
|
]]
|
||||||
|
|
||||||
@since 1.14*/
|
|
||||||
}
|
}
|
||||||
get {
|
get {
|
||||||
/*@
|
[[Get the image orientation.
|
||||||
Get the image orientation.
|
|
||||||
|
|
||||||
@return The image orientation @ref Evas_Image_Orient
|
@since 1.14
|
||||||
|
]]
|
||||||
@see evas_object_image_orient_set()
|
|
||||||
@see @ref Evas_Image_Orient
|
|
||||||
|
|
||||||
@since 1.14*/
|
|
||||||
}
|
}
|
||||||
values {
|
values {
|
||||||
orient: Evas_Image_Orient; /*@ The image orientation @ref Evas_Image_Orient
|
orient: Evas_Image_Orient; [[The image orientation \@ref Evas_Image_Orient.
|
||||||
Default is #EVAS_IMAGE_ORIENT_NONE. */
|
Default is #EVAS_IMAGE_ORIENT_NONE.]]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@property snapshot {
|
@property snapshot {
|
||||||
set {
|
set {
|
||||||
/*@
|
[[The content below the Evas_Object_Image will be rendered
|
||||||
The content below the Evas_Object_Image will be rendered inside it and
|
inside it and you can reuse it as a source for any kind
|
||||||
you can reuse it as a source for any kind of effect.
|
of effect.
|
||||||
|
|
||||||
@since 1.15
|
@since 1.15
|
||||||
*/
|
]]
|
||||||
}
|
}
|
||||||
get {
|
get {
|
||||||
/*@
|
[[Determine wether the Evas_Object_Image replicate the content
|
||||||
Determine wether the Evas_Object_Image replicate the content of the
|
of the canvas below.
|
||||||
canvas below.
|
|
||||||
|
|
||||||
@return $true if it does, $false if it doesn't.
|
@since 1.15
|
||||||
@since 1.15
|
]]
|
||||||
*/
|
}
|
||||||
}
|
values {
|
||||||
values {
|
s: bool; [[Wether to put the content of the canvas below inside
|
||||||
s: bool; /*@ Wether to put the content of the canvas below inside the Evas_Object_Image. */
|
the Evas_Object_Image.]]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
preload_begin {
|
preload_begin {
|
||||||
/*@ Begin preloading an image object's image data in the background */
|
[[Begin preloading an image object's image data in the background.]]
|
||||||
legacy: null;
|
legacy: null;
|
||||||
}
|
}
|
||||||
data_update_add {
|
data_update_add {
|
||||||
/*@
|
[[Mark a sub-region of the given image object to be redrawn.
|
||||||
Mark a sub-region of the given image object to be redrawn.
|
|
||||||
|
|
||||||
This function schedules a particular rectangular region of an image
|
|
||||||
object to be updated (redrawn) at the next rendering cycle. */
|
|
||||||
|
|
||||||
|
This function schedules a particular rectangular region of an
|
||||||
|
image object to be updated (redrawn) at the next rendering cycle.
|
||||||
|
]]
|
||||||
params {
|
params {
|
||||||
@in x: int; /*@ X-offset of the region to be updated. */
|
@in x: int; [[X-offset of the region to be updated.]]
|
||||||
@in y: int; /*@ Y-offset of the region to be updated. */
|
@in y: int; [[Y-offset of the region to be updated.]]
|
||||||
@in w: int; /*@ Width of the region to be updated. */
|
@in w: int; [[Width of the region to be updated.]]
|
||||||
@in h: int; /*@ Height of the region to be updated. */
|
@in h: int; [[Height of the region to be updated.]]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
animated_frame_duration_get @const {
|
animated_frame_duration_get @const {
|
||||||
/*@
|
[[Get the duration of a sequence of frames.
|
||||||
Get the duration of a sequence of frames.
|
|
||||||
|
|
||||||
This returns total duration that the specified sequence of frames should
|
This returns total duration that the specified sequence of
|
||||||
take in seconds.
|
frames should take in seconds.
|
||||||
|
|
||||||
If you set start_frame to 1 and frame_num 0, you get frame 1's duration
|
If you set start_frame to 1 and frame_num 0, you get frame 1's
|
||||||
If you set start_frame to 1 and frame_num 1, you get frame 1's duration +
|
duration. If you set start_frame to 1 and frame_num 1, you get
|
||||||
frame2's duration
|
frame 1's duration + frame2's duration.
|
||||||
|
|
||||||
@see evas_object_image_animated_get()
|
See also \@ref evas_object_image_animated_get,
|
||||||
@see evas_object_image_animated_frame_count_get()
|
@.animated_frame_count.get, @.animated_loop_type.get,
|
||||||
@see evas_object_image_animated_loop_type_get()
|
@.animated_loop_count.get, @.animated_frame_duration_get.
|
||||||
@see evas_object_image_animated_loop_count_get()
|
|
||||||
@see evas_object_image_animated_frame_duration_get()
|
@since 1.1
|
||||||
@see evas_object_image_animated_frame_set()
|
]]
|
||||||
@since 1.1 */
|
|
||||||
return: double;
|
return: double;
|
||||||
params {
|
params {
|
||||||
@in start_frame: int; /*@ The first frame */
|
@in start_frame: int; [[The first frame.]]
|
||||||
@in frame_num: int; /*@ Number of frames in the sequence */
|
@in frame_num: int; [[Number of frames in the sequence.]]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
data_set {
|
data_set {
|
||||||
/*@
|
[[Sets the raw image data of the given image object.
|
||||||
Sets the raw image data of the given image object.
|
|
||||||
|
|
||||||
Note that the raw data must be of the same size (see
|
|
||||||
evas_object_image_size_set(), which has to be called @b before this
|
|
||||||
one) and colorspace (see evas_object_image_colorspace_set()) of the
|
|
||||||
image. If data is $null, the current image data will be
|
|
||||||
freed. Naturally, if one does not set an image object's data
|
|
||||||
manually, it will still have one, allocated by Evas.
|
|
||||||
|
|
||||||
@see evas_object_image_data_get() */
|
|
||||||
|
|
||||||
|
Note that the raw data must be of the same size (see
|
||||||
|
\@ref evas_object_image_size_set, which has to be called before
|
||||||
|
this one) and colorspace (see @.colorspace.set) of the image.
|
||||||
|
If data is $null, the current image data will be freed.
|
||||||
|
Naturally, if one does not set an image object's data
|
||||||
|
manually, it will still have one, allocated by Evas.
|
||||||
|
]]
|
||||||
params {
|
params {
|
||||||
@in data: void *; /*@ The raw data, or $null. */
|
@in data: void *; [[The raw data, or $null.]]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
data_get @const {
|
data_get @const {
|
||||||
/*@
|
[[Get a pointer to the raw image data of the given image object.
|
||||||
Get a pointer to the raw image data of the given image object.
|
|
||||||
|
|
||||||
@return The raw image data.
|
This function returns a pointer to an image object's internal
|
||||||
|
pixel buffer, for reading only or read/write. If you request
|
||||||
|
it for writing, the image will be marked dirty so that it gets
|
||||||
|
redrawn at the next update.
|
||||||
|
|
||||||
This function returns a pointer to an image object's internal pixel
|
Each time you call this function on an image object, its data
|
||||||
buffer, for reading only or read/write. If you request it for
|
buffer will have an internal reference counter incremented.
|
||||||
writing, the image will be marked dirty so that it gets redrawn at
|
Decrement it back by using @.data_set.
|
||||||
the next update.
|
|
||||||
|
|
||||||
Each time you call this function on an image object, its data
|
This is best suited for when you want to modify an existing
|
||||||
buffer will have an internal reference counter
|
image, without changing its dimensions.
|
||||||
incremented. Decrement it back by using
|
|
||||||
evas_object_image_data_set().
|
|
||||||
|
|
||||||
This is best suited for when you want to modify an existing image,
|
Note: The contents' format returned by it depend on the color
|
||||||
without changing its dimensions.
|
space of the given image object.
|
||||||
|
|
||||||
@note The contents' format returned by it depend on the color
|
Note: You may want to use @.data_update_add to inform data
|
||||||
space of the given image object.
|
changes, if you did any.
|
||||||
|
]]
|
||||||
@note You may want to use evas_object_image_data_update_add() to
|
return: void * @warn_unused; [[ The raw image data.]]
|
||||||
inform data changes, if you did any.
|
|
||||||
|
|
||||||
@see evas_object_image_data_set() */
|
|
||||||
return: void * @warn_unused;
|
|
||||||
params {
|
params {
|
||||||
@in for_writing: bool; /*@ Whether the data being retrieved will be
|
@in for_writing: bool; [[Whether the data being retrieved will
|
||||||
modified ($true) or not ($false). */
|
be modified ($true) or not ($false).]]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
preload_cancel {
|
preload_cancel {
|
||||||
/*@ Cancel preloading an image object's image data in the background */
|
[[Cancel preloading an image object's image data in the background.]]
|
||||||
legacy: null;
|
legacy: null;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
Loading…
Reference in New Issue