Skip to content
This repository was archived by the owner on Aug 31, 2021. It is now read-only.

Commit eac438a

Browse files
peter-bpeter-b
committed
revvideograbber: Remove from Mac OS X builds
revvideograbber for Mac OS X depends on QuickTime, which is not available to build against when using the `macosx10.9` SDK (or newer). In LiveCode 9, we will end support for Mac OS X 10.8 and earlier. The need to be able to build revvideograbber has been preventing from using newer C++ language and standard library features, and has made it difficult to get started with LiveCode engine development. This patch discontinues revvideograbber for Mac, and updates all revvideograbber documentation accordingly. revvideograbber is still supported on Windows, using DirectShow. Some of its commands are no longer useful, including `revVideoGrabSettings`, `revSetVideoGrabSettings`, and `revVideoGrabIdle`.
1 parent 44607cf commit eac438a

18 files changed

+106
-190
lines changed

‎Installer/package.txt‎

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -702,13 +702,11 @@ component Externals.Windows
702702
component Externals.MacOSX
703703
into [[TargetFolder]]/Externals place
704704
executable macosx:revspeech.bundle
705-
executable macosx:revvideograbber.bundle
706705
executable macosx:revxml.bundle
707706
executable macosx:revbrowser.bundle
708707
executable macosx:revzip.bundle
709708
executable macosx:revfont.bundle
710709
declare external "Speech" using revspeech.bundle
711-
declare external "Video Grabber" using revvideograbber.bundle
712710
declare external "XML" using revxml.bundle
713711
declare external "Browser" using revbrowser.bundle
714712
declare external "Revolution Zip" using revzip.bundle

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ This repository contains a number of subprojects, each of which has its own subd
4040

4141
* `revspeech/` — Text-to-speech support
4242

43-
* `revvideograbber/` — Video capture
43+
* `revvideograbber/` — Video capture (Windows only)
4444

4545
* `revxml/` — XML parsing and generation
4646

‎config.sh‎

Lines changed: 1 addition & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -353,13 +353,6 @@ if test "${OS}" = "emscripten" ; then
353353
NODE_JS=${NODE_JS:-node}
354354
fi
355355

356-
357-
# Building on Travis
358-
if [ "${TRAVIS}" = "true" ] ; then
359-
DISABLE_REVVIDEOGRABBER=-Denable_revvideograbber=0
360-
fi
361-
362-
363356
################################################################
364357
# Invoke gyp
365358
################################################################
@@ -412,8 +405,7 @@ case ${OS} in
412405
invoke_gyp $basic_args "-DOS=${OS}" \
413406
"-Dtarget_sdk=${XCODE_TARGET_SDK}" \
414407
"-Dhost_sdk=${XCODE_HOST_SDK}" \
415-
"-Dtarget_arch=${TARGET_ARCH}" "$@" \
416-
${DISABLE_REVVIDEOGRABBER}
408+
"-Dtarget_arch=${TARGET_ARCH}" "$@"
417409
;;
418410
*)
419411
echo "ERROR: Bad configuration for generating project files"

‎docs/development/build-mac.md‎

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -28,13 +28,10 @@ Download and install each of the following versions of Xcode, placing their app
2828
| ------------- | --------------------------------------- |
2929
| 8.0 | /Applications/Xcode-Dev/Xcode_8_0.app |
3030
| 7.2.1 | /Applications/Xcode-Dev/Xcode_7_2_1.app |
31-
| 6.2 | /Applications/Xcode-Dev/Xcode_6_2.app |
32-
| 5.1.1 [1] | /Applications/Xcode-Dev/Xcode_5_1_1.app |
33-
| 4.3.3 [2] | /Applications/Xcode-Dev/Xcode_4_3_3.app |
31+
| 6.2 [1] | /Applications/Xcode-Dev/Xcode_6_2.app |
3432

3533
Notes:
36-
1. Required for OS X build excluding "revvideograbber" extension
37-
2. Required for "revvideograbber" extension
34+
1. Required for OS X build
3835

3936
Make sure you run and verify each of the versions of Xcode. Download and install any extra SDKs you need using the "Xcode → Preferences → Downloads" window.
4037

‎docs/dictionary/command/revCloseVideoGrabber.lcdoc‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Associations: video library
1212

1313
Introduced: 2.0
1414

15-
OS: mac, windows
15+
OS: windows
1616

1717
Platforms: desktop
1818

@@ -61,5 +61,9 @@ command (glossary), LiveCode custom library (glossary),
6161
Video library (library), closeStack (message), shutdown (message),
6262
stack (object)
6363

