Module: MIDICommunications::Device::InstanceMethods

Included in:
Input, Output
Defined in:
lib/midi-communications/device.rb

Overview

Instance methods shared by both Input and Output instances.

Provides device lifecycle management (open, close) and access to device attributes (name, id, manufacturer, etc.).

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#direction ⇒ Symbol (readonly)

Returns the device direction (:input or :output).

Returns:

  • (Symbol) —

    the device direction (:input or :output)




# File 'lib/midi-communications/device.rb', line 249

#display_name ⇒ String (readonly)

Returns the device display name.

Returns:

  • (String) —

    the device display name




# File 'lib/midi-communications/device.rb', line 267

#enabled ⇒ Boolean (readonly)

Returns whether the device is currently open.

Returns:

  • (Boolean) —

    whether the device is currently open




# File 'lib/midi-communications/device.rb', line 252

#id ⇒ Integer (readonly)

Returns the device ID.

Returns:

  • (Integer) —

    the device ID




# File 'lib/midi-communications/device.rb', line 255

#manufacturer ⇒ String (readonly)

Returns the device manufacturer name.

Returns:

  • (String) —

    the device manufacturer name




# File 'lib/midi-communications/device.rb', line 258

#model ⇒ String (readonly)

Returns the device model name.

Returns:

  • (String) —

    the device model name




# File 'lib/midi-communications/device.rb', line 261

#name ⇒ String (readonly)

Returns the device name.

Returns:

  • (String) —

    the device name




# File 'lib/midi-communications/device.rb', line 264

Instance Method Details

#close(*args) ⇒ Boolean

Closes the device.

Examples:

output.close

Parameters:

  • args (Object) —

    arguments passed to the underlying device

Returns:

  • (Boolean) —

    true if the device was closed, false if already closed



232
233
234
235
236
237
238
239
240
 
# File 'lib/midi-communications/device.rb', line 232

def close(*args)
  if @enabled
    @device.close(*args)
    @enabled = false
    true
  else
    false
  end
end

#closed? ⇒ Boolean

Returns true if the device is closed (not enabled).

Returns:

  • (Boolean) —

    true if device is closed



245
246
247
 
# File 'lib/midi-communications/device.rb', line 245

def closed?
  !@enabled
end

#enabled? ⇒ Boolean

Returns alias for #enabled.

Returns:




# File 'lib/midi-communications/device.rb', line 270

#initialize(device) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Creates a new device wrapper.

Parameters:

  • device (Object) —

    platform-specific device object



181
182
183
184
185
186
 
# File 'lib/midi-communications/device.rb', line 181

def initialize(device)
  @device = device
  @enabled = false

  populate_from_device
end

#open(*args) {|device| ... } ⇒ Input, Output

Opens the device for use.

When a block is given, the device is automatically closed when the block exits. Otherwise, the device is closed at program exit.

Examples:

Open and close automatically with block

output.open do |o|
  o.puts(0x90, 60, 100)
end  # device closed here

Open manually (closed at program exit)

output.open
output.puts(0x90, 60, 100)

Parameters:

  • args (Object) —

    arguments passed to the underlying device

Yields:

  • (device) —

    optional block to execute with the open device

Yield Parameters:

Returns:



206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
 
# File 'lib/midi-communications/device.rb', line 206

def open(*args)
  unless @enabled
    @device.open(*args)
    @enabled = true
  end
  if block_given?
    begin
      yield(self)
    ensure
      close
    end
  else
    at_exit do
      close
    end
  end
  self
end

#type ⇒ Symbol

Returns alias for #direction.

Returns:




# File 'lib/midi-communications/device.rb', line 273