DLL - Revision history

Sandman at 16:07, 19 March 2008

Sandman — Wed, 19 Mar 2008 16:07:54 GMT

←Older revision		Revision as of 16:07, 19 March 2008
Line 1:		Line 1:
-	DLL stands for "Dynamically Linked Library". It's a filetype used ~~by windows~~ to extend applications (such as [[Fenix]]), and is logically described ~~by windows~~ as an "application extension". These DLLs can be included in your Fenix programs as and when you wish, or not at all.	+	DLL stands for "Dynamically Linked Library". It's a filetype used to extend applications (such as [[Fenix]]), and is logically described as an "application extension" or, because different programs can make use of it, as a "shared object". These DLLs can be included in your Fenix programs as and when you wish, or not at all. In Windows DLLs have the extension .DLL (Dynamic-Link Library) and in Linux .SO (Shared Object).

	To view a list of documented DLL's, see [[DLLs]].		To view a list of documented DLL's, see [[DLLs]].

-	Want to create ~~DLL's~~? Check [[Making_DLLs\|this]] out.	+	Want to create DLLs? Check [[Making_DLLs\|this]] out.

	== What does this mean for Fenix? ==		== What does this mean for Fenix? ==
Line 16:		Line 16:
	Many DLL's require you to import them, like so:		Many DLL's require you to import them, like so:
	<pre>import "<Path and file name of DLL here>";</pre>		<pre>import "<Path and file name of DLL here>";</pre>
-	Although there are some, like Network.DLL, which require you to include a [[~~Fenix header~~]] ~~file~~, instead of importing the DLL. The header file will do that and possibly provide more functionality.	+	Although there are some, like Network.DLL, which require you to [[include]] a Fenix Header file (*.[[FH]]), instead of importing the DLL. The header file will do that and possibly provide more functionality.

	Once successfully imported or included, [[function]]s of that DLL can then be used in the rest of your program in the same way that Fenix functions are used.		Once successfully imported or included, [[function]]s of that DLL can then be used in the rest of your program in the same way that Fenix functions are used.

Sandman at 12:22, 1 March 2008

Sandman — Sat, 01 Mar 2008 12:22:34 GMT

←Older revision		Revision as of 12:22, 1 March 2008
Line 1:		Line 1:
-	DLL stands for "~~Dynamic~~ Linked Library". It's a filetype used by windows to extend applications (such as [[Fenix]]), and is logically described by windows as an "application extension". These DLLs can be included in your Fenix programs as and when you wish, or not at all.	+	DLL stands for "Dynamically Linked Library". It's a filetype used by windows to extend applications (such as [[Fenix]]), and is logically described by windows as an "application extension". These DLLs can be included in your Fenix programs as and when you wish, or not at all.

	To view a list of documented DLL's, see [[DLLs]].		To view a list of documented DLL's, see [[DLLs]].
Line 6:		Line 6:

	== What does this mean for Fenix? ==		== What does this mean for Fenix? ==
-	It means that people who are not developing the Fenix language can still add to it by writing DLL's for Fenix in C. These add optional extra functionality for the Fenix language through the use of some DLLs. For example, if you want to add internet/network functionality to your games, there is [[~~Network_DLL\|~~Network.DLL]].	+	It means that people who are not developing the Fenix language can still add to it by writing DLL's for Fenix in C. These add optional extra functionality for the Fenix language through the use of some DLLs. For example, if you want to add internet/network functionality to your games, there is [[Network.DLL]].

-	To use a DLL in Fenix it must first have been compiled for the version of Fenix that you are using. Most DLLs for Fenix have been pre-compiled for use with Fenix [[0.84a]] and therefore require you to use that version Fenix (else you get a cryptic Spanish [[error message]]). However most DLLs also come with source code supplied and therefore you are able to [[compile DLL]]s for any Fenix version that you want to use (if you know how to).	+	To use a DLL in Fenix it must first have been compiled for the version of Fenix that you are using. Most DLLs for Fenix have been pre-compiled for use with Fenix [[0.84a]] or [[0.92a]] and therefore require you to use that version Fenix (else you get a cryptic Spanish [[error message]]). However most DLLs also come with source code supplied and therefore you are able to [[compile DLL]]s for any Fenix version that you want to use (if you know how to).

	== Using a DLL ==		== Using a DLL ==
Line 18:		Line 18:
	Although there are some, like Network.DLL, which require you to include a [[Fenix header]] file, instead of importing the DLL. The header file will do that and possibly provide more functionality.		Although there are some, like Network.DLL, which require you to include a [[Fenix header]] file, instead of importing the DLL. The header file will do that and possibly provide more functionality.

-	Once successfully imported, ~~functions~~ of that DLL can then be used in the rest of your program in the same way that Fenix functions are used.	+	Once successfully imported or included, [[function]]s of that DLL can then be used in the rest of your program in the same way that Fenix functions are used.
-	Some DLLs ~~(especially the ones included in the Fenix releases)~~ require other DLLs to be present in the same folder. This is ~~normal~~ because ~~they~~ use ~~some [[SDL]]~~ functionality ~~that requires the appropriate SDL~~ DLL.	+	Some DLLs require other DLLs to be present in the same folder. This is possible because DLLs for Fenix can make use of functionality of other DLLs, like Network.DLL uses SDL_Net.DLL.

-	For example, when including the [[~~TTF DLL\|TTF~~.DLL]] (supplied with Fenix) which enables TrueType font support, first you need to find the file named "~~ttf~~.dll" in the directory (or subfolders) to which you saved Fenix (for Fenix 0.84a the filepath is "\dll\~~ttf~~\bin") and copy "~~ttf~~.dll" to where you want your game to access it (often the same folder as the game file itself). Then go back to where you found ttf.DLL and copy the file named "freetype.dll" into the ''same directory'' as ttf.DLL (it needs to be the same directory, not a subfolder or anywhere else). Once you have copied the two files, simply add this line into your ~~fenix~~ code:	+	For example, when including the [[GUI.DLL]] (supplied with Fenix 0.84a) which enables [http://en.wikipedia.org/wiki/TrueType TrueType] font support, first you need to find the file named "gui.dll" in the directory (or subfolders) to which you saved Fenix (for Fenix 0.84a the filepath is "\dll\gui\bin") and copy "gui.dll" to where you want your game to access it (often the same folder as the game file itself). Then simply add this line into your Fenix code:
	<pre>import "ttf.dll";</pre>		<pre>import "ttf.dll";</pre>
-	and you're away~~, you~~ can then use any ~~functions related to ttf.DLL. Note that the "freetype~~.dll~~" is neccessary for ttf.DLL to work, but does not need to be imported into your fenix code~~.	+	and you're away. You can then use any function provided by gui.dll.

	== DLLs and game releases ==		== DLLs and game releases ==
Line 30:		Line 30:
	== Links ==		== Links ==
	* [[List of Fenix DLLs]]		* [[List of Fenix DLLs]]
-	* [[~~:Category:dll~~\|~~DLL category~~]] ~~for a list of DLL's on FenixWiki~~	+	* [[DLLs\|List of DLLs]]

Sandman at 22:06, 1 October 2007

Sandman — Mon, 01 Oct 2007 22:06:40 GMT

←Older revision		Revision as of 22:06, 1 October 2007
Line 2:		Line 2:

	To view a list of documented DLL's, see [[DLLs]].		To view a list of documented DLL's, see [[DLLs]].
		+
		+	Want to create DLL's? Check [[Making_DLLs\|this]] out.

	== What does this mean for Fenix? ==		== What does this mean for Fenix? ==

Sandman at 02:27, 1 September 2007

Sandman — Sat, 01 Sep 2007 02:27:27 GMT

←Older revision		Revision as of 02:27, 1 September 2007
Line 19:		Line 19:
	Some DLLs (especially the ones included in the Fenix releases) require other DLLs to be present in the same folder. This is normal because they use some [[SDL]] functionality that requires the appropriate SDL DLL.		Some DLLs (especially the ones included in the Fenix releases) require other DLLs to be present in the same folder. This is normal because they use some [[SDL]] functionality that requires the appropriate SDL DLL.

-	For example, when including the [[~~ttf~~ DLL\|~~ttf~~.DLL]] (supplied with Fenix) which enables TrueType font support, first you need to find the file named "ttf.dll" in the directory (or subfolders) to which you saved Fenix (for Fenix 0.84a the filepath is "\dll\ttf\bin") and copy "ttf.dll" to where you want your game to access it (often the same folder as the game file itself). Then go back to where you found ttf.DLL and copy the file named "freetype.dll" into the ''same directory'' as ttf.DLL (it needs to be the same directory, not a subfolder or anywhere else). Once you have copied the two files, simply add this line into your fenix code:	+	For example, when including the [[TTF DLL\|TTF.DLL]] (supplied with Fenix) which enables TrueType font support, first you need to find the file named "ttf.dll" in the directory (or subfolders) to which you saved Fenix (for Fenix 0.84a the filepath is "\dll\ttf\bin") and copy "ttf.dll" to where you want your game to access it (often the same folder as the game file itself). Then go back to where you found ttf.DLL and copy the file named "freetype.dll" into the ''same directory'' as ttf.DLL (it needs to be the same directory, not a subfolder or anywhere else). Once you have copied the two files, simply add this line into your fenix code:
	<pre>import "ttf.dll";</pre>		<pre>import "ttf.dll";</pre>
	and you're away, you can then use any functions related to ttf.DLL. Note that the "freetype.dll" is neccessary for ttf.DLL to work, but does not need to be imported into your fenix code.		and you're away, you can then use any functions related to ttf.DLL. Note that the "freetype.dll" is neccessary for ttf.DLL to work, but does not need to be imported into your fenix code.

Sandman at 13:06, 23 July 2007

Sandman — Mon, 23 Jul 2007 13:06:16 GMT

←Older revision		Revision as of 13:06, 23 July 2007
Line 1:		Line 1:
-	[[Category:dll]]
-
	DLL stands for "Dynamic Linked Library". It's a filetype used by windows to extend applications (such as [[Fenix]]), and is logically described by windows as an "application extension". These DLLs can be included in your Fenix programs as and when you wish, or not at all.		DLL stands for "Dynamic Linked Library". It's a filetype used by windows to extend applications (such as [[Fenix]]), and is logically described by windows as an "application extension". These DLLs can be included in your Fenix programs as and when you wish, or not at all.
		+
		+	To view a list of documented DLL's, see [[DLLs]].

	== What does this mean for Fenix? ==		== What does this mean for Fenix? ==

Sandman at 15:25, 29 April 2007

Sandman — Sun, 29 Apr 2007 15:25:02 GMT

←Older revision		Revision as of 15:25, 29 April 2007
Line 23:		Line 23:
	and you're away, you can then use any functions related to ttf.DLL. Note that the "freetype.dll" is neccessary for ttf.DLL to work, but does not need to be imported into your fenix code.		and you're away, you can then use any functions related to ttf.DLL. Note that the "freetype.dll" is neccessary for ttf.DLL to work, but does not need to be imported into your fenix code.

-	== DLLs and ~~Game Releases~~ ==	+	== DLLs and game releases ==
	When it comes to the point when you want to distribute your game to others, it is necessary to distribute it with all of the DLLs used, including the ones that are not directly imported into your code (see above). Lack of any DLLs used will make your game unplayable. For more information see [[Distributing Fenix Programs]].		When it comes to the point when you want to distribute your game to others, it is necessary to distribute it with all of the DLLs used, including the ones that are not directly imported into your code (see above). Lack of any DLLs used will make your game unplayable. For more information see [[Distributing Fenix Programs]].

Sandman at 15:24, 29 April 2007

Sandman — Sun, 29 Apr 2007 15:24:36 GMT

←Older revision		Revision as of 15:24, 29 April 2007
Line 1:		Line 1:
	[[Category:dll]]		[[Category:dll]]

-	DLL stands for "Dynamic Linked Library". It is a filetype used by windows to extend applications (such as [[Fenix]]), and it logically ~~descirbed~~ by windows as an "application extension". These DLLs can be included in your [[Fenix]] programs as and when you wish, or not at all.	+	DLL stands for "Dynamic Linked Library". It's a filetype used by windows to extend applications (such as [[Fenix]]), and is logically described by windows as an "application extension". These DLLs can be included in your Fenix programs as and when you wish, or not at all.

-	==What ~~Does This Mean For~~ Fenix?==	+	== What does this mean for Fenix? ==
		+	It means that people who are not developing the Fenix language can still add to it by writing DLL's for Fenix in C. These add optional extra functionality for the Fenix language through the use of some DLLs. For example, if you want to add internet/network functionality to your games, there is [[Network_DLL\|Network.DLL]].

-	It means that people who are not developing the Fenix language can still add to it by writing DLL's for [[fenix]] in C. These add optional extra functionality for the [[fenix]] language through the use of some DLLs. For example, if you want to add internet/network functionality to your games, there is [[Network DLL]].	+	To use a DLL in Fenix it must first have been compiled for the version of Fenix that you are using. Most DLLs for Fenix have been pre-compiled for use with Fenix [[0.84a]] and therefore require you to use that version Fenix (else you get a cryptic Spanish [[error message]]). However most DLLs also come with source code supplied and therefore you are able to [[compile DLL]]s for any Fenix version that you want to use (if you know how to).
-	To use a DLL in [[Fenix]] it must first have been compiled for the version of ~~[[fenix]]~~ that you are using. Most DLLs for ~~fenix~~ have been pre-compiled for use with ~~fenix~~ [[0.84a]] and therefore require you to use that version ~~[[fenix]]~~ (else you get a cryptic ~~spanish~~ [[error message]]). However most DLLs also come with source code supplied and therefore you are able to compile ~~DLLs~~ for any ~~fenix~~ version that you want to use (if you know how to).	+
-		+
-	~~==Using A DLL==~~	+

		+	== Using a DLL ==
	Each DLL may have different functionality, so it is always advisable to read the documentation that comes with the DLL (if there is any) or the page on that DLL on this wiki: [[List of Fenix DLLs]].		Each DLL may have different functionality, so it is always advisable to read the documentation that comes with the DLL (if there is any) or the page on that DLL on this wiki: [[List of Fenix DLLs]].

-	First, to use the functions of any DLL you need to include this line in your code:	+	First, to use the [[functions]] of any DLL you need to include this line in your code:
-	<pre>import "Path and file name of DLL here";</pre>	+	Many DLL's require you to import them, like so:
-	~~Once successfully included~~, ~~and [[functions]] of that DLL can then be used in the rest of your program in the same way that [[Fenix]] [[functions]] are used~~.	+	<pre>import "<Path and file name of DLL here>";</pre>
-	Some DLLs (especially the ones included in the [[Fenix]] releases require other DLLs to be present in the same folder. This is normally because they use some [[SDL]] functionality that requires the appropriate [[SDL]] DLL.	+	Although there are some, like Network.DLL, which require you to include a [[Fenix header]] file, instead of importing the DLL. The header file will do that and possibly provide more functionality.
-	~~For example~~, ~~when including the [[ttf DLL]] (supplied with [[fenix]])~~ which ~~enables TrueType font support, firstly~~ you ~~need~~ to ~~find the file named "ttf.dll" in the directory (or subfolders) to which you saved~~ [[Fenix]] ~~(for [[0.84a]] the filepath is "\dll\ttf\bin") and copy "ttf.dll" to where you want your game to access it (often the same folder as the game~~ file ~~itself). Then go back to where you found [[ttf DLL]] and copy over the file named "freetype.dll" into the SAME DIRECTORY as [[ttf DLL]] (it needs to be the same directory~~, ~~not a subfolder or anywhere else). Once you have copied over~~ the ~~two files, simply add this line into your fenix code:~~	+
-	~~<pre>import "ttf.dll";</pre>~~	+
-	~~and you're away, you can then use any functions related to [[ttf~~ DLL]]. ~~Note~~ that ~~the "freetype.dll" is neccessary for [[ttf DLL]] to work, but does not need to be imported into your fenix code~~.	+

-	==DLLs ~~and Game Releases==~~	+	Once successfully imported, functions of that DLL can then be used in the rest of your program in the same way that Fenix functions are used.
		+	Some DLLs (especially the ones included in the Fenix releases) require other DLLs to be present in the same folder. This is normal because they use some [[SDL]] functionality that requires the appropriate SDL DLL.

-	~~When it comes~~ to the ~~point when~~ you ~~want~~ to ~~distribute~~ your game to ~~others,~~ it ~~is neccesary~~ to ~~distribute~~ it ~~with all of~~ the ~~DLLs used~~, ~~including the ones that are~~ not ~~directly imported~~ into your code ~~(see above)~~. ~~Lack of~~ any ~~DLLs used will make your game unplayable~~. ~~For more information see [[Distributing Fenix Programs]]~~.	+	For example, when including the [[ttf DLL\|ttf.DLL]] (supplied with Fenix) which enables TrueType font support, first you need to find the file named "ttf.dll" in the directory (or subfolders) to which you saved Fenix (for Fenix 0.84a the filepath is "\dll\ttf\bin") and copy "ttf.dll" to where you want your game to access it (often the same folder as the game file itself). Then go back to where you found ttf.DLL and copy the file named "freetype.dll" into the ''same directory'' as ttf.DLL (it needs to be the same directory, not a subfolder or anywhere else). Once you have copied the two files, simply add this line into your fenix code:
		+	<pre>import "ttf.dll";</pre>
		+	and you're away, you can then use any functions related to ttf.DLL. Note that the "freetype.dll" is neccessary for ttf.DLL to work, but does not need to be imported into your fenix code.

-	==~~Links~~==	+	== DLLs and Game Releases ==
		+	When it comes to the point when you want to distribute your game to others, it is necessary to distribute it with all of the DLLs used, including the ones that are not directly imported into your code (see above). Lack of any DLLs used will make your game unplayable. For more information see [[Distributing Fenix Programs]].

-	[[List of Fenix DLLs]]	+	== Links ==
		+	* [[List of Fenix DLLs]]
		+	* [[:Category:dll\|DLL category]] for a list of DLL's on FenixWiki

86.136.63.228 at 10:54, 13 April 2007

86.136.63.228 — Fri, 13 Apr 2007 10:54:40 GMT

New page

[[Category:dll]]

DLL stands for "Dynamic Linked Library". It is a filetype used by windows to extend applications (such as [[Fenix]]), and it logically descirbed by windows as an "application extension". These DLLs can be included in your [[Fenix]] programs as and when you wish, or not at all.

==What Does This Mean For Fenix?==

It means that people who are not developing the Fenix language can still add to it by writing DLL's for [[fenix]] in C. These add optional extra functionality for the [[fenix]] language through the use of some DLLs. For example, if you want to add internet/network functionality to your games, there is [[Network DLL]].
To use a DLL in [[Fenix]] it must first have been compiled for the version of [[fenix]] that you are using. Most DLLs for fenix have been pre-compiled for use with fenix [[0.84a]] and therefore require you to use that version [[fenix]] (else you get a cryptic spanish [[error message]]). However most DLLs also come with source code supplied and therefore you are able to compile DLLs for any fenix version that you want to use (if you know how to).

==Using A DLL==

Each DLL may have different functionality, so it is always advisable to read the documentation that comes with the DLL (if there is any) or the page on that DLL on this wiki: [[List of Fenix DLLs]].

First, to use the functions of any DLL you need to include this line in your code:
<pre>import "*Path and file name of DLL here*";</pre>
Once successfully included, and [[functions]] of that DLL can then be used in the rest of your program in the same way that [[Fenix]] [[functions]] are used.
Some DLLs (especially the ones included in the [[Fenix]] releases require other DLLs to be present in the same folder. This is normally because they use some [[SDL]] functionality that requires the appropriate [[SDL]] DLL.
For example, when including the [[ttf DLL]] (supplied with [[fenix]]) which enables TrueType font support, firstly you need to find the file named "ttf.dll" in the directory (or subfolders) to which you saved [[Fenix]] (for [[0.84a]] the filepath is "\dll\ttf\bin") and copy "ttf.dll" to where you want your game to access it (often the same folder as the game file itself). Then go back to where you found [[ttf DLL]] and copy over the file named "freetype.dll" into the SAME DIRECTORY as [[ttf DLL]] (it needs to be the same directory, not a subfolder or anywhere else). Once you have copied over the two files, simply add this line into your fenix code:
<pre>import "ttf.dll";</pre>
and you're away, you can then use any functions related to [[ttf DLL]]. Note that the "freetype.dll" is neccessary for [[ttf DLL]] to work, but does not need to be imported into your fenix code.

==DLLs and Game Releases==

When it comes to the point when you want to distribute your game to others, it is neccesary to distribute it with all of the DLLs used, including the ones that are not directly imported into your code (see above). Lack of any DLLs used will make your game unplayable. For more information see [[Distributing Fenix Programs]].

==Links==

[[List of Fenix DLLs]]