Projects/Oxygen/namingSpec/devices: Difference between revisions

From KDE TechBase
(Techbasification of an improved oxygen-naming-devices-1.3.txt.)
 
(KDE 3 names for all of devices, yay!)
 
(46 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<pre>
== Specification compliance of icon names ==
---
Concrete renaming suggestions


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


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


  * 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.
</pre>
** 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


== 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.
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.
 
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/.)


<pre>
  camera-video
  camera-video
   The fallback icon for video cameras
   The fallback icon for video cameras
</pre>


drive-optical
== Icons in Tango, but not in the spec ==
  The icon used for optical media drives such as CD and DVD.


media-flash
We don't need to have those, but if we do they should be named this way:
  The fallback icon used for flash media, such as memory stick
  and SD.


  media-tape
<pre>
   The icon used for generic physical tape media.
  media-zip
   The icon for Iomega Zip media.
</pre>


modem
== Summary of the suggested additions ==
  The icon used for modem devices.


multimedia-player
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 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.
 
 
---
Icons that are neither in the spec nor in Oxygen's devices/
(after renaming) but still should be added to both.
 
media-optical-video
  The icon used for physical optical media such as CD and DVD
  containing video content.
 
 
---
Don't know what to do with...
 
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.
 
 
---
Summary of the suggested additions to the icon naming specification
 
The ones marked with **, in a shorter list for a better overview.
Including a suggested short description text like needed for
inclusion in the spec.


<pre>
  audio-headset
  audio-headset
   The icon used for handsfree headset devices that combine a pair
   The icon used for handsfree headset devices that combine a pair
Line 131: 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.