Calligra/Icons/3.0

From KDE Community Wiki

Legend: TODO, DONE, ??

Table related icons

all icons are available at https://share.kde.org/index.php/s/AJ0ELSIjLLfN3Iw for an better overview

Existing table icons in Breeze

edit-table-cell-merge
edit-table-cell-split
edit-table-delete-column
edit-table-delete-row
edit-table-insert-column-left
edit-table-insert-column-right
edit-table-insert-row-above
edit-table-insert-row-below

The naming pattern for action icons (as I understand it):

edit-OBJECT-ACTION(-MATERIAL)

"edit-" as prefix because content is changed. Then there are "format-" icons for changing the style of content. And state icons, though there is slight mix with action icons, as target state is also used with actions.

old name proposed name description state
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-adjustcol.png adjustcol edit-table-column-resize-equal used for both equalize & adapt-to-content currently, should be split ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-adjustcol.png adjustcol edit-table-column-resize-fit see above edit-table-column-resize-fit.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-adjustrow.png adjustrow edit-table-row-resize-equal used for both equalize & adapt-to-content, should be split ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-adjustrow.png adjustrow edit-table-row-resize-fit see above edit-table-row-resize-fit.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-resizecol.png resizecol edit-table-column-resize ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-resizerow.png resizerow edit-table-row-resize ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-hide_table_column.png hide_table_column hide target state used with action, like "layer-visible-*" show and hide should work for that ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-hide_table_row.png hide_table_row hide " ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-show_table_column.png show_table_column show " ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-show_table_row.png show_table_row show " ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-cell_edit.png cell_edit edit-table-cell used to start editing (text) content of cell, "edit" as action seems strange, just "edit-table-cell" also, better idea? edit-rename cause you rename the cell input ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-cell_layout.png cell_layout configure used to start formatting (content of) cell, see also tool_cellformatting. Or "format-table-cell"? ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-insertcell.png insertcell edit-table-insert-cell used to insert single blank cell or multiple ones, incl. full row/column ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-insertcellcopy.png insertcellcopy edit-table-paste-cell for inserting cells from clipboard, moving existing ones to other positions ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-mergecell.png mergecell edit-table-cell-merge seems existing icon is for same usecase ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-mergecell-horizontal.png mergecell-horizontal edit-table-cell-merge-horizontal used to merge all selected cells horizontal only ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-mergecell-vertical.png mergecell-vertical edit-table-cell-merge-vertical used to merge all selected cells vertical only ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-removecell.png removecell edit-table-cell-delete used to remove a complete cell, resulting in other cells moving positions edit-table-cell-delete.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-deletecell.png deletecell edit-table-cell-clear used to blank selected cells from all data and formatting ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-delete_table.png delete_table edit-table-delete used to delete the whole table/spreadsheet ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-dissociatecell.png dissociatecell use edit-table-cell-split ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-selection.png selection edit-table-select-cell used both for selecting single cells and cell ranges, but single item in icon is standard? ?


Kexi has table icons, see below. Do they need different iconic language ?

  • Note (Jstaniek (talk) 07:23, 12 November 2015 (UTC)): Spreadsheets have sheets (strictly speaking); db tables are different especially when it comes to the meaning and behaviour of columns and rows. This of course does not have to be always reflected at the level of icons. Ideally we'd like to have the "Kexi table"-related actions here synced with the new table object's icon of Kexi [1].
  • Note Frinring (talk) 19:06, 13 November 2015 (UTC) I would like to see the "sheet" in "spreadsheet" not emphasized in icons, as spreadsheet-tables can be also embedded in rich-text documents or slides (as normal table), so the "sheet" would be misleading there.

Borders for multiple cells [DONE-1]

old name proposed name description state
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-border_all.png border_all format-border-set-all sets borders on all sides of all selected cells format-border-set-all.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-border_inside.png border_inside format-border-set-internal sets borders only at sides of selected cells where neighbor is not selected format-border-set-internal.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-border_outline.png border_outline format-border-set-external sets borders only at sides where both neighboring cells are selected format-border-set-external.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-border_top.png border_top format-border-set-top sets border only at the top side of the top selected cells format-border-set-top.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-border_bottom.png border_bottom format-border-set-bottom sets border only at the bottom side of the bottom selected cells format-border-set-bottom.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-border_left.png border_left format-border-set-left sets border only at the left side of the left selected cells format-border-set-left.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-border_right.png border_right format-border-set-right sets border only at the right side of the right selected cells format-border-set-right.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-border_horizontal.png border_horizontal format-border-set-internal-horizontal like border_inside, but only horizontal sides format-border-set-internal-horizontal.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-border_vertical.png border_vertical format-border-set-internal-vertical like border_inside, but only verticalal sides format-border-set-internal-vertical.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-border_remove.png border_remove format-border-set-none removes all borders on all sides of all selected cells format-border-set-none.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-border_fall.png border_fall format-border-set-diagonal-tl-br sets diagonal line to all selected cells (topleft-bottomright) format-border-set-diagonal-tl-br.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-border_up.png border_up format-border-set-diagonal-bl-tr sets diagonal line to all selected cells (bottomleft-topright) format-border-set-diagonal-bl-tr.png
?p=calligra.git&a=blob&o=plain&f=pics%2Fhicolor%2F16-actions-borderpainter.png borderpainter format-border-style??? TODO turns mouse to "painter" with current border settings, to format borders by clicking them format-border-style.png

