PackageFile.xml 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408
  1. <Type Name="PackageFile" FullName="Urho.IO.PackageFile">
  2. <TypeSignature Language="C#" Value="public class PackageFile : Urho.UrhoObject" />
  3. <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit PackageFile extends Urho.UrhoObject" />
  4. <AssemblyInfo>
  5. <AssemblyName>Urho</AssemblyName>
  6. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  7. </AssemblyInfo>
  8. <Base>
  9. <BaseTypeName>Urho.UrhoObject</BaseTypeName>
  10. </Base>
  11. <Interfaces />
  12. <Docs>
  13. <summary>
  14. Stores files of a directory tree sequentially for convenient access.
  15. </summary>
  16. <remarks>To be added.</remarks>
  17. </Docs>
  18. <Members>
  19. <Member MemberName=".ctor">
  20. <MemberSignature Language="C#" Value="public PackageFile ();" />
  21. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
  22. <MemberType>Constructor</MemberType>
  23. <AssemblyInfo>
  24. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  25. </AssemblyInfo>
  26. <Attributes>
  27. <Attribute>
  28. <AttributeName>Preserve</AttributeName>
  29. </Attribute>
  30. </Attributes>
  31. <Parameters />
  32. <Docs>
  33. <summary>
  34. <para>Constructs a new instance of Urho.IO.PackageFile which is tied to the <see cref="P:Urho.Application.CurrentContext" />.</para>
  35. </summary>
  36. <remarks>
  37. </remarks>
  38. </Docs>
  39. </Member>
  40. <Member MemberName=".ctor">
  41. <MemberSignature Language="C#" Value="public PackageFile (IntPtr handle);" />
  42. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(native int handle) cil managed" />
  43. <MemberType>Constructor</MemberType>
  44. <AssemblyInfo>
  45. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  46. </AssemblyInfo>
  47. <Attributes>
  48. <Attribute>
  49. <AttributeName>Preserve</AttributeName>
  50. </Attribute>
  51. </Attributes>
  52. <Parameters>
  53. <Parameter Name="handle" Type="System.IntPtr" />
  54. </Parameters>
  55. <Docs>
  56. <param name="handle">Pointer to the raw unmanaged Urho object.</param>
  57. <summary>Constructs a new instance of Urho.IO.PackageFile, given a raw pointer to an unmanaged object</summary>
  58. <remarks>
  59. <para>This creates a new managed wrapper for the type using the raw pointer to an unmanaged object.</para>
  60. <para>Objects that are created in this fashion get registered with the UrhoSharp runtime.</para>
  61. <para>This is intended to be used by the UrhoSharp runtime, and is not intended to be used by users.</para>
  62. </remarks>
  63. </Docs>
  64. </Member>
  65. <Member MemberName=".ctor">
  66. <MemberSignature Language="C#" Value="public PackageFile (Urho.Context context);" />
  67. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class Urho.Context context) cil managed" />
  68. <MemberType>Constructor</MemberType>
  69. <AssemblyInfo>
  70. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  71. </AssemblyInfo>
  72. <Attributes>
  73. <Attribute>
  74. <AttributeName>Preserve</AttributeName>
  75. </Attribute>
  76. </Attributes>
  77. <Parameters>
  78. <Parameter Name="context" Type="Urho.Context" />
  79. </Parameters>
  80. <Docs>
  81. <param name="context">The context that this object will be attached to.</param>
  82. <summary>
  83. <para>Constructs a new instance of Urho.IO.PackageFile linked to a specific <see cref="T:Urho.Context" />.</para>
  84. </summary>
  85. <remarks>
  86. </remarks>
  87. </Docs>
  88. </Member>
  89. <Member MemberName=".ctor">
  90. <MemberSignature Language="C#" Value="protected PackageFile (Urho.UrhoObjectFlag emptyFlag);" />
  91. <MemberSignature Language="ILAsm" Value=".method familyhidebysig specialname rtspecialname instance void .ctor(valuetype Urho.UrhoObjectFlag emptyFlag) cil managed" />
  92. <MemberType>Constructor</MemberType>
  93. <AssemblyInfo>
  94. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  95. </AssemblyInfo>
  96. <Attributes>
  97. <Attribute>
  98. <AttributeName>Preserve</AttributeName>
  99. </Attribute>
  100. </Attributes>
  101. <Parameters>
  102. <Parameter Name="emptyFlag" Type="Urho.UrhoObjectFlag" />
  103. </Parameters>
  104. <Docs>
  105. <param name="emptyFlag">Pass UrhoObjectFlag.Empty.</param>
  106. <summary>Empty constructor, chain to this constructor when you provide your own constructor that sets the handle field.</summary>
  107. <remarks>
  108. <para>This constructor should be invoked by your code if you provide your own constructor that sets the handle field.</para>
  109. <para>This essentially circumvents the default path that creates a new object and sets the handle and does not call RegisterObject on the target, you must do this on your own constructor.</para>
  110. <para>You would typically chain to this constructor from your own, and then set the handle to the unmanaged object from your code, and then register your object.</para>
  111. </remarks>
  112. </Docs>
  113. </Member>
  114. <Member MemberName=".ctor">
  115. <MemberSignature Language="C#" Value="public PackageFile (Urho.Context context, string fileName, uint startOffset = 0);" />
  116. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class Urho.Context context, string fileName, unsigned int32 startOffset) cil managed" />
  117. <MemberType>Constructor</MemberType>
  118. <AssemblyInfo>
  119. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  120. </AssemblyInfo>
  121. <Attributes>
  122. <Attribute>
  123. <AttributeName>Preserve</AttributeName>
  124. </Attribute>
  125. </Attributes>
  126. <Parameters>
  127. <Parameter Name="context" Type="Urho.Context" />
  128. <Parameter Name="fileName" Type="System.String" />
  129. <Parameter Name="startOffset" Type="System.UInt32" />
  130. </Parameters>
  131. <Docs>
  132. <param name="context">The context that this object will be attached to.</param>
  133. <param name="fileName">To be added.</param>
  134. <param name="startOffset">To be added.</param>
  135. <summary>Creates an instance of PackageFile that is attached to an execution context.</summary>
  136. <remarks>
  137. <para>This creates an instance of PackageFile attached to the specified execution context.</para>
  138. </remarks>
  139. </Docs>
  140. </Member>
  141. <Member MemberName="Checksum">
  142. <MemberSignature Language="C#" Value="public uint Checksum { get; }" />
  143. <MemberSignature Language="ILAsm" Value=".property instance unsigned int32 Checksum" />
  144. <MemberType>Property</MemberType>
  145. <AssemblyInfo>
  146. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  147. </AssemblyInfo>
  148. <ReturnValue>
  149. <ReturnType>System.UInt32</ReturnType>
  150. </ReturnValue>
  151. <Docs>
  152. <summary>
  153. Return checksum of the package file contents.
  154. </summary>
  155. <value>To be added.</value>
  156. <remarks>To be added.</remarks>
  157. </Docs>
  158. </Member>
  159. <Member MemberName="Compressed">
  160. <MemberSignature Language="C#" Value="public bool Compressed { get; }" />
  161. <MemberSignature Language="ILAsm" Value=".property instance bool Compressed" />
  162. <MemberType>Property</MemberType>
  163. <AssemblyInfo>
  164. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  165. </AssemblyInfo>
  166. <ReturnValue>
  167. <ReturnType>System.Boolean</ReturnType>
  168. </ReturnValue>
  169. <Docs>
  170. <summary>Return whether the files are compressed.</summary>
  171. <value>To be added.</value>
  172. <remarks>To be added.</remarks>
  173. </Docs>
  174. </Member>
  175. <Member MemberName="Exists">
  176. <MemberSignature Language="C#" Value="public bool Exists (string fileName);" />
  177. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance bool Exists(string fileName) cil managed" />
  178. <MemberType>Method</MemberType>
  179. <AssemblyInfo>
  180. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  181. </AssemblyInfo>
  182. <ReturnValue>
  183. <ReturnType>System.Boolean</ReturnType>
  184. </ReturnValue>
  185. <Parameters>
  186. <Parameter Name="fileName" Type="System.String" />
  187. </Parameters>
  188. <Docs>
  189. <param name="fileName">To be added.</param>
  190. <summary>
  191. Check if a file exists within the package file. This will be case-insensitive on Windows and case-sensitive on other platforms.
  192. </summary>
  193. <returns>To be added.</returns>
  194. <remarks>To be added.</remarks>
  195. </Docs>
  196. </Member>
  197. <Member MemberName="GetEntry">
  198. <MemberSignature Language="C#" Value="public Urho.IO.PackageEntry* GetEntry (string fileName);" />
  199. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance valuetype Urho.IO.PackageEntry* GetEntry(string fileName) cil managed" />
  200. <MemberType>Method</MemberType>
  201. <AssemblyInfo>
  202. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  203. </AssemblyInfo>
  204. <ReturnValue>
  205. <ReturnType>Urho.IO.PackageEntry*</ReturnType>
  206. </ReturnValue>
  207. <Parameters>
  208. <Parameter Name="fileName" Type="System.String" />
  209. </Parameters>
  210. <Docs>
  211. <param name="fileName">To be added.</param>
  212. <summary>
  213. Return the file entry corresponding to the name, or null if not found. This will be case-insensitive on Windows and case-sensitive on other platforms.
  214. </summary>
  215. <returns>To be added.</returns>
  216. <remarks>To be added.</remarks>
  217. </Docs>
  218. </Member>
  219. <Member MemberName="Name">
  220. <MemberSignature Language="C#" Value="public string Name { get; }" />
  221. <MemberSignature Language="ILAsm" Value=".property instance string Name" />
  222. <MemberType>Property</MemberType>
  223. <AssemblyInfo>
  224. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  225. </AssemblyInfo>
  226. <ReturnValue>
  227. <ReturnType>System.String</ReturnType>
  228. </ReturnValue>
  229. <Docs>
  230. <summary>
  231. Return the package file name.
  232. </summary>
  233. <value>To be added.</value>
  234. <remarks>To be added.</remarks>
  235. </Docs>
  236. </Member>
  237. <Member MemberName="NameHash">
  238. <MemberSignature Language="C#" Value="public Urho.StringHash NameHash { get; }" />
  239. <MemberSignature Language="ILAsm" Value=".property instance valuetype Urho.StringHash NameHash" />
  240. <MemberType>Property</MemberType>
  241. <AssemblyInfo>
  242. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  243. </AssemblyInfo>
  244. <ReturnValue>
  245. <ReturnType>Urho.StringHash</ReturnType>
  246. </ReturnValue>
  247. <Docs>
  248. <summary>
  249. Return hash of the package file name.
  250. </summary>
  251. <value>To be added.</value>
  252. <remarks>To be added.</remarks>
  253. </Docs>
  254. </Member>
  255. <Member MemberName="NumFiles">
  256. <MemberSignature Language="C#" Value="public uint NumFiles { get; }" />
  257. <MemberSignature Language="ILAsm" Value=".property instance unsigned int32 NumFiles" />
  258. <MemberType>Property</MemberType>
  259. <AssemblyInfo>
  260. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  261. </AssemblyInfo>
  262. <ReturnValue>
  263. <ReturnType>System.UInt32</ReturnType>
  264. </ReturnValue>
  265. <Docs>
  266. <summary>
  267. Return number of files.
  268. </summary>
  269. <value>To be added.</value>
  270. <remarks>To be added.</remarks>
  271. </Docs>
  272. </Member>
  273. <Member MemberName="Open">
  274. <MemberSignature Language="C#" Value="public bool Open (string fileName, uint startOffset = 0);" />
  275. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance bool Open(string fileName, unsigned int32 startOffset) cil managed" />
  276. <MemberType>Method</MemberType>
  277. <AssemblyInfo>
  278. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  279. </AssemblyInfo>
  280. <ReturnValue>
  281. <ReturnType>System.Boolean</ReturnType>
  282. </ReturnValue>
  283. <Parameters>
  284. <Parameter Name="fileName" Type="System.String" />
  285. <Parameter Name="startOffset" Type="System.UInt32" />
  286. </Parameters>
  287. <Docs>
  288. <param name="fileName">To be added.</param>
  289. <param name="startOffset">To be added.</param>
  290. <summary>
  291. Open the package file. Return true if successful.
  292. </summary>
  293. <returns>To be added.</returns>
  294. <remarks>To be added.</remarks>
  295. </Docs>
  296. </Member>
  297. <Member MemberName="TotalDataSize">
  298. <MemberSignature Language="C#" Value="public uint TotalDataSize { get; }" />
  299. <MemberSignature Language="ILAsm" Value=".property instance unsigned int32 TotalDataSize" />
  300. <MemberType>Property</MemberType>
  301. <AssemblyInfo>
  302. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  303. </AssemblyInfo>
  304. <ReturnValue>
  305. <ReturnType>System.UInt32</ReturnType>
  306. </ReturnValue>
  307. <Docs>
  308. <summary>Return total data size from all the file entries in the package file.</summary>
  309. <value>
  310. <para />
  311. </value>
  312. <remarks>
  313. <para />
  314. </remarks>
  315. </Docs>
  316. </Member>
  317. <Member MemberName="TotalSize">
  318. <MemberSignature Language="C#" Value="public uint TotalSize { get; }" />
  319. <MemberSignature Language="ILAsm" Value=".property instance unsigned int32 TotalSize" />
  320. <MemberType>Property</MemberType>
  321. <AssemblyInfo>
  322. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  323. </AssemblyInfo>
  324. <ReturnValue>
  325. <ReturnType>System.UInt32</ReturnType>
  326. </ReturnValue>
  327. <Docs>
  328. <summary>
  329. Return total size of the package file.
  330. </summary>
  331. <value>To be added.</value>
  332. <remarks>To be added.</remarks>
  333. </Docs>
  334. </Member>
  335. <Member MemberName="Type">
  336. <MemberSignature Language="C#" Value="public override Urho.StringHash Type { get; }" />
  337. <MemberSignature Language="ILAsm" Value=".property instance valuetype Urho.StringHash Type" />
  338. <MemberType>Property</MemberType>
  339. <AssemblyInfo>
  340. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  341. </AssemblyInfo>
  342. <ReturnValue>
  343. <ReturnType>Urho.StringHash</ReturnType>
  344. </ReturnValue>
  345. <Docs>
  346. <summary>Urho's type system type.</summary>
  347. <value>StringHash representing the type for this C# type.</value>
  348. <remarks>This returns the Urho's type and is surfaced for low-level Urho code.</remarks>
  349. </Docs>
  350. </Member>
  351. <Member MemberName="TypeName">
  352. <MemberSignature Language="C#" Value="public override string TypeName { get; }" />
  353. <MemberSignature Language="ILAsm" Value=".property instance string TypeName" />
  354. <MemberType>Property</MemberType>
  355. <AssemblyInfo>
  356. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  357. </AssemblyInfo>
  358. <ReturnValue>
  359. <ReturnType>System.String</ReturnType>
  360. </ReturnValue>
  361. <Docs>
  362. <summary>Urho's low-level type name.</summary>
  363. <value>Stringified low-level type name.</value>
  364. <remarks>
  365. </remarks>
  366. </Docs>
  367. </Member>
  368. <Member MemberName="TypeNameStatic">
  369. <MemberSignature Language="C#" Value="public static string TypeNameStatic { get; }" />
  370. <MemberSignature Language="ILAsm" Value=".property string TypeNameStatic" />
  371. <MemberType>Property</MemberType>
  372. <AssemblyInfo>
  373. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  374. </AssemblyInfo>
  375. <ReturnValue>
  376. <ReturnType>System.String</ReturnType>
  377. </ReturnValue>
  378. <Docs>
  379. <summary>Urho's low-level type name, accessible as a static method.</summary>
  380. <value>Stringified low-level type name.</value>
  381. <remarks>
  382. </remarks>
  383. </Docs>
  384. </Member>
  385. <Member MemberName="TypeStatic">
  386. <MemberSignature Language="C#" Value="public static Urho.StringHash TypeStatic { get; }" />
  387. <MemberSignature Language="ILAsm" Value=".property valuetype Urho.StringHash TypeStatic" />
  388. <MemberType>Property</MemberType>
  389. <AssemblyInfo>
  390. <AssemblyVersion>1.0.0.0</AssemblyVersion>
  391. </AssemblyInfo>
  392. <Attributes>
  393. <Attribute>
  394. <AttributeName>Preserve</AttributeName>
  395. </Attribute>
  396. </Attributes>
  397. <ReturnValue>
  398. <ReturnType>Urho.StringHash</ReturnType>
  399. </ReturnValue>
  400. <Docs>
  401. <summary>Urho's low-level type, accessible as a static method.</summary>
  402. <value>This returns the Urho's type and is surface for the low-level Urho code.</value>
  403. <remarks>
  404. </remarks>
  405. </Docs>
  406. </Member>
  407. </Members>
  408. </Type>