# This program source code file is part of KICAD, a free EDA CAD application. # # Copyright (C) 2011 SoftPLC Corporation, Dick Hollenbeck # Copyright (C) 2011-2022 Kicad Developers, see AUTHORS.txt for contributors. # # This program is free software; you can redistribute it and/or # modify it under the terms of the GNU General Public License # as published by the Free Software Foundation; either version 2 # of the License, or (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, you may find one here: # http://www.gnu.org/licenses/old-licenses/gpl-2.0.html # or you may search the http://www.gnu.org website for the version 2 license, # or you may write to the Free Software Foundation, Inc., # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA # # In this directory, a number of different processes are managed: # # 1) PNG files are created from SVG files for each icon theme and needed bitmap resolution # 2) An images.tar.gz file is created from all the PNG files # Step 2) is universal and is done for any builder, whereas step 1) is # optional and depend on MAINTAIN_PNGS being defined in CMake. The reason we # can skip 1) is that the *.PNG files are part of the source tree so # do not need to rebuilt by a typical builder. However, because the *.PNG files # are part of the source tree, and subject to version control, they should be built # only when needed, otherwise this results in a diff for the version control system. # Therefore step 1) is driven by CMake (if MAINTAIN_PNGS) which gives # us conditional *.PNG building based on an edit to the respective *.SVG file. # If MAINTAIN_PNGS is not defined, then you are a normal builder and no special # tools are required. If MAINTAIN_PNGS is defined, then you are a PNG maintainer # and will need the following tools findable in your PATH: # # 1) inkscape - command line mode is used, must be on your PATH # 2) pngcrush - this program must be on your PATH # # lower case is used for local variables, uppercase for global variables option( MAINTAIN_PNGS "Set to true if you are a PNG maintainer and have the required tools given in the resources/bitmaps_png/CMakeLists.txt file (default OFF)." OFF) # Used Only to maintain PNG files (and therefore to recreate .cpp files) # The png2cpp creates files with native End of Line format. # List of themes - each corresponds to a folder of SVGS in ./resources/bitmaps_png/sources/ set( THEMES light dark ) # Plan for three sizes of bitmaps: # SMALL - for menus - 16 x 16 # MID - for toolbars - 24 x 24 # BIG - for program icons - 48 x 48 # which are given on three basename lists: BMAPS_SMALL, BMAPS_MID,and BMAPS_BIG # respectively. The basename is without file extension and without path. # A corresponding ${basename}.svg file must exist in 'sources' dir below here. # small icons (16x16) needed in listboxes and dialog buttons set( BMAPS_SMALL e_24 e_48 e_96 e_192 git_add git_changed_ahead git_conflict git_delete git_good_check git_modified git_out_of_date icon_bitmap2component_16 icon_eeschema_16 icon_gerbview_16 icon_kicad_16 icon_kicad_nightly_16 icon_libedit_16 icon_modedit_16 icon_pagelayout_editor_16 icon_pcbcalculator_16 icon_pcbnew_16 label_align_left label_align_right label_align_top label_align_bottom list_nets_16 notifications options_generic_16 pinorient_right pinorient_left pinorient_up pinorient_down pinshape_normal pinshape_invert pinshape_clock_normal pinshape_clock_invert pinshape_active_low_input pinshape_clock_active_low pinshape_active_low_output pinshape_clock_fall pinshape_nonlogic pintype_input pintype_output pintype_bidi pintype_3states pintype_passive pintype_notspecif pintype_powerinput pintype_poweroutput pintype_opencoll pintype_openemit pintype_nic pintype_noconnect small_down small_edit small_folder small_library small_plus small_refresh small_sort_desc small_trash small_up small_warning text_horizontal text_vertical text_align_left text_align_center text_align_right text_align_bottom text_align_middle text_align_top text_valign_top text_valign_center text_valign_bottom text_bold text_italic text_mirrored tree_nosel tree_sel visibility visibility_off www ) # image basenames that go into the toolbar sized destinations, i.e. 24x24 set( BMAPS_MID about add_aligned_dimension add_arc add_board add_bus2bus add_bus add_center_dimension add_class_flag add_circle add_component add_corner add_dashed_line add_document add_glabel add_graphical_segments add_graphical_polygon add_hierarchical_label add_hierar_pin add_hierarchical_subsheet add_junction add_keepout_area add_label add_leader add_library add_line2bus add_line_label add_line add_orthogonal_dimension add_pcb_target add_power add_radial_dimension add_rectangle add_symbol_to_schematic add_textbox add_tracks add_via add_zone_cutout add_zone align_elements_to_grid align_items align_items_left align_items_right align_items_top align_items_bottom align_items_center align_items_middle anchor annotate_down_right annotate_right_down annotate apply_pad_settings array auto_associate auto_track_width autoplace_fields axis3d_back axis3d_bottom axis3d_front axis3d_left axis3d_right axis3d_top axis3d break_line bug bus_definition_tool cancel chamfer change_entry_orient checked_ok cleanup_graphics cleanup_tracks_and_vias color_materials component_select_unit config contrast_mode convert copy copy_pad_settings cursor_shape cursor custom_pad_to_primitives curved_ratsnest cut datasheet delete_association delete_cursor delete_gerber delete_sheet directory directory_browser directory_open distribute_horizontal distribute_vertical down drag drag_segment drag_segment_withslope drc duplicate edit_comp_footprint edit_comp_ref edit_comp_value editor edit_cmp_symb_links edit edge_to_copper_clearance enter_sheet ercerr erc_green ercwarn erc exit exchange export3d export_cmp export_dsn export_idf export_file export_footprint_names export_gltf export_module export_part export_png export_step export_svg export_to_pcbnew fabrication file_bom file_cir file_drl file_dsn file_gbr file_gerber_job file_html file_idf file_pdf file_pos file_svg fill_zone fillet filter find find_replace flag flip_board gbr_select_mode1 gbr_select_mode2 gerbview_show_negative_objects general_deletions general_ratsnest grid_select grid_select_axis grid_override grid group group_enter group_leave group_remove group_ungroup heal_shapes help help_online hidden_pin hide_ratsnest hierarchy_nav hotkeys hole_to_hole_clearance hole_to_copper_clearance hv45mode icon_cvpcb_24 icon_footprint_browser icon_gerbview_24 icon_pcm_24 import3d image import_brd_file import_document import_footprint_names import_hierarchical_label import_module import_part import_project import_vector import info insert_module_board intersect_polygons language layers_manager leave_sheet left libedit lib_next lib_previous library_browser library_archive library_archive_as library library_table lines_any lines90 list_nets load_drill load_gerber load_module_board lock_unlock locked marker_exclude marker_next marker_previous measurement merge_polygons mirror_h mirror_v mode_module module_editor module_wizard module_filtered_list module_options module_pin_filtered_list module_library_list module morgan1 morgan2 move_exactly move move_relative mw_add_gap mw_add_line mw_add_shape mw_add_stub_arc mw_add_stub net_highlight net_highlight_schematic netlist new_component new_footprint new_generic new_library new_project new_project_from_template noconn normal open_project open_project_demo options_3drender options_board options_generic options_pad options_schematic opt_show_polygon ortho pack_footprints pad_sketch pad pad_enumerate pad_number pads_mask_layers pads_remove path pagelayout_normal_view_mode pagelayout_special_view_mode part_properties paste paste_special pcb_target pin2pin pin_size_to pin_show_etype pin_table pin plot polar_coord post_bom post_compo post_d356 post_drill post_gencad post_gerber post_rpt post_xml preference print_button project project_close project_kicad ps_diff_pair ps_diff_pair_gap ps_diff_pair_tune_length ps_diff_pair_tune_phase ps_tune_length push_pad_settings puzzle_piece py_script recent redo refresh reload render_mode rescue right router_len_tuner router_len_tuner_setup router_len_tuner_amplitude_decr router_len_tuner_amplitude_incr router_len_tuner_dist_decr router_len_tuner_dist_incr rotate_ccw rotate_cw rotate_ccw_x rotate_cw_x rotate_ccw_y rotate_cw_y rotate_ccw_z rotate_cw_z save_as save select_layer_pair select_w_layer select_same_sheet shape_3d shape_3d_back sheetset simulator sim_add_plot sim_command sim_run sim_stop sim_tune sim_probe sim_add_signal slice_line search_tree set_origin show_dcodenumber show_dnp show_footprint show_mod_edge show_ratsnest showtrack show_not_in_posfile show_other show_tht show_smt show_zone show_zone_disable show_zone_outline_only show_zone_triangulation show_all_layers show_no_layers show_no_copper_layers show_all_copper_layers show_all_front_layers show_all_back_layers show_front_assembly_layers show_back_assembly_layers special_tools spreadsheet subtract_polygons swap swap_layer switch_corner_rounding_shape text text_sketch thermal_spokes three_d tool_ratsnest tools trash undo unit_inch unit_mil unit_mm unknown unlocked unzip up update_pcb_from_sch update_sch_from_pcb via via_annulus via_buried via_microvia via_sketch via_diameter via_hole_diameter width_conn width_track_via width_track zip zone_duplicate zone_fillet zone_unfill zoom_area zoom_auto_fit_in_page zoom_fit_in_page zoom_fit_to_objects zoom_center_on_screen zoom_in zoom_out zoom_selection ) # 24 x 24 for internal icons set( BMAPS_24 icon_bitmap2component_24 icon_eeschema_24 icon_gerbview_24 icon_kicad_24 icon_libedit_24 icon_modedit_24 icon_pagelayout_editor_24 icon_pcbcalculator_24 icon_pcbnew_24 ) # 32 x 32 for icon sets set( BMAPS_32 icon_bitmap2component_32 icon_eeschema_32 icon_gerbview_32 icon_kicad_32 icon_kicad_nightly_32 icon_libedit_32 icon_modedit_32 icon_pagelayout_editor_32 icon_pcbcalculator_32 icon_pcbnew_32 ) # 48 x 48 for now set( BMAPS_BIG dialog_warning icon_3d icon_cvpcb icon_eeschema icon_gerbview icon_kicad icon_kicad_nightly icon_libedit icon_modedit icon_pcbnew icon_bitmap2component icon_pagelayout_editor icon_pcbcalculator icon_pcm reannotate_down_left reannotate_down_right reannotate_left_down reannotate_left_up reannotate_right_down reannotate_right_up reannotate_up_left reannotate_up_right icon_pagelayout_editor wizard_add_fplib_icon ) # 64 x 64 for icon sets set( BMAPS_64 icon_cvpcb icon_eeschema icon_gerbview icon_kicad icon_kicad_nightly icon_libedit icon_modedit icon_pcbnew icon_pagelayout_editor icon_bitmap2component icon_pcbcalculator ) # 128 x 128 for icon sets set( BMAPS_128 icon_cvpcb icon_eeschema icon_gerbview icon_kicad icon_kicad_nightly icon_libedit icon_modedit icon_pcbnew icon_pagelayout_editor icon_bitmap2component icon_pcbcalculator ) # 256 x 256 for icon sets (windows namely) set( BMAPS_256 icon_cvpcb icon_eeschema icon_gerbview icon_kicad icon_kicad_nightly icon_libedit icon_modedit icon_pcbnew icon_pagelayout_editor icon_bitmap2component icon_pcbcalculator ) # Images in this section are generated at whatever resolution is set in the source SVG file # Use Inkscape Document Properties > Custom Size to set (make sure units are pixels) # These are used for images in the UI that are not-square or very large (infographics, etc) set( BMAPS_OTHER att_bridge att_pi att_splitter att_tee c_microstrip coax color_code_multiplier color_code_tolerance color_code_value color_code_value_and_name creepage_clearance cpw cpw_back light microstrip microstrip_zodd_zeven pads_npth pads_npth_bottom pads_npth_top pads_npth_top_bottom pads_remove_unused pads_remove_unused_keep_bottom pads_reset_unused rectwaveguide regul regul_3pins splash stripline stroke_dash stroke_dashdot stroke_dashdotdot stroke_dot stroke_solid teardrop_sizes teardrop_rect_sizes teardrop_track_sizes tune_diff_pair_length_legend tune_diff_pair_skew_legend tune_single_track_length_legend twistedpair viacalc ) # @todo keep these in sync with .bzrignore set( TMP_DIR "${CMAKE_CURRENT_BINARY_DIR}/tmp" ) # true to generate log files, false to build icon files only # generate logs is useful only if you have problems set( CREATE_LOG_FILES false ) #set( BITMAP_INFO_FILE "${CMAKE_SOURCE_DIR}/include/bitmaps/bitmap_info.h" ) set( BITMAP_INFO_FILE "${CMAKE_SOURCE_DIR}/common/bitmap_info.cpp" ) set( BITMAP_INFO_TEMPLATE "${CMAKE_SOURCE_DIR}/include/bitmaps/bitmap_info.cpp.in" ) set( BITMAP_INFO_LIST "" ) set( ALL_PNGS "" ) function( svg2png inputFile outFile pngWidth pngHeight ) #message( "svg2png( inputFile: ${inputFile} outFile: ${outFile} pngWidth: ${pngWidth} pngHeight: ${pngHeight})") if( CREATE_LOG_FILES ) set( logfile "${TMP_DIR}/${bmn}.inkscape.log" ) else() if( MSVC ) set( logfile "nul" ) else() set( logfile "null" ) endif() endif() if( ${pngWidth} EQUAL -1 ) set( sizeArgs --export-area-page ) else() set( sizeArgs -w ${pngWidth} -h ${pngHeight} ) endif() add_custom_command( OUTPUT ${outFile} # this Inkscape command line is for old Inkscape version < 1.0 # COMMAND ${Inkscape_EXECUTABLE} --without-gui --export-area-snap -f ${inputFile} --export-png ${outFile} -w ${pngWidth} -h ${pngHeight} > ${logfile} # this Inkscape command line is for Inkscape >= 1.0 COMMAND ${Inkscape_EXECUTABLE} --export-area-snap --export-type=png ${inputFile} --export-filename ${outFile} ${sizeArgs} > ${logfile} DEPENDS ${inputFile} COMMENT "Creating ${pngHeight} pixel tall ${outFile}" VERBATIM ) endfunction() # Function png2png # converts a basic PNG to one function( png2png inputFile outFile ) if( CREATE_LOG_FILES ) set( logfile "${TMP_DIR}/${bmn}.pngcrush.log" ) else() if( MSVC ) set( logfile "nul" ) else() set( logfile "null" ) endif() endif() add_custom_command( OUTPUT ${outFile} # pngcrush all icons without background to remove any extraneous text records. COMMAND ${pngcrush_EXECUTABLE} -rem alla ${inputFile} ${outFile} > ${logfile} DEPENDS ${inputFile} COMMENT "Creating cleaned file ${outFile}" ) endfunction() # Function bitmap_dir # Creates build targets for all the source SVGs in the given list, output at the given resolution # Will create targets for each theme in the THEMES list. # A height of -1 means to export with the page area rather than scaling to a given resolution. # This is used for the BMAPS_OTHER list which have varying output sizes. function( bitmap_dir pngWidth pngHeight bmapList ) set( pngDir "${CMAKE_CURRENT_SOURCE_DIR}/png" ) file( MAKE_DIRECTORY ${pngDir} ) #file( REMOVE_RECURSE ${TMP_DIR} ) file( MAKE_DIRECTORY ${TMP_DIR} ) foreach( theme ${THEMES} ) if( NOT ${theme} STREQUAL "light" ) set( themeTag "_${theme}" ) else() set( themeTag "" ) endif() if( ${pngHeight} EQUAL -1 ) set( heightTag "" ) else() set( heightTag "_${pngHeight}" ) endif() foreach( bmn ${bmapList} ) set( svgFile "${CMAKE_CURRENT_SOURCE_DIR}/sources/${theme}/${bmn}.svg" ) set( pngFile "${bmn}${themeTag}${heightTag}.png" ) set( pngPath "${pngDir}/${pngFile}" ) set( tmpFile "${TMP_DIR}/${pngFile}" ) if( NOT EXISTS ${svgFile} ) message( "Warning: Source SVG ${svgFile} does not exist!" ) continue() endif() #svg2png( inputFile outFile pngWidth pngHeight ) svg2png( ${svgFile} ${tmpFile} ${pngWidth} ${pngHeight} ) #png2png( inputFile outFile ) png2png( ${tmpFile} ${pngPath} ) set( bitmapInfo " aBitmapInfoCache[BITMAPS::${bmn}].emplace_back( BITMAPS::${bmn}, wxT( \"${pngFile}\" ), ${pngHeight}, wxT( \"${theme}\" ) );\n" ) set( BITMAP_INFO_LIST "${BITMAP_INFO_LIST}${bitmapInfo}" ) list( APPEND ALL_PNGS ${pngPath} ) endforeach() endforeach() set( ALL_PNGS ${ALL_PNGS} PARENT_SCOPE ) set( BITMAP_INFO_LIST ${BITMAP_INFO_LIST} PARENT_SCOPE ) endfunction() include( FindUnixCommands ) if( TAR STREQUAL "TAR-NOTFOUND" ) # CMake on Windows CI seems to struggle to find tar even though it's in PATH # Let's help it out as modern windows (Server 2019 and 10 provide tar) if( MSVC ) # yolo set( TAR "C:\\Windows\\System32\\tar.exe" ) else() message( FATAL_ERROR "Could not find the tar program." ) endif() endif() set( BITMAP_ARCHIVE_PATH ${CMAKE_BINARY_DIR}/resources/images.tar.gz ) if( NOT ALL_PNGS ) file( GLOB_RECURSE ALL_PNGS ${CMAKE_CURRENT_SOURCE_DIR}/png/*.png ) endif() if( MINGW ) # This seems like a huge hack, but I can't find a better way. If anyone else does, please # feel free to replace this with it... file( TO_CMAKE_PATH "${BITMAP_ARCHIVE_PATH}" TAR_OUTPUT_FILE ) string( REGEX REPLACE "^([a-zA-Z]):/" "/\\1/" TAR_OUTPUT_FILE "${TAR_OUTPUT_FILE}" ) else() set( TAR_OUTPUT_FILE "${BITMAP_ARCHIVE_PATH}" ) endif() add_custom_target( bitmap_archive ALL COMMAND ${TAR} cfz "${TAR_OUTPUT_FILE}" . DEPENDS ${ALL_PNGS} BYPRODUCTS ${BITMAP_ARCHIVE_PATH} WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/png COMMENT "Creating image archive ${TAR_OUTPUT_FILE}" VERBATIM ) install( FILES ${BITMAP_ARCHIVE_PATH} DESTINATION ${KICAD_DATA}/resources ) if( MAINTAIN_PNGS ) # Inkscape is required to convert SVG files to PNG files. set( Inkscape_FOUND FALSE ) if( NOT Inkscape_FOUND ) find_program( Inkscape_EXECUTABLE inkscape PATHS "[HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\Inkscape;InstallDir]" "$ENV{PROGRAMFILES}\\Inkscape\\bin" DOC "Inkscape vector drawing program." ) if( NOT Inkscape_EXECUTABLE ) message( FATAL_ERROR "Could not find the Inkscape vector drawing program." ) else( NOT Inkscape_EXECUTABLE ) set( Inkscape_FOUND TRUE ) set( Inkscape_EXECUTABLE ${Inkscape_EXECUTABLE} CACHE FILEPATH "Path and file name of the Inkscape program." ) message( STATUS "The Inkscape vector drawing program found." ) endif( NOT Inkscape_EXECUTABLE ) endif( NOT Inkscape_FOUND ) # pngcrush is required to reduce the size of the converted PNG files. set( pngcrush_FOUND FALSE ) if( NOT pngcrush_FOUND ) find_program( pngcrush_EXECUTABLE pngcrush DOC "The PNG size reduction program." ) if( NOT pngcrush_EXECUTABLE ) message( FATAL_ERROR "Could not find the pngcrush PNG size reduction program." ) else( NOT pngcrush_EXECUTABLE ) set( pngcrush_FOUND TRUE ) set( pngcrush_EXECUTABLE ${pngcrush_EXECUTABLE} CACHE FILEPATH "Path and file name of the pngcrush program." ) message( STATUS "The pngcrush PNG size reduction program found." ) endif( NOT pngcrush_EXECUTABLE ) endif( NOT pngcrush_FOUND ) # these 3 cmake commands for each desired bitmap size set, repeat as needed: bitmap_dir( 16 16 "${BMAPS_SMALL}" ) bitmap_dir( 32 32 "${BMAPS_SMALL}" ) # 2x HiDPI bitmap_dir( 24 24 "${BMAPS_MID}" ) # "primary" size first bitmap_dir( 16 16 "${BMAPS_MID}" ) # Small toolbar mode bitmap_dir( 32 32 "${BMAPS_MID}" ) # Large toolbar mode bitmap_dir( 48 48 "${BMAPS_MID}" ) # HiDPI normal size bitmap_dir( 64 64 "${BMAPS_MID}" ) # HiDPI large size bitmap_dir( 32 32 "${BMAPS_32}" ) bitmap_dir( 24 24 "${BMAPS_24}" ) bitmap_dir( 64 64 "${BMAPS_64}" ) bitmap_dir( 128 128 "${BMAPS_128}" ) bitmap_dir( 256 256 "${BMAPS_256}" ) bitmap_dir( 48 48 "${BMAPS_BIG}" ) bitmap_dir( -1 -1 "${BMAPS_OTHER}" ) configure_file( ${BITMAP_INFO_TEMPLATE} ${BITMAP_INFO_FILE} NEWLINE_STYLE UNIX ) add_custom_target( generate_pngs ALL DEPENDS ${ALL_PNGS} COMMENT "Creating PNGs from SVGs" ) add_dependencies( bitmap_archive generate_pngs ) endif( MAINTAIN_PNGS )