Spreadsheet formatting icons [DONE-4]

old name proposed name description state
TODO - format-text-lowercase turns all chars lower-case format-text-lowercase.png
TODO - format-text-uppercase turns all chars upper-case format-text-uppercase.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-first_letter_upper.png first_letter_upper format-text-capitalize turns first letter of words uppercase format-text-capitalize.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-vertical_text.png vertical_text format-text-direction-vertical letters still horizontal, but lined in a column. not sure if format-text-direction-vertical is also for that? format-text-direction-vertical.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-prec_minus.png prec_minus format-precision-less to decrease precision of number format-precision-less.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-prec_plus.png prec_plus format-precision-more to increase precision of number %20format-precision-more.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-text_top.png text_top format-align-vertical-top needs text variant, blocks of align-vertical-top look strange format-align-vertical-top.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-middle.png middle format-align-vertical-center " format-align-vertical-center.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-text_bottom.png text_bottom format-align-vertical-bottom " format-align-vertical-bottom.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-comment.png comment edit-comment switches to edit the comment (creates one if there is none yet) edit-comment.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-removecomment.png removecomment delete-comment delete delete-comment.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-percent.png percent format-number-percent using a percent char as text does not work, because used as icon in menus format-number-percent.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-money.png money format-currency format-currency.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-funct.png funct insert-math-expression "function" might be bound more to sourcecode insert-math-expression.png
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-series.png series insert-series?? TODO is "series" a term that makes sense outside spreadsheets? TODO
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-multirow.png multirow text-wrap?? TODO "Make the cell text wrap onto multiple lines" TODO

Path editing related icons [DONE]

Breeze has most icons here already. Though it uses the term "node" where "pathpoint" is used in Calligra. And segments (lines between neighbour nodes) are not mentioned at all in icon names. Not sure this can be kept, as 2 icons used refer to action on multiple selected nodes, filtered to those which are neighbours on the path. So for now the names proposed use the term "segment", for "format-segment-curve" and "format-segment-line". Ideas for node-only naming pattern welcome.

old name proposed name description state
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-convert-to-path.png convert-to-path format-convert-to-path converts a shape into nodes-based path object format-convert-to-path.png
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-pathpoint-curve.png pathpoint-curve format-node-curve makes node basepoint of curves format-node-curve.png
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-pathpoint-line.png pathpoint-line format-node-line makes node basepoint of lines format-node-line.png
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-pathsegment-curve.png pathsegment-curve format-segment-curve makes only nodes of path segments basepoints of curves format-segment-curve.png
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-pathsegment-line.png pathsegment-line format-segment-line makes only nodes of path segments basepoints of lines format-segment-line.png
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-pathpoint-insert.png pathpoint-insert format-insert-node not the same as format-add-node, node added on line in middle of two nodes, not appended format-insert-node.png
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-pathpoint-remove.png pathpoint-remove format-remove-node format-remove-node.png
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-pathpoint-join.png pathpoint-join format-connect-node format-connect-node.png
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-pathpoint-merge.png pathpoint-merge format-join-node format-join-node.png
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-path-break-point.png path-break-point format-break-node format-break-node.png
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-path-break-segment.png path-break-segment format-disconnect-node format-disconnect-node.png
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-pathpoint-corner.png pathpoint-corner format-node-corner path can enter and leave at different angles in both directions format-node-corner.png
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-pathpoint-smooth.png pathpoint-smooth format-node-smooth path needs to enter and leave at same angle in both directions format-node-smooth.png
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-pathpoint-symmetric.png pathpoint-symmetric format-node-symmetric like smooth, but curve controls are equal in both directions format-node-symmetric.png

Connection line related icons

Escape directions [DONE]

Shapes can be connected with lines. The lines enter/leave the shapes on a certain side, ideally orthogonal to the surface. It can be controlled on which sides of a shape connection lines can enter/leave.

"escape-direction" is ODF lingo. Are there more common terms for this?

