Merge pull request #144 from gnustep/NSMovie_branch

Create files to support NSMovie and NSMovieView

Author: gcasa

ChangeLog

@@ -1,6 +1,26 @@
+2025-05-29 Gregory John Casamento <greg.casamento@gmail.com>
+
+	* config.make.in: Add HAVE_* variables.
+	* configure
+	* configure.ac: Look for relevant libraries
+	* Headers/Additions/GNUstepGUI/config.h.in
+	* Headers/AppKit/NSMovie.h
+	* Headers/AppKit/NSMovieView.h
+	* Source/GNUmakefile
+	* Source/GNUmakefile.preamble
+	* Source/GSAudioPlayer.h
+	* Source/GSAudioPlayer.m: Added to play audio from avcodec
+	* Source/GSMovieView.h
+	* Source/GSMovieView.m: Subclass to handle video playback
+	* Source/NSMovie.m
+	* Source/NSMovieView.m: Cleanup and add textfield.
+	* Source/NSSound.m: Cleanup NSSound, add support for playing
+	ffmpeg movies using NSMovie, NSMovieView.
+
 2025-04-30 Gregory John Casamento <greg.casamento@gmail.com>
 
-	* Headers/AppKit/NSColorSpace.h: Add NSColorSpaceModel* enumerated values.
+	* Headers/AppKit/NSColorSpace.h: Add NSColorSpaceModel*
+	enumerated values.
 
 2025-02-11 Richard Frith-Macdonald <rfm@gnu.org>
 
@@ -9,8 +29,7 @@
 	* INSTALL:
 	* NEWS:
 	* Source/DocMakefile:
-	* Version:
-	Updates for 0.32.0 release
+	* Version: Updates for 0.32.0 release
 
 2024-11-08 Gregory John Casamento <greg.casamento@gmail.com>
 
@@ -27,7 +46,8 @@
 
 2024-10-29 Fred Kiefer <FredKiefer@gmx.de>
 
-	* Headers/AppKit/NSLayoutAnchor.h: Add missing include that is required after a change in base.
+	* Headers/AppKit/NSLayoutAnchor.h: Add missing include that is
+	required after a change in base.
 	* Source/NSTableView.m: Forward declare new methods.
 
 2024-08-29 Gregory John Casamento <greg.casamento@gmail.com>

Headers/Additions/GNUstepGUI/config.h.in

@@ -148,6 +148,9 @@
 /* MagickCore >= 7 */
 #undef MAGICKCORE_7_OR_NEWER
 
+/* avcodec */
+#undef HAVE_AVCODEC
+
 /* mntent structure member name */
 #undef MNT_FSNAME
 

Headers/AppKit/NSMovie.h

@@ -1,9 +1,11 @@
-/** <title>NSMovie</title>
+/* <title>NSMovie</title>
 
    <abstract>Encapsulate a Quicktime movie</abstract>
 
    Copyright <copy>(C) 2003 Free Software Foundation, Inc.</copy>
 
+   Author: Gregory John Casamento <greg.casamento@gmail.com>
+   Date: May 2025
    Author: Fred Kiefer <FredKiefer@gmx.de>
    Date: March 2003
 
@@ -28,9 +30,25 @@
 
 #ifndef _GNUstep_H_NSMovie
 #define _GNUstep_H_NSMovie
-#import <AppKit/AppKitDefines.h>
-
 #import <Foundation/NSObject.h>
+#import "AppKit/AppKitDefines.h"
+
+/**
+ * NSMovie
+ *
+ * Encapsulates a QuickTime movie object, providing methods to initialize and
+ * retrieve movie data from various sources, such as NSData, NSURL, or NSPasteboard.
+ *
+ * Instance Variables:
+ *   _movie:
+ *     The raw NSData representing the contents of the QuickTime movie.
+ *
+ *   _url:
+ *     The URL from which the movie was loaded. May be nil if not URL-based.
+ *
+ *   _tmp:
+ *     A boolean indicating whether the movie data is temporary (not persisted).
+ */
 
 @class NSArray;
 @class NSData;
@@ -41,19 +59,49 @@ APPKIT_EXPORT_CLASS
 @interface NSMovie : NSObject <NSCopying, NSCoding> 
 {
   @private
-    NSData*  _movie;
-    NSURL*   _url;
+    NSData*   _movie;
+    NSURL*    _url;
+    BOOL      _tmp;
 }
 
+/**
+ * An array of all of the types NSMovie can support.
+ */
 + (NSArray*) movieUnfilteredFileTypes;
+
+/**
+ * An array of all of the pasteboard types NSMovie can support.
+ */
 + (NSArray*) movieUnfilteredPasteboardTypes;
+
+/**
+ * Returns YES, if the object can be initialized with the given pasteboard.
+ */
 + (BOOL) canInitWithPasteboard: (NSPasteboard*)pasteboard;
 
-- (id) initWithMovie: (void*)movie;
-- (id) initWithURL: (NSURL*)url byReference: (BOOL)byRef;
-- (id) initWithPasteboard: (NSPasteboard*)pasteboard;
+/**
+ * Returns an NSMovie with the raw data pointed to by movie.
+ */
+- (instancetype) initWithMovie: (void*)movie;
 
+/**
+ * Returns an NSMovie with the given URL. byRef should be YES if it is by reference.
+ */
+- (instancetype) initWithURL: (NSURL*)url byReference: (BOOL)byRef;
+
+/**
+ * Returns an NSMovie initialized with the pasteboard passed in.
+ */
+- (instancetype) initWithPasteboard: (NSPasteboard*)pasteboard;
+
+/**
+ * Returns the raw data for the movie.
+ */
 - (void*) QTMovie;
+
+/**
+ * Returns the URL of the movie to be played.
+ */
 - (NSURL*) URL;
 
 @end