PCB-FPW developer documentation based on version: 0.0.11

Functions

callbacks.h File Reference

Callback functions header file for the pcb footprintwizard. More...

Go to the source code of this file.

Functions

void on_C1_entry_changed (GtkEditable *editable, gpointer user_data)
 The "top to bottom pads/pins center-center distance (C1)" entry is changed.
void on_C1_radiobutton_toggled (GtkToggleButton *togglebutton, gpointer user_data)
 The "top to bottom pads/pins center-center distance (C1)" radiobutton is clicked.
void on_C2_entry_changed (GtkEditable *editable, gpointer user_data)
 The "left to right pads/pins center-center distance (C2)" entry is changed.
void on_C2_radiobutton_toggled (GtkToggleButton *togglebutton, gpointer user_data)
 The "left to right pads/pins center-center distance (C2)" radiobutton is clicked.
void on_G1_entry_changed (GtkEditable *editable, gpointer user_data)
 The top to bottom pads/pins inner-inner distance (G1) entry is changed.
void on_G1_radiobutton_toggled (GtkToggleButton *togglebutton, gpointer user_data)
 The top to bottom pads/pins inner-inner distance (G1) radiobutton is clicked.
void on_G2_entry_changed (GtkEditable *editable, gpointer user_data)
 The left to right pads/pins inner-inner distance (G2) entry is changed.
void on_G2_radiobutton_toggled (GtkToggleButton *togglebutton, gpointer user_data)
 The left to right pads/pins inner-inner distance (G2) radiobutton is clicked.
void on_Z1_entry_changed (GtkEditable *editable, gpointer user_data)
 The top to bottom pads/pins outer-outer distance (Z1) entry is changed.
void on_Z1_radiobutton_toggled (GtkToggleButton *togglebutton, gpointer user_data)
 The top to bottom pads/pins outer-outer (Z1) radiobutton is clicked.
void on_Z2_entry_changed (GtkEditable *editable, gpointer user_data)
 The left to right pads/pins outer-outer distance (Z2) entry is changed.
void on_Z2_radiobutton_toggled (GtkToggleButton *togglebutton, gpointer user_data)
 The left to right pads/pins outer-outer (Z2) radiobutton is clicked.
void on_about_dialog_close (GtkDialog *dialog, gint response_id, gpointer user_data)
 The close button of the about dialog is clicked.
void on_about_dialog_destroy (GtkObject *object, gpointer user_data)
 The destroy button of the about dialog is clicked.
void on_add_attribs_checkbutton_toggled (GtkToggleButton *togglebutton, gpointer user_data)
 The "add attributes to footprint" checkbutton is toggled.
void on_add_license_checkbutton_toggled (GtkToggleButton *togglebutton, gpointer user_data)
 The "add a license text to footprint" checkbutton is toggled.
void on_clear_button_clicked (GtkButton *button, gpointer user_data)
 The "Clear" button is clicked.
void on_close_button_clicked (GtkButton *button, gpointer user_data)
 The "Close" button is clicked.
void on_count_x_entry_changed (GtkEditable *editable, gpointer user_data)
 The "Count X-direction" entry is changed.
void on_count_y_entry_changed (GtkEditable *editable, gpointer user_data)
 The "Count Y-direction" entry is changed.
void on_courtyard_checkbutton_toggled (GtkToggleButton *togglebutton, gpointer user_data)
 The "courtyard" checkbutton is toggled.
void on_courtyard_clearance_with_package_entry_changed (GtkEditable *editable, gpointer user_data)
 The "courtyard clearance with package" entry is changed.
void on_courtyard_length_entry_changed (GtkEditable *editable, gpointer user_data)
 The "length of the courtyard (X)" entry is changed.
void on_courtyard_line_width_entry_changed (GtkEditable *editable, gpointer user_data)
 The "courtyard line width" entry is changed.
void on_courtyard_width_entry_changed (GtkEditable *editable, gpointer user_data)
 The "width of the courtyard (Y)" entry is changed.
void on_dimensions_button_clicked (GtkButton *button, gpointer user_data)
 The "Dimensions" button is clicked.
void on_fiducial_checkbutton_toggled (GtkToggleButton *togglebutton, gpointer user_data)
 The "fiducial" checkbutton is toggled.
void on_fiducial_pad_clearance_entry_changed (GtkEditable *editable, gpointer user_data)
 The "fiducial pad clearance" entry is changed.
void on_fiducial_pad_diameter_entry_changed (GtkEditable *editable, gpointer user_data)
 The "fiducial pad diameter (D)" entry is changed.
