Calligra/Icons/Shared icons: Difference between revisions

From KDE Community Wiki
(documentinfo-koffice is done as documentinfo, actually now used is document-properties)
(add icons currently known to miss)
Line 38: Line 38:
| 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]
| 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]
|}
|}


== Actions ==
== Actions ==
Line 52: Line 53:
| 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].
| 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
|-
| 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
|-
| 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
|-
| 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
|-
| 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
|-
| 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
|-
| 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.
|}
== Tool icons ==
{| border="1" cellpadding="5" cellspacing="0"
! name !! KDE3 name !! description
|-
| 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.

Revision as of 10:42, 4 August 2012

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:

View management icons

name KDE3 name description
fit-to-width 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 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 n/a Fit to two pages: Possibly we could also have a "fit to two pages"
fit-1-to-1 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 grid Show grid: a switch - shows or hides grid helper within the document view. png


Actions

name KDE3 name description
insert-table-row 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. png

Additional note: In case of Kexi, the action is not the same as "start editing a new row" (current Kexi icon, MS Access icon), but has largely the same meaning as in spreadsheets - for example it is used in design mode of the Table Designer (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:
File:Icons-KOffice wide icons-dialog-no.png
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. (Jstaniek 14:02, 31 October 2008 (PDT))
Source code using the icon: [1].


Chart Types

name KDE3 name description
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
music-clef-bass
music-clef-alto
music-clef-trebble
music-clef
musicflake/musicshape icon for the Music Shape


Formula Symbols

name KDE3 name description
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 plugins/formulashape/pics/hicolor/


Layer Actions

name KDE3 name description
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
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

name KDE3 name description
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.


Tool icons

name KDE3 name description
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.