/*
 * This file is part of gtkD.
 *
 * gtkD is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License
 * as published by the Free Software Foundation; either version 3
 * of the License, or (at your option) any later version, with
 * some exceptions, please read the COPYING file.
 *
 * gtkD is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with gtkD; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA
 */
 
// generated automatically - do not change
// find conversion definition on APILookup.txt
// implement new conversion functionalities on the wrap.utils pakage

/*
 * Conversion parameters:
 * inFile  = gdk3-GdkFrameClock.html
 * outPack = gdk
 * outFile = FrameClock
 * strct   = GdkFrameClock
 * realStrct=
 * ctorStrct=
 * clss    = FrameClock
 * interf  = 
 * class Code: No
 * interface Code: No
 * template for:
 * extend  = 
 * implements:
 * prefixes:
 * 	- gdk_frame_clock_
 * omit structs:
 * omit prefixes:
 * omit code:
 * omit signals:
 * imports:
 * 	- gdk.FrameTimings
 * structWrap:
 * 	- GdkFrameTimings* -> FrameTimings
 * module aliases:
 * local aliases:
 * overrides:
 */

module gdk.FrameClock;

public  import gtkc.gdktypes;

private import gtkc.gdk;
private import glib.ConstructionException;
private import gobject.ObjectG;

private import gdk.FrameTimings;



/**
 * A GdkFrameClock tells the application when to update and repaint a
 * window. This may be synced to the vertical refresh rate of the
 * monitor, for example. Even when the frame clock uses a simple timer
 * rather than a hardware-based vertical sync, the frame clock helps
 * because it ensures everything paints at the same time (reducing the
 * total number of frames). The frame clock can also automatically
 * stop painting when it knows the frames will not be visible, or
 * scale back animation framerates.
 *
 * GdkFrameClock is designed to be compatible with an OpenGL-based
 * implementation or with mozRequestAnimationFrame in Firefox,
 * for example.
 *
 * A frame clock is idle until someone requests a frame with
 * gdk_frame_clock_request_phase(). At some later point that makes
 * sense for the synchronization being implemented, the clock will
 * process a frame and emit signals for each phase that has been
 * requested. (See the signals of the GdkFrameClock class for
 * documentation of the phases. GDK_FRAME_CLOCK_PHASE_UPDATE and the
 * "update" signal are most interesting for application
 * writers, and are used to update the animations, using the frame time
 * given by gdk_frame_clock_get_frame_time().
 *
 * The frame time is reported in microseconds and generally in the same
 * timescale as g_get_monotonic_time(), however, it is not the same
 * as g_get_monotonic_time(). The frame time does not advance during
 * the time a frame is being painted, and outside of a frame, an attempt
 * is made so that all calls to gdk_frame_clock_get_frame_time() that
 * are called at a "similar" time get the same value. This means that
 * if different animations are timed by looking at the difference in
 * time between an initial value from gdk_frame_clock_get_frame_time()
 * and the value inside the "update" signal of the clock,
 * they will stay exactly synchronized.
 */
public class FrameClock
{
	
	/** the main Gtk struct */
	protected GdkFrameClock* gdkFrameClock;
	
	
	/** Get the main Gtk struct */
	public GdkFrameClock* getFrameClockStruct()
	{
		return gdkFrameClock;
	}
	
	
	/** the main Gtk struct as a void* */
	protected void* getStruct()
	{
		return cast(void*)gdkFrameClock;
	}
	
	/**
	 * Sets our main struct and passes it to the parent class
	 */
	public this (GdkFrameClock* gdkFrameClock)
	{
		this.gdkFrameClock = gdkFrameClock;
	}
	
	/**
	 */
	
	/**
	 * Gets the time that should currently be used for animations. Inside
	 * the processing of a frame, it's the time used to compute the
	 * animation position of everything in a frame. Outside of a frame, it's
	 * the time of the conceptual "previous frame," which may be either
	 * the actual previous frame time, or if that's too old, an updated
	 * time.
	 * Returns: a timestamp in microseconds, in the timescale of of g_get_monotonic_time(). Since 3.8
	 */
	public long getFrameTime()
	{
		// gint64 gdk_frame_clock_get_frame_time (GdkFrameClock *frame_clock);
		return gdk_frame_clock_get_frame_time(gdkFrameClock);
	}
	
	/**
	 * Asks the frame clock to run a particular phase. The signal
	 * corresponding the requested phase will be emitted the next
	 * time the frame clock processes. Multiple calls to
	 * gdk_frame_clock_request_phase() will be combined together
	 * and only one frame processed. If you are displaying animated
	 * content and want to continually request the
	 * GDK_FRAME_CLOCK_PHASE_UPDATE phase for a period of time,
	 * you should use gdk_frame_clock_begin_updating() instead, since
	 * this allows GTK+ to adjust system parameters to get maximally
	 * smooth animations.
	 * Params:
	 * phase = the phase that is requested
	 * Since 3.8
	 */
	public void requestPhase(GdkFrameClockPhase phase)
	{
		// void gdk_frame_clock_request_phase (GdkFrameClock *frame_clock,  GdkFrameClockPhase phase);
		gdk_frame_clock_request_phase(gdkFrameClock, phase);
	}
	