64+
Changes:
65+
Support for the "Video Grabber" library on Mac OS X ended in LiveCode
66+
9.0.
67+
6468
Tags: multimedia
6569

‎docs/dictionary/command/revInitializeVideoGrabber.lcdoc‎

Lines changed: 8 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -11,15 +11,12 @@ Associations: video library
1111

1212
Introduced: 2.0
1313

14-
OS: mac, windows
14+
OS: windows
1515

1616
Platforms: desktop
1717

1818
Security: disk, privacy
1919

20-
Example:
21-
revInitializeVideoGrabber the short name of this stack, "QT","100,100,200,200"
22-
2320
Example:
2421
revInitializeVideoGrabber the short name of this stack, "VFW",the rect of this stack
2522

@@ -29,7 +26,7 @@ The short name of the stack that the video-grabber should attach itself
2926
to.
3027

3128
videoMethod:
32-
Either "QT" or "VFW".
29+
Must be "VFW".
3330

3431
grabberRect:
3532
The rectangle of the video grabber window, and consists of four integers
@@ -58,9 +55,8 @@ connected. Use the <revRecordVideo> <command> to record video from the
5855
camera to a <file>, or use the <revPreviewVideo> command to display
5956
video without saving it.
6057

61-
To use QuickTime for video capture on Mac OS X specify "QT" as the
62-
<videoMethod>. To use <VFW|Video for Windows> (on <Windows|Windows
63-
systems>), specify "VFW".
58+
To use <VFW|Video for Windows> (on <Windows|Windows systems>), specify
59+
"VFW".
6460

6561
To close the window and unload the video capture code, you should use
6662
the <revCloseVideoGrabber> <command> when you're done with <video
@@ -80,9 +76,10 @@ The use of <QuickTime> was deprecated in version 8.1 of LiveCode with
8076
new defaults for <dontUseQT> and <dontUseQTEffects> as true on all
8177
systems apart from pre OS X 10.8. The Windows build of LiveCode no
8278
longer supports any <QuickTime> features and setting the <dontUseQT> and
83-
<dontUseQTEffects> will have no effect. Additionally <QuickTime> does
84-
not include 64 bit support and therefore can not be supported on OS X 64
85-
bit builds of LiveCode.
79+
<dontUseQTEffects> will have no effect.
80+
81+
Support for the "Video Grabber" library on Mac OS X ended in LiveCode
82+
9.0.
8683

8784
References: revCloseVideoGrabber (command),
8885
revSetVideoGrabberRect (command), revRecordVideo (command),

‎docs/dictionary/command/revPreviewVideo.lcdoc‎

Lines changed: 5 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Associations: video library
1111

1212
Introduced: 2.0
1313

14-
OS: mac, windows
14+
OS: windows
1515

1616
Platforms: desktop
1717

@@ -38,11 +38,6 @@ save the video as a <file> while displaying it, use the <revRecordVideo>
3838
If the video grabber was already recording video to a file, the
3939
<revPreviewVideo> <command> stops the recording.
4040

41-
>*Important:* If you are using <QuickTime> for video capture, <execute>
42-
> the <revVideoGrabIdle> <command> periodically while previewing or
43-
> recording video. Otherwise, you may experience poor quality in the
44-
> video capture.
45-
4641
To stop displaying the video input, use the <revStopPreviewingVideo>
4742
<command>.
4843

@@ -60,9 +55,10 @@ The use of <QuickTime> was deprecated in version 8.1 of LiveCode with
6055
new defaults for <dontUseQT> and <dontUseQTEffects> as true on all
6156
systems apart from pre OS X 10.8. The Windows build of LiveCode no
6257
longer supports any <QuickTime> features and setting the <dontUseQT> and
63-
<dontUseQTEffects> will have no effect. Additionally <QuickTime> does
64-
not include 64 bit support and therefore can not be supported on OS X 64
65-
bit builds of LiveCode.
58+
<dontUseQTEffects> will have no effect.
59+
60+
Support for the "Video Grabber" library on Mac OS X ended in LiveCode
61+
9.0.
6662

6763
References: revVideoFrameImage (command), revRecordVideo (command),
6864
revVideoGrabIdle (command), revStopPreviewingVideo (command),

‎docs/dictionary/command/revRecordVideo.lcdoc‎

Lines changed: 6 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Associations: video library
1111

1212
Introduced: 2.0
1313

14-
OS: mac, windows
14+
OS: windows
1515

1616
Platforms: desktop
1717

@@ -38,20 +38,11 @@ Use the <revRecordVideo> <command> to record a <movie> file.
3838
You must use the <revInitializeVideoGrabber> <command> to open the
3939
<video grabber> before you can use the <revRecordVideo> <command>.
4040

