View source for Calligra/Icons/Shared icons

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.

'''See also:'''
* [http://websvn.kde.org/*checkout*/trunk/playground/artwork/Oxygen/docs/calligra-icons.ods ODS file of Calligra icons sheet] (seems out-dated)
* [https://projects.kde.org/projects/calligra/repository/revisions/master/show/pics/hicolor directory in git repository of old Calligra-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__

==  View management icons ==
{| border="1" cellpadding="5" cellspacing="0"
! name !! KDE3 name !! description || Assigned To
|-
| fit-to-2-pages
| n/a
|Fit to two pages: Possibly we could also have a "fit to two pages"
|
|}

== Actions ==
{| border="1" cellpadding="5" cellspacing="0"
! name !! KDE3 name !! description || Assigned To
|-
| 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].
|
|}

== Chart Types ==
{| border="1" cellpadding="5" cellspacing="0"
! 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) ==
{| border="1" cellpadding="5" cellspacing="0"
! name !! KDE3 name !! description || Assigned To
|-
| music-clef-bass
| 
|
| 
|-
| music-clef-alto
|
| 
| 
|-
| music-clef-trebble
| 
|
| 
|-
| music-clef
| 
|
| 
|-
| musicflake/musicshape
| 
| icon for the Music Shape
|
|}


== Formula Symbols ==
{| border="1" cellpadding="5" cellspacing="0"
! name !! KDE3 name !! description || Assigned To
|-
| vector
| 
|
| 
|-
| root
|
| 
| 
|-
| bevelled
| 
|
| 
|-
| rsubup
| 
|
| 
|-
| gsubup
|
| 
| 
|-
| enclosed
|
| 
| 
|}

From what I can tell after my research these icons have never existed. A request to the original author of the code using these icon names has not got an answer yet (see email "Missing icons in the formula shape" from July 10th 2012 on calligra-devel)
Other formula icons are in [https://projects.kde.org/projects/calligra/repository/revisions/master/show/plugins/formulashape/pics/hicolor plugins/formulashape/pics/hicolor/]


== Layer Actions ==
{| border="1" cellpadding="5" cellspacing="0"
! 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 ==
{| border="1" cellpadding="5" cellspacing="0"
! 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.


== Snap to Boundingbox ==
{| border="1" cellpadding="5" cellspacing="0"
! name !! KDE3 name !! description || Assigned To
|-
| snap-boundingbox
|
| Used in a checkbox to control if bounding boxes of objects should be used as guidelines to snap to.
Used in all option widgets where snapping is configured, e,g. in Calligra 
Words at the bottom of the "Basic shape manipulation" tool view.

Calligra has icons for all the snap options in libs/flake/pics/ox16-action-snap-*.png which are copies from the Oxygen iconset.
In Oxygen the SVG versions can be found in the "small" subset, e.g. for the 16x16 variants in http://websvn.kde.org/trunk/kdesupport/oxygen-icons/scalable/actions/small/16x16/snap-*.svgz

No idea where a bounding box is already part of a icon, so the presentation 
could be consistently reused. Also no idea how to design the icon.
| Animtim
|}

== Tool icons ==
{| border="1" cellpadding="5" cellspacing="0"
! 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 e.g. in 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.