old name proposed name description state
?p=calligra.git&a=blob&o=plain&f=plugins%2FdefaultTools%2Fpics%2F16-actions-escape-direction-all.png escape-direction-all escape-direction-all.png
?p=calligra.git&a=blob&o=plain&f=plugins%2FdefaultTools%2Fpics%2F16-actions-escape-direction-up.png escape-direction-up escape-direction-up.png
?p=calligra.git&a=blob&o=plain&f=plugins%2FdefaultTools%2Fpics%2F16-actions-escape-direction-down.png escape-direction-down escape-direction-down.png
?p=calligra.git&a=blob&o=plain&f=plugins%2FdefaultTools%2Fpics%2F16-actions-escape-direction-left.png escape-direction-left escape-direction-left.png
?p=calligra.git&a=blob&o=plain&f=plugins%2FdefaultTools%2Fpics%2F16-actions-escape-direction-right.png escape-direction-right escape-direction-right.png
?p=calligra.git&a=blob&o=plain&f=plugins%2FdefaultTools%2Fpics%2F16-actions-escape-direction-vertical.png escape-direction-vertical escape-direction-vertical.png
?p=calligra.git&a=blob&o=plain&f=plugins%2FdefaultTools%2Fpics%2F16-actions-escape-direction-horizontal.png escape-direction-horizontal escape-direction-horizontal.png

Connection line types

old name proposed name description state
?p=calligra.git&a=blob&o=plain&f=pics%2Fhicolor%2F16-actions-lines-connector.png lines-connector lines-connector lines-connector.png
?p=calligra.git&a=blob&o=plain&f=pics%2Fhicolor%2F16-actions-curve-connector.png curve-connector curve-connector curve-connector.png
?p=calligra.git&a=blob&o=plain&f=pics%2Fhicolor%2F16-actions-standard-connector.png standard-connector standard-connector standard-connector.png
?p=calligra.git&a=blob&o=plain&f=pics%2Fhicolor%2F16-actions-straight-connector.png straight-connector straight-connector straight-connector.png

Animation related icons

Animation actions

old name proposed name description state
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F32-actions-with_previous.png with_previous animation-start-together used to set an animation to start with another/the one before in list ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F32-actions-after_previous.png after_previous animation-start-after used to set an animation to start after another/the one before in list ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F32-actions-onclick.png onclick animation-start-on-click used to set an animation to start on activation by user (mouse click/touch on it) ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F32-actions-edit_animation.png edit_animation edit-animation used to start editing parameters of an animation ?

Animation types

There is a set of preinstalled animations. User manually (not supported by UI) can add own animation definitions. Each animation is represented by a symbolic icon, either rendered on-the-fly by animation data (like path) or from prerendered icon fetched by iconname.

Animations are organized hierarchical in groups, with 1 or 2 levels, by type, and each group is shown with a symbolic icon as well.

Current top-level categories with pre-installed animations:

  • entrance animations - shape is not part of scene before, is part when animation is done
  • exit animations - shape is part of scene before, no longer part when animation is done
  • move animations - shape is part of scene before and after, possibly different location or parameters changed

There should be another category actually, at least for the "movie_credits_animation" animation:

  • passing animations - shape is not part of scene before and after

Second level: the type of motion and deformation, like zooming, flying, falling, etc.

Third level (for some): subtype with variants of parameters, like direction of flight, origin/target of move or speed.

Existing icons are done as expected for the first and second level, with one icon per type (some missing). Examples: "entrance_animations" for 1st level and "fly_in_animation" for 2nd level. There are some icons reused for 2nd-level types across 1st-level groups, like "zoom_animation".

For the 3rd level though icons are reused across the groups as created by the upper levels. They refer generically to the parameter variant, like "horizontal"/"vertical" or "in"/"out". Example: "horizontal_animations". Many icons missing.

Approach with parameter-type-style icons for subtypes/3rd level surely makes sense, using combination of 2 icons avoids explicit icons for any possible animation type. Possibly sometimes even existing action icons could be used here, as animation aspect is not needed in the 3rd-level icon itself.

Proposal:

Naming pattern "animation-1STLEVELTYPE-2NDLEVELTYPE", to make use of fallback to less specific icon names if present. Example: "animation-in-funkyfunky" would have "animation-in" as fallback. And "animation-color" would have "animation" as fallback. So no longer reusing icons across different 1st-level categories. That should allow to use the 2nd-level icon as single icon in lists of applied animations (assuming 3rd-level as detail to be ignorable iconically).

1st-level icons

old name proposed name description state
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-entrance_animations.png entrance_animations animation-in shape enters the scene from outside and stays once done ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-motion_path_animations.png motion_path_animations animation-move shape moves by a given path ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-exit_animations.png exit_animations animation-out shape leaves the scene and is now longer present once done ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-emphasis_animations.png emphasis_animations animation-emphasis none preinstalled right now, shape possibly somehow highlighted ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-custom_animations.png custom_animations animation-other none preinstalled right now, "other" possibly better than "custom" ?

2nd-level type icons

