Class: GObject::Object

Inherits:
Object
  • Object
show all
Defined in:
lib/ffi-gobject/object.rb

Overview

Overrides for GObject, GObject’s generic base class.

Class Method Summary collapse

Instance Method Summary collapse

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method, *args) ⇒ Object

TODO: Generate accessor methods from GIR at class definition time



93
94
95
96
97
98
99
100
101
 
# File 'lib/ffi-gobject/object.rb', line 93

def method_missing(method, *args)
  getter_name = "get_#{method}"
  return send(getter_name, *args) if respond_to?(getter_name)
  if method.to_s =~ /(.*)=$/
    setter_name = "set_#{Regexp.last_match[1]}"
    return send(setter_name, *args) if respond_to?(setter_name)
  end
  super
end

Class Method Details

.make_finalizer(ptr) ⇒ Object 



81
82
83
84
85
86
87
88
89
90
 
# File 'lib/ffi-gobject/object.rb', line 81

def self.make_finalizer(ptr)
  proc do
    rc = GObject::Object::Struct.new(ptr)[:ref_count]
    if rc.zero?
      warn "not unreffing #{name}:#{ptr} (#{rc})"
    else
      GObject::Lib.g_object_unref ptr
    end
  end
end

.new(*args, &block) ⇒ Object 



15
16
17
18
19
 
# File 'lib/ffi-gobject/object.rb', line 15

def self.new(*args, &block)
  obj = allocate
  obj.__send__ :initialize, *args, &block
  obj
end

Instance Method Details

#get_property_extended(property_name) ⇒ Object 



118
119
120
121
122
 
# File 'lib/ffi-gobject/object.rb', line 118

def get_property_extended(property_name)
  value = get_property(property_name)
  type_info = get_property_type property_name
  property_value_post_conversion value, type_info
end

#get_property_with_override(property_name) ⇒ Object Also known as: get_property 



124
125
126
127
128
 
# File 'lib/ffi-gobject/object.rb', line 124

def get_property_with_override(property_name)
  gvalue = gvalue_for_property property_name
  get_property_without_override property_name, gvalue
  gvalue.get_value
end

#initialize_with_automatic_gtype(properties = {}) ⇒ Object Also known as: initialize

Before GLib 2.54.0, use g_object_newv, which takes an array of GParameter.



49
50
51
52
53
54
55
56
57
58
59
 
# File 'lib/ffi-gobject/object.rb', line 49

def initialize_with_automatic_gtype(properties = {})
  gparameters = properties.map do |name, value|
    name = name.to_s
    property_param_spec(name)
    GObject::Parameter.new.tap do |gparam|
      gparam.name = name
      gparam.value = value
    end
  end
  initialize_without_automatic_gtype(self.class.gtype, gparameters)
end

#ref ⇒ Object 



71
72
73
74
 
# File 'lib/ffi-gobject/object.rb', line 71

def ref
  Lib.g_object_ref self
  self
end

#respond_to_missing? ⇒ Boolean

Returns:

  • (Boolean) 


103
104
105
 
# File 'lib/ffi-gobject/object.rb', line 103

def respond_to_missing?(*)
  false
end

#set_property_extended(property_name, value) ⇒ Object 



130
131
132
133
134
 
# File 'lib/ffi-gobject/object.rb', line 130

def set_property_extended(property_name, value)
  type_info = get_property_type property_name
  adjusted_value = property_value_pre_conversion(value, type_info)
  set_property property_name, adjusted_value
end

#set_property_with_override(property_name, value) ⇒ Object Also known as: set_property 



136
137
138
139
140
 
# File 'lib/ffi-gobject/object.rb', line 136

def set_property_with_override(property_name, value)
  gvalue = gvalue_for_property(property_name)
  gvalue.set_value value
  set_property_without_override property_name, gvalue
end

#signal_connect(event, data = nil, &block) ⇒ Object 



107
108
109
 
# File 'lib/ffi-gobject/object.rb', line 107

def signal_connect(event, data = nil, &block)
  GObject.signal_connect(self, event, data, &block)
end

#signal_connect_after(event, data = nil, &block) ⇒ Object 



111
112
113
 
# File 'lib/ffi-gobject/object.rb', line 111

def signal_connect_after(event, data = nil, &block)
  GObject.signal_connect_after(self, event, data, &block)
end

#store_pointer(ptr) ⇒ Object 



76
77
78
79
 
# File 'lib/ffi-gobject/object.rb', line 76

def store_pointer(ptr)
  super
  ObjectSpace.define_finalizer self, self.class.make_finalizer(ptr)
end