	/**
	 * Starts updates for an animation. Until a matching call to
	 * gdk_frame_clock_end_updating() is made, the frame clock will continually
	 * request a new frame with the GDK_FRAME_CLOCK_PHASE_UPDATE phase.
	 * This function may be called multiple times and frames will be
	 * requested until gdk_frame_clock_end_updating() is called the same
	 * number of times.
	 */
	public void beginUpdating()
	{
		// void gdk_frame_clock_begin_updating (GdkFrameClock *frame_clock);
		gdk_frame_clock_begin_updating(gdkFrameClock);
	}
	
	/**
	 * Stops updates for an animation. See the documentation for
	 * gdk_frame_clock_begin_updating().
	 */
	public void endUpdating()
	{
		// void gdk_frame_clock_end_updating (GdkFrameClock *frame_clock);
		gdk_frame_clock_end_updating(gdkFrameClock);
	}
	
	/**
	 * A GdkFrameClock maintains a 64-bit counter that increments for
	 * each frame drawn.
	 * Returns: inside frame processing, the value of the frame counter for the current frame. Outside of frame processing, the frame counter for the last frame. Since 3.8
	 */
	public long getFrameCounter()
	{
		// gint64 gdk_frame_clock_get_frame_counter (GdkFrameClock *frame_clock);
		return gdk_frame_clock_get_frame_counter(gdkFrameClock);
	}
	
	/**
	 * GdkFrameClock internally keeps a history of GdkFrameTiming
	 * objects for recent frames that can be retrieved with
	 * gdk_frame_clock_get_timings(). The set of stored frames
	 * is the set from the counter values given by
	 * gdk_frame_clock_get_history_start() and
	 * gdk_frame_clock_get_frame_counter(), inclusive.
	 * Returns: the frame counter value for the oldest frame that is available in the internal frame history of the GdkFrameClock. Since 3.8
	 */
	public long getHistoryStart()
	{
		// gint64 gdk_frame_clock_get_history_start (GdkFrameClock *frame_clock);
		return gdk_frame_clock_get_history_start(gdkFrameClock);
	}
	
	/**
	 * Retrieves a GdkFrameTimings object holding timing information
	 * for the current frame or a recent frame. The GdkFrameTimings
	 * object may not yet be complete: see gdk_frame_timings_get_complete().
	 * Params:
	 * frameCounter = the frame counter value identifying the frame to
	 * be received.
	 * Returns: the GdkFrameTimings object for the specified frame, or NULL if it is not available. See gdk_frame_clock_get_history_start(). Since 3.8
	 */
	public FrameTimings getTimings(long frameCounter)
	{
		// GdkFrameTimings * gdk_frame_clock_get_timings (GdkFrameClock *frame_clock,  gint64 frame_counter);
		auto p = gdk_frame_clock_get_timings(gdkFrameClock, frameCounter);
		
		if(p is null)
		{
			return null;
		}
		
		return ObjectG.getDObject!(FrameTimings)(cast(GdkFrameTimings*) p);
	}
	
	/**
	 * Gets the frame timings for the current frame.
	 * Returns: the GdkFrameTimings for the frame currently being processed, or even no frame is being processed, for the previous frame. Before any frames have been procesed, returns NULL. Since 3.8
	 */
	public FrameTimings getCurrentTimings()
	{
		// GdkFrameTimings * gdk_frame_clock_get_current_timings (GdkFrameClock *frame_clock);
		auto p = gdk_frame_clock_get_current_timings(gdkFrameClock);
		
		if(p is null)
		{
			return null;
		}
		
		return ObjectG.getDObject!(FrameTimings)(cast(GdkFrameTimings*) p);
	}
	
	/**
	 * Using the frame history stored in the frame clock, finds the last
	 * known presentation time and refresh interval, and assuming that
	 * presentation times are separated by the refresh interval,
	 * predicts a presentation time that is a multiple of the refresh
	 * interval after the last presentation time, and later than base_time.
	 * Params:
	 * baseTime = base time for determining a presentaton time
	 * refreshIntervalReturn = a location to store the determined refresh
	 * interval, or NULL. A default refresh interval of 1/60th of
	 * a second will be stored if no history is present.
	 * presentationTimeReturn = a location to store the next
	 * candidate presentation time after the given base time.
	 * 0 will be will be stored if no history is present.
	 * Since 3.8
	 */
	public void getRefreshInfo(long baseTime, out long refreshIntervalReturn, out long presentationTimeReturn)
	{
		// void gdk_frame_clock_get_refresh_info (GdkFrameClock *frame_clock,  gint64 base_time,  gint64 *refresh_interval_return,  gint64 *presentation_time_return);
		gdk_frame_clock_get_refresh_info(gdkFrameClock, baseTime, &refreshIntervalReturn, &presentationTimeReturn);
	}
}