void on_fiducial_pad_solder_mask_clearance_entry_changed (GtkEditable *editable, gpointer user_data)
 The "fiducial pad solder mask clearance" entry is changed.
void on_filechooser_dialog_cancel_button_clicked (GtkButton *button, gpointer user_data)
 The file chooser dialog "Cancel" button is clicked.
void on_filechooser_dialog_close (GtkDialog *dialog, gpointer user_data)
 The file chooser dialog "close" signal is emitted.
void on_filechooser_dialog_current_folder_changed (GtkFileChooser *filechooser, gpointer user_data)
 The file chooser dialog "current folder changed" signal is emitted.
void on_filechooser_dialog_open_button_clicked (GtkButton *button, gpointer user_data)
 The file chooser dialog "Open" button is clicked.
void on_filechooser_dialog_selection_changed (GtkFileChooser *filechooser, gpointer user_data)
 The file chooser dialog "selection changed" signal is emitted.
void on_filechooser_dialog_update_preview (GtkFileChooser *filechooser, gpointer user_data)
 The file chooser dialog "update preview" signal is emitted.
void on_footprint_author_entry_changed (GtkEditable *editable, gpointer user_data)
 The "footprint author name" entry is changed.
void on_footprint_button_clicked (GtkButton *button, gpointer user_data)
 The "Footprint" button is clicked.
void on_footprint_dist_license_entry_changed (GtkEditable *editable, gpointer user_data)
 The "footprint distribution license" entry is changed.
void on_footprint_name_entry_changed (GtkEditable *editable, gpointer user_data)
 The "footprint name" entry is changed.
void on_footprint_refdes_entry_changed (GtkEditable *editable, gpointer user_data)
 The "footprint refdes prefix" entry is changed.
void on_footprint_status_entry_changed (GtkComboBox *combobox, gpointer user_data)
 The "footprint status" entry is changed.
void on_footprint_type_entry_changed (GtkComboBox *combobox, gpointer user_data)
 The "footprint type" entry is changed.
void on_footprint_units_entry_changed (GtkComboBox *combobox, gpointer user_data)
 The "footprint units" entry is changed.
void on_footprint_use_license_entry_changed (GtkEditable *editable, gpointer user_data)
 The "footprint usage license" entry is changed.
void on_footprint_value_entry_changed (GtkEditable *editable, gpointer user_data)
 The "footprint value" entry is changed.
void on_number_1_position_entry_changed (GtkComboBox *combobox, gpointer user_data)
 The "position of number 1 pad/pin" entry is changed.
void on_number_of_columns_entry_changed (GtkEditable *editable, gpointer user_data)
 The "number of columns" entry is changed.
void on_number_of_rows_entry_changed (GtkEditable *editable, gpointer user_data)
 The "number of rows" entry is changed.
void on_number_total_pins_entry_changed (GtkEditable *editable, gpointer user_data)
 The "number of pads/pins" entry is changed.
void on_open_button_clicked (GtkButton *button, gpointer user_data)
 The "Open" button is clicked.
void on_package_body_height_entry_changed (GtkEditable *editable, gpointer user_data)
 The "package body height" entry is changed.
void on_package_body_length_entry_changed (GtkEditable *editable, gpointer user_data)
 The "package body length" entry is changed.
void on_package_body_width_entry_changed (GtkEditable *editable, gpointer user_data)
 The "package body width" entry is changed.
void on_package_is_radial_checkbutton_toggled (GtkToggleButton *togglebutton, gpointer user_data)
 The "package is radial" checkbutton is toggled.
void on_pad_clearance_entry_changed (GtkEditable *editable, gpointer user_data)
 The "pad clearance" entry is changed.
void on_pad_diameter_entry_changed (GtkEditable *editable, gpointer user_data)
 The "diameter of the pad (D)" entry is changed.
void on_pad_length_entry_changed (GtkEditable *editable, gpointer user_data)
 The "length of the pads (X)" entry is changed.
void on_pad_shape_entry_changed (GtkComboBox *combobox, gpointer user_data)
 The "shape of pads" entry is changed.
void on_pad_solder_mask_clearance_entry_changed (GtkEditable *editable, gpointer user_data)
 The "pad solder mask clearance" entry is changed.
void on_pad_width_entry_changed (GtkEditable *editable, gpointer user_data)
 The "width of the pads (Y)" entry is changed.
void on_pcb_gfpw_destroy (GtkObject *object, gpointer user_data)
 The top-right "X" is clicked.
void on_pin_drill_diameter_entry_changed (GtkEditable *editable, gpointer user_data)
 The "diameter of the drill holes (d)" entry is changed.
