ModelColors.swp Copyright 2003 Leonard Kikstra                      07/20/2004

Dowloaded from KIKSTRA SolidWorks Resources
	http://webpages.charter.net/mkikstra/SolidWorks.html
-------------------------------------------------------------------------------

INTRODUCTION:
ModelColors is a nice tool to dynamically change the base color of SolidWorks 
part models.  This macro incorporates a user customizable external data file 
to allow the user to add their own custom model colors to the selection 
buttons.  This maceo can also manage multiple color lists if needed.  User 
also has option to apply color to shaded, wireframe or both.

This macro is provided as an example of using the SolidWorks API and VBA to 
read and change SolidWorks model settings. 

-------------------------------------------------------------------------------

DISCLAIMER:
* These macros are provided free of charge for personal use and/or reference. 
* These macros may be freely distributed, provided the original copyright 
  notices remain unchanged and intact. 
* All macros were written to work with SolidWorks 2003. 
* These macros, and corresponding files, are provided as is. 
* There are no warranties, expressed or implied, that these macros will perform 
  as indicated, perform to users expectations, or complete a specific task. 
* These macros will change the current SolidWorks document. Use these macros at 
  your own risk. Back up your data before using this macro on any SolidWorks 
  document. 

-------------------------------------------------------------------------------

REVISION HISTORY
  1.0 - Initial creation with embedded list of model colors
  1.5 - Added external source file for custom colors
  2.0 - Added controls for model appearance (Transparency & Specularity)
      - First released version
  2.1 - Added option to apply selected color to wireframe (default yes)
      - Bug fix - Color grid selection via SpinButtonColorGrid
  2.5 - Color set selection pulldown replaces radio buttons which allows for 
        multiple color selection groups
      - Apply color to selection pulldown replaces checkbox (from v2.1) which
        allows for applying color to shaded only, wireframe only or shaded +
        wireframe. 

-------------------------------------------------------------------------------

CONFIGURING THE EXTERNAL DATA FILE:
  * Data file must be in same directory as macro file.  
  * Data file must have same name as macro file with '.ini' extension.
  * Section names must be enclose with [] brackets. 
  * Section names are case sensitive and must match.  
  * An empty line must exist at the end of each section.
  * Data with special characters should be enclosed in "" quotes.
  * Option group has only 2 options and must be set to 'True' to activate
  * The color groups names must be bracketed [] and must exist in data file.
  * This group must contain the following:  (see example below)
      1) Color name (used in color button tool tip)
      2) Model color in hexadecimal format.
  * Hex color values must be preceeded by the '&H' standard nomenclature
  * Hex color values must follow the standard RGB format (&HBBGGRR)

Example:
  Color, ColorName

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 

[OPTIONS]
ApplyToShaded=True
ApplyToWireframe=False

[COLORS]
&He6e8fa, Silver
&HF0B050, Light Bronze
&HF0B090, Light Copper
&Hcfb53b, Gold
&H8f8fbd, Steel Blue
&H527f76, Oxidized Copper 

[SHADES]
&HFF0000, Blue
&HFFFF00, Cyan
&H00FF00, Green
&H00FFFF, Yellow
&H0000FF, Red
&HFF00FF, Purple

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
