[sdl_omap.git] / docs / html / time.html

<HTML
><HEAD
><TITLE
>Time</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
HREF="index.html"><LINK
REL="UP"
TITLE="SDL Reference"
HREF="reference.html"><LINK
REL="PREVIOUS"
TITLE="SDL_CondWaitTimeout"
HREF="sdlcondwaittimeout.html"><LINK
REL="NEXT"
TITLE="SDL_GetTicks"
HREF="sdlgetticks.html"><META
NAME="KEYWORD"
CONTENT="time"><META
NAME="KEYWORD"
CONTENT="function"></HEAD
><BODY
CLASS="CHAPTER"
BGCOLOR="#FFF8DC"
TEXT="#000000"
LINK="#0000ee"
VLINK="#551a8b"
ALINK="#ff0000"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>SDL Library Documentation</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="sdlcondwaittimeout.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="sdlgetticks.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="CHAPTER"
><H1
><A
NAME="TIME"
></A
>Chapter 13. Time</H1
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="sdlgetticks.html"
>SDL_GetTicks</A
>&nbsp;--&nbsp;Get the number of milliseconds since the SDL library initialization.</DT
><DT
><A
HREF="sdldelay.html"
>SDL_Delay</A
>&nbsp;--&nbsp;Wait a specified number of milliseconds before returning.</DT
><DT
><A
HREF="sdladdtimer.html"
>SDL_AddTimer</A
>&nbsp;--&nbsp;Add a timer which will call a callback after the specified number of milliseconds has
elapsed.</DT
><DT
><A
HREF="sdlremovetimer.html"
>SDL_RemoveTimer</A
>&nbsp;--&nbsp;Remove a timer which was added with
<A
HREF="sdladdtimer.html"
>SDL_AddTimer</A
>.</DT
><DT
><A
HREF="sdlsettimer.html"
>SDL_SetTimer</A
>&nbsp;--&nbsp;Set a callback to run after the specified number of milliseconds has
elapsed.</DT
></DL
></DIV
><P
>SDL provides several cross-platform functions for dealing with time.
It provides a way to get the current time, a way to wait a little while,
and a simple timer mechanism.  These functions give you two ways of moving an
object every x milliseconds:

<P
></P
><UL
><LI
><P
>Use a timer callback function.  This may have the bad effect that it runs in a seperate thread or uses alarm signals, but it's easier to implement.</P
></LI
><LI
><P
>Or you can get the number of milliseconds passed, and move the object if, for example, 30 ms passed.</P
></LI
></UL
>&#13;</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="sdlcondwaittimeout.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="sdlgetticks.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>SDL_CondWaitTimeout</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="reference.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>SDL_GetTicks</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
Commit	Line	Data
e14743d1	1	<HTML
	2	><HEAD
	3	><TITLE
	4	>Time</TITLE
	5	><META
	6	NAME="GENERATOR"
	7	CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
	8	"><LINK
	9	REL="HOME"
	10	TITLE="SDL Library Documentation"
	11	HREF="index.html"><LINK
	12	REL="UP"
	13	TITLE="SDL Reference"
	14	HREF="reference.html"><LINK
	15	REL="PREVIOUS"
	16	TITLE="SDL_CondWaitTimeout"
	17	HREF="sdlcondwaittimeout.html"><LINK
	18	REL="NEXT"
	19	TITLE="SDL_GetTicks"
	20	HREF="sdlgetticks.html"><META
	21	NAME="KEYWORD"
	22	CONTENT="time"><META
	23	NAME="KEYWORD"
	24	CONTENT="function"></HEAD
	25	><BODY
	26	CLASS="CHAPTER"
	27	BGCOLOR="#FFF8DC"
	28	TEXT="#000000"
	29	LINK="#0000ee"
	30	VLINK="#551a8b"
	31	ALINK="#ff0000"
	32	><DIV
	33	CLASS="NAVHEADER"
	34	><TABLE
	35	SUMMARY="Header navigation table"
	36	WIDTH="100%"
	37	BORDER="0"
	38	CELLPADDING="0"
	39	CELLSPACING="0"
	40	><TR
	41	><TH
	42	COLSPAN="3"
	43	ALIGN="center"
	44	>SDL Library Documentation</TH
	45	></TR
	46	><TR
	47	><TD
	48	WIDTH="10%"
	49	ALIGN="left"
	50	VALIGN="bottom"
	51	><A
	52	HREF="sdlcondwaittimeout.html"
	53	ACCESSKEY="P"
	54	>Prev</A
	55	></TD
	56	><TD
	57	WIDTH="80%"
	58	ALIGN="center"
	59	VALIGN="bottom"
	60	></TD
	61	><TD
	62	WIDTH="10%"
	63	ALIGN="right"
	64	VALIGN="bottom"