void on_pin_pad_exceptions_button_clicked (GtkButton *button, gpointer user_data)
 The "Pin/Pad exceptions" button is clicked.
void on_pin_pad_exceptions_entry_changed (GtkEditable *editable, gpointer user_data)
 The "pin/pad exceptions" entry is changed.
void on_pin_square_checkbutton_toggled (GtkToggleButton *togglebutton, gpointer user_data)
 The "pin #1 square" checkbutton is toggled.
void on_pitch_x_entry_changed (GtkEditable *editable, gpointer user_data)
 The "Pitch X-direction" entry is changed.
void on_pitch_y_entry_changed (GtkEditable *editable, gpointer user_data)
 The "Pitch Y-direction" entry is changed.
void on_preview_button_clicked (GtkButton *button, gpointer user_data)
 The "Preview" button is clicked.
void on_refresh_button_clicked (GtkButton *button, gpointer user_data)
 The "Refresh" button is clicked.
void on_save_button_clicked (GtkButton *button, gpointer user_data)
 The "Save" button is clicked.
void on_silkscreen_indicate_1_checkbutton_toggled (GtkToggleButton *togglebutton, gpointer user_data)
 The "indicate pin/pad number 1" checkbutton is toggled.
void on_silkscreen_line_width_entry_changed (GtkEditable *editable, gpointer user_data)
 The "silkscreen line width" entry is changed.
void on_silkscreen_package_outline_checkbutton_toggled (GtkToggleButton *togglebutton, gpointer user_data)
 The "package outline" checkbutton is toggled.
void on_thermal_checkbutton_toggled (GtkToggleButton *togglebutton, gpointer user_data)
 The "thermal pad" checkbutton is toggled.
void on_thermal_clearance_entry_changed (GtkEditable *editable, gpointer user_data)
 The "thermal pad clearance" entry is changed.
void on_thermal_length_entry_changed (GtkEditable *editable, gpointer user_data)
 The "thermal pad length" entry is changed.
void on_thermal_nopaste_checkbutton_toggled (GtkToggleButton *togglebutton, gpointer user_data)
 The "thermal pad no paste" checkbutton is clicked.
void on_thermal_solder_mask_clearance_entry_changed (GtkEditable *editable, gpointer user_data)
 The "thermal pad solder mask clearance" entry is changed.
void on_thermal_width_entry_changed (GtkEditable *editable, gpointer user_data)
 The "thermal pad width" entry is changed.

Detailed Description

Callback functions header file for the pcb footprintwizard.

Author:
Copyright (C) 2007, 2008, 2009 by Bert Timmerman <bert.timmerman@xs4all.nl>

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, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Definition in file callbacks.h.


Function Documentation

void on_about_dialog_close ( GtkDialog *  dialog,
gint  response_id,
gpointer  user_data 
)

The close button of the about dialog is clicked.

Parameters: *dialog is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1465 of file callbacks.c.

void on_about_dialog_destroy ( GtkObject *  object,
gpointer  user_data 
)

The destroy button of the about dialog is clicked.

Parameters: *object is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1485 of file callbacks.c.

void on_add_attribs_checkbutton_toggled ( GtkToggleButton *  togglebutton,
gpointer  user_data 
)

The "add attributes to footprint" checkbutton is toggled.

  • get active state.
  • store in the attributes_in_footprint variable (global).

Parameters: *togglebutton is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1509 of file callbacks.c.

void on_add_license_checkbutton_toggled ( GtkToggleButton *  togglebutton,
gpointer  user_data 
)

The "add a license text to footprint" checkbutton is toggled.

  • get active state.
  • store in the license_in_footprint variable (global).

Parameters: *togglebutton is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1531 of file callbacks.c.

void on_C1_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "top to bottom pads/pins center-center distance (C1)" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the c1 variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1111 of file callbacks.c.

void on_C1_radiobutton_toggled ( GtkToggleButton *  togglebutton,
gpointer  user_data 
)

The "top to bottom pads/pins center-center distance (C1)" radiobutton is clicked.

  • set the "center-center distance (C1)" entry to sensitive.
  • set the "inner-inner distance (G1)" entry to insensitive.
  • set the "outer-outer distance (Z1)" entry to insensitive.

Parameters: *togglebutton is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1140 of file callbacks.c.

void on_C2_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "left to right pads/pins center-center distance (C2)" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the c2 variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1171 of file callbacks.c.

void on_C2_radiobutton_toggled ( GtkToggleButton *  togglebutton,
gpointer  user_data 
)

