Projects/Oxygen/namingSpec/devices: Difference between revisions

From KDE TechBase
(Whoa, David also added the generic multimedia player. Cool stuff, man.)
(KDE 3 names for all of devices, yay!)
 
(39 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)
  battery                 OK
  camera-photo                  OK (KDE 3 names:
  camera-unmount          -> camera-photo
                                  camera_unmount, camera)
  cdaudio-unmount        -> media-optical-audio **
camera-video                  Needed
  cdwriter-unmount        -> media-optical-recordable **
camera-web                    OK (Not yet in 0.8 of the spec,
  cellular-phone-unmount  -> phone
                                  only in CVS.)
cpu                    ??
  cpu                          OK ** (did not exist in KDE 3 - right?)
  drive-optical           -> media-optical
computer                      OK (KDE 3 name: system)
  dvd-unmount            -> svn rm, as media should be represented
  computer-laptop              OK ** (KDE 3 name: laptop)
                            by their contents, not their disc format.
  drive-harddisk                OK (KDE 3 name: hdd_unmount)
  hdd-external-unmount    -> drive-removable-media
  drive-optical                 OK (did not exist in KDE 3)
hdd-unmount            -> drive-harddisk
  drive-removable-media         OK (did not exist in KDE 3)
  hdd-usb-unmount        -> drive-removable-media-usb ***
  drive-removable-media-usb    OK ** (did not exist in KDE 3)
ipod-unmount            -> multimedia-player-ipod
  drive-removable-media-usb-pendrive  OK **
  joystick                -> input-gaming
                                  (KDE 3 name: usbpendrive_unmount)
  keyboard                -> input-keyboard
  input-gaming                 OK (KDE 3 name: joystick)
  laptop                  -> computer-laptop **
  input-keyboard                OK (KDE 3 name: keyboard)
  memory-stick-unmount    -> media-flash-memory-stick ***
input-mouse                  OK (KDE 3 name: mouse)
  modem                  OK
input-tablet                  OK (KDE 3 name: tablet)
mouse                  -> input-mouse
  media-flash                  OK (did not exist in KDE 3)
multimedia-player      OK
  media-flash-memory-stick     OK ** (KDE 3 name: memory_stick_unmount)
  nfs-unmount            -> drive-remote **
  media-flash-sd-mmc            OK ** (KDE 3 name: sd_mmc_unmount)
  printer                OK
  media-flash-smart-media      OK ** (KDE 3 name: smart_media_unmount)
  projector              -> video-projector **
  media-floppy                  OK (KDE 3 name: 3floppy_unmount)
scanner                 OK
  media-optical                 OK (KDE 3 name: cdrom_unmount)
  screen                  -> video-display
  media-optical-audio          -> svn rm, and replace with a
  sd-mmc-unmount          -> media-flash-sd-mmc ***
                                  combination of media-optical
  smart-media-unmount    -> media-flash-smart-media ***
                                  and emblem-audio
  system                  -> computer
                                  (KDE 3 name: cdaudio_unmount)
  tablet                  -> input-tablet
  media-optical-recordable      OK ** (KDE 3 name: cdwriter_unmount)
  usbpendrive-unmount    -> drive-removable-media-usb-pendrive ***
  media-tape                    OK (KDE 3 name: mo_unmount)
  video-television       OK **
modem                        OK (did not exist in KDE 3 - right?)
webcam                  -> camera-web
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 57: Line 63:


<pre>
<pre>
audio-card
  The icon used for the audio rendering device.
  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.
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 122: 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.
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.