1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 6.5.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
8<TITLE>DVDOpen</TITLE>
9</HEAD>
10<BODY>
11<H1>DVDOpen</H1>
12<H2>C Specification</H2>
13<DL>
14  <DD>
15  <PRE><code>#include &lt;revolution/dvd.h&gt;</CODE></PRE>
16  <DD>
17<PRE><CODE>BOOL DVDOpen(const char* fileName, DVDFileInfo* fileInfo);</CODE></PRE>
18</DL>
19<H2>Arguments</H2>
20<TABLE border="1" cellpadding="3" cellspacing="0.1">
21  <TBODY>
22    <TR>
23<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE>fileName</CODE></STRONG></EM></TD>
24      <TD width="621">Pointer to file name to open.</TD>
25    </TR>
26    <TR>
27<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE>fileInfo</CODE></STRONG></EM></TD>
28<TD width="621">Pointer to file info to use.</TD>
29    </TR>
30  </TBODY>
31</TABLE>
32<H2>Return Values</H2>
33<P>Returns <CODE>TRUE</CODE> if file exists and <CODE>FALSE</CODE> if file doesn't exist. </P>
34<H2>Description</H2>
35<P>Opens a file.</P>
36<P>The <code>DVDOpen</code> function returns <CODE>FALSE</CODE> if the specified file isn't found. If you want to check for a file and then conditionally branch (i.e., read and use the file if it exists or use default values), use the <a href="DVDConvertPathToEntrynum.html"><code>DVDConvertPathToEntrynum</code></a> function. Because the <code>DVDOpen</code>function outputs a warning message if the file isn't found.</P>
37<P>The <code>DVDOpen</code> function is the same as the <a href="DVDConvertPathToEntrynum.html"><code>DVDConvertPathToEntrynum</code></a> and <a href="DVDFastOpen.html"><code>DVDFastOpen</code></a> functions combined.</P>
38<P><STRONG><em><code>fileName</code></em></STRONG> accepts one of the following formats:</P>
39<P>- /texture/mario<BR> - texture/mario</P>
40<P>The device driver accepts the first format as an absolute pathname; in contrast, the device driver accepts the second format as the relative pathname from the current directory (see the <a href="DVDChangeDir.html"><code>DVDChangeDir</code></a> function). There are no restrictions for the file name length.</P>
41<P>You need to use &quot;/&quot; (forward slash). You can't use &quot;\&quot; (backward slash).</P>
42<P>Similar to other file systems, you can use &quot;..&quot; and &quot;.&quot; to represent the parent directory and the current directory, respectively. The parent directory of the root directory is considered the root directory.</P>
43<H2>See Also</H2>
44<P><CODE><A href="DVDInit.html">DVDInit</A><BR> <A href="DVDClose.html">DVDClose</A><BR> <A href="DVDFastOpen.html">DVDFastOpen</A><BR> <A href="DVDConvertPathToEntrynum.html">DVDConvertPathToEntrynum</A></CODE></P>
45<H2>Revision History</H2>
46<P>03/01/2006 Initial version.</P>
47</BODY>
48</HTML>
49