The "left to right pads/pins center-center distance (C2)" radiobutton is clicked.

  • set the "center-center distance (C2)" entry to sensitive.
  • set the "inner-inner distance (G2)" entry to insensitive.
  • set the "outer-outer distance (Z2)" entry to insensitive.

Parameters: *togglebutton is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1200 of file callbacks.c.

void on_clear_button_clicked ( GtkButton *  button,
gpointer  user_data 
)

The "Clear" button is clicked.

  • clear all entries or set entries which have a default values to that value,
  • set all togglebuttons to the initial state.
Todo:
Combobox entries to be stripped of characters with something like gtk_combo_box_remove_text ().

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

  • clear all entries or set entries which have a default values to that value,
  • set all togglebuttons to the initial state.
Todo:
Combobox entries to be stripped of characters with something like gtk_combo_box_remove_text ().

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1557 of file callbacks.c.

void on_close_button_clicked ( GtkButton *  button,
gpointer  user_data 
)

The "Close" button is clicked.

Close the application.

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1760 of file callbacks.c.

void on_count_x_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "Count X-direction" entry is changed.

  • get the chars from the entry.
  • convert to an integer and store in the count_x variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1783 of file callbacks.c.

void on_count_y_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "Count Y-direction" entry is changed.

  • get the chars from the entry.
  • convert to an integer and store in the count_y variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1812 of file callbacks.c.

void on_courtyard_checkbutton_toggled ( GtkToggleButton *  togglebutton,
gpointer  user_data 
)

The "courtyard" checkbutton is toggled.

  • get active state.
  • store in the courtyard variable (global).

Parameters: *togglebutton is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1840 of file callbacks.c.

void on_courtyard_clearance_with_package_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "courtyard clearance with package" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the courtyard_clearance_with_package variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1877 of file callbacks.c.

void on_courtyard_length_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "length of the courtyard (X)" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the courtyard_length variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1905 of file callbacks.c.

void on_courtyard_line_width_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "courtyard line width" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the courtyard_line_width variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1933 of file callbacks.c.

void on_courtyard_width_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "width of the courtyard (Y)" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the courtyard_width variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1961 of file callbacks.c.

void on_dimensions_button_clicked ( GtkButton *  button,
gpointer  user_data 
)

The "Dimensions" button is clicked.

Create a window with a pixmap of the dimensions of the current footprint type (based on the value in the entry widget).

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1986 of file callbacks.c.

void on_fiducial_checkbutton_toggled ( GtkToggleButton *  togglebutton,
gpointer  user_data 
)

The "fiducial" checkbutton is toggled.

  • get active state.
  • store in the fiducial variable (global).
  • set pad diameter and pad solder mask clearance entries to the corresponding sensitive state.
  • set fpw entries have changed marker.

Parameters: *togglebutton is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2029 of file callbacks.c.

void on_fiducial_pad_clearance_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "fiducial pad clearance" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the fiducial_pad_clearance variable (global).
  • set the fpw entries have changed marker "[*]" in the title bar.

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2065 of file callbacks.c.

void on_fiducial_pad_diameter_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "fiducial pad diameter (D)" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the fiducial_pad_diameter variable (global).
  • set fpw entries have changed marker.

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2096 of file callbacks.c.

void on_fiducial_pad_solder_mask_clearance_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "fiducial pad solder mask clearance" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the fiducial_pad_solder_mask_clearance variable (global).
  • set fpw entries have changed marker.

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2127 of file callbacks.c.

void on_filechooser_dialog_cancel_button_clicked ( GtkButton *  button,
gpointer  user_data 
)

The file chooser dialog "Cancel" button is clicked.

  • lookup the dialog widget.
  • destroy the file chooser widget.
Todo:
  • maybe restore the preview widget ?

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

  • lookup the dialog widget.
  • destroy the file chooser widget.
Todo:
  • maybe restore the preview widget ?

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

  • lookup the dialog widget.
  • destroy the file chooser widget.
Todo:
  • maybe restore the preview widget ?

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2161 of file callbacks.c.

void on_filechooser_dialog_close ( GtkDialog *  dialog,
gpointer  user_data 
)

The file chooser dialog "close" signal is emitted.

  • lookup the dialog widget.
  • destroy the file chooser widget.

Parameters: *dialog is the caller widget.

Parameters: user_data.

Returns: none.

The file chooser dialog "close" signal is emitted.

  • lookup the dialog widget.
  • destroy the filechooser widget.

Parameters: *dialog is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2185 of file callbacks.c.

