Copyright © Fred Weinhaus My scripts are available free of charge for non-commercial (non-profit) use, ONLY. For use of my scripts in commercial (for-profit) environments or non-free applications, please contact me (Fred Weinhaus) for licensing arrangements. My email address is fmw at alink dot net. If you: 1) redistribute, 2) incorporate any of these scripts into other free applications or 3) reprogram them in another scripting language, then you must contact me for permission, especially if the result might be used in a commercial or for-profit environment. Usage, whether stated or not in the script, is restricted to the above licensing arrangements. It is also subject, in a subordinate manner, to the ImageMagick license, which can be found at: http://www.imagemagick.org/script/license.php Please read the Pointers For Use on my home page to properly install and customize my scripts. |
Adds a picture frame around an image. |
last modified: December 15, 2018
Download Frames
tar.gz format
zip format
USAGE: picframe [-f frameid] [-m mattesize] [-c mattecolor] [-b bordersize] [-s shade] [-a adjust] [-o opacity ] [-d distance] infile outfile
-f .... frameid id number of picture frame; Value are PURPOSE: To add a picture frame around and image. DESCRIPTION: PICFRAME adds a picture frame around an image using pictures of actual frames. There is an option to add a black border around the image and/or a colored matte. ARGUMENTS: -f frameid ... FRAMEID is the id number for the picture frame. The following id and frame types are allowd: 1) oak, 2) rustic mahogany, 3) light rosewood, 4) light gold, 5) dark rosewood, 6) gold finish, 7) ornate rosewood, 8) onate silver, 9) ornate walnut, 10) maple, 11) ornate gold and 12) mahogany. The default is 1) oak. -m mattesize ... MATTESIZE is the thicknesses in pixels for the optional matte around the image. The default is 0 or no matte. -c mattecolor ... MATTECOLOR is the color of the optional matte surrounding the image. Any IM color specification is valid. Be sure to enclose it in double quotes. The default is cornsilk. For colornames see http://imagemagick.org/script/color.php -b bordersize ... BORDERSIZE is the thickness of the optional black border around the image. The default is 0 or no black border. -s shade ... SHADE is the percentage shading from an upper left light source. Values range from 0 to 100. Default is 0 or no shading. -a adjust ... ADJUST affects the brightness, saturation and hue of the frame. It is represented as three integer representing percentage changes separated by commas. This is useful as shading decreases the saturation of the frame. Values greater/less than 100 for the brightness and saturation will increase/decrease them. Values greater/less than 100 for the hue will shift the color towards the green/red. A value of 100,100,100 is the default and will make no change. -o opacity ... OPACITY is the inner shadow opacity for upper and left sides. Values are integers between 0 and 100. The default=50. -d distance ... DISTANCE is the inner shaddow distance in pixels for upper and left sides. Values are integers>=0. If distance=0, then no shadow will created. The default=0 NOTE: Be sure to download the picframecorners folder and place it where you want it. Then modify the framedir location in the defaults section just below to point to where you have placed the brcorners folder. If you want to add your own frames, simply cut out a square section of the lower right corner of a picture frame whose dimensions are the thickness of the frame and place it in the picframecorners directory with a name of "brcorner#.png" where # is the next available integer. All picture corners must be in PNG format. Thanks to Anthony Thyssen for the shading technique. See http://www.imagemagick.org/Usage/thumbnails/#frame_edge CAVEAT: No guarantee that this script will work on all platforms, nor that trapping of inconsistent parameters is complete and foolproof. Use At Your Own Risk. |
Picture Frame Styles |
|||
1) Oak |
2) Rustic Mahogany |
3) Light Rosewood |
4) Light Gold |
![]() |
![]() |
![]() |
![]() |
5) Dark Rosewood |
6) Gold Finish |
7) Ornate Rosewood |
8) Ornate Silver |
![]() |
![]() |
![]() |
![]() |
9) Ornate Walnut |
10) Maple |
11) Ornate Gold |
12) Mahogany |
![]() |
![]() |
![]() |
![]() |
Picture In Frame |
|
Original |
|
![]() |
|
Frame 1 |
Frame 2 |
![]() |
![]() |
Frame 1 With Border And Matte |
Frame 2 With Border And Matte |
![]() |
![]() |
Frame 1 With Border, Matte And Shading |
Frame 1 With Border, Matte, Shading And Saturation |
![]() |
![]() |
Frame 1 With Border, Matte, Shading, Saturation and Green Shift |
Frame 1 With Border, Matte, Shading, Saturation and Red Shift |
![]() |
![]() |
Frame 1 With Border, Matte, Shading and Shadow |
|
![]() |
What the script does for the case of no shading and no adjust is as follows:
This is equivalent to the following IM commands:
|