old name proposed name description state
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-appear_animation.png appear_animation animation-in-appear instant appear ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-bounce_animation.png bounce_animation - unused it seems ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-collapse_animation.png collapse_animation animation-out-collapse ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-disappear_animation.png disappear_animation animation-out-disappear instant disappear ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-falling_in_animation.png falling_in_animation animation-in-fall shaky-fly in ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-fly_in_animation.png fly_in_animation animation-in-fly ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-fly_in_slow_animation.png fly_in_slow_animation animation-in-fly-slow 2 fly-in speeds predefined, thus another symbol needed ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-fly_out_animation.png fly_out_animation animation-out-fly ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-crawl_out_animation.png crawl_out_animation animation-out-fly-slow ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-spiral_in_animation.png spiral_in_animation animation-in-spiral ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-spiral_out_animation.png spiral_out_animation animation-out-spiral ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-stretchy_animation.png stretchy_animation animation-in-stretch ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-swish_animation.png swish_animation animation-out-swish ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-thread_animation.png thread_animation animation-in-thread ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-swivel_animation.png swivel_animation animation-in-swivel used for both in and out ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-swivel_animation.png swivel_animation animation-out-swivel " ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-flash_once_animation.png flash_once_animation animation-in-flash used for both in and out ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-flash_once_animation.png flash_once_animation animation-out-flash " ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-zoom_animation.png zoom_animation animation-in-zoom used for both in and out ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-zoom_animation.png zoom_animation animation-out-zoom " ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-movie_credits_animation.png movie_credits_animation animation-pass-movie-credits ?

Fallback icon for animations without matching icon

old name proposed name description state
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F32-actions-unrecognized_animation.png unrecognized_animation animation used as generic symbol icon for animation ?

3rd-level subtypes

old name proposed name description state
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-horizontal_animations.png horizontal_animations transform-move-horizontal not sure if "transform-move-" is good group ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-vertical_animations.png vertical_animations transform-move-vertical " ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-in_animations.png in_animations transform-move-in " ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2Fanimations%2F64-actions-out_animations.png out_animations transform-move-out " ?

Text editing icons

old name proposed name description state
- - text-wrap splits two text sections into two, uses "split" ATM text-wrap.png
?p=calligra.git&a=blob&o=plain&f=pics%2Fhicolor%2F32-actions-insert-pagebreak.png insert-pagebreak insert-page-break insert-page-break.png
?p=calligra.git&a=blob&o=plain&f=pics%2Fhicolor%2F32-actions-insert-tableofcontents.png insert-tableofcontents insert-table-of-contents naming would match "view-table-of-contents" insert-table-of-contents.png

Presentation tool icons

The "pen" icon is also used for the cursor. Breeze cursor theme has a pencil . Qt::CursorShape has no pencil variant. How to check if there is a themed cursor variant (and how to get it), before setting own hardcoded icon? KCursor (QCursor subclass) of kdelibs4 was able to search by string for further themed cursors, but lost that in KF5 for unknown reason.

old name proposed name description state
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2F16-actions-black.png black pause-to-black-screen used to temporarily turn off the presentation, next to black screen also white screen one day ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpics%2F16-actions-highlight.png highlight highlight-pointer-spot something about turning to mode where mouse is a spot, to highlight things on screen ?

Shape icons

  • inconsistent naming pattern
  • are objects, not actions (few are mimetype icons already), should be rather colored like file type/mimetype
  • those for fixed shape look (flower) should reflect look instead of being iconic