void on_filechooser_dialog_current_folder_changed ( GtkFileChooser *  filechooser,
gpointer  user_data 
)

The file chooser dialog "current folder changed" signal is emitted.

  • lookup the dialog widget.
  • get the current folder.
  • test the current folder for null pointer or empty string and if true, please log a message and return.
  • store the (new) current folder name in temp_dir.

Parameters: *filechooser is the caller widget.

Parameters: user_data.

Returns: none.

The file chooser dialog "current folder changed" signal is emitted.

  • lookup the dialog widget.
  • get the current folder.
  • test the current folder for null pointer or empty string and if true, please log a message and return.
  • store the (new) current folder name in temp_dir.

Parameters: *filechooser is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2214 of file callbacks.c.

void on_filechooser_dialog_open_button_clicked ( GtkButton *  button,
gpointer  user_data 
)

The file chooser dialog "Open" button is clicked.

  • lookup the dialog widget.
  • get the selected filename.
  • test the selected filename for null pointer or empty string and if true, please log a message.
  • test if the selected filename is not a directory and if true, please log a message.
  • store the selected filename in fpw_filename.
  • duplicate the (new) current directory name from temp_dir into work_dir.
  • read new global values from the selected footprintwizard file.
  • update the entry widgets to reflect the changes.

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

The file chooser dialog "Open" button is clicked.

  • lookup the dialog widget.
  • get the selected filename.
  • test the selected filename for null pointer or empty string and if true, please log a message.
  • test if the selected filename is not a directory and if true, please log a message.
  • store the selected filename in fpw_filename.
  • duplicate the (new) current directory name from temp_dir into work_dir.
  • read new global values from the selected footprintwizard file.
  • update the entry widgets to reflect the changes.

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2278 of file callbacks.c.

void on_filechooser_dialog_selection_changed ( GtkFileChooser *  filechooser,
gpointer  user_data 
)

The file chooser dialog "selection changed" signal is emitted.

Todo:
  • store the selected filename in temp_fpw_filename.

- read the values from the selected footprintwizard file in a temporary set of variables temp_*.

- generate a new preview image.

- update the preview widget.

Parameters: *filechooser is the caller widget.

Parameters: user_data.

Returns: none.

Todo:
  • store the selected filename in temp_fpw_filename.

- read the values from the selected footprintwizard file in a temporary set of variables temp_*.

- generate a new preview image.

- update the preview widget.

Parameters: *filechooser is the caller widget.

Parameters: user_data.

Returns: none.

The file chooser dialog "selection changed" signal is emitted.

Todo:
  • store the selected filename in temp_fpw_filename.

- read the values from the selected footprintwizard file in a temporary set of variables temp_*.

- generate a new preview image.

- update the preview widget.

Parameters: *filechooser is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2376 of file callbacks.c.

void on_filechooser_dialog_update_preview ( GtkFileChooser *  filechooser,
gpointer  user_data 
)

The file chooser dialog "update preview" signal is emitted.

Todo:
  • generate a new preview image.

- update the preview widget.

Parameters: *filechooser is the caller widget.

Parameters: user_data.

Returns: none.

Todo:
  • generate a new preview image.

- update the preview widget.

Parameters: *filechooser is the caller widget.

Parameters: user_data.

Returns: none.

The file chooser dialog "update preview" signal is emitted.

Todo:
  • generate a new preview image.

- update the preview widget.

Parameters: *filechooser is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2396 of file callbacks.c.

void on_footprint_author_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "footprint author name" entry is changed.

Store in the footprint_author variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2415 of file callbacks.c.

void on_footprint_button_clicked ( GtkButton *  button,
gpointer  user_data 
)

The "Footprint" button is clicked.

  • check for null pointer and empty string in footprint_name.
  • determine the name of the footprintwizard filename.
  • determine the name of the footprint filename.
  • invoke the write_footprint() function to write the footprint file.
  • if the footprint file is written successful reflect this in the statusbar.

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

  • check for null pointer and empty string in footprint_name.
  • determine the name of the footprintwizard filename.
  • determine the name of the footprint filename.
  • invoke the write_footprint() function to write the footprint file.
  • if the footprint file is written successfull reflect this in the statusbar.

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2445 of file callbacks.c.

void on_footprint_dist_license_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "footprint distribution license" entry is changed.

Store in the footprint_dist_license variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2512 of file callbacks.c.

void on_footprint_name_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "footprint name" entry is changed.

Store in the footprint_name variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2534 of file callbacks.c.

void on_footprint_refdes_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "footprint refdes prefix" entry is changed.

Store in the footprint_refdes variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2754 of file callbacks.c.

