* Salt Pluggins

  You can copy the subckt pluggin to the preferences (.klayout/salt) or (KLayout/salt) subdirectory


  keep uptodate with git/klay8sf/salt/subckt

  cd
  rsync -arv --delete ggit/klay8sf/salt /mnt/c/Users/warwargr/DD

  cd kwork
  cd cmd.exe /c /Users/warwargr/AppData/Roaming/KLayout/klayout_app.exe gregNand.gds   -e

* Environment Variables

  https://www.klayout.de/command_args.html

  $KLAYOUT_PATH: contains a series of search locations separated by a ":" on Linux or ";" on Windows. 
                 These are the locations searched for macros, libraries, plugins, ruby modules etc. 
                 The first entry of that path will be the one where the configuration is stored when
                 KLayout exits. The installation site (where the KLayout executable resides) is always
                 part of the search path. It cannot be disabled.

  $KLAYOUT_HOME: This is the place where KLayout keeps the configuration files, local macros and
                 technology files. By default, this place is "~/.klayout" on Linux and "%HOME%/KLayout"
                 on Windows.

 
  $KLAYOUT_PYTHONPATH: Used by the Python interpreter instead of "PYTHONHOME". This path can be used to
                       establish a Python search path.
  

* Command Line Arguments

  https://www.klayout.de/command_args.html


  -t  : DO NOT update the configuration on exit

  -nt : DO     update the configuration on exit

  -e  : start in edit mode

  -s : load files into same view

  -z  : non-gui mode

  -zz : pure non-gui mode

  -x  : synchronous drawing mode

  -rd <name>=<value> : define a python variable
  -wd <name>=<value> : define a variable for use within expressions

  -r <script>  : run a python or .lym script. To start the
                 KLayout application, and "Application.exec"
                 method call must be included. This option can
                 be included with -z or -zz

  -rm <script> : run a script before KLayout starts the user
                 interface.

  -p <plugin>  : load the plugin (a shared object)

  -l <lyp file> : load layer properties file

  -c <config file> : use this configuration file in stead of
                     the default one

  -rx : ignore all implicit macros (*.rbm, rbainit, *.lym).

  -nc : DO NOT use a configuration

  -gr <file> : record GUI actions
  -gp <file> : replay GUI actions
  -gx <ms>   : replay rate [ms] for GUI actions


  -b : same as -zz -nc -rx 

* In Windows klayout_app.exe is at

    c:\Users\Name\AppData\Roaming\KLayout

  so add this to your PATH windows environment variable

  The setup info is at

    C:\Users\Name\KLayout\macros
                         \pymacros
                         \python

  cd ...Users/Name/KLayout
  \rm -rf macros pymacros python
  tar xvf klay.tar

  cd ...Users/Name/Desktop
  tar xvf kwork.tar

  cd kwork
  klayout_app.exe -e file.gds -l file.lyp



* When you start it, you need to set :

  the background to black

  clear the bindkeys

  set editor options
    select depth shallow




  




* *******************************************************************************************

Main Layout Window
------------------
         Mouse Btn1  --> select
         Mouse Btn2  --> grap view port and move
         Mouse Btn3  --> center view

         Mouse Wheel --> zoom in / out
  <shft> Mouse Wheel --> scroll up/down
  <ctrl> Mouse Wheel --> scroll left/right


  Mouse Btn1 Box --> select area
  Mouse Btn3 Box --> zoom   area


         F2 - fit
  <shft>_F2 --> fit selected


         RTN --> zoom in
  <shft>_RTN --> zoom out



  *  -->  Full view depth
  0  -->  0    view depth
  1  -->  1    view depth
  +  -->  increment view depth
  -  -->  decrement view 



Cell Browser Window
-------------------
* Click on a cell with middle mouse button to view it as a separate cell
  (or right click and select "Show As New Top"



Configuration
-------------
File-->Setup-->Grid  (set display and ruler snapping to a common sense unit for technology)
File-->Setup-->Default_Grids (set a list of grids you want)
File-->Setup-->Display-->Background-->Background color (set to black if you like)

File-->Load_Layer_Properties  (load a .lay file)

Linux
-----
You need to compile it from the sources. Could not install from .deb

tar -xvf ../klayout-0.25.8.tar.gz

cd klayout-0.25.8/

sudo apt-get install qmake
sudo apt-get install qt4-default
sudo apt-get install qt4-qtconfig
sudo apt-get install ruby-dev
sudo ./build.sh
lls /home/greg/src/klayout-0.25.8/bin-release/

LD_LIBRARY_PATH=$HOME/src/klayout-0.25.8/bin-release/
export LD_LIBRARY_PATH


use qtconfig to change the font size of all Qt applications like klayout
(this seems to edit $HOME/.config/Trolltech.conf)

use Lubuntu-->Preferences-->LXQt-->Appearance-->Font to set the font specifically for Lubuntu
(this edits $HOME/.gtkrc-2.0)

88888888888888888 IMPORTANT 888888888888888888888
on xubuntu, I found out that I have to delete Trolltech.conf, and then set font with qtconfig
88888888888888888888888888888888888888888888888888



* ****************************************
* keyboard shortcuts
* ****************************************
you can find code to customize all the keyboard shortcuts in :

https://www.klayout.de/forum/discussion/4/how-to-install-custom-keyboard-shortcuts

* ****************************************