old name proposed name description state
?p=calligra.git&a=blob&o=plain&f=plugins%2Fpathshapes%2Fpics%2F22-actions-callout-shape.png callout-shape draw-callout draw-callout.png
?p=calligra.git&a=blob&o=plain&f=plugins%2Fpathshapes%2Fpics%2F22-actions-circular-arrow-shape.png circular-arrow-shape draw-circular-arrow draw-circular-arrow.png
?p=calligra.git&a=blob&o=plain&f=plugins%2Fpathshapes%2Fpics%2F22-actions-cross-shape.png cross-shape draw-cross draw-cross-shape.png
?p=calligra.git&a=blob&o=plain&f=plugins%2Fpathshapes%2Fpics%2F22-actions-ellipse-shape.png ellipse-shape draw-ellipse draw-ellipse-shape.png
?p=calligra.git&a=blob&o=plain&f=plugins%2Fpathshapes%2Fpics%2F22-actions-flower-shape.png flower-shape draw-flower draw-flower-shape.png
?p=calligra.git&a=blob&o=plain&f=plugins%2Fpathshapes%2Fpics%2F22-actions-gearhead-shape.png gearhead-shape draw-gearhead draw-gearhead-shape.png
?p=calligra.git&a=blob&o=plain&f=plugins%2Fpathshapes%2Fpics%2F22-actions-hexagon-shape.png hexagon-shape draw-hexagon draw-hexagon-shape.png
?p=calligra.git&a=blob&o=plain&f=plugins%2Fpathshapes%2Fpics%2F22-actions-pentagon-shape.png pentagon-shape draw-pentagon draw-pentagon-shape.png
?p=calligra.git&a=blob&o=plain&f=plugins%2Fpathshapes%2Fpics%2F22-actions-rectangle-shape.png rectangle-shape draw-rectangle draw-rectangle-shape.png
?p=calligra.git&a=blob&o=plain&f=plugins%2Fpathshapes%2Fpics%2F22-actions-smiley-shape.png smiley-shape draw-smiley draw-smiley-shape.png
?p=calligra.git&a=blob&o=plain&f=plugins%2Fpathshapes%2Fpics%2F22-actions-spiral-shape.png spiral-shape draw-spiral draw-spiral-shape.png
?p=calligra.git&a=blob&o=plain&f=plugins%2Fpathshapes%2Fpics%2F22-actions-star-shape.png star-shape draw-star draw-star-shape.png
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-pathshape.png pathshape draw-path draw-pathshape.png
?p=calligra.git&a=blob&o=plain&f=pics%2Fhicolor%2F32-mimetypes-x-shape-connection.png x-shape-connection ? ?
?p=calligra.git&a=blob&o=plain&f=plugins%2Fformulashape%2Fpics%2F32-mimetypes-x-shape-formula.png x-shape-formula ? ?
?p=calligra.git&a=blob&o=plain&f=pics%2Fhicolor%2F32-mimetypes-x-shape-image.png x-shape-image ? ?
?p=calligra.git&a=blob&o=plain&f=pics%2Fhicolor%2F32-mimetypes-x-shape-text.png x-shape-text ? ?
- x-shape-text-artistic ? ?
- x-shape-vectorimage ? ?
- x-shape-3d ? ?
- x-shape-chart ? ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fshape%2F22-actions-spreadsheetshape.png spreadsheetshape ? ?
- musicshape ? ?
?p=calligra.git&a=blob&o=plain&f=braindump%2Fdata%2Fstates%2Ficons%2F22-actions-stateshape.png stateshape ? ?
- enhancedpath ? shape icon unused, because never fetched due to variants ?

"shape-choose" is used for action, is "shape" a proper term also useful for other apps using these icons?

Tool icons

A tool represents a specific mode of the application, where user input by mouse, keyboard etc. is interpreted for a certain aspect. Additionally the UI might highlight different aspects of the content. Examples: tool "Draw path", tool "Edit vector path", tool "Review". Tools can be offered in a toolbox (Karbon) or by tabs in the sidebar. Each tool is represented by an icon.

  • inconsistent naming here
  • possibly should be all named as action icons, "edit-" or is "tool-" better here?
  • some inconsistent naming in breeze icons, "tools" vs "tool"

Current Breeze icons for drawing tools look too similar on small sizes, as the toolbox.

old name proposed name description state
?p=calligra.git&a=blob&o=plain&f=sheets%2Fshape%2F22-actions-tool_cellformatting.png tool_cellformatting table see also discussion of table icons done
- tool_comment edit-comment not sure where it shows up in UI ?
?p=calligra.git&a=blob&o=plain&f=plugins%2Fkarbonplugins%2Ftools%2F32-actions-tool_imageeffects.png tool_imageeffects edit-image-filter ? edits effect filters applied on vector shapes ?
?p=calligra.git&a=blob&o=plain&f=words%2Fpics%2F22-actions-tool_pagelayout.png tool_pagelayout edit-page-layout ? ?
?p=calligra.git&a=blob&o=plain&f=plugins%2Ftextshape%2Fpics%2F22-actions-tool_references.png tool_references edit-references ? to manipulate footnotes, endnotes, internal links, external links, cites ?
?p=calligra.git&a=blob&o=plain&f=plugins%2Ftextshape%2Fpics%2F22-actions-tool_review.png tool_review edit-review done
?p=calligra.git&a=blob&o=plain&f=plugins%2Ftextshape%2Fpics%2F22-actions-tool-text.png tool-text edit-text done
?p=calligra.git&a=blob&o=plain&f=libs%2Fpageapp%2Ftools%2FbackgroundTool%2F22-actions-backgroundtool.png backgroundtool configure for pages, slides, and other canvas types ?
?p=calligra.git&a=blob&o=plain&f=pics%2Fhicolor%2F22-actions-artistictext-tool.png artistictext-tool edit-text ? artistic text has a different tool to the one for normal text frames ?
?p=calligra.git&a=blob&o=plain&f=braindump%2Fdata%2Fstates%2Ficons%2F22-actions-statetool.png statetool edit-state ? specific tool for "state" shape (mainly Braindump) ?
?p=calligra.git&a=blob&o=plain&f=stage%2Fpart%2Ftools%2Fanimationtool%2F16-actions-animation-stage.png animation-stage tool-animator ?
?p=calligra.git&a=blob&o=plain&f=pics%2Fhicolor%2F22-actions-select.png select tool-pointer 'tool-pointer' exists already in breeze. done
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-hand.png hand transform-move would match "zoom", but perhaps "view-move" better? ?
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-createpath.png createpath draw-path or rename tool-draw-path ? done
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F22-actions-editpath.png editpath edit-node not just a single node edited, so not sure "edit-node" matches, edit-path is needed for draw path done
?p=calligra.git&a=blob&o=plain&f=plugins%2Fkarbonplugins%2Ftools%2F22-actions-calligraphy.png calligraphy draw-calligraphic ? or rename tool-calligraphy ? ?
?p=calligra.git&a=blob&o=plain&f=plugins%2Fkarbonplugins%2Ftools%2F22-actions-gradient.png gradient color-gradient done
?p=calligra.git&a=blob&o=plain&f=plugins%2Fkarbonplugins%2Ftools%2F22-actions-pattern.png pattern color-pattern ?