void on_footprint_status_entry_changed ( GtkComboBox *  combobox,
gpointer  user_data 
)

The "footprint status" entry is changed.

Store in the footprint_status variable (global).

Parameters: *combobox is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2775 of file callbacks.c.

void on_footprint_type_entry_changed ( GtkComboBox *  combobox,
gpointer  user_data 
)

The "footprint type" entry is changed.

  • test if the footprint name is equal with the footprint type or has a null pointer or is an empty string, if so copy the footprint type into the footprint name entry.
  • store the new value in the footprint_type variable (global).

Parameters: *combobox is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 2813 of file callbacks.c.

void on_footprint_units_entry_changed ( GtkComboBox *  combobox,
gpointer  user_data 
)

The "footprint units" entry is changed.

  • store in the footprint_units variable (global).
  • check for null pointer and empty string.

Parameters: *combobox is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3093 of file callbacks.c.

void on_footprint_use_license_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "footprint usage license" entry is changed.

Store in the footprint_use_license variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3142 of file callbacks.c.

void on_footprint_value_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "footprint value" entry is changed.

Store in the footprint_value variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3164 of file callbacks.c.

void on_G1_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The top to bottom pads/pins inner-inner distance (G1) entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the g1 variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1231 of file callbacks.c.

void on_G1_radiobutton_toggled ( GtkToggleButton *  togglebutton,
gpointer  user_data 
)

The top to bottom pads/pins inner-inner distance (G1) radiobutton is clicked.

  • set the inner-inner (G1) entry to sensitive.
  • set the center-center (C1) entry to insensitive.
  • set the outer-outer (Z1) entry to insensitive.

Parameters: *togglebutton is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1260 of file callbacks.c.

void on_G2_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The left to right pads/pins inner-inner distance (G2) entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the g2 variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1291 of file callbacks.c.

void on_G2_radiobutton_toggled ( GtkToggleButton *  togglebutton,
gpointer  user_data 
)

The left to right pads/pins inner-inner distance (G2) radiobutton is clicked.

  • set the inner-inner (G2) entry to sensitive.
  • set the center-centr (C2) entry to insensitive.
  • set the outer-outer (Z2) entry to insensitive.

Parameters: *togglebutton is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1320 of file callbacks.c.

void on_number_1_position_entry_changed ( GtkComboBox *  combobox,
gpointer  user_data 
)

The "position of number 1 pad/pin" entry is changed.

Store in the n1_pos variable (global).

Parameters: *combobox is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3187 of file callbacks.c.

void on_number_of_columns_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "number of columns" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the n_col variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3210 of file callbacks.c.

void on_number_of_rows_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "number of rows" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the n_row variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3238 of file callbacks.c.

void on_number_total_pins_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "number of pads/pins" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the n variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3266 of file callbacks.c.

void on_open_button_clicked ( GtkButton *  button,
gpointer  user_data 
)

The "Open" button is clicked.

  • create a file chooser dialog.
  • create and set a file filter "*.fpw" and add to the file chooser.
  • show the file chooser widget to let the user select a .fpw file.

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3294 of file callbacks.c.

void on_package_body_height_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "package body height" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the package_body_height variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3323 of file callbacks.c.

void on_package_body_length_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "package body length" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the package_body_length variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3351 of file callbacks.c.

void on_package_body_width_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "package body width" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the package_body_width variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3379 of file callbacks.c.

void on_package_is_radial_checkbutton_toggled ( GtkToggleButton *  togglebutton,
gpointer  user_data 
)

The "package is radial" checkbutton is toggled.

Store the state of the checkbutton in the package_is_radial variable (global).

Parameters: *togglebutton is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3405 of file callbacks.c.

void on_pad_clearance_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "pad clearance" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the pad_clearance variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3429 of file callbacks.c.

void on_pad_diameter_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "diameter of the pad (D)" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the d_pad variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3456 of file callbacks.c.

void on_pad_length_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "length of the pads (X)" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the pad_length variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3484 of file callbacks.c.

void on_pad_shape_entry_changed ( GtkComboBox *  combobox,
gpointer  user_data 
)

The "shape of pads" entry is changed.

  • store in the pad_shape variable (global).
  • check for null pointer and empty string.

Parameters: *combobox is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3511 of file callbacks.c.

void on_pad_solder_mask_clearance_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "pad solder mask clearance" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the solder_mask_clearance variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3565 of file callbacks.c.

void on_pad_width_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "width of the pads (Y)" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the pad_with variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3593 of file callbacks.c.

