ComputerInput.kif

;; Access to and use of these products is governed by the GNU General Public 
;; License <http://www.gnu.org/copyleft/gpl.html>. 
;; By using these products, you agree to be bound by the terms 
;; of the GPL.

;; We ask that people using or referencing this work cite our primary paper and book:

;; Niles, I., and Pease, A.  2001.  Towards a Standard Upper Ontology.  In 
;; Proceedings of the 2nd International Conference on Formal Ontology in 
;; Information Systems (FOIS-2001), Chris Welty and Barry Smith, eds, 
;; Ogunquit, Maine, October 17-19, 2001.  See also http://www.ontologyportal.org

;; Pease, A., (2011). Ontology: A Practical Guide. Articulate Software Press, 
;; Angwin, CA. ISBN 978-1-889455-10-5.

(instance contraryAttributeWRT TernaryPredicate)
(domain contraryAttributeWRT 1 Attribute)
(domain contraryAttributeWRT 2 Attribute)
(domain contraryAttributeWRT 3 BinaryPredicate)
(documentation contraryAttributeWRT EnglishLanguage "(contraryAttributeWRT ?ATT1 ?ATT2 ?ATTPRED) means that nothing can 
have both attributes at the same time using the attribute predicate ?ATTPRED.")

; can we express this?:
; only subrelations of &%attribute may be the third argument to &%contraryAttributeWRT:
; (condition
;   (contraryAttributeWRT ?ATT1 ?ATT2 ?PRED)
;   (subrelation ?PRED attribute))

; can we express this?:
; only instances of the domain of the third argument to &%contraryAttributeWRT
; are allowed as the first and second argument:
; (condition
;   (and
;     (contraryAttributeWRT ?ATT1 ?ATT2 ?PRED)
;     (domain ?PRED 2 ?ATT_TYPE))
;   (and
;     (instance ?ATT1 ?ATT_TYPE)
;     (instance ?ATT2 ?ATT_TYPE)))

; nothing can have two attributes using the same predicate simultaneously 
; if they are disjoint with respect to that predicate

(=>
  (and
    (instance ?ATT1 Attribute)
    (instance ?ATT2 Attribute)
    (subrelation ?PRED attribute))
  (not
    (and
      (contraryAttributeWRT ?ATT1 ?ATT2 ?PRED)
      (?PRED ?ENTITY ?ATT1)
      (?PRED ?ENTITY ?ATT2))))

; would it be more efficient to further restrict the attributes?:
; (=>
;   (and
;     (subrelation ?PRED attribute)
;     (domain ?PRED 2 ?ATT_TYPE)
;     (instance ?ATT1 ?ATT_TYPE)
;     (instance ?ATT2 ?ATT_TYPE))
;   (not
;     (and
;       (contraryAttributeWRT ?ATT1 ?ATT2 ?PRED)
;       (?PRED ?ENTITY ?ATT1)
;       (?PRED ?ENTITY ?ATT2))))

; ===============

(subclass GuidingMotion Guiding)
(documentation GuidingMotion EnglishLanguage "Controlling the motion (direction, trajectory, and/or speed) of an &%Object.")
(=> 
  (instance ?GUIDE GuidingMotion)
  (exists (?MOTION)
    (and
      (subProcess ?MOTION ?GUIDE)
      (instance ?MOTION Motion))))

(=> 
  (instance ?GUIDE GuidingMotion)
  (exists (?MOVED)
    (and
      (patient ?GUIDE ?MOVED)
      (instance ?MOVED Object))))

(=> 
  (and
    (instance ?GUIDE GuidingMotion)
    (patient ?GUIDE ?MOVED)
    (subProcess ?MOTION ?GUIDE)
    (instance ?MOTION Motion))
  (patient ?MOTION ?MOVED))

(=> 
  (and
    (instance ?GUIDE GuidingMotion)
    (subProcess ?MOTION ?GUIDE)
    (instance ?MOTION Motion)
    (patient ?MOTION ?MOVED))
  (patient ?GUIDE ?MOVED))

(subclass PhysicalGuiding Guiding)
(documentation PhysicalGuiding EnglishLanguage "Controlling the motion (direction,
trajectory, and/or speed) of a &%CorpuscularObject.")

(=> 
  (instance ?PGUIDE PhysicalGuiding)
  (exists (?MOVED)
    (and
      (patient ?PGUIDE ?MOVED)
      (instance ?MOVED CorpuscularObject))))

(subclass Keyboard Device)
(documentation Keyboard EnglishLanguage "A &%Keyboard has a set of keys for typing on to
transmit data corresponding to those keys or to cause physical action such as striking or
plucking a string, opening a valve, or marking of the selected keys on paper or some other
surface.")

(subclass ComputerIODevice ComputerOutputDevice)
(subclass ComputerIODevice ComputerInputDevice)
(documentation ComputerIODevice EnglishLanguage "A &%ComputerIODevice is both a
&%ComputerInputDevice and a &%ComputerOutputDevice.")

(subclass ComputerTerminal ComputerIODevice)
;; It is already defined as a ComputerOutputDevice.
(documentation ComputerTerminal EnglishLanguage "An interactive combination &%ComputerInputDevice
and &%ComputerOutputDevice that does not have an internal computer.  The input device sends
(normally) characters input by the user and the output device relays output to the user.  Early
computer terminals output text to paper; terminals for sight disadvantaged people may provide
audio or tactile output to the user, but most terminals around the turn of the 21st Century
display text and/or images on a display device.  Traditional computer terminals have given way
to personal computers with separate keyboards and screens or to laptop and tablet computers
which operate with an internal computer.

A &%ComputerTerminal is contrasted with a &%Printer, which is an output only device which does
not output directly in view of the user and which only makes hardcopies of computer output by
altering the surface of the hard copy in a way that is for practical purposes, permanent.")

(subclass ComputerDisplay ComputerOutputDevice)
(subclass ComputerDisplay DataDisplayDevice)
(documentation ComputerDisplay EnglishLanguage "A &%ComputerOutputDevice for displaying
information on some sort of screen or other reusable visible output surface.  This is contrasted
with a &%Printer, which places a substance on a surface that is for practical purposes,
permanent.  A display may be part of a computer, a computer terminal, or a separate device.
A single computer may be connected to multiple displays, either all remote, or one physically
part of the computer and the other(s) remote.")
(disjoint ComputerDisplay Printer)

(instance displayedUpon BinaryPredicate)
(domain displayedUpon 1 Image)
(domain displayedUpon 2 ComputerDisplay)
(documentation displayedUpon EnglishLanguage "(displayedUpon ?IMAGE ?DISPLAY) means that the
image, ?IMAGE is displayed upon the &%ComputerDisplay, ?DISPLAY.  A computer connected to
multiple &%ComputerDisplays can have the same images displayed upon more than one display, or
have them restricted to a single display.")

(subclass ComputerScreen ComputerDisplay)
(documentation ComputerScreen EnglishLanguage "A &%ComputerDisplay for displaying information
on some sort of screen.")

(=>
  (instance ?SCREEN ComputerScreen)
  (shape ?SCREEN Rectangle))

(subclass ComputerKeyboard_Generic ComputerInputDevice)
(documentation ComputerKeyboard_Generic EnglishLanguage "A &%ComputerInputDevice for accepting typed
input.  This could be a keyboard with a typewriter layout, a cell phone keypad or any other
similar device.  It could be a keyboard displayed upon a &%ComputerScreen or be a physical
&%Keyboard.")

(subclass ComputerInputButton ComputerInputDevice)
(documentation ComputerInputButton EnglishLanguage "A physical &%ComputerInputDevice such
that pushing the button down, pushing it down twice quickly, and/or holding it down causes
a signal to be sent to a computer (if everything necessary is turned on and connected).  This
could be a key on a keyboard, mouse, telephone, ATM, or other piece of equipment.")

(subclass MouseButton ComputerInputButton)
(documentation MouseButton EnglishLanguage "A &%ComputerInputButton on a &%ComputerMouse.")

(subclass PhysicalRightCIButton ComputerInputButton)
(documentation PhysicalRightCIButton EnglishLanguage "A &%ComputerInputButton physically on
the right side of a set of &%ComputerInputButtons.  A computer system may be told to logically
switch the right and left buttons (e.g., for a person who uses a mouse in the left hand -- in
such a case, the &%LeftCIButton is the &%PhysicalRightCIButton).")

(subclass PhysicalLeftCIButton ComputerInputButton)
(documentation PhysicalLeftCIButton EnglishLanguage "A &%ComputerInputButton physically on the
left side of a set of &%ComputerInputButtons.  A computer system may be told to logically switch
the right and left buttons (e.g., for a person who uses a mouse in the left hand -- in such a
case, the &%RightCIButton is the &%PhysicalLeftCIButton).")

(subclass RightCIButton ComputerInputButton)
(documentation RightCIButton EnglishLanguage "A &%ComputerInputButton logically on the right
side of a set of &%ComputerInputButtons.  Normally, the &%PhysicalRightCIButton.  A computer
system may be told to logically switch the right and left buttons (e.g., for a person who uses
a mouse in the left hand -- in such a case, the &%RightCIButton is the leftmost physical button.")

(subclass LeftCIButton ComputerInputButton)
(documentation LeftCIButton EnglishLanguage "A &%ComputerInputButton logically on the left side
of a set of &%ComputerInputButtons.  Normally, the &%PhysicalLeftCIButton.  A computer system may
be told to logically switch the right and left buttons (e.g., for a person who uses a mouse in the
left hand -- in such a case, the &%LeftCIButton is the rightmost physical button.")
(disjoint RightCIButton LeftCIButton)

(=>
  (and
    (instance ?RIGHT PhysicalRightCIButton)
    (component ?RIGHT ?DEV)
    (instance ?DEV ComputerInputDevice))
  (exists (?LEFT)
    (and
      (instance ?LEFT PhysicalLeftCIButton)
      (component ?LEFT ?DEV)
      (orientation ?RIGHT ?LEFT Left))))

(subclass MiddleCIButton ComputerInputButton)
(documentation RightCIButton EnglishLanguage "A &%ComputerInputButton in the middle of a row
of three &%ComputerInputButtons.")
(disjoint RightCIButton MiddleCIButton)
(disjoint MiddleCIButton LeftCIButton)

; If a device has a &%MiddleCIButton, then it has a &%RightCIButton oriented to its 
; right and a &%LeftCIButton oriented to its left:

(=>
  (and
    (instance ?MID MiddleCIButton)
    (component ?MID ?DEV)
    (instance ?DEV ComputerInputDevice))
  (exists (?LEFT ?RIGHT)
    (and
      (instance ?RIGHT RightCIButton)
      (instance ?LEFT LeftCIButton)
      (component ?RIGHT ?DEV)
      (component ?LEFT ?DEV)
      (between ?LEFT ?MID ?RIGHT)
      (orientation ?MID ?LEFT Left)
      (orientation ?MID ?RIGHT Right))))

(subclass ComputerKeyboardKey ComputerInputButton)
(documentation ComputerKeyboardKey EnglishLanguage "A &%ComputerInputButton on a &%ComputerKeyboard.")
(disjoint ComputerKeyboardKey RightCIButton)
(disjoint ComputerKeyboardKey MiddleCIButton)
(disjoint ComputerKeyboardKey LeftCIButton)
(disjoint ComputerKeyboardKey MouseButton)

; every Computer Keyboard Key is typically part of a Computer Keyboard
(typicalPart ComputerKeyboardKey ComputerKeyboard_Generic)

; every Computer Keyboard Key is part of no more than one Computer Keyboard

(=>
  (and
    (instance ?KEY ComputerKeyboardKey)
    (instance ?KEYBOARD1 ComputerKeyboard_Generic)
    (component ?KEY ?KEYBOARD1) 
    (instance ?KEYBOARD2 ComputerKeyboard_Generic)
    (component ?KEY ?KEYBOARD2)) 
  (equal ?KEYBOARD1 ?KEYBOARD2))

; every Computer Keyboard has a Computer Keyboard Key as a component

(=>
  (instance ?KEYBOARD ComputerKeyboard_Generic)
  (exists (?KEY)
    (and
      (instance ?KEY ComputerKeyboardKey)
      (component ?KEY ?KEYBOARD))))

(subclass CharacterKey ComputerKeyboardKey)
(documentation CharacterKey EnglishLanguage "A &%CharacterKey is a type of &%ComputerKeyboardKey on a
&%ComputerKeyboard that sends a single (printable or whitespace) character to a computer to which it is attached.")

(subclass SpecialComputerKeyboardKey ComputerKeyboardKey)
(documentation SpecialComputerKeyboardKey EnglishLanguage "A &%SpecialComputerKeyboardKey is a type of
&%ComputerKeyboardKey on a &%ComputerKeyboard that does not simply send a single visible character to a computer to which
it is attached.  This includes the Enter/Return key, backspace, delete, function, control, shift, and
other non-character keys.")
(disjoint SpecialComputerKeyboardKey CharacterKey)

(subclass TabKey SpecialComputerKeyboardKey)
(documentation TabKey EnglishLanguage "An &%TabKey is a type of &%ComputerKeyboardKey on a
&%ComputerKeyboard ^T (tab) to a computer to which it is attached.  A tab character instructs
a display algorithm to move to the next tab stop, which is at fixed horizontal points.  Some
text editors, especially programming editors, may insert several space characters, rather
than a tab character, to align the subsequent text at a tab stop." )

(subclass EnterKey SpecialComputerKeyboardKey)
(documentation EnterKey EnglishLanguage "An &%EnterKey is a type of &%ComputerKeyboardKey on a
&%ComputerKeyboard often labeled Enter or Return which sends a ^L (newline) and/or ^M (return) to a
computer to which it is attached." )

(subclass ArrowKey SpecialComputerKeyboardKey)
(documentation ArrowKey EnglishLanguage "An &%ArrowKey is a type of &%ComputerKeyboardKey on a
&%ComputerKeypad with a right, left, up, or down graphic.")
(disjoint ArrowKey EnterKey)

(subclass RightArrowKey ArrowKey)
(documentation RightArrowKey EnglishLanguage "A &%RightArrowKey is a type of &%ArrowKey on a
&%ComputerKeypad with a right pointing graphic.")

(subclass LeftArrowKey ArrowKey)
(documentation LeftArrowKey EnglishLanguage "A &%LeftArrowKey is a type of &%ArrowKey on a
&%ComputerKeypad with a left pointing graphic.")
(disjoint LeftArrowKey RightArrowKey)

(subclass UpArrowKey ArrowKey)
(documentation UpArrowKey EnglishLanguage "A &%UpArrowKey is a type of &%ArrowKey on a
&%ComputerKeypad with a upward pointing graphic." )
(disjoint UpArrowKey LeftArrowKey)
(disjoint UpArrowKey RightArrowKey)

(subclass DownArrowKey ArrowKey)
(documentation DownArrowKey EnglishLanguage "A &%DownArrowKey is a type of &%ArrowKey on a
&%ComputerKeypad with a downward pointing graphic.")
(disjoint DownArrowKey RightArrowKey)
(disjoint DownArrowKey LeftArrowKey)
(disjoint UpArrowKey DownArrowKey)

(subclass NumberedFunctionKey SpecialComputerKeyboardKey)
(documentation NumberedFunctionKey EnglishLanguage "A &%NumberedFunctionKey is a type of
&%ComputerKeyboardKey on a &%ComputerKeyboard that does not send a single character to a
computer to which it is attached.  A &%ComputerKeyboard either has no &%NumberedFunctionKey
or more than one &%NumberedFunctionKey.")
(disjoint NumberedFunctionKey EnterKey)
(disjoint NumberedFunctionKey ArrowKey)

(subclass MultiKeypressKey SpecialComputerKeyboardKey)
(documentation MultiKeypressKey EnglishLanguage "A &%MultiKeypressKey is a type of
&%ComputerKeyboardKey (including &%ShiftKey, &%ControlKey, and &%AltKey) which is not
intended to send a character from the keyboard when it is pressed, but to cause a
different character (or set of characters) to be sent from a keyboard when another
key is pressed while it is being held down.")
(disjoint MultiKeypressKey NumberedFunctionKey)
(disjoint MultiKeypressKey EnterKey)
(disjoint MultiKeypressKey ArrowKey)

(subclass FunctionKey MultiKeypressKey)
(documentation FunctionKey EnglishLanguage "A &%FunctionKey is a type of &%ComputerKeyboardKey
on a &%ComputerKeyboard may be labeled ``Fn''.  It acts similar to a &%ShiftKey, &%ControlKey,
or &%AltKey to cause a different character (or set of characters) to be sent from a keyboard
when another key is pressed.")

(subclass ShiftKey MultiKeypressKey)
(documentation ShiftKey EnglishLanguage "A &%ShiftKey is a type of &%ComputerKeyboardKey on a
&%ComputerKeyboard often labeled ``Shift'' which affects the output of other keys if typed
while it is being held down.")
(disjoint ShiftKey FunctionKey)

(subclass ControlKey MultiKeypressKey)
(documentation ControlKey EnglishLanguage "A &%ControlKey is a type of &%ComputerKeyboardKey on
a &%ComputerKeyboard often labeled ``Ctrl'' which affects the output of other keys if typed
while it is being held down.")
(disjoint ControlKey ShiftKey)
(disjoint ControlKey FunctionKey)

(subclass AltKey MultiKeypressKey)
(documentation AltKey EnglishLanguage "An &%AltKey is a type of &%ComputerKeyboardKey on a
&%ComputerKeyboard often labeled ``Shift'' which affects the output of other keys if typed
while it is being held down.")
(disjoint AltKey ControlKey)
(disjoint AltKey ShiftKey)
(disjoint AltKey FunctionKey)

(subclass TouchpadKey ComputerInputButton)
(documentation TouchpadKey EnglishLanguage "A &%ComputerInputButton on a &%ComputerTouchpad.
A touchpad key may be a &%RightCIButton, &%LeftCIButton, or &%MiddleCIButton.")
(disjoint ComputerKeyboardKey TouchpadKey)

(subclass ComputerKeyboard ComputerKeyboard_Generic)
(subclass ComputerKeyboard Keyboard)
(documentation ComputerKeyboard EnglishLanguage "A physical (as opposed to displayed)
&%ComputerInputDevice for accepting typed input with a typewriter layout.  A
&%ComputerKeyboard may have additional keys and arrays of keys that are not on a
typewriter keyboard.")
(havePartTypes ComputerKeyboard ComputerKeyboardKey)

(subclass ComputerKeypad ComputerKeyboard_Generic)
(documentation ComputerKeypad EnglishLanguage "A &%ComputerKeyboard_Generic that does
not have a typewriter layout.")

; ===========

(subclass ComputerMouse ComputerInputDevice)
(documentation ComputerMouse EnglishLanguage "A &%ComputerInputDevice that fits
in a person's hand for accepting point and click input on a flat 2D surface.  A computer
mouse has one or more buttons and may have a &%ScrollWheel as well.  A mouse may be
connected to a computer by a power and signalling cable or may have a wireless connection.")

(=>
  (instance ?PROCESS
    (OperatingFn ComputerMouse))
  (exists (?SURFACE)
    (and
      (instance ?SURFACE Object)
      (attribute ?SURFACE Flat)
      (eventLocated ?PROCESS ?SURFACE))))

(disjoint ComputerMouse ComputerKeyboard)

(havePartTypes ComputerMouse MouseButton)
(typicalPart MouseButton ComputerMouse)

(subclass ScrollWheel ComputerInputDevice)

(documentation ScrollWheel EnglishLanguage "A &%ComputerInputDevice
that consists of a wheel that projects perpendicularly out of a
surface. A &%ComputerUser may rotate it in either direction with a
finger. &%ScrollWheels are often part of &%ComputerMouses.")

(disjoint ScrollWheel ComputerKeyboard_Generic)
(disjoint ScrollWheel ComputerMouse)

(subclass TouchSensitiveComputerInputDevice ComputerInputDevice)

(documentation TouchSensitiveComputerInputDevice EnglishLanguage "A
touch-sensitive &%ComputerInputDevice for accepting point and click
input on a 2D surface. The device is operated by moving (normally) a
finger across the surface of the device. Clicking may be achieved by
clicking on an adjacent button or by tapping the surface. Two basic
types of &%TouchSensitiveComputerInputDevices are &%ComputerTouchpad
and &%TouchScreen.")

(disjoint TouchSensitiveComputerInputDevice ComputerMouse)
(disjoint TouchSensitiveComputerInputDevice ComputerKeyboard)
(disjoint TouchSensitiveComputerInputDevice ScrollWheel)

(subclass ComputerTouchpad TouchSensitiveComputerInputDevice)

(documentation ComputerTouchpad EnglishLanguage "A touch-sensitive
&%ComputerInputDevice for accepting point and click input on a 2D
surface. The device is operated by moving (normally) a finger across
the surface of the device. Clicking may be achieved by clicking on an
adjacent button or by tapping the surface.")

(disjoint ComputerScreen ComputerTouchpad)

(subclass ComputerTouchscreen TouchSensitiveComputerInputDevice)
(subclass ComputerTouchscreen ComputerScreen)

(documentation ComputerTouchscreen EnglishLanguage "A touch-sensitive
&%ComputerScreen for accepting point and click input on its display
surface. The device is operated by moving (normally) a finger across
the surface of the device. Clicking is achieved by tapping the
surface. Multi-finger gestures may have other effects.")

(subclass ComputerTouchscreenKeyboard ComputerTouchscreen)
(subclass ComputerTouchscreenKeyboard Icon)
(subclass ComputerTouchscreenKeyboard Image)
(subclass ComputerTouchscreenKeyboard ComputerKeyboard_Generic)
(subclass ComputerTouchscreenKeyboard TouchSensitiveComputerInputDevice)

(documentation ComputerTouchscreenKeyboard EnglishLanguage "A portion
of a &%ComputerTouchscreen which displays a keyboard and acts as a
keyboard, accepting taps on the key images as if the keys were
typed.")

(=>
   (instance ?KEYBOARD ComputerTouchscreenKeyboard )
   (exists (?SCREEN)
       (and
         (instance ?SCREEN ComputerTouchscreen )
         (displayedUpon ?KEYBOARD ?SCREEN))))

(subclass ComputerTouchscreenKeypad ComputerTouchscreenKeyboard)
(subclass ComputerTouchscreenKeypad ComputerKeypad)
(subclass ComputerTouchscreenKeypad ComputerTouchscreen)

(documentation ComputerTouchscreenKeypad EnglishLanguage "A portion of
a &%ComputerTouchscreen which displays a keyboard and acts as a
keyboard, accepting taps on the key images as if the keys were
typed.")

; ===

(subclass SpeakerDevice Device)

(documentation SpeakerDevice EnglishLanguage "A &%Device for
projecting sound into a medium.")

(=>
  (instance ?SPEAKER SpeakerDevice)
  (capability RadiatingSound instrument ?SPEAKER))

(subclass ElectricSpeakerDevice SpeakerDevice)
(subclass ElectricSpeakerDevice ElectricDevice)

(documentation ElectricSpeakerDevice EnglishLanguage "A combination
&%SpeakerDevice and &%ElectricDevice.")

(=>
  (and
    (instance ?DEV SpeakerDevice)
    (instance ?DEV ElectricDevice))
  (instance ?DEV ElectricSpeakerDevice))

(subclass Loudspeaker ElectricSpeakerDevice)

(documentation Loudspeaker EnglishLanguage "A &%SpeakerDevice for
projecting sound through the air. A loudspeaker produces louder sound
than earphones or a hearing aid.")

(subclass Earphone ElectricSpeakerDevice)
(subclass Earphone WearableItem)

(documentation Earphone EnglishLanguage "A &%WearableItem worn on the
head with an &%ElectricSpeaker device located near one or both ears.")

(disjoint Earphone Loudspeaker)

(=>
  (and
    (instance ?EARPHONE Earphone)
    (wears ?PERSON ?EARPHONE)
    (instance ?HEAD Head)
    (part ?HEAD ?PERSON))
  (located ?EARPHONE ?HEAD))

(subclass ComputerLoudspeaker ComputerOutputDevice)
(subclass ComputerLoudspeaker Loudspeaker)

(documentation ComputerLoudspeaker EnglishLanguage "A &%Loudspeaker
which is also a &%ComputerOutputDevice, whether or not it is currently
connected to a computer. This includes loudspeakers that are integral
to a computer component as well as ones designed to be plugged into a
standard computer I/O connection.")

(=>
  (and
    (instance ?DEV Loudspeaker)
    (instance ?DEV ComputerOutputDevice))
  (instance ?DEV ComputerLoudspeaker))

(subclass InternalComputerLoudspeaker ComputerLoudspeaker)

(documentation InternalComputerLoudspeaker EnglishLanguage "A
&%ComputerLoudspeaker which is internal to a computer, computer
keyboard, or computer screen.")

(partTypes InternalComputerLoudspeaker ComputerHardware)

(subclass ComputerMicrophone ComputerInputDevice)
(subclass ComputerMicrophone Microphone)

(documentation ComputerLoudspeaker EnglishLanguage "A &%Microphone
which is also a &%ComputerInputDevice, whether or not it is currently
connected to a computer. This includes microphones that are integral
to a computer component as well as ones designed to be plugged into a
standard computer I/O connection.")

(=>
  (and
    (instance ?DEV Microphone)
    (instance ?DEV ComputerOutputDevice))
  (instance ?DEV ComputerMicrophone))

(subclass VideoCamera Camera)
(subclass VideoCamera ElectricDevice)

(documentation VideoCamera EnglishLanguage "A &%Camera for taking
video images.")

(subclass Modem ComputerIODevice)

(documentation Modem EnglishLanguage "A type of ComputerIODevice and
ComputerPeripheralDevice. Each Modem is a device designed to
facilitate communication between computers by modulating analog
signals to encode digital information, and demodulating analog signals
to decode information back into digital format.")

(subclass CableModem Modem)

(documentation CableModem EnglishLanguage "A type of Modem that
provides bi-directional data communication via radio frequency
channels on a fiberoptic cable. Cable modems are primarily used to
deliver broadband Internet access in the form of cable Internet.")

(=>
  (and
    (instance ?MODEM CableModem)
    (instance ?COMM Communication)
    (instrument ?COMM ?MODEM))
  (exists (?CABLE) 
    (and
      (instance ?CABLE Cable)
      (instrument ?COMM ?CABLE)
      (connectedEngineeringComponents ?CABLE ?MODEM))))

(subclass RadioModem Modem)

(documentation RadioModem EnglishLanguage "A type of Modem that
provides bi-directional data communication via radio connection with a
network or computer.")

(disjoint RadioModem CableModem)

(subclass ComputerHardware EngineeringComponent)
;; assertion missing from QoSontology.kif

(subclass Joystick ComputerInputDevice)

(documentation Joystick EnglishLanguage "A type of
&%ComputerInputDevice with a stick that can be activated to control a
cursor in the X and Y directions. A &%Joystick may or may not have an
attached button for clicking.")

(subclass Trackball ComputerInputDevice)

(documentation Trackball EnglishLanguage "A type of
&%ComputerInputDevice with a ball that can be rolled to control a
cursor in the X and Y directions. A &%Trackball may or may not have an
attached button for clicking.")

(disjoint Joystick Trackball)

(subclass GameIODevice ComputerIODevice)

(documentation GameIODevice EnglishLanguage "A type of
&%ComputerIODevice designed for playing video games.")

(subclass GamePad GameIODevice)

(documentation GamePad EnglishLanguage "A type of &%GameIODevice
designed being held in two hands with the fingers, including thumbs
being used to control multiple buttons and possibly other input
devices such as &%Joysticks.")

(subclass Accelerometer Sensor)
(subclass Accelerometer ElectricDevice)

(documentation Accelerometer EnglishLanguage "A type of
&%ElectricDevice used to measure acceleration.")

(subclass GameIODeviceWithAccelerometer GameIODevice)

(documentation GameIODeviceWithAccelerometer EnglishLanguage "A type
of &%GameIODevice designed to be moved in three dimensions to detect
sorts of motion used in sports and other physical activities.")

(havePartTypes GameIODeviceWithAccelerometer Accelerometer)

(=>
  (and
    (instance ?DEVICE GameIODevice)
    (instance ?ACCELEROMETER Accelerometer)
    (component ?ACCELEROMETER ?DEVICE))
  (instance ?DEVICE GameIODeviceWithAccelerometer))

(subclass InternalDigitalDataStorageDevice DigitalDataStorageDevice)
(documentation InternalDigitalDataStorageDevice EnglishLanguage "A type of &%DigitalDataStorageDevice
 that is installed in a &%Computer and not readily removable.")

(subclass RemovableDigitalDataStorageDevice DigitalDataStorageDevice)
(documentation RemovableDigitalDataStorageDevice EnglishLanguage "A type of &%DigitalDataStorageDevice
that can be temporarily installed in a computer and is readily removable.")
(disjoint InternalDigitalDataStorageDevice RemovableDigitalDataStorageDevice)

(subclass ComputerDisk DigitalDataStorageDevice)
(documentation ComputerDisk EnglishLanguage "A type of &%DigitalDataStorageDevice that is disk-shaped
and is read while being spun in a &%DiskDrive.")

(=>
  (instance ?DISK ComputerDisk)
  (shape ?DISK DiskShaped))

(subclass HardDisk ComputerDisk)
(documentation HardDisk EnglishLanguage "A type of &%ComputerDisk that is hard, rather than floppy.
The 3 1/2'' floppy disk is considered a type of &%Floppy disk even though it is hard.  Hard disks can
be internal to the computer, internal to an external drive, or removable.")

(subclass InternalHardDisk HardDisk)
(subclass InternalHardDisk InternalDigitalDataStorageDevice)
(documentation InternalHardDisk EnglishLanguage "A type of &%HardDisk that is installed in a &%Computer
(in its &%HardDiskDrive) and is not readily removable.")

(=>
  (instance ?DISK InternalHardDisk)
  (exists (?DRIVE)
    (and
      (instance ?DRIVE HardDiskDrive)
      (component ?DISK ?DRIVE))))

(subclass RemovableDisk ComputerDisk)
(subclass RemovableDisk RemovableDigitalDataStorageDevice )
(documentation RemovableDisk EnglishLanguage "A type of &%ComputerDisk that can be temporarily installed
in a computer (in a &%DiskDrive) and is readily removable.")
(disjoint RemovableDisk InternalHardDisk)

(subclass CartridgeHardDisk HardDisk)
(subclass CartridgeHardDisk RemovableDisk)
(documentation CartridgeHardDisk EnglishLanguage "A type of &%HardDisk that can be temporarily installed
in a computer (in its &%HardDiskDrive) and is readily removable.")

(subclass FloppyDisk RemovableDisk)
(documentation FloppyDisk EnglishLanguage "A type of &%ComputerDisk that can be temporarily installed in
a &%DiskDrive and is readily removable.")
(disjoint FloppyDisk HardDisk)

(subclass CompactDisc RemovableDigitalDataStorageDevice)

; CompactDisc is defined in Media.kif

;;MSv: Different types of &%OpticalDiscs moved to Media.kif
;;(subclass CD-ROM CompactDisc)
;;(subclass CD-ROM ReadOnlyMemoryDataStorage)
;;(subclass CD-ROM ComputerDisc)
;;(subclass CD-ROM ComputerInputDevice)
;;(documentation CD-ROM EnglishLanguage "A type of &%CompactDisc that can be read but not written on.")
;;(disjoint CD-ROM ComputerOutputDevice)

;;(subclass CD-R CompactDisc)
;;(subclass CD-R WriteOnceDataStorage)
;;(subclass CD-WriteOnce ComputerDisk)
;;(subclass CD-WriteOnce ComputerIODevice)
;;(documentation CD-R EnglishLanguage "A type of &%CompactDisc that can be written on once and read
;;from multiple times.")

;;(subclass CD-RW CompactDisc)
;;(subclass CD-RW RewritableDataStorage)
;;(subclass CD-RW ComputerDisk)
;;(subclass CD-RW ComputerIODevice)
;;(documentation CD-RW EnglishLanguage "A type of &%CompactDisc that can be written on and read from multiple times.")
;;(disjoint CD-R CD-ROM)

;;(subclass BluRayDisc OpticalDisc)
;;(documentation BluRayDisc EnglishLanguage "A type of &%CompactDisc that has significantly more storage
;;than a &%DVD.")
;;(disjoint BluRayDisc CompactDisc)
;;(disjoint BluRayDisc DVD)

(subclass DiskDrive ComputerComponent)
(subclass DiskDrive ComputerIODevice)
;;(subclass DiskDrive DigitalDataStorageDevice )
(documentation DiskDrive EnglishLanguage "A device that can read and (often) write &%ComputerDisks.")

(instance diskTypeForDrive BinaryPredicate)
(domainSubclass diskTypeForDrive 1 ComputerDisk)
(domainSubclass diskTypeForDrive 2 DiskDrive)
(documentation diskTypeForDrive EnglishLanguage "(diskTypeForDrive ?DISK_TYPE ?DRIVE_TYPE) means that
disks of type ?DISK_TYPE are designed to be used by drives of type ?DRIVE_TYPE and such drives are
designed to read (and possibly write) disks of type ?DISK_TYPE.")

(subclass ExternalDiskDrive DiskDrive)
(documentation ExternalDiskDrive EnglishLanguage "A type of &%DiskDrive that can be attached to a
&%Computer by a cable.")
(disjoint ExternalDiskDrive InternalHardDisk)

(subclass ExternalHardDiskDrive HardDiskDrive)
(subclass ExternalHardDiskDrive ExternalDiskDrive)
(documentation ExternalHardDiskDrive EnglishLanguage "A type of &%HardDiskDrive that can be attached
to a &%Computer by a cable.")

(subclass DiskDriveWithRemovableDisks DiskDrive)
(documentation DiskDriveWithRemovableDisks EnglishLanguage "A type of &%DiskDrive that can have different
&%ComputerDisks installed at different times.  Insertion and removal of a disk are simple processes.")

(subclass CartridgeHardDiskDrive HardDiskDrive)
(subclass CartridgeHardDiskDrive DiskDriveWithRemovableDisks)
(documentation CartridgeHardDiskDrive EnglishLanguage "A type of &%HardDiskDrive that can have different
&%CartridgeHardDisks at different times.  Insertion and removal of a disk are simple processes.")
(diskTypeForDrive CartridgeHardDisk CartridgeHardDiskDrive)

(subclass HardDiskDrive DiskDrive)
; defined in QoSontology.kif
; (documentation HardDiskDrive EnglishLanguage "A device that can read and write &%ComputerHardDisks.")

(subclass FloppyDiskDrive DiskDriveWithRemovableDisks)
(documentation FloppyDiskDrive EnglishLanguage "A device that can read and write &%FloppyDisks.")
(diskTypeForDrive FloppyDisk FloppyDiskDrive)

(subclass OpticalDiscDrive DiskDrive)
(documentation OpticalDiscDrive EnglishLanguage "A device that can read and (in some cases) write certain
kinds of &%OpticalDisc.")
(diskTypeForDrive OpticalDisc OpticalDiscDrive)

(subclass CDDrive OpticalDiscDrive)
(documentation CDDrive EnglishLanguage "A device that can read and (in some cases) write &%CompactDiscs.")
(diskTypeForDrive CompactDisc CDDrive)

(subclass DVDDrive OpticalDiscDrive)
(documentation DVDDrive EnglishLanguage "A device that can read and (in some cases) write &%DVDs.")
(diskTypeForDrive DVD DVDDrive)

(subclass BluRayDrive OpticalDiscDrive)
(documentation BluRayDrive EnglishLanguage "A device that can read and (in some cases) write &%BluRayDiscs.")
(diskTypeForDrive BluRayDisc BluRayDrive)

; =============================

(subclass SolidStateDataStorageDevice DigitalDataStorageDevice)
(documentation SolidStateDataStorageDevice EnglishLanguage "A type of &%DigitalDataStorageDevice which
can be read with no moving parts.")

(subclass FlashDrive SolidStateDataStorageDevice)
(subclass FlashDrive ComputerIODevice)
(subclass FlashDrive RemovableDigitalDataStorageDevice)
(documentation SolidStateDataStorageDevice EnglishLanguage "A &%FlashDrive is removable
&%SolidStateDataStorageDevice that connects to a USB port.  A &%FlashDrive is alternatively called
a ``USB drive'', ``USB flash drive'', ``thumb drive'', ``jump drive'', and ``pen drive''.")

(subclass MemoryCard SolidStateDataStorageDevice)
(subclass MemoryCard RemovableDigitalDataStorageDevice)
(subclass MemoryCard ComputerIODevice)
(documentation MemoryCard EnglishLanguage "A type of &%RemovableDigitalDataStorageDevice with no moving
parts, that can be inserted into a camera, cell phone, computer, or similar device; written on that
device; and switched to another device to be read.")
(disjoint FlashDrive MemoryCard)

(subclass Software Procedure)
(documentation Software EnglishLanguage "A set of instructions in a computer programming language that
can be executed by a computer, possibly after compilation into another programming language.  The term
&%Software includes &%ComputerPrograms (free-standing software), object methods, subroutines and
software packages.")
(subclass ComputerProgram Software)

(subclass SoftwarePackage Software)
(documentation SoftwarePackage EnglishLanguage "A &%SoftwarePackage is a set of &%ComputerPrograms and
&%DataFiles that operate together to enable various &%ComputerUser activities.")

(=>
  (instance ?PACK SoftwarePackage)
  (exists (?PROGRAM)
    (and 
      (instance ?PROGRAM ComputerProgram)
      (part ?PROGRAM ?PACK))))

(=>
  (instance ?PACK SoftwarePackage)
  (exists (?FILE)
    (and 
      (instance ?FILE ComputerFile)
      (part ?FILE ?PACK))))

(subclass UserInterface Software)
(documentation UserInterface EnglishLanguage "A &%UserInterface is a piece or collection of &%Software
that allows a user to interact with a computer system or program.")

(subclass GraphicalUserInterface UserInterface)
(documentation GraphicalUserInterface EnglishLanguage "A &%GraphicalUserInterface is a &%UserInterface
that allows users to interact with electronic devices with images rather than text commands.")
(abbreviation "GUI" GraphicalUserInterface)

(subclass UIElement Icon)
(documentation UIElement EnglishLanguage "A &%UIElement is a feature that a user uses to interact with a
&%UserInterface.  The type of interaction depends upon the type of element and type of screen.")

(subclass ComputerMenu UIElement)
(documentation ComputerMenu EnglishLanguage "A &%ComputerMenu is an image generated by a computer program
of a set of choices tha a user has for interacting with that program in conjunction with a method for the
user to input a selection to the program.")

(instance accessibleFromMenu BinaryPredicate)
(domain accessibleFromMenu 1 Entity)   ; !!! Narrow this down
(domain accessibleFromMenu 2 ComputerMenu)
(documentation accessibleFromMenu EnglishLanguage "The property &%accessibleFromMenu relates a file,
computer process, or submenu to a &%ComputerMenu from which the object can be accessed.")

(subclass TextualComputerMenu ComputerMenu)
(documentation TextualComputerMenu EnglishLanguage "A &%TextualComputerMenu is a &%ComputerMenu that
textually describes a user's options and permits the user to select one of the options by typing the
appropriate thing into the computer.")

; =====================================

(subclass GUIElement Image)
(subclass GUIElement UIElement)
(documentation GUIElement EnglishLanguage "A &%GUIElement is an image on a &%ComputerScreen that a user
uses to interact with a &%GraphicalUserInterface.  The type of interaction depends upon the type of
element and type of screen.")
(disjoint TextualComputerMenu GUIElement)

(instance screenOfGUIE BinaryPredicate)
(domain screenOfGUIE 1 GUIElement)
(domain screenOfGUIE 2 ComputerScreen)
(documentation screenOfGUIE EnglishLanguage "(screenOfGUIE ?GUIE ?SCREEN) means that the GUIElement,
?GUIE, is displayed on, or at least logically assigned to be displayed on the &%ComputerScreen, ?SCREEN.")

(subclass GUIActiveArea GUIElement)
(documentation GUIActiveArea EnglishLanguage "A &%GUIActiveArea is a (normally rectangular) &%GUIElement
which a user can make active (change its state to GUI_ActiveState), select, and interact with.")

(subclass ComputerTouchscreenKeypad GUIActiveArea)   ; defined above
(subclass ComputerTouchscreenKeyboard GUIActiveArea) ; defined above

(subclass GraphicalComputerMenu ComputerMenu)
(subclass GraphicalComputerMenu GUIActiveArea)
(subclass GraphicalComputerMenu UIElement)
(documentation GraphicalComputerMenu EnglishLanguage "A &%GraphicalComputerMenu is a &%ComputerMenu
that displays a user's options and permits the user to select one or more of the options in a graphical
manner and usually using a keyboard as well.")
(disjoint GraphicalComputerMenu ComputerTouchscreenKeypad)
(disjoint GraphicalComputerMenu ComputerTouchscreenKeyboard)

; A GraphicalComputerMenu is typically accessed by a mouse icon
; A GraphicalComputerMenu can be accessed by arrow keys.

(subclass ListBox GraphicalComputerMenu)
(documentation ListBox EnglishLanguage "A &%ListBox is a &%GraphicalComputerMenu which appears as a
static list of visible values whether active or not.  The whole list may or may not be visible at one time.")

(subclass DropDownList GraphicalComputerMenu)
(documentation DropDownList EnglishLanguage "A &%DropDownList is a &%GraphicalComputerMenu which appears
as a single choice when inactive, but expands to a list of visible values (see &%ListBox) when made
active.  The whole list may or may not be visible at one time.")
(disjoint ListBox DropDownList)

(subclass ComboListTextBox GraphicalComputerMenu)
(documentation ComboListTextBox EnglishLanguage "A &%ComboListTextBox is a &%GraphicalComputerMenu
which appears as a &%ListBox or a &%DropDownList, but also has a single line &%TextInputBox into
which a user can type a text value not in the menu.")
; (havePartTypes ComboList TextInputBox) 

(subclass GraphicalSubMenu GraphicalComputerMenu)
(documentation GraphicalSubMenu EnglishLanguage "A &%GraphicalSubMenu is a &%GraphicalComputerMenu
that appears when a user either makes a &%GraphicalMenuItem the active area or selects an appropriate
menu item.")

(=> 
  (instance ?SUB GraphicalSubMenu)
  (exists (?MENU)
    (and
      (instance ?MENU GraphicalComputerMenu)
      (accessibleFromMenu ?SUB ?MENU))))

; Note that this is not unique, since the same submenu conceptually be accessed 
; from multiple menus.

(subclass GUIButton GUIActiveArea)
(subclass GUIButton ComputerInputButton)
(documentation GUIButton EnglishLanguage "A &%GUIButton is an image of a button on a &%GUIElement that
a user may click on or ''hold down'' to indicate a &%UserSignifiedAction.  The button's graphical
appearance changes once it is selected.  An icon of a &%ComputerKeyboardKey is not considered to be a
&%GUIButton.  A &%GUIButton may have labeling text or symbol displayed on or adjacent it.  The active
area for selecting a GUI button may be the area of the button itself or may include the area of text
labeling the box.")
(disjoint GUIButton ComputerKeyboardKey)
(disjoint GUIButton ComputerTouchscreenKeypad)
(disjoint GUIButton ComputerTouchscreenKeyboard)

(subclass GUIRadioButton GUIButton)
(documentation GUIRadioButton EnglishLanguage "A &%GUIRadioButton is a &%GUIButton in a set of buttons
that stays selected when a user clicks on it.  Any other button that was depressed is released when the
GUI radio button is pushed.")


(subclass ScrollBar GUIActiveArea)
(documentation ScrollBar EnglishLanguage "A &%ScrollBar is an image of a slider on an &%InterfaceWindow
with an indicator (&%ScrollBarBar) that a user may move to shift the image in the window up and down or
right and left in cases in which the logical image is larger than the portion displayed in the window.
The image may be pure text or may be graphics.")
(disjoint ComputerMenu ScrollBar)
(disjoint ScrollBar GUIButton)
; A ScrollBar can be used to move an image in a window
; A ScrollBar is typically moved by a mouse icon
; A ScrollBar can be moved by a roller
; A ScrollBar can be moved by arrow keys

(subclass HorizontalScrollBar ScrollBar)
(documentation HorizontalScrollBar EnglishLanguage "A &%HorizontalScrollBar is a horizontal image of a
slider on an &%InterfaceWindow with an indicator (&%ScrollBarBar) that a user may move to shift the image
in the window to the right and left in cases in which the logical image is wider than the portion displayed
in the window.  The image may be pure text or may be graphics.")

(subclass VerticalScrollBar ScrollBar)
(documentation VerticalScrollBar EnglishLanguage "A &%VerticalScrollBar is a vertical image of a slider on
an &%InterfaceWindow with an indicator (&%ScrollBarBar) that a user may move to shift the image in the
window up or down in cases in which the logical image is taller than the portion displayed in the window.
The image may be pure text or may be graphics.")
(disjoint VerticalScrollBar HorizontalScrollBar)

(subclass ScrollBarBar GUIActiveArea)
(documentation ScrollBarBar EnglishLanguage "A &%ScrollBarBar is an image of an indicator on an &%ScrollBar
that a user may move to shift the logical image in the window up and down or right and left in cases in which
the logical image is larger than the portion displayed in the window.  The image may be pure text or may be graphics.")
(partTypes ScrollBarBar ScrollBar)
(disjoint ScrollBarBar ScrollBar)
(disjoint ScrollBarBar ComputerMenu)
(disjoint ScrollBarBar ComputerTouchscreenKeypad)
(disjoint ScrollBarBar ComputerTouchscreenKeyboard)

(subclass ScrollBarArrowButton GUIButton)
(documentation ScrollBarArrowButton EnglishLanguage "A &%ScrollBarArrowButton is an image of an arrow on an
&%ScrollBar that a user may click on or hold down to shift the logical image in the window up and down or
right and left in cases in which the logical image is larger than the portion displayed in the window.  The
logical image may be pure text or may be graphics.")
(partTypes ScrollBarArrowButton ScrollBar)
(disjoint ScrollBarArrowButton ScrollBarBar)
(disjoint ScrollBarArrowButton ComputerMenu)

(subclass ScrollBarRightArrowButton ScrollBarArrowButton)
(documentation ScrollBarRightArrowButton EnglishLanguage "A &%ScrollBarRightArrowButton is an image of an
arrow on an &%ScrollBar that a user may click on or hold down to shift the image in the window to the right
in cases in which the logical image is wider than the portion displayed in the window.  The image may be
pure text or may be graphics.")
(partTypes ScrollBarRightArrowButton HorizontalScrollBar)

(subclass ScrollBarLeftArrowButton ScrollBarArrowButton)
(documentation ScrollBarLeftArrowButton EnglishLanguage "A &%ScrollBarLeftArrowButton is an image of an arrow
on an &%ScrollBar that a user may click on or hold down to shift the image in the window to the left in cases
in which the logical image is wider than the portion displayed in the window.  The image may be pure text or
may be graphics.")
(partTypes ScrollBarLeftArrowButton HorizontalScrollBar)
(disjoint ScrollBarLeftArrowButton ScrollBarRightArrowButton)

(subclass ScrollBarUpArrowButton ScrollBarArrowButton)
(documentation ScrollBarUpArrowButton EnglishLanguage "A &%ScrollBarUpArrowButton is an image of an arrow
on an &%ScrollBar that a user may click on or hold down to shift the image in the window upward in cases
in which the logical image is taller than the portion displayed in the window.  The image may be pure text
or may be graphics.")
(partTypes ScrollBarUpArrowButton VerticalScrollBar)
(disjoint ScrollBarUpArrowButton ScrollBarRightArrowButton)
(disjoint ScrollBarUpArrowButton ScrollBarLeftArrowButton)

(subclass ScrollBarDownArrowButton ScrollBarArrowButton)
(documentation ScrollBarDownArrowButton EnglishLanguage "A &%ScrollBarDownArrowButton is an image of an
arrow on an &%ScrollBar that a user may click on or hold down to shift the image in the window downward
in cases in which the logical image is taller than the portion displayed in the window.  The image may
be pure text or may be graphics.")
(partTypes ScrollBarDownArrowButton VerticalScrollBar)
(disjoint ScrollBarDownArrowButton ScrollBarUpArrowButton)
(disjoint ScrollBarDownArrowButton ScrollBarRightArrowButton)
(disjoint ScrollBarDownArrowButton ScrollBarLeftArrowButton)

(subclass GUISlider GUIActiveArea)
(documentation GUISlider EnglishLanguage "A &%GUISlider is an image of a slider on an &%InterfaceWindow
with an indicator (&%GUISliderIndicator) that a user may move to shift a value up and down or within a
list of values.")
(disjoint GUISlider ScrollBar)
(disjoint GUISlider ComputerTouchscreenKeypad)
(disjoint GUISlider ComputerTouchscreenKeyboard)
; A GUISlider can be used to change a data value
; A GUISlider is typically moved by a mouse icon
; A GUISlider can be moved by a roller
; A GUISlider can be moved by arrow keys

(subclass GUISliderIndicator GUIActiveArea)
(documentation GUISliderIndicator EnglishLanguage "A &%GUISliderIndicator is an image of an indicator on
an &%GUISlider that a user may move to shift the image in the window up and down or right and left in
cases in which the logical image is larger than the portion displayed in the window.  The image may be
pure text or may be graphics.")
(partTypes GUISlider GUISliderIndicator)
(disjoint GUISliderIndicator ComputerMenu)
(disjoint GUISliderIndicator ScrollBar)
(disjoint GUISliderIndicator ScrollBarBar)

(subclass Cursor GUIElement)
(documentation Cursor EnglishLanguage "A &%Cursor is a &%GUIElement designed for a user to move around a
computer screen.  A cursor can have different visual forms and may change in appearance depending upon
the current type of graphical interaction.  A &%TextCursor locates an active area for inserting or
deleting text and is more limited in its movement than a &%MouseCursor.  Both a mouse cursor and a text
cursor may be visible at the same time.")
; A cursor may be controlled by a &%ComputerMouse, but may also be controlled by 
; software, a trackball, joystick, or keyboard arrow keys
(subclass TextCursor Cursor)
(documentation TextCursor EnglishLanguage "A &%TextCursor is a &%Cursor that locates an active area for
inserting or deleting text and is more limited in its movement than a &%MouseCursor.  Both a mouse cursor
and a text cursor may be visible at the same time.")

(subclass MouseCursor Cursor)
(documentation MouseCursor EnglishLanguage "A &%MouseCursor is a &%Cursor that locates a location on a
computer screen ``pointed to'' by a computer mouse, trackball, joystick, or other device.  Both a mouse
cursor and a text cursor may be visible at the same time.")
(disjoint MouseCursor TextCursor)
(disjoint MouseCursor GUIActiveArea)
; Only one &%MouseCursor may be on a screen at a time

(=> 
  (and
    (instance ?CURSOR1 MouseCursor)
    (instance ?CURSOR2 MouseCursor)
    (screenOfGUIE ?CURSOR1 ?SCREEN)
    (screenOfGUIE ?CURSOR2 ?SCREEN))
  (equal ?CURSOR1 ?CURSOR2))

(subclass InterfaceWindow GUIElement)
(documentation InterfaceWindow EnglishLanguage "An &%InterfaceWindow is a &%GUIElement that covers a
(normally rectangular region of a computer screen.  Each window has an image which covers its whole area
and a level of transparency.  A region of the screen may be covered by one or more &%InterfaceWindows in
a specified order with the ``top'' window visible, and those sequentially underneigth visible only to the
extent that the window(s) above them are partially or wholely transparent.  An interface window is ``active''
if the state of the GUI is such that user input is automatically set to it.")
(disjoint Cursor InterfaceWindow)

(subclass PopupWindow InterfaceWindow)
(documentation PopupWindow EnglishLanguage "A &%PopupWindow is a &%InterfaceWindow that appears in addition
to the window with which a user is interacting.  A popup window traditionally appears partially covering
the previously active window, although some are place below the active window and are not visible until
the active window no longer covers that area.  A popup window may be used to provide information (including
advertising) to the user or may be an interaction window.")

(subclass HoverBox PopupWindow)
(documentation HoverBox EnglishLanguage "A &%HoverBox is a &%PopupWindow that temporarily appears when the
cursor is within a &%HoverBoxActiveArea.")
; A &%HoverBox appears when 

(subclass HoverBoxActiveArea GUIActiveArea)
(documentation HoverBoxActiveArea EnglishLanguage "A &%HoverBoxActiveArea is a &%GUIActiveArea which, when
it becomes active, causes a &%HoverBox to appear on the active display.")
; RULE NEEDED

(subclass TextBox GUIElement)
(documentation TextBox EnglishLanguage "A &%TextBox is a (normally rectangular) &%GUIElement which displays
and/or accepts input of text.")
(disjoint TextBox ComputerMenu)
(disjoint TextBox GUIButton)

(subclass TextInputBox GUIActiveArea)
(subclass TextInputBox TextBox)
(documentation TextInputBox EnglishLanguage "A &%TextInputBox is a &%TextBox that accepts input of text.")
;(havePartTypes ComboList TextInputBox)
; Rule needed.  Note Paste (^V and via Right Click menu)

(subclass TextOutputBox TextBox)
(documentation TextOutputBox EnglishLanguage "A &%TextOutputBox is a &%TextBox that which displays text.")

(subclass GUICheckBox GUIActiveArea)
(documentation TextInputBox EnglishLanguage "A &%GUICheckBox is a &%GUIActiveArea with associated text or
icon that may have its state changed between selected and not selected by clicking or typing a keyboard key.
Some applications use checkboxes that allow an indeterminate state in addition to the two provided by a
normal checkbox. This third state is depicted differently than the selected and unselected states, and
indicates that its state is neither checked nor unchecked. This is most often used when the checkbox is
tied to a collection of items in mixed states. The indeterminate state cannot usually be selected by the
user, and switches to a checked (or in some applications unchecked) state when activated.  Like a
&%GUIRadioButton a &%GUICheckBox stays selected after being clicked on and released, but unlike a radio
button, multiple check boxes in a set may be the selected state at the same time.")
(disjoint GUICheckBox GUIRadioButton)

(subclass ComputerMenuItem GUIActiveArea)
(documentation ComputerMenuItem EnglishLanguage "A &%ComputerMenuItem is a &%UIElement that presents one of
the user's options and informs the running program if the user selects that option.  A &%ComputerMenuItem
may act as either a &%GUIRadioButton or a &%GUICheckBox.  In many instances a menu item acts as a radio
button on a normal click and as a check box on a shift-click.")
(partTypes ComputerMenuItem ComputerMenu)
(havePartTypes ComputerMenu ComputerMenuItem)

(instance accessibleFromMenuItem BinaryPredicate)
(domain accessibleFromMenuItem 1 Entity)   ; !!! Narrow this down
(domain accessibleFromMenuItem 2 ComputerMenuItem )
(documentation accessibleFromMenu EnglishLanguage "The property &%ComputerMenuItem relates a file, computer
process, or submenu to a &%ComputerMenuItem from which the object can be accessed.")

(subclass GraphicalMenuItem ComputerMenuItem)
(subclass GraphicalMenuItem GUIActiveArea)
(documentation GraphicalMenuItem EnglishLanguage "A &%GraphicalMenuItem is a &%GUIActiveArea that is also a
&%ComputerMenuItem. It presents one of the user's options and informs the running program if the user
selects that option.")

(partTypes GraphicalMenuItem GraphicalComputerMenu)
(havePartTypes GraphicalComputerMenu GraphicalMenuItem)
; every &%GraphicalSubMenu must be accessible from some &%GraphicalMenuItem

(=> 
  (instance ?SUB GraphicalSubMenu)
  (exists (?MENUITEM)
    (and
      (instance ?MENU GraphicalMenuItem)
      (accessibleFromMenuItem ?SUB ?MENUITEM))))

(subclass GUI_Link HypertextLink)
(subclass GUI_Link GUIActiveArea)

(documentation GUI_Link EnglishLanguage "A &%GUI_Link is a
&%GUIActiveArea that, if selected, sends a &%WebBrowser to a URL
specified in the link.")

(subclass UserAction IntentionalProcess)

(documentation UserAction EnglishLanguage "A &%UserAction is an action
taken by a &%ComputerUser in interacting with a &%ComputerProcess.")

(=>
   (instance ?ACTION UserAction)
   (exists (?COMP_USER)
       (and
         (attribute ?COMP_USER ComputerUser)
         (agent ?ACTION ?COMP_USER))))

(subclass UserDirectAction UserAction)
(subclass UserDirectAction Icon)

(documentation UserDirectAction EnglishLanguage "A &%UserDirectAction
is a physical action taken by a &%ComputerUser in interacting with a
&%ComputerProcess -- clicking a button, moving a mouse, touching a
screen -- not the action signified by the physical action (scrolling,
selecting a link, moving a cursor, ...). The action signifies an
instruction to the computer. See &%UserSignifiedAction.")

; A &%UserDirectAction acts on some ComputerInputDevice:
(=>
   (instance ?ACTION UserDirectAction)
   (exists (?DEVICE)
       (and
         (patient ?ACTION ?DEVICE)
         (instance ?DEVICE ComputerInputDevice))))

(subclass UserSignifiedAction UserAction)
(subclass UserSignifiedAction ComputerProcess)

(documentation UserSignifiedAction EnglishLanguage "A
&%UserSignifiedAction is an action signified by physical action taken
by a &%ComputerUser in interacting with a &%ComputerProcess --
scrolling, selecting a link, moving a cursor, ... -- not physical
action itself (clicking a button, moving a mouse, touching a screen,
...). Often several different types &%UserDirectAction (q.v.) could
signify the same &%UserSignifiedAction.")

(disjoint UserDirectAction UserSignifiedAction)

(=>
   (instance ?ACTION UserDirectAction)
   (exists (?SIG_ACTION)
       (and
         (represents ?ACTION ?SIG_ACTION)
         (instance ?SIG_ACTION UserSignifiedAction))))
(=>
   (instance ?SIG_ACTION UserSignifiedAction)
   (exists (?DIR_ACTION)
       (and
         (represents ?DIR_ACTION ?SIG_ACTION)
         (instance ?DIR_ACTION UserDirectAction))))

(subclass KeyboardAction UserDirectAction)

(documentation KeyboardAction EnglishLanguage "A &%KeyboardAction is a
&%UserDirectAction of hitting or holding down one or more keyboard
keys.")

(=>
   (instance ?ACT KeyboardAction)
   (exists (?KEY)
       (and
         (instance ?KEY ComputerKeyboardKey)
         (patient ?ACT ?KEY))))

(subclass MultikeyAction KeyboardAction)

(documentation MultikeyAction EnglishLanguage "A &%MultikeyAction is a
&%UserDirectAction of hitting or holding down more than one keyboard
key at the same time. All but one of the multiple keys are normally
the shift, control, alt, function, or similar keys.")

(=>
   (instance ?ACT MultikeyAction)
   (exists (?KEY1 ?KEY2)
       (and
         (patient ?ACT ?KEY1)
         (patient ?ACT ?KEY2)
         (not (equal ?KEY1 ?KEY2))
         (instance ?KEY1 ComputerKeyboardKey)
         (instance ?KEY2 ComputerKeyboardKey))))

(subclass KeyHoldDown KeyboardAction)

(documentation KeyHoldDown EnglishLanguage "A &%KeyHoldDown is a
&%UserDirectAction of holding down a keyboard key for a while. Holding
down a &%CharacterKey causes the input of a string of such characters.
Holding down an &%ArrowKey can cause a graphic to continusously move.
Holding down a &%MultiKeypressKey is useful for modifying the normal
result of taking some other action that is taken while the key is held
down. This action may be the typing of some other key or a &%Clicking
action.")

(subclass ShiftKeyHoldDown KeyHoldDown)

(documentation ShiftKeyHoldDown EnglishLanguage "A &%ShiftKeyHoldDown
is a &%UserDirectAction of pressing and holding down the Shift key on
a keyboard.")

(=>
   (instance ?ACT ShiftKeyHoldDown)
   (exists (?KEY)
       (and
         (instance ?KEY ShiftKey)
         (patient ?ACT ?KEY))))

(=>
   (and
      (instance ?ACT ShiftKeyHoldDown)
      (patient ?ACT ?KEY)
      (instance ?KEY ComputerKeyboardKey))
   (instance ?KEY ShiftKey))

(subclass ControlKeyHoldDown KeyHoldDown)

(documentation ControlKeyHoldDown EnglishLanguage "A
&%ControlKeyHoldDown is a &%UserDirectAction of pressing and holding
down the Control key on a keyboard.")

(disjoint ShiftKeyHoldDown ControlKeyHoldDown)
(=>
   (instance ?ACT ControlKeyHoldDown)
   (exists (?KEY)
       (and
         (instance ?KEY ControlKey)
         (patient ?ACT ?KEY))))

(=>
   (and
      (instance ?ACT ControlKeyHoldDown)
      (patient ?ACT ?KEY)
      (instance ?KEY ComputerKeyboardKey))
   (instance ?KEY ControlKey))

(subclass AltKeyHoldDown KeyHoldDown)

(documentation AltKeyHoldDown EnglishLanguage "A &%AltKeyHoldDown is a
&%UserDirectAction of pressing and holding down the Alt key on a
keyboard.")

(disjoint AltKeyHoldDown ShiftKeyHoldDown)
(disjoint AltKeyHoldDown ControlKeyHoldDown)

(=>
   (instance ?ACT AltKeyHoldDown)
   (exists (?KEY)
       (and
         (instance ?KEY AltKey)
         (patient ?ACT ?KEY))))

(=>
   (and
      (instance ?ACT AltKeyHoldDown)
      (patient ?ACT ?KEY)
      (instance ?KEY ComputerKeyboardKey))
   (instance ?KEY AltKey))

(subclass FunctionKeyHoldDown KeyHoldDown)

(documentation FunctionKeyHoldDown EnglishLanguage "A
&%FunctionKeyHoldDown is a &%UserDirectAction of pressing and holding
down the &%FunctionKey on a keyboard.")

(disjoint FunctionKeyHoldDown AltKeyHoldDown)
(disjoint FunctionKeyHoldDown ShiftKeyHoldDown)
(disjoint FunctionKeyHoldDown ControlKeyHoldDown)

(=>
   (instance ?ACT FunctionKeyHoldDown)
   (exists (?KEY)
       (and
         (instance ?KEY FunctionKey)
         (patient ?ACT ?KEY))))

(=>
   (and
      (instance ?ACT FunctionKeyHoldDown)
      (patient ?ACT ?KEY)
      (instance ?KEY ComputerKeyboardKey))
   (instance ?KEY FunctionKey))

(subclass SingleKeyPress KeyboardAction)
(documentation SingleKeyPress EnglishLanguage "A &%SingleKeyPress is a &%UserDirectAction of typing
(breifly pressing down) a keyboard key.")
(disjoint SingleKeyPress KeyHoldDown)

(instance PressingKeyFn UnaryFunction)
(domainSubclass PressingKeyFn 1 ComputerKeyboardKey)
(rangeSubclass PressingKeyFn SingleKeyPress)
(documentation PressingKeyFn EnglishLanguage "(PressingKeyFn ?KEY_TYPE) indicates the type of action of
typing a &%KeyboardKey of the specified type.")

(subclass CharacterKeyPress SingleKeyPress)
(documentation CharacterKeyPress EnglishLanguage "A &%CharacterKeyPress is a &%SingleKeyPress of a keyboard
key that signifies a single character (letters, numbers, punctuation, other symbols, space, and tab).  Use
&%SpecialCharacterPress for enter, backspace, delete, escape, shift, control, function, function keys,
home, page-up, etc. keys.")

(=>
   (instance ?ACT CharacterKeyPress)
   (exists (?KEY)
       (and
         (instance ?KEY CharacterKey)
         (patient ?ACT ?KEY))))

(=>
   (and
      (instance ?ACT CharacterKeyPress)
      (patient ?ACT ?KEY)
      (instance ?KEY ComputerKeyboardKey))
   (instance ?KEY CharacterKey))

(subclass SpecialCharacterPress SingleKeyPress)

(documentation SpecialCharacterPress EnglishLanguage "A
&%CharacterKeyPress is a &%SingleKeyPress of the enter, backspace,
delete, escape, shift, control, function, function keys, home,
page-up, and similar keys. Use &%CharacterKeyPress for white space
keys and a keyboard key that signifies a single character (letters,
numbers, punctuation, other symbols).")

(disjoint CharacterKeyPress SpecialCharacterPress)

(=>
  (instance ?ACT SpecialCharacterPress)
  (exists (?KEY)
    (and
      (instance ?KEY SpecialComputerKeyboardKey)
      (patient ?ACT ?KEY))))

(=>
  (and
    (instance ?ACT SpecialCharacterPress)
    (patient ?ACT ?KEY)
    (instance ?KEY ComputerKeyboardKey))
  (instance ?KEY SpecialComputerKeyboardKey))

(subclass EnterKeyPress SpecialCharacterPress)

(documentation EnterKeyPress EnglishLanguage "A &%EnterKeyPress is a
&%UserDirectAction of hitting the Enter key on a keyboard.")

(=>
  (instance ?ACT EnterKeyPress)
  (exists (?KEY)
    (and
      (instance ?KEY EnterKey)
      (patient ?ACT ?KEY))))

(=>
  (and
    (instance ?ACT EnterKeyPress)
    (patient ?ACT ?KEY)
    (instance ?KEY ComputerKeyboardKey))
  (instance ?KEY EnterKey))

; ===========

(subclass Clicking UserDirectAction)

(documentation Clicking EnglishLanguage "A &%Clicking is a
&%UserDirectAction of clicking on a mouse button or its equivalent on
some other input device.")

(subclass DoubleClicking Clicking)

(documentation DoubleClicking EnglishLanguage "&%DoubleClicking is a
&%UserDirectAction of clicking twice relatively rapidly so as to
signify a ``double click''.")

(=>
  (instance ?ACT DoubleClicking)
  (exists (?CLICK1 ?CLICK2)
    (and
      (subProcess ?ACT ?CLICK1)
      (instance ?CLICK1 Clicking)
      (subProcess ?ACT ?CLICK2)
      (not
        (equal ?CLICK1 ?CLICK2))
      (instance ?CLICK2 Clicking))))

(subclass RightClicking Clicking)

(documentation RightClicking EnglishLanguage "&%RightClicking is a
&%UserDirectAction of clicking with the right button on a two or three
button mouse or similar device. A computer system may be told to
logically switch the right and left buttons (e.g., for a person who
uses a mouse in the left hand -- in such a case, &%RightClicking is
achieved by clicking the leftmost physical button.")

(=>
  (instance ?ACT RightClicking)
  (exists (?R_BUTTON)
    (and
      (patient ?ACT ?R_BUTTON)
      (instance ?R_BUTTON RightCIButton))))

(subclass LeftClicking Clicking)

(documentation LeftClicking EnglishLanguage "&%LeftClicking is a
&%UserDirectAction of clicking with the left button on a two or three
button mouse or similar device.")

(=>
   (instance ?ACT LeftClicking)
   (exists (?L_BUTTON)
       (and
         (patient ?ACT ?L_BUTTON)
         (instance ?L_BUTTON LeftCIButton))))

(subclass MiddleClicking Clicking)
(documentation MiddleClicking EnglishLanguage "&%MiddleClicking is a &%UserDirectAction of clicking with the
middle button on a three button mouse or similar device.")

(=>
   (instance ?ACT MiddleClicking)
   (exists (?M_BUTTON)
       (and
         (patient ?ACT ?M_BUTTON)
         (instance ?M_BUTTON MiddleCIButton))))

(subclass ShiftClicking Clicking)
(documentation ShiftClicking EnglishLanguage "&%ShiftClicking is a &%UserDirectAction of &%Clicking during a
&%ShiftKeyHoldDown.")

(=>
   (instance ?ACT ShiftClicking)
   (exists (?SHIFT)
       (and
         (subProcess ?SHIFT ?ACT)
         (instance ?SHIFT ShiftKeyHoldDown))))

(subclass MouseButtonHoldDown Clicking)
(documentation MouseButtonHoldDown EnglishLanguage "&%MouseButtonHoldDown is a &%UserDirectAction of clicking
a mouse (or similar) button, but holding the button down while taking other action (such as moving the mouse
or reading text that appeared when the button was depressed).")

(=>
   (instance ?ACT MouseButtonHoldDown)
   (exists (?MOUSE)
       (and
         (patient ?ACT ?MOUSE)
         (instance ?MOUSE ComputerMouse))))

(subclass SlidingComputerInputDeviceAction UserDirectAction)
(subclass SlidingComputerInputDeviceAction PhysicalGuiding)
(documentation SlidingComputerInputDeviceAction EnglishLanguage "&%SlidingComputerInputDeviceAction is a
&%UserDirectAction of moving a &%ComputerInputDevice (or an object such as a finger on a &%ComputerInputDevice)
in such a way that the motion can be mapped as moving a point (e.g. a &%MouseCursor) around a &%ComputerScreen.")

(subclass MouseMoving SlidingComputerInputDeviceAction)
(documentation MouseMoving EnglishLanguage "&%MouseMoving is a &%UserDirectAction of moving a &%ComputerMouse
in such a way that the motion is registered by the controlling program.")

(=>
   (instance ?ACT MouseMoving)
   (exists (?MOUSE)
       (and
         (patient ?ACT ?MOUSE)
         (instance ?MOUSE ComputerMouse))))

(subclass TouchSurfaceAction UserDirectAction)
(subclass TouchSurfaceAction Touching)
(documentation TouchSurfaceAction EnglishLanguage "A &%TouchSurfaceAction is a &%UserDirectAction of
interacting with a &%TouchSensitiveComputerInputDevice.")

(=>
   (instance ?ACT TouchSurfaceAction)
   (exists (?TOUCHSURF)
       (and
         (patient ?ACT ?TOUCHSURF)
         (instance ?TOUCHSURF TouchSensitiveComputerInputDevice))))

(=>
  (and
    (instance ?ACT UserDirectAction)
    (patient ?ACT ?TOUCHSURF)
    (instance ?TOUCHSURF TouchSensitiveComputerInputDevice))
  (instance ?ACT TouchSurfaceAction))

(subclass TouchSurfaceSlide TouchSurfaceAction)
(subclass TouchSurfaceSlide SlidingComputerInputDeviceAction)
(documentation TouchSurfaceSlide EnglishLanguage "A &%TouchSurfaceSlide is a &%SlidingComputerInputDeviceAction
guiding an object along the surface of a &%TouchSensitiveComputerInputDevice.")

(subclass TouchSurfaceTap TouchSurfaceAction)
(subclass TouchSurfaceTap Clicking)
(subclass TouchSurfaceTap Impacting)
(documentation TouchSurfaceTap EnglishLanguage "A &%TouchSurfaceTap is a method of &%Clicking using a
&%TouchSensitiveComputerInputDevice by tapping the touch surface.")

(subclass TouchSurfaceDoubleFingerSlide TouchSurfaceAction)
(documentation TouchSurfaceDoubleFingerSlide EnglishLanguage "A &%TouchSurfaceDoubleFingerSlide is a
&%TouchSurfaceAction of touching the surface with two fingers and moving them in different directions.")

(=>
   (instance ?ACTION TouchSurfaceDoubleFingerSlide)
   (exists (?FINGER1 ?FINGER2)
       (and
         (instrument ?ACTION ?FINGER1)
         (instance ?FINGER1 Finger)
         (instrument ?ACTION ?FINGER2)
         (not (equal ?FINGER1 ?FINGER2))
         (instance ?FINGER2 Finger))))

(subclass ScreenTouchAction TouchSurfaceAction)
(documentation ScreenTouchAction EnglishLanguage "A &%ScreenTouchAction is a &%TouchSurfaceAction using
a &%ComputerTouchscreen.")
(=>
   (instance ?ACT ScreenTouchAction)
   (exists (?TOUCHSCREEN)
       (and
         (patient ?ACT ?TOUCHSCREEN)
         (instance ?TOUCHSCREEN ComputerTouchscreen))))

(=>
  (and
    (instance ?ACT ScreenTouchAction)
    (patient ?ACT ?TOUCHSURF)
    (instance ?TOUCHSURF TouchSensitiveComputerInputDevice))
  (instance ?TOUCHSURF ComputerTouchscreen))

(=>
  (and
    (instance ?ACT UserDirectAction)
    (patient ?ACT ?TOUCHSCREEN)
    (instance ?TOUCHSCREEN ComputerTouchscreen))
  (instance ?ACT ScreenTouchAction))

(subclass Screenshot ImageFile)
(documentation Screenshot EnglishLanguage "An &%Image that captures
the visual content of a &%ComputerDisplay at some point in time.  This
includes &%MobileCellPhones.")
(termFormat EnglishLanguage Screenshot "screenshot")

(=>
  (instance ?S Screenshot)
  (exists (?T ?I ?CD)
    (and
      (holdsDuring ?T
        (displayedUpon ?I ?CD))
      (represents ?I ?S))))
      
(subclass TouchPadAction TouchSurfaceAction)
(documentation TouchPadAction EnglishLanguage "A &%ScreenTouchAction is a &%TouchSurfaceAction using
a &%ComputerTouchpad.")

(=>
   (instance ?ACT TouchPadAction)
   (exists (?TOUCHPAD)
       (and
         (patient ?ACT ?TOUCHPAD)
         (instance ?TOUCHPAD ComputerTouchpad))))

(=>
  (and
    (instance ?ACT UserDirectAction)
    (patient ?ACT ?TOUCHPAD)
    (instance ?TOUCHPAD ComputerTouchpad))
  (instance ?ACT TouchPadAction))

(subclass JoystickMotion UserDirectAction)
(documentation JoystickMotion EnglishLanguage "A &%UserDirectAction consisting of moving a &%Joystick.")
(disjoint JoystickMotion TouchSurfaceAction)
(disjoint JoystickMotion KeyboardAction)

(=>
   (instance ?ACT JoystickMotion)
   (exists (?JOYSTICK)
       (and
         (patient ?ACT ?JOYSTICK)
         (instance ?JOYSTICK Joystick))))

(=>
  (and
    (instance ?ACT UserDirectAction)
    (patient ?ACT ?JOYSTICK)
    (instance ?JOYSTICK Joystick))
  (instance ?ACT JoystickMotion))

(subclass AudioInput UserDirectAction)
(documentation AudioInput EnglishLanguage "A &%UserDirectAction consisting of providing sound as
input to a computer.  &%AudioInput may be recorded, transmitted to another device, or used for control.")
(disjoint AudioInput TouchSurfaceAction)
(disjoint AudioInput JoystickMotion)
(disjoint AudioInput KeyboardAction)

(subclass AudioInputControl AudioInput)
(documentation AudioInputControl EnglishLanguage "A &%UserDirectAction consisting of using sound to
control a computer.  &%AudioInput which is not used for control (whether being recorded or transmitted
to another device) is not considered to be &%AudioInputControl")

(subclass ScrollWheelRotating UserDirectAction)
(subclass ScrollWheelRotating Rotating)
(documentation ScrollWheelRotating EnglishLanguage "A &%UserDirectAction consisting of rolling a &%ScrollWheel.")
(disjoint ScrollWheelRotating TouchSurfaceAction)
(disjoint ScrollWheelRotating AudioInput)
(disjoint ScrollWheelRotating JoystickMotion)
(disjoint ScrollWheelRotating KeyboardAction)

(=>
   (instance ?ACT ScrollWheelRotating)
   (exists (?WHEEL)
       (and
         (experiencer ?ACT ?WHEEL)
         (instance ?WHEEL ScrollWheel))))

(subclass ScrollWheelRotatingAway ScrollWheelRotating)
(documentation ScrollWheelRotatingAway EnglishLanguage "&%ScrollWheelRotating consisting of rolling a
&%ScrollWheel away from the user (assuming the user is on the expected side of the scroll wheel).")

(subclass ScrollWheelRotatingInward ScrollWheelRotating)
(documentation ScrollWheelRotatingInward EnglishLanguage "&%ScrollWheelRotating consisting of rolling a
&%ScrollWheel towards from the user (assuming the user is on the expected side of the scroll wheel).")
(disjoint ScrollWheelRotatingAway ScrollWheelRotatingInward)

(subclass Typing KeyboardAction)
(documentation Typing EnglishLanguage "A &%UserDirectAction consisting of typing on a keyboard.  Each
act of &%Typing has a number of subevents which are instances of &%SingleKeyPress.")
(disjoint ScrollWheelRotating Typing)
(disjoint Typing AudioInput)
(disjoint Typing TouchSurfaceAction)
(disjoint Typing JoystickMotion)

(=>
   (instance ?TYPING Typing)
   (exists (?KEYPRESS)
      (and
         (subProcess ?KEYPRESS ?TYPING)
         (instance ?KEYPRESS SingleKeyPress))))

; =======================

(subclass UserSignifiedGraphicalAction UserSignifiedAction)
(documentation UserSignifiedGraphicalAction EnglishLanguage "A &%UserSignifiedAction that is interpreted
as signifying a change in a graphical feature (cursor movement, highlighting of an area, etc.).")

(=>
   (instance ?ACT UserSignifiedGraphicalAction)
   (exists (?GUIE)
       (and
         (patient ?ACT ?GUIE)
         (instance ?GUIE GUIActiveArea))))

(instance udaCanSignify BinaryPredicate)
(domainSubclass udaCanSignify 1 UserDirectAction)
(domainSubclass udaCanSignify 2 UserSignifiedAction)
(documentation udaCanSignify EnglishLanguage "(udaCanSignify ?DIRECT_ACTION_TYPE ?SIGNIFIED_ACTION_TYPE)
means that an instance of the &%UserDirectAction ?DIRECT_ACTION can signify to a program an instance of
the &%UserSignifiedAction ?SIGNIFIED_ACTION_TYPE.")

(subclass MovingCursor UserSignifiedGraphicalAction)
(subclass MovingCursor Translocation)
(subclass MovingCursor Guiding)
(documentation MovingCursor EnglishLanguage "The &%UserSignifiedGraphicalAction is accomplished by a
&%ComputerUser taking a &%UserDirectAction that is interpreted as signifying that a cursor should be
moved.  Depending upon program state this could be accomplished by &%UserDirectActions of &%MouseMoving,
a &%TouchSurfaceSlide, &%JoystickMotion, &%ScrollWheelRotating, &%KeyboardAction, repeated %&Clicking,
or &%AudioInput.")

(=>
   (instance ?ACT MovingCursor)
   (exists (?GUIE)
       (and
         (patient ?ACT ?GUIE)
         (instance ?GUIE Cursor))))

(udaCanSignify SlidingComputerInputDeviceAction MovingCursor)
(udaCanSignify ScrollWheelRotating MovingCursor)
(udaCanSignify (PressingKeyFn ArrowKey) MovingCursor)
(udaCanSignify Clicking MovingCursor)

(subclass DraggingWithCursor MovingCursor)
(documentation DraggingWithCursor EnglishLanguage "&%DraggingWithCursor consists of moving a cursor
while some other screen component moves along with the cursor.")
(udaCanSignify (IntersectionFn MouseButtonHoldDown SlidingComputerInputDeviceAction)
               DraggingWithCursor)
(udaCanSignify (IntersectionFn ShiftKeyHoldDown SlidingComputerInputDeviceAction)
               DraggingWithCursor)
; Any cursor acted on by a &%DraggingWithCursor action is a &%MouseCursor

(=>
   (and
       (instance ?ACT DraggingWithCursor)
       (patient ?ACT ?CURSOR)
       (instance ?CURSOR Cursor))
   (instance ?CURSOR MouseCursor))

; In any DraggingWithCursor there is a non-cursor graphical element that is affected

(=>
   (instance ?ACT DraggingWithCursor)
   (exists (?GUIE)
       (and
         (patient ?ACT ?GUIE)
         (instance ?GUIE GUIActiveArea)
         (not (instance ?GUIE Cursor)))))

(subclass WindowScrolling ComputerProcess)
(documentation WindowScrolling EnglishLanguage "&%WindowScrolling consists of a &%ComputerProcess
moving as a block the contents of a frame in a window (when the logical size of the contents is
greater than that of the frame) without moving the window itself.")
; WindowScrolling always acts upon an InterfaceWindow:

(=>
   (instance ?ACT WindowScrolling)
   (exists (?GUIE)
       (and
         (patient ?ACT ?GUIE)
         (instance ?GUIE InterfaceWindow))))

(subclass WindowScrollingByUser WindowScrolling)
(subclass WindowScrollingByUser UserSignifiedGraphicalAction)
(documentation WindowScrollingByUser EnglishLanguage "&%WindowScrollingByUser consists of moving the
contents of a frame in a window (when the logical size of the contents is greater than that of the frame)
without moving the window itself.")

(<=> 
  (and
    (instance ?SCROLL WindowScrolling)
    (instance ?SCROLL UserSignifiedGraphicalAction))
  (instance ?SCROLL WindowScrollingByUser))

; User Window Scrolling affects the currently active window

(=>
  (instance ?SCROLL WindowScrollingByUser)
  (exists (?WINDOW)
    (and
      (patient ?SCROLL ?WINDOW)
      (instance ?WINDOW InterfaceWindow)
      (hasGUEState ?WINDOW GUE_ActiveState))))

(udaCanSignify (IntersectionFn MouseButtonHoldDown SlidingComputerInputDeviceAction)
               WindowScrollingByUser)
(udaCanSignify ScrollWheelRotating WindowScrollingByUser)
(udaCanSignify (PressingKeyFn ArrowKey) WindowScrollingByUser)

(subclass VerticalWindowScrolling WindowScrolling)
(documentation VerticalWindowScrolling EnglishLanguage "&%VerticalWindowScrolling consists of scrolling
the image in a frame up or down.  Such a scrolling direction is commonly used for text.")
(udaCanSignify (PressingKeyFn UpArrowKey) 
               (IntersectionFn VerticalWindowScrolling WindowScrollingByUser))
(udaCanSignify (PressingKeyFn DownArrowKey) 
               (IntersectionFn VerticalWindowScrolling WindowScrollingByUser))

(subclass HorizontalWindowScrolling WindowScrolling)
(documentation HorizontalWindowScrolling EnglishLanguage "&%HorizontalWindowScrolling consists of
scrolling the image in a frame from side to side.  Such a scrolling direction is commonly used in
video games.")
(udaCanSignify (PressingKeyFn RightArrowKey) 
               (IntersectionFn HorizontalWindowScrolling WindowScrollingByUser))
(udaCanSignify (PressingKeyFn LeftArrowKey) 
               (IntersectionFn HorizontalWindowScrolling WindowScrollingByUser))

(subclass TwoDWindowScrolling WindowScrolling)
(documentation TwoDWindowScrolling EnglishLanguage "&%TwoDWindowScrolling consists of scrolling the image
in a frame in any direction in 2D.  Such a scrolling method is commonly used for viewing portions of an
image or graphic in more detail than would be possible if the complete graphic were displayed in the
frame at one time.")

(subclass SubmitAction UserSignifiedAction)
(documentation SubmitAction EnglishLanguage "A &%SubmitAction is a &%UserSignifiedAction informing a
&%ComputerProgram to make a user-selected action.")
(udaCanSignify (PressingKeyFn EnterKey) SubmitAction)
(udaCanSignify LeftClicking SubmitAction)
(udaCanSignify DoubleClicking SubmitAction)
(udaCanSignify TouchSurfaceTap SubmitAction)
(udaCanSignify EnterKeyPress SubmitAction)

(subclass DownloadingRequest SubmitAction)
(documentation DownloadingRequest EnglishLanguage "A &%SubmitAction instructing a &%ComputerProgram to
download a file from an already specified location.")

(=>
   (instance ?ACT DownloadingRequest)
   (exists (?FILE)
       (and
         (patient ?ACT ?FILE)
         (instance ?FILE ComputerFile))))

(subclass UploadingRequest SubmitAction)
(documentation UploadingRequest EnglishLanguage "A &%SubmitAction instructing a &%ComputerProgram to
upload across a network a specified file existing on the local machine.")
(disjoint UploadingRequest DownloadingRequest)

(=>
   (instance ?ACT UploadingRequest)
   (exists (?FILE)
       (and
         (patient ?ACT ?FILE)
         (instance ?FILE ComputerFile))))

(subclass SubmitForm SubmitAction)
(documentation SubmitForm EnglishLanguage "A &%SubmitAction instructing a &%ComputerProgram to upload
a form which has been generated or filled in by a local program.")

(subclass InputCharacterString UserSignifiedAction)
(documentation InputCharacterString EnglishLanguage "A &%UserSignifiedAction providing a &%ComputerProgram
with a character string input.  This is often the intent of &%Typing.")
(udaCanSignify Typing InputCharacterString)

; ======================================

(subclass GUElementState VisualAttribute)
(documentation GUElementState EnglishLanguage "A state possessed by instances of &%GUIElement.  The
possible states include &%GUE_ActiveState, &%GUE_PassiveState, &%GUE_DisplayedState, &%GUE_CoveredState,
&%GUE_UncoveredState, and &%GUE_PartiallyCoveredState.")

(instance hasGUEState BinaryPredicate)
(subrelation hasGUEState attribute)
(domain hasGUEState 1 GUIElement)
(domain hasGUEState 2 GUElementState)
(documentation hasGUEState EnglishLanguage "(hasGUEState ?GUIE ?STATE) means that the &%GUIElement ?GUIE
has the &%GUElementState, ?STATE.")

(instance GUE_ActiveState GUElementState)
(documentation GUE_ActiveState EnglishLanguage "The &%GUElementState of being ready to accept user  clicks
and keyboard activity. At most one &%InterfaceWindow on a &%ComputerScreen is active at a time, and at most
one &%GUIElement that is a direct part of that window is active at one time.  A subelement of an active
element may also be active.")

; Only one &%InterfaceWindow is active on a screen at a time

(=> 
  (and
    (instance ?WINDOW1 InterfaceWindow)
    (instance ?WINDOW2 InterfaceWindow)
    (screenOfGUIE ?WINDOW1 ?SCREEN)
    (screenOfGUIE ?WINDOW2 ?SCREEN)
    (hasGUEState ?WINDOW1 GUE_ActiveState)
    (hasGUEState ?WINDOW1 GUE_ActiveState))
  (equal ?WINDOW1 ?WINDOW2))

; If a &%GUIElement is active, any &%GUIElement (including a &%InterfaceWindow) that 
; it is part of is active:

(=>
  (and
    (instance ?GUIE1 GUIElement)
    (hasGUEState ?GUIE1 GUE_ActiveState)
    (properPart ?GUIE1 ?GUIE2)
    (instance ?GUIE2 GUIElement))
  (hasGUEState ?GUIE2 GUE_ActiveState))

; If a &%GUIElement is active, it is part of the active &%InterfaceWindow
; on that screen:

(=>
  (and
    (instance ?WINDOW InterfaceWindow)
    (instance ?GUIE GUIElement)
    (screenOfGUIE ?WINDOW ?SCREEN)
    (screenOfGUIE ?GUIE ?SCREEN)
    (not (instance ?GUIE InterfaceWindow))
    (hasGUEState ?WINDOW GUE_ActiveState)
    (hasGUEState ?GUIE GUE_ActiveState))
  (properPart ?GUIE ?WINDOW))

; if two different non-window &%GUIElements are active on the same screen,
; one is a part of the other
; E.g., a menu & menuitem or submenu:

(=>
  (and
    (instance ?GUIE1 GUIElement)
    (instance ?GUIE2 GUIElement)
    (not (instance ?GUIE1 InterfaceWindow))
    (not (instance ?GUIE2 InterfaceWindow))
    (screenOfGUIE ?GUIE1 ?SCREEN)
    (screenOfGUIE ?GUIE2 ?SCREEN)
    (hasGUEState ?GUIE1 GUE_ActiveState)
    (hasGUEState ?GUIE2 GUE_ActiveState))
  (or
    (properPart ?GUIE1 ?GUIE2)
    (properPart ?GUIE2 ?GUIE1)
    (equal ?GUIE1 ?GUIE2)))
  
; A MouseCursor is never in the &%GUE_ActiveState:

(not
  (and
    (instance ?CURSOR MouseCursor)
    (hasGUEState ?CURSOR GUE_ActiveState)))

(instance GUE_PassiveState GUElementState)
(documentation GUE_PassiveState EnglishLanguage "The &%GUElementState of not being ready to accept user
clicks or keyboard activity. Whenever an &%InterfaceWindow is passive at a time, any &%GUIElement that is
part of that window is also passive.")
(contraryAttribute GUE_ActiveState GUE_PassiveState)
; any window other than the active one on a screen is passive:

(=> 
  (and
    (instance ?WINDOW_A InterfaceWindow)
    (instance ?WINDOW_P InterfaceWindow)
    (screenOfGUIE ?WINDOW_A ?SCREEN)
    (screenOfGUIE ?WINDOW_P ?SCREEN)
    (hasGUEState ?WINDOW_A GUE_ActiveState)
    (not (equal ?WINDOW_A ?WINDOW_P)))
  (hasGUEState ?WINDOW_P GUE_PassiveState))

; any &%GUIElement that is part of a passive &%GUIElement (including an 
; &%InterfaceWindow) is also passive:

(=>
  (and
    (instance ?GUIE_SM GUIElement)
    (instance ?GUIE_BIG GUIElement)
    (properPart ?GUIE_SM ?GUIE_BIG)
    (hasGUEState ?GUIE_BIG GUE_PassiveState))
  (hasGUEState ?GUIE_SM GUE_PassiveState))

(instance GUE_DisplayedState GUElementState)
(documentation GUE_DisplayedState EnglishLanguage "A &%GUIElement has a &%GUE_DisplayedState if it at least
partially appears on a &%ComputerScreen.")
; A MouseCursor is always in the &%GUE_DisplayedState:

(=>
    (instance ?CURSOR MouseCursor)
    (hasGUEState ?CURSOR GUE_DisplayedState))
 
(instance GUE_NonVisibleState GUElementState)
(subAttribute GUE_NonVisibleState GUE_PassiveState)
(documentation GUE_NonVisibleState EnglishLanguage "A &%GUIElement has a &%GUE_NonVisibleState if it
conceptually exists, but does not appear on a &%ComputerScreen.")
; any &%GUIElement that is part of a non-visible &%GUIElement (including an 
; &%InterfaceWindow) is also offscreen:

(=>
  (and
    (instance ?GUIE_SM GUIElement)
    (instance ?GUIE_BIG GUIElement)
    (properPart ?GUIE_SM ?GUIE_BIG)
    (hasGUEState ?GUIE_BIG GUE_NonVisibleState))
  (hasGUEState ?GUIE_SM GUE_NonVisibleState))

;  a non-visible window may not be active:

(not
   (and
      (hasGUEState ?WINDOW GUE_NonVisibleState)
      (hasGUEState ?WINDOW GUE_ActiveState)
      (instance ?WINDOW InterfaceWindow)))

(contraryAttribute GUE_NonVisibleState GUE_DisplayedState)

(instance GUE_OffscreenState GUElementState)
(subAttribute GUE_OffscreenState GUE_NonVisibleState)
(documentation GUE_OffscreenState EnglishLanguage "An &%InterfaceWindow has a &%GUE_OffscreenState if all
parts of it are outside the logical area displaye on a &%ComputerScreen. A &%GUIElement has a
&%GUE_OffscreenState if all parts of it are outside the &$InterfaceWindow which it is in or outside the
logical area of the screen.  An offscreen &%InterfaceWindow may not be active, but an offscreen element
of a window that is partially on the screen may be.")
; any &%GUIElement that is part of an offscreen &%GUIElement (including an 
; &%InterfaceWindow) is also offscreen:

(=>
  (and
    (instance ?GUIE_SM GUIElement)
    (instance ?GUIE_BIG GUIElement)
    (properPart ?GUIE_SM ?GUIE_BIG)
    (hasGUEState ?GUIE_BIG GUE_OffscreenState))
  (hasGUEState ?GUIE_SM GUE_OffscreenState))
 
(instance GUE_MinimizedState GUElementState)
(subAttribute GUE_MinimizedState GUE_NonVisibleState)
(documentation GUE_MinimizedState EnglishLanguage "A &%GUIElement has a &%GUE_MinimizedState if has been
logically minimized, which means that although it might have an assigned position on the screen, it does
not appear on the screen and is can not be made active until it is reopened.")
(contraryAttribute GUE_MinimizedState GUE_ActiveState)

(instance GUE_MaximizedWindowState GUElementState)
(documentation GUE_MaximizedWindowState EnglishLanguage "An &%InterfaceWindow has a &%GUE_MaximizedWindowState
if it is sized to cover the whole screen and is not minimized.  A maximized window may still be completely
covered.  Only windows can have such a state.")
; Only an InterfaceWindow can have a GUE_MaximizedWindowState
; can this be expressed as a constraint instead of an implication?:

(=> 
  (hasGUEState ?GUIE GUE_MaximizedWindowState)
  (instance ?GUIE InterfaceWindow))

(contraryAttribute GUE_MaximizedWindowState GUE_MinimizedState)
(contraryAttribute GUE_MaximizedWindowState GUE_OffscreenState)
 
(instance GUE_VerticallyMaximizedWindowState GUElementState)
(documentation GUE_VerticallyMaximizedWindowState EnglishLanguage "An &%InterfaceWindow has a
&%VerticallyMaximizedWindowState if it is sized to cover the whole screen in the vertical direction,
has a fixed (and maximum for its program) width that is less than the screen width, and is not minimized.
A vertically maximized window may still be completely covered.  Only windows can have such a state.")
; Only an InterfaceWindow can have a VerticallyMaximizedWindowState

(=> 
  (hasGUEState ?GUIE GUE_VerticallyMaximizedWindowState)
  (instance ?GUIE InterfaceWindow))

(contraryAttribute GUE_VerticallyMaximizedWindowState GUE_MaximizedWindowState)
(contraryAttribute GUE_VerticallyMaximizedWindowState GUE_MinimizedState)
(contraryAttribute GUE_VerticallyMaximizedWindowState GUE_OffscreenState)

(instance GUE_CoveredState GUElementState)
(subAttribute GUE_CoveredState GUE_NonVisibleState)
(documentation GUE_CoveredState EnglishLanguage "A &%GUIElement has a &%GUE_CoveredState if it does not
appear on a &%ComputerScreen and every portion of it on the computer window space (including parts
outside the visible window) for which it is defined has something opaque being displayed on a layer
conceptually closer to the viewer.")
; any &%GUIElement that is part of a covered &%GUIElement (including an 
; &%InterfaceWindow) is also covered:

(=>
  (and
    (instance ?GUIE_SM GUIElement)
    (instance ?GUIE_BIG GUIElement)
    (properPart ?GUIE_SM ?GUIE_BIG)
    (hasGUEState ?GUIE_BIG GUE_CoveredState))
  (hasGUEState ?GUIE_SM GUE_CoveredState))

(instance GUE_UncoveredState GUElementState)
(documentation GUE_UncoveredState EnglishLanguage "A &%GUIElement has a &%GUE_UncoveredState if no
portion of it on the computer window space (including parts outside the visible window) for which it
is defined has something being displayed on a layer conceptually closer to the viewer.")
; An uncovered window is either partially visible or offscreen:

(=>
  (hasGUEState ?WIN1 GUE_UncoveredState)
  (or
    (hasGUEState ?WIN1 GUE_DisplayedState)
    (hasGUEState ?WIN1 GUE_OffscreenState)))

; If an uncovered window is maximized, it is the active window:

(=>
  (and
    (hasGUEState ?WINDOW GUE_UncoveredState)
    (hasGUEState ?WINDOW GUE_MaximizedWindowState))
  (hasGUEState ?WINDOW GUE_ActiveState))

(instance GUE_PartiallyCoveredState GUElementState)
(documentation GUE_PartiallyCoveredState EnglishLanguage "A &%GUIElement has a &%GUE_PartiallyCoveredState
if some portion of it on the computer window space (including parts outside the visible window) for which
it is defined has something being displayed on a layer conceptually closer to the viewer while some other
portion is not opaquely covered.")
(contraryAttribute GUE_CoveredState GUE_UncoveredState GUE_PartiallyCoveredState)

; If an uncovered window is maximized, every other window is
; covered, partially covered, or offscreen:

(=>
  (and
    (hasGUEState ?WIN1 GUE_UncoveredState)
    (hasGUEState ?WIN1 GUE_MaximizedWindowState)
    (screenOfGUIE ?WIN1 ?SCREEN)
    (instance ?WIN2 InterfaceWindow)
    (screenOfGUIE ?WIN2 ?SCREEN)
    (not (equal ?WIN1 ?WIN2)))
  (or
    (hasGUEState ?WIN2 GUE_CoveredState)
    (hasGUEState ?WIN2 GUE_PartiallyCoveredState)
    (hasGUEState ?WIN2 GUE_OffscreenState)))

(instance GUE_TranslucentlyCoveredState GUElementState)
(subAttribute GUE_TranslucentlyCoveredState GUE_PartiallyCoveredState)
(documentation GUE_TranslucentlyCoveredState EnglishLanguage "A &%GUIElement has a &%GUE_TranslucentlyCoveredState
if some portion of it on the computer window space (including parts outside the visible window) for which it is
defined has something translucent being displayed on a layer conceptually closer to the viewer such that that
section would be partially displayed.")

(instance GUE_InPartCoveredState GUElementState)
(subAttribute GUE_InPartCoveredState GUE_PartiallyCoveredState)
(documentation GUE_InPartCoveredState EnglishLanguage "A &%GUIElement has a &%GUE_InPartCoveredState if some
portion of it on the computer window space (including parts outside the visible window) for which it is
defined has something opaque being displayed on a layer conceptually closer to the viewer such that that
section would be partially displayed while some other portion is not opaquely covered.")
; note that GUE_TranslucentlyCoveredState and GUE_InPartCoveredState are 
; compatible.  Something can have both states.

(=>
  (instance ?GUE GUIElement)
  (or
    (hasGUEState ?GUE GUE_CoveredState)
    (hasGUEState ?GUE GUE_OffscreenState)
    (hasGUEState ?GUE GUE_MinimizedState)
    (hasGUEState ?GUE GUE_DisplayedState)))

;=========================================================================

(subclass SelectingActiveArea UserSignifiedAction)
(documentation SelectingActiveArea EnglishLanguage "A &%UserSignifiedAction informing a &%ComputerProgram
that the current &%GUIElement with the state &%GUE_ActiveState is selected.  This causes the program
controlling the element to take the action that selecting the element is mapped to.  After the action has
been initiated, unless the action causes a different element to become active or changes the state of the
element, the element reverts to &%GUE_ActiveState.

Selecting an &%ActiveArea_Submitting causes a &%SubmitAction (of the type associated with the active area)
to take place.  What is actually submitted may depend upon the state of associated active areas.  However,
if the active area is a &%HypertextLink, &%MenuItem, or dedicated &%GUIButton the submission may not be
state dependent.

An off-screen element on an active window can be selected by keyboard action: tabbing to it to make it
active and typing the Enter/Return key.")
(udaCanSignify Clicking SelectingActiveArea)
(udaCanSignify DoubleClicking SelectingActiveArea)
(udaCanSignify ShiftClicking SelectingActiveArea)
(udaCanSignify KeyboardAction SelectingActiveArea)

(instance GUE_SelectedState GUElementState)
(documentation GUE_SelectedState EnglishLanguage "A &%GUIElement has a &%GUE_SelectedState if a
&%SelectingActiveArea action is performed with it as the &%patient.  This causes the program controlling
the element to take the action that selecting the element is mapped to.  After the action has been initiated,
unless the action causes a different element to become active or changes the state of the element, the element
reverts to &%GUE_ActiveState.

The state of a GUI element normally changes to selected if the element had been in the &%GUE_ActiveState and it
was clicked, double-clicked, the enter key was hit, or some similar graphical action was taken to select it.")
(contraryAttribute GUE_CoveredState GUE_SelectedState)
; Selecting and active area operates on a currently active GUI element

(=>
  (instance ?SELECT SelectingActiveArea)
  (exists (?ELEMENT)
    (and
      (instance ?ELEMENT GUIActiveArea)
      (holdsDuring 
        (BeginFn ?SELECT)
        (hasGUEState ?ELEMENT GUE_ActiveState))
      (patient ?SELECT ?ELEMENT))))

; A GUIElement that is selected, does not have the &%GUE_SelectedState 
; before the selection occurs:

(=>
  (and
    (instance ?SELECT SelectingActiveArea)
    (patient ?SELECT ?ELEMENT)
    (instance ?ELEMENT GUIActiveArea))
  (holdsDuring 
    (BeginFn ?SELECT)
    (not (hasGUEState ?ELEMENT GUE_SelectedState))))

; A GUIElement that is selected, achieves the &%GUE_SelectedState 
; when the selection occurs:

(=>
  (and
    (instance ?SELECT SelectingActiveArea)
    (patient ?SELECT ?ELEMENT)
    (instance ?ELEMENT GUIActiveArea))
  (holdsDuring 
    (EndFn ?SELECT)
    (hasGUEState ?ELEMENT GUE_SelectedState)))

; A Cursor is never in the &%GUE_SelectedState:

(not
  (and
    (instance ?CURSOR Cursor)
    (hasGUEState ?CURSOR GUE_SelectedState)))
    
(subclass RequestingHyperlink SelectingActiveArea)
(documentation RequestingHyperlink EnglishLanguage "A &%UserSignifiedAction instructing a &%ComputerProgram
to follow the currently active &%HypertextLink.")

(=>
  (and
    (instance ?SELECT SelectingActiveArea)
    (patient ?SELECT ?ELEMENT)
    (instance ?ELEMENT HypertextLink))
  (instance ?SELECT RequestingHyperlink))

(subclass SelectingComputerMenuOption SelectingActiveArea)
(documentation SelectingComputerMenuOption EnglishLanguage "A &%UserSignifiedAction instructing a
&%ComputerProgram to take whatever action is intended when the selected menu selection is chosen.")

(=>
  (and
    (instance ?SELECT SelectingActiveArea)
    (patient ?SELECT ?ELEMENT)
    (instance ?ELEMENT ComputerMenuItem))
  (instance ?SELECT SelectingComputerMenuOption))

; last two relations undefined [AP]
;(=>
;  (and
;    (instance ?SELECT SelectingComputerMenuOption)
;    (patient ?SELECT ?ELEMENT)
;    (instance ?ELEMENT ComputerMenuItem)
;    (menuItemIndicates ?ELEMENT ?COMPUTER_PROCESS_TYPE))
;  (initiatesCompterProcessType ?SELECT ?COMPUTER_PROCESS_TYPE))

(subclass ActivatingUIElement UserSignifiedAction)
(documentation ActivatingUIElement EnglishLanguage "A &%UserSignifiedAction causing a program to make a
&%UIElement the ``active'' element.  Making an element active means that user can interact with it --
follow a link, select a menu option, drag the element on the screen, ``push'' a button, etc.  The system
may display the %&UIElement in a different manner signifying that it is selected.")

(=>
  (and
    (instance ?ACT ActivatingUIElement)
    (patient ?ACT ?GUIE)
    (instance ?GUIE GUIElement))
  (and
    (holdsDuring (EndFn ?SELECT) 
      (hasGUEState ?GUIE GUE_ActiveState))
    (holdsDuring (StartFn ?SELECT) 
      (not (hasGUEState ?GUIE GUE_ActiveState)))))

(subclass SelectingComputerSubmenu ActivatingUIElement)
(documentation SelectingComputerSubmenu EnglishLanguage "A &%UserSignifiedAction instructing a
&%ComputerProgram to allow user interaction with a chosen submenu.")

(=>
  (and
    (instance ?SELECT SelectingComputerSubmenu)
    (patient ?SELECT ?SUBMENU)
    (instance ?SUBMENU GUIElement))
  (instance ?SUBMENU ComputerMenu))

(subclass JumpingToActivateUIElement ActivatingUIElement)
(subclass JumpingToActivateUIElement UserSignifiedGraphicalAction)
(documentation JumpingToActivateUIElement EnglishLanguage "A &%UserSignifiedAction causing the cursor
to ``jump'' from its current position to a &%UIElement, making it ``Active''.")

(subclass JumpingForwardToActivateUIElement JumpingToActivateUIElement)
(documentation JumpingForwardToActivateUIElement EnglishLanguage "A &%JumpingToActiveUIElement causing
the cursor to ``jump'' from its current position to whatever is considered the ``next'' &%UIElement,
making it ``Active''.")
; !!! Needs rule
(udaCanSignify (PressingKeyFn TabKey) SelectingActiveArea)
(udaCanSignify (PressingKeyFn RightArrowKey) SelectingActiveArea)
(udaCanSignify (PressingKeyFn DownArrowKey) SelectingActiveArea)

(subclass JumpingBackwardToActivateUIElement JumpingToActivateUIElement)
(documentation JumpingBackwardToActivateUIElement EnglishLanguage "A &%JumpingToActiveUIElement causing the
cursor to ``jump'' from its current position to whatever is considered the ``previous'' &%UIElement, making
it ``Active''.")
; !!! Needs rule
(udaCanSignify (UnionFn (PressingKeyFn TabKey) ShiftKeyHoldDown)
               SelectingActiveArea)
(udaCanSignify (PressingKeyFn LeftArrowKey) SelectingActiveArea)
(udaCanSignify (PressingKeyFn UpArrowKey) SelectingActiveArea)

(subclass Highlighting UserSignifiedGraphicalAction)
(documentation Highlighting EnglishLanguage "A &%UserSignifiedAction causing a program to highlight a piece of
text, link, image, or other component visible on the screen.")
; !!! Needs rule

(subclass ResizingScreenObject UserSignifiedGraphicalAction)
(documentation ResizingScreenObject EnglishLanguage "A &%UserSignifiedAction causing a program to change the
size of a display on the &%ComputerScreen.")
(udaCanSignify TouchSurfaceDoubleFingerSlide ResizingScreenObject)
; !!! Needs rule

(subclass BringingGEToFront UserSignifiedGraphicalAction)
(documentation BringingGEToFront EnglishLanguage "A &%UserSignifiedAction causing an &%GUIElement to be logically
brought to the front -- of its window if it is an element in a window, and of a &%ComputerScreen if it is an
&%InterfaceWindow.")
; If an window is brought to the front, it loses any state that is contrary to 
; &%GUE_UncoveredState

(=>
  (and
    (instance ?ACT BringingGEToFront)
    (patient ?ACT ?WINDOW)
    (instance ?WINDOW InterfaceWindow)
    (holdsDuring
      (BeginFn ?ACT)
      (hasGUEState ?WINDOW ?STATE))
    (contraryAttribute ?STATE GUE_UncoveredState))
  (holdsDuring
    (EndFn ?ACT)
    (not (hasGUEState ?WINDOW ?STATE))))

; If an window is brought to the front, it gains the state, &%GUE_UncoveredState

(=>
  (and
    (instance ?ACT BringingGEToFront)
    (patient ?ACT ?WINDOW)
    (instance ?WINDOW InterfaceWindow))
  (holdsDuring
    (EndFn ?ACT)
    (hasGUEState ?WINDOW GUE_UncoveredState)))
; ? Needs another rule?

(subclass OpeningGraphicalWindow UserSignifiedGraphicalAction)
(documentation OpeningGraphicalWindow EnglishLanguage "A &%UserSignifiedAction causing the display of an
&%InterfaceWindow on a &%ComputerScreen.")

(=> 
  (and
    (instance ?OPEN OpeningGraphicalWindow)
    (patient ?OPEN ?WINDOW))
  (instance ?WINDOW InterfaceWindow))

(subclass OpeningNewGraphicalWindow OpeningGraphicalWindow)
(subclass OpeningNewGraphicalWindow Creation)
(documentation OpeningNewGraphicalWindow EnglishLanguage "A &%UserSignifiedAction causing the display of a
new &%InterfaceWindow on a &%ComputerScreen.")
; OpeningNewGraphicalWindow creates a window that didn't previously exist:

(=> 
  (instance ?OPEN OpeningNewGraphicalWindow)
  (exists (?WINDOW)
    (and
      (patient ?OPEN ?WINDOW)
      (instance ?WINDOW InterfaceWindow)
      (time ?WINDOW (EndFn (WhenFn ?OPEN)))
      (not (time ?WINDOW (BeginFn (WhenFn ?OPEN)))))))

(subclass ReopeningGraphicalWindow OpeningGraphicalWindow)
(documentation ReopeningGraphicalWindow EnglishLanguage "A &%UserSignifiedAction causing the redisplay of a
minimized &%InterfaceWindow on a &%ComputerScreen.  Reopening a window normally makes it the active window
and brings it to the front.")
(disjoint ReopeningGraphicalWindow OpeningNewGraphicalWindow)
; ReopeningGraphicalWindow opens a window that was previouly minimized:

(=>
  (and
    (instance ?OPEN ReopeningGraphicalWindow)
    (patient ?OPEN ?WINDOW)
    (instance ?WINDOW InterfaceWindow))
  (and
    (holdsDuring (BeginFn (WhenFn ?OPEN))
      (hasGUEState ?WINDOW GUE_MinimizedState))
    (holdsDuring (EndFn (WhenFn ?OPEN))
      (not (hasGUEState ?WINDOW GUE_MinimizedState)))))

(subclass UncoveringGraphicalWindow OpeningGraphicalWindow)
(documentation UncoveringGraphicalWindow EnglishLanguage "A &%UserSignifiedAction causing a &%CoveredInterfaceWindow
to become visible again by (re)moving any &%GraphicalUIElement that has been covering it.")
(disjoint UncoveringGraphicalWindow OpeningNewGraphicalWindow)
(disjoint UncoveringGraphicalWindow ReopeningGraphicalWindow)
; UncoveringGraphicalWindow affects an &%InterfaceWindow:

(=>
  (instance ?UNCOVER UncoveringGraphicalWindow)
  (exists (?WINDOW)
    (and
      (patient ?UNCOVER ?WINDOW)
      (instance ?WINDOW InterfaceWindow))))

; UncoveringGraphicalWindow changes the state of a window from covered to uncovered:

(=>
  (and
    (instance ?UNCOVER UncoveringGraphicalWindow)
    (patient ?UNCOVER ?WINDOW)
    (instance ?WINDOW InterfaceWindow))
  (guiElementUncovered ?UNCOVER ?WINDOW))

(=>
  (and
    (instance ?UNCOVER UncoveringGraphicalWindow)
    (patient ?UNCOVER ?WINDOW)
    (instance ?WINDOW InterfaceWindow)
    (properPart ?CURSOR ?WINDOW)
    (instance ?CURSOR Cursor))
  (guiElementUncovered ?UNCOVER ?WINDOW))

(subclass ClosingGraphicalWindow UserSignifiedGraphicalAction)
(subclass ClosingGraphicalWindow Destruction)
(documentation ClosingGraphicalWindow EnglishLanguage "A &%UserSignifiedAction causing an &%InterfaceWindow
on a &%ComputerScreen to stop being displayed.")
; On closing a graphical window an &%Interface window ceases to exist:

(=> 
  (and
    (instance ?CLOSE ClosingGraphicalWindow)
    (patient ?CLOSE ?WINDOW))
  (and
    (instance ?WINDOW InterfaceWindow)
    (time ?WINDOW (BeginFn (WhenFn ?OPEN)))
    (not (time ?WINDOW (EndFn (WhenFn ?OPEN))))))

(subclass MinimizingGraphicalWindow UserSignifiedGraphicalAction)
(documentation MinimizingGraphicalWindow EnglishLanguage "A &%UserSignifiedAction causing an &%InterfaceWindow
on a &%ComputerScreen to stop being displayed but to still conceptually exist.")

(=>
  (and
    (instance ?OPEN MinimizingGraphicalWindow)
    (patient ?OPEN ?WINDOW)
    (instance ?WINDOW InterfaceWindow))
  (and
    (holdsDuring (EndFn (WhenFn ?OPEN))
      (hasGUEState ?WINDOW GUE_MinimizedState))
    (holdsDuring (BeginFn (WhenFn ?OPEN))
      (not (hasGUEState ?WINDOW GUE_MinimizedState)))))

(subclass MaximizingGraphicalWindow UserSignifiedGraphicalAction)
(documentation MaximizingGraphicalWindow EnglishLanguage "A &%UserSignifiedAction causing an &%InterfaceWindow
to be expanded to cover the complete area of a &%ComputerScreen -- or possibly the complete vertical range of
the screen if the window has a maximum width less than the screen-width.  If the window being maximized is
logically in front of any other window (which would normally be the case), this would also be a case of
&%CoveringGraphicalWindow.")

(=>
  (and
    (instance ?OPEN MaximizingGraphicalWindow)
    (patient ?OPEN ?WINDOW)
    (instance ?WINDOW InterfaceWindow))
  (and
    (holdsDuring (EndFn (WhenFn ?OPEN))
      (hasGUEState ?WINDOW GUE_MaximizedWindowState))
    (holdsDuring (BeginFn (WhenFn ?OPEN))
      (not (hasGUEState ?WINDOW GUE_MaximizedWindowState)))))

(subclass UnmaximizingGraphicalWindow UserSignifiedGraphicalAction)
(documentation UnmaximizingGraphicalWindow EnglishLanguage "A &%UserSignifiedAction causing an
&%InterfaceWindow to be reduced from covering the complete area of a &%ComputerScreen to the size and location
it had before being maximized.  If it was created as maximized, unmaximizing it will shrink it to a default
size and location.")

(=>
  (and
    (instance ?UNMAX UnmaximizingGraphicalWindow)
    (patient ?UNMAX ?WINDOW)
    (instance ?WINDOW InterfaceWindow))
  (and
    (holdsDuring (BeginFn (WhenFn ?UNMAX ))
      (hasGUEState ?WINDOW GUE_MaximizedWindowState))
    (holdsDuring (EndFn (WhenFn ?UNMAX ))
      (not (hasGUEState ?WINDOW GUE_MaximizedWindowState)))))

(subclass CoveringGUIElement UserSignifiedGraphicalAction)
(documentation CoveringGUIElement EnglishLanguage "A &%UserSignifiedAction causing a &%GUIElement to be
covered completely on a &%ComputerScreen by at least one other &%GUIElement.")
; An instance of &%CoveringGUIElement involves an element (doing the covering) and 
; a different element (doing the uncovering)

(=>
  (instance ?COVERING CoveringGUIElement)
  (exists (?GUIE1 ?GUIE2)
    (and
      (instance ?GUIE1 GUIElement)
      (instance ?GUIE2 GUIElement)
      (agent ?COVERING ?GUIE1)
      (patient ?COVERING ?GUIE2)
      (not (equal ?GUIE1 ?GUIE2)))))

(instance guiElementCovered BinaryPredicate)
(domain guiElementCovered 1 CoveringGUIElement)
(domain guiElementCovered 2 GUIElement)
(documentation guiElementCovered EnglishLanguage "(guiElementCovered ?COVERING ?GUIE) means that the
&%GUIElement ?GUIE has become completely covered by the action ?COVERING.  It is still logically
positioned at the same place on the screen.")

(=>
  (instance ?COVERING CoveringGUIElement)
  (exists (?GUIE)
    (and
      (instance ?GUIE GUIElement)
      (patient ?COVERING ?GUIE)
      (guiElementCovered ?COVERING ?GUIE))))

(=>
  (guiElementCovered ?COVERING ?GUIE)
  (and
    (holdsDuring (BeginFn (WhenFn ?COVERING))
                 (or
                   (hasGUEState ?GUIE GUE_PartiallyCoveredState)
                   (hasGUEState ?GUIE GUE_UncoveredState)))
    (holdsDuring (EndFn (WhenFn ?COVERING))
                 (hasGUEState ?GUIE GUE_CoveredState))))

(instance guiElementCoveredBy BinaryPredicate)
(instance guiElementCoveredBy AsymmetricRelation)
(domain guiElementCoveredBy 1 GUIElement)
(domain guiElementCoveredBy 2 GUIElement)
(documentation guiElementCoveredBy EnglishLanguage "(guiElementCoveredBy ?GUIE1 ?GUIE2) means that the
&%GUIElement ?GUIE1 is completely covered by the &%GUIElement ?GUIE2.")
; A GUI Element that is covered by another has the GUE State, &%GUE_CoveredState:

(=>
  (guiElementCoveredBy ?GUIE_BOTTOM ?GUIE_TOP)
  (hasGUEState ?GUIE_BOTTOM GUE_CoveredState))

(subclass PartiallyCoveringGraphicalWindow UserSignifiedGraphicalAction)
(documentation PartiallyCoveringGraphicalWindow EnglishLanguage "A &%UserSignifiedAction causing a
&%GUIElement to be partially covered on a &%ComputerScreen by at least one other &%GUIElement.")

(instance guiElementPartiallyCovered BinaryPredicate)
(domain guiElementPartiallyCovered 1 PartiallyCoveringGraphicalWindow)
(domain guiElementPartiallyCovered 2 GUIElement)
(documentation guiElementPartiallyCovered EnglishLanguage "(guiElementPartiallyCovered ?COVERING ?GUIE)
means that the &%GUIElement ?GUIE has become partially covered by the action ?COVERING.  It is still
logically positioned at the same place on the screen.")
; Any &%PartiallyCoveringGraphicalWindow action causes some &%GUIElement to become
; uncovered:

(=>
  (instance ?UNCOVERING PartiallyCoveringGraphicalWindow)
  (exists (?GUIE)
    (and
      (instance ?GUIE GUIElement)
      (guiElementPartiallyCovered ?UNCOVERING ?GUIE))))

; The result of a &%GUIElement being partially covered is that the affected element
; ends up in the partialy covered state:

(=>
  (guiElementPartiallyCovered ?ACT ?GUIE)
  (holdsDuring (EndFn (WhenFn ?ACT))
    (hasGUEState ?GUIE GUE_PartiallyCoveredState)))

; A &%GUIElement being partially covered was partially or totally uncovered before the 
; partial covering took place:

(=>
  (guiElementPartiallyCovered ?ACT ?GUIE)
  (or
    (holdsDuring (BeginFn (WhenFn ?ACT))
      (hasGUEState ?GUIE GUE_UncoveredState))
    (holdsDuring (BeginFn (WhenFn ?ACT))
      (hasGUEState ?GUIE GUE_PartiallyCoveredState))))

(instance guiElementPartiallyCoveredBy BinaryPredicate)
(instance guiElementPartiallyCoveredBy AsymmetricRelation)
(domain guiElementPartiallyCoveredBy 1 GUIElement)
(domain guiElementPartiallyCoveredBy 2 GUIElement)
(documentation guiElementPartiallyCoveredBy EnglishLanguage "(guiElementPartiallyCoveredBy ?GUIE1 ?GUIE2)
means that the &%GUIElement ?GUIE1 is partially covered by the &%GUIElement ?GUIE2.")

(=>
  (and
    (instance ?COVERING CoveringGUIElement)
    (agent ?COVERING ?GUIE_TOP)
    (patient ?COVERING ?GUIE_BOTTOM)
    (instance ?GUIE_TOP GUIElement)
    (instance ?GUIE_BOTTOM GUIElement))
  (holdsDuring (EndFn ?COVERING)
           (or
             (guiElementCoveredBy ?GUIE_BOTTOM ?GUIE_TOP) 
             (guiElementPartiallyCoveredBy ?GUIE_BOTTOM ?GUIE_TOP))))

(=>
  (and
    (instance ?COVERING PartiallyCoveringGraphicalWindow)
    (agent ?COVERING ?GUIE_TOP)
    (patient ?COVERING ?GUIE_BOTTOM)
    (instance ?GUIE_TOP GUIElement)
    (instance ?GUIE_BOTTOM GUIElement))
  (holdsDuring (EndFn ?COVERING)
           (guiElementPartiallyCoveredBy ?GUIE_BOTTOM ?GUIE_TOP)))

(subclass UncoveringGUIElement UserSignifiedGraphicalAction)
(documentation UncoveringGUIElement EnglishLanguage "A &%UserSignifiedAction causing a covered
&%GUIElement to be completely uncovered on a &%ComputerScreen.")

(instance guiElementUncovered BinaryPredicate)
(domain guiElementUncovered 1 UncoveringGraphicalWindow)
(domain guiElementUncovered 2 GUIElement)
(documentation guiElementUncovered EnglishLanguage "(guiElementUncovered ?UNCOVERING ?GUIE) means that
the &%GUIElement ?GUIE has become completely uncovered by the action ?UNCOVERING.  Its logical
positioned on the screen does is not changed.")
; Any &%UncoveringGUIElement action causes some &%GUIElement to become uncovered:

(=>
  (instance ?UNCOVERING UncoveringGUIElement)
  (exists (?GUIE)
    (and
      (instance ?GUIE GUIElement)
      (guiElementUncovered ?UNCOVERING ?GUIE))))

; The result of a &%GUIElement being uncovered is that the affected element ends up 
; in the uncovered state:

(=>
  (guiElementUncovered ?ACT ?GUIE)
  (holdsDuring (EndFn (WhenFn ?ACT))
               (hasGUEState ?GUIE GUE_UncoveredState)))

; A &%GUIElement that is uncovered was partially or totally covered before the 
; uncovering took place:

(=>
  (guiElementUncovered ?ACT ?GUIE)
  (or
    (holdsDuring (BeginFn (WhenFn ?ACT))
                 (hasGUEState ?GUIE GUE_CoveredState))
    (holdsDuring (BeginFn (WhenFn ?ACT))
                 (hasGUEState ?GUIE GUE_PartiallyCoveredState))))

; ========================================

(subclass NetworkCommunication DataTransfer)
(documentation NetworkCommunication EnglishLanguage "&%NetworkCommunication consists of an interplay
of messages across a &%ComputerNetwork.")

(subclass AccessingWebPage NetworkCommunication)
(documentation AccessingWebPage EnglishLanguage "&%AccessWebPage consists accessing a &%WebPage across
a &%ComputerNetwork.")

(=>
  (instance ?ACT DownloadingOverNetwork)
  (exists (?FILE)
    (and
      (patient ?ACT ?FILE)
      (instance ?FILE WebPage))))

(subclass FTPing NetworkCommunication)
(documentation FTPing EnglishLanguage "&%FTPing consists accessing &%CompuerFiles on a remote computer
across a &%ComputerNetwork using the File Transfer Protocol (FTP).")

(subclass DownloadingOverNetwork NetworkCommunication)
(documentation DownloadingOverNetwork EnglishLanguage "&%DownloadingOverNetwork is those instances of
&%NetworkCommunication in which &%DigitalData are downloaded from a network onto the user's local
computer.  For example a &%ComputerFile may be generated on the fly or pre-exist on the system from which it
is being downloaded.")

(=>
  (instance ?ACT DownloadingOverNetwork)
  (exists (?DATA ?COM)
    (and
      (patient ?ACT ?DATA)
      (agent ?ACT ?COM)
      (destination ?ACT ?COM)
      (instance ?COM ComputerSystem)
      (instance ?DATA DigitalData))))

(subclass DownloadingingUpdate DownloadingOverNetwork )
(documentation DownloadingingUpdate EnglishLanguage "&%DownloadingingUpdate is those instances of
&%NetworkCommunication in which an update for &%ComputerFile is downloaded from a network onto the
user's local computer.  The &%ComputerFile may be generated on the fly or pre-exist on the system
from which it is being downloaded.")
; !!! Needs rule

(subclass DownloadingSoftware DownloadingOverNetwork )
(documentation DownloadingSoftware EnglishLanguage "&%DownloadingSoftware is those instances of
&%NetworkCommunication in which a &%SoftwarePackage is downloaded from a network onto the user's
local computer.")

(=>
  (instance ?ACT DownloadingSoftware)
  (exists (?FILE)
    (and
      (patient ?ACT ?FILE)
      (instance ?FILE SoftwareFile))))

(subclass DownloadingUserFile DownloadingOverNetwork )
(documentation DownloadingUserFile EnglishLanguage "&%DownloadingUserFile is those instances of
&%NetworkCommunication in which a user &%ComputerFile is downloaded to be stored on a user's local
computer from another &%ComputerSystem on a network.")
; !!! Needs rule

(subclass DownloadingImage DownloadingUserFile)
(documentation DownloadingImage EnglishLanguage "&%DownloadingImage is those instances of
&%NetworkCommunication in which a &%ImageFile is downloaded to a user's local computer from
another &%ComputerSystem on a network.")

(=>
  (instance ?ACT DownloadingImage)
  (exists (?FILE)
    (and
      (patient ?ACT ?FILE)
      (instance ?FILE ImageFile))))

(subclass DownloadingVideo DownloadingUserFile)
(documentation DownloadingVideo EnglishLanguage "&%DownloadingVideo is those instances of
&%NetworkCommunication in which an &%AudioVisualFile is downloaded to a user's local computer
from another &%ComputerSystem on a network.")

(=>
  (instance ?ACT DownloadingVideo)
  (exists (?FILE)
    (and
      (patient ?ACT ?FILE)
      (instance ?FILE AudioVisualFile))))

(subclass DownloadingAudio DownloadingUserFile)
(documentation DownloadingAudio EnglishLanguage "&%DownloadingAudio is those instances of
&%NetworkCommunication in which an &%AudioFile is downloaded to a user's local computer from
another &%ComputerSystem on a network.")

(=>
  (instance ?ACT DownloadingVideo)
  (exists (?FILE)
    (and
      (patient ?ACT ?FILE)
      (instance ?FILE AudioFile))))

(subclass DownloadingNonAudioVideoImageUserFile DownloadingUserFile)
(documentation DownloadingNonAudioVideoImageUserFile EnglishLanguage "&%DownloadingNonAudioVideoImageUserFile
is those instances of &%NetworkCommunication in which an &%ComputerFile that isn't an &%AudioFile,
&%MultimediaFile, or &%ImageFile is downloaded to a user's local computer from another &%ComputerSystem
on a network.")

(=>
  (and
    (instance ?ACT DownloadingNonAudioVideoImageUserFile)
    (patient ?ACT ?FILE)
    (instance ?FILE ComputerFile))
  (and
    (not
      (instance ?FILE ImageFile))
    (not
      (instance ?FILE AudioFile))
    (not
      (instance ?FILE MultimediaFile))))

(subclass UploadingOverNetwork NetworkCommunication)
(documentation UploadingOverNetwork EnglishLanguage "&%UploadingOverNetwork is those instances of
&%NetworkCommunication in which a &%DigitalData, such as a &%Computerfile is uploaded from a user's local computer onto
another &%ComputerSystem on a network.")

(=>
  (instance ?ACT UploadingOverNetwork)
  (exists (?DATA ?COM)
    (and
      (patient ?ACT ?DATA)
      (instance ?COM Computer)
      (origin ?ACT ?COM)
      (instance ?DATA DigitalData))))

(subclass UploadingImage UploadingOverNetwork)
(documentation UploadingImage EnglishLanguage "&%UploadingImage is those instances of
&%NetworkCommunication in which a &%ImageFile is uploaded from a user's local computer onto
another &%ComputerSystem on a network.")

(=>
  (instance ?ACT UploadingImage)
  (exists (?FILE)
    (and
      (patient ?ACT ?FILE)
      (instance ?FILE ImageFile))))

(subclass UploadingVideo UploadingOverNetwork)
(documentation UploadingVideo EnglishLanguage "&%UploadingImage is those instances of
&%NetworkCommunication in which an &%AudioVisualFile is uploaded from a user's local
computer onto another &%ComputerSystem on a network.")

(=>
  (instance ?ACT UploadingVideo)
  (exists (?FILE)
    (and
      (patient ?ACT ?FILE)
      (instance ?FILE AudioVisualFile))))

(subclass UploadingAudioFile UploadingOverNetwork)
(documentation UploadingAudioFile EnglishLanguage "&%UploadingAudioFile is those instances of
&%NetworkCommunication in which a non-video &%AudioFile is uploaded from a user's local computer
onto another &%ComputerSystem on a network.")

(=>
  (instance ?ACT UploadingAudioFile)
  (exists (?FILE)
    (and
      (patient ?ACT ?FILE)
      (instance ?FILE AudioFile))))

;; Revised DigitalPost to be a subclass of WebPage instead of DigitalData 1st November 2021
(subclass DigitalPost DigitalData)
(documentation DigitalPost EnglishLanguage "&%DigitalPost is &%WebPage content created
by the users who &%hasAccount on a &%WebSite, intended ( &%HasPurpose) for &%Diseminating.")
(termFormat EnglishLanguage DigitalPost "digital post")

(=>
  (and
    (instance ?P DigitalPost)
    (instance ?A Agent)
    (instance ?W WebSite)
    (component ?P ?W)
    (creator ?A ?P)
    (registeredUser ?A ?W))
  (hasPurpose ?P
    (exists (?D)
      (and
        (instance ?D Disseminating)
        (agent ?D ?A)
        (patient ?D ?P)
        (instrument ?D ?W)))))

(subclass Posting ContentDevelopment)
(subclass Posting NetworkCommunication)
(documentation Posting EnglishLanguage "&%Posting is a &%Process for creating
&%DigitalPosts.")
(termFormat EnglishLanguage Posting "Posting")

(=>
  (instance ?P Posting)
  (exists (?POST)
    (and
      (instance ?POST DigitalPost)
      (result ?P ?POST))))

(subclass DigitalComment DigitalData)
(documentation DigitalComment EnglishLanguage "&%DigitalComments are comments referring 
to a &%DigitalPost.")
(termFormat EnglishLanguage DigitalComment "digital comment")

(=>
  (instance ?COMMENT DigitalComment)
  (exists (?POST)
    (and
      (instance ?POST DigitalPost)
      (refers ?COMMENT ?POST))))
     
(subclass Blog WebSite)
(documentation Blog EnglishLanguage "A &%Blog is a &%WebSite which one or more people can
update with &%DigitalPosts and engaged in &%DigitalComments.")

(subclass Wiki WebSite)
(documentation Wiki EnglishLanguage "A &%Wiki is a &%WebSite whose users can add, modify,
or delete its content via a &%WebBrowser.")

(subclass PostingOnBlog UploadingOverNetwork)
(subclass PostingOnBlog WrittenCommunication)
(documentation PostingOnBlog EnglishLanguage "&%PostingOnBlog is those instances of
&%NetworkCommunication in which a &%ComputerUser updates a %&Blog.")

(=>
  (instance ?ACT PostingOnBlog)
  (exists (?FILE)
    (and
      (patient ?ACT ?FILE)
      (instance ?FILE Blog))))

(subclass DoNetworkMessaging NetworkCommunication)
(documentation DoNetworkMessaging EnglishLanguage "&%DoNetworkMessaging is those instances
of &%NetworkCommunication in which messages are sent back and forth among users .")

(subclass Tweeting DoNetworkMessaging)
(subclass Tweeting WrittenCommunication)
(documentation Tweeting EnglishLanguage "&%Tweeting is those instances of &%DoNetworkMessaging
in which messages of 280 characters or less are sent among users via Twitter (TM).")
; !!! Needs rule

(subclass AudioMessaging DoNetworkMessaging)
(documentation AudioMessaging EnglishLanguage "&%AudioMessaging is those instances of &%DoNetworkMessaging
in which audio messages are sent among users.")

(subclass LiveAudioMessaging AudioMessaging)
(documentation LiveAudioMessaging EnglishLanguage "&%LiveAudioMessaging is those instances of
&%DoNetworkMessaging in which live audio communication is set up among users over a
&%ComputerNetwork.  Some of the users may connect to a live audio messaging session by telephone.")

(subclass LiveVideoMessaging DoNetworkMessaging)
(documentation LiveVideoMessaging EnglishLanguage "&%LiveVideoMessaging is those instances of
&%DoNetworkMessaging in which live audio-video communication is set up among users over a
&%ComputerNetwork.  Some of the users may connect via audio-only communication.")

(subclass WebChatting DoNetworkMessaging)
(subclass WebChatting WrittenCommunication)
(documentation WebChatting EnglishLanguage "&%WebChatting is those instances of &%DoNetworkMessaging
in which text messages are sent across the &%WorldWideWeb among users connected to the &%Website.")

; &%Emailing is defined in Media.kif with one rule
(subclass Emailing DoNetworkMessaging)
(documentation Emailing EnglishLanguage "&%Emailing is the process of sending and receiving emails.
Emailing is a subclass of &%DoNetworkMessaging since the messages are sent over a local, global, or
other network.  The sender normally sends text, but may also send URLs and computer files of any
kind with or without accompanying text.")

(subclass ReceivingEmail Emailing)
(documentation ReceivingEmail EnglishLanguage "&%ReceivingEmail is the process of receiving emails
that have been sent to an email address.")
; !!! Needs rule

(subclass SendingEmail Emailing)
(documentation SendingEmail EnglishLanguage "&%SendingEmail is the process of sending emails.  The
sender normally sends text to one or more email addresses, but may also send URLs and computer
files of any kind with or without accompanying text.")
(disjoint SendingEmail ReceivingEmail)
; !!! Needs rule

(subclass ForwardingEmail SendingEmail)
(documentation ForwardingEmail EnglishLanguage "&%ForwardingEmail is the process of sending received
emails on to other email addresses.  The forwarder may add commentary, but normally includes most,
if not all, of the body of the received email.  The forwarded email may be distinguished in some
way from the forwarder's comments.  Some of the information from the received email's header may
also be included.  The subject line of the forwarded email may have an indicator that it is
forwarded (a leading `Fw:' or 'Fwd' is common in English).")
; !!! Needs rule

(instance webVisitor CaseRole)
(domain webVisitor 1 Agent)
(domain webVisitor 2 WebSite)
(documentation webVisitor EnglishLanguage "A relationship between an &%Agent and
a &%WebSite, stating that the agent has visited the site.")

(=>
  (webVisitor ?A ?WS)
  (exists (?AWS ?WP)
    (and
      (instance ?AWS AccessingWebPage)
      (instance ?WP WebPage)
      (component ?WP ?WS)
      (agent ?AWS ?A)
      (patient ?AWS ?WP))))

(instance grossMerchandiseBoughtInPeriod QuaternaryPredicate)
(domain grossMerchandiseBoughtInPeriod 1 Agent)
(domain grossMerchandiseBoughtInPeriod 2 Organization)
(domain grossMerchandiseBoughtInPeriod 3 CurrencyMeasure)
(domain grossMerchandiseBoughtInPeriod 4 TimeInterval)

(documentation grossMerchandiseBoughtInPeriod EnglishLanguage "The total &%monetaryValue
of all mechandise bought by a given &%Agent from an &%Organization in a particular
&%TimeInterval.")
(termFormat EnglishLanguage grossMerchandiseBoughtInPeriod "GMB")

(=>
  (grossMerchandiseBoughtInPeriod ?A ?O ?CM ?TP)
  (and
    (monetaryValue ?CI ?CM)
    (instance ?CI 
      (KappaFn ?COL
        (and
          (instance ?B Buying)
          (instance ?ITEM ?COL)
          (agent ?B ?A)
          (patient ?B ?ITEM)
          (patient ?B ?O)
          (during ?B ?TP))))))

(documentation grossMerchandiseSoldInPeriod EnglishLanguage "The total &%monetaryValue
of all mechandise sold by a given &%Agent through an &%Organization in a particular
&%TimeInterval.")
(termFormat EnglishLanguage grossMerchandiseSoldInPeriod "GMV")
(instance grossMerchandiseSoldInPeriod QuaternaryPredicate)
(domain grossMerchandiseSoldInPeriod 1 Agent)
(domain grossMerchandiseSoldInPeriod 2 Organization)
(domain grossMerchandiseSoldInPeriod 3 CurrencyMeasure)
(domain grossMerchandiseSoldInPeriod 4 TimeInterval)

(=>
  (grossMerchandiseSoldInPeriod ?A ?O ?CM ?TP)
  (and
    (monetaryValue ?CI ?CM)
    (instance ?CI 
      (KappaFn ?COL
        (and
          (instance ?S Selling)
          (instance ?ITEM ?COL)
          (agent ?S ?A)
          (patient ?S ?ITEM)
          (patient ?S ?O)
          (during ?S ?TP))))))

(subclass LiveTestUpdate Text)
(termFormat EnglishLanguage LiveTestUpdate "LTU")
(documentation LiveTestUpdate EnglishLanguage "A report of an eBay experiment.
This used to be a live report as an experiment was occurring, but the historical
name has been kept, even though it now denotes a report after conclusion of the
test.")