Other tool icons, used from Breeze iconset:

tools-check-spelling
tools-report-bug

Other icons

old name proposed name description state
?p=calligra.git&a=blob&o=plain&f=libs%2Fwidgets%2Fpics%2Fhicolor%2F22-actions-zoom-pixels.png zoom-pixels zoom-pixels zoom so one pixel is shown as one pixel of display ?
?p=calligra.git&a=blob&o=plain&f=sheets%2Fdata%2Ftoolbar%2Fhicolor%2F16-actions-special_paste.png special_paste edit-paste-custom pastes with user interaction for configuring ?
?p=calligra.git&a=blob&o=plain&f=libs%2Fflake%2Fpics%2F16-actions-snap-boundingbox.png snap-boundingbox snap-boundingbox misses from snap-* icons in Breeze/Oxygen added
?p=calligra.git&a=blob&o=plain&f=pics%2Fhicolor%2F22-actions-artistictext-attach-path.png artistictext-attach-path ? action to select a path to use as baseline, currently not in UI, but done by double-click ?
?p=calligra.git&a=blob&o=plain&f=pics%2Fhicolor%2F22-actions-artistictext-detach-path.png artistictext-detach-path ? action to disconnect text from path currently used as baseline ?

Kexi

(this section also contains libraries that are used by Kexi)

Kexi General Actions

old name proposed name description state
?p=calligra.git&o=plain&a=blob&h=7fe517cd07330dc90daf86a008dfe02bdbe63553&f=kexi%2Fpics%2F22-actions-form_action.png form_action form-action An "execution" symbol for action that can be assigned to a form widget, e.g. button. The symbol is present in Breeze's form-view-action so could be reused.
?p=calligra.git&o=plain&a=blob&h=47af9c7189f5ac6bddd72baf83157ad72f854f46&f=kexi%2Fpics%2F22-actions-widgets.png widgets Symbolizes set of widgets / a tree of widgets / form structure
?p=calligra.git&o=plain&a=blob&h=a66612dc04d044302c7799570bcad4012f8f63ce&f=kexi%2Fpics%2F22-actions-state_data.png state_data data-view Symbolizes "data" view of a window. Other views are "design" and "SQL".
?p=calligra.git&o=plain&a=blob&h=189e26772c1d76c0ff4a2ce90bfe0f4de036591a&f=kexi%2Fpics%2F22-actions-state_edit.png state_edit design-view Symbolizes "design" view of a window. Other views are "data" and "SQL". "application-x-designer" icons can be a good base. Or this (from MSA): oZPstjj.png
?p=calligra.git&o=plain&a=blob&h=7bd3f3a91f009562559ff192233b9506f2a57aa2&f=kexi%2Fpics%2F22-actions-state_sql.png state_sql sql-view Symbolizes "SQL" view of a window. Other views are "data" and "design".

Kexi Form Widgets

Note

Kexi has a Form Design toolbar with widget icons used for forms development. Kexi 3 will switch to a toolbox view like the Apple's one. A list view with description is also possible [2] - good for novice users. Therefore the idea is to have somewhat WYSIWYG look for the widget icons. But still without unnecessary details.


old name proposed name description state
?p=calligra.git&o=plain&a=blob&h=f56f93e0b86072f81ed21f47fa5147c0b62b9964&f=kexi%2Fpics%2F22-actions-autofield.png autofield Low priority, unused for now
?p=calligra.git&a=blob&o=plain&h=d339ab26478c5036141b26aaa72954920d4c6351&f=kexi%2Fpics%2F22-actions-button.png button
?p=calligra.git&a=blob&h=3a97088b7568e24e0aa9b0b41bf5b45ed8913773&o=plain&f=kexi%2Fpics%2F22-actions-check.png check checkbox Can be based on Breeze's 'checkbox', maybe even identical? LO Breeze checkbox icon looks like a frame. DONE
?p=calligra.git&o=plain&a=blob&h=f32fcacfa523140b9f71dd1366f84d439966dac6&f=kexi%2Fpics%2F22-actions-combo.png combo combobox Breeze's combobox for LO is not the best, it's too similar to other icons.
?p=calligra.git&o=plain&a=blob&h=fa4b73a1ea982be7e86c5df03535e75fc9aaa873&f=kexi%2Fpics%2F22-actions-dateedit.png dateedit A box with "2015-11" could fit here.
?p=calligra.git&o=plain&a=blob&h=54fac2b96b7aa378933afa860eb3c35501d460e3&f=kexi%2Fpics%2F22-actions-datetimeedit.png datetimeedit A box with "2015 01:23" could fit here. 16px version is a challenge.
?p=calligra.git&o=plain&a=blob&h=eb7479e5f87248a968de2e972edd0fb7c3d8d6cd&f=kexi%2Fpics%2F22-actions-frame.png frame
?p=calligra.git&a=blob&o=plain&h=142a0b4a43290e74555e2fb7643aaa2a2c6d84ff&f=kexi%2Fpics%2F22-actions-groupbox.png groupbox
?p=calligra.git&a=blob&o=plain&h=a376acf516dce7b0a4a219dca434f6171fba5694&f=kexi%2Fpics%2F22-actions-pixmaplabel.png pixmaplabel imagebox Image box able to present a single static image. Breeze's 16/22px "place" icon "folder-images" fits here. DONE
?p=calligra.git&o=plain&a=blob&h=d3d66493a3a9f919958fc7054624154cafde91ca&f=kexi%2Fpics%2F22-actions-label.png label Definitely let's not use label-amarok, Just "Label" text is preferred
?p=calligra.git&o=plain&a=blob&h=e17d93438030ece55b433ebf9b59dbca4df3678b&f=kexi%2Fpics%2F22-actions-lineedit.png lineedit
?p=calligra.git&a=blob&o=plain&h=a135ff9c96209e81d966ad87d17b27d697e71535&f=kexi%2Fpics%2F22-actions-line_horizontal.png line_horizontal line-horizontal A line (visual separator) DONE
?p=calligra.git&a=blob&o=plain&h=dfdd0274e003f07cb7954f347d79816fbcace2d9&f=kexi%2Fpics%2F22-actions-line_vertical.png line_vertical line-vertical A line (visual separator) DONE
?p=calligra.git&o=plain&a=blob&h=8f76f232a9616ddc0e2ca2297ef69ac6789c0c1a&f=kexi%2Fpics%2F22-actions-listbox.png listbox Low priority, unused for now
?p=calligra.git&o=plain&a=blob&h=b8f2124d4a89baa9b08d725ac6ab16b893f7cdc3&f=kexi%2Fpics%2F22-actions-listwidget.png listwidget Low priority, unused for now
?p=calligra.git&o=plain&a=blob&h=d3a3dc0edc7987973c7b336a1fa0f487fa3b4e91&f=kexi%2Fpics%2F22-actions-multiple_obj.png multiple_obj multiple-objects Symbolizes multi-selection of objects. Breeze's "edit-select-all" fits quite well.
?p=calligra.git&o=plain&a=blob&h=db727ee88bbb06f27f6c927556d7043b0f74a604&f=kexi%2Fpics%2F22-actions-progress.png progress progressbar
?p=calligra.git&o=plain&a=blob&h=2895d6c8ca4258b59de5478434041cb80b3a6136&f=kexi%2Fpics%2F22-actions-radio.png radio radiobutton
?p=calligra.git&o=plain&a=blob&h=1c740f95a76bcb82fd51ff08cf1d0433770c3e0a&f=kexi%2Fpics%2F22-actions-slider.png slider Breeze's "games-config-options" is a good base for it.
?p=calligra.git&o=plain&a=blob&h=9c352ea63756385cf627bdab581843c180210cd0&f=kexi%2Fpics%2F22-actions-spin.png spin spinbox
?p=calligra.git&o=plain&a=blob&h=1ab08afed4830a7dafdd639e056c9950d60efa6e&f=kexi%2Fpics%2F22-actions-tabwidget.png tabwidget Could be based on Breeze's "tab-new", just without the "+"
?p=calligra.git&o=plain&a=blob&h=54aa160da0c92563ea1c7625e8a5f84270e85218&f=kexi%2Fpics%2F22-actions-.png tabwidget_tab tabwidget-tab A single tab widget's tab. Could be based on Breeze's "tab-new", just without the "+".
?p=calligra.git&o=plain&a=blob&h=49610ccd6610e144f1618c5d3f87f558a765809f&f=kexi%2Fpics%2F22-actions-textedit.png textedit A multiline text box widget. Breeze's 16/22px "place" icon "folder-text" fits here.
?p=calligra.git&o=plain&a=blob&h=09cdf0f9d736b943ae4f369ea7c1ff7ce0001440&f=kexi%2Fpics%2F22-actions-timeedit.png timeedit A box with "01:23" could fit here.
?p=calligra.git&a=blob&o=plain&h=47ab6f31674522e75c45069170418964217f1a8d&f=kexi%2Fpics%2F22-actions-unknown_widget.png unknown_widget unknown-widget Symbolizes unrecognized/unknown/unavailable/broken widget type

Kexi Table Actions

old name proposed name description state
?p=calligra.git&o=plain&a=blob&h=ec14b60517473cd82e92fb6da10ae4e64f575c9a&f=kexi%2Fpics%2F16-actions-add_field.png add_field add-field "Add database field", look at Breeze's text-field
?p=calligra.git&o=plain&a=blob&h=8a9e8529ca1141344e4545b773fab257136ad419&f=kexi%2Fpics%2F16-actions-autonumber.png autonumber "Autonumbering database records (rows)"
?p=calligra.git&a=blob&o=plain&h=6549c74f26af2b6c7fd21ea8fd855664718f1f75&f=kexi%2Fpics%2F22-actions-clear_table_contents.png clear_table_contents edit-table-clear Uses Kexi's "table" icon as a base V44AO3N.png
?p=calligra.git&a=blob&o=plain&h=4e26ce775940f48029010c998a403b6ec1277b13&f=kexi%2Fpics%2F22-actions-delete_table_row.png delete_table_row edit-table-delete-row Uses Kexi's "table" icon as a base and "row delete" symbol from Breeze. 4LQX6lY.png
?p=calligra.git&a=blob&o=plain&h=ade15e6843a88eb69e1bb5359a32cd99051f13ec&f=kexi%2Fpics%2F22-actions-insert_table_row.png insert_table_row edit-table-insert-row Uses Kexi's "table" icon as a base and "row insert" symbol from Breeze. VxRhjS1.png
?p=calligra.git&o=plain&a=blob&h=a51cbf7473507c6a585fe209316d3c39105384e4&f=kexi%2Fpics%2F22-actions-key.png key database-key "Database Primary Key", it's not related to keyboard or locking DONE
?p=calligra.git&a=blob&o=plain&h=3170acc6c1c11e9f352ef13c82066e5209679787&f=kexi%2Fpics%2F22-actions-relation.png relation "Relation between database tables", in MSA: qerjsis.png OFsceYR.png

Kexi Query Actions

old name proposed name description state
?p=calligra.git&o=plain&a=blob&h=d0d41512d50ca3307af6291352264c939d4f414e&f=kexi%2Fpics%2F22-actions-test_it.png test_it validate Checks validity of a query. Breeze's "checkbox" can be useful base. V8CqtHd.png

Kexi Format Actions

old name proposed name description state
?p=calligra.git&o=plain&a=blob&h=86caef964b160bcebf5db01c4f970626c2d6c76e&f=kexi%2Fpics%2F22-actions-aopos2grid.png aopos2grid align-grid "Align Widgets Position To Grid", low priority, not used in Kexi for now
?p=calligra.git&o=plain&a=blob&h=eb601e62098914deafe8c820f4c5340a436af884&f=kexi%2Fpics%2F22-actions-aofit.png aofit fit-contents "Adjust Widgets Size To Fit Contents", low priority, not used in Kexi for now
?p=calligra.git&o=plain&a=blob&h=9f4e36f948305186e7649beaac06b4af7113830c&f=kexi%2Fpics%2F22-actions-aogrid.png aogrid fit-grid "Adjust Widgets Size To Grid", low priority, not used in Kexi for now
?p=calligra.git&o=plain&a=blob&h=ad8bef89075d8a21b6756f4d3971843088f99b05&f=kexi%2Fpics%2F22-actions-aonarrowest.png aonarrowest fit-narrowest "Adjust Widgets Widths To Narrowest Selected", low priority, not used in Kexi for now
?p=calligra.git&o=plain&a=blob&h=453db90e07f4147a3edb67b4d115b54431e056e5&f=kexi%2Fpics%2F22-actions-aoshortest.png aoshortest fit-shortest "Adjust Widgets Heights To Shortest Selected", low priority, not used in Kexi for now
?p=calligra.git&o=plain&a=blob&h=b12ec10c0ef7acd73fe91eb6ad2abf17a870e162&f=kexi%2Fpics%2F22-actions-aotallest.png aotallest fit-tallest "Adjust Widgets Heights To Tallest Selected", low priority, not used in Kexi for now
?p=calligra.git&o=plain&a=blob&h=0b3722a9f2d8d66e1d39e102cd0ab60b1b4e60e0&f=kexi%2Fpics%2F22-actions-aowidest.png aowidest fit-widest "Adjust Widgets Widths To Widest Selected", low priority, not used in Kexi for now

KDb lib

See KDb for info about this component.

TODO

KProperty lib

See KProperty for info about this component.

  • TODO: button_no has been moved from Kexi here and is used to show "No" value, it's actuqally a 'minus' sign, see the Fill Background property at http://i.imgur.com/ES2BSbt.png.

KReport lib

See KReport for info about this component.

Many icons for KReport are already DONE.

TODO

References