void on_pcb_gfpw_destroy ( GtkObject *  object,
gpointer  user_data 
)

The top-right "X" is clicked.

Close the application.

Parameters: *object is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3617 of file callbacks.c.

void on_pin_drill_diameter_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "diameter of the drill holes (d)" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the pin_drill_diameter variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3640 of file callbacks.c.

void on_pin_pad_exceptions_button_clicked ( GtkButton *  button,
gpointer  user_data 
)

The "Pin/Pad exceptions" button is clicked.

  • check if a (valid) footprint type has been selected and if a valid number of rows and a valid number of columns is selected:
    • if non valid values have been selected (or not selected yet) log a warning and let this occurance pass.
    • if valid values have been selected create a seperate window with radio buttons depicting the package leads.

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3673 of file callbacks.c.

void on_pin_pad_exceptions_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "pin/pad exceptions" entry is changed.

  • get the chars from the entry.
  • store the contents in the pin_pad_exception_string variable (global) for processing while generating a footprint or preview.

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3744 of file callbacks.c.

void on_pin_square_checkbutton_toggled ( GtkToggleButton *  togglebutton,
gpointer  user_data 
)

The "pin #1 square" checkbutton is toggled.

Save the state of the checkbutton in the pin1_square variable (global).

Parameters: *togglebutton is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3767 of file callbacks.c.

void on_pitch_x_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "Pitch X-direction" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the pitch_x variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3790 of file callbacks.c.

void on_pitch_y_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "Pitch Y-direction" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the pitch_y variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3817 of file callbacks.c.

void on_preview_button_clicked ( GtkButton *  button,
gpointer  user_data 
)

The "Preview" button is clicked.

Create a pixmap of the footprint based on the values in the entry widgets.

Todo:
  • create and (re)load the preview image.

There are several ways to create a preview image of the footprint based on the values entered in the entries:

  1. Copy the method as in the pcb pinout preview.
    Advantage: proven functionality in pcb.
    Disadvantage: this means including a lot of code from pcb.
  2. Invoke pcb to create a picture, and subsequent load that picture into the preview drawing area.
    Advantage: proven functionality in pcb.
    Disadvantage: this will make the user wait, and this will eventually become a showstopper.
  3. Change pcb-fpw into a plug-in.
    Advantage: all pcb functionality is at hand.
    Disadvantage: the gtk approach will not work on the lesstif GUI.
  4. Make an inbuilt renderer for drawing footprints inside pcb-fpw.
    Advantage: a renderer would keep pcb-fpw independant of whatever GUI is used in pcb itself, actually pcb-fpw itself would have to draw on a canvas, regardless if pcb is installed/available or not.
    Disadvantage: a lot of code to duplicate, modify and maintain.

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

Create a pixmap of the footprint based on the values in the entry widgets.

Todo:
  • create and (re)load the preview image.

There are several ways to create a preview image of the footprint based on the values entered in the entries:

  1. Copy the method as in the pcb pinout preview.
    Advantage: proven functionality in pcb.
    Disadvantage: this means including a lot of code from pcb.
  2. Invoke pcb to create a picture, and subsequent load that picture into the preview drawing area.
    Advantage: proven functionality in pcb.
    Disadvantage: this will make the user wait, and this will eventually become a showstopper.
  3. Change pcb-fpw into a plug-in.
    Advantage: all pcb functionality is at hand.
    Disadvantage: the gtk approach will not work on the lesstif GUI.
  4. Make an inbuilt renderer for drawing footprints inside pcb-fpw.
    Advantage: a renderer would keep pcb-fpw independant of whatever GUI is used in pcb itself, actually pcb-fpw itself would have to draw on a canvas, regardless if pcb is installed/available or not.
    Disadvantage: a lot of code to duplicate, modify and maintain.

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

Bug:
Invoking preview_create_window (footprint_name, 300, 200); gives an error by ld.
Bug:
Invoking preview_create_window (footprint_name, 300, 200); gives an error by ld.

Definition at line 3865 of file callbacks.c.

void on_refresh_button_clicked ( GtkButton *  button,
gpointer  user_data 
)

The "Refresh" button is clicked.

Refresh all the entries in the GUI.

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3886 of file callbacks.c.

void on_save_button_clicked ( GtkButton *  button,
gpointer  user_data 
)