65	><A
66	HREF="sdlgetticks.html"
67	ACCESSKEY="N"
68	>Next</A
69	></TD
70	></TR
71	></TABLE
72	><HR
73	ALIGN="LEFT"
74	WIDTH="100%"></DIV
75	><DIV
76	CLASS="CHAPTER"
77	><H1
78	><A
79	NAME="TIME"
80	></A
81	>Chapter 13. Time</H1
82	><DIV
83	CLASS="TOC"
84	><DL
85	><DT
86	><B
87	>Table of Contents</B
88	></DT
89	><DT
90	><A
91	HREF="sdlgetticks.html"
92	>SDL_GetTicks</A
93	> -- Get the number of milliseconds since the SDL library initialization.</DT
94	><DT
95	><A
96	HREF="sdldelay.html"
97	>SDL_Delay</A
98	> -- Wait a specified number of milliseconds before returning.</DT
99	><DT
100	><A
101	HREF="sdladdtimer.html"
102	>SDL_AddTimer</A
103	> -- Add a timer which will call a callback after the specified number of milliseconds has
104	elapsed.</DT
105	><DT
106	><A
107	HREF="sdlremovetimer.html"
108	>SDL_RemoveTimer</A
109	> -- Remove a timer which was added with
110	<A
111	HREF="sdladdtimer.html"
112	>SDL_AddTimer</A
113	>.</DT
114	><DT
115	><A
116	HREF="sdlsettimer.html"
117	>SDL_SetTimer</A
118	> -- Set a callback to run after the specified number of milliseconds has
119	elapsed.</DT
120	></DL
121	></DIV
122	><P
123	>SDL provides several cross-platform functions for dealing with time.
124	It provides a way to get the current time, a way to wait a little while,
125	and a simple timer mechanism. These functions give you two ways of moving an
126	object every x milliseconds:
127
128	<P
129	></P
130	><UL
131	><LI
132	><P
133	>Use a timer callback function. This may have the bad effect that it runs in a seperate thread or uses alarm signals, but it's easier to implement.</P
134	></LI
135	><LI
136	><P
137	>Or you can get the number of milliseconds passed, and move the object if, for example, 30 ms passed.</P
138	></LI
139	></UL
140	> </P
141	></DIV
142	><DIV
143	CLASS="NAVFOOTER"
144	><HR
145	ALIGN="LEFT"
146	WIDTH="100%"><TABLE
147	SUMMARY="Footer navigation table"
148	WIDTH="100%"
149	BORDER="0"
150	CELLPADDING="0"
151	CELLSPACING="0"
152	><TR
153	><TD
154	WIDTH="33%"
155	ALIGN="left"
156	VALIGN="top"
157	><A
158	HREF="sdlcondwaittimeout.html"
159	ACCESSKEY="P"
160	>Prev</A
161	></TD
162	><TD
163	WIDTH="34%"
164	ALIGN="center"
165	VALIGN="top"
166	><A
167	HREF="index.html"
168	ACCESSKEY="H"
169	>Home</A
170	></TD
171	><TD
172	WIDTH="33%"
173	ALIGN="right"
174	VALIGN="top"
175	><A
176	HREF="sdlgetticks.html"
177	ACCESSKEY="N"
178	>Next</A
179	></TD
180	></TR
181	><TR
182	><TD
183	WIDTH="33%"
184	ALIGN="left"
185	VALIGN="top"
186	>SDL_CondWaitTimeout</TD
187	><TD
188	WIDTH="34%"
189	ALIGN="center"
190	VALIGN="top"
191	><A
192	HREF="reference.html"
193	ACCESSKEY="U"
194	>Up</A
195	></TD
196	><TD
197	WIDTH="33%"
198	ALIGN="right"
199	VALIGN="top"
200	>SDL_GetTicks</TD
201	></TR
202	></TABLE
203	></DIV
204	></BODY
205	></HTML
206	>