41-
If you specified "QT" as the video method when you executed the
42-
<revInitializeVideoGrabber> <command>, the recorded video is stored in
43-
<QuickTime> <format>. If you specified "VFW", the recorded video is
44-
stored in <AVI> <format>.
41+
The recorded video is stored in <AVI> <format>.
4542

4643
If the video grabber was already recording video to a file, executing
4744
the <revRecordVideo> <command> again stops that recording and starts a
4845
new one.
49-
50-
>*Important:* If you are using <QuickTime> for video capture, <execute>
51-
> the <revVideoGrabIdle> <command> periodically while previewing or
52-
> recording video. Not doing so may cause the video in the <video
53-
> grabber> to stutter or display strange screen artifacts
54-
5546
To stop recording the video input, use the <revStopRecordingVideo>
5647
<command>.
5748

@@ -69,9 +60,10 @@ The use of <QuickTime> was deprecated in version 8.1 of LiveCode with
6960
new defaults for <dontUseQT> and <dontUseQTEffects> as true on all
7061
systems apart from pre OS X 10.8. The Windows build of LiveCode no
7162
longer supports any <QuickTime> features and setting the <dontUseQT> and
72-
<dontUseQTEffects> will have no effect. Additionally <QuickTime> does
73-
not include 64 bit support and therefore can not be supported on OS X 64
74-
bit builds of LiveCode.
63+
<dontUseQTEffects> will have no effect.
64+
65+
Support for the "Video Grabber" library on Mac OS X ended in LiveCode
66+
9.0.
7567

7668
References: revVideoGrabIdle (command), revPreviewVideo (command),
7769
revInitializeVideoGrabber (command), revStopRecordingVideo (command),

‎docs/dictionary/command/revSetVideoGrabSettings.lcdoc‎

Lines changed: 8 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,9 @@ Associations: video library
1111

1212
Introduced: 2.0
1313

14-
OS: mac
14+
Deprecated: 9.0
15+
16+
OS:
1517

1618
Platforms: desktop
1719

@@ -29,18 +31,7 @@ settings string is a block of binary data returned by the
2931
revVideoGrabSettings function.
3032

3133
Description:
32-
Use the <revSetVideoGrabSettings> <command> to restore settings for
33-
<video capture>.
34-
35-
You specify settings for video capture in the video capture dialog box,
36-
which is displayed by the revVideoGrabDialog <command>. You can get the
37-
current settings with the <revVideoGrabSettings> <function> and restore
38-
them later with the <revSetVideoGrabSettings> <command>. This allows you
39-
to make changes to the <video capture|video-capture> settings under
40-
script control.
41-
42-
>*Important:* The <revSetVideoGrabSettings> <command> works only for
43-
> <QuickTime> <video capture>.
34+
The <revSetVideoGrabSettings> is ignored and and has no effect.
4435

4536
>*Important:* The <revSetVideoGrabSettings> <command> is part of the
4637
> <Video library>. To ensure that the <command> works in a
@@ -56,9 +47,10 @@ The use of <QuickTime> was deprecated in version 8.1 of LiveCode with
5647
new defaults for <dontUseQT> and <dontUseQTEffects> as true on all
5748
systems apart from pre OS X 10.8. The Windows build of LiveCode no
5849
longer supports any <QuickTime> features and setting the <dontUseQT> and
59-
<dontUseQTEffects> will have no effect. Additionally <QuickTime> does
60-
not include 64 bit support and therefore can not be supported on OS X 64
61-
bit builds of LiveCode.
50+
<dontUseQTEffects> will have no effect.
51+
52+
Support for the "Video Grabber" library on Mac OS X ended in LiveCode
53+
9.0.
6254

6355
References: revVideoGrabSettings (command), function (control structure),
6456
video capture (glossary), Standalone Application Settings (glossary),

‎docs/dictionary/command/revSetVideoGrabberRect.lcdoc‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Associations: video library
1212

1313
Introduced: 2.0
1414

15-
OS: mac, windows
15+
OS: windows
1616

1717
Platforms: desktop
1818

@@ -59,6 +59,10 @@ left, bottom, and right edges of the <video grabber>, in <absolute
5959
> "Video Grabber"
6060
> library checkbox is checked.
6161

62+
Changes:
63+
Support for the "Video Grabber" library on Mac OS X ended in LiveCode
64+
9.0.
65+
6266
References: revInitializeVideoGrabber (command), globalLoc (function),
6367
Standalone Application Settings (glossary),
6468
absolute coordinates (glossary), video grabber (glossary),

0 commit comments

Comments
 (0)