class Elm_Glview (Elm_Widget)
{
   eo_prefix: elm_obj_glview;
   methods {
      version_constructor {
         /*@ Constructor with context version number. */
         legacy: null;
         params {
            @in Evas_GL_Context_Version version;
         }
      }
   }
   properties {
      size {
         set {
            /*@
            @brief Sets the size of the glview

            @if MOBILE @since_tizen 2.3
            @elseif WEARABLE @since_tizen 2.3.1
            @endif

            @ingroup GLView */
         }
         get {
            /*@
            @brief Get the size of the glview.

            @if MOBILE @since_tizen 2.3
            @elseif WEARABLE @since_tizen 2.3.1
            @endif

            @remark Note that this function returns the actual image size of the
            glview. This means that when the scale policy is set to
            #ELM_GLVIEW_RESIZE_POLICY_SCALE, it'll return the non-scaled
            size.

            @ingroup GLView */
         }
         values {
            int w; /*@ width of the glview object */
            int h; /*@ height of the glview object */
         }
      }
      resize_policy {
         set {
            /*@
            @brief Set the resize policy for the glview object.

            @if MOBILE @since_tizen 2.3
            @elseif WEARABLE @since_tizen 2.3.1
            @endif

            @remark By default, the resize policy is set to #ELM_GLVIEW_RESIZE_POLICY_RECREATE.
            When resize is called it destroys the previous surface and recreates the
            newly specified size. If the policy is set to
            #ELM_GLVIEW_RESIZE_POLICY_SCALE, however, glview only scales the image
            object and not the underlying GL Surface.

            @ingroup GLView */
            return: bool;
         }
         values {
            Elm_GLView_Resize_Policy policy; /*@ The scaling policy. */
         }
      }
      changed {
         set {
            /*@
            @brief Notifies that there has been changes in the GLView.

            @if MOBILE @since_tizen 2.3
            @elseif WEARABLE @since_tizen 2.3.1
            @endif

            @ingroup GLView */
         }
      }
      resize_func {
         set {
            /*@
            @brief Set the resize function that gets called when resize happens.

            @if MOBILE @since_tizen 2.3
            @elseif WEARABLE @since_tizen 2.3.1
            @endif

            @remark The resize function gets called during the render loop.
            This function allows glview to hide all the rendering context/surface
            details and have the user just call GL calls that they desire
            when resize happens.

            @ingroup GLView */
         }
         values {
            Elm_GLView_Func_Cb func; /*@ The resize function to be registered. */
         }
      }
      del_func {
         set {
            /*@
            @brief Set the delete function that runs in the main loop.

            @if MOBILE @since_tizen 2.3
            @elseif WEARABLE @since_tizen 2.3.1
            @endif

            @remark The registered del function gets called when GLView object is deleted.
            This function allows glview to hide all the rendering context/surface
            details and have the user just call GL calls that they desire
            when delete happens.

            @ingroup GLView */
         }
         values {
            Elm_GLView_Func_Cb func; /*@ The delete function to be registered. */
         }
      }
      init_func {
         set {
            /*@
            @brief Set the init function that runs once in the main loop.

            @if MOBILE @since_tizen 2.3
            @elseif WEARABLE @since_tizen 2.3.1
            @endif

            @remark The registered init function gets called once during the render loop.
            This function allows glview to hide all the rendering context/surface
            details and have the user just call GL calls that they desire
            for initialization GL calls.

            @ingroup GLView */
         }
         values {
            Elm_GLView_Func_Cb func; /*@ The init function to be registered. */
         }
      }
      render_policy {
         set {
            /*@
            @brief Set the render policy for the glview object.

            @if MOBILE @since_tizen 2.3
            @elseif WEARABLE @since_tizen 2.3.1
            @endif

            @remark By default, the render policy is set to #ELM_GLVIEW_RENDER_POLICY_ON_DEMAND.
            This policy is set such that during the render loop, glview is only
            redrawn if it needs to be redrawn. (i.e. when it is visible) If the policy
            is set to #ELM_GLVIEWW_RENDER_POLICY_ALWAYS, it redraws regardless of
            whether it is visible or needs redrawing.

            @ingroup GLView */
            return: bool;
         }
         values {
            Elm_GLView_Render_Policy policy; /*@ The render policy. */
         }
      }
      mode {
         set {
            /*@
            @brief Set the mode of the GLView. Supports alpha, depth, stencil.

            @if MOBILE @since_tizen 2.3
            @elseif WEARABLE @since_tizen 2.3.1
            @endif

            @return True if set properly.

            @remark Direct is a hint for the elm_glview to render directly to the window
            given that the right conditions are met. Otherwise it falls back
            to rendering to an offscreen buffer before it gets composited to the
            window.

            @ingroup GLView */
            return: bool;
         }
         values {
            Elm_GLView_Mode mode; /*@ The mode Options OR'ed enabling Alpha, Depth, Stencil, Direct. */
         }
      }
      render_func {
         set {
            /*@
            @brief Set the render function that runs in the main loop.

            @if MOBILE @since_tizen 2.3
            @elseif WEARABLE @since_tizen 2.3.1
            @endif

            @remark The render function gets called in the main loop but whether it runs
            depends on the rendering policy and whether elm_glview_changed_set()
            gets called.

            @ingroup GLView */
         }
         values {
            Elm_GLView_Func_Cb func; /*@ The render function to be registered. */
         }
      }
      gl_api {
         get {
            /*@
            @brief Get the gl api struct for gl rendering

            @if MOBILE @since_tizen 2.3
            @elseif WEARABLE @since_tizen 2.3.1
            @endif

            @return The api object or NULL if it cannot be created

            @ingroup GLView */
            return: Evas_GL_API *;
         }
      }
      evas_gl {
         get {
            /*@
            @brief Get the internal Evas GL attached to this view.

            @if MOBILE @since_tizen 2.3
            @elseif WEARABLE @since_tizen 2.3.1
            @endif

            @remark The returned Evas_GL must not be destroyed as it is still owned
            by the view. But this pointer can be used then to call all the evas_gl_
            functions.

            @since 1.12

            @return The Evas_GL used by this GLView.

            @ingroup GLView */
            return: Evas_GL *;
         }
      }
      rotation {
         get {
            /*@
            @brief Get the current GL view's rotation when using direct rendering

            @since_tizen 2.4

            @return A window rotation in degrees (0, 90, 180 or 270)

            @note This rotation can be different from the device orientation. This
                  rotation value must be used in case of direct rendering and should be
                  taken into account by the application when setting the internal rotation
                  matrix for the view.

            @see ELM_GLVIEW_CLIENT_SIDE_ROTATION

            @since 1.12

            @ingroup GLView */
            return: int;
         }
      }
   }
   implements {
      class.constructor;
      Eo.Base.constructor;
      Evas.Object_Smart.add;
      Evas.Object_Smart.del;
      Evas.Object_Smart.resize;
      Elm_Widget.on_focus;
   }
   events {
      focused;
      unfocused;
      language,changed;
      access,changed;
   }
   constructors {
      .version_constructor;
   }
}
