X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~mdw/git/clg/blobdiff_plain/560af5c515eb5b6206040a9334de4254d2650147..eeda1c2da2663832d114329d58e92f77c86cf2fa:/glib/gobject.lisp diff --git a/glib/gobject.lisp b/glib/gobject.lisp index 015f29b..8292772 100644 --- a/glib/gobject.lisp +++ b/glib/gobject.lisp @@ -1,5 +1,5 @@ ;; Common Lisp bindings for GTK+ v2.0 -;; Copyright (C) 2000 Espen S. Johnsen +;; Copyright (C) 2000-2001 Espen S. Johnsen ;; ;; This library is free software; you can redistribute it and/or ;; modify it under the terms of the GNU Lesser General Public @@ -15,90 +15,367 @@ ;; License along with this library; if not, write to the Free Software ;; Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -;; $Id: gobject.lisp,v 1.1 2000-08-14 16:44:30 espen Exp $ +;; $Id: gobject.lisp,v 1.23 2004-12-16 23:19:17 espen Exp $ (in-package "GLIB") +;;;; Metaclass used for subclasses of gobject + +(eval-when (:compile-toplevel :load-toplevel :execute) + (defclass gobject-class (ginstance-class) + ()) + + (defmethod validate-superclass ((class gobject-class) + (super pcl::standard-class)) +; (subtypep (class-name super) 'gobject) + t)) + +(defclass direct-property-slot-definition (direct-virtual-slot-definition) + ((pname :reader slot-definition-pname :initarg :pname) + (readable :initform t :reader slot-readable-p :initarg :readable) + (writable :initform t :reader slot-writable-p :initarg :writable) + (construct :initform nil :initarg :construct))) + +(defclass effective-property-slot-definition (effective-virtual-slot-definition) + ((pname :reader slot-definition-pname :initarg :pname) + (readable :reader slot-readable-p :initarg :readable) + (writable :reader slot-writable-p :initarg :writable) + (construct :initarg :construct)));) + +(defbinding %object-ref () pointer + (location pointer)) + +(defbinding %object-unref () nil + (location pointer)) + +(defmethod reference-foreign ((class gobject-class) location) + (declare (ignore class)) + (%object-ref location)) + +(defmethod unreference-foreign ((class gobject-class) location) + (declare (ignore class)) + (%object-unref location)) + + +; (defbinding object-class-install-param () nil +; (class pointer) +; (id unsigned-int) +; (parameter parameter)) + +; (defbinding object-class-find-param-spec () parameter +; (class pointer) +; (name string)) + +(defun signal-name-to-string (name) + (substitute #\_ #\- (string-downcase (string name)))) + + +(defmethod direct-slot-definition-class ((class gobject-class) &rest initargs) + (case (getf initargs :allocation) + (:property (find-class 'direct-property-slot-definition)) + (t (call-next-method)))) + +(defmethod effective-slot-definition-class ((class gobject-class) &rest initargs) + (case (getf initargs :allocation) + (:property (find-class 'effective-property-slot-definition)) + (t (call-next-method)))) + +(defmethod compute-effective-slot-definition-initargs ((class gobject-class) direct-slotds) + (if (typep (first direct-slotds) 'direct-property-slot-definition) + (nconc + (list :pname (signal-name-to-string + (most-specific-slot-value direct-slotds 'pname)) + :readable (most-specific-slot-value direct-slotds 'readable) + :writable (most-specific-slot-value direct-slotds 'writable) + :construct (most-specific-slot-value direct-slotds 'construct)) + (call-next-method)) + (call-next-method))) + + +(defmethod initialize-internal-slot-functions ((slotd effective-property-slot-definition)) + (let* ((type (slot-definition-type slotd)) + (pname (slot-definition-pname slotd)) + (type-number (find-type-number type))) + (when (and (not (slot-boundp slotd 'getter)) (slot-readable-p slotd)) + (setf + (slot-value slotd 'getter) + (let ((reader nil)) + #'(lambda (object) + (unless reader + (setq reader (reader-function (type-from-number type-number)))) + (let ((gvalue (gvalue-new type-number))) + (%object-get-property object pname gvalue) + (unwind-protect + (funcall reader gvalue +gvalue-value-offset+) + (gvalue-free gvalue t))))))) + + (when (and (not (slot-boundp slotd 'setter)) (slot-writable-p slotd)) + (setf + (slot-value slotd 'setter) + (let ((writer nil)) + #'(lambda (value object) + (unless writer + (setq writer (writer-function (type-from-number type-number)))) + (let ((gvalue (gvalue-new type-number))) + (funcall writer value gvalue +gvalue-value-offset+) + (%object-set-property object pname gvalue) + (gvalue-free gvalue t) + value)))))) + + (call-next-method)) + + +;;;; Super class for all classes in the GObject type hierarchy + (eval-when (:compile-toplevel :load-toplevel :execute) - (defclass gobject (gtype) + (defclass gobject (ginstance) () - (:metaclass gtype-class) - (:alien-name "GObject")) + (:metaclass gobject-class) + (:alien-name "GObject"))) - (defclass gobject-class (gtype-class))) +(defun initial-add (object function initargs key pkey) + (loop + as (initarg value . rest) = initargs then rest + do (cond + ((eq initarg key) (funcall function object value)) + ((eq initarg pkey) (mapc #'(lambda (value) + (funcall function object value)) + value))) + while rest)) -;;;; Methods for gobject +(defun initial-apply-add (object function initargs key pkey) + (initial-add object #'(lambda (object value) + (apply function object (mklist value))) + initargs key pkey)) -;; Specializing reference-instance and unreference-instance on gobject -;; is not really necessary but done for efficiency -(defmethod reference-instance ((object gobject)) - (%object-ref object) - object) +(defmethod initialize-instance ((object gobject) &rest initargs) + ;; Extract initargs which we should pass directly to the GObeject + ;; constructor + (let* ((slotds (class-slots (class-of object))) + (args (when initargs + (loop + as (key value . rest) = initargs then rest + as slotd = (find-if + #'(lambda (slotd) + (member key (slot-definition-initargs slotd))) + slotds) + when (and (typep slotd 'effective-property-slot-definition) + (slot-value slotd 'construct)) + collect (progn + (remf initargs key) + (list + (slot-definition-pname slotd) + (slot-definition-type slotd) + value)) + while rest)))) + (if args + (let* ((string-size (size-of 'string)) + (string-writer (writer-function 'string)) + (string-destroy (destroy-function 'string)) + (params (allocate-memory + (* (length args) (+ string-size +gvalue-size+))))) + (loop + for (pname type value) in args + as tmp = params then (sap+ tmp (+ string-size +gvalue-size+)) + do (funcall string-writer pname tmp) + (gvalue-init (sap+ tmp string-size) type value)) + (unwind-protect + (setf + (slot-value object 'location) + (%gobject-newv (type-number-of object) (length args) params)) + (loop + repeat (length args) + as tmp = params then (sap+ tmp (+ string-size +gvalue-size+)) + do (funcall string-destroy tmp) + (gvalue-unset (sap+ tmp string-size))) + (deallocate-memory params))) + (setf + (slot-value object 'location) + (%gobject-new (type-number-of object))))) -(defmethod unreference-instance ((object gobject)) - (%object-unref object)) + (apply #'call-next-method object initargs)) -(deftype-method alien-ref gobject (type-spec) - (declare (ignore type-spec)) - '%object-ref) -(deftype-method alien-unref gobject (type-spec) - (declare (ignore type-spec)) - '%object-unref) +(defmethod instance-finalizer ((instance gobject)) + (let ((location (proxy-location instance))) + #'(lambda () + (remove-cached-instance location) + (%object-unref location)))) -(define-foreign %object-ref () pointer - (object (or gobject pointer))) -(define-foreign %object-unref () nil - (object (or gobject pointer))) +(defbinding (%gobject-new "g_object_new") () pointer + (type type-number) + (nil null)) +(defbinding (%gobject-newv "g_object_newv") () pointer + (type type-number) + (n-parameters unsigned-int) + (params pointer)) -;; Parameter stuff not yet implemented -; (define-foreign object-set-param () nil -; (object gobject) -; (name string) -; (value gvalue)) -; (define-foreign object-get-param () nil -; (object gobject) -; (name string) -; (value gvalue :out)) +;;;; Property stuff -; (define-foreign object-queue-param-changed () nil -; (object gobject) -; (name string)) +(defbinding %object-set-property () nil + (object gobject) + (name string) + (value gvalue)) +(defbinding %object-get-property () nil + (object gobject) + (name string) + (value gvalue)) +(defbinding %object-notify () nil + (object gobject) + (name string)) -;;;; Methods for gobject-class +(defbinding object-freeze-notify () nil + (object gobject)) -(defmethod shared-initialize ((class gobject-class) names &rest initargs - &key type-init name) - (declare (ignore initargs names)) - (let ((alien - (alien::%heap-alien - (alien::make-heap-alien-info - :type (alien::parse-alien-type '(function (unsigned 32))) - :sap-form (system:foreign-symbol-address - (or - (first type-init) - (default-alien-func-name - (format - nil "~A_get_type" (or name (class-name class)))))))))) - (alien:alien-funcall alien)) - (call-next-method)) +(defbinding object-thaw-notify () nil + (object gobject)) +(defbinding %object-set-qdata-full () nil + (object gobject) + (id quark) + (data unsigned-long) + (destroy-marshal pointer)) -; (define-foreign object-class-install-param () nil -; (class pointer) -; (id unsigned-int) -; (parameter parameter)) -; (define-foreign object-class-find-param-spec () parameter -; (class pointer) -; (name string)) +;;;; User data + +(defun (setf object-data) (data object key &key (test #'eq)) + (%object-set-qdata-full + object (quark-from-object key :test test) + (register-user-data data) (callback %destroy-user-data)) + data) + +(defbinding %object-get-qdata () unsigned-long + (object gobject) + (id quark)) + +(defun object-data (object key &key (test #'eq)) + (find-user-data + (%object-get-qdata object (quark-from-object key :test test)))) + + +;;;; + +(defbinding %object-class-list-properties () pointer + (class pointer) + (n-properties unsigned-int :out)) + + +(defun %map-params (params length type inherited-p) + (if inherited-p + (map-c-vector 'list #'identity params 'param length) + (let ((properties ())) + (map-c-vector 'list + #'(lambda (param) + (when (eql (param-owner-type param) type) + (push param properties))) + params 'param length) + (nreverse properties)))) + +(defun query-object-class-properties (type &optional inherited-p) + (let* ((type-number (find-type-number type)) + (class (type-class-ref type-number))) + (unwind-protect + (multiple-value-bind (array length) + (%object-class-list-properties class) + (unwind-protect + (%map-params array length type-number inherited-p) + (deallocate-memory array))) +; (type-class-unref type-number) + ))) + + +(defun default-slot-name (name) + (intern (substitute #\- #\_ (string-upcase (string-upcase name))))) + +(defun default-slot-accessor (class-name slot-name type) + (intern + (format + nil "~A-~A~A" class-name slot-name + (if (eq type 'boolean) "-P" "")))) + + +(defun slot-definition-from-property (class property &optional args) + (with-slots (name flags value-type documentation) property + (let* ((slot-name (default-slot-name name)) + (slot-type (or (getf args :type) (type-from-number value-type) value-type)) + (accessor (default-slot-accessor class slot-name slot-type))) + + `(,slot-name + :allocation :property :pname ,name + + ;; temporary hack + ,@(cond + ((find :unbound args) (list :unbound (getf args :unbound))) + ((type-is-p slot-type 'gobject) (list :unbound nil))) + + ;; accessors + ,@(cond + ((and + (member :writable flags) (member :readable flags) + (not (member :construct-only flags))) + (list :accessor accessor)) + ((and (member :writable flags) (not (member :construct-only flags))) + (list :writer `(setf ,accessor))) + ((member :readable flags) + (list :reader accessor))) + + ;; readable/writable/construct + ,@(when (or (not (member :writable flags)) + (member :construct-only flags)) + '(:writable nil)) + ,@(when (not (member :readable flags)) + '(:readable nil)) + ,@(when (or (member :construct flags) + (member :construct-only flags)) + '(:construct t)) + + ;; initargs + ,@(when (or (member :construct flags) + (member :construct-only flags) + (member :writable flags)) + (list :initarg (intern (string slot-name) "KEYWORD"))) + + :type ,slot-type + :documentation ,documentation)))) + + +(defun slot-definitions (class properties slots) + (loop + for property in properties + as slot = (or + (find (param-name property) slots + :key #'(lambda (slot) (getf (rest slot) :pname)) + :test #'string=) + (find (param-name property) slots + :key #'first :test #'string-equal)) + do (cond + ((not slot) + (push (slot-definition-from-property class property) slots)) + ((getf (rest slot) :merge) + (setf + (rest slot) + (rest (slot-definition-from-property class property (rest slot))))))) + (delete-if #'(lambda (slot) (getf (rest slot) :ignore)) slots)) + + +(defun expand-gobject-type (type &optional options (metaclass 'gobject-class)) + (let ((supers (cons (supertype type) (implements type))) + (class (type-from-number type)) + (slots (getf options :slots))) + `(defclass ,class ,supers + ,(slot-definitions class (query-object-class-properties type) slots) + (:metaclass ,metaclass) + (:alien-name ,(find-type-name type))))) + +(register-derivable-type 'gobject "GObject" 'expand-gobject-type)