Calligra/Icons/Shared icons: Difference between revisions

From KDE Community Wiki
No edit summary
 
(17 intermediate revisions by 3 users not shown)
Line 1: Line 1:
On this page we collect descriptions of the icons we need for KOffice. Rather than showing pictures of icons we describe the functionality they provide.
On this page we collect descriptions of the icons we need for Calligra. Rather than showing pictures of icons we describe the functionality they provide.


The icons are grouped in sections so they are easier to find. When adding new please consider which group to add them to, and possibly create a new group.
The icons are grouped in sections so they are easier to find. When adding new please consider which group to add them to, and possibly create a new group.


Only requirement is that they will be used by more than one KOffice application.
Only requirement is that they will be used by more than one Calligra application.


'''See also:'''
'''List currently unmaintained''', needs to be picked up once work in [[Calligra/Icons/3.0]] is done.
* [http://websvn.kde.org/*checkout*/trunk/playground/artwork/Oxygen/docs/koffice-icons.ods ODS file of KOffice icons sheet]
* [http://websvn.kde.org/trunk/koffice/pics/hicolor/ SVN repository of old KOffice-wide icons]
* [http://techbase.kde.org/Projects/Oxygen/namingSpec Oxygen naming specs]
* [http://kexi-project.org/wiki/wikiview/index.php?UIDesignIcons_Specs Kexi icons naming prepared for migrating to Oxygen]
* [http://websvn.kde.org/*checkout*/trunk/playground/artwork/Oxygen/docs/icons.ods ODS file of KDE icons]; use as inspiration for the formatting here


__TOC__
__TOC__


== View management icons ==
== Chart Types ==
{| border="1" cellpadding="5" cellspacing="0"
{| border="1" cellpadding="5" cellspacing="0"
! name !! KDE3 name !! description
! name !! KDE3 name !! description || Assigned To
|-
|-
| fit-to-width
| office-chart-surface
| view_fit_width
|
|Fit to width: This mode automatically adjusts the zoom so the width of the page/canvas is always entirely visible.
|
|  
|-
|-
| fit-to-page
| office-chart-bubble
| view_fit_window
|
|Fit to page: This mode automatically adjusts the zoom so the page/canvas is always entirely visible in the view.
|  
|  
|-
|-
| fit-to-2-pages
| office-chart-gantt
| n/a
|
|Fit to two pages: Possibly we could also have a "fit to two pages"
|  
|  
|-
|-
| fit-1-to-1
| office-chart-stock
| n/a
|
|Actual pixels: In this mode (for paint applications only) pixels are shown 1 to 1 on screen. This is not the same as 100%.
|
|  
|-
|-
| grid
| office-chart-polar-filled
| grid
|
| Show grid: a switch - shows or hides grid helper within the document view. [http://websvn.kde.org/*checkout*/trunk/koffice/pics/hicolor/hi32-action-grid.png png]
|
|  
|}
|}


=== Tools ===
There is already a nice set of chart icons, but the types above are not yet included. Ideally the same artist does the missing one. All existing icons are part of Oxygen icon set, see office-chart-*
 
 
== clef Types (+ icon for shape) ==
{| border="1" cellpadding="5" cellspacing="0"
{| border="1" cellpadding="5" cellspacing="0"
! name !! KDE3 name !! description
! name !! KDE3 name !! description || Assigned To
|-
|-
|mouse-pointer
| music-clef-bass
|mouse_pointer
|
|An icon for the selection tool to provide selection and rotation and other general interaction features to be used. [http://websvn.kde.org/*checkout*/trunk/koffice/kexi/pics/hi22-action-mouse_pointer.png png]
|
|  yuri
|-
| music-clef-alto
|
|
| yuri
|-
|-
|tool-pan
| music-clef-trebble
|tool_pan
|
|An icon for the pan tool which allows the user to 'grab' the canvas and move it.  [http://websvn.kde.org/*checkout*/trunk/koffice/krita/plugins/tools/defaulttools/tool_pan.png png]
|
| yuri
|-
|-
|tool-connect
| music-clef
|kivio_connector
|
|An icon for the tool that allows you to connect different objects using a connection line. The connection can be straight or exist of curves. [http://websvn.kde.org/*checkout*/trunk/koffice/kivio/plugins/kivioconnectortool/hi22-action-kivio_connector.png png]
|
| yuri
|-
| musicflake/musicshape
|  
| icon for the Music Shape
|
|}
|}


=== Positioning ===
== Layer Actions ==
{| border="1" cellpadding="5" cellspacing="0"
{| border="1" cellpadding="5" cellspacing="0"
! name !! KDE3 name !! description
! name !! KDE3 name !! description || Assigned To
|-
|-
|align-right
| layer-new
|aoright
|
|All the selected objects' positions will be moved to align to the position of the rightmost object's right edge. [http://websvn.kde.org/*checkout*/trunk/koffice/kexi/pics/hi22-action-aoright.png png]
| for the action to create a new layer (layer as in: layer in a stack of layers of a document, where each layer contains a group of objects, like a pixmap)
Krita has a "newlayer" icon (krita/pics/newlayer.png) which is similar to an empty document. Other than that there are no icons with a symbol for a layer yet.
|
|-
|-
| align-left
| layer-duplicate
| aoleft
|
| All the selected objects' left positions will be moved to the position of th leftmost object's left edge. [http://websvn.kde.org/*checkout*/trunk/koffice/kexi/pics/hi22-action-aoleft.png png]
|used in the context menu on a layer in the "Layers" docker of Krita, for the action "Duplicate Layer or Mask". Or rather do a generic "edit-duplicate" icon?
|
|-
|-
| align-top
| layer-merge
| aotop
|
| All the selected objects' top positions will be moved to the position of the uppermost object's upper edge. [http://websvn.kde.org/*checkout*/trunk/koffice/kexi/pics/hi22-action-aotop.png png]
| used in the context menu on a layer in the "Layers" docker of Krita, for the action "Merge with Layer Below". Or rather do a generic "edit-merge" icon?
|-
|
| align-bottom
| aobottom
| All the selected objects' bottom positions will be moved to the position of the bottommost object's bottom edge. [http://websvn.kde.org/*checkout*/trunk/koffice/kexi/pics/hi22-action-aobottom.png png]
|-
| align-to-grid
| aopos2grid
| All the selected objects' top-left corners will be moved so that they are positioned in the nearest grid point. [http://websvn.kde.org/*checkout*/trunk/koffice/kexi/pics/hi22-action-aopos2grid.png png]
|-
| align-objects
| alignobjs
| An icon describing a group of actions related to objects aligning. [http://websvn.kde.org/*checkout*/trunk/koffice/kexi/pics/hi22-action-alignobjs.png png]
|-
| raise
| raise
| An icon indicating the feature to alter the selected object to come forward one level.  This feature alters the z-index.  In KWord; raise-frame. [http://websvn.kde.org/*checkout*/trunk/koffice/pics/hicolor/hi22-action-raise.png png]
|-
| lower
| lower
| An icon indicating the feature to alter the selected object to go backward one level.  This feature alters the z-index.  In KWord; lower-frame. [http://websvn.kde.org/*checkout*/trunk/koffice/pics/hicolor/hi22-action-lower.png png]
|-
| bring-forward
| bring_forward
| An icon indicating the feature to alter the selected object to come forward to the top.  This feature alters the z-level.  In KWord; Bring to Front. [http://websvn.kde.org/*checkout*/trunk/koffice/pics/hicolor/hi22-action-bring_forward.png png]
|-
| send-backward
| send_backward
| An icon indicating the feature to alter the selected object to go completely to the back.  This feature alters the z-level.  In KWord; Send to Back. [http://websvn.kde.org/*checkout*/trunk/koffice/pics/hicolor/hi22-action-send_backward.png png]
|}
|}


== Actions ==
 
== Guides Insertor Options ==
{| border="1" cellpadding="5" cellspacing="0"
{| border="1" cellpadding="5" cellspacing="0"
! name !! KDE3 name !! description
! name !! KDE3 name !! description || Assigned To
|-
|-
| delete-table-row
| add-horizontal-edges
| delete_table_row
|  
| An icon for removing row from a table, e.g. a table currently selected row(s) in KWord, a whole row(s) in a spreadsheet, a database row(s) (record(s) ) in Kexi's tabular or form data view. [http://websvn.kde.org/*checkout*/trunk/koffice/pics/hicolor/hi22-action-delete_table_row.png png]
| Used in checkbox of the Guides Tool to control if guidelines should be added at the horizontal borders of the current page
|
|-
|-
| insert-table-row
| add-vertical-edges
| insert_table_row
|  
| An icon for inserting a new (empty) row into a table at current selection, e.g. a table row in KWord, a whole row in a spreadsheet, a whole row in Kexi's tabular view. [http://websvn.kde.org/*checkout*/trunk/koffice/pics/hicolor/hi22-action-insert_table_row.png png]<br/>
| Used in checkbox of the Guides Tool to control if guidelines should be added at the vertical borders of the current page
Additional note: In case of Kexi, the action '''is not the same''' as "start editing a new row" ([http://kexi-project.org/pics/icons/add_new.png current Kexi icon], [http://kexi-project.org/pics/msa/icons/msa_addnew.png MS Access icon]), but has largely the same meaning as in spreadsheets - for example it is used in design mode of the Table Designer ([http://kexi-project.org/pics/1.1/image_box_object_datatype.png screenshot]).
|
|-
| dialog-no
| button_no
| A gdash '-' icon being a pair for dialog-ok (blue 'v' icon). Used in places like the property editor for 3-state mode, where yes/no/unknown states are provided. Currently the icon is drawn as a gray dash:<br/>[[Image:Icons-KOffice_wide_icons-dialog-no.png]]<br/>It is recommended to use a neutral color and not red. In particular we did not decide to use dialog-cancel (/) or red 'x' to avoid suggestion that the selection as about deleting an item. ([[User:Jstaniek|Jstaniek]] 14:02, 31 October 2008 (PDT))<br/>Source code using the icon: [http://websvn.kde.org/trunk/koffice/kexi/koproperty2/editors/booledit.cpp].
|}
|}


== Mimetypes ==
The Oxygen icon set has "snap-guideline" and "edit-guides" as design reference.
 
 
== Tool icons ==
{| border="1" cellpadding="5" cellspacing="0"
{| border="1" cellpadding="5" cellspacing="0"
! name !! KDE3 name !! description
! name !! KDE3 name !! description || Assigned To
|-
|-
|mimetype-opendocument-encrypted
| tool_formula_edit
|
| is now "text", should be a sigma or something
|
|
|A mimetype-icon to show the file is an encrypted opendocument file. Also needed for embedding into these documents as preview. Possibly this icon can be used KDE-wide as well [http://websvn.kde.org/*checkout*/trunk/KDE/kdeartwork/IconThemes/kdeclassic/48x48/mimetypes/encrypted.png png]
|-
|-
| application-vnd.oasis.opendocument.database
| tool_pagelayout
| ?
|
| Icon for ODF database files (not kexi native)
| a symbol for (the tool for) the basic layout of a document page/slide
Seen Calligra Words in the title bar of the tool view "Page layout".
No idea from where the icon could be derived.
|
|-
|-
| application-vnd.oasis.opendocument.chart
| tool_references
| ?
|
| Icon for ODF charts.
| a symbol for (the tool for) everything related to refering other texts (footnotes, literature, citation).
Seen e.g. in Calligra Words in the title bar of the tool view "References",
No real idea here where to take symbolism from for the icon.
|
|-
|-
| application-vnd.oasis.opendocument.formula
| tool_review
| ?
|
| Icon for ODF formulas.
| for the review tool. Currently not available in the UI
|
|-
|-
| application-vnd.oasis.opendocument.graphics
| commentTool
| ?
|
| Icon for ODF vector graphics.
| No idea how and where to create comment shapes and thus how to see the comment tool. So no idea what is needed here as icon.
|-
Comment related icons are in Oxygen none, in Calligra:
| application-vnd.oasis.opendocument.image
* sheets/data/toolbar/hicolor/hi16-action-comment.png
| ?
* sheets/data/toolbar/hicolor/hi16-action-removecomment.png
| Icon for ODF raster images.
* flow/stencils/SDL/comment.png
|-
|
| application-vnd.oasis.opendocument.presentation
| ?
| Icon for ODF presentations.
|-
| application-vnd.oasis.opendocument.spreadsheet
| ?
| Icon for ODF spreadsheets.
|-
| application-vnd.oasis.opendocument.text
| ?
| Icon for ODF text documents.
|-
| odf
| ?
| Icon for other ODF based files.
|}
|}


== Other ==
The icons tool_pagelayout, tool_references, and tool_review are used together with the icon of the text tool, so ideally have a consistent look.
{| border="1" cellpadding="5" cellspacing="0"
! name !! KDE3 name !! description
|-
| documentinfo-koffice
| ?
| Icon used to show the action to that pops up a dialog for various document-specific meta data.
|}

Latest revision as of 23:52, 13 November 2015

On this page we collect descriptions of the icons we need for Calligra. Rather than showing pictures of icons we describe the functionality they provide.

The icons are grouped in sections so they are easier to find. When adding new please consider which group to add them to, and possibly create a new group.

Only requirement is that they will be used by more than one Calligra application.

List currently unmaintained, needs to be picked up once work in Calligra/Icons/3.0 is done.

Chart Types

name KDE3 name description Assigned To
office-chart-surface
office-chart-bubble
office-chart-gantt
office-chart-stock
office-chart-polar-filled

There is already a nice set of chart icons, but the types above are not yet included. Ideally the same artist does the missing one. All existing icons are part of Oxygen icon set, see office-chart-*


clef Types (+ icon for shape)

name KDE3 name description Assigned To
music-clef-bass yuri
music-clef-alto yuri
music-clef-trebble yuri
music-clef yuri
musicflake/musicshape icon for the Music Shape

Layer Actions

name KDE3 name description Assigned To
layer-new for the action to create a new layer (layer as in: layer in a stack of layers of a document, where each layer contains a group of objects, like a pixmap)

Krita has a "newlayer" icon (krita/pics/newlayer.png) which is similar to an empty document. Other than that there are no icons with a symbol for a layer yet.

layer-duplicate used in the context menu on a layer in the "Layers" docker of Krita, for the action "Duplicate Layer or Mask". Or rather do a generic "edit-duplicate" icon?
layer-merge used in the context menu on a layer in the "Layers" docker of Krita, for the action "Merge with Layer Below". Or rather do a generic "edit-merge" icon?


Guides Insertor Options

name KDE3 name description Assigned To
add-horizontal-edges Used in checkbox of the Guides Tool to control if guidelines should be added at the horizontal borders of the current page
add-vertical-edges Used in checkbox of the Guides Tool to control if guidelines should be added at the vertical borders of the current page

The Oxygen icon set has "snap-guideline" and "edit-guides" as design reference.


Tool icons

name KDE3 name description Assigned To
tool_formula_edit is now "text", should be a sigma or something
tool_pagelayout a symbol for (the tool for) the basic layout of a document page/slide

Seen Calligra Words in the title bar of the tool view "Page layout". No idea from where the icon could be derived.

tool_references a symbol for (the tool for) everything related to refering other texts (footnotes, literature, citation).

Seen e.g. in Calligra Words in the title bar of the tool view "References", No real idea here where to take symbolism from for the icon.

tool_review for the review tool. Currently not available in the UI
commentTool No idea how and where to create comment shapes and thus how to see the comment tool. So no idea what is needed here as icon.

Comment related icons are in Oxygen none, in Calligra:

  • sheets/data/toolbar/hicolor/hi16-action-comment.png
  • sheets/data/toolbar/hicolor/hi16-action-removecomment.png
  • flow/stencils/SDL/comment.png

The icons tool_pagelayout, tool_references, and tool_review are used together with the icon of the text tool, so ideally have a consistent look.