Calligra/Icons/3.0

From KDE Community Wiki

Legend: TODO, DONE, ??

Table related icons

Existing 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
adjustcol edit-table-column-resize-equal used for both equalize & adapt-to-content currently, should be split ?
adjustcol edit-table-column-resize-fit see above ?
adjustrow edit-table-row-resize-equal used for both equalize & adapt-to-content, should be split ?
adjustrow edit-table-row-resize-fit see above ?
resizecol edit-table-column-resize ?
resizerow edit-table-row-resize ?
hide_table_column table-column-visible-off target state used with action, like "layer-visible-*" ?
hide_table_row table-row-visible-off " ?
show_table_column table-column-visible-on " ?
show_table_row table-row-visible-on " ?
cell_edit edit-table-cell-edit used to start editing (text) content of cell, "edit" as action seems strange, just "edit-table-cell" also, better idea? ?
cell_layout edit-table-cell-format used to start formatting (content of) cell, see also tool_cellformatting. Or "format-table-cell"? ?
insertcell edit-table-insert-cell used to insert single blank cell or multiple ones, incl. full row/column ?
insertcellcopy edit-table-paste-cell for inserting cells from clipboard, moving existing ones to other positions ?
mergecell edit-table-cell-merge seems existing icon is for same usecase ?
mergecell-horizontal edit-table-cell-merge-horizontal used to merge all selected cells horizontal only ?
mergecell-vertical edit-table-cell-merge-vertical used to merge all selected cells vertical only ?
removecell edit-table-cell-delete used to remove a complete cell, resulting in other cells moving positions ?
deletecell edit-table-cell-clear used to blank selected cells from all data and formatting ?
delete_table edit-table-delete used to delete the whole table/spreadsheet ?
dissociatecell edit-table-cell-unmerge or use edit-table-cell-split? ?
clear_table_contents edit-table-clear ?
selection edit-table-select-cell used both for selecting single cells and cell ranges, but single item in icon is standard? ?

Kexi also has table icons (but db vs. spreadsheet?)

  • 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].
old name proposed name description state
insert_table_row edit-table-insert-row-above use existing breeze, cmp. kexi/main/KexiMainWindow.cpp:779 tooltip "above" ?
delete_table_row rename table-delete-row ?

Borders for multiple cells

old name proposed name description state
border_all format-border-set-all sets borders on all sides of all selected cells ?
border_inside format-border-set-internal sets borders only at sides of selected cells where neighbor is not selected ?
border_outline format-border-set-external sets borders only at sides where both neighboring cells are selected ?
border_top format-border-set-top sets border only at the top side of the top selected cells ?
border_bottom format-border-set-bottom sets border only at the bottom side of the bottom selected cells ?
border_left format-border-set-left sets border only at the left side of the left selected cells ?
border_right format-border-set-right sets border only at the right side of the right selected cells ?
border_horizontal format-border-set-internal-horizontal like border_inside, but only horizontal sides ?
border_vertical format-border-set-internal-vertical like border_inside, but only verticalal sides ?
border_remove format-border-remove / border-set-none removes all borders on all sides of all selected cells ?
border_fall format-border-set-diagonal-tl-br sets diagonal line to all selected cells (topleft-bottomright) ?
border_up format-border-set-diagonal-bl-tr sets diagonal line to all selected cells (bottomleft-topright) ?
borderpainter format-border turns mouse to "painter" with current border settings, to format borders by clicking them ?

"table" is used for both for spreadsheet tables and db tables. Do they need different iconic language ?

Animation related icons

Actions:

old name proposed name description state
with_previous animation-start-together used to set an animation to start with another/the one before in list ?
after_previous animation-start-after used to set an animation to start after another/the one before in list ?
onclick animation-start-on-click used to set an animation to start on activation by user (mouse click/touch on it) ?
edit_animation edit-animation used to start editing parameters of an 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
entrance_animations animation-in shape enters the scene from outside and stays once done ?
motion_path_animations animation-move shape moves by a given path ?
exit_animations animation-exit shape leaves the scene and is now longer present once done ?
emphasis_animations animation-emphasis none preinstalled right now, shape possibly somehow highlighted ?
custom_animations animation-other none preinstalled right now, "other" possibly better than "custom" ?

2nd-level type icons:

old name proposed name description state
appear_animation animation-in-appear instant appear ?
bounce_animation - unused it seems ?
collapse_animation animation-out-collapse ?
disappear_animation animation-out-disappear instant disappear ?
falling_in_animation animation-in-fall shaky-fly in ?
fly_in_animation animation-in-fly ?
fly_in_slow_animation animation-in-fly-slow 2 fly-in speeds predefined, thus another symbol needed ?
fly_out_animation animation-out-fly ?
crawl_out_animation animation-out-fly-slow ?
spiral_in_animation animation-in-spiral ?
spiral_out_animation animation-out-spiral ?
stretchy_animation animation-in-stretch ?
swish_animation animation-out-swish ?
thread_animation animation-in-thread ?
swivel_animation animation-in-swivel used for both in and out ?
swivel_animation animation-out-swivel " ?
flash_once_animation animation-in-flash used for both in and out ?
flash_once_animation animation-out-flash " ?
zoom_animation animation-in-zoom used for both in and out ?
zoom_animation animation-out-zoom " ?
movie_credits_animation animation-pass-movie-credits ?

Fallback icon for animations without matching icon:

old name proposed name description state
unrecognized_animation animation used as generic symbol icon for animation ?

3rd-level subtypes:

horizontal_animations transform-move-horizontal not sure if "transform-move-" is good group ?
vertical_animations transform-move-vertical " ?
in_animations transform-move-in " ?
out_animations transform-move-out " ?


Shape icons

  • inconsistent naming pattern
  • are objects, not actions, should be rather colored like file type/mimetype
  • those for fixed shape look (flower) should reflect look instead of being iconic
callout-shape
circular-arrow-shape
cross-shape
ellipse-shape
flower-shape
gearhead-shape
hexagon-shape
musicshape
pathshape
pentagon-shape
rectangle-shape
smiley-shape
spiral-shape
spreadsheetshape
star-shape
stateshape
x-shape-3d
x-shape-chart
x-shape-connection
x-shape-formula
x-shape-image
x-shape-text
x-shape-text-artistic
x-shape-vectorimage
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

  • inconsistent naming here
  • possibly should be all named as action icons
  • some inconsistent naming in breeze icons, "tools" vs "tool"
tool_cellformatting -> edit-table-cell-format ? see also discussion of table icons
tool_comment - not sure where it shows up in UI
tool_imageeffects
tool_pagelayout
tool_references
tool_review
tools-check-spelling
tools-report-bug
tool-text
backgroundtool
artistictext-tool
statetool
hand -> rename tool-pan ?
createpath -> draw-path or rename tool-draw-path ?
# karbon tools
calligraphy -> use draw-calligraphic or rename tool-calligraphy ? current breeze icons for drawing tools too similar
gradient -> color-gradient or rename tool-gradient ?
pattern -> rename tool-pattern ?


Kexi

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

TODO

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.

TODO

References