Projects/Oxygen/namingSpec/devices: Difference between revisions

From KDE TechBase
(Have drive-removable-media-usb-pendrive instead of media-flash-usb, as discussed on the list)
(KDE 3 names for all of devices, yay!)
 
(43 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== Concrete renaming suggestions ==
== Specification compliance of icon names ==


Icon names without trailing stars already exist in the freedesktop.org icon naming specification.
Icon names without trailing stars already exist in the freedesktop.org icon naming specification.


<pre>
<pre>
  *-mount                -> svn rm, right now. See below (*)
  audio-card                    OK (did not exist in KDE 3 - right?)
                            for the explanation.
  audio-headset                 OK * (did not exist in KDE 3)
3floppy-unmount        -> media-floppy
  audio-input-line             OK * (did not exist in KDE 3)
  audio-headset           OK **
  audio-input-microphone       OK (did not exist in KDE 3)
  audio-input-line       OK **
  battery                      OK (KDE 3 names: battery,
  audio-input-microphone  OK
                                  apps/laptop_battery)
  camera-unmount          -> camera-photo
  camera-photo                  OK (KDE 3 names:
  cdaudio-unmount        -> media-optical-audio **
                                  camera_unmount, camera)
  cdwriter-unmount        -> media-optical-recordable **
camera-video                  Needed
  cellular-phone-unmount  -> phone
camera-web                    OK (Not yet in 0.8 of the spec,
cpu                    ??
                                  only in CVS.)
  drive-optical           -> media-optical
  cpu                          OK ** (did not exist in KDE 3 - right?)
  dvd-unmount            -> svn rm, as media should be represented
computer                      OK (KDE 3 name: system)
                            by their contents, not their disc format.
  computer-laptop              OK ** (KDE 3 name: laptop)
  hdd-external-unmount    -> drive-removable-media
  drive-harddisk                OK (KDE 3 name: hdd_unmount)
hdd-unmount            -> drive-harddisk
  drive-optical                 OK (did not exist in KDE 3)
  hdd-usb-unmount        -> drive-removable-media-usb ***
  drive-removable-media         OK (did not exist in KDE 3)
ipod-unmount            -> multimedia-player-ipod
  drive-removable-media-usb    OK ** (did not exist in KDE 3)
  joystick                -> input-gaming
  drive-removable-media-usb-pendrive  OK **
  keyboard                -> input-keyboard
                                  (KDE 3 name: usbpendrive_unmount)
  laptop                  -> computer-laptop **
  input-gaming                 OK (KDE 3 name: joystick)
  memory-stick-unmount    -> media-flash-memory-stick ***
  input-keyboard                OK (KDE 3 name: keyboard)
  mouse                  -> input-mouse
input-mouse                  OK (KDE 3 name: mouse)
  nfs-unmount            -> drive-remote **
input-tablet                  OK (KDE 3 name: tablet)
  printer                OK
  media-flash                  OK (did not exist in KDE 3)
  projector              -> video-projector **
  media-flash-memory-stick     OK ** (KDE 3 name: memory_stick_unmount)
scanner                 OK
  media-flash-sd-mmc            OK ** (KDE 3 name: sd_mmc_unmount)
  screen                  -> video-display
  media-flash-smart-media      OK ** (KDE 3 name: smart_media_unmount)
  sd-mmc-unmount          -> media-flash-sd-mmc ***
  media-floppy                  OK (KDE 3 name: 3floppy_unmount)
  smart-media-unmount    -> media-flash-smart-media ***
  media-optical                 OK (KDE 3 name: cdrom_unmount)
  system                  -> computer
  media-optical-audio          -> svn rm, and replace with a
  tablet                  -> input-tablet
                                  combination of media-optical
  usbpendrive-unmount    -> drive-removable-media-usb-pendrive ***
                                  and emblem-audio
  video-television       OK **
                                  (KDE 3 name: cdaudio_unmount)
webcam                  -> camera-web
  media-optical-recordable      OK ** (KDE 3 name: cdwriter_unmount)
  media-tape                    OK (KDE 3 name: mo_unmount)
modem                        OK (did not exist in KDE 3 - right?)
multimedia-player            OK (did not exist in KDE 3)
multimedia-player-apple-ipod  OK ** (KDE 3 name: ipod_unmount)
  network-wired                OK (did not exist in KDE 3)
  network-wireless              OK (did not exist in KDE 3)
pda                          OK (KDE 3 names: pda_black, pda_blue)
phone                        OK (did not exist in KDE 3 - right?)
printer                      OK (KDE 3 names: printer1, printer)
scanner                      OK (KDE 3 name: scanner)
  video-display                OK (did not exist in KDE 3)
video-projector              OK * (did not exist in KDE 3)
  video-television             OK * (KDE 3 name: tv)


  * The specification's way of doing "*-mounted" icons would be
  * suggesting this for inclusion into the icon naming specification
  mount emblems, overlaying the standard ones. Kévin and Aaron
  ** not in the spec, but let's keep it out of there anyways,
  claim to have a solution at hand right now, so let's kill all
    it's not really suited or necessary for it to be in there
  "*-mounted" icons instantly.
** suggesting this for inclusion into the icon naming specification
  *** not in the spec, but let's keep it out of there anyways,
    it's not really suited to be a standard icon
</pre>
</pre>


Line 54: Line 63:


<pre>
<pre>
audio-card
  The icon used for the audio rendering device.
battery
  The icon used for the system battery device.
  (Let's just move actions/battery.svg to devices/.)
  camera-video
  camera-video
   The fallback icon for video cameras
   The fallback icon for video cameras
drive-optical
  The icon used for optical media drives such as CD and DVD.
media-flash
  The fallback icon used for flash media, such as memory stick
  and SD.
media-tape
  The icon used for generic physical tape media.
modem
  The icon used for modem devices.
multimedia-player
  The icon used for generic multimedia playing devices.
network-wired
  The icon used for wired network connections.
network-wireless
  The icon used for wireless network connections.
pda
  This is the fallback icon for Personal Digial Assistant devices.
  Primary use of this icon is for PDA devices connected to the PC.
  Connection medium is not an important aspect of the icon. The
  metaphor for this fallback icon should be a generic
  PDA device icon.
</pre>
</pre>


== Icons in Tango, but not in the spec ==


== To do for Oxygen *and* the spec ==
We don't need to have those, but if we do they should be named this way:
 
Icons that are neither in the spec nor in Oxygen's devices/ (after renaming) but still should be added to both.


<pre>
<pre>
  media-optical-video
  media-zip
   The icon used for physical optical media such as CD and DVD
   The icon for Iomega Zip media.
  containing video content.
</pre>
 
== Don't know what to do with... ==
 
<pre>
cpu
  The specification does not contain any low-level processing
  units, such as CPUs or RAM. I can't think of an appropriate
  "category" name for those. The only word that I found which
  comes close was "internal-*" (internal-cpu, internal-memory, ...)
  but I'm not sure if this consistent with the rest of the
  devices category in the spec and extensible enough.
  Input and better ideas appreciated.
</pre>
</pre>


== Summary of the suggested additions ==
== Summary of the suggested additions ==


The ones marked with ** and should therefore go into the icon naming specification, presented here in a shorter list for a better overview. Including a suggested short description text like needed for inclusion in the spec.
The ones marked with * and should therefore go into the icon naming specification, presented here in a shorter list for a better overview. Including a suggested short description text like needed for inclusion in the spec.


<pre>
<pre>
Line 129: Line 87:
  audio-input-line
  audio-input-line
   The icon used for audio line input devices.
   The icon used for audio line input devices.
media-optical-audio
  The icon used for physical optical media such as CD and DVD
  containing audio content.
media-optical-video
  The icon used for physical optical media such as CD and DVD
  containing video content.
media-optical-recordable
  The icon used for recordable physical optical media,
  such as CD-R and DVD-R.
media-flash-usb
  The icon used for physical USB flash drive media.
computer-laptop
  The icon used for a portable computing device as a whole.
drive-remote
  The icon used for remotely accessed drives, such as
  NFS or WebDAV mounts.


  video-projector
  video-projector

Latest revision as of 18:53, 11 May 2008

Specification compliance of icon names

Icon names without trailing stars already exist in the freedesktop.org icon naming specification.

 audio-card                    OK (did not exist in KDE 3 - right?)
 audio-headset                 OK * (did not exist in KDE 3)
 audio-input-line              OK * (did not exist in KDE 3)
 audio-input-microphone        OK (did not exist in KDE 3)
 battery                       OK (KDE 3 names: battery,
                                   apps/laptop_battery)
 camera-photo                  OK (KDE 3 names:
                                   camera_unmount, camera)
 camera-video                  Needed
 camera-web                    OK (Not yet in 0.8 of the spec,
                                   only in CVS.)
 cpu                           OK ** (did not exist in KDE 3 - right?)
 computer                      OK (KDE 3 name: system)
 computer-laptop               OK ** (KDE 3 name: laptop)
 drive-harddisk                OK (KDE 3 name: hdd_unmount)
 drive-optical                 OK (did not exist in KDE 3)
 drive-removable-media         OK (did not exist in KDE 3)
 drive-removable-media-usb     OK ** (did not exist in KDE 3)
 drive-removable-media-usb-pendrive  OK **
                                  (KDE 3 name: usbpendrive_unmount)
 input-gaming                  OK (KDE 3 name: joystick)
 input-keyboard                OK (KDE 3 name: keyboard)
 input-mouse                   OK (KDE 3 name: mouse)
 input-tablet                  OK (KDE 3 name: tablet)
 media-flash                   OK (did not exist in KDE 3)
 media-flash-memory-stick      OK ** (KDE 3 name: memory_stick_unmount)
 media-flash-sd-mmc            OK ** (KDE 3 name: sd_mmc_unmount)
 media-flash-smart-media       OK ** (KDE 3 name: smart_media_unmount)
 media-floppy                  OK (KDE 3 name: 3floppy_unmount)
 media-optical                 OK (KDE 3 name: cdrom_unmount)
 media-optical-audio           -> svn rm, and replace with a
                                  combination of media-optical
                                  and emblem-audio
                                  (KDE 3 name: cdaudio_unmount)
 media-optical-recordable      OK ** (KDE 3 name: cdwriter_unmount)
 media-tape                    OK (KDE 3 name: mo_unmount)
 modem                         OK (did not exist in KDE 3 - right?)
 multimedia-player             OK (did not exist in KDE 3)
 multimedia-player-apple-ipod  OK ** (KDE 3 name: ipod_unmount)
 network-wired                 OK (did not exist in KDE 3)
 network-wireless              OK (did not exist in KDE 3)
 pda                           OK (KDE 3 names: pda_black, pda_blue)
 phone                         OK (did not exist in KDE 3 - right?)
 printer                       OK (KDE 3 names: printer1, printer)
 scanner                       OK (KDE 3 name: scanner)
 video-display                 OK (did not exist in KDE 3)
 video-projector               OK * (did not exist in KDE 3)
 video-television              OK * (KDE 3 name: tv)

 * suggesting this for inclusion into the icon naming specification
 ** not in the spec, but let's keep it out of there anyways,
    it's not really suited or necessary for it to be in there

To do for Oxygen

Icons that are in the spec, but not yet in Oxygen's devices/ (after renaming) so they need to be added. Descriptions taken from the specification.

 camera-video
   The fallback icon for video cameras

Icons in Tango, but not in the spec

We don't need to have those, but if we do they should be named this way:

 media-zip
   The icon for Iomega Zip media.

Summary of the suggested additions

The ones marked with * and should therefore go into the icon naming specification, presented here in a shorter list for a better overview. Including a suggested short description text like needed for inclusion in the spec.

 audio-headset
   The icon used for handsfree headset devices that combine a pair
   of headphones or earphones with a microphone.

 audio-input-line
   The icon used for audio line input devices.

 video-projector
   The icon used for a projector that video gets displayed to.

 video-television
   The icon used for a television device, such as
   CRT or flat panel displays.