Language - LiveCode - Revision history

Mparadis at 20:37, 6 June 2017

2017-06-06T20:37:04Z

← Older revision		Revision as of 20:37, 6 June 2017
Line 12:		Line 12:
	{{QuickDownloads\|LiveCode\|		{{QuickDownloads\|LiveCode\|
	{{APIQuickDownloads\|{{SERVER}}/documentation/LiveCode_API_Manual.pdf}}\|		{{APIQuickDownloads\|{{SERVER}}/documentation/LiveCode_API_Manual.pdf}}\|
	{{ExampleQuickDownloads\|{{SERVER}}/downloads/examples/LiveCode.zip\|}}\|		{{ExampleQuickDownloads\|{{SERVER}}/downloads/phidget21/examples/livecode/LiveCode.zip\|}}\|
	{{ExtraLibraryQuickDownloads\|{{SERVER}}/downloads/libraries/LiveCodeRequiredWin.zip\|LiveCode Library\|(Windows)}}		{{ExtraLibraryQuickDownloads\|{{SERVER}}/downloads/phidget21/libraries/windows/LiveCodeRequiredWin.zip\|LiveCode Library\|(Windows)}}
	{{ExtraLibraryQuickDownloads\|{{SERVER}}/downloads/libraries/LiveCodeRequiredMac.zip\|LiveCode Library\|(OS X)}}		{{ExtraLibraryQuickDownloads\|{{SERVER}}/downloads/phidget21/libraries/macos/LiveCodeRequiredMac.zip\|LiveCode Library\|(OS X)}}
	{{WindowsQuickDownloads}}		{{WindowsQuickDownloads}}
	{{MacQuickDownloads}}}}		{{MacQuickDownloads}}}}
Line 36:		Line 36:
	* <b>{{Code\|Externals.txt}}</b> lets LiveCode know the name of the Phidget LiveCode library as well as the name of its corresponding {{Code\|phidgets_livecode.dll}}. More information on its usage will be provided in the [[#Use Our Examples \| Use Our Examples]] section.		* <b>{{Code\|Externals.txt}}</b> lets LiveCode know the name of the Phidget LiveCode library as well as the name of its corresponding {{Code\|phidgets_livecode.dll}}. More information on its usage will be provided in the [[#Use Our Examples \| Use Our Examples]] section.

	If you do not want to use our installer, you can download the [{{SERVER}}/downloads/libraries/~~phidget21~~-x86.zip {{Code\|phidget21.dll}}] and manually install it where you want; refer to our [[OS_-_Windows#Manual_File_Installation\|Manual Installation Instructions]].		If you do not want to use our installer, you can download the [{{SERVER}}/downloads/phidget21/libraries/windows/Phidget-x86.zip {{Code\|phidget21.dll}}] and manually install it where you want; refer to our [[OS_-_Windows#Manual_File_Installation\|Manual Installation Instructions]].

	===Use Our Examples===		===Use Our Examples===
Line 44:		Line 44:
	To run the examples,		To run the examples,

	1. Download the [{{SERVER}}/downloads/libraries/LiveCodeRequiredWin.zip Phidget LiveCode library] and extract it into a folder. Here, you will find two files inside the {{Code\|Windows}} folder: {{Code\|phidgets_livecode.dll}} and {{Code\|Externals.txt}}.		1. Download the [{{SERVER}}/downloads/phidget21/libraries/windows/LiveCodeRequiredWin.zip Phidget LiveCode library] and extract it into a folder. Here, you will find two files inside the {{Code\|Windows}} folder: {{Code\|phidgets_livecode.dll}} and {{Code\|Externals.txt}}.

	2. Open up the LiveCode environment.		2. Open up the LiveCode environment.
Line 60:		Line 60:
	[[File:LiveCode User Extensions 2.PNG\|link=\|alt=User Extensions Folder]]		[[File:LiveCode User Extensions 2.PNG\|link=\|alt=User Extensions Folder]]

	6. Download the [{{SERVER}}/downloads/examples/LiveCode.zip examples] and unpack them into a folder. Navigate to the {{Code\|LiveCode/InterfaceKit Example}} folder, and open {{Code\|InterfaceKit-full.rev}} in LiveCode. These examples were written in LiveCode 4.5, but will also work with other versions.		6. Download the [{{SERVER}}/downloads/phidget21/examples/livecode/LiveCode.zip examples] and unpack them into a folder. Navigate to the {{Code\|LiveCode/InterfaceKit Example}} folder, and open {{Code\|InterfaceKit-full.rev}} in LiveCode. These examples were written in LiveCode 4.5, but will also work with other versions.

	7. The example will be running in {{Code\|Pointer Tool}} mode.		7. The example will be running in {{Code\|Pointer Tool}} mode.
Line 138:		Line 138:

	===Libraries===		===Libraries===
	*[{{SERVER}}/downloads/libraries/LiveCodeRequiredMac.zip Phidget LiveCode Library]		*[{{SERVER}}/downloads/phidget21/libraries/macos/LiveCodeRequiredMac.zip Phidget LiveCode Library]

	===Running Phidgets with LiveCode===		===Running Phidgets with LiveCode===
Line 249:		Line 249:
	==Extending LiveCode to Other Phidgets==		==Extending LiveCode to Other Phidgets==

	The Phidgets LiveCode library was developed from a C++ external wrapper and allows the PhidgetInterfaceKit to be programmable in LiveCode. It is possible to extend this external to other Phidgets as well. The goal of this section is to equip the reader with knowledge so that they can understand the relationship between LiveCode and the Phidgets framework. It is intended to provide guidance for readers who wish to extend LiveCode to other Phidgets. This guide uses C++, Microsoft Visual Studio 2005(for Windows XP SP3), XCode 3.2.4(for OS X 10.6.4), LiveCode 4.5 IDE and it is assumed that the reader has a solid understanding of these technologies. It will also help if you are familiar with programming with Phidgets in [[Language - C/C++ \| C/C++]]. For your reference, the Visual Studio and XCode project solutions for the Phidget LiveCode library are provided in the [{{SERVER}}/downloads/examples/LiveCode.zip LiveCode examples]		The Phidgets LiveCode library was developed from a C++ external wrapper and allows the PhidgetInterfaceKit to be programmable in LiveCode. It is possible to extend this external to other Phidgets as well. The goal of this section is to equip the reader with knowledge so that they can understand the relationship between LiveCode and the Phidgets framework. It is intended to provide guidance for readers who wish to extend LiveCode to other Phidgets. This guide uses C++, Microsoft Visual Studio 2005(for Windows XP SP3), XCode 3.2.4(for OS X 10.6.4), LiveCode 4.5 IDE and it is assumed that the reader has a solid understanding of these technologies. It will also help if you are familiar with programming with Phidgets in [[Language - C/C++ \| C/C++]]. For your reference, the Visual Studio and XCode project solutions for the Phidget LiveCode library are provided in the [{{SERVER}}/downloads/phidget21/examples/livecode/LiveCode.zip LiveCode examples]

	The first step is to download LiveCode Externals Creator SDK from [http://www.runrev.com RunRev]. Run the SDK, select C++ as the language, enter the project name, select the platform and specify the LiveCode installation path. Hit generate to create a skeleton project for the external.		The first step is to download LiveCode Externals Creator SDK from [http://www.runrev.com RunRev]. Run the SDK, select C++ as the language, enter the project name, select the platform and specify the LiveCode installation path. Hit generate to create a skeleton project for the external.

Burley: /* Windows (2000/XP/Vista/7) */

2013-04-02T18:34:02Z

Windows (2000/XP/Vista/7)

← Older revision		Revision as of 18:34, 2 April 2013
Line 27:		Line 27:
	*[[#Mac OS\|Mac OS]]		*[[#Mac OS\|Mac OS]]

	==Windows (~~2000/~~XP/Vista/7)==		==Windows (XP/Vista/7/8)==

	===Description of Library Files===		===Description of Library Files===

Cora at 19:50, 28 June 2012

2012-06-28T19:50:58Z

← Older revision		Revision as of 19:50, 28 June 2012
Line 11:		Line 11:
	==Quick Downloads==		==Quick Downloads==
	{{QuickDownloads\|LiveCode\|		{{QuickDownloads\|LiveCode\|
	{{APIQuickDownloads\|~~http://www.phidgets.com~~/documentation/LiveCode_API_Manual.pdf}}\|		{{APIQuickDownloads\|{{SERVER}}/documentation/LiveCode_API_Manual.pdf}}\|
	{{ExampleQuickDownloads\|~~http://www.phidgets.com~~/downloads/examples/LiveCode.zip\|}}\|		{{ExampleQuickDownloads\|{{SERVER}}/downloads/examples/LiveCode.zip\|}}\|
	{{ExtraLibraryQuickDownloads\|~~http://www.phidgets.com~~/downloads/libraries/LiveCodeRequiredWin.zip\|LiveCode Library\|(Windows)}}		{{ExtraLibraryQuickDownloads\|{{SERVER}}/downloads/libraries/LiveCodeRequiredWin.zip\|LiveCode Library\|(Windows)}}
	{{ExtraLibraryQuickDownloads\|~~http://www.phidgets.com~~/downloads/libraries/LiveCodeRequiredMac.zip\|LiveCode Library\|(OS X)}}		{{ExtraLibraryQuickDownloads\|{{SERVER}}/downloads/libraries/LiveCodeRequiredMac.zip\|LiveCode Library\|(OS X)}}
	{{WindowsQuickDownloads}}		{{WindowsQuickDownloads}}
	{{MacQuickDownloads}}}}		{{MacQuickDownloads}}}}
Line 36:		Line 36:
	* <b>{{Code\|Externals.txt}}</b> lets LiveCode know the name of the Phidget LiveCode library as well as the name of its corresponding {{Code\|phidgets_livecode.dll}}. More information on its usage will be provided in the [[#Use Our Examples \| Use Our Examples]] section.		* <b>{{Code\|Externals.txt}}</b> lets LiveCode know the name of the Phidget LiveCode library as well as the name of its corresponding {{Code\|phidgets_livecode.dll}}. More information on its usage will be provided in the [[#Use Our Examples \| Use Our Examples]] section.

	If you do not want to use our installer, you can download the [~~http://www.phidgets.com~~/downloads/libraries/phidget21-x86.zip {{Code\|phidget21.dll}}] and manually install it where you want; refer to our [[OS_-_Windows#Manual_File_Installation\|Manual Installation Instructions]].		If you do not want to use our installer, you can download the [{{SERVER}}/downloads/libraries/phidget21-x86.zip {{Code\|phidget21.dll}}] and manually install it where you want; refer to our [[OS_-_Windows#Manual_File_Installation\|Manual Installation Instructions]].

	===Use Our Examples===		===Use Our Examples===

	Currently, the only device we support and have examples for is the PhidgetInterfaceKit. In particular, the examples were written with the [~~[Product -~~ 1018 ~~2 - PhidgetInterfaceKit 8/8/8 \| PhidgetInterfaceKit 8/8/8]~~] in mind. If you have a different PhidgetInterfaceKit, you will need to modify the example to meet the number of digital inputs, digital outputs, and analog inputs that your device support.		Currently, the only device we support and have examples for is the PhidgetInterfaceKit. In particular, the examples were written with the [{{SERVER}}/products.php?product_id=1018 Phidget Interface Kit] in mind. If you have a different PhidgetInterfaceKit, you will need to modify the example to meet the number of digital inputs, digital outputs, and analog inputs that your device support.

	To run the examples,		To run the examples,

	1. Download the [~~http://www.phidgets.com~~/downloads/libraries/LiveCodeRequiredWin.zip Phidget LiveCode library] and extract it into a folder. Here, you will find two files inside the {{Code\|Windows}} folder: {{Code\|phidgets_livecode.dll}} and {{Code\|Externals.txt}}.		1. Download the [{{SERVER}}/downloads/libraries/LiveCodeRequiredWin.zip Phidget LiveCode library] and extract it into a folder. Here, you will find two files inside the {{Code\|Windows}} folder: {{Code\|phidgets_livecode.dll}} and {{Code\|Externals.txt}}.

	2. Open up the LiveCode environment.		2. Open up the LiveCode environment.
Line 60:		Line 60:
	[[File:LiveCode User Extensions 2.PNG\|link=\|alt=User Extensions Folder]]		[[File:LiveCode User Extensions 2.PNG\|link=\|alt=User Extensions Folder]]

	6. Download the [~~http://www.phidgets.com~~/downloads/examples/LiveCode.zip examples] and unpack them into a folder. Navigate to the {{Code\|LiveCode/InterfaceKit Example}} folder, and open {{Code\|InterfaceKit-full.rev}} in LiveCode. These examples were written in LiveCode 4.5, but will also work with other versions.		6. Download the [{{SERVER}}/downloads/examples/LiveCode.zip examples] and unpack them into a folder. Navigate to the {{Code\|LiveCode/InterfaceKit Example}} folder, and open {{Code\|InterfaceKit-full.rev}} in LiveCode. These examples were written in LiveCode 4.5, but will also work with other versions.

	7. The example will be running in {{Code\|Pointer Tool}} mode.		7. The example will be running in {{Code\|Pointer Tool}} mode.
Line 138:		Line 138:

	===Libraries===		===Libraries===
	*[~~http://www.phidgets.com~~/downloads/libraries/LiveCodeRequiredMac.zip Phidget LiveCode Library]		*[{{SERVER}}/downloads/libraries/LiveCodeRequiredMac.zip Phidget LiveCode Library]

	===Running Phidgets with LiveCode===		===Running Phidgets with LiveCode===
Line 151:		Line 151:
	Your main reference for writing LiveCode code will be our LiveCode API information, with syntax for all of our functions:		Your main reference for writing LiveCode code will be our LiveCode API information, with syntax for all of our functions:

	{{UsingAPhidgetInCodeGeneral\|both of which are available in LiveCode\|[~~http://www.phidgets.com~~/documentation/LiveCode_API_Manual.pdf LiveCode API]}}		{{UsingAPhidgetInCodeGeneral\|both of which are available in LiveCode\|[{{SERVER}}/documentation/LiveCode_API_Manual.pdf LiveCode API]}}

	We include code snippets as well as a section on adapting our libraries to use other Phidgets within LiveCode		We include code snippets as well as a section on adapting our libraries to use other Phidgets within LiveCode
Line 208:		Line 208:
	</div>		</div>

	In this function, the code inside SensorChangeHandler will get executed every time the PhidgetInterfaceKit reports a change on one of its analog inputs. Please refer to the [~~http://www.phidgets.com~~/documentation/LiveCode_API_Manual.pdf LiveCode API] manual for a full list of events and their usage.		In this function, the code inside SensorChangeHandler will get executed every time the PhidgetInterfaceKit reports a change on one of its analog inputs. Please refer to the [{{SERVER}}/documentation/LiveCode_API_Manual.pdf LiveCode API] manual for a full list of events and their usage.

	Most values can be also read directly as an alternative to event driven programming. Simply use the LiveCode API functions, such as {{Code\|phidgetsInterfaceKit_getSensorValue}} for PhidgetInterfaceKits.		Most values can be also read directly as an alternative to event driven programming. Simply use the LiveCode API functions, such as {{Code\|phidgetsInterfaceKit_getSensorValue}} for PhidgetInterfaceKits.
Line 249:		Line 249:
	==Extending LiveCode to Other Phidgets==		==Extending LiveCode to Other Phidgets==

	The Phidgets LiveCode library was developed from a C++ external wrapper and allows the PhidgetInterfaceKit to be programmable in LiveCode. It is possible to extend this external to other Phidgets as well. The goal of this section is to equip the reader with knowledge so that they can understand the relationship between LiveCode and the Phidgets framework. It is intended to provide guidance for readers who wish to extend LiveCode to other Phidgets. This guide uses C++, Microsoft Visual Studio 2005(for Windows XP SP3), XCode 3.2.4(for OS X 10.6.4), LiveCode 4.5 IDE and it is assumed that the reader has a solid understanding of these technologies. It will also help if you are familiar with programming with Phidgets in [[Language - C/C++ \| C/C++]]. For your reference, the Visual Studio and XCode project solutions for the Phidget LiveCode library are provided in the [~~http://www.phidgets.com~~/downloads/examples/LiveCode.zip LiveCode examples]		The Phidgets LiveCode library was developed from a C++ external wrapper and allows the PhidgetInterfaceKit to be programmable in LiveCode. It is possible to extend this external to other Phidgets as well. The goal of this section is to equip the reader with knowledge so that they can understand the relationship between LiveCode and the Phidgets framework. It is intended to provide guidance for readers who wish to extend LiveCode to other Phidgets. This guide uses C++, Microsoft Visual Studio 2005(for Windows XP SP3), XCode 3.2.4(for OS X 10.6.4), LiveCode 4.5 IDE and it is assumed that the reader has a solid understanding of these technologies. It will also help if you are familiar with programming with Phidgets in [[Language - C/C++ \| C/C++]]. For your reference, the Visual Studio and XCode project solutions for the Phidget LiveCode library are provided in the [{{SERVER}}/downloads/examples/LiveCode.zip LiveCode examples]

	The first step is to download LiveCode Externals Creator SDK from [http://www.runrev.com RunRev]. Run the SDK, select C++ as the language, enter the project name, select the platform and specify the LiveCode installation path. Hit generate to create a skeleton project for the external.		The first step is to download LiveCode Externals Creator SDK from [http://www.runrev.com RunRev]. Run the SDK, select C++ as the language, enter the project name, select the platform and specify the LiveCode installation path. Hit generate to create a skeleton project for the external.
Line 393:		Line 393:
	<b>Note:</b> For OS X, {{Code\|__stdcall}} is not needed.		<b>Note:</b> For OS X, {{Code\|__stdcall}} is not needed.

	Here, we use {{Code\|SendCardMessage}} to run the LiveCode command {{Code\|sensorChange}}. The message will be passed to the card that called {{Code\|phidgetsInterfaceKit_set_OnSensorChange_Handler}} before passing through the stack in the message hierarchy. Other Phidgets and functions can be extended in a similar manner. The [~~http://www.phidgets.com~~/documentation/Phidget21_C_Doc.zip C/C++ API Manual] contains calls and events for every type of Phidget.		Here, we use {{Code\|SendCardMessage}} to run the LiveCode command {{Code\|sensorChange}}. The message will be passed to the card that called {{Code\|phidgetsInterfaceKit_set_OnSensorChange_Handler}} before passing through the stack in the message hierarchy. Other Phidgets and functions can be extended in a similar manner. The [{{SERVER}}/documentation/Phidget21_C_Doc.zip C/C++ API Manual] contains calls and events for every type of Phidget.

	==Common Problems and Solutions/Workarounds==		==Common Problems and Solutions/Workarounds==

	None at this time.		None at this time.

Burley: /* Mac OS */

2012-05-24T21:02:25Z

Mac OS

← Older revision		Revision as of 21:02, 24 May 2012
Line 131:		Line 131:
	Now, the application can be used to control Phidgets.		Now, the application can be used to control Phidgets.

	==~~Mac~~ OS==		==OS X==

	LiveCode has excellent support on OS X.		LiveCode has excellent support on OS X.

Burley: /* Use Our Examples */

2012-05-24T21:02:07Z

Use Our Examples

← Older revision		Revision as of 21:02, 24 May 2012
Line 140:		Line 140:
	*[http://www.phidgets.com/downloads/libraries/LiveCodeRequiredMac.zip Phidget LiveCode Library]		*[http://www.phidgets.com/downloads/libraries/LiveCodeRequiredMac.zip Phidget LiveCode Library]

	===~~Use Our Examples~~===		===Running Phidgets with LiveCode===
	Once the LiveCode environment is installed, the steps to run actual code are nearly identical to the steps on [[#Windows (2000/XP/Vista/7)\|Windows]]. Please refer to that section for a detailed walk through on getting our sample code running. The only significant difference is setting the Phidget's library up. On a Windows machine the Preferences menu is under "Edit", on OS X it is under "LiveCode" as can be seen in the following image:		Once the LiveCode environment is installed, the steps to run actual code and create your own are nearly identical to the steps on [[#Windows (2000/XP/Vista/7)\|Windows]]. Please refer to that section for a detailed walk through on getting our sample code running as well as writing your own code. The only significant difference is setting the Phidget's library up. On a Windows machine the Preferences menu is under "Edit", on OS X it is under "LiveCode" as can be seen in the following image:

	[[image:livecodepreferences.png\|link=\|700px]]		[[image:livecodepreferences.png\|link=\|700px]]

Burley: /* Write Your Own Code */

2012-05-24T20:59:14Z

Write Your Own Code

← Older revision		Revision as of 20:59, 24 May 2012
Line 144:		Line 144:

	[[image:livecodepreferences.png\|link=\|700px]]		[[image:livecodepreferences.png\|link=\|700px]]

	~~===Write Your Own Code===~~

	~~====Creating Standalone Applications====~~

	==Follow the Examples==		==Follow the Examples==

Burley: /* Use Our Examples */

2012-05-24T20:58:38Z

Use Our Examples

← Older revision		Revision as of 20:58, 24 May 2012
Line 141:		Line 141:

	===Use Our Examples===		===Use Our Examples===
	Once the LiveCode environment is installed, the steps to run actual code are nearly identical to the steps on [[#Windows (2000/XP/7)\|Windows]]. Please refer to that section for a detailed walk through on getting our sample code running. The only significant difference is setting the Phidget's library up. On a Windows machine the Preferences menu is under "Edit", on OS X it is under "LiveCode" as can be seen in the following image:		Once the LiveCode environment is installed, the steps to run actual code are nearly identical to the steps on [[#Windows (2000/XP/Vista/7)\|Windows]]. Please refer to that section for a detailed walk through on getting our sample code running. The only significant difference is setting the Phidget's library up. On a Windows machine the Preferences menu is under "Edit", on OS X it is under "LiveCode" as can be seen in the following image:

	[[image:livecodepreferences.png\|link=\|~~500px~~]]		[[image:livecodepreferences.png\|link=\|700px]]

	===Write Your Own Code===		===Write Your Own Code===

Burley: /* Use Our Examples */

2012-05-24T20:58:16Z

Use Our Examples

← Older revision		Revision as of 20:58, 24 May 2012
Line 141:		Line 141:

	===Use Our Examples===		===Use Our Examples===
			Once the LiveCode environment is installed, the steps to run actual code are nearly identical to the steps on [[#Windows (2000/XP/7)\|Windows]]. Please refer to that section for a detailed walk through on getting our sample code running. The only significant difference is setting the Phidget's library up. On a Windows machine the Preferences menu is under "Edit", on OS X it is under "LiveCode" as can be seen in the following image:

			[[image:livecodepreferences.png\|link=\|500px]]

	===Write Your Own Code===		===Write Your Own Code===

Burley: /* Description */

2012-05-24T20:49:46Z

Description

← Older revision		Revision as of 20:49, 24 May 2012
Line 139:		Line 139:
	===Libraries===		===Libraries===
	*[http://www.phidgets.com/downloads/libraries/LiveCodeRequiredMac.zip Phidget LiveCode Library]		*[http://www.phidgets.com/downloads/libraries/LiveCodeRequiredMac.zip Phidget LiveCode Library]

	~~===Description===~~
	~~LiveCode on Windows depend on the following files, which the installers above put onto your system:~~
	* <b>{{Code\| libphidget21.so}}</b> contains the actual Phidget library, which is used at run-time. If you used our installer, it's already placed in {{Code\|C:\Windows\System32}}. It can be manually installed - check our [[Manual Installation instructions]].
	* <b>{{Code\|phidgets_livecode.bundle}}</b> is the Phidget library for LiveCode. It should be placed in the LiveCode User Extensions folder. More information will be provided in the [[#Use Our Examples 2 \| Use Our Examples]] section.
	* <b>{{Code\|Externals.txt}}</b> lets LiveCode know the name of the Phidget LiveCode library as well as the name of its corresponding {{Code\|phidgets_livecode.dll}}. More information will be provided in the [[#Use Our Examples 2 \| Use Our Examples]] section.

	===Use Our Examples===		===Use Our Examples===

Cora: /* Step Four: Close and Delete */

2012-05-16T18:37:00Z

Step Four: Close and Delete

← Older revision		Revision as of 18:37, 16 May 2012
Line 235:		Line 235:

	====Step Four: Close and Delete====		====Step Four: Close and Delete====

			At the end of your program make sure to close and delete (release) the Phidget:

	<div class="source">		<div class="source">