The "Save" button is clicked.

  • check for null pointer and empty string in footprint_name.
  • determine the name of the footprintwizard filename.
  • determine the name of the footprint filename.
  • invoke the write_footprintwizard_file() to write the global variables to the footprintwizard file, with a .fpw suffix, for debugging and other (future) purposes.
  • if the footprint wizard file is written successful change the title of the main window with the latest filename.
  • invoke the write_footprint() function to write the actual footprint file.
  • if the footprint file is written successful reflect this in the statusbar.

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

  • check for null pointer and empty string in footprint_name.
  • determine the name of the footprintwizard filename.
  • determine the name of the footprint filename.
  • invoke the write_footprintwizard_file() to write the global variables to the footprintwizard file, with a .fpw suffix, for debugging and other (future) purposes.
  • if the footprint wizard file is written successfull change the title of the main window with the latest filename.
  • invoke the write_footprint() function to write the actual footprint file.
  • if the footprint file is written successfull reflect this in the statusbar.

Parameters: *button is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 3917 of file callbacks.c.

void on_silkscreen_indicate_1_checkbutton_toggled ( GtkToggleButton *  togglebutton,
gpointer  user_data 
)

The "indicate pin/pad number 1" checkbutton is toggled.

Store the state of the checkbutton in the silkscreen_indicate_1 variable (global).

Parameters: *togglebutton is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 4012 of file callbacks.c.

void on_silkscreen_line_width_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "silkscreen line width" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the silkscreen_line_thickness variable (global).

Parameters: *ediatble is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 4036 of file callbacks.c.

void on_silkscreen_package_outline_checkbutton_toggled ( GtkToggleButton *  togglebutton,
gpointer  user_data 
)

The "package outline" checkbutton is toggled.

  • save the state of the checkbutton in the silkscreen_package_outline variable (global).
  • if the "package outline" checkbutton is not "checked", set the linewidth entry to insensitive.
  • if the "package outline" checkbutton is "checked", set the line width entry to sensitive.

Parameters: *togglebutton is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 4068 of file callbacks.c.

void on_thermal_checkbutton_toggled ( GtkToggleButton *  togglebutton,
gpointer  user_data 
)

The "thermal pad" checkbutton is toggled.

  • save the state of the checkbutton in the thermal variable (global).
  • if the "thermal pad" checkbutton is not "checked", set the length and width entries to insensitive.
  • if the "thermal pad" checkbutton is "checked", set the length and width entries to sensitive.
  • if the "thermal pad" checkbutton is "checked", set the no paste checkbutton to sensitive and active (on).

Parameters: *togglebutton is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 4103 of file callbacks.c.

void on_thermal_clearance_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "thermal pad clearance" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the thermal_clearance variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 4152 of file callbacks.c.

void on_thermal_length_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "thermal pad length" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the thermal_length variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 4180 of file callbacks.c.

void on_thermal_nopaste_checkbutton_toggled ( GtkToggleButton *  togglebutton,
gpointer  user_data 
)

The "thermal pad no paste" checkbutton is clicked.

Store the state of the checkbutton in the thermal_nopaste variable (global).

Parameters: *togglebutton is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 4205 of file callbacks.c.

void on_thermal_solder_mask_clearance_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "thermal pad solder mask clearance" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the thermal_solder_clearance variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 4230 of file callbacks.c.

void on_thermal_width_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The "thermal pad width" entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the thermal_width variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 4258 of file callbacks.c.

void on_Z1_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The top to bottom pads/pins outer-outer distance (Z1) entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the z1 variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1351 of file callbacks.c.

void on_Z1_radiobutton_toggled ( GtkToggleButton *  togglebutton,
gpointer  user_data 
)

The top to bottom pads/pins outer-outer (Z1) radiobutton is clicked.

  • set the outer-outer (Z1) entry to sensitive.
  • set the center-center (C1) entry to insensitive.
  • set the inner-inner (G1) entry to insensitive.

Parameters: *togglebutton is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1380 of file callbacks.c.

void on_Z2_entry_changed ( GtkEditable *  editable,
gpointer  user_data 
)

The left to right pads/pins outer-outer distance (Z2) entry is changed.

  • get the chars from the entry.
  • convert to a double and store in the z2 variable (global).

Parameters: *editable is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1411 of file callbacks.c.

void on_Z2_radiobutton_toggled ( GtkToggleButton *  togglebutton,
gpointer  user_data 
)

The left to right pads/pins outer-outer (Z2) radiobutton is clicked.

  • set the "outer-outer distance (Z2)" entry to sensitive.
  • set the "center-center distance (C2)" entry to insensitive.
  • set the "inner-inner distance (G2)" entry to insensitive.

Parameters: *togglebutton is the caller widget.

Parameters: user_data.

Returns: none.

Definition at line 1